DSHarness Systems Dissection Pinned baseline 47f943859b · 36 verified / 0 in progress / 36 chapters
中文
Synthesis·Chapter 35

Glossary, Evidence Catalog, and Source Index

Navigate from concepts and claims back to the pinned source baseline

VerifiedUpstream 47f943859bScope: Collect terminology, every evidence record, package/symbol/event indexes, and citation coverage.

Conclusion: a reverse-navigation layer over the pinned baseline

This chapter is an index, not a second narrative. Start with a term, catalog ID, package path, documented symbol, or event name and follow it back to the exact pinned source. Every count below is generated from the current manifests, bilingual fragments, catalog, inventory, and upstream structured models.

1. Reading guide and scope

Catalog reach counts stable evidence IDs cited by eligible Chapters 00–34. English and Chinese citation sequences must be identical, and each bilingual chapter is counted once. Chapter 35 is always excluded, so rendering the catalog cannot improve its own coverage.

Interpretation boundary

Catalog reach measures cited catalog IDs only; it is not claim, architecture, package, source-file, or proof-quality coverage.

2. Bilingual glossary · 48

SymbolDefinitionNavigation
Activation
activation

The transition in which a validated contribution becomes visible in a scope; activation must have explicit ownership and disposal.

Aliases: dynamic activation
First definition: 23
Related chapters: 04, 05, 24
Evidence records: CODEMODE-ACTIVATION, MULTIAGENT-ACTIVATION-OWNERSHIP
Agent
agent

A runtime object with identity, scope, inbox, status, and a Session-backed execution lifecycle; it is published only after setup succeeds.

Aliases: agent handle
First definition: 05
Related chapters: 06, 24, 26
Evidence records: AGENT-PUBLIC-INTERFACE, AGENT-PREPARE-PUBLISH
Approval
approval

A request-scoped human decision with a closed outcome vocabulary; approval is not a reusable ambient permission.

Aliases: one-shot approval
First definition: 19
Related chapters: 20, 21, 23, 29
Evidence records: APPROVAL-OUTCOMES, APPROVAL-REQUEST-SHAPE
Bundle
bundle

A reusable product-level configuration layer that assembles a coherent set of plugins and defaults.

Aliases: product bundle
First definition: 04
Related chapters: 03, 17, 30
Evidence records: ARCH-LAYERS, BASE-BUNDLE-SPINE
Code Mode
code-mode

A model-facing presentation and dispatch mode that exposes generated SDK bindings; it does not create a second, authority-free tool engine.

Aliases: code presentation mode
First definition: 23
Related chapters: 16, 18, 24
Evidence records: CODEMODE-MODES, CODEMODE-SEAM
Commit point
commit-point

The exact transition after which a candidate is authoritative; failures before it veto publication, while later observer failures cannot undo the fact.

Aliases: authoritative commit
First definition: 09
Related chapters: 11, 15, 16, 27
Evidence records: SESSION-APPEND-COMMIT, DESIGN-PACKAGE-RULES
Compaction
compaction

A logged Surface replacement that summarizes an eligible prefix to reduce future model context without deleting canonical history.

Aliases: context compaction
First definition: 13
Related chapters: 09, 10, 28
Evidence records: COMPACT-TRANSACTION, COMPACT-COMMIT
Connection generation
connection-generation

A monotonic client-side epoch that prevents stale work from an earlier transport from mutating the current connected state.

Aliases: reconnect generation
First definition: 30
Related chapters: 27, 29
Evidence records: WEBUI-CONNECTION-GENERATION, API-CONNECTION-LOOP
Continuable child
continuable-child

A child whose stable descriptor and Session permit later follow-up epochs; publication occurs only after setup and inbox acceptance succeed.

Aliases: continuable
First definition: 24
Related chapters: 26, 27
Evidence records: MULTIAGENT-CONTINUABLE-START, MULTIAGENT-FOLLOWUP
Catalog reach
coverage-reach

The share of catalog IDs cited by an eligible chapter corpus, counting one bilingual chapter once; it is not claim coverage, source-file coverage, or proof quality.

Aliases: evidence catalog reach
First definition: 35
Related chapters: 01, 32, 34
Evidence records: —
Disposer
disposer

The callable cleanup handle returned by a registration; ownership and reverse teardown make it part of the runtime contract, not optional housekeeping.

Aliases: cleanup handle
First definition: 02
Related chapters: 04, 05, 27
Evidence records: ROOT-EFFECTS, DESIGN-SCOPE-TEST
Durability barrier
durability-barrier

An awaited boundary that makes the required log prefix durable before a model request, top-level tool body, or another selected side effect proceeds.

Aliases: checkpoint barrier, flush barrier
First definition: 10
Related chapters: 11, 15, 27
Evidence records: LOG-CHECKPOINT-POLICY, LLM-CHECKPOINT-BARRIER
Reversible effect
effect

A side-effect registration paired with a disposer and owned by the current lifecycle fiber, so replacement can retract what it published.

Aliases: effect
First definition: 02
Related chapters: 04, 05, 23
Evidence records: ROOT-EFFECTS, DESIGN-SCOPED-LAYERS
Evidence record
evidence-record

A stable catalog ID tied to one pinned repository path and line range, with bilingual statements of what that excerpt supports.

Aliases: catalog item
First definition: 01
Related chapters: 00, 33, 34, 35
Evidence records: ROOT-BOUNDARIES
Fiber
fiber

The runtime lifecycle node that owns a plugin activation and its effects; disposing it retracts its owned contribution graph.

Aliases: plugin fiber
First definition: 02
Related chapters: 04, 05, 23
Evidence records: DESIGN-SCOPED-LAYERS, ROOT-EFFECTS
Goal
goal

A revisioned, phase-bearing objective updated through exact-reference checks and a durable Session commit before live publication.

Aliases: goal state
First definition: 15
Related chapters: 24, 29, 30
Evidence records: PLANSTATE-GOAL-COMMIT, PLANSTATE-GOAL-TYPES
Inbox claim
inbox-claim

The durable transition that assigns queued input to an execution boundary, preserving ordering and recovery semantics across cancellation or restart.

Aliases: claim boundary
First definition: 26
Related chapters: 05, 06, 24, 27
Evidence records: INBOX-CLAIM-REPLAY, AGENT-INBOX-COMMIT
JSON-RPC
json-rpc

The typed request, response, and notification carrier used by API and ACP surfaces; envelope validation does not by itself establish user identity.

Aliases: RPC envelope
First definition: 29
Related chapters: 24, 30, 31
Evidence records: API-RPC-SCHEMAS, API-TRUST-FENCE
Monotonic guard
monotonic-guard

A policy hook that may deny or abstain but cannot grant authority, so a later guard cannot reverse an earlier veto.

Aliases: tool guard
First definition: 19
Related chapters: 16, 20, 23
Evidence records: APPROVAL-GUARD-CONTRACT, TOOL-DECISIONS
Filesystem observation
observation

Session-owned freshness metadata recorded by selected filesystem tools; it is narrower than proof that every byte was read or every filesystem access was observed.

Aliases: read observation
First definition: 20
Related chapters: 16, 31
Evidence records: SANDBOX-OBSERVATION, SANDBOX-OBSERVATION-LIMITS
Patch
patch

A configuration-tree operation that adds, replaces, or removes a row by stable identity as composition layers are applied.

Aliases: Cordis patch
First definition: 04
Related chapters: 03, 23
Evidence records: BASE-BUNDLE-SEMANTICS, PROFILE-COMPOSE
Pinned baseline
pinned-baseline

The exact upstream commit against which every path, line range, generated index, and architectural statement in this study is evaluated.

Aliases: source baseline
First definition: 01
Related chapters: 00, 35
Evidence records: ROOT-PREVIEW
Plan
plan

A selected interaction mode whose transition commits immediately when idle or at the next accepted in-Turn pre-Step boundary.

Aliases: plan mode
First definition: 15
Related chapters: 06, 19, 30
Evidence records: PLANSTATE-PLAN-BOUNDARY, PLANSTATE-PLAN-STATE
Plugin
plugin

A composable runtime contribution mounted into a context and owned by a lifecycle scope; it may publish services, listeners, and reversible effects.

Aliases: Cordis plugin
First definition: 02
Related chapters: 03, 04, 23, 30
Evidence records: ARCH-PLUGIN-CORE, DESIGN-CORDIS-SEMANTICS
Profile
profile

A named launch composition that selects and layers bundles and patches into an effective plugin tree.

Aliases: launch profile
First definition: 04
Related chapters: 03, 23, 31
Evidence records: PROFILE-COMPOSE, PROFILE-LOAD
Projection
projection

A fold or query-derived view over authoritative records; a projection can accelerate reads without becoming the source of truth.

Aliases: derived view
First definition: 12
Related chapters: 09, 10, 15, 30
Evidence records: PROJ-AUTHORITY-LAYERS, PROJ-REGISTRY-DRIVE
Replay
replay

Reconstructing derived runtime or model-visible state by folding durable facts in sequence order rather than trusting a resident cache.

Aliases: log replay
First definition: 10
Related chapters: 09, 12, 13, 27
Evidence records: SESSION-DERIVED-ORACLE-TEST, LOG-HISTORY-CUT
Request header
request-header

The canonical logged snapshot of request-shaping context used to reconstruct and compare model requests.

Aliases: request-header event
First definition: 07
Related chapters: 08, 09, 27, 28
Evidence records: PROMPT-HEADER-CANONICAL, LOOP-REQUEST-INVARIANT
Row identity
row-identity

The stable key used to decide which configuration row a later layer replaces; textual position alone is not identity.

Aliases: stable row identity
First definition: 04
Related chapters: 23, 27
Evidence records: BASE-BUNDLE-SEMANTICS, PROFILE-LIVE
Runtime invariant
runtime-invariant

A package-owned executable check of a semantic property at runtime; it complements static types and tests rather than replacing either.

Aliases: invariant
First definition: 32
Related chapters: 06, 09, 13, 16
Evidence records: DESIGN-INVARIANT-REGISTRY, PKG-INVARIANTS
Sandbox policy
sandbox-policy

Per-call policy for declared process file effects and writable roots; its documented boundary is not general network, syscall, device, or credential isolation.

Aliases: file-effect confinement
First definition: 20
Related chapters: 19, 21, 23, 31
Evidence records: SANDBOX-DOC-BOUNDARY, SANDBOX-POLICY
Scope
scope

A visibility and ownership boundary that determines which contributions are observable and which lifecycle must retract them.

Aliases: context scope
First definition: 02
Related chapters: 05, 16, 23, 30
Evidence records: DESIGN-SCOPED-LAYERS, DESIGN-SCOPE-TEST
Service
service

A typed capability published under a context key and consumed through scope-aware lookup rather than direct global ownership.

Aliases: context service
First definition: 02
Related chapters: 03, 16, 22, 23
Evidence records: DESIGN-CORDIS-SEMANTICS, DESIGN-SCOPED-LAYERS
Session event
session-event

An append-only typed record in a Session log with sequence, time, payload, and optional Surface metadata; it is not a live Cordis event.

Aliases: durable log record
First definition: 09
Related chapters: 10, 11, 12, 35
Evidence records: SESSION-EVENT-ENVELOPE, SESSION-CORE-EVENTS
Slot
slot

A scope-owned browser contribution point whose recursive disposal removes the subtree declared by an entry.

Aliases: UI slot
First definition: 30
Related chapters: 02, 23
Evidence records: WEBUI-SLOT-CASCADE, DESIGN-SCOPED-LAYERS
Step
step

One prompt assembly and model-request attempt inside a Turn, followed by either completion or a tool-continuation boundary.

Aliases: model step
First definition: 06
Related chapters: 07, 08, 18
Evidence records: LOOP-STEP-STATE, LOOP-REQUEST-BUILD
Subagent
subagent

A child execution created through a provider seam with explicit parent ownership, run identity, settlement, budgets, and optional continuation.

Aliases: child agent
First definition: 24
Related chapters: 25, 26, 29
Evidence records: MULTIAGENT-SEAM, MULTIAGENT-LIFECYCLE
Surface
surface

The ordered model-visible message projection derived from eligible Session events; it is a view over the log rather than the canonical log itself.

Aliases: model-visible Surface
First definition: 09
Related chapters: 10, 12, 13
Evidence records: SESSION-SURFACE-PROJECTION, ROOT-MODEL-LOGGED
Surface operation
surface-op

The append, replace, or delete operation carried by a Surface-eligible event to fold model-visible history deterministically.

Aliases: surfaceOp
First definition: 09
Related chapters: 10, 13
Evidence records: SESSION-SURFACE-REPLACE, SESSION-EVENT-ENVELOPE
Todo
todo

A whole-value list state with its own validation and projection contract; it does not inherit Goal or Plan authority semantics.

Aliases: todo list
First definition: 15
Related chapters: 16, 17, 30
Evidence records: PLANSTATE-TODO-TOOL, PLANSTATE-TODO-INVARIANT
Tool runtime
tool-runtime

The ordered execution transaction spanning input materialization, policy, guards, around-dispatch, body execution, post-policy, finalization, and immutable result.

Aliases: tool transaction
First definition: 16
Related chapters: 17, 18, 19, 23
Evidence records: TOOL-PIPELINE, TOOL-RUNTIME-INVARIANT
Trust boundary
trust-boundary

A named transition where identity, authority, data origin, or side-effect capability changes and therefore requires explicit validation or policy.

Aliases: authority boundary
First definition: 31
Related chapters: 19, 20, 29
Evidence records: ROOT-TYPED-TRUST, API-TRUST-FENCE
Turn
turn

A user- or system-triggered execution interval that may contain several Steps and ends with an explicit reason.

Aliases: agent turn
First definition: 06
Related chapters: 09, 15, 26
Evidence records: LOOP-TURN-STATE, ARCH-TURN
Typed event
typed-event

A named live-bus contract whose TypeScript signature and dispatch mode constrain producers and listeners; it is distinct from a durable Session log record.

Aliases: Cordis event
First definition: 02
Related chapters: 06, 09, 35
Evidence records: DESIGN-CORDIS-SEMANTICS, SESSION-CORE-EVENTS
Waterfall
waterfall

An ordered live-event mode in which a listener can transform a value and delegate to the next listener; before/after-next placement is semantic.

Aliases: waterfall event
First definition: 02
Related chapters: 06, 07, 16, 19
Evidence records: DESIGN-CORDIS-SEMANTICS, PROMPT-ASSEMBLY-PIPELINE
Watermark
watermark

The log position and identity metadata that bound what a cached projection has folded and whether tail replay is safe.

Aliases: projection watermark
First definition: 12
Related chapters: 10, 30
Evidence records: PROJ-CACHE-LADDER, PROJ-CACHE-SCHEMA
Workflow
workflow

A validated orchestration program that composes child runs and combinators under explicit concurrency, total-child, slice, and disposal ceilings.

Aliases: workflow run
First definition: 25
Related chapters: 24, 27, 29
Evidence records: WORKFLOW-LIFECYCLE, WORKFLOW-CAPS
Write-behind
write-behind

Per-Session asynchronous persistence that preserves append order but needs an explicit flush barrier before selected external effects.

Aliases: write-behind queue
First definition: 10
Related chapters: 11, 27
Evidence records: LOG-WRITE-BEHIND, PERSIST-WRITE-BEHIND

3. Evidence catalog reach

CorpusChaptersOccurrencesUnique IDs citedUncited IDsCatalog reachCatalog-path reach
published-substantive3513501092299.8%100.0%
verified3513501092299.8%100.0%

Published-substantive reach by catalog kind

KindCatalog IDsUnique IDs citedCatalog reach
design-note44100.0%
generated-doc44100.0%
generated-source11100.0%
official-doc797898.7%
production-config5757100.0%
production-source805805100.0%
production-test137137100.0%
repository-policy7685.7%

Reused IDs: 201; reuse occurrences: 258.

4. Complete evidence catalog · 1094

Universe: every record in evidence/catalog.json. Rows are ordinary links, not citation tags, and therefore do not enter coverage. “First” and “all chapters” use the published-substantive corpus.

design-note · 4
IDPinned sourceWhat this excerpt supportsFirst citationAll citing chapters
INBOX-WAKE-LATCH-NOTE
Cancellation-convergence latch decision and remaining gap
.agents/notes/implemented/bug-fix/2026-08-07-cancel-convergence-wake-latch.md:9-29Records why the latch exists, why it distinguishes post-abort wakes, and how the post-hasPending sub-microtask gap can still park input.2626
PARALLEL-NOTE-DRIFT
Stale cancellation and Code Mode claims in the implemented note
.agents/notes/implemented/feature/2026-07-10-parallel-tool-call-execution.md:43-51The older note still says unstarted calls have no audit event and the Code Mode queue remains serial; current source instead uses synthetic call/result pairs and a parallel per-run scheduler.1818
PARALLEL-SAFETY-NOTE
Conservative safety contract of the unary classifier
.agents/notes/implemented/feature/2026-07-10-parallel-tool-call-execution.md:17-25The classifier sees only the current call's arguments; the scheduler neither compares siblings nor proves resource compatibility, so calls whose safety is relational must remain exclusive.1818
TOOLCAT-PARALLEL-OPTINS
Conservative parallel declarations for shipped tools
.agents/notes/implemented/feature/2026-07-10-parallel-tool-call-execution.md:53-65The implementation note lists Web search and fetch, filesystem reads, Session Query trace and read, and subagent delegation as opt-ins, while writes and edits, shells, query searches, workflow, human interaction, todo, Code, and Cordis remain exclusive.1717
generated-doc · 4
IDPinned sourceWhat this excerpt supportsFirst citationAll citing chapters
TOOL-PIPELINE
Tool execution pipeline
docs/tool-execution-pipeline.md:4-60The complete order of pre hooks, monotonic guards, around execution, post hooks, normalization, finalization, and immutable results.1616, 33
TOOLCAT-GENERATED
Generated-tool-catalog scope and complete package map
docs/tool-catalog.md:1-41The catalog explains real plugin boot for dynamic schemas, default and required branches, configurable names, and excluded examples, then lists every shipped tool package at the pinned baseline with names, dependencies, effects, and aliases.1717
TOOLCAT-PACKAGE-MAP
Names and capability seams for 24 shipped tool packages
docs/tool-catalog.md:16-41The package map lists model-visible names, requirements, writes or effects, shipped aliases, and deployment notes for every package, including opt-in Cordis, conditional read_image, configured subagents, and child-only report.1717
TURN-SEQUENCE
Agent turn and step sequence
docs/agent-lifecycle.md:19-80The sequence of input claims, durable events, parallel tool settlement, stop points, and SDK-facing events.0101, 06
generated-source · 1
IDPinned sourceWhat this excerpt supportsFirst citationAll citing chapters
SESSION-KNOWN-EVENTS
The 44 event types known to this build
packages/core/session/src/known-event-types.ts:9-64The generated catalog lists all 44 event types declared in the repository and lets persistence refuse unknown required vocabulary.0909
official-doc · 79
IDPinned sourceWhat this excerpt supportsFirst citationAll citing chapters
APPROVAL-DOC-API-DRIFT
API proxy README approval-capability drift
packages/host/apiproxy/README.md:75-81The README still says the pending interaction table handles questions only and has no approval entries.1919
APPROVAL-DOC-PRESET-DRIFT
Permission README identifier drift
packages/interaction/permission-presets/README.md:5-17The README still names the durable event permissionPresets/preset and the command /permissionPresets.1919
ARCH-LAYERS
Profile, bundle, and patch layers
docs/architecture.md:15-37The runtime plugin tree is composed in bundle, profile patch, home patch, and CLI overlay order.Not cited in this corpus
ARCH-LOG
Session log and capability seams
docs/architecture.md:92-102The log is the source of truth for model context; model-visible data must be reconstructable, and a seam includes definition, provider, and consumer.0000, 02, 12
ARCH-PLUGIN-CORE
Cordis and the unprivileged core
docs/architecture.md:9-13Every product component is a plugin composed through services, typed events, and reversible effects on a shared context.0000, 02
ARCH-TURN
Turn and step flow
docs/architecture.md:63-90The relationship among turns, steps, prompts, LLM calls, tools, and live waterfalls.0202, 06
CAP-MCP-DEFAULT-OFF
MCP memory examples are default-off
examples/mcp-memory/README.md:1-33The three third-party MCP memory configurations are default-off interoperability examples; no server ships by default, and installation, operation, and provider behavior remain external responsibilities.2222
CAP-MCP-LIMITS
Known MCP bridge limitations
packages/mcp/mcp-client/README.md:109-115The README states that only Tools are bridged, startup timeout comes from the SDK, HTTP recovery differs, Native non-text is lossy, and unsupported output schemas are not enforced.2222, 33
CODEMODE-README-DRIFT
tool-cordis README still describes the old five-tool and config surface
packages/extensions/tool-cordis/README.md:5-27The README still lists the old five-tool cordis_inspect surface and claims an ackTimeoutMs runner option; production source has seven tools and the current runner config has only vmTimeoutMs.2323
DESIGN-CORDIS-SEMANTICS
Cordis service, event, waterfall, and effect semantics
docs/cordis-primer.md:7-44Plugins decouple implementations through service keys, wait through declarative injection, coordinate through typed events, and bind registration to teardown with reversible effects.0202
FAILURE-RETRY-DOC-DRIFT
Retry README drift about fresh Turns
packages/llm/llm-retry/README.md:1-13The README says every retry closes the failed Turn and opens a freshly numbered Turn, conflicting with the current Step-local loop and tests.2727
INBOX-JSONL-DURABILITY
JSONL fsync, write-behind, and flush
packages/session/session-persistence-jsonl/README.md:40-52Initial and later batches are fsynced with rollback on failure; live events use a fixed batching window while flush and teardown drain.2626
INBOX-README-DRIFT
ApiProxy README drift on next-step projection
packages/host/apiproxy/README.md:41-41The README says next-step steering stays outside Web projection, while current queueItems and ChatView explicitly project and render it.2626
LLM-RETRY-DOC-DRIFT
Retry README drift from the current loop boundary
packages/llm/llm-retry/README.md:1-53The README repeatedly says retries close the old Turn and open a freshly numbered Turn, while production source and tests continue in the same loop, Turn, and Step.0808
MEMORY-MCP-BOUNDARY
Responsibility boundary of default-off third-party Memory MCP examples
examples/mcp-memory/README.md:5-82The three examples are opt-in overlays only; Harness owns MCP transport and tool discovery, not server installation, databases, models or embeddings, provider data, or semantics. The README describes provider storage and requires manual cross-Session recall validation.1414, 33
MEMORY-QUERY-TOOL-CONTRACT
Model-facing Session-query tools not mounted by default
packages/session-query/tool-session-query/README.md:5-20The opt-in package declares five model tools that shipped Hosts do not mount by default, defines exact-cwd authority and hidden unauthorized lineage, and states that the package itself does not truncate output.1414
MEMORY-REFERENCE-DOC-DRIFT
README claim of standard-TUI injection integration
packages/context/session-reference/README.md:13-18The README says the standard TUI installs a one-shot pre-step wrapper while idle and injects before steering while running, but the pinned shipped composition and production consumers contain no corresponding mount.1414
MEMORY-REFERENCE-OPT-IN
The context package overview marks session-reference as opt-in
packages/context/README.md:5-14The context package overview names only agent-instructions as part of the default bundle and explicitly classifies time-context, tmux-context, and session-reference as opt-in.1414
MEMORY-REFERENCE-TRUST
Trusted-caller and snapshot limitations of Session reference
packages/context/session-reference/README.md:45-50The README explicitly says the service assumes its Host may read every Session exposed by sessionQuery and that references are text-only snapshots, not live links, forks, resumes, or subscriptions.1414
MEMORY-SKILL-CLIENT-UI
Web Skill candidate caching, literal gestures, and failure degradation
packages/client/ui-skill/README.md:5-9The client caches the user-invocable catalog per ordinary Session, writes literal /name from the slash menu for Host pre-step interpretation, and folds skill.list failure into a silently missing menu group.1414
MEMORY-WEB-SEARCH
Local-first and remote-content search UX in Workspace Browser
packages/client/ui-workspace/README.md:5-11A nonblank query immediately matches title and workspace, then merges Host current-conversation content hits after 250 ms; remote failure preserves local results with a warning, and the final list is deduplicated and capped at 20.1414
OBS-PRIVACY-BOUNDARY
Data leaving the machine and lineage notes
packages/session/session-telemetry-otel/README.md:36-42Enumerates uploaded messages, tools, files, prompts, todos, compaction, feedback, and cwd; no built-in redaction exists, while credentials are structurally absent.2828, 33
OBS-QUERY-TOOLS
Five model-facing session-query tools
packages/session-query/tool-session-query/README.md:5-76Documents five opt-in tools not mounted by shipped hosts, unabridged exact reads, and the generic spill policy's responsibility.2828
OBS-TRAJECTORY-CONTRACT
Trajectory browser-view contract
packages/client/ui-trajectory/README.md:5-17Defines a window-scoped ledger with paging, virtualization, timeline, inspector, blank in-flight durations, and no model effect.2828
OPEN-API-BODY-BOUND
Resident request-body bound of the API bridge
packages/client/connection/README.md:23-26Each request body is fully buffered in memory with a default maxRequestBodyBytes of 160 MiB; lowering the resident bound requires streaming or smaller image limits.3434
OPEN-ATOMIC-DURABILITY
Durability and orphan-lock boundary of atomic write
packages/util/atomic-write/README.md:23-45Same-directory rename provides visible whole-value atomicity, but the primitive does not fsync the file or directory and a crash can leave an orphan lock requiring verified operator recovery.3434
OPEN-ATTACHMENT-LOCAL-RETENTION
Indefinite retention in the local attachment backend
packages/attachment/attachment-local/README.md:17-20The local backend explicitly retains objects indefinitely and defers reference-aware garbage collection.3434
OPEN-ATTACHMENT-RETENTION
Attachment retention and garbage-collection gap
packages/attachment/attachment/README.md:17-21Immutable objects may be shared by resume and fork, so retention and garbage collection are deferred; other media and persistent drafts require separate lifecycles.3434
OPEN-CHECKPOINT-UNKNOWN
External outcome remains unknown after checkpoint
packages/session/session-checkpoint-policy/README.md:5-45The policy checkpoints execution intent before a top-level tool body; recovery marks a persisted call with no result as TOOL_OUTCOME_UNKNOWN, does not retry automatically, and provides no generic exactly-once effects.3434
OPEN-CLIENT-UNLOAD
General client unload-chain gap
packages/client/runtime/README.md:89-93loader.unload is a not-implemented stub, with no general chain from fiber disposal through registration and style removal.3434
OPEN-FEEDBACK-CONSISTENCY
Cross-process consistency and retention limits of feedback
packages/feedback/message-feedback/README.md:76-84Compare-and-set holds only inside one process queue; several Host processes may silently lose updates, and there is no durable deletion cascade, item-count cap, or aggregate-row byte cap.3434
OPEN-NATIVE-OUTPUT-BOUND
Unbounded native-command output buffering
packages/util/native-command/README.md:25-27Both stdout and stderr buffer without bounds in memory; current justification relies only on callers invoking small-output native tools.3434
OPEN-OTEL-BOUNDARY
OTel SDK and live-collector boundary
packages/session/session-telemetry-otel/README.md:30-38Authentication, TLS, retry, queues, and throttling belong to the SDK; the outer shutdown deadline cannot cancel transport, and complete event data may leave according to the current redaction result.3434
OPEN-PROCESS-PLATFORM-LIMITS
Platform limits of local process observation
packages/subprocess/subprocess-local/README.md:26-33Windows tree support is best-effort and terminal inspection supports only Linux and macOS; reparenting or setsid can let a daemonized child escape observation.3434
OPEN-RALPH-VERIFICATION
Ralph self-declared completion and effort bounds
packages/workflow/tool-ralph/README.md:86-93Completion is worker self-declaration without an independent evaluator, and round count is the only aggregate effort bound while token, price, and elapsed-time budgets are deferred.3434
OPEN-REPLAY-CONCURRENCY
Concurrent-delegation and failure-expression gaps in replay
packages/test-support/llm-replay/README.md:77-80First-call-order script binding assumes sequential delegation, concurrent siblings bind nondeterministically, and some throw, hang, and summarizer cases require a sidecar.3434
OPEN-SANDBOX-DOC-OMISSION
Windows omission in the parent sandbox README summary
packages/sandbox/sandbox/README.md:5-26The implementation-summary parenthetical lists only Linux and macOS, while the same page's fail-closed error includes the Windows ACL runner.3434
OPEN-SANDBOX-PLATFORM-LADDER
Actual platform ladder of the sandbox provider
packages/sandbox/sandbox-local/README.md:1-15The provider README explicitly lists Linux bwrap and Landlock, macOS Seatbelt, and the Windows ACL restricted-token runner.3434
OPEN-SANDBOX-PLATFORM-LIMITS
Per-platform sandbox enforcement limits
packages/sandbox/sandbox-local/README.md:34-40Windows ACL and older Landlock ABIs may be partial, Seatbelt depends on deprecated sandbox-exec, runner selection is cached, and a custom runner is an operator assertion.3434
OPEN-SANDBOX-SCOPE
Explicit scope of the sandbox seam
packages/sandbox/sandbox/README.md:37-43The contract covers file effects rather than network, process, syscall, device, or credential restrictions and explicitly bounds same-world confinement, stderr denial classification, and in-band runner diagnostics.3434
OPEN-SETTINGS-CROSS-PROCESS
Cross-process consistency boundary of settings
packages/settings/settings/README.md:41-45The settings seam serializes by namespace only in-process; cross-process convergence belongs to the provider, and the local file provider resolves same-namespace conflicts last-write-wins.3434
OPEN-SETTINGS-REDACTION-DOC
Public limitations of settings wire redaction
packages/settings/settings/README.md:41-45The public documentation records both the walker blind spot and serialized schema-default path and defers a fail-closed describeForWire boundary.3434
OPEN-SNAPSHOT-BACKEND-GAP
Backend gap in snapshot harvesting
packages/test-support/acp-snapshot/README.md:74-78Session harvest supports raw JSONL only; compressed JSONL and SQLite compositions have no snapshot-harvest path.3434
OPEN-TELEMETRY-HANDOFF
Exact semantics of the telemetry handoff cursor
packages/session/session-telemetry/README.md:13-35Disclosure does not claim delivery; the cursor marks handed-off rather than delivered, resume does not backfill prior-process misses, and receivers still need deduplication.3434
OPEN-TELEMETRY-LIMITS
Telemetry delivery and redaction limitations
packages/session/session-telemetry/README.md:45-49A backend queue may be lost on crash, the seam ships no redaction rule, and on-demand replay uses policy current at trigger time.3434
OPEN-WEB-SSRF
SSRF gap in HTTP fetch
packages/web/web-fetch-http/README.md:17-51The provider bounds protocol, size, timeout, content, and same-origin redirects but has no private-destination blocking, post-resolution validation, or per-hop revalidation, and says not to enable it where sensitive internal targets are reachable.3434
OPEN-WORKFLOW-DURABILITY
Workflow durability and budget gaps
packages/workflow/workflow/README.md:53-59Supports foreground collection only, with no journaling or resume, saved or nested workflows, cross-child token budget, or service-level tracking of live runs.3434
OPEN-WORKFLOW-ISOLATION
Workflow worker and vm are not a security boundary
packages/workflow/workflow-worker-thread/README.md:5-22The worker isolates synchronous execution and permits termination, but node:vm only shapes APIs; an escaped script can obtain host-process authority and untrusted scripts require another engine.3434
PARALLEL-AGENT-README
Current concurrency semantics in the agent-loop README
packages/core/agent-loop/README.md:68-74The README accurately describes exclusive barriers, the bounded rolling pool, body-only overlap, ordered policy/results/context, and draining on cancellation or scheduler failure.1818
PARALLEL-README
Native and Code Mode concurrency in the tools README
packages/core/tools/README.md:119-130The README describes Code Mode's independent per-run pool, default cap of ten, exclusive barriers, ordered contexts, and settlement drain while distinguishing it from the native scheduler under the same classification principle.1818
PERSIST-ATTACH-DECODE-DOC
Attachment README claims full decode on read
packages/attachment/attachment-local/README.md:1-7The README explicitly says both write admission and reads fully decode the raster before accepting format and dimensions.1111
PERSIST-ATTACH-LIMITS
Indefinite Attachment retention limitation
packages/attachment/attachment-local/README.md:17-21Known limitations explicitly state that objects are retained indefinitely and reference-aware garbage collection is deferred.1111
PERSIST-WORKSPACE-OWNERSHIP
Workspace deletion and ownership boundary
packages/workspace/workspace/README.md:11-23Workspace deletion removes only registration, durable order entry, and Session accounting; it never touches the directory, user files, live Sessions, or persisted logs.1111
PERSIST-WORKSPACE-REFRESH-DOC
Workspace README refresh statement
packages/workspace/workspace/README.md:41-44The README says external Session deletion or cwd damage is observed after the next refresh or restart.1111
PKG-HIERARCHY
Package groups and dependency direction
packages/README.md:5-67Responsibilities and publication expectations for 49 package groups, plus the rule that extensions depend only on service definitions.0303
PLANSTATE-DOC-GOAL-COMMAND
Stale status-widget limitation in the command-goal README
packages/goal/command-goal/README.md:53-58The README still says there is no continuous status widget, although the current Web ships a projection-driven GoalBar.1515
PLANSTATE-DOC-GOAL-TOOL
Stale concludeTurn claim in the tool-goal README
packages/goal/tool-goal/README.md:13-18The README says autonomous complete and blocked call concludeTurn, contradicting the current deferContext source and tests.1515
PLANSTATE-DOC-GOAL-UI
Stale inbox/context architecture in the ui-goal README
packages/client/ui-goal/README.md:5-21The Model Experience section still says Remote mutations write agent/inbox/spliced and queue Goal context, while also documenting that the projection omits activation.1515
PLANSTATE-PLAN-LIMITATION
Documented Plan recovery and presentation constraints
packages/plan/plan-mode/README.md:92-98The README records loss of a post-final-pre-Step selection on process exit, Fork versus spawn behavior, live-child review restrictions, and the Web-only specialized renderer.1515
SANDBOX-DOC-BACKENDS
Backend and consumer drift in the sandbox README
packages/sandbox/sandbox/README.md:11-13The README implementation summary lists only Linux and macOS local backends and only Bash as a consumer, while current production code also contains Windows ACL and the filesystem sandbox consumer.2020
SANDBOX-DOC-BOUNDARY
Official sandbox boundary and in-band diagnostic limits
packages/sandbox/sandbox/README.md:37-43The README explicitly limits the policy to file effects, excludes network, process, syscall, device, and credential restrictions, and records the in-band limits of stderr denial and runner attribution.2020, 33
SANDBOX-DOC-ERROR-CODE
Missing error code in the filesystem README
packages/fs/fs/README.md:49-51The README's stable FsErrorCode enumeration lists many errors but omits FS_SANDBOX_DENIED, which the source type defines, creating concrete documentation drift.2020
SANDBOX-E2B-LIMITS
E2B filesystem synchronization, lock, and reopen limits
packages/e2b/fs-e2b/README.md:26-32The README explicitly has no host synchronization, limits mutation coordination to the host process, allows replacement races with external writers, and records a reopen race between canonical path resolution and stream opening.2020
SANDBOX-FS-LOCAL-LIMITS
Local filesystem concurrency and cleanup limits
packages/fs/fs-local/README.md:40-45The README states that mutation locks are process-local, only guarded create has cross-process no-replace, replacement can still race, and failed post-commit staging cleanup leaves residue.2020
SANDBOX-OBSERVATION-DOC
First-wins and removable semantics of the observation gate
packages/fs/fs-observation-policy/README.md:30-50The README defines the three fs event decisions, states that intent slots are first-wins by registration order, and says removing the plugin falls back to unconditional write and edit on the bare provider.2020
SANDBOX-OBSERVATION-LIMITS
Known guarantee boundaries of observation policy
packages/fs/fs-observation-policy/README.md:68-73Official limits state that state does not persist across resume, actors without sessions cannot satisfy policy, direct ctx.fs reads do not record, and a windowed read authorizes by version without proving complete viewing.2020, 33
SANDBOX-WINDOWS-CAPS
Partial Windows ACL capability and cleanup boundary
packages/sandbox/sandbox-windows-acl/README.md:73-82The official boundary records Everyone and hard-link bypasses, standing workspace ACEs, revocable per-session temp capabilities, and inert residue after crashes or cleanup failures.2020
SDK-WIRE-LIMITS
Documented SDK wire limitations
packages/sdk/protocol/README.md:35-39The protocol has no version negotiation, prompt cancel, or session close; serverInfo.version is 0.0.1 without expected-version comparison, and server-to-client requests are currently a dead capability.2929
SEC-DYNAMIC-ROOT-SCOPE
Session ownership and process-wide effect scope for dynamic packages
packages/extensions/tool-cordis/README.md:11-23The public tool contract says each verb is controllable only from the defining Session, while an active package may affect other Sessions in the same process, and states that the sandbox is not a security boundary.3131
SEC-E2B-LIMITS
E2B filesystem synchronization and race limits
packages/e2b/fs-e2b/README.md:26-32The remote filesystem does not automatically synchronize with the Host, coordination is Host-process-local, and close/reopen has a documented race.3131
SEC-FS-LOCAL-LIMITS
Local-filesystem boundaries and races
packages/fs/fs-local/README.md:36-45cwd is not a sandbox; absolute paths and .. can escape, mutation locks are process-local, cross-process guarded replacement and metadata version tokens can race, and failed cleanup may leave staging residue.3131
SEC-OBSERVATION-LIMITS
Explicit observation-policy limits
packages/fs/fs-observation-policy/README.md:68-73Observation state does not survive resume, direct ctx.fs reads are not observations, and a windowed read authorizes a full overwrite while the version is unchanged; the mechanism is a freshness gate, not authorization.3131
SEC-SANDBOX-SCOPE
Explicit sandbox exclusions
packages/sandbox/sandbox/README.md:37-43The documentation excludes syscall, device, and credential restrictions and records the limits of same-world confinement, stderr classification, and forgeable in-band diagnostics.3131
SHELL-JOBS-UI
Read-only Web Job mirror and restart semantics
packages/client/ui-jobs/README.md:5-24The Web renders read-only live and settled rows from a Host mirror; restart empties the list while the transcript retains start cards, and unowned Jobs are visible to every Session.2121
SHELL-PWSH-DOC-DRIFT
Stale PowerShell inject names in README
packages/shell/tool-pwsh/README.md:5-9The README declares the tool-pwsh inject list as tools/bash/systemPrompt/bashEnv.2121
TINV-POLICY
Layered testing policy
docs/testing.md:7-15Defines the distinct proof boundaries of unit, per-file coverage, real-API, keyless snapshot, and browser snapshot tiers.3232, 33
WEBUI-DETAILS-LIMIT
Tool-details entry-point gap
packages/client/ui-conversation/README.md:57-64The conversation documentation records that openDetails exists but has no caller in the current assembly, leaving raw selected-call details unreachable.3030
WEBUI-DEVELOPER-PREVIEW
Developer Preview status
README.md:9-11The root README labels the project Developer Preview and warns that current versions may contain breaking changes.3030
WEBUI-UNLOAD-LIMIT
General client-unload-chain gap
packages/client/runtime/README.md:89-92The runtime's public Known Limitations states that loader.unload is still a stub with no general chain from fiber disposal through registration and style removal.3030
production-config · 57
IDPinned sourceWhat this excerpt supportsFirst citationAll citing chapters
ACP-PACKAGE
ACP adapter release version and standard SDK pin
packages/acp/acp/package.json:1-36The public adapter package is version 0.1.0-rc.5 and pins @agentclientprotocol/sdk 0.25.1.2929
APPROVAL-SHIPPED-PRESETS
Three shipped permission combinations
packages/bundle/base/cordis.patch.yml:166-205The base bundle composes read-only+ask, workspace-write+ask, and danger-full-access+never, with an environment-derived deployment default.1919
BASE-BUNDLE-SEMANTICS
Base-bundle patch and activation semantics
packages/bundle/base/cordis.patch.yml:1-24Base is one insert over an empty root; later layers are last-write-wins by ID, config is replaced wholesale, and row order carries no load semantics.0404
BASE-BUNDLE-SPINE
The base bundle runtime spine
packages/bundle/base/cordis.patch.yml:24-100Base directly assembles shared LLM, session, API, agent, jobs, retry, settings, credentials, adapter, and JSONL persistence services.0404
CAP-LSP-OPTIONAL
LSP in the optional E2B composition
examples/headless-agent/e2b.cordis.yml:35-57The example explicitly mounts lsp, its stdio provider, a pinned TypeScript server command/extension map, and tool-lsp, showing that availability depends on optional composition.2222
CAP-SKILL-BASE
Base Skill service and default tool rows
packages/bundle/base/cordis.patch.yml:232-248The base composition mounts agent instructions, the Skill registry, filesystem provider, and tool-skill while leaving the badge disabled.2222
CAP-SKILL-SHIPPED
Scoped Skill discovery and loader in the Standard preset
apps/cli/config/agent-presets/standard/agent.cordis.yml:76-87The Standard preset registers filesystem discovery and tool-skill into its layered registry view while also merging deployment-global contributions.2222
CAP-WEB-SHIPPED
Shipped composition enables DeepSeek Search only
packages/bundle/base/cordis.patch.yml:396-418Base pins deepseek-official search, mounts its provider, exposes web_search with 60 seconds, and disables fetch with no fetch provider because SSRF protection is deferred.2222
CODEMODE-HEADLESS-COMPOSITION
The headless bundle mounts CodeRuntime while mode remains opt-in
packages/bundle/headless/cordis.patch.yml:17-26The headless bundle maps tools.mode to DSH_TOOLS_MODE and mounts the worker-thread CodeRuntime; when mode is unset, the schema default remains native.2323
CODEMODE-SELF-MOD-OPTIN
Model self-modification tools are an explicit opt-in overlay
examples/headless-agent/advanced.cordis.yml:28-34The advanced headless example explicitly adds CodeRuntime, the Cordis host runner, and tool-cordis; the base bundle does not automatically add model self-modification tools to every agent.2323
CODEMODE-WEB-COMPOSITION
The web bundle's temporary process-wide Code Mode switch
packages/bundle/web-app/cordis.patch.yml:35-50The web bundle also selects native/code/both through DSH_TOOLS_MODE and labels that environment variable a temporary process-wide seam until per-session UI selection exists.2323
HEADLESS-BUNDLE
The headless product surface
packages/bundle/headless/cordis.patch.yml:1-35Headless mounts no Host, HTTP, Web, or browser plugins; it adds only the code runtime, launch-argument provider, and a one-shot Agent driver.0404
MEMORY-DEFAULT-COMPOSITION
Default JSONL persistence with full-text indexing disabled
packages/bundle/base/cordis.patch.yml:98-121Base writes Session logs under the DSH home sessions directory and mounts SQLite sessionQuery; openAt never preserves exact reads, titles, and lineage while search fails and SQLite is never opened.1414
MEMORY-MINIMAL-PRESET
The minimal preset explicitly omits runtime context, compaction, and Skills
apps/cli/config/agent-presets/minimal/agent.cordis.yml:1-62Minimal is a fixed-prompt two-tool composition that suppresses runtime-context snapshots, mounts only persistent Bash and str_replace_editor, and explicitly states that context compaction is absent.1414
MEMORY-STANDARD-PRESET
Skills and compaction in the standard preset
apps/cli/config/agent-presets/standard/agent.cordis.yml:76-155The standard preset mounts the filesystem Skill provider, model-facing Skill tool, basic compaction, manual command, and tool-result pruner.1414
MULTIAGENT-BASE-COMPOSITION
Base-bundle multi-agent composition
packages/bundle/base/cordis.patch.yml:292-338Base registers the subagent service, spawn/fork providers, control/list tools, and report setup, binding spawn to continuable and fork to one-shot.2424
MULTIAGENT-CODE-PRESET
Continuable fork and disabled external tools in the Code preset
apps/cli/config/agent-presets/code/agent.cordis.yml:164-220The Code preset configures both spawn and fork as continuable and retains disabled Codex/Claude Code tool rows.2424
MULTIAGENT-CORDIS-PRESET
Continuable fork in the Cordis preset
apps/cli/config/agent-presets/cordis/agent.cordis.yml:155-220The Cordis preset configures both spawn and fork tools as continuable and keeps external-product tools disabled.2424
MULTIAGENT-STANDARD-PRESET
Complete delegation configuration in the Standard preset
apps/cli/config/agent-presets/standard/agent.cordis.yml:1-251The Standard preset mounts control/list tools, configures both spawn and fork as continuable, keeps Codex/Claude Code tool rows disabled, and does not load their external providers.2424
MULTIAGENT-WEB-PLANE
Subagent boundary between Web host and Agent planes
packages/bundle/web-app/cordis.patch.yml:367-390Web retains the cross-Session registry/backends on the host plane and disables base model-facing delegation/control tools so Session presets can choose them.2424
OBS-BASE-DEFAULT
Shipped telemetry defaults
packages/bundle/base/cordis.patch.yml:129-161The base bundle defaults to DISABLED, mounts no redaction, and specifies endpoint, gzip, batch, queue, and shutdown settings.2828
OBS-OTEL-DEPENDENCIES
OTel dependency surface of the telemetry backend
packages/session/session-telemetry-otel/package.json:33-41The manifest declares the generic OTel API, Logs API/SDK, resources, the OTLP exporter base, and the OTLP log exporter, with no trace or metrics SDK.2828
OPEN-CI-SERIAL-LANES
Current state of hosted and self-hosted serial lanes
.github/workflows/ci.yml:491-696Hosted Linux and macOS serial reference jobs are disabled with if:false, while self-hosted Linux and Windows serial lanes run only on master pushes and do not block pull requests.3434
OPEN-CI-VERDICT
Dependency boundary of all-checks-passed
.github/workflows/ci.yml:904-935all-checks-passed aggregates named jobs in the same workflow and explicitly excludes windows-native; that dependency graph alone does not prove the repository's live ruleset or required-status configuration.3434
OPEN-CI-WINDOWS-SIGNALS
Wine aggregate input and independent native-Windows signal
.github/workflows/ci.yml:328-489The pull-request windows job invokes the Wine runner on hosted Linux; the real-Windows-kernel job runs the complete inventory but is explicitly absent from all-checks-passed.needs.3434
OPEN-CLI-VERSION
Current CLI package version
apps/cli/package.json:1-12At the pinned commit, the apps/cli package version is 0.1.0-rc.5, different from the host.describe placeholder.3434
OPEN-REAL-API-CI
Secret and skip boundary of real-API E2E
.github/workflows/e2e.yml:1-65The separate workflow skips the entire job for fork and Dependabot pull requests, and its comment states that a job-level skip reports as a successful check.3434
OPEN-SANDBOX-CI
Aggregate boundary and run guard of the real-kernel sandbox workflow
.github/workflows/sandbox.yml:1-113The workflow runs only on master pushes; its matrix covers bwrap, x64 and arm64 Landlock, and Seatbelt, and its command requires both platform files to have run so a self-skip cannot pass green.3434
PLANSTATE-SHIPPED-PLAN-POLICY
Shipped base-profile Plan policy
packages/bundle/base/cordis.patch.yml:265-279The shipped policy requires non-mutating exploration, a decision-complete plan, a stable tool catalog, and forbids substituting todo_write for Plan.1515
PLANSTATE-SHIPPED-TODO-POLICY
Shipped base-profile Todo parallel policy
packages/bundle/base/cordis.patch.yml:367-375The shipped base profile mounts tool-todo with allowParallelInProgress explicitly set to true.1515
PROJ-SHIPPED-COMPOSITION
The shipped composition explicitly mounts persistence, projections, and checkpoint policy
packages/bundle/base/cordis.patch.yml:98-356The base patch mounts JSONL Session persistence, the shared projection registry, and the semantic checkpoint policy for model requests and top-level tools as separate rows rather than one implicit service.1212
SANDBOX-E2B-COMPOSITION
Same-world composition for headless E2B
examples/headless-agent/e2b.cordis.yml:1-41The example disables local subprocess and fs, inserts the E2B owner plus remote subprocess and fs with full sandbox policy, and documents that cwd, policy root, and Bash or PTY workdir must name the same remote directory.2020
SANDBOX-SHIPPED-FS
Shipped filesystem policy and tool layers
packages/bundle/base/cordis.patch.yml:210-230The base bundle composes tool-fs, tool-fs-search, and fs-observation-policy together, so model mutations pass through the observation gate in the default composition.2020
SANDBOX-SHIPPED-FS-PROVIDER
Shipped sandboxed filesystem provider
packages/bundle/base/cordis.patch.yml:441-445The base bundle's provider row explicitly installs @deepseek-ai/dsh-fs-sandbox rather than the bare local filesystem.2020
SANDBOX-SHIPPED-POLICY
Shipped sandbox and approval defaults
packages/bundle/base/cordis.patch.yml:166-205The base bundle installs the local sandbox and shared policy, defaults the mode to workspace-write, derives ask approval for it, and ships read-only, workspace-write, and danger-full-access presets.2020
SEC-SELF-MOD-OPTIN
Explicit opt-in for self-modification
examples/headless-agent/advanced.cordis.yml:28-34The advanced headless example explicitly inserts the dynamic Host runner, showing that self-modification is not an unconditional core capability.3131
SEC-SHIPPED-PERMISSION
Shipped permission modes and launch default
packages/bundle/base/cordis.patch.yml:163-205The base composition provides read-only + ask, workspace-write + ask, and danger-full-access + never, defaults to workspace-write, and permits DSH_PERMISSION_MODE override.3131
SHELL-MINIMAL-COMPOSITION
Minimal isolated persistent-shell composition
apps/cli/config/agent-presets/minimal/agent.cordis.yml:1-60Minimal composes only persistent Bash and an editor through an isolated Terminal service, Bash backend, and persistent wrapper, without raw Terminal tools.2121
SHELL-STANDARD-COMPOSITION
Standard one-shot shell and Job composition
apps/cli/config/agent-presets/standard/agent.cordis.yml:35-74Standard selects tool-bash or tool-pwsh by platform and places model Job controls in the Agent preset while the registry remains on the Host.2121
TINV-CI-LINUX
Linux static, coverage, and consumer gates
.github/workflows/ci.yml:63-257Defines independent Linux static-analysis, coverage, and consumer-verification jobs and their dependencies.3232
TINV-COVERAGE-BAR
Per-file full-coverage threshold
vitest.config.ts:264-283Enables per-file thresholds and sets statements, branches, functions, and lines to 100 percent.3232
TINV-COVERAGE-EXEMPT
Parallel roster for heavy suites
scripts/coverage-exempt.ts:1-41Explains which suites skip instrumentation, why they still run under ordinary Vitest, and the roster's maintenance premise.3232
TINV-COVERAGE-SCOPE
Coverage inclusion and exclusion surface
vitest.config.ts:160-268Limits coverage inclusion to the package src glob; examples and vendor lie outside it, while types, self-executing entries, and documented GUI, composition, and other special paths are explicitly excluded within it.3232
TINV-NODE-MATRIX
Node version matrix
.github/workflows/ci.yml:260-296Installs dependencies and runs the same check:node-compat compatibility-smoke command in independent Node 22.19 and 26 matrix jobs.3232
TINV-PLATFORM-COVERAGE
Platform-conditional coverage surface
vitest.config.ts:21-84Adjusts suite and source exclusions for Windows, POSIX, and pwsh availability, giving the report platform-specific scope.3232
TINV-REQUIRED-VERDICT
all-checks-passed result aggregation
.github/workflows/ci.yml:904-935Lists aggregate dependencies, excludes native Windows, and makes skipped, cancelled, or failed results fail the aggregate; the YAML alone does not prove the live ruleset.3232
TINV-SNAPSHOT-MODE
Keyless snapshot modes
vitest.snapshot.config.ts:19-67Makes replay the credential-free default, loads environment only for record, reuses scripts for refresh, and separates parallel from serial execution.3232
TINV-WINDOWS
Wine and native Windows jobs
.github/workflows/ci.yml:328-489Defines the pull-request Wine job and a complete job on a real Windows kernel; the latter is explicitly absent from all-checks-passed.needs.3232
TOOLCAT-ATTACHMENT
JSONL, local attachments, and disabled FTS in the base Host
packages/bundle/base/cordis.patch.yml:98-115The baseline Host mounts a local attachment service, allowing the standard fs package to register read_image; the same region shows Session Query present while full-text search defaults to openAt never.1717
TOOLCAT-MINIMAL
The complete two-tool minimal composition
apps/cli/config/agent-presets/minimal/agent.cordis.yml:1-62Minimal uses a complete fixed persona, suppresses runtime context, omits compaction, and exposes only persistent bash and str_replace_editor in isolated PTY and filesystem realms.1717
TOOLCAT-STANDARD-BASE
Shell, filesystem, jobs, Skill, Goal, and plan tools in the standard preset
apps/cli/config/agent-presets/standard/agent.cordis.yml:35-124The preset selects one platform shell, mounts fs/search, job controls, Skill, Goal, and the stable exit_plan_mode schema, and explicitly keeps the tool catalog unchanged across plan-mode transitions for request-cache stability.1717
TOOLCAT-STANDARD-ORCHESTRATION
Delegation, workflow, interaction, and Web tools in the standard preset
apps/cli/config/agent-presets/standard/agent.cordis.yml:157-251The preset mounts three child controls, continuable spawn and fork names, workflow, Ralph, ask, todo, and search-only Web, while explicitly disabling Codex and Claude Code delegation and fetch.1717
WEB-AGENT-PLANE
The Web host-plane and agent-plane boundary
packages/bundle/web-app/cordis.patch.yml:276-408Web disables per-Agent capability rows from base and mounts them through per-session presets, while cross-session registries and host-API dependencies remain in the host plane.0404
WEBUI-DUAL-ROSTER
Host and browser plugin rosters
packages/bundle/web-app/cordis.patch.yml:97-203The web bundle configures Host services alongside modules, connection, runtime, and UI plugins carrying dsh.client entries.3030
WORKFLOW-SHIPPED-BASE
Shipped Workflow and Ralph composition in Base
packages/bundle/base/cordis.patch.yml:315-382Base mounts the worker engine and workflow tool over spawn, plus Ralph over spawn with a 64-round ceiling.2525
WORKFLOW-SHIPPED-PRESET
Per-Agent Workflow isolation in the Standard preset
apps/cli/config/agent-presets/standard/agent.cordis.yml:165-233The delegation group isolates workflowEngine and mounts the worker, generic tool, and 64-round Ralph in the same entry-local realm.2525
WORKFLOW-WEB-ISOLATION
Web host plane disables base Workflow rows
packages/bundle/web-app/cordis.patch.yml:380-410The Web overlay disables base subagent, workflow engine, workflow tool, and Ralph rows so session presets determine Agent capabilities.2525
production-source · 805
IDPinned sourceWhat this excerpt supportsFirst citationAll citing chapters
ACP-CHILD-CANCEL
ACP child cancellation, partial output, and authoritative reaping
packages/subagent/subagent-acp/src/run.ts:94-367Caller abort can immediately settle aborted with text collected so far and one best-effort session/cancel; dispose remains authoritative, requests cancel only if not already requested, and then applies the shared EOF-to-terminate-to-whole-tree-exit reaper.2929
ACP-CHILD-CAPABILITIES
ACP child backend capability and cwd boundary
packages/subagent/subagent-acp/src/index.ts:124-169Each out-of-process child uses configured cwd or the parent session cwd and rejects an implicit process-cwd fallback; the provider advertises no output schema, depth, tool filter, or persona capability and does not inherit parent context.2929
ACP-CHILD-ENV-MERGE
Explicit env merge in the local subprocess provider
packages/subprocess/subprocess-local/src/spawn.ts:17-352The local provider starts from scrubbedParentEnv, merges explicit env/tombstones with target-platform semantics, and passes the result to process spawn.2929
ACP-CHILD-ENV-POLICY
Shared subprocess environment-scrubbing policy
packages/subprocess/subprocess/src/index.ts:37-65The shared scrub removes credential-shaped and DSH_* names from ambient parent env while retaining ordinary runtime variables; explicit env is merged afterward.2929
ACP-CHILD-START
ACP child startup transaction
packages/subagent/subagent-acp/src/run.ts:190-367Every run starts a fresh process and the parent separately mints a globally unique lifecycle id; the handle is published only after initialize and session/new succeed, and any spawn, handshake, or cancellation failure reaps the private child first.2929
ACP-CODEC
ACP content and stop-reason mapping
packages/acp/acp/src/codec.ts:9-65Baseline text concatenates verbatim, resource_link becomes an explicit bracketed reference, and other blocks reject; completed, interrupted, max-token, and other turn endings map into ACP vocabulary, with max-token becoming max_tokens at the codec layer.2929
ACP-HANDSHAKE
ACP initialize, authentication, and fresh sessions
packages/acp/acp/src/index.ts:231-436The server always returns the standard SDK's PROTOCOL_VERSION, minimal prompt capabilities, and empty authMethods, with authenticate as a no-op; session/new accepts only an absolute primary cwd, empty additionalDirectories, and an empty MCP server list, then creates a fresh session.2929
ACP-OUTPUT-PERMISSION
ACP committed output and permission requests
packages/acp/acp/src/index.ts:130-229The bridge sends only committed assistant/message text or image placeholders; sessionUpdate transport/write rejection is caught and warned, while a client-handler failure cannot feed back through a response-free notification. Owned tool-call approvals are one-shot allow/reject and fail closed on cancellation or unknown choices.2929
ACP-PROMPT-CANCEL
ACP prompt correlation, errors, and cancel
packages/acp/acp/src/index.ts:145-345Each session permits one in-flight prompt; turn/end correlates the captured turn exactly, but the agent/error fallback for an uncaptured or different turn has no message causality and may misattribute. Output and settlement span whole-agent-to-idle, the max-token wrapper lowers to end_turn, and cancel affects only the target.2929
ACP-QUIESCE
ACP connection-owned quiescence
packages/acp/acp/src/index.ts:348-415Connection close and plugin disposal share memoized quiescence: admission closes, the map clears, and prompts cancel and settle; owned-descendant drain failure only warns, after which handle-disposal failures alone are aggregated from allSettled.2929
ACP-SDK-CONNECTION
ACP standard stream and connection wiring
packages/acp/acp/src/index.ts:348-353The adapter wraps stdio with the SDK ndJsonStream and constructs the SDK AgentSideConnection.2929
ACP-SDK-IMPORTS
ACP adapter standard-SDK imports
packages/acp/acp/src/index.ts:18-35The adapter imports PROTOCOL_VERSION, ndJsonStream, AgentSideConnection, and related ACP types directly from @agentclientprotocol/sdk.2929
AGENT-CREATE-RESUME
Create, setupAndPublish, and resume control flow
packages/core/agent-loop/src/index.ts:606-709Fresh and persisted sessions converge on one prepare/setup/commit/publish path, while resume loading is also bounded by owner, caller, and factory cancellation.0505
AGENT-FACTORY-SEAM
Factory seam between the registry and concrete loop
packages/core/agent/src/index.ts:360-430The registry effect-scopes one factory and retraces create/resume through the caller context so ownership follows the actual consumer.0505
AGENT-INBOX-COMMIT
Durable inbox-splice commit and identity invariant
packages/core/agent/src/inbox.ts:128-219agent/inbox/spliced is appended before the live projection mutates, removals may be marked canceled, and MessageId is unique across both pending lists.0505
AGENT-INBOX-REPLAY
Inbox event reconstruction and claim order
packages/core/agent/src/inbox.ts:24-78Inbox reconstructs durable splices after the seed boundary; a claim takes every next-step item first and optionally one next-turn item, then notifies per message.0505
AGENT-INITIATOR-API
Process-local initiator attribution API
packages/core/agent/src/index.ts:300-358current/require/with/withoutInitiator propagate the causal Agent of a driver through AsyncLocalStorage without treating ambient identity as authorization.0505
AGENT-INITIATOR-DRAIN
Initiator teardown drain semantics
packages/core/agent/src/index.ts:619-703Shutdown rejects new boundaries, drains returned-Promise boundaries, excludes nested chains that initiated their own unload to avoid deadlock, and finally disables storage.0505
AGENT-PREPARE-PUBLISH
Agent preparation, publication, and reverse teardown
packages/core/agent-loop/src/index.ts:453-578Caller, factory, and owner cancellation fuse before resources exist; publication orders session enter, agent enter, session announce, agent announce, and session-start; disposal shares one quiescence boundary.0505
AGENT-PUBLIC-INTERFACE
Public Agent interface and status semantics
packages/core/agent/src/runtime-types.ts:23-143Defines provider/model/maxTokens, idle/running state, session/inbox/scoped context, cancellation, idle observation, maintenance, and four input operations.0505
AGENT-REGISTRY-LIFECYCLE
AgentRegistry enter, announce, and exact detach
packages/core/agent/src/index.ts:450-617Enter verifies shared identity and arbitrates collisions, announce publishes once, reentrant detach waits for dispatch, and stale closures cannot delete a same-ID replacement.0505
AGENT-RUNTIME-SCOPE
Concrete Agent scope, phase, and input mapping
packages/core/agent-loop/src/agent.ts:63-140ReactLoopAgent restores turns and inbox state from the log, creates an Agent scope, maps idle/maintenance to idle, routes followup/steer/inject into two inbox levels, and clears pending work on cancel by default.0505
AGENT-SETUP-CONTRACT
Unpublished setup, commit, and owned-handle contract
packages/core/agent/src/index.ts:52-174Create/resume setup composes the scoped world while objects remain unpublished and may return a synchronous commit; AgentHandle is the teardown capability.0505
API-CONNECTION-LOOP
Two-stream connection generations and reconnect
packages/client/connection/src/client/connection.ts:3-201Each generation opens mux, host, and host.describe together; only after describe/handshake settles can a stream ending reach shared backoff and rebuild both. Stream-open has a 3-second guard, but describe has no generation signal/timeout and can wedge reconnect after abort; sink failures are isolated.2929
API-HOST-VERSION-CONTRACT
Host API intentionally has no protocol version
packages/host/apiproxy/src/api/host.ts:1-53The contract says client and host ship together, so protocolVersion is deferred; host.describe.version is defined as the host application package version.2929
API-HOST-VERSION-PLACEHOLDER
host.describe still returns a placeholder version
packages/host/apiproxy/src/api-proxy.ts:2923-2938An implementation TODO says version does not yet read the CLI package.json and currently returns the fixed value 0.0.1.2929
API-HTTP-BRIDGE
HTTP bridge capacity, cancellation, and backpressure
packages/client/connection/src/http-bridge.ts:8-99Request bodies are buffered in memory with a 160 MiB default cap; browser disconnect aborts the Fetch signal, and response streaming respects drain backpressure.2929
API-HTTP-CLIENT
Browser HTTP-carrier transport failures
packages/client/connection/src/client/rpc.ts:24-46The browser throws a non-2xx HTTP response as a transport failure, then validates the response envelope and rpcId.2929
API-HTTP-HANDLER
HTTP RPC dispatch and error boundary
packages/client/connection/src/rpc-host.ts:144-223The generic Remote/Connection RPC handler accepts only POST application/json; the outer envelope and URL-method identity are checked; invalid requests receive typed bad-request results while unexpected handler throws become HTTP 500 responses.2929
API-PRIVILEGED-LOOPBACK
Loopback fence for privileged Browser APIs
packages/client/connection/src/index.ts:69-195Settings, credentials, native dialogs, preset management, and draft-credential model discovery are separately pinned to loopback authority and pass shared Fetch-Metadata/Origin-authority checks; Origin may be absent and only authority is compared when present, so this is not a full same-origin test.2929
API-RPC-MODEL
Four-quadrant browser API RPC model
packages/host/apiproxy/src/api/rpc.ts:1-193Logical messages are decoupled from HTTP, WebSocket, and in-process carriers; initiators mint rpcId values, responders echo them, and the closed union separates client requests, server responses, server requests, and client responses with business failures carried by RpcResult.2929
API-RPC-SCHEMAS
Two-stage wire validation
packages/host/apiproxy/src/api/rpc.schema.ts:1-140The outer Zod schemas validate only the message envelope while retaining unknown payload/value slots; each business method performs the second parse, and error bodies are discriminated by code with required details.2929, 33
API-TRUST-FENCE
The browser trust fence is not authentication
packages/client/connection/src/api-request-trust.ts:1-123Every /api request checks Host authority and rejects cross-site Fetch Metadata or a mismatched Origin; the source explicitly excludes network reachability and identity authentication from this fence.2929, 33
API-WS-CLIENT
Browser-side WebSocket parsing policy
packages/client/connection/src/client/web-api-client.ts:34-90Binary data, malformed JSON, invalid envelopes, and invalid business frames are logged and dropped; only socket closure ends the stream, and AbortSignal closes the socket.2929
API-WS-HOST
Downlink-only WebSocket carrier
packages/client/connection/src/websocket-downlink.ts:46-137Mux and host use independent downlink-only sockets; a client message closes with 1008, a source failure first attempts a stream/error frame, and teardown awaits pump cleanup.2929
APPROVAL-ACP-ANSWERER
ACP one-shot machine answerer
packages/acp/acp/src/index.ts:212-229ACP claims only owned Agent requests with callId, offers allow-once/reject-once, and collapses unknown non-allow outcomes to rejection.1919
APPROVAL-ASK-MAPPING
ToolRuntime ask outcome mapping
packages/core/tools/src/index.ts:1678-1728Missing approval or Agent identity denies; only allowed-once proceeds, while the other outcomes map to distinct denial reasons.1919
APPROVAL-AUDIT-EVENTS
Approval audit and policy events
packages/interaction/user-approval/src/index.ts:34-72approval/asked and approval/decided pair by id, while approval/policy is a log-only Session override event.1919
APPROVAL-AUDIT-REQUEST
Turn-enclosed approval audit transaction
packages/interaction/user-approval/src/index.ts:239-276Request requires an open turn, appends asked, awaits the decision, and appends matching decided; commit failures reject the call.1919
APPROVAL-BASH-EXECUTION
Bash escalation and process-start order
packages/shell/tool-bash/src/index.ts:190-390Bash resolves standing policy, completes one-call approval before any process starts, stamps the mode, and rejects escalation in non-sandboxed compositions.1919
APPROVAL-CANCEL-DISPATCH
Policy races and tool-body cancellation
packages/core/tools/src/index.ts:1459-1559Preparation rechecks caller cancellation, while a started body reaches quiescence before an otherwise successful result becomes aborted.1919
APPROVAL-CHILD-PIN
Delegated child permission pinning
packages/subagent/subagent/src/child-agent.ts:130-224A child inherits only the parent's explicit sandbox override, not deployment defaults or one-shot grants; approval is pinned to never after fork seed.1919
APPROVAL-DECIDE-WATERFALL
Fail-closed answerer waterfall
packages/interaction/user-approval/src/index.ts:298-344Never rejects before dispatch; absent, throwing, or rogue answerers become unavailable, and cancellation discards late answers.1919
APPROVAL-ESCALATION-FLOW
Fail-closed one-call escalation flow
packages/sandbox/sandbox/src/escalation.ts:143-188Runtime checks strict widening, approval availability, and Agent identity; only allowed-once returns the target mode for this call.1919
APPROVAL-ESCALATION-LADDER
Strict escalation ladder and argument pairing
packages/sandbox/sandbox/src/escalation.ts:22-61Read-only may widen to workspace-write/full and workspace-write only to full; permission and justification must be paired and nonblank.1919
APPROVAL-EXEC-SNAPSHOT
Execution identity and frozen arguments
packages/core/tools/src/index.ts:1364-1423ToolRuntime mints the token, resolves rootCallId, and losslessly snapshots and deep-freezes arguments before policy.1919
APPROVAL-FS-ESCALATION
Filesystem escalation controller
packages/fs/tool-fs/src/sandbox.ts:37-130The shared controller owns capability advertisement, pairing, per-call policy, approval and one-call mode, and maps sandbox denial to a structured retry hint.1919
APPROVAL-GUARD-CONTRACT
Monotonic guard contract
packages/core/tools/src/index.ts:703-753A guard returns a denial reason or abstains and has no allow result; runtime stops at the first denial.1919, 33
APPROVAL-GUARD-REGISTRY
Global and scoped guard registry
packages/core/tools/src/index.ts:1100-1127Guards register globally or per Agent scope; execution checks global first, then the scope chain farthest-first, taking the first denial.1919
APPROVAL-INVARIANT
Replay invariants for approval events
packages/interaction/user-approval/src/invariant.ts:17-102The invariant replays and checks open turns, pending asks, duplicate ids, orphan decisions, and closed vocabularies without requiring unmatched asks to clear at turn end.1919
APPROVAL-OUTCOMES
Approval identity and closed outcomes
packages/interaction/user-approval/src/types.ts:10-29Each request uses a branded id and may settle only as allowed-once, rejected, cancelled, or unavailable.1919, 33
APPROVAL-PERMISSION-COMPOSER
Composer permission selector and risk confirmation
packages/client/ui-conversation/src/client/skeleton/PermissionSelect.tsx:10-170The selector filters custom, submits /permission, and shows checkbox-gated risk confirmation only for the danger-full-access machine key.1919
APPROVAL-PERMISSION-DECORATION
Permission command popup decoration
packages/client/ui-permission-presets/src/client/index.ts:55-169The command popup builds options from the projection, attaches confirmation only to FULL_ACCESS_PRESET, and executes /permission.1919
APPROVAL-PERMISSION-SETTINGS
Default-permission Settings risk confirmation
packages/client/ui-permission-presets/src/client/PermissionRow.tsx:15-126The future-Session default UI likewise gates confirmation only for FULL_ACCESS_PRESET before invoking the settings write.1919
APPROVAL-PERMISSION-SETTINGS-WRITE
Future-Session default preset write
packages/client/ui-permission-presets/src/client/settings-store.ts:128-155The Settings controller updates defaultPreset with an expected revision, explicitly for subsequently created Sessions.1919
APPROVAL-PRE-DECISION
Closed pre-execute decision authority
packages/core/tools/src/index.ts:582-592Pre-execute may only allow, deny, or ask; argument rewriting is explicitly excluded.1919
APPROVAL-PREPARE-ORDER
Actual approval and guard order
packages/core/tools/src/index.ts:1453-1506Preparation checks cancellation, runs the pre waterfall, resolves ask, applies monotonic guards, and dispatches only after a final cancellation check.1919
APPROVAL-PRESET-CONFIG
Configurable permission presets and load-time checks
packages/interaction/permission-presets/src/index.ts:139-225Presets bundle sandbox and approval; custom is derived-only, and non-confining shells or unresolved defaults fail at load.1919
APPROVAL-PRESET-DERIVE
Deriving the current preset from real knobs
packages/interaction/permission-presets/src/index.ts:280-338A still-matching last selection wins, then the first table match, otherwise the service derives custom.1919
APPROVAL-PRESET-PIN
Initial Session permission pinning
packages/interaction/permission-presets/src/index.ts:394-430Fresh Sessions pin all three facts during synchronous session-created publication; seeded, resumed, or partial Sessions preserve effective state and fill only missing facts.1919
APPROVAL-PRESET-PROJECTION
Permissions projection and command surface
packages/interaction/permission-presets/src/index.ts:227-277The service registers the permissions projection and uses /permission as the canonical report and current-Session switch command.1919
APPROVAL-PRESET-WRITE
Canonical preset write path
packages/interaction/permission-presets/src/index.ts:369-392A changed selection records permission/preset first and writes only changed sandbox and approval knobs; a no-op writes nothing.1919
APPROVAL-PWSH-EXECUTION
PowerShell escalation and process-start order
packages/shell/tool-pwsh/src/index.ts:209-406PowerShell rejects escalation without sandbox capability; its execution path validates arguments, resolves standing policy, awaits one-call approval, stamps the mode, and only then commits a background starter or runs a foreground process.1919
APPROVAL-REQUEST-SHAPE
Approval request without duplicated arguments
packages/interaction/user-approval/src/index.ts:149-174A request carries Agent, tool name, optional callId, reason, and signal; arguments remain linked through the existing tool call.1919
APPROVAL-SANDBOX-PRECEDENCE
Sandbox policy resolution precedence
packages/sandbox/sandbox-policy/src/index.ts:126-150An approved explicit mode outranks the Session log override, which outranks the deployment default; Session cwd supplies the workspace root.1919
APPROVAL-UI-PANEL
One-shot approval panel
packages/client/ui-conversation/src/client/skeleton/ApprovalPanel.tsx:22-87The panel derives an optional shell command from the paired root call, shows the reason, and uses a one-shot latch with retry after response failure.1919
APPROVAL-WEB-REGISTRY
Host approval pending registry
packages/host/apiproxy/src/api-proxy.ts:1407-1488The proxy pairs requests with undecided, unclaimed, callId-matching audit events; abort and teardown cancel, while disconnect does not remove pending entries.1919
APPROVAL-WEB-REPLAY
Pending approval replay on reconnect
packages/host/apiproxy/src/api-proxy.ts:3429-3447A new mux subscription replays every unsettled approval request with the same stable rpcId.1919
APPROVAL-WEB-RESPOND
Exact approval-response correlation
packages/host/apiproxy/src/api-proxy.ts:3696-3742Responses route by rpcId and validate payload, Session, and approval ids; the first valid response settles and late ids are not-pending.1919
APPROVAL-WEB-TRUST
Browser request trust fence and boundary
packages/client/connection/src/api-request-trust.ts:1-122Host, Fetch Metadata, and Origin checks defend DNS rebinding and cross-site requests; the source explicitly says this is not authentication.1919
APPROVAL-WIRE-CONTRACT
Web approval wire contract
packages/host/apiproxy/src/api/approvals.ts:1-20Approval is a server request with stable rpcId; clients may return only allowed-once/rejected while echoing exact Session and approval ids.1919
BOOT-HMR
Transactional user-configuration refresh
packages/boot/app-boot/src/index.ts:225-265HMR watches the exact user patch, regenerates the full patch list, and replaces it transactionally through entry.update; shutdown races return a no-op disposer.0404
BOOT-TRANSACTION
Transactional boot and failure cleanup
packages/boot/app-boot/src/index.ts:757-801Host preparation precedes tree mounting, activation is audited after Loader settlement, and any failure disposes the partial root while preserving the deepest error stack.0404, 33
CAP-LSP-HOST-FS
LSP workspace containment and bounded source reads
packages/lsp/lsp-stdio/src/host.ts:25-120Workspace and source are canonicalized through ctx.fs; the source must be contained by the workspace and is read as complete UTF-8 text under an explicit byte cap.2222
CAP-LSP-REGISTRY
Closed extension-routed LSP seam
packages/lsp/lsp/src/index.ts:1-158LSP exposes only four normalized operations, atomically validates and reserves provider ids plus extension sets, routes by final extension, and offers no JSON-RPC escape hatch.2222
CAP-LSP-STDIO-LOAD
All-or-nothing LSP stdio activation
packages/lsp/lsp-stdio/src/index.ts:119-215The plugin validates every server and resolves every executable before provider registration; conflicts roll back, and teardown removes routes before settling every process.2222
CAP-LSP-STDIO-POOL
Per-workspace LSP process pool and serialized queries
packages/lsp/lsp-stdio/src/index.ts:216-369Each canonical workspace lazily owns one server and serializes source-read/open/query/close; one transport replacement is allowed, and disposal drains lookups, queues, and instances.2222
CAP-LSP-TOOL
Model-facing precision LSP navigation tool
packages/lsp/tool-lsp/src/index.ts:1-243One read-only lsp tool uses a four-operation enum, one-based UTF-16 positions, the Session workspace, result caps, and a 60-second timeout while recommending search/read for ordinary navigation.2222
CAP-MCP-CONFIG
One-server MCP configuration and namespace
packages/mcp/mcp-client/src/index.ts:1-128The MCP client supports stdio and Streamable HTTP; each instance connects one server and derives its public tool namespace from a constrained unique serverName.2222
CAP-MCP-GENERATION
MCP client-generation connect, close, and disposal
packages/mcp/mcp-client/src/connection.ts:227-350Each attempt creates a fresh Client/transport and syncs after connect; failure to close within the barrier stops reconnect to avoid overlap, while disposal drains attempts and syncs before unregistering.2222
CAP-MCP-NAMING
Deterministic MCP public tool names
packages/mcp/mcp-client/src/tools.ts:82-102Public names are pure functions of serverName/rawName; character or length normalization adds an identity-derived hash suffix, making collisions between distinct wire identities extremely unlikely.2222
CAP-MCP-RECONNECT
Serialized MCP sync and bounded reconnect budget
packages/mcp/mcp-client/src/connection.ts:123-224Syncs across all generations serialize; loss triggers exponential backoff, a stability window resets the budget, exhaustion unregisters tools, and the last good generation is not removed early during an outage.2222
CAP-MCP-RESULT
MCP canonical result and lossy Native projection
packages/mcp/mcp-client/src/tools.ts:176-317The bridge preserves full JSON content/structuredContent, rejects task-required and isError results, while Native rendering joins text and replaces image/audio/resource with discarded-content placeholders.2222
CAP-MCP-STARTUP
MCP initial discovery and activation policy
packages/mcp/mcp-client/src/index.ts:132-180The plugin reserves its namespace, starts the supervisor, and awaits first connection plus tool sync; failOnStartupError decides whether failure rejects activation.2222
CAP-MCP-SYNC
Two-phase MCP tool-generation synchronization
packages/mcp/mcp-client/src/tools.ts:104-174The bridge fully fetches and builds the next generation without registry mutation, then disposes old and registers new; a conflict rolls the partial new generation back to zero.2222
CAP-MCP-TRANSPORT
MCP transport bypasses the subprocess spawn seam
packages/mcp/mcp-client/src/transport.ts:15-50Stdio shares the scrubbedParentEnv definition but the MCP SDK performs the spawn; Streamable HTTP is likewise constructed by the SDK from configured URL and headers.2222
CAP-SKILL-CATALOG
Visibility-matched durable Skill replacement catalog
packages/skill/tool-skill/src/index.ts:206-335The plugin publishes name/description source entries only for its exact visible tool identity; complete digest changes append whole-list replacements, empty lists retire old names, and incomplete snapshots publish nothing.2222
CAP-SKILL-COLLECT
Skill catalog collection, caching, and incomplete observations
packages/skill/skill/src/index.ts:463-625The registry collects and caches complete catalogs by cwd/scope/revision with a bounded revision-race retry; provider failures/incomplete observations are not cached, and nearer layers overwrite.2222
CAP-SKILL-FS-ROOTS
Filesystem Skill roots, ranks, and provider lifecycle
packages/skill/skill-filesystem/src/index.ts:36-260The provider defines project/custom/user/bundled ranks, builds roots by cwd, observes watcher completeness, loads bodies by locator, and actively invalidates on model-facing file mutations.2222
CAP-SKILL-FS-TRUST
Filesystem-versus-host routing for Skill directories and bodies
packages/skill/skill-filesystem/src/index.ts:749-885Ordinary roots use ctx.fs for listing and reads when present; trusted bundled roots may use Node host FS; frontmatter is parsed and missing/non-text entries are treated as unavailable.2222
CAP-SKILL-LAYERS
Layered Skill registry and runtime contributions
packages/skill/skill/src/index.ts:346-461Registrations enter the calling context's global/scoped layer; nearer same-name entries override outright, rank selects only within one layer, and providers/runtime skills are effect-scoped.2222
CAP-SKILL-RENDER
Canonical Skill wrapper and trusted body
packages/skill/skill/src/index.ts:140-228Explicit user invocation carries a durable source; the shared skill_content wrapper escapes framing metadata but embeds the instruction body verbatim because it is trusted local content.2222
CAP-SKILL-TOOL-LOAD
Skill loader visibility and double revalidation
packages/skill/tool-skill/src/index.ts:71-161The model tool lists by Agent cwd/scope and checks the summary, then gets and rechecks the loaded definition's modelInvocable policy before returning body and resource base.2222
CAP-SKILL-TYPES
Skill summaries, candidates, definitions, and invocation policy
packages/skill/skill/src/index.ts:20-109Skill types separate routing summaries, ranked/provider-located candidates, and full bodies while independently expressing model/user invocation and three resource-base kinds.2222
CAP-SKILL-USER-INVOKE
Explicit user Skill gestures and instruction injection
packages/skill/tool-skill/src/index.ts:163-430Only whitespace-bounded /name tokens in direct user-source text are scanned; the loaded definition must be userInvocable and is then injected last as instructions using the shared wrapper.2222
CAP-WEB-DEEPSEEK-MAP
DeepSeek native-search result normalization
packages/web/web-search-deepseek/src/provider.ts:112-174The adapter requires web_search_tool_result, joins citation excerpts by URL, deduplicates sources, and leaves final result-count truncation to the Web seam.2222
CAP-WEB-DEEPSEEK-REQUEST
DeepSeek Search request, cancellation, and credential resolution
packages/web/web-search-deepseek/src/provider.ts:176-300Each search snapshots config, records before dispatch, rejects redirects, sends compatible auth headers, distinguishes cancellation/HTTP/parse failures, and resolves credentials per operation.2222
CAP-WEB-DEEPSEEK-SETTINGS
Per-operation Search settings projection and logging
packages/web/web-search-deepseek/src/index.ts:95-138The provider resolves the next operation from the current Settings section plus credential/environment seams and appends the secret-free request to the current initiator Session.2222
CAP-WEB-DEEPSEEK-WIRE
Provider-private DeepSeek Search wire
packages/web/web-search-deepseek/src/provider.ts:1-109Search uses a separate Anthropic-compatible Messages endpoint, native web_search server tool, and secret-free auxiliary request shape without going through ctx.llm.2222
CAP-WEB-FETCH-CAPS
Fetch byte caps and truncation semantics
packages/web/web-fetch-http/src/provider.ts:149-207An oversized declared length rejects; a stream crossing the cap retains only a bounded prefix and marks truncation; completed chunks are assembled into exact bytes.2222
CAP-WEB-FETCH-POLICY
HTTP fetch URL and content policy
packages/web/web-fetch-http/src/policy.ts:14-105The optional fetcher accepts only HTTP(S), rejects embedded credentials, bounds URLs, defines same-origin redirect semantics, and classifies/decodes supported text while explicitly deferring SSRF blocking.2222
CAP-WEB-FETCH-TRANSPORT
Anonymous bounded same-origin HTTP fetch
packages/web/web-fetch-http/src/provider.ts:1-147The fetcher carries no cookies or ambient credentials, unifies cancellation and timeout, handles same-origin redirects manually, rejects unsupported content, and returns status plus decoded body.2222
CAP-WEB-SELECTION
Deterministic execution-time Web provider selection
packages/web/web/src/index.ts:49-200The Web seam separates search and fetch registries, rejects duplicate ids, and selects at call time by explicit configuration or exactly one usable provider; ambiguity and unavailability fail structurally.2222
CAP-WEB-TOOL
Web tool registration decoupled from provider availability
packages/web/tool-web/src/index.ts:1-91tool-web owns schemas, enablement, limits, and timeouts; an enabled tool remains visible when its provider is unavailable and fails structurally at execution.2222
CAP-WEB-TYPES
Normalized Web request and result vocabulary
packages/web/web/src/types.ts:15-129Search returns optional content and citeable sources; fetch returns final URL, status, a closed HTML/text body union, and truncation, with non-2xx represented as a result.2222
CLI-PROFILE-DISPATCH
CLI launch-mode dispatch
apps/cli/src/bin.ts:27-52After parsing, the CLI dispatches only profile, plugin, and dump-config modes; the profile path receives the environment snapshot, profile, patches, and inner arguments.0404
CODEMODE-ACTIVATION
Updates retract the old run before committing current on success
packages/extensions/cordis-host-runner/src/index.ts:810-992A new activation first awaits retraction of the old run, then starts Host/Client; a Client-bearing run stays client-pending, and only successful commitActivation sets currentPackageId and clears next. Failure retracts only the new run it owns.2323
CODEMODE-APPROVAL-SETTLE
First-answer and exact-run checks for approval responses
packages/extensions/cordis-host-runner/src/index.ts:406-428resolveRequestRun accepts only a still-pending response naming the exact active pluginRunId, claims it, settles activation, broadcasts resolution, and steers the result; unknown, stale, or duplicate responses return accepted:false.2323
CODEMODE-BINDINGS
Binding snapshot, recursion exclusion, and convergence
packages/core/tools/src/code-mode.ts:596-640Each run builds a null-prototype tools namespace from the calling agent's currently visible schemas, excluding run_code; after runtime settlement it aborts and drains every nested call before converting failures to CODE_RUN_FAILED or returning curated logs/result.2323
CODEMODE-CLIENT-EVAL
The browser half's closure symbol surface
packages/extensions/cordis-client-runner/src/client/evaluator.ts:157-222Client source executes in a browser new Function async body whose parameters explicitly inject React, console, styles, host.call, and teaching traps while setting process/Buffer to undefined; the return must be a Plugin.2323
CODEMODE-CLIENT-GUARD
Browser Context facade and declared-service gate
packages/extensions/cordis-client-runner/src/client/guard.ts:180-233The Client half's ctx likewise exposes only lifecycle verbs, optional get, and declared services; slots/theme use specialized guards, while assignment and framework internals are denied.2323
CODEMODE-CLIENT-LIFECYCLE
Browser package operations serialize per Plugin and recover
packages/extensions/cordis-client-runner/src/client/runtime.ts:176-341The Client runner serializes load/unload per pluginId, replaces old activations, retracts only the exact run, and unloads all on disposal; its queue tail contains one failure so later operations do not wedge.2323
CODEMODE-CLIENT-ORCHESTRATION
Browser activation follows Host to source to Client to settlement
packages/extensions/cordis-client-runner/src/client/orchestrator.ts:312-381The page orchestrates per Plugin: start the Host half, fetch Client source for the exact active run, load the browser half, then answer approval or direct run; failures return stage-specific diagnostics.2323
CODEMODE-CONTEXT-GUARD
Dynamic Host Context is a capability facade
packages/extensions/cordis-host-runner/src/guard.ts:680-819A Host half may use only lifecycle-safe verbs, ctx.get, and declared injected services; framework internals, Context-valued service returns, and undeclared property access are denied, and apply always receives the facade.2323
CODEMODE-CORDIS-DEFINE
cordis_define only records an immutable Package
packages/extensions/tool-cordis/src/index.ts:148-238cordis_define records at least one plain-JavaScript Host/Client half for a new or existing Plugin, returns pluginId/packageId, and explicitly does not execute, request approval, or change currentPackageId.2323
CODEMODE-CORDIS-INSPECT
Three layered inspect tools
packages/extensions/tool-cordis/src/index.ts:34-146tool-cordis registers provider listing, schema-validated queries, and session-owned self inspection; exact Package source is returned only when both pluginId and packageId are supplied.2323
CODEMODE-CORDIS-LIFECYCLE-TOOLS
Model contract for run, stop, and undefine
packages/extensions/tool-cordis/src/index.ts:240-379cordis_run returns awaiting-approval, starting, or running; stop retains definitions, grants, and version pointers, while undefine stops and permanently removes the entire Plugin.2323
CODEMODE-CORDIS-PROMPT
Dynamic Plugin lifecycle, versions, and trust guidance
packages/extensions/tool-cordis/src/prompt.ts:3-54The system prompt defines dynamic Plugins as temporary current-process extensions and not a security boundary; it lists the seven-tool workflow, three identities, immutable versions, approval grants, and that a failed update does not automatically restart the old version.2323
CODEMODE-DEFINE-RUNNER
Define-time validation and Package append
packages/extensions/cordis-host-runner/src/index.ts:146-202The runner validates metadata, at least one half, both halves' syntax, and new/existing ownership, then mints a packageId and appends source; define does not start the runtime.2323
CODEMODE-DYNAMIC-TOOL-GUARD
Dynamic tool definition, JSON normalization, and bypass closure
packages/extensions/cordis-host-runner/src/guard.ts:542-655harness.defineTool validates schema/render/execute and JSON-clones cross-realm outputs; register accepts only marker-tagged definitions, and ctx.tools.get returns a schema view rather than execute, preventing direct ToolRuntime bypass.2323
CODEMODE-EXECUTION
The execution boundary also enforces code collapse
packages/core/tools/src/index.ts:1208-1253In code mode, model-direct calls may name only run_code; nested calls carrying a parent token may execute agent-visible tools, and the generated SDK excludes run_code itself to close recursive transport.2323
CODEMODE-FLAT-JSON
Flat, iterative worker JSON wire
packages/code-runtime/code-runtime-worker-thread/src/worker-json.ts:247-419Lossless JSON is encoded as a flat token stream and strictly decoded iteratively; deep values do not consume JavaScript call-stack depth, and malformed or incomplete inputs return undefined.2323
CODEMODE-HISTORY
Nested dispatch records and model history are layered
packages/core/tools/src/code-mode.ts:1-6Every Code Mode sub-call is logged as a reconstructable nested dispatch, while only the outer run_code curated result enters model history.2323
CODEMODE-HOST-CODE
Define-time syntax precheck and synchronous VM timeout
packages/extensions/cordis-host-runner/src/sandbox.ts:196-238Host/Client source is compile-only prechecked at define time with the same async wrapper; Host evaluation's vmTimeoutMs bounds only the synchronous portion, while an async body escapes that limit.2323
CODEMODE-HOST-SANDBOX
The real trust boundary of the dynamic Host VM
packages/extensions/cordis-host-runner/src/sandbox.ts:1-11The Host half runs in a fresh node:vm realm and traps redirect work to ctx services, but host-realm helpers remain an escape route; the module explicitly says this is not a malicious-code security boundary.2323
CODEMODE-INSPECT-REGISTRY
Inspect-query platform routing and cancellation
packages/extensions/cordis-host-runner/src/inspect-registry.ts:98-198Host queries validate input/output locally; Client queries publish an agent-identified request, wait for the first valid same-session response or AbortSignal cancellation, and clean pending state.2323
CODEMODE-MODES
Tool presentation modes and sub-call concurrency
packages/core/tools/src/index.ts:650-673The tool runtime defines native, code, and both presentation modes; code exposes only run_code, with a default per-program nested-call cap of 10.2323, 33
CODEMODE-NESTED-DISPATCH
Nested-call identity, logging, and context commitment
packages/core/tools/src/code-mode.ts:464-594Each nested call receives a deterministic subCallId, root/parent identity, the same agent and cancellation signal; start/settle events carry detached argument snapshots, results resolve after ordered commit, and additionalContexts plus concludesTurn are forwarded to the outer execution.2323
CODEMODE-OUTCOME-STEERING
Asynchronous activation outcomes return through steering
packages/extensions/cordis-host-runner/src/index.ts:1019-1047Final page-side success, rejection, or technical failure becomes steering context with exact Plugin/Package/Run identity; failure text includes current/next pointers and same-Plugin repair guidance.2323
CODEMODE-POLICY
Nested calls reuse the complete ToolRuntime pipeline
packages/core/tools/src/index.ts:1453-1599Staged execution runs pre-execute, approval, monotonic guards, around-dispatch, the real tool body, result normalization, and post stages; cancellation and tool failures materialize as standard results.2323
CODEMODE-REFERENCE
@pluginId injects source-free context only from user messages
packages/extensions/tool-cordis/src/index.ts:497-529Explicit references are extracted only from user-source text with a strict ID pattern; injected context carries current base/version state but requires exact source inspection, and missing or cross-session references are reported unavailable.2323
CODEMODE-REGISTRY
Plugin, Package, Run, and approval state model
packages/extensions/cordis-host-runner/src/registry.ts:16-82A session-owned Plugin stores an immutable Package map, per-package and future-version grants, current/next pointers, one active run, and the latest attempt; runs and pending approvals have independent identities.2323
CODEMODE-RETRACT
Stop-to-quiescence and Session ownership
packages/extensions/cordis-host-runner/src/index.ts:1219-1239Retraction removes the live run, unregisters handlers, awaits fiber.dispose, and emits a retract event; action lookup requires plugin.sessionId to equal agent.id.2323
CODEMODE-RUN-APPROVAL
Host-only fast path and Client approval state machine
packages/extensions/cordis-host-runner/src/index.ts:238-374Host-only Packages activate directly; Client-bearing Packages create an approval request without a grant or enter starting when authorized, while request/package/run identities prevent stale approval from starting the wrong version.2323
CODEMODE-RUN-SCHEMA
run_code input, output, and runtime entry
packages/core/tools/src/code-mode.ts:283-340run_code requires code and a non-empty description, returns only logs plus an optional result, resolves the runtime at execution, and forwards outer cancellation into a run-scoped AbortController.2323
CODEMODE-RUNTIME-DESCRIPTORS
language and isolation are descriptors only
packages/code-runtime/code-runtime/src/index.ts:95-134CodeRuntime language and isolation guide presentation and diagnostics rather than making a security claim; the source explicitly states that only TypeScript has a published backend.2323
CODEMODE-RUNTIME-READS
Assembly and execution read CodeRuntime separately
packages/core/tools/src/index.ts:1003-1028CodeRuntime is read dynamically at prompt assembly and again at run_code execution, without binding the language to one request; the source defers closing the hot-swap window until a second backend ships.2323
CODEMODE-SCHEDULER
A per-program nested scheduler
packages/core/tools/src/code-mode.ts:342-457run_code uses one ordered lane for start, prepare, and commit, overlaps only concurrency-safe dispatch bodies, holds exclusive barriers through post-execute, and drains logging work at settlement.2323
CODEMODE-SCOPE
Scoped and disposable Code Mode selection
packages/core/tools/src/index.ts:894-973Presentation resolves from the nearest scope; an agent or preset can override the deployment default, and disposal restores the previous view and prompt sections.2323
CODEMODE-SDK-LIVE
The Code Mode SDK is rebuilt at every prompt assembly
packages/core/tools/src/index.ts:865-891The tools:sdk section is rebuilt at render time from the calling scope's currently visible tools in stable order rather than frozen when ToolRuntime is constructed.2323
CODEMODE-SEAM
CodeRuntime JSON boundary and failure taxonomy
packages/code-runtime/code-runtime/src/types.ts:9-127Binding arguments and results must be lossless JSON, with no seam-level byte cap on intermediate binding resolutions; run failures are exception, timeout, abort, worker-exit, invalid-output, or output-limit and return in a resolved result's error field.2323
CODEMODE-TRANSPORT
run_code is reserved presentation transport
packages/core/tools/src/index.ts:913-933run_code stays outside ordinary filterable registration layers and is inserted after visibility resolution, so agent restrictions cannot remove it and scoped tools cannot shadow it.2323
CODEMODE-WIRE
Wire-schema collapse and runtime-language validation
packages/core/tools/src/index.ts:976-1028Native sends visible tools, code sends only run_code, and both sends both forms; non-native prompt assembly requires a CodeRuntime with a supported language.2323
CODEMODE-WORKER-BOOT
Programs receive only explicit namespaces and console
packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts:301-424The worker builds null-prototype binding namespaces, bridges async calls over the message port, and executes the program as a strict AsyncFunction body whose injected parameters are only declared namespaces, error classes, and console.2323
CODEMODE-WORKER-BRIDGE
Hostile worker messages, budgets, and cancellation
packages/code-runtime/code-runtime-worker-thread/src/index.ts:462-556The host shape-checks worker messages, uses own-property binding lookup, and revalidates JSON; duplicate IDs, unknown bindings, bad values, worker exit, busy/wall timeouts, and abort all converge to controlled results.2323
CODEMODE-WORKER-LIFECYCLE
Fresh worker and single terminal outcome
packages/code-runtime/code-runtime-worker-thread/src/index.ts:363-460Every execution creates a worker with env={}, execArgv=[], and a heap limit; exactly one outcome wins, and the host terminates the worker and drains stdout/stderr before resolving.2323
CODEMODE-WORKER-LIMITS
Worker defaults and disposal semantics
packages/code-runtime/code-runtime-worker-thread/src/index.ts:230-317Defaults are 60 seconds busy time, 600 seconds wall time, 64 MiB combined outer output, and 512 MiB old generation; disposal aborts and awaits every worker, and type-strip failures spawn none.2323
CODEMODE-WORKER-TRUST
worker-thread is containment, not a security boundary
packages/code-runtime/code-runtime-worker-thread/src/index.ts:1-6Each run uses a fresh worker, but the module explicitly gives model code bash-equivalent trust despite an empty environment, heap and time bounds, and forced termination.2323
COMPACT-AUTO-TRIGGERS
Pre-step pressure and same-Step overflow recovery
packages/compaction/compaction-basic/src/index.ts:137-223The pre-step listener warns and continues on failure; canonical context overflow uses an independent budget and returns retry only after Surface generation advances, including durable prune progress before a later summary failure, while cancellation remains final.1313
COMPACT-COMMAND
Human-facing /compact and failure classification
packages/compaction/command-compact/src/index.ts:22-105The argument-free command maps busy, cancelled, changed, summary, commit, and persistence failures to distinct user outcomes, reports shadowed items and tokens with the summary seq on success, and drains active handlers on teardown.1313
COMPACT-COMMIT
Snapshot, shrink validation, stability, and synchronous commit body
packages/compaction/compaction-basic/src/region.ts:338-485The selected span is priced and snapshotted as token nodes and messages; the framed checkpoint must be strictly smaller; automatic mode requires the whole Surface unchanged while manual mode requires only the selected span stable; summary event and replacement append synchronously adjacent.1313, 33
COMPACT-CONFIG
Threshold and retention budgets resolved per exact Provider and Model
packages/compaction/compaction-basic/src/config.ts:67-166Defaults are thresholdRatio .8, retainRatio .16, maxTokens 8192, one extra summary retry, and one overflow retry; exact routes can partially override them, and capacity scales ratios into absolute budgets.1313, 14
COMPACT-ESTIMATOR
Fixed-density token heuristic
packages/llm/token-meter/src/estimate.ts:12-87Text and reasoning use four JavaScript code units per token plus block overhead, tool arguments and schemas use JSON length, and messages add role overhead; this is one shared heuristic, not an exact tokenizer.1313
COMPACT-EVENTS
Compaction lifecycle, shadow-price, and result event vocabulary
packages/compaction/compaction/src/types.ts:16-119Start, summary, and end form a log-only bracket; summary records shadowed seqs and token price, route, raw output, and usage, while the following replacement user message changes the Surface; prune is the model-free shadow-price event.1313, 14
COMPACT-INVARIANT
Runtime invariant for compaction brackets, owners, and checkpoints
packages/compaction/compaction/src/invariant.ts:56-217The companion validates transaction and command IDs, Turn enclosure, one summary, shadow endpoints and token count, checkpoint source, and successful end; it does not validate that summary or prune is immediately adjacent to its replacement.1313
COMPACT-MANUAL
Manual compaction under idle maintenance
packages/compaction/compaction-basic/src/index.ts:360-419compactNow synchronously enters runMaintenance only while idle with no waking work, selects a useful range with retain zero, writes a turn-null bracket, permits appends outside the span, and flushes a closed attempt before returning.1313
COMPACT-PAIRING
Tool-call and result balanced cuts in current Surface order
packages/compaction/compaction/src/tool-pairing.ts:28-130The fold increments for assistant tool calls and decrements for tool results to compute N+1 cuts for N nodes; it rebuilds when replacement generation changes and extends incrementally for ordinary appends.1313
COMPACT-POLICY-LOOP
Main loop for pressure, pruning, retention, and summary retries
packages/compaction/compaction-basic/src/index.ts:248-331Pressure first resolves routed capacity and crosses its threshold, optionally prunes and remeasures, then selects a head range retaining a tail; overflow bypasses threshold and retention and prunes first; every summary is remeasured until below threshold or bounded retries expire.1313
COMPACT-PRUNER
Replay-safe model-free content-only tool-result replacement
packages/compaction/compaction-tool-result-pruner/src/index.ts:63-184Only text blocks are measured and pruned by code point while rich blocks retain order; for every oversized result in a Surface snapshot it writes a shadow price, then uses Session's content-only replacement citing the original seq.1313
COMPACT-PRUNER-CONFIG
Code-point budgets for the tool-result pruner
packages/compaction/compaction-tool-result-pruner/src/config.ts:7-64The default triggers above 8192 Unicode code points and keeps a 4096-point head, 1024-point tail, and fixed marker; validation guarantees output stays within the threshold and can converge.1313
COMPACT-RANGE
Head-anchored range selection that retains a recent tail
packages/compaction/compaction-basic/src/region.ts:90-134The selector accumulates at least retainTokens from the Surface tail, then moves the cut headward to a tool-pair-balanced boundary; it returns null when no compactable head or only one indivisible unit remains.1313, 33
COMPACT-RUNTIME-ORDER
Ordering of the pre-Step candidate, waterfall, and message commit
packages/core/agent-loop/src/agent.ts:225-287Before the waterfall, the Agent claims input, assembles the prompt, and computes the runtime-context candidate; only after the waterfall returns does it write step/start and user messages, so pressure measurement inside the waterfall cannot see this entering batch.1313
COMPACT-RUNTIME-PROJECTION
Retained-snapshot projection for dynamic runtime context
packages/core/agent-loop/src/runtime-context.ts:24-75The projection remembers the latest owned snapshot still on the Surface, sets retained to null when a replacement cites it, and produces a candidate message only when current text differs from the retained value.1313
COMPACT-SEAM
Compaction backend seam and its three entry points
packages/compaction/compaction/src/index.ts:87-169The abstract engine separates pressure or overflow policy, idle compactNow, and explicit compactRegion; every success replaces one balanced Surface span with a user message carrying the common checkpoint source.1313
COMPACT-SHADOW-PRICE
Adjacent shadow-price protocol for O(1) projections
packages/llm/token-meter/src/surface-projection.ts:1-94The bounded projection retains only a running total and one pending claim; summary or prune is meant to price the next replacement, any other event expires the claim, and a historical replacement without a claim degrades to zero delta rather than failing.1313, 33
COMPACT-SUMMARIZER
Cache-shaped one-shot summary request and checkpoint framing
packages/compaction/compaction-basic/src/summarizer.ts:20-223The summary request reuses conversation system, tools, and selected messages and appends one fixed English structure directive; target preference is explicit summary route, then latest route or Agent options; only nonempty text is accepted, images or max-token truncation fail, and raw output and usage are stored separately.1313, 14
COMPACT-TOKEN-ANCHOR
Provider-usage anchors and reconstruction from cited chunks
packages/llm/token-meter/src/index.ts:188-310At assistant/message, the meter anchors to the Step-start Surface and reassembles real Provider output from cited raw chunks; when reported usage is lower than the full heuristic anchor it falls back to the estimate so negative deltas cannot understate pressure.1313
COMPACT-TOKEN-MEASURE
Replay-aware request-pressure measurement
packages/llm/token-meter/src/index.ts:100-180With a matching request header, measurement prefers a conservative Provider-usage anchor plus signed Surface delta; otherwise it reprices header and Surface heuristically, returning immutable O(surface) positional nodes each time.1313
COMPACT-TRANSACTION
Transaction with a durable start lock and exactly one close attempt
packages/compaction/compaction-basic/src/region.ts:137-253After validation it synchronously writes start as the lock, rechecks stability after summarization, commits the body, then writes end; every later failure attempts one error end, while a failed close deliberately leaves an unmatched start, and a closed manual attempt may then flush.1313, 33
COMPACT-USAGE-PROJECTION
Primary-conversation usage and next-request pressure projections
packages/llm/token-meter/src/usage-projection.ts:70-205The usage fold reads only assistant usage chunks and messages and accumulates last-wins per Turn and Step; context pressure combines a Provider prompt sample with Surface shadow-price deltas for the next request, while usage stored on compaction/summary is not accumulated.1313
DESIGN-INVARIANT-REGISTRY
Package-owned runtime invariant registry
packages/runtime-diagnostics/invariants/src/index.ts:93-197Invariants are selected and uniquely registered per package, run in service-owned child fibers, attribute failures to their package, and release registrations on failed setup or disposal.0202, 03
DESIGN-SCOPED-LAYERS
Unified scope visibility and effect ownership
packages/core/scope/src/store.ts:153-266ScopedLayers overlays global and scope-chain contributions with the nearest scope winning; the registration context determines both visibility and effect ownership, and undo reclaims empty layers.0202, 07, 33
FAILURE-ADAPTER-BOUNDARY
Final adapter failure boundary
packages/llm/llm/src/index.ts:838-938The direct unprepared stream path selects, resolves, dispatches, and iterates inside the final boundary; prepared dispatch/iteration also becomes terminal finish, while middleware, consumer, and cleanup errors remain thrown.2727
FAILURE-AGENT-CANCEL
Agent cancel, wake latch, and Turn containment
packages/core/agent-loop/src/agent.ts:113-329Defines default Inbox clearing and abort, post-abort waking-input reclassification and latching, replacement-activity tracking in whenIdle, balanced turn/end, and a fresh AbortController for the next Turn.2727
FAILURE-AGENT-DISPOSAL
Memoized Agent lifecycle disposal
packages/core/agent-loop/src/index.ts:459-530Fuses caller, owner, and factory cancellation; the shared disposer performs cancel(disposed), whenIdle, scope.dispose, then registry and ownership detachment.2727
FAILURE-AGENT-PREPARE-BOUNDARY
Agent prepared-call and request-error boundary
packages/core/agent-loop/src/agent.ts:302-458The Agent prepares in buildRequest; non-NO_ADAPTER resolution errors throw before streaming and close the Turn directly, while only a terminal failure chunk dispatches agent/request-error.2727
FAILURE-CHECKPOINT-AGENT-ORDER
Agent request-prefix and stream ordering
packages/core/agent-loop/src/agent.ts:225-350The Agent records turn/start, claims Inbox input, then records step/start and input messages before building the request and entering the stream; returned chunks continue into the log.2727
FAILURE-CHECKPOINT-POLICY
Semantic checkpoints before model and tool side effects
packages/session/session-checkpoint-policy/src/index.ts:20-82With a live session, flushes before the downstream model stream, before a top-level tool body, and during pre-step; failures are fail-closed and cancellation during checkpoint returns not-dispatched.2727
FAILURE-CHECKPOINT-REQUEST-PREFIX
Request header/context logged before streaming
packages/core/agent-loop/src/agent.ts:403-494buildRequest appends request/header and any required request/context before returning the frozen request carrying sessionId.2727, 33
FAILURE-CHECKPOINT-TOOL-INTENT
Tool intent logged before scheduler dispatch
packages/core/agent-loop/src/tool-calls.ts:164-175Each started call appends tool/call before preparation and scheduler dispatch.2727
FAILURE-CHECKPOINT-TOOL-WRAPPER
Scheduler dispatch traverses the tools/execute waterfall
packages/core/tools/src/index.ts:1569-1577Scheduled dispatch enters the tools/execute waterfall, whose final next invokes the tool body.2727
FAILURE-CONFIG-RESOLUTION
DeepSeek two-layer validation and last-good generation
packages/llm/llm-deepseek/src/index.ts:91-256Schema plus explicit resolver revalidate catalog, bounds, reasoning, timeout, and retry; initial failure blocks registration while an invalid live snapshot falls back to the complete lastGood generation.2727, 33
FAILURE-CRASH-REPAIR
Deterministic semantic repair of an interrupted Turn
packages/core/session/src/repair.ts:18-132Distinguishes TOOL_NOT_STARTED from TOOL_OUTCOME_UNKNOWN, closes dangling tool results before Step/Turn, and instructs side-effect risk verification in recovery text.2727, 33
FAILURE-CREDENTIAL-ROUTE
Per-request credential recovery and in-place retry-policy replacement
packages/llm/llm-deepseek/src/index.ts:225-275Credentials resolve lazily from the same request snapshot and missing values throw MISSING_CREDENTIAL; the route registers independently and policy changes use synchronous replace to avoid an empty registry window.2727
FAILURE-DEEPSEEK-HTTP
DeepSeek HTTP errors, Retry-After, and request id
packages/llm/llm-deepseek/src/adapter.ts:117-338Parses seconds or HTTP-date Retry-After, two request-id headers, and maps non-2xx status/body into stable failure codes and facts.2727
FAILURE-DEEPSEEK-STREAM
Per-request snapshot, idle watchdog, and transport cleanup
packages/llm/llm-deepseek/src/adapter.ts:214-268One stream freezes connection and credential facts, distinguishes TIMEOUT, ABORTED, and TRANSPORT, then aborts the consumer and awaits an unexhausted iterator.return in finally.2727
FAILURE-HMR-WATCH
User-patch watcher and present-invalid fail-loud behavior
packages/boot/app-boot/src/index.ts:225-338The watcher rereads a complete patch generation and performs one entry.update; a present but unreadable, unparsable, or non-array patch throws rather than being skipped.2727
FAILURE-JSONL-ATOMICITY
JSONL materialization, append rollback, and fsync
packages/session/session-persistence-jsonl/src/index.ts:511-701Initial write uses a synced temp and non-overwriting publish; POSIX links and fsyncs the parent directory; append write/sync failure truncates and fsyncs the old length, and repair truncation is fsynced too.2727
FAILURE-JSONL-PREFIX
Stable JSONL/Zstd prefix and torn-tail repair marker
packages/session/session-persistence-jsonl/src/index.ts:306-444The loader uses scanner committed/torn boundaries to construct a stable event prefix and truncation/recovered-events marker, then persists repair through commitRepair.2727
FAILURE-JSONL-RAW-SCAN
Complete-record raw JSONL scanner
packages/session/session-persistence-jsonl/src/format.ts:272-377Commits only newline-terminated, decodable event records with contiguous sequence numbers; an unfinished fragment does not advance committedBytes.2727
FAILURE-JSONL-WIN32
Windows write-through durable publish
packages/session/session-persistence-jsonl/src/win32.ts:109-120Windows publishes the staging path to the final path with MoveFileExW MOVEFILE_WRITE_THROUGH and without replacement or cross-volume copy-fallback flags.2727
FAILURE-JSONL-ZSTD-SCAN
Complete Zstd frame scanner
packages/session/session-persistence-jsonl/src/zstd.ts:48-103Validates frame header, block, and checksum boundaries, returns only complete frames, and marks the start of an EOF-interrupted final frame as tornStart.2727
FAILURE-PERSISTENCE-WIRING
Persistence admission, final drain, and retirement order
packages/session/session-persistence/src/coordinator.ts:1084-1161Reverse teardown closes event admission before flush, chain draining, and backend close; session retirement flushes before releasing exact-lifecycle state.2727
FAILURE-REQUEST-LOOP
Model-request recovery loop inside one Step
packages/core/agent-loop/src/agent.ts:332-400Each attempt rebuilds request and assembler; only terminal error/aborted finish enters request-error, a retry action continues the same Step, and only success commits the assistant message and tools.2727
FAILURE-RETRY-EXECUTOR
Retry execution, durable scheduling, and disposal drain
packages/llm/llm-retry/src/index.ts:99-225Counts by coordinates and policyKey, records retry before waiting, handles provider-delay caps and always-mode downstream composition, and cancels then drains active recovery on disposal.2727, 33
FAILURE-RETRY-POLICY
Provider-owned retry policy defaults and validation
packages/llm/llm/src/retry-policy.ts:14-191Defines normal/always modes and default counts, delays, jitter, and codes; rejects unknown keys, invalid bounds, empty or duplicate codes; returns a frozen policy.2727
FAILURE-SNAPSHOT
Serializable frozen failure snapshot
packages/llm/llm/src/adapter-failure.ts:16-104A carried snapshot is trusted only when the Error's own data descriptors for failure/code match; inner fields are read and validated inside a try but need not be own properties, and the copied snapshot is frozen.2727
FAILURE-TIMEOUT-SIGNAL
Signal contract for deadlines and idle watchdogs
packages/util/timeout/src/index.ts:57-190Signals only notify and callers must stop; the first abort reason wins, code-scoped timeoutOf separates outer cancellation, and the watchdog times only an outstanding demand.2727
FAILURE-TOOL-DRAIN
Parallel-tool abort and scheduler-failure drain
packages/core/agent-loop/src/tool-calls.ts:112-255Abort stops new dispatches, waits and commits started calls in order, then synthesizes skipped-call results; scheduler failure allSettles in-flight work.2727, 33
FAILURE-TOOL-TIMEOUT
Cooperative tool timeout policy
packages/guard/timeout-policy/src/index.ts:18-80Wraps only tools declaring timeoutMs, temporarily swaps the signal, awaits downstream convergence, returns TOOL_TIMEOUT only when its own timer wins, and never abandons the Promise.2727
FAILURE-WRITE-BEHIND
Per-session write-behind and flush barrier
packages/session/session-persistence/src/write-behind.ts:18-158Enqueue clones events; flush shares a barrier and drains to quiescence; failed batches return to the head in order, automatic work pauses, and explicit barriers reject.2727
INBOX-ACTIVATION-MODEL
Activation as a residency epoch
packages/subagent/subagent/src/continuation.ts:1-19An Activation is explicitly not a request, result, cancellation, or task; it can execute many FIFO Turns while the Agent Inbox remains the sole Turn queue.2626
INBOX-ACTIVATION-STATE
Derived Activation running/waiting/settled states
packages/subagent/subagent/src/continuation.ts:151-159State is derived from Agent activity and the owned-child set rather than introducing a second execution state machine.2626
INBOX-ACTIVITY-CONTRACT
Agent status, whenIdle, maintenance, and input contracts
packages/core/agent/src/runtime-types.ts:43-143Running spans the whole driver drain, maintenance remains externally idle, whenIdle follows replacement activity, and all three input boundaries are explicit.2626
INBOX-AGENT-RESUME
Persisted Agent resume path
packages/core/agent-loop/src/index.ts:647-709Resume prepares from persistence, rejoins shared setupAndPublish, and publishes a new Agent handle with resume source.2626
INBOX-CANCEL-CODE
Cancel clear and abort implementation
packages/core/agent-loop/src/agent.ts:134-140Default cancel clears the Inbox and wake latch, keepInbox skips clearing, and only a non-idle phase receives the abort signal.2626
INBOX-CHECKPOINT-POLICY
Semantic checkpoints before model and tool side effects
packages/session/session-checkpoint-policy/src/index.ts:20-82Pre-step and llm/stream boundaries flush the Session; flush failure prevents model or top-level tool side-effect dispatch.2626
INBOX-CHILD-CLIENT
Client ordinary/child prompt and cancel routing
packages/client/runtime/src/client/sessions/session.ts:184-329Ordinary sessions pass queue/steer through; one-shot children are read-only; continuable children are text-only and ignore mode; cancel routes to session.cancel or subagent.interrupt.2626
INBOX-CHILD-COMPOSER
Independent Send and Stop for a running child
packages/client/ui-conversation/src/client/skeleton/InputBar.tsx:541-555A running ordinary session makes Stop primary, while a continuable child retains Send as primary and exposes Stop separately so follow-ups can queue.2626
INBOX-CHILD-INTERRUPT
Continuable-child interrupt semantics
packages/subagent/subagent/src/continuation.ts:507-568Interrupt authorizes the live target, calls cancel with keepInbox, and returns immediately; claimed work is not restored, pending work and descendants remain, and absence is a no-op.2626
INBOX-CHILD-OFFLINE-UI
Child composer while the parent is offline
packages/client/ui-subagent/src/client/index.ts:43-52One-shot children are always read-only; a parent-offline continuable child keeps the default composer while running to expose Stop, then becomes read-only after stopping.2626
INBOX-CHILD-REPORT
Exact-child reporting and parent scheduling
packages/subagent/subagent/src/continuation.ts:583-693Only the exact resident child may report; direct parent comes from lineage; wakeup uses followup, quiet uses inject, and reporting does not end the child.2626
INBOX-CLAIM-REPLAY
Post-seed replay and claim order
packages/core/agent/src/inbox.ts:24-78Inbox replays only post-seed splices; claim takes every next-step item first and then one next-turn item when requested.2626
INBOX-CLIENT-MIRROR
Queue snapshot mirror and durable handoff
packages/client/runtime/src/client/sessions/queue-mirror.ts:23-73The client replaces the queue from whole snapshots and retires one pending steering row when user/message with the same MessageId arrives.2626
INBOX-COLD-RESUME
Continuable-child cold resume and lineage authorization
packages/subagent/subagent/src/continuation.ts:876-932Cold resume inspects persistence, authorizes the durable direct parent first, folds only the post-seed descriptor, materializes, and then submits.2626
INBOX-COMMIT-IDENTITY
Commit-first splices and the identity invariant
packages/core/agent/src/inbox.ts:128-219Coordinates are normalized and validated before Session append; live state mutates only after success, and MessageId is unique across both lists.2626
INBOX-CONSUMED-WORK
Joint event fold for consumed work
packages/core/agent/src/consumed-work.ts:60-107A single pass joins steps, claims, turn endings, and canceled splices to distinguish accounted Turns from dropped-unrun input.2626
INBOX-CONTINUATION-ADMISSION
Synchronous admission fence for child follow-up
packages/subagent/subagent/src/continuation.ts:1125-1204A no-await span checks signal, drain, disposal, and lineage; it records the accepted ID before synchronously calling child Agent.followup and marking announced.2626
INBOX-CONTINUATION-DELIVERY
Resident, disposal-race, and cold-resume delivery
packages/subagent/subagent/src/continuation.ts:459-505A per-child lock serializes followup: resident children submit directly, absent children cold-resume, and delivery racing disposal waits for release then retries.2626
INBOX-CONTINUATION-SEAM
Continuable-child start/followup/interrupt/report seam
packages/subagent/subagent/src/index.ts:203-275Start ends at initial Inbox acceptance; later followup is the next FIFO Turn; interrupt preserves pending work; report flows from the exact child to its direct parent.2626
INBOX-CONTROL-TOOLS
Model contract for send_message and interrupt_agent
packages/subagent/tool-subagent-control/src/index.ts:25-119send_message uses the exact caller for child followup, cannot redirect the current Turn, and returns no child reply; interrupt only requests cancellation and preserves the queue.2626
INBOX-DRIVER-WAKE
Input reclassification, driver wake, and latch
packages/core/agent-loop/src/agent.ts:113-220Send redirects post-abort waking input to next-turn; idle wake reserves a driver, active work latches only for maintenance/abort, and exit replays it.2626
INBOX-EVENT-SCHEMA
Two Inbox targets and the durable splice event
packages/core/agent/src/types.ts:9-25Only next-turn and next-step exist; agent/inbox/spliced records coordinates, complete inserted messages, and an optional canceled outcome.2626
INBOX-HISTORY-CLASSIFICATION
Durable steering history classification
packages/client/runtime/src/client/sessions/steering-history.ts:20-63Replay records identities removed from next-step without cancellation and classifies only the later user-source user/message as steering.2626
INBOX-HOST-CONTRACT
Session prompt, queue mutation, and cancel wire contract
packages/host/apiproxy/src/api/sessions.ts:315-371The contract defines queue/steer prompts, edit/remove/steer mutations, and ordinary cancellation that preserves pending work.2626
INBOX-HOST-PROJECTION
Authoritative Web projection of both Inbox lists
packages/host/apiproxy/src/api-proxy.ts:1326-1355The Host projects next-turn and next-step, distinguishes steering/context by user source, and applies the current splice inside the synchronous observer to derive post-state.2626
INBOX-HOST-PROMPT
Ordinary prompt admission and mode routing
packages/host/apiproxy/src/api-proxy.ts:2461-2517The Host creates a sourced message, routes queue to followup and steer to steer, and returns accepted after synchronous enqueue succeeds.2626
INBOX-HOST-QUEUE-MUTATION
MessageId queue mutation and strict steer
packages/host/apiproxy/src/api-proxy.ts:2568-2633The Host relocates pending items, limits edits to text, accepts strict steer only for running next-turn items, removes then steers the same message, and cancels with keepInbox.2626
INBOX-INPUT-GESTURES
Enter deduplication and whole-queue steer gesture
packages/client/ui-conversation/src/client/skeleton/InputBar.tsx:313-339Repeated Enter is suppressed; accelerated Enter on an empty draft steers every still-pending queued row, otherwise submission follows policy.2626
INBOX-MESSAGE-IDENTITY
Unified message identity, source, and freezing
packages/llm/llm/src/message.ts:96-199Messages carry stable IDs, roles, exact content, and extensible sources; existing messages are deep-frozen and new messages receive UUIDs.2626
INBOX-PENDING-STEERING-UI
Pending steering at the conversation tail
packages/client/ui-conversation/src/client/chat/ChatView.tsx:400-406ChatView renders every pending steering item as a separate bubble after the running indicator.2626
INBOX-QUEUE-DOCK
QueueDock filtering and row actions
packages/client/ui-conversation/src/client/queue/QueueDock.tsx:27-205The Dock displays only queued placement and offers text edit, remove, and running-only steer for ordinary sessions.2626
INBOX-RECONNECT-CLIENT
Client-generation queue reset
packages/client/runtime/src/client/sessions/session.ts:412-485The client clears the old queue mirror on session/subscribed and then accepts the same stream's later snapshot, correctly handling an omitted empty baseline.2626
INBOX-RECONNECT-HOST
Mux reconnect queue baseline
packages/host/apiproxy/src/api-proxy.ts:3430-3455Reconnect establishes Session subscriptions and then sends a complete queue baseline only for Agents that still have pending work.2626
INBOX-SEED-BOUNDARY
Inbox seed-ownership boundary
packages/core/agent/src/inbox.ts:24-39Construction explicitly skips events before seedLength and reconstructs pending state only from the Session's own suffix splices.2626
INBOX-SEND-MAP
Follow-up, steer, and inject mapping
packages/core/agent-loop/src/agent.ts:113-132Unified send inserts before optional wake; followup, steer, and inject map to next-turn+wake, next-step+wake, and next-step+quiet.2626
INBOX-SETTLEMENT-NOTICE
Settlement-notice ordering and routing
packages/subagent/subagent/src/continuation.ts:1363-1465Notice delivery precedes parent-ownership release; closing parents receive inject, idle parents followup, busy parents steer; failures drop and final flush is best-effort.2626
INBOX-SUBAGENT-HOST
Subagent Host prompt and offline-parent interrupt
packages/host/apiproxy/src/api-proxy.ts:2737-2799Child prompt requires a live parent and calls continuation followup; interrupt performs no parent/catalog/persistence lookup and lets the live Activation authorize the durable address.2626
INBOX-SUBAGENT-WIRE
Subagent prompt and interrupt receipt contract
packages/host/apiproxy/src/api/subagents.ts:38-119Prompt receipt is an accepted MessageId with independent later execution; interrupt receipt acknowledges only the cancel signal, preserves pending work, and accepts absent/idle targets.2626
INBOX-SUBMISSION-POLICY
Busy-Enter queue/steer decision
packages/client/ui-conversation/src/client/input/submission-policy.ts:17-57Non-running or non-steer transports force queue; busy state follows the preference, accelerated gesture chooses the opposite, and direct steer is explicitly best-effort.2626
INBOX-TOOL-CONTEXT
Ordered tool-result and additional-context commit
packages/core/agent-loop/src/tool-calls.ts:145-158Each finalized tool result is appended in model order, then its additionalContexts are passed one by one to the next-step acceptor.2626
INBOX-TOOL-CONTINUATION
Same-Turn continuation after tool results
packages/core/agent-loop/src/agent.ts:287-399An unconcluded tool outcome continues the Turn into a later Step, and existing next-step work prevents an immediate close even after conclusion.2626
INBOX-TURN-MACHINE
Turn/Step claim, admission, and closing machine
packages/core/agent-loop/src/agent.ts:245-329A Turn starts before claim; reject yields blocked with no Step, empty enter yields completed with no Step, next-step continues the Turn, and other pending work opens another Turn.2626
INBOX-WIRE-DOC-DRIFT
Durability drift in queue wire comments
packages/host/apiproxy/src/api/events.ts:36-84The file carries complete pending messages in queue frames yet says they become durable only at claim and have no durable Session event, contradicting the Inbox splice implementation.2626
LLM-ADAPTER-REGISTRY
One-to-one provider-route registry
packages/llm/llm/src/index.ts:330-413Adapters own non-empty unique routes; conflicts fail all-or-nothing, effect disposal releases exact routes, and replace atomically swaps routes before publishing an update.0808, 33
LLM-BLOCK-ASSEMBLER
Canonical chunk-to-assistant-message assembler
packages/llm/llm/src/assembler.ts:25-163Supports interleaved indexes and delta-only protocols, lets the first block-end win, drops unsafe tool calls on max-token truncation, and carries usage, finish, and replay state.0808
LLM-CHECKPOINT-BARRIER
Durable checkpoint before adapter dispatch
packages/session/session-checkpoint-policy/src/index.ts:20-82The llm/stream waterfall flushes the complete request prefix before constructing the downstream adapter stream and fails closed with no model I/O when flushing fails.0808
LLM-CONTENT-PROTOCOL
Provider-neutral content and usage vocabulary
packages/llm/llm/src/types.ts:53-141Core blocks are text, reasoning, image, tool-call, and tool-result; tool arguments remain raw JSON strings and usage buckets are disjoint.0808
LLM-DEEPSEEK-CONFIG
DeepSeek config resolution, last-good state, and route registration
packages/llm/llm-deepseek/src/index.ts:149-275Config is explicitly resolved and validated, bad live snapshots retain last-good state, credentials resolve per request, and retry-policy changes atomically replace the sole deepseek-official route.0808
LLM-DEEPSEEK-MODELS
DeepSeek model capabilities and defaults
packages/llm/llm-deepseek/src/adapter.ts:88-211Defaults are a 1M context, 256K output, and text-only input; uncatalogued model ids still pass through, while deployment thinking policy controls off, high, max, and the default effort.0808
LLM-DEEPSEEK-SERIALIZE
Projection from internal messages to DeepSeek chat completions
packages/llm/llm-deepseek/src/serialize.ts:25-186Rejects images, expands user-role tool results into role=tool, replays reasoning_content only on tool-call turns, forces thinking off for session titles, and always requests streaming usage.0808
LLM-DEEPSEEK-TRANSLATE
Stateful translation from DeepSeek SSE to internal chunks
packages/llm/llm-deepseek/src/translate.ts:26-184Builds reasoning, text, and tool indexes, defers block-end, usage, and finish until DONE, subtracts cache hits from prompt totals, and fails empty stop, malformed JSON, or missing DONE distinctly.0808
LLM-DEEPSEEK-TRANSPORT
DeepSeek request snapshot, HTTP, and SSE boundary
packages/llm/llm-deepseek/src/adapter.ts:214-345Each stream captures connection and key, sends attribution plus anonymous user, session, and compaction headers, preserves status, Retry-After, and request id, and classifies idle timeout and transport failures.0808
LLM-FAILURE-BOUNDARY
Adapter-failure normalization boundary
packages/llm/llm/src/index.ts:838-938Selection, dispatch, iterator construction, and iteration failures become terminal failure chunks, while middleware, consumer, and cleanup failures remain thrown.0808, 33
LLM-MESSAGE-IDENTITY
Assistant provider provenance and replay state
packages/llm/llm/src/message.ts:7-18Model messages carry provider, model, and optional adapter-private lossless replay state, which is reusable only under the same adapter ownership.0808
LLM-MESSAGE-VALUE
One immutable Message value
packages/llm/llm/src/message.ts:128-184Delivery, durable history, and provider requests share one stable id, role, content, and source representation, cloned and deep-frozen at creation.0808
LLM-PI-CONFIG
Pi AI multi-provider profile shape
packages/llm/llm-pi-ai/src/config.ts:34-178Routes default to empty; each profile owns credentials, endpoint, model catalog and overrides, reasoning, cache retention, transport, timeouts, headers, and retry policy.0808
LLM-PI-PROVIDER
Pi AI catalog reuse and manual protocol table
packages/llm/llm-pi-ai/src/provider.ts:35-191Catalog routes retain their original provider API and auth; manual routes support only openai-completions, openai-responses, and anthropic-messages and are built from configuration.0808
LLM-PI-REPLAY
Versioned adapter-private Pi AI replay state
packages/llm/llm-pi-ai/src/replay.ts:15-215Durable content remains authoritative while versioned state stores API, response identity, stop reason, and provider signatures and is validated field-by-field and block-by-block on replay.0808
LLM-PI-STREAM
Pi AI exact-model and stream-snapshot boundary
packages/llm/llm-pi-ai/src/adapter.ts:217-357Unknown models fail before I/O, stop is unsupported, one call captures profile, model, and credential with SDK retries disabled, and images require model capability plus a durable attachment service.0808
LLM-PREPARED-CALL
One-shot registration-bound PreparedLlmCall
packages/llm/llm/src/index.ts:771-814prepareCall captures resolved config, model context, adapter defaults, and retry policy; stream is one-shot and rejects config drift before dispatch.0808
LLM-REPLAY-DERIVATION
Log derivation of keyless test replay scripts
packages/test-support/llm-replay/src/index.ts:193-260Assistant chunks split at each finish and one turn and step may contain multiple retry calls; throws and hangs cannot be derived from the log alone and require an explicit sidecar.0808
LLM-REQUEST-INVARIANT-SCOPE
Field coverage of the request-reconstruction invariant
packages/core/agent-loop/src/invariant.ts:35-55The invariant compares messages, model, system, temperature, maxTokens, stop, and tools, but not provider or reasoningEffort.0808
LLM-RETRY-EXECUTOR
Durable retry scheduling and cancellable backoff
packages/llm/llm-retry/src/index.ts:111-225Writes llm/retry before waiting and llm/retry-started before returning retry; over-cap Retry-After delegates in normal mode and falls back locally in always mode, while disposal aborts and drains.0808
LLM-RETRY-POLICY
Provider-owned retry-policy defaults and validation
packages/llm/llm/src/retry-policy.ts:14-191Normal defaults to two retries for EMPTY_RESPONSE, RATE_LIMIT, SERVER, TIMEOUT, and TRANSPORT with 500ms-to-10s exponential backoff and 10 percent jitter; always is unbounded.0808
LLM-STREAM-PROTOCOL
Closed streaming chunks and complete request protocol
packages/llm/llm/src/types.ts:283-355Streams use indexed block start, delta, end, usage, and one terminal finish; GenerateOptions carries config, system, tools, messages, session identity, and auxiliary purpose.0808
LLM-TOKEN-USAGE-PROJECTION
Last-sample-replaces usage projection keyed by Turn and Step
packages/llm/token-meter/src/usage-projection.ts:97-140The projection retains one last sample and replaces totals for later usage in the same turn and step, intended to avoid double-counting chunk and final-message usage.0808
LOG-ATTEMPT-ASSEMBLY
Raw chunks and semantic-message commit for each model attempt
packages/core/agent-loop/src/agent.ts:332-400Each request derives messages from the current Surface; every chunk is logged first, and only a successful attempt appends an assistant message citing those seqs, while a failed retrying attempt commits no semantic message.1010
LOG-CHECKPOINT-POLICY
Semantic durability checkpoints before model and tool side effects
packages/session/session-checkpoint-policy/src/index.ts:20-82The policy flushes before model-stream construction, a top-level tool body, and every pre-step; a failed checkpoint prevents the adapter or tool side-effect body from running, while nested tool dispatch reuses the outer boundary.1010, 12, 33
LOG-CLIENT-ASSISTANT
Client projection of assistant streams, retries, and interruption
packages/client/ui-conversation/src/client/conversation-nodes/assistant.ts:72-205The client folds chunks incrementally; llm/retry hides and clears failed-attempt partials while preserving first-token time, and a closed boundary with chunk evidence but no final message can synthesize an interrupted node.1010
LOG-CLIENT-STITCH
History-window stitching, live buffering, deduplication, and gap repair
packages/client/runtime/src/client/sessions/session.ts:614-729The client installs a tail page, stitches events buffered during subscription by seq, drops overlap, and buffers plus refetches the tail on a seq hole so the conversation engine never receives a discontinuous window.1010, 12
LOG-CONVERSATION-ASSEMBLER
Incremental UI business-context engine over a contiguous raw window
packages/client/runtime/src/client/sessions/conversation-assembler.ts:133-248The assembler fully rebuilds on replaceWindow, handles only the tail on append, and adds older pages on prepend while preserving existing context and view identity; business Definitions decide how events become UI nodes.1010
LOG-CORE-FORK
Core Fork rules for live sources and balanced prefixes
packages/core/session/src/index.ts:1067-1153Core copies an inclusive prefix only from the current live Session; the boundary must exist and be contiguous, may not end inside an open turn, and the child inherits cwd, parentSession, and exact seedLength.1010
LOG-HISTORY-CONTRACT
Wire-level contracts for raw history entries and Fork
packages/host/apiproxy/src/api/sessions.ts:59-338History returns each raw event plus an optional current tool view, pages by append-origin message groups, includes tail partials, and never resumes a cold Agent; Fork atSeq is a completed-turn anchor.1010
LOG-HISTORY-CUT
One synchronous cut for history events and the projection baseline
packages/host/apiproxy/src/api-proxy.ts:1533-1574Attached history copies live events while cold history uses inspect; after all awaits, events and the projection watermark are read synchronously so one response cannot mix moments N and N+1.1010, 12
LOG-HISTORY-PAGINATION
Contiguous raw pagination by append-origin message group
packages/host/apiproxy/src/api-proxy.ts:282-313The algorithm counts append-origin user and assistant messages backward, gives replacements no quota, and uses sourceEventSeqs to extend the cut to the raw chunk group's start so a page never splits an assistant attempt.1010
LOG-HISTORY-SCHEMA
Wire validation for history requests and responses
packages/host/apiproxy/src/api/sessions.schema.ts:141-242beforeSeq and maxMessages are checked only as non-negative and positive integers, with no maximum for maxMessages; each response entry validates its raw event and optional view, while the transport schema does not express the contiguous-window invariant.1010
LOG-HISTORY-VIEW
Pagination-time tool views and cross-page soft fallback
packages/host/apiproxy/src/api-proxy.ts:804-820History backscans tool-call arguments only within the current raw page and invokes the current presenter; a call on an older page or unparseable arguments returns undefined so the client uses a generic card.1010
LOG-HOST-FORK
Host Fork message anchors and composition inheritance
packages/host/apiproxy/src/api-proxy.ts:2363-2458atSeq selects the first turn/end for its containing Turn and includes standalone events before the next turn/start; the child inherits cwd, lineage, seedLength, and current composition, and a later workspace-attach failure does not unpublish it.1010
LOG-PERSISTENCE-ADMISSION
Asynchronous persistence admission after Session creation
packages/session/session-persistence/src/coordinator.ts:1084-1181The session/created listener starts initFor in a fire-and-observe manner, session/event enters write-behind, and session/flush is the explicit barrier, so physical persistence of a fork seed is not atomic with child publication.1010
LOG-PERSISTENCE-READ-FACES
Four read contracts: prepare, load, inspect, and readFrom
packages/session/session-persistence/src/coordinator.ts:720-889Prepare reserves the sole publishable Session and commits recovery; load commits recovery and returns a balanced view; inspect performs logical repair without publication or writes; readFrom returns a physical stored suffix without recovery.1010, 12
LOG-PREPARED-COMMIT
Revision checking and exact commit of prepared repair
packages/session/session-persistence/src/coordinator.ts:891-990A cold source synthesizes closers and validates them through Session seeding; after commitRepair changes revision it reloads instead of binding an old memory graph to a new revision, while live load flushes first and rejects an open turn.1010, 12
LOG-QUERY-TRACE
Queries for Surface replacement, sources, and Session lineage
packages/session-query/session-query/src/tracing.ts:21-218Query first applies the canonical Surface fold to classify events as current, shadowed, or log-only, then returns replacement chains and direct source or derived links; Session lineage follows header parents into ancestors and recursive descendants and explicitly reports a missing parent.1010, 14
LOG-RAW-EXPORT
Byte-preserving export of raw artifacts and lineage media after flush
packages/host/apiproxy/src/session-export.ts:1-265Export passes every live Session through the authoritative flush barrier, then streams the backend artifact verbatim with optional descendant logs and deduplicated referenced media into ZIP, without rebuilding UI or Surface projections.1010
LOG-REPAIR-CLOSERS
Deterministic synthetic closers for a crash tail
packages/core/session/src/repair.ts:18-132Repair scans only the tail open turn; an unrecorded start gets TOOL_NOT_STARTED, a recorded call without a result gets TOOL_OUTCOME_UNKNOWN, then step/end and interrupted turn/end are added as needed with contiguous seqs and the last real timestamp.1010
LOG-WRITE-BEHIND
Per-session write-behind queue and explicit quiescence barrier
packages/session/session-persistence/src/write-behind.ts:18-158Events are cloned into a fixed-deadline queue; a failed stable batch is restored in order and pauses automatic retry, while concurrent flushes share a barrier that explicitly retries until the queue and active write are quiescent.1010, 12
LOOP-DRIVER-PRESTEP
Driver containment and pre-step preparation
packages/core/agent-loop/src/agent.ts:195-243kick contains turn failure and cancellation at the driver boundary; preStep claims input, assembles the prompt, projects runtime context, and then enters the agent/pre-step waterfall.0606
LOOP-REQUEST-BUILD
Construction of reconstructable frozen requests
packages/core/agent-loop/src/agent.ts:403-495Shows the request waterfall, exact-adapter prepareCall, adapter-default markers, request/header, request/context, and the final frozen marked request in order.0606, 07, 08
LOOP-REQUEST-INVARIANT
Log-reconstruction invariant for LLM requests
packages/core/agent-loop/src/invariant.ts:18-55For loop-marked requests, verifies freezing, a live session, step/header presence, and independently compares deriveMessages and the folded header.0202, 06, 07, 33
LOOP-RUNTIME-CONTEXT
Dynamic runtime-context projection
packages/core/agent-loop/src/runtime-context.ts:24-75Restores the latest retained snapshot from the surface, follows replacements, proposes an uncommitted user message only on change, and uses a cleared marker to retire old semantics.0606, 07
LOOP-STEP-STATE
Step model stream and tool continuation
packages/core/agent-loop/src/agent.ts:332-400Each request uses deriveMessages, logs every chunk, and writes assistant/message on success; max-tokens, no-tool, concluded-tool, and continuation branches are explicit.0606, 08
LOOP-TURN-STATE
Turn state machine and end reasons
packages/core/agent-loop/src/agent.ts:245-330Covers turn/start before claims, reject, empty initial steps, the step loop, turn-stopping, error normalization, turn/end, and consecutive queued turns.0202, 06, 33
MEMORY-AGENT-CONTEXT
Model-context construction from pre-step to Provider request
packages/core/agent-loop/src/agent.ts:225-494The Agent claims input and assembles system and runtime context, durably appends accepted user and context messages after the waterfall, builds each request from the current Surface via deriveMessages(), and records route, system, and tools headers.1414
MEMORY-JSONL-PERMISSIONS
Owner-only, non-overwriting JSONL publication
packages/session/session-persistence-jsonl/src/index.ts:528-615POSIX materialization creates directories with 0700 and synchronized temporary files with 0600, publishes through link plus directory fsync, and refuses to overwrite an existing Session log.1414
MEMORY-PERSISTENCE-FLUSH
Session write-behind, flush barriers, and disposal drains
packages/session/session-persistence/src/coordinator.ts:1117-1160Every frozen event enters a persistence-owned bounded write queue, session/flush is the immediate durability barrier, and Session disposal drains writes before releasing lifecycle state.1414
MEMORY-PERSISTENCE-TRANSACTION
Durable append commits and exact prepare/load
packages/session/session-persistence/src/coordinator.ts:690-774The coordinator validates contiguous seq values, advances its durable cursor only after a backend batch commits, and uses reservations plus a stable log to produce exact prepared and loaded recovery views.1414
MEMORY-QUERY-CORPUS
The live-first logical corpus of Session query
packages/session-query/session-query/src/corpus.ts:53-220Query merges persistence with live Sessions using live precedence, always prefers a detached live snapshot for one target, bounds cold-batch concurrency, isolates per-item failures, and rechecks attachment after persisted reads.1414
MEMORY-QUERY-DOCUMENTS
Raw-log projection into current, shadowed, and log-only search documents
packages/session-query/session-query/src/documents.ts:15-74The document builder applies the canonical Surface fold to a complete raw log and retains Session, seq, type, time, Surface classification, and extracted text for every searchable event.1414
MEMORY-QUERY-EXTRACTION
First-party Session search-text extraction rules
packages/session-query/session-query/src/extraction.ts:13-82Extraction includes user and assistant text, tool names, arguments and results, Todos, and selected Turn errors, excludes reasoning, raw chunks, request headers, and unknown events or blocks, and does not inspect user-message source.1414
MEMORY-QUERY-SQLITE-MODE
openAt modes and the branch that fully disables full-text search
packages/session-query/session-query-sqlite/src/index.ts:85-331openAt may be startup, first-search, or never; never retains inherited exact reads, filters, and traces but deterministically rejects both full-text APIs before importing or opening SQLite.1414
MEMORY-QUERY-SQLITE-SCHEMA
Owner-only disposable SQLite FTS5 derived index
packages/session-query/session-query-sqlite/src/schema.ts:27-169Persistent database directories and files are created with 0700 and 0600, foreign databases are refused, old derived schemas may be rebuilt, and persistent and live documents use plaintext unicode61 FTS5 tables.1414
MEMORY-QUERY-TOOL-AUTH
Workspace authorization and rechecks for Session-query model tools
packages/session-query/tool-session-query/src/workspace-access.ts:54-233The caller must come from exec.agent; self is readable, cross-Session access requires exact cwd equality, batches are prefiltered, observed headers are rechecked, and unauthorized lineage subtrees collapse to null markers.1414
MEMORY-REFERENCE-PROJECTION
Text projection and exact UTF-8 retention for Session references
packages/context/session-reference/src/projection.ts:35-171Projection keeps direct-user text, assistant text, and canonical checkpoints, excludes tools and injected context, then drops older non-checkpoint messages and head-tail truncates with exact omitted-byte accounting when over budget.1414
MEMORY-REFERENCE-RESOLVER
Candidate, budget, and injection semantics of explicit cross-Session snapshots
packages/context/session-reference/src/index.ts:42-217The resolver marks sources untrusted and read-only, defaults to three references, 50 candidates, and 65,536 bytes per source, uses cwd only for candidate ranking, and prepares one sourced user context from exact Surface reads.1414
MEMORY-SKILL-FILESYSTEM-CONFIG
Filesystem Skill provider ordering, watch defaults, and naming drift
packages/skill/skill-filesystem/src/index.ts:36-100Configuration defines project, custom, and user ranks and defaults watching, symlink following, and 128 project watchers; JSDoc says providerName defaults to local while the schema actually defaults to filesystem.1414
MEMORY-SKILL-FILESYSTEM-LOAD
Skill-file discovery, frontmatter parsing, and uncapped body reads
packages/skill/skill-filesystem/src/index.ts:719-885Discovery accepts flat .md files or one-level SKILL.md directories, parses name, description, and invocation while retaining the full trimmed body, and neither Node nor policy-filesystem reads impose a Skill-level byte cap.1414
MEMORY-SKILL-FILESYSTEM-ROOTS
Project, custom, user, and bundled Skill roots
packages/skill/skill-filesystem/src/index.ts:241-260The provider starts with the nearest project's .dsh/skills and .agents/skills, then adds custom roots, two user roots, and an optional trusted bundled root.1414
MEMORY-SKILL-HOST-UI
Session scope and user-invocable filtering in Host skill.list
packages/host/apiproxy/src/api-proxy.ts:3205-3257The Host neither creates nor resumes an Agent, resolves cwd from an attached Session header, reads the registry through the live or preset scope, and returns only the wire projection of user-invocable Skills.1414
MEMORY-SKILL-INVOCATION
Skill catalog, model loading, and explicit user injection
packages/skill/tool-skill/src/index.ts:27-430Each catalog description defaults to a 500-character cap but the whole catalog has no aggregate cap; the model tool and user gesture recheck invocation policy, load full bodies on demand, and only whitespace-bounded /name in direct user input creates durable instructions context.1414
MEMORY-SKILL-REGISTRY
Layered Skill registry, shadowing, and on-demand loading
packages/skill/skill/src/index.ts:327-619The registry merges global and scope-chain layers, lets the nearest scope shadow same-name entries while rank resolves within a layer, returns summaries from list and snapshot, and loads the winning full definition on demand through get.1414
MEMORY-WEB-HOST-GATE
Web Session visibility baseline, search-hit gate, and error boundary
packages/host/apiproxy/src/api-proxy.ts:1720-2162The Host builds visibility from attached and servable cwd-bearing cold Sessions, accepts only current user or assistant hits in that set, and still interpolates underlying errors with a note to redact before multi-user deployment.1414
MULTIAGENT-ACP-PROVIDER
ACP external-provider boundary
packages/subagent/subagent-acp/src/index.ts:124-170An ACP child starts out of process, advertises zero start capabilities and no parent history, and runs one-shot with either a configured cwd override or the parent Session cwd.2424
MULTIAGENT-ACTIVATION-DISPOSAL
Activation top-down cancellation and child-first release
packages/subagent/subagent/src/continuation.ts:1270-1380Disposal installs the admission cutoff, synchronously cancels top-down, disposes children, awaits idle/flush, then releases handles child-first, notifies the parent, and releases ownership.2424
MULTIAGENT-ACTIVATION-MODEL
Continuable Activation data model
packages/subagent/subagent/src/continuation.ts:151-240Activation state derives from Agent quiescence and owned children; each epoch holds the exact handle, ancestry, accepted IDs, ownership set, and memoized disposal.2424
MULTIAGENT-ACTIVATION-OWNERSHIP
Parent ownership and the acceptance gap
packages/subagent/subagent/src/continuation.ts:1094-1174A continuation-managed parent acquires ownership before the child runs, and accepted IDs register before synchronous inbox send so neither parent nor child settles during the admission microtask gap.2424
MULTIAGENT-ASSISTANT-OUTPUT
Canonical child assistant output
packages/subagent/subagent/src/assistant-output.ts:1-74The canonical rule selects the last non-empty assistant message, otherwise accumulated text deltas, independently of stop reason.2424
MULTIAGENT-CHILD-COMPOSITION
Child-scoped composition
packages/subagent/subagent/src/child-agent.ts:130-175Each in-process child first joins the parent preset, then receives fixed delegation context plus child-scoped persona and tool restrictions.2424
MULTIAGENT-CHILD-INHERITANCE
Child options and durable lineage
packages/subagent/subagent/src/child-agent.ts:38-120Children default to parent provider/model/maxTokens; the durable header records cwd, parentSession, origin, delegationDepth, a nonzero seedLength when present, and the ID of the parent's current live composed preset.2424
MULTIAGENT-CHILD-LOCK
Per-child linearization lock
packages/subagent/subagent/src/continuation.ts:319-340ChildLock serializes operations by durable child ID and absorbs one critical section's rejection so later callers remain independent.2424
MULTIAGENT-CLAUDE-PROVIDER
Fixed Claude Code one-shot provider
packages/subagent/subagent-claude-code/src/index.ts:50-112The Claude Code provider advertises zero capabilities and no parent history, resolves the CLI executable, and runs a one-shot child in the parent workspace under the shared subprocess owner.2424
MULTIAGENT-CODEX-PROVIDER
Fixed Codex one-shot provider
packages/subagent/subagent-codex/src/index.ts:47-100The Codex provider has a fixed name, zero start capabilities, and no parent history; it requires the parent Session cwd and starts each run through the subprocess service.2424
MULTIAGENT-CODEX-RUN
Codex app-server one-shot run lifecycle
packages/subagent/subagent-codex/src/run.ts:28-199Each run spawns a fixed app-server and publishes only after initialize and ephemeral-thread success, then runs one text-only Turn; disposal closes the protocol and reclaims the process tree.2424
MULTIAGENT-CODEX-UNATTENDED
Codex unattended requests and notification filtering
packages/subagent/subagent-codex/src/wire.ts:294-373Approvals only cancel/decline, permission and user-input responses are empty, MCP elicitation is declined, and notifications bind the exact thread/Turn while excluding commentary and retaining the last final answer.2424
MULTIAGENT-CODEX-WIRE
Codex handshake, ephemeral thread, and result selection
packages/subagent/subagent-codex/src/wire.ts:128-373The wire performs initialize/initialized, requires an ephemeral thread, submits one Turn, maps contextWindowExceeded to max-tokens, and selects the last final or unphased answer.2424
MULTIAGENT-COLD-RESUME
Provider-independent cold resume
packages/subagent/subagent/src/continuation.ts:876-932Cold resume inspects persistence, first authorizes the exact direct parent, folds only the child-suffix descriptor, and materializes/resumes directly without invoking the original provider.2424
MULTIAGENT-CONTINUABLE-START
Continuable-child start transaction
packages/subagent/subagent/src/continuation.ts:388-457The manager reserves identity, snapshots descriptor and policy, prepares the seed, materializes the child, and returns childId/messageId only at inbox acceptance; earlier failure rolls back completely.2424, 33
MULTIAGENT-CONTROL-TOOLS
send_message and interrupt_agent
packages/subagent/tool-subagent-control/src/index.ts:25-119send_message uses the exact calling Agent as direct-parent authority and returns only messageId; interrupt_agent requests cancellation under exact-ancestor authority and returns immediately.2424
MULTIAGENT-DELEGATED-POLICY
Delegated-policy capture and persistence
packages/subagent/subagent/src/child-agent.ts:177-225When the corresponding service exists, delegation captures the parent's explicit Session sandbox override and pins approval to never; only defined overrides are appended to the child log.2424
MULTIAGENT-DEPTH
Monotonic delegation depth
packages/subagent/subagent/src/depth.ts:18-50Effective depth is the maximum of the durable header and runtime option; caps must be nonnegative safe integers so a resumed child cannot lower itself to top-level.2424
MULTIAGENT-DESCRIPTOR
Versioned durable subagent descriptor
packages/subagent/subagent/src/descriptor.ts:1-88The model-hidden v2 descriptor distinguishes one-shot and continuable children and stores resumable composition while deliberately omitting subagentDepth, outputSchema, and maxTokens.2424
MULTIAGENT-DESCRIPTOR-FOLD
Strict descriptor parse, snapshot, and fold
packages/subagent/subagent/src/descriptor.ts:195-314Current-version descriptors strictly validate fields and are lossless-JSON snapshotted before creation; within a supplied event slice the first descriptor is authoritative.2424
MULTIAGENT-DESCRIPTOR-PROJECTION
Last-wins projection for descriptors in fork seeds
packages/subagent/subagent/src/projection.ts:111-155The identity projection is last-wins so the child's descriptor overrides ancestor identity in its seed; malformed or unknown versions reset to null.2424
MULTIAGENT-DESCRIPTOR-SEED
Between-Turn continuable-descriptor seed
packages/subagent/subagent/src/descriptor-seed.ts:13-30A continuable child's creation seed contains an optional inherited prefix followed by one model-hidden between-Turn descriptor accepted through Session sequencing rules.2424
MULTIAGENT-DRAIN
Manager and scoped-forest drain
packages/subagent/subagent/src/continuation.ts:695-803Drain closes admission before its first await, waits for materialization boundaries, disposes the forest by roots, and scoped drain opens every cancellation transaction synchronously before aggregating failures.2424
MULTIAGENT-FINAL-FLUSH
Best-effort final flush and persistence requirement
packages/subagent/subagent/src/continuation.ts:1451-1478After Activation quiescence the runtime requests a final Session flush; failure only warns that resume may be stale and does not block release, while new continuable starts require persistence.2424
MULTIAGENT-FOLLOWUP
Continuable follow-up routing
packages/subagent/subagent/src/continuation.ts:459-505Per-child locking linearizes messages: resident children enqueue or wake, absent children cold-resume, and the caller signal owns work only until inbox acceptance.2424
MULTIAGENT-FORK-PROVIDER
In-process fork provider and continuable note
packages/subagent/subagent-fork-in-process/src/index.ts:40-94Fork copies only the balanced prefix through the last turn/end, supports all four capabilities, and implements prepareContinuable while its source comment says no shipped caller uses it.2424
MULTIAGENT-INBOX-SPLICE
Durable Inbox splice precedes live updates
packages/core/agent/src/inbox.ts:128-192Inbox splice first appends durable agent/inbox/spliced, then updates the live inbox and publishes inserted notifications only after append succeeds.2424
MULTIAGENT-INTERRUPT
Current-Turn interrupt semantics
packages/subagent/subagent/src/continuation.ts:507-568For a live target, interrupt authorizes the exact parent or ancestor, requests keepInbox cancellation, and returns immediately while preserving the Activation, unclaimed messages, and descendants. An absent target is a no-op; only ancestor-caller liveness is checked before lookup.2424
MULTIAGENT-INVARIANTS
Subagent registry and lifecycle invariants
packages/subagent/subagent/src/invariant.ts:14-84The invariant companion checks provider add/remove consistency, no duplicate live run IDs, start/end pairing, and matching provider, child ID, and local flag.2424
MULTIAGENT-JOB-CAPACITY
Per-owner background Job capacity
packages/jobs/jobs-local/src/index.ts:126-150Job start counts active tasks by owner and rejects a new Job when the configured per-owner limit has been reached.2424
MULTIAGENT-LIFECYCLE
One-shot and Activation-epoch lifecycle
packages/subagent/subagent/src/lifecycle.ts:76-217Listener failures are individually contained; one-shot runs and each continuable residency epoch emit paired start/end edges, with a new runId and epoch-only suffix on cold resume.2424, 33
MULTIAGENT-LIST-CONCURRENCY
Listing cold-read concurrency limit
packages/subagent/subagent/src/list-children.ts:27-32Read-only cold inspection of local persistence is bounded by the constant four.2424, 33
MULTIAGENT-LIST-SERVICE
Durable child and descendant enumeration
packages/subagent/subagent/src/list-children.ts:117-409Listing merges live and persistent corpora, classifies through projections, and degrades per-child read/fold damage to diagnostics without consulting Activation/provider state.2424
MULTIAGENT-LIST-TOOL
list_agents states and filtering
packages/subagent/tool-subagent-control/src/list-agents.ts:52-105Model statuses running/idle/ready derive from the live registry; ready means storage-only resumable, one-shot rows are filtered, and descendant depth constrains follow-up versus interrupt.2424
MULTIAGENT-ONE-SHOT-DRIVER
In-process one-shot driver
packages/subagent/subagent-in-process-driver/src/index.ts:78-205During unpublished setup, the driver applies policy and composition and installs the descriptor-append hook; the event appends at the first entered pre-step after publication, followed by one prompt, idle wait, and idempotent handle disposal.2424
MULTIAGENT-ONE-SHOT-RESULT
One-shot result suffix and stop reason
packages/subagent/subagent-in-process-driver/src/index.ts:207-233Results read only the child-owned suffix, preserve final output, and map the actual Turn end; a completed schema request without a capture is reclassified as error.2424
MULTIAGENT-OUTPROCESS-SETTLEMENT
External-run failure normalization and idempotent teardown
packages/subagent/subagent/src/out-of-process.ts:155-215Post-publication attempt rejection normalizes to aborted/error with partial output, and the subprocess run handle memoizes teardown and awaits actual exit.2424
MULTIAGENT-PRESET-INHERITANCE
Child joins the parent's exact preset generation
packages/preset/agent-presets/src/index.ts:290-325composeFrom binds to the parent's existing standing composition, sharing the same plugin instances, tools, and prompt sections without rereading the preset roster.2424
MULTIAGENT-REPORT-DELIVERY
Report authority and parent scheduling
packages/subagent/subagent/src/continuation.ts:570-693Only the exact resident child may report; the recipient resolves from durable direct-parent lineage, wakeup uses followup, quiet uses inject, and reporting does not change Activation lifetime.2424
MULTIAGENT-REPORT-TOOL
Continuable child-scoped report tool
packages/subagent/tool-subagent-report/src/index.ts:40-142The report tool and prompt install only in continuable in-process child scopes, send selected content only to the direct parent without ending the Turn, and register/clean up transactionally.2424
MULTIAGENT-RUN-SETTLEMENT
One-shot background Job settlement
packages/subagent/subagent/src/run-settlement.ts:21-63Only completed emits final text, aborted maps to killed, and other reasons map to failed; disposal always runs and preserves both details when result and cleanup fail.2424
MULTIAGENT-RUNTIME-DISPATCH
Validation boundary before provider dispatch
packages/subagent/subagent/src/index.ts:404-495Before provider.start, the service validates provider presence, capabilities, depth, schema, and descriptor; startup rejection publishes no lifecycle, and prepareContinuable method presence is the continuation capability.2424
MULTIAGENT-SDK-PROVIDER
Independent SDK-runtime provider
packages/subagent/subagent-dsh-sdk/src/index.ts:1-119The SDK provider starts a complete external runtime with its own composition, model, and tools, advertises no parent-enforced capabilities, and inherits no parent conversation.2424
MULTIAGENT-SEAM
Subagent capabilities and provider seam
packages/subagent/subagent/src/types.ts:75-323Providers explicitly declare four start capabilities, parent-history inheritance, one-shot start, and optional prepareContinuable; distinct children may overlap and the manager, not the provider, owns continuable lifecycles.2424
MULTIAGENT-SETTLEMENT-NOTICE
Continuable settlement notice
packages/subagent/subagent/src/continuation.ts:1382-1448Every child whose ID was announced attempts to send a stop summary and closing output independently of report; an absent parent is silently skipped, while delivery failure is logged and dropped without blocking teardown.2424
MULTIAGENT-SPAWN-PROVIDER
In-process spawn provider
packages/subagent/subagent-spawn-in-process/src/index.ts:34-64Spawn supports all four capabilities, does not seed parent history, and implements both one-shot start and fresh continuable preparation.2424
MULTIAGENT-STRUCTURED-OUTPUT
Two-phase commit for child structured output
packages/subagent/subagent-in-process-driver/src/structured.ts:49-141The child scope installs a schema tool, prompt, and guard; values stage first and commit only after the authoritative tool result and any Code Mode outer result succeed.2424
MULTIAGENT-TOOL-CONCURRENCY
Delegation-tool concurrency safety and parallel guidance
packages/subagent/tool-subagent/src/index.ts:366-465The tool declares concurrency safety because children do not mutate the parent Session, and continuable guidance encourages independent starts in one assistant message.2424
MULTIAGENT-TOOL-CONFIG
Delegation-tool configuration and default depth
packages/subagent/tool-subagent/src/index.ts:28-99A tool instance configures provider, toolName, backgroundMode, Agent options, persona/filter, and maxDepth; the loader defaults depth to 3 and permits provider-managed.2424
MULTIAGENT-TOOL-ROUTES
Three delegation-tool execution routes
packages/subagent/tool-subagent/src/index.ts:246-429run_in_background and backgroundMode select foreground one-shot, Job-backed one-shot, or continuable background execution with distinct return values and commit points.2424
OBS-ANON-ID
Harness-home anonymous UUID
packages/identity/anonymous-user-id/src/index.ts:1-100A random UUID is cached per process and persisted per home when possible; later processes reuse it after convergence, concurrent first launch has a narrow race, and an unwritable home is stable only for the current process. It is not host- or network-derived.2828
OBS-DURABLE-FAILURE
Live agent errors and durable turn closure
packages/core/agent-loop/src/agent.ts:202-323The Agent emits a coordinate-bearing live error before rethrow, contains it at the driver, and still records structured turn/end in finally.2828
OBS-FEEDBACK-DISCLOSURE
Feedback recording and sharing disclosure
packages/feedback/command-feedback/src/index.ts:1-106Feedback is an unflushed log-only event that starts no model work, and its acknowledgement distinguishes four sharing states.2828
OBS-HARD-OPTOUT
Final telemetry hard opt-out
apps/cli/src/profile-boot.ts:56-170Within apps/cli profile composition, any non-empty DSH_TELEMETRY_DISABLED value patches the fixed session-telemetry-otel row id after profile, home, and CLI overlays; another row id/backend is outside that patch.2828
OBS-HISTORY-API
Raw-history pagination contract
packages/host/apiproxy/src/api/sessions.ts:264-283Pages align to message origins and include raw events plus host views; only the tail carries partial/projections, and reads never resume an Agent.2828
OBS-HISTORY-CLIENT
Client contiguous window and gap repair
packages/client/runtime/src/client/sessions/session.ts:376-723Load-older checks adjacent sequences, live data deduplicates by seq, and gaps buffer and repull the tail; discontinuities and transport exceptions log to console, while RPC error results silently preserve the window.2828, 33
OBS-HOST-FAILURE
Host live-failure frame
packages/host/apiproxy/src/api/events.ts:110-154Defines transient host/agent-error with session id/message but no turn position, and calls it the only outlet for that class of live failure.2828
OBS-OPS-LOGS
Telemetry-failure containment logs
packages/session/session-telemetry/src/coordinator.ts:112-267Backend shutdown and per-step capture failures only warn locally and do not affect the agent loop or application teardown.2828
OBS-OTEL-PIPELINE
OTel Logs pipeline and field mapping
packages/session/session-telemetry-otel/src/index.ts:197-232Builds LoggerProvider, BatchLogRecordProcessor, and OTLP log exporter, setting resource, two scopes, time, severity, body, and attributes.2828
OBS-OTEL-SHUTDOWN
Batch ownership and bounded shutdown
packages/session/session-telemetry-otel/src/index.ts:265-298The backend implements no flush; provider shutdown races an outer deadline that cannot cancel the SDK transport.2828
OBS-PERSISTENCE-DIAGNOSTIC
Background-persistence failure diagnostics
packages/session/session-persistence/src/coordinator.ts:1325-1350Background write failure warns that buffered events are retained, while explicit flush still propagates failure.2828
OBS-PROJECTION-DEGRADE
Fail-soft projection degradation
packages/host/apiproxy/src/api-proxy.ts:847-898Projection helpers for session.list and subagent.history warn on failure and return undefined so responses continue without the projection block.2828
OBS-QUERY-AUTH
Workspace authorization and lineage pruning
packages/session-query/tool-session-query/src/workspace-access.ts:54-203The caller comes from the Agent; self or exact cwd equality authorizes, observed headers are rechecked, and unauthorized subtrees become null markers.2828
OBS-QUERY-CORPUS
Live-preferred logical corpus
packages/session-query/session-query/src/corpus.ts:31-116Single-target exact loads bypass persistence for known live targets, unlike corpus-wide operations. Persisted exact targets list/inspect and check header compatibility only if still detached; a late live attachment wins directly.2828
OBS-QUERY-CURRENT-BOUNDARY
Current-step self-search boundary
packages/session-query/tool-session-query/src/operations.ts:116-166Current-session event search caps its range before the latest step/start and re-authorizes the returned header.2828, 33
OBS-QUERY-DIAGNOSTIC
Full local session-query diagnostics
packages/session-query/tool-session-query/src/service-boundary.ts:116-171The service boundary best-effort renders complete printable stack/cause chains locally, uses a fixed placeholder for unprintable values, and contains cyclic causes or diagnostic failure.2828
OBS-QUERY-SANITIZE
Model-boundary error sanitization
packages/session-query/tool-session-query/src/service-boundary.ts:19-171Preserves caller cancellation, best-effort logs complete printable diagnostics locally with a fixed placeholder for unprintable values, and exposes only allowlisted stable codes/messages or a generic failure to the model.2828
OBS-QUERY-SERVICE
Unified session-query service
packages/session-query/session-query/src/index.ts:74-345Exact read/filter/trace behavior is backend-independent; full reads replay-validate and expose surfaces, lineage, event traces, and bounded raw windows.2828
OBS-QUERY-TRACE
Event relationships and session lineage
packages/session-query/session-query/src/tracing.ts:21-213Computes replacement/source/derived links, current/shadowed/log-only classification, and ancestry/descendants with unresolved and cycle semantics.2828
OBS-RAW-FRAMES
Raw mux, transient projections, and remote frames
packages/host/apiproxy/src/api/events.ts:65-154The mux carries raw session events, projections are replayable transient pushes, and allowlisted remote frames apply no redaction.2828
OBS-REQUEST-HEADER
Request-header assembly and logging
packages/core/agent-loop/src/agent.ts:407-470The Agent builds a header from effective model config, full system prompt, and tool catalog, then records initial, resume, or change snapshots.2828
OBS-SESSION-HISTORY-PROJECTION
Direct projection path for ordinary session history
packages/host/apiproxy/src/api-proxy.ts:1555-1573The ordinary session.history cut directly calls the live snapshot or detached restore without the list/subagent helper catches.2828
OBS-SESSION-LIST-PROJECTION
Session-list baseline invokes the fail-soft projection helper
packages/host/apiproxy/src/api-proxy.ts:1720-1764Both attached and cold session.list summary baselines inject their optional projection block through listProjectionsFor.2828
OBS-SESSION-LOG
Session event-log contract
packages/core/session/src/types.ts:152-309Defines structured turn outcomes and the append-only, lossless, contiguous raw-event source of truth with its major payloads.2828
OBS-STATS-CONTRACT
Whole-log stats contract
packages/session/session-stats/src/types.ts:15-45Defines turn, step, model/tool time, TTFT, and decode figures independent of client pagination.2828
OBS-STATS-FOLD
Pure session-stats fold
packages/session/session-stats/src/projection.ts:1-183Implements per-event step, first-token, assistant, tool-pair, and turn-cleanup timing/counting with usage, skew, and prototype-key guards.2828
OBS-STATS-UI
Stats UI projection precedence
packages/client/ui-conversation/src/client/chat/StatsLine.tsx:34-205The UI prefers whole-log sessionStats, falls back to a window fold only when absent, and displays timing, throughput, cache, and token figures.2828
OBS-SUBAGENT-HISTORY-PROJECTION
Subagent history invokes the fail-soft projection helper
packages/host/apiproxy/src/api-proxy.ts:2668-2696Both live and detached subagent.history tails compute projections through the fail-soft helper.2828
OBS-TELEMETRY-CONTRACT
Telemetry record and sink contract
packages/session/session-telemetry/src/index.ts:47-130Defines ledger/ops channels, minimal attributes, complete bodies, synchronous non-blocking emit, and backend-owned batching and loss.2828
OBS-TELEMETRY-HANDOFF
Handoff cursor and adoption
packages/session/session-telemetry/src/coordinator.ts:32-169The module-scope cursor marks handed-off rather than delivered; live adoption, on-demand suffixes, and firstLiveSeq form a capture-side at-most-once high-water mark without constraining downstream retries or end-to-end delivery semantics.2828
OBS-TELEMETRY-MODES
FULL, FEEDBACK_ONLY, and DISABLED
packages/session/session-telemetry-otel/src/index.ts:43-252Defaults to disabled; uploading modes build the SDK and FULL captures live, while feedback-only releases an eligible suffix only on canonical feedback: after the cursor when one exists, otherwise from firstLiveSeq.2828, 33
OBS-TELEMETRY-PROJECTION
Capture projection and copying
packages/session/session-telemetry/src/coordinator.ts:179-220Hands off only the first chunk per turn/step and deep-copies other event data through redaction to the backend.2828
OBS-TELEMETRY-REDACTION
Synchronous redaction waterfall
packages/session/session-telemetry/src/index.ts:24-43The seam ships no rule; listeners compose synchronously, throws fail closed per record, and only the outbound copy changes.2828
OBS-TELEMETRY-SEVERITY
Ops errors and severity mapping
packages/session/session-telemetry/src/coordinator.ts:228-302Agent errors retain only name/message; only error tool results, error turn ends, and agent-error map to error severity.2828
OBS-TRAJECTORY-BUILDER
Trajectory snapshot builder
packages/client/ui-trajectory/src/client/trajectory-snapshot-builder.ts:137-266Composes event nodes, requests, schemas, partials, running calls, compactions, and turn errors in raw-sequence order.2828
OBS-TRAJECTORY-PROMPT
Prompt snapshots and change detection
packages/client/ui-trajectory/src/client/trajectory-request-header-definition.ts:9-80Reconstructs config, full system text, and tools from request/header and classifies initial/system/tools changes.2828
OPEN-API-RESERVED-SEATS
Unimplemented cursor for session list
packages/host/apiproxy/src/api/sessions.ts:231-240The public API accepts an optional cursor, but v1 list returns every session and the cursor is only reserved; search likewise has no continuation cursor.3434
OPEN-EVENT-RESUME-SEAT
Unimplemented since hook for the mux stream
packages/host/apiproxy/src/api/events.ts:46-56events.mux accepts a since map but ignores it in v1; the reconnect contract is reopen the stream plus refetch history.3434
OPEN-HOST-VERSION-CONTRACT
Public contract for the Host version
packages/host/apiproxy/src/api/host.ts:35-53The HostApi.describe comment defines version as the host application version from apps/cli package.json.3434
OPEN-HOST-VERSION-IMPL
Placeholder implementation of the Host version
packages/host/apiproxy/src/api-proxy.ts:2923-2938The implementation carries a TODO and returns the constant 0.0.1 instead of reading the CLI manifest.3434
OPEN-LIMITATIONS-GATE
Package limitations-ledger gate
scripts/verify-package-readme-limitations.ts:1-93Scans every two-level package manifest, requires the canonical limitations heading and at least one top-level bullet in the sibling README, and permits omission only through an explicitly justified whitelist.3434
OPEN-SETTINGS-REDACTION-CODE
Schema shapes missed by the settings secret walker
packages/settings/settings/src/redact.ts:50-109The walker recurses only through object, dict, and array; its default branch explicitly returns a secret reachable only through a union, intersection, or transform verbatim without recording the miss.3434
PARALLEL-ABORT
Stop-replenish and started-call drain after abort
packages/core/agent-loop/src/tool-calls.ts:198-245The pool rechecks abort between replenishment and ordered commits; after cancellation it starts no new calls, drains in-flight work, commits started calls, and appends synthetic results for unstarted calls in the group.1818
PARALLEL-ABORT-RESULT
Synthetic call/result pair for unstarted calls
packages/core/agent-loop/src/tool-calls.ts:248-259A model call skipped by cancellation still receives tool/call plus a tool/result carrying structured ABORTED_BEFORE_DISPATCH, keeping replay pairing closed.1818
PARALLEL-AGENT-STEP
Agent-step decision after the complete call batch
packages/core/agent-loop/src/agent.ts:393-399The agent awaits the entire executeToolCalls batch before using the aggregated concluded flag to complete the step; otherwise it advances to another step.1818
PARALLEL-CAP-CONFIG
Dynamic configuration boundary for the native parallel cap
packages/core/agent-loop/src/index.ts:300-345AgentLoop resolves maxParallelToolCalls with the shared default of 10 and reads committed Settings changes through a getter beginning with the next group.1818
PARALLEL-CLASSIFIER
Fail-closed classification on the live definition
packages/core/tools/src/index.ts:1269-1285executionMode classifies through the currently visible tool definition; missing, unknown, hidden, throwing, or non-exact-true classifiers all return exclusive.1818
PARALLEL-CODE-BINDING
Staged dispatch and durable events for Code bindings
packages/core/tools/src/code-mode.ts:464-594Each nested binding gets a deterministic subCallId and runs through the same staged ToolRuntime, appending code-dispatch-start first; ordered commit defers contexts, returns the program value, and asynchronously shapes and appends code-dispatch.1818
PARALLEL-CODE-DRAIN
Cancellation, commit, and log drain in Code Mode
packages/core/tools/src/code-mode.ts:448-629After the outer run settles it aborts; the run-scoped drain abandons queued-unstarted entries, awaits the live pool and ordered commit lane, and empties logWork; commit finalizes in submission order, forwards contexts, then starts non-blocking settle-log side work.1818
PARALLEL-CODE-DRIVER
Independent per-run scheduler for Code Mode
packages/core/tools/src/code-mode.ts:328-457Each run_code creates its own abort controller, pending and commit queues, in-flight set, and single driver lane; only dispatch/body overlaps, an exclusive barrier lasts through ordered commit, and settlement/log work drains before the run ends.1818
PARALLEL-DISPATCH
Concurrent around-dispatch and tool body stage
packages/core/tools/src/index.ts:1527-1599Dispatch fuses caller and wrapper signals, awaits any started body to quiescence, invokes it through tools/execute wrappers, and merges deferred contexts into the normalized result.1818, 33
PARALLEL-DURABLE-PAIRING
Durable sequence pairing for tool calls and results
packages/core/agent-loop/src/tool-calls.ts:164-288Each started call appends tool/call with the original argument string before prepare and retains its sequence; tool/result cites that exact call through sourceEventSeqs.1818, 33
PARALLEL-FINALIZE
Ordered post, finalization, and result notification
packages/core/tools/src/index.ts:1601-1675Finalize awaits post-execute, applies definition-owned content finalization, materializes the final snapshot, and synchronously dispatches tools/result; promises returned by observers are error-observed but not awaited.1818
PARALLEL-GROUPING
Group progression from live classification
packages/core/agent-loop/src/tool-calls.ts:82-100In model order, the scheduler reads the next call's live execution mode: parallel takes the remaining suffix, exclusive forms a singleton, and the consumed cursor advances only after the group finishes.1818, 33
PARALLEL-LOOP-ENTRY
Tool scheduling entry after assistant-message commit
packages/core/agent-loop/src/agent.ts:373-399The loop appends the complete assistant/message before extracting every tool-call block and invoking executeToolCalls; a step completes directly when no calls exist.1818
PARALLEL-MODE-CONTRACT
Concurrency safety is strict opt-in host metadata
packages/core/tools/src/index.ts:257-269ToolDefinition.isConcurrencySafe is a pure synchronous classifier; only true opts in and the metadata is not sent to the model. Authors must avoid parent-owned mutation and make shared-state races commute or fail closed.1818
PARALLEL-PIPELINE-SPLIT
Scheduler-only staged ToolRuntime view
packages/core/tools/src/index.ts:426-466A private symbol-keyed scheduler view splits the full pipeline into prepare, dispatch, finalize, and finish so policy stays ordered while only bodies overlap; ordinary callers still use execute.1818
PARALLEL-PREPARE
Ordered prepare, approval, and guards
packages/core/tools/src/index.ts:1453-1507Prepare creates the execution, handles pre-dispatch cancellation, awaits pre-execute, approval, and monotonic guards, then returns dispatch, post-result, or final-result.1818, 33
PARALLEL-RESULT-OBSERVER
Non-awaited tools/result observers
packages/core/tools/src/index.ts:1656-1675Result observers are invoked synchronously after the final snapshot; returned promises receive only a rejection logger and do not become scheduler-awaited barriers.1818
PARALLEL-ROLLING-POOL
Bounded rolling pool and ordered commit cursor
packages/core/agent-loop/src/tool-calls.ts:121-245runGroup overlaps dispatch only and replenishes up to maxParallelToolCalls; settled slots are finalized, appended, and have context accepted only through a contiguous model-order commit cursor.1818, 33
PARALLEL-SCHEDULER-FAILURE
Quiescence boundary for internal scheduler failures
packages/core/agent-loop/src/tool-calls.ts:215-245An internal failure stops new dispatch, Promise.allSettled drains every started dispatch, and the first scheduler error is rethrown; this path does not fabricate unattributable tool results.1818, 33
PARALLEL-TYPED-CLASSIFIER
Argument-validating classifier wrapper in defineTool
packages/core/tools/src/schema.ts:545-615defineTool validates with the same parameter schema before invoking the typed isConcurrencySafe callback; invalid arguments classify as false.1818
PERSIST-ATTACH-DECODE-IMPL
Implementation difference between full decode and header probe
packages/attachment/attachment-local/src/image.ts:21-65probeImage reads only Sharp metadata, while detectImage checks the pixel limit and calls image.raw().toBuffer() for a full decode.1111
PERSIST-ATTACH-DECODE-SOURCE
Actual Attachment admission and read branches
packages/attachment/attachment-local/src/store.ts:46-230Admission goes through detectImage, while read verifies the digest before calling probeImage and comparing media type, bytes, width, and height.1111
PERSIST-ATTACH-SEAM
Attachment durability seam
packages/attachment/attachment/src/index.ts:28-59AttachmentStore exposes immutable binary references; saveImage must validate and durably commit before the owning Session event is appended, and readImage must verify bytes against the reference.1111
PERSIST-ATTACH-STORE
Content-addressed local Attachment publication
packages/attachment/attachment-local/src/store.ts:19-194The local store addresses by SHA-256, uses private staging, a synced file, exclusive hard-link publication, and directory fsync, and re-reads and hashes an existing object during deduplication races.1111
PERSIST-BACKEND-CONTRACT
Session persistence backend contract
packages/session/session-persistence/src/coordinator.ts:117-214A backend supplies prefix reads, revisions, optional suffix seeking, atomic first materialization, durable append, repair, listing, and close while the coordinator owns the rest of the protocol.1111
PERSIST-COORDINATOR
PersistenceCoordinator state and commit order
packages/session/session-persistence/src/coordinator.ts:575-710The coordinator keys state, promise chains, and preparations by Session ID, lifecycle state by live Session, and advances materialized state, cursor, and cache invalidation only after durable appendBatch completion.1111
PERSIST-DOMAIN-CLOSE-GAP
One-way Domain close failure state
packages/storage/storage-domain/src/domain.ts:148-275Close first sets disposing and drains the chain; if unit.close rejects, closed and onClosed are never reached and the rejected disposal is cached, leaving writes rejected, reads available, and the name unreopenable.1111
PERSIST-DOMAIN-ORDER
Domain durability-first write ordering
packages/storage/storage-domain/src/domain.ts:135-269Domain serializes writes through one promise chain, updates memory only after backend success, then emits a contained changed notification; failed writes leave memory untouched.1111
PERSIST-JSON-ATOMIC
JSON KV atomic replacement protocol
packages/storage/storage-json/src/atomic.ts:1-52The writer creates an owner-only same-directory temp, writes and fsyncs it, renames it over the target, then fsyncs the parent on POSIX; failures remove the temp and propagate.1111
PERSIST-JSON-ROOT-GAP
JSON Storage relative-root gap
packages/storage/storage-json/src/index.ts:21-66Configuration requires an explicit root, but the schema accepts a relative string, the backend stores it verbatim, and later openUnit calls mkdir and join, so a cwd change can redirect newly opened units.1111
PERSIST-JSON-UNIT-ROLLBACK
JSON KV in-memory rollback after failure
packages/storage/storage-json/src/unit.ts:47-140Each KV mutation changes unit memory before publishing the whole file and restores old memory on any publish rejection, even though publication can reject during the directory fsync after rename.1111
PERSIST-JSONL-FORMAT
JSONL header, path encoding, and chunk packing
packages/session/session-persistence-jsonl/src/format.ts:28-223The format starts with a dedicated Session header, injectively escapes unvalidated branded IDs into safe path segments, and can losslessly pack delta runs into storage rows.1111
PERSIST-JSONL-REPAIR
JSONL reads, publication, rollback, and repair
packages/session/session-persistence-jsonl/src/index.ts:306-701The reader returns a byte-offset torn marker plus recoverable complete events; first write uses a synced temp and no-clobber publication, failed append restores length, and repair truncates and syncs before normally appending recovered events and closers.1111
PERSIST-JSONL-ROOT
JSONL root and sequential-medium boundary
packages/session/session-persistence-jsonl/src/index.ts:115-200The JSONL constructor resolves its root once, normalizes programmatic-construction defaults, returns absolute artifact paths, and intentionally omits seek-capable loadStoredFrom.1111
PERSIST-JSONL-SCAN
Tail classification of complete JSONL rows
packages/session/session-persistence-jsonl/src/format.ts:272-388The scanner checks JSON, storage shape, and sequence for complete newline-terminated records; if no later turn/end follows a defect, finish returns the pre-defect committedBytes, placing even a complete bad row in the truncatable suffix.1111
PERSIST-READ-FACES
Prepare, load, inspect, and readFrom roles
packages/session/session-persistence/src/coordinator.ts:712-970Prepare reserves the exact unpublished Session, load commits cold recovery, inspect borrows an immutable view without committing repair, and readFrom bypasses the preparation cache while remaining non-mutating.1111
PERSIST-SEAM-API
SessionPersistence authority and read surfaces
packages/session/session-persistence/src/index.ts:1-240The Service Definition makes SessionHeader plus contiguous SessionEvents durable facts and distinguishes locate, create, append, prepare, load, inspect, readFrom, list, and listSnapshots.1111
PERSIST-SESSION-SQLITE-CONSTRUCTOR
Session SQLite direct-constructor default leak
packages/session/session-persistence-sqlite/src/index.ts:69-146The schema defaults journalMode to wal, but the constructor normalizes only cache and batching defaults and passes the still-optional journalMode onward via a Required cast.1111
PERSIST-SQLITE-REPAIR
SQLite append and repair transactions
packages/session/session-persistence-sqlite/src/index.ts:278-338First materialization and batch append occur in one transaction; repair deletes the torn suffix, inserts synthetic closers, and advances the revision in another single transaction.1111
PERSIST-SQLITE-SCAN
SQLite torn-suffix classification
packages/session/session-persistence-sqlite/src/schema.ts:220-269scanRows treats bad JSON or a sequence gap through the last valid turn/end as committed corruption and marks only a later first defect as a discardable torn tail.1111
PERSIST-SQLITE-SCHEMA
Strict Session SQLite schema and refusal-based versioning
packages/session/session-persistence-sqlite/src/schema.ts:15-171The backend uses schema version 15, an application id, store identity, and STRICT sessions and events tables; unknown, foreign, or nonempty unversioned databases are refused rather than migrated.1111
PERSIST-SQLITE-SUFFIX
True SQLite suffix seeking
packages/session/session-persistence-sqlite/src/index.ts:220-237loadStoredFrom directly queries by session_id and seq >= fromSeq and scans only selected rows; a torn tail shortens the returned view without repair.1111
PERSIST-STORAGE-REGISTRY
Non-owning Storage registry unregistration
packages/storage/storage/src/registry.ts:14-36The registry disposer removes a name only while identity still matches and explicitly does not close the backend; medium lifecycle belongs to the provider plugin.1111
PERSIST-STORAGE-SEAM
Generic Storage backend seam
packages/storage/storage/src/backend.ts:12-104StorageBackend owns one medium and its lifecycle; KvUnit guarantees only per-call atomic durability while leaving opaque-JSON schemas and concurrent write ordering to callers.1111
PERSIST-STORAGE-SQLITE-CONSTRUCTOR
Generic SQLite Storage constructor default leak
packages/storage/storage-sqlite/src/index.ts:23-72The config schema promises a WAL default, but the public constructor force-casts the optional journalMode and passes it directly to asynchronous openDatabase.1111
PERSIST-STORAGE-SQLITE-OPEN
Generic SQLite open path dereferences journalMode
packages/storage/storage-sqlite/src/schema.ts:52-80After resolving the database path, openDatabase enters configureDatabase, which calls journalMode.toUpperCase() without a fallback.1111
PERSIST-STORAGE-SQLITE-SCHEMA
Generic SQLite Storage physical schema
packages/storage/storage-sqlite/src/schema.ts:15-119The generic backend uses physical user_version 1, STRICT units and unit_globals tables, and validated generated physical names for unit tables; other stamped versions are refused rather than migrated.1111
PERSIST-STORAGE-SQLITE-UNIT
Generic SQLite KV unit primitives
packages/storage/storage-sqlite/src/unit.ts:23-147Each declared table precompiles upsert, delete, and select statements with a separate global-slot upsert; each KV mutation is one synchronous SQLite statement settled through the Promise contract.1111
PERSIST-WORKSPACE-BOOTSTRAP
Header-only Workspace bootstrap
packages/workspace/workspace/src/index.ts:426-508Bootstrap groups headers by canonical cwd, reuses partial records, writes Workspace rows and order, and writes the initialized=true marker last.1111
PERSIST-WORKSPACE-INIT
Workspace initialization order
packages/workspace/workspace/src/index.ts:118-140Initialization opens the Domain, recovers a pending mutation, and validates state; an uninitialized registry lists headers, fully replaces the index, and bootstraps, while an initialized startup fully replaces the header index.1111
PERSIST-WORKSPACE-INVARIANTS
Cross-record Workspace invariants
packages/workspace/workspace/src/index.ts:510-551Startup validation rejects repeated order IDs, missing or orphan rows, duplicate canonical paths, and a Session accounted by multiple Workspaces.1111
PERSIST-WORKSPACE-MUTATION
Two-write Workspace mutation and recovery
packages/workspace/workspace/src/index.ts:285-424Create and delete write a durable pending marker before record and order can diverge, include compensation paths, and startup completes only the named mutation rather than guessing other divergence.1111
PERSIST-WORKSPACE-REFRESH
Workspace header-index refresh paths
packages/workspace/workspace/src/index.ts:561-630Startup replacement clears all three header and path maps; an uncached runtime lookup only incrementally indexes list results, while a cached hit returns directly and no public full-refresh path exists.1111
PERSIST-WORKSPACE-SCHEMA
Workspace Domain schema
packages/workspace/workspace/src/spec.ts:13-75Workspace domain version 2 consists of one workspaces table and global state; runtime shapes for ids, path, title, Session ids, and timestamps are largely plain strings.1111
PERSIST-WORKSPACE-TITLE-GAP
Stale Workspace create-time title branch
packages/workspace/workspace/src/index.ts:142-163Public create(path, title?) still accepts an optional raw title, but a source TODO says its last production caller was deleted and calls for removing the parameter.1111
PERSIST-WORKSPACE-TITLE-SETTER
Workspace title setter lacks semantic validation
packages/workspace/workspace/src/entity.ts:101-107setTitle accepts any string and writes it directly through the record mutation without nonblank, trimming, or length checks.1111
PERSIST-WRITE-BEHIND
Failure-safe Session write-behind queue
packages/session/session-persistence/src/write-behind.ts:19-157The queue clones events, uses a fixed deadline, shares concurrent flush barriers, restores failed batches ahead of newer events, and uses explicit flush to retry and drain to quiescence.1111
PLANSTATE-GOAL-API
Goal Host API mutation contract
packages/host/apiproxy/src/api/goals.ts:25-53The public façade exposes only create, edit, pause, resume, complete, and clear; reads use the goal projection and mutations return only ref or cleared acknowledgements.1515
PLANSTATE-GOAL-API-ERRORS
Goal service resolution and wire error mapping
packages/host/apiproxy/src/api-proxy.ts:1787-1825The Host resolves the Session-specific GoalService through the Agent preset and maps GoalError to wire internal with the stable domain code under details.goalCode.1515
PLANSTATE-GOAL-API-ROUTING
Host API Agent cold resume and subagent fence
packages/api/remotes/src/agent-lookup.ts:113-210The resolver reuses live Agents, coalesces cold resume per identity, and applies an agent-busy fence to live-owned or persisted subagent identities.1515
PLANSTATE-GOAL-AUTHORITY
Execution authority for model Goal tools
packages/goal/tool-goal/src/authority.ts:29-108Requires an exact live, running, current-initiator Agent in an open Turn; direct-human authority needs a root user source, while autonomous terminal actions require the matching current Goal round.1515
PLANSTATE-GOAL-COMMAND
/goal command grammar and state operations
packages/goal/command-goal/src/index.ts:14-170/goal provides show, create, edit, pause, resume, and clear by calling GoalService directly and returning text; it exposes no complete, block, or per-command round cap.1515
PLANSTATE-GOAL-COMMAND-UI
Goal command-input projection
packages/client/ui-goal/src/client/goal-command-input.ts:26-70The Web builds a separate visible command-input Chat Node from durable /goal command/run events without creating a model message.1515
PLANSTATE-GOAL-COMMAND-VIEW
Goal command-input bubble renderer
packages/client/ui-goal/src/client/GoalCommandInputView.tsx:11-30The dedicated renderer displays /goal input as a right-aligned bubble without ordinary message actions.1515
PLANSTATE-GOAL-COMMIT
Goal CAS, cache, and commit ordering
packages/goal/goal/src/index.ts:392-577Requires the exact live Agent and current GoalRef; cold caches start disarmed, and goal/changed emits only after goal/change append and cache synchronization.1515, 33
PLANSTATE-GOAL-DRIVER
Same-session Goal round driver
packages/goal/goal-round-driver/src/index.ts:75-445Full control flow for one attempt and coalesced run per Agent, checkpoint barriers, competing input, double reservation validation, error disarm/block/pause, and teardown quiescence.1515
PLANSTATE-GOAL-FOLD
Strict Goal state fold
packages/goal/goal/src/fold.ts:271-349The strict fold validates create, transitions, and clear, and advances roundsStarted only for the sequential goal-sourced user message matching the current active revision.1515
PLANSTATE-GOAL-PROJECTION
Lightweight last-wins Goal projection
packages/goal/goal/src/index.ts:83-113The browser projection handles only goal/change, maps clear to null, and preserves the same reference for other events, so admitted goal-round messages do not refresh roundsStarted.1515
PLANSTATE-GOAL-SERVICE
GoalService lifecycle mutations
packages/goal/goal/src/index.ts:216-390Defines phase, revision, capacity, and activation rules for get, disarm, create, edit, pause, resume, complete, block, and clear.1515
PLANSTATE-GOAL-TOOLS
get_goal, create_goal, and update_goal
packages/goal/tool-goal/src/index.ts:186-338Defines the three model tools, direct-human and action authority, the blocked-round threshold, and autonomous terminal wrap-up through deferContext.1515
PLANSTATE-GOAL-TYPES
Goal identity, revision, phase, and projection types
packages/goal/goal/src/types.ts:15-110GoalRef is the revision CAS identity; four durable phases are separate from process-local activation, which the browser projection deliberately omits.1515
PLANSTATE-GOAL-UI
GoalBar phase actions and single-flight
packages/client/ui-goal/src/client/GoalBar.tsx:34-186GoalBar hides absent and complete goals, offers phase-dependent pause or resume plus edit and clear, fences duplicate clicks synchronously, and locally suppresses a cleared id.1515
PLANSTATE-GOAL-UI-REMOTE
GoalBar Remote mutation wiring
packages/client/ui-goal/src/client/index.ts:40-99Every UI verb reads the latest CAS ref from the current goal projection at call time before invoking edit, pause, resume, or clear Remote.1515
PLANSTATE-PLAN-ASSEMBLY
Plan pre-Step and prompt assembly
packages/plan/plan-mode/src/index.ts:197-233Only an accepted pre-Step commits pending state; append failure retains it without blocking the Step, and plan:policy reads the pending target first.1515
PLANSTATE-PLAN-BOUNDARY
Plan selection commit boundary and narration
packages/plan/plan-mode/src/index.ts:396-473Idle selections commit immediately; open-Turn selections wait for an accepted pre-Step, survive append failure, and narrate only when the last request header saw the opposite mode.1515, 33
PLANSTATE-PLAN-CONTROLS
Plan command and reviewed exit tool
packages/plan/plan-mode/src/index.ts:268-393Defines /plan, exact lowercase off, optional steering text, and exit_plan_mode Markdown, review, dismissal, and delayed-exit rules.1515
PLANSTATE-PLAN-PROJECTION
Plan double-event projection
packages/plan/plan-mode/src/index.ts:235-266The plan projection folds command/run into a wanted target and plan/mode into committed active state, exposing active and pending.1515
PLANSTATE-PLAN-REVIEW-AUTH
Human-interaction ownership for Plan review
packages/interaction/user-questions/src/index.ts:80-139Agent-bound questions require the exact live runtime root; live-owned children are rejected, while a lineage Session later resumed as a root may ask.1515
PLANSTATE-PLAN-REVIEW-UI
Dedicated Plan review panel
packages/client/ui-user-questions/src/client/PlanReviewPanel.tsx:36-99The dedicated panel renders the Markdown plan, approve, decline, and discuss/cancel actions with a one-shot submission latch.1515
PLANSTATE-PLAN-STATE
Logged Plan state and process-local pending intent
packages/plan/plan-mode/src/index.ts:46-195plan/mode is a log-only, non-Surface, last-write-wins boolean event, while the controller separately keeps pending selections in a Session-keyed WeakMap.1515
PLANSTATE-PLAN-UI
Plan Web status chip
packages/client/ui-plan/src/client/PlanModeControl.tsx:15-68The Web computes the effective target from the plan projection, renders the chip only for Plan, and exits through /plan off.1515
PLANSTATE-TODO-INVARIANT
Coverage boundary of the Todo durable invariant
packages/todo/tool-todo/src/invariant.ts:15-57The companion validates the array, trimmed unique content, and status enum, deliberately omits active-count policy, and does not compare item own keys.1515, 33
PLANSTATE-TODO-ROW
Historical todo_write tool row
packages/client/ui-tool/src/client/tool/toolviews/todo-row.tsx:1-97The tool row derives done/total, first-active, and extra-active summaries from raw call arguments with fallback for malformed or rejected input.1515
PLANSTATE-TODO-TOOL
Todo whole-value tool and projection
packages/todo/tool-todo/src/index.ts:28-225todo_write requires the complete list, normalizes content, validates duplicates, statuses, and parallel-active policy, appends todo/write, and registers a last-wins projection cleared at turn/start.1515
PLANSTATE-TODO-UI
TodoPanel current-list view
packages/client/ui-conversation/src/client/skeleton/TodoPanel.tsx:81-153The Web renders a collapsible list, status counts, and all items from the todos projection and hides an empty list.1515
PLANSTATE-TOOL-EXCLUSIVE
Fail-closed tool concurrency classification
packages/core/tools/src/index.ts:1269-1285Only an exact true from isConcurrencySafe yields parallel execution; omission, exceptions, hidden, unknown, or invalid definitions are exclusive.1515
PLANSTATE-TOOL-SCHEDULER
Exclusive tool ordering barrier
packages/core/agent-loop/src/tool-calls.ts:82-119The Agent loop classifies calls in model order; an exclusive call forms a one-call group that is awaited, while a parallel group must drain before an exclusive reclassification.1515
PROFILE-COMPOSE
Effective profile patch order
apps/cli/src/profile-boot.ts:121-170The application order for bundle, profile, home, CLI, launcher preset, and telemetry overlays, including construction of the row index.0404, 33
PROFILE-LIVE
Live recomposition of user patches
apps/cli/src/profile-boot.ts:227-299Each generation rereads both user layers, clones patches to prevent reference contamination, and mounts a config-only HMR instance when needed.0404, 33
PROFILE-LOAD
Bundle resolution and isomorphic composition
packages/boot/app-boot/src/profile.ts:357-420Bundle declarations resolve in manifest order, missing dsh.bundle metadata fails, and the same applyEntryPatches operation used by boot composes over an empty root.0404
PROFILE-MODULE-FALLBACK
Flat module fallback for profiles
packages/boot/app-boot/src/profile.ts:204-255A breadth-first traversal of dependencies and peerDependencies creates a profiles/node_modules symlink closure from installation locations.0404
PROFILE-ROOT
Empty root and profile preparation
apps/cli/src/profile-boot.ts:59-103Every launch rewrites an empty cordis.yml; patches define the entire real tree and prevent Loader write-back from baking in composed rows.0404
PROFILE-TEMPLATES
Profile directories and built-in templates
packages/boot/app-boot/src/profile.ts:104-168Profile-name validation, web/headless bundle templates, the default base bundle, and idempotent initialization of three files.0404
PROJ-AUTHORITY-LAYERS
Projection baselines and non-authoritative checkpoint rows
packages/session/session-projection/src/index.ts:88-118ProjectionSnapshot defines one shared asOfSeq cut, while ProjectionCheckpointRow records version, watermark, and internal state and explicitly declares the row a fold shortcut rather than an authority.1212, 33
PROJ-CACHE-DETACH-WINDOW
The log-before-cache barrier for live checkpoints and its detach exception
packages/session/session-projection-cache/src/index.ts:132-230A normal write flushes a still-live Session after taking the registry cut and before putting the cache, while the disposed listener starts flushSoft asynchronously after the live-store check can fail and skip the explicit flush; the source notes residual overreach is left for cold-read detection.1212
PROJ-CACHE-INTEGRATION
Shipped list and detached-History projection paths
packages/host/apiproxy/src/api-proxy.ts:841-877Session list uses a registry snapshot for live rows and only cachedSnapshot for cold rows, while detached History restores the complete inspected event log from zero with an empty checkpoint.1212
PROJ-CACHE-LADDER
The projection cache cold tail-replay ladder
packages/session/session-projection-cache/src/index.ts:154-197coldSnapshot reads checkpoints, computes a restore floor, and tail-folds persistence.readFrom; identity or watermark overreach falls back to a full read, followed by a fail-soft refreshed write-back.1212, 33
PROJ-CACHE-SCHEMA
Versioned rows, log-lifecycle identity, and the cache domain
packages/session/session-projection-cache/src/spec.ts:16-69Each checkpoint row contains ver, seq, and a JSON value; a complete Session record binds rows to createdAt and cwd identity, and the version-3 session_projcache domain stores derived state that can be discarded.1212
PROJ-CLIENT-EQUAL-SEQ
Equal-seq rejection and truncation only beyond lastSeq
packages/client/runtime/src/client/sessions/projection-store.ts:128-177apply returns immediately when seq is lower than or equal to the resident row, seed reuses that rule, and generation truncation removes only rows whose seq is greater than lastSeq, so a new-generation value at the same watermark cannot replace the old one.1212
PROJ-CLIENT-MANAGER
Convergence through list baselines, pre-instantiation pushes, and subscribed repair
packages/client/runtime/src/client/sessions/manager.ts:438-735The manager replays mutations that arrived during a list pull, applies only carried keys from partial list projections, stores session/projection frames before Session instantiation, and uses subscribed to truncate phantom rows and reset generation state.1212
PROJ-CLIENT-STORE
Higher-seq-wins, full seeding, and generation truncation in the client projection store
packages/client/runtime/src/client/sessions/projection-store.ts:67-177The value store rejects lower or equal seq for both baselines and pushes; a full seed clears old keys omitted at the cut, while subscribed truncation removes only rows beyond the Host's durable lastSeq.1212
PROJ-COLD-RESUME
Setup, publication, and rollback for an exact prepared Session
packages/core/agent-loop/src/index.ts:624-710Agent resume requires persistence.prepare under fused cancellation, runs setup before publishing the exact preparation, disposes on failure, releases the reservation in finally, and contains no automatic fresh-create branch after resume failure.1212
PROJ-HISTORY-FAILURE
Ordinary History maps projection failures to an internal error
packages/host/apiproxy/src/api-proxy.ts:2242-2269History obtains its source, composition, projection cut, and page inside one try; every error except SessionNotFound becomes history unavailable/internal, with no branch that degrades by omitting the projection block as list and subagent History do.1212
PROJ-HOST-CARRIER
Projection change frames and Host-owned projection units
packages/host/apiproxy/src/api-proxy.ts:1273-1323The API Proxy broadcasts registry changes as session/projection frames and registers sessionListMetadata plus per-boot imageLimits; imageLimits always returns the same state from apply and therefore travels only through baselines.1212
PROJ-HOST-COLD-OPEN
Cold History uses inspection without acquiring Agent ownership
packages/host/apiproxy/src/api-proxy.ts:1525-1573History reads an attached Session when present and otherwise uses servable inspection; after all awaits it synchronously takes events and the projection cut without resuming or publishing an Agent.1212
PROJ-IMAGE-LIMITS
The per-boot, baseline-only imageLimits projection
packages/host/apiproxy/src/api-proxy.ts:1302-1323The imageLimits unit keeps null state, always returns the same reference from apply, and reads the current attachments-service configuration in view, so it emits no change frame within a boot and travels only through baselines.1212
PROJ-REGISTRY-DRIVE
Per-Session projection cells, synchronous snapshots, and eager drive
packages/session/session-projection/src/index.ts:130-425The registry holds state and observedSeq in WeakMap cells and drives every unit from one subscription; missing cells lazily fold the in-memory log, Object.is gates notifications, and observedSeq advances for every event.1212
PROJ-REGISTRY-REGISTRATION
Reference counting and version conflicts for registrations sharing one key
packages/session/session-projection/src/index.ts:137-220Registrants with the same key and stateVersion share the first unit and increment refs, while a different version is rejected; the final disposer removes the registration and all cells, and runtime cannot compare function semantics.1212
PROJ-REGISTRY-RESTORE
Anchored restore floors and safe tail folding
packages/session/session-projection/src/index.ts:284-385restoreFloor selects one event below the lowest usable watermark, while restore accepts only version-matching rows within the provable log endpoint and requires a reread from seq zero for an unsafe partial restore.1212
PROMPT-ASSEMBLY-PIPELINE
Exact evaluation and waterfall order of each assembly
packages/core/system-prompt/src/index.ts:467-541Assembly merges scope, variables, and named entries; snapshots and evaluates tool providers; orders and evaluates sections and contexts; canonicalizes tools; then runs the waterfall before reapplying complete and suppression constraints.0707, 33
PROMPT-CONTEXT-AGENT-INSTRUCTIONS
Workspace instructions enter through a pre-step message
packages/context/agent-instructions/src/index.ts:322-347Agent instructions compute after downstream decisions, reconcile pending projections, and insert a new message after the claimed batch and before driver runtime context.0707
PROMPT-CONTEXT-TIME
Per-step sourced message for time context
packages/context/time-context/src/index.ts:170-208Time context resolves timezone and refresh rules after the prepended listener's next returns, then appends a user message with a plugin snapshot source.0707
PROMPT-CONTEXT-TMUX
First-step and change gates for tmux context
packages/context/tmux-context/src/index.ts:208-246The tmux listener queries only on step one when shell exists, refresh is due, and state changed, then prepends a sourced snapshot to the decision messages.0707
PROMPT-DEEPSEEK-WIRE
Stable-prefix layout of the DeepSeek wire request
packages/llm/llm-deepseek/src/serialize.ts:143-186The adapter places system first, then serializes durable history, always streams, and requests usage; this path writes no explicit cache-control directive.0707
PROMPT-HEADER-CANONICAL
Request-header canonicalization, comparison, and folding
packages/core/session/src/request-header.ts:14-70Empty system and tool fields canonicalize to absence; equality covers config, adapter defaults, system, and ordered schemas; offline folding takes the latest full snapshot.0707
PROMPT-REGISTRY-CONTRACT
Five reversible prompt registrations and default sections
packages/core/system-prompt/src/index.ts:337-455SystemPrompt effect-registers scoped sections, contexts, runtime-context suppressors, tool providers, and variables; the default identity and persona are ordinary sections too.0707
PROMPT-RETRY-BOUNDARY
Provider retries do not reassemble the prompt within a step
packages/core/agent-loop/src/agent.ts:332-370The system prompt is rendered from the assembly outside the retry loop; provider retries rebuild the request and derive messages while reusing that step's assembly and tool schemas.0707, 08
PROMPT-STEP-BOUNDARY
Prompt assembly boundary for every proposed step
packages/core/agent-loop/src/agent.ts:225-243PreStep claims input, assembles the prompt, renders runtime context, proposes its message, and enters the pre-step waterfall; rejection or an empty initial step can still avoid opening a step after assembly.0707
PROMPT-STRICT-RENDER
Strict section and context interpolation
packages/core/system-prompt/src/index.ts:204-294Rendering drops empty entries and strictly validates variable names, ownership, and values; it blocks prototype lookup and recursive interpolation and fails on malformed references.0707
PROMPT-TOOL-ORDER
Deterministic tool-schema ordering rules
packages/core/system-prompt/src/index.ts:139-183The default is code-unit lexicographic order; explicit ordering requires one rest marker, rejects unknown names, and permits known tools hidden in a scope to be absent.0707
RALPH-CONTRACT
Ralph's minimal model schema and explicit-use policy
packages/workflow/tool-ralph/src/index.ts:404-435Ralph exposes only objective/maxRounds with a fixed tool name and output envelope; its system prompt requires an explicit human request for Ralph/fresh-agent iteration.2525
RALPH-DOUBLE-VALIDATION
Consumer-side revalidation of Ralph terminal results
packages/workflow/tool-ralph/src/index.ts:246-333TypeScript revalidates exact keys, status, round range, status-specific report invariants, and handoff size, rejecting malformed engine-boundary values.2525, 33
RALPH-EXECUTE
Ralph execution mapping onto a fixed Workflow
packages/workflow/tool-ralph/src/index.ts:437-474The tool trims the objective, resolves cap/provider, passes the fixed script/provider/maxTotalAgents to the engine, bridges cancellation, decodes the result, and disposes in finally.2525
RALPH-FRESH-PROVIDER
Ralph round cap and fresh-provider capability gate
packages/workflow/tool-ralph/src/index.ts:207-232The call round count must be a positive safe integer within the ceiling; the provider must be registered, support structured output, and not inherit parent context.2525
RALPH-OUTCOMES
Ralph terminal outcomes and round-failure semantics
packages/workflow/tool-ralph/src/index.ts:282-391The decoder distinguishes complete, blocked, budget-limited, and round-failed, bounds roundsStarted, and retains the previous continue report after an ordinary child failure.2525
RALPH-RENDER
Bounded, non-certifying Ralph result rendering
packages/workflow/tool-ralph/src/index.ts:351-391The renderer says the worker reported completion/blocker or reached its limit; maxResultChars includes envelope and truncation marker, and round failure retains the last handoff.2525
RALPH-ROUND-PROMPT
Ralph round prompt and workspace memory
packages/workflow/tool-ralph/src/index.ts:151-167Each round carries only the immutable objective, round index, workspace-as-truth instruction, and previous bounded report, explicitly without parent conversation or a previous child Session.2525
RALPH-SCRIPT
Build-time-fixed Ralph state machine and report rules
packages/workflow/tool-ralph/src/index.ts:80-177The fixed script defines report schema/status invariants, bounded handoff, one fresh agent per round, and complete/blocked/round-failed/budget-limited transitions.2525
REMOTE-AGENT-RESOLVE
Cold-resume policy for Remote session identities
packages/api/remotes/src/agent-lookup.ts:113-211Live Agents are reused and concurrent ordinary cold resumes are deduplicated by id; subagent ownership is fenced at entry, after durable inspection, and before resume, while a failed publication race rechecks the published identity and classifies agent-busy.2929
REMOTE-CLIENT-INVOKE
Remote client invocation and lifetime cancellation
packages/api/gateway/src/client/index.ts:327-415The client projects positional arguments into named wire args, fuses mount lifetime with caller cancellation, and revalidates the response; no active Connection throws before the try, while RPC rejection, abort, and malformed responses fold into RemoteResult only after a Connection exists.2929
REMOTE-CLIENT-MOUNT
Transactional mounting of generated Remote contributions
packages/api/gateway/src/client/index.ts:174-260The client mounts only strict descriptors, checks duplicates and namespace collisions before callability, rolls back partial installation in reverse, and aborts in-flight calls when a mount token is withdrawn.2929
REMOTE-EVENT-ALLOWLIST
Single allowlist for Remote events
packages/api/remotes/src/remote-events.ts:1-29One constant controls the 11 forwardable events; the wire uses each Host event's original name and argument list without projection, renaming, or redaction.2929
REMOTE-EVENT-FORWARD
Actual forwarding of allowlisted events
packages/host/apiproxy/src/api-proxy.ts:3617-3635The Host registers a listener for every allowlisted event, proves its arguments JSON-safe, and wraps it as host/remote-event on the host stream.2929
REMOTE-GATEWAY-TYPES
Carrier-independent Typert Remote contract
packages/api/gateway/src/types.ts:6-46An invocation consists of namespace, method, exact named args, and an optionally injected signal, with stable gateway failure categories.2929
REMOTE-HOST-DISPATCH
Strict descriptor dispatch on the Remote host
packages/api/gateway/src/index.ts:90-235The Gateway re-resolves the current descriptor on every call, validates exact arguments, resolves Context/lookups, binds the live Service, and validates results; a withdrawn strict definition that was previously seen cannot downgrade to SRC.2929
REMOTE-HOST-ERRORS
Remote cancellation and wire error folding
packages/api/gateway/src/index.ts:159-489Only methods declaring cancellation receive a signal; a business rejection observed after abort maps to cancelled, lookup-policy failures retain their RpcError, and other gateway or business exceptions collapse to internal on the wire.2929
SANDBOX-BASH-CONSUMER
Sandbox consumption path for one-shot Bash
packages/shell/bash-sandbox/src/index.ts:79-179The executor gives the provider exact ['bash','-c',command] and runs the returned argv directly; foreground and background paths retain mode, enforcement, denial, and runner-failure outcomes.2020
SANDBOX-CONTAINMENT
Separator-aware containment with filesystem-identity fallback
packages/fs/fs-sandbox/src/containment.ts:19-76Containment first performs separator-aware lexical comparison; when spellings differ it walks existing ancestors comparing device and inode, treats missing roots conservatively, and supports Windows case and alias semantics.2020
SANDBOX-E2B-FS
Remote identity, reads, and mutations in E2B filesystem
packages/e2b/fs-e2b/src/index.ts:170-454The E2B provider builds target identity from POSIX cwd and remote GNU realpath, supplies whole, streaming, and bounded-byte reads, and wraps guarded write and edit with a host-process lock keyed by canonical target.2020
SANDBOX-E2B-OWNER
E2B execution-world owner for one context
packages/e2b/e2b/src/index.ts:22-179E2BRuntime creates and shares one sandbox handle, validates API key, absolute Linux cwd, and timeout, prepares a 0700 runtime root, isolates the SDK login shell with randomized HOME, and kills on bootstrap failure or disposal.2020
SANDBOX-E2B-PGID
E2B process-group identity, TERM-to-KILL, and quiescence probing
packages/e2b/subprocess-e2b/src/process.ts:93-665The remote wrapper uses setsid and publishes the actual PGID; termination signals the negative PGID with TERM, escalates to KILL and SDK kill, then confirms group quiescence through ps while excluding zombie and dead entries.2020
SANDBOX-E2B-PUBLICATION
E2B atomic publication and cancellation commit point
packages/e2b/fs-e2b/src/index.ts:510-579Remote writes create a random 0700 sibling staging directory, upload a version-tagged file while preserving mode, commit with ln -T or rename without a signal, and clean up best effort afterward.2020
SANDBOX-E2B-SUBPROCESS
E2B remote executable, process, and terminal seam
packages/e2b/subprocess-e2b/src/index.ts:103-204The provider resolves absolute or bare executables inside the shared sandbox, spawns managed process handles, allocates process and terminal state under the owner's runtimeRoot, and fences terminal setup against cancellation and disposal.2020
SANDBOX-EDIT-TOOL
Edit-tool policy, guard, and observation flow
packages/fs/tool-fs/src/edit.ts:112-146Edit resolves policy and target before I/O, obtains its version intent inside the try and calls provider atomic edit; failures are mapped consistently and success refreshes the present observation.2020
SANDBOX-ESCALATION
Strictly monotonic pre-execution escalation approval
packages/sandbox/sandbox/src/escalation.ts:22-187The escalation table permits only strictly wider targets; arguments must be paired with a nonblank reason, approval carries cancellation before execution, and only allowed-once returns a wider mode for this call.2020
SANDBOX-FS-ATOMIC
Local atomic staging and publication
packages/fs/fs-local/src/fsio.ts:518-615Writes use a 0700 sibling staging directory, a 0600 exclusive file, and sync; cancellation is checked before commit, then publication uses hard-link no-replace, Windows ReplaceFile, or rename, with post-commit cleanup best effort.2020
SANDBOX-FS-ESCALATION
Conditional escalation interface for filesystem mutations
packages/fs/tool-fs/src/sandbox.ts:20-130The controller advertises escalation fields only when ctx.fs exposes sandboxMode and then requires shared policy; each mutation resolves standing or approved policy and maps FS_SANDBOX_DENIED to the shared marker and hint.2020
SANDBOX-FS-FENCE
In-process filesystem fence for mutations only
packages/fs/fs-sandbox/src/index.ts:1-149SandboxedFileSystem inherits reads unchanged and checks only write and edit against per-call policy; read-only denies, workspace-write fresh-resolves and checks writable roots, full passes through, and residual TOCTOU is explicitly accepted.2020
SANDBOX-FS-IDENTITY
Realpath identity for present and missing targets
packages/fs/fs-local/src/fsio.ts:105-194Present targets use their own realpath; missing targets walk to the nearest existing ancestor, canonicalize it, and append the missing suffix so symlink aliases preserve identity across creation.2020
SANDBOX-FS-LOCAL
Local filesystem cwd and canonical target
packages/fs/fs-local/src/index.ts:40-123LocalFileSystem states that cwd is only a relative-path default, not containment; it uses canonical targetKey for lock and I/O identity and platform path semantics for contains.2020
SANDBOX-FS-LOCAL-MUTATION
Local per-target mutation lock and guards
packages/fs/fs-local/src/index.ts:70-255One provider serializes mutations by targetKey with a FIFO lock; write and edit probe and validate create, replace, or version guards under that lock before atomic writing and returning a new version.2020
SANDBOX-FS-READ-IO
Local text, byte, and streaming read semantics
packages/fs/fs-local/src/fsio.ts:17-463Whole-text reads the complete file with UTF-8 and NUL checks; raw-byte reads enforce maxBytes; streaming decodes across chunks, samples only the first 8192 bytes for NUL, and propagates cancellation.2020
SANDBOX-FS-SEAM
Filesystem provider and event seam
packages/fs/fs/src/index.ts:44-249FileSystem declares path, read, list, and atomic-mutation APIs; fs write and edit intents are single-slot waterfalls, observed is synchronous emission, and sandboxMode optionally exposes mutation confinement.2020
SANDBOX-FS-TYPES
Filesystem identity, observation, guard, and error types
packages/fs/fs/src/types.ts:11-203The types make target and version opaque identities, distinguish present and absent observations, define guarded create and replace intents, and list structured FsErrorCode including FS_SANDBOX_DENIED.2020
SANDBOX-LOCAL-DIALECTS
Local platform runner chains and diagnostic dialects
packages/sandbox/sandbox-local/src/index.ts:150-240The source defines Linux bwrap-to-Landlock, macOS Seatbelt, and Windows ACL chains with their full or partial enforcement, denial signatures, and runner-failure rules.2020
SANDBOX-LOCAL-SELECT
Runner selection, caching, and fail-closed behavior
packages/sandbox/sandbox-local/src/index.ts:485-539The provider caches one chain verdict for its lifetime; a sole candidate is unprobed, multiple candidates are probed in order, and an empty or wholly unusable chain becomes structured unavailable rather than original argv.2020
SANDBOX-LOCAL-WRAP
Custom-runner validation and wrapping
packages/sandbox/sandbox-local/src/index.ts:276-333Construction requires runnerCommand and failure signatures together; a configured runner bypasses platform selection, wraps with a bwrap-shaped profile, and is treated as the operator's assertion of full enforcement.2020
SANDBOX-MODE-EVENT
Session sandbox-mode event and fold
packages/sandbox/sandbox-policy/src/session-mode.ts:24-71sandbox/mode is a log-only session event; effectiveSandboxMode scans backward for the latest value, and setSandboxMode only appends that event.2020
SANDBOX-OBSERVATION
Observation state machine isolated by session owner
packages/fs/fs-observation-policy/src/index.ts:17-130The plugin stores ephemeral state in WeakMap<owner, Map<target, observation>>; unseen, absent, and present determine create or version guards, disposal resets state, and three listeners occupy intent slots and synchronously record observations.2020
SANDBOX-PERMISSION-PRESETS
Permission-preset defaults and startup validation
packages/interaction/permission-presets/src/index.ts:139-225The service defaults to workspace-write plus ask and danger-full-access plus never, requires shell and approval, validates confinement only through ctx.shell.sandboxMode, and pins initial permission for new sessions.2020
SANDBOX-PERMISSION-WRITE
Three-event write path for permission presets
packages/interaction/permission-presets/src/index.ts:369-430A switch conditionally appends permission/preset, then updates sandbox/mode and approval/policy through canonical setters; new sessions also receive any missing durable facts.2020
SANDBOX-POLICY
Per-call resolution of shared sandbox policy
packages/sandbox/sandbox-policy/src/index.ts:60-150SandboxPolicyService itself defaults to read-only; each resolve selects explicit mode, then the session's last override, then deployment default, and prefers session cwd as the workspace root.2020
SANDBOX-PROFILES
Bwrap, Landlock, and Seatbelt profiles
packages/sandbox/sandbox-local/src/profiles.ts:11-58Bwrap read-only binds the root and gives workspace mode an isolated /tmp; Landlock grants host /tmp and workspace; Seatbelt allows by default, denies file writes, then permits the shared writable roots.2020
SANDBOX-READ-TARGET
Read-target resolution and absent observation
packages/fs/tool-fs/src/read-target.ts:12-34The shared helper resolves from session cwd and stats the target; confirmed absence emits an absent observation before FS_NOT_FOUND, and non-regular files are rejected.2020
SANDBOX-READ-TOOL
Bounded window and present observation in the read tool
packages/fs/tool-fs/src/read.ts:134-163Read performs one stat for type, size, and version, selects whole or streaming I/O by size, builds a bounded window, and emits a present observation only after success.2020
SANDBOX-RESULT-CLASSIFIER
Sandbox denial and runner-failure classifiers
packages/shell/bash-sandbox/src/helpers.ts:25-116Spawn attribution requires a usable workdir and exact runner path or syscall; settled runner failure uses exit gates, informational-line exclusions, and fatal stderr matches, while denial matches signatures only on nonzero exit.2020
SANDBOX-SEAM
Sandbox contract for process file-effect confinement
packages/sandbox/sandbox/src/index.ts:23-175The source defines the three modes as file-effect policy and requires the provider to accept a complete per-call policy, return exact wrapped argv plus enforcement and diagnostic rules, and fail closed when unavailable.2020
SANDBOX-SEARCH-WORLD
Subprocess execution-world assumption of glob and grep
packages/fs/tool-fs-search/src/index.ts:1-24Search tools run packaged ripgrep through ctx.subprocess and deliberately do not inject ctx.fs; returned paths are follow-up readable only when subprocess workdir and filesystem root are co-located, and that is not runtime validated.2020
SANDBOX-SESSION-CWD
Session-cwd resolution for filesystem tools
packages/fs/tool-fs/src/session-cwd.ts:16-46Tools take cwd from the calling agent's session header, recanonicalize when parent traversal is involved, and let the sandbox policy root take precedence for mutation resolution.2020
SANDBOX-TERMINAL-FENCE
Persistent-terminal mode fence and confined spawn
packages/terminal/terminal-bash/src/index.ts:27-145An owner-scoped listener rejects a different sandbox/mode while PTYs are open or being created; spawn resolves session policy, wraps argv, uses its root, and awaits close cleanup on initialization failure.2020
SANDBOX-WRITABLE-ROOTS
Canonicalization and derivation of writable roots
packages/sandbox/sandbox/src/roots.ts:20-55canonicalPath best-effort uses native realpath; writableRoots is empty for read-only and canonicalizes and deduplicates the workspace root, /tmp, and os.tmpdir() for workspace-write.2020
SANDBOX-WRITE-TOOL
Write-tool policy, intent, and observation flow
packages/fs/tool-fs/src/write.ts:102-128Write resolves policy and target before I/O, obtains the single-slot intent, invokes provider mutation, maps denials and errors, and records a present observation with the returned version after success.2020
SDK-DOC-STALE-ACCEPTED
Stale TypeScript SdkProtocolError comment
packages/sdk/client/src/client.ts:55-290The class comment still uses a prompt response lacking accepted:true as its example, while the implementation and current wire contract require messageId.2929
SDK-JSONL-TRANSPORT
SDK newline-delimited JSON transport
packages/sdk/protocol/src/transport.ts:1-268Outbound frames always write jsonrpc:2.0; inbound frames are classified only by id/method without validating that field or the full envelope. StringDecoder preserves split UTF-8; malformed lines and unknown response ids are ignored, while missing and failing handlers map to -32601/-32603.2929
SDK-PY-CLIENT
Python SDK synchronous client and bidirectional request surface
python/sdk/src/deepseek_harness/client.py:24-397The Python client sends the same requests and exposes future server-request APIs; its environment copies the parent then merges overrides. After the shutdown response, close terminates a still-live process; clearing _proc permits restart, but start does not clear the sentinels that close leaves in the global-notification and server-request queues.2929
SDK-PY-MODELS
Lenient Python initialize-response model
python/sdk/src/deepseek_harness/models.py:26-32Python permits ServerInfo.name/version and InitializeResponse.serverInfo all to be absent.2929
SDK-PY-READER
Python SDK waiting, parsing, and subscriptions
python/sdk/src/deepseek_harness/client.py:228-396Each request is correlated by UUID and a queue; timeout removes its waiter and attaches process diagnostics, the reader ignores malformed JSON and separates server requests, responses, and notifications, and a throwing filter terminates only its own subscription.2929
SDK-PY-RESULT
Python SDK configuration and RunResult contract
python/sdk/src/deepseek_harness/api.py:13-84The Python high-level configuration offers session_root, base_url, and api_key conveniences merged into the environment; its RunResult additionally contains finish_reason and session_root.2929
SDK-PY-RUN
Python high-level receipt-to-idle run semantics
python/sdk/src/deepseek_harness/api.py:97-242Python likewise subscribes to the session tree before using the messageId receipt as the start and collecting through idle; it additionally derives finish_reason from the last turn/end and raises SdkProtocolError when reason.kind is not a string.2929
SDK-SERVER-EVENTS
Global notification subscriptions in the SDK server
packages/sdk/server/src/server.ts:48-103Construction subscribes to every session/event, agent/status, and child lifecycle in the context; local subagent completion is reported only from the snapshotted local flag, never inferred from ids or lineage.2929
SDK-SERVER-INIT
SDK server initialization and dispatch state
packages/sdk/server/src/server.ts:48-201The class comment says reinitialization is unsupported, yet the class has no initialized state; initialize rewrites cwd/provider/model/maxTokens on every call, and handleRequest does not gate session/prompt on the handshake.2929
SDK-SERVER-SESSIONS
SDK session creation and teardown
packages/sdk/server/src/server.ts:127-239A sessionId is created lazily on first prompt, concurrent creation of the same id is coalesced, prompt verifies the exact Agent is still live, and shutdown rejects new creation, settles in-flight creation, and allSettles every handle plus the fallback adapter.2929
SDK-SERVER-SHUTDOWN
SDK runtime shutdown and exit order
packages/sdk/server/src/index.ts:40-91After the shutdown result is written, the next event-loop turn flushes the transport, disposes the root fiber, and exits 0; successful plugin-only unmount shuts down the server then closes transport, but a shutdown rejection skips close because there is no finally.2929
SDK-TS-CLIENT
TypeScript SDK errors, timeouts, and close
packages/sdk/client/src/client.ts:175-401The client lazily starts a subprocess and initialize only checks that identity fields are strings; timeout removes only the local pending entry while server work continues; wire errors retain code/data, transport errors add exit code plus a 400-line stderr tail, and close performs best-effort shutdown before authoritative process reaping.2929
SDK-TS-DISPOSE
TypeScript SDK process-reaping ladder
packages/sdk/client/src/dispose.ts:13-99Reaping proceeds through stdin EOF, POSIX SIGTERM, and SIGKILL while cleaning timers and listeners at each tier; it resolves only after observing exit, and Windows skips directly to forced termination.2929
SDK-TS-RESULT
TypeScript SDK launch and RunResult contract
packages/sdk/client/src/types.ts:22-70An explicit env replaces the complete child environment; RunResult contains only sessionId, finalResponse, events, and notifications, with no finish reason.2929
SDK-TS-RUN
The TypeScript high-level run activity interval
packages/sdk/client/src/api.ts:139-245Subscription precedes prompt, notifications before the matching durable inbox receipt are ignored, collection runs through the next whole-agent idle, and finalResponse is the interval's last committed assistant text rather than a prompt-causal result.2929
SDK-WIRE-METHODS
The SDK wire's three requests and four notifications
packages/sdk/protocol/src/types.ts:15-105Clients have only initialize, session/prompt, and shutdown; the server notifies session.event, session.status, subagent.started, and subagent.finished; prompt returns only messageId, and full SessionEvent envelopes enter the wire vocabulary.2929
SEC-ACP-BRIDGE
ACP session and approval bridge semantics
packages/acp/acp/src/index.ts:212-274ACP creates a one-shot owned approval answerer per session; authenticate is a no-op, and the method surface puts the client cwd into new-Agent metadata without adding user authentication.3131
SEC-ACP-CWD
ACP absolute-cwd validation
packages/acp/acp/src/index.ts:430-433A new-Session request with a non-absolute cwd is rejected before Agent creation.3131
SEC-ACP-TRUST
ACP trusted programmatic stdio boundary
packages/acp/acp/src/index.ts:1-45The ACP adapter describes itself as a trusted programmatic stdio boundary and allows its controller to create Agents.3131
SEC-APPROVAL-CLOSED
Approval audit and fail-closed settlement
packages/interaction/user-approval/src/index.ts:239-343Approval requires an open turn and records asked/decided events; never, absent or failing answerers, invalid answers, and cancellation do not execute, and only allowed-once is a grant.3131
SEC-BOOT-TRANSACTION
Transactional boot and failure cleanup
packages/boot/app-boot/src/index.ts:757-801Prepare, mount, settle, and activation audit run in order; any failure disposes the partial root while preserving the deeper error stack.3131
SEC-BROWSER-FENCE
Browser API Host/Origin request fence
packages/client/connection/src/api-request-trust.ts:1-122Requests are checked through Host, Fetch Metadata, and Origin signals; the source explicitly describes the mechanism as a request fence rather than authentication.3131
SEC-BROWSER-PRIVILEGED
Browser API privileged configuration plane
packages/client/connection/src/index.ts:69-159Configuration-mutating methods are loopback-only, while ordinary Agent/Session methods remain a high-authority control plane for any reachable client that passes the request fence.3131
SEC-CHILD-ENV
Heuristic child-environment scrubbing
packages/subprocess/subprocess/src/index.ts:37-66Child processes remove ambient names matching KEY/PASSWORD/SECRET/TOKEN or DSH_*; an explicit env layer may then restore any entry, making this a naming heuristic rather than secret-taint tracking.3131
SEC-CREDENTIAL-FILE
Managed credential file protection and parsing
packages/credentials/credentials-local/src/index.ts:87-185On POSIX, an existing file with group/other permission bits is rejected before reading; Windows skips the mode assertion, and parsing/error paths avoid emitting secret values.3131
SEC-CREDENTIAL-LAYERS
Local credential-layer precedence
packages/credentials/credentials-local/src/index.ts:1-34The provider resolves inherited environment, managed store, then fallback environment in order, and does not copy the managed file into process.env.3131
SEC-CREDENTIAL-RESOLVE
Credential resolution, value-free description, and shadow guard
packages/credentials/credentials-local/src/index.ts:249-380Inherited references are dominant and read-only, managed/fallback references resolve through explicit layers, describe omits values, and set/unset reject writes shadowed by inherited environment both before queuing and at execution.3131
SEC-CREDENTIAL-SEAM
Credential reference/value separation seam
packages/credentials/credentials/src/index.ts:1-99Configuration and UI carry CredentialRef values and value-free descriptions, while a provider resolves the secret at the concrete operation boundary.3131
SEC-CUSTOM-RUNNER
Custom-runner trust contract
packages/sandbox/sandbox-local/src/index.ts:276-333A configured custom runner bypasses platform selection; implementation validates only command and failure-signature shape, then treats the operator-provided runner as full enforcement.3131
SEC-DYNAMIC-CLIENT
Dynamic Client-code evaluator capability surface
packages/extensions/cordis-client-runner/src/client/evaluator.ts:1-222The Client evaluator runs code with new Function in the page realm, shadows selected bare globals, and sets process and Buffer to undefined, while ambient page globals remain reachable.3131
SEC-DYNAMIC-GUARD
Dynamic-plugin Context facade and tool-bypass guard
packages/extensions/cordis-host-runner/src/guard.ts:620-819Property-style Service access requires a declared injection, but optional ctx.get is not declaration-gated; wrappers reject only direct Context returns, while the tools facade prevents access to a live execute function that could bypass ToolRuntime.3131
SEC-DYNAMIC-RUN
Dynamic Host and Client package activation branches
packages/extensions/cordis-host-runner/src/index.ts:238-312A Host-only package can activate immediately; a package containing Client code requires approval or an existing grant, and a package-wide grant can cover later versions.3131
SEC-DYNAMIC-VM
node:vm is not a malicious-code boundary
packages/extensions/cordis-host-runner/src/sandbox.ts:1-11The Host runner explicitly states that node:vm is convenience isolation, not a security boundary against malicious code.3131
SEC-E2B-OWNER
Single owner for the E2B remote context
packages/e2b/e2b/src/index.ts:1-179Configuration resolves the API key and cwd, each Context owns one shared sandbox handle, randomizes HOME for internal login shells, creates an owner-only runtime directory, attempts rollback kill after setup failure, requests kill on timeout or disposal, and avoids forwarding the API key into the remote environment.3131
SEC-ENV-LAYERS
Launch environment layering and bootstrap denylist
packages/boot/app-boot/src/index.ts:92-198Launch layers inherited, invoking-directory .env, and Harness-home .env; both files are parsed before bootstrap-sensitive variables and prefixes are rejected, then accepted values are materialized with inherited values winning.3131
SEC-ESCALATION
One-shot sandbox escalation control flow
packages/sandbox/sandbox/src/escalation.ts:143-188The escalated mode must be wider and an Agent plus approval service must exist; reason and call identity are audited, and only allowed-once stamps the wider mode onto that call.3131
SEC-FS-FENCE
Filesystem mutation containment
packages/fs/fs-sandbox/src/index.ts:1-149The wrapper leaves reads unchanged and fences only writeText/editText; workspace-write recanonicalizes immediately before the syscall and checks workspace/temp containment, while accepting a residual ancestor-symlink race after the final check.3131
SEC-LANDLOCK-PROBE
Enforcement result of the Landlock probe
packages/sandbox/sandbox-local/src/index.ts:500-527The runner chain uses functional probes to select a usable rung; the Landlock probe returns full, partial, or unusable according to launcher and ABI support.3131
SEC-LOADER-IMPORT
Root Include module resolution and creation
packages/boot/app-boot/src/index.ts:475-528Relative plugins resolve beside the configuration, bare plugins resolve through the module base, and Loader then creates the composed tree.3131
SEC-LOCAL-RUNNERS
Local sandbox runner selection and static guarantees
packages/sandbox/sandbox-local/src/index.ts:150-240Linux selects bubblewrap then Landlock, macOS uses Seatbelt, and Windows uses the ACL runner; bubblewrap and Seatbelt advertise full, Windows advertises partial due to ACL and hard-link semantics, and Landlock is probe-determined.3131
SEC-MCP-EXEC
MCP invocation and result boundary
packages/mcp/mcp-client/src/tools.ts:218-277The bridge does not locally validate arguments against the advertised input schema; it normalizes the top-level result while separating Native text projection from canonical JSON content retained for Code Mode, and the remote server remains the execution authority.3131
SEC-MCP-SYNC
MCP tool discovery and generation swap
packages/mcp/mcp-client/src/tools.ts:128-173Discovery first builds the complete candidate map; swap disposes the old set before registering the new set sequentially, and a registry conflict clears the partial new set to an empty generation rather than restoring the old one.3131
SEC-MCP-TRANSPORT
MCP stdio and HTTP transport boundary
packages/mcp/mcp-client/src/transport.ts:1-49A stdio server is spawned directly by the MCP SDK with a scrubbed environment, while an HTTP server receives the configured URL and headers.3131
SEC-MODEL-PARSE
Model tool-argument parsing boundary
packages/core/agent-loop/src/tool-calls.ts:59-110Tool blocks become execution requests; valid JSON is parsed, empty arguments become an object, and invalid JSON remains a raw string for downstream validation.3131
SEC-PATCH-LAYERS
User-patch parsing and fail-loud behavior
packages/boot/app-boot/src/index.ts:267-337Optional and required patch layers may replace configuration, insert Loader rows, and use !!js; a present layer that is unreadable, unparsable, or has the wrong top-level shape fails launch.3131
SEC-PLUGIN-PNPM
Plugin installation and automatic bundle activation
apps/cli/src/plugin.ts:55-157Plugin commands forward to pnpm; after success, installed dependencies declaring bundle patches are reconciled into the profile, relative specs anchor to the invocation directory, and git build policy is delegated to pnpm.3131
SEC-PRESETS-PIN
Application and pinning of per-session permission facts
packages/interaction/permission-presets/src/index.ts:379-430New sessions receive durable preset, sandbox-mode, and approval-policy facts; existing or partially initialized sessions gain only missing facts without rewriting prior choices.3131
SEC-PRESETS-VALIDATE
Permission-preset dependencies and default-table validation
packages/interaction/permission-presets/src/index.ts:155-225The service requires a shell advertising the sandboxMode policy capability and an approval service; its table maps workspace-write to ask and danger-full-access to never, validating the default before publishing settings.3131
SEC-PROFILE-ORDER
Effective profile layering order
apps/cli/src/profile-boot.ts:121-170Effective configuration composes bundle, profile, home, CLI, and launcher-owned overlays in order, allowing later administrative layers to alter or insert runtime rows.3131
SEC-PROVIDER-CONFIG
Provider endpoint and credential configuration
packages/llm/llm-deepseek/src/index.ts:149-246The DeepSeek adapter validates bounded request and model settings, snapshots the configured endpoint, credential reference, and request settings, and resolves the actual key when performing the operation; the endpoint itself is only a string.3131
SEC-PROVIDER-TRANSPORT
Provider HTTP transport data boundary
packages/llm/llm-deepseek/src/adapter.ts:214-345The adapter sends messages, tool schemas, request parameters, API key, and request identifiers to the configured endpoint and consumes its streamed response.3131
SEC-RAW-TOOL-REGISTER
Low-level tool registration contract
packages/core/tools/src/index.ts:1031-1061register validates the output contract, timeout, and reserved names, but does not inject generic input validation around an arbitrary ToolDefinition.execute.3131
SEC-REMOTE-CARRIER
Remote calls reuse the active Connection
packages/api/gateway/src/client/index.ts:399-409A generated Remote call requires the active Connection, sends endpoint and arguments through its /api RPC, and parses the result with the descriptor codec.3131
SEC-REMOTE-CODECS
Strict-codec gate for generated Remote
packages/api/gateway/src/client/index.ts:549-575The Client gateway requires strict codecs for results, parameters, and contextual invocation and parses wire values through their schemas; absence or parse failure fails loudly.3131
SEC-REMOTE-EVENTS
Remote-event allowlist and verbatim data
packages/api/remotes/src/remote-events.ts:1-29Forwarded events use an explicit allowlist, but allowed payloads are sent verbatim without a generic redaction layer.3131
SEC-REMOTE-MOUNT
Fixed mounting surface for Remote contributions
packages/api/remotes/src/client/index.ts:97-121The Client assembly mounts only predefined contribution categories and cleans up mounted entries in reverse order on failure and disposal.3131
SEC-SANDBOX-SEAM
Sandbox file-effect contract
packages/sandbox/sandbox/src/index.ts:23-175The sandbox defines only three file-effect modes; a provider must return wrapped argv, enforcement level, and diagnostic dialect or fail closed, while network and process visibility are outside the contract.3131, 33
SEC-SDK-CLIENT
TypeScript SDK as a trusted stdio controller
packages/sdk/client/src/client.ts:175-260The SDK client may own the server subprocess, inherit or override its environment, and control it over stdio RPC; timeout abandons the client pending entry rather than cancelling server work.3131
SEC-SDK-FILTER
Client-side Session-tree filtering
packages/sdk/client/src/client.ts:354-370The SDK client filters global notifications locally by root Session tree; this helper is not server-side authorization.3131
SEC-SDK-PYTHON
Python SDK environment inheritance
python/sdk/src/deepseek_harness/client.py:63-83The Python client copies the complete parent environment, merges caller overrides, and then starts the stdio server.3131
SEC-SDK-SERVER
SDK server initialization and global event surface
packages/sdk/server/src/server.ts:48-124The stdio server accepts initialize parameters selecting cwd, provider, and model and projects global events to the controller; the private pipe relies on process ownership rather than protocol authentication.3131
SEC-SKILL-INVOCATION-GATES
Model and user skill-invocation gates
packages/skill/tool-skill/src/index.ts:127-227The model tool checks model-invocable on both the summary and loaded definition, explicit user invocation injects only user-invocable skills, and the model catalog retains only model-invocable entries.3131
SEC-SKILL-TRUST
Skill wrapper and verbatim instruction trust
packages/skill/skill/src/index.ts:157-183The skill wrapper escapes the name attribute, but embeds the body verbatim as trusted local content, making skill provenance part of the instruction supply chain.3131
SEC-TOOL-ARG-SNAPSHOT
Argument snapshot and freeze before policy
packages/core/tools/src/index.ts:1364-1450Execution arguments are lossless-JSON snapshotted and deeply frozen before policy; values that cannot be safely read or serialized produce an error result.3131
SEC-TOOL-DEFINE
defineTool input and output validation
packages/core/tools/src/schema.ts:538-617defineTool compiles parameter and output schemas, validates arguments before user code, and softly validates replay arguments that may originate from an older schema.3131
SEC-TOOL-GATE
Tool pre-execute, approval, and guard order
packages/core/tools/src/index.ts:1453-1506pre-execute begins at default allow, only ask invokes approval, an allowed result still passes monotonic guards, and denial or cancellation settles before body dispatch.3131
SEC-WORKER-TRUST
Worker thread non-security-boundary declaration
packages/code-runtime/code-runtime-worker-thread/src/index.ts:1-6The source states that worker containment is not an adversarial security boundary and model-written worker code should be treated as bash-equivalent authority.3131
SESSION-APPEND-COMMIT
Synchronous commit point of Session.append
packages/core/session/src/index.ts:550-654Append snapshots JSON and surface metadata, freezes the candidate, validates the surface, and resolves precommit dispatch; log.push is the commit point, after which observer failures are contained and reentrant append is rejected.0909, 33
SESSION-CORE-EVENTS
Core SessionEvent vocabulary
packages/core/session/src/types.ts:230-332Core declares Turn and Step boundaries, user messages, raw assistant chunks, assembled assistants, tool calls and results, todos, request header and context, and end-seed events with their payload semantics.0909
SESSION-DERIVED-CACHE
Incremental derived-message cache
packages/core/session/src/index.ts:700-747Without replacement only new surface nodes are projected; a generation change rebuilds fully; every call returns a fresh array while sharing frozen messages from events.0909, 14
SESSION-EVENT-ENVELOPE
SessionEvent envelope, surface markers, and ignorable flag
packages/core/session/src/types.ts:335-435Events are a type-discriminated union with seq, time, and data; only three message event types may carry surfaceOp and sourceEventSeqs, and an unknown event is skippable only with ignorable=true.0909
SESSION-FORMAT-HEADER
Session format version and durable header
packages/core/session/src/types.ts:33-99The format version is fixed at zero with no compatibility promise; the header stores identity, creation time, cwd, fork parent and seed length, subagent origin and depth, and agent preset.0909, 12
SESSION-INVARIANT-COMMIT
Invariant precommit staging and postcommit advancement
packages/core/session/src/invariant.ts:189-250The companion builds traces from existing logs, validates and stages a pure transition during internal dispatch, and advances only after matching session/event publication, so a veto cannot pollute state.0909
SESSION-LOSSLESS-JSON
Single-pass lossless-JSON snapshot
packages/core/session/src/json.ts:69-178An iterative traversal reads, validates, and copies a plain JSON graph once, rejecting sparse, cyclic, and exotic objects, negative zero, non-finite numbers, and non-string own keys.0909
SESSION-RELATIONAL-INVARIANT
Optional Turn, Step, and tool relational invariant
packages/core/session/src/invariant.ts:54-165The companion checks sequence order, Turn and Step numbering and closure, execution-event enclosure, and same-Step call/result pairing, leaving merge-extensible event relations to their owner.0909
SESSION-SEED-ACCEPTANCE
Per-event seed acceptance and end-seed boundary
packages/core/session/src/index.ts:499-547Seed events are snapshotted or adopted, checked for envelope, header, and contiguous sequence, and accepted through the same surface transition; construction records firstLiveSeq and appends end-seed when absent.0909
SESSION-SURFACE-PROJECTION
The sole event-to-model-visible-message projection
packages/core/session/src/surface.ts:70-142Only user messages, non-empty assistant messages, and tool results project, reusing frozen messages directly; boundaries, chunks, and log-only events never enter model history.0909, 10, 14
SESSION-SURFACE-PROVENANCE
Surface eligibility and source-provenance validation
packages/core/session/src/surface.ts:184-243The three eligible event types require surfaceOp while all others forbid surface metadata; source sequences must be unique and earlier, and replacements must cite every shadowed node.0909
SESSION-SURFACE-REPLACE
Atomic fold of positional surface replacement
packages/core/session/src/surface.ts:245-379Replace locates start and end in the current node list, then one splice installs the new node and increments generation; a tool result may rewrite only the content of one current result.0909
SESSION-UNKNOWN-EVENT-GATE
Recovery refusal for unknown required events
packages/session/session-persistence/src/coordinator.ts:1046-1065After normalization, persistence load checks every event against the known catalog and fails the entire session closed when an unknown event is not marked ignorable.0909
SHELL-BACKGROUND-OUTCOME
Background Shell outcome mapping
packages/shell/tool-bash/src/background.ts:9-27Signal-killed processes map to killed; every other exit, including nonzero, maps to completed with an exit-code detail; a TODO records that an unconfined spawn failure can still alias a kill.2121
SHELL-BASH-CWD
Bash canonical policy-root workdir resolution
packages/shell/tool-bash/src/index.ts:138-156Bash prefers the sandbox-policy workspace root, otherwise canonicalizes the Session cwd, and resolves a relative workdir against that identity.2121
SHELL-BASH-TOOL
Bash foreground/background ownership handoff
packages/shell/tool-bash/src/index.ts:330-389The tool first resolves approval, directory, and managed env; background atomically preflights and spawns through jobs.start after a signal check, while foreground passes the tool signal to the executor.2121
SHELL-E2B-SEAM
Remote E2B subprocess and Terminal provider
packages/e2b/subprocess-e2b/src/index.ts:51-205E2B implements SubprocessRuntime with remote executable lookup, ordinary process handles, Terminal allocation, publication fences, and disposal cleanup, without requiring consumer-specific tools.2121
SHELL-ENV-LIST-GAP
Managed-environment list built-in omission
packages/shell/shell-env/src/index.ts:175-192A source TODO states that list() enumerates contributor declarations but omits registry-owned built-ins, so diagnostics/UI cannot treat it as an exhaustive environment catalog.2121
SHELL-ENV-SCRUB
Shared ambient environment scrub
packages/subprocess/subprocess/src/index.ts:37-66The child baseline removes credential-shaped names and every DSH_* variable; a later explicit provider overlay can restore deliberately forwarded values.2121
SHELL-EXECUTOR-CONTRACT
One-shot Shell executor result contract
packages/shell/shell/src/index.ts:46-100run rejects only for infrastructure failure; nonzero, timeout, and abort are result facts; start has no timeout, output is incrementally consumed, and substrate composition teardown reaps background processes.2121
SHELL-JOB-NOTICES
Job completion delivery and wake budget
packages/jobs/tool-jobs/src/index.ts:205-300Unreported completion chooses inject or followup from owner busy/idle state; the default consecutive wake cap is three, and only a claimed user source resets the exact-Agent budget.2121
SHELL-JOB-TOOLS
Job output, list, and cancellation tools
packages/jobs/tool-jobs/src/index.ts:302-401The three tools provide optionally bounded waits, consuming output, visible listing, and cancellation requests; wait timeout leaves the Job alive and the kill snapshot does not consume output.2121
SHELL-JOBS-CLEANUP
Exact-owner Job teardown and cancellation failure boundary
packages/jobs/jobs-local/src/index.ts:442-528Owner/service disposal requests cancellation and awaits every Job; a throwing cancel force-fails and reports possible orphaning, while a cancel that returns without settling may block teardown.2121
SHELL-JOBS-SETTLEMENT
Scoped Job access and first-wins settlement
packages/jobs/jobs-local/src/index.ts:307-440Owner access and listener/observer routing are isolated by Session and scope; settlement is first-wins and commits the record, releases waiters, updates observers, then invokes completion listeners.2121
SHELL-JOBS-START
Local Job preflight, allocation, and registration
packages/jobs/jobs-local/src/index.ts:86-190Before producer run, the Job Registry validates a scoped controller, fields, exact live owner, and per-owner active cap; only then does it run the producer, mint kind-N, and register the record.2121
SHELL-MANAGED-ENV
Per-execution managed DSH environment registry
packages/shell/shell-env/src/index.ts:81-216The registry validates contributor and key ownership, collects built-ins plus current contributions per call, sorts and freezes them, and exposes an optional JSONL location through the persistence seam.2121
SHELL-OUTPUT-SPILL
Bounded tail collector and trustworthy spill protocol
packages/subprocess/subprocess-local/src/spawn.ts:84-247The local collector retains an exact byte tail, uses a private directory and exclusive mode-0600 spill, deletes it beyond the completeness cap, exposes lossy offset reads, and suppresses paths after seal failure.2121
SHELL-PERSISTENT-BASH
Persistent Bash marker protocol and per-owner serialization
packages/shell/tool-bash-persistent/src/index.ts:62-398The wrapper uses random markers, scrollback, and a per-owner promise queue to delimit commands; timeout, abort, send failure, or shell exit resets the PTY, while nonzero exit is a marker result.2121
SHELL-PROCESS-TREE
Local process-tree signalling and quiescence
packages/subprocess/subprocess-local/src/spawn.ts:253-543POSIX uses a detached process group for TERM-to-KILL and continues probing group liveness; Windows requests tree termination through taskkill /T /F, while waitForExit uses direct-child exit as its observable proxy.2121
SHELL-PTY-CLEANUP
Identity-fenced PTY signalling and cleanup
packages/subprocess/subprocess-local/src/terminal.ts:93-248The PTY rejects direct SIGKILL to the top-level shell, tracks descendants by PID plus start identity, and verifies quiescence through descendants-shell-descendants TERM/KILL cleanup, failing if survivors remain.2121
SHELL-PTY-READINESS
PTY readiness inference, interrupt, and close quiescence
packages/terminal/terminal-bash/src/session.ts:225-564Readiness combines session exit, a controlled prompt plus foreground group, exact stdin wait, and silence inference; cancellation sends real SIGINT and close awaits termination plus completion.2121
SHELL-PWSH-CWD-GAP
PowerShell raw Session-cwd resolution
packages/shell/tool-pwsh/src/index.ts:147-158PowerShell defaults directly to session.header.cwd and resolves relative workdir against it, without Bash's policy-root preference and canonicalPath step.2121
SHELL-PWSH-INJECT
Current PowerShell inject declaration
packages/shell/tool-pwsh/src/index.ts:42-50Current production source declares tools/shell/systemPrompt/shellEnv, directly demonstrating drift in the README list.2121
SHELL-SPAWN-CONTRACT
Explicit subprocess spawn, output, and handle contract
packages/subprocess/subprocess/src/types.ts:55-193The spawn spec explicitly carries argv, cwd, stdio, grace, signal, and env; done rejects only on spawn failure, collected output uses independent byte offsets, and terminate/wait are tree-scoped.2121
SHELL-SUBPROCESS-SEAM
Subprocess execution-world and lifecycle seam
packages/subprocess/subprocess/src/index.ts:37-139Defines the shared environment scrub and the contracts for executables, ordinary processes, PTYs, tree-scoped termination, output reads, and service disposal.2121
SHELL-TERMINAL-SERVICE
Exact-Agent PTY publication, ownership, and close
packages/terminal/terminal/src/index.ts:104-405The Terminal service reserves name/spawn, rechecks the exact live owner before publication, allows one active send per session, fences every operation by owner, and deletes only after quiescent, retryable close.2121
SHELL-TERMINAL-TOOLS
Six owner-scoped Terminal tools and background send
packages/terminal/tool-terminal/src/index.ts:157-399Defines open, send, read, signal, close, and list; every call requires an Agent, and background send hands an exclusive operation, cancellation, and bounded output to a pty-send Job.2121
TINV-BUILT-COMPANIONS
Built companion verification
scripts/verify-built-package-invariants.mjs:31-82Stages manifest-declared lib files, imports companions through package exports with plain Node, and checks the Loader-consumable namespace shape.3232
TINV-CI-CONSUMERS
Actual gate closure of the consumer job
scripts/run-gates.ts:374-419The consumer graph assembles build, publint, built companions, snapshots, browser snapshots, documentation typecheck, Node-next types, and built-bin smoke with explicit dependencies.3232
TINV-COMPANION-GATE
Source companion gate
scripts/package-invariants.ts:11-286Scans package topology and checks companion exports, dependencies, AST shape, owner names, reporter use, and explicit no-runtime-rule explanations.3232
TINV-CONFIG-CATALOG
Configuration-catalog generation contract
scripts/gen-config-catalog.ts:1-7Declares that the catalog comes from entries, config types, JSDoc, and static schemas, with schema paths required to exist on declared types.3232
TINV-CONFIG-CATALOG-CHECK
Configuration-catalog path and freshness checks
scripts/gen-config-catalog.ts:719-875Folds composed schemas, checks config types path by path, renders deterministically, and byte-checks the committed catalog under --check.3232
TINV-CONFIG-CLOSURE
Cordis configuration closure
scripts/verify-cordis-config.ts:72-364Scans Loader YAML, recursively traverses entries, inserts, and include patches, and validates example, app, and bundle dependencies, source-plane mappings, and string-selected backend closure.3232
TINV-CONFIG-METADATA
Dynamic configuration metadata validation
scripts/verify-cordis-config.ts:1-471Rejects !!js in metadata fields that Loader does not interpolate and parse-checks the allowed entry-level disabled expression without executing it.3232
TINV-CORDIS-CATALOG
Cordis API projection and freshness
scripts/gen-cordis-catalog.ts:701-918Generates runtime APIs and bilingual documentation regions from discovered services and events, enforces partition closure, and checks every committed output.3232
TINV-DOC-SYNC
Documentation-sync aggregate gate
scripts/run-gates.ts:571-615Combines source projections, catalogs, examples, types, and generated-document checks into doc-sync leaf gates.3232
TINV-LOOP-REQUEST
Agent-loop request invariant
packages/core/agent-loop/src/invariant.ts:18-55Compares the outgoing frozen request, messages, and headers against expected input derived from the Session durable log.3232
TINV-REGISTRY
Runtime invariant registry
packages/runtime-diagnostics/invariants/src/index.ts:49-197Implements pre-filter name reservation, per-installer child fibers, package-attributed failures, atomic rollback, and ordered disposal.3232
TINV-REPLAY-DERIVE
Deriving replay scripts from durable logs
packages/test-support/llm-replay/src/index.ts:1-263Splits calls at terminal chunks, reconstructs marked local compaction calls, and requires explicit overrides for throw or hang behavior.3232
TINV-RUNTIME-CLOSURE
Runtime dependency closure
scripts/verify-runtime-closure.ts:24-73Traverses reachable workspace dependencies and optional dependencies from deployment-manifest roots, rejecting required workspace peers that the root manifest does not explicitly supply.3232
TINV-SESSION-COMMIT
Session post-commit guard
packages/core/session/src/invariant.ts:189-242Seeds the validation baseline from existing durable events and applies the staged transition only after session/event publishes successfully.3232
TINV-SESSION-RULES
Session precommit rules
packages/core/session/src/invariant.ts:22-165Requires precommit purity, legal stages for core execution events, and the prior-call relationship for append-mode tool results with the TOOL_NOT_STARTED exception.3232
TINV-SNAPSHOT-GATE
Snapshot gate assembly
scripts/run-gates.ts:497-527Defines a snapshot gate that depends on build by default and pins DSH_EXAMPLE_MODE=lib; example and package snapshots use built artifacts while script snapshots use real source entries.3232
TINV-SNAPSHOT-SCENARIO-MODE
Mode-aware concurrency for ACP scenarios
packages/test-support/acp-snapshot/src/suite.ts:1080-1098The ACP snapshot suite uses describe.concurrent only in replay mode; record and refresh use serial describe.3232
TINV-TEST-HOST
Exhaustive invariant test host
scripts/test-invariants.ts:67-272Selects the owner companion from the test path; the dedicated topology path selects every companion, and a readiness barrier makes the target wait for companion activation.3232
TINV-TYPE-EQUIV
Documentation type-equivalence check
scripts/verify-type-equiv.ts:199-300Scans all documentation blocks, partitions paired-language copies as derivatives, and requires primary blocks to correspond one-to-one with the manifest and match source structure and JSDoc.3232
TINV-WINE-RUNNER
Substantive checks in the Wine Windows runner
scripts/wine-windows-gates.sh:31-282The runner verifies the Windows Node archive checksum and win32 x64 identity, then runs Host and Client build plus VitePress production-site build as its two surfaces.3232, 34
TOOL-CANCELLATION
Caller and wrapper signal fusion and the two cancellation outcomes
packages/core/tools/src/index.ts:1880-1944A dispatch-scoped relay watches caller and wrapper signals and cleans up at settlement; cancellation maps to ABORTED or ABORTED_BEFORE_DISPATCH according to whether the body started and preserves existing additional contexts.1616
TOOL-CANONICAL-OUTPUT
Canonical-value validation, pure projections, and final materialization
packages/core/tools/src/index.ts:1783-1862The registry snapshots and validates body or policy values, runs render and metadata projections, marks canonical results with the execution token, renormalizes unmarked wrapper successes, and freezes a durable projection that omits the value.1616
TOOL-CODE-RUNTIME-WINDOW
The unbound Code-runtime window between assembly and execution
packages/core/tools/src/index.ts:1003-1028The runtime is read live during prompt assembly and again during run_code execution; source explicitly records that a cross-language hot reload could hand a program written for one SDK to another runtime and defers request binding.1616
TOOL-DECISIONS
Pre and post decision vocabulary and monotonic guards
packages/core/tools/src/index.ts:580-711Pre decisions can only allow, deny, or ask and deliberately cannot rewrite arguments; post may accept, replace one projection, add context, or block; a guard can return a reason or abstain but cannot force allow.1616
TOOL-DEFINE-HELPER
Hard execution validation and soft replay validation in defineTool
packages/core/tools/src/schema.ts:538-616The helper compiles schemas, hard-validates arguments before the body with INVALID_ARGS, makes presenters and the concurrency classifier fail softly for old or invalid arguments, and binds typed output projectors.1616
TOOL-DEFINITION
Canonical output, execution, and presentation contracts in ToolDefinition
packages/core/tools/src/index.ts:212-301A definition combines model schema, canonical output schema/render/meta, body, timeout and concurrency metadata, finalization, and pure UI presenters while explicitly separating successful values from durable content.1616, 17
TOOL-EXECUTION-IDENTITY
Root, call, and token identity, nested parentage, and result control signals
packages/core/tools/src/index.ts:304-472ToolExecutionInput distinguishes root calls, opaque parent tokens, Agent, and caller signal; registry executions add an unforgeable token, while ToolRunContext carries control only through deferContext and concludeTurn on its own result.1616
TOOL-HOST-PRESENTER
Host pairing and fail-soft fallback for live and replay presenters
packages/host/apiproxy/src/api-proxy.ts:735-779The Host computes call and result views from the current scoped definition and looks up result arguments; a cross-page missing call, JSON parse error, or presenter throw only omits the view while the original event still ships for generic client fallback.1616, 17
TOOL-LOOP-COMMIT
Agent-loop commits for tool calls, ordered results, and context
packages/core/agent-loop/src/tool-calls.ts:59-289The loop appends raw tool/call before prepare, runs the staged registry, commits final tool/result in model order citing the call seq, then accepts additional context and concludesTurn; cancelled unstarted calls receive synthetic pairs.1616
TOOL-PIPELINE-DISPATCH
Around dispatch, caller-signal fusion, body execution, and deferred context
packages/core/tools/src/index.ts:1527-1599The registry fuses wrapper and original caller signals, resolves the current definition, awaits body quiescence, validates a successful value, restores the wrapper signal, and normalizes around results and body-deferred contexts; pipeline throws become final errors.1616
TOOL-PIPELINE-FINALIZE
Captured finalizer, double materialization, and observer containment after post
packages/core/tools/src/index.ts:1601-1675Finalization runs post and rechecks cancellation, materializes the candidate, invokes the content-only finalizer captured at call start, materializes and freezes again, and contains all synchronous and asynchronous result-observer failures.1616
TOOL-PIPELINE-PREPARE
Execution creation, argument materialization, and the ordered pre/guard gate
packages/core/tools/src/index.ts:1328-1506The registry mints a token, snapshots and freezes arguments, handles Code Mode collapse and pre-dispatch aborts, then runs scoped pre-policy, approval, and monotonic guards, normalizing ordinary policy failures into staged results.1616
TOOL-POST-POLICY
Value or content replacement, blocking, and context rules in post-execute
packages/core/tools/src/index.ts:1731-1781Post accept may replace value or content but not both; value reruns canonical projection and cannot replace a failure, while block discards body contexts and keeps only contexts explicitly supplied by the blocker.1616
TOOL-PRESENTATION-INTENTS
Provider-neutral call and result render-intent vocabulary
packages/core/tools/src/presentation.ts:1-388Core defines generic, terminal, and diff pending cards plus generic, terminal, diff, search, read, and web completed cards, with structured fields for follow-along, truncation, line views, and citations independent of a particular UI.1616, 17
TOOL-PRESENTATION-MODES
Native, Code, Both, and per-scope presentation
packages/core/tools/src/index.ts:650-1001Configuration or scoped presentAs selects native, code, or both; Code Mode adds the collapse instruction, typed SDK, and reserved run_code and filters Provider schemas to the transport only under code while retaining the SDK end-capability view.1616
TOOL-REGISTRATION
Registration-validation boundary for raw ToolDefinition values
packages/core/tools/src/index.ts:1030-1061Registration checks the output contract, supported output schema, timeout, and reserved name and inserts the live definition in the calling scope; it does not wrap raw definitions with per-call parameter validation.1616
TOOL-RESULT-TYPES
ToolExecutionResult and pre/post decision unions
packages/core/tools/src/index.ts:555-600A success carries an execution-local value, content, metadata, context, and optional concludesTurn, while a failure has no value; pre decisions are allow, deny, or ask and post decisions accept, replace value or content, or block.1616
TOOL-RUNTIME-INVARIANT
Invariant for tool-pipeline order, freezing, and Code dispatch lineage
packages/core/tools/src/invariant.ts:17-120The companion checks pre, execute, and post stage order per execution, frozen final execution, result, and content with nonempty identity, and nested Code dispatch root/parent lineage within an open Turn.1616
TOOL-SCHEMA-PROJECTION
Model-schema allowlist, Code SDK output schema, and fail-closed classification
packages/core/tools/src/index.ts:1228-1285Native schemas project only detached name, description, and parameters, the Code SDK additionally carries output schemas, and executionMode is parallel only for an exact true while absence, invalid input, or exceptions are exclusive.1616, 17
TOOL-SCHEMA-SUBSET
The enforced JSON Schema subset and stack-safe validator
packages/core/tools/src/json-schema.ts:1-430The schema vocabulary is limited to types, oneOf, container and literal constraints, and lossless annotations; it rejects unknown keywords, cycles, exotic records, and sparse arrays and uses an explicit task stack for path-qualified violations.1616
TOOL-SCOPE-VIEW
Scoped restrictions, shadowing, guards, and one visibility resolver
packages/core/tools/src/index.ts:1064-1226Restrictions intersect along the chain and filter inherited capability while exempting and allowing shadows from own registrations; global and chain guards can only deny, and get, schema, and dispatch resolve from the same live view.1616
TOOLCAT-GENERATOR
Catalog completeness guards, isolated package boots, and schema rendering
scripts/gen-tool-catalog.ts:556-704The generator rejects omitted on-disk tool packages and pending boots that harvest zero schemas, then uses a fresh Context per package to load ToolRuntime, collect scoped schemas, dispose, and render name, description, parameters, and source.1717
WEBUI-BOOT-SETTLE
Two-phase boot and the all-ACTIVE gate
packages/client/web/src/boot.tsx:150-237Boot settles the immediately-prefetch barrier, leaving individual failures for import retry and reporting, before creating Loader entries and verifying every root fiber is ACTIVE.3030
WEBUI-BROWSER-CONTEXT
Browser Cordis Context boot
packages/client/web/src/boot.tsx:97-143The page parses the boot graph, constructs ClientModuleSystem and an independent Context, then enters browser boot.3030
WEBUI-CHAT-STORE
Session-scoped Chat UI store
packages/client/ui-conversation/src/client/stores.ts:1-34The chat-store handle defines selection, draft, view, inspect state, a persistence key, and the sole action set.3030
WEBUI-COLD-SESSION-DISPATCH
Cold-session frame dispatch policy
packages/client/runtime/src/client/sessions/manager.ts:675-789An uninstantiated session drops ordinary events; projections and jobs land in manager mirrors, while only interactions and queue snapshots unrecoverable from history enter the replay buffer.3030
WEBUI-CONNECTION-GENERATION
WebSocket generations and backoff
packages/client/connection/src/client/connection.ts:19-201One generation opens mux and host streams plus describe concurrently; after readiness settles, stream loss reaches shared backoff. The dual-onOpen wait has a three-second guard, but describe has no generation signal/timeout and can wedge reconnect after a stream has ended; sink failures are isolated.3030, 33
WEBUI-CONVERSATION-DEFINITION
Conversation Definition contract
packages/client/runtime/src/client/contract/conversation.ts:164-227A Definition specifies event-only matching, stable ids, start/update folding, location data, and target-specific view-node construction.3030
WEBUI-CONVERSATION-FOLD
Conversation Context fold rules
packages/client/runtime/src/client/sessions/conversation-assembler.ts:337-446Multiple Definitions may claim one event; Contexts group by kind and id, duplicate starts and unordered updates fail, and fallback handles only unclaimed targets.3030
WEBUI-CONVERSATION-INCREMENTAL
Incremental Conversation append and prepend
packages/client/runtime/src/client/sessions/conversation-assembler.ts:162-257replaceWindow handles complete windows and registry rebuilds; append processes only the new event and location-dependent Contexts, while prepend accepts only fresh events and replays the affected closure.3030
WEBUI-CONVERSATION-VIEW-VALIDATION
Conversation view-node stability validation
packages/client/runtime/src/client/sessions/conversation-assembler.ts:707-743The assembler validates that buildViewNode returns the requested target and a key stable for the same Context and target.3030
WEBUI-FOUR-SHARES
Type composition of four props shares
packages/client/ui-slots/src/index.ts:200-450The type layer derives the runtime share from SlotMap owner/key/scope/slot inject, and the other shares from parent-registration children, store, and business inject before composing ComposedProps.3030
WEBUI-GENERIC-TOOLVIEW
Generic Tool renderer dispatch
packages/client/ui-tool/src/client/tool/toolviews/GenericToolCard.tsx:36-77GenericToolCard selects terminal, read, diff, search, web, and other generic cards from the pure model variant.3030
WEBUI-HMR-HOST
Host HMR graph and SSE
packages/client/hmr/src/index.ts:30-190Host HMR polls bundles by default, updates revisions on content changes, and publishes graph and rebuilt messages through its event endpoint.3030
WEBUI-HMR-SWAP
Browser HMR swap order
packages/client/hmr/src/client/index.ts:1-180The browser serializes rebuilt handling, invalidates and prefetches first, then drains the old fiber, removes styles, and refreshes without rollback; Cordis activation epochs cascade provider-fiber replacement.3030
WEBUI-HOST-GRAPH
Host-side client graph publication
packages/client/modules/src/index.ts:184-419ClientModuleRegistry scans Loader entries, accepts those with a fiber, not disabled, and declaring a Web client, registers bundle routes, and injects the current graph into the page.3030
WEBUI-LAZY-MODULES
Lazy module materialization
packages/client/modules/src/client/system.ts:77-195The client module system separates script arrival from factory execution and owns require/import, caching, cycle checks, styles, and invalidation.3030
WEBUI-LAZY-SESSION
Lazy Session instantiation
packages/client/runtime/src/client/sessions/manager.ts:254-320SessionManager creates a Session only on resolution or open and applies buffered cold interactions to the new instance.3030
WEBUI-LIST-REFETCH
Single-flight session-list refetch
packages/client/runtime/src/client/sessions/manager.ts:438-470refreshList is single-flight and replays live mutations observed during the request over the returned baseline.3030
WEBUI-LOCALE-INSTALL
Locale service and settings-row installation
packages/client/locale/src/client/index.ts:346-391The locale plugin installs LocaleFace into SlotRegistry and registers its Language preference row in General settings.3030
WEBUI-LOCALE-OWNER
LocaleRuntime ownership of language and dictionaries
packages/client/locale/src/client/index.ts:104-207LocaleRuntime owns provisional and active locale, Host-settings synchronization, dictionary revision, namespace fallback, and paired zh/en registration.3030
WEBUI-LOCATION-INDEX
Conversation location index
packages/client/runtime/src/client/sessions/conversation-location-index.ts:201-464The location index preserves unchanged Turn and Step object references and returns changed sequences; boundary append revisits only sequences owned by that Turn.3030
WEBUI-MANAGER-RECONNECT
SessionManager reconnect resync
packages/client/runtime/src/client/sessions/manager.ts:878-909Reconnect refreshes the session list and open subagent catalogs, then starts resync for resident Sessions.3030
WEBUI-MANIFEST-CONTRACT
Manifest wire contract
packages/client/modules/src/client/manifest.ts:43-143A manifest row defines id, url, rev, inject, and immediately; the parser validates row-field shape and splits module and plugin views.3030, 33
WEBUI-REACT-BINDING
React binding for bare snapshot sources
packages/client/web-react/src/bind.ts:1-24bindSnapshotSelector converts a getSnapshot/subscribe source into a useSyncExternalStoreWithSelector hook.3030
WEBUI-RENDER-KIT
React props composition for a Slot entry
packages/client/web-react/src/scoped-slots.tsx:343-470At the terminal layer, the renderer composes global and session hooks, projection, store, renderSlot, SessionProvider, locale, and business props.3030
WEBUI-ROOT-DECLARATION
ui-layout declares root-level children
packages/client/ui-layout/src/client/index.ts:120-137ui-layout registers the root entry and declares sidebar, conversation, details, and shell.overlay as children.3030
WEBUI-RUNTIME-RECONNECT
Runtime actions across connection generations
packages/client/runtime/src/client/index.ts:204-232Death of an old generation clears pending interactions; a ready replacement refreshes session and workspace baselines and emits connection/reset.3030
WEBUI-RUNTIME-STORE-OWNER
Runtime owns the snapshot-store engine
packages/client/runtime/src/client/index.ts:69-73runtime constructs SnapshotStoreEngine outside React as the state substrate for later object services.3030
WEBUI-RUNTIME-WIRING
React-free runtime wiring
packages/client/runtime/src/client/index.ts:182-232runtime creates Slot, Conversation, Session, and Workspace object services and routes mux, host, and remote frames into that object layer.3030
WEBUI-SELECTION-ADDRESSABILITY
Addressability gate for the selected Session
packages/client/runtime/src/client/sessions/manager.ts:1020-1075The manager projects current only when the selected id remains in list items or the retained subagent-address map, and exposes currentAddress only for that addressable current.3030
WEBUI-SESSION-GAP-REPAIR
Session sequence windows and gap repair
packages/client/runtime/src/client/sessions/session.ts:612-724Session installs a contiguous history window, stitches live buffers by sequence, and repairs holes by buffering later frames and repulling history instead of publishing a gapped sequence.3030, 33
WEBUI-SESSION-PROVIDER
Keyed remount in strict SessionProvider
packages/client/web-react/src/session-provider.tsx:119-159The root provider follows current; a strict provider requires sessionId and uses it as the key that remounts the session subtree.3030
WEBUI-SESSION-RESYNC
Open-state gate on Session reconnect resync
packages/client/runtime/src/client/sessions/session.ts:412-425resync no-ops for a cold Session that has never opened; only an open or opening Session advances generation, clears the old window, and opens again.3030
WEBUI-SESSION-RUNTIME
SessionRuntime ownership of selection and provide
packages/client/runtime/src/client/sessions/service.ts:228-365SessionRuntime owns the list, persisted selection, manager, scope map, and current provide bundle; provider-roster changes rebuild materialized bundles.3030
WEBUI-SESSION-SCOPE-LIFECYCLE
Session-scope resolution and pruning
packages/client/runtime/src/client/sessions/service.ts:599-766resolve lazily creates the Cordis scope, Session, binding, and sources; off-stage prune disposes them, while removal during staging defers until the stage moves.3030
WEBUI-SESSION-SELECTION
Session-selection projection and persistence
packages/client/runtime/src/client/sessions/service.ts:659-733The service persists an addressable current; a masked gap clears the persisted cell while the manager's in-process selection may resurface when the row returns.3030
WEBUI-SETTINGS-SCOPE
SettingsScope concurrency and recovery semantics
packages/client/ui-settings/src/client/settings-scope.ts:35-269Each namespace serializes reads and writes and carries expectedRevision; a stale read may advance revision/base/user metadata but does not publish decoded value/status. Failures or invalidation refetch, and non-loopback uses memory mode.3030
WEBUI-SETTINGS-SHELL
General-settings Slot shell
packages/client/ui-settings-general/src/client/index.ts:84-177ui-settings-general occupies sidebar.settings, declares its child locations, and derives navigation and copy from the Slot ledger and locale revision.3030
WEBUI-SHELL-INSTALL
App-shell renderer installation
packages/client/web/src/app-shell.ts:29-49app-shell waits for slots, sessions, and layout, installs the React Slot renderer, and exports a stable renderApp closure.3030
WEBUI-SHELL-ROOT
Root Slot assembly
packages/client/web/src/app.tsx:26-43The final App assembly only subscribes to the session title and calls renderSlot('root', {}), without enumerating business UI packages.3030
WEBUI-SINGLE-STAGE-LIMIT
Current single-stage session model
packages/client/runtime/src/client/sessions/service.ts:599-766One current drives a single staged occupant; an absent current or masked gap retains the previous occupant, and a removed-while-staged scope stays frozen until the next stage move.3030
WEBUI-SLOT-CASCADE
Declared-subtree cascade disposal
packages/client/ui-slots/src/index.ts:1123-1148An entry disposer recursively removes descendant registrations and declarations rooted in its children.3030, 33
WEBUI-SLOT-CORE-COMMIT
Atomic Slot registration commit
packages/client/ui-slots/src/index.ts:787-895Before commit, SlotCore validates declarations, kind parameters, child conflicts, and store scope, then writes the ledger atomically.3030
WEBUI-SLOT-DECL-INJECT
Declaration-gated Slot injection
packages/client/runtime/src/client/slots.ts:128-204inject waits for a target declaration, activates and disposes across declaration epochs, and binds the wait and callback effect to the caller's fiber.3030
WEBUI-SLOT-TYPE-CONTRACT
SlotMap and children type contract
packages/client/ui-slots/src/index.ts:90-145SlotMap defines each location's kind, scope, and owner props; registration children define the child Slots that may be declared and rendered.3030
WEBUI-STALE-AUTHORIZATION
Runtime revalidation of renderSlot authorization
packages/client/web-react/src/scoped-slots.tsx:31-88Every child render revalidates entry liveness in the ledger and children authorization, rejecting stale closures and undeclared keys.3030
WEBUI-STORE-CONTRACT
Slot-store read/write contract
packages/client/ui-slots/src/store.ts:19-125A store handle declares state and actions; component props expose selector reads and baked actions rather than instance set/update.3030
WEBUI-STORE-SCOPE-LIFECYCLE
Slot-store scope caching and cleanup
packages/client/runtime/src/client/slots.ts:264-456Store instances are cached by handle and root/session scope key; session-scope pruning removes both the instance and its persisted value.3030
WEBUI-THEME-DOM
ThemePresenter DOM-write boundary
packages/client/ui-layout/src/client/theme-presenter.ts:1-61ThemePresenter projects only color-scheme, the dark attribute, owned CSS variables, and meta theme-color, and can clean up those writes.3030
WEBUI-THEME-OWNER
ThemeRuntime ownership of preference and tokens
packages/client/ui-theme/src/client/index.ts:139-238ThemeRuntime owns light/dark/system, the system media query, token layers, and theme/change without writing the DOM directly.3030
WEBUI-THEME-PRESENTER
Event-driven ThemePresenter installation
packages/client/ui-layout/src/client/index.ts:145-155ui-layout applies the initial ThemeRuntime snapshot, subscribes to theme/change, and cleans up the presenter on fiber disposal.3030
WEBUI-TOOL-DISPATCH
Recursive ToolCallTree keyed dispatch
packages/client/ui-tool/src/client/tool/ToolCallTree.tsx:13-104Root calls and subCalls recursively enter the toolview Slot through the same wire-name key; an unregistered key uses GenericToolCard fallback.3030
WEBUI-TOOL-LOCAL-STATE
Component-local state in a Tool row
packages/client/ui-tool/src/client/tool/components/ToolRow.tsx:128-180ToolRow keeps expanded in React useState, making that transient presentation state follow component lifecycle.3030
WEBUI-TOOL-MODEL
Pure derived model from a frozen Tool block
packages/client/ui-tool/src/client/tool/models/tool-call-model.ts:204-240The tool-call model purely derives variant, lifecycle, summary, path, input, and output from the frozen block and wire name.3030
WEBUI-TOOL-REGISTRATION
Tool UI Slot registration
packages/client/ui-tool/src/client/apply.ts:22-44ui-tool registers the tool-call Chat node, declares a keyed toolview child, and independently installs generic and specialized tool views.3030
WEBUI-TOOLVIEW-CONTRACT
Atomic ToolView props contract
packages/client/ui-tool/src/client/contract/slots.ts:7-49Toolview owner props carry only callId, wire tool name, frozen block, cwd, a Host-bound openFile callback, and a local inspect callback in a session-scoped keyed Slot.3030
WORKFLOW-AGENT-OPTIONS
Closed agent() option set and schema validation
packages/workflow/workflow-worker-thread/src/runtime.ts:347-398The runtime accepts only label, phase, schema, provider, and model, explicitly rejects deferred/unknown options, and constrains the object-rooted JSON Schema subset.2525
WORKFLOW-AGENT-RESULT
agent() result, failure, and disposal semantics
packages/workflow/workflow-worker-thread/src/runtime.ts:249-345Within a slot the call starts a child; completion returns text or structured data, ordinary failure/missing structured data returns null, infrastructure rejection is fatal, and disposal always runs.2525
WORKFLOW-CANCEL-BOUNDARY
Hook-boundary cancellation and never-reject drive
packages/workflow/workflow-worker-thread/src/runtime.ts:116-187Cancellation rejects queued slots and makes every later hook throw CANCELLED; drive checks settlement around the initial VM timeout and normalizes every failure into a result.2525
WORKFLOW-CANCEL-RACE
First-wins settlement between result and cancellation
packages/workflow/workflow-worker-thread/src/host.ts:486-516The host atomically claims terminal ownership before cleanup; an earlier result stays, while an already accepted cancellation turns a racing non-cancel result into cancelled.2525
WORKFLOW-CAPS
Deployment limits of the workflow worker
packages/workflow/workflow-worker-thread/src/index.ts:31-48Configuration separates concurrent children, total children per run, items per combinator, synchronous slice, and disposal grace; concurrency auto-resolves from CPU count.2525, 33
WORKFLOW-CHILD-BRIDGE
Host child bridge to the Subagent seam
packages/workflow/workflow-worker-thread/src/host.ts:329-412After its admission gate, the host starts a child with parent, shared signal, schema, and provider/model overrides, then forwards a snapshotted result after publishing the handle.2525
WORKFLOW-CHILD-QUIESCENCE
Deduplicated child disposal and quiescence
packages/workflow/workflow-worker-thread/src/host.ts:414-483Each child disposal is memoized; quiescence waits for both pending provider starts and published children, with failures logged and contained.2525
WORKFLOW-CHILD-SNAPSHOT
Worker-boundary snapshot of child results
packages/workflow/workflow-worker-thread/src/host.ts:385-412The host snapshots output, structured data, and stop reason as JSON; inability to cross losslessly is returned as a child infrastructure failure.2525
WORKFLOW-COMBINATORS
parallel barrier and per-item pipeline
packages/workflow/workflow-worker-thread/src/runtime.ts:400-466parallel applies Promise.all to all thunks; pipeline moves each item independently through every stage with no cross-stage barrier; ordinary errors become null and fatal errors propagate.2525
WORKFLOW-DISPOSE
Bounded cleanup transaction of workflow disposal
packages/workflow/workflow-worker-thread/src/host.ts:206-251Memoized disposal immediately drives child cleanup, waits for result and quiescence within the same grace, then unconditionally terminates the worker and performs a final sweep.2525
WORKFLOW-DURABLE-RECORD
Durable root-workflow projection and degradation
packages/workflow/tool-workflow/src/index.ts:69-330The recorder filters lifecycle events by run and disables that run after append failure; execute records only root transport calls and writes run-end after disposal/quiescence.2525
WORKFLOW-ERROR-TAXONOMY
Machine-routable fatal WorkflowError taxonomy
packages/workflow/workflow/src/index.ts:102-148Parse, meta, arguments, options/schema, caps, child infrastructure, JSON boundary, and cancellation have codes; ordinary child failure is outside the fatal taxonomy.2525
WORKFLOW-EVENT-PAIRING
Exactly-once end ledger for every published child
packages/workflow/workflow-worker-thread/src/host.ts:553-582A live host ledger guarantees exactly one agent-end for every forwarded agent-start and synthesizes a cancelled end when the worker can no longer speak.2525
WORKFLOW-EVENTS
Observe-only workflow event vocabulary
packages/workflow/workflow/src/index.ts:36-100The seam defines start, phase, log, agent-start, agent-end, and end; phases have no execution semantics, events expose no control handle, and end omits the result value.2525
WORKFLOW-FATALITY
Unforgeable fatality routing inside combinators
packages/workflow/workflow-worker-thread/src/runtime.ts:400-455parallel and pipeline rethrow only host-realm fatal WorkflowErrors, while ordinary script throws map to per-item null.2525
WORKFLOW-HMR-HOLDER
Holder-bound dependency lifetime of an accepted run
packages/workflow/workflow-worker-thread/src/index.ts:164-180The engine captures the subagent handle before returning, allowing an existing run to keep starting and cleaning children after engine HMR unload.2525
WORKFLOW-JSON-BOUNDARY
Lossless JSON materialization boundary
packages/workflow/workflow-worker-thread/src/realm.ts:42-151Cross-realm copying rejects values JSON cannot preserve, cycles, sparse arrays, exotic prototypes, and symbol keys while safely retaining a __proto__ data key.2525
WORKFLOW-LIFECYCLE
WorkflowEngine lifecycle contract
packages/workflow/workflow/src/index.ts:150-186Invalid requests throw before publication; the holder owns a live run, cancellation and disposal are bounded, listener failures are contained, and end follows result settlement exactly once.2525, 33
WORKFLOW-META
Complete workflow metadata validation and normalized copy
packages/workflow/workflow-worker-thread/src/meta.ts:12-82The validator collects unknown, missing, and mistyped fields and phases, then builds a normalized non-aliasing copy only from validated fields.2525
WORKFLOW-REALM-TRUST
Explicit trust premise that the VM is not a security boundary
packages/workflow/workflow-worker-thread/src/realm.ts:1-39The source calls the VM escapable and limits it to host-loop isolation and termination; getters, proxies, and thrown-value rendering may execute script code.2525
WORKFLOW-RECORD-INVARIANT
Cold-load and incremental Workflow-record invariants
packages/workflow/tool-workflow/src/invariant.ts:67-163The fold rejects missing starts, duplicate sequences/ends, run-end with open members, and post-terminal updates, and applies to both existing Sessions and live appends.2525
WORKFLOW-RECORD-TYPES
Browser-safe Workflow Session record types
packages/workflow/tool-workflow/src/types.ts:13-63Four log-only events record run identity/name, child sequence/label/phase/id, member outcome, and terminal reason.2525
WORKFLOW-SEAM
Workflow start request and holder-owned run
packages/workflow/workflow/src/runtime-types.ts:14-49A request carries script, metadata, args, provider/total overrides, parent, and signal; a live run exposes a never-rejecting result, cancellation, and idempotent disposal.2525
WORKFLOW-SLOTS
FIFO concurrency slots and pre-queue total counting
packages/workflow/workflow-worker-thread/src/runtime.ts:222-274Slot waits are FIFO; total agents are counted and checked before acquisition, cancellation rejects waiters, and a post-acquire check closes races.2525
WORKFLOW-START-VALIDATION
Worker-engine pre-publication validation and start
packages/workflow/workflow-worker-thread/src/index.ts:53-201The engine parse-checks the same wrapper, resolves provider and run ceiling, publishes start only after constructing the worker, and maps later outcomes into run settlement.2525
WORKFLOW-TOOL-CONTRACT
Model-facing Workflow authoring contract
packages/workflow/tool-workflow/src/index.ts:133-270The tool description defines meta, script, args, hooks, failures, and foreground constraints; prompt policy requires explicit large orchestration, while the consumer owns schema and rendering.2525
WORKFLOW-TOOL-EXECUTE
Workflow tool execution, cancellation, and finally disposal
packages/workflow/tool-workflow/src/index.ts:272-330The tool requires a calling Agent, starts a foreground run, bridges abort, awaits the never-reject result, maps non-completed outcomes to errors, and disposes in finally.2525
WORKFLOW-VM-GLOBALS
Closed global surface of the workflow VM
packages/workflow/workflow-worker-thread/src/runtime.ts:75-114Each realm receives only agent, parallel, pipeline, phase, log, and args, and compiles the body in the same async wrapper.2525
WORKFLOW-WORKER-SPAWN
Fresh worker with scrubbed environment and structured clone
packages/workflow/workflow-worker-thread/src/host.ts:32-169Each run creates a new Worker with ambient env and execArgv cleared, preserving only platform temp/development loader pins, while init crosses through workerData clone.2525
production-test · 137
IDPinned sourceWhat this excerpt supportsFirst citationAll citing chapters
AGENT-ATOMIC-TEST
Atomic publication, concurrent same-ID, and creation-only signal tests
packages/core/agent-loop/tests/scope-lifecycle.spec.ts:242-365Tests prove both registries stay unpublished through setup, announcements are ordered, only one concurrent preparation enters, and a creation signal cannot cancel a returned live handle.0505
AGENT-INBOX-TEST
Inbox replay, replacement, unique identity, and cancellation tests
packages/core/agent/tests/agent.spec.ts:41-142Tests cover invalid persisted splices, replacement across queues, duplicate MessageId rejection, and clear producing two durable canceled splices.0505
AGENT-REGISTRY-TEST
Registry split-publication and stale-detach tests
packages/core/agent/tests/agent.spec.ts:258-298Tests prove enter and announce are separate, detach is idempotent, stale capabilities cannot delete replacements, and detach from a created listener waits for every listener to return.0505
AGENT-TEARDOWN-TEST
Reentrant teardown ordering during creation notifications
packages/core/agent-loop/tests/scope-lifecycle.spec.ts:623-715Tests prove the registry remains stable for every listener during notification; rollback then unwinds scope, emits agent/disposed, and emits session/disposed in order.0505
APPROVAL-ESCALATION-TESTS
Sandbox escalation fail-closed tests
packages/sandbox/sandbox/tests/escalation.spec.ts:20-111Tests cover argument pairing, strict widening, audit reasons, missing service/Agent, and every non-grant outcome.1919
APPROVAL-GUARD-TESTS
Monotonic scoped-guard tests
packages/core/tools/tests/scoped.spec.ts:284-375Tests prove a prepended allow cannot bypass an owner guard and cover global composition, scope isolation, disposal, and live registration.1919
APPROVAL-PRESET-TESTS
Permission preset and Session-pinning tests
packages/interaction/permission-presets/tests/permission-presets.spec.ts:67-300Tests cover folds, custom, shared-bundle identity, writes, configuration failures, new-Session defaults, seed/resume preservation, and HMR catch-up.1919
APPROVAL-SERVICE-TESTS
ApprovalService behavior and policy tests
packages/interaction/user-approval/tests/approval.spec.ts:42-503Tests cover open turns, audit pairing, answerer failures, cancellation, fresh ids, unbypassable never, Session overrides, and model context.1919
APPROVAL-TOOLS-TESTS
ToolRuntime approval negative-path tests
packages/core/tools/tests/tools.spec.ts:676-853Tests cover pre denial, missing approval seam, ask outcomes, cancellation, Agent-less calls, and rogue answers.1919
APPROVAL-WEB-TESTS
Web approval registry and recovery tests
packages/host/apiproxy/tests/api-proxy-approval.spec.ts:87-329Tests cover round trip, stable-id replay, malformed/foreign/late responses, abort, teardown, parallel pairing, and unaudited delegation.1919
CODEMODE-TEST-CLIENT-LIFECYCLE
Client replacement, serialization, failure recovery, and disposal tests
packages/extensions/cordis-client-runner/tests/runner.client.spec.ts:201-344Tests cover new-revision replacement, per-Plugin operation serialization, queue recovery after failure, activation-failure teardown, exact retraction, and runner disposal.2323
CODEMODE-TEST-DYNAMIC-GUARD
Dynamic Context escape and capability-gate tests
packages/extensions/cordis-host-runner/tests/sandbox-context.spec.ts:44-246Tests pin rejection of ctx.root bypass, Context-returning services, undeclared services, and access to live ToolDefinition.execute while preserving declared and optional-get paths.2323
CODEMODE-TEST-DYNAMIC-RUNNER
Dynamic definition, ownership, approval, and asynchronous-failure tests
packages/extensions/cordis-host-runner/tests/runner.spec.ts:98-247Tests cover define-only behavior, syntax rejection, cross-session hiding, the Host-only fast path, Client approval/refusal, Client-failure unwind, and failed updates.2323
CODEMODE-TEST-POLICY-FAILURE
Nested policy, error, cancellation, and quiescence tests
packages/core/tools/tests/code-mode.spec.ts:935-1206Tests pin program-side rejection for tool errors, pre-execute denial, lossless JSON, context retention, CODE_RUN_FAILED, outer cancellation, and nested-work drain after runtime rejection.2323
CODEMODE-TEST-PRESENTATION
Code Mode presentation-matrix regression tests
packages/core/tools/tests/code-mode.spec.ts:118-160Tests pin native/code/both wire schemas, SDK presence, and the code-only prompt rule, including its order before ordinary tool guidance.2323
CODEMODE-TEST-SCHEDULER
Nested scheduler, barrier, ordering, and drain tests
packages/core/tools/tests/code-mode.spec.ts:509-799Tests cover concurrency-safe overlap, exclusive barriers, the cap, ordered pre/post stages, run-settlement drain, context commitment, and queued-unstarted abandonment.2323
CODEMODE-TEST-VERSIONING
Version-pointer and failure-ownership tests
packages/extensions/cordis-host-runner/tests/versioning.spec.ts:1-106Tests show that failed updates preserve currentPackageId while cleaning attempt state, pending approval can be cancelled and retracted, and an attaching page's failure does not stop an existing Host run.2323
CODEMODE-TEST-WORKER
Worker failure-budget and isolation tests
packages/code-runtime/code-runtime-worker-thread/tests/runtime.spec.ts:128-338Tests cover syntax/runtime exceptions, an empty environment, lossless output, busy/wall timeouts, abort, late bindings, OOM/worker exit, and the combined output cap.2323
CODEMODE-TEST-WORKER-HOSTILE
Hostile worker-port and bidirectional JSON validation tests
packages/code-runtime/code-runtime-worker-thread/tests/runtime.spec.ts:442-603Tests inject unknown bindings, duplicate IDs, junk messages, forged log/done messages, and lossless-JSON violations, verifying that the host fails closed without crashing.2323
COMPACT-PRUNE-TEST
Tests for prune-first two-mechanism composition and replayable checkpoints
packages/compaction/compaction-basic/tests/compaction-basic.spec.ts:769-879Test source requires no opportunistic pruning below pressure, no LLM call when pruning suffices, summarization of the pruned Surface when it does not, and checkpoint source and token price with fresh-Session replay equality.1313
COMPACT-REAL-LOOP-TEST
Real-loop contract tests for between-Step pressure and same-Step overflow
packages/compaction/compaction-basic/tests/compaction-loop-repro.spec.ts:217-381Test source requires pressure to run between the prior step/end and next step/start; overflow creates a checkpoint and retries within the same Step, removing the old sentinel from retry messages.1313
DESIGN-SCOPE-TEST
Scope inheritance, isolation, and reverse-teardown tests
packages/core/scope/tests/scope.spec.ts:24-220Tests verify nearest tags, synchronous registration, shared quiescence, reverse teardown, key-based routing, and events flowing to ancestor scopes without leaking down to descendants.0202
FAILURE-CANCEL-TEST
Abort-to-idle latch and queued-tail cancellation tests
packages/core/agent-loop/tests/cancel.spec.ts:129-403Verifies latch replay, clearing, removal, slow convergence, and disposal boundaries, and pins default mid-Step cancellation dropping the entire queued tail.2727
FAILURE-CANCEL-TOOL-TEST
Replay-integrity test for cancellation after assistant message
packages/core/agent-loop/tests/cancel.spec.ts:405-458Cancellation keeps tool-body execution at zero but records a matching call and TOOL_ABORTED_BEFORE_DISPATCH result that a later request can replay.2727
FAILURE-CHECKPOINT-TEST
Checkpoint ordering, rejection, and cancellation tests
packages/session/session-checkpoint-policy/tests/session-checkpoint-policy.spec.ts:62-238Verifies adapter/tool dispatch follows flush, checkpoint rejection blocks side effects, cancellation produces the canonical not-dispatched result, and nested tools reuse the outer checkpoint.2727
FAILURE-CRASH-CONTRACT
Backend-agnostic crash-repair shared contract
packages/session/session-persistence/tests/contract.ts:118-265Pins interrupted-Turn preservation and closure, a retryable result for an unstarted tool, unknown-outcome guidance for a recorded tool, and a replayable transcript.2727
FAILURE-CRASH-CONTRACT-JSONL
JSONL backend instantiates the shared contract
packages/session/session-persistence-jsonl/tests/jsonl.spec.ts:102-115The real JSONL backend suite invokes runPersistenceContract.2727
FAILURE-CRASH-CONTRACT-MEMORY
In-memory backend instantiates the shared contract
packages/session/session-persistence/tests/persistence.spec.ts:240-249The in-memory persistence suite invokes runPersistenceContract.2727
FAILURE-CRASH-CONTRACT-SQLITE
SQLite backend instantiates the shared contract
packages/session/session-persistence-sqlite/tests/sqlite.spec.ts:51-60The real SQLite backend suite invokes the same runPersistenceContract.2727
FAILURE-CRASH-E2E
SIGKILL recovery E2E at model and tool boundaries
packages/session/session-checkpoint-policy/tests/crash-recovery.e2e.ts:39-110Hard-kills a child process to prove the complete request is durable before model dispatch and the call is durable before a tool side effect, with a missing result repaired as TOOL_OUTCOME_UNKNOWN.2727
FAILURE-CRASH-FIXTURE
Model-dispatch and tool-side-effect failpoints
packages/session/session-checkpoint-policy/tests/fixtures/crash-child.ts:21-60The child waits forever after the adapter receives a request or the tool writes its external-effect marker, giving the parent precise SIGKILL boundaries.2727
FAILURE-DISPOSAL-TEST
Agent teardown order, shared quiescence, and ID-reuse tests
packages/core/agent-loop/tests/scope-lifecycle.spec.ts:921-1051Proves turn/end precedes unregistration, concurrent disposal waits for the same boundary, and an ID cannot be reused before scope cleanup completes.2727
FAILURE-DYNAMIC-CONFIG-TEST
DeepSeek dynamic endpoint/key/policy/last-good tests
packages/llm/llm-deepseek/tests/dynamic-config.spec.ts:61-186Verifies next-request endpoint/key refresh, recovery after adding a key, in-place policy update, and no URL/key leakage from a rejected generation before later recovery.2727
FAILURE-HMR-CONFIG-TEST
Last-good and later recovery test for invalid config refresh
packages/boot/app-boot/tests/config-reload.spec.ts:61-84Both parse failure and empty-file validation failure preserve the last-good running tree, and the next valid edit replaces it successfully.2727
FAILURE-HMR-USER-PATCH-TEST
User-patch HMR failure, recovery, and removal test
packages/boot/app-boot/tests/user-patches.spec.ts:315-356Covers add, apply failure, parse failure, recovery, and removal; failed candidates do not replace the current live configuration.2727
FAILURE-JSONL-TEST
JSONL torn-tail, append-only, and fsync-rollback tests
packages/session/session-persistence-jsonl/tests/jsonl.spec.ts:585-674Covers a torn partial line, open-event preservation and closers, byte-stable committed prefixes, and retry without a sequence gap after fsync rollback.2727
FAILURE-REQUEST-TEST
Request-error narrow seam and cancellation precedence tests
packages/core/agent-loop/tests/request-error.spec.ts:30-141Proves middleware failures bypass recovery, repeated failures stay in Turn 1/Step 1, cancellation beats a retry action, and recovery-listener failure closes the Turn.2727
FAILURE-RETRY-SEMANTICS-TEST
Retry scheduling, partial-chunk isolation, and budget tests
packages/llm/llm-retry/tests/retry.spec.ts:175-344Verifies retry is recorded first, same-Step success, EMPTY_RESPONSE recovery, failed partial chunks do not become a message or tool side effect, and bounded exponential exhaustion.2727
FAILURE-TIMEOUT-TEST
Tool-timeout and caller-abort race tests
packages/guard/timeout-policy/tests/timeout-policy.spec.ts:97-193Covers cooperative return, abort throw, caller-first, and timeout-first behavior, proving timeout still waits for the tool cleanup gate before completion.2727
FAILURE-WIRE-RECOVERY-TEST
Real DeepSeek HTTP/SSE transport recovery tests
packages/llm/llm-retry/tests/transport-recovery.spec.ts:85-219Covers refused connection, stream/partial disconnect, empty response, clean partial EOF, and stalled body while pinning identical request bodies, same-Step behavior, and default retry classification.2727
INBOX-CANCEL-BEHAVIOR-TEST
Claimed work, keepInbox, and latch tests
packages/core/agent-loop/tests/cancel.spec.ts:75-174Tests prove claimed work is not restored, pre-abort queued work parks, post-abort waking sends replay, and default cancel clears the latch.2626
INBOX-CANCEL-DROP-TEST
Default cancellation drops the queued tail
packages/core/agent-loop/tests/cancel.spec.ts:384-403Default cancel during a running Turn records an aborted ending and drops the queued tail before it runs.2626
INBOX-CANCEL-LATCH-TEST
Abort-to-idle wake-latch test matrix
packages/core/agent-loop/tests/cancel.spec.ts:103-218Covers pre-abort parking, post-abort replay, latch clearing/removal, and slow cancellation convergence.2626
INBOX-CONSUMED-WORK-TEST
Consumed-work boundary tests
packages/core/agent/tests/consumed-work.spec.ts:38-158Covers no work, failed/cancelled/blocked claims, empty rewrites, out-of-Turn claims, drops, replacements, and later absorption.2626
INBOX-CRASH-RECOVERY
Hard-crash recovery at model dispatch
packages/session/session-checkpoint-policy/tests/crash-recovery.e2e.ts:82-110After a hard child-process kill, recovery retains the complete request prefix with interrupted closers and repairs missing tool results as unknown outcomes.2626
INBOX-FIFO-PROPERTY
Follow-up FIFO Turn property tests
packages/core/agent-loop/tests/properties.spec.ts:107-190Synchronous bursts, sequential sends, and mixed settlement verify one increasing Turn per ordinary message without reordering.2626
INBOX-PRESTEP-CUTOFF-TEST
Pre-step claim cutoff and late-input tests
packages/core/agent-loop/tests/interception.spec.ts:257-363Inject and steer arriving during pre-step miss the first request and enter the next Step in order; input after a blocked batch survives.2626
INBOX-TURN-STOPPING-TEST
Turn-stopping steering regression
packages/core/agent-loop/tests/contract-regressions.spec.ts:317-340When the model would otherwise stop, steer from a turn-stopping listener forces a second model Step in the same Turn.2626
LLM-MULTI-ATTEMPT-REPLAY-TEST
Replay test for multiple provider attempts in one Turn and Step
packages/test-support/llm-replay/tests/llm-replay.spec.ts:119-132The test explicitly splits failed and successful chunk streams sharing a turn and step into two provider calls, proving attempt identity cannot be represented by turn and step alone.0808
LLM-PREPARED-PIN-TEST
Prepared-call route and retry-policy pinning test
packages/llm/llm/tests/service.spec.ts:227-257The test dispatches a prepared call after route replacement and proves the old adapter and policy still serve it while the registry exposes the new policy.0808
LLM-RETRY-SAME-STEP-TEST
Retry remains in the same Turn and Step test
packages/llm/llm-retry/tests/retry.spec.ts:175-224The first provider attempt fails and the second succeeds; only one turn/start and one step/start exist while the adapter receives two requests.0808
LLM-RETRY-WIRE-TEST
Identical wire bodies and partial-chunk semantics across retries
packages/llm/llm-retry/tests/transport-recovery.spec.ts:112-198Tests expect identical request bodies across failed and successful attempts, retain failed chunks outside the surface, commit only one assistant message, and do not retry STREAM_CLOSED by default.0808
LOG-FORK-CONTRACT
Tests for empty forks, stable boundaries, frozen seeds, and rejection cases
packages/core/session/tests/fork.spec.ts:63-318Tests cover empty-child lineage, detached frozen seeds, earlier boundaries before an open source tail, every turn-end reason, post-turn log-only events, and rejection of invalid, stale, open-turn, and duplicate-child cases.1010
LOG-RAW-CHUNK-TEST
Complete raw-chunk retention and reassembly test
packages/core/agent-loop/tests/loop.spec.ts:529-547The test requires all seven protocol chunks that produce text abc to remain in order and be reassembled by the canonical assembler.1010
LOG-REPAIR-CONTRACT
Backend contract test: inspect does not commit repair while load does
packages/session/session-persistence/tests/contract.ts:118-266The contract proves inspect returns a balanced logical view with synthetic closers without changing revision, whereas load persists recovery, advances revision, and yields paired calls and results.1010
LOG-REQUEST-RECONSTRUCTION
Theorem test for byte-equal reconstruction of every request
packages/core/agent-loop/tests/request-reconstruction.spec.ts:566-613A fresh Session rebuilds messages from the event prefix before the first chunk, while the request-header fold rebuilds model, reasoning, system, tools, temperature, maxTokens, and stop, all deep-equal to the dispatched request.1010
LOG-TORN-TAIL-CONTRACT
Torn-tail truncation and committed-prefix preservation test
packages/session/session-persistence/tests/coordinator-contract.ts:1427-1479The backend returns a valid committed prefix plus a torn marker; load truncates the fragment, retains every committed open-turn event, and appends deterministic closers.1010
LOOP-ERROR-CONTAINMENT-TEST
Durable error and loop-unload tests
packages/core/agent-loop/tests/loop.spec.ts:1353-1398A model failure becomes both live agent/error and durable turn/end error; unloading an owner mid-turn stops the driver and removes it from the registry.0606
LOOP-INTERCEPTION-TEST
Empty continuation, blocked step, and concurrent pre-step input tests
packages/core/agent-loop/tests/interception.spec.ts:207-363Tests cover an empty post-completion decision opening no step, rejection retaining only turn boundaries, and steer/inject arriving after a claim remaining for the next step or wake.0606
LOOP-ORDER-TEST
Simple-turn and tool-round-trip ordering tests
packages/core/agent-loop/tests/loop.spec.ts:162-233Tests prove inbox receipt precedes the turn, four boundaries nest strictly, assistant usage is durable, and tool call/result enter the second derived request.0606
LOOP-OUTCOME-TEST
Abort and sticky max-tokens outcome tests
packages/core/agent-loop/tests/loop.spec.ts:945-1054Tests confirm mid-stream cancellation records aborted, max-tokens is sticky within one turn but not across turns, and a truncated step does not execute tool calls.0606
LOOP-RECONSTRUCTION-TEST
Byte-equal request reconstruction from the log
packages/core/agent-loop/tests/request-reconstruction.spec.ts:566-613Across tool steps, later turns, prompt changes, and request-config changes, a fresh Session rebuilds messages and folded headers from pre-dispatch events with field equality.0606
LOOP-REQUEST-ERROR-TEST
Request-error recovery boundary tests
packages/core/agent-loop/tests/request-error.spec.ts:30-141Middleware failures bypass recovery, provider failures may retry repeatedly within one step, cancellation beats retry, and a failing recovery listener ends the turn in error.0606, 07, 08
MEMORY-MCP-CONTRACT-TEST
Memory MCP overlay and fixture-discovery test boundary
apps/cli/tests/memory-mcp-configs.spec.ts:83-131Tests check row fields, version pins, and obvious secrets, then replace each real command with a keyless fixture to prove tool discovery; none of the three real memory providers is executed.1414
MEMORY-REFERENCE-CONTRACT-TEST
Session-reference snapshot, exclusion, and replay-independence tests
packages/context/session-reference/tests/session-reference.spec.ts:320-641Tests require projection of only current conversation and checkpoints, exclusion of nested injections, fixed capture metadata, target independence after source mutation, compaction, or deletion, and equality after fresh Session replay.1414
MULTIAGENT-CODEX-WIRE-TEST
Codex wire protocol-selection test
packages/subagent/subagent-codex/tests/subagent-codex.spec.ts:363-435The test verifies the fixed handshake, ephemeral thread, text input, cross-thread/Turn filtering, reasoning/commentary exclusion, and last-final selection.2424
MULTIAGENT-CONTINUATION-ACCEPTANCE-TEST
Inbox-acceptance commit-point test
packages/subagent/subagent/tests/continuation.spec.ts:101-191The test proves startContinuable returns the accepted inbox message ID after its splice is recorded but before it is claimed into a user/message event or any model request is sent.2424
MULTIAGENT-FORK-OPEN-TURN-TEST
Fork exclusion of the open Turn test
packages/subagent/subagent-fork-in-process/tests/subagent-fork-in-process.spec.ts:134-158The test hangs the parent's second Turn, forks during it, and proves the child seeds only the first complete Turn before completing its own.2424
OBS-TEST-HANDOFF
Capture, reload, and failure-containment tests
packages/session/session-telemetry/tests/telemetry.spec.ts:161-539Covers first-chunk-only capture, on-demand suffixes, reload cursors, rejected middle records, non-awaited flush, shutdown ordering, and backend containment.2828
OBS-TEST-OTEL-COMPOSITION
Real Loader telemetry-composition tests
packages/session/session-telemetry-otel/tests/loader-composition.e2e.ts:78-153Covers scrubbed outbound copies with canonical secrets retained, feedback-only prefixes, and disabled local behavior.2828
OBS-TEST-OTEL-MODES
OTel sharing-mode tests
packages/session/session-telemetry-otel/tests/otel.spec.ts:273-489Covers feedback suffixes, rejection of non-canonical consent, zero disabled transport, mode disclosure, default-off behavior, and fail-loud config.2828
OBS-TEST-OTEL-WIRE
Real SDK-pipeline wire test against a local mock collector
packages/session/session-telemetry-otel/tests/otel.spec.ts:1-163Sends OTLP/HTTP JSON through the real OTel SDK pipeline to a local scripted node:http mock collector and verifies service.name/user.id, both scopes, a source timestamp, severity, session.cwd/event attributes, and the shutdown marker.2828
OBS-TEST-REDACTION
Redaction-boundary regression tests
packages/session/session-telemetry/tests/redact.spec.ts:39-128Covers no-rule pass-through, ledger/ops scrubbing, listener composition, untouched canonical logs, and throw-to-withhold behavior.2828
OBS-TEST-STATS
Stats counting and timing tests
packages/session/session-stats/tests/projection.spec.ts:58-291Covers rejected, cancelled, max-token, retry, tool pairing, invalid usage, clock skew, late mount, and HMR.2828
OBS-TEST-STATS-PAGING
Paged-history stats E2E
apps/web/tests/stats-paged-history.e2e.ts:73-135A long history's tail page immediately shows full-session totals that remain unchanged after load-older.2828
PARALLEL-ABORT-TESTS
Native scheduler cancellation tests
packages/core/agent-loop/tests/tool-calls.spec.ts:459-631Tests cover cancellation before a group, during prepare, while stopping replenishment and synthesizing unstarted results, and prevention of crossing into a later exclusive barrier.1818
PARALLEL-CAP-TESTS
Native rolling-pool cap tests
packages/core/agent-loop/tests/tool-calls.spec.ts:264-365Tests verify invalid-cap rejection, the default, rolling replenishment at cap two, full serialization at cap one, and the shared configured limit for factory-created agents.1818
PARALLEL-CODE-ORDER-TEST
The Code Mode ordering fixture labeled out-of-order
packages/core/tools/tests/code-mode.spec.ts:731-765The test asserts submission-ordered post and contexts, but gate.release() explicitly releases A FIFO before releaseAll, so the fixture does not actually make B complete before A.1818
PARALLEL-CODE-TESTS
Code Mode pool, barrier, and drain tests
packages/core/tools/tests/code-mode.spec.ts:509-730Tests cover parallel overlap, exclusive barriers, the maxParallelSubCalls cap, ordered prepare, barriers through post-execute, and run settlement waiting for an in-progress commit.1818
PARALLEL-CONTEXT-TEST
Test for retaining ordered additional contexts after cancellation
packages/core/agent-loop/tests/tool-calls.spec.ts:523-589The test shows contexts from started calls remain in the next-step inbox as C1, C2, are not logged as user/message when cancellation ends the turn, and enter the log in order on the next wake.1818
PARALLEL-FAILURE-TEST
Scheduler-invariant failure drain test
packages/core/agent-loop/tests/tool-calls.spec.ts:633-690The test injects an internal scheduler rejection and confirms no third body starts, the turn does not end early, the started sibling drains, and the first error closes the turn.1818
PARALLEL-GROUP-TESTS
Parallel groups, exclusive barriers, and live replacement tests
packages/core/agent-loop/tests/tool-calls.spec.ts:99-218Tests cover parallel siblings, parallel-exclusive-parallel grouping, definition replacement after a barrier, and a result observer reclassifying an unstarted call as exclusive.1818
PARALLEL-ORDER-TESTS
Model-order result tests under out-of-order settlement
packages/core/agent-loop/tests/tool-calls.spec.ts:220-262Tests release the second parallel call first and confirm no result appears before the first completes; durable results and deriveMessages still end in C1, C2 order.1818
PARALLEL-RECLASS-TESTS
Live reclassification tests for queued calls
packages/core/agent-loop/tests/tool-calls.spec.ts:144-217Tests show that registry replacement inside an exclusive barrier and synchronous result-observer replacement both affect unstarted calls; the current pool drains before the new exclusive definition runs.1818, 33
PERSIST-SESSION-SQLITE-CONSTRUCTOR-TEST
Session SQLite direct-construction test supplies WAL
packages/session/session-persistence-sqlite/tests/sqlite.spec.ts:677-691The direct-construction test bypasses Schemastery to verify the preparation-cache default but explicitly supplies journalMode: wal, leaving omitted journalMode uncovered.1111
PLANSTATE-GOAL-DRIVER-TEST
Goal round-cap and fail-closed tests
packages/goal/goal-round-driver/tests/goal-round-driver.spec.ts:186-260Tests admit exactly rounds 1 through N and durably block at the cap; hot-load disarms, while provider, error, max-token, and prompt rejection paths stop continuation.1515
PLANSTATE-GOAL-DURABILITY-TEST
Per-round Goal durability-barrier tests
packages/goal/goal-round-driver/tests/goal-round-driver.spec.ts:465-510A creation or prior-round checkpoint failure disarms without extra dispatch, while success requires an observed flush between rounds one and two.1515
PLANSTATE-GOAL-PROJECTION-TEST
Goal projection fail-soft and same-reference tests
packages/goal/goal/tests/projection.spec.ts:142-187Tests pin the same-reference fast path for non-goal and malformed goal-shaped events so projection driving remains fail-soft.1515
PLANSTATE-GOAL-WRAPUP-TEST
Autonomous Goal terminal wrap-up test
packages/goal/tool-goal/tests/tool-goal.spec.ts:352-415Tests require autonomous complete to add one closing context while concludesTurn stays undefined; a direct-human mutation adds no such context.1515
PLANSTATE-PLAN-LOOP-TEST
Plan real-loop and retry tests
packages/plan/plan-mode/tests/integration.spec.ts:66-174Tests prove a write tool still executes in Plan, schemas remain stable, and a same-Step retry reuses old assembly until a later Step applies the mode.1515
PLANSTATE-TODO-PROJECTION
Todo standing-projection tests
packages/todo/tool-todo/tests/projection.spec.ts:68-123Tests prove null before first write, latest whole-list wins, turn/end retention, clearing at the next turn/start, and key removal on unload.1515
PLANSTATE-TODO-TEST
Todo write, replacement, and validation tests
packages/todo/tool-todo/tests/tool-todo.spec.ts:70-209Tests cover successful writes and counts, trimming, whole replacement, parallel policy, rejection of blanks, duplicates, unknown fields and enums, and non-Agent callers.1515
PROFILE-HMR-TEST
HMR last-known-good configuration test
packages/boot/app-boot/tests/user-patches.spec.ts:315-371The test covers addition, apply failure, parse failure, recovery, and removal; failed candidates never replace the previous valid plugin tree.0404
PROFILE-ORDER-TEST
Bundle and user-layer ordering test
packages/boot/app-boot/tests/profile.spec.ts:121-143The test verifies bundle manifest order, wholesale configuration replacement by later layers, and empty composition without a user layer.0404
PROMPT-ASSEMBLY-MUTATION-TEST
Provider membership, complete section, and assembly snapshot tests
packages/core/system-prompt/tests/system-prompt.spec.ts:212-333Tests pin tool-provider membership snapshots, complete-section restoration and conflicts, and isolation of mutations between assemblies.0707
PROMPT-CACHE-E2E
Real DeepSeek API prefix-cache test
packages/core/agent-loop/tests/request-cache.e2e.ts:71-103When an API key is present, the E2E requires every assistant usage after the first to report positive cacheReadTokens and verifies the tool value reaches the final answer; this study did not execute the test.0707
PROMPT-CANCEL-TEST
No-step disposal and cancellation during prompt assembly
packages/core/agent-loop/tests/contract-regressions.spec.ts:1100-1199Tests prove disposal or cancellation during blocked assembly leaves only turn start and aborted turn end, with no step, chunk, message, or adapter request.0707
PROMPT-HEADER-CHANGE-TEST
Stable prompts omit headers while real changes write full snapshots
packages/core/agent-loop/tests/request-reconstruction.spec.ts:433-455Tests prove per-step reassembly adds no header when values are equal; a real system-prompt change writes a second full header with reason change while preserving history.0707
PROMPT-SCOPE-SHADOW
Scoped persona shadowing and provider non-evaluation test
packages/core/system-prompt/tests/scoped.spec.ts:32-79Tests prove a same-name scoped section shadows only its scope, leaves the global view intact, and prevents evaluation of the shadowed text provider.0707
PROMPT-VARIABLE-TEST
Variable live iteration and strict interpolation tests
packages/core/system-prompt/tests/system-prompt.spec.ts:449-580Tests cover same-generation variable registration, unknown, undefined, and malformed references, prototype-like names, and non-recursive substitution values.0707
SANDBOX-FS-FENCE-TEST
Filesystem-fence mode and escape tests
packages/fs/fs-sandbox/tests/fs-sandbox.spec.ts:59-235Tests cover read-only mutation denial and reads, workspace and temp writes, absolute, parent, and symlink escapes, fresh targets, full mode, per-call overrides, and structured denial.2020
SANDBOX-LOCAL-TEST
Local sandbox profile, selection, and fail-closed tests
packages/sandbox/sandbox-local/tests/local.spec.ts:64-453Tests cover the three profile dialects, custom runners, Linux fallback, sole and multiple candidate probing, verdict caching, unavailable behavior, partial Landlock, Seatbelt, and the Windows ACL chain.2020
SANDBOX-OBSERVATION-TEST
Observation decision, owner-isolation, and disposal tests
packages/fs/fs-observation-policy/tests/policy.spec.ts:47-235Tests pin unseen, absent, and present write and edit outcomes, version refresh after successful mutation, no-owner behavior, multiple owners, first-wins, and state and listener removal on disposal.2020
SESSION-APPEND-BOUNDARY-TEST
Append precommit veto, postcommit containment, and surface atomicity tests
packages/core/session/tests/session.spec.ts:1388-1507Tests prove observers see an already committed event and cannot roll it back; internal dispatch may veto before commit, and a rejected surface plan does not pollute the next append.0909
SESSION-DERIVED-ORACLE-TEST
Incremental derivation equality with a fresh replay oracle
packages/core/session/tests/derived-cache.spec.ts:22-86Tests compare the live cache with a fresh Session replay after appends, an empty assistant, and replacement, and prove a previously returned array does not grow after later appends.0909
SESSION-IMMUTABILITY-TEST
Derived-message immutability and source rejection of invalid JSON
packages/core/session/tests/session.spec.ts:437-495Tests cannot mutate frozen derived messages or content, and append rejects BigInt, functions, symbols, maps, undefined, infinity, sparse arrays, and cyclic graphs without growing the log.0909
SESSION-SEED-REPLAY-TEST
Seed replay and idempotent end-seed test
packages/core/session/tests/session.spec.ts:116-155The test proves a seeded Session derives the same messages, retains the verbatim prefix, appends one end-seed, and does not keep growing when an already marked seed is reopened.0909
SESSION-UNKNOWN-EVENT-TEST
Load test for unknown required and ignorable events
packages/session/session-persistence/tests/coordinator-contract.ts:1360-1382The test requires an unknown required event to raise SessionFormatUnsupportedError while retaining an unknown ignorable=true event in the loaded event log.0909
TEST-ACP
ACP handshake, session, and input-boundary tests
packages/acp/acp/tests/bridge.spec.ts:14-147Tests pin capabilities, version response, no-op auth, fresh sessions, baseline prompts, resource links, unsupported workspace/MCP features, and unknown-cancel behavior.2929
TEST-CONNECTION
Connection generation and reconnect tests
packages/client/connection/tests/connection.client.spec.ts:1-322Tests cover describe plus two-stream readiness, stream/error, sink isolation, open-timeout degradation, and state deduplication; the readiness stream-end rebuild fixture must manually resolve the hung describe first, exposing its lack of timeout/signal.2929
TEST-REMOTE
Generated Remote client tests
packages/api/gateway/tests/gateway.client.spec.ts:1-829Tests cover strict boundaries, mount rollback, in-flight withdrawal cancellation, scope projection, carrier-failure folding, and forwarded-event listener isolation.2929
TEST-SDK-PROTOCOL
JSON-RPC transport regression tests
packages/sdk/protocol/tests/transport.spec.ts:1-307Tests cover requests, notifications, error code/data, malformed frames, split UTF-8, abort abandonment, flush, stream end, and unknown response ids.2929
TINV-CONFIG-TEST
Focused Cordis metadata tests
scripts/verify-cordis-config.spec.ts:1-38Validates the allowed entry-level disabled expression and covers three rejection paths: !!js in static metadata, nested !!js under disabled, and invalid disabled syntax.3232
TINV-COVERAGE-EXEMPT-TEST
Exemption-roster closure test
scripts/coverage-exempt.spec.ts:13-54Verifies nonempty equivalence between each filter and exclude glob and forbids overlapping roster entries.3232
TINV-FIXTURE-LAYOUT-TEST
Session-fixture layout guard
scripts/session-fixture-layout.snapshot.ts:1-16Scans snapshot session JSONL and rejects noncanonical packed event representations.3232
TINV-INVARIANT-TOPOLOGY-TEST
Invariant-topology regression test
scripts/test-invariants.spec.ts:97-152Registers every companion after real Loader unwrapping and asserts that package reservations match the companion selected from each test path.3232
TINV-REGISTRY-TEST
Registry lifecycle tests
packages/runtime-diagnostics/invariants/tests/service.spec.ts:189-302Covers package-attributed errors, child-fiber disposal, duplicate names, and atomic rollback on startup failure.3232
TINV-REPLAY-TEST
Positional replay failure-semantics tests
packages/test-support/llm-replay/tests/llm-replay.spec.ts:671-917Covers positional order, throw, hang, script exhaustion, abort, and underrun failure semantics.3232
TINV-SESSION-TEST
Session invariant regression tests
packages/core/session/tests/invariant.spec.ts:34-116Verifies that successful commits advance the trace while vetoed publication neither advances nor contaminates later expectations.3232
TINV-SNAPSHOT-COMPARE
ACP process and dual-channel snapshot comparison
packages/test-support/acp-snapshot/src/suite.ts:1167-1342Runs the real assembled entry, normalizes volatile values, and separately compares stdout and harvested main and child session logs.3232, 34
TINV-SNAPSHOT-FIXTURES
Scenario fixture closure
packages/test-support/acp-snapshot/src/suite.ts:1440-1480Rejects orphan directories, missing inputs or expectations, invalid overrides, and illegal header-sidecar ownership.3232
WEBUI-CONNECTION-TESTS
Connection-generation tests
packages/client/connection/tests/connection.client.spec.ts:22-183Existing tests cover dual-stream readiness, generation teardown, reconnect backoff, and sink-error isolation.3030
WEBUI-CONVERSATION-TESTS
Incremental Conversation projection tests
packages/client/runtime/tests/conversation-assembler.client.spec.ts:126-262Existing tests cover append/prepend, Context folding, replay of affected nodes, and identity preservation for unchanged nodes.3030
WEBUI-HMR-TESTS
Host HMR watcher tests
packages/client/hmr/tests/node-half.client.spec.ts:85-203Existing tests cover graph-bundle watching, row addition and removal, stat and content changes, rename races, and unwatching after fiber disposal.3030
WEBUI-LOCATION-TESTS
Conversation location-replay tests
packages/client/runtime/tests/conversation-assembler.client.spec.ts:564-860Existing tests cover Turn and Step location changes, boundary append/prepend, and updates to nodes that depend on location.3030
WEBUI-MANAGER-TESTS
SessionManager list-refetch tests
packages/client/runtime/tests/manager.client.spec.ts:78-166Existing tests cover refreshList single-flight, Host baseline ordering, and replay of live mutations during the request.3030
WEBUI-MODULE-TESTS
Client module-loader tests
packages/client/modules/tests/loader.client.spec.ts:63-293Existing tests cover factory arrival, materialization, dependency caching, styles, and invalidation behavior.3030
WEBUI-PREFERENCE-TESTS
Locale preference and dictionary tests
packages/client/locale/tests/locale.client.spec.ts:30-239Existing tests cover browser-provisional locale, Host preference, fallback, paired dictionary registration, and revision notifications.3030
WEBUI-REACT-BINDING-TESTS
React-binding tests over the real SlotCore
packages/client/web-react/tests/scoped-slots-real-core.client.spec.tsx:62-125Existing integration tests cover uSES notification batching, live rendering, stable references, and stale authorization over the real Slot ledger.3030
WEBUI-SESSION-SCOPE-TESTS
Session-scope lifecycle tests
packages/client/runtime/tests/sessions-service.client.spec.ts:122-174Existing tests cover lazy scope creation on first resolution, stable bindings, off-stage removal cleanup, and staged removal deferred until the stage moves.3030
WEBUI-SESSION-TESTS
Session-window and gap tests
packages/client/runtime/tests/session.client.spec.ts:178-374Existing tests cover history/live stitching, duplicate sequences, gap detection, repair, and retention of the old window on failure.3030
WEBUI-SETTINGS-TESTS
SettingsScope state-machine tests
packages/client/ui-settings/tests/settings-scope.client.spec.ts:65-421Existing tests cover initial read, serialized writes, revisions, failure recovery, invalidation, stale reads, and memory mode.3030
WEBUI-SLOT-TESTS
Slot declaration and cascade tests
packages/client/ui-slots/tests/core.client.spec.ts:52-107Existing tests cover root-only initial declaration, rejection of undeclared targets, child declaration, and cascading cleanup after parent removal.3030
WEBUI-THEME-PRESENTER-TESTS
ThemePresenter DOM-projection tests
packages/client/ui-layout/tests/theme-presenter.client.spec.ts:44-90Existing tests cover light and dark projection, token replacement, one meta node, and disposal that retracts only presenter-owned writes.3030
WEBUI-THEME-TESTS
ThemeRuntime preference and token tests
packages/client/ui-theme/tests/theme.client.spec.ts:24-249Existing tests cover system resolution, Host preference, reversible theme and token layers, revisions, and the service's no-DOM boundary.3030
WEBUI-TOOL-TESTS
ToolView keyed-dispatch tests
packages/client/ui-tool/tests/toolview-slot.client.spec.tsx:91-230Existing tests cover wire-name specialized dispatch, generic fallback, recursive subcalls, and the atomic props boundary.3030
WEBUI-WEB-REACT-TESTS
SessionProvider lifecycle tests
packages/client/web-react/tests/session-provider.client.spec.tsx:92-190Existing tests cover strict-provider session resolution, fail-loud behavior for missing sessions, and keyed remount when sessionId changes.3030
repository-policy · 7
IDPinned sourceWhat this excerpt supportsFirst citationAll citing chapters
DESIGN-PACKAGE-RULES
Ownership, commit-point, boundary, and package-invariant rules
packages/AGENTS.md:8-18Asynchronous work needs one lifecycle owner; capability contracts serve all consumers; state publishes only at commit; bounds apply to complete results; and each package owns its runtime invariants.0202
PKG-INVARIANTS
Package lifecycle and invariant rules
packages/AGENTS.md:5-18Constraints for plugin exports, composition tests, ownership, commit points, disposal, and per-package invariants.0202, 03
ROOT-BOUNDARIES
Explicit boundaries and fail-fast behavior
AGENTS.md:107-116Cross-package defaults resolve explicitly, deployment parameters are configurable, invalid configuration fails early, and external IDs use branded types.0202
ROOT-EFFECTS
Registration as effects and waterfall semantics
AGENTS.md:91-100Contributions register through effect/on and are disposable; waterfall listeners must call next.0202
ROOT-MODEL-LOGGED
Model-visible means logged
AGENTS.md:99-104Every input entering a model request requires a session event and must be reconstructable from the log.0202, 07
ROOT-PREVIEW
Developer Preview compatibility posture
AGENTS.md:5-8Before the first tag, sound foundations take precedence over compatibility shims, and on-disk formats carry no compatibility promise.0101, 02
ROOT-TYPED-TRUST
Validation at static and runtime boundaries
AGENTS.md:115-117Same-process statically typed values trust TypeScript, while parsing, model JSON, persistence, processes, workers, and wire boundaries receive runtime validation.Not cited in this corpus

5. Package and repository-zone index · 219

Universe: the complete pinned package inventory. Evidence counts refer only to catalog paths matched by an exact package-path boundary; unmatched paths are retained in explicit repository zones.

Packages · 219
Package / zoneCatalog pathsEvidence recordsSource filesTest files
packages/acp/acp
@deepseek-ai/dsh-acp
41338
packages/api/gateway
@deepseek-ai/dsh-api-gateway
4842
packages/api/remotes
@deepseek-ai/dsh-api-remotes
3562
packages/attachment/attachment
@deepseek-ai/dsh-attachment
2250
packages/attachment/attachment-local
@deepseek-ai/dsh-attachment-local
3643
packages/boot/app-boot
@deepseek-ai/dsh-app-boot
51436
packages/boot/cmdline
@deepseek-ai/dsh-cmdline
0021
packages/bundle/base
@deepseek-ai/dsh-base
11721
packages/bundle/headless
@deepseek-ai/dsh-headless
1232
packages/bundle/web-app
@deepseek-ai/dsh-web-app
1533
packages/client/connection
@deepseek-ai/dsh-client-connection
10151611
packages/client/hmr
@deepseek-ai/dsh-client-hmr
3341
packages/client/locale
@deepseek-ai/dsh-client-locale
23116
packages/client/modules
@deepseek-ai/dsh-client-modules
4452
packages/client/runtime
@deepseek-ai/dsh-client-runtime
16384425
packages/client/schema-form
@deepseek-ai/dsh-client-schema-form
0032
packages/client/ui-agent-preset
@deepseek-ai/dsh-client-ui-agent-preset
00137
packages/client/ui-attachment
@deepseek-ai/dsh-client-ui-attachment
0075
packages/client/ui-commands
@deepseek-ai/dsh-client-ui-commands
00105
packages/client/ui-conversation
@deepseek-ai/dsh-client-ui-conversation
11127028
packages/client/ui-deliverables
@deepseek-ai/dsh-client-ui-deliverables
0072
packages/client/ui-directory-picker-browse
@deepseek-ai/dsh-client-ui-directory-picker-browse
0062
packages/client/ui-directory-picker-native
@deepseek-ai/dsh-client-ui-directory-picker-native
0041
packages/client/ui-goal
@deepseek-ai/dsh-client-ui-goal
5593
packages/client/ui-input-trigger
@deepseek-ai/dsh-client-ui-input-trigger
00145
packages/client/ui-jobs
@deepseek-ai/dsh-client-ui-jobs
1162
packages/client/ui-layout
@deepseek-ai/dsh-client-ui-layout
3496
packages/client/ui-message-feedback
@deepseek-ai/dsh-client-ui-message-feedback
0083
packages/client/ui-model-selection
@deepseek-ai/dsh-client-ui-model-selection
0092
packages/client/ui-permission-presets
@deepseek-ai/dsh-client-ui-permission-presets
3383
packages/client/ui-plan
@deepseek-ai/dsh-client-ui-plan
1162
packages/client/ui-primitives
@deepseek-ai/dsh-client-ui-primitives
004421
packages/client/ui-settings
@deepseek-ai/dsh-client-ui-settings
2263
packages/client/ui-settings-general
@deepseek-ai/dsh-client-ui-settings-general
11117
packages/client/ui-settings-models
@deepseek-ai/dsh-client-ui-settings-models
001810
packages/client/ui-settings-plugin-inventory
@deepseek-ai/dsh-client-ui-settings-plugin-inventory
0063
packages/client/ui-settings-plugins
@deepseek-ai/dsh-client-ui-settings-plugins
00175
packages/client/ui-sidebar
@deepseek-ai/dsh-client-ui-sidebar
0077
packages/client/ui-skill
@deepseek-ai/dsh-client-ui-skill
1162
packages/client/ui-slots
@deepseek-ai/dsh-client-ui-slots
3644
packages/client/ui-subagent
@deepseek-ai/dsh-client-ui-subagent
1172
packages/client/ui-theme
@deepseek-ai/dsh-client-ui-theme
2298
packages/client/ui-tool
@deepseek-ai/dsh-client-ui-tool
882516
packages/client/ui-trajectory
@deepseek-ai/dsh-client-ui-trajectory
33288
packages/client/ui-user-questions
@deepseek-ai/dsh-client-ui-user-questions
1184
packages/client/ui-workflow-run
@deepseek-ai/dsh-client-ui-workflow-run
0071
packages/client/ui-workspace
@deepseek-ai/dsh-client-ui-workspace
11118
packages/client/web
@deepseek-ai/dsh-client-web
34115
packages/client/web-react
@deepseek-ai/dsh-client-web-react
5677
packages/code-runtime/code-runtime
@deepseek-ai/dsh-code-runtime
2232
packages/code-runtime/code-runtime-worker-thread
@deepseek-ai/dsh-code-runtime-worker-thread
4976
packages/compaction/command-compact
@deepseek-ai/dsh-command-compact
1123
packages/compaction/compaction
@deepseek-ai/dsh-compaction
4463
packages/compaction/compaction-basic
@deepseek-ai/dsh-compaction-basic
61064
packages/compaction/compaction-tool-result-pruner
@deepseek-ai/dsh-compaction-tool-result-pruner
2242
packages/context/agent-instructions
@deepseek-ai/dsh-agent-instructions
1172
packages/context/session-reference
@deepseek-ai/dsh-session-reference
4571
packages/context/time-context
@deepseek-ai/dsh-time-context
1144
packages/context/tmux-context
@deepseek-ai/dsh-tmux-context
1121
packages/core/agent
@deepseek-ai/dsh-agent
71886
packages/core/agent-default-model
@deepseek-ai/dsh-agent-default-model
0021
packages/core/agent-loop
@deepseek-ai/dsh-agent-loop
1678620
packages/core/agent-tool-presentation
@deepseek-ai/dsh-agent-tool-presentation
0021
packages/core/scope
@deepseek-ai/dsh-scope
2243
packages/core/session
@deepseek-ai/dsh-session
12261013
packages/core/system-prompt
@deepseek-ai/dsh-system-prompt
3724
packages/core/tools
@deepseek-ai/dsh-tools
10641012
packages/credentials/credentials
@deepseek-ai/dsh-credentials
1133
packages/credentials/credentials-local
@deepseek-ai/dsh-credentials-local
1324
packages/e2b/e2b
@deepseek-ai/dsh-e2b
1222
packages/e2b/fs-e2b
@deepseek-ai/dsh-fs-e2b
2421
packages/e2b/subprocess-e2b
@deepseek-ai/dsh-subprocess-e2b
2372
packages/examples/acp-demo
@deepseek-ai/dsh-acp-demo
0033
packages/examples/agent-spine-demo
@deepseek-ai/dsh-agent-spine-demo
0023
packages/examples/jsonrpc-demo
@deepseek-ai/dsh-sdk-jsonrpc-demo
0050
packages/extensions/cordis-client-runner
@deepseek-ai/dsh-cordis-client-runner
56125
packages/extensions/cordis-host-runner
@deepseek-ai/dsh-cordis-host-runner
81886
packages/extensions/tool-cordis
@deepseek-ai/dsh-tool-cordis
3781
packages/extensions/ui-cordis
@deepseek-ai/dsh-client-ui-cordis
00163
packages/feedback/command-feedback
@deepseek-ai/dsh-command-feedback
1122
packages/feedback/message-feedback
@deepseek-ai/dsh-message-feedback
1144
packages/fs/fs
@deepseek-ai/dsh-fs
3332
packages/fs/fs-local
@deepseek-ai/dsh-fs-local
3743
packages/fs/fs-observation-policy
@deepseek-ai/dsh-fs-observation-policy
3531
packages/fs/fs-sandbox
@deepseek-ai/dsh-fs-sandbox
3432
packages/fs/tool-fs
@deepseek-ai/dsh-tool-fs
67128
packages/fs/tool-fs-search
@deepseek-ai/dsh-tool-fs-search
1185
packages/fs/tool-str-replace-editor
@deepseek-ai/dsh-tool-str-replace-editor
0021
packages/goal/command-goal
@deepseek-ai/dsh-command-goal
2221
packages/goal/goal
@deepseek-ai/dsh-goal
4674
packages/goal/goal-round-driver
@deepseek-ai/dsh-goal-round-driver
2332
packages/goal/tool-goal
@deepseek-ai/dsh-tool-goal
4441
packages/guard/repeat-tool-reminder
@deepseek-ai/dsh-repeat-tool-reminder
0021
packages/guard/timeout-policy
@deepseek-ai/dsh-tool-call-timeout-policy
2221
packages/hooks/hook-protocol
@deepseek-ai/dsh-hook-protocol
0097
packages/hooks/hooks-claude-code
@deepseek-ai/dsh-hooks-claude-code
0037
packages/hooks/hooks-codex
@deepseek-ai/dsh-hooks-codex
0036
packages/host/apiproxy
@deepseek-ai/dsh-host-apiproxy
13484220
packages/host/directory-picker
@deepseek-ai/dsh-host-directory-picker
0021
packages/host/directory-picker-auto
@deepseek-ai/dsh-host-directory-picker-auto
0042
packages/host/directory-picker-browse
@deepseek-ai/dsh-host-directory-picker-browse
0021
packages/host/directory-picker-native
@deepseek-ai/dsh-host-directory-picker-native
0086
packages/host/frontend-static
@deepseek-ai/dsh-host-frontend-static
0021
packages/host/plugin-inventory
@deepseek-ai/dsh-host-plugin-inventory
0032
packages/host/webserver
@deepseek-ai/dsh-host-webserver
0021
packages/identity/anonymous-user-id
@deepseek-ai/dsh-anonymous-user-id
1122
packages/interaction/commands
@deepseek-ai/dsh-commands
0042
packages/interaction/permission-presets
@deepseek-ai/dsh-permission-presets
31143
packages/interaction/tool-ask-user
@deepseek-ai/dsh-tool-ask-user
0021
packages/interaction/user-approval
@deepseek-ai/dsh-user-approval
4832
packages/interaction/user-questions
@deepseek-ai/dsh-user-questions
1131
packages/jobs/jobs
@deepseek-ai/dsh-jobs
0042
packages/jobs/jobs-local
@deepseek-ai/dsh-jobs-local
1422
packages/jobs/tool-jobs
@deepseek-ai/dsh-tool-jobs
1221
packages/llm/llm
@deepseek-ai/dsh-llm
7141411
packages/llm/llm-deepseek
@deepseek-ai/dsh-llm-deepseek
51379
packages/llm/llm-pi-ai
@deepseek-ai/dsh-llm-pi-ai
441013
packages/llm/llm-retry
@deepseek-ai/dsh-llm-retry
4855
packages/llm/token-meter
@deepseek-ai/dsh-token-meter
46103
packages/lsp/lsp
@deepseek-ai/dsh-lsp
1141
packages/lsp/lsp-stdio
@deepseek-ai/dsh-lsp-stdio
23910
packages/lsp/tool-lsp
@deepseek-ai/dsh-tool-lsp
1144
packages/mcp/mcp-client
@deepseek-ai/dsh-mcp-client
51256
packages/plan/plan-mode
@deepseek-ai/dsh-plan-mode
3744
packages/preset/agent-presets
@deepseek-ai/dsh-agent-presets
1198
packages/preset/persona
@deepseek-ai/dsh-persona
0021
packages/runtime-diagnostics/invariants
@deepseek-ai/dsh-invariants
2321
packages/sandbox/sandbox
@deepseek-ai/dsh-sandbox
51343
packages/sandbox/sandbox-local
@deepseek-ai/dsh-sandbox-local
41036
packages/sandbox/sandbox-policy
@deepseek-ai/dsh-sandbox-policy
2332
packages/sandbox/sandbox-windows-acl
@deepseek-ai/dsh-sandbox-windows-acl
111214
packages/schedule/schedule
@deepseek-ai/dsh-schedule
0087
packages/sdk/client
@deepseek-ai/dsh-sdk-client
4763
packages/sdk/protocol
@deepseek-ai/dsh-sdk-protocol
4441
packages/sdk/server
@deepseek-ai/dsh-sdk-jsonrpc-server
2534
packages/session-query/session-log-export
@deepseek-ai/dsh-session-log-export
0087
packages/session-query/session-query
@deepseek-ai/dsh-session-query
57114
packages/session-query/session-query-sqlite
@deepseek-ai/dsh-session-query-sqlite
2243
packages/session-query/tool-session-query
@deepseek-ai/dsh-tool-session-query
4772
packages/session/session-checkpoint-policy
@deepseek-ai/dsh-session-checkpoint-policy
5923
packages/session/session-persistence
@deepseek-ai/dsh-session-persistence
62065
packages/session/session-persistence-jsonl
@deepseek-ai/dsh-session-persistence-jsonl
61374
packages/session/session-persistence-sqlite
@deepseek-ai/dsh-session-persistence-sqlite
3731
packages/session/session-projection
@deepseek-ai/dsh-session-projection
1431
packages/session/session-projection-cache
@deepseek-ai/dsh-session-projection-cache
2331
packages/session/session-stats
@deepseek-ai/dsh-session-stats
3352
packages/session/session-telemetry
@deepseek-ai/dsh-session-telemetry
51032
packages/session/session-telemetry-otel
@deepseek-ai/dsh-session-telemetry-otel
5922
packages/session/session-title
@deepseek-ai/dsh-session-title
0057
packages/session/session-title-all-prompts-llm
@deepseek-ai/dsh-session-title-all-prompts-llm
0021
packages/session/session-title-first-prompt-llm
@deepseek-ai/dsh-session-title-first-prompt-llm
0023
packages/session/session-title-llm
@deepseek-ai/dsh-session-title-llm
0021
packages/settings/settings
@deepseek-ai/dsh-settings
2344
packages/settings/settings-file
@deepseek-ai/dsh-settings-file
0025
packages/shell/bash-local
@deepseek-ai/dsh-bash-local
0022
packages/shell/bash-sandbox
@deepseek-ai/dsh-bash-sandbox
2235
packages/shell/pwsh-local
@deepseek-ai/dsh-pwsh-local
0032
packages/shell/pwsh-sandbox
@deepseek-ai/dsh-pwsh-sandbox
0032
packages/shell/shell
@deepseek-ai/dsh-shell
1142
packages/shell/shell-env
@deepseek-ai/dsh-shell-env
1221
packages/shell/tool-bash
@deepseek-ai/dsh-tool-bash
2442
packages/shell/tool-bash-persistent
@deepseek-ai/dsh-tool-bash-persistent
1122
packages/shell/tool-pwsh
@deepseek-ai/dsh-tool-pwsh
2443
packages/skill/skill
@deepseek-ai/dsh-skill
1621
packages/skill/skill-badge
@deepseek-ai/dsh-skill-badge
0021
packages/skill/skill-filesystem
@deepseek-ai/dsh-skill-filesystem
1522
packages/skill/tool-skill
@deepseek-ai/dsh-tool-skill
1521
packages/spill/spill
@deepseek-ai/dsh-spill
0031
packages/spill/spill-local
@deepseek-ai/dsh-spill-local
0031
packages/spill/spill-policy
@deepseek-ai/dsh-spill-policy
0031
packages/storage/storage
@deepseek-ai/dsh-storage
2252
packages/storage/storage-domain
@deepseek-ai/dsh-storage-domain
1263
packages/storage/storage-json
@deepseek-ai/dsh-storage-json
3351
packages/storage/storage-sqlite
@deepseek-ai/dsh-storage-sqlite
3442
packages/subagent/subagent
@deepseek-ai/dsh-subagent
15401810
packages/subagent/subagent-acp
@deepseek-ai/dsh-subagent-acp
2434
packages/subagent/subagent-claude-code
@deepseek-ai/dsh-subagent-claude-code
1145
packages/subagent/subagent-codex
@deepseek-ai/dsh-subagent-codex
4546
packages/subagent/subagent-dsh-sdk
@deepseek-ai/dsh-subagent-dsh-sdk
1132
packages/subagent/subagent-fork-in-process
@deepseek-ai/dsh-subagent-fork-in-process
2222
packages/subagent/subagent-in-process-driver
@deepseek-ai/dsh-subagent-in-process-driver
2334
packages/subagent/subagent-spawn-in-process
@deepseek-ai/dsh-subagent-spawn-in-process
1123
packages/subagent/tool-subagent
@deepseek-ai/dsh-tool-subagent
1323
packages/subagent/tool-subagent-control
@deepseek-ai/dsh-tool-subagent-control
2333
packages/subagent/tool-subagent-report
@deepseek-ai/dsh-tool-subagent-report
1121
packages/subprocess/subprocess
@deepseek-ai/dsh-subprocess
2531
packages/subprocess/subprocess-local
@deepseek-ai/dsh-subprocess-local
3557
packages/terminal/terminal
@deepseek-ai/dsh-terminal
1131
packages/terminal/terminal-bash
@deepseek-ai/dsh-terminal-bash
2255
packages/terminal/tool-terminal
@deepseek-ai/dsh-tool-terminal
1133
packages/test-support/acp-snapshot
@deepseek-ai/dsh-acp-snapshot
2464
packages/test-support/agent-loop-testkit
@deepseek-ai/dsh-agent-loop-testkit
0021
packages/test-support/client-runtime
@deepseek-ai/dsh-client-test-runtime
00103
packages/test-support/llm-mock-server
@deepseek-ai/dsh-llm-mock-server
0043
packages/test-support/llm-replay
@deepseek-ai/dsh-llm-replay
3521
packages/test-support/loader-smoke
@deepseek-ai/dsh-loader-smoke
0036
packages/todo/tool-todo
@deepseek-ai/dsh-tool-todo
4445
packages/typert/generator
@deepseek-ai/dsh-typert-generator
001718
packages/typert/loader
@deepseek-ai/dsh-typert-loader
0021
packages/typert/protocol
@deepseek-ai/dsh-typert-protocol
0032
packages/typert/registry
@deepseek-ai/dsh-typert-registry
0051
packages/util/atomic-write
@deepseek-ai/dsh-atomic-write
1122
packages/util/brand
@deepseek-ai/dsh-brand
0020
packages/util/home-paths
@deepseek-ai/dsh-home-paths
0021
packages/util/launch-environment
@deepseek-ai/dsh-launch-environment
0021
packages/util/native-command
@deepseek-ai/dsh-native-command
1121
packages/util/output-retention
@deepseek-ai/dsh-output-retention
0021
packages/util/timeout
@deepseek-ai/dsh-timeout
1121
packages/web/tool-web
@deepseek-ai/dsh-tool-web
1154
packages/web/web
@deepseek-ai/dsh-web
2231
packages/web/web-fetch-http
@deepseek-ai/dsh-web-fetch-http
3441
packages/web/web-search-deepseek
@deepseek-ai/dsh-web-search-deepseek
2444
packages/web/web-search-exa
@deepseek-ai/dsh-web-search-exa
0042
packages/web/web-search-perplexity
@deepseek-ai/dsh-web-search-perplexity
0042
packages/workflow/tool-ralph
@deepseek-ai/dsh-tool-ralph
2922
packages/workflow/tool-workflow
@deepseek-ai/dsh-tool-workflow
3532
packages/workflow/workflow
@deepseek-ai/dsh-workflow
3542
packages/workflow/workflow-worker-thread
@deepseek-ai/dsh-workflow-worker-thread
621108
packages/workspace/workspace
@deepseek-ai/dsh-workspace
41062
Repository zones · 9
Package / zoneCatalog pathsEvidence recordsSource filesTest files
.agents24
.github39
apps1022
docs610
examples36
packages-unmatched34
python36
repository-root410
scripts1721

6. Catalog path index · 533

Universe: distinct paths represented by the evidence catalog, not every file in the repository.

Pinned sourcePackage or repository zoneCatalog ranges
.agents/notes/implemented/bug-fix/2026-08-07-cancel-convergence-wake-latch.md.agents9-29 · INBOX-WAKE-LATCH-NOTE
.agents/notes/implemented/feature/2026-07-10-parallel-tool-call-execution.md.agents17-25 · PARALLEL-SAFETY-NOTE
43-51 · PARALLEL-NOTE-DRIFT
53-65 · TOOLCAT-PARALLEL-OPTINS
.github/workflows/ci.yml.github63-257 · TINV-CI-LINUX
260-296 · TINV-NODE-MATRIX
328-489 · OPEN-CI-WINDOWS-SIGNALS
328-489 · TINV-WINDOWS
491-696 · OPEN-CI-SERIAL-LANES
904-935 · OPEN-CI-VERDICT
904-935 · TINV-REQUIRED-VERDICT
.github/workflows/e2e.yml.github1-65 · OPEN-REAL-API-CI
.github/workflows/sandbox.yml.github1-113 · OPEN-SANDBOX-CI
AGENTS.mdrepository-root5-8 · ROOT-PREVIEW
91-100 · ROOT-EFFECTS
99-104 · ROOT-MODEL-LOGGED
107-116 · ROOT-BOUNDARIES
115-117 · ROOT-TYPED-TRUST
apps/cli/config/agent-presets/code/agent.cordis.ymlapps164-220 · MULTIAGENT-CODE-PRESET
apps/cli/config/agent-presets/cordis/agent.cordis.ymlapps155-220 · MULTIAGENT-CORDIS-PRESET
apps/cli/config/agent-presets/minimal/agent.cordis.ymlapps1-62 · MEMORY-MINIMAL-PRESET
1-60 · SHELL-MINIMAL-COMPOSITION
1-62 · TOOLCAT-MINIMAL
apps/cli/config/agent-presets/standard/agent.cordis.ymlapps1-251 · MULTIAGENT-STANDARD-PRESET
35-74 · SHELL-STANDARD-COMPOSITION
35-124 · TOOLCAT-STANDARD-BASE
76-87 · CAP-SKILL-SHIPPED
76-155 · MEMORY-STANDARD-PRESET
157-251 · TOOLCAT-STANDARD-ORCHESTRATION
165-233 · WORKFLOW-SHIPPED-PRESET
apps/cli/package.jsonapps1-12 · OPEN-CLI-VERSION
apps/cli/src/bin.tsapps27-52 · CLI-PROFILE-DISPATCH
apps/cli/src/plugin.tsapps55-157 · SEC-PLUGIN-PNPM
apps/cli/src/profile-boot.tsapps56-170 · OBS-HARD-OPTOUT
59-103 · PROFILE-ROOT
121-170 · PROFILE-COMPOSE
121-170 · SEC-PROFILE-ORDER
227-299 · PROFILE-LIVE
apps/cli/tests/memory-mcp-configs.spec.tsapps83-131 · MEMORY-MCP-CONTRACT-TEST
apps/web/tests/stats-paged-history.e2e.tsapps73-135 · OBS-TEST-STATS-PAGING
docs/agent-lifecycle.mddocs19-80 · TURN-SEQUENCE
docs/architecture.mddocs9-13 · ARCH-PLUGIN-CORE
15-37 · ARCH-LAYERS
63-90 · ARCH-TURN
92-102 · ARCH-LOG
docs/cordis-primer.mddocs7-44 · DESIGN-CORDIS-SEMANTICS
docs/testing.mddocs7-15 · TINV-POLICY
docs/tool-catalog.mddocs1-41 · TOOLCAT-GENERATED
16-41 · TOOLCAT-PACKAGE-MAP
docs/tool-execution-pipeline.mddocs4-60 · TOOL-PIPELINE
examples/headless-agent/advanced.cordis.ymlexamples28-34 · CODEMODE-SELF-MOD-OPTIN
28-34 · SEC-SELF-MOD-OPTIN
examples/headless-agent/e2b.cordis.ymlexamples1-41 · SANDBOX-E2B-COMPOSITION
35-57 · CAP-LSP-OPTIONAL
examples/mcp-memory/README.mdexamples1-33 · CAP-MCP-DEFAULT-OFF
5-82 · MEMORY-MCP-BOUNDARY
packages/acp/acp/package.jsonpackages/acp/acp1-36 · ACP-PACKAGE
packages/acp/acp/src/codec.tspackages/acp/acp9-65 · ACP-CODEC
packages/acp/acp/src/index.tspackages/acp/acp1-45 · SEC-ACP-TRUST
18-35 · ACP-SDK-IMPORTS
130-229 · ACP-OUTPUT-PERMISSION
145-345 · ACP-PROMPT-CANCEL
212-229 · APPROVAL-ACP-ANSWERER
212-274 · SEC-ACP-BRIDGE
231-436 · ACP-HANDSHAKE
348-415 · ACP-QUIESCE
348-353 · ACP-SDK-CONNECTION
430-433 · SEC-ACP-CWD
packages/acp/acp/tests/bridge.spec.tspackages/acp/acp14-147 · TEST-ACP
packages/AGENTS.mdpackages-unmatched5-18 · PKG-INVARIANTS
8-18 · DESIGN-PACKAGE-RULES
packages/api/gateway/src/client/index.tspackages/api/gateway174-260 · REMOTE-CLIENT-MOUNT
327-415 · REMOTE-CLIENT-INVOKE
399-409 · SEC-REMOTE-CARRIER
549-575 · SEC-REMOTE-CODECS
packages/api/gateway/src/index.tspackages/api/gateway90-235 · REMOTE-HOST-DISPATCH
159-489 · REMOTE-HOST-ERRORS
packages/api/gateway/src/types.tspackages/api/gateway6-46 · REMOTE-GATEWAY-TYPES
packages/api/gateway/tests/gateway.client.spec.tspackages/api/gateway1-829 · TEST-REMOTE
packages/api/remotes/src/agent-lookup.tspackages/api/remotes113-210 · PLANSTATE-GOAL-API-ROUTING
113-211 · REMOTE-AGENT-RESOLVE
packages/api/remotes/src/client/index.tspackages/api/remotes97-121 · SEC-REMOTE-MOUNT
packages/api/remotes/src/remote-events.tspackages/api/remotes1-29 · REMOTE-EVENT-ALLOWLIST
1-29 · SEC-REMOTE-EVENTS
packages/attachment/attachment-local/README.mdpackages/attachment/attachment-local1-7 · PERSIST-ATTACH-DECODE-DOC
17-20 · OPEN-ATTACHMENT-LOCAL-RETENTION
17-21 · PERSIST-ATTACH-LIMITS
packages/attachment/attachment-local/src/image.tspackages/attachment/attachment-local21-65 · PERSIST-ATTACH-DECODE-IMPL
packages/attachment/attachment-local/src/store.tspackages/attachment/attachment-local19-194 · PERSIST-ATTACH-STORE
46-230 · PERSIST-ATTACH-DECODE-SOURCE
packages/attachment/attachment/README.mdpackages/attachment/attachment17-21 · OPEN-ATTACHMENT-RETENTION
packages/attachment/attachment/src/index.tspackages/attachment/attachment28-59 · PERSIST-ATTACH-SEAM
packages/boot/app-boot/src/index.tspackages/boot/app-boot92-198 · SEC-ENV-LAYERS
225-265 · BOOT-HMR
225-338 · FAILURE-HMR-WATCH
267-337 · SEC-PATCH-LAYERS
475-528 · SEC-LOADER-IMPORT
757-801 · BOOT-TRANSACTION
757-801 · SEC-BOOT-TRANSACTION
packages/boot/app-boot/src/profile.tspackages/boot/app-boot104-168 · PROFILE-TEMPLATES
204-255 · PROFILE-MODULE-FALLBACK
357-420 · PROFILE-LOAD
packages/boot/app-boot/tests/config-reload.spec.tspackages/boot/app-boot61-84 · FAILURE-HMR-CONFIG-TEST
packages/boot/app-boot/tests/profile.spec.tspackages/boot/app-boot121-143 · PROFILE-ORDER-TEST
packages/boot/app-boot/tests/user-patches.spec.tspackages/boot/app-boot315-356 · FAILURE-HMR-USER-PATCH-TEST
315-371 · PROFILE-HMR-TEST
packages/bundle/base/cordis.patch.ymlpackages/bundle/base1-24 · BASE-BUNDLE-SEMANTICS
24-100 · BASE-BUNDLE-SPINE
98-121 · MEMORY-DEFAULT-COMPOSITION
98-356 · PROJ-SHIPPED-COMPOSITION
98-115 · TOOLCAT-ATTACHMENT
129-161 · OBS-BASE-DEFAULT
163-205 · SEC-SHIPPED-PERMISSION
166-205 · APPROVAL-SHIPPED-PRESETS
166-205 · SANDBOX-SHIPPED-POLICY
210-230 · SANDBOX-SHIPPED-FS
232-248 · CAP-SKILL-BASE
265-279 · PLANSTATE-SHIPPED-PLAN-POLICY
292-338 · MULTIAGENT-BASE-COMPOSITION
315-382 · WORKFLOW-SHIPPED-BASE
367-375 · PLANSTATE-SHIPPED-TODO-POLICY
396-418 · CAP-WEB-SHIPPED
441-445 · SANDBOX-SHIPPED-FS-PROVIDER
packages/bundle/headless/cordis.patch.ymlpackages/bundle/headless1-35 · HEADLESS-BUNDLE
17-26 · CODEMODE-HEADLESS-COMPOSITION
packages/bundle/web-app/cordis.patch.ymlpackages/bundle/web-app35-50 · CODEMODE-WEB-COMPOSITION
97-203 · WEBUI-DUAL-ROSTER
276-408 · WEB-AGENT-PLANE
367-390 · MULTIAGENT-WEB-PLANE
380-410 · WORKFLOW-WEB-ISOLATION
packages/client/connection/README.mdpackages/client/connection23-26 · OPEN-API-BODY-BOUND
packages/client/connection/src/api-request-trust.tspackages/client/connection1-123 · API-TRUST-FENCE
1-122 · APPROVAL-WEB-TRUST
1-122 · SEC-BROWSER-FENCE
packages/client/connection/src/client/connection.tspackages/client/connection3-201 · API-CONNECTION-LOOP
19-201 · WEBUI-CONNECTION-GENERATION
packages/client/connection/src/client/rpc.tspackages/client/connection24-46 · API-HTTP-CLIENT
packages/client/connection/src/client/web-api-client.tspackages/client/connection34-90 · API-WS-CLIENT
packages/client/connection/src/http-bridge.tspackages/client/connection8-99 · API-HTTP-BRIDGE
packages/client/connection/src/index.tspackages/client/connection69-195 · API-PRIVILEGED-LOOPBACK
69-159 · SEC-BROWSER-PRIVILEGED
packages/client/connection/src/rpc-host.tspackages/client/connection144-223 · API-HTTP-HANDLER
packages/client/connection/src/websocket-downlink.tspackages/client/connection46-137 · API-WS-HOST
packages/client/connection/tests/connection.client.spec.tspackages/client/connection1-322 · TEST-CONNECTION
22-183 · WEBUI-CONNECTION-TESTS
packages/client/hmr/src/client/index.tspackages/client/hmr1-180 · WEBUI-HMR-SWAP
packages/client/hmr/src/index.tspackages/client/hmr30-190 · WEBUI-HMR-HOST
packages/client/hmr/tests/node-half.client.spec.tspackages/client/hmr85-203 · WEBUI-HMR-TESTS
packages/client/locale/src/client/index.tspackages/client/locale104-207 · WEBUI-LOCALE-OWNER
346-391 · WEBUI-LOCALE-INSTALL
packages/client/locale/tests/locale.client.spec.tspackages/client/locale30-239 · WEBUI-PREFERENCE-TESTS
packages/client/modules/src/client/manifest.tspackages/client/modules43-143 · WEBUI-MANIFEST-CONTRACT
packages/client/modules/src/client/system.tspackages/client/modules77-195 · WEBUI-LAZY-MODULES
packages/client/modules/src/index.tspackages/client/modules184-419 · WEBUI-HOST-GRAPH
packages/client/modules/tests/loader.client.spec.tspackages/client/modules63-293 · WEBUI-MODULE-TESTS
packages/client/runtime/README.mdpackages/client/runtime89-93 · OPEN-CLIENT-UNLOAD
89-92 · WEBUI-UNLOAD-LIMIT
packages/client/runtime/src/client/contract/conversation.tspackages/client/runtime164-227 · WEBUI-CONVERSATION-DEFINITION
packages/client/runtime/src/client/index.tspackages/client/runtime69-73 · WEBUI-RUNTIME-STORE-OWNER
182-232 · WEBUI-RUNTIME-WIRING
204-232 · WEBUI-RUNTIME-RECONNECT
packages/client/runtime/src/client/sessions/conversation-assembler.tspackages/client/runtime133-248 · LOG-CONVERSATION-ASSEMBLER
162-257 · WEBUI-CONVERSATION-INCREMENTAL
337-446 · WEBUI-CONVERSATION-FOLD
707-743 · WEBUI-CONVERSATION-VIEW-VALIDATION
packages/client/runtime/src/client/sessions/conversation-location-index.tspackages/client/runtime201-464 · WEBUI-LOCATION-INDEX
packages/client/runtime/src/client/sessions/manager.tspackages/client/runtime254-320 · WEBUI-LAZY-SESSION
438-735 · PROJ-CLIENT-MANAGER
438-470 · WEBUI-LIST-REFETCH
675-789 · WEBUI-COLD-SESSION-DISPATCH
878-909 · WEBUI-MANAGER-RECONNECT
1020-1075 · WEBUI-SELECTION-ADDRESSABILITY
packages/client/runtime/src/client/sessions/projection-store.tspackages/client/runtime67-177 · PROJ-CLIENT-STORE
128-177 · PROJ-CLIENT-EQUAL-SEQ
packages/client/runtime/src/client/sessions/queue-mirror.tspackages/client/runtime23-73 · INBOX-CLIENT-MIRROR
packages/client/runtime/src/client/sessions/service.tspackages/client/runtime228-365 · WEBUI-SESSION-RUNTIME
599-766 · WEBUI-SESSION-SCOPE-LIFECYCLE
599-766 · WEBUI-SINGLE-STAGE-LIMIT
659-733 · WEBUI-SESSION-SELECTION
packages/client/runtime/src/client/sessions/session.tspackages/client/runtime184-329 · INBOX-CHILD-CLIENT
376-723 · OBS-HISTORY-CLIENT
412-485 · INBOX-RECONNECT-CLIENT
412-425 · WEBUI-SESSION-RESYNC
612-724 · WEBUI-SESSION-GAP-REPAIR
614-729 · LOG-CLIENT-STITCH
packages/client/runtime/src/client/sessions/steering-history.tspackages/client/runtime20-63 · INBOX-HISTORY-CLASSIFICATION
packages/client/runtime/src/client/slots.tspackages/client/runtime128-204 · WEBUI-SLOT-DECL-INJECT
264-456 · WEBUI-STORE-SCOPE-LIFECYCLE
packages/client/runtime/tests/conversation-assembler.client.spec.tspackages/client/runtime126-262 · WEBUI-CONVERSATION-TESTS
564-860 · WEBUI-LOCATION-TESTS
packages/client/runtime/tests/manager.client.spec.tspackages/client/runtime78-166 · WEBUI-MANAGER-TESTS
packages/client/runtime/tests/session.client.spec.tspackages/client/runtime178-374 · WEBUI-SESSION-TESTS
packages/client/runtime/tests/sessions-service.client.spec.tspackages/client/runtime122-174 · WEBUI-SESSION-SCOPE-TESTS
packages/client/ui-conversation/README.mdpackages/client/ui-conversation57-64 · WEBUI-DETAILS-LIMIT
packages/client/ui-conversation/src/client/chat/ChatView.tsxpackages/client/ui-conversation400-406 · INBOX-PENDING-STEERING-UI
packages/client/ui-conversation/src/client/chat/StatsLine.tsxpackages/client/ui-conversation34-205 · OBS-STATS-UI
packages/client/ui-conversation/src/client/conversation-nodes/assistant.tspackages/client/ui-conversation72-205 · LOG-CLIENT-ASSISTANT
packages/client/ui-conversation/src/client/input/submission-policy.tspackages/client/ui-conversation17-57 · INBOX-SUBMISSION-POLICY
packages/client/ui-conversation/src/client/queue/QueueDock.tsxpackages/client/ui-conversation27-205 · INBOX-QUEUE-DOCK
packages/client/ui-conversation/src/client/skeleton/ApprovalPanel.tsxpackages/client/ui-conversation22-87 · APPROVAL-UI-PANEL
packages/client/ui-conversation/src/client/skeleton/InputBar.tsxpackages/client/ui-conversation313-339 · INBOX-INPUT-GESTURES
541-555 · INBOX-CHILD-COMPOSER
packages/client/ui-conversation/src/client/skeleton/PermissionSelect.tsxpackages/client/ui-conversation10-170 · APPROVAL-PERMISSION-COMPOSER
packages/client/ui-conversation/src/client/skeleton/TodoPanel.tsxpackages/client/ui-conversation81-153 · PLANSTATE-TODO-UI
packages/client/ui-conversation/src/client/stores.tspackages/client/ui-conversation1-34 · WEBUI-CHAT-STORE
packages/client/ui-goal/README.mdpackages/client/ui-goal5-21 · PLANSTATE-DOC-GOAL-UI
packages/client/ui-goal/src/client/goal-command-input.tspackages/client/ui-goal26-70 · PLANSTATE-GOAL-COMMAND-UI
packages/client/ui-goal/src/client/GoalBar.tsxpackages/client/ui-goal34-186 · PLANSTATE-GOAL-UI
packages/client/ui-goal/src/client/GoalCommandInputView.tsxpackages/client/ui-goal11-30 · PLANSTATE-GOAL-COMMAND-VIEW
packages/client/ui-goal/src/client/index.tspackages/client/ui-goal40-99 · PLANSTATE-GOAL-UI-REMOTE
packages/client/ui-jobs/README.mdpackages/client/ui-jobs5-24 · SHELL-JOBS-UI
packages/client/ui-layout/src/client/index.tspackages/client/ui-layout120-137 · WEBUI-ROOT-DECLARATION
145-155 · WEBUI-THEME-PRESENTER
packages/client/ui-layout/src/client/theme-presenter.tspackages/client/ui-layout1-61 · WEBUI-THEME-DOM
packages/client/ui-layout/tests/theme-presenter.client.spec.tspackages/client/ui-layout44-90 · WEBUI-THEME-PRESENTER-TESTS
packages/client/ui-permission-presets/src/client/index.tspackages/client/ui-permission-presets55-169 · APPROVAL-PERMISSION-DECORATION
packages/client/ui-permission-presets/src/client/PermissionRow.tsxpackages/client/ui-permission-presets15-126 · APPROVAL-PERMISSION-SETTINGS
packages/client/ui-permission-presets/src/client/settings-store.tspackages/client/ui-permission-presets128-155 · APPROVAL-PERMISSION-SETTINGS-WRITE
packages/client/ui-plan/src/client/PlanModeControl.tsxpackages/client/ui-plan15-68 · PLANSTATE-PLAN-UI
packages/client/ui-settings-general/src/client/index.tspackages/client/ui-settings-general84-177 · WEBUI-SETTINGS-SHELL
packages/client/ui-settings/src/client/settings-scope.tspackages/client/ui-settings35-269 · WEBUI-SETTINGS-SCOPE
packages/client/ui-settings/tests/settings-scope.client.spec.tspackages/client/ui-settings65-421 · WEBUI-SETTINGS-TESTS
packages/client/ui-skill/README.mdpackages/client/ui-skill5-9 · MEMORY-SKILL-CLIENT-UI
packages/client/ui-slots/src/index.tspackages/client/ui-slots90-145 · WEBUI-SLOT-TYPE-CONTRACT
200-450 · WEBUI-FOUR-SHARES
787-895 · WEBUI-SLOT-CORE-COMMIT
1123-1148 · WEBUI-SLOT-CASCADE
packages/client/ui-slots/src/store.tspackages/client/ui-slots19-125 · WEBUI-STORE-CONTRACT
packages/client/ui-slots/tests/core.client.spec.tspackages/client/ui-slots52-107 · WEBUI-SLOT-TESTS
packages/client/ui-subagent/src/client/index.tspackages/client/ui-subagent43-52 · INBOX-CHILD-OFFLINE-UI
packages/client/ui-theme/src/client/index.tspackages/client/ui-theme139-238 · WEBUI-THEME-OWNER
packages/client/ui-theme/tests/theme.client.spec.tspackages/client/ui-theme24-249 · WEBUI-THEME-TESTS
packages/client/ui-tool/src/client/apply.tspackages/client/ui-tool22-44 · WEBUI-TOOL-REGISTRATION
packages/client/ui-tool/src/client/contract/slots.tspackages/client/ui-tool7-49 · WEBUI-TOOLVIEW-CONTRACT
packages/client/ui-tool/src/client/tool/components/ToolRow.tsxpackages/client/ui-tool128-180 · WEBUI-TOOL-LOCAL-STATE
packages/client/ui-tool/src/client/tool/models/tool-call-model.tspackages/client/ui-tool204-240 · WEBUI-TOOL-MODEL
packages/client/ui-tool/src/client/tool/ToolCallTree.tsxpackages/client/ui-tool13-104 · WEBUI-TOOL-DISPATCH
packages/client/ui-tool/src/client/tool/toolviews/GenericToolCard.tsxpackages/client/ui-tool36-77 · WEBUI-GENERIC-TOOLVIEW
packages/client/ui-tool/src/client/tool/toolviews/todo-row.tsxpackages/client/ui-tool1-97 · PLANSTATE-TODO-ROW
packages/client/ui-tool/tests/toolview-slot.client.spec.tsxpackages/client/ui-tool91-230 · WEBUI-TOOL-TESTS
packages/client/ui-trajectory/README.mdpackages/client/ui-trajectory5-17 · OBS-TRAJECTORY-CONTRACT
packages/client/ui-trajectory/src/client/trajectory-request-header-definition.tspackages/client/ui-trajectory9-80 · OBS-TRAJECTORY-PROMPT
packages/client/ui-trajectory/src/client/trajectory-snapshot-builder.tspackages/client/ui-trajectory137-266 · OBS-TRAJECTORY-BUILDER
packages/client/ui-user-questions/src/client/PlanReviewPanel.tsxpackages/client/ui-user-questions36-99 · PLANSTATE-PLAN-REVIEW-UI
packages/client/ui-workspace/README.mdpackages/client/ui-workspace5-11 · MEMORY-WEB-SEARCH
packages/client/web-react/src/bind.tspackages/client/web-react1-24 · WEBUI-REACT-BINDING
packages/client/web-react/src/scoped-slots.tsxpackages/client/web-react31-88 · WEBUI-STALE-AUTHORIZATION
343-470 · WEBUI-RENDER-KIT
packages/client/web-react/src/session-provider.tsxpackages/client/web-react119-159 · WEBUI-SESSION-PROVIDER
packages/client/web-react/tests/scoped-slots-real-core.client.spec.tsxpackages/client/web-react62-125 · WEBUI-REACT-BINDING-TESTS
packages/client/web-react/tests/session-provider.client.spec.tsxpackages/client/web-react92-190 · WEBUI-WEB-REACT-TESTS
packages/client/web/src/app-shell.tspackages/client/web29-49 · WEBUI-SHELL-INSTALL
packages/client/web/src/app.tsxpackages/client/web26-43 · WEBUI-SHELL-ROOT
packages/client/web/src/boot.tsxpackages/client/web97-143 · WEBUI-BROWSER-CONTEXT
150-237 · WEBUI-BOOT-SETTLE
packages/code-runtime/code-runtime-worker-thread/src/bootstrap.tspackages/code-runtime/code-runtime-worker-thread301-424 · CODEMODE-WORKER-BOOT
packages/code-runtime/code-runtime-worker-thread/src/index.tspackages/code-runtime/code-runtime-worker-thread1-6 · CODEMODE-WORKER-TRUST
1-6 · SEC-WORKER-TRUST
230-317 · CODEMODE-WORKER-LIMITS
363-460 · CODEMODE-WORKER-LIFECYCLE
462-556 · CODEMODE-WORKER-BRIDGE
packages/code-runtime/code-runtime-worker-thread/src/worker-json.tspackages/code-runtime/code-runtime-worker-thread247-419 · CODEMODE-FLAT-JSON
packages/code-runtime/code-runtime-worker-thread/tests/runtime.spec.tspackages/code-runtime/code-runtime-worker-thread128-338 · CODEMODE-TEST-WORKER
442-603 · CODEMODE-TEST-WORKER-HOSTILE
packages/code-runtime/code-runtime/src/index.tspackages/code-runtime/code-runtime95-134 · CODEMODE-RUNTIME-DESCRIPTORS
packages/code-runtime/code-runtime/src/types.tspackages/code-runtime/code-runtime9-127 · CODEMODE-SEAM
packages/compaction/command-compact/src/index.tspackages/compaction/command-compact22-105 · COMPACT-COMMAND
packages/compaction/compaction-basic/src/config.tspackages/compaction/compaction-basic67-166 · COMPACT-CONFIG
packages/compaction/compaction-basic/src/index.tspackages/compaction/compaction-basic137-223 · COMPACT-AUTO-TRIGGERS
248-331 · COMPACT-POLICY-LOOP
360-419 · COMPACT-MANUAL
packages/compaction/compaction-basic/src/region.tspackages/compaction/compaction-basic90-134 · COMPACT-RANGE
137-253 · COMPACT-TRANSACTION
338-485 · COMPACT-COMMIT
packages/compaction/compaction-basic/src/summarizer.tspackages/compaction/compaction-basic20-223 · COMPACT-SUMMARIZER
packages/compaction/compaction-basic/tests/compaction-basic.spec.tspackages/compaction/compaction-basic769-879 · COMPACT-PRUNE-TEST
packages/compaction/compaction-basic/tests/compaction-loop-repro.spec.tspackages/compaction/compaction-basic217-381 · COMPACT-REAL-LOOP-TEST
packages/compaction/compaction-tool-result-pruner/src/config.tspackages/compaction/compaction-tool-result-pruner7-64 · COMPACT-PRUNER-CONFIG
packages/compaction/compaction-tool-result-pruner/src/index.tspackages/compaction/compaction-tool-result-pruner63-184 · COMPACT-PRUNER
packages/compaction/compaction/src/index.tspackages/compaction/compaction87-169 · COMPACT-SEAM
packages/compaction/compaction/src/invariant.tspackages/compaction/compaction56-217 · COMPACT-INVARIANT
packages/compaction/compaction/src/tool-pairing.tspackages/compaction/compaction28-130 · COMPACT-PAIRING
packages/compaction/compaction/src/types.tspackages/compaction/compaction16-119 · COMPACT-EVENTS
packages/context/agent-instructions/src/index.tspackages/context/agent-instructions322-347 · PROMPT-CONTEXT-AGENT-INSTRUCTIONS
packages/context/README.mdpackages-unmatched5-14 · MEMORY-REFERENCE-OPT-IN
packages/context/session-reference/README.mdpackages/context/session-reference13-18 · MEMORY-REFERENCE-DOC-DRIFT
45-50 · MEMORY-REFERENCE-TRUST
packages/context/session-reference/src/index.tspackages/context/session-reference42-217 · MEMORY-REFERENCE-RESOLVER
packages/context/session-reference/src/projection.tspackages/context/session-reference35-171 · MEMORY-REFERENCE-PROJECTION
packages/context/session-reference/tests/session-reference.spec.tspackages/context/session-reference320-641 · MEMORY-REFERENCE-CONTRACT-TEST
packages/context/time-context/src/index.tspackages/context/time-context170-208 · PROMPT-CONTEXT-TIME
packages/context/tmux-context/src/index.tspackages/context/tmux-context208-246 · PROMPT-CONTEXT-TMUX
packages/core/agent-loop/README.mdpackages/core/agent-loop68-74 · PARALLEL-AGENT-README
packages/core/agent-loop/src/agent.tspackages/core/agent-loop63-140 · AGENT-RUNTIME-SCOPE
113-329 · FAILURE-AGENT-CANCEL
113-220 · INBOX-DRIVER-WAKE
113-132 · INBOX-SEND-MAP
134-140 · INBOX-CANCEL-CODE
195-243 · LOOP-DRIVER-PRESTEP
202-323 · OBS-DURABLE-FAILURE
225-287 · COMPACT-RUNTIME-ORDER
225-350 · FAILURE-CHECKPOINT-AGENT-ORDER
225-494 · MEMORY-AGENT-CONTEXT
225-243 · PROMPT-STEP-BOUNDARY
245-329 · INBOX-TURN-MACHINE
245-330 · LOOP-TURN-STATE
287-399 · INBOX-TOOL-CONTINUATION
302-458 · FAILURE-AGENT-PREPARE-BOUNDARY
332-400 · FAILURE-REQUEST-LOOP
332-400 · LOG-ATTEMPT-ASSEMBLY
332-400 · LOOP-STEP-STATE
332-370 · PROMPT-RETRY-BOUNDARY
373-399 · PARALLEL-LOOP-ENTRY
393-399 · PARALLEL-AGENT-STEP
403-494 · FAILURE-CHECKPOINT-REQUEST-PREFIX
403-495 · LOOP-REQUEST-BUILD
407-470 · OBS-REQUEST-HEADER
packages/core/agent-loop/src/index.tspackages/core/agent-loop300-345 · PARALLEL-CAP-CONFIG
453-578 · AGENT-PREPARE-PUBLISH
459-530 · FAILURE-AGENT-DISPOSAL
606-709 · AGENT-CREATE-RESUME
624-710 · PROJ-COLD-RESUME
647-709 · INBOX-AGENT-RESUME
packages/core/agent-loop/src/invariant.tspackages/core/agent-loop18-55 · LOOP-REQUEST-INVARIANT
18-55 · TINV-LOOP-REQUEST
35-55 · LLM-REQUEST-INVARIANT-SCOPE
packages/core/agent-loop/src/runtime-context.tspackages/core/agent-loop24-75 · COMPACT-RUNTIME-PROJECTION
24-75 · LOOP-RUNTIME-CONTEXT
packages/core/agent-loop/src/tool-calls.tspackages/core/agent-loop59-110 · SEC-MODEL-PARSE
59-289 · TOOL-LOOP-COMMIT
82-100 · PARALLEL-GROUPING
82-119 · PLANSTATE-TOOL-SCHEDULER
112-255 · FAILURE-TOOL-DRAIN
121-245 · PARALLEL-ROLLING-POOL
145-158 · INBOX-TOOL-CONTEXT
164-175 · FAILURE-CHECKPOINT-TOOL-INTENT
164-288 · PARALLEL-DURABLE-PAIRING
198-245 · PARALLEL-ABORT
215-245 · PARALLEL-SCHEDULER-FAILURE
248-259 · PARALLEL-ABORT-RESULT
packages/core/agent-loop/tests/cancel.spec.tspackages/core/agent-loop75-174 · INBOX-CANCEL-BEHAVIOR-TEST
103-218 · INBOX-CANCEL-LATCH-TEST
129-403 · FAILURE-CANCEL-TEST
384-403 · INBOX-CANCEL-DROP-TEST
405-458 · FAILURE-CANCEL-TOOL-TEST
packages/core/agent-loop/tests/contract-regressions.spec.tspackages/core/agent-loop317-340 · INBOX-TURN-STOPPING-TEST
1100-1199 · PROMPT-CANCEL-TEST
packages/core/agent-loop/tests/interception.spec.tspackages/core/agent-loop207-363 · LOOP-INTERCEPTION-TEST
257-363 · INBOX-PRESTEP-CUTOFF-TEST
packages/core/agent-loop/tests/loop.spec.tspackages/core/agent-loop162-233 · LOOP-ORDER-TEST
529-547 · LOG-RAW-CHUNK-TEST
945-1054 · LOOP-OUTCOME-TEST
1353-1398 · LOOP-ERROR-CONTAINMENT-TEST
packages/core/agent-loop/tests/properties.spec.tspackages/core/agent-loop107-190 · INBOX-FIFO-PROPERTY
packages/core/agent-loop/tests/request-cache.e2e.tspackages/core/agent-loop71-103 · PROMPT-CACHE-E2E
packages/core/agent-loop/tests/request-error.spec.tspackages/core/agent-loop30-141 · FAILURE-REQUEST-TEST
30-141 · LOOP-REQUEST-ERROR-TEST
packages/core/agent-loop/tests/request-reconstruction.spec.tspackages/core/agent-loop433-455 · PROMPT-HEADER-CHANGE-TEST
566-613 · LOG-REQUEST-RECONSTRUCTION
566-613 · LOOP-RECONSTRUCTION-TEST
packages/core/agent-loop/tests/scope-lifecycle.spec.tspackages/core/agent-loop242-365 · AGENT-ATOMIC-TEST
623-715 · AGENT-TEARDOWN-TEST
921-1051 · FAILURE-DISPOSAL-TEST
packages/core/agent-loop/tests/tool-calls.spec.tspackages/core/agent-loop99-218 · PARALLEL-GROUP-TESTS
144-217 · PARALLEL-RECLASS-TESTS
220-262 · PARALLEL-ORDER-TESTS
264-365 · PARALLEL-CAP-TESTS
459-631 · PARALLEL-ABORT-TESTS
523-589 · PARALLEL-CONTEXT-TEST
633-690 · PARALLEL-FAILURE-TEST
packages/core/agent/src/consumed-work.tspackages/core/agent60-107 · INBOX-CONSUMED-WORK
packages/core/agent/src/inbox.tspackages/core/agent24-78 · AGENT-INBOX-REPLAY
24-78 · INBOX-CLAIM-REPLAY
24-39 · INBOX-SEED-BOUNDARY
128-219 · AGENT-INBOX-COMMIT
128-219 · INBOX-COMMIT-IDENTITY
128-192 · MULTIAGENT-INBOX-SPLICE
packages/core/agent/src/index.tspackages/core/agent52-174 · AGENT-SETUP-CONTRACT
300-358 · AGENT-INITIATOR-API
360-430 · AGENT-FACTORY-SEAM
450-617 · AGENT-REGISTRY-LIFECYCLE
619-703 · AGENT-INITIATOR-DRAIN
packages/core/agent/src/runtime-types.tspackages/core/agent23-143 · AGENT-PUBLIC-INTERFACE
43-143 · INBOX-ACTIVITY-CONTRACT
packages/core/agent/src/types.tspackages/core/agent9-25 · INBOX-EVENT-SCHEMA
packages/core/agent/tests/agent.spec.tspackages/core/agent41-142 · AGENT-INBOX-TEST
258-298 · AGENT-REGISTRY-TEST
packages/core/agent/tests/consumed-work.spec.tspackages/core/agent38-158 · INBOX-CONSUMED-WORK-TEST
packages/core/scope/src/store.tspackages/core/scope153-266 · DESIGN-SCOPED-LAYERS
packages/core/scope/tests/scope.spec.tspackages/core/scope24-220 · DESIGN-SCOPE-TEST
packages/core/session/src/index.tspackages/core/session499-547 · SESSION-SEED-ACCEPTANCE
550-654 · SESSION-APPEND-COMMIT
700-747 · SESSION-DERIVED-CACHE
1067-1153 · LOG-CORE-FORK
packages/core/session/src/invariant.tspackages/core/session22-165 · TINV-SESSION-RULES
54-165 · SESSION-RELATIONAL-INVARIANT
189-250 · SESSION-INVARIANT-COMMIT
189-242 · TINV-SESSION-COMMIT
packages/core/session/src/json.tspackages/core/session69-178 · SESSION-LOSSLESS-JSON
packages/core/session/src/known-event-types.tspackages/core/session9-64 · SESSION-KNOWN-EVENTS
packages/core/session/src/repair.tspackages/core/session18-132 · FAILURE-CRASH-REPAIR
18-132 · LOG-REPAIR-CLOSERS
packages/core/session/src/request-header.tspackages/core/session14-70 · PROMPT-HEADER-CANONICAL
packages/core/session/src/surface.tspackages/core/session70-142 · SESSION-SURFACE-PROJECTION
184-243 · SESSION-SURFACE-PROVENANCE
245-379 · SESSION-SURFACE-REPLACE
packages/core/session/src/types.tspackages/core/session33-99 · SESSION-FORMAT-HEADER
152-309 · OBS-SESSION-LOG
230-332 · SESSION-CORE-EVENTS
335-435 · SESSION-EVENT-ENVELOPE
packages/core/session/tests/derived-cache.spec.tspackages/core/session22-86 · SESSION-DERIVED-ORACLE-TEST
packages/core/session/tests/fork.spec.tspackages/core/session63-318 · LOG-FORK-CONTRACT
packages/core/session/tests/invariant.spec.tspackages/core/session34-116 · TINV-SESSION-TEST
packages/core/session/tests/session.spec.tspackages/core/session116-155 · SESSION-SEED-REPLAY-TEST
437-495 · SESSION-IMMUTABILITY-TEST
1388-1507 · SESSION-APPEND-BOUNDARY-TEST
packages/core/system-prompt/src/index.tspackages/core/system-prompt139-183 · PROMPT-TOOL-ORDER
204-294 · PROMPT-STRICT-RENDER
337-455 · PROMPT-REGISTRY-CONTRACT
467-541 · PROMPT-ASSEMBLY-PIPELINE
packages/core/system-prompt/tests/scoped.spec.tspackages/core/system-prompt32-79 · PROMPT-SCOPE-SHADOW
packages/core/system-prompt/tests/system-prompt.spec.tspackages/core/system-prompt212-333 · PROMPT-ASSEMBLY-MUTATION-TEST
449-580 · PROMPT-VARIABLE-TEST
packages/core/tools/README.mdpackages/core/tools119-130 · PARALLEL-README
packages/core/tools/src/code-mode.tspackages/core/tools1-6 · CODEMODE-HISTORY
283-340 · CODEMODE-RUN-SCHEMA
328-457 · PARALLEL-CODE-DRIVER
342-457 · CODEMODE-SCHEDULER
448-629 · PARALLEL-CODE-DRAIN
464-594 · CODEMODE-NESTED-DISPATCH
464-594 · PARALLEL-CODE-BINDING
596-640 · CODEMODE-BINDINGS
packages/core/tools/src/index.tspackages/core/tools212-301 · TOOL-DEFINITION
257-269 · PARALLEL-MODE-CONTRACT
304-472 · TOOL-EXECUTION-IDENTITY
426-466 · PARALLEL-PIPELINE-SPLIT
555-600 · TOOL-RESULT-TYPES
580-711 · TOOL-DECISIONS
582-592 · APPROVAL-PRE-DECISION
650-673 · CODEMODE-MODES
650-1001 · TOOL-PRESENTATION-MODES
703-753 · APPROVAL-GUARD-CONTRACT
865-891 · CODEMODE-SDK-LIVE
894-973 · CODEMODE-SCOPE
913-933 · CODEMODE-TRANSPORT
976-1028 · CODEMODE-WIRE
1003-1028 · CODEMODE-RUNTIME-READS
1003-1028 · TOOL-CODE-RUNTIME-WINDOW
1030-1061 · TOOL-REGISTRATION
1031-1061 · SEC-RAW-TOOL-REGISTER
1064-1226 · TOOL-SCOPE-VIEW
1100-1127 · APPROVAL-GUARD-REGISTRY
1208-1253 · CODEMODE-EXECUTION
1228-1285 · TOOL-SCHEMA-PROJECTION
1269-1285 · PARALLEL-CLASSIFIER
1269-1285 · PLANSTATE-TOOL-EXCLUSIVE
1328-1506 · TOOL-PIPELINE-PREPARE
1364-1423 · APPROVAL-EXEC-SNAPSHOT
1364-1450 · SEC-TOOL-ARG-SNAPSHOT
1453-1506 · APPROVAL-PREPARE-ORDER
1453-1599 · CODEMODE-POLICY
1453-1507 · PARALLEL-PREPARE
1453-1506 · SEC-TOOL-GATE
1459-1559 · APPROVAL-CANCEL-DISPATCH
1527-1599 · PARALLEL-DISPATCH
1527-1599 · TOOL-PIPELINE-DISPATCH
1569-1577 · FAILURE-CHECKPOINT-TOOL-WRAPPER
1601-1675 · PARALLEL-FINALIZE
1601-1675 · TOOL-PIPELINE-FINALIZE
1656-1675 · PARALLEL-RESULT-OBSERVER
1678-1728 · APPROVAL-ASK-MAPPING
1731-1781 · TOOL-POST-POLICY
1783-1862 · TOOL-CANONICAL-OUTPUT
1880-1944 · TOOL-CANCELLATION
packages/core/tools/src/invariant.tspackages/core/tools17-120 · TOOL-RUNTIME-INVARIANT
packages/core/tools/src/json-schema.tspackages/core/tools1-430 · TOOL-SCHEMA-SUBSET
packages/core/tools/src/presentation.tspackages/core/tools1-388 · TOOL-PRESENTATION-INTENTS
packages/core/tools/src/schema.tspackages/core/tools538-617 · SEC-TOOL-DEFINE
538-616 · TOOL-DEFINE-HELPER
545-615 · PARALLEL-TYPED-CLASSIFIER
packages/core/tools/tests/code-mode.spec.tspackages/core/tools118-160 · CODEMODE-TEST-PRESENTATION
509-799 · CODEMODE-TEST-SCHEDULER
509-730 · PARALLEL-CODE-TESTS
731-765 · PARALLEL-CODE-ORDER-TEST
935-1206 · CODEMODE-TEST-POLICY-FAILURE
packages/core/tools/tests/scoped.spec.tspackages/core/tools284-375 · APPROVAL-GUARD-TESTS
packages/core/tools/tests/tools.spec.tspackages/core/tools676-853 · APPROVAL-TOOLS-TESTS
packages/credentials/credentials-local/src/index.tspackages/credentials/credentials-local1-34 · SEC-CREDENTIAL-LAYERS
87-185 · SEC-CREDENTIAL-FILE
249-380 · SEC-CREDENTIAL-RESOLVE
packages/credentials/credentials/src/index.tspackages/credentials/credentials1-99 · SEC-CREDENTIAL-SEAM
packages/e2b/e2b/src/index.tspackages/e2b/e2b1-179 · SEC-E2B-OWNER
22-179 · SANDBOX-E2B-OWNER
packages/e2b/fs-e2b/README.mdpackages/e2b/fs-e2b26-32 · SANDBOX-E2B-LIMITS
26-32 · SEC-E2B-LIMITS
packages/e2b/fs-e2b/src/index.tspackages/e2b/fs-e2b170-454 · SANDBOX-E2B-FS
510-579 · SANDBOX-E2B-PUBLICATION
packages/e2b/subprocess-e2b/src/index.tspackages/e2b/subprocess-e2b51-205 · SHELL-E2B-SEAM
103-204 · SANDBOX-E2B-SUBPROCESS
packages/e2b/subprocess-e2b/src/process.tspackages/e2b/subprocess-e2b93-665 · SANDBOX-E2B-PGID
packages/extensions/cordis-client-runner/src/client/evaluator.tspackages/extensions/cordis-client-runner1-222 · SEC-DYNAMIC-CLIENT
157-222 · CODEMODE-CLIENT-EVAL
packages/extensions/cordis-client-runner/src/client/guard.tspackages/extensions/cordis-client-runner180-233 · CODEMODE-CLIENT-GUARD
packages/extensions/cordis-client-runner/src/client/orchestrator.tspackages/extensions/cordis-client-runner312-381 · CODEMODE-CLIENT-ORCHESTRATION
packages/extensions/cordis-client-runner/src/client/runtime.tspackages/extensions/cordis-client-runner176-341 · CODEMODE-CLIENT-LIFECYCLE
packages/extensions/cordis-client-runner/tests/runner.client.spec.tspackages/extensions/cordis-client-runner201-344 · CODEMODE-TEST-CLIENT-LIFECYCLE
packages/extensions/cordis-host-runner/src/guard.tspackages/extensions/cordis-host-runner542-655 · CODEMODE-DYNAMIC-TOOL-GUARD
620-819 · SEC-DYNAMIC-GUARD
680-819 · CODEMODE-CONTEXT-GUARD
packages/extensions/cordis-host-runner/src/index.tspackages/extensions/cordis-host-runner146-202 · CODEMODE-DEFINE-RUNNER
238-374 · CODEMODE-RUN-APPROVAL
238-312 · SEC-DYNAMIC-RUN
406-428 · CODEMODE-APPROVAL-SETTLE
810-992 · CODEMODE-ACTIVATION
1019-1047 · CODEMODE-OUTCOME-STEERING
1219-1239 · CODEMODE-RETRACT
packages/extensions/cordis-host-runner/src/inspect-registry.tspackages/extensions/cordis-host-runner98-198 · CODEMODE-INSPECT-REGISTRY
packages/extensions/cordis-host-runner/src/registry.tspackages/extensions/cordis-host-runner16-82 · CODEMODE-REGISTRY
packages/extensions/cordis-host-runner/src/sandbox.tspackages/extensions/cordis-host-runner1-11 · CODEMODE-HOST-SANDBOX
1-11 · SEC-DYNAMIC-VM
196-238 · CODEMODE-HOST-CODE
packages/extensions/cordis-host-runner/tests/runner.spec.tspackages/extensions/cordis-host-runner98-247 · CODEMODE-TEST-DYNAMIC-RUNNER
packages/extensions/cordis-host-runner/tests/sandbox-context.spec.tspackages/extensions/cordis-host-runner44-246 · CODEMODE-TEST-DYNAMIC-GUARD
packages/extensions/cordis-host-runner/tests/versioning.spec.tspackages/extensions/cordis-host-runner1-106 · CODEMODE-TEST-VERSIONING
packages/extensions/tool-cordis/README.mdpackages/extensions/tool-cordis5-27 · CODEMODE-README-DRIFT
11-23 · SEC-DYNAMIC-ROOT-SCOPE
packages/extensions/tool-cordis/src/index.tspackages/extensions/tool-cordis34-146 · CODEMODE-CORDIS-INSPECT
148-238 · CODEMODE-CORDIS-DEFINE
240-379 · CODEMODE-CORDIS-LIFECYCLE-TOOLS
497-529 · CODEMODE-REFERENCE
packages/extensions/tool-cordis/src/prompt.tspackages/extensions/tool-cordis3-54 · CODEMODE-CORDIS-PROMPT
packages/feedback/command-feedback/src/index.tspackages/feedback/command-feedback1-106 · OBS-FEEDBACK-DISCLOSURE
packages/feedback/message-feedback/README.mdpackages/feedback/message-feedback76-84 · OPEN-FEEDBACK-CONSISTENCY
packages/fs/fs-local/README.mdpackages/fs/fs-local36-45 · SEC-FS-LOCAL-LIMITS
40-45 · SANDBOX-FS-LOCAL-LIMITS
packages/fs/fs-local/src/fsio.tspackages/fs/fs-local17-463 · SANDBOX-FS-READ-IO
105-194 · SANDBOX-FS-IDENTITY
518-615 · SANDBOX-FS-ATOMIC
packages/fs/fs-local/src/index.tspackages/fs/fs-local40-123 · SANDBOX-FS-LOCAL
70-255 · SANDBOX-FS-LOCAL-MUTATION
packages/fs/fs-observation-policy/README.mdpackages/fs/fs-observation-policy30-50 · SANDBOX-OBSERVATION-DOC
68-73 · SANDBOX-OBSERVATION-LIMITS
68-73 · SEC-OBSERVATION-LIMITS
packages/fs/fs-observation-policy/src/index.tspackages/fs/fs-observation-policy17-130 · SANDBOX-OBSERVATION
packages/fs/fs-observation-policy/tests/policy.spec.tspackages/fs/fs-observation-policy47-235 · SANDBOX-OBSERVATION-TEST
packages/fs/fs-sandbox/src/containment.tspackages/fs/fs-sandbox19-76 · SANDBOX-CONTAINMENT
packages/fs/fs-sandbox/src/index.tspackages/fs/fs-sandbox1-149 · SANDBOX-FS-FENCE
1-149 · SEC-FS-FENCE
packages/fs/fs-sandbox/tests/fs-sandbox.spec.tspackages/fs/fs-sandbox59-235 · SANDBOX-FS-FENCE-TEST
packages/fs/fs/README.mdpackages/fs/fs49-51 · SANDBOX-DOC-ERROR-CODE
packages/fs/fs/src/index.tspackages/fs/fs44-249 · SANDBOX-FS-SEAM
packages/fs/fs/src/types.tspackages/fs/fs11-203 · SANDBOX-FS-TYPES
packages/fs/tool-fs-search/src/index.tspackages/fs/tool-fs-search1-24 · SANDBOX-SEARCH-WORLD
packages/fs/tool-fs/src/edit.tspackages/fs/tool-fs112-146 · SANDBOX-EDIT-TOOL
packages/fs/tool-fs/src/read-target.tspackages/fs/tool-fs12-34 · SANDBOX-READ-TARGET
packages/fs/tool-fs/src/read.tspackages/fs/tool-fs134-163 · SANDBOX-READ-TOOL
packages/fs/tool-fs/src/sandbox.tspackages/fs/tool-fs20-130 · SANDBOX-FS-ESCALATION
37-130 · APPROVAL-FS-ESCALATION
packages/fs/tool-fs/src/session-cwd.tspackages/fs/tool-fs16-46 · SANDBOX-SESSION-CWD
packages/fs/tool-fs/src/write.tspackages/fs/tool-fs102-128 · SANDBOX-WRITE-TOOL
packages/goal/command-goal/README.mdpackages/goal/command-goal53-58 · PLANSTATE-DOC-GOAL-COMMAND
packages/goal/command-goal/src/index.tspackages/goal/command-goal14-170 · PLANSTATE-GOAL-COMMAND
packages/goal/goal-round-driver/src/index.tspackages/goal/goal-round-driver75-445 · PLANSTATE-GOAL-DRIVER
packages/goal/goal-round-driver/tests/goal-round-driver.spec.tspackages/goal/goal-round-driver186-260 · PLANSTATE-GOAL-DRIVER-TEST
465-510 · PLANSTATE-GOAL-DURABILITY-TEST
packages/goal/goal/src/fold.tspackages/goal/goal271-349 · PLANSTATE-GOAL-FOLD
packages/goal/goal/src/index.tspackages/goal/goal83-113 · PLANSTATE-GOAL-PROJECTION
216-390 · PLANSTATE-GOAL-SERVICE
392-577 · PLANSTATE-GOAL-COMMIT
packages/goal/goal/src/types.tspackages/goal/goal15-110 · PLANSTATE-GOAL-TYPES
packages/goal/goal/tests/projection.spec.tspackages/goal/goal142-187 · PLANSTATE-GOAL-PROJECTION-TEST
packages/goal/tool-goal/README.mdpackages/goal/tool-goal13-18 · PLANSTATE-DOC-GOAL-TOOL
packages/goal/tool-goal/src/authority.tspackages/goal/tool-goal29-108 · PLANSTATE-GOAL-AUTHORITY
packages/goal/tool-goal/src/index.tspackages/goal/tool-goal186-338 · PLANSTATE-GOAL-TOOLS
packages/goal/tool-goal/tests/tool-goal.spec.tspackages/goal/tool-goal352-415 · PLANSTATE-GOAL-WRAPUP-TEST
packages/guard/timeout-policy/src/index.tspackages/guard/timeout-policy18-80 · FAILURE-TOOL-TIMEOUT
packages/guard/timeout-policy/tests/timeout-policy.spec.tspackages/guard/timeout-policy97-193 · FAILURE-TIMEOUT-TEST
packages/host/apiproxy/README.mdpackages/host/apiproxy41-41 · INBOX-README-DRIFT
75-81 · APPROVAL-DOC-API-DRIFT
packages/host/apiproxy/src/api-proxy.tspackages/host/apiproxy282-313 · LOG-HISTORY-PAGINATION
735-779 · TOOL-HOST-PRESENTER
804-820 · LOG-HISTORY-VIEW
841-877 · PROJ-CACHE-INTEGRATION
847-898 · OBS-PROJECTION-DEGRADE
1273-1323 · PROJ-HOST-CARRIER
1302-1323 · PROJ-IMAGE-LIMITS
1326-1355 · INBOX-HOST-PROJECTION
1407-1488 · APPROVAL-WEB-REGISTRY
1525-1573 · PROJ-HOST-COLD-OPEN
1533-1574 · LOG-HISTORY-CUT
1555-1573 · OBS-SESSION-HISTORY-PROJECTION
1720-2162 · MEMORY-WEB-HOST-GATE
1720-1764 · OBS-SESSION-LIST-PROJECTION
1787-1825 · PLANSTATE-GOAL-API-ERRORS
2242-2269 · PROJ-HISTORY-FAILURE
2363-2458 · LOG-HOST-FORK
2461-2517 · INBOX-HOST-PROMPT
2568-2633 · INBOX-HOST-QUEUE-MUTATION
2668-2696 · OBS-SUBAGENT-HISTORY-PROJECTION
2737-2799 · INBOX-SUBAGENT-HOST
2923-2938 · API-HOST-VERSION-PLACEHOLDER
2923-2938 · OPEN-HOST-VERSION-IMPL
3205-3257 · MEMORY-SKILL-HOST-UI
3429-3447 · APPROVAL-WEB-REPLAY
3430-3455 · INBOX-RECONNECT-HOST
3617-3635 · REMOTE-EVENT-FORWARD
3696-3742 · APPROVAL-WEB-RESPOND
packages/host/apiproxy/src/api/approvals.tspackages/host/apiproxy1-20 · APPROVAL-WIRE-CONTRACT
packages/host/apiproxy/src/api/events.tspackages/host/apiproxy36-84 · INBOX-WIRE-DOC-DRIFT
46-56 · OPEN-EVENT-RESUME-SEAT
65-154 · OBS-RAW-FRAMES
110-154 · OBS-HOST-FAILURE
packages/host/apiproxy/src/api/goals.tspackages/host/apiproxy25-53 · PLANSTATE-GOAL-API
packages/host/apiproxy/src/api/host.tspackages/host/apiproxy1-53 · API-HOST-VERSION-CONTRACT
35-53 · OPEN-HOST-VERSION-CONTRACT
packages/host/apiproxy/src/api/rpc.schema.tspackages/host/apiproxy1-140 · API-RPC-SCHEMAS
packages/host/apiproxy/src/api/rpc.tspackages/host/apiproxy1-193 · API-RPC-MODEL
packages/host/apiproxy/src/api/sessions.schema.tspackages/host/apiproxy141-242 · LOG-HISTORY-SCHEMA
packages/host/apiproxy/src/api/sessions.tspackages/host/apiproxy59-338 · LOG-HISTORY-CONTRACT
231-240 · OPEN-API-RESERVED-SEATS
264-283 · OBS-HISTORY-API
315-371 · INBOX-HOST-CONTRACT
packages/host/apiproxy/src/api/subagents.tspackages/host/apiproxy38-119 · INBOX-SUBAGENT-WIRE
packages/host/apiproxy/src/session-export.tspackages/host/apiproxy1-265 · LOG-RAW-EXPORT
packages/host/apiproxy/tests/api-proxy-approval.spec.tspackages/host/apiproxy87-329 · APPROVAL-WEB-TESTS
packages/identity/anonymous-user-id/src/index.tspackages/identity/anonymous-user-id1-100 · OBS-ANON-ID
packages/interaction/permission-presets/README.mdpackages/interaction/permission-presets5-17 · APPROVAL-DOC-PRESET-DRIFT
packages/interaction/permission-presets/src/index.tspackages/interaction/permission-presets139-225 · APPROVAL-PRESET-CONFIG
139-225 · SANDBOX-PERMISSION-PRESETS
155-225 · SEC-PRESETS-VALIDATE
227-277 · APPROVAL-PRESET-PROJECTION
280-338 · APPROVAL-PRESET-DERIVE
369-392 · APPROVAL-PRESET-WRITE
369-430 · SANDBOX-PERMISSION-WRITE
379-430 · SEC-PRESETS-PIN
394-430 · APPROVAL-PRESET-PIN
packages/interaction/permission-presets/tests/permission-presets.spec.tspackages/interaction/permission-presets67-300 · APPROVAL-PRESET-TESTS
packages/interaction/user-approval/src/index.tspackages/interaction/user-approval34-72 · APPROVAL-AUDIT-EVENTS
149-174 · APPROVAL-REQUEST-SHAPE
239-276 · APPROVAL-AUDIT-REQUEST
239-343 · SEC-APPROVAL-CLOSED
298-344 · APPROVAL-DECIDE-WATERFALL
packages/interaction/user-approval/src/invariant.tspackages/interaction/user-approval17-102 · APPROVAL-INVARIANT
packages/interaction/user-approval/src/types.tspackages/interaction/user-approval10-29 · APPROVAL-OUTCOMES
packages/interaction/user-approval/tests/approval.spec.tspackages/interaction/user-approval42-503 · APPROVAL-SERVICE-TESTS
packages/interaction/user-questions/src/index.tspackages/interaction/user-questions80-139 · PLANSTATE-PLAN-REVIEW-AUTH
packages/jobs/jobs-local/src/index.tspackages/jobs/jobs-local86-190 · SHELL-JOBS-START
126-150 · MULTIAGENT-JOB-CAPACITY
307-440 · SHELL-JOBS-SETTLEMENT
442-528 · SHELL-JOBS-CLEANUP
packages/jobs/tool-jobs/src/index.tspackages/jobs/tool-jobs205-300 · SHELL-JOB-NOTICES
302-401 · SHELL-JOB-TOOLS
packages/llm/llm-deepseek/src/adapter.tspackages/llm/llm-deepseek88-211 · LLM-DEEPSEEK-MODELS
117-338 · FAILURE-DEEPSEEK-HTTP
214-268 · FAILURE-DEEPSEEK-STREAM
214-345 · LLM-DEEPSEEK-TRANSPORT
214-345 · SEC-PROVIDER-TRANSPORT
packages/llm/llm-deepseek/src/index.tspackages/llm/llm-deepseek91-256 · FAILURE-CONFIG-RESOLUTION
149-275 · LLM-DEEPSEEK-CONFIG
149-246 · SEC-PROVIDER-CONFIG
225-275 · FAILURE-CREDENTIAL-ROUTE
packages/llm/llm-deepseek/src/serialize.tspackages/llm/llm-deepseek25-186 · LLM-DEEPSEEK-SERIALIZE
143-186 · PROMPT-DEEPSEEK-WIRE
packages/llm/llm-deepseek/src/translate.tspackages/llm/llm-deepseek26-184 · LLM-DEEPSEEK-TRANSLATE
packages/llm/llm-deepseek/tests/dynamic-config.spec.tspackages/llm/llm-deepseek61-186 · FAILURE-DYNAMIC-CONFIG-TEST
packages/llm/llm-pi-ai/src/adapter.tspackages/llm/llm-pi-ai217-357 · LLM-PI-STREAM
packages/llm/llm-pi-ai/src/config.tspackages/llm/llm-pi-ai34-178 · LLM-PI-CONFIG
packages/llm/llm-pi-ai/src/provider.tspackages/llm/llm-pi-ai35-191 · LLM-PI-PROVIDER
packages/llm/llm-pi-ai/src/replay.tspackages/llm/llm-pi-ai15-215 · LLM-PI-REPLAY
packages/llm/llm-retry/README.mdpackages/llm/llm-retry1-13 · FAILURE-RETRY-DOC-DRIFT
1-53 · LLM-RETRY-DOC-DRIFT
packages/llm/llm-retry/src/index.tspackages/llm/llm-retry99-225 · FAILURE-RETRY-EXECUTOR
111-225 · LLM-RETRY-EXECUTOR
packages/llm/llm-retry/tests/retry.spec.tspackages/llm/llm-retry175-344 · FAILURE-RETRY-SEMANTICS-TEST
175-224 · LLM-RETRY-SAME-STEP-TEST
packages/llm/llm-retry/tests/transport-recovery.spec.tspackages/llm/llm-retry85-219 · FAILURE-WIRE-RECOVERY-TEST
112-198 · LLM-RETRY-WIRE-TEST
packages/llm/llm/src/adapter-failure.tspackages/llm/llm16-104 · FAILURE-SNAPSHOT
packages/llm/llm/src/assembler.tspackages/llm/llm25-163 · LLM-BLOCK-ASSEMBLER
packages/llm/llm/src/index.tspackages/llm/llm330-413 · LLM-ADAPTER-REGISTRY
771-814 · LLM-PREPARED-CALL
838-938 · FAILURE-ADAPTER-BOUNDARY
838-938 · LLM-FAILURE-BOUNDARY
packages/llm/llm/src/message.tspackages/llm/llm7-18 · LLM-MESSAGE-IDENTITY
96-199 · INBOX-MESSAGE-IDENTITY
128-184 · LLM-MESSAGE-VALUE
packages/llm/llm/src/retry-policy.tspackages/llm/llm14-191 · FAILURE-RETRY-POLICY
14-191 · LLM-RETRY-POLICY
packages/llm/llm/src/types.tspackages/llm/llm53-141 · LLM-CONTENT-PROTOCOL
283-355 · LLM-STREAM-PROTOCOL
packages/llm/llm/tests/service.spec.tspackages/llm/llm227-257 · LLM-PREPARED-PIN-TEST
packages/llm/token-meter/src/estimate.tspackages/llm/token-meter12-87 · COMPACT-ESTIMATOR
packages/llm/token-meter/src/index.tspackages/llm/token-meter100-180 · COMPACT-TOKEN-MEASURE
188-310 · COMPACT-TOKEN-ANCHOR
packages/llm/token-meter/src/surface-projection.tspackages/llm/token-meter1-94 · COMPACT-SHADOW-PRICE
packages/llm/token-meter/src/usage-projection.tspackages/llm/token-meter70-205 · COMPACT-USAGE-PROJECTION
97-140 · LLM-TOKEN-USAGE-PROJECTION
packages/lsp/lsp-stdio/src/host.tspackages/lsp/lsp-stdio25-120 · CAP-LSP-HOST-FS
packages/lsp/lsp-stdio/src/index.tspackages/lsp/lsp-stdio119-215 · CAP-LSP-STDIO-LOAD
216-369 · CAP-LSP-STDIO-POOL
packages/lsp/lsp/src/index.tspackages/lsp/lsp1-158 · CAP-LSP-REGISTRY
packages/lsp/tool-lsp/src/index.tspackages/lsp/tool-lsp1-243 · CAP-LSP-TOOL
packages/mcp/mcp-client/README.mdpackages/mcp/mcp-client109-115 · CAP-MCP-LIMITS
packages/mcp/mcp-client/src/connection.tspackages/mcp/mcp-client123-224 · CAP-MCP-RECONNECT
227-350 · CAP-MCP-GENERATION
packages/mcp/mcp-client/src/index.tspackages/mcp/mcp-client1-128 · CAP-MCP-CONFIG
132-180 · CAP-MCP-STARTUP
packages/mcp/mcp-client/src/tools.tspackages/mcp/mcp-client82-102 · CAP-MCP-NAMING
104-174 · CAP-MCP-SYNC
128-173 · SEC-MCP-SYNC
176-317 · CAP-MCP-RESULT
218-277 · SEC-MCP-EXEC
packages/mcp/mcp-client/src/transport.tspackages/mcp/mcp-client1-49 · SEC-MCP-TRANSPORT
15-50 · CAP-MCP-TRANSPORT
packages/plan/plan-mode/README.mdpackages/plan/plan-mode92-98 · PLANSTATE-PLAN-LIMITATION
packages/plan/plan-mode/src/index.tspackages/plan/plan-mode46-195 · PLANSTATE-PLAN-STATE
197-233 · PLANSTATE-PLAN-ASSEMBLY
235-266 · PLANSTATE-PLAN-PROJECTION
268-393 · PLANSTATE-PLAN-CONTROLS
396-473 · PLANSTATE-PLAN-BOUNDARY
packages/plan/plan-mode/tests/integration.spec.tspackages/plan/plan-mode66-174 · PLANSTATE-PLAN-LOOP-TEST
packages/preset/agent-presets/src/index.tspackages/preset/agent-presets290-325 · MULTIAGENT-PRESET-INHERITANCE
packages/README.mdpackages-unmatched5-67 · PKG-HIERARCHY
packages/runtime-diagnostics/invariants/src/index.tspackages/runtime-diagnostics/invariants49-197 · TINV-REGISTRY
93-197 · DESIGN-INVARIANT-REGISTRY
packages/runtime-diagnostics/invariants/tests/service.spec.tspackages/runtime-diagnostics/invariants189-302 · TINV-REGISTRY-TEST
packages/sandbox/sandbox-local/README.mdpackages/sandbox/sandbox-local1-15 · OPEN-SANDBOX-PLATFORM-LADDER
34-40 · OPEN-SANDBOX-PLATFORM-LIMITS
packages/sandbox/sandbox-local/src/index.tspackages/sandbox/sandbox-local150-240 · SANDBOX-LOCAL-DIALECTS
150-240 · SEC-LOCAL-RUNNERS
276-333 · SANDBOX-LOCAL-WRAP
276-333 · SEC-CUSTOM-RUNNER
485-539 · SANDBOX-LOCAL-SELECT
500-527 · SEC-LANDLOCK-PROBE
packages/sandbox/sandbox-local/src/profiles.tspackages/sandbox/sandbox-local11-58 · SANDBOX-PROFILES
packages/sandbox/sandbox-local/tests/local.spec.tspackages/sandbox/sandbox-local64-453 · SANDBOX-LOCAL-TEST
packages/sandbox/sandbox-policy/src/index.tspackages/sandbox/sandbox-policy60-150 · SANDBOX-POLICY
126-150 · APPROVAL-SANDBOX-PRECEDENCE
packages/sandbox/sandbox-policy/src/session-mode.tspackages/sandbox/sandbox-policy24-71 · SANDBOX-MODE-EVENT
packages/sandbox/sandbox-windows-acl/README.mdpackages/sandbox/sandbox-windows-acl73-82 · SANDBOX-WINDOWS-CAPS
packages/sandbox/sandbox/README.mdpackages/sandbox/sandbox5-26 · OPEN-SANDBOX-DOC-OMISSION
11-13 · SANDBOX-DOC-BACKENDS
37-43 · OPEN-SANDBOX-SCOPE
37-43 · SANDBOX-DOC-BOUNDARY
37-43 · SEC-SANDBOX-SCOPE
packages/sandbox/sandbox/src/escalation.tspackages/sandbox/sandbox22-61 · APPROVAL-ESCALATION-LADDER
22-187 · SANDBOX-ESCALATION
143-188 · APPROVAL-ESCALATION-FLOW
143-188 · SEC-ESCALATION
packages/sandbox/sandbox/src/index.tspackages/sandbox/sandbox23-175 · SANDBOX-SEAM
23-175 · SEC-SANDBOX-SEAM
packages/sandbox/sandbox/src/roots.tspackages/sandbox/sandbox20-55 · SANDBOX-WRITABLE-ROOTS
packages/sandbox/sandbox/tests/escalation.spec.tspackages/sandbox/sandbox20-111 · APPROVAL-ESCALATION-TESTS
packages/sdk/client/src/api.tspackages/sdk/client139-245 · SDK-TS-RUN
packages/sdk/client/src/client.tspackages/sdk/client55-290 · SDK-DOC-STALE-ACCEPTED
175-401 · SDK-TS-CLIENT
175-260 · SEC-SDK-CLIENT
354-370 · SEC-SDK-FILTER
packages/sdk/client/src/dispose.tspackages/sdk/client13-99 · SDK-TS-DISPOSE
packages/sdk/client/src/types.tspackages/sdk/client22-70 · SDK-TS-RESULT
packages/sdk/protocol/README.mdpackages/sdk/protocol35-39 · SDK-WIRE-LIMITS
packages/sdk/protocol/src/transport.tspackages/sdk/protocol1-268 · SDK-JSONL-TRANSPORT
packages/sdk/protocol/src/types.tspackages/sdk/protocol15-105 · SDK-WIRE-METHODS
packages/sdk/protocol/tests/transport.spec.tspackages/sdk/protocol1-307 · TEST-SDK-PROTOCOL
packages/sdk/server/src/index.tspackages/sdk/server40-91 · SDK-SERVER-SHUTDOWN
packages/sdk/server/src/server.tspackages/sdk/server48-103 · SDK-SERVER-EVENTS
48-201 · SDK-SERVER-INIT
48-124 · SEC-SDK-SERVER
127-239 · SDK-SERVER-SESSIONS
packages/session-query/session-query-sqlite/src/index.tspackages/session-query/session-query-sqlite85-331 · MEMORY-QUERY-SQLITE-MODE
packages/session-query/session-query-sqlite/src/schema.tspackages/session-query/session-query-sqlite27-169 · MEMORY-QUERY-SQLITE-SCHEMA
packages/session-query/session-query/src/corpus.tspackages/session-query/session-query31-116 · OBS-QUERY-CORPUS
53-220 · MEMORY-QUERY-CORPUS
packages/session-query/session-query/src/documents.tspackages/session-query/session-query15-74 · MEMORY-QUERY-DOCUMENTS
packages/session-query/session-query/src/extraction.tspackages/session-query/session-query13-82 · MEMORY-QUERY-EXTRACTION
packages/session-query/session-query/src/index.tspackages/session-query/session-query74-345 · OBS-QUERY-SERVICE
packages/session-query/session-query/src/tracing.tspackages/session-query/session-query21-218 · LOG-QUERY-TRACE
21-213 · OBS-QUERY-TRACE
packages/session-query/tool-session-query/README.mdpackages/session-query/tool-session-query5-20 · MEMORY-QUERY-TOOL-CONTRACT
5-76 · OBS-QUERY-TOOLS
packages/session-query/tool-session-query/src/operations.tspackages/session-query/tool-session-query116-166 · OBS-QUERY-CURRENT-BOUNDARY
packages/session-query/tool-session-query/src/service-boundary.tspackages/session-query/tool-session-query19-171 · OBS-QUERY-SANITIZE
116-171 · OBS-QUERY-DIAGNOSTIC
packages/session-query/tool-session-query/src/workspace-access.tspackages/session-query/tool-session-query54-233 · MEMORY-QUERY-TOOL-AUTH
54-203 · OBS-QUERY-AUTH
packages/session/session-checkpoint-policy/README.mdpackages/session/session-checkpoint-policy5-45 · OPEN-CHECKPOINT-UNKNOWN
packages/session/session-checkpoint-policy/src/index.tspackages/session/session-checkpoint-policy20-82 · FAILURE-CHECKPOINT-POLICY
20-82 · INBOX-CHECKPOINT-POLICY
20-82 · LLM-CHECKPOINT-BARRIER
20-82 · LOG-CHECKPOINT-POLICY
packages/session/session-checkpoint-policy/tests/crash-recovery.e2e.tspackages/session/session-checkpoint-policy39-110 · FAILURE-CRASH-E2E
82-110 · INBOX-CRASH-RECOVERY
packages/session/session-checkpoint-policy/tests/fixtures/crash-child.tspackages/session/session-checkpoint-policy21-60 · FAILURE-CRASH-FIXTURE
packages/session/session-checkpoint-policy/tests/session-checkpoint-policy.spec.tspackages/session/session-checkpoint-policy62-238 · FAILURE-CHECKPOINT-TEST
packages/session/session-persistence-jsonl/README.mdpackages/session/session-persistence-jsonl40-52 · INBOX-JSONL-DURABILITY
packages/session/session-persistence-jsonl/src/format.tspackages/session/session-persistence-jsonl28-223 · PERSIST-JSONL-FORMAT
272-377 · FAILURE-JSONL-RAW-SCAN
272-388 · PERSIST-JSONL-SCAN
packages/session/session-persistence-jsonl/src/index.tspackages/session/session-persistence-jsonl115-200 · PERSIST-JSONL-ROOT
306-444 · FAILURE-JSONL-PREFIX
306-701 · PERSIST-JSONL-REPAIR
511-701 · FAILURE-JSONL-ATOMICITY
528-615 · MEMORY-JSONL-PERMISSIONS
packages/session/session-persistence-jsonl/src/win32.tspackages/session/session-persistence-jsonl109-120 · FAILURE-JSONL-WIN32
packages/session/session-persistence-jsonl/src/zstd.tspackages/session/session-persistence-jsonl48-103 · FAILURE-JSONL-ZSTD-SCAN
packages/session/session-persistence-jsonl/tests/jsonl.spec.tspackages/session/session-persistence-jsonl102-115 · FAILURE-CRASH-CONTRACT-JSONL
585-674 · FAILURE-JSONL-TEST
packages/session/session-persistence-sqlite/src/index.tspackages/session/session-persistence-sqlite69-146 · PERSIST-SESSION-SQLITE-CONSTRUCTOR
220-237 · PERSIST-SQLITE-SUFFIX
278-338 · PERSIST-SQLITE-REPAIR
packages/session/session-persistence-sqlite/src/schema.tspackages/session/session-persistence-sqlite15-171 · PERSIST-SQLITE-SCHEMA
220-269 · PERSIST-SQLITE-SCAN
packages/session/session-persistence-sqlite/tests/sqlite.spec.tspackages/session/session-persistence-sqlite51-60 · FAILURE-CRASH-CONTRACT-SQLITE
677-691 · PERSIST-SESSION-SQLITE-CONSTRUCTOR-TEST
packages/session/session-persistence/src/coordinator.tspackages/session/session-persistence117-214 · PERSIST-BACKEND-CONTRACT
575-710 · PERSIST-COORDINATOR
690-774 · MEMORY-PERSISTENCE-TRANSACTION
712-970 · PERSIST-READ-FACES
720-889 · LOG-PERSISTENCE-READ-FACES
891-990 · LOG-PREPARED-COMMIT
1046-1065 · SESSION-UNKNOWN-EVENT-GATE
1084-1161 · FAILURE-PERSISTENCE-WIRING
1084-1181 · LOG-PERSISTENCE-ADMISSION
1117-1160 · MEMORY-PERSISTENCE-FLUSH
1325-1350 · OBS-PERSISTENCE-DIAGNOSTIC
packages/session/session-persistence/src/index.tspackages/session/session-persistence1-240 · PERSIST-SEAM-API
packages/session/session-persistence/src/write-behind.tspackages/session/session-persistence18-158 · FAILURE-WRITE-BEHIND
18-158 · LOG-WRITE-BEHIND
19-157 · PERSIST-WRITE-BEHIND
packages/session/session-persistence/tests/contract.tspackages/session/session-persistence118-265 · FAILURE-CRASH-CONTRACT
118-266 · LOG-REPAIR-CONTRACT
packages/session/session-persistence/tests/coordinator-contract.tspackages/session/session-persistence1360-1382 · SESSION-UNKNOWN-EVENT-TEST
1427-1479 · LOG-TORN-TAIL-CONTRACT
packages/session/session-persistence/tests/persistence.spec.tspackages/session/session-persistence240-249 · FAILURE-CRASH-CONTRACT-MEMORY
packages/session/session-projection-cache/src/index.tspackages/session/session-projection-cache132-230 · PROJ-CACHE-DETACH-WINDOW
154-197 · PROJ-CACHE-LADDER
packages/session/session-projection-cache/src/spec.tspackages/session/session-projection-cache16-69 · PROJ-CACHE-SCHEMA
packages/session/session-projection/src/index.tspackages/session/session-projection88-118 · PROJ-AUTHORITY-LAYERS
130-425 · PROJ-REGISTRY-DRIVE
137-220 · PROJ-REGISTRY-REGISTRATION
284-385 · PROJ-REGISTRY-RESTORE
packages/session/session-stats/src/projection.tspackages/session/session-stats1-183 · OBS-STATS-FOLD
packages/session/session-stats/src/types.tspackages/session/session-stats15-45 · OBS-STATS-CONTRACT
packages/session/session-stats/tests/projection.spec.tspackages/session/session-stats58-291 · OBS-TEST-STATS
packages/session/session-telemetry-otel/package.jsonpackages/session/session-telemetry-otel33-41 · OBS-OTEL-DEPENDENCIES
packages/session/session-telemetry-otel/README.mdpackages/session/session-telemetry-otel30-38 · OPEN-OTEL-BOUNDARY
36-42 · OBS-PRIVACY-BOUNDARY
packages/session/session-telemetry-otel/src/index.tspackages/session/session-telemetry-otel43-252 · OBS-TELEMETRY-MODES
197-232 · OBS-OTEL-PIPELINE
265-298 · OBS-OTEL-SHUTDOWN
packages/session/session-telemetry-otel/tests/loader-composition.e2e.tspackages/session/session-telemetry-otel78-153 · OBS-TEST-OTEL-COMPOSITION
packages/session/session-telemetry-otel/tests/otel.spec.tspackages/session/session-telemetry-otel1-163 · OBS-TEST-OTEL-WIRE
273-489 · OBS-TEST-OTEL-MODES
packages/session/session-telemetry/README.mdpackages/session/session-telemetry13-35 · OPEN-TELEMETRY-HANDOFF
45-49 · OPEN-TELEMETRY-LIMITS
packages/session/session-telemetry/src/coordinator.tspackages/session/session-telemetry32-169 · OBS-TELEMETRY-HANDOFF
112-267 · OBS-OPS-LOGS
179-220 · OBS-TELEMETRY-PROJECTION
228-302 · OBS-TELEMETRY-SEVERITY
packages/session/session-telemetry/src/index.tspackages/session/session-telemetry24-43 · OBS-TELEMETRY-REDACTION
47-130 · OBS-TELEMETRY-CONTRACT
packages/session/session-telemetry/tests/redact.spec.tspackages/session/session-telemetry39-128 · OBS-TEST-REDACTION
packages/session/session-telemetry/tests/telemetry.spec.tspackages/session/session-telemetry161-539 · OBS-TEST-HANDOFF
packages/settings/settings/README.mdpackages/settings/settings41-45 · OPEN-SETTINGS-CROSS-PROCESS
41-45 · OPEN-SETTINGS-REDACTION-DOC
packages/settings/settings/src/redact.tspackages/settings/settings50-109 · OPEN-SETTINGS-REDACTION-CODE
packages/shell/bash-sandbox/src/helpers.tspackages/shell/bash-sandbox25-116 · SANDBOX-RESULT-CLASSIFIER
packages/shell/bash-sandbox/src/index.tspackages/shell/bash-sandbox79-179 · SANDBOX-BASH-CONSUMER
packages/shell/shell-env/src/index.tspackages/shell/shell-env81-216 · SHELL-MANAGED-ENV
175-192 · SHELL-ENV-LIST-GAP
packages/shell/shell/src/index.tspackages/shell/shell46-100 · SHELL-EXECUTOR-CONTRACT
packages/shell/tool-bash-persistent/src/index.tspackages/shell/tool-bash-persistent62-398 · SHELL-PERSISTENT-BASH
packages/shell/tool-bash/src/background.tspackages/shell/tool-bash9-27 · SHELL-BACKGROUND-OUTCOME
packages/shell/tool-bash/src/index.tspackages/shell/tool-bash138-156 · SHELL-BASH-CWD
190-390 · APPROVAL-BASH-EXECUTION
330-389 · SHELL-BASH-TOOL
packages/shell/tool-pwsh/README.mdpackages/shell/tool-pwsh5-9 · SHELL-PWSH-DOC-DRIFT
packages/shell/tool-pwsh/src/index.tspackages/shell/tool-pwsh42-50 · SHELL-PWSH-INJECT
147-158 · SHELL-PWSH-CWD-GAP
209-406 · APPROVAL-PWSH-EXECUTION
packages/skill/skill-filesystem/src/index.tspackages/skill/skill-filesystem36-260 · CAP-SKILL-FS-ROOTS
36-100 · MEMORY-SKILL-FILESYSTEM-CONFIG
241-260 · MEMORY-SKILL-FILESYSTEM-ROOTS
719-885 · MEMORY-SKILL-FILESYSTEM-LOAD
749-885 · CAP-SKILL-FS-TRUST
packages/skill/skill/src/index.tspackages/skill/skill20-109 · CAP-SKILL-TYPES
140-228 · CAP-SKILL-RENDER
157-183 · SEC-SKILL-TRUST
327-619 · MEMORY-SKILL-REGISTRY
346-461 · CAP-SKILL-LAYERS
463-625 · CAP-SKILL-COLLECT
packages/skill/tool-skill/src/index.tspackages/skill/tool-skill27-430 · MEMORY-SKILL-INVOCATION
71-161 · CAP-SKILL-TOOL-LOAD
127-227 · SEC-SKILL-INVOCATION-GATES
163-430 · CAP-SKILL-USER-INVOKE
206-335 · CAP-SKILL-CATALOG
packages/storage/storage-domain/src/domain.tspackages/storage/storage-domain135-269 · PERSIST-DOMAIN-ORDER
148-275 · PERSIST-DOMAIN-CLOSE-GAP
packages/storage/storage-json/src/atomic.tspackages/storage/storage-json1-52 · PERSIST-JSON-ATOMIC
packages/storage/storage-json/src/index.tspackages/storage/storage-json21-66 · PERSIST-JSON-ROOT-GAP
packages/storage/storage-json/src/unit.tspackages/storage/storage-json47-140 · PERSIST-JSON-UNIT-ROLLBACK
packages/storage/storage-sqlite/src/index.tspackages/storage/storage-sqlite23-72 · PERSIST-STORAGE-SQLITE-CONSTRUCTOR
packages/storage/storage-sqlite/src/schema.tspackages/storage/storage-sqlite15-119 · PERSIST-STORAGE-SQLITE-SCHEMA
52-80 · PERSIST-STORAGE-SQLITE-OPEN
packages/storage/storage-sqlite/src/unit.tspackages/storage/storage-sqlite23-147 · PERSIST-STORAGE-SQLITE-UNIT
packages/storage/storage/src/backend.tspackages/storage/storage12-104 · PERSIST-STORAGE-SEAM
packages/storage/storage/src/registry.tspackages/storage/storage14-36 · PERSIST-STORAGE-REGISTRY
packages/subagent/subagent-acp/src/index.tspackages/subagent/subagent-acp124-169 · ACP-CHILD-CAPABILITIES
124-170 · MULTIAGENT-ACP-PROVIDER
packages/subagent/subagent-acp/src/run.tspackages/subagent/subagent-acp94-367 · ACP-CHILD-CANCEL
190-367 · ACP-CHILD-START
packages/subagent/subagent-claude-code/src/index.tspackages/subagent/subagent-claude-code50-112 · MULTIAGENT-CLAUDE-PROVIDER
packages/subagent/subagent-codex/src/index.tspackages/subagent/subagent-codex47-100 · MULTIAGENT-CODEX-PROVIDER
packages/subagent/subagent-codex/src/run.tspackages/subagent/subagent-codex28-199 · MULTIAGENT-CODEX-RUN
packages/subagent/subagent-codex/src/wire.tspackages/subagent/subagent-codex128-373 · MULTIAGENT-CODEX-WIRE
294-373 · MULTIAGENT-CODEX-UNATTENDED
packages/subagent/subagent-codex/tests/subagent-codex.spec.tspackages/subagent/subagent-codex363-435 · MULTIAGENT-CODEX-WIRE-TEST
packages/subagent/subagent-dsh-sdk/src/index.tspackages/subagent/subagent-dsh-sdk1-119 · MULTIAGENT-SDK-PROVIDER
packages/subagent/subagent-fork-in-process/src/index.tspackages/subagent/subagent-fork-in-process40-94 · MULTIAGENT-FORK-PROVIDER
packages/subagent/subagent-fork-in-process/tests/subagent-fork-in-process.spec.tspackages/subagent/subagent-fork-in-process134-158 · MULTIAGENT-FORK-OPEN-TURN-TEST
packages/subagent/subagent-in-process-driver/src/index.tspackages/subagent/subagent-in-process-driver78-205 · MULTIAGENT-ONE-SHOT-DRIVER
207-233 · MULTIAGENT-ONE-SHOT-RESULT
packages/subagent/subagent-in-process-driver/src/structured.tspackages/subagent/subagent-in-process-driver49-141 · MULTIAGENT-STRUCTURED-OUTPUT
packages/subagent/subagent-spawn-in-process/src/index.tspackages/subagent/subagent-spawn-in-process34-64 · MULTIAGENT-SPAWN-PROVIDER
packages/subagent/subagent/src/assistant-output.tspackages/subagent/subagent1-74 · MULTIAGENT-ASSISTANT-OUTPUT
packages/subagent/subagent/src/child-agent.tspackages/subagent/subagent38-120 · MULTIAGENT-CHILD-INHERITANCE
130-224 · APPROVAL-CHILD-PIN
130-175 · MULTIAGENT-CHILD-COMPOSITION
177-225 · MULTIAGENT-DELEGATED-POLICY
packages/subagent/subagent/src/continuation.tspackages/subagent/subagent1-19 · INBOX-ACTIVATION-MODEL
151-159 · INBOX-ACTIVATION-STATE
151-240 · MULTIAGENT-ACTIVATION-MODEL
319-340 · MULTIAGENT-CHILD-LOCK
388-457 · MULTIAGENT-CONTINUABLE-START
459-505 · INBOX-CONTINUATION-DELIVERY
459-505 · MULTIAGENT-FOLLOWUP
507-568 · INBOX-CHILD-INTERRUPT
507-568 · MULTIAGENT-INTERRUPT
570-693 · MULTIAGENT-REPORT-DELIVERY
583-693 · INBOX-CHILD-REPORT
695-803 · MULTIAGENT-DRAIN
876-932 · INBOX-COLD-RESUME
876-932 · MULTIAGENT-COLD-RESUME
1094-1174 · MULTIAGENT-ACTIVATION-OWNERSHIP
1125-1204 · INBOX-CONTINUATION-ADMISSION
1270-1380 · MULTIAGENT-ACTIVATION-DISPOSAL
1363-1465 · INBOX-SETTLEMENT-NOTICE
1382-1448 · MULTIAGENT-SETTLEMENT-NOTICE
1451-1478 · MULTIAGENT-FINAL-FLUSH
packages/subagent/subagent/src/depth.tspackages/subagent/subagent18-50 · MULTIAGENT-DEPTH
packages/subagent/subagent/src/descriptor-seed.tspackages/subagent/subagent13-30 · MULTIAGENT-DESCRIPTOR-SEED
packages/subagent/subagent/src/descriptor.tspackages/subagent/subagent1-88 · MULTIAGENT-DESCRIPTOR
195-314 · MULTIAGENT-DESCRIPTOR-FOLD
packages/subagent/subagent/src/index.tspackages/subagent/subagent203-275 · INBOX-CONTINUATION-SEAM
404-495 · MULTIAGENT-RUNTIME-DISPATCH
packages/subagent/subagent/src/invariant.tspackages/subagent/subagent14-84 · MULTIAGENT-INVARIANTS
packages/subagent/subagent/src/lifecycle.tspackages/subagent/subagent76-217 · MULTIAGENT-LIFECYCLE
packages/subagent/subagent/src/list-children.tspackages/subagent/subagent27-32 · MULTIAGENT-LIST-CONCURRENCY
117-409 · MULTIAGENT-LIST-SERVICE
packages/subagent/subagent/src/out-of-process.tspackages/subagent/subagent155-215 · MULTIAGENT-OUTPROCESS-SETTLEMENT
packages/subagent/subagent/src/projection.tspackages/subagent/subagent111-155 · MULTIAGENT-DESCRIPTOR-PROJECTION
packages/subagent/subagent/src/run-settlement.tspackages/subagent/subagent21-63 · MULTIAGENT-RUN-SETTLEMENT
packages/subagent/subagent/src/types.tspackages/subagent/subagent75-323 · MULTIAGENT-SEAM
packages/subagent/subagent/tests/continuation.spec.tspackages/subagent/subagent101-191 · MULTIAGENT-CONTINUATION-ACCEPTANCE-TEST
packages/subagent/tool-subagent-control/src/index.tspackages/subagent/tool-subagent-control25-119 · INBOX-CONTROL-TOOLS
25-119 · MULTIAGENT-CONTROL-TOOLS
packages/subagent/tool-subagent-control/src/list-agents.tspackages/subagent/tool-subagent-control52-105 · MULTIAGENT-LIST-TOOL
packages/subagent/tool-subagent-report/src/index.tspackages/subagent/tool-subagent-report40-142 · MULTIAGENT-REPORT-TOOL
packages/subagent/tool-subagent/src/index.tspackages/subagent/tool-subagent28-99 · MULTIAGENT-TOOL-CONFIG
246-429 · MULTIAGENT-TOOL-ROUTES
366-465 · MULTIAGENT-TOOL-CONCURRENCY
packages/subprocess/subprocess-local/README.mdpackages/subprocess/subprocess-local26-33 · OPEN-PROCESS-PLATFORM-LIMITS
packages/subprocess/subprocess-local/src/spawn.tspackages/subprocess/subprocess-local17-352 · ACP-CHILD-ENV-MERGE
84-247 · SHELL-OUTPUT-SPILL
253-543 · SHELL-PROCESS-TREE
packages/subprocess/subprocess-local/src/terminal.tspackages/subprocess/subprocess-local93-248 · SHELL-PTY-CLEANUP
packages/subprocess/subprocess/src/index.tspackages/subprocess/subprocess37-65 · ACP-CHILD-ENV-POLICY
37-66 · SEC-CHILD-ENV
37-66 · SHELL-ENV-SCRUB
37-139 · SHELL-SUBPROCESS-SEAM
packages/subprocess/subprocess/src/types.tspackages/subprocess/subprocess55-193 · SHELL-SPAWN-CONTRACT
packages/terminal/terminal-bash/src/index.tspackages/terminal/terminal-bash27-145 · SANDBOX-TERMINAL-FENCE
packages/terminal/terminal-bash/src/session.tspackages/terminal/terminal-bash225-564 · SHELL-PTY-READINESS
packages/terminal/terminal/src/index.tspackages/terminal/terminal104-405 · SHELL-TERMINAL-SERVICE
packages/terminal/tool-terminal/src/index.tspackages/terminal/tool-terminal157-399 · SHELL-TERMINAL-TOOLS
packages/test-support/acp-snapshot/README.mdpackages/test-support/acp-snapshot74-78 · OPEN-SNAPSHOT-BACKEND-GAP
packages/test-support/acp-snapshot/src/suite.tspackages/test-support/acp-snapshot1080-1098 · TINV-SNAPSHOT-SCENARIO-MODE
1167-1342 · TINV-SNAPSHOT-COMPARE
1440-1480 · TINV-SNAPSHOT-FIXTURES
packages/test-support/llm-replay/README.mdpackages/test-support/llm-replay77-80 · OPEN-REPLAY-CONCURRENCY
packages/test-support/llm-replay/src/index.tspackages/test-support/llm-replay1-263 · TINV-REPLAY-DERIVE
193-260 · LLM-REPLAY-DERIVATION
packages/test-support/llm-replay/tests/llm-replay.spec.tspackages/test-support/llm-replay119-132 · LLM-MULTI-ATTEMPT-REPLAY-TEST
671-917 · TINV-REPLAY-TEST
packages/todo/tool-todo/src/index.tspackages/todo/tool-todo28-225 · PLANSTATE-TODO-TOOL
packages/todo/tool-todo/src/invariant.tspackages/todo/tool-todo15-57 · PLANSTATE-TODO-INVARIANT
packages/todo/tool-todo/tests/projection.spec.tspackages/todo/tool-todo68-123 · PLANSTATE-TODO-PROJECTION
packages/todo/tool-todo/tests/tool-todo.spec.tspackages/todo/tool-todo70-209 · PLANSTATE-TODO-TEST
packages/util/atomic-write/README.mdpackages/util/atomic-write23-45 · OPEN-ATOMIC-DURABILITY
packages/util/native-command/README.mdpackages/util/native-command25-27 · OPEN-NATIVE-OUTPUT-BOUND
packages/util/timeout/src/index.tspackages/util/timeout57-190 · FAILURE-TIMEOUT-SIGNAL
packages/web/tool-web/src/index.tspackages/web/tool-web1-91 · CAP-WEB-TOOL
packages/web/web-fetch-http/README.mdpackages/web/web-fetch-http17-51 · OPEN-WEB-SSRF
packages/web/web-fetch-http/src/policy.tspackages/web/web-fetch-http14-105 · CAP-WEB-FETCH-POLICY
packages/web/web-fetch-http/src/provider.tspackages/web/web-fetch-http1-147 · CAP-WEB-FETCH-TRANSPORT
149-207 · CAP-WEB-FETCH-CAPS
packages/web/web-search-deepseek/src/index.tspackages/web/web-search-deepseek95-138 · CAP-WEB-DEEPSEEK-SETTINGS
packages/web/web-search-deepseek/src/provider.tspackages/web/web-search-deepseek1-109 · CAP-WEB-DEEPSEEK-WIRE
112-174 · CAP-WEB-DEEPSEEK-MAP
176-300 · CAP-WEB-DEEPSEEK-REQUEST
packages/web/web/src/index.tspackages/web/web49-200 · CAP-WEB-SELECTION
packages/web/web/src/types.tspackages/web/web15-129 · CAP-WEB-TYPES
packages/workflow/tool-ralph/README.mdpackages/workflow/tool-ralph86-93 · OPEN-RALPH-VERIFICATION
packages/workflow/tool-ralph/src/index.tspackages/workflow/tool-ralph80-177 · RALPH-SCRIPT
151-167 · RALPH-ROUND-PROMPT
207-232 · RALPH-FRESH-PROVIDER
246-333 · RALPH-DOUBLE-VALIDATION
282-391 · RALPH-OUTCOMES
351-391 · RALPH-RENDER
404-435 · RALPH-CONTRACT
437-474 · RALPH-EXECUTE
packages/workflow/tool-workflow/src/index.tspackages/workflow/tool-workflow69-330 · WORKFLOW-DURABLE-RECORD
133-270 · WORKFLOW-TOOL-CONTRACT
272-330 · WORKFLOW-TOOL-EXECUTE
packages/workflow/tool-workflow/src/invariant.tspackages/workflow/tool-workflow67-163 · WORKFLOW-RECORD-INVARIANT
packages/workflow/tool-workflow/src/types.tspackages/workflow/tool-workflow13-63 · WORKFLOW-RECORD-TYPES
packages/workflow/workflow-worker-thread/README.mdpackages/workflow/workflow-worker-thread5-22 · OPEN-WORKFLOW-ISOLATION
packages/workflow/workflow-worker-thread/src/host.tspackages/workflow/workflow-worker-thread32-169 · WORKFLOW-WORKER-SPAWN
206-251 · WORKFLOW-DISPOSE
329-412 · WORKFLOW-CHILD-BRIDGE
385-412 · WORKFLOW-CHILD-SNAPSHOT
414-483 · WORKFLOW-CHILD-QUIESCENCE
486-516 · WORKFLOW-CANCEL-RACE
553-582 · WORKFLOW-EVENT-PAIRING
packages/workflow/workflow-worker-thread/src/index.tspackages/workflow/workflow-worker-thread31-48 · WORKFLOW-CAPS
53-201 · WORKFLOW-START-VALIDATION
164-180 · WORKFLOW-HMR-HOLDER
packages/workflow/workflow-worker-thread/src/meta.tspackages/workflow/workflow-worker-thread12-82 · WORKFLOW-META
packages/workflow/workflow-worker-thread/src/realm.tspackages/workflow/workflow-worker-thread1-39 · WORKFLOW-REALM-TRUST
42-151 · WORKFLOW-JSON-BOUNDARY
packages/workflow/workflow-worker-thread/src/runtime.tspackages/workflow/workflow-worker-thread75-114 · WORKFLOW-VM-GLOBALS
116-187 · WORKFLOW-CANCEL-BOUNDARY
222-274 · WORKFLOW-SLOTS
249-345 · WORKFLOW-AGENT-RESULT
347-398 · WORKFLOW-AGENT-OPTIONS
400-466 · WORKFLOW-COMBINATORS
400-455 · WORKFLOW-FATALITY
packages/workflow/workflow/README.mdpackages/workflow/workflow53-59 · OPEN-WORKFLOW-DURABILITY
packages/workflow/workflow/src/index.tspackages/workflow/workflow36-100 · WORKFLOW-EVENTS
102-148 · WORKFLOW-ERROR-TAXONOMY
150-186 · WORKFLOW-LIFECYCLE
packages/workflow/workflow/src/runtime-types.tspackages/workflow/workflow14-49 · WORKFLOW-SEAM
packages/workspace/workspace/README.mdpackages/workspace/workspace11-23 · PERSIST-WORKSPACE-OWNERSHIP
41-44 · PERSIST-WORKSPACE-REFRESH-DOC
packages/workspace/workspace/src/entity.tspackages/workspace/workspace101-107 · PERSIST-WORKSPACE-TITLE-SETTER
packages/workspace/workspace/src/index.tspackages/workspace/workspace118-140 · PERSIST-WORKSPACE-INIT
142-163 · PERSIST-WORKSPACE-TITLE-GAP
285-424 · PERSIST-WORKSPACE-MUTATION
426-508 · PERSIST-WORKSPACE-BOOTSTRAP
510-551 · PERSIST-WORKSPACE-INVARIANTS
561-630 · PERSIST-WORKSPACE-REFRESH
packages/workspace/workspace/src/spec.tspackages/workspace/workspace13-75 · PERSIST-WORKSPACE-SCHEMA
python/sdk/src/deepseek_harness/api.pypython13-84 · SDK-PY-RESULT
97-242 · SDK-PY-RUN
python/sdk/src/deepseek_harness/client.pypython24-397 · SDK-PY-CLIENT
63-83 · SEC-SDK-PYTHON
228-396 · SDK-PY-READER
python/sdk/src/deepseek_harness/models.pypython26-32 · SDK-PY-MODELS
README.mdrepository-root9-11 · WEBUI-DEVELOPER-PREVIEW
scripts/coverage-exempt.spec.tsscripts13-54 · TINV-COVERAGE-EXEMPT-TEST
scripts/coverage-exempt.tsscripts1-41 · TINV-COVERAGE-EXEMPT
scripts/gen-config-catalog.tsscripts1-7 · TINV-CONFIG-CATALOG
719-875 · TINV-CONFIG-CATALOG-CHECK
scripts/gen-cordis-catalog.tsscripts701-918 · TINV-CORDIS-CATALOG
scripts/gen-tool-catalog.tsscripts556-704 · TOOLCAT-GENERATOR
scripts/package-invariants.tsscripts11-286 · TINV-COMPANION-GATE
scripts/run-gates.tsscripts374-419 · TINV-CI-CONSUMERS
497-527 · TINV-SNAPSHOT-GATE
571-615 · TINV-DOC-SYNC
scripts/session-fixture-layout.snapshot.tsscripts1-16 · TINV-FIXTURE-LAYOUT-TEST
scripts/test-invariants.spec.tsscripts97-152 · TINV-INVARIANT-TOPOLOGY-TEST
scripts/test-invariants.tsscripts67-272 · TINV-TEST-HOST
scripts/verify-built-package-invariants.mjsscripts31-82 · TINV-BUILT-COMPANIONS
scripts/verify-cordis-config.spec.tsscripts1-38 · TINV-CONFIG-TEST
scripts/verify-cordis-config.tsscripts1-471 · TINV-CONFIG-METADATA
72-364 · TINV-CONFIG-CLOSURE
scripts/verify-package-readme-limitations.tsscripts1-93 · OPEN-LIMITATIONS-GATE
scripts/verify-runtime-closure.tsscripts24-73 · TINV-RUNTIME-CLOSURE
scripts/verify-type-equiv.tsscripts199-300 · TINV-TYPE-EQUIV
scripts/wine-windows-gates.shscripts31-282 · TINV-WINE-RUNNER
vitest.config.tsrepository-root21-84 · TINV-PLATFORM-COVERAGE
160-268 · TINV-COVERAGE-SCOPE
264-283 · TINV-COVERAGE-BAR
vitest.snapshot.config.tsrepository-root19-67 · TINV-SNAPSHOT-MODE

7. Documented symbol index · 384

Universe: primary entries in scripts/type-equiv.manifest.json. Identity is source + symbol + projection. This is intentionally not described as all exports or all declarations.

SymbolProjectionPinned sourceDocumentation
InvokeRemoteRequestcompletepackages/api/gateway/src/types.tsdocs/subsystems/typert.md
TypertGatewaycompletepackages/api/gateway/src/types.tsdocs/subsystems/typert.md
TypertGatewayErrorCodecompletepackages/api/gateway/src/types.tsdocs/subsystems/typert.md
ImageAttachmentLimitscompletepackages/attachment/attachment/src/types.tsdocs/subsystems/attachment.md
ImageAttachmentRefcompletepackages/attachment/attachment/src/types.tsdocs/subsystems/attachment.md
ImageMediaTypecompletepackages/attachment/attachment/src/types.tsdocs/subsystems/attachment.md
SaveImageAttachmentcompletepackages/attachment/attachment/src/types.tsdocs/subsystems/attachment.md
StoredImageAttachmentcompletepackages/attachment/attachment/src/types.tsdocs/subsystems/attachment.md
WebBootEntrycompletepackages/client/modules/src/client/manifest.tsdocs/subsystems/client-modules.md
WebBootGraphcompletepackages/client/modules/src/client/manifest.tsdocs/subsystems/client-modules.md
CodeBindingErrorClasscompletepackages/code-runtime/code-runtime/src/types.tsdocs/subsystems/code-runtime.md
CodeBindingFunctioncompletepackages/code-runtime/code-runtime/src/types.tsdocs/subsystems/code-runtime.md
CodeBindingNamespacecompletepackages/code-runtime/code-runtime/src/types.tsdocs/subsystems/code-runtime.md
CodeJsonValuecompletepackages/code-runtime/code-runtime/src/types.tsdocs/subsystems/code-runtime.md
CodeRunFailurecompletepackages/code-runtime/code-runtime/src/types.tsdocs/subsystems/code-runtime.md
CodeRunRequestcompletepackages/code-runtime/code-runtime/src/types.tsdocs/subsystems/code-runtime.md
CodeRunResultcompletepackages/code-runtime/code-runtime/src/types.tsdocs/subsystems/code-runtime.md
PrunedEntrycompletepackages/compaction/compaction-tool-result-pruner/src/types.tsdocs/subsystems/compaction.md
PruneResultcompletepackages/compaction/compaction-tool-result-pruner/src/types.tsdocs/subsystems/compaction.md
CompactionTriggercompletepackages/compaction/compaction/src/index.tsdocs/subsystems/compaction.md
ManualCompactionErrorCodecompletepackages/compaction/compaction/src/index.tsdocs/subsystems/compaction.md
CompactionResultcompletepackages/compaction/compaction/src/types.tsdocs/subsystems/compaction.md
SessionReferenceErrorCodecompletepackages/context/session-reference/src/config.tsdocs/subsystems/session-reference.md
PreparedReferencedMessagecompletepackages/context/session-reference/src/types.tsdocs/subsystems/session-reference.md
SessionReferenceCandidatecompletepackages/context/session-reference/src/types.tsdocs/subsystems/session-reference.md
SessionReferenceInputcompletepackages/context/session-reference/src/types.tsdocs/subsystems/session-reference.md
AgentHandlecompletepackages/core/agent/src/index.tsdocs/subsystems/core.md
Agentcompletepackages/core/agent/src/runtime-types.tsdocs/subsystems/core.md
AgentOptionscompletepackages/core/agent/src/runtime-types.tsdocs/subsystems/core.md
AgentStatuscompletepackages/core/agent/src/runtime-types.tsdocs/subsystems/core.md
CancelOptionscompletepackages/core/agent/src/runtime-types.tsdocs/subsystems/core.md
PreStepDecisioncompletepackages/core/agent/src/runtime-types.tsdocs/subsystems/core.md
RequestErrorActioncompletepackages/core/agent/src/runtime-types.tsdocs/subsystems/core.md
SessionStartSourcecompletepackages/core/agent/src/runtime-types.tsdocs/subsystems/core.md
InboxTargetcompletepackages/core/agent/src/types.tsdocs/subsystems/core.md
Scopecompletepackages/core/scope/src/index.tsdocs/subsystems/scope.md
Scopedcompletepackages/core/scope/src/index.tsdocs/subsystems/scope.md
ScopeKeycompletepackages/core/scope/src/index.tsdocs/subsystems/scope.md
ScopeLayercompletepackages/core/scope/src/store.tsdocs/subsystems/scope.md
Sessionpublic-apipackages/core/session/src/index.tsdocs/subsystems/session.md
SessionPreparationpublic-apipackages/core/session/src/preparation.tsdocs/subsystems/persistence.md
SessionPreparationOptionscompletepackages/core/session/src/preparation.tsdocs/subsystems/persistence.md
SessionSurfacecompletepackages/core/session/src/surface.tsdocs/subsystems/session.md
SurfaceFoldReplacementcompletepackages/core/session/src/surface.tsdocs/subsystems/session.md
SurfaceFoldResultcompletepackages/core/session/src/surface.tsdocs/subsystems/session.md
AgentCancelCausecompletepackages/core/session/src/types.tsdocs/subsystems/core.md
CreateSessionOptionscompletepackages/core/session/src/types.tsdocs/subsystems/persistence.md
EpochHeadercompletepackages/core/session/src/types.tsdocs/subsystems/session.md
PrepareSessionOptionscompletepackages/core/session/src/types.tsdocs/subsystems/persistence.md
RequestContextcompletepackages/core/session/src/types.tsdocs/subsystems/session.md
RestoredSessionOptionscompletepackages/core/session/src/types.tsdocs/subsystems/persistence.md
SessionEventcompletepackages/core/session/src/types.tsdocs/subsystems/session.md
SessionEventMapcompletepackages/core/session/src/types.tsdocs/subsystems/session.md
SessionHeadercompletepackages/core/session/src/types.tsdocs/subsystems/persistence.md
SurfaceEventTypecompletepackages/core/session/src/types.tsdocs/subsystems/session.md
SurfaceIntentcompletepackages/core/session/src/types.tsdocs/subsystems/session.md
SurfaceOpcompletepackages/core/session/src/types.tsdocs/subsystems/session.md
TodoItemcompletepackages/core/session/src/types.tsdocs/subsystems/session.md
TurnEndCancelCausecompletepackages/core/session/src/types.tsdocs/subsystems/session.md
TurnEndReasonMapcompletepackages/core/session/src/types.tsdocs/subsystems/session.md
AssembleContextcompletepackages/core/system-prompt/src/index.tsdocs/subsystems/system-prompt.md
PromptContextcompletepackages/core/system-prompt/src/index.tsdocs/subsystems/system-prompt.md
PromptSectioncompletepackages/core/system-prompt/src/index.tsdocs/subsystems/system-prompt.md
ToolProviderResultcompletepackages/core/system-prompt/src/index.tsdocs/subsystems/system-prompt.md
CodeDispatchLogcompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
PostToolDecisioncompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
PreToolDecisioncompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolDefinitioncompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolDispatchExecutioncompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolExecutioncompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolExecutionFailurecompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolExecutionInputcompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolExecutionModecompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolExecutionResultcompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolExecutionSuccesscompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolExecutionTokencompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolFailurecompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolGuardcompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolOutputDefinitioncompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolRestrictioncompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
ToolRunContextcompletepackages/core/tools/src/index.tsdocs/subsystems/tools.md
JsonSchemaNodecompletepackages/core/tools/src/json-schema.tsdocs/subsystems/tools.md
JsonSchemaScalarcompletepackages/core/tools/src/json-schema.tsdocs/subsystems/tools.md
JsonSchemaTypecompletepackages/core/tools/src/json-schema.tsdocs/subsystems/tools.md
ObjectJsonSchemacompletepackages/core/tools/src/json-schema.tsdocs/subsystems/tools.md
InferArgscompletepackages/core/tools/src/schema.tsdocs/subsystems/tools.md
InferValuecompletepackages/core/tools/src/schema.tsdocs/subsystems/tools.md
ParameterPropertySpeccompletepackages/core/tools/src/schema.tsdocs/subsystems/tools.md
ParameterSchemaSpeccompletepackages/core/tools/src/schema.tsdocs/subsystems/tools.md
ValueSchemaSpeccompletepackages/core/tools/src/schema.tsdocs/subsystems/tools.md
CredentialInfocompletepackages/credentials/credentials/src/index.tsdocs/subsystems/credentials.md
ResolvedCredentialcompletepackages/credentials/credentials/src/index.tsdocs/subsystems/credentials.md
CredentialRefcompletepackages/credentials/credentials/src/types.tsdocs/subsystems/credentials.md
MessageFeedbackDeleteRequestcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackDeleteResultcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackDeleteValuecompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackFailurecompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackItemcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackListRequestcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackListResultcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackListValuecompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackNoteBlankcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackNoteTooLargecompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackPutRequestcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackPutResultcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackRatingcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackRejectedcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackSessionNotFoundcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackSuccesscompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackTargetNotFoundcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackVersioncompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
MessageFeedbackVersionConflictcompletepackages/feedback/message-feedback/src/types.tsdocs/subsystems/feedback.md
FsObservationActorcompletepackages/fs/fs-observation-policy/src/types.tsdocs/subsystems/filesystem.md
FsDirEntrycompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsEditOutcomecompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsEditRequestcompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsErrorCodecompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsInfocompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsObservationcompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsPathInfocompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsTargetcompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsTargetKeycompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsVersioncompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsWriteIntentcompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FsWriteOutcomecompletepackages/fs/fs/src/types.tsdocs/subsystems/filesystem.md
FileReadOutcomecompletepackages/fs/tool-fs/src/read-render.tsdocs/subsystems/filesystem.md
GoalChangedcompletepackages/goal/goal/src/domain.tsdocs/subsystems/goal.md
GoalClearChangeMetacompletepackages/goal/goal/src/domain.tsdocs/subsystems/goal.md
GoalMessageSourcecompletepackages/goal/goal/src/domain.tsdocs/subsystems/goal.md
GoalSnapshotChangeMetacompletepackages/goal/goal/src/domain.tsdocs/subsystems/goal.md
CreateGoalRequestcompletepackages/goal/goal/src/types.tsdocs/subsystems/goal.md
EditGoalRequestcompletepackages/goal/goal/src/types.tsdocs/subsystems/goal.md
GoalBlockReasoncompletepackages/goal/goal/src/types.tsdocs/subsystems/goal.md
GoalPhasecompletepackages/goal/goal/src/types.tsdocs/subsystems/goal.md
GoalRefcompletepackages/goal/goal/src/types.tsdocs/subsystems/goal.md
GoalSnapshotcompletepackages/goal/goal/src/types.tsdocs/subsystems/goal.md
GoalViewcompletepackages/goal/goal/src/types.tsdocs/subsystems/goal.md
Configcompletepackages/host/webserver/src/index.tsdocs/subsystems/web-server.md
WebRoutecompletepackages/host/webserver/src/index.tsdocs/subsystems/web-server.md
WebRouteKindcompletepackages/host/webserver/src/index.tsdocs/subsystems/web-server.md
CommandDefinitioncompletepackages/interaction/commands/src/index.tsdocs/subsystems/commands.md
CommandInvocationcompletepackages/interaction/commands/src/index.tsdocs/subsystems/commands.md
ParsedCommandcompletepackages/interaction/commands/src/index.tsdocs/subsystems/commands.md
CommandDescriptorcompletepackages/interaction/commands/src/types.tsdocs/subsystems/commands.md
CommandInputDescriptorcompletepackages/interaction/commands/src/types.tsdocs/subsystems/commands.md
CommandResultcompletepackages/interaction/commands/src/types.tsdocs/subsystems/commands.md
Configcompletepackages/interaction/permission-presets/src/index.tsdocs/subsystems/permission-presets.md
PresetSpeccompletepackages/interaction/permission-presets/src/index.tsdocs/subsystems/permission-presets.md
PresetOptioncompletepackages/interaction/permission-presets/src/types.tsdocs/subsystems/permission-presets.md
ApprovalPolicycompletepackages/interaction/user-approval/src/index.tsdocs/subsystems/approval.md
ApprovalRequestcompletepackages/interaction/user-approval/src/index.tsdocs/subsystems/approval.md
ApprovalOutcomecompletepackages/interaction/user-approval/src/types.tsdocs/subsystems/approval.md
ApprovalRequestIdcompletepackages/interaction/user-approval/src/types.tsdocs/subsystems/approval.md
AskUserQuestionRequestcompletepackages/interaction/user-questions/src/index.tsdocs/subsystems/user-questions.md
UserQuestionErrorcompletepackages/interaction/user-questions/src/index.tsdocs/subsystems/user-questions.md
UserQuestionProvidercompletepackages/interaction/user-questions/src/index.tsdocs/subsystems/user-questions.md
AskUserQuestionAnswercompletepackages/interaction/user-questions/src/types.tsdocs/subsystems/user-questions.md
AskUserQuestionAnswerItemcompletepackages/interaction/user-questions/src/types.tsdocs/subsystems/user-questions.md
AskUserQuestionIntentcompletepackages/interaction/user-questions/src/types.tsdocs/subsystems/user-questions.md
AskUserQuestionItemcompletepackages/interaction/user-questions/src/types.tsdocs/subsystems/user-questions.md
AskUserQuestionOptioncompletepackages/interaction/user-questions/src/types.tsdocs/subsystems/user-questions.md
JobHookscompletepackages/jobs/jobs/src/types.tsdocs/subsystems/jobs.md
JobKindMapcompletepackages/jobs/jobs/src/types.tsdocs/subsystems/jobs.md
JobOutcomecompletepackages/jobs/jobs/src/types.tsdocs/subsystems/jobs.md
JobReadcompletepackages/jobs/jobs/src/types.tsdocs/subsystems/jobs.md
JobSnapshotcompletepackages/jobs/jobs/src/types.tsdocs/subsystems/jobs.md
JobStartcompletepackages/jobs/jobs/src/types.tsdocs/subsystems/jobs.md
BlockAssemblerpublic-apipackages/llm/llm/src/assembler.tsdocs/subsystems/llm-streaming.md
AppIdentitycompletepackages/llm/llm/src/attribution.tsdocs/subsystems/llm-streaming.md
ReasoningEffortIdcompletepackages/llm/llm/src/brand.tsdocs/subsystems/llm-streaming.md
LlmCallConfigcompletepackages/llm/llm/src/call-config.tsdocs/subsystems/llm-streaming.md
LlmCallConfigAdapterDefaultscompletepackages/llm/llm/src/call-config.tsdocs/subsystems/llm-streaming.md
AdapterRegistrationHandlecompletepackages/llm/llm/src/index.tsdocs/subsystems/llm-streaming.md
LlmAdapterpublic-apipackages/llm/llm/src/index.tsdocs/subsystems/llm-streaming.md
PreparedLlmCallcompletepackages/llm/llm/src/index.tsdocs/subsystems/llm-streaming.md
AssistantProvenancecompletepackages/llm/llm/src/message.tsdocs/subsystems/llm-streaming.md
ContextFormcompletepackages/llm/llm/src/message.tsdocs/subsystems/llm-streaming.md
ContextFormedcompletepackages/llm/llm/src/message.tsdocs/subsystems/llm-streaming.md
ContextSnapshotSectioncompletepackages/llm/llm/src/message.tsdocs/subsystems/llm-streaming.md
Messagecompletepackages/llm/llm/src/message.tsdocs/subsystems/llm-streaming.md
MessageSourceMapcompletepackages/llm/llm/src/message.tsdocs/subsystems/llm-streaming.md
UserMessagecompletepackages/llm/llm/src/message.tsdocs/subsystems/session.md
ContentBlockMapcompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
FinishReasonMapcompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
GenerateOptionscompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
LlmConfigurableProvidercompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
LlmDiscoveredModelcompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
LlmFailurecompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
LlmModelContextcompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
LlmModelDiscoveryRequestcompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
LlmModelInfocompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
LlmModelReasoningInfocompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
LlmProviderInfocompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
LlmReasoningEffortInfocompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
LlmResolvedModelInfocompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
StreamChunkcompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
TokenUsagecompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
ToolSchemacompletepackages/llm/llm/src/types.tsdocs/subsystems/llm-streaming.md
TokenMeasurementcompletepackages/llm/token-meter/src/types.tsdocs/subsystems/token-meter.md
TokenSurfaceNodecompletepackages/llm/token-meter/src/types.tsdocs/subsystems/token-meter.md
LspHovercompletepackages/lsp/lsp/src/types.tsdocs/subsystems/lsp.md
LspLocationcompletepackages/lsp/lsp/src/types.tsdocs/subsystems/lsp.md
LspOperationcompletepackages/lsp/lsp/src/types.tsdocs/subsystems/lsp.md
LspPositioncompletepackages/lsp/lsp/src/types.tsdocs/subsystems/lsp.md
LspProvidercompletepackages/lsp/lsp/src/types.tsdocs/subsystems/lsp.md
LspProviderQuerycompletepackages/lsp/lsp/src/types.tsdocs/subsystems/lsp.md
LspQueryRequestcompletepackages/lsp/lsp/src/types.tsdocs/subsystems/lsp.md
LspQueryResultcompletepackages/lsp/lsp/src/types.tsdocs/subsystems/lsp.md
LspRangecompletepackages/lsp/lsp/src/types.tsdocs/subsystems/lsp.md
LspServicecompletepackages/lsp/lsp/src/types.tsdocs/subsystems/lsp.md
PlanModeConfigcompletepackages/plan/plan-mode/src/index.tsdocs/subsystems/plan.md
Configcompletepackages/runtime-diagnostics/invariants/src/index.tsdocs/subsystems/invariants.md
InvariantFailurecompletepackages/runtime-diagnostics/invariants/src/index.tsdocs/subsystems/invariants.md
InvariantInstallercompletepackages/runtime-diagnostics/invariants/src/index.tsdocs/subsystems/invariants.md
SandboxPolicyRequestcompletepackages/sandbox/sandbox-policy/src/index.tsdocs/subsystems/sandbox.md
ConfinedArgvcompletepackages/sandbox/sandbox/src/index.tsdocs/subsystems/sandbox.md
ConfinedSandboxModecompletepackages/sandbox/sandbox/src/index.tsdocs/subsystems/sandbox.md
RunnerFailureRulecompletepackages/sandbox/sandbox/src/index.tsdocs/subsystems/sandbox.md
SandboxEnforcementcompletepackages/sandbox/sandbox/src/index.tsdocs/subsystems/sandbox.md
SandboxExecutionPolicycompletepackages/sandbox/sandbox/src/index.tsdocs/subsystems/sandbox.md
SandboxModecompletepackages/sandbox/sandbox/src/index.tsdocs/subsystems/sandbox.md
SandboxPolicycompletepackages/sandbox/sandbox/src/index.tsdocs/subsystems/sandbox.md
AfterScheduleRecordcompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
AtInputcompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
AtScheduleRecordcompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
EveryScheduleDispatchChangecompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
EveryScheduleRecordcompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
LocalAtInputcompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
OneShotScheduleDispatchChangecompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
OneShotScheduleRecordcompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
ScheduleChangecompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
ScheduleCreateChangecompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
ScheduleDeleteChangecompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
ScheduleDeliveryModecompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
ScheduleDispatchChangecompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
ScheduleRecordcompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
ScheduleStatecompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
ScheduleViewcompletepackages/schedule/schedule/src/types.tsdocs/subsystems/schedule.md
SessionQueryErrorCodecompletepackages/session-query/session-query/src/config.tsdocs/subsystems/session-query.md
SessionSearchCursorcompletepackages/session-query/session-query/src/cursor.tsdocs/subsystems/session-query.md
SessionEventReadRequestcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventRecordcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventResultFiltercompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventSearchDocumentcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventSearchHitcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventSearchPagecompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventSearchRequestcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventSurfacecompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventTracecompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventTraceObservationcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventTraceRequestcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionEventWindowcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionLineageNodecompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionLineageTracecompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionLogSnapshotcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionRecordcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionResultFiltercompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionSearchHitcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionSearchPagecompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionSearchRequestcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionSurfaceSnapshotcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionTitleObservationcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionTitleObservationResultcompletepackages/session-query/session-query/src/types.tsdocs/subsystems/session-query.md
SessionInspectioncompletepackages/session/session-persistence/src/index.tsdocs/subsystems/persistence.md
SessionLocationcompletepackages/session/session-persistence/src/index.tsdocs/subsystems/persistence.md
SessionPersistenceSnapshotcompletepackages/session/session-persistence/src/index.tsdocs/subsystems/persistence.md
SessionRawArtifactcompletepackages/session/session-persistence/src/index.tsdocs/subsystems/persistence.md
SessionPersistenceRevisioncompletepackages/session/session-persistence/src/revision.tsdocs/subsystems/persistence.md
ProjectionChangeListenercompletepackages/session/session-projection/src/index.tsdocs/subsystems/session-projection.md
ProjectionDefinitioncompletepackages/session/session-projection/src/index.tsdocs/subsystems/session-projection.md
ProjectionSnapshotcompletepackages/session/session-projection/src/index.tsdocs/subsystems/session-projection.md
SessionTelemetryRecordcompletepackages/session/session-telemetry/src/index.tsdocs/subsystems/session-telemetry.md
SessionTelemetrySeveritycompletepackages/session/session-telemetry/src/index.tsdocs/subsystems/session-telemetry.md
SessionTelemetrySharingStatuscompletepackages/session/session-telemetry/src/index.tsdocs/subsystems/session-telemetry.md
SessionTelemetrySinkcompletepackages/session/session-telemetry/src/index.tsdocs/subsystems/session-telemetry.md
SessionTitleLlmRequestEventDatacompletepackages/session/session-title-llm/src/index.tsdocs/subsystems/session-title.md
SessionTitleAutomaticModecompletepackages/session/session-title/src/index.tsdocs/subsystems/session-title.md
SessionTitleEventDatacompletepackages/session/session-title/src/index.tsdocs/subsystems/session-title.md
SessionTitleModelProvenancecompletepackages/session/session-title/src/index.tsdocs/subsystems/session-title.md
SessionTitleProvidercompletepackages/session/session-title/src/index.tsdocs/subsystems/session-title.md
SessionTitleProviderIdcompletepackages/session/session-title/src/index.tsdocs/subsystems/session-title.md
SessionTitleProviderRequestcompletepackages/session/session-title/src/index.tsdocs/subsystems/session-title.md
SessionTitleProviderResultcompletepackages/session/session-title/src/index.tsdocs/subsystems/session-title.md
SessionTitleSnapshotcompletepackages/session/session-title/src/index.tsdocs/subsystems/session-title.md
SessionTitleSourcecompletepackages/session/session-title/src/index.tsdocs/subsystems/session-title.md
SessionTitleUserMessagecompletepackages/session/session-title/src/index.tsdocs/subsystems/session-title.md
SettingsAppliescompletepackages/settings/settings/src/index.tsdocs/subsystems/settings.md
SettingsDescribeOptionscompletepackages/settings/settings/src/index.tsdocs/subsystems/settings.md
SettingsDescriptorcompletepackages/settings/settings/src/index.tsdocs/subsystems/settings.md
SettingsPathOpcompletepackages/settings/settings/src/index.tsdocs/subsystems/settings.md
SettingsRegisterOptionscompletepackages/settings/settings/src/index.tsdocs/subsystems/settings.md
SettingsScopecompletepackages/settings/settings/src/index.tsdocs/subsystems/settings.md
SettingsNamespacecompletepackages/settings/settings/src/types.tsdocs/subsystems/settings.md
SettingsUpdateSourcecompletepackages/settings/settings/src/types.tsdocs/subsystems/settings.md
ShellExecRequestcompletepackages/shell/shell/src/types.tsdocs/subsystems/shell.md
ShellExecSpeccompletepackages/shell/shell/src/types.tsdocs/subsystems/shell.md
ShellProcesscompletepackages/shell/shell/src/types.tsdocs/subsystems/shell.md
ShellProcessReadcompletepackages/shell/shell/src/types.tsdocs/subsystems/shell.md
ShellRunResultcompletepackages/shell/shell/src/types.tsdocs/subsystems/shell.md
ShellSandboxInfocompletepackages/shell/shell/src/types.tsdocs/subsystems/shell.md
Configcompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillCandidatecompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillCatalogSnapshotcompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillDefinitioncompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillInvocationPolicycompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillLookupOptionscompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillProvidercompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillProviderControlcompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillProviderObservationcompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillRegistrationcompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillResourceBasecompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillSourcecompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillSummarycompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SkillViewOptionscompletepackages/skill/skill/src/index.tsdocs/subsystems/skills.md
SaveTextSpillcompletepackages/spill/spill/src/types.tsdocs/subsystems/spill.md
SpillLocatorcompletepackages/spill/spill/src/types.tsdocs/subsystems/spill.md
SpillOwnercompletepackages/spill/spill/src/types.tsdocs/subsystems/spill.md
SpillRefcompletepackages/spill/spill/src/types.tsdocs/subsystems/spill.md
SpillSourcecompletepackages/spill/spill/src/types.tsdocs/subsystems/spill.md
Domaincompletepackages/storage/storage-domain/src/domain.tsdocs/subsystems/storage.md
DomainChangedcompletepackages/storage/storage-domain/src/events.tsdocs/subsystems/storage.md
DomainChangedBasecompletepackages/storage/storage-domain/src/events.tsdocs/subsystems/storage.md
DomainSpeccompletepackages/storage/storage-domain/src/spec.tsdocs/subsystems/storage.md
StorageBackendcompletepackages/storage/storage/src/backend.tsdocs/subsystems/storage.md
StorageFormscompletepackages/storage/storage/src/index.tsdocs/subsystems/storage.md
ContinuableStartcompletepackages/subagent/subagent/src/continuation.tsdocs/subsystems/subagent.md
CoordinatorMessageSourcecompletepackages/subagent/subagent/src/continuation.tsdocs/subsystems/subagent.md
SubagentFollowupOptionscompletepackages/subagent/subagent/src/continuation.tsdocs/subsystems/subagent.md
SubagentInterruptAuthoritycompletepackages/subagent/subagent/src/continuation.tsdocs/subsystems/subagent.md
SubagentReportDeliverycompletepackages/subagent/subagent/src/continuation.tsdocs/subsystems/subagent.md
SubagentReportMessageSourcecompletepackages/subagent/subagent/src/continuation.tsdocs/subsystems/subagent.md
SubagentReportOptionscompletepackages/subagent/subagent/src/continuation.tsdocs/subsystems/subagent.md
SubagentSettledMessageSourcecompletepackages/subagent/subagent/src/continuation.tsdocs/subsystems/subagent.md
SubagentDescendantListEntrycompletepackages/subagent/subagent/src/list-children.tsdocs/subsystems/subagent.md
ContinuableCreateRequestcompletepackages/subagent/subagent/src/types.tsdocs/subsystems/subagent.md
ContinuableCreateSpeccompletepackages/subagent/subagent/src/types.tsdocs/subsystems/subagent.md
ResolvedSubagentStartRequestcompletepackages/subagent/subagent/src/types.tsdocs/subsystems/subagent.md
SubagentCapabilitiescompletepackages/subagent/subagent/src/types.tsdocs/subsystems/subagent.md
SubagentProvidercompletepackages/subagent/subagent/src/types.tsdocs/subsystems/subagent.md
SubagentResultcompletepackages/subagent/subagent/src/types.tsdocs/subsystems/subagent.md
SubagentRuncompletepackages/subagent/subagent/src/types.tsdocs/subsystems/subagent.md
SubagentStartRequestcompletepackages/subagent/subagent/src/types.tsdocs/subsystems/subagent.md
SubagentStopReasonMapcompletepackages/subagent/subagent/src/types.tsdocs/subsystems/subagent.md
CollectedOutputcompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
DshEnvironmentcompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
DshEnvironmentKeycompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
SubprocessCollectcompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
SubprocessCollectedOutputscompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
SubprocessHandlecompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
SubprocessOutcomecompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
SubprocessOutputModecompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
SubprocessOutputReadcompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
SubprocessOutputReadercompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
SubprocessSpawnSpeccompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
SubprocessStdinModecompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
SubprocessStdiocompletepackages/subprocess/subprocess/src/types.tsdocs/subsystems/subprocess.md
TerminalBackendcompletepackages/terminal/terminal/src/types.tsdocs/subsystems/terminal.md
TerminalBackendSessioncompletepackages/terminal/terminal/src/types.tsdocs/subsystems/terminal.md
TerminalSendOperationcompletepackages/terminal/terminal/src/types.tsdocs/subsystems/terminal.md
TerminalSendResultcompletepackages/terminal/terminal/src/types.tsdocs/subsystems/terminal.md
TerminalSessionStatuscompletepackages/terminal/terminal/src/types.tsdocs/subsystems/terminal.md
TerminalWaitReasoncompletepackages/terminal/terminal/src/types.tsdocs/subsystems/terminal.md
InvocationDescriptorcompletepackages/typert/protocol/src/types.tsdocs/subsystems/typert.md
InvocationParameterDescriptorcompletepackages/typert/protocol/src/types.tsdocs/subsystems/typert.md
TypertClientRemotecompletepackages/typert/protocol/src/types.tsdocs/subsystems/typert.md
TypertCodeccompletepackages/typert/protocol/src/types.tsdocs/subsystems/typert.md
TypertContextMapcompletepackages/typert/protocol/src/types.tsdocs/subsystems/typert.md
TypertLookupDefinitioncompletepackages/typert/protocol/src/types.tsdocs/subsystems/typert.md
TypertLookupMapcompletepackages/typert/protocol/src/types.tsdocs/subsystems/typert.md
TypertRegistryContractcompletepackages/typert/protocol/src/types.tsdocs/subsystems/typert.md
TypertRemoteNamespaceMapcompletepackages/typert/protocol/src/types.tsdocs/subsystems/typert.md
Brandedcompletepackages/util/brand/src/index.tsdocs/subsystems/core.md
WebFetchBodycompletepackages/web/web/src/types.tsdocs/subsystems/web.md
WebFetchRequestcompletepackages/web/web/src/types.tsdocs/subsystems/web.md
WebFetchResultcompletepackages/web/web/src/types.tsdocs/subsystems/web.md
WebSearchRequestcompletepackages/web/web/src/types.tsdocs/subsystems/web.md
WebSearchResultcompletepackages/web/web/src/types.tsdocs/subsystems/web.md
WebSearchSourcecompletepackages/web/web/src/types.tsdocs/subsystems/web.md
WorkflowRuncompletepackages/workflow/workflow/src/runtime-types.tsdocs/subsystems/workflow.md
WorkflowStartRequestcompletepackages/workflow/workflow/src/runtime-types.tsdocs/subsystems/workflow.md
WorkflowMetacompletepackages/workflow/workflow/src/types.tsdocs/subsystems/workflow.md
WorkflowResultcompletepackages/workflow/workflow/src/types.tsdocs/subsystems/workflow.md
Workspacecompletepackages/workspace/workspace/src/types.tsdocs/subsystems/workspace.md
WorkspaceIdcompletepackages/workspace/workspace/src/types.tsdocs/subsystems/workspace.md

8. Event and service indexes

The durable Session log and live Cordis bus are different planes and are never combined into one total. Durable rows come from the persistence-catalog generator. Live rows and host services come from the host-face Typert model; client-face and inherited framework APIs are out of scope.

Durable Session log vocabulary · 44
EventMode / surfacePayload or signaturePinned source
agent-preset/selectedlog-only{ agentPreset: string }packages/preset/agent-presets/src/session.ts:26
agent/inbox/splicedlog-only{ target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled' }packages/core/agent/src/types.ts:19
approval/askedlog-only{ id: ApprovalRequestId; toolName: string; callId?: CallId; reason?: string }packages/interaction/user-approval/src/index.ts:44
approval/decidedlog-only{ id: ApprovalRequestId; outcome: ApprovalOutcome }packages/interaction/user-approval/src/index.ts:55
approval/policylog-only{ policy: ApprovalPolicy; source?: 'delegation' }packages/interaction/user-approval/src/index.ts:67
assistant/chunklog-only{ turn: number; step: number; chunk: StreamChunk }packages/core/session/src/types.ts:266
assistant/messagesurface{ turn: number; step: number; message: AssistantMessage; usage?: TokenUsage }packages/core/session/src/types.ts:273
command/donelog-only{ commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: number }packages/interaction/commands/src/types.ts:95
command/runlog-only{ commandId: CommandId; name: string; args?: string; source: CommandSource }packages/interaction/commands/src/types.ts:88
compaction/endlog-only{ compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string }packages/compaction/compaction/src/types.ts:71
compaction/prunelog-only{ shadowedRange: { start: number; end: number }; shadowedSeqs: number[]; shadowedTokenCount: number }packages/compaction/compaction/src/types.ts:81
compaction/startlog-only{ compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null }packages/compaction/compaction/src/types.ts:23
compaction/summarylog-only{ compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: number; end: number }; shadowedSeqs: number[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage } & ({ rawOutput: ContentBlock[]; llmStreamCall: true } | { rawOutput?: ContentBlock[]; llmStreamCall?: never })packages/compaction/compaction/src/types.ts:33
feedback/recordlog-only{ text: string }packages/feedback/command-feedback/src/index.ts:62
goal/changelog-onlyGoalChangeMetapackages/goal/goal/src/domain.ts:66
hook/invokedlog-only{ turn: number; point: string; dialect: HookDialect; matcher?: string; handlerId: string }packages/hooks/hook-protocol/src/types.ts:19
hook/resultlog-only{ turn: number; point: string; handlerId: string; decision: string; exitCode?: number; stderrSummary?: string; durationMs: number }packages/hooks/hook-protocol/src/types.ts:31
llm/retrylog-onlyLlmRetryEventDatapackages/llm/llm-retry/src/types.ts:9
llm/retry-startedlog-onlyLlmRetryStartedEventDatapackages/llm/llm-retry/src/types.ts:11
permission/presetlog-only{ preset: string }packages/interaction/permission-presets/src/index.ts:50
plan/modelog-only{ active: boolean }packages/plan/plan-mode/src/index.ts:53
request/contextlog-onlyRequestContextpackages/core/session/src/types.ts:309
request/headerlog-only{ header: EpochHeader; reason: RequestHeaderReason }packages/core/session/src/types.ts:304
sandbox/modelog-only{ mode: SandboxMode; source?: 'delegation' }packages/sandbox/sandbox-policy/src/session-mode.ts:33
schedule/changelog-onlyScheduleChangepackages/schedule/schedule/src/types.ts:219
session/end-seedlog-onlyRecord<string, never>packages/core/session/src/types.ts:332
session/titlelog-onlySessionTitleEventDatapackages/session/session-title/src/index.ts:100
session/title-llm-requestlog-onlySessionTitleLlmRequestEventDatapackages/session/session-title-llm/src/index.ts:43
step/endlog-only{ turn: number; step: number }packages/core/session/src/types.ts:256
step/startlog-only{ turn: number; step: number }packages/core/session/src/types.ts:254
subagent/descriptorlog-onlySubagentDescriptorDatapackages/subagent/subagent/src/descriptor.ts:37
todo/writelog-only{ todos: TodoItem[] }packages/core/session/src/types.ts:299
tool-workflow/agent-endlog-onlyToolWorkflowAgentEndDatapackages/workflow/tool-workflow/src/types.ts:57
tool-workflow/agent-startlog-onlyToolWorkflowAgentStartDatapackages/workflow/tool-workflow/src/types.ts:52
tool-workflow/run-endlog-onlyToolWorkflowRunEndDatapackages/workflow/tool-workflow/src/types.ts:62
tool-workflow/run-startlog-onlyToolWorkflowRunStartDatapackages/workflow/tool-workflow/src/types.ts:47
tool/calllog-only{ turn: number; step: number; callId: CallId; name: string; arguments: string }packages/core/session/src/types.ts:279
tool/code-dispatchlog-onlyCodeDispatchEventDatapackages/core/tools/src/types.ts:56
tool/code-dispatch-startlog-onlyCodeDispatchStartEventDatapackages/core/tools/src/types.ts:40
tool/resultsurface{ turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string }; meta?: JsonValue }packages/core/session/src/types.ts:291
turn/endlog-only{ turn: number; reason: TurnEndReason }packages/core/session/src/types.ts:252
turn/startlog-only{ turn: number }packages/core/session/src/types.ts:243
user/messagesurfaceUserMessagepackages/core/session/src/types.ts:264
web/deepseek-search-llm-requestlog-onlyDeepSeekSearchLlmRequestpackages/web/web-search-deepseek/src/provider.ts:83
Live Cordis host-bus vocabulary · 56
EventMode / surfacePayload or signaturePinned source
agent-loop/config-start-failedemit'agent-loop/config-start-failed'(payload: { sessionId: SessionId; error: unknown }): voidpackages/core/agent-loop/src/index.ts:183
agent-preset/selectedemit'agent-preset/selected'(sessionId: SessionId, agentPreset: string): voidpackages/preset/agent-presets/src/types.ts:13
agent/createdemit'agent/created'(this: Scoped<Agent>, payload: { agent: Agent }): voidpackages/core/agent/src/runtime-types.ts:159
agent/disposedemit'agent/disposed'(this: Scoped<Agent>, payload: { agent: Agent }): voidpackages/core/agent/src/runtime-types.ts:168
agent/erroremit'agent/error'(this: Scoped<Agent>, payload: { agent: Agent; turn: number; step: number; error: unknown }): voidpackages/core/agent/src/runtime-types.ts:290
agent/inbox/claimedemit'agent/inbox/claimed'(this: Scoped<Agent>, payload: { agent: Agent; message: UserMessage; turn: number }): voidpackages/core/agent/src/runtime-types.ts:197
agent/inbox/discardedemit'agent/inbox/discarded'(this: Scoped<Agent>, payload: { agent: Agent; message: UserMessage }): voidpackages/core/agent/src/runtime-types.ts:205
agent/inbox/insertedemit'agent/inbox/inserted'(this: Scoped<Agent>, payload: { agent: Agent; message: UserMessage }): voidpackages/core/agent/src/runtime-types.ts:186
agent/pre-stepwaterfall'agent/pre-step'(this: Scoped<Agent>, payload: { agent: Agent; messages: UserMessage[]; turn: number; step: number; signal: AbortSignal }, next: () => Promise<PreStepDecision>): Promise<PreStepDecision>packages/core/agent/src/runtime-types.ts:231
agent/requestwaterfall'agent/request'(this: Scoped<Agent>, payload: { agent: Agent; turn: number; step: number; signal: AbortSignal }, next: () => Promise<LlmCallConfig>): Promise<LlmCallConfig>packages/core/agent/src/runtime-types.ts:244
agent/request-errorwaterfall'agent/request-error'(this: Scoped<Agent>, payload: { agent: Agent; turn: number; step: number; provider: string; failure: LlmFailure; retryPolicy: ResolvedRetryPolicy | undefined; signal: AbortSignal }, next: () => Promise<RequestErrorAction>): Promise<RequestErrorAction>packages/core/agent/src/runtime-types.ts:260
agent/session-startemit'agent/session-start'(this: Scoped<Agent>, payload: { agent: Agent; source: SessionStartSource }): voidpackages/core/agent/src/runtime-types.ts:217
agent/statusemit'agent/status'(this: Scoped<Agent>, payload: { agent: Agent; status: AgentStatus }): voidpackages/core/agent/src/runtime-types.ts:178
agent/turn-stoppingserial'agent/turn-stopping'(this: Scoped<Agent>, payload: { agent: Agent; turn: number; signal: AbortSignal }): Promise<void> | voidpackages/core/agent/src/runtime-types.ts:278
approval/requestwaterfall'approval/request'(this: Scoped<ApprovalService>, req: ApprovalRequest, next: () => Promise<ApprovalOutcome>): Promise<ApprovalOutcome>packages/interaction/user-approval/src/index.ts:30
commands/changeemit'commands/change'(): voidpackages/interaction/commands/src/types.ts:72
cordis/dynamic-packageemit'cordis/dynamic-package'(pkg: DynamicCordisPackage): voidpackages/extensions/cordis-host-runner/src/types.ts:379
cordis/dynamic-retractemit'cordis/dynamic-retract'(retracted: DynamicCordisRetracted): voidpackages/extensions/cordis-host-runner/src/types.ts:385
cordis/inspect-queryemit'cordis/inspect-query'(request: CordisInspectQueryRequest): voidpackages/extensions/cordis-host-runner/src/types.ts:391
cordis/inspect-query-resolvedemit'cordis/inspect-query-resolved'(resolved: CordisInspectQueryResolved): voidpackages/extensions/cordis-host-runner/src/types.ts:397
cordis/request-runemit'cordis/request-run'(request: DynamicCordisRunRequest): voidpackages/extensions/cordis-host-runner/src/types.ts:367
cordis/request-run-resolvedemit'cordis/request-run-resolved'(resolved: DynamicCordisRequestResolved): voidpackages/extensions/cordis-host-runner/src/types.ts:373
credentials/updatedemit'credentials/updated'(ref: CredentialRef): voidpackages/credentials/credentials/src/types.ts:29
domain/changedemit'domain/changed'(change: DomainChanged): voidpackages/storage/storage-domain/src/events.ts:46
fs/edit-intentwaterfall'fs/edit-intent'(target: FsTarget, actor: object | undefined, next: () => { version: FsVersion } | undefined | Promise<{ version: FsVersion } | undefined>): Promise<{ version: FsVersion } | undefined>packages/fs/fs/src/index.ts:66
fs/observedemit'fs/observed'(target: FsTarget, observation: FsObservation, actor: object | undefined): voidpackages/fs/fs/src/index.ts:76
fs/write-intentwaterfall'fs/write-intent'(target: FsTarget, actor: object | undefined, next: () => FsWriteIntent | undefined | Promise<FsWriteIntent | undefined>): Promise<FsWriteIntent | undefined>packages/fs/fs/src/index.ts:58
goal/changedemit'goal/changed'(this: import('@deepseek-ai/dsh-scope').Scoped<Agent>, payload: { agent: Agent; change: GoalChanged }): voidpackages/goal/goal/src/domain.ts:114
llm/adapters-updatedemit'llm/adapters-updated'(): voidpackages/llm/llm/src/types.ts:23
llm/streamwaterfall'llm/stream'(this: LlmRuntime, options: GenerateOptions, next: () => AsyncIterable<StreamChunk>): AsyncIterable<StreamChunk>packages/llm/llm/src/index.ts:64
session-telemetry/recordwaterfall'session-telemetry/record'(record: SessionTelemetryRecord, next: () => SessionTelemetryRecord): SessionTelemetryRecordpackages/session/session-telemetry/src/index.ts:43
session/createdemit'session/created'(this: Scoped<Session>, session: Session): voidpackages/core/session/src/index.ts:54
session/disposedemit'session/disposed'(this: Scoped<Session>, session: Session): voidpackages/core/session/src/index.ts:64
session/eventemit'session/event'(this: Scoped<Session>, session: Session, event: SessionEvent): voidpackages/core/session/src/index.ts:76
session/flushparallel'session/flush'(this: Scoped<Session>, session: Session): Promise<void> | voidpackages/core/session/src/index.ts:85
settings/document-updatedemit'settings/document-updated'(ns: SettingsNamespace, revision: number): voidpackages/settings/settings/src/types.ts:48
settings/updatedemit'settings/updated'(ns: SettingsNamespace, next: unknown, prev: unknown, source: SettingsUpdateSource): voidpackages/settings/settings/src/types.ts:35
skills/changeemit'skills/change'(): voidpackages/skill/skill/src/index.ts:297
subagent/endemit'subagent/end'(this: Scoped<SubagentRuntime>, info: SubagentRunEndInfo): voidpackages/subagent/subagent/src/index.ts:166
subagent/provider-addedemit'subagent/provider-added'(provider: SubagentProvider): voidpackages/subagent/subagent/src/index.ts:140
subagent/provider-removedemit'subagent/provider-removed'(name: string): voidpackages/subagent/subagent/src/index.ts:146
subagent/startemit'subagent/start'(this: Scoped<SubagentRuntime>, info: SubagentRunInfo): voidpackages/subagent/subagent/src/index.ts:157
system-prompt/assemblewaterfall'system-prompt/assemble'(this: Scoped<SystemPrompt>, assembly: PromptAssembly, context: AssembleContext, next: () => Promise<PromptAssembly>): Promise<PromptAssembly>packages/core/system-prompt/src/index.ts:31
system-prompt/changeemit'system-prompt/change'(): voidpackages/core/system-prompt/src/index.ts:37
tools/changeemit'tools/change'(): voidpackages/core/tools/src/index.ts:207
tools/code-dispatch-logwaterfall'tools/code-dispatch-log'(this: Scoped<ToolRuntime>, dispatch: CodeDispatchLog, next: () => Promise<ContentBlock[]>): Promise<ContentBlock[]>packages/core/tools/src/index.ts:189
tools/executewaterfall'tools/execute'(this: Scoped<ToolRuntime>, exec: ToolDispatchExecution, next: () => Promise<ToolExecutionResult>): Promise<ToolExecutionResult>packages/core/tools/src/index.ts:163
tools/post-executewaterfall'tools/post-execute'(this: Scoped<ToolRuntime>, exec: ToolExecution, result: Readonly<ToolExecutionResult>, next: () => Promise<PostToolDecision>): Promise<PostToolDecision>packages/core/tools/src/index.ts:175
tools/pre-executewaterfall'tools/pre-execute'(this: Scoped<ToolRuntime>, exec: ToolExecution, next: () => Promise<PreToolDecision>): Promise<PreToolDecision>packages/core/tools/src/index.ts:152
tools/resultemit'tools/result'(this: Scoped<ToolRuntime>, exec: Readonly<ToolExecution>, result: Readonly<ToolExecutionResult>): undefinedpackages/core/tools/src/index.ts:197
workflow/agent-endemit'workflow/agent-end'(info: WorkflowRunInfo, agent: WorkflowAgentEndInfo): voidpackages/workflow/workflow/src/index.ts:79
workflow/agent-startemit'workflow/agent-start'(info: WorkflowRunInfo, agent: WorkflowAgentInfo): voidpackages/workflow/workflow/src/index.ts:68
workflow/endemit'workflow/end'(info: WorkflowRunInfo, result: WorkflowResultInfo): voidpackages/workflow/workflow/src/index.ts:89
workflow/logemit'workflow/log'(info: WorkflowRunInfo, message: string): voidpackages/workflow/workflow/src/index.ts:58
workflow/phaseemit'workflow/phase'(info: WorkflowRunInfo, title: string): voidpackages/workflow/workflow/src/index.ts:51
workflow/startemit'workflow/start'(info: WorkflowRunInfo): voidpackages/workflow/workflow/src/index.ts:43
Cordis host services · 56
ServiceClassPublic methodsPinned source
agentDefaultModel
AgentDefaultModelConfig
concretecurrentSelection(): ModelSelection
async saveSelection(next: ModelSelection): Promise<void>
packages/core/agent-default-model/src/index.ts:64
agentLoop
AgentLoop
concretereadonly config: ResolvedConfig
create(id: SessionId, options: AgentOptions = {}, meta: Pick<SessionHeader, 'cwd'> = {}): Agent
async createAgent(ownerCtx: Context, options: CreateAgentOptions): Promise<AgentHandle>
async resume(ownerCtx: Context, options: ResumeAgentOptions): Promise<AgentHandle>
packages/core/agent-loop/src/index.ts:296
agentPresets
AgentPresets
concreteasync list(): Promise<AgentPreset[]>
async resolve(id?: string): Promise<AgentPreset>
async mount(agentCtx: Context, id?: string): Promise<AgentPreset>
composeFrom(agentCtx: Context, parentCtx: Context): string | undefined
composedPreset(agentCtx: Context): string | undefined
async read(id: string): Promise<string>
async copy(from: string, id: string, name?: string): Promise<void>
async remove(id: string): Promise<void>
serviceFor<K extends string & keyof Context>(agent: { ctx: Context }, name: K): Context[K] | undefined
async recompose(agentCtx: Context, id: string): Promise<AgentPreset>
async standingKeyFor(id?: string): Promise<ScopeKey>
packages/preset/agent-presets/src/index.ts:82
agents
AgentRegistry
concretecurrentInitiator(): Agent | undefined
requireInitiator(): Agent
withInitiator<T>(agent: Agent, operation: () => T): T
withoutInitiator<T>(operation: () => T): T
setFactory(factory: AgentFactory): () => void
async create(options: CreateAgentOptions): Promise<AgentHandle>
async resume(options: ResumeAgentOptions): Promise<AgentHandle>
register(agent: Agent): () => void
enter(agent: Agent, owner: Agent | undefined): () => void
announce(agent: Agent): void
get(id: SessionId): Agent | undefined
isOwnedBy(id: SessionId, owner: Agent): boolean
list(): Agent[]
roots(): Agent[]
packages/core/agent/src/index.ts:256
apiProxy
ApiProxy
concretedownloads: DownloadsApi
respond(message: ClientResponse): Promise<RpcReceipt>
packages/host/apiproxy/src/api/index.ts:22
approval
ApprovalService
concretesetPolicy(agent: Agent, policy: ApprovalPolicy): void
async request(req: ApprovalRequest): Promise<ApprovalOutcome>
overrideOf(session: Session): ApprovalPolicy | undefined
packages/interaction/user-approval/src/index.ts:192
attachments
AttachmentStore
abstractabstract readonly imageLimits: ImageAttachmentLimits
abstract validateImage(input: SaveImageAttachment): Promise<void>
abstract saveImage(input: SaveImageAttachment): Promise<ImageAttachmentRef>
abstract readImage(ref: ImageAttachmentRef, signal?: AbortSignal): Promise<StoredImageAttachment>
packages/attachment/attachment/src/index.ts:29
clientModules
ClientModuleRegistry
concretegraph(): WebBootGraph
clientPath(id: string): string | undefined
rebuilt(id: string): string | undefined
onRebuilt(listener: (id: string, rev: string) => void): () => void
onGraphChanged(listener: () => void): () => void
packages/client/modules/src/index.ts:184
codeRuntime
CodeRuntime
abstractabstract readonly language: string
abstract readonly isolation: string
abstract run(request: CodeRunRequest): Promise<CodeRunResult>
packages/code-runtime/code-runtime/src/index.ts:102
commands
CommandRuntime
concreteregister(definition: CommandDefinition): () => void
@Remote list(agent: Agent): readonly CommandDescriptor[]
find(agent: Agent, name: string): CommandDefinition | undefined
@Remote async execute( agent: Agent, line: string, signal: AbortSignal, ): Promise<CommandExecution | undefined>
packages/interaction/commands/src/index.ts:225
compaction
CompactionEngine
abstractabstract compactIfNeeded( agent: CompactionAgentContext, trigger: CompactionTrigger, signal: AbortSignal, ): Promise<CompactionResult | null>
abstract compactNow( agent: ManualCompactAgentContext, signal: AbortSignal, sourceCommandId?: CommandId, ): Promise<CompactionResult | null>
abstract compactRegion( start: number, end: number, agent: CompactionAgentContext, signal?: AbortSignal, ): Promise<CompactionResult>
packages/compaction/compaction/src/index.ts:96
cordisInspect
CordisInspectRegistryService
concreteregister(registration: HostCordisInspectProviderRegistration): () => void
syncClientManifest(providers: readonly CordisInspectProviderManifest[]): void
list(): CordisInspectProviderView[]
async query( platform: CordisInspectPlatform, providerId: string, methodName: string, input: JsonValue | undefined, agent: Agent, signal: AbortSignal, ): Promise<JsonValue>
resolveClientQuery( agent: Agent, requestId: CordisInspectRequestId, resolution: CordisInspectQueryResolution, ): CordisInspectResolveAck
packages/extensions/cordis-host-runner/src/inspect-registry.ts:46
credentials
CredentialProvider
abstractabstract resolve(ref: CredentialRef): Promise<ResolvedCredential | undefined>
abstract describe(ref: CredentialRef): Promise<CredentialInfo>
abstract set(ref: CredentialRef, value: string): Promise<void>
abstract unset(ref: CredentialRef): Promise<void>
packages/credentials/credentials/src/index.ts:60
directoryPicker
DirectoryPicker
abstractabstract capability(): DirectoryPickerCapabilitypackages/host/directory-picker/src/index.ts:131
dynamicCordisRunner
DynamicCordisRunnerService
concretedefine(request: DynamicCordisDefineRequest): DynamicCordisDefineReceipt
async undefine(agent: Agent, pluginId: CordisDynamicPluginId): Promise<DynamicCordisUndefineReceipt>
@Remote('undefineFromPanel') async undefineFromPanel(agent: Agent, pluginId: CordisDynamicPluginId): Promise<DynamicCordisUndefineReceipt>
async run( agent: Agent, pluginId: CordisDynamicPluginId, packageId: CordisDynamicPackageId, mode: CordisDynamicRunMode, signal?: AbortSignal, ): Promise<DynamicCordisRunResponse>
@Remote('runHostHalf') async runHostHalf( agent: Agent, pluginId: CordisDynamicPluginId, packageId: CordisDynamicPackageId, mode: CordisDynamicRunMode, requestId: ApprovalRequestId | null, approveFutureVersions: boolean, ): Promise<DynamicCordisHostHalfResult>
@Remote('getClientCode') getClientCode( agent: Agent, pluginId: CordisDynamicPluginId, pluginRunId: CordisDynamicPluginRunId, ): DynamicCordisClientSource
@Remote('resolveRequestRun') async resolveRequestRun( requestId: ApprovalRequestId, resolution: DynamicCordisRunResolution, ): Promise<DynamicCordisResolveAck>
@Remote('settleUserRun') async settleUserRun( agent: Agent, pluginId: CordisDynamicPluginId, resolution: DynamicCordisRunResolution, ): Promise<DynamicCordisRunResponse>
async stop(agent: Agent, pluginId: CordisDynamicPluginId): Promise<DynamicCordisStopResponse>
@Remote('stopFromPanel') async stopFromPanel(agent: Agent, pluginId: CordisDynamicPluginId): Promise<DynamicCordisStopResponse>
@Remote('syncInspectManifest') syncInspectManifest(providers: readonly CordisInspectProviderManifest[]): null
@Remote('resolveInspectQuery') resolveInspectQuery( agent: Agent, requestId: CordisInspectRequestId, resolution: CordisInspectQueryResolution, ): CordisInspectResolveAck
@Remote('inventory') inventory(): DynamicCordisInventoryRow[]
snapshot(agent: Agent): DynamicCordisSnapshotRow[]
reference(agent: Agent, pluginId: CordisDynamicPluginId): DynamicCordisReference | undefined
listPlugins(agent: Agent): DynamicCordisPluginInspection[]
inspectPlugin(agent: Agent, pluginId: CordisDynamicPluginId): DynamicCordisPluginInspection
inspectPackage( agent: Agent, pluginId: CordisDynamicPluginId, packageId: CordisDynamicPackageId, ): DynamicCordisPackageInspection
@Remote('reportRenderFailure') async reportRenderFailure( agent: Agent, pluginId: CordisDynamicPluginId, pluginRunId: CordisDynamicPluginRunId, failure: DynamicCordisRenderFailure, ): Promise<null>
@Remote('reportClientGuardFailure') async reportClientGuardFailure( agent: Agent, pluginId: CordisDynamicPluginId, pluginRunId: CordisDynamicPluginRunId, failure: CordisErrorDetails, ): Promise<null>
@Remote('invoke') async invoke( pluginId: CordisDynamicPluginId, pluginRunId: CordisDynamicPluginRunId, method: string, args: JsonValue, ): Promise<DynamicCordisInvokeResult>
packages/extensions/cordis-host-runner/src/index.ts:124
e2b
E2BRuntime
concretereadonly cwd: string
readonly runtimeRoot: string
async getSandbox(): Promise<Sandbox>
packages/e2b/e2b/src/index.ts:74
fs
FileSystem
abstractabstract resolve(path: string, opts?: { cwd?: string; signal?: AbortSignal }): Promise<FsTarget>
abstract processPath(target: FsTarget): string
abstract fileUrl(target: FsTarget): string
abstract contains(parent: FsTarget, child: FsTarget): boolean
abstract stat(target: FsTarget, signal?: AbortSignal): Promise<FsInfo | undefined>
abstract lstat(path: string, opts?: { cwd?: string }, signal?: AbortSignal): Promise<FsPathInfo | undefined>
abstract readText(target: FsTarget, signal?: AbortSignal): Promise<string>
abstract streamText(target: FsTarget, signal?: AbortSignal): Promise<AsyncIterable<string>>
abstract readBytes(target: FsTarget, signal: AbortSignal | undefined, maxBytes: number): Promise<Uint8Array>
abstract listDir(target: FsTarget, signal?: AbortSignal): Promise<FsDirEntry[]>
abstract writeText( target: FsTarget, content: string, expected?: FsWriteIntent, signal?: AbortSignal, sandboxPolicy?: SandboxExecutionPolicy, ): Promise<FsWriteOutcome>
abstract editText( target: FsTarget, edit: FsEditRequest, expected?: { version: FsVersion }, signal?: AbortSignal, sandboxPolicy?: SandboxExecutionPolicy, ): Promise<FsEditOutcome>
packages/fs/fs/src/index.ts:86
goals
GoalService
concreteget(agent: Agent): GoalView | undefined
disarm(agent: Agent): GoalView | undefined
create(agent: Agent, request: CreateGoalRequest): GoalView
@Remote('edit') edit(agent: Agent, ref: GoalRef, request: EditGoalRequest): GoalView
@Remote('pause') pause(agent: Agent, ref: GoalRef): GoalView
@Remote('resume') resume(agent: Agent, ref: GoalRef): GoalView
@Remote('complete') complete(agent: Agent, ref: GoalRef): GoalView
block(agent: Agent, ref: GoalRef, reason: GoalBlockReason): GoalView
@Remote('clear') clear(agent: Agent, ref: GoalRef): GoalRef
@Remote('create') remoteExportCreate(agent: Agent, request: CreateGoalRequest): CreateGoalResult
packages/goal/goal/src/index.ts:183
invariants
InvariantRegistry
concreteregister(packageName: string, installer: InvariantInstaller): () => voidpackages/runtime-diagnostics/invariants/src/index.ts:94
jobs
JobRegistry
abstractabstract start(spec: JobStart): JobId
abstract list(caller?: Agent): JobSnapshot[]
abstract get(id: JobId, caller?: Agent): JobSnapshot
abstract read(id: JobId, caller?: Agent): JobRead
abstract kill(id: JobId, caller?: Agent, reason?: string): 'requested' | 'already-finished'
abstract wait(id: JobId, timeoutMs: number, caller?: Agent, signal?: AbortSignal): Promise<JobSnapshot>
abstract onJobDone(listener: JobDoneListener): () => void
abstract onJobsChanged(listener: JobsChangedListener): () => void
abstract attachController(name: string): () => void
packages/jobs/jobs/src/index.ts:62
llm
LlmRuntime
concreteregisterAdapter(providers: string[], adapter: LlmAdapter): AdapterRegistrationHandle
listProviders(): LlmProviderInfo[]
registerConfigurableProviders(entries: readonly LlmConfigurableProvider[]): DirectoryRegistrationHandle
listConfigurableProviders(): LlmConfigurableProvider[]
registerModelDiscovery( settingsNs: string, discover: (request: LlmModelDiscoveryRequest) => Promise<readonly LlmDiscoveredModel[]>, ): () => void
async discoverModels( settingsNs: string, request: LlmModelDiscoveryRequest, ): Promise<LlmDiscoveredModel[]>
providerRetryPolicy(provider: string): ResolvedRetryPolicy
async listModels(provider: string): Promise<LlmModelInfo[]>
async resolveModelInfo( provider: string, model: string, signal?: AbortSignal, ): Promise<LlmResolvedModelInfo>
async resolveCallConfig(config: LlmCallConfig, signal?: AbortSignal): Promise<LlmCallConfig>
async prepareCall(config: LlmCallConfig, signal?: AbortSignal): Promise<PreparedLlmCall>
stream(options: GenerateOptions): AsyncIterable<StreamChunk>
packages/llm/llm/src/index.ts:284
lsp
LspService
concreteregisterProvider(provider: LspProvider): () => void
query(request: LspQueryRequest, signal?: AbortSignal): Promise<LspQueryResult>
packages/lsp/lsp/src/types.ts:113
messageFeedback
MessageFeedbackService
concrete@Remote('list') async list(request: MessageFeedbackListRequest): Promise<MessageFeedbackListResult>
@Remote('put') put(request: MessageFeedbackPutRequest): Promise<MessageFeedbackPutResult>
@Remote('delete') delete(request: MessageFeedbackDeleteRequest): Promise<MessageFeedbackDeleteResult>
packages/feedback/message-feedback/src/index.ts:150
permissionPresets
PermissionPresetService
concretecurrent(events: readonly SessionEvent[]): string
selectFor(state: KnobState): PermissionSelect
resolve(name: string): PresetSpec
optionOf(name: string): PresetOption
set(session: Session, name: string): void
packages/interaction/permission-presets/src/index.ts:159
planMode
PlanModeController
concreteget(agent: Agent): { active: boolean; pending?: boolean }
set(agent: Agent, active: boolean): 'committed' | 'queued' | 'cancelled' | 'noop'
packages/plan/plan-mode/src/index.ts:184
sandbox
SandboxProvider
abstractabstract confine(argv: readonly string[], policy: SandboxPolicy): ConfinedArgvpackages/sandbox/sandbox/src/index.ts:158
sandboxPolicy
SandboxPolicyService
concretereadonly defaultMode: SandboxMode
readonly workspaceRoot: string
resolve(request: SandboxPolicyRequest = {}): SandboxExecutionPolicy
overrideOf(session: Session): SandboxMode | undefined
packages/sandbox/sandbox-policy/src/index.ts:91
sessionPersistence
SessionPersistence
abstractabstract locate(meta: SessionHeader): SessionLocation | undefined
abstract readonly supportsRawArtifacts: boolean
readRaw(_id: SessionId, signal?: AbortSignal): Promise<SessionRawArtifact | undefined>
abstract create(meta: SessionHeader): Promise<void>
abstract append(id: SessionId, events: readonly SessionEvent[]): Promise<void>
async prepare(id: SessionId, signal?: AbortSignal): Promise<SessionPreparation>
abstract load(id: SessionId): Promise<SessionInspection>
abstract inspect(id: SessionId, signal?: AbortSignal): Promise<SessionInspection>
abstract readFrom(id: SessionId, fromSeq: number, signal?: AbortSignal): Promise<{ meta: SessionHeader; events: SessionEvent[] }>
abstract list(signal?: AbortSignal): Promise<SessionHeader[]>
abstract listSnapshots(signal?: AbortSignal): Promise<SessionPersistenceSnapshot[]>
packages/session/session-persistence/src/index.ts:84
sessionProjectionCache
SessionProjectionCache
concretecachedSnapshot(meta: SessionHeader): ProjectionSnapshot | undefined
async write(session: Session): Promise<void>
async coldSnapshot(id: SessionId, signal?: AbortSignal): Promise<ProjectionSnapshot>
packages/session/session-projection-cache/src/index.ts:71
sessionProjections
SessionProjectionRegistry
concreteregister<K extends keyof SessionProjectionMap, S>(definition: ProjectionDefinition<K, S>): () => void
onChanged(listener: ProjectionChangeListener): () => void
snapshot(session: Session): ProjectionSnapshot
checkpoint(session: Session): ProjectionCheckpoint
restoreFloor(checkpoint: ProjectionCheckpoint): number | undefined
viewCheckpoint(checkpoint: ProjectionCheckpoint): Partial<SessionProjectionMap>
restore(checkpoint: ProjectionCheckpoint, events: readonly SessionEvent[], baseSeq: number): { snapshot: ProjectionSnapshot; checkpoint: ProjectionCheckpoint }
packages/session/session-projection/src/index.ts:171
sessionQuery
SessionQueryEngine
abstractabstract searchSessions( request: SessionSearchRequest, exec?: SessionSearchExecContext, ): Promise<SessionSearchPage<SessionSearchHit>>
abstract searchEvents( request: SessionEventSearchRequest, exec?: SessionSearchExecContext, ): Promise<SessionEventSearchPage>
listSessions(signal?: AbortSignal): Promise<SessionRecord[]>
async readSession(sessionId: SessionId): Promise<SessionLogSnapshot>
async filterSessions( filters: readonly SessionResultFilter[], signal?: AbortSignal, ): Promise<SessionRecord[]>
async readTitle( sessionId: SessionId, signal?: AbortSignal, ): Promise<SessionTitleSnapshot | undefined>
async readTitleSnapshot( sessionId: SessionId, signal?: AbortSignal, ): Promise<SessionTitleObservation>
async readTitleSnapshots( sessionIds: readonly SessionId[], signal?: AbortSignal, ): Promise<SessionTitleObservationResult[]>
async listEvents(sessionId: SessionId): Promise<SessionEventRecord[]>
async filterEvents( sessionId: SessionId, filters: readonly SessionEventResultFilter[], ): Promise<SessionEventSearchDocument[]>
async readSurface(sessionId: SessionId): Promise<SessionSurfaceSnapshot>
async traceSession(sessionId: SessionId, signal?: AbortSignal): Promise<SessionLineageTrace>
async traceEvent(request: SessionEventTraceRequest, signal?: AbortSignal): Promise<SessionEventTraceObservation>
async readEvent(request: SessionEventReadRequest, signal?: AbortSignal): Promise<SessionEventWindow>
packages/session-query/session-query/src/index.ts:81
sessionReferenceResolver
SessionReferenceResolver
concreteasync listCandidates( agent: Agent, query: string = '', limit: number = this.config.candidateLimit, signal?: AbortSignal, ): Promise<SessionReferenceCandidate[]>
async prepare( agent: Agent, content: ContentBlock[], references: SessionReferenceInput[], signal?: AbortSignal, ): Promise<PreparedReferencedMessage>
packages/context/session-reference/src/index.ts:70
sessions
SessionStore
concretecreate(id?: SessionId, options?: CreateSessionOptions): Session
prepare(id?: SessionId, options?: PrepareSessionOptions): Session
enter(session: Session): () => void
announce(session: Session): void
async flush(session: Session): Promise<boolean>
get(id: SessionId): Session | undefined
list(): Session[]
fork(source: SessionForkSource, boundary?: number, childSessionId?: SessionId): Session
packages/core/session/src/index.ts:792
sessionTelemetry
SessionTelemetryBackend
abstractabstract readonly sharing: SessionTelemetrySharingStatus
abstract emit(record: SessionTelemetryRecord): void
flush?(): void
abstract shutdown(): Promise<void>
packages/session/session-telemetry/src/index.ts:148
sessionTitle
SessionTitleService
concreteget(session: Session): SessionTitleSnapshot | undefined
rename(session: Session, title: string): SessionTitleSnapshot
async refresh(session: Session, signal?: AbortSignal): Promise<SessionTitleSnapshot | undefined>
register(provider: SessionTitleProvider): () => Promise<void>
packages/session/session-title/src/index.ts:261
settings
SettingsProvider
abstractabstract readonly writable: boolean
prepareDocument(): Promise<string | undefined>
register<T>(ns: SettingsNamespace, schema: z<T>, options?: SettingsRegisterOptions<T>): SettingsScope<T>
describe(options?: SettingsDescribeOptions): SettingsDescriptor[]
get(ns: SettingsNamespace): unknown
async update(ns: SettingsNamespace, patch: object, expectedRevision?: number): Promise<void>
async replace(ns: SettingsNamespace, section: object, expectedRevision?: number): Promise<void>
async mutate(ns: SettingsNamespace, ops: readonly SettingsPathOp[], expectedRevision?: number): Promise<void>
packages/settings/settings/src/index.ts:350
shell
ShellExecutor
abstractabstract resolve(request: ShellExecRequest): ShellExecSpec
abstract run(spec: ShellExecSpec): Promise<ShellRunResult>
abstract start(spec: ShellExecSpec): ShellProcess
packages/shell/shell/src/index.ts:65
shellEnv
ShellEnvRegistry
concreteregister(contributor: BashEnvContributor): () => void
collect(execution: ToolExecution): DshEnvironment
list(): BashEnvVariableInfo[]
packages/shell/shell-env/src/index.ts:89
skills
SkillRegistry
concreteregisterProvider(create: (control: SkillProviderControl) => SkillProvider): () => void
register(skill: SkillRegistration): () => void
async list(options: SkillViewOptions = {}): Promise<SkillSummary[]>
async snapshot(options: SkillViewOptions = {}): Promise<SkillCatalogSnapshot>
async get(name: string, options: SkillViewOptions = {}): Promise<SkillDefinition | undefined>
packages/skill/skill/src/index.ts:357
spillStore
SpillStore
abstractabstract saveText(input: SaveTextSpill): Promise<SpillRef>packages/spill/spill/src/index.ts:45
storage
Storage
concretereadonly backend: BackendRegistry = new BackendRegistry()
mount<K extends keyof StorageForms>(form: K, facility: StorageForms[K]): () => void
form<K extends keyof StorageForms>(form: K): StorageForms[K]
packages/storage/storage/src/index.ts:47
storageDomain
DomainFacility
concreteasync open<S extends DomainSpec>(spec: S): Promise<Domain<S>>
get(name: string): DomainImpl | undefined
async closeAll(): Promise<void>
packages/storage/storage-domain/src/index.ts:69
subagents
SubagentRuntime
concreteasync startContinuable(spec: ContinuableStartSpec): Promise<ContinuableStart>
async followup( parent: Agent, childId: SessionId, content: ContentBlock[], options: SubagentFollowupOptions, ): Promise<MessageId>
interrupt(targetSessionId: SessionId, authority: SubagentInterruptAuthority): void
async reportFrom( child: Agent, content: ContentBlock[], options: SubagentReportOptions, ): Promise<MessageId>
registerContinuableSetup(contribution: ContinuableSetupContribution): () => void
async drainContinuableDescendants(parents: readonly Agent[]): Promise<void>
listChildren(parentSessionId: SessionId, signal?: AbortSignal): Promise<SubagentListEntry[]>
listDescendants(rootSessionId: SessionId, signal?: AbortSignal): Promise<SubagentDescendantListEntry[]>
registerProvider(provider: SubagentProvider): () => void
getProvider(name: string): SubagentProvider | undefined
list(): string[]
async start(name: string, request: SubagentStartRequest): Promise<SubagentRun>
packages/subagent/subagent/src/index.ts:171
subprocess
SubprocessRuntime
abstractabstract resolveExecutable( command: string, env?: Readonly<Record<string, string>>, signal?: AbortSignal, ): Promise<string>
abstract spawn(spec: SubprocessSpawnSpec): SubprocessHandle
abstract spawnTerminal(spec: SubprocessTerminalSpawnSpec): Promise<SubprocessTerminalHandle>
packages/subprocess/subprocess/src/index.ts:102
systemPrompt
SystemPrompt
concretesection(section: PromptSection): () => void
context(context: PromptContext): () => void
suppressRuntimeContext(): () => void
tools(provider: (context: AssembleContext) => ToolProviderResult): () => void
variable(name: string, provider: (context: AssembleContext) => string | undefined): () => void
async assemble(context: AssembleContext = {}): Promise<PromptAssembly>
packages/core/system-prompt/src/index.ts:338
terminals
TerminalSessionService
concreteregisterBackend(backend: TerminalBackend): () => void
listBackends(): string[]
async spawn(owner: Agent, request: TerminalSpawnRequest, signal?: AbortSignal): Promise<TerminalSpawnResult>
hasOwnerActivity(owner: Agent): boolean
startSend(owner: Agent, id: TerminalSessionId, request: TerminalSendRequest): TerminalSendOperation
read(owner: Agent, id: TerminalSessionId, request: TerminalReadRequest = {}): TerminalReadResult
signal(owner: Agent, id: TerminalSessionId, signal: TerminalSignal): Promise<TerminalSignalResult>
async kill(owner: Agent, id: TerminalSessionId, reason: string = 'model request'): Promise<boolean>
list(owner: Agent): TerminalSessionSnapshot[]
packages/terminal/terminal/src/index.ts:105
tokenMeter
TokenMeter
concretemeasure(session: Session, requestHeader?: EpochHeader): TokenMeasurement
estimateMessage(message: Message): number
packages/llm/token-meter/src/index.ts:74
toolResultPruner
ToolResultPruner
concretereadonly config: ResolvedConfig
measureContent(blocks: readonly ContentBlock[]): number
pruneContent(blocks: readonly ContentBlock[]): ContentBlock[] | null
pruneSession(session: Session): PruneResult
packages/compaction/compaction-tool-result-pruner/src/index.ts:44
tools
ToolRuntime
concretepresentAs(mode: ToolPresentationMode): () => void
register(definition: ToolDefinition): () => void
restrict(filter: ToolRestriction): () => void
guard(guard: ToolGuard): () => void
get(name: string, scope?: ScopeKey): ToolDefinition | undefined
schemas(scope?: ScopeKey): ToolSchema[]
executionMode(exec: ToolExecutionInput): ToolExecutionMode
async execute(exec: ToolExecutionInput): Promise<ToolExecutionResult>
packages/core/tools/src/index.ts:787
typert
TypertRegistry
concreteregister(contribution: TypertContribution): TypertDisposer
get(key: string): TypertSchemaRecord | undefined
resolve(key: string): TypertSchemaRecord
list(filter: TypertSchemaFilter = {}): TypertSchemaRecord[]
getPackage(packageName: string, face: TypertFace = 'host'): TypertPackageRecord | undefined
listPackages(filter: TypertPackageFilter = {}): TypertPackageRecord[]
toJSONSchema(key: string, params?: z.core.ToJSONSchemaParams): z.core.JSONSchema.BaseSchema
packages/typert/registry/src/service.ts:446
typertGateway
TypertGatewayService
concreteasync invoke(request: InvokeRemoteRequest): Promise<unknown>packages/api/gateway/src/index.ts:90
userQuestions
UserQuestionService
concreteregisterProvider(provider: UserQuestionProvider): () => void
async ask(request: AskUserQuestionRequest): Promise<AskUserQuestionAnswer>
packages/interaction/user-questions/src/index.ts:51
web
WebRuntime
concreteregisterSearchProvider(provider: WebSearchProvider): () => void
registerFetchProvider(provider: WebFetchProvider): () => void
async search(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>
async fetch(request: WebFetchRequest, signal?: AbortSignal): Promise<WebFetchResult>
packages/web/web/src/index.ts:74
webServer
WebServer
concreteregister(route: WebRoute): () => void
registerUpgrade(route: WebUpgradeRoute): () => void
registerFallback(handler: WebRoute['handler']): () => void
tapIndex(transform: (html: string) => string): () => void
applyIndexTaps(html: string): string
packages/host/webserver/src/index.ts:59
workflowEngine
WorkflowEngine
abstractabstract start(request: WorkflowStartRequest): WorkflowRunpackages/workflow/workflow/src/index.ts:157
workspaceRegistry
WorkspaceRegistry
concreteasync create(path: string, title?: string): Promise<Workspace>
get(id: WorkspaceId): Workspace | undefined
list(): Workspace[]
delete(id: WorkspaceId): Promise<boolean>
insertBefore(id: WorkspaceId, beforeId?: WorkspaceId): Promise<readonly WorkspaceId[]>
archiveSession(sessionId: SessionId): Promise<void>
async resolveByPath(path: string): Promise<Workspace | undefined>
packages/workspace/workspace/src/index.ts:92

9. Limits and reproduction

These indexes establish deterministic navigation within named structured universes. They do not establish complete repository symbol coverage, complete file coverage, downstream-plugin event coverage, claim coverage, or proof quality. Regeneration fails closed on baseline drift, bilingual citation drift, unknown IDs, invalid source ranges, duplicate identities, or leaked self-citations.

node scripts/generate-ch35.mjs --analysis-root . --upstream-root ../deepseek-harness --output-root .
  • Pinned baseline and every catalog path/range verified.
  • Bilingual citation sequences compared before counting.
  • Chapter 35 excluded and generated fragments contain no citation tags.

My Learning Notes

Autosaved only in this browser. Nothing is uploaded or committed. Export Markdown whenever you want to keep a copy.