@namzu/sdk 0.4.1 → 0.4.2

package/dist/types/summary/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../../src/types/summary/ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAA;AAE3C,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE5E,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAA;IAC5C,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAA;IACvC,QAAQ,CAAC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAA;IAChD,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,yBAAyB,EAAE,CAAA;IAC3D,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAA;CACjC"}

package/dist/types/summary/ref.js

@@ -0,0 +1,28 @@
+/**
+ * SessionSummaryRef — the structured pointer a parent session sees when a
+ * sub-session completes. Kernel-owned terminalization primitive: the only
+ * producer is `SessionSummaryMaterializer.materialize` (see
+ * `session/summary/materialize.ts`). See session-hierarchy.md §4.7 (shape)
+ * and §8.1 (emission invariant).
+ *
+ * The `materializedBy: 'kernel'` literal field is load-bearing — combined
+ * with the opaque {@link SummaryId} brand (mintable only by
+ * `generateSummaryId`), it enforces at the type level that no agent or tool
+ * can construct a valid `SessionSummaryRef`. `SessionStore.recordSummary`
+ * only accepts `SessionSummaryRef & { materializedBy: 'kernel' }`, so even a
+ * payload shaped correctly would fail the structural check.
+ *
+ * This is Convention #0 load-bearing: there is no "tool" path to emit a
+ * summary; the parent agent sees only what the kernel seals.
+ *
+ * Runtime errors related to summary emission (`AgentSummaryTooLongError`,
+ * `SessionAlreadySummarizedError`) are runtime and therefore live at
+ * `session/summary/errors.ts` — they are NOT pure shapes.
+ */
+/**
+ * Max characters allowed for {@link SessionSummaryRef.agentSummary}. See
+ * session-hierarchy.md §4.7 — the agent's narration is bounded to keep
+ * parent prompts token-finite regardless of the child's transcript length.
+ */
+export const AGENT_SUMMARY_MAX_CHARS = 4000;
+//# sourceMappingURL=ref.js.map

package/dist/types/summary/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../../src/types/summary/ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAA"}

package/dist/{session/hierarchy/tenant.d.ts → types/tenant/entity.d.ts}

@@ -1,4 +1,4 @@
-import type { TenantId } from '../../types/ids/index.js';
+import type { TenantId } from '../ids/index.js';
 /**
  * Tenancy boundary for everything in the hierarchy.
  *
@@ -10,4 +10,4 @@ export interface Tenant {
     id: TenantId;
     createdAt: Date;
 }
-//# sourceMappingURL=tenant.d.ts.map
+//# sourceMappingURL=entity.d.ts.map

package/dist/types/tenant/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/types/tenant/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACtB,EAAE,EAAE,QAAQ,CAAA;IACZ,SAAS,EAAE,IAAI,CAAA;CACf"}

package/dist/types/tenant/entity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entity.js.map

package/dist/types/tenant/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/types/tenant/entity.ts"],"names":[],"mappings":""}

package/dist/types/tenant/index.d.ts

@@ -0,0 +1,2 @@
+export type { Tenant } from './entity.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/tenant/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/tenant/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA"}

package/dist/types/tenant/index.js

@@ -0,0 +1,4 @@
+// Sub-barrel for the tenancy shape surface (Convention #4).
+// Concrete types live in sibling files; re-export them here.
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/tenant/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/tenant/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,6DAA6D"}

package/dist/{session/hierarchy/thread.d.ts → types/thread/entity.d.ts}

@@ -1,5 +1,5 @@
-import type { TenantId } from '../../types/ids/index.js';
-import type { ProjectId, ThreadId } from '../../types/session/ids.js';
+import type { TenantId } from '../ids/index.js';
+import type { ProjectId, ThreadId } from '../session/ids.js';
 /**
  * Lifecycle state of a Thread.
  *
@@ -17,8 +17,8 @@ import type { ProjectId, ThreadId } from '../../types/session/ids.js';
 export type ThreadStatus = 'open' | 'archived';
 /**
  * Topic-level container sitting between {@link ProjectId Project} and
- * {@link import('../../types/session/ids.js').SessionId Session} in the
- * five-layer hierarchy (Project → Thread → Session → SubSession → Run).
+ * {@link import('../session/ids.js').SessionId Session} in the five-layer hierarchy
+ * (Project → Thread → Session → SubSession → Run).
  *
  * A Thread groups together many Sessions that address the same coherent
  * topic or line-of-work within a Project (e.g. "auth refactor", "billing
@@ -26,7 +26,31 @@ export type ThreadStatus = 'open' | 'archived';
  * resources (memory, vaults, knowledge bases) but have independent actor
  * state, handoff history, and Run streams.
  *
- * Design §4 (`docs.local/sessions/ses_001-hierarchy-redesign/design.md`):
+ * ## Why Thread is a first-class layer (A2A-connection surface)
+ *
+ * The layer exists because of how enterprise sharing works in Namzu:
+ *
+ * - **Project is the folder-bound sharing unit.** An enterprise team shares
+ *   a Project (`.namzu/` in a repo, a long-lived goal scope). Everyone with
+ *   Project access sees its shape but not necessarily its active work.
+ * - **Thread is the path-independent, A2A-attachable topic surface.** A
+ *   Project can have multiple Threads — one per objective or line-of-work —
+ *   and the Threads can be partitioned by device, user, or agent identity.
+ *   A2A (agent-to-agent) connections attach at the Thread level: connecting
+ *   to a Thread exposes every Session under it and the ability to join the
+ *   ongoing work.
+ * - **Sessions are the immediate work unit.** A user or agent enters a
+ *   Thread and opens/resumes Sessions for the concrete interval of work.
+ *
+ * This is the mental model ses_001 ratified (Phase 0, 2026-04-18). Industry
+ * frameworks (OpenAI Responses, LangGraph, Claude Agent SDK, Temporal) do
+ * not have an exact analogue for the Thread layer — it is Namzu's answer to
+ * the question "how do you expose a multi-session topic to A2A without
+ * coupling it to the Project's filesystem identity?".
+ *
+ * ## Design reference
+ *
+ * Session design §4 (`docs.local/sessions/ses_001-hierarchy-redesign/design.md`):
  *   - Container only. No own message stream, no own Run stream. Messages
  *     live in Sessions (Phase 0 decision B.1).
  *   - `title` is a user-facing label. **Titles are NOT unique within a
@@ -37,7 +61,7 @@ export type ThreadStatus = 'open' | 'archived';
  *   - `ownerVersion` is the CAS counter for mutations — `updateThread` and
  *     archival transitions require a matching version and reject
  *     {@link StaleThreadError} on mismatch. Mirrors the
- *     {@link import('./session.js').Session} handoff CAS pattern (§6.1).
+ *     {@link import('./entity.js').Session} handoff CAS pattern (§6.1).
  *   - No fan-in `deriveStatus()` helper — status is owner-managed, not
  *     Run-derived. This is the Thread-vs-Session contract boundary.
  */
@@ -51,4 +75,4 @@ export interface Thread {
     createdAt: Date;
     updatedAt: Date;
 }
-//# sourceMappingURL=thread.d.ts.map
+//# sourceMappingURL=entity.d.ts.map

package/dist/types/thread/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/types/thread/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,WAAW,MAAM;IACtB,EAAE,EAAE,QAAQ,CAAA;IACZ,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,YAAY,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CACf"}

package/dist/types/thread/entity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entity.js.map

package/dist/types/thread/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/types/thread/entity.ts"],"names":[],"mappings":""}

package/dist/types/thread/index.d.ts

@@ -1,2 +1,3 @@
 export type { ThreadStore, CreateThreadParams } from './store.js';
+export type { Thread, ThreadStatus } from './entity.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/thread/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/thread/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/thread/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACjE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/types/thread/store.d.ts

@@ -18,7 +18,7 @@
  * awareness preserves the single-boundary ownership boundary that Phase 2
  * has just introduced for this layer (Convention #0).
  */
-import type { Thread } from '../../session/hierarchy/thread.js';
+import type { Thread } from '../../types/thread/entity.js';
 import type { TenantId } from '../ids/index.js';
 import type { ProjectId, ThreadId } from '../session/ids.js';
 /**

package/dist/types/thread/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/types/thread/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAA;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,SAAS,CAAA;IACpB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE7E;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAEzE;;;;;;;;;OASG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/D;;;;;;;OAOG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnE;;;;;;;OAOG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;CACjF"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/types/thread/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,SAAS,CAAA;IACpB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE7E;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAEzE;;;;;;;;;OASG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/D;;;;;;;OAOG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnE;;;;;;;OAOG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;CACjF"}

package/dist/types/workspace/index.d.ts

@@ -0,0 +1,2 @@
+export type { GitWorktreeBackendMeta, WorkspaceBackendKind, WorkspaceBackendMeta, WorkspaceRef, } from './ref.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/workspace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/workspace/index.ts"],"names":[],"mappings":"AAMA,YAAY,EACX,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,GACZ,MAAM,UAAU,CAAA"}

package/dist/types/workspace/index.js

@@ -0,0 +1,7 @@
+// Sub-barrel for the workspace shape surface (Convention #4).
+// Concrete types live in sibling files; re-export them here.
+//
+// Runtime workspace machinery (drivers, registry, path-builder, git-worktree)
+// stays under `session/workspace/` — this barrel is shape-only.
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/workspace/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,6DAA6D;AAC7D,EAAE;AACF,8EAA8E;AAC9E,gEAAgE"}

package/dist/{session → types}/workspace/ref.d.ts

@@ -7,7 +7,7 @@
  * in a later phase of the overall roadmap (post-MVP) without breaking
  * existing consumers (Convention #6).
  */
-import type { WorkspaceId } from '../../types/session/ids.js';
+import type { WorkspaceId } from '../session/ids.js';
 /**
  * Supported backend kinds. Additional variants are append-only; existing
  * consumers switch with an `_exhaustive` never-guard and will fail to compile

package/dist/types/workspace/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../../src/types/workspace/ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEpF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,cAAc,CAAA;IACvB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,CAAA;AAEzD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,WAAW,CAAA;IACf,IAAI,EAAE,oBAAoB,CAAA;IAC1B,SAAS,EAAE,IAAI,CAAA;CACf"}

package/dist/types/workspace/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../../src/types/workspace/ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@namzu/sdk",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Open-source AI agent SDK with a built-in runtime. Nothing between you and your agents.",
   "license": "FSL-1.1-MIT",
   "type": "module",

package/src/__tests__/replay-public-surface.test.ts

@@ -0,0 +1,54 @@
+import { describe, expect, it } from 'vitest'
+import {
+	CheckpointManager,
+	MutationNotApplicableError,
+	listCheckpoints,
+	prepareReplayState,
+	projectEmergencyToCheckpoint,
+} from '../index.js'
+import type { CheckpointListEntry, Mutation, ReplayAttribution, Run } from '../index.js'
+
+describe('ses_005 replay primitive — root public surface', () => {
+	it('exposes runtime values at the package root', () => {
+		expect(typeof prepareReplayState).toBe('function')
+		expect(typeof listCheckpoints).toBe('function')
+		expect(typeof projectEmergencyToCheckpoint).toBe('function')
+		expect(typeof CheckpointManager).toBe('function')
+		expect(typeof MutationNotApplicableError).toBe('function')
+	})
+
+	it('MutationNotApplicableError is a throwable Error subclass with availableToolCallIds', () => {
+		const err = new MutationNotApplicableError('nope', ['call_x', 'call_y'] as never)
+		expect(err).toBeInstanceOf(Error)
+		expect(err).toBeInstanceOf(MutationNotApplicableError)
+		expect(err.name).toBe('MutationNotApplicableError')
+		expect(err.availableToolCallIds).toEqual(['call_x', 'call_y'])
+	})
+
+	// Type-only checks — if these expressions compile, the type surface is
+	// correctly flowing through public-types.ts.
+	it('exposes replay types (compile-time check)', () => {
+		const mutation: Mutation = {
+			type: 'injectToolResponse',
+			toolCallId: 'call_a' as never,
+			response: { success: true, output: '' },
+		}
+		const entry: CheckpointListEntry = {
+			id: 'cp_x' as never,
+			runId: 'run_x' as never,
+			iteration: 0,
+			createdAt: 0,
+			messageCount: 0,
+		}
+		const attribution: ReplayAttribution = {
+			sourceRunId: 'run_source' as never,
+			fromCheckpointId: 'cp_x' as never,
+			mutations: [mutation],
+			replayedAt: 0,
+		}
+		const run: Pick<Run, 'replayOf'> = { replayOf: attribution }
+		expect(mutation.type).toBe('injectToolResponse')
+		expect(entry.iteration).toBe(0)
+		expect(run.replayOf?.sourceRunId).toBe('run_source')
+	})
+})

package/src/agents/SupervisorAgent.ts

@@ -3,7 +3,6 @@ import { LocalTaskGateway } from '../gateway/local.js'
 import { ToolRegistry } from '../registry/tool/execute.js'
 import { drainQuery } from '../runtime/query/index.js'
 import type { LaunchedTaskMeta } from '../runtime/query/iteration/phases/context.js'
-import type { ActorRef } from '../session/hierarchy/actor.js'
 import { buildCoordinatorTools } from '../tools/coordinator/index.js'
 import type { TaskGateway } from '../types/agent/gateway.js'
 import type {
@@ -16,6 +15,7 @@ import type { AgentTaskContext } from '../types/agent/task.js'
 import type { AgentId, TaskId } from '../types/ids/index.js'
 import { deriveChildState } from '../types/invocation/index.js'
 import type { RunEventListener } from '../types/run/index.js'
+import type { ActorRef } from '../types/session/actor.js'
 import { ZERO_COST } from '../utils/cost.js'
 import { AbstractAgent } from './AbstractAgent.js'
 

package/src/bridge/a2a/task.ts

@@ -1,5 +1,5 @@
 import { RUN_STATUS_TO_A2A, TERMINAL_STATES } from '../../constants/a2a/index.js'
-import type { Run, RunConfig, WireRunStatus } from '../../contracts/index.js'
+import type { RunConfig, WireRun, WireRunStatus } from '../../contracts/index.js'
 import type {
 	A2AArtifact,
 	A2AMessage,
@@ -19,7 +19,7 @@ export function runStatusToA2AState(status: WireRunStatus): A2ATaskState {
 	return RUN_STATUS_TO_A2A[status]
 }
 
-function buildTaskStatus(run: Run): A2ATaskStatus {
+function buildTaskStatus(run: WireRun): A2ATaskStatus {
 	const state = runStatusToA2AState(run.status)
 	const timestamp = run.completed_at ?? run.started_at ?? run.created_at
 
@@ -32,7 +32,7 @@ function buildTaskStatus(run: Run): A2ATaskStatus {
 	return { state, message, timestamp }
 }
 
-function buildArtifacts(run: Run): A2AArtifact[] | undefined {
+function buildArtifacts(run: WireRun): A2AArtifact[] | undefined {
 	if (!run.result) return undefined
 
 	return [
@@ -54,7 +54,7 @@ function buildArtifacts(run: Run): A2AArtifact[] | undefined {
 	]
 }
 
-export function runToA2ATask(run: Run, messages?: readonly Message[]): A2ATask {
+export function runToA2ATask(run: WireRun, messages?: readonly Message[]): A2ATask {
 	return {
 		id: run.id,
 		contextId: run.project_id ?? undefined,

package/src/config/runtime.ts

@@ -51,8 +51,6 @@ export const PromptCacheConfigSchema = z.object({
 	strategy: z.enum(['auto', 'disabled']).default('auto'),
 })
 
-export type PromptCacheConfig = z.infer<typeof PromptCacheConfigSchema>
-
 export const PluginRuntimeConfigSchema = z.object({
 	enabled: z.boolean().default(false),
 	autoDiscovery: z.boolean().default(true),

package/src/contracts/api.ts

@@ -1,7 +1,7 @@
 import type { AgentCapabilities, AgentType } from '../types/agent/base.js'
+import type { ProjectId, RunId, SessionId } from '../types/ids/index.js'
 import type { MessageRole } from '../types/message/index.js'
 import type { StopReason } from '../types/run/events.js'
-import type { ProjectId, RunId, SessionId } from './ids.js'
 
 export type { MessageRole, StopReason, AgentType, AgentCapabilities }
 
@@ -65,7 +65,7 @@ export type WireRunStatus =
 // identifier even if the domain type is later renamed.
 export type RunStopReason = StopReason
 
-export interface Run {
+export interface WireRun {
 	id: RunId
 	project_id: ProjectId | null
 	session_id?: SessionId

package/src/contracts/index.ts

@@ -14,7 +14,7 @@ export type {
 	CreateMessageRequest,
 	WireRunStatus,
 	RunStopReason,
-	Run,
+	WireRun,
 	RunHierarchyNode,
 	ApiPermissionMode,
 	RunConfig,
@@ -29,8 +29,6 @@ export type {
 	ApiError,
 } from './api.js'
 
-export type { ProjectId, RunId, MessageId, SessionId } from './ids.js'
-
 export {
 	ProjectIdSchema,
 	RunIdSchema,