Skip to content

v5.3.0

Choose a tag to compare

@fede-kamel fede-kamel released this 30 Oct 16:12
· 327 commits to main since this release
3c4ed60

Added

  • Codex scenarios. codex/scenarios/ is a series of twelve tasks Codex
    builds from the Locus skill alone, each with a PROMPT.md and a check.sh
    that runs in the project Codex built: a gated refund with its audit trail,
    a hold a person approves and a resumed run, a StateGraph fan-out, a
    retrieval tool, the coding harness behind the gate, a checkpointed
    conversation, an agent served over HTTP, an orchestrator with specialists,
    a typed answer with a termination rule and an evaluation, an agent on OCI
    Generative AI, the permission rules of a coding agent, and a playbook with
    a custom hook. python codex/scenarios/run.py runs them in empty
    directories through locus codex run --exec and prints a summary table;
    --locus-install points Codex at a checkout, so a change to the SDK or the
    skill is tried the way an application would use it. The skill gains a fifth
    reference, extending-and-advanced.md (subagents, voice sessions, external
    hooks, tool sandboxes, custom model providers, the ReAct loop, core
    protocols and settings, DeepAgent internals, graph evaluation, the remaining
    router, memory and observability surface), the four existing references
    name the rest of each package's public surface, and
    tests/docs/test_codex_skill.py measures that coverage against every
    package's __all__ so it cannot regress.
  • Codex builds on Locus. The repository ships a Codex skill,
    .agents/skills/locus/: a SKILL.md that gives a coding agent the shape
    of the SDK (the agent and its tools, the admission gate, the shapes,
    memory and RAG, the harness, the providers, offline tests) and four
    reference files with every option, each snippet checked against the
    installed SDK by tests/docs/test_codex_skill.py. The wheel carries the
    skill, and locus codex places and uses it: init puts it in a
    project's .agents/skills/locus with a Locus section in AGENTS.md, or
    in ~/.agents/skills with --home; run installs it where it is missing
    and starts Codex with the sandbox settings its recipes need (--exec,
    --codex-profile, and anything after -- go to Codex); path prints
    the bundled copy. examples/codex-on-oci/ is a loopback LiteLLM gateway
    that signs Codex's own model calls with an OCI profile, so Codex runs on
    OCI Generative AI and needs no account elsewhere. The how-to page and the
    README section describe all three.

Fixed

  • OCI_REGION selects the region for oci: model strings. The provider
    guide and the environment-variables page said so; the factory behind
    Agent(model="oci:...") only read OCI_PROFILE and sent every request
    to the default region. It now takes LOCUS_OCI_REGION, then
    OCI_REGION, when neither region= nor base_url= is given; the
    default stays us-chicago-1.

  • The harness examples decide by label. The ControlPolicy shown with
    build_harness(..., wrap=gate_tool) on the README, the landing page and the
    harness pages now sets require_verification_score=0.0; with the default
    score every harness call, reads included, was held for a person because no
    verification verdict accompanies a workspace tool call.

Install: pip install "locus-sdk[oci]". The full changelog is in CHANGELOG.md.