Repository navigation
v5.3.0
Added
- Codex scenarios.
codex/scenarios/is a series of twelve tasks Codex
builds from the Locus skill alone, each with aPROMPT.mdand acheck.sh
that runs in the project Codex built: a gated refund with its audit trail,
a hold a person approves and a resumed run, aStateGraphfan-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.pyruns them in empty
directories throughlocus codex run --execand prints a summary table;
--locus-installpoints 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.pymeasures that coverage against every
package's__all__so it cannot regress. - Codex builds on Locus. The repository ships a Codex skill,
.agents/skills/locus/: aSKILL.mdthat 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 bytests/docs/test_codex_skill.py. The wheel carries the
skill, andlocus codexplaces and uses it:initputs it in a
project's.agents/skills/locuswith a Locus section inAGENTS.md, or
in~/.agents/skillswith--home;runinstalls it where it is missing
and starts Codex with the sandbox settings its recipes need (--exec,
--codex-profile, and anything after--go to Codex);pathprints
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_REGIONselects the region foroci:model strings. The provider
guide and the environment-variables page said so; the factory behind
Agent(model="oci:...")only readOCI_PROFILEand sent every request
to the default region. It now takesLOCUS_OCI_REGION, then
OCI_REGION, when neitherregion=norbase_url=is given; the
default staysus-chicago-1. -
The harness examples decide by label. The
ControlPolicyshown with
build_harness(..., wrap=gate_tool)on the README, the landing page and the
harness pages now setsrequire_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.