@claudexor/schema 4.3.1 → 4.5.0

package/dist/mcp-run-wait.d.ts

@@ -0,0 +1,269 @@
+import { z } from "zod/v3";
+export declare const MCP_RUN_WAIT_EVENT_BYTES = 65536;
+export declare const MCP_RUN_WAIT_INTERACTION_BYTES = 32768;
+export declare const MCP_RUN_WAIT_RESULT_BYTES = 131072;
+export declare const McpRunWaitInput: z.ZodObject<{
+    runId: z.ZodString;
+    afterSeq: z.ZodDefault<z.ZodNumber>;
+    waitMs: z.ZodDefault<z.ZodNumber>;
+    maxEvents: z.ZodDefault<z.ZodNumber>;
+    wake: z.ZodDefault<z.ZodEnum<["batch", "event"]>>;
+}, "strict", z.ZodTypeAny, {
+    runId: string;
+    afterSeq: number;
+    waitMs: number;
+    maxEvents: number;
+    wake: "batch" | "event";
+}, {
+    runId: string;
+    afterSeq?: number | undefined;
+    waitMs?: number | undefined;
+    maxEvents?: number | undefined;
+    wake?: "batch" | "event" | undefined;
+}>;
+export type McpRunWaitInput = z.infer<typeof McpRunWaitInput>;
+export declare const McpRunWaitResult: z.ZodObject<{
+    runId: z.ZodString;
+    status: z.ZodEnum<["queued", "running", "succeeded", "failed", "cancelled", "interrupted"]>;
+    snapshotSeq: z.ZodNumber;
+    snapshotPhase: z.ZodEnum<["before_wait", "after_wait"]>;
+    snapshotProblem: z.ZodNullable<z.ZodEnum<["snapshot_unavailable"]>>;
+    nextSeq: z.ZodNumber;
+    events: z.ZodArray<z.ZodObject<{
+        seq: z.ZodNumber;
+        event: z.ZodObject<{
+            seq: z.ZodOptional<z.ZodNumber>;
+            ts: z.ZodString;
+            run_id: z.ZodString;
+            task_id: z.ZodString;
+            thread_id: z.ZodOptional<z.ZodString>;
+            type: z.ZodEnum<["run.created", "task.contract.created", "context.pack.created", "project.git.initialized", "project.claude_bridge.created", "budget.lease.created", "budget.observation", "budget.cash", "policy.web.upgraded", "harness.started", "harness.event", "harness.completed", "route.fallback.started", "route.fallback.completed", "route.fallback.exhausted", "route.transient.detected", "route.transient.retry_scheduled", "route.profile.headroom_exceeded", "route.profile.rotated", "route.profile.rotation_exhausted", "route.profile.credential_unusable", "route.account.pool_selected", "route.account.lane_switch", "route.account.pool_exhausted", "route.transient.exhausted", "route.fallback.auth_switched", "route.primary.diverged", "route.pool.degraded", "session.continuity", "interaction.requested", "interaction.answered", "interaction.timeout", "interaction.answer_discarded", "interaction.withdrawn", "message.accepted", "message.delivered", "message.refused", "plan.progress", "plan.questions", "plan.brief.materialized", "council.started", "council.draft", "council.member.failed", "council.merged", "budget.quota_pressure", "delegation.belt.unavailable", "delegation.belt.degraded", "output.ready", "gate.started", "gate.completed", "review.preflight", "review.started", "review.skipped", "reviewer.started", "reviewer.first_event", "reviewer.auth_switched", "reviewer.completed", "reviewer.timed_out", "reviewer.failed", "finding.revalidated", "synthesis.started", "arbitration.completed", "work_product.emitted", "work_product.adopted", "control.requested", "control.applied", "control.rejected", "run.blocked", "run.completed", "run.failed", "run.continuation", "run.continuation.denied", "run.continuity", "workspace.retained"]>;
+            payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            seq?: number | undefined;
+            ts: string;
+            run_id: string;
+            task_id: string;
+            thread_id?: string | undefined;
+            type: "arbitration.completed" | "budget.cash" | "budget.lease.created" | "budget.observation" | "budget.quota_pressure" | "context.pack.created" | "control.applied" | "control.rejected" | "control.requested" | "council.draft" | "council.member.failed" | "council.merged" | "council.started" | "delegation.belt.degraded" | "delegation.belt.unavailable" | "finding.revalidated" | "gate.completed" | "gate.started" | "harness.completed" | "harness.event" | "harness.started" | "interaction.answer_discarded" | "interaction.answered" | "interaction.requested" | "interaction.timeout" | "interaction.withdrawn" | "message.accepted" | "message.delivered" | "message.refused" | "output.ready" | "plan.brief.materialized" | "plan.progress" | "plan.questions" | "policy.web.upgraded" | "project.claude_bridge.created" | "project.git.initialized" | "review.preflight" | "review.skipped" | "review.started" | "reviewer.auth_switched" | "reviewer.completed" | "reviewer.failed" | "reviewer.first_event" | "reviewer.started" | "reviewer.timed_out" | "route.account.lane_switch" | "route.account.pool_exhausted" | "route.account.pool_selected" | "route.fallback.auth_switched" | "route.fallback.completed" | "route.fallback.exhausted" | "route.fallback.started" | "route.pool.degraded" | "route.primary.diverged" | "route.profile.credential_unusable" | "route.profile.headroom_exceeded" | "route.profile.rotated" | "route.profile.rotation_exhausted" | "route.transient.detected" | "route.transient.exhausted" | "route.transient.retry_scheduled" | "run.blocked" | "run.completed" | "run.continuation" | "run.continuation.denied" | "run.continuity" | "run.created" | "run.failed" | "session.continuity" | "synthesis.started" | "task.contract.created" | "work_product.adopted" | "work_product.emitted" | "workspace.retained";
+            payload: Record<string, unknown>;
+        }, {
+            seq?: number | undefined;
+            ts: string;
+            run_id: string;
+            task_id: string;
+            thread_id?: string | undefined;
+            type: "arbitration.completed" | "budget.cash" | "budget.lease.created" | "budget.observation" | "budget.quota_pressure" | "context.pack.created" | "control.applied" | "control.rejected" | "control.requested" | "council.draft" | "council.member.failed" | "council.merged" | "council.started" | "delegation.belt.degraded" | "delegation.belt.unavailable" | "finding.revalidated" | "gate.completed" | "gate.started" | "harness.completed" | "harness.event" | "harness.started" | "interaction.answer_discarded" | "interaction.answered" | "interaction.requested" | "interaction.timeout" | "interaction.withdrawn" | "message.accepted" | "message.delivered" | "message.refused" | "output.ready" | "plan.brief.materialized" | "plan.progress" | "plan.questions" | "policy.web.upgraded" | "project.claude_bridge.created" | "project.git.initialized" | "review.preflight" | "review.skipped" | "review.started" | "reviewer.auth_switched" | "reviewer.completed" | "reviewer.failed" | "reviewer.first_event" | "reviewer.started" | "reviewer.timed_out" | "route.account.lane_switch" | "route.account.pool_exhausted" | "route.account.pool_selected" | "route.fallback.auth_switched" | "route.fallback.completed" | "route.fallback.exhausted" | "route.fallback.started" | "route.pool.degraded" | "route.primary.diverged" | "route.profile.credential_unusable" | "route.profile.headroom_exceeded" | "route.profile.rotated" | "route.profile.rotation_exhausted" | "route.transient.detected" | "route.transient.exhausted" | "route.transient.retry_scheduled" | "run.blocked" | "run.completed" | "run.continuation" | "run.continuation.denied" | "run.continuity" | "run.created" | "run.failed" | "session.continuity" | "synthesis.started" | "task.contract.created" | "work_product.adopted" | "work_product.emitted" | "workspace.retained";
+            payload?: Record<string, unknown> | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        seq: number;
+        event: {
+            seq?: number | undefined;
+            ts: string;
+            run_id: string;
+            task_id: string;
+            thread_id?: string | undefined;
+            type: "arbitration.completed" | "budget.cash" | "budget.lease.created" | "budget.observation" | "budget.quota_pressure" | "context.pack.created" | "control.applied" | "control.rejected" | "control.requested" | "council.draft" | "council.member.failed" | "council.merged" | "council.started" | "delegation.belt.degraded" | "delegation.belt.unavailable" | "finding.revalidated" | "gate.completed" | "gate.started" | "harness.completed" | "harness.event" | "harness.started" | "interaction.answer_discarded" | "interaction.answered" | "interaction.requested" | "interaction.timeout" | "interaction.withdrawn" | "message.accepted" | "message.delivered" | "message.refused" | "output.ready" | "plan.brief.materialized" | "plan.progress" | "plan.questions" | "policy.web.upgraded" | "project.claude_bridge.created" | "project.git.initialized" | "review.preflight" | "review.skipped" | "review.started" | "reviewer.auth_switched" | "reviewer.completed" | "reviewer.failed" | "reviewer.first_event" | "reviewer.started" | "reviewer.timed_out" | "route.account.lane_switch" | "route.account.pool_exhausted" | "route.account.pool_selected" | "route.fallback.auth_switched" | "route.fallback.completed" | "route.fallback.exhausted" | "route.fallback.started" | "route.pool.degraded" | "route.primary.diverged" | "route.profile.credential_unusable" | "route.profile.headroom_exceeded" | "route.profile.rotated" | "route.profile.rotation_exhausted" | "route.transient.detected" | "route.transient.exhausted" | "route.transient.retry_scheduled" | "run.blocked" | "run.completed" | "run.continuation" | "run.continuation.denied" | "run.continuity" | "run.created" | "run.failed" | "session.continuity" | "synthesis.started" | "task.contract.created" | "work_product.adopted" | "work_product.emitted" | "workspace.retained";
+            payload: Record<string, unknown>;
+        };
+    }, {
+        seq: number;
+        event: {
+            seq?: number | undefined;
+            ts: string;
+            run_id: string;
+            task_id: string;
+            thread_id?: string | undefined;
+            type: "arbitration.completed" | "budget.cash" | "budget.lease.created" | "budget.observation" | "budget.quota_pressure" | "context.pack.created" | "control.applied" | "control.rejected" | "control.requested" | "council.draft" | "council.member.failed" | "council.merged" | "council.started" | "delegation.belt.degraded" | "delegation.belt.unavailable" | "finding.revalidated" | "gate.completed" | "gate.started" | "harness.completed" | "harness.event" | "harness.started" | "interaction.answer_discarded" | "interaction.answered" | "interaction.requested" | "interaction.timeout" | "interaction.withdrawn" | "message.accepted" | "message.delivered" | "message.refused" | "output.ready" | "plan.brief.materialized" | "plan.progress" | "plan.questions" | "policy.web.upgraded" | "project.claude_bridge.created" | "project.git.initialized" | "review.preflight" | "review.skipped" | "review.started" | "reviewer.auth_switched" | "reviewer.completed" | "reviewer.failed" | "reviewer.first_event" | "reviewer.started" | "reviewer.timed_out" | "route.account.lane_switch" | "route.account.pool_exhausted" | "route.account.pool_selected" | "route.fallback.auth_switched" | "route.fallback.completed" | "route.fallback.exhausted" | "route.fallback.started" | "route.pool.degraded" | "route.primary.diverged" | "route.profile.credential_unusable" | "route.profile.headroom_exceeded" | "route.profile.rotated" | "route.profile.rotation_exhausted" | "route.transient.detected" | "route.transient.exhausted" | "route.transient.retry_scheduled" | "run.blocked" | "run.completed" | "run.continuation" | "run.continuation.denied" | "run.continuity" | "run.created" | "run.failed" | "session.continuity" | "synthesis.started" | "task.contract.created" | "work_product.adopted" | "work_product.emitted" | "workspace.retained";
+            payload?: Record<string, unknown> | undefined;
+        };
+    }>, "many">;
+    eventOmission: z.ZodNullable<z.ZodEnum<["event_limit", "byte_limit", "oversized_frame", "invalid_event", "stream_ended"]>>;
+    oversizedEvent: z.ZodNullable<z.ZodObject<{
+        seq: z.ZodNumber;
+        type: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        seq: number;
+        type: string;
+    }, {
+        seq: number;
+        type: string;
+    }>>;
+    pendingInteractions: z.ZodArray<z.ZodObject<{
+        interactionId: z.ZodString;
+        runId: z.ZodString;
+        attemptId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        harnessId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        sourceTool: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        questions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            question: z.ZodString;
+            header: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                label: string;
+                description: string | null;
+            }, {
+                label: string;
+                description?: string | null | undefined;
+            }>, "many">>;
+            multi_select: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            question: string;
+            header: string | null;
+            options: {
+                label: string;
+                description: string | null;
+            }[];
+            multi_select: boolean;
+        }, {
+            id: string;
+            question: string;
+            header?: string | null | undefined;
+            options?: {
+                label: string;
+                description?: string | null | undefined;
+            }[] | undefined;
+            multi_select?: boolean | undefined;
+        }>, "many">>;
+        requestedAt: z.ZodString;
+        timeoutAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        interactionId: string;
+        runId: string;
+        attemptId: string | null;
+        harnessId: string | null;
+        sourceTool: string | null;
+        questions: {
+            id: string;
+            question: string;
+            header: string | null;
+            options: {
+                label: string;
+                description: string | null;
+            }[];
+            multi_select: boolean;
+        }[];
+        requestedAt: string;
+        timeoutAt: string | null;
+    }, {
+        interactionId: string;
+        runId: string;
+        attemptId?: string | null | undefined;
+        harnessId?: string | null | undefined;
+        sourceTool?: string | null | undefined;
+        questions?: {
+            id: string;
+            question: string;
+            header?: string | null | undefined;
+            options?: {
+                label: string;
+                description?: string | null | undefined;
+            }[] | undefined;
+            multi_select?: boolean | undefined;
+        }[] | undefined;
+        requestedAt: string;
+        timeoutAt?: string | null | undefined;
+    }>, "many">;
+    pendingInteractionCount: z.ZodNumber;
+    omittedInteractions: z.ZodNumber;
+    wakeReason: z.ZodEnum<["events", "interactions", "terminal", "timeout", "aborted", "disconnected"]>;
+}, "strict", z.ZodTypeAny, {
+    runId: string;
+    status: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+    snapshotSeq: number;
+    snapshotPhase: "after_wait" | "before_wait";
+    snapshotProblem: "snapshot_unavailable" | null;
+    nextSeq: number;
+    events: {
+        seq: number;
+        event: {
+            seq?: number | undefined;
+            ts: string;
+            run_id: string;
+            task_id: string;
+            thread_id?: string | undefined;
+            type: "arbitration.completed" | "budget.cash" | "budget.lease.created" | "budget.observation" | "budget.quota_pressure" | "context.pack.created" | "control.applied" | "control.rejected" | "control.requested" | "council.draft" | "council.member.failed" | "council.merged" | "council.started" | "delegation.belt.degraded" | "delegation.belt.unavailable" | "finding.revalidated" | "gate.completed" | "gate.started" | "harness.completed" | "harness.event" | "harness.started" | "interaction.answer_discarded" | "interaction.answered" | "interaction.requested" | "interaction.timeout" | "interaction.withdrawn" | "message.accepted" | "message.delivered" | "message.refused" | "output.ready" | "plan.brief.materialized" | "plan.progress" | "plan.questions" | "policy.web.upgraded" | "project.claude_bridge.created" | "project.git.initialized" | "review.preflight" | "review.skipped" | "review.started" | "reviewer.auth_switched" | "reviewer.completed" | "reviewer.failed" | "reviewer.first_event" | "reviewer.started" | "reviewer.timed_out" | "route.account.lane_switch" | "route.account.pool_exhausted" | "route.account.pool_selected" | "route.fallback.auth_switched" | "route.fallback.completed" | "route.fallback.exhausted" | "route.fallback.started" | "route.pool.degraded" | "route.primary.diverged" | "route.profile.credential_unusable" | "route.profile.headroom_exceeded" | "route.profile.rotated" | "route.profile.rotation_exhausted" | "route.transient.detected" | "route.transient.exhausted" | "route.transient.retry_scheduled" | "run.blocked" | "run.completed" | "run.continuation" | "run.continuation.denied" | "run.continuity" | "run.created" | "run.failed" | "session.continuity" | "synthesis.started" | "task.contract.created" | "work_product.adopted" | "work_product.emitted" | "workspace.retained";
+            payload: Record<string, unknown>;
+        };
+    }[];
+    eventOmission: "byte_limit" | "event_limit" | "invalid_event" | "oversized_frame" | "stream_ended" | null;
+    oversizedEvent: {
+        seq: number;
+        type: string;
+    } | null;
+    pendingInteractions: {
+        interactionId: string;
+        runId: string;
+        attemptId: string | null;
+        harnessId: string | null;
+        sourceTool: string | null;
+        questions: {
+            id: string;
+            question: string;
+            header: string | null;
+            options: {
+                label: string;
+                description: string | null;
+            }[];
+            multi_select: boolean;
+        }[];
+        requestedAt: string;
+        timeoutAt: string | null;
+    }[];
+    pendingInteractionCount: number;
+    omittedInteractions: number;
+    wakeReason: "aborted" | "disconnected" | "events" | "interactions" | "terminal" | "timeout";
+}, {
+    runId: string;
+    status: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+    snapshotSeq: number;
+    snapshotPhase: "after_wait" | "before_wait";
+    snapshotProblem: "snapshot_unavailable" | null;
+    nextSeq: number;
+    events: {
+        seq: number;
+        event: {
+            seq?: number | undefined;
+            ts: string;
+            run_id: string;
+            task_id: string;
+            thread_id?: string | undefined;
+            type: "arbitration.completed" | "budget.cash" | "budget.lease.created" | "budget.observation" | "budget.quota_pressure" | "context.pack.created" | "control.applied" | "control.rejected" | "control.requested" | "council.draft" | "council.member.failed" | "council.merged" | "council.started" | "delegation.belt.degraded" | "delegation.belt.unavailable" | "finding.revalidated" | "gate.completed" | "gate.started" | "harness.completed" | "harness.event" | "harness.started" | "interaction.answer_discarded" | "interaction.answered" | "interaction.requested" | "interaction.timeout" | "interaction.withdrawn" | "message.accepted" | "message.delivered" | "message.refused" | "output.ready" | "plan.brief.materialized" | "plan.progress" | "plan.questions" | "policy.web.upgraded" | "project.claude_bridge.created" | "project.git.initialized" | "review.preflight" | "review.skipped" | "review.started" | "reviewer.auth_switched" | "reviewer.completed" | "reviewer.failed" | "reviewer.first_event" | "reviewer.started" | "reviewer.timed_out" | "route.account.lane_switch" | "route.account.pool_exhausted" | "route.account.pool_selected" | "route.fallback.auth_switched" | "route.fallback.completed" | "route.fallback.exhausted" | "route.fallback.started" | "route.pool.degraded" | "route.primary.diverged" | "route.profile.credential_unusable" | "route.profile.headroom_exceeded" | "route.profile.rotated" | "route.profile.rotation_exhausted" | "route.transient.detected" | "route.transient.exhausted" | "route.transient.retry_scheduled" | "run.blocked" | "run.completed" | "run.continuation" | "run.continuation.denied" | "run.continuity" | "run.created" | "run.failed" | "session.continuity" | "synthesis.started" | "task.contract.created" | "work_product.adopted" | "work_product.emitted" | "workspace.retained";
+            payload?: Record<string, unknown> | undefined;
+        };
+    }[];
+    eventOmission: "byte_limit" | "event_limit" | "invalid_event" | "oversized_frame" | "stream_ended" | null;
+    oversizedEvent: {
+        seq: number;
+        type: string;
+    } | null;
+    pendingInteractions: {
+        interactionId: string;
+        runId: string;
+        attemptId?: string | null | undefined;
+        harnessId?: string | null | undefined;
+        sourceTool?: string | null | undefined;
+        questions?: {
+            id: string;
+            question: string;
+            header?: string | null | undefined;
+            options?: {
+                label: string;
+                description?: string | null | undefined;
+            }[] | undefined;
+            multi_select?: boolean | undefined;
+        }[] | undefined;
+        requestedAt: string;
+        timeoutAt?: string | null | undefined;
+    }[];
+    pendingInteractionCount: number;
+    omittedInteractions: number;
+    wakeReason: "aborted" | "disconnected" | "events" | "interactions" | "terminal" | "timeout";
+}>;
+export type McpRunWaitResult = z.infer<typeof McpRunWaitResult>;
+//# sourceMappingURL=mcp-run-wait.d.ts.map

package/dist/mcp-run-wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-run-wait.d.ts","sourceRoot":"","sources":["../src/mcp-run-wait.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,yBAAyB,SAAU,CAAC;AAIjD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EA8BjB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyD1B,CAAC;AACJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/mcp-run-wait.js

@@ -0,0 +1,73 @@
+import { z } from "zod/v3";
+import { ControlPendingInteraction, ControlRunState } from "./control.js";
+import { RunEvent } from "./events.js";
+export const MCP_RUN_WAIT_EVENT_BYTES = 65_536;
+export const MCP_RUN_WAIT_INTERACTION_BYTES = 32_768;
+export const MCP_RUN_WAIT_RESULT_BYTES = 131_072;
+const sequence = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
+export const McpRunWaitInput = z
+    .object({
+    runId: z
+        .string()
+        .trim()
+        .min(1)
+        .max(256)
+        .describe("Run id, or the job id of an accepted launch that may still be queued."),
+    afterSeq: sequence
+        .default(0)
+        .describe("Last durable event seq already consumed (the previous nextSeq), never snapshotSeq."),
+    waitMs: z
+        .number()
+        .int()
+        .min(0)
+        .max(50_000)
+        .default(25_000)
+        .describe("Bound of the event stage. Zero never waits for new events: it returns the bounded page already available at the snapshot fence, read within a separate 5s budget. Daemon discovery and each snapshot read have their own 5s budgets, so one call can take up to waitMs plus about 15s."),
+    maxEvents: z.number().int().min(1).max(200).default(50),
+    wake: z
+        .enum(["batch", "event"])
+        .default("batch")
+        .describe("batch (default): collect events until the page fills, it includes a question event (interaction.requested, also one written before the wait), the run ends, or waitMs elapses. event: return as soon as any event is available. A pending question whose event is not in the page is reported in both modes but never ends a wait by itself."),
+})
+    .strict();
+export const McpRunWaitResult = z
+    .object({
+    runId: z
+        .string()
+        .describe("Canonical run id; a queued job id converges to its run id once the run binds."),
+    status: ControlRunState,
+    snapshotSeq: sequence.describe("Last event seq at the latest snapshot: a fence, not a cursor. nextSeq below it means events are already written; eventOmission stream_ended reports when the stream cannot serve them."),
+    snapshotPhase: z.enum(["before_wait", "after_wait"]),
+    snapshotProblem: z
+        .enum(["snapshot_unavailable"])
+        .nullable()
+        .describe("A failed final read leaves the explicitly labelled initial snapshot, never invented current state."),
+    nextSeq: sequence.describe("Last returned event seq, or afterSeq when none was returned. It never advances over an unreturned event."),
+    events: z
+        .array(z.object({ seq: sequence, event: RunEvent }).strict())
+        .max(200)
+        .describe("Ordered new events, at most 65536 UTF-8 JSON bytes including envelopes. Legacy events retain their body and use the stream id as seq."),
+    eventOmission: z
+        .enum(["event_limit", "byte_limit", "oversized_frame", "invalid_event", "stream_ended"])
+        .nullable()
+        .describe("Why the page stopped early: event_limit or byte_limit (more events may follow; resume with nextSeq), oversized_frame (the next frame exceeds the 131072-byte stream frame cap), invalid_event (the next frame failed validation and is never skipped), stream_ended (the stream, which ends only for a terminal run, served nothing after nextSeq although snapshotSeq is higher, such as a last line left unterminated by a crash; nothing was skipped, and the same call returns the same page until the log changes, so stop there). Null means no limit was reached, not that replay is exhausted."),
+    oversizedEvent: z
+        .object({
+        seq: sequence.describe("Durable seq of the next unread event."),
+        type: z.string().describe("Event type the daemon stream names for it."),
+    })
+        .strict()
+        .nullable()
+        .describe("The next unread event after nextSeq cannot fit one page. Read its exact bytes in parts with claudexor_run_event_read, then resume with afterSeq set to its seq. Null otherwise."),
+    pendingInteractions: z
+        .array(ControlPendingInteraction)
+        .describe("Current snapshot's pending questions, bounded to 32768 UTF-8 JSON bytes; claudexor_run_interactions returns complete bodies. They never hold back events."),
+    pendingInteractionCount: sequence,
+    omittedInteractions: sequence,
+    wakeReason: z
+        .enum(["events", "interactions", "terminal", "timeout", "aborted", "disconnected"])
+        .describe("Why this observation returned, by precedence: aborted (this read was cancelled; the worker continues), terminal (the run is terminal; events may still follow nextSeq unless eventOmission is stream_ended), interactions (this page includes a question event), events (event mode, a completed zero-wait page, or a page, even an empty one, stopped by event_limit, byte_limit, oversized_frame or invalid_event), timeout (waitMs elapsed, possibly with a partial batch), disconnected (the stream ended early; never completion)."),
+})
+    .strict()
+    .describe("Read-only run observation, at most 131072 UTF-8 JSON bytes: at most two snapshot reads and one stream subscription, no automatic reconnect or worker cancellation. Events already available at the snapshot fence are returned before any wait, whether or not a question is pending. Resume with nextSeq.");
+//# sourceMappingURL=mcp-run-wait.js.map

package/dist/mcp-run-wait.js.map

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