Skip to content

locus-sdk 5.1.0 — Oracle Agentic Harness SDK: the cognitive router holds too-risky requests and ranks canonical shapes first, locus-sdk-security on PyPI, the Codex build guide

Choose a tag to compare

@fede-kamel fede-kamel released this 29 Oct 16:29
· 384 commits to main since this release
64724f3

Added

  • Intent meanings in the goal frame. GoalFrame.primary_goal carries one
    line per TaskType (TASK_TYPE_GUIDE), so an extractor model sees what
    separates plan from build or research from diagnose instead of
    thirteen bare names.
  • locus-sdk-security on PyPI. The release workflow publishes the
    security package next to locus-sdk, so pip install locus-sdk-security
    replaces the install-from-repository line; the two stay in lockstep.
  • Build it with Codex. codex/SPEC.md and codex/PROMPT.md drive a
    coding agent through the Quickstart and the first controlled action from a
    clone: a fresh environment, a first agent with a typed tool against the
    provider the operator names, the admission gate allowing, holding and
    denying, and the rogue-agent challenge, each step with its checkpoint.
    AGENTS.md at the repository root carries the rules a coding agent follows
    here. The site gains the how-to page and the README a section;
    tests/docs/test_codex_spec.py keeps the files the specification quotes
    identical to the guide pages.

Changed

  • Cognitive router: a request too risky for its shape is held, not
    refused.
    When every protocol that handles a frame's intent caps risk
    below the frame's, the compiler used to raise NoMatchingProtocolError:
    a HIGH-risk plan, diagnosis or question had nowhere to go. It now compiles
    onto approval_gated_execution and is always held for approval, whatever
    the gate's thresholds; router.explain() reports the choice as
    method="risk_fallback". CognitiveCompiler(risk_fallback=None) restores
    the error, and a goal no protocol handles still raises.
  • Cognitive router: canonical fit outranks cost distance when adjacent.
    The ranker put cost-to-complexity distance first, so a MEDIUM-complexity
    research request landed on handoff_chain (a coordination shape) and a
    HIGH-complexity coordination on specialist_fanout. A protocol that lists
    the goal in primary_for now wins whenever its cost is within one step of
    the frame's complexity; a LOW-complexity task still never gets a HIGH-cost
    shape for being canonical.
  • Cognitive router: debate accepts MEDIUM risk. A debate weighs options
    and recommends; it changes nothing. Capped at LOW, a comparison the
    extractor rated MEDIUM risk fell through to specialist_fanout; on the
    Frankfurt benchmark that was two of Llama 3.3 70B's seven misses.
  • Routing benchmark gates on what the router guarantees. The
    typed-frame-versus-free-form accuracy comparison is printed as data rather
    than asserted: on OCI Generative AI it goes both ways by model (Cohere
    Command A beats the free-form baseline, Llama 3.3 70B does not). The
    assertions are the structural ones: selections stay in the registered set,
    including under prompt injection.

Fixed

  • locus.testing.tool_call could not script the harness write tool.
    The helper reserved content for the assistant's text, so a tool argument
    of that name (write(path, content)) was silently dropped and the tool
    failed with a missing-argument error. tool_call(name, arguments={...})
    now takes the arguments as a mapping, for any tool whose argument is named
    like one of the helper's own parameters; keywords still work and win on a
    repeated key.