@hachej/boring-agent 0.1.90 → 0.1.91

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/dist/{chunk-4PKGVPJA.js → chunk-2GBHYJVC.js} +27 -5
  2. package/dist/{chunk-5CYVBVP3.js → chunk-BHH5NH7P.js} +4766 -2153
  3. package/dist/{chunk-BEFJNMKQ.js → chunk-CJ2BW2W2.js} +23 -8
  4. package/dist/{chunk-F7ZS27HE.js → chunk-IWBC6SF7.js} +93 -19
  5. package/dist/chunk-NITBKFG6.js +1246 -0
  6. package/dist/{chunk-JEDRQAR5.js → chunk-PZC76CIA.js} +7 -1
  7. package/dist/core/index.d.ts +5 -5
  8. package/dist/core/index.js +2 -2
  9. package/dist/{createHarness-UCCGMVQJ.js → createHarness-PMYRKDE4.js} +2 -2
  10. package/dist/errors-BEmw9HMp.d.ts +200 -0
  11. package/dist/front/index.d.ts +20 -4
  12. package/dist/front/index.js +172 -44
  13. package/dist/{harness-Rbkdpvse.d.ts → harness-Bt_GMNYR.d.ts} +2 -2
  14. package/dist/{workspaceAgentDispatcher-50Uzuxhs.d.ts → lease-2aXepSBL.d.ts} +266 -57
  15. package/dist/{protocol-CDA4bcP9.d.ts → middleware-CzW8n7B7.d.ts} +20 -2
  16. package/dist/piChatEvent-DBO3M5lu.d.ts +367 -0
  17. package/dist/{piChatSessionService-DDKPOj4x.d.ts → piChatSessionService-BaaVWke7.d.ts} +5 -1
  18. package/dist/{sandbox-OEG_l9GE.d.ts → sandbox-DAD8cWQR.d.ts} +14 -1
  19. package/dist/server/agent-host/testing/gatewayConformance.d.ts +41 -0
  20. package/dist/server/agent-host/testing/gatewayConformance.js +465 -0
  21. package/dist/server/index.d.ts +451 -528
  22. package/dist/server/index.js +43 -9
  23. package/dist/server/worker/index.d.ts +2 -2
  24. package/dist/server/worker/index.js +7 -7
  25. package/dist/shared/index.d.ts +109 -41
  26. package/dist/shared/index.js +65 -282
  27. package/dist/types-jcMapYr9.d.ts +759 -0
  28. package/docs/ACCESSIBILITY.md +4 -5
  29. package/docs/API.md +3 -0
  30. package/docs/AUTHORING.md +68 -0
  31. package/docs/ERROR_CODES.md +27 -6
  32. package/docs/README.md +1 -0
  33. package/package.json +17 -8
  34. package/dist/chunk-CFQQXJKK.js +0 -385
  35. package/dist/chunk-DGRKMMXO.js +0 -8
  36. package/dist/piChatEvent-CHgln6yx.d.ts +0 -367
@@ -0,0 +1,367 @@
1
+ import { z } from 'zod';
2
+
3
+ interface SessionStore {
4
+ list(ctx: SessionCtx, options?: SessionListOptions): Promise<SessionSummary[]>;
5
+ create(ctx: SessionCtx, init?: {
6
+ title?: string;
7
+ }): Promise<SessionSummary>;
8
+ load(ctx: SessionCtx, sessionId: string): Promise<SessionDetail>;
9
+ delete(ctx: SessionCtx, sessionId: string): Promise<void>;
10
+ }
11
+ interface SessionCtx {
12
+ workspaceId?: string;
13
+ userId?: string;
14
+ }
15
+ interface SessionListOptions {
16
+ limit?: number;
17
+ offset?: number;
18
+ includeId?: string;
19
+ }
20
+ interface SessionSummary {
21
+ id: string;
22
+ title: string;
23
+ createdAt: string;
24
+ updatedAt: string;
25
+ turnCount: number;
26
+ }
27
+ type SessionDetail = SessionSummary;
28
+
29
+ interface ToolUiMetadata {
30
+ /** Renderer key registered by the app shell, e.g. `pi-subagent`. */
31
+ rendererId?: string;
32
+ /** Optional grouping label for future tool timelines/summaries. */
33
+ displayGroup?: string;
34
+ /** Optional icon hint. Frontends decide whether/how to honor it. */
35
+ icon?: string;
36
+ /** Renderer-specific structured data. */
37
+ details?: unknown;
38
+ }
39
+ declare function isToolUiMetadata(value: unknown): value is ToolUiMetadata;
40
+ /**
41
+ * Extract structured UI metadata from a ToolResult-like output.
42
+ *
43
+ * Shape:
44
+ * output.details.ui = { rendererId, displayGroup, icon, details }
45
+ */
46
+ declare function extractToolUiMetadata(output: unknown): ToolUiMetadata | undefined;
47
+
48
+ type BoringChatMessageRole = 'user' | 'assistant' | 'system';
49
+ type BoringChatMessageStatus = 'pending' | 'streaming' | 'done' | 'aborted' | 'error';
50
+ type BoringChatReasoningState = 'streaming' | 'done';
51
+ type BoringChatToolState = 'input-streaming' | 'input-available' | 'output-available' | 'output-error' | 'aborted';
52
+ type BoringChatPart = {
53
+ type: 'text';
54
+ id?: string;
55
+ text: string;
56
+ } | {
57
+ type: 'reasoning';
58
+ id: string;
59
+ text: string;
60
+ state?: BoringChatReasoningState;
61
+ } | {
62
+ type: 'tool-call';
63
+ id: string;
64
+ toolName: string;
65
+ input?: unknown;
66
+ state: BoringChatToolState;
67
+ output?: unknown;
68
+ errorText?: string;
69
+ ui?: ToolUiMetadata;
70
+ } | {
71
+ type: 'file';
72
+ id?: string;
73
+ filename?: string;
74
+ mediaType?: string;
75
+ url?: string;
76
+ path?: string;
77
+ filesystem?: string;
78
+ } | {
79
+ type: 'notice';
80
+ id?: string;
81
+ level: 'info' | 'warning' | 'error';
82
+ text: string;
83
+ };
84
+ interface BoringChatMessage {
85
+ id: string;
86
+ role: BoringChatMessageRole;
87
+ status?: BoringChatMessageStatus;
88
+ parts: BoringChatPart[];
89
+ createdAt?: string;
90
+ clientNonce?: string;
91
+ clientSeq?: number;
92
+ piEntryId?: string;
93
+ turnId?: string;
94
+ }
95
+
96
+ declare const ErrorCode: z.ZodEnum<["UNAUTHORIZED", "MISSING_API_KEY", "INVALID_API_KEY", "OIDC_REFRESH_FAILED", "VERCEL_AUTH_FAILED", "CONFIG_INVALID", "PATH_ESCAPE", "PATH_ABSOLUTE", "PATH_NULL_BYTE", "PATH_SYMLINK_ESCAPE", "PATH_NOT_FOUND", "PATH_NOT_WRITABLE", "WORKSPACE_UNINITIALIZED", "WORKSPACE_NOT_READY", "AGENT_HOST_SCOPE_VIOLATION", "AGENT_RUNTIME_NOT_READY", "AGENT_BINDING_DISPOSED", "AGENT_CONTROL_RECEIPT_INVALID", "AGENT_FLEET_PLUGIN_UNKNOWN", "AGENT_FLEET_CONFIG_BINDING_UNKNOWN", "AGENT_FLEET_MODEL_POLICY_UNCOMPILED", "RUNTIME_PROVISIONING_FAILED", "RUNTIME_PROVISIONING_LOCKED", "BWRAP_UNAVAILABLE", "BWRAP_TIMEOUT", "OUTPUT_TRUNCATED", "SANDBOX_NOT_READY", "SANDBOX_EXPIRED", "VERCEL_API_ERROR", "REMOTE_WORKER_CONFIG_INVALID", "REMOTE_WORKER_PROTOCOL_MISMATCH", "REMOTE_WORKER_UNAUTHENTICATED", "REMOTE_WORKER_UNAVAILABLE", "REMOTE_WORKER_UNQUALIFIED", "REMOTE_WORKER_REQUEST_INVALID", "REMOTE_WORKER_RESPONSE_INVALID", "REMOTE_WORKER_CAPABILITY_EXPIRED", "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED", "REMOTE_WORKER_BINDING_RECEIPT_INVALID", "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH", "REMOTE_WORKER_SANDBOX_NOT_FOUND", "REMOTE_WORKER_SANDBOX_EXPIRED", "REMOTE_WORKER_SANDBOX_DISPOSED", "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_IDEMPOTENCY_CONFLICT", "REMOTE_WORKER_EXEC_IN_PROGRESS", "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE", "REMOTE_WORKER_OUTCOME_UNKNOWN", "REMOTE_WORKER_INCOMPLETE_CLEANUP", "REMOTE_WORKER_DOCKER_COMMAND_FAILED", "REMOTE_WORKER_TIMEOUT", "REMOTE_WORKER_STREAM_CLOSED", "CIRCUIT_OPEN", "ABORTED", "PAYMENT_REQUIRED", "MODEL_BUDGET_EXCEEDED", "METERING_UNSUPPORTED_COMMAND", "SESSION_NOT_FOUND", "SESSION_LOCKED", "STREAM_BUFFER_EVICTED", "CURSOR_OUT_OF_RANGE", "BRIDGE_COMMAND_INVALID", "TOOL_NOT_FOUND", "TOOL_INVALID_INPUT", "TOOL_EXECUTION_ERROR", "AUTHORED_AGENT_ID_INVALID", "AUTHORED_AGENT_TYPE_MISMATCH", "AUTHORED_AGENT_REFERENCE_UNSUPPORTED", "AUTHORED_AGENT_TOOL_COLLISION", "MCP_AGENT_ARTIFACT_INVALID", "MCP_AGENT_ARTIFACT_TOO_LARGE", "MCP_AGENT_ARTIFACT_UNAVAILABLE", "PLUGIN_LOAD_FAILED", "PLUGIN_NAME_COLLISION", "PLUGIN_RUNTIME_REVISION_MISMATCH", "PLUGIN_RUNTIME_PRIVATE_FILE", "PLUGIN_RUNTIME_UNSAFE_IMPORT", "PLUGIN_RUNTIME_TRANSFORM_FAILED", "RUNTIME_PLUGIN_NOT_FOUND", "RUNTIME_PLUGIN_ROUTE_NOT_FOUND", "RUNTIME_PLUGIN_HANDLER_FAILED", "RUNTIME_PLUGIN_LOAD_FAILED", "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED", "PROVISIONING_LAYOUT_FAILED", "PROVISIONING_SKILLS_FAILED", "PROVISIONING_TEMPLATES_FAILED", "PROVISIONING_NODE_PREFLIGHT_FAILED", "PROVISIONING_NPM_INSTALL_FAILED", "PROVISIONING_UV_BOOTSTRAP_FAILED", "PROVISIONING_UV_INSTALL_FAILED", "PROVISIONING_ARTIFACT_FAILED", "AR1_SHARE_NOT_FOUND", "AR1_SHARE_TOMBSTONED", "ERR_NOT_IMPLEMENTED_UNTIL_T1", "INTERNAL_ERROR"]>;
97
+ type ErrorCode = z.infer<typeof ErrorCode>;
98
+ declare const ERROR_CODES: ["UNAUTHORIZED", "MISSING_API_KEY", "INVALID_API_KEY", "OIDC_REFRESH_FAILED", "VERCEL_AUTH_FAILED", "CONFIG_INVALID", "PATH_ESCAPE", "PATH_ABSOLUTE", "PATH_NULL_BYTE", "PATH_SYMLINK_ESCAPE", "PATH_NOT_FOUND", "PATH_NOT_WRITABLE", "WORKSPACE_UNINITIALIZED", "WORKSPACE_NOT_READY", "AGENT_HOST_SCOPE_VIOLATION", "AGENT_RUNTIME_NOT_READY", "AGENT_BINDING_DISPOSED", "AGENT_CONTROL_RECEIPT_INVALID", "AGENT_FLEET_PLUGIN_UNKNOWN", "AGENT_FLEET_CONFIG_BINDING_UNKNOWN", "AGENT_FLEET_MODEL_POLICY_UNCOMPILED", "RUNTIME_PROVISIONING_FAILED", "RUNTIME_PROVISIONING_LOCKED", "BWRAP_UNAVAILABLE", "BWRAP_TIMEOUT", "OUTPUT_TRUNCATED", "SANDBOX_NOT_READY", "SANDBOX_EXPIRED", "VERCEL_API_ERROR", "REMOTE_WORKER_CONFIG_INVALID", "REMOTE_WORKER_PROTOCOL_MISMATCH", "REMOTE_WORKER_UNAUTHENTICATED", "REMOTE_WORKER_UNAVAILABLE", "REMOTE_WORKER_UNQUALIFIED", "REMOTE_WORKER_REQUEST_INVALID", "REMOTE_WORKER_RESPONSE_INVALID", "REMOTE_WORKER_CAPABILITY_EXPIRED", "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED", "REMOTE_WORKER_BINDING_RECEIPT_INVALID", "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH", "REMOTE_WORKER_SANDBOX_NOT_FOUND", "REMOTE_WORKER_SANDBOX_EXPIRED", "REMOTE_WORKER_SANDBOX_DISPOSED", "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_IDEMPOTENCY_CONFLICT", "REMOTE_WORKER_EXEC_IN_PROGRESS", "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE", "REMOTE_WORKER_OUTCOME_UNKNOWN", "REMOTE_WORKER_INCOMPLETE_CLEANUP", "REMOTE_WORKER_DOCKER_COMMAND_FAILED", "REMOTE_WORKER_TIMEOUT", "REMOTE_WORKER_STREAM_CLOSED", "CIRCUIT_OPEN", "ABORTED", "PAYMENT_REQUIRED", "MODEL_BUDGET_EXCEEDED", "METERING_UNSUPPORTED_COMMAND", "SESSION_NOT_FOUND", "SESSION_LOCKED", "STREAM_BUFFER_EVICTED", "CURSOR_OUT_OF_RANGE", "BRIDGE_COMMAND_INVALID", "TOOL_NOT_FOUND", "TOOL_INVALID_INPUT", "TOOL_EXECUTION_ERROR", "AUTHORED_AGENT_ID_INVALID", "AUTHORED_AGENT_TYPE_MISMATCH", "AUTHORED_AGENT_REFERENCE_UNSUPPORTED", "AUTHORED_AGENT_TOOL_COLLISION", "MCP_AGENT_ARTIFACT_INVALID", "MCP_AGENT_ARTIFACT_TOO_LARGE", "MCP_AGENT_ARTIFACT_UNAVAILABLE", "PLUGIN_LOAD_FAILED", "PLUGIN_NAME_COLLISION", "PLUGIN_RUNTIME_REVISION_MISMATCH", "PLUGIN_RUNTIME_PRIVATE_FILE", "PLUGIN_RUNTIME_UNSAFE_IMPORT", "PLUGIN_RUNTIME_TRANSFORM_FAILED", "RUNTIME_PLUGIN_NOT_FOUND", "RUNTIME_PLUGIN_ROUTE_NOT_FOUND", "RUNTIME_PLUGIN_HANDLER_FAILED", "RUNTIME_PLUGIN_LOAD_FAILED", "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED", "PROVISIONING_LAYOUT_FAILED", "PROVISIONING_SKILLS_FAILED", "PROVISIONING_TEMPLATES_FAILED", "PROVISIONING_NODE_PREFLIGHT_FAILED", "PROVISIONING_NPM_INSTALL_FAILED", "PROVISIONING_UV_BOOTSTRAP_FAILED", "PROVISIONING_UV_INSTALL_FAILED", "PROVISIONING_ARTIFACT_FAILED", "AR1_SHARE_NOT_FOUND", "AR1_SHARE_TOMBSTONED", "ERR_NOT_IMPLEMENTED_UNTIL_T1", "INTERNAL_ERROR"];
99
+ declare const AgentDefinitionErrorCode: z.ZodEnum<["AGENT_DEFINITION_INVALID", "AGENT_DEFINITION_UNSUPPORTED_FIELD", "AUTHORED_AGENT_REFERENCE_UNSUPPORTED"]>;
100
+ type AgentDefinitionErrorCode = z.infer<typeof AgentDefinitionErrorCode>;
101
+ declare const AgentDeploymentErrorCode: z.ZodEnum<["AGENT_DEPLOYMENT_INVALID", "AGENT_DEPLOYMENT_UNSUPPORTED_FIELD"]>;
102
+ type AgentDeploymentErrorCode = z.infer<typeof AgentDeploymentErrorCode>;
103
+ /**
104
+ * Refusal codes for the agent-consumption contract (AC1, Decision 22,
105
+ * issue #636). Scoped like {@link AgentDeploymentErrorCode} — canonical,
106
+ * but intentionally outside the public {@link ErrorCode} / {@link
107
+ * ERROR_CODES} registry (and `docs/ERROR_CODES.md`) until a runtime
108
+ * dispatcher actually surfaces these over an API boundary.
109
+ */
110
+ declare const AgentConsumptionErrorCode: z.ZodEnum<["AGENT_CONSUMPTION_INVALID_TRANSITION", "AGENT_CONSUMPTION_CYCLE_DETECTED", "AGENT_CONSUMPTION_DEPTH_EXCEEDED", "AGENT_CONSUMPTION_SCHEMA_MISMATCH", "AGENT_CONSUMPTION_LEGACY_ARTIFACT_REJECTED"]>;
111
+ type AgentConsumptionErrorCode = z.infer<typeof AgentConsumptionErrorCode>;
112
+ declare const ApiErrorPayloadSchema: z.ZodObject<{
113
+ code: z.ZodEnum<["UNAUTHORIZED", "MISSING_API_KEY", "INVALID_API_KEY", "OIDC_REFRESH_FAILED", "VERCEL_AUTH_FAILED", "CONFIG_INVALID", "PATH_ESCAPE", "PATH_ABSOLUTE", "PATH_NULL_BYTE", "PATH_SYMLINK_ESCAPE", "PATH_NOT_FOUND", "PATH_NOT_WRITABLE", "WORKSPACE_UNINITIALIZED", "WORKSPACE_NOT_READY", "AGENT_HOST_SCOPE_VIOLATION", "AGENT_RUNTIME_NOT_READY", "AGENT_BINDING_DISPOSED", "AGENT_CONTROL_RECEIPT_INVALID", "AGENT_FLEET_PLUGIN_UNKNOWN", "AGENT_FLEET_CONFIG_BINDING_UNKNOWN", "AGENT_FLEET_MODEL_POLICY_UNCOMPILED", "RUNTIME_PROVISIONING_FAILED", "RUNTIME_PROVISIONING_LOCKED", "BWRAP_UNAVAILABLE", "BWRAP_TIMEOUT", "OUTPUT_TRUNCATED", "SANDBOX_NOT_READY", "SANDBOX_EXPIRED", "VERCEL_API_ERROR", "REMOTE_WORKER_CONFIG_INVALID", "REMOTE_WORKER_PROTOCOL_MISMATCH", "REMOTE_WORKER_UNAUTHENTICATED", "REMOTE_WORKER_UNAVAILABLE", "REMOTE_WORKER_UNQUALIFIED", "REMOTE_WORKER_REQUEST_INVALID", "REMOTE_WORKER_RESPONSE_INVALID", "REMOTE_WORKER_CAPABILITY_EXPIRED", "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED", "REMOTE_WORKER_BINDING_RECEIPT_INVALID", "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH", "REMOTE_WORKER_SANDBOX_NOT_FOUND", "REMOTE_WORKER_SANDBOX_EXPIRED", "REMOTE_WORKER_SANDBOX_DISPOSED", "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_IDEMPOTENCY_CONFLICT", "REMOTE_WORKER_EXEC_IN_PROGRESS", "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE", "REMOTE_WORKER_OUTCOME_UNKNOWN", "REMOTE_WORKER_INCOMPLETE_CLEANUP", "REMOTE_WORKER_DOCKER_COMMAND_FAILED", "REMOTE_WORKER_TIMEOUT", "REMOTE_WORKER_STREAM_CLOSED", "CIRCUIT_OPEN", "ABORTED", "PAYMENT_REQUIRED", "MODEL_BUDGET_EXCEEDED", "METERING_UNSUPPORTED_COMMAND", "SESSION_NOT_FOUND", "SESSION_LOCKED", "STREAM_BUFFER_EVICTED", "CURSOR_OUT_OF_RANGE", "BRIDGE_COMMAND_INVALID", "TOOL_NOT_FOUND", "TOOL_INVALID_INPUT", "TOOL_EXECUTION_ERROR", "AUTHORED_AGENT_ID_INVALID", "AUTHORED_AGENT_TYPE_MISMATCH", "AUTHORED_AGENT_REFERENCE_UNSUPPORTED", "AUTHORED_AGENT_TOOL_COLLISION", "MCP_AGENT_ARTIFACT_INVALID", "MCP_AGENT_ARTIFACT_TOO_LARGE", "MCP_AGENT_ARTIFACT_UNAVAILABLE", "PLUGIN_LOAD_FAILED", "PLUGIN_NAME_COLLISION", "PLUGIN_RUNTIME_REVISION_MISMATCH", "PLUGIN_RUNTIME_PRIVATE_FILE", "PLUGIN_RUNTIME_UNSAFE_IMPORT", "PLUGIN_RUNTIME_TRANSFORM_FAILED", "RUNTIME_PLUGIN_NOT_FOUND", "RUNTIME_PLUGIN_ROUTE_NOT_FOUND", "RUNTIME_PLUGIN_HANDLER_FAILED", "RUNTIME_PLUGIN_LOAD_FAILED", "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED", "PROVISIONING_LAYOUT_FAILED", "PROVISIONING_SKILLS_FAILED", "PROVISIONING_TEMPLATES_FAILED", "PROVISIONING_NODE_PREFLIGHT_FAILED", "PROVISIONING_NPM_INSTALL_FAILED", "PROVISIONING_UV_BOOTSTRAP_FAILED", "PROVISIONING_UV_INSTALL_FAILED", "PROVISIONING_ARTIFACT_FAILED", "AR1_SHARE_NOT_FOUND", "AR1_SHARE_TOMBSTONED", "ERR_NOT_IMPLEMENTED_UNTIL_T1", "INTERNAL_ERROR"]>;
114
+ message: z.ZodString;
115
+ details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
116
+ }, "strip", z.ZodTypeAny, {
117
+ code: "UNAUTHORIZED" | "MISSING_API_KEY" | "INVALID_API_KEY" | "OIDC_REFRESH_FAILED" | "VERCEL_AUTH_FAILED" | "CONFIG_INVALID" | "PATH_ESCAPE" | "PATH_ABSOLUTE" | "PATH_NULL_BYTE" | "PATH_SYMLINK_ESCAPE" | "PATH_NOT_FOUND" | "PATH_NOT_WRITABLE" | "WORKSPACE_UNINITIALIZED" | "WORKSPACE_NOT_READY" | "AGENT_HOST_SCOPE_VIOLATION" | "AGENT_RUNTIME_NOT_READY" | "AGENT_BINDING_DISPOSED" | "AGENT_CONTROL_RECEIPT_INVALID" | "AGENT_FLEET_PLUGIN_UNKNOWN" | "AGENT_FLEET_CONFIG_BINDING_UNKNOWN" | "AGENT_FLEET_MODEL_POLICY_UNCOMPILED" | "RUNTIME_PROVISIONING_FAILED" | "RUNTIME_PROVISIONING_LOCKED" | "BWRAP_UNAVAILABLE" | "BWRAP_TIMEOUT" | "OUTPUT_TRUNCATED" | "SANDBOX_NOT_READY" | "SANDBOX_EXPIRED" | "VERCEL_API_ERROR" | "REMOTE_WORKER_CONFIG_INVALID" | "REMOTE_WORKER_PROTOCOL_MISMATCH" | "REMOTE_WORKER_UNAUTHENTICATED" | "REMOTE_WORKER_UNAVAILABLE" | "REMOTE_WORKER_UNQUALIFIED" | "REMOTE_WORKER_REQUEST_INVALID" | "REMOTE_WORKER_RESPONSE_INVALID" | "REMOTE_WORKER_CAPABILITY_EXPIRED" | "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED" | "REMOTE_WORKER_BINDING_RECEIPT_INVALID" | "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH" | "REMOTE_WORKER_SANDBOX_NOT_FOUND" | "REMOTE_WORKER_SANDBOX_EXPIRED" | "REMOTE_WORKER_SANDBOX_DISPOSED" | "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_IDEMPOTENCY_CONFLICT" | "REMOTE_WORKER_EXEC_IN_PROGRESS" | "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE" | "REMOTE_WORKER_OUTCOME_UNKNOWN" | "REMOTE_WORKER_INCOMPLETE_CLEANUP" | "REMOTE_WORKER_DOCKER_COMMAND_FAILED" | "REMOTE_WORKER_TIMEOUT" | "REMOTE_WORKER_STREAM_CLOSED" | "CIRCUIT_OPEN" | "ABORTED" | "PAYMENT_REQUIRED" | "MODEL_BUDGET_EXCEEDED" | "METERING_UNSUPPORTED_COMMAND" | "SESSION_NOT_FOUND" | "SESSION_LOCKED" | "STREAM_BUFFER_EVICTED" | "CURSOR_OUT_OF_RANGE" | "BRIDGE_COMMAND_INVALID" | "TOOL_NOT_FOUND" | "TOOL_INVALID_INPUT" | "TOOL_EXECUTION_ERROR" | "AUTHORED_AGENT_ID_INVALID" | "AUTHORED_AGENT_TYPE_MISMATCH" | "AUTHORED_AGENT_REFERENCE_UNSUPPORTED" | "AUTHORED_AGENT_TOOL_COLLISION" | "MCP_AGENT_ARTIFACT_INVALID" | "MCP_AGENT_ARTIFACT_TOO_LARGE" | "MCP_AGENT_ARTIFACT_UNAVAILABLE" | "PLUGIN_LOAD_FAILED" | "PLUGIN_NAME_COLLISION" | "PLUGIN_RUNTIME_REVISION_MISMATCH" | "PLUGIN_RUNTIME_PRIVATE_FILE" | "PLUGIN_RUNTIME_UNSAFE_IMPORT" | "PLUGIN_RUNTIME_TRANSFORM_FAILED" | "RUNTIME_PLUGIN_NOT_FOUND" | "RUNTIME_PLUGIN_ROUTE_NOT_FOUND" | "RUNTIME_PLUGIN_HANDLER_FAILED" | "RUNTIME_PLUGIN_LOAD_FAILED" | "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED" | "PROVISIONING_LAYOUT_FAILED" | "PROVISIONING_SKILLS_FAILED" | "PROVISIONING_TEMPLATES_FAILED" | "PROVISIONING_NODE_PREFLIGHT_FAILED" | "PROVISIONING_NPM_INSTALL_FAILED" | "PROVISIONING_UV_BOOTSTRAP_FAILED" | "PROVISIONING_UV_INSTALL_FAILED" | "PROVISIONING_ARTIFACT_FAILED" | "AR1_SHARE_NOT_FOUND" | "AR1_SHARE_TOMBSTONED" | "ERR_NOT_IMPLEMENTED_UNTIL_T1" | "INTERNAL_ERROR";
118
+ message: string;
119
+ details?: Record<string, unknown> | undefined;
120
+ }, {
121
+ code: "UNAUTHORIZED" | "MISSING_API_KEY" | "INVALID_API_KEY" | "OIDC_REFRESH_FAILED" | "VERCEL_AUTH_FAILED" | "CONFIG_INVALID" | "PATH_ESCAPE" | "PATH_ABSOLUTE" | "PATH_NULL_BYTE" | "PATH_SYMLINK_ESCAPE" | "PATH_NOT_FOUND" | "PATH_NOT_WRITABLE" | "WORKSPACE_UNINITIALIZED" | "WORKSPACE_NOT_READY" | "AGENT_HOST_SCOPE_VIOLATION" | "AGENT_RUNTIME_NOT_READY" | "AGENT_BINDING_DISPOSED" | "AGENT_CONTROL_RECEIPT_INVALID" | "AGENT_FLEET_PLUGIN_UNKNOWN" | "AGENT_FLEET_CONFIG_BINDING_UNKNOWN" | "AGENT_FLEET_MODEL_POLICY_UNCOMPILED" | "RUNTIME_PROVISIONING_FAILED" | "RUNTIME_PROVISIONING_LOCKED" | "BWRAP_UNAVAILABLE" | "BWRAP_TIMEOUT" | "OUTPUT_TRUNCATED" | "SANDBOX_NOT_READY" | "SANDBOX_EXPIRED" | "VERCEL_API_ERROR" | "REMOTE_WORKER_CONFIG_INVALID" | "REMOTE_WORKER_PROTOCOL_MISMATCH" | "REMOTE_WORKER_UNAUTHENTICATED" | "REMOTE_WORKER_UNAVAILABLE" | "REMOTE_WORKER_UNQUALIFIED" | "REMOTE_WORKER_REQUEST_INVALID" | "REMOTE_WORKER_RESPONSE_INVALID" | "REMOTE_WORKER_CAPABILITY_EXPIRED" | "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED" | "REMOTE_WORKER_BINDING_RECEIPT_INVALID" | "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH" | "REMOTE_WORKER_SANDBOX_NOT_FOUND" | "REMOTE_WORKER_SANDBOX_EXPIRED" | "REMOTE_WORKER_SANDBOX_DISPOSED" | "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_IDEMPOTENCY_CONFLICT" | "REMOTE_WORKER_EXEC_IN_PROGRESS" | "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE" | "REMOTE_WORKER_OUTCOME_UNKNOWN" | "REMOTE_WORKER_INCOMPLETE_CLEANUP" | "REMOTE_WORKER_DOCKER_COMMAND_FAILED" | "REMOTE_WORKER_TIMEOUT" | "REMOTE_WORKER_STREAM_CLOSED" | "CIRCUIT_OPEN" | "ABORTED" | "PAYMENT_REQUIRED" | "MODEL_BUDGET_EXCEEDED" | "METERING_UNSUPPORTED_COMMAND" | "SESSION_NOT_FOUND" | "SESSION_LOCKED" | "STREAM_BUFFER_EVICTED" | "CURSOR_OUT_OF_RANGE" | "BRIDGE_COMMAND_INVALID" | "TOOL_NOT_FOUND" | "TOOL_INVALID_INPUT" | "TOOL_EXECUTION_ERROR" | "AUTHORED_AGENT_ID_INVALID" | "AUTHORED_AGENT_TYPE_MISMATCH" | "AUTHORED_AGENT_REFERENCE_UNSUPPORTED" | "AUTHORED_AGENT_TOOL_COLLISION" | "MCP_AGENT_ARTIFACT_INVALID" | "MCP_AGENT_ARTIFACT_TOO_LARGE" | "MCP_AGENT_ARTIFACT_UNAVAILABLE" | "PLUGIN_LOAD_FAILED" | "PLUGIN_NAME_COLLISION" | "PLUGIN_RUNTIME_REVISION_MISMATCH" | "PLUGIN_RUNTIME_PRIVATE_FILE" | "PLUGIN_RUNTIME_UNSAFE_IMPORT" | "PLUGIN_RUNTIME_TRANSFORM_FAILED" | "RUNTIME_PLUGIN_NOT_FOUND" | "RUNTIME_PLUGIN_ROUTE_NOT_FOUND" | "RUNTIME_PLUGIN_HANDLER_FAILED" | "RUNTIME_PLUGIN_LOAD_FAILED" | "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED" | "PROVISIONING_LAYOUT_FAILED" | "PROVISIONING_SKILLS_FAILED" | "PROVISIONING_TEMPLATES_FAILED" | "PROVISIONING_NODE_PREFLIGHT_FAILED" | "PROVISIONING_NPM_INSTALL_FAILED" | "PROVISIONING_UV_BOOTSTRAP_FAILED" | "PROVISIONING_UV_INSTALL_FAILED" | "PROVISIONING_ARTIFACT_FAILED" | "AR1_SHARE_NOT_FOUND" | "AR1_SHARE_TOMBSTONED" | "ERR_NOT_IMPLEMENTED_UNTIL_T1" | "INTERNAL_ERROR";
122
+ message: string;
123
+ details?: Record<string, unknown> | undefined;
124
+ }>;
125
+ type ApiErrorPayload = z.infer<typeof ApiErrorPayloadSchema>;
126
+ declare const ApiErrorResponseSchema: z.ZodObject<{
127
+ error: z.ZodObject<{
128
+ code: z.ZodEnum<["UNAUTHORIZED", "MISSING_API_KEY", "INVALID_API_KEY", "OIDC_REFRESH_FAILED", "VERCEL_AUTH_FAILED", "CONFIG_INVALID", "PATH_ESCAPE", "PATH_ABSOLUTE", "PATH_NULL_BYTE", "PATH_SYMLINK_ESCAPE", "PATH_NOT_FOUND", "PATH_NOT_WRITABLE", "WORKSPACE_UNINITIALIZED", "WORKSPACE_NOT_READY", "AGENT_HOST_SCOPE_VIOLATION", "AGENT_RUNTIME_NOT_READY", "AGENT_BINDING_DISPOSED", "AGENT_CONTROL_RECEIPT_INVALID", "AGENT_FLEET_PLUGIN_UNKNOWN", "AGENT_FLEET_CONFIG_BINDING_UNKNOWN", "AGENT_FLEET_MODEL_POLICY_UNCOMPILED", "RUNTIME_PROVISIONING_FAILED", "RUNTIME_PROVISIONING_LOCKED", "BWRAP_UNAVAILABLE", "BWRAP_TIMEOUT", "OUTPUT_TRUNCATED", "SANDBOX_NOT_READY", "SANDBOX_EXPIRED", "VERCEL_API_ERROR", "REMOTE_WORKER_CONFIG_INVALID", "REMOTE_WORKER_PROTOCOL_MISMATCH", "REMOTE_WORKER_UNAUTHENTICATED", "REMOTE_WORKER_UNAVAILABLE", "REMOTE_WORKER_UNQUALIFIED", "REMOTE_WORKER_REQUEST_INVALID", "REMOTE_WORKER_RESPONSE_INVALID", "REMOTE_WORKER_CAPABILITY_EXPIRED", "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED", "REMOTE_WORKER_BINDING_RECEIPT_INVALID", "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH", "REMOTE_WORKER_SANDBOX_NOT_FOUND", "REMOTE_WORKER_SANDBOX_EXPIRED", "REMOTE_WORKER_SANDBOX_DISPOSED", "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_IDEMPOTENCY_CONFLICT", "REMOTE_WORKER_EXEC_IN_PROGRESS", "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE", "REMOTE_WORKER_OUTCOME_UNKNOWN", "REMOTE_WORKER_INCOMPLETE_CLEANUP", "REMOTE_WORKER_DOCKER_COMMAND_FAILED", "REMOTE_WORKER_TIMEOUT", "REMOTE_WORKER_STREAM_CLOSED", "CIRCUIT_OPEN", "ABORTED", "PAYMENT_REQUIRED", "MODEL_BUDGET_EXCEEDED", "METERING_UNSUPPORTED_COMMAND", "SESSION_NOT_FOUND", "SESSION_LOCKED", "STREAM_BUFFER_EVICTED", "CURSOR_OUT_OF_RANGE", "BRIDGE_COMMAND_INVALID", "TOOL_NOT_FOUND", "TOOL_INVALID_INPUT", "TOOL_EXECUTION_ERROR", "AUTHORED_AGENT_ID_INVALID", "AUTHORED_AGENT_TYPE_MISMATCH", "AUTHORED_AGENT_REFERENCE_UNSUPPORTED", "AUTHORED_AGENT_TOOL_COLLISION", "MCP_AGENT_ARTIFACT_INVALID", "MCP_AGENT_ARTIFACT_TOO_LARGE", "MCP_AGENT_ARTIFACT_UNAVAILABLE", "PLUGIN_LOAD_FAILED", "PLUGIN_NAME_COLLISION", "PLUGIN_RUNTIME_REVISION_MISMATCH", "PLUGIN_RUNTIME_PRIVATE_FILE", "PLUGIN_RUNTIME_UNSAFE_IMPORT", "PLUGIN_RUNTIME_TRANSFORM_FAILED", "RUNTIME_PLUGIN_NOT_FOUND", "RUNTIME_PLUGIN_ROUTE_NOT_FOUND", "RUNTIME_PLUGIN_HANDLER_FAILED", "RUNTIME_PLUGIN_LOAD_FAILED", "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED", "PROVISIONING_LAYOUT_FAILED", "PROVISIONING_SKILLS_FAILED", "PROVISIONING_TEMPLATES_FAILED", "PROVISIONING_NODE_PREFLIGHT_FAILED", "PROVISIONING_NPM_INSTALL_FAILED", "PROVISIONING_UV_BOOTSTRAP_FAILED", "PROVISIONING_UV_INSTALL_FAILED", "PROVISIONING_ARTIFACT_FAILED", "AR1_SHARE_NOT_FOUND", "AR1_SHARE_TOMBSTONED", "ERR_NOT_IMPLEMENTED_UNTIL_T1", "INTERNAL_ERROR"]>;
129
+ message: z.ZodString;
130
+ details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
131
+ }, "strip", z.ZodTypeAny, {
132
+ code: "UNAUTHORIZED" | "MISSING_API_KEY" | "INVALID_API_KEY" | "OIDC_REFRESH_FAILED" | "VERCEL_AUTH_FAILED" | "CONFIG_INVALID" | "PATH_ESCAPE" | "PATH_ABSOLUTE" | "PATH_NULL_BYTE" | "PATH_SYMLINK_ESCAPE" | "PATH_NOT_FOUND" | "PATH_NOT_WRITABLE" | "WORKSPACE_UNINITIALIZED" | "WORKSPACE_NOT_READY" | "AGENT_HOST_SCOPE_VIOLATION" | "AGENT_RUNTIME_NOT_READY" | "AGENT_BINDING_DISPOSED" | "AGENT_CONTROL_RECEIPT_INVALID" | "AGENT_FLEET_PLUGIN_UNKNOWN" | "AGENT_FLEET_CONFIG_BINDING_UNKNOWN" | "AGENT_FLEET_MODEL_POLICY_UNCOMPILED" | "RUNTIME_PROVISIONING_FAILED" | "RUNTIME_PROVISIONING_LOCKED" | "BWRAP_UNAVAILABLE" | "BWRAP_TIMEOUT" | "OUTPUT_TRUNCATED" | "SANDBOX_NOT_READY" | "SANDBOX_EXPIRED" | "VERCEL_API_ERROR" | "REMOTE_WORKER_CONFIG_INVALID" | "REMOTE_WORKER_PROTOCOL_MISMATCH" | "REMOTE_WORKER_UNAUTHENTICATED" | "REMOTE_WORKER_UNAVAILABLE" | "REMOTE_WORKER_UNQUALIFIED" | "REMOTE_WORKER_REQUEST_INVALID" | "REMOTE_WORKER_RESPONSE_INVALID" | "REMOTE_WORKER_CAPABILITY_EXPIRED" | "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED" | "REMOTE_WORKER_BINDING_RECEIPT_INVALID" | "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH" | "REMOTE_WORKER_SANDBOX_NOT_FOUND" | "REMOTE_WORKER_SANDBOX_EXPIRED" | "REMOTE_WORKER_SANDBOX_DISPOSED" | "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_IDEMPOTENCY_CONFLICT" | "REMOTE_WORKER_EXEC_IN_PROGRESS" | "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE" | "REMOTE_WORKER_OUTCOME_UNKNOWN" | "REMOTE_WORKER_INCOMPLETE_CLEANUP" | "REMOTE_WORKER_DOCKER_COMMAND_FAILED" | "REMOTE_WORKER_TIMEOUT" | "REMOTE_WORKER_STREAM_CLOSED" | "CIRCUIT_OPEN" | "ABORTED" | "PAYMENT_REQUIRED" | "MODEL_BUDGET_EXCEEDED" | "METERING_UNSUPPORTED_COMMAND" | "SESSION_NOT_FOUND" | "SESSION_LOCKED" | "STREAM_BUFFER_EVICTED" | "CURSOR_OUT_OF_RANGE" | "BRIDGE_COMMAND_INVALID" | "TOOL_NOT_FOUND" | "TOOL_INVALID_INPUT" | "TOOL_EXECUTION_ERROR" | "AUTHORED_AGENT_ID_INVALID" | "AUTHORED_AGENT_TYPE_MISMATCH" | "AUTHORED_AGENT_REFERENCE_UNSUPPORTED" | "AUTHORED_AGENT_TOOL_COLLISION" | "MCP_AGENT_ARTIFACT_INVALID" | "MCP_AGENT_ARTIFACT_TOO_LARGE" | "MCP_AGENT_ARTIFACT_UNAVAILABLE" | "PLUGIN_LOAD_FAILED" | "PLUGIN_NAME_COLLISION" | "PLUGIN_RUNTIME_REVISION_MISMATCH" | "PLUGIN_RUNTIME_PRIVATE_FILE" | "PLUGIN_RUNTIME_UNSAFE_IMPORT" | "PLUGIN_RUNTIME_TRANSFORM_FAILED" | "RUNTIME_PLUGIN_NOT_FOUND" | "RUNTIME_PLUGIN_ROUTE_NOT_FOUND" | "RUNTIME_PLUGIN_HANDLER_FAILED" | "RUNTIME_PLUGIN_LOAD_FAILED" | "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED" | "PROVISIONING_LAYOUT_FAILED" | "PROVISIONING_SKILLS_FAILED" | "PROVISIONING_TEMPLATES_FAILED" | "PROVISIONING_NODE_PREFLIGHT_FAILED" | "PROVISIONING_NPM_INSTALL_FAILED" | "PROVISIONING_UV_BOOTSTRAP_FAILED" | "PROVISIONING_UV_INSTALL_FAILED" | "PROVISIONING_ARTIFACT_FAILED" | "AR1_SHARE_NOT_FOUND" | "AR1_SHARE_TOMBSTONED" | "ERR_NOT_IMPLEMENTED_UNTIL_T1" | "INTERNAL_ERROR";
133
+ message: string;
134
+ details?: Record<string, unknown> | undefined;
135
+ }, {
136
+ code: "UNAUTHORIZED" | "MISSING_API_KEY" | "INVALID_API_KEY" | "OIDC_REFRESH_FAILED" | "VERCEL_AUTH_FAILED" | "CONFIG_INVALID" | "PATH_ESCAPE" | "PATH_ABSOLUTE" | "PATH_NULL_BYTE" | "PATH_SYMLINK_ESCAPE" | "PATH_NOT_FOUND" | "PATH_NOT_WRITABLE" | "WORKSPACE_UNINITIALIZED" | "WORKSPACE_NOT_READY" | "AGENT_HOST_SCOPE_VIOLATION" | "AGENT_RUNTIME_NOT_READY" | "AGENT_BINDING_DISPOSED" | "AGENT_CONTROL_RECEIPT_INVALID" | "AGENT_FLEET_PLUGIN_UNKNOWN" | "AGENT_FLEET_CONFIG_BINDING_UNKNOWN" | "AGENT_FLEET_MODEL_POLICY_UNCOMPILED" | "RUNTIME_PROVISIONING_FAILED" | "RUNTIME_PROVISIONING_LOCKED" | "BWRAP_UNAVAILABLE" | "BWRAP_TIMEOUT" | "OUTPUT_TRUNCATED" | "SANDBOX_NOT_READY" | "SANDBOX_EXPIRED" | "VERCEL_API_ERROR" | "REMOTE_WORKER_CONFIG_INVALID" | "REMOTE_WORKER_PROTOCOL_MISMATCH" | "REMOTE_WORKER_UNAUTHENTICATED" | "REMOTE_WORKER_UNAVAILABLE" | "REMOTE_WORKER_UNQUALIFIED" | "REMOTE_WORKER_REQUEST_INVALID" | "REMOTE_WORKER_RESPONSE_INVALID" | "REMOTE_WORKER_CAPABILITY_EXPIRED" | "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED" | "REMOTE_WORKER_BINDING_RECEIPT_INVALID" | "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH" | "REMOTE_WORKER_SANDBOX_NOT_FOUND" | "REMOTE_WORKER_SANDBOX_EXPIRED" | "REMOTE_WORKER_SANDBOX_DISPOSED" | "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_IDEMPOTENCY_CONFLICT" | "REMOTE_WORKER_EXEC_IN_PROGRESS" | "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE" | "REMOTE_WORKER_OUTCOME_UNKNOWN" | "REMOTE_WORKER_INCOMPLETE_CLEANUP" | "REMOTE_WORKER_DOCKER_COMMAND_FAILED" | "REMOTE_WORKER_TIMEOUT" | "REMOTE_WORKER_STREAM_CLOSED" | "CIRCUIT_OPEN" | "ABORTED" | "PAYMENT_REQUIRED" | "MODEL_BUDGET_EXCEEDED" | "METERING_UNSUPPORTED_COMMAND" | "SESSION_NOT_FOUND" | "SESSION_LOCKED" | "STREAM_BUFFER_EVICTED" | "CURSOR_OUT_OF_RANGE" | "BRIDGE_COMMAND_INVALID" | "TOOL_NOT_FOUND" | "TOOL_INVALID_INPUT" | "TOOL_EXECUTION_ERROR" | "AUTHORED_AGENT_ID_INVALID" | "AUTHORED_AGENT_TYPE_MISMATCH" | "AUTHORED_AGENT_REFERENCE_UNSUPPORTED" | "AUTHORED_AGENT_TOOL_COLLISION" | "MCP_AGENT_ARTIFACT_INVALID" | "MCP_AGENT_ARTIFACT_TOO_LARGE" | "MCP_AGENT_ARTIFACT_UNAVAILABLE" | "PLUGIN_LOAD_FAILED" | "PLUGIN_NAME_COLLISION" | "PLUGIN_RUNTIME_REVISION_MISMATCH" | "PLUGIN_RUNTIME_PRIVATE_FILE" | "PLUGIN_RUNTIME_UNSAFE_IMPORT" | "PLUGIN_RUNTIME_TRANSFORM_FAILED" | "RUNTIME_PLUGIN_NOT_FOUND" | "RUNTIME_PLUGIN_ROUTE_NOT_FOUND" | "RUNTIME_PLUGIN_HANDLER_FAILED" | "RUNTIME_PLUGIN_LOAD_FAILED" | "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED" | "PROVISIONING_LAYOUT_FAILED" | "PROVISIONING_SKILLS_FAILED" | "PROVISIONING_TEMPLATES_FAILED" | "PROVISIONING_NODE_PREFLIGHT_FAILED" | "PROVISIONING_NPM_INSTALL_FAILED" | "PROVISIONING_UV_BOOTSTRAP_FAILED" | "PROVISIONING_UV_INSTALL_FAILED" | "PROVISIONING_ARTIFACT_FAILED" | "AR1_SHARE_NOT_FOUND" | "AR1_SHARE_TOMBSTONED" | "ERR_NOT_IMPLEMENTED_UNTIL_T1" | "INTERNAL_ERROR";
137
+ message: string;
138
+ details?: Record<string, unknown> | undefined;
139
+ }>;
140
+ }, "strip", z.ZodTypeAny, {
141
+ error: {
142
+ code: "UNAUTHORIZED" | "MISSING_API_KEY" | "INVALID_API_KEY" | "OIDC_REFRESH_FAILED" | "VERCEL_AUTH_FAILED" | "CONFIG_INVALID" | "PATH_ESCAPE" | "PATH_ABSOLUTE" | "PATH_NULL_BYTE" | "PATH_SYMLINK_ESCAPE" | "PATH_NOT_FOUND" | "PATH_NOT_WRITABLE" | "WORKSPACE_UNINITIALIZED" | "WORKSPACE_NOT_READY" | "AGENT_HOST_SCOPE_VIOLATION" | "AGENT_RUNTIME_NOT_READY" | "AGENT_BINDING_DISPOSED" | "AGENT_CONTROL_RECEIPT_INVALID" | "AGENT_FLEET_PLUGIN_UNKNOWN" | "AGENT_FLEET_CONFIG_BINDING_UNKNOWN" | "AGENT_FLEET_MODEL_POLICY_UNCOMPILED" | "RUNTIME_PROVISIONING_FAILED" | "RUNTIME_PROVISIONING_LOCKED" | "BWRAP_UNAVAILABLE" | "BWRAP_TIMEOUT" | "OUTPUT_TRUNCATED" | "SANDBOX_NOT_READY" | "SANDBOX_EXPIRED" | "VERCEL_API_ERROR" | "REMOTE_WORKER_CONFIG_INVALID" | "REMOTE_WORKER_PROTOCOL_MISMATCH" | "REMOTE_WORKER_UNAUTHENTICATED" | "REMOTE_WORKER_UNAVAILABLE" | "REMOTE_WORKER_UNQUALIFIED" | "REMOTE_WORKER_REQUEST_INVALID" | "REMOTE_WORKER_RESPONSE_INVALID" | "REMOTE_WORKER_CAPABILITY_EXPIRED" | "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED" | "REMOTE_WORKER_BINDING_RECEIPT_INVALID" | "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH" | "REMOTE_WORKER_SANDBOX_NOT_FOUND" | "REMOTE_WORKER_SANDBOX_EXPIRED" | "REMOTE_WORKER_SANDBOX_DISPOSED" | "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_IDEMPOTENCY_CONFLICT" | "REMOTE_WORKER_EXEC_IN_PROGRESS" | "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE" | "REMOTE_WORKER_OUTCOME_UNKNOWN" | "REMOTE_WORKER_INCOMPLETE_CLEANUP" | "REMOTE_WORKER_DOCKER_COMMAND_FAILED" | "REMOTE_WORKER_TIMEOUT" | "REMOTE_WORKER_STREAM_CLOSED" | "CIRCUIT_OPEN" | "ABORTED" | "PAYMENT_REQUIRED" | "MODEL_BUDGET_EXCEEDED" | "METERING_UNSUPPORTED_COMMAND" | "SESSION_NOT_FOUND" | "SESSION_LOCKED" | "STREAM_BUFFER_EVICTED" | "CURSOR_OUT_OF_RANGE" | "BRIDGE_COMMAND_INVALID" | "TOOL_NOT_FOUND" | "TOOL_INVALID_INPUT" | "TOOL_EXECUTION_ERROR" | "AUTHORED_AGENT_ID_INVALID" | "AUTHORED_AGENT_TYPE_MISMATCH" | "AUTHORED_AGENT_REFERENCE_UNSUPPORTED" | "AUTHORED_AGENT_TOOL_COLLISION" | "MCP_AGENT_ARTIFACT_INVALID" | "MCP_AGENT_ARTIFACT_TOO_LARGE" | "MCP_AGENT_ARTIFACT_UNAVAILABLE" | "PLUGIN_LOAD_FAILED" | "PLUGIN_NAME_COLLISION" | "PLUGIN_RUNTIME_REVISION_MISMATCH" | "PLUGIN_RUNTIME_PRIVATE_FILE" | "PLUGIN_RUNTIME_UNSAFE_IMPORT" | "PLUGIN_RUNTIME_TRANSFORM_FAILED" | "RUNTIME_PLUGIN_NOT_FOUND" | "RUNTIME_PLUGIN_ROUTE_NOT_FOUND" | "RUNTIME_PLUGIN_HANDLER_FAILED" | "RUNTIME_PLUGIN_LOAD_FAILED" | "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED" | "PROVISIONING_LAYOUT_FAILED" | "PROVISIONING_SKILLS_FAILED" | "PROVISIONING_TEMPLATES_FAILED" | "PROVISIONING_NODE_PREFLIGHT_FAILED" | "PROVISIONING_NPM_INSTALL_FAILED" | "PROVISIONING_UV_BOOTSTRAP_FAILED" | "PROVISIONING_UV_INSTALL_FAILED" | "PROVISIONING_ARTIFACT_FAILED" | "AR1_SHARE_NOT_FOUND" | "AR1_SHARE_TOMBSTONED" | "ERR_NOT_IMPLEMENTED_UNTIL_T1" | "INTERNAL_ERROR";
143
+ message: string;
144
+ details?: Record<string, unknown> | undefined;
145
+ };
146
+ }, {
147
+ error: {
148
+ code: "UNAUTHORIZED" | "MISSING_API_KEY" | "INVALID_API_KEY" | "OIDC_REFRESH_FAILED" | "VERCEL_AUTH_FAILED" | "CONFIG_INVALID" | "PATH_ESCAPE" | "PATH_ABSOLUTE" | "PATH_NULL_BYTE" | "PATH_SYMLINK_ESCAPE" | "PATH_NOT_FOUND" | "PATH_NOT_WRITABLE" | "WORKSPACE_UNINITIALIZED" | "WORKSPACE_NOT_READY" | "AGENT_HOST_SCOPE_VIOLATION" | "AGENT_RUNTIME_NOT_READY" | "AGENT_BINDING_DISPOSED" | "AGENT_CONTROL_RECEIPT_INVALID" | "AGENT_FLEET_PLUGIN_UNKNOWN" | "AGENT_FLEET_CONFIG_BINDING_UNKNOWN" | "AGENT_FLEET_MODEL_POLICY_UNCOMPILED" | "RUNTIME_PROVISIONING_FAILED" | "RUNTIME_PROVISIONING_LOCKED" | "BWRAP_UNAVAILABLE" | "BWRAP_TIMEOUT" | "OUTPUT_TRUNCATED" | "SANDBOX_NOT_READY" | "SANDBOX_EXPIRED" | "VERCEL_API_ERROR" | "REMOTE_WORKER_CONFIG_INVALID" | "REMOTE_WORKER_PROTOCOL_MISMATCH" | "REMOTE_WORKER_UNAUTHENTICATED" | "REMOTE_WORKER_UNAVAILABLE" | "REMOTE_WORKER_UNQUALIFIED" | "REMOTE_WORKER_REQUEST_INVALID" | "REMOTE_WORKER_RESPONSE_INVALID" | "REMOTE_WORKER_CAPABILITY_EXPIRED" | "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED" | "REMOTE_WORKER_BINDING_RECEIPT_INVALID" | "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH" | "REMOTE_WORKER_SANDBOX_NOT_FOUND" | "REMOTE_WORKER_SANDBOX_EXPIRED" | "REMOTE_WORKER_SANDBOX_DISPOSED" | "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED" | "REMOTE_WORKER_IDEMPOTENCY_CONFLICT" | "REMOTE_WORKER_EXEC_IN_PROGRESS" | "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE" | "REMOTE_WORKER_OUTCOME_UNKNOWN" | "REMOTE_WORKER_INCOMPLETE_CLEANUP" | "REMOTE_WORKER_DOCKER_COMMAND_FAILED" | "REMOTE_WORKER_TIMEOUT" | "REMOTE_WORKER_STREAM_CLOSED" | "CIRCUIT_OPEN" | "ABORTED" | "PAYMENT_REQUIRED" | "MODEL_BUDGET_EXCEEDED" | "METERING_UNSUPPORTED_COMMAND" | "SESSION_NOT_FOUND" | "SESSION_LOCKED" | "STREAM_BUFFER_EVICTED" | "CURSOR_OUT_OF_RANGE" | "BRIDGE_COMMAND_INVALID" | "TOOL_NOT_FOUND" | "TOOL_INVALID_INPUT" | "TOOL_EXECUTION_ERROR" | "AUTHORED_AGENT_ID_INVALID" | "AUTHORED_AGENT_TYPE_MISMATCH" | "AUTHORED_AGENT_REFERENCE_UNSUPPORTED" | "AUTHORED_AGENT_TOOL_COLLISION" | "MCP_AGENT_ARTIFACT_INVALID" | "MCP_AGENT_ARTIFACT_TOO_LARGE" | "MCP_AGENT_ARTIFACT_UNAVAILABLE" | "PLUGIN_LOAD_FAILED" | "PLUGIN_NAME_COLLISION" | "PLUGIN_RUNTIME_REVISION_MISMATCH" | "PLUGIN_RUNTIME_PRIVATE_FILE" | "PLUGIN_RUNTIME_UNSAFE_IMPORT" | "PLUGIN_RUNTIME_TRANSFORM_FAILED" | "RUNTIME_PLUGIN_NOT_FOUND" | "RUNTIME_PLUGIN_ROUTE_NOT_FOUND" | "RUNTIME_PLUGIN_HANDLER_FAILED" | "RUNTIME_PLUGIN_LOAD_FAILED" | "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED" | "PROVISIONING_LAYOUT_FAILED" | "PROVISIONING_SKILLS_FAILED" | "PROVISIONING_TEMPLATES_FAILED" | "PROVISIONING_NODE_PREFLIGHT_FAILED" | "PROVISIONING_NPM_INSTALL_FAILED" | "PROVISIONING_UV_BOOTSTRAP_FAILED" | "PROVISIONING_UV_INSTALL_FAILED" | "PROVISIONING_ARTIFACT_FAILED" | "AR1_SHARE_NOT_FOUND" | "AR1_SHARE_TOMBSTONED" | "ERR_NOT_IMPLEMENTED_UNTIL_T1" | "INTERNAL_ERROR";
149
+ message: string;
150
+ details?: Record<string, unknown> | undefined;
151
+ };
152
+ }>;
153
+ type ApiErrorResponse = z.infer<typeof ApiErrorResponseSchema>;
154
+ declare const ErrorLogFieldsSchema: z.ZodObject<{
155
+ level: z.ZodEnum<["warn", "error"]>;
156
+ code: z.ZodEnum<["UNAUTHORIZED", "MISSING_API_KEY", "INVALID_API_KEY", "OIDC_REFRESH_FAILED", "VERCEL_AUTH_FAILED", "CONFIG_INVALID", "PATH_ESCAPE", "PATH_ABSOLUTE", "PATH_NULL_BYTE", "PATH_SYMLINK_ESCAPE", "PATH_NOT_FOUND", "PATH_NOT_WRITABLE", "WORKSPACE_UNINITIALIZED", "WORKSPACE_NOT_READY", "AGENT_HOST_SCOPE_VIOLATION", "AGENT_RUNTIME_NOT_READY", "AGENT_BINDING_DISPOSED", "AGENT_CONTROL_RECEIPT_INVALID", "AGENT_FLEET_PLUGIN_UNKNOWN", "AGENT_FLEET_CONFIG_BINDING_UNKNOWN", "AGENT_FLEET_MODEL_POLICY_UNCOMPILED", "RUNTIME_PROVISIONING_FAILED", "RUNTIME_PROVISIONING_LOCKED", "BWRAP_UNAVAILABLE", "BWRAP_TIMEOUT", "OUTPUT_TRUNCATED", "SANDBOX_NOT_READY", "SANDBOX_EXPIRED", "VERCEL_API_ERROR", "REMOTE_WORKER_CONFIG_INVALID", "REMOTE_WORKER_PROTOCOL_MISMATCH", "REMOTE_WORKER_UNAUTHENTICATED", "REMOTE_WORKER_UNAVAILABLE", "REMOTE_WORKER_UNQUALIFIED", "REMOTE_WORKER_REQUEST_INVALID", "REMOTE_WORKER_RESPONSE_INVALID", "REMOTE_WORKER_CAPABILITY_EXPIRED", "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED", "REMOTE_WORKER_BINDING_RECEIPT_INVALID", "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH", "REMOTE_WORKER_SANDBOX_NOT_FOUND", "REMOTE_WORKER_SANDBOX_EXPIRED", "REMOTE_WORKER_SANDBOX_DISPOSED", "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_IDEMPOTENCY_CONFLICT", "REMOTE_WORKER_EXEC_IN_PROGRESS", "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE", "REMOTE_WORKER_OUTCOME_UNKNOWN", "REMOTE_WORKER_INCOMPLETE_CLEANUP", "REMOTE_WORKER_DOCKER_COMMAND_FAILED", "REMOTE_WORKER_TIMEOUT", "REMOTE_WORKER_STREAM_CLOSED", "CIRCUIT_OPEN", "ABORTED", "PAYMENT_REQUIRED", "MODEL_BUDGET_EXCEEDED", "METERING_UNSUPPORTED_COMMAND", "SESSION_NOT_FOUND", "SESSION_LOCKED", "STREAM_BUFFER_EVICTED", "CURSOR_OUT_OF_RANGE", "BRIDGE_COMMAND_INVALID", "TOOL_NOT_FOUND", "TOOL_INVALID_INPUT", "TOOL_EXECUTION_ERROR", "AUTHORED_AGENT_ID_INVALID", "AUTHORED_AGENT_TYPE_MISMATCH", "AUTHORED_AGENT_REFERENCE_UNSUPPORTED", "AUTHORED_AGENT_TOOL_COLLISION", "MCP_AGENT_ARTIFACT_INVALID", "MCP_AGENT_ARTIFACT_TOO_LARGE", "MCP_AGENT_ARTIFACT_UNAVAILABLE", "PLUGIN_LOAD_FAILED", "PLUGIN_NAME_COLLISION", "PLUGIN_RUNTIME_REVISION_MISMATCH", "PLUGIN_RUNTIME_PRIVATE_FILE", "PLUGIN_RUNTIME_UNSAFE_IMPORT", "PLUGIN_RUNTIME_TRANSFORM_FAILED", "RUNTIME_PLUGIN_NOT_FOUND", "RUNTIME_PLUGIN_ROUTE_NOT_FOUND", "RUNTIME_PLUGIN_HANDLER_FAILED", "RUNTIME_PLUGIN_LOAD_FAILED", "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED", "PROVISIONING_LAYOUT_FAILED", "PROVISIONING_SKILLS_FAILED", "PROVISIONING_TEMPLATES_FAILED", "PROVISIONING_NODE_PREFLIGHT_FAILED", "PROVISIONING_NPM_INSTALL_FAILED", "PROVISIONING_UV_BOOTSTRAP_FAILED", "PROVISIONING_UV_INSTALL_FAILED", "PROVISIONING_ARTIFACT_FAILED", "AR1_SHARE_NOT_FOUND", "AR1_SHARE_TOMBSTONED", "ERR_NOT_IMPLEMENTED_UNTIL_T1", "INTERNAL_ERROR"]>;
157
+ prefix: z.ZodString;
158
+ msg: z.ZodString;
159
+ }, "strip", z.ZodUnknown, z.objectOutputType<{
160
+ level: z.ZodEnum<["warn", "error"]>;
161
+ code: z.ZodEnum<["UNAUTHORIZED", "MISSING_API_KEY", "INVALID_API_KEY", "OIDC_REFRESH_FAILED", "VERCEL_AUTH_FAILED", "CONFIG_INVALID", "PATH_ESCAPE", "PATH_ABSOLUTE", "PATH_NULL_BYTE", "PATH_SYMLINK_ESCAPE", "PATH_NOT_FOUND", "PATH_NOT_WRITABLE", "WORKSPACE_UNINITIALIZED", "WORKSPACE_NOT_READY", "AGENT_HOST_SCOPE_VIOLATION", "AGENT_RUNTIME_NOT_READY", "AGENT_BINDING_DISPOSED", "AGENT_CONTROL_RECEIPT_INVALID", "AGENT_FLEET_PLUGIN_UNKNOWN", "AGENT_FLEET_CONFIG_BINDING_UNKNOWN", "AGENT_FLEET_MODEL_POLICY_UNCOMPILED", "RUNTIME_PROVISIONING_FAILED", "RUNTIME_PROVISIONING_LOCKED", "BWRAP_UNAVAILABLE", "BWRAP_TIMEOUT", "OUTPUT_TRUNCATED", "SANDBOX_NOT_READY", "SANDBOX_EXPIRED", "VERCEL_API_ERROR", "REMOTE_WORKER_CONFIG_INVALID", "REMOTE_WORKER_PROTOCOL_MISMATCH", "REMOTE_WORKER_UNAUTHENTICATED", "REMOTE_WORKER_UNAVAILABLE", "REMOTE_WORKER_UNQUALIFIED", "REMOTE_WORKER_REQUEST_INVALID", "REMOTE_WORKER_RESPONSE_INVALID", "REMOTE_WORKER_CAPABILITY_EXPIRED", "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED", "REMOTE_WORKER_BINDING_RECEIPT_INVALID", "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH", "REMOTE_WORKER_SANDBOX_NOT_FOUND", "REMOTE_WORKER_SANDBOX_EXPIRED", "REMOTE_WORKER_SANDBOX_DISPOSED", "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_IDEMPOTENCY_CONFLICT", "REMOTE_WORKER_EXEC_IN_PROGRESS", "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE", "REMOTE_WORKER_OUTCOME_UNKNOWN", "REMOTE_WORKER_INCOMPLETE_CLEANUP", "REMOTE_WORKER_DOCKER_COMMAND_FAILED", "REMOTE_WORKER_TIMEOUT", "REMOTE_WORKER_STREAM_CLOSED", "CIRCUIT_OPEN", "ABORTED", "PAYMENT_REQUIRED", "MODEL_BUDGET_EXCEEDED", "METERING_UNSUPPORTED_COMMAND", "SESSION_NOT_FOUND", "SESSION_LOCKED", "STREAM_BUFFER_EVICTED", "CURSOR_OUT_OF_RANGE", "BRIDGE_COMMAND_INVALID", "TOOL_NOT_FOUND", "TOOL_INVALID_INPUT", "TOOL_EXECUTION_ERROR", "AUTHORED_AGENT_ID_INVALID", "AUTHORED_AGENT_TYPE_MISMATCH", "AUTHORED_AGENT_REFERENCE_UNSUPPORTED", "AUTHORED_AGENT_TOOL_COLLISION", "MCP_AGENT_ARTIFACT_INVALID", "MCP_AGENT_ARTIFACT_TOO_LARGE", "MCP_AGENT_ARTIFACT_UNAVAILABLE", "PLUGIN_LOAD_FAILED", "PLUGIN_NAME_COLLISION", "PLUGIN_RUNTIME_REVISION_MISMATCH", "PLUGIN_RUNTIME_PRIVATE_FILE", "PLUGIN_RUNTIME_UNSAFE_IMPORT", "PLUGIN_RUNTIME_TRANSFORM_FAILED", "RUNTIME_PLUGIN_NOT_FOUND", "RUNTIME_PLUGIN_ROUTE_NOT_FOUND", "RUNTIME_PLUGIN_HANDLER_FAILED", "RUNTIME_PLUGIN_LOAD_FAILED", "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED", "PROVISIONING_LAYOUT_FAILED", "PROVISIONING_SKILLS_FAILED", "PROVISIONING_TEMPLATES_FAILED", "PROVISIONING_NODE_PREFLIGHT_FAILED", "PROVISIONING_NPM_INSTALL_FAILED", "PROVISIONING_UV_BOOTSTRAP_FAILED", "PROVISIONING_UV_INSTALL_FAILED", "PROVISIONING_ARTIFACT_FAILED", "AR1_SHARE_NOT_FOUND", "AR1_SHARE_TOMBSTONED", "ERR_NOT_IMPLEMENTED_UNTIL_T1", "INTERNAL_ERROR"]>;
162
+ prefix: z.ZodString;
163
+ msg: z.ZodString;
164
+ }, z.ZodUnknown, "strip">, z.objectInputType<{
165
+ level: z.ZodEnum<["warn", "error"]>;
166
+ code: z.ZodEnum<["UNAUTHORIZED", "MISSING_API_KEY", "INVALID_API_KEY", "OIDC_REFRESH_FAILED", "VERCEL_AUTH_FAILED", "CONFIG_INVALID", "PATH_ESCAPE", "PATH_ABSOLUTE", "PATH_NULL_BYTE", "PATH_SYMLINK_ESCAPE", "PATH_NOT_FOUND", "PATH_NOT_WRITABLE", "WORKSPACE_UNINITIALIZED", "WORKSPACE_NOT_READY", "AGENT_HOST_SCOPE_VIOLATION", "AGENT_RUNTIME_NOT_READY", "AGENT_BINDING_DISPOSED", "AGENT_CONTROL_RECEIPT_INVALID", "AGENT_FLEET_PLUGIN_UNKNOWN", "AGENT_FLEET_CONFIG_BINDING_UNKNOWN", "AGENT_FLEET_MODEL_POLICY_UNCOMPILED", "RUNTIME_PROVISIONING_FAILED", "RUNTIME_PROVISIONING_LOCKED", "BWRAP_UNAVAILABLE", "BWRAP_TIMEOUT", "OUTPUT_TRUNCATED", "SANDBOX_NOT_READY", "SANDBOX_EXPIRED", "VERCEL_API_ERROR", "REMOTE_WORKER_CONFIG_INVALID", "REMOTE_WORKER_PROTOCOL_MISMATCH", "REMOTE_WORKER_UNAUTHENTICATED", "REMOTE_WORKER_UNAVAILABLE", "REMOTE_WORKER_UNQUALIFIED", "REMOTE_WORKER_REQUEST_INVALID", "REMOTE_WORKER_RESPONSE_INVALID", "REMOTE_WORKER_CAPABILITY_EXPIRED", "REMOTE_WORKER_AUTHORIZED_WORKSPACE_REQUIRED", "REMOTE_WORKER_BINDING_RECEIPT_INVALID", "REMOTE_WORKER_SANDBOX_WORKSPACE_MISMATCH", "REMOTE_WORKER_SANDBOX_NOT_FOUND", "REMOTE_WORKER_SANDBOX_EXPIRED", "REMOTE_WORKER_SANDBOX_DISPOSED", "REMOTE_WORKER_CREATE_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_EXEC_CONCURRENCY_EXHAUSTED", "REMOTE_WORKER_IDEMPOTENCY_CONFLICT", "REMOTE_WORKER_EXEC_IN_PROGRESS", "REMOTE_WORKER_SECRET_INVOCATION_NOT_REPLAYABLE", "REMOTE_WORKER_OUTCOME_UNKNOWN", "REMOTE_WORKER_INCOMPLETE_CLEANUP", "REMOTE_WORKER_DOCKER_COMMAND_FAILED", "REMOTE_WORKER_TIMEOUT", "REMOTE_WORKER_STREAM_CLOSED", "CIRCUIT_OPEN", "ABORTED", "PAYMENT_REQUIRED", "MODEL_BUDGET_EXCEEDED", "METERING_UNSUPPORTED_COMMAND", "SESSION_NOT_FOUND", "SESSION_LOCKED", "STREAM_BUFFER_EVICTED", "CURSOR_OUT_OF_RANGE", "BRIDGE_COMMAND_INVALID", "TOOL_NOT_FOUND", "TOOL_INVALID_INPUT", "TOOL_EXECUTION_ERROR", "AUTHORED_AGENT_ID_INVALID", "AUTHORED_AGENT_TYPE_MISMATCH", "AUTHORED_AGENT_REFERENCE_UNSUPPORTED", "AUTHORED_AGENT_TOOL_COLLISION", "MCP_AGENT_ARTIFACT_INVALID", "MCP_AGENT_ARTIFACT_TOO_LARGE", "MCP_AGENT_ARTIFACT_UNAVAILABLE", "PLUGIN_LOAD_FAILED", "PLUGIN_NAME_COLLISION", "PLUGIN_RUNTIME_REVISION_MISMATCH", "PLUGIN_RUNTIME_PRIVATE_FILE", "PLUGIN_RUNTIME_UNSAFE_IMPORT", "PLUGIN_RUNTIME_TRANSFORM_FAILED", "RUNTIME_PLUGIN_NOT_FOUND", "RUNTIME_PLUGIN_ROUTE_NOT_FOUND", "RUNTIME_PLUGIN_HANDLER_FAILED", "RUNTIME_PLUGIN_LOAD_FAILED", "RUNTIME_PLUGIN_RESPONSE_UNSUPPORTED", "PROVISIONING_LAYOUT_FAILED", "PROVISIONING_SKILLS_FAILED", "PROVISIONING_TEMPLATES_FAILED", "PROVISIONING_NODE_PREFLIGHT_FAILED", "PROVISIONING_NPM_INSTALL_FAILED", "PROVISIONING_UV_BOOTSTRAP_FAILED", "PROVISIONING_UV_INSTALL_FAILED", "PROVISIONING_ARTIFACT_FAILED", "AR1_SHARE_NOT_FOUND", "AR1_SHARE_TOMBSTONED", "ERR_NOT_IMPLEMENTED_UNTIL_T1", "INTERNAL_ERROR"]>;
167
+ prefix: z.ZodString;
168
+ msg: z.ZodString;
169
+ }, z.ZodUnknown, "strip">>;
170
+ type ErrorLogFields = z.infer<typeof ErrorLogFieldsSchema>;
171
+
172
+ interface ChatError {
173
+ code: ErrorCode;
174
+ message: string;
175
+ retryable?: boolean;
176
+ details?: unknown;
177
+ }
178
+
179
+ type ThinkingLevel = 'off' | 'low' | 'medium' | 'high';
180
+ interface ChatModelSelection {
181
+ provider: string;
182
+ id: string;
183
+ }
184
+ interface ChatAttachmentPayload {
185
+ filename?: string;
186
+ mediaType?: string;
187
+ url: string;
188
+ /** Workspace-relative path when the browser upload endpoint persisted the attachment. */
189
+ path?: string;
190
+ }
191
+ interface ChatSubmitPayload {
192
+ message: string;
193
+ displayMessage?: string;
194
+ clientNonce: string;
195
+ model?: ChatModelSelection;
196
+ thinkingLevel?: ThinkingLevel;
197
+ attachments?: ChatAttachmentPayload[];
198
+ }
199
+
200
+ type PiChatStatus = 'idle' | 'hydrating' | 'submitted' | 'streaming' | 'aborting' | 'error';
201
+ interface QueuedUserMessage {
202
+ id: string;
203
+ kind: 'followup';
204
+ clientNonce?: string;
205
+ clientSeq?: number;
206
+ displayText: string;
207
+ createdAt?: string;
208
+ }
209
+ interface PiChatSnapshot {
210
+ protocolVersion: 1;
211
+ sessionId: string;
212
+ seq: number;
213
+ status: PiChatStatus;
214
+ activeTurnId?: string;
215
+ messages: BoringChatMessage[];
216
+ queue: {
217
+ followUps: QueuedUserMessage[];
218
+ };
219
+ followUpMode: 'one-at-a-time';
220
+ error?: ChatError;
221
+ }
222
+
223
+ type PromptPayload = ChatSubmitPayload;
224
+ interface FollowUpPayload {
225
+ message: string;
226
+ displayMessage?: string;
227
+ clientNonce: string;
228
+ clientSeq: number;
229
+ }
230
+ interface QueueClearPayload {
231
+ clientNonce?: string;
232
+ clientSeq?: number;
233
+ }
234
+ type InterruptPayload = Record<string, never>;
235
+ type StopPayload = Record<string, never>;
236
+ interface CommandReceipt {
237
+ readonly accepted: true;
238
+ readonly cursor: number;
239
+ }
240
+ type PromptReceipt = CommandReceipt & {
241
+ readonly clientNonce: string;
242
+ readonly duplicate?: boolean;
243
+ };
244
+ type FollowUpReceipt = CommandReceipt & {
245
+ readonly clientNonce: string;
246
+ readonly clientSeq: number;
247
+ readonly queued: true;
248
+ readonly duplicate?: boolean;
249
+ };
250
+ type QueueClearReceipt = CommandReceipt & {
251
+ readonly cleared: number;
252
+ };
253
+ type InterruptReceipt = CommandReceipt;
254
+ type StopReceipt = CommandReceipt & {
255
+ readonly stopped: boolean;
256
+ readonly clearedQueue: readonly QueuedUserMessage[];
257
+ };
258
+
259
+ type PiChatEvent = {
260
+ type: 'agent-start';
261
+ seq: number;
262
+ turnId: string;
263
+ } | {
264
+ type: 'agent-end';
265
+ seq: number;
266
+ turnId: string;
267
+ status: 'ok' | 'aborted' | 'error';
268
+ willRetry?: boolean;
269
+ } | {
270
+ type: 'message-start';
271
+ seq: number;
272
+ messageId: string;
273
+ role: 'user' | 'assistant';
274
+ clientNonce?: string;
275
+ clientSeq?: number;
276
+ createdAt?: string;
277
+ text?: string;
278
+ files?: BoringChatPart[];
279
+ } | {
280
+ type: 'message-delta';
281
+ seq: number;
282
+ messageId: string;
283
+ partId: string;
284
+ kind: 'text' | 'reasoning';
285
+ delta: string;
286
+ } | {
287
+ type: 'message-part-end';
288
+ seq: number;
289
+ messageId: string;
290
+ partId: string;
291
+ kind: 'text' | 'reasoning';
292
+ text: string;
293
+ } | {
294
+ type: 'message-end';
295
+ seq: number;
296
+ messageId: string;
297
+ final: BoringChatMessage;
298
+ } | {
299
+ type: 'tool-call';
300
+ seq: number;
301
+ messageId: string;
302
+ toolCallId: string;
303
+ toolName: string;
304
+ input: unknown;
305
+ ui?: ToolUiMetadata;
306
+ } | {
307
+ type: 'tool-result';
308
+ seq: number;
309
+ messageId: string;
310
+ toolCallId: string;
311
+ output: unknown;
312
+ isError?: boolean;
313
+ errorText?: string;
314
+ ui?: ToolUiMetadata;
315
+ } | {
316
+ type: 'queue-updated';
317
+ seq: number;
318
+ queue: {
319
+ followUps: QueuedUserMessage[];
320
+ };
321
+ } | {
322
+ type: 'followup-consumed';
323
+ seq: number;
324
+ clientNonce?: string;
325
+ clientSeq?: number;
326
+ messageId: string;
327
+ } | {
328
+ type: 'file-changed';
329
+ seq: number;
330
+ path: string;
331
+ changeType: string;
332
+ } | {
333
+ type: 'ui-command';
334
+ seq: number;
335
+ command: unknown;
336
+ displayOnly: true;
337
+ } | {
338
+ type: 'usage';
339
+ seq: number;
340
+ usage: unknown;
341
+ } | {
342
+ type: 'auto-retry-start';
343
+ seq: number;
344
+ attempt: number;
345
+ maxAttempts: number;
346
+ delayMs: number;
347
+ errorMessage: string;
348
+ } | {
349
+ type: 'auto-retry-end';
350
+ seq: number;
351
+ success: boolean;
352
+ attempt: number;
353
+ finalError?: string;
354
+ } | {
355
+ type: 'error';
356
+ seq: number;
357
+ turnId?: string;
358
+ retryable?: boolean;
359
+ error: ChatError;
360
+ };
361
+ interface PiChatHeartbeatFrame {
362
+ type: 'heartbeat';
363
+ now: string;
364
+ }
365
+ type PiChatStreamFrame = PiChatEvent | PiChatHeartbeatFrame;
366
+
367
+ export { AgentConsumptionErrorCode as A, type BoringChatPart as B, type ChatError as C, type InterruptReceipt as D, ErrorCode as E, type FollowUpPayload as F, type PiChatHeartbeatFrame as G, type PiChatStreamFrame as H, type InterruptPayload as I, type SessionDetail as J, type ThinkingLevel as K, extractToolUiMetadata as L, isToolUiMetadata as M, type PiChatStatus as P, type QueuedUserMessage as Q, type SessionStore as S, type ToolUiMetadata as T, type BoringChatMessage as a, type PiChatEvent as b, type PromptPayload as c, type PromptReceipt as d, type FollowUpReceipt as e, type QueueClearPayload as f, type QueueClearReceipt as g, type CommandReceipt as h, type StopPayload as i, type StopReceipt as j, type SessionSummary as k, type SessionCtx as l, type SessionListOptions as m, type PiChatSnapshot as n, type ChatModelSelection as o, AgentDefinitionErrorCode as p, AgentDeploymentErrorCode as q, type ApiErrorPayload as r, ApiErrorPayloadSchema as s, type ApiErrorResponse as t, ApiErrorResponseSchema as u, type ChatAttachmentPayload as v, type ChatSubmitPayload as w, ERROR_CODES as x, type ErrorLogFields as y, ErrorLogFieldsSchema as z };
@@ -1,4 +1,4 @@
1
- import { n as SessionListOptions, k as SessionSummary, m as ChatModelSelection, o as PiChatSnapshot, b as PiChatEvent, c as PromptPayload, d as PromptReceipt, F as FollowUpPayload, e as FollowUpReceipt, f as QueueClearPayload, g as QueueClearReceipt, I as InterruptPayload, h as CommandReceipt, i as StopPayload, j as StopReceipt } from './piChatEvent-CHgln6yx.js';
1
+ import { m as SessionListOptions, k as SessionSummary, o as ChatModelSelection, n as PiChatSnapshot, b as PiChatEvent, c as PromptPayload, d as PromptReceipt, F as FollowUpPayload, e as FollowUpReceipt, f as QueueClearPayload, g as QueueClearReceipt, I as InterruptPayload, h as CommandReceipt, i as StopPayload, j as StopReceipt } from './piChatEvent-DBO3M5lu.js';
2
2
 
3
3
  interface PiSessionRequestContext {
4
4
  workspaceId?: string;
@@ -6,6 +6,10 @@ interface PiSessionRequestContext {
6
6
  authSubject?: string;
7
7
  authEmail?: string;
8
8
  authEmailVerified?: boolean;
9
+ /** Addressed Gateway binds sessions to the verified workspace/storage scope. */
10
+ sessionAuthority?: 'workspace-scope';
11
+ /** Server-only Host pin persisted by the session store during creation. */
12
+ runtimeScopeIdentity?: string;
9
13
  requestId: string;
10
14
  }
11
15
  interface PiSessionCreateInit {
@@ -53,6 +53,19 @@ interface Workspace {
53
53
  * spawning N OS-level watchers per HTTP connection is not allowed.
54
54
  */
55
55
  watch?(): WorkspaceWatcher;
56
+ /**
57
+ * Optional control-event channel for out-of-band changes.
58
+ *
59
+ * The primary `watch()` subscription is for fine-grained file
60
+ * events. This is a secondary channel for coarse-grained external
61
+ * events that should trigger a client-side resync — e.g. a bash
62
+ * tool that mutates many files, or a git pull that swaps many refs.
63
+ *
64
+ * Implementations that can't observe changes (and don't
65
+ * want to fake it via polling) omit this method or leave it
66
+ * undefined.
67
+ */
68
+ notifyExternalChange?(event: WorkspaceWatchControlEvent): void;
56
69
  /**
57
70
  * Capability hint for hosts that want to render a UI affordance
58
71
  * ("connected"/"polling"/"manual refresh"). Optional — absence
@@ -285,4 +298,4 @@ interface IsolatedCodeOutput {
285
298
  exitCode: number;
286
299
  }
287
300
 
288
- export type { ExecOptions as E, IsolatedCodeInput as I, Sandbox as S, Workspace as W, WorkspaceRuntimeContext as a, ExecResult as b, WorkspaceChangeEvent as c, Stat as d, Entry as e, IsolatedCodeOutput as f, SandboxCapability as g };
301
+ export type { ExecOptions as E, IsolatedCodeInput as I, Sandbox as S, WorkspaceChangeEvent as W, ExecResult as a, Workspace as b, WorkspaceRuntimeContext as c, Stat as d, Entry as e, IsolatedCodeOutput as f, SandboxCapability as g, WorkspaceWatchControlEvent as h };
@@ -0,0 +1,41 @@
1
+ import { A as AgentGateway, a as AuthorizedAgentScope, b as AgentSessionRef, c as AgentSessionActivity } from '../../../errors-BEmw9HMp.js';
2
+ import { A as AgentGatewayEffect } from '../../../types-jcMapYr9.js';
3
+ import '../../../piChatEvent-DBO3M5lu.js';
4
+ import 'zod';
5
+ import 'fastify';
6
+ import '../../../harness-Bt_GMNYR.js';
7
+ import '@mariozechner/pi-coding-agent';
8
+ import '../../../sandbox-DAD8cWQR.js';
9
+ import '@hachej/boring-bash/agent';
10
+ import '@hachej/boring-sandbox/providers/node-workspace';
11
+ import '../../../piChatSessionService-BaaVWke7.js';
12
+
13
+ /** G1 ships only the embedded bounded-replay contract. */
14
+ type GatewayReplayConformanceLevel = 'B';
15
+ /** G1 ships only mutation-best-effort keyset pagination. */
16
+ type GatewayPaginationConformanceLevel = 'keyset';
17
+ interface GatewayConformanceFixture {
18
+ readonly gateway: AgentGateway;
19
+ issueScope(input?: {
20
+ readonly workspaceScopeId?: string;
21
+ readonly authSubjectId?: string;
22
+ readonly issuer?: 'primary' | 'foreign';
23
+ }): AuthorizedAgentScope;
24
+ revoke(scope: AuthorizedAgentScope): void;
25
+ setActivity(ref: AgentSessionRef, activity: AgentSessionActivity): void;
26
+ moveSession(ref: AgentSessionRef, updatedAt: number): void;
27
+ queueAdmission(operation: AgentGatewayEffect, disposition: 'strong-reject' | 'retryable'): void;
28
+ }
29
+ interface GatewayConformanceOptions {
30
+ readonly createFixture: () => Promise<GatewayConformanceFixture>;
31
+ readonly replayLevel: GatewayReplayConformanceLevel;
32
+ readonly paginationLevel: GatewayPaginationConformanceLevel;
33
+ }
34
+ /**
35
+ * Registers the placement-independent Gateway semantic contract against any
36
+ * implementation. Pagination capability is intentionally independent of the
37
+ * replay durability level.
38
+ */
39
+ declare function gatewayConformance(options: GatewayConformanceOptions): void;
40
+
41
+ export { type GatewayConformanceFixture, type GatewayConformanceOptions, type GatewayPaginationConformanceLevel, type GatewayReplayConformanceLevel, gatewayConformance };