@namzu/sdk 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,103 @@
 # Changelog
 
+## 1.3.0
+
+### Minor Changes
+
+- d7c683e: Add lazy provider registration: `ProviderRegistry.registerLazy(type, loader, options?)` plus async construction via `ProviderRegistry.createAsync()` / `createProviderAsync()`.
+
+  Hosts that must not bundle every provider client into every entrypoint can now register a dynamic-import loader instead of an eagerly imported class — no more hand-rolled construction switches outside the registry. Registration never invokes the loader; the first `createAsync()` awaits it, validates the resolved `{ create }` module, and caches the factory. Concurrent first-creates share a single in-flight load, and only success is cached: a rejected load surfaces as the new `LazyProviderLoadError` (original failure on `cause`) and the next create retries.
+
+  Capabilities integrate with capability negotiation: an optional `options.capabilities` hint lets `getCapabilities(type)` answer before the provider is loaded (no hint ⇒ permissive default), the loaded module's declared capabilities replace the hint, and the constructed instance's own `LLMProvider.capabilities` remain what the query runtime negotiates against.
+
+  Lazy types are deliberately not constructible through the sync `create()` / `createProvider()` — those throw the new `LazyProviderSyncCreateError` deterministically so sync behavior never depends on load timing. Existing eager `register()` / `create()` behavior is unchanged.
+
+## 1.2.0
+
+### Minor Changes
+
+- cc6b5f3: Pluggable checkpoint persistence with cadence and growth controls.
+
+  Iteration checkpoints now flow through a new `CheckpointStore` interface
+  (`types/run/checkpoint-store.ts`) keyed by the full run scope
+  (`tenantId`/`projectId`/`sessionId`/`runId`) instead of a filesystem
+  path, so hosts can persist mid-turn resume state in a shared backend
+  (e.g. Postgres) that survives machine loss:
+
+  - `QueryParams.checkpointStore?` injects a store per run (mirrors the
+    existing `pathBuilder?` override); the disk layout under the run's
+    output directory remains the default via the new exported
+    `DiskCheckpointStore` conformance adapter over `RunDiskStore`.
+  - `RunPersistenceConfig.checkpointStore?` +
+    `RunPersistence.getCheckpointStore()`/`getRunScope()` expose the same
+    seam to embedded callers.
+  - The replay entry points (`listCheckpoints`, `prepareReplayState`)
+    accept an optional `checkpointStore` + `scope` pair; their
+    disk-addressed `baseDir` inputs are unchanged.
+  - `CheckpointManager` now takes `(store: CheckpointStore, scope:
+CheckpointRunScope)` — a breaking constructor change for direct
+    constructions; the query pipeline threads it automatically.
+
+  Growth control on the run config, byte-identical by default:
+
+  - `AgentRunConfig.checkpointEvery?` (default 1 = every tool-call
+    iteration, today's behavior) checkpoints iterations 1, 1+N, 1+2N, …
+    and skips the HITL `iteration_checkpoint` park on off-cadence
+    iterations.
+  - `AgentRunConfig.pruneKeepLast?` (default undefined = never prune)
+    prunes the run's checkpoint set down to the newest N after each
+    iteration-checkpoint create.
+
+- f1f000c: Provider capability negotiation — degradation is now loud, not silent.
+
+  `LLMProvider` gains an optional `readonly capabilities?:
+ProviderCapabilities` (with a new `supportsVision?` flag on the type)
+  declaring what the DRIVER actually does with a request. Providers that
+  declare nothing resolve to the exported
+  `PERMISSIVE_PROVIDER_CAPABILITIES` constant (assume everything works —
+  exactly the previous behavior), so third-party providers are
+  unaffected. `resolveProviderCapabilities(provider)` performs the
+  per-field permissive merge.
+
+  `query()` consults the resolved capabilities before tooling bootstrap:
+
+  - Tools registered against a `supportsTools: false` driver → a loud
+    `log.warn`, a new `capability_warning` run event, and every tool
+    surface stripped (no `<available_tools>` prompt section, no `tools`
+    request param) so the model is never told about tools it cannot
+    call.
+  - Image attachments on user messages against a `supportsVision: false`
+    driver → `log.warn` + a `capability_warning` run event so the host
+    can surface that the images never reach the model.
+  - New `QueryParams.strictCapabilities?: boolean` (default `false`)
+    throws on either mismatch instead of degrading.
+
+  `RunEvent` gains the additive `capability_warning` variant
+  (`capability: 'tools' | 'vision'`, `providerId`, `message`); the
+  SSE/A2A bridges intentionally do not map it to a wire event yet.
+
+### Patch Changes
+
+- 30c755d: Remove the dead task-notification busy-wait that could hang a run for minutes.
+
+  When the model ended its turn while the task gateway still listed a running
+  agent task, the iteration loop polled an internal `pendingNotifications`
+  queue every 250ms for up to `runConfig.timeoutMs` (120s default) — but
+  nothing has pushed onto that queue since the `onTaskCompleted` listener was
+  removed: every dispatch tool (`create_task`, `continue_task`, `Agent`) is
+  blocking and already returns the worker's output as the dispatching
+  tool_use's canonical `tool_result`. The wait always injected nothing, then
+  re-invoked the model with an unchanged conversation, so runs with an orphaned
+  task (an interrupted tool execution, a cancel race) sporadically stalled for
+  multiples of the timeout before finishing with the answer they already had.
+
+  The superseded `<task-notification>` envelope path is now fully torn out
+  (`waitAndInjectNotifications`, `injectOneTaskNotification`, the
+  `pendingNotifications` queue and its XML/CDATA helpers). End-of-turn
+  semantics with orphan running tasks are explicit: the run ends normally
+  (`end_turn`) and a warning is logged that the orphans have no delivery path.
+  Runs without orphan tasks are byte-identical.
+
 ## 1.1.0
 
 ### Minor Changes

package/dist/bridge/a2a/mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/bridge/a2a/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EAGd,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAgLzD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAO3F;AAED,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,yBAAmB,CAAA"}
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/bridge/a2a/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EAGd,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAmLzD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAO3F;AAED,uCAAuC;AACvC,eAAO,MAAM,oBAAoB,yBAAmB,CAAA"}

package/dist/bridge/a2a/mapper.js

@@ -30,6 +30,8 @@ const MAPPING = {
         role: 'agent',
         parts: [{ kind: 'text', text: e.error }],
     }),
+    // Capability degradation is host-facing diagnostics, not A2A task state.
+    capability_warning: null,
     iteration_started: (e, ctx) => statusEvent(e.runId, 'running', false, ctx, {
         role: 'agent',
         parts: [{ kind: 'text', text: `Iteration ${e.iteration} started` }],

package/dist/bridge/a2a/mapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/bridge/a2a/mapper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/bridge/a2a/mapper.ts"],"names":[],"mappings":"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"}

package/dist/bridge/sse/mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/bridge/sse/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAEzD,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7B;AA6UD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,iBAAiB,GAAG,IAAI,CAkB3F;AAED,0CAA0C;AAC1C,eAAO,MAAM,uBAAuB,4BAAsB,CAAA"}
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/bridge/sse/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAEzD,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7B;AAkVD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,iBAAiB,GAAG,IAAI,CAkB3F;AAED,0CAA0C;AAC1C,eAAO,MAAM,uBAAuB,4BAAsB,CAAA"}

package/dist/bridge/sse/mapper.js

@@ -131,6 +131,10 @@ const MAPPING = {
     },
     run_completed: null,
     run_failed: null,
+    // Not mapped to a wire event yet — hosts consume `capability_warning`
+    // from the RunEvent stream directly; promoting it to the SSE contract
+    // needs a StreamEventType addition first.
+    capability_warning: null,
     agent_pending: {
         wire: 'agent.pending',
         transform: (e, runId) => ({

package/dist/bridge/sse/mapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/bridge/sse/mapper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../src/bridge/sse/mapper.ts"],"names":[],"mappings":"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"}

package/dist/{runtime/query → constants}/continuation.d.ts

@@ -11,6 +11,11 @@
  * that match this constant verbatim, so the run's `result` field
  * concatenates the full multi-turn assistant output instead of only
  * surfacing the trailing continuation chunk.
+ *
+ * Lives in `constants/` (not `runtime/query/`) because both the
+ * runtime iteration loop and `manager/run/persistence.ts` consume
+ * it — a manager→runtime import for a string constant would create
+ * a manager↔runtime directory cycle.
  */
 export declare const AUTO_CONTINUATION_USER_MESSAGE = "Continue exactly where you left off. Do not repeat content you already wrote \u2014 pick up at the next token.";
 //# sourceMappingURL=continuation.d.ts.map

package/dist/constants/continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation.d.ts","sourceRoot":"","sources":["../../src/constants/continuation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,8BAA8B,mHACiE,CAAA"}

package/dist/{runtime/query → constants}/continuation.js

@@ -11,6 +11,11 @@
  * that match this constant verbatim, so the run's `result` field
  * concatenates the full multi-turn assistant output instead of only
  * surfacing the trailing continuation chunk.
+ *
+ * Lives in `constants/` (not `runtime/query/`) because both the
+ * runtime iteration loop and `manager/run/persistence.ts` consume
+ * it — a manager→runtime import for a string constant would create
+ * a manager↔runtime directory cycle.
  */
 export const AUTO_CONTINUATION_USER_MESSAGE = 'Continue exactly where you left off. Do not repeat content you already wrote — pick up at the next token.';
 //# sourceMappingURL=continuation.js.map

package/dist/constants/continuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation.js","sourceRoot":"","sources":["../../src/constants/continuation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAC1C,2GAA2G,CAAA"}

package/dist/constants/index.d.ts

@@ -7,6 +7,7 @@ export * from './rag/index.js';
 export * from './tools/index.js';
 export * from './telemetry/index.js';
 export * from './agent/index.js';
+export * from './continuation.js';
 export * from './limits.js';
 export * from './bus/index.js';
 export * from './verification/index.js';

package/dist/constants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}

package/dist/constants/index.js

@@ -7,6 +7,7 @@ export * from './rag/index.js';
 export * from './tools/index.js';
 export * from './telemetry/index.js';
 export * from './agent/index.js';
+export * from './continuation.js';
 export * from './limits.js';
 export * from './bus/index.js';
 export * from './verification/index.js';

package/dist/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}

package/dist/manager/run/persistence.d.ts

@@ -2,12 +2,14 @@ import { RunDiskStore } from '../../store/run/disk.js';
 import { type CostInfo, type TokenUsage } from '../../types/common/index.js';
 import type { RunId, SessionId, TenantId } from '../../types/ids/index.js';
 import type { Message } from '../../types/message/index.js';
+import type { CheckpointRunScope, CheckpointStore } from '../../types/run/checkpoint-store.js';
 import type { EmergencySaveData } from '../../types/run/emergency.js';
 import type { Run, RunPersistenceConfig, StopReason } from '../../types/run/index.js';
 import type { ProjectId, ThreadId } from '../../types/session/ids.js';
 export declare class RunPersistence {
     private run;
     private runStore;
+    private checkpointStore;
     private pricing?;
     private log;
     private readonly _sessionId;
@@ -29,6 +31,15 @@ export declare class RunPersistence {
     getRun(): Readonly<Run>;
     getSession(): Readonly<Run>;
     getRunStore(): RunDiskStore;
+    /**
+     * Checkpoint persistence for this run — the injected
+     * {@link CheckpointStore} when the host provided one, otherwise the
+     * disk default. Pair with {@link getRunScope} when constructing a
+     * `CheckpointManager`.
+     */
+    getCheckpointStore(): CheckpointStore;
+    /** Full five-layer scope key for this run's checkpoint operations. */
+    getRunScope(): CheckpointRunScope;
     getRunDir(): string | null;
     init(): Promise<void>;
     markRunning(): void;

package/dist/manager/run/persistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../src/manager/run/persistence.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAwB,MAAM,6BAA6B,CAAA;AAClG,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,GAAG,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAKrE,qBAAa,cAAc;IAC1B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAW;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAW;gBAE1B,MAAM,EAAE,oBAAoB;IAgCxC,IAAI,EAAE,IAAI,KAAK,CAEd;IAED,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED,IAAI,MAAM,sDAET;IAED,IAAI,UAAU,2BAEb;IAED,IAAI,QAAQ,IAAI,OAAO,EAAE,CAExB;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC;IAIvB,UAAU,IAAI,QAAQ,CAAC,GAAG,CAAC;IAI3B,WAAW,IAAI,YAAY;IAI3B,SAAS,IAAI,MAAM,GAAG,IAAI;IAIpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,WAAW,IAAI,IAAI;IAInB,aAAa,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IAS5C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO/B,aAAa,IAAI,IAAI;IAMrB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIvC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC,kBAAkB,IAAI,MAAM;IAK5B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQxC,OAAO,CAAC,aAAa;IAqCrB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAchD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAc9B"}
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../src/manager/run/persistence.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAwB,MAAM,6BAA6B,CAAA;AAClG,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,GAAG,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAKrE,qBAAa,cAAc;IAC1B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAW;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAW;gBAE1B,MAAM,EAAE,oBAAoB;IAyCxC,IAAI,EAAE,IAAI,KAAK,CAEd;IAED,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED,IAAI,MAAM,sDAET;IAED,IAAI,UAAU,2BAEb;IAED,IAAI,QAAQ,IAAI,OAAO,EAAE,CAExB;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC;IAIvB,UAAU,IAAI,QAAQ,CAAC,GAAG,CAAC;IAI3B,WAAW,IAAI,YAAY;IAI3B;;;;;OAKG;IACH,kBAAkB,IAAI,eAAe;IAIrC,sEAAsE;IACtE,WAAW,IAAI,kBAAkB;IAUjC,SAAS,IAAI,MAAM,GAAG,IAAI;IAIpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,WAAW,IAAI,IAAI;IAInB,aAAa,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IAS5C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO/B,aAAa,IAAI,IAAI;IAMrB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIvC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC,kBAAkB,IAAI,MAAM;IAK5B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQxC,OAAO,CAAC,aAAa;IAqCrB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAchD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAc9B"}

package/dist/manager/run/persistence.js

@@ -1,5 +1,6 @@
+import { AUTO_CONTINUATION_USER_MESSAGE } from '../../constants/continuation.js';
 import { EMPTY_TOKEN_USAGE } from '../../constants/limits.js';
-import { AUTO_CONTINUATION_USER_MESSAGE } from '../../runtime/query/continuation.js';
+import { DiskCheckpointStore } from '../../store/run/checkpoint-disk.js';
 import { RunDiskStore } from '../../store/run/disk.js';
 import { accumulateTokenUsage } from '../../types/common/index.js';
 import { ZERO_COST, accumulateCost } from '../../utils/cost.js';
@@ -7,6 +8,7 @@ import { generateEmergencySaveId } from '../../utils/id.js';
 export class RunPersistence {
     run;
     runStore;
+    checkpointStore;
     pricing;
     log;
     _sessionId;
@@ -24,6 +26,14 @@ export class RunPersistence {
             baseDir: config.outputDir,
             logger: config.log,
         });
+        // Checkpoints go through the injectable seam; the disk layout under
+        // `outputDir` (same tree the runStore writes to) stays the default.
+        this.checkpointStore =
+            config.checkpointStore ??
+                new DiskCheckpointStore({
+                    baseDir: config.outputDir,
+                    logger: config.log,
+                });
         this.run = {
             id: config.runId,
             status: 'idle',
@@ -84,6 +94,25 @@ export class RunPersistence {
     getRunStore() {
         return this.runStore;
     }
+    /**
+     * Checkpoint persistence for this run — the injected
+     * {@link CheckpointStore} when the host provided one, otherwise the
+     * disk default. Pair with {@link getRunScope} when constructing a
+     * `CheckpointManager`.
+     */
+    getCheckpointStore() {
+        return this.checkpointStore;
+    }
+    /** Full five-layer scope key for this run's checkpoint operations. */
+    getRunScope() {
+        return {
+            tenantId: this._tenantId,
+            projectId: this._projectId,
+            sessionId: this._sessionId,
+            runId: this.run.id,
+            parentRunId: this.run.parentRunId,
+        };
+    }
     getRunDir() {
         return this.runStore.getRunDir();
     }

package/dist/manager/run/persistence.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../../src/manager/run/persistence.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../../src/manager/run/persistence.ts"],"names":[],"mappings":"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"}

package/dist/provider/__tests__/registry.test.d.ts

@@ -2,9 +2,14 @@ interface TestProviderConfig {
     type: 'test';
     value?: string;
 }
+interface LazyTestProviderConfig {
+    type: 'lazytest';
+    value?: string;
+}
 declare module '../../types/provider/config.js' {
     interface ProviderConfigRegistry {
         test: TestProviderConfig;
+        lazytest: LazyTestProviderConfig;
     }
 }
 export {};

package/dist/provider/__tests__/registry.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../../src/provider/__tests__/registry.test.ts"],"names":[],"mappings":"AAaA,UAAU,kBAAkB;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,OAAO,QAAQ,gCAAgC,CAAC;IAC/C,UAAU,sBAAsB;QAC/B,IAAI,EAAE,kBAAkB,CAAA;KACxB;CACD"}
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../../src/provider/__tests__/registry.test.ts"],"names":[],"mappings":"AAoBA,UAAU,kBAAkB;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,UAAU,sBAAsB;IAC/B,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,OAAO,QAAQ,gCAAgC,CAAC;IAC/C,UAAU,sBAAsB;QAC/B,IAAI,EAAE,kBAAkB,CAAA;QACxB,QAAQ,EAAE,sBAAsB,CAAA;KAChC;CACD"}

package/dist/provider/__tests__/registry.test.js

@@ -1,7 +1,8 @@
 import { beforeEach, describe, expect, it } from 'vitest';
+import { PERMISSIVE_PROVIDER_CAPABILITIES, resolveProviderCapabilities } from '../capabilities.js';
 import { registerMock } from '../mock-register.js';
 import { MockLLMProvider } from '../mock.js';
-import { DuplicateProviderError, ProviderRegistry, UnknownProviderError, __resetProviderRegistryInternal, } from '../registry.js';
+import { DuplicateProviderError, LazyProviderLoadError, LazyProviderSyncCreateError, ProviderRegistry, UnknownProviderError, __resetProviderRegistryInternal, } from '../registry.js';
 class TestProvider {
     config;
     id = 'test';
@@ -33,6 +34,39 @@ const TEST_CAPS = {
     supportsStreaming: true,
     supportsFunctionCalling: false,
 };
+class LazyTestProvider {
+    config;
+    capabilities;
+    id = 'lazytest';
+    name = 'Lazy Test';
+    constructor(config, capabilities) {
+        this.config = config;
+        this.capabilities = capabilities;
+    }
+    async *chatStream() {
+        yield { id: 'x', delta: { content: 'ok' } };
+    }
+}
+const HINT_CAPS = {
+    supportsTools: false,
+    supportsStreaming: false,
+    supportsFunctionCalling: false,
+};
+const MODULE_CAPS = {
+    supportsTools: true,
+    supportsStreaming: true,
+    supportsFunctionCalling: true,
+    supportsVision: false,
+};
+function deferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve, reject };
+}
 describe('ProviderRegistry', () => {
     beforeEach(() => {
         __resetProviderRegistryInternal();
@@ -114,5 +148,156 @@ describe('ProviderRegistry', () => {
             expect(err.name).toBe('DuplicateProviderError');
         });
     });
+    describe('registerLazy', () => {
+        it('does not invoke the loader at registration time', () => {
+            let calls = 0;
+            ProviderRegistry.registerLazy('lazytest', async () => {
+                calls++;
+                return { create: (config) => new LazyTestProvider(config) };
+            });
+            expect(calls).toBe(0);
+            expect(ProviderRegistry.isSupported('lazytest')).toBe(true);
+            expect(ProviderRegistry.listTypes()).toContain('lazytest');
+        });
+        it('throws DuplicateProviderError over an existing eager registration', () => {
+            ProviderRegistry.register('test', TestProvider, TEST_CAPS);
+            expect(() => ProviderRegistry.registerLazy('test', async () => ({
+                create: (config) => new TestProvider(config),
+            }))).toThrowError(DuplicateProviderError);
+        });
+        it('throws DuplicateProviderError over an existing lazy registration', () => {
+            const loader = async () => ({
+                create: (config) => new LazyTestProvider(config),
+            });
+            ProviderRegistry.registerLazy('lazytest', loader);
+            expect(() => ProviderRegistry.registerLazy('lazytest', loader)).toThrowError(DuplicateProviderError);
+        });
+        it('replace: true swaps between eager and lazy registrations', async () => {
+            ProviderRegistry.register('lazytest', LazyTestProvider, TEST_CAPS);
+            ProviderRegistry.registerLazy('lazytest', async () => ({ create: (config) => new LazyTestProvider(config) }), { replace: true });
+            expect(() => ProviderRegistry.createProvider({ type: 'lazytest' })).toThrowError(LazyProviderSyncCreateError);
+            ProviderRegistry.register('lazytest', LazyTestProvider, TEST_CAPS, { replace: true });
+            expect(ProviderRegistry.createProvider({ type: 'lazytest' })).toBeInstanceOf(LazyTestProvider);
+        });
+        it('sync create()/createProvider() always throws for lazy types, even after load', async () => {
+            ProviderRegistry.registerLazy('lazytest', async () => ({
+                create: (config) => new LazyTestProvider(config),
+            }));
+            expect(() => ProviderRegistry.create({ type: 'lazytest' })).toThrowError(LazyProviderSyncCreateError);
+            await ProviderRegistry.createAsync({ type: 'lazytest' });
+            expect(() => ProviderRegistry.createProvider({ type: 'lazytest' })).toThrowError(LazyProviderSyncCreateError);
+        });
+        it('unregister removes a lazy registration', () => {
+            ProviderRegistry.registerLazy('lazytest', async () => ({
+                create: (config) => new LazyTestProvider(config),
+            }));
+            expect(ProviderRegistry.unregister('lazytest')).toBe(true);
+            expect(ProviderRegistry.isSupported('lazytest')).toBe(false);
+        });
+    });
+    describe('createAsync', () => {
+        it('first create invokes the loader once; subsequent creates reuse the cached factory', async () => {
+            let calls = 0;
+            ProviderRegistry.registerLazy('lazytest', async () => {
+                calls++;
+                return { create: (config) => new LazyTestProvider(config) };
+            });
+            const first = await ProviderRegistry.createAsync({ type: 'lazytest', value: 'a' });
+            const second = await ProviderRegistry.createAsync({ type: 'lazytest', value: 'b' });
+            expect(calls).toBe(1);
+            expect(first.provider).toBeInstanceOf(LazyTestProvider);
+            expect(second.provider).toBeInstanceOf(LazyTestProvider);
+            expect(second.provider.config.value).toBe('b');
+        });
+        it('concurrent first-creates share a single loader invocation', async () => {
+            let calls = 0;
+            const gate = deferred();
+            ProviderRegistry.registerLazy('lazytest', async () => {
+                calls++;
+                await gate.promise;
+                return { create: (config) => new LazyTestProvider(config) };
+            });
+            const a = ProviderRegistry.createAsync({ type: 'lazytest' });
+            const b = ProviderRegistry.createAsync({ type: 'lazytest' });
+            gate.resolve();
+            const [ra, rb] = await Promise.all([a, b]);
+            expect(calls).toBe(1);
+            expect(ra.provider).toBeInstanceOf(LazyTestProvider);
+            expect(rb.provider).toBeInstanceOf(LazyTestProvider);
+        });
+        it('loader rejection surfaces as LazyProviderLoadError and the next create retries', async () => {
+            let calls = 0;
+            ProviderRegistry.registerLazy('lazytest', async () => {
+                calls++;
+                if (calls === 1) {
+                    throw new Error('transient network failure');
+                }
+                return { create: (config) => new LazyTestProvider(config) };
+            });
+            const failure = await ProviderRegistry.createAsync({ type: 'lazytest' }).catch((err) => err);
+            expect(failure).toBeInstanceOf(LazyProviderLoadError);
+            expect(failure.providerType).toBe('lazytest');
+            expect(failure.cause.message).toBe('transient network failure');
+            const { provider } = await ProviderRegistry.createAsync({ type: 'lazytest' });
+            expect(calls).toBe(2);
+            expect(provider).toBeInstanceOf(LazyTestProvider);
+        });
+        it('rejects with LazyProviderLoadError when the loader resolves an invalid module shape', async () => {
+            ProviderRegistry.registerLazy('lazytest', async () => ({}));
+            await expect(ProviderRegistry.createAsync({ type: 'lazytest' })).rejects.toThrowError(LazyProviderLoadError);
+        });
+        it('works for eagerly registered types too', async () => {
+            const { provider, capabilities } = await ProviderRegistry.createAsync({
+                type: 'mock',
+                model: 'test-model',
+            });
+            expect(provider).toBeInstanceOf(MockLLMProvider);
+            expect(capabilities.supportsStreaming).toBe(true);
+        });
+        it('rejects with UnknownProviderError for unregistered types', async () => {
+            await expect(ProviderRegistry.createAsync({ type: 'nonexistent' })).rejects.toThrowError(UnknownProviderError);
+        });
+    });
+    describe('lazy capabilities', () => {
+        it('answers with the registration hint before load, without invoking the loader', () => {
+            let calls = 0;
+            ProviderRegistry.registerLazy('lazytest', async () => {
+                calls++;
+                return { create: (config) => new LazyTestProvider(config) };
+            }, { capabilities: HINT_CAPS });
+            expect(ProviderRegistry.getCapabilities('lazytest')).toEqual(HINT_CAPS);
+            expect(calls).toBe(0);
+        });
+        it('answers permissively before load when no hint was given', () => {
+            ProviderRegistry.registerLazy('lazytest', async () => ({
+                create: (config) => new LazyTestProvider(config),
+            }));
+            expect(ProviderRegistry.getCapabilities('lazytest')).toEqual(PERMISSIVE_PROVIDER_CAPABILITIES);
+        });
+        it('module capabilities replace the hint after load', async () => {
+            ProviderRegistry.registerLazy('lazytest', async () => ({
+                create: (config) => new LazyTestProvider(config),
+                capabilities: MODULE_CAPS,
+            }), { capabilities: HINT_CAPS });
+            const { capabilities } = await ProviderRegistry.createAsync({ type: 'lazytest' });
+            expect(capabilities).toEqual(MODULE_CAPS);
+            expect(ProviderRegistry.getCapabilities('lazytest')).toEqual(MODULE_CAPS);
+        });
+        it('the constructed instance own capabilities win at run time over any hint', async () => {
+            const instanceCaps = {
+                supportsTools: true,
+                supportsStreaming: true,
+                supportsFunctionCalling: false,
+                supportsVision: false,
+            };
+            ProviderRegistry.registerLazy('lazytest', async () => ({ create: (config) => new LazyTestProvider(config, instanceCaps) }), { capabilities: HINT_CAPS });
+            const { provider } = await ProviderRegistry.createAsync({ type: 'lazytest' });
+            // The query runtime negotiates against the instance, not the registry:
+            const resolved = resolveProviderCapabilities(provider);
+            expect(resolved.supportsTools).toBe(true);
+            expect(resolved.supportsFunctionCalling).toBe(false);
+            expect(resolved.supportsVision).toBe(false);
+        });
+    });
 });
 //# sourceMappingURL=registry.test.js.map