npm - @byok-sdk/protocol - Versions diffs - 0.13.0 → 0.14.0 - Mend

@byok-sdk/protocol 0.13.0 → 0.14.0

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 (8) hide show

package/dist/agent-event.d.ts CHANGED Viewed

@@ -1,4 +1,62 @@
 import { z } from 'zod';
+/**
+ * Maximum UTF-16 length of {@link AgentEventSpillSchema}'s `unstoredReason`.
+ * The reason is a bounded diagnostic string, not a place to inline the
+ * content that failed to store: the whole point of a spill descriptor is
+ * that the event stays under the daemon's inline-event cap even when the
+ * blob upload failed.
+ */
+export declare const AGENT_EVENT_SPILL_UNSTORED_REASON_MAX_LENGTH = 512;
+/**
+ * Additive descriptor attached to a `tool_use` / `tool_result` event whose
+ * `input` / `output` was too large to travel inline and was therefore
+ * REPLACED, at the daemon's ingestion boundary, by a bounded head/tail
+ * preview (`{ preview: { head, tail } }`). See
+ * `packages/client/src/daemon/event-spill.ts` for the producer and
+ * `DaemonConfig.maxInlineEventBytes` for the cap.
+ *
+ * Presence of this field is the ONLY signal that the inline field is a
+ * projection rather than the whole value — a consumer that reads
+ * `tool_result.output` (or `tool_use.input`) without checking `spill` is
+ * reading a preview and calling it the result.
+ *
+ * Exactly one of `blob` / `unstoredReason` is present, and the union is
+ * closed on purpose:
+ *
+ *  - `blob` — the full `JSON.stringify(<field>)` bytes are readable from the
+ *    blob plane (protocol §7) under that `BlobRef`; `contentHash` is the
+ *    sha256 of exactly those bytes, so a consumer can verify what it read
+ *    back is what was omitted.
+ *  - `unstoredReason` — the omitted bytes are not readable from this event:
+ *    either the upload failed, or it succeeded but the returned locator did
+ *    not fit the daemon's inline cap. Either way the content is not reachable
+ *    through this event; the reason says which. This exists so an unreadable
+ *    omission is observable rather than silently indistinguishable from a
+ *    small output.
+ *
+ * `.strict()` because this is an SDK-authored descriptor with a closed
+ * shape, not free-form runtime data: an unrecognized key here means a
+ * producer and a consumer disagree about what the omission means, which is
+ * exactly the case that must fail loudly.
+ */
+export declare const AgentEventSpillSchema: z.ZodObject<{
+    field: z.ZodEnum<{
+        input: "input";
+        output: "output";
+    }>;
+    totalBytes: z.ZodNumber;
+    omittedBytes: z.ZodNumber;
+    contentType: z.ZodLiteral<"application/json">;
+    blob: z.ZodOptional<z.ZodObject<{
+        blobId: z.ZodString;
+        contentHash: z.ZodString;
+        size: z.ZodNumber;
+        contentType: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    unstoredReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AgentEventSpill = z.infer<typeof AgentEventSpillSchema>;
 /**
  * Normalized event shape that every runtime adapter (pi / claude / codex)
  * translates its native JSONL output into. This is the interior of a
@@ -12,12 +70,46 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     tool: z.ZodString;
     input: z.ZodOptional<z.ZodUnknown>;
     toolCallId: z.ZodOptional<z.ZodString>;
+    spill: z.ZodOptional<z.ZodObject<{
+        field: z.ZodEnum<{
+            input: "input";
+            output: "output";
+        }>;
+        totalBytes: z.ZodNumber;
+        omittedBytes: z.ZodNumber;
+        contentType: z.ZodLiteral<"application/json">;
+        blob: z.ZodOptional<z.ZodObject<{
+            blobId: z.ZodString;
+            contentHash: z.ZodString;
+            size: z.ZodNumber;
+            contentType: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        unstoredReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"tool_result">;
     tool: z.ZodString;
     output: z.ZodOptional<z.ZodUnknown>;
     toolCallId: z.ZodOptional<z.ZodString>;
     isError: z.ZodOptional<z.ZodBoolean>;
+    spill: z.ZodOptional<z.ZodObject<{
+        field: z.ZodEnum<{
+            input: "input";
+            output: "output";
+        }>;
+        totalBytes: z.ZodNumber;
+        omittedBytes: z.ZodNumber;
+        contentType: z.ZodLiteral<"application/json">;
+        blob: z.ZodOptional<z.ZodObject<{
+            blobId: z.ZodString;
+            contentHash: z.ZodString;
+            size: z.ZodNumber;
+            contentType: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        unstoredReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"artifact">;
     name: z.ZodString;
@@ -106,12 +198,46 @@ export declare const AgentEventOrUnknownSchema: z.ZodUnion<readonly [z.ZodDiscri
     tool: z.ZodString;
     input: z.ZodOptional<z.ZodUnknown>;
     toolCallId: z.ZodOptional<z.ZodString>;
+    spill: z.ZodOptional<z.ZodObject<{
+        field: z.ZodEnum<{
+            input: "input";
+            output: "output";
+        }>;
+        totalBytes: z.ZodNumber;
+        omittedBytes: z.ZodNumber;
+        contentType: z.ZodLiteral<"application/json">;
+        blob: z.ZodOptional<z.ZodObject<{
+            blobId: z.ZodString;
+            contentHash: z.ZodString;
+            size: z.ZodNumber;
+            contentType: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        unstoredReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"tool_result">;
     tool: z.ZodString;
     output: z.ZodOptional<z.ZodUnknown>;
     toolCallId: z.ZodOptional<z.ZodString>;
     isError: z.ZodOptional<z.ZodBoolean>;
+    spill: z.ZodOptional<z.ZodObject<{
+        field: z.ZodEnum<{
+            input: "input";
+            output: "output";
+        }>;
+        totalBytes: z.ZodNumber;
+        omittedBytes: z.ZodNumber;
+        contentType: z.ZodLiteral<"application/json">;
+        blob: z.ZodOptional<z.ZodObject<{
+            blobId: z.ZodString;
+            contentHash: z.ZodString;
+            size: z.ZodNumber;
+            contentType: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        unstoredReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"artifact">;
     name: z.ZodString;

package/dist/envelope.d.ts CHANGED Viewed

@@ -736,12 +736,46 @@ export declare const EnvelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             tool: z.ZodString;
             input: z.ZodOptional<z.ZodUnknown>;
             toolCallId: z.ZodOptional<z.ZodString>;
+            spill: z.ZodOptional<z.ZodObject<{
+                field: z.ZodEnum<{
+                    input: "input";
+                    output: "output";
+                }>;
+                totalBytes: z.ZodNumber;
+                omittedBytes: z.ZodNumber;
+                contentType: z.ZodLiteral<"application/json">;
+                blob: z.ZodOptional<z.ZodObject<{
+                    blobId: z.ZodString;
+                    contentHash: z.ZodString;
+                    size: z.ZodNumber;
+                    contentType: z.ZodString;
+                    url: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                unstoredReason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"tool_result">;
             tool: z.ZodString;
             output: z.ZodOptional<z.ZodUnknown>;
             toolCallId: z.ZodOptional<z.ZodString>;
             isError: z.ZodOptional<z.ZodBoolean>;
+            spill: z.ZodOptional<z.ZodObject<{
+                field: z.ZodEnum<{
+                    input: "input";
+                    output: "output";
+                }>;
+                totalBytes: z.ZodNumber;
+                omittedBytes: z.ZodNumber;
+                contentType: z.ZodLiteral<"application/json">;
+                blob: z.ZodOptional<z.ZodObject<{
+                    blobId: z.ZodString;
+                    contentHash: z.ZodString;
+                    size: z.ZodNumber;
+                    contentType: z.ZodString;
+                    url: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                unstoredReason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"artifact">;
             name: z.ZodString;

package/dist/http-api.d.ts CHANGED Viewed

@@ -829,12 +829,46 @@ export declare const EventsPollResponseSchema: z.ZodObject<{
                 tool: z.ZodString;
                 input: z.ZodOptional<z.ZodUnknown>;
                 toolCallId: z.ZodOptional<z.ZodString>;
+                spill: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodEnum<{
+                        input: "input";
+                        output: "output";
+                    }>;
+                    totalBytes: z.ZodNumber;
+                    omittedBytes: z.ZodNumber;
+                    contentType: z.ZodLiteral<"application/json">;
+                    blob: z.ZodOptional<z.ZodObject<{
+                        blobId: z.ZodString;
+                        contentHash: z.ZodString;
+                        size: z.ZodNumber;
+                        contentType: z.ZodString;
+                        url: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    unstoredReason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"tool_result">;
                 tool: z.ZodString;
                 output: z.ZodOptional<z.ZodUnknown>;
                 toolCallId: z.ZodOptional<z.ZodString>;
                 isError: z.ZodOptional<z.ZodBoolean>;
+                spill: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodEnum<{
+                        input: "input";
+                        output: "output";
+                    }>;
+                    totalBytes: z.ZodNumber;
+                    omittedBytes: z.ZodNumber;
+                    contentType: z.ZodLiteral<"application/json">;
+                    blob: z.ZodOptional<z.ZodObject<{
+                        blobId: z.ZodString;
+                        contentHash: z.ZodString;
+                        size: z.ZodNumber;
+                        contentType: z.ZodString;
+                        url: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    unstoredReason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"artifact">;
                 name: z.ZodString;
@@ -1899,12 +1933,46 @@ export declare const MessagesSendRequestSchema: z.ZodObject<{
                 tool: z.ZodString;
                 input: z.ZodOptional<z.ZodUnknown>;
                 toolCallId: z.ZodOptional<z.ZodString>;
+                spill: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodEnum<{
+                        input: "input";
+                        output: "output";
+                    }>;
+                    totalBytes: z.ZodNumber;
+                    omittedBytes: z.ZodNumber;
+                    contentType: z.ZodLiteral<"application/json">;
+                    blob: z.ZodOptional<z.ZodObject<{
+                        blobId: z.ZodString;
+                        contentHash: z.ZodString;
+                        size: z.ZodNumber;
+                        contentType: z.ZodString;
+                        url: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    unstoredReason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"tool_result">;
                 tool: z.ZodString;
                 output: z.ZodOptional<z.ZodUnknown>;
                 toolCallId: z.ZodOptional<z.ZodString>;
                 isError: z.ZodOptional<z.ZodBoolean>;
+                spill: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodEnum<{
+                        input: "input";
+                        output: "output";
+                    }>;
+                    totalBytes: z.ZodNumber;
+                    omittedBytes: z.ZodNumber;
+                    contentType: z.ZodLiteral<"application/json">;
+                    blob: z.ZodOptional<z.ZodObject<{
+                        blobId: z.ZodString;
+                        contentHash: z.ZodString;
+                        size: z.ZodNumber;
+                        contentType: z.ZodString;
+                        url: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    unstoredReason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"artifact">;
                 name: z.ZodString;

package/dist/index.d.ts CHANGED Viewed

@@ -6,8 +6,8 @@ export { PermissionPolicySchema, PERMISSION_MODES } from './permission';
 export type { PermissionPolicy, PermissionMode } from './permission';
 export { PROVIDER_PROFILE_BINDING_CAPABILITY, PROVIDER_MODEL_CAPABILITIES, ProviderProfileRefSchema, ProviderProfileRevisionSchema, ProviderProfileHashSchema, ProviderModelCapabilitySchema, ProviderProfileBindingSchema, } from './provider-profile-binding';
 export type { ProviderProfileRef, ProviderProfileRevision, ProviderProfileHash, ProviderModelCapability, ProviderProfileBinding, } from './provider-profile-binding';
-export { AgentEventSchema, UnknownAgentEventSchema, AgentEventOrUnknownSchema, KNOWN_AGENT_EVENT_TYPES, isKnownAgentEvent, partitionAgentEvents, } from './agent-event';
-export type { AgentEvent, UnknownAgentEvent, AgentEventOrUnknown } from './agent-event';
+export { AgentEventSchema, AgentEventSpillSchema, AGENT_EVENT_SPILL_UNSTORED_REASON_MAX_LENGTH, UnknownAgentEventSchema, AgentEventOrUnknownSchema, KNOWN_AGENT_EVENT_TYPES, isKnownAgentEvent, partitionAgentEvents, } from './agent-event';
+export type { AgentEvent, AgentEventSpill, UnknownAgentEvent, AgentEventOrUnknown } from './agent-event';
 export { AgentEgressPolicySchema, AgentEgressActivityPolicySchema, AgentReliableQuotaPolicySchema, ContentReadPolicySchema, AgentEgressLaneSchema, AgentEgressDropReasonSchema, AgentContentReadSurfaceSchema, AgentContentActorKindSchema, AgentContentActorSchema, AgentContentDecodeAsSchema, AgentContentMimeTypeSchema, AgentContentReadDecisionSchema, AgentContentReadDenialReasonSchema, AgentEgressContentHashSchema, AgentEgressPolicyRevisionSchema, AgentMessageContractSchema, AgentMessageContentTypeSchema, AgentMessageDestinationBindingSchema, AgentMessageFreshnessCursorSchema, AgentMessageServerContextSchema, AgentMessageEgressRequirementSchema, AGENT_MESSAGE_MAX_BYTES, AGENT_MESSAGE_EGRESS_CAPABILITY, AGENT_EGRESS_POLICY_CAPABILITY, AGENT_EGRESS_RELIABLE_ACK_CAPABILITY, AGENT_EGRESS_FRESH_SESSION_CAPABILITY, AGENT_CONTENT_WORKSPACE_READ_CAPABILITY, AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY, AGENT_CONTENT_ARTIFACT_READ_CAPABILITY, } from './agent-egress';
 export type { AgentEgressPolicy, AgentEgressActivityPolicy, AgentReliableQuotaPolicy, ContentReadPolicy, AgentEgressLane, AgentEgressDropReason, AgentMessageContentType, AgentMessageEgressRequirement, AgentMessageServerContext, AgentContentReadSurface, AgentContentActorKind, AgentContentActor, AgentContentDecodeAs, AgentContentReadDecision, AgentContentReadDenialReason, } from './agent-egress';
 export { AGENT_HOME_PROJECTION_CAPABILITY, AGENT_HOME_PROJECTION_MAX_BYTES, AGENT_HOME_PROJECTION_PROFILE_REVISION_MAXIMUM, AgentHomeProjectionProfileRevisionSchema, AgentHomeProjectionHashSchema, AgentHomeProjectionOutcomeSchema, AgentHomeProjectionValueSchema, } from './agent-home-projection';
@@ -18,7 +18,7 @@ export { TERMINAL_PROJECTION_SELECTION_CAPABILITY, TerminalProjectionContractSch
 export type { TerminalProjectionSelection } from './terminal-projection';
 export { TASK_STATES, TASK_TRANSITIONS, canTransition } from './task-state';
 export type { TaskState } from './task-state';
-export { MESSAGE_TYPES, MESSAGE_PAYLOAD_SCHEMAS, SERVER_TO_DAEMON_TYPES, DAEMON_TO_SERVER_TYPES, RuntimeIdSchema, ProtocolVersionNumberSchema, RuntimeInfoSchema, RuntimeCapabilitiesSchema, AgentRefSchema, AgentHomeProjectionAgentRefSchema, AGENT_REF_MAX_BYTES, DispatchSelectionSchema, ToolsetIdSchema, ConfiguredToolsetsSchema, RequiredToolsetsSchema, CONFIGURED_TOOLSETS_MAX_ITEMS, ConnHelloPayloadSchema, ConnAckPayloadSchema, TaskOfferPayloadSchema, TaskOfferWithToolsetsPayloadSchema, TaskOfferForAgentPayloadSchema, TaskOfferForAgentWithEgressPayloadSchema, TaskOfferForAgentWithEgressFreshPayloadSchema, AgentEgressReliablePayloadSchema, AgentEgressAckPayloadSchema, AgentMessagePublishPayloadSchema, AgentMessageDispositionPayloadSchema, AgentContentReadPayloadSchema, AgentContentReceiptPayloadSchema, AgentHomeProjectionPayloadSchema, TaskApprovePayloadSchema, TaskRejectPayloadSchema, TaskCancelPayloadSchema, TaskSteerPayloadSchema, TaskClaimPayloadSchema, TaskStartedPayloadSchema, TaskDeclinePayloadSchema, TaskProgressPayloadSchema, TaskArtifactPayloadSchema, TaskAwaitApprovalPayloadSchema, TaskCompletePayloadSchema, TaskFailPayloadSchema, TaskCancelledPayloadSchema, TaskApprovalResolvedPayloadSchema, RESULT_DOCUMENT_MAX_BYTES, checkResultDocument, TerminalInferenceUsageSchema, TERMINAL_INFERENCE_USAGE_MAX_TOKENS, TERMINAL_INFERENCE_USAGE_MAX_DURATION_MS, TERMINAL_INFERENCE_USAGE_PROVIDER_MAX_LENGTH, TERMINAL_INFERENCE_USAGE_MODEL_MAX_LENGTH, TERMINAL_INFERENCE_USAGE_CLIENT_VERSION_MAX_LENGTH, } from './messages';
+export { MESSAGE_TYPES, TASK_OFFER_TYPES, isTaskOfferType, MESSAGE_PAYLOAD_SCHEMAS, SERVER_TO_DAEMON_TYPES, DAEMON_TO_SERVER_TYPES, RuntimeIdSchema, ProtocolVersionNumberSchema, RuntimeInfoSchema, RuntimeCapabilitiesSchema, AgentRefSchema, AgentHomeProjectionAgentRefSchema, AGENT_REF_MAX_BYTES, DispatchSelectionSchema, ToolsetIdSchema, ConfiguredToolsetsSchema, RequiredToolsetsSchema, CONFIGURED_TOOLSETS_MAX_ITEMS, ConnHelloPayloadSchema, ConnAckPayloadSchema, TaskOfferPayloadSchema, TaskOfferWithToolsetsPayloadSchema, TaskOfferForAgentPayloadSchema, TaskOfferForAgentWithEgressPayloadSchema, TaskOfferForAgentWithEgressFreshPayloadSchema, AgentEgressReliablePayloadSchema, AgentEgressAckPayloadSchema, AgentMessagePublishPayloadSchema, AgentMessageDispositionPayloadSchema, AgentContentReadPayloadSchema, AgentContentReceiptPayloadSchema, AgentHomeProjectionPayloadSchema, TaskApprovePayloadSchema, TaskRejectPayloadSchema, TaskCancelPayloadSchema, TaskSteerPayloadSchema, TaskClaimPayloadSchema, TaskStartedPayloadSchema, TaskDeclinePayloadSchema, TaskProgressPayloadSchema, TaskArtifactPayloadSchema, TaskAwaitApprovalPayloadSchema, TaskCompletePayloadSchema, TaskFailPayloadSchema, TaskCancelledPayloadSchema, TaskApprovalResolvedPayloadSchema, RESULT_DOCUMENT_MAX_BYTES, checkResultDocument, TerminalInferenceUsageSchema, TERMINAL_INFERENCE_USAGE_MAX_TOKENS, TERMINAL_INFERENCE_USAGE_MAX_DURATION_MS, TERMINAL_INFERENCE_USAGE_PROVIDER_MAX_LENGTH, TERMINAL_INFERENCE_USAGE_MODEL_MAX_LENGTH, TERMINAL_INFERENCE_USAGE_CLIENT_VERSION_MAX_LENGTH, } from './messages';
 export type { ResultDocumentCheck, MessageType, RuntimeId, RuntimeInfo, RuntimeCapabilities, AgentRef, AgentHomeProjectionAgentRef, DispatchSelection, ToolsetId, ConnHelloPayload, ConnAckPayload, TaskOfferPayload, TaskOfferWithToolsetsPayload, TaskOfferForAgentPayload, TaskOfferForAgentWithEgressPayload, TaskOfferForAgentWithEgressFreshPayload, AgentEgressReliablePayload, AgentEgressAckPayload, AgentMessagePublishPayload, AgentMessageDispositionPayload, AgentContentReadPayload, AgentContentReceiptPayload, AgentHomeProjectionPayload, TaskApprovePayload, TaskRejectPayload, TaskCancelPayload, TaskSteerPayload, TaskClaimPayload, TaskStartedPayload, TaskDeclinePayload, TaskProgressPayload, TaskArtifactPayload, TaskAwaitApprovalPayload, TaskCompletePayload, TaskFailPayload, TaskCancelledPayload, TaskApprovalResolvedPayload, TerminalInferenceUsage, } from './messages';
 export { EnvelopeSchema, isServerToDaemonType } from './envelope';
 export type { Envelope } from './envelope';
@@ -27,3 +27,4 @@ export { encodeEnvelope, decodeEnvelope, createEnvelope, parseMessage } from './
 export type { CreateEnvelopeOptions } from './codec';
 export { PairRequestSchema, PairResponseTenantIdSchema, PAIR_RESPONSE_TENANT_ID_MAX_LENGTH, PairResponseSchema, ChallengeRequestSchema, ChallengeResponseSchema, TokenRequestSchema, TokenResponseSchema, PresencePublishRequestSchema, CreateBlobRequestSchema, CreateBlobResponseSchema, BlobDownloadUrlResponseSchema, EventsPollQuerySchema, EventsPollResponseSchema, MessagesSendRequestSchema, MessagesSendResponseSchema, AgentHomeProjectionCompletionRequestSchema, AgentHomeProjectionStatusSchema, AgentHomeProjectionReadbackSchema, AgentMemoryProjectionCommitRequestSchema, AgentMemoryProjectionCommitResponseSchema, MAX_MESSAGES_PER_BATCH, BYOK_PAIR_PATH, BYOK_CHALLENGE_PATH, BYOK_TOKEN_PATH, BYOK_CAPABILITIES_PATH, BYOK_EVENTS_PATH, BYOK_MESSAGES_PATH, BYOK_AGENT_HOME_PROJECTIONS_PATH, BYOK_AGENT_HOME_PROJECTION_COMPLETION_ROUTE, byokAgentHomeProjectionCompletionPath, BYOK_AGENT_MEMORY_PROJECTIONS_PATH, BYOK_PRESENCE_PATH, BYOK_ACTIVITY_PATH, BYOK_BOARD_PATH, BYOK_BOARD_STREAM_PATH, BYOK_BOARD_CLAIM_ROUTE, BYOK_BOARD_UNCLAIM_ROUTE, BYOK_BOARD_STATUS_ROUTE, BYOK_RECORDS_PATH, BYOK_RECORD_ROUTE, byokRecordPath, BYOK_SKILL_PACKS_PATH, BYOK_SKILL_PACK_FILE_ROUTE, byokSkillPackFilePath, BYOK_BLOBS_PATH, BYOK_BLOB_FINALIZE_ROUTE, BYOK_BLOB_URL_ROUTE, BYOK_BLOB_CONTENT_ROUTE, byokBlobFinalizePath, byokBlobUrlPath, byokBlobContentPath, } from './http-api';
 export type { PairRequest, PairResponse, ChallengeRequest, ChallengeResponse, TokenRequest, TokenResponse, PresencePublishRequest, CreateBlobRequest, CreateBlobResponse, BlobDownloadUrlResponse, EventsPollQuery, EventsPollResponse, MessagesSendRequest, MessagesSendResponse, AgentHomeProjectionCompletionRequest, AgentHomeProjectionStatus, AgentHomeProjectionReadback, AgentMemoryProjectionCommitRequest, AgentMemoryProjectionCommitResponse, } from './http-api';
+export type { TaskOfferType } from './messages';

package/dist/index.js CHANGED Viewed

@@ -181,20 +181,42 @@ var PermissionPolicySchema = z.object({
   workspaceRoot: z.string().optional(),
   network: z.boolean().optional()
 }).strict();
+var AGENT_EVENT_SPILL_UNSTORED_REASON_MAX_LENGTH = 512;
+var AgentEventSpillSchema = z.object({
+  /** Which field of the event was replaced by a preview. */
+  field: z.enum(["input", "output"]),
+  /** UTF-8 byte length of the full `JSON.stringify(<field>)` that was spilled. */
+  totalBytes: z.number().int().nonnegative(),
+  /** `totalBytes` minus the UTF-8 bytes of the retained preview head + tail. */
+  omittedBytes: z.number().int().nonnegative(),
+  /** Always the JSON serialization of the field — never the tool's own notion of a content type. */
+  contentType: z.literal("application/json"),
+  /** Where the omitted bytes are readable. Mutually exclusive with `unstoredReason`. */
+  blob: BlobRefSchema.optional(),
+  /** Why the omitted bytes are NOT readable. Mutually exclusive with `blob`. */
+  unstoredReason: z.string().min(1).max(AGENT_EVENT_SPILL_UNSTORED_REASON_MAX_LENGTH).optional()
+}).strict().refine(
+  (spill) => spill.blob === void 0 !== (spill.unstoredReason === void 0),
+  "spill must carry exactly one of blob (the omitted bytes are readable) or unstoredReason (they are not)"
+);
 var AgentEventSchema = z.discriminatedUnion("type", [
   z.object({ type: z.literal("progress"), text: z.string() }),
   z.object({
     type: z.literal("tool_use"),
     tool: z.string(),
     input: z.unknown().optional(),
-    toolCallId: z.string().regex(/\S/, "toolCallId must contain a non-whitespace character").optional()
+    toolCallId: z.string().regex(/\S/, "toolCallId must contain a non-whitespace character").optional(),
+    /** Present only when `input` is a preview of a spilled value — see {@link AgentEventSpillSchema}. */
+    spill: AgentEventSpillSchema.optional()
   }),
   z.object({
     type: z.literal("tool_result"),
     tool: z.string(),
     output: z.unknown().optional(),
     toolCallId: z.string().regex(/\S/, "toolCallId must contain a non-whitespace character").optional(),
-    isError: z.boolean().optional()
+    isError: z.boolean().optional(),
+    /** Present only when `output` is a preview of a spilled value — see {@link AgentEventSpillSchema}. */
+    spill: AgentEventSpillSchema.optional()
   }),
   z.object({ type: z.literal("artifact"), name: z.string(), contentType: z.string() }),
   z.object({ type: z.literal("needs_approval"), summary: z.string() }),
@@ -647,14 +669,23 @@ var TaskApprovalResolvedPayloadSchema = z.object({
   resolvedBy: z.enum(["local"]),
   at: z.iso.datetime({ offset: true })
 });
-var MESSAGE_PAYLOAD_SCHEMAS = {
-  "conn.hello": ConnHelloPayloadSchema,
-  "conn.ack": ConnAckPayloadSchema,
+var TASK_OFFER_PAYLOAD_SCHEMAS = {
   "task.offer": TaskOfferPayloadSchema,
   "task.offer_with_toolsets": TaskOfferWithToolsetsPayloadSchema,
   "task.offer_for_agent": TaskOfferForAgentPayloadSchema,
   "task.offer_for_agent_with_egress": TaskOfferForAgentWithEgressPayloadSchema,
-  "task.offer_for_agent_with_egress_fresh": TaskOfferForAgentWithEgressFreshPayloadSchema,
+  "task.offer_for_agent_with_egress_fresh": TaskOfferForAgentWithEgressFreshPayloadSchema
+};
+var TASK_OFFER_TYPES = Object.freeze(
+  Object.keys(TASK_OFFER_PAYLOAD_SCHEMAS)
+);
+function isTaskOfferType(type) {
+  return Object.hasOwn(TASK_OFFER_PAYLOAD_SCHEMAS, type);
+}
+var MESSAGE_PAYLOAD_SCHEMAS = {
+  "conn.hello": ConnHelloPayloadSchema,
+  "conn.ack": ConnAckPayloadSchema,
+  ...TASK_OFFER_PAYLOAD_SCHEMAS,
   "agent.egress.reliable": AgentEgressReliablePayloadSchema,
   "agent.egress.ack": AgentEgressAckPayloadSchema,
   "agent.message.publish": AgentMessagePublishPayloadSchema,
@@ -1110,6 +1141,6 @@ function byokBlobContentPath(blobId) {
   return `/byok/blobs/${blobId}/content`;
 }
-export { AGENT_CONTENT_ARTIFACT_READ_CAPABILITY, AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY, AGENT_CONTENT_WORKSPACE_READ_CAPABILITY, AGENT_EGRESS_FRESH_SESSION_CAPABILITY, AGENT_EGRESS_POLICY_CAPABILITY, AGENT_EGRESS_RELIABLE_ACK_CAPABILITY, AGENT_HOME_PROJECTION_CAPABILITY, AGENT_HOME_PROJECTION_MAX_BYTES, AGENT_HOME_PROJECTION_PROFILE_REVISION_MAXIMUM, AGENT_MEMORY_PROJECTION_CAPABILITY, AGENT_MEMORY_PROJECTION_MAX_ORDERING_VALUE, AGENT_MEMORY_PROJECTION_MAX_REDACTED_BYTES, AGENT_MESSAGE_EGRESS_CAPABILITY, AGENT_MESSAGE_MAX_BYTES, AGENT_REF_MAX_BYTES, AgentContentActorKindSchema, AgentContentActorSchema, AgentContentDecodeAsSchema, AgentContentMimeTypeSchema, AgentContentReadDecisionSchema, AgentContentReadDenialReasonSchema, AgentContentReadPayloadSchema, AgentContentReadSurfaceSchema, AgentContentReceiptPayloadSchema, AgentEgressAckPayloadSchema, AgentEgressActivityPolicySchema, AgentEgressContentHashSchema, AgentEgressDropReasonSchema, AgentEgressLaneSchema, AgentEgressPolicyRevisionSchema, AgentEgressPolicySchema, AgentEgressReliablePayloadSchema, AgentEventOrUnknownSchema, AgentEventSchema, AgentHomeProjectionAgentRefSchema, AgentHomeProjectionCompletionRequestSchema, AgentHomeProjectionHashSchema, AgentHomeProjectionOutcomeSchema, AgentHomeProjectionPayloadSchema, AgentHomeProjectionProfileRevisionSchema, AgentHomeProjectionReadbackSchema, AgentHomeProjectionStatusSchema, AgentHomeProjectionValueSchema, AgentMemoryProjectionCommitRequestSchema, AgentMemoryProjectionCommitResponseSchema, AgentMemoryProjectionEraseResultSchema, AgentMemoryProjectionGrantRefSchema, AgentMemoryProjectionMeteringReceiptSchema, AgentMemoryProjectionMutationSchema, AgentMemoryProjectionReceiptSchema, AgentMemoryProjectionSessionRefSchema, AgentMemoryProjectionSnapshotSchema, AgentMemoryProjectionSourceSeqSchema, AgentMemoryProjectionWriterEpochSchema, AgentMessageContentTypeSchema, AgentMessageContractSchema, AgentMessageDestinationBindingSchema, AgentMessageDispositionPayloadSchema, AgentMessageEgressRequirementSchema, AgentMessageFreshnessCursorSchema, AgentMessagePublishPayloadSchema, AgentMessageServerContextSchema, AgentRefSchema, AgentReliableQuotaPolicySchema, BYOK_ACTIVITY_PATH, BYOK_AGENT_HOME_PROJECTIONS_PATH, BYOK_AGENT_HOME_PROJECTION_COMPLETION_ROUTE, BYOK_AGENT_MEMORY_PROJECTIONS_PATH, BYOK_BLOBS_PATH, BYOK_BLOB_CONTENT_ROUTE, BYOK_BLOB_FINALIZE_ROUTE, BYOK_BLOB_URL_ROUTE, BYOK_BOARD_CLAIM_ROUTE, BYOK_BOARD_PATH, BYOK_BOARD_STATUS_ROUTE, BYOK_BOARD_STREAM_PATH, BYOK_BOARD_UNCLAIM_ROUTE, BYOK_CAPABILITIES_PATH, BYOK_CHALLENGE_PATH, BYOK_EVENTS_PATH, BYOK_MESSAGES_PATH, BYOK_PAIR_PATH, BYOK_PRESENCE_PATH, BYOK_RECORDS_PATH, BYOK_RECORD_ROUTE, BYOK_SKILL_PACKS_PATH, BYOK_SKILL_PACK_FILE_ROUTE, BYOK_TOKEN_PATH, BlobDownloadUrlResponseSchema, BlobRefSchema, CAPABILITY_FLAGS, CONFIGURED_TOOLSETS_MAX_ITEMS, CONTENT_HASH_RE, ChallengeRequestSchema, ChallengeResponseSchema, ConfiguredToolsetsSchema, ConnAckPayloadSchema, ConnHelloPayloadSchema, ContentReadPolicySchema, CreateBlobRequestSchema, CreateBlobResponseSchema, DAEMON_TO_SERVER_TYPES, DispatchSelectionSchema, EnvelopeParseError, EnvelopeSchema, EnvelopeValidationError, EventsPollQuerySchema, EventsPollResponseSchema, KNOWN_AGENT_EVENT_TYPES, MAX_MESSAGES_PER_BATCH, MESSAGE_PAYLOAD_SCHEMAS, MESSAGE_TYPES, MessagesSendRequestSchema, MessagesSendResponseSchema, PAIR_RESPONSE_TENANT_ID_MAX_LENGTH, PERMISSION_MODES, PROTOCOL_VERSION, PROVIDER_MODEL_CAPABILITIES, PROVIDER_PROFILE_BINDING_CAPABILITY, PairRequestSchema, PairResponseSchema, PairResponseTenantIdSchema, PermissionPolicySchema, PresencePublishRequestSchema, ProtocolError, ProtocolVersionNumberSchema, ProviderModelCapabilitySchema, ProviderProfileBindingSchema, ProviderProfileHashSchema, ProviderProfileRefSchema, ProviderProfileRevisionSchema, RESULT_DOCUMENT_MAX_BYTES, RequiredToolsetsSchema, RuntimeCapabilitiesSchema, RuntimeIdSchema, RuntimeInfoSchema, SERVER_TO_DAEMON_TYPES, STRICT_AGENT_ONLY_CAPABILITY, TASK_STATES, TASK_TRANSITIONS, TERMINAL_INFERENCE_USAGE_CLIENT_VERSION_MAX_LENGTH, TERMINAL_INFERENCE_USAGE_MAX_DURATION_MS, TERMINAL_INFERENCE_USAGE_MAX_TOKENS, TERMINAL_INFERENCE_USAGE_MODEL_MAX_LENGTH, TERMINAL_INFERENCE_USAGE_PROVIDER_MAX_LENGTH, TERMINAL_PROJECTION_SELECTION_CAPABILITY, TaskApprovalResolvedPayloadSchema, TaskApprovePayloadSchema, TaskArtifactPayloadSchema, TaskAwaitApprovalPayloadSchema, TaskCancelPayloadSchema, TaskCancelledPayloadSchema, TaskClaimPayloadSchema, TaskCompletePayloadSchema, TaskDeclinePayloadSchema, TaskFailPayloadSchema, TaskOfferForAgentPayloadSchema, TaskOfferForAgentWithEgressFreshPayloadSchema, TaskOfferForAgentWithEgressPayloadSchema, TaskOfferPayloadSchema, TaskOfferWithToolsetsPayloadSchema, TaskProgressPayloadSchema, TaskRejectPayloadSchema, TaskStartedPayloadSchema, TaskSteerPayloadSchema, TerminalInferenceUsageSchema, TerminalProjectionContractSchema, TerminalProjectionSelectionSchema, TokenRequestSchema, TokenResponseSchema, ToolsetIdSchema, UnknownAgentEventSchema, UnknownMessageTypeError, agentMemoryProjectionBase64UrlByteLength, byokAgentHomeProjectionCompletionPath, byokBlobContentPath, byokBlobFinalizePath, byokBlobUrlPath, byokRecordPath, byokSkillPackFilePath, canTransition, checkResultDocument, createEnvelope, decodeEnvelope, encodeEnvelope, isKnownAgentEvent, isServerToDaemonType, parseMessage, partitionAgentEvents };
+export { AGENT_CONTENT_ARTIFACT_READ_CAPABILITY, AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY, AGENT_CONTENT_WORKSPACE_READ_CAPABILITY, AGENT_EGRESS_FRESH_SESSION_CAPABILITY, AGENT_EGRESS_POLICY_CAPABILITY, AGENT_EGRESS_RELIABLE_ACK_CAPABILITY, AGENT_EVENT_SPILL_UNSTORED_REASON_MAX_LENGTH, AGENT_HOME_PROJECTION_CAPABILITY, AGENT_HOME_PROJECTION_MAX_BYTES, AGENT_HOME_PROJECTION_PROFILE_REVISION_MAXIMUM, AGENT_MEMORY_PROJECTION_CAPABILITY, AGENT_MEMORY_PROJECTION_MAX_ORDERING_VALUE, AGENT_MEMORY_PROJECTION_MAX_REDACTED_BYTES, AGENT_MESSAGE_EGRESS_CAPABILITY, AGENT_MESSAGE_MAX_BYTES, AGENT_REF_MAX_BYTES, AgentContentActorKindSchema, AgentContentActorSchema, AgentContentDecodeAsSchema, AgentContentMimeTypeSchema, AgentContentReadDecisionSchema, AgentContentReadDenialReasonSchema, AgentContentReadPayloadSchema, AgentContentReadSurfaceSchema, AgentContentReceiptPayloadSchema, AgentEgressAckPayloadSchema, AgentEgressActivityPolicySchema, AgentEgressContentHashSchema, AgentEgressDropReasonSchema, AgentEgressLaneSchema, AgentEgressPolicyRevisionSchema, AgentEgressPolicySchema, AgentEgressReliablePayloadSchema, AgentEventOrUnknownSchema, AgentEventSchema, AgentEventSpillSchema, AgentHomeProjectionAgentRefSchema, AgentHomeProjectionCompletionRequestSchema, AgentHomeProjectionHashSchema, AgentHomeProjectionOutcomeSchema, AgentHomeProjectionPayloadSchema, AgentHomeProjectionProfileRevisionSchema, AgentHomeProjectionReadbackSchema, AgentHomeProjectionStatusSchema, AgentHomeProjectionValueSchema, AgentMemoryProjectionCommitRequestSchema, AgentMemoryProjectionCommitResponseSchema, AgentMemoryProjectionEraseResultSchema, AgentMemoryProjectionGrantRefSchema, AgentMemoryProjectionMeteringReceiptSchema, AgentMemoryProjectionMutationSchema, AgentMemoryProjectionReceiptSchema, AgentMemoryProjectionSessionRefSchema, AgentMemoryProjectionSnapshotSchema, AgentMemoryProjectionSourceSeqSchema, AgentMemoryProjectionWriterEpochSchema, AgentMessageContentTypeSchema, AgentMessageContractSchema, AgentMessageDestinationBindingSchema, AgentMessageDispositionPayloadSchema, AgentMessageEgressRequirementSchema, AgentMessageFreshnessCursorSchema, AgentMessagePublishPayloadSchema, AgentMessageServerContextSchema, AgentRefSchema, AgentReliableQuotaPolicySchema, BYOK_ACTIVITY_PATH, BYOK_AGENT_HOME_PROJECTIONS_PATH, BYOK_AGENT_HOME_PROJECTION_COMPLETION_ROUTE, BYOK_AGENT_MEMORY_PROJECTIONS_PATH, BYOK_BLOBS_PATH, BYOK_BLOB_CONTENT_ROUTE, BYOK_BLOB_FINALIZE_ROUTE, BYOK_BLOB_URL_ROUTE, BYOK_BOARD_CLAIM_ROUTE, BYOK_BOARD_PATH, BYOK_BOARD_STATUS_ROUTE, BYOK_BOARD_STREAM_PATH, BYOK_BOARD_UNCLAIM_ROUTE, BYOK_CAPABILITIES_PATH, BYOK_CHALLENGE_PATH, BYOK_EVENTS_PATH, BYOK_MESSAGES_PATH, BYOK_PAIR_PATH, BYOK_PRESENCE_PATH, BYOK_RECORDS_PATH, BYOK_RECORD_ROUTE, BYOK_SKILL_PACKS_PATH, BYOK_SKILL_PACK_FILE_ROUTE, BYOK_TOKEN_PATH, BlobDownloadUrlResponseSchema, BlobRefSchema, CAPABILITY_FLAGS, CONFIGURED_TOOLSETS_MAX_ITEMS, CONTENT_HASH_RE, ChallengeRequestSchema, ChallengeResponseSchema, ConfiguredToolsetsSchema, ConnAckPayloadSchema, ConnHelloPayloadSchema, ContentReadPolicySchema, CreateBlobRequestSchema, CreateBlobResponseSchema, DAEMON_TO_SERVER_TYPES, DispatchSelectionSchema, EnvelopeParseError, EnvelopeSchema, EnvelopeValidationError, EventsPollQuerySchema, EventsPollResponseSchema, KNOWN_AGENT_EVENT_TYPES, MAX_MESSAGES_PER_BATCH, MESSAGE_PAYLOAD_SCHEMAS, MESSAGE_TYPES, MessagesSendRequestSchema, MessagesSendResponseSchema, PAIR_RESPONSE_TENANT_ID_MAX_LENGTH, PERMISSION_MODES, PROTOCOL_VERSION, PROVIDER_MODEL_CAPABILITIES, PROVIDER_PROFILE_BINDING_CAPABILITY, PairRequestSchema, PairResponseSchema, PairResponseTenantIdSchema, PermissionPolicySchema, PresencePublishRequestSchema, ProtocolError, ProtocolVersionNumberSchema, ProviderModelCapabilitySchema, ProviderProfileBindingSchema, ProviderProfileHashSchema, ProviderProfileRefSchema, ProviderProfileRevisionSchema, RESULT_DOCUMENT_MAX_BYTES, RequiredToolsetsSchema, RuntimeCapabilitiesSchema, RuntimeIdSchema, RuntimeInfoSchema, SERVER_TO_DAEMON_TYPES, STRICT_AGENT_ONLY_CAPABILITY, TASK_OFFER_TYPES, TASK_STATES, TASK_TRANSITIONS, TERMINAL_INFERENCE_USAGE_CLIENT_VERSION_MAX_LENGTH, TERMINAL_INFERENCE_USAGE_MAX_DURATION_MS, TERMINAL_INFERENCE_USAGE_MAX_TOKENS, TERMINAL_INFERENCE_USAGE_MODEL_MAX_LENGTH, TERMINAL_INFERENCE_USAGE_PROVIDER_MAX_LENGTH, TERMINAL_PROJECTION_SELECTION_CAPABILITY, TaskApprovalResolvedPayloadSchema, TaskApprovePayloadSchema, TaskArtifactPayloadSchema, TaskAwaitApprovalPayloadSchema, TaskCancelPayloadSchema, TaskCancelledPayloadSchema, TaskClaimPayloadSchema, TaskCompletePayloadSchema, TaskDeclinePayloadSchema, TaskFailPayloadSchema, TaskOfferForAgentPayloadSchema, TaskOfferForAgentWithEgressFreshPayloadSchema, TaskOfferForAgentWithEgressPayloadSchema, TaskOfferPayloadSchema, TaskOfferWithToolsetsPayloadSchema, TaskProgressPayloadSchema, TaskRejectPayloadSchema, TaskStartedPayloadSchema, TaskSteerPayloadSchema, TerminalInferenceUsageSchema, TerminalProjectionContractSchema, TerminalProjectionSelectionSchema, TokenRequestSchema, TokenResponseSchema, ToolsetIdSchema, UnknownAgentEventSchema, UnknownMessageTypeError, agentMemoryProjectionBase64UrlByteLength, byokAgentHomeProjectionCompletionPath, byokBlobContentPath, byokBlobFinalizePath, byokBlobUrlPath, byokRecordPath, byokSkillPackFilePath, canTransition, checkResultDocument, createEnvelope, decodeEnvelope, encodeEnvelope, isKnownAgentEvent, isServerToDaemonType, isTaskOfferType, parseMessage, partitionAgentEvents };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map