@byok-sdk/protocol 0.7.0 → 0.8.0

package/dist/index.js

@@ -3,6 +3,7 @@ import { z } from 'zod';
 // src/agent-egress.ts
 var AGENT_EGRESS_POLICY_CAPABILITY = "agent-egress-policy";
 var AGENT_EGRESS_RELIABLE_ACK_CAPABILITY = "agent-egress-reliable-ack";
+var AGENT_EGRESS_FRESH_SESSION_CAPABILITY = "agent-egress-fresh-session";
 var AGENT_CONTENT_WORKSPACE_READ_CAPABILITY = "agent-content-workspace-read";
 var AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY = "agent-content-transcript-read";
 var AGENT_CONTENT_ARTIFACT_READ_CAPABILITY = "agent-content-artifact-read";
@@ -83,6 +84,19 @@ var AgentContentReadDenialReasonSchema = z.enum([
 ]);
 var AgentEgressContentHashSchema = z.string().regex(/^sha256:[a-f0-9]{64}$/u, "contentHash must be a lowercase SHA-256 digest");
 var AgentEgressPolicyRevisionSchema = POLICY_REVISION;
+var AGENT_HOME_PROJECTION_CAPABILITY = "agent-home-projection";
+var AGENT_HOME_PROJECTION_MAX_BYTES = 64 * 1024;
+var AGENT_HOME_PROJECTION_PROFILE_REVISION_MAXIMUM = "9223372036854775807";
+var AgentHomeProjectionProfileRevisionSchema = z.string().regex(/^[1-9][0-9]{0,18}$/u, "profileRevision must be a canonical positive decimal string").refine(
+  (value) => value.length < AGENT_HOME_PROJECTION_PROFILE_REVISION_MAXIMUM.length || value <= AGENT_HOME_PROJECTION_PROFILE_REVISION_MAXIMUM,
+  `profileRevision must not exceed PostgreSQL BIGINT maximum ${AGENT_HOME_PROJECTION_PROFILE_REVISION_MAXIMUM}`
+);
+var AgentHomeProjectionHashSchema = AgentEgressContentHashSchema;
+var AgentHomeProjectionOutcomeSchema = z.enum(["applied", "idempotent", "stale", "conflict"]);
+var AgentHomeProjectionValueSchema = z.json().refine(
+  (value) => new TextEncoder().encode(JSON.stringify(value)).byteLength <= AGENT_HOME_PROJECTION_MAX_BYTES,
+  `projection must not exceed ${AGENT_HOME_PROJECTION_MAX_BYTES} UTF-8 JSON bytes`
+);
 
 // src/version.ts
 var PROTOCOL_VERSION = 1;
@@ -98,9 +112,11 @@ var CAPABILITY_FLAGS = [
   "agent-home-contract",
   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
+  AGENT_CONTENT_ARTIFACT_READ_CAPABILITY,
+  AGENT_HOME_PROJECTION_CAPABILITY
 ];
 var CONTENT_HASH_RE = /^sha256:[0-9a-f]{64}$/;
 var BlobRefSchema = z.object({
@@ -234,6 +250,9 @@ var AgentRefSchema = z.object({
   ),
   profileRevision: AGENT_REF_VALUE
 }).strict();
+var AgentHomeProjectionAgentRefSchema = AgentRefSchema.extend({
+  profileRevision: AgentHomeProjectionProfileRevisionSchema
+}).strict();
 function rejectDuplicateToolsets(ids, ctx, label) {
   const seen = /* @__PURE__ */ new Set();
   for (const [index, id] of ids.entries()) {
@@ -317,6 +336,9 @@ var TaskOfferForAgentWithEgressPayloadSchema = TaskOfferForAgentPayloadSchema.ex
   sessionRef: z.string().min(1).max(512),
   egressPolicy: AgentEgressPolicySchema
 }).strict();
+var TaskOfferForAgentWithEgressFreshPayloadSchema = TaskOfferForAgentPayloadSchema.omit({
+  sessionRef: true
+}).extend({ egressPolicy: AgentEgressPolicySchema }).strict();
 var EGRESS_SAFE_VALUE = z.json().refine(
   (value) => new TextEncoder().encode(JSON.stringify(value)).byteLength <= 256 * 1024,
   "sanitized egress payload exceeds 256KiB"
@@ -411,6 +433,12 @@ var AgentContentReceiptPayloadSchema = z.discriminatedUnion("decision", [
     ctx.addIssue({ code: "custom", path: ["blobRef", "contentType"], message: "blobRef contentType must equal mimeType" });
   }
 });
+var AgentHomeProjectionPayloadSchema = z.object({
+  requestId: z.uuid(),
+  agentRef: AgentHomeProjectionAgentRefSchema,
+  projectionHash: AgentHomeProjectionHashSchema,
+  projection: AgentHomeProjectionValueSchema
+}).strict();
 var TaskApprovePayloadSchema = z.object({
   approvalId: z.string().optional()
 });
@@ -561,10 +589,12 @@ var MESSAGE_PAYLOAD_SCHEMAS = {
   "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,
   "agent.egress.reliable": AgentEgressReliablePayloadSchema,
   "agent.egress.ack": AgentEgressAckPayloadSchema,
   "agent.content.read": AgentContentReadPayloadSchema,
   "agent.content.receipt": AgentContentReceiptPayloadSchema,
+  "agent.home.projection": AgentHomeProjectionPayloadSchema,
   "task.approve": TaskApprovePayloadSchema,
   "task.reject": TaskRejectPayloadSchema,
   "task.cancel": TaskCancelPayloadSchema,
@@ -587,8 +617,10 @@ var SERVER_TO_DAEMON_TYPES = [
   "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",
@@ -610,6 +642,7 @@ var DAEMON_TO_SERVER_TYPES = [
 ];
 var REQUIRED_TASK_ID = z.string().min(1);
 var OPTIONAL_TASK_ID = REQUIRED_TASK_ID.optional();
+var FORBIDDEN_TASK_ID = z.never().optional();
 var REQUIRED_SEQ = z.number().int();
 var OPTIONAL_SEQ = REQUIRED_SEQ.optional();
 function envelopeShape(type, taskId, seq) {
@@ -636,8 +669,10 @@ var EnvelopeSchema = z.discriminatedUnion("type", [
   envelopeShape("task.offer_with_toolsets", REQUIRED_TASK_ID, REQUIRED_SEQ),
   envelopeShape("task.offer_for_agent", REQUIRED_TASK_ID, REQUIRED_SEQ),
   envelopeShape("task.offer_for_agent_with_egress", REQUIRED_TASK_ID, REQUIRED_SEQ),
+  envelopeShape("task.offer_for_agent_with_egress_fresh", REQUIRED_TASK_ID, REQUIRED_SEQ),
   envelopeShape("agent.egress.ack", OPTIONAL_TASK_ID, REQUIRED_SEQ),
   envelopeShape("agent.content.read", OPTIONAL_TASK_ID, REQUIRED_SEQ),
+  envelopeShape("agent.home.projection", FORBIDDEN_TASK_ID, REQUIRED_SEQ),
   envelopeShape("task.approve", REQUIRED_TASK_ID, REQUIRED_SEQ),
   envelopeShape("task.reject", REQUIRED_TASK_ID, REQUIRED_SEQ),
   envelopeShape("task.cancel", REQUIRED_TASK_ID, REQUIRED_SEQ),
@@ -833,6 +868,28 @@ var MessagesSendResponseSchema = z.object({
   accepted: z.number().int().nonnegative(),
   rejected: z.number().int().nonnegative().optional()
 });
+var AgentHomeProjectionCompletionRequestSchema = z.object({
+  requestId: z.uuid(),
+  agentRef: AgentHomeProjectionAgentRefSchema,
+  projectionHash: AgentHomeProjectionHashSchema,
+  outcome: AgentHomeProjectionOutcomeSchema
+}).strict();
+var AgentHomeProjectionStatusSchema = z.enum([
+  "pending",
+  "applied",
+  "idempotent",
+  "stale",
+  "conflict"
+]);
+var AgentHomeProjectionReadbackSchema = z.object({
+  tenantId: z.string().min(1),
+  deviceId: z.string().min(1),
+  requestId: z.uuid(),
+  agentRef: AgentHomeProjectionAgentRefSchema,
+  projectionHash: AgentHomeProjectionHashSchema,
+  status: AgentHomeProjectionStatusSchema,
+  completedAt: z.iso.datetime({ offset: true }).optional()
+}).strict();
 var BYOK_WS_PATH = "/byok/ws";
 var BYOK_PAIR_PATH = "/byok/pair";
 var BYOK_CHALLENGE_PATH = "/byok/challenge";
@@ -840,6 +897,11 @@ var BYOK_TOKEN_PATH = "/byok/token";
 var BYOK_CAPABILITIES_PATH = "/byok/capabilities";
 var BYOK_EVENTS_PATH = "/byok/events";
 var BYOK_MESSAGES_PATH = "/byok/messages";
+var BYOK_AGENT_HOME_PROJECTIONS_PATH = "/byok/agent-home-projections";
+var BYOK_AGENT_HOME_PROJECTION_COMPLETION_ROUTE = "/byok/agent-home-projections/:requestId/completion";
+function byokAgentHomeProjectionCompletionPath(requestId) {
+  return `${BYOK_AGENT_HOME_PROJECTIONS_PATH}/${encodeURIComponent(requestId)}/completion`;
+}
 var BYOK_PRESENCE_PATH = "/byok/presence";
 var BYOK_ACTIVITY_PATH = "/byok/activity";
 var BYOK_BOARD_PATH = "/byok/board";
@@ -871,6 +933,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_POLICY_CAPABILITY, AGENT_EGRESS_RELIABLE_ACK_CAPABILITY, AGENT_REF_MAX_BYTES, AgentContentActorKindSchema, AgentContentActorSchema, AgentContentDecodeAsSchema, AgentContentMimeTypeSchema, AgentContentReadDecisionSchema, AgentContentReadDenialReasonSchema, AgentContentReadPayloadSchema, AgentContentReadSurfaceSchema, AgentContentReceiptPayloadSchema, AgentEgressAckPayloadSchema, AgentEgressActivityPolicySchema, AgentEgressContentHashSchema, AgentEgressDropReasonSchema, AgentEgressLaneSchema, AgentEgressPolicyRevisionSchema, AgentEgressPolicySchema, AgentEgressReliablePayloadSchema, AgentEventOrUnknownSchema, AgentEventSchema, AgentRefSchema, AgentReliableQuotaPolicySchema, BYOK_ACTIVITY_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, BYOK_WS_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, PairRequestSchema, PairResponseSchema, PairResponseTenantIdSchema, PermissionPolicySchema, PresencePublishRequestSchema, ProtocolError, ProtocolVersionNumberSchema, RESULT_DOCUMENT_MAX_BYTES, RequiredToolsetsSchema, RuntimeCapabilitiesSchema, RuntimeIdSchema, RuntimeInfoSchema, SERVER_TO_DAEMON_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, TaskApprovalResolvedPayloadSchema, TaskApprovePayloadSchema, TaskArtifactPayloadSchema, TaskAwaitApprovalPayloadSchema, TaskCancelPayloadSchema, TaskCancelledPayloadSchema, TaskClaimPayloadSchema, TaskCompletePayloadSchema, TaskDeclinePayloadSchema, TaskFailPayloadSchema, TaskOfferForAgentPayloadSchema, TaskOfferForAgentWithEgressPayloadSchema, TaskOfferPayloadSchema, TaskOfferWithToolsetsPayloadSchema, TaskProgressPayloadSchema, TaskRejectPayloadSchema, TaskStartedPayloadSchema, TaskSteerPayloadSchema, TerminalInferenceUsageSchema, TokenRequestSchema, TokenResponseSchema, ToolsetIdSchema, UnknownAgentEventSchema, UnknownMessageTypeError, 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_HOME_PROJECTION_CAPABILITY, AGENT_HOME_PROJECTION_MAX_BYTES, AGENT_HOME_PROJECTION_PROFILE_REVISION_MAXIMUM, 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, AgentRefSchema, AgentReliableQuotaPolicySchema, BYOK_ACTIVITY_PATH, BYOK_AGENT_HOME_PROJECTIONS_PATH, BYOK_AGENT_HOME_PROJECTION_COMPLETION_ROUTE, 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, BYOK_WS_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, PairRequestSchema, PairResponseSchema, PairResponseTenantIdSchema, PermissionPolicySchema, PresencePublishRequestSchema, ProtocolError, ProtocolVersionNumberSchema, RESULT_DOCUMENT_MAX_BYTES, RequiredToolsetsSchema, RuntimeCapabilitiesSchema, RuntimeIdSchema, RuntimeInfoSchema, SERVER_TO_DAEMON_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, TaskApprovalResolvedPayloadSchema, TaskApprovePayloadSchema, TaskArtifactPayloadSchema, TaskAwaitApprovalPayloadSchema, TaskCancelPayloadSchema, TaskCancelledPayloadSchema, TaskClaimPayloadSchema, TaskCompletePayloadSchema, TaskDeclinePayloadSchema, TaskFailPayloadSchema, TaskOfferForAgentPayloadSchema, TaskOfferForAgentWithEgressFreshPayloadSchema, TaskOfferForAgentWithEgressPayloadSchema, TaskOfferPayloadSchema, TaskOfferWithToolsetsPayloadSchema, TaskProgressPayloadSchema, TaskRejectPayloadSchema, TaskStartedPayloadSchema, TaskSteerPayloadSchema, TerminalInferenceUsageSchema, TokenRequestSchema, TokenResponseSchema, ToolsetIdSchema, UnknownAgentEventSchema, UnknownMessageTypeError, byokAgentHomeProjectionCompletionPath, byokBlobContentPath, byokBlobFinalizePath, byokBlobUrlPath, byokRecordPath, byokSkillPackFilePath, canTransition, checkResultDocument, createEnvelope, decodeEnvelope, encodeEnvelope, isKnownAgentEvent, isServerToDaemonType, parseMessage, partitionAgentEvents };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map