Skip to content

Standard Agents primary-source ledger ​

Companion evidence for the dossier and platform comparison.

Retrieval and scope ​

  • Retrieved: 2026-11-15, confirmed with the local clock.
  • Repository snapshot: 78fa54c14d7125f481f6f05538cce5abb5b7a419.
  • The repository README names 0.2.0 current. Versioned content, rather than a mutable /latest URL, supplies the behavioral claims.
  • The commit permalink is the source snapshot. SHA-256 below hashes complete source-file bytes, including line endings; it does not claim an upstream release signature or certification.
  • Inspected material includes the versioned specification and site metadata. Excerpts are literal substrings, with original Markdown retained. A short excerpt can be part of a longer source line; links identify that line.
  • No SDK or runtime was installed or executed. The npm API examples are specification declarations, not independently verified implementation behavior.
  • The GitHub releases API returned no release entries during retrieval. This observation does not establish the npm SDK version or its implementation.
  • Open issues #52 and #46 were checked for topic and open status on the retrieval date; their discussions are not normative.

Exact excerpts ​

Agent definition ​

content/0.2.0/specification/agents.md:3:

An agent is the top-level conversation orchestrator in Standard Agents.

content/0.2.0/specification/agents.md:3:

There is no agent "type": everything about how an agent converses, composes, and terminates is derived from the backings of its two sides.

Version boundary ​

content/0.1.0/specification/agents.md:10:

A subagent is not a separate concept

content/0.1.0/specification/agents.md:25:

| type | 'ai_human' \| 'dual_ai' | 'ai_human' | Conversation mode |

Persistent children ​

content/0.2.0/specification/subagents.md:118:

Every child instance is a persistent thread.

content/0.2.0/specification/subagents.md:110:

When blocking: true is combined with maxInstances: 1 and an instance already exists, subagent_create MUST behave as create-or-continue: message the existing instance and await that session's close, rather than erroring on the cap.

content/0.2.0/specification/subagents.md:149:

Child visibility is pull-based: runtimes inject the subagents query tool

Handler delivery ​

content/0.2.0/specification/handlers.md:61:

  • The runtime MUST invoke the handler exactly once for each inbound message on the side's perspective, in message persistence order.

content/0.2.0/specification/handlers.md:63:

  • The runtime MUST NOT automatically redeliver a message whose handler invocation failed. Retry is a userland decision (re-send the message).

Required parent hooks ​

content/0.2.0/specification/agents.md:155:

Downloading or installing a package is inert.

content/0.2.0/specification/agents.md:163:

  • The hook receives the parent's ThreadState and remains active for the lifetime of the enabled relationship. It applies during every prompt on either side of the parent.

content/0.2.0/specification/agents.md:164:

  • Missing, invalid, or unloadable required hooks MUST fail composition closed. Runtimes must not silently run a partially installed child.

Context assembly ​

content/0.2.0/infrastructure/runtime.md:71:

The snapshot MUST be the set of eligible persisted messages at the moment the runtime starts filter_messages.

content/0.2.0/infrastructure/runtime.md:88:

Tool calls MUST execute sequentially in the returned order.

Silent history ​

content/0.2.0/specification/threads/messages.md:128:

  • Silent messages MUST remain eligible for model context.

content/0.2.0/specification/threads/messages.md:130:

  • silent MUST NOT change persistence, lifecycle hooks, or same-execution visibility.

Decision inference ​

content/0.2.0/specification/threads/decisions.md:3:

A decision evaluates named, typed questions against caller-supplied context.

content/0.2.0/specification/threads/decisions.md:162:

Rounded probabilities MUST NOT be silently renormalized.

content/0.2.0/specification/threads/decisions.md:165:

Providers and runtimes MUST NOT coerce a boolean probability to a boolean or apply an application threshold. Thresholds and subsequent actions are caller-defined.

Tool dependency restriction ​

content/0.2.0/specification/tools.md:44:

When a uses list is supplied, the runtime MUST reject an invocation of a target outside the list.

content/0.2.0/specification/tools.md:44:

An empty list permits no targets. When uses is omitted, this restriction does not apply.

Credential grants ​

content/0.2.0/specification/users.md:199:

  1. Secret material is write-only: it MUST NOT be readable by packaged code, models, or clients. Only metadata and grant existence are readable.

content/0.2.0/specification/users.md:200:

  1. fetch(grant, input, init) MUST inject the credential per the grant's kind and inject policy on the runtime side.

content/0.2.0/specification/users.md:202:

  1. The runtime MUST reject a fetch from a caller not covered by allow. An absent allow denies all callers.

content/0.2.0/specification/users.md:204:

  1. Deleting a grant MUST cause subsequent fetch calls to fail with an error distinguishable from a network failure.

Model fallback ​

content/0.2.0/specification/models.md:44:

When a model definition includes fallbacks, implementations SHOULD:

content/0.2.0/specification/models.md:47:

  1. If the primary model fails after exhausting retries, try each fallback in order

Client API scope ​

content/0.2.0/specification/threads/client-api.md:9:

  1. A runtime SHOULD expose the thread client API.

content/0.2.0/specification/threads/client-api.md:10:

  1. A runtime that exposes it MUST implement every route in §2 as specified in this section.

content/0.2.0/specification/threads/client-api.md:44:

  1. The runtime MUST NOT accept a long-lived credential in a URL.

Packaging portability ​

content/0.2.0/distribution/packaging.md:10:

Packed definitions MUST NOT require private runtime RPCs, implementation-specific storage schemas or bindings, undocumented events, sidecar services that substitute for runtime behavior, or _notPackableRuntimeContext.

Runtime directory limits ​

src/data/runtimes.md:24:

A listing is not an endorsement, and it does not certify conformance.

Source-file digests ​

Paths are relative to standardagents/spec at the pinned commit.

SourceSHA-256
content/0.2.0/distribution/packaging.md5f9180c43b7c5a43f8bad3925ae6c729bb2777579f2d63035e96a6ff2a011bb1
content/0.2.0/infrastructure/providers.mdbb0c357f2f85b4860cc3be7db7f5207cc46bfa2320881c632320cb9692de2fcb
content/0.2.0/infrastructure/runtime.md7893ce53d71ed23d5ac675293123aa3e8cbdfe9a000acfd0168def2b3f1f3693
content/0.2.0/specification/agents.md05fc056303eab738065efa51f0d9b8dc11909322862ec786f0bbf8a416646a31
content/0.2.0/specification/effects.mdebb11b27fd8af04f6fe6a5d00ae48c2e1a5b85d320236cc13acd061391f8f76d
content/0.2.0/specification/handlers.md3493d5297297cc94e017a1833c3daa2cce19face3f3eb486baa0d18f2c9fc0fa
content/0.2.0/specification/hooks.md659d3b98c6e58797b97816c159cf0a345346b63f6c7915028336bc98978ccfef
content/0.2.0/specification/models.md5eb29e1e740fee0a9ba8cac02d5f6c190483241081820fb86f788f33561d0282
content/0.2.0/specification/prompts.md91062950c17ade55a248164b21b2835ef0e7c72280c123a3f3a91f6f828c7f9f
content/0.2.0/specification/providers.mde80825414a9d667e855e292bf6e4f83515a4e072c2c2f0ad83b9cd7a2f0928fd
content/0.2.0/specification/subagents.mdf71ca8dcfbe230e97b1776ff8cd5844c197088b5cebb642197a33d15858ceaaa
content/0.2.0/specification/threads/client-api.mde1147f5b9958e6c45e465ef7ea754349df9da786f6664dcc942307f5281ca564
content/0.2.0/specification/threads/code-execution.md5ba6d186049359b0f885e9442a16e538e6c731df68a5c9dab014725403194f78
content/0.2.0/specification/threads/decisions.md15c646172799c052ffdb559d7fad1512ba0ff3a6cb955116835d331e14cb6dbd
content/0.2.0/specification/threads/endpoints.mde267aa40a81cb1bb0e00a04fb591326baffa5c42f954196a09ad1d8db5060825
content/0.2.0/specification/threads/execution-state.mde12fd7942e55707cdc3b894b99b5cff7e572e4674c445b4fe728e78829a7bb12
content/0.2.0/specification/threads/filesystem.md455df74632b8fea9cada7bf270c5a265811f450691fd7424c08742f1a5332fbe
content/0.2.0/specification/threads/messages.md1ba5d7143a192e08413679b274b9b1181f1c9698896b244b2ac5b8d8e3877800
content/0.2.0/specification/threads/runtime-streams.md659ca050f508bbe7e3422d5ea16f5fed5ed164d1c9e108823b8d1a569d3f55df
content/0.2.0/specification/threads.md33b7d1eed207f78c551c17aea09fa7525008e2b7218d38d6c0e47777c46d32e4
content/0.2.0/specification/tools.md2439c24fcd43d666ce7d2df5897aed431bb684ffe91e5a2bab7fda29852ac5f6
content/0.2.0/specification/type-registry.mddef64cb9772816ceba40568d27afe1c6e5c0849a96a9ee61fcbd8634c160d53e
content/0.2.0/specification/users.mdbd130a9716df404deb2cedd26454c3f60844f91e0315e753f335f883dcad78ee
README.md17823b944bbb2a814ec304b75c8c6a5b7f4917bba76836785ead506e7d2b5966
package.json106955bc8c8678f68bb2e71668a821135f93b149a568db4fe357ad3ee35c950d
content/0.1.0/specification/agents.md8c1991cdddeeaba7522de5ce0deb0e5b44c1834a72ffbd2a3163e7838e3027be
src/data/runtimes.md085f518f2ff052797f5695827138fff23fe21426556ae5451a9eaab73d067976
tests/site.test.mjs4ce7db7c04a918cfceceddb6ff3b02d5f7150707c949967d55903568b5396225
tests/models-guide.test.mjs9601ce2a141162ceebf72a8fe6326b7f252bbd7a04e2c367d8acbe0db4c737ed
tests/home-cta.test.mjsf5b84dc5425e923dfce0fbf794d4f6158723f03dbd9a7b69079ea836525fbf57

Local comparison anchors ​

The comparison baseline is 3d5354507dd6d937ea70eaa957e7f31332d82dfb. These repository paths and symbols were checked directly. Draft schemas are declarations; implementation files are static evidence, not fresh test receipts.

SourceRelevant symbol or boundary
buf.gen.yaml:13Agent, Session and adjacent package generation exclusions
proto/trogonai/agents/agents/v1alpha1/agent.proto:18Runtime settings, dependencies and execution subject
proto/trogonai/agents/agents/v1alpha1/agent_revision.proto:13Exact configuration reference and revision identity
proto/trogonai/agents/agents/v1alpha1/implementation.proto:89Pinned implementation and definition digest
proto/trogonai/agents/agents/v1alpha1/dependencies.proto:19Distinct declared binding names and dependency resolution
proto/trogonai/session/sessions/v1alpha1/session_started.proto:18Immutable plan creation fact
proto/trogonai/session/sessions/v1alpha1/execution_plan.proto:11Canonical plan bytes and digest
proto/trogonai/session/sessions/v1alpha1/close_session.proto:12Terminal Session boundary
proto/trogonai/session/sessions/v1alpha1/create_child_session.proto:22Proposed child lineage saga and live admission
proto/trogonai/session/sessions/v1alpha1/reserve_operation.proto:15Operation identity and request digest reservation
proto/trogonai/session/sessions/v1alpha1/cascade_policy.proto:8Explicit parent-terminal cascade versus independent child
rsworkspace/crates/decider/trogon-decider-nats/src/lib.rs:1Native JetStream storage, processor and projector modules
rsworkspace/crates/scheduler/trogon-scheduler/src/processor/execution/worker/mod.rs:1Existing scheduling dispatcher, retry and reconciliation exports
rsworkspace/crates/policy/trogon-policy-eval/src/evaluator.rs:32Pure policy evaluation over snapshots
rsworkspace/crates/platform/trogon-egress-proxy/src/lib.rs:1CONNECT policy/audit scope and implementation modules
rsworkspace/crates/platform/trogon-workload-identity/README.md:1Governed identity, current authority and caller obligations
rsworkspace/crates/provider/trogon-provider-gateway/README.md:1Current HTTP foundation and unimplemented inference routes
rsworkspace/crates/platform/trogon-claude-agent-sdk/README.md:1Concrete Claude Code loop ownership and protocol boundary
docs/architecture/agent-platform.md:1Current foundations versus target architecture

Interpretation limits ​

Capitalized MUST, SHOULD and MAY retain the levels stated in the source. Optional capability support is distinct from mandatory behavior once a capability is implemented. Inconsistencies listed in the dossier remain open; this research does not silently resolve them or claim upstream conformance.

Released under the Apache License 2.0.