@namzu/sdk 42.0.2 → 44.0.0

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

@@ -35,10 +35,17 @@ export declare const GENAI: {
     readonly TOOL_CALL_ID: "gen_ai.tool.call.id";
     readonly AGENT_NAME: "gen_ai.agent.name";
     readonly AGENT_ID: "gen_ai.agent.id";
+    /**
+     * The conversation a span belongs to. In namzu that is the session: the
+     * value is the `sessionId`.
+     */
+    readonly CONVERSATION_ID: "gen_ai.conversation.id";
 };
 export declare const NAMZU: {
-    readonly RUN_ID: "namzu.run.id";
-    readonly RUN_STATUS: "namzu.run.status";
+    readonly TURN_ID: "namzu.turn.id";
+    readonly TURN_STATUS: "namzu.turn.status";
+    /** Set on a child session's spans: the parent session that delegated it. */
+    readonly SESSION_PARENT_ID: "namzu.session.parent_id";
     readonly ITERATION: "namzu.iteration";
     readonly TOOL_SUCCESS: "namzu.tool.success";
     readonly TOOL_ERROR: "namzu.tool.error";
@@ -50,7 +57,6 @@ export declare const NAMZU: {
     readonly THREAD_ID: "namzu.thread.id";
     readonly PROJECT_ID: "namzu.project.id";
     readonly TENANT_ID: "namzu.tenant.id";
-    readonly RUN_PARENT_ID: "namzu.run.parent_id";
     readonly AGENT_TYPE: "namzu.agent.type";
     readonly REGISTRY_NAME: "namzu.registry.name";
     readonly CREDENTIAL_ID: "namzu.credential.id";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/constants/telemetry/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;;;;;;;;;;;IAejB;;;;;OAKG;;;;IAMH;;;;;;;;;;;;;OAaG;;;;CAKM,CAAA;AAEV,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;CA+ER,CAAA;AAEV;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;CAWnB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/constants/telemetry/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;;;;;;;;;;;IAejB;;;;;OAKG;;;;IAMH;;;;;;;;;;;;;OAaG;;;;IAMH;;;OAGG;;CAEM,CAAA;AAEV,eAAO,MAAM,KAAK;;;IAGjB,4EAA4E;;;;;;;;;;;;;;;;;;;;;;;CAyEnE,CAAA;AAEV;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;CAWnB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAA"}

package/dist/constants/telemetry/index.js

@@ -35,10 +35,17 @@ export const GENAI = {
     TOOL_CALL_ID: 'gen_ai.tool.call.id',
     AGENT_NAME: 'gen_ai.agent.name',
     AGENT_ID: 'gen_ai.agent.id',
+    /**
+     * The conversation a span belongs to. In namzu that is the session: the
+     * value is the `sessionId`.
+     */
+    CONVERSATION_ID: 'gen_ai.conversation.id',
 };
 export const NAMZU = {
-    RUN_ID: 'namzu.run.id',
-    RUN_STATUS: 'namzu.run.status',
+    TURN_ID: 'namzu.turn.id',
+    TURN_STATUS: 'namzu.turn.status',
+    /** Set on a child session's spans: the parent session that delegated it. */
+    SESSION_PARENT_ID: 'namzu.session.parent_id',
     ITERATION: 'namzu.iteration',
     TOOL_SUCCESS: 'namzu.tool.success',
     TOOL_ERROR: 'namzu.tool.error',
@@ -46,23 +53,18 @@ export const NAMZU = {
     CACHE_READ_TOKENS: 'namzu.cache.read_tokens',
     CACHE_WRITE_TOKENS: 'namzu.cache.write_tokens',
     CACHE_DISCOUNT: 'namzu.cache.discount',
-    // Correlation attributes for the run's own logger — see
-    // RunContextFactory.buildLogger (runtime/query/context.ts). RUN_ID above
-    // already covered the run itself; these are the layers above it
-    // (Tenant -> Project -> Thread -> Session -> Run, Convention #17) that
-    // used to reach the run's logger as four bare, un-namespaced keys.
+    // Correlation attributes for a turn's own logger — see
+    // TurnContextFactory.buildLogger (runtime/query/context.ts). TURN_ID above
+    // covers the turn itself; these are the layers above it
+    // (Tenant -> Project -> Topic -> Session -> Turn, Convention #17).
     SESSION_ID: 'namzu.session.id',
     THREAD_ID: 'namzu.thread.id',
     PROJECT_ID: 'namzu.project.id',
     TENANT_ID: 'namzu.tenant.id',
-    // Set only when a run was started by another run (the sub-agent gateway
-    // path) — see query()'s params.parentRunId in runtime/query/index.ts.
-    // Previously reached the RunContext's own fields but never the logger.
-    RUN_PARENT_ID: 'namzu.run.parent_id',
     // AbstractAgent's per-instance identity (agents/AbstractAgent.ts). The id
     // half reuses GENAI.AGENT_ID — an agent's id is the same concept whether
     // it is read off a span or a log record, and GENAI.AGENT_ID already
-    // exists and is already bound at the run's own correlated logger and
+    // exists and is already bound at the turn's own correlated logger and
     // root span. TYPE has no GENAI analogue, so it is new.
     AGENT_TYPE: 'namzu.agent.type',
     // ManagedRegistry's per-subclass distinction (registry/ManagedRegistry.ts).

package/dist/constants/telemetry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/telemetry/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACpB,cAAc,EAAE,uBAAuB;IACvC,MAAM,EAAE,eAAe;IAEvB,aAAa,EAAE,sBAAsB;IACrC,mBAAmB,EAAE,4BAA4B;IACjD,kBAAkB,EAAE,2BAA2B;IAE/C,cAAc,EAAE,uBAAuB;IACvC,uBAAuB,EAAE,gCAAgC;IACzD,WAAW,EAAE,oBAAoB;IAEjC,kBAAkB,EAAE,2BAA2B;IAC/C,mBAAmB,EAAE,4BAA4B;IAEjD;;;;;OAKG;IACH,UAAU,EAAE,mBAAmB;IAE/B,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,kBAAkB;IAE7B;;;;;;;;;;;;;OAaG;IACH,YAAY,EAAE,qBAAqB;IAEnC,UAAU,EAAE,mBAAmB;IAC/B,QAAQ,EAAE,iBAAiB;CAClB,CAAA;AAEV,MAAM,CAAC,MAAM,KAAK,GAAG;IACpB,MAAM,EAAE,cAAc;IACtB,UAAU,EAAE,kBAAkB;IAC9B,SAAS,EAAE,iBAAiB;IAC5B,YAAY,EAAE,oBAAoB;IAClC,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE,kBAAkB;IAC9B,iBAAiB,EAAE,yBAAyB;IAC5C,kBAAkB,EAAE,0BAA0B;IAC9C,cAAc,EAAE,sBAAsB;IAEtC,wDAAwD;IACxD,yEAAyE;IACzE,gEAAgE;IAChE,uEAAuE;IACvE,mEAAmE;IACnE,UAAU,EAAE,kBAAkB;IAC9B,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,kBAAkB;IAC9B,SAAS,EAAE,iBAAiB;IAC5B,wEAAwE;IACxE,sEAAsE;IACtE,uEAAuE;IACvE,aAAa,EAAE,qBAAqB;IAEpC,0EAA0E;IAC1E,yEAAyE;IACzE,oEAAoE;IACpE,qEAAqE;IACrE,uDAAuD;IACvD,UAAU,EAAE,kBAAkB;IAE9B,4EAA4E;IAC5E,yEAAyE;IACzE,qEAAqE;IACrE,sEAAsE;IACtE,mEAAmE;IACnE,aAAa,EAAE,qBAAqB;IAEpC,wEAAwE;IACxE,mEAAmE;IACnE,uEAAuE;IACvE,qCAAqC;IACrC,aAAa,EAAE,qBAAqB;IACpC,gBAAgB,EAAE,wBAAwB;IAE1C,uEAAuE;IACvE,iEAAiE;IACjE,qEAAqE;IACrE,qEAAqE;IACrE,+CAA+C;IAC/C,4EAA4E;IAC5E,wEAAwE;IACxE,mCAAmC;IACnC,SAAS,EAAE,2BAA2B;IACtC,WAAW,EAAE,6BAA6B;IAE1C,0EAA0E;IAC1E,yEAAyE;IACzE,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,uBAAuB;IACvB,aAAa,EAAE,qBAAqB;IAEpC,wEAAwE;IACxE,mEAAmE;IACnE,0EAA0E;IAC1E,uEAAuE;IACvE,mEAAmE;IACnE,sEAAsE;IACtE,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,sBAAsB;IAEtC,uEAAuE;IACvE,6DAA6D;IAC7D,uEAAuE;IACvE,qDAAqD;IACrD,UAAU,EAAE,kBAAkB;CACrB,CAAA;AAEV;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,UAAU,EAAE,kBAAkB;IAC9B,eAAe,EAAE,uBAAuB;IACxC,gBAAgB,EAAE,wBAAwB;IAC1C,iBAAiB,EAAE,yBAAyB;IAC5C,mBAAmB,EAAE,2BAA2B;IAChD,iBAAiB,EAAE,yBAAyB;IAC5C,gBAAgB,EAAE,wBAAwB;IAC1C,mBAAmB,EAAE,2BAA2B;IAChD,YAAY,EAAE,oBAAoB;IAClC,UAAU,EAAE,kBAAkB;CACrB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/telemetry/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACpB,cAAc,EAAE,uBAAuB;IACvC,MAAM,EAAE,eAAe;IAEvB,aAAa,EAAE,sBAAsB;IACrC,mBAAmB,EAAE,4BAA4B;IACjD,kBAAkB,EAAE,2BAA2B;IAE/C,cAAc,EAAE,uBAAuB;IACvC,uBAAuB,EAAE,gCAAgC;IACzD,WAAW,EAAE,oBAAoB;IAEjC,kBAAkB,EAAE,2BAA2B;IAC/C,mBAAmB,EAAE,4BAA4B;IAEjD;;;;;OAKG;IACH,UAAU,EAAE,mBAAmB;IAE/B,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,kBAAkB;IAE7B;;;;;;;;;;;;;OAaG;IACH,YAAY,EAAE,qBAAqB;IAEnC,UAAU,EAAE,mBAAmB;IAC/B,QAAQ,EAAE,iBAAiB;IAE3B;;;OAGG;IACH,eAAe,EAAE,wBAAwB;CAChC,CAAA;AAEV,MAAM,CAAC,MAAM,KAAK,GAAG;IACpB,OAAO,EAAE,eAAe;IACxB,WAAW,EAAE,mBAAmB;IAChC,4EAA4E;IAC5E,iBAAiB,EAAE,yBAAyB;IAC5C,SAAS,EAAE,iBAAiB;IAC5B,YAAY,EAAE,oBAAoB;IAClC,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE,kBAAkB;IAC9B,iBAAiB,EAAE,yBAAyB;IAC5C,kBAAkB,EAAE,0BAA0B;IAC9C,cAAc,EAAE,sBAAsB;IAEtC,uDAAuD;IACvD,2EAA2E;IAC3E,wDAAwD;IACxD,mEAAmE;IACnE,UAAU,EAAE,kBAAkB;IAC9B,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,kBAAkB;IAC9B,SAAS,EAAE,iBAAiB;IAE5B,0EAA0E;IAC1E,yEAAyE;IACzE,oEAAoE;IACpE,sEAAsE;IACtE,uDAAuD;IACvD,UAAU,EAAE,kBAAkB;IAE9B,4EAA4E;IAC5E,yEAAyE;IACzE,qEAAqE;IACrE,sEAAsE;IACtE,mEAAmE;IACnE,aAAa,EAAE,qBAAqB;IAEpC,wEAAwE;IACxE,mEAAmE;IACnE,uEAAuE;IACvE,qCAAqC;IACrC,aAAa,EAAE,qBAAqB;IACpC,gBAAgB,EAAE,wBAAwB;IAE1C,uEAAuE;IACvE,iEAAiE;IACjE,qEAAqE;IACrE,qEAAqE;IACrE,+CAA+C;IAC/C,4EAA4E;IAC5E,wEAAwE;IACxE,mCAAmC;IACnC,SAAS,EAAE,2BAA2B;IACtC,WAAW,EAAE,6BAA6B;IAE1C,0EAA0E;IAC1E,yEAAyE;IACzE,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,uBAAuB;IACvB,aAAa,EAAE,qBAAqB;IAEpC,wEAAwE;IACxE,mEAAmE;IACnE,0EAA0E;IAC1E,uEAAuE;IACvE,mEAAmE;IACnE,sEAAsE;IACtE,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,sBAAsB;IAEtC,uEAAuE;IACvE,6DAA6D;IAC7D,uEAAuE;IACvE,qDAAqD;IACrD,UAAU,EAAE,kBAAkB;CACrB,CAAA;AAEV;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,UAAU,EAAE,kBAAkB;IAC9B,eAAe,EAAE,uBAAuB;IACxC,gBAAgB,EAAE,wBAAwB;IAC1C,iBAAiB,EAAE,yBAAyB;IAC5C,mBAAmB,EAAE,2BAA2B;IAChD,iBAAiB,EAAE,yBAAyB;IAC5C,gBAAgB,EAAE,wBAAwB;IAC1C,mBAAmB,EAAE,2BAA2B;IAChD,YAAY,EAAE,oBAAoB;IAClC,UAAU,EAAE,kBAAkB;CACrB,CAAA"}

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

@@ -1,8 +1,8 @@
 export declare const DANGEROUS_PATTERNS: RegExp[];
 export declare const FILESYSTEM_TOOLS: Set<string>;
 /**
- * Subdirectory of a run directory holding tool output that exceeded the
- * model-visible budget. Kept beside the run so it is cleaned up with the
+ * Subdirectory of a turn directory holding tool output that exceeded the
+ * model-visible budget. Kept beside the turn so it is cleaned up with the
  * run and reachable by the agent through its own `read`/`grep`.
  */
 export declare const TOOL_OUTPUT_DIR_NAME = "tool-output";

package/dist/constants/tools/index.js

@@ -59,8 +59,8 @@ export const DANGEROUS_PATTERNS = [
 ];
 export const FILESYSTEM_TOOLS = new Set(['glob', 'read', 'write', 'bash']);
 /**
- * Subdirectory of a run directory holding tool output that exceeded the
- * model-visible budget. Kept beside the run so it is cleaned up with the
+ * Subdirectory of a turn directory holding tool output that exceeded the
+ * model-visible budget. Kept beside the turn so it is cleaned up with the
  * run and reachable by the agent through its own `read`/`grep`.
  */
 export const TOOL_OUTPUT_DIR_NAME = 'tool-output';

package/dist/contracts/a2a.d.ts

@@ -726,13 +726,13 @@ export declare const A2ATaskListSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     limit: number;
     state?: "pending" | "running" | "completed" | "failed" | "rejected" | "canceled" | "input-required" | undefined;
-    cursor?: string | undefined;
     contextId?: string | undefined;
+    cursor?: string | undefined;
 }, {
     limit?: number | undefined;
     state?: "pending" | "running" | "completed" | "failed" | "rejected" | "canceled" | "input-required" | undefined;
-    cursor?: string | undefined;
     contextId?: string | undefined;
+    cursor?: string | undefined;
 }>;
 export declare const A2ATaskCancelSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/contracts/api.d.ts

@@ -1,8 +1,9 @@
 import type { AgentCapabilities, AgentType } from '../types/agent/base.js';
-import type { ProjectId, RunId, SessionId } from '../types/ids/index.js';
+import type { SessionId } from '../types/ids/index.js';
 import type { MessageRole } from '../types/message/index.js';
 import type { PermissionMode } from '../types/permission/index.js';
-import type { StopReason } from '../types/run/events.js';
+import type { StopReason } from '../types/session/stop-reason.js';
+import type { WireTurnStatus } from './session/turn-status.js';
 export type { MessageRole, StopReason, AgentType, AgentCapabilities };
 export type ISOTimestamp = string;
 export interface AgentDefaults {
@@ -37,137 +38,21 @@ export interface CreateMessageRequest {
     metadata?: Record<string, unknown>;
 }
 /**
- * Wire-side run status for HTTP / A2A / SSE payloads.
+ * One session in a delegation tree, as a host's tree endpoint returns it.
  *
- * Distinct from the domain {@link import('../types/run/status.js').RunStatus}
- * which models the kernel state machine. The wire enum collapses domain
- * variants onto the HTTP-facing shape (e.g. domain `succeeded` → wire
- * `completed`; domain `awaiting_hitl*` → wire `running`; domain
- * `awaiting_subsession` → wire `running`).
+ * A child session is a delegated piece of work; `children` are the sessions it
+ * spawned in turn. `status` is the status of the session's latest turn.
  */
-export type WireRunStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'cancelling'
-/**
- * The run's approval window closed with nobody answering.
- *
- * Set by a host sweeping expired parks — there is no domain status that
- * collapses onto it, because the kernel is suspended mid-iteration while
- * parked and never gets to observe its own deadline passing.
- */
- | 'expired';
-export type RunStopReason = StopReason;
-export interface WireRun {
-    id: RunId;
-    project_id: ProjectId | null;
-    session_id?: SessionId;
-    agent_id: string;
-    agent_name?: string;
-    status: WireRunStatus;
-    stop_reason?: RunStopReason;
-    created_at: ISOTimestamp;
-    started_at?: ISOTimestamp;
-    completed_at?: ISOTimestamp;
-    duration_ms?: number;
-    model?: string;
-    config: RunConfig;
-    usage?: RunUsage;
-    iterations?: number;
-    result?: string;
-    last_error?: string;
-    parent_run_id?: RunId;
-    depth?: number;
-    child_run_ids?: RunId[];
-}
-export interface RunHierarchyNode {
-    run_id: RunId;
+export interface SessionTreeNode {
+    session_id: SessionId;
     agent_id: string;
+    /** 0 for a root session. */
     depth: number;
-    status: WireRunStatus;
-    children: RunHierarchyNode[];
+    status: WireTurnStatus;
+    children: SessionTreeNode[];
 }
 /** The wire name for the kernel's `PermissionMode`; one union, not a second copy of it. */
 export type ApiPermissionMode = PermissionMode;
-export interface RunConfig {
-    model?: string;
-    temperature?: number;
-    tokenBudget?: number;
-    maxResponseTokens?: number;
-    timeoutMs?: number;
-    streamIdleTimeoutMs?: number;
-    maxRequestRichContentBytes?: number;
-    permissionMode?: ApiPermissionMode;
-    systemPrompt?: string;
-}
-export interface RunUsage {
-    input_tokens: number;
-    output_tokens: number;
-    total_tokens: number;
-    total_cost_usd?: number;
-}
-export interface CreateRunRequest {
-    agent_id: string;
-    config: RunConfig;
-    env?: Record<string, string>;
-    stream?: boolean;
-}
-export interface CreateStatelessRunRequest {
-    agent_id: string;
-    message: string;
-    config: RunConfig;
-    env?: Record<string, string>;
-}
-export type StreamEventType = 'run.started' | 'run.completed' | 'run.failed' | 'run.cancelled' | 'run.paused' | 'run.resuming' | 'iteration.started' | 'iteration.completed'
-/**
- * Who answers when this run asks a human, changed mid-run.
- *
- * Wire-visible for the same reason `compaction.completed` is: an
- * operator watching a live run 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 run. */
- | 'guardrail.triggered'
-/**
- * Extended-thinking lifecycle. Wire-visible because without it a
- * client renders a multi-second stall with no events while the model
- * is demonstrably working.
- */
- | 'reasoning.started' | 'reasoning.delta' | 'reasoning.completed'
-/**
- * A model call failed transiently and is being retried after a backoff.
- * Wire-visible on the same grounds as `tool.progress` and the reasoning
- * events: without it a client sees no event and no keepalive for the
- * whole backoff, so a run that is about to succeed is indistinguishable
- * from one that has hung.
- */
- | 'provider.retry'
-/**
- * A member of the provider chain could not serve and a later member has
- * taken over. Wire-visible because a client that is not told has no way to
- * know the answer it is reading came from a provider it did not ask for —
- * at a different price, and possibly a different quality.
- */
- | 'hosted.tool' | '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 run is parked on it. Wire-
- * visible for the same reason `review.requested` is: 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';
-export interface StreamEvent {
-    event: StreamEventType;
-    data: Record<string, unknown>;
-}
 export interface PaginationParams {
     limit?: number;
     after?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/contracts/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/contracts/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAA;AAErE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AAEjC,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,aAAa,CAAA;IACvB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,YAAY,CAAC,EAAE,iBAAiB,CAAA;CAChC;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAA;KACjB,CAAA;CACD;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,SAAS,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,cAAc,CAAA;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC3B;AAED,2FAA2F;AAC3F,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C,MAAM,WAAW,gBAAgB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,MAAM,YAAY,GACrB,kBAAkB,GAClB,sBAAsB,GACtB,WAAW,GACX,UAAU,GACV,qBAAqB,GACrB,gBAAgB,CAAA;AAEnB,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,YAAY,CAAA;QAClB,KAAK,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACD"}

package/dist/contracts/index.d.ts

@@ -1,4 +1,5 @@
-export type { ISOTimestamp, AgentDefaults, AgentInfo, ToolCallInfo, CreateMessageRequest, WireRunStatus, RunStopReason, WireRun, RunHierarchyNode, ApiPermissionMode, RunConfig, RunUsage, CreateRunRequest, CreateStatelessRunRequest, StreamEventType, StreamEvent, PaginationParams, PaginatedResponse, ApiErrorType, ApiError, } from './api.js';
-export { ProjectIdSchema, RunIdSchema, MessageIdSchema, RunConfigSchema, CreateMessageSchema, CreateRunSchema, CreateStatelessRunSchema, PaginationSchema, zodErrorToApiError, } from './schemas.js';
+export type { ISOTimestamp, AgentDefaults, AgentInfo, ToolCallInfo, CreateMessageRequest, SessionTreeNode, ApiPermissionMode, PaginationParams, PaginatedResponse, ApiErrorType, ApiError, } from './api.js';
+export { ProjectIdSchema, MessageIdSchema, CreateMessageSchema, PaginationSchema, zodErrorToApiError, } from './schemas.js';
+export * from './session/index.js';
 export * from './a2a.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAQA,YAAY,EACX,YAAY,EACZ,aAAa,EACb,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,GACR,MAAM,UAAU,CAAA;AAEjB,OAAO,EACN,eAAe,EACf,WAAW,EACX,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,cAAc,CAAA;AAErB,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAYA,YAAY,EACX,YAAY,EACZ,aAAa,EACb,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,GACR,MAAM,UAAU,CAAA;AAEjB,OAAO,EACN,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,cAAc,CAAA;AAErB,cAAc,oBAAoB,CAAA;AAElC,cAAc,UAAU,CAAA"}

package/dist/contracts/index.js

@@ -4,7 +4,12 @@
 //   - contracts/* — snake_case wire fields, stable for HTTP and protocol clients.
 //   - types/*     — camelCase domain shapes, may include internal-only fields.
 // When a wire type is just a rename of a domain type, that's intentional (e.g.
-// `RunStopReason` aliases `types/run/events.StopReason`).
-export { ProjectIdSchema, RunIdSchema, MessageIdSchema, RunConfigSchema, CreateMessageSchema, CreateRunSchema, CreateStatelessRunSchema, PaginationSchema, zodErrorToApiError, } from './schemas.js';
+// `WireStopReason` is the domain stop reason under its wire name).
+//
+// The session and turn shapes (`WireTurn`, `WireTurnStatus`,
+// `CreateTurnRequest`, `CreateEphemeralSessionRequest`, `SessionStreamEvent`
+// and their schemas) are defined in `./session/` and re-exported here.
+export { ProjectIdSchema, MessageIdSchema, CreateMessageSchema, PaginationSchema, zodErrorToApiError, } from './schemas.js';
+export * from './session/index.js';
 export * from './a2a.js';
 //# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,sDAAsD;AACtD,kFAAkF;AAClF,+EAA+E;AAC/E,+EAA+E;AAC/E,0DAA0D;AAyB1D,OAAO,EACN,eAAe,EACf,WAAW,EACX,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,cAAc,CAAA;AAErB,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,sDAAsD;AACtD,kFAAkF;AAClF,+EAA+E;AAC/E,+EAA+E;AAC/E,mEAAmE;AACnE,EAAE;AACF,6DAA6D;AAC7D,6EAA6E;AAC7E,uEAAuE;AAgBvE,OAAO,EACN,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,cAAc,CAAA;AAErB,cAAc,oBAAoB,CAAA;AAElC,cAAc,UAAU,CAAA"}

package/dist/contracts/schemas.d.ts

@@ -1,39 +1,12 @@
 import { z } from 'zod';
-/** Shared with constructors and stores: opaque UUIDs. */
+/**
+ * Shared with constructors and stores: opaque UUIDs. The session and turn
+ * schemas (`SessionIdSchema`, `TurnIdSchema`, `TurnConfigSchema`,
+ * `CreateTurnSchema`, `CreateEphemeralSessionSchema`) live in
+ * `./session/schemas.ts`.
+ */
 export declare const ProjectIdSchema: z.ZodString;
-export declare const RunIdSchema: z.ZodString;
 export declare const MessageIdSchema: z.ZodString;
-export declare const RunConfigSchema: 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;
-    streamIdleTimeoutMs?: number | undefined;
-    maxRequestRichContentBytes?: number | undefined;
-    permissionMode?: "plan" | "auto" | undefined;
-    systemPrompt?: string | undefined;
-}, {
-    model?: string | undefined;
-    timeoutMs?: number | undefined;
-    temperature?: number | undefined;
-    tokenBudget?: number | undefined;
-    maxResponseTokens?: number | undefined;
-    streamIdleTimeoutMs?: number | undefined;
-    maxRequestRichContentBytes?: number | undefined;
-    permissionMode?: "plan" | "auto" | undefined;
-    systemPrompt?: string | undefined;
-}>;
 export declare const CreateMessageSchema: z.ZodObject<{
     role: z.ZodLiteral<"user">;
     content: z.ZodString;
@@ -47,138 +20,6 @@ export declare const CreateMessageSchema: z.ZodObject<{
     content: string;
     metadata?: Record<string, unknown> | undefined;
 }>;
-export declare const CreateRunSchema: z.ZodObject<{
-    agent_id: 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;
-        streamIdleTimeoutMs?: number | undefined;
-        maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
-        systemPrompt?: string | undefined;
-    }, {
-        model?: string | undefined;
-        timeoutMs?: number | undefined;
-        temperature?: number | undefined;
-        tokenBudget?: number | undefined;
-        maxResponseTokens?: number | undefined;
-        streamIdleTimeoutMs?: number | undefined;
-        maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
-        systemPrompt?: string | undefined;
-    }>;
-    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    stream: z.ZodOptional<z.ZodBoolean>;
-}, "strict", z.ZodTypeAny, {
-    config: {
-        model?: string | undefined;
-        timeoutMs?: number | undefined;
-        temperature?: number | undefined;
-        tokenBudget?: number | undefined;
-        maxResponseTokens?: number | undefined;
-        streamIdleTimeoutMs?: number | undefined;
-        maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
-        systemPrompt?: string | undefined;
-    };
-    agent_id: string;
-    env?: Record<string, string> | undefined;
-    stream?: boolean | undefined;
-}, {
-    config: {
-        model?: string | undefined;
-        timeoutMs?: number | undefined;
-        temperature?: number | undefined;
-        tokenBudget?: number | undefined;
-        maxResponseTokens?: number | undefined;
-        streamIdleTimeoutMs?: number | undefined;
-        maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
-        systemPrompt?: string | undefined;
-    };
-    agent_id: string;
-    env?: Record<string, string> | undefined;
-    stream?: boolean | undefined;
-}>;
-export declare const CreateStatelessRunSchema: 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;
-        streamIdleTimeoutMs?: number | undefined;
-        maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
-        systemPrompt?: string | undefined;
-    }, {
-        model?: string | undefined;
-        timeoutMs?: number | undefined;
-        temperature?: number | undefined;
-        tokenBudget?: number | undefined;
-        maxResponseTokens?: number | undefined;
-        streamIdleTimeoutMs?: number | undefined;
-        maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
-        systemPrompt?: string | 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;
-        streamIdleTimeoutMs?: number | undefined;
-        maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
-        systemPrompt?: string | 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;
-        streamIdleTimeoutMs?: number | undefined;
-        maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
-        systemPrompt?: string | undefined;
-    };
-    agent_id: string;
-    env?: Record<string, string> | undefined;
-}>;
 export declare const PaginationSchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodNumber>;
     after: z.ZodOptional<z.ZodString>;

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/contracts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,yDAAyD;AACzD,eAAO,MAAM,eAAe,aAAmE,CAAA;AAC/F,eAAO,MAAM,WAAW,aAA+D,CAAA;AACvF,eAAO,MAAM,eAAe,aAAmE,CAAA;AAE/F,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBlB,CAAA;AAEV,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAMtB,CAAA;AAEV,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOlB,CAAA;AAEV,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAA;AAEV,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAA;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,kBAAkB,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAUA"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/contracts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB;;;;;GAKG;AACH,eAAO,MAAM,eAAe,aAAmE,CAAA;AAC/F,eAAO,MAAM,eAAe,aAAmE,CAAA;AAE/F,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAMtB,CAAA;AAEV,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAA;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,kBAAkB,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAUA"}

package/dist/contracts/schemas.js

@@ -1,27 +1,13 @@
 import { z } from 'zod';
 import { entityIdPattern } from '../utils/id-format.js';
-/** Shared with constructors and stores: opaque UUIDs. */
+/**
+ * Shared with constructors and stores: opaque UUIDs. The session and turn
+ * schemas (`SessionIdSchema`, `TurnIdSchema`, `TurnConfigSchema`,
+ * `CreateTurnSchema`, `CreateEphemeralSessionSchema`) live in
+ * `./session/schemas.ts`.
+ */
 export const ProjectIdSchema = z.string().regex(entityIdPattern(), 'Invalid project ID format');
-export const RunIdSchema = z.string().regex(entityIdPattern(), 'Invalid run ID format');
 export const MessageIdSchema = z.string().regex(entityIdPattern(), 'Invalid message ID format');
-export const RunConfigSchema = 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();
 export const CreateMessageSchema = z
     .object({
     role: z.literal('user'),
@@ -29,22 +15,6 @@ export const CreateMessageSchema = z
     metadata: z.record(z.unknown()).optional(),
 })
     .strict();
-export const CreateRunSchema = z
-    .object({
-    agent_id: z.string().min(1, 'agent_id is required'),
-    config: RunConfigSchema,
-    env: z.record(z.string()).optional(),
-    stream: z.boolean().optional(),
-})
-    .strict();
-export const CreateStatelessRunSchema = z
-    .object({
-    agent_id: z.string().min(1, 'agent_id is required'),
-    message: z.string().min(1, 'message is required'),
-    config: RunConfigSchema,
-    env: z.record(z.string()).optional(),
-})
-    .strict();
 export const PaginationSchema = z.object({
     limit: z.coerce.number().int().min(1).max(100).default(20),
     after: z.string().optional(),

package/dist/contracts/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/contracts/schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/contracts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,2BAA2B,CAAC,CAAA;AAC/F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,2BAA2B,CAAC,CAAA;AAE/F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KAClC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,iCAAiC,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC;KACD,MAAM,EAAE,CAAA;AAEV,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CAC9C,CAAC,CAAA;AAEF,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAMnD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAClC,OAAO;QACN,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,UAAU;YAClB,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,OAAO,EAAE;YACvD,CAAC,CAAC,mBAAmB;QACtB,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS;KAC9C,CAAA;AACF,CAAC"}