@namzu/sdk 42.0.2 → 44.0.0

package/dist/contracts/session/api.d.ts

@@ -0,0 +1,94 @@
+import type { SessionId, TurnId } from '../../types/ids/index.js';
+import type { WireTurnConfig } from './turn.js';
+/**
+ * `POST /sessions/{id}/turns`: start the next turn of an existing session.
+ *
+ * A turn begins with a user message, so `message` is required. There is no
+ * `agent_id`: the session's agent is fixed when the session starts, and a
+ * turn cannot switch it.
+ *
+ * A session has at most one active turn. A host answers a request that
+ * arrives while one is running, paused or interrupted with a conflict that
+ * names the active turn.
+ */
+export interface CreateTurnRequest {
+    message: string;
+    config: WireTurnConfig;
+    env?: Record<string, string>;
+    stream?: boolean;
+}
+/**
+ * A session that exists for one turn: the session and its first turn are
+ * created together, and the client never addresses the session again.
+ */
+export interface CreateEphemeralSessionRequest {
+    agent_id: string;
+    message: string;
+    config: WireTurnConfig;
+    env?: Record<string, string>;
+}
+/** The turn lifecycle events on a session stream, in lifecycle order. */
+export declare const TURN_STREAM_EVENT_TYPES: readonly ["turn.started", "turn.completed", "turn.failed", "turn.cancelled", "turn.paused", "turn.resuming"];
+export type TurnStreamEventType = (typeof TURN_STREAM_EVENT_TYPES)[number];
+/** Every event name a session stream (SSE) carries. */
+export type SessionStreamEventType = TurnStreamEventType | 'iteration.started' | 'iteration.completed'
+/**
+ * Who answers when this turn asks a human, changed mid-turn.
+ *
+ * Wire-visible for the same reason `compaction.completed` is: an operator
+ * watching a live turn needs to see supervision loosen, not infer it from
+ * approvals that stopped arriving. Names only; the wire cannot carry a
+ * handler.
+ */
+ | 'approval_policy.changed'
+/**
+ * A compaction pass replaced a span of history with a summary. Wire-
+ * visible because the operation is destructive: a client rendering the
+ * transcript needs to know its middle was dropped, not infer it.
+ */
+ | 'compaction.completed'
+/** Oversized tool results were emptied instead of the history summarized. */
+ | 'compaction.tool_results_cleared' | 'memory.consolidated' | 'background_job.exited' | 'compaction.failed'
+/** A guardrail refused or corrected the turn. */
+ | 'guardrail.triggered'
+/**
+ * Extended-thinking lifecycle. Wire-visible because without it a client
+ * renders a multi-second stall with no events while the model is working.
+ */
+ | 'reasoning.started' | 'reasoning.delta' | 'reasoning.completed'
+/**
+ * A model call failed transiently and is being retried after a backoff.
+ * Without it a client sees no event and no keepalive for the whole
+ * backoff, so a turn that is about to succeed looks like one that hung.
+ */
+ | 'provider.retry' | 'hosted.tool'
+/**
+ * A member of the provider chain could not serve and a later member took
+ * over. Without it a client cannot know the answer it is reading came from
+ * a provider it did not ask for, at a different price.
+ */
+ | 'provider.fallback' | 'tool.executing'
+/** Ephemeral progress from a long-running tool. Not in the transcript. */
+ | 'tool.progress' | 'tool.completed' | 'tool.error' | 'tool.input_started' | 'tool.input_delta' | 'tool.input_completed' | 'token.usage' | 'message.created' | 'message.delta' | 'message.completed'
+/**
+ * A tool asked the user a question and the turn is parked on it. A client
+ * cannot render an approval card for something it never hears about.
+ */
+ | 'question.asked' | 'question.answered' | 'review.requested' | 'review.completed' | 'checkpoint.created' | 'activity.created' | 'activity.updated' | 'plan.ready' | 'plan.approved' | 'plan.rejected' | 'plan.step_updated' | 'plan.completed' | 'plan.failed' | 'agent.pending' | 'agent.completed' | 'agent.failed' | 'agent.canceled' | 'task.created' | 'task.updated' | 'plugin.hook_executing' | 'plugin.hook_completed' | 'sandbox.created' | 'sandbox.exec' | 'sandbox.destroyed';
+/** One event on a session stream. */
+export interface SessionStreamEvent {
+    event: SessionStreamEventType;
+    data: Record<string, unknown>;
+}
+/** The ids every `turn.*` payload carries. */
+export interface TurnStreamEventData {
+    session_id: SessionId;
+    turn_id: TurnId;
+    [key: string]: unknown;
+}
+/** A `turn.*` event: its payload always names the session and the turn. */
+export interface TurnStreamEvent extends SessionStreamEvent {
+    event: TurnStreamEventType;
+    data: TurnStreamEventData;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/contracts/session/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/contracts/session/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5B;AAED,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,8GAO1B,CAAA;AAEV,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1E,uDAAuD;AACvD,MAAM,MAAM,sBAAsB,GAC/B,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB;AACvB;;;;;;;GAOG;GACD,yBAAyB;AAC3B;;;;GAIG;GACD,sBAAsB;AACxB,6EAA6E;GAC3E,iCAAiC,GACjC,qBAAqB,GACrB,uBAAuB,GACvB,mBAAmB;AACrB,iDAAiD;GAC/C,qBAAqB;AACvB;;;GAGG;GACD,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB;AACvB;;;;GAIG;GACD,gBAAgB,GAChB,aAAa;AACf;;;;GAIG;GACD,mBAAmB,GACnB,gBAAgB;AAClB,0EAA0E;GACxE,eAAe,GACf,gBAAgB,GAChB,YAAY,GACZ,oBAAoB,GACpB,kBAAkB,GAClB,sBAAsB,GACtB,aAAa,GACb,iBAAiB,GACjB,eAAe,GACf,mBAAmB;AACrB;;;GAGG;GACD,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,eAAe,GACf,mBAAmB,GACnB,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,uBAAuB,GACvB,uBAAuB,GACvB,iBAAiB,GACjB,cAAc,GACd,mBAAmB,CAAA;AAEtB,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,sBAAsB,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7B;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IACnC,UAAU,EAAE,SAAS,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACtB;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IAC1D,KAAK,EAAE,mBAAmB,CAAA;IAC1B,IAAI,EAAE,mBAAmB,CAAA;CACzB"}

package/dist/contracts/session/api.js

@@ -0,0 +1,10 @@
+/** The turn lifecycle events on a session stream, in lifecycle order. */
+export const TURN_STREAM_EVENT_TYPES = [
+    'turn.started',
+    'turn.completed',
+    'turn.failed',
+    'turn.cancelled',
+    'turn.paused',
+    'turn.resuming',
+];
+//# sourceMappingURL=api.js.map

package/dist/contracts/session/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/contracts/session/api.ts"],"names":[],"mappings":"AAgCA,yEAAyE;AACzE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACtC,cAAc;IACd,gBAAgB;IAChB,aAAa;IACb,gBAAgB;IAChB,aAAa;IACb,eAAe;CACN,CAAA"}

package/dist/contracts/session/index.d.ts

@@ -0,0 +1,7 @@
+export type { CreateEphemeralSessionRequest, CreateTurnRequest, SessionStreamEvent, SessionStreamEventType, TurnStreamEvent, TurnStreamEventData, TurnStreamEventType, } from './api.js';
+export { TURN_STREAM_EVENT_TYPES } from './api.js';
+export type { WireStopReason, WireTurn, WireTurnConfig, WireUsage } from './turn.js';
+export type { WireTurnStatus } from './turn-status.js';
+export { TURN_STATUS_TO_WIRE, WIRE_TURN_STATUSES, toWireTurnStatus } from './turn-status.js';
+export { CreateEphemeralSessionSchema, CreateTurnSchema, SessionIdSchema, TurnConfigSchema, TurnIdSchema, TurnStreamEventTypeSchema, WireTurnStatusSchema, } from './schemas.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contracts/session/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACX,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAElD,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAEpF,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE5F,OAAO,EACN,4BAA4B,EAC5B,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,yBAAyB,EACzB,oBAAoB,GACpB,MAAM,cAAc,CAAA"}

package/dist/contracts/session/index.js

@@ -0,0 +1,7 @@
+// Wire contracts for sessions and turns: snake_case shapes for HTTP, SSE and
+// A2A clients. A protocol's "run" is a namzu turn; its thread, context or
+// session is a namzu session. The public barrels re-export this module.
+export { TURN_STREAM_EVENT_TYPES } from './api.js';
+export { TURN_STATUS_TO_WIRE, WIRE_TURN_STATUSES, toWireTurnStatus } from './turn-status.js';
+export { CreateEphemeralSessionSchema, CreateTurnSchema, SessionIdSchema, TurnConfigSchema, TurnIdSchema, TurnStreamEventTypeSchema, WireTurnStatusSchema, } from './schemas.js';
+//# sourceMappingURL=index.js.map

package/dist/contracts/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contracts/session/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,0EAA0E;AAC1E,wEAAwE;AAWxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAKlD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE5F,OAAO,EACN,4BAA4B,EAC5B,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,yBAAyB,EACzB,oBAAoB,GACpB,MAAM,cAAc,CAAA"}

package/dist/contracts/session/schemas.d.ts

@@ -0,0 +1,173 @@
+import { z } from 'zod';
+/** A session id on the wire: an opaque UUID, the same spelling its constructor accepts. */
+export declare const SessionIdSchema: z.ZodString;
+/** A turn id on the wire: an opaque UUID, the same spelling its constructor accepts. */
+export declare const TurnIdSchema: z.ZodString;
+export declare const WireTurnStatusSchema: z.ZodEnum<["queued", "running", "awaiting_input", "completed", "failed", "cancelled", "cancelling", "expired"]>;
+export declare const TurnStreamEventTypeSchema: z.ZodEnum<["turn.started", "turn.completed", "turn.failed", "turn.cancelled", "turn.paused", "turn.resuming"]>;
+export declare const TurnConfigSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    tokenBudget: z.ZodOptional<z.ZodNumber>;
+    maxResponseTokens: z.ZodOptional<z.ZodNumber>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    streamIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    maxRequestRichContentBytes: z.ZodOptional<z.ZodNumber>;
+    permissionMode: z.ZodOptional<z.ZodEnum<["plan", "auto"]>>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    model?: string | undefined;
+    timeoutMs?: number | undefined;
+    temperature?: number | undefined;
+    tokenBudget?: number | undefined;
+    maxResponseTokens?: number | undefined;
+    systemPrompt?: string | undefined;
+    streamIdleTimeoutMs?: number | undefined;
+    maxRequestRichContentBytes?: number | undefined;
+    permissionMode?: "plan" | "auto" | undefined;
+}, {
+    model?: string | undefined;
+    timeoutMs?: number | undefined;
+    temperature?: number | undefined;
+    tokenBudget?: number | undefined;
+    maxResponseTokens?: number | undefined;
+    systemPrompt?: string | undefined;
+    streamIdleTimeoutMs?: number | undefined;
+    maxRequestRichContentBytes?: number | undefined;
+    permissionMode?: "plan" | "auto" | undefined;
+}>;
+/** `POST /sessions/{id}/turns`. The session id comes from the path, not the body. */
+export declare const CreateTurnSchema: z.ZodObject<{
+    message: z.ZodString;
+    config: z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        tokenBudget: z.ZodOptional<z.ZodNumber>;
+        maxResponseTokens: z.ZodOptional<z.ZodNumber>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        streamIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxRequestRichContentBytes: z.ZodOptional<z.ZodNumber>;
+        permissionMode: z.ZodOptional<z.ZodEnum<["plan", "auto"]>>;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        model?: string | undefined;
+        timeoutMs?: number | undefined;
+        temperature?: number | undefined;
+        tokenBudget?: number | undefined;
+        maxResponseTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+        streamIdleTimeoutMs?: number | undefined;
+        maxRequestRichContentBytes?: number | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
+    }, {
+        model?: string | undefined;
+        timeoutMs?: number | undefined;
+        temperature?: number | undefined;
+        tokenBudget?: number | undefined;
+        maxResponseTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+        streamIdleTimeoutMs?: number | undefined;
+        maxRequestRichContentBytes?: number | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
+    }>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    stream: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    message: string;
+    config: {
+        model?: string | undefined;
+        timeoutMs?: number | undefined;
+        temperature?: number | undefined;
+        tokenBudget?: number | undefined;
+        maxResponseTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+        streamIdleTimeoutMs?: number | undefined;
+        maxRequestRichContentBytes?: number | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
+    };
+    env?: Record<string, string> | undefined;
+    stream?: boolean | undefined;
+}, {
+    message: string;
+    config: {
+        model?: string | undefined;
+        timeoutMs?: number | undefined;
+        temperature?: number | undefined;
+        tokenBudget?: number | undefined;
+        maxResponseTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+        streamIdleTimeoutMs?: number | undefined;
+        maxRequestRichContentBytes?: number | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
+    };
+    env?: Record<string, string> | undefined;
+    stream?: boolean | undefined;
+}>;
+/** A session and its first turn, created together. */
+export declare const CreateEphemeralSessionSchema: z.ZodObject<{
+    agent_id: z.ZodString;
+    message: z.ZodString;
+    config: z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        tokenBudget: z.ZodOptional<z.ZodNumber>;
+        maxResponseTokens: z.ZodOptional<z.ZodNumber>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        streamIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxRequestRichContentBytes: z.ZodOptional<z.ZodNumber>;
+        permissionMode: z.ZodOptional<z.ZodEnum<["plan", "auto"]>>;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        model?: string | undefined;
+        timeoutMs?: number | undefined;
+        temperature?: number | undefined;
+        tokenBudget?: number | undefined;
+        maxResponseTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+        streamIdleTimeoutMs?: number | undefined;
+        maxRequestRichContentBytes?: number | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
+    }, {
+        model?: string | undefined;
+        timeoutMs?: number | undefined;
+        temperature?: number | undefined;
+        tokenBudget?: number | undefined;
+        maxResponseTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+        streamIdleTimeoutMs?: number | undefined;
+        maxRequestRichContentBytes?: number | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
+    }>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    message: string;
+    config: {
+        model?: string | undefined;
+        timeoutMs?: number | undefined;
+        temperature?: number | undefined;
+        tokenBudget?: number | undefined;
+        maxResponseTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+        streamIdleTimeoutMs?: number | undefined;
+        maxRequestRichContentBytes?: number | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
+    };
+    agent_id: string;
+    env?: Record<string, string> | undefined;
+}, {
+    message: string;
+    config: {
+        model?: string | undefined;
+        timeoutMs?: number | undefined;
+        temperature?: number | undefined;
+        tokenBudget?: number | undefined;
+        maxResponseTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+        streamIdleTimeoutMs?: number | undefined;
+        maxRequestRichContentBytes?: number | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
+    };
+    agent_id: string;
+    env?: Record<string, string> | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/contracts/session/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/contracts/session/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAYvB,2FAA2F;AAC3F,eAAO,MAAM,eAAe,aAAmE,CAAA;AAE/F,wFAAwF;AACxF,eAAO,MAAM,YAAY,aAAgE,CAAA;AAEzF,eAAO,MAAM,oBAAoB,iHAA6B,CAAA;AAE9D,eAAO,MAAM,yBAAyB,gHAAkC,CAAA;AAExE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBnB,CAAA;AAEV,qFAAqF;AACrF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOnB,CAAA;AAEV,sDAAsD;AACtD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAA"}

package/dist/contracts/session/schemas.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { entityIdPattern } from '../../utils/id-format.js';
+import { TURN_STREAM_EVENT_TYPES } from './api.js';
+import { WIRE_TURN_STATUSES } from './turn-status.js';
+// Request validation for the session and turn wire surface. The schemas are
+// not annotated with the interfaces they validate, on purpose: an annotation
+// would make the inferred type the interface itself and hide any drift. The
+// tests assert instead that each schema infers exactly its interface, so a
+// field added to one and not the other fails the typecheck.
+/** A session id on the wire: an opaque UUID, the same spelling its constructor accepts. */
+export const SessionIdSchema = z.string().regex(entityIdPattern(), 'Invalid session ID format');
+/** A turn id on the wire: an opaque UUID, the same spelling its constructor accepts. */
+export const TurnIdSchema = z.string().regex(entityIdPattern(), 'Invalid turn ID format');
+export const WireTurnStatusSchema = z.enum(WIRE_TURN_STATUSES);
+export const TurnStreamEventTypeSchema = z.enum(TURN_STREAM_EVENT_TYPES);
+export const TurnConfigSchema = z
+    .object({
+    model: z.string().min(1).optional(),
+    temperature: z.number().min(0).max(2).optional(),
+    tokenBudget: z.number().int().nonnegative().optional(),
+    maxResponseTokens: z.number().int().positive().optional(),
+    timeoutMs: z.number().int().nonnegative().max(3_600_000).optional(),
+    streamIdleTimeoutMs: z.number().int().nonnegative().max(3_600_000).optional(),
+    maxRequestRichContentBytes: z
+        .number()
+        .int()
+        .nonnegative()
+        .max(Number.MAX_SAFE_INTEGER)
+        .optional(),
+    permissionMode: z.enum(['plan', 'auto']).optional(),
+    systemPrompt: z.string().min(1).max(100_000).optional(),
+})
+    .strict();
+/** `POST /sessions/{id}/turns`. The session id comes from the path, not the body. */
+export const CreateTurnSchema = z
+    .object({
+    message: z.string().min(1, 'message is required'),
+    config: TurnConfigSchema,
+    env: z.record(z.string()).optional(),
+    stream: z.boolean().optional(),
+})
+    .strict();
+/** A session and its first turn, created together. */
+export const CreateEphemeralSessionSchema = z
+    .object({
+    agent_id: z.string().min(1, 'agent_id is required'),
+    message: z.string().min(1, 'message is required'),
+    config: TurnConfigSchema,
+    env: z.record(z.string()).optional(),
+})
+    .strict();
+//# sourceMappingURL=schemas.js.map

package/dist/contracts/session/schemas.js.map

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

package/dist/contracts/session/turn-status.d.ts

@@ -0,0 +1,45 @@
+import type { TurnStatus } from '../../types/session/turn.js';
+/**
+ * A turn's status as HTTP, SSE and A2A payloads carry it.
+ *
+ * Distinct from the domain {@link TurnStatus}, which models the kernel's state
+ * machine. The wire enum collapses domain members onto the shape a remote
+ * client acts on: domain `succeeded` is wire `completed`, both `awaiting_hitl`
+ * members are wire `awaiting_input`, and `awaiting_subsession` is wire
+ * `running`.
+ */
+export type WireTurnStatus = 'queued' | 'running'
+/**
+ * The turn is waiting on a human: an approval, a question or a review.
+ *
+ * Distinct from `running` because a client acts on it differently. A
+ * running turn settles by itself; a turn awaiting input settles only when
+ * someone answers, so a client that saw `running` would wait forever for
+ * an answer nobody is going to give. A2A carries it as `input-required`.
+ */
+ | 'awaiting_input' | 'completed' | 'failed' | 'cancelled' | 'cancelling'
+/**
+ * The turn's approval window closed with nobody answering.
+ *
+ * Set by a host sweeping expired parks. No domain status collapses onto
+ * it: the kernel is suspended while parked and never observes its own
+ * deadline passing.
+ */
+ | 'expired';
+/** Every {@link WireTurnStatus} member, in declaration order. */
+export declare const WIRE_TURN_STATUSES: readonly ["queued", "running", "awaiting_input", "completed", "failed", "cancelled", "cancelling", "expired"];
+/**
+ * The collapse of every domain {@link TurnStatus} onto the wire.
+ *
+ * A `Record` over the domain union, so a new domain status is a type error
+ * here rather than an `undefined` on the wire.
+ */
+export declare const TURN_STATUS_TO_WIRE: Readonly<Record<TurnStatus, WireTurnStatus>>;
+/**
+ * Collapse a domain turn status onto the wire enum.
+ *
+ * Total over {@link TurnStatus}. A value outside the union (a status read from
+ * an untyped source) throws rather than putting `undefined` on the wire.
+ */
+export declare function toWireTurnStatus(status: TurnStatus): WireTurnStatus;
+//# sourceMappingURL=turn-status.d.ts.map

package/dist/contracts/session/turn-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-status.d.ts","sourceRoot":"","sources":["../../../src/contracts/session/turn-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACvB,QAAQ,GACR,SAAS;AACX;;;;;;;GAOG;GACD,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,WAAW,GACX,YAAY;AACd;;;;;;GAMG;GACD,SAAS,CAAA;AAEZ,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,+GASe,CAAA;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAe3E,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAKnE"}

package/dist/contracts/session/turn-status.js

@@ -0,0 +1,46 @@
+/** Every {@link WireTurnStatus} member, in declaration order. */
+export const WIRE_TURN_STATUSES = [
+    'queued',
+    'running',
+    'awaiting_input',
+    'completed',
+    'failed',
+    'cancelled',
+    'cancelling',
+    'expired',
+];
+/**
+ * The collapse of every domain {@link TurnStatus} onto the wire.
+ *
+ * A `Record` over the domain union, so a new domain status is a type error
+ * here rather than an `undefined` on the wire.
+ */
+export const TURN_STATUS_TO_WIRE = Object.freeze({
+    queued: 'queued',
+    running: 'running',
+    // Both HITL members wait on a person. `awaiting_hitl_resolution` is the
+    // persisted variant (the user is absent and the turn survives until the
+    // decision is resolved or the turn is abandoned); to a client the two are
+    // the same thing: nothing happens until someone answers.
+    awaiting_hitl: 'awaiting_input',
+    awaiting_hitl_resolution: 'awaiting_input',
+    // A turn delegated to a child session settles by itself when the child
+    // does, so it is still running to a client.
+    awaiting_subsession: 'running',
+    succeeded: 'completed',
+    failed: 'failed',
+    cancelled: 'cancelled',
+});
+/**
+ * Collapse a domain turn status onto the wire enum.
+ *
+ * Total over {@link TurnStatus}. A value outside the union (a status read from
+ * an untyped source) throws rather than putting `undefined` on the wire.
+ */
+export function toWireTurnStatus(status) {
+    if (!Object.hasOwn(TURN_STATUS_TO_WIRE, status)) {
+        throw new Error(`Unmapped turn status: ${String(status)}`);
+    }
+    return TURN_STATUS_TO_WIRE[status];
+}
+//# sourceMappingURL=turn-status.js.map

package/dist/contracts/session/turn-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-status.js","sourceRoot":"","sources":["../../../src/contracts/session/turn-status.ts"],"names":[],"mappings":"AAoCA,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IACjC,QAAQ;IACR,SAAS;IACT,gBAAgB;IAChB,WAAW;IACX,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,SAAS;CACoC,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiD,MAAM,CAAC,MAAM,CAAC;IAC9F,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,wEAAwE;IACxE,wEAAwE;IACxE,0EAA0E;IAC1E,yDAAyD;IACzD,aAAa,EAAE,gBAAgB;IAC/B,wBAAwB,EAAE,gBAAgB;IAC1C,uEAAuE;IACvE,4CAA4C;IAC5C,mBAAmB,EAAE,SAAS;IAC9B,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CACtB,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IAClD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC"}

package/dist/contracts/session/turn.d.ts

@@ -0,0 +1,64 @@
+import type { ProjectId, SessionId, TurnId } from '../../types/ids/index.js';
+import type { Turn } from '../../types/session/turn.js';
+import type { ApiPermissionMode, ISOTimestamp } from '../api.js';
+import type { WireTurnStatus } from './turn-status.js';
+/**
+ * Why a turn stopped, as the wire's `stop_reason` field carries it.
+ *
+ * The domain stop reason under a wire name, so the HTTP field stays decoupled
+ * from the internal type's identifier.
+ */
+export type WireStopReason = NonNullable<Turn['stopReason']>;
+/** The per-turn configuration a client may set. Every field is optional; the agent's defaults fill the rest. */
+export interface WireTurnConfig {
+    model?: string;
+    temperature?: number;
+    tokenBudget?: number;
+    maxResponseTokens?: number;
+    timeoutMs?: number;
+    streamIdleTimeoutMs?: number;
+    maxRequestRichContentBytes?: number;
+    permissionMode?: ApiPermissionMode;
+    systemPrompt?: string;
+}
+/** What one turn spent. Usage of this turn only; child sessions report their own. */
+export interface WireUsage {
+    input_tokens: number;
+    output_tokens: number;
+    total_tokens: number;
+    total_cost_usd?: number;
+}
+/**
+ * One turn of a session, as HTTP, SSE and A2A payloads carry it.
+ *
+ * A turn always belongs to a session: `session_id` is required. A child
+ * session's turn names the parent session and the parent turn whose tool call
+ * spawned it; `child_session_ids` lists the child sessions this turn spawned.
+ */
+export interface WireTurn {
+    turn_id: TurnId;
+    session_id: SessionId;
+    project_id: ProjectId | null;
+    agent_id: string;
+    agent_name?: string;
+    status: WireTurnStatus;
+    stop_reason?: WireStopReason;
+    created_at: ISOTimestamp;
+    started_at?: ISOTimestamp;
+    completed_at?: ISOTimestamp;
+    duration_ms?: number;
+    model?: string;
+    config: WireTurnConfig;
+    usage?: WireUsage;
+    iterations?: number;
+    /** The authoritative answer, after guardrail, review and structured-output overrides. */
+    result?: string;
+    last_error?: string;
+    /** Present on a child session's turn: the session that delegated it. */
+    parent_session_id?: SessionId;
+    /** Present on a child session's turn: the parent turn whose tool call spawned the child. */
+    parent_turn_id?: TurnId;
+    depth?: number;
+    child_session_ids?: SessionId[];
+}
+//# sourceMappingURL=turn.d.ts.map

package/dist/contracts/session/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../../../src/contracts/session/turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAA;AAE5D,gHAAgH;AAChH,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,SAAS,CAAA;IACrB,UAAU,EAAE,SAAS,GAAG,IAAI,CAAA;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,CAAC,EAAE,cAAc,CAAA;IAC5B,UAAU,EAAE,YAAY,CAAA;IACxB,UAAU,CAAC,EAAE,YAAY,CAAA;IACzB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,SAAS,CAAA;IAC7B,4FAA4F;IAC5F,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAA;CAC/B"}

package/dist/contracts/session/turn.js

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

package/dist/contracts/session/turn.js.map

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

package/dist/directory/derive-supervisor.d.ts

@@ -45,7 +45,7 @@ export interface DelegatePlan {
 /**
  * Turn a project that declares delegates into a supervisor configuration.
  *
- * The counterpart to `deriveRunOptions` for the multi-agent shape, and the
+ * The counterpart to `deriveTurnOptions` for the multi-agent shape, and the
  * same contract: it converts, it does not run. `SupervisorAgent` needs an
  * `agentIds` roster and a manager that can spawn them; this supplies the
  * roster from the directory and leaves the manager to the host.

package/dist/directory/derive-supervisor.js

@@ -22,7 +22,7 @@ function delegatePlan(entry, fallbackModel) {
 /**
  * Turn a project that declares delegates into a supervisor configuration.
  *
- * The counterpart to `deriveRunOptions` for the multi-agent shape, and the
+ * The counterpart to `deriveTurnOptions` for the multi-agent shape, and the
  * same contract: it converts, it does not run. `SupervisorAgent` needs an
  * `agentIds` roster and a manager that can spawn them; this supplies the
  * roster from the directory and leaves the manager to the host.
@@ -40,7 +40,7 @@ export function deriveSupervisorOptions(manifest, input) {
         // An empty roster makes `create_task` unmountable by design, so the
         // result would be a coordinator that cannot coordinate — and the
         // caller asked for a supervisor, which means they expected delegates.
-        throw new Error(`${manifest.root} declares no delegates, so there is nothing for a supervisor to coordinate. Add directories under agents/, or use deriveRunOptions for a single agent.`);
+        throw new Error(`${manifest.root} declares no delegates, so there is nothing for a supervisor to coordinate. Add directories under agents/, or use deriveTurnOptions for a single agent.`);
     }
     const model = input.model ?? manifest.config.model;
     if (!model) {

package/dist/directory/derive-supervisor.js.map

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

package/dist/directory/derive.d.ts

@@ -1,5 +1,5 @@
 import type { RunAgentOptions } from '../agents/runAgent.js';
-import type { DeriveRunOptionsInput, DirectoryManifest } from './types.js';
+import type { DeriveTurnOptionsInput, DirectoryManifest } from './types.js';
 /**
  * Turn a loaded project into the options `runAgent` takes.
  *
@@ -8,5 +8,5 @@ import type { DeriveRunOptionsInput, DirectoryManifest } from './types.js';
  * spreads `overrides` or stops using this function — there is no behaviour
  * reachable only through the convention.
  */
-export declare function deriveRunOptions(manifest: DirectoryManifest, input: DeriveRunOptionsInput): RunAgentOptions;
+export declare function deriveTurnOptions(manifest: DirectoryManifest, input: DeriveTurnOptionsInput): RunAgentOptions;
 //# sourceMappingURL=derive.d.ts.map

package/dist/directory/derive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/directory/derive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAG5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE1E;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,qBAAqB,GAC1B,eAAe,CAkEjB"}
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/directory/derive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAG5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE3E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,sBAAsB,GAC3B,eAAe,CAkEjB"}

package/dist/directory/derive.js

@@ -7,13 +7,13 @@ import { ToolRegistry } from '../registry/tool/execute.js';
  * spreads `overrides` or stops using this function — there is no behaviour
  * reachable only through the convention.
  */
-export function deriveRunOptions(manifest, input) {
+export function deriveTurnOptions(manifest, input) {
     if (manifest.modules === 'skip') {
         // The manifest is structurally complete and its tools were never
         // imported, so `manifest.tools` is empty for a reason that has nothing
         // to do with the project. Running it would produce an agent with no
         // capabilities and no indication why.
-        throw new Error('This manifest was loaded with modules: "skip", so no tool was imported and none can be registered. Load with modules: "evaluate" before deriving run options.');
+        throw new Error('This manifest was loaded with modules: "skip", so no tool was imported and none can be registered. Load with modules: "evaluate" before deriving runAgent options.');
     }
     const model = input.model ?? manifest.config.model;
     if (!model) {