stitchkit 0.110.2 → 0.110.4

package/llms/agent-runtime.3.txt

@@ -104,6 +104,7 @@ Server-only optional application runtime. See the
 | `AgentStoreEventEnvelopeSchema` / `AgentStoreEventEnvelope` / `AgentStoreEventKindSchema` / `AgentStoreEventKind` / `AgentStoreEventPageSchema` / `AgentStoreEventPage` | schema / _type_ | append-only event envelope, closed current vocabulary (including `provider/request` and `provider/response`) and bounded page |
 | `AppendAgentStoreEventSchema` / `AppendAgentStoreEvent` / `ReadAgentStoreEventsSchema` / `ReadAgentStoreEvents` | schema / _type_ | required append and bounded-read store contracts |
 | `AgentStoreTransitionSchema` / `AgentStoreTransition` / `AgentStoreEventDraft` / `AgentStoreEventDecodeAccepted` / `AgentStoreEventDecodeIgnored` / `AgentStoreEventDecodeResult` / `decodeAgentStoreEvent` | schema / _types_ / function | normalized runtime mutations, append drafts and strict current/ignorable future-event decoding outcomes |
+| `AgentStoreTransitionRecordSchema` / `AgentStoreTransitionRecord` | schema / _type_ | persisted journal payloads: full runtime mutations or hash-only streaming checkpoint observations with numeric part/byte counts; inspection does not authorize replay |
 | `defineAgentProjection` / `AgentProjectionDefinition` / `AgentProjectionValue` / `createAgentProjectionRegistry` / `createSqliteAgentProjectionStore` | functions / _type_ | deterministic folds with persisted version and honest `uptoSeq` checkpoints |
 | `agentSummaryProjection` / `agentUsageProjection` / `agentOutlineProjection` | constants | built-in list summary, provenance-carrying usage and request outline projections |
 | `agentConversationCardProjection` / `agentStateSlotsProjection` / `agentScheduleSummaryProjection` | constants | focused card, durable-state and schedule lifecycle projections |

package/llms/agent-runtime.txt

@@ -612,16 +612,28 @@ spill. Compacted content stays in the event history and SQLite inactive rows; th
 same active summaries. A hash-only checkpoint is historical digest evidence, marked
 `sourceSha256`; a later full terminal record must settle its content.
 
+Recorded provider options and canonical reasoning/tool-call provider metadata are retained.
+Provider message hashes and request references remain consistent after rekey. Metadata is
+data, subject to the opaque JSON reference guard: an undocumented runtime reference key
+refuses instead of carrying a source identity into the destination. Unknown message fields
+and malformed request/message digests also refuse before any destination writes.
+
 A branch grants no source authority. Terminal run owners/fences and approval signatures are
 removed. State, schedules, children, retries, sandbox, approval rejection and durability facts are
 retained as inert `runtime/branch-observation` records; they cannot repopulate operational state
 or pending effects. Spills discard source authorization and require the explicit fresh
 `artifactAuthorization`; normal destination read authorization still applies. No cached projection,
-schedule row or child relation is cloned.
+schedule row or child relation is cloned. Ordinary companion projections in the export have
+`{ name, version, uptoSeq, value, updatedAt }` envelopes. Branch validates their envelopes,
+unique names and checkpoints within the supplied journal, then discards their values. They are
+derived application caches, including ones containing source references; their values are never
+replayed as state or copied as authority. Rebuild destination projections with
+`createSqliteAgentProjectionStore().advance(...)` over the destination ledger. An exact earlier
+boundary never inherits a later cache value.
 
 The store validates the complete archive before writing: contiguous events, a matching runtime
 snapshot, known typed forms, reference closure, and spill bytes/digests. Unsupported provider
-envelopes, encrypted invocation payloads, unknown event versions, arbitrary cached projections,
+envelopes, encrypted invocation payloads, unknown event versions, malformed projection envelopes,
 missing artifacts and undocumented reference fields in opaque JSON refuse atomically. They need
 an owner-defined transfer codec; never recursively rewrite internal JSON in the application.
 Third-party drivers must provide atomic write transactions and archive support for spills;
@@ -638,6 +650,15 @@ upstream name comes from the model provider's own `resolveResponseProvider` —
 supplies it — so the runtime carries the fact without learning any gateway's metadata key. The normalized
 head/run/message tables remain the fast operational projection.
 
+For `runtime/transition` payload inspection, use `AgentStoreTransitionRecordSchema` and its
+inferred `AgentStoreTransitionRecord` type. A checkpoint record may hold either the full assistant
+message or `{ id, status: 'streaming', sha256?, sourceSha256?, parts: number, bytes: number }`;
+exactly one digest is present. Numeric `parts` counts parts; it is not an array of message parts.
+`sourceSha256` preserves a branch's historical source digest. These hash-only records are
+observations, not executable checkpoint inputs. `AgentStoreTransitionSchema` describes full
+store mutations. Shape inspection does not replace branch's complete replay/reference validation.
+Schema v4 archives written by 0.109.4 use the same journal representation.
+
 Use `defineAgentProjection` with `createSqliteAgentProjectionStore` for a
 deterministic versioned fold. Every value reports `uptoSeq`, so a caller can
 distinguish current data from a projection that still has events to consume.

package/llms-full.txt

@@ -5810,16 +5810,28 @@ spill. Compacted content stays in the event history and SQLite inactive rows; th
 same active summaries. A hash-only checkpoint is historical digest evidence, marked
 `sourceSha256`; a later full terminal record must settle its content.
 
+Recorded provider options and canonical reasoning/tool-call provider metadata are retained.
+Provider message hashes and request references remain consistent after rekey. Metadata is
+data, subject to the opaque JSON reference guard: an undocumented runtime reference key
+refuses instead of carrying a source identity into the destination. Unknown message fields
+and malformed request/message digests also refuse before any destination writes.
+
 A branch grants no source authority. Terminal run owners/fences and approval signatures are
 removed. State, schedules, children, retries, sandbox, approval rejection and durability facts are
 retained as inert `runtime/branch-observation` records; they cannot repopulate operational state
 or pending effects. Spills discard source authorization and require the explicit fresh
 `artifactAuthorization`; normal destination read authorization still applies. No cached projection,
-schedule row or child relation is cloned.
+schedule row or child relation is cloned. Ordinary companion projections in the export have
+`{ name, version, uptoSeq, value, updatedAt }` envelopes. Branch validates their envelopes,
+unique names and checkpoints within the supplied journal, then discards their values. They are
+derived application caches, including ones containing source references; their values are never
+replayed as state or copied as authority. Rebuild destination projections with
+`createSqliteAgentProjectionStore().advance(...)` over the destination ledger. An exact earlier
+boundary never inherits a later cache value.
 
 The store validates the complete archive before writing: contiguous events, a matching runtime
 snapshot, known typed forms, reference closure, and spill bytes/digests. Unsupported provider
-envelopes, encrypted invocation payloads, unknown event versions, arbitrary cached projections,
+envelopes, encrypted invocation payloads, unknown event versions, malformed projection envelopes,
 missing artifacts and undocumented reference fields in opaque JSON refuse atomically. They need
 an owner-defined transfer codec; never recursively rewrite internal JSON in the application.
 Third-party drivers must provide atomic write transactions and archive support for spills;
@@ -5836,6 +5848,15 @@ upstream name comes from the model provider's own `resolveResponseProvider` —
 supplies it — so the runtime carries the fact without learning any gateway's metadata key. The normalized
 head/run/message tables remain the fast operational projection.
 
+For `runtime/transition` payload inspection, use `AgentStoreTransitionRecordSchema` and its
+inferred `AgentStoreTransitionRecord` type. A checkpoint record may hold either the full assistant
+message or `{ id, status: 'streaming', sha256?, sourceSha256?, parts: number, bytes: number }`;
+exactly one digest is present. Numeric `parts` counts parts; it is not an array of message parts.
+`sourceSha256` preserves a branch's historical source digest. These hash-only records are
+observations, not executable checkpoint inputs. `AgentStoreTransitionSchema` describes full
+store mutations. Shape inspection does not replace branch's complete replay/reference validation.
+Schema v4 archives written by 0.109.4 use the same journal representation.
+
 Use `defineAgentProjection` with `createSqliteAgentProjectionStore` for a
 deterministic versioned fold. Every value reports `uptoSeq`, so a caller can
 distinguish current data from a projection that still has events to consume.
@@ -21835,6 +21856,7 @@ Server-only optional application runtime. See the
 | `AgentStoreEventEnvelopeSchema` / `AgentStoreEventEnvelope` / `AgentStoreEventKindSchema` / `AgentStoreEventKind` / `AgentStoreEventPageSchema` / `AgentStoreEventPage` | schema / _type_ | append-only event envelope, closed current vocabulary (including `provider/request` and `provider/response`) and bounded page |
 | `AppendAgentStoreEventSchema` / `AppendAgentStoreEvent` / `ReadAgentStoreEventsSchema` / `ReadAgentStoreEvents` | schema / _type_ | required append and bounded-read store contracts |
 | `AgentStoreTransitionSchema` / `AgentStoreTransition` / `AgentStoreEventDraft` / `AgentStoreEventDecodeAccepted` / `AgentStoreEventDecodeIgnored` / `AgentStoreEventDecodeResult` / `decodeAgentStoreEvent` | schema / _types_ / function | normalized runtime mutations, append drafts and strict current/ignorable future-event decoding outcomes |
+| `AgentStoreTransitionRecordSchema` / `AgentStoreTransitionRecord` | schema / _type_ | persisted journal payloads: full runtime mutations or hash-only streaming checkpoint observations with numeric part/byte counts; inspection does not authorize replay |
 | `defineAgentProjection` / `AgentProjectionDefinition` / `AgentProjectionValue` / `createAgentProjectionRegistry` / `createSqliteAgentProjectionStore` | functions / _type_ | deterministic folds with persisted version and honest `uptoSeq` checkpoints |
 | `agentSummaryProjection` / `agentUsageProjection` / `agentOutlineProjection` | constants | built-in list summary, provenance-carrying usage and request outline projections |
 | `agentConversationCardProjection` / `agentStateSlotsProjection` / `agentScheduleSummaryProjection` | constants | focused card, durable-state and schedule lifecycle projections |

package/llms.txt

@@ -25,7 +25,7 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/primitives**: [llms/primitives.txt](llms/primitives.txt) 11.7 KB
 - **stitchkit/server**: [llms/server.txt](llms/server.txt) 45.3 KB → [llms/server.2.txt](llms/server.2.txt) 14.6 KB → [llms/server.3.txt](llms/server.3.txt) 45.6 KB → [llms/server.4.txt](llms/server.4.txt) 38.3 KB → [llms/server.5.txt](llms/server.5.txt) 22.1 KB
 - **stitchkit/observability**: [llms/observability.txt](llms/observability.txt) 45.9 KB
-- **stitchkit/agent-runtime**: [llms/agent-runtime.txt](llms/agent-runtime.txt) 41.0 KB → [llms/agent-runtime.2.txt](llms/agent-runtime.2.txt) 46.7 KB → [llms/agent-runtime.3.txt](llms/agent-runtime.3.txt) 35.4 KB
+- **stitchkit/agent-runtime**: [llms/agent-runtime.txt](llms/agent-runtime.txt) 42.7 KB → [llms/agent-runtime.2.txt](llms/agent-runtime.2.txt) 46.7 KB → [llms/agent-runtime.3.txt](llms/agent-runtime.3.txt) 35.6 KB
 - **stitchkit/agent-runtime/testing**: [llms/agent-runtime-testing.txt](llms/agent-runtime-testing.txt) 2.6 KB
 - **stitchkit/agent-runtime/harness**: [llms/agent-runtime-harness.txt](llms/agent-runtime-harness.txt) 11.0 KB
 - **stitchkit/agent-runtime/coding-tools**: [llms/agent-runtime-coding-tools.txt](llms/agent-runtime-coding-tools.txt) 5.0 KB

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.110.2",
+  "version": "0.110.4",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",