@byok-sdk/protocol 0.8.0 → 0.9.0-rc.1

package/dist/messages.d.ts

@@ -316,6 +316,12 @@ export declare const TaskOfferForAgentPayloadSchema: z.ZodObject<{
         providerId: z.ZodString;
         modelId: z.ZodString;
     }, z.core.$strict>], "lane">>;
+    terminalProjection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"result-document">;
+        contract: z.ZodString;
+    }, z.core.$strict>], "mode">>;
     sessionRef: z.ZodOptional<z.ZodString>;
     limits: z.ZodOptional<z.ZodObject<{
         maxDurationMs: z.ZodOptional<z.ZodNumber>;
@@ -374,6 +380,12 @@ export declare const TaskOfferForAgentWithEgressPayloadSchema: z.ZodObject<{
         providerId: z.ZodString;
         modelId: z.ZodString;
     }, z.core.$strict>], "lane">>;
+    terminalProjection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"result-document">;
+        contract: z.ZodString;
+    }, z.core.$strict>], "mode">>;
     limits: z.ZodOptional<z.ZodObject<{
         maxDurationMs: z.ZodOptional<z.ZodNumber>;
         maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -410,6 +422,15 @@ export declare const TaskOfferForAgentWithEgressPayloadSchema: z.ZodObject<{
             }, z.core.$strict>]>;
         }, z.core.$strict>;
     }, z.core.$strict>;
+    messageEgress: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodLiteral<"required">;
+        contract: z.ZodString;
+        contentType: z.ZodEnum<{
+            "text/markdown": "text/markdown";
+            "text/plain": "text/plain";
+        }>;
+        maxBytes: z.ZodNumber;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type TaskOfferForAgentWithEgressPayload = z.infer<typeof TaskOfferForAgentWithEgressPayloadSchema>;
 /**
@@ -464,6 +485,12 @@ export declare const TaskOfferForAgentWithEgressFreshPayloadSchema: z.ZodObject<
         providerId: z.ZodString;
         modelId: z.ZodString;
     }, z.core.$strict>], "lane">>;
+    terminalProjection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"result-document">;
+        contract: z.ZodString;
+    }, z.core.$strict>], "mode">>;
     limits: z.ZodOptional<z.ZodObject<{
         maxDurationMs: z.ZodOptional<z.ZodNumber>;
         maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -499,6 +526,15 @@ export declare const TaskOfferForAgentWithEgressFreshPayloadSchema: z.ZodObject<
             }, z.core.$strict>]>;
         }, z.core.$strict>;
     }, z.core.$strict>;
+    messageEgress: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodLiteral<"required">;
+        contract: z.ZodString;
+        contentType: z.ZodEnum<{
+            "text/markdown": "text/markdown";
+            "text/plain": "text/plain";
+        }>;
+        maxBytes: z.ZodNumber;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type TaskOfferForAgentWithEgressFreshPayload = z.infer<typeof TaskOfferForAgentWithEgressFreshPayloadSchema>;
 /** Daemon -> cloud: one durable reliable-lane item after local sanitization. */
@@ -529,6 +565,44 @@ export declare const AgentEgressAckPayloadSchema: z.ZodObject<{
     receiptId: z.ZodUUID;
 }, z.core.$strict>;
 export type AgentEgressAckPayload = z.infer<typeof AgentEgressAckPayloadSchema>;
+/** Daemon -> server: one Agent-authored message, independent from task activity. */
+export declare const AgentMessagePublishPayloadSchema: z.ZodObject<{
+    agentRef: z.ZodObject<{
+        agentId: z.ZodString;
+        profileRevision: z.ZodString;
+    }, z.core.$strict>;
+    sessionRef: z.ZodString;
+    contract: z.ZodString;
+    messageId: z.ZodUUID;
+    cursor: z.ZodNumber;
+    contentType: z.ZodEnum<{
+        "text/markdown": "text/markdown";
+        "text/plain": "text/plain";
+    }>;
+    body: z.ZodString;
+    contentHash: z.ZodString;
+    byteCount: z.ZodNumber;
+}, z.core.$strict>;
+export type AgentMessagePublishPayload = z.infer<typeof AgentMessagePublishPayloadSchema>;
+export declare const AgentMessageDispositionPayloadSchema: z.ZodObject<{
+    agentRef: z.ZodObject<{
+        agentId: z.ZodString;
+        profileRevision: z.ZodString;
+    }, z.core.$strict>;
+    sessionRef: z.ZodString;
+    contract: z.ZodString;
+    messageId: z.ZodUUID;
+    cursor: z.ZodNumber;
+    contentHash: z.ZodString;
+    outcome: z.ZodEnum<{
+        accepted: "accepted";
+        held: "held";
+        refused: "refused";
+    }>;
+    receiptId: z.ZodUUID;
+    reasonCode: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AgentMessageDispositionPayload = z.infer<typeof AgentMessageDispositionPayloadSchema>;
 /** Server -> daemon: one exact, independently-capability-gated content read. */
 export declare const AgentContentReadPayloadSchema: z.ZodObject<{
     requestId: z.ZodUUID;
@@ -1395,6 +1469,12 @@ export declare const MESSAGE_PAYLOAD_SCHEMAS: {
             providerId: z.ZodString;
             modelId: z.ZodString;
         }, z.core.$strict>], "lane">>;
+        terminalProjection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            mode: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            mode: z.ZodLiteral<"result-document">;
+            contract: z.ZodString;
+        }, z.core.$strict>], "mode">>;
         sessionRef: z.ZodOptional<z.ZodString>;
         limits: z.ZodOptional<z.ZodObject<{
             maxDurationMs: z.ZodOptional<z.ZodNumber>;
@@ -1447,6 +1527,12 @@ export declare const MESSAGE_PAYLOAD_SCHEMAS: {
             providerId: z.ZodString;
             modelId: z.ZodString;
         }, z.core.$strict>], "lane">>;
+        terminalProjection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            mode: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            mode: z.ZodLiteral<"result-document">;
+            contract: z.ZodString;
+        }, z.core.$strict>], "mode">>;
         limits: z.ZodOptional<z.ZodObject<{
             maxDurationMs: z.ZodOptional<z.ZodNumber>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -1483,6 +1569,15 @@ export declare const MESSAGE_PAYLOAD_SCHEMAS: {
                 }, z.core.$strict>]>;
             }, z.core.$strict>;
         }, z.core.$strict>;
+        messageEgress: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodLiteral<"required">;
+            contract: z.ZodString;
+            contentType: z.ZodEnum<{
+                "text/markdown": "text/markdown";
+                "text/plain": "text/plain";
+            }>;
+            maxBytes: z.ZodNumber;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     readonly 'task.offer_for_agent_with_egress_fresh': z.ZodObject<{
         instruction: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
@@ -1530,6 +1625,12 @@ export declare const MESSAGE_PAYLOAD_SCHEMAS: {
             providerId: z.ZodString;
             modelId: z.ZodString;
         }, z.core.$strict>], "lane">>;
+        terminalProjection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            mode: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            mode: z.ZodLiteral<"result-document">;
+            contract: z.ZodString;
+        }, z.core.$strict>], "mode">>;
         limits: z.ZodOptional<z.ZodObject<{
             maxDurationMs: z.ZodOptional<z.ZodNumber>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -1565,6 +1666,15 @@ export declare const MESSAGE_PAYLOAD_SCHEMAS: {
                 }, z.core.$strict>]>;
             }, z.core.$strict>;
         }, z.core.$strict>;
+        messageEgress: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodLiteral<"required">;
+            contract: z.ZodString;
+            contentType: z.ZodEnum<{
+                "text/markdown": "text/markdown";
+                "text/plain": "text/plain";
+            }>;
+            maxBytes: z.ZodNumber;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     readonly 'agent.egress.reliable': z.ZodObject<{
         agentRef: z.ZodObject<{
@@ -1590,6 +1700,41 @@ export declare const MESSAGE_PAYLOAD_SCHEMAS: {
         cursor: z.ZodNumber;
         receiptId: z.ZodUUID;
     }, z.core.$strict>;
+    readonly 'agent.message.publish': z.ZodObject<{
+        agentRef: z.ZodObject<{
+            agentId: z.ZodString;
+            profileRevision: z.ZodString;
+        }, z.core.$strict>;
+        sessionRef: z.ZodString;
+        contract: z.ZodString;
+        messageId: z.ZodUUID;
+        cursor: z.ZodNumber;
+        contentType: z.ZodEnum<{
+            "text/markdown": "text/markdown";
+            "text/plain": "text/plain";
+        }>;
+        body: z.ZodString;
+        contentHash: z.ZodString;
+        byteCount: z.ZodNumber;
+    }, z.core.$strict>;
+    readonly 'agent.message.disposition': z.ZodObject<{
+        agentRef: z.ZodObject<{
+            agentId: z.ZodString;
+            profileRevision: z.ZodString;
+        }, z.core.$strict>;
+        sessionRef: z.ZodString;
+        contract: z.ZodString;
+        messageId: z.ZodUUID;
+        cursor: z.ZodNumber;
+        contentHash: z.ZodString;
+        outcome: z.ZodEnum<{
+            accepted: "accepted";
+            held: "held";
+            refused: "refused";
+        }>;
+        receiptId: z.ZodUUID;
+        reasonCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
     readonly 'agent.content.read': z.ZodObject<{
         requestId: z.ZodUUID;
         surface: z.ZodEnum<{
@@ -1930,7 +2075,7 @@ export declare const MESSAGE_TYPES: MessageType[];
  * (`envelope.ts`) to decide which branches require envelope `seq` (M1
  * redelivery cursor).
  */
-export declare const SERVER_TO_DAEMON_TYPES: readonly ["conn.ack", "task.offer", "task.offer_with_toolsets", "task.offer_for_agent", "task.offer_for_agent_with_egress", "task.offer_for_agent_with_egress_fresh", "agent.egress.ack", "agent.content.read", "agent.home.projection", "task.approve", "task.reject", "task.cancel", "task.steer"];
+export declare const SERVER_TO_DAEMON_TYPES: readonly ["conn.ack", "task.offer", "task.offer_with_toolsets", "task.offer_for_agent", "task.offer_for_agent_with_egress", "task.offer_for_agent_with_egress_fresh", "agent.egress.ack", "agent.message.disposition", "agent.content.read", "agent.home.projection", "task.approve", "task.reject", "task.cancel", "task.steer"];
 /**
  * Message types the daemon sends to the server — the flip side of
  * {@link SERVER_TO_DAEMON_TYPES}. `conn.hello` is deliberately excluded: it's
@@ -1943,4 +2088,4 @@ export declare const SERVER_TO_DAEMON_TYPES: readonly ["conn.ack", "task.offer",
  * or anything unrecognized — is rejected before it's dispatched to any
  * handler or counted `accepted` on the `/byok/messages` wire.
  */
-export declare const DAEMON_TO_SERVER_TYPES: readonly ["task.claim", "task.started", "task.decline", "task.progress", "task.artifact", "task.await_approval", "task.complete", "task.fail", "task.cancelled", "task.approval_resolved", "agent.egress.reliable", "agent.content.receipt"];
+export declare const DAEMON_TO_SERVER_TYPES: readonly ["task.claim", "task.started", "task.decline", "task.progress", "task.artifact", "task.await_approval", "task.complete", "task.fail", "task.cancelled", "task.approval_resolved", "agent.egress.reliable", "agent.message.publish", "agent.content.receipt"];

package/dist/terminal-projection.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/** Capability required before an offer may select terminal projection behavior. */
+export declare const TERMINAL_PROJECTION_SELECTION_CAPABILITY: 'terminal-projection-selection';
+export declare const TerminalProjectionContractSchema: z.ZodString;
+/** Offer-scoped authority: explicit bypass or one required structured result. */
+export declare const TerminalProjectionSelectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"none">;
+}, z.core.$strict>, z.ZodObject<{
+    mode: z.ZodLiteral<"result-document">;
+    contract: z.ZodString;
+}, z.core.$strict>], "mode">;
+export type TerminalProjectionSelection = z.infer<typeof TerminalProjectionSelectionSchema>;

package/dist/version.d.ts

@@ -23,6 +23,8 @@
  * silent edit to either file to make the test pass.
  */
 export declare const PROTOCOL_VERSION = 1;
+/** Host declares that this device accepts only Agent-bound offer variants. */
+export declare const STRICT_AGENT_ONLY_CAPABILITY: 'strict-agent-only';
 /**
  * Capability flags exchanged during the connection handshake (`conn.hello` /
  * `conn.ack`). Additional flags may be introduced without a protocol version
@@ -101,5 +103,5 @@ export declare const PROTOCOL_VERSION = 1;
  * boundary for long-poll: an older daemon skips it as unknown and therefore
  * cannot accidentally execute the instruction without the required tools.
  */
-export declare const CAPABILITY_FLAGS: readonly ['steer', 'blob-upload', 'interactive-approval', 'approval_resolved', 'approval-targeting', 'result-document', 'dispatch-selection', 'toolset-selection', 'agent-home-contract', "agent-egress-policy", "agent-egress-reliable-ack", "agent-egress-fresh-session", "agent-content-workspace-read", "agent-content-transcript-read", "agent-content-artifact-read", "agent-home-projection"];
+export declare const CAPABILITY_FLAGS: readonly ['steer', 'blob-upload', 'interactive-approval', 'approval_resolved', 'approval-targeting', 'result-document', 'dispatch-selection', 'toolset-selection', 'agent-home-contract', "strict-agent-only", "agent-egress-policy", "agent-egress-reliable-ack", "agent-message-egress", "agent-egress-fresh-session", "agent-content-workspace-read", "agent-content-transcript-read", "agent-content-artifact-read", "agent-home-projection", "terminal-projection-selection"];
 export type CapabilityFlag = (typeof CAPABILITY_FLAGS)[number];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byok-sdk/protocol",
-  "version": "0.8.0",
+  "version": "0.9.0-rc.1",
   "description": "BYOK SDK wire protocol: envelope schema, message types, and codec helpers",
   "type": "module",
   "license": "MIT",