@byok-sdk/protocol 0.30.2 → 0.32.0

package/README.md

@@ -9,7 +9,7 @@ decimal `profileRevision`, SHA-256 `profileHash`, `modelId`, and bounded
 `requiredCapabilities`. Endpoint, auth configuration, and credential material
 remain outside the protocol.
 
-`TaskOfferPayload.dispatchSelection` is the optional strict dual-lane target
+An Agent offer's `dispatchSelection` is the optional strict dual-lane target
 contract: subscription selects Claude/Codex + model, while BYOK selects Pi +
 provider + model. When present it is authoritative and runtime disagreement
 fails closed. Servers send it only to a daemon advertising the

package/dist/agent-event.d.ts

@@ -122,9 +122,6 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"artifact">;
     name: z.ZodString;
     contentType: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"needs_approval">;
-    summary: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"turn_end">;
 }, z.core.$strip>, z.ZodObject<{
@@ -143,6 +140,7 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         estimate: "estimate";
         provider: "provider";
     }>>;
+    model: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">;
 export type AgentEvent = z.infer<typeof AgentEventSchema>;
 /**
@@ -264,9 +262,6 @@ export declare const AgentEventOrUnknownSchema: z.ZodUnion<readonly [z.ZodDiscri
     type: z.ZodLiteral<"artifact">;
     name: z.ZodString;
     contentType: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"needs_approval">;
-    summary: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"turn_end">;
 }, z.core.$strip>, z.ZodObject<{
@@ -285,6 +280,7 @@ export declare const AgentEventOrUnknownSchema: z.ZodUnion<readonly [z.ZodDiscri
         estimate: "estimate";
         provider: "provider";
     }>>;
+    model: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">, z.ZodObject<{
     type: z.ZodString;
 }, z.core.$loose>]>;

package/dist/agent-memory.d.ts

@@ -0,0 +1,79 @@
+/**
+ * `@byok-sdk/protocol/agent-memory` — the Host-side Agent memory contract that both
+ * `@byok-sdk/client` (the device) and `@byok-sdk/server/execution-core` (the Host)
+ * use: the file and export shapes, the model path policy, the Host transport and
+ * projection ports, and the memory error bases. It is zod-free so the embedded
+ * `@byok-sdk/client/agent-memory` entry stays schema-free, and it is its own entry
+ * so the error classes have one runtime definition.
+ */
+import type { AgentMemoryIntentCompletion, AgentMemoryIntentReservation } from './agent-memory-intent';
+import type { AgentMemoryProjectionMutation } from './agent-memory-projection';
+import type { AgentRef } from './messages';
+export declare class AgentMemoryError extends Error {
+    constructor(message: string);
+}
+/**
+ * Deterministic refusal: the same input against the same home state fails the
+ * same way on every retry (an invalid path, a forbidden delete, an oversized or
+ * non-UTF-8 file, a non-regular leaf, a platform without a secure backend).
+ */
+export declare class AgentMemoryValidationError extends AgentMemoryError {
+    constructor(message: string);
+}
+export interface AgentMemoryFile {
+    readonly path: string;
+    readonly revision: string;
+    readonly byteCount: number;
+    readonly content: string;
+}
+export interface AgentMemorySnapshot {
+    readonly files: readonly AgentMemoryFile[];
+    readonly totalBytes: number;
+}
+/** Raw local-only Host result. Never send this through the redacted projection port. */
+export interface AgentMemoryExport extends AgentMemorySnapshot {
+    /** Validated Host request, not proof of a globally current profile revision. */
+    readonly requestedAgentRef: AgentRef;
+    /** Present only when the home has a durable applied profile projection. */
+    readonly appliedProfileRevision?: string;
+    /** sha256 of UTF-8 JSON ["byok-agent-memory-export.v1", [[path, revision, byteCount], ...]]. */
+    readonly snapshotDigest: string;
+}
+/** Model input can name one allowed file, never a root, directory, glob, or internal SDK state. */
+export declare function validateAgentMemoryPath(value: unknown): string;
+/** Exactly what the daemon hands the Host transport for one fetch. */
+export interface AgentMemoryIntentFetchInput {
+    readonly intentId: string;
+    readonly agentRef: AgentRef;
+    /** `held`: a ledger slot is reserved; `none`: the Host must not release or change state. */
+    readonly reservation: AgentMemoryIntentReservation;
+}
+/**
+ * Host-injected transport for Host-approved Agent memory intents. The Host
+ * authenticates the device on its own routes; the SDK never sees an assertion.
+ *
+ * - `fetch` resolves with the Host's fetch answer (release / withheld /
+ *   terminal / deferred) for exactly this intent and reservation.
+ * - `complete` delivers one terminal completion and resolves with the Host's
+ *   DURABLE readback for it.
+ *
+ * Both answers are copied into inert plain data and strictly parsed. A throw
+ * from either is a transport failure: the notice is not acknowledged and a
+ * redelivery retries. Neither is ever called while the Agent home is leased.
+ */
+export interface AgentMemoryIntentTransport {
+    fetch(request: AgentMemoryIntentFetchInput): Promise<unknown>;
+    complete(completion: AgentMemoryIntentCompletion): Promise<unknown>;
+}
+/**
+ * Optional bridge to a complete hosted client. It receives the canonical,
+ * already-redacted protocol mutation only; the SDK intentionally owns no
+ * consent, cloud transport, or raw-source upload fallback.
+ */
+export interface AgentMemoryProjectionPort {
+    publish(input: Readonly<{
+        mutation: AgentMemoryProjectionMutation;
+    }>): Promise<{
+        readonly accepted: boolean;
+    }>;
+}

package/dist/agent-memory.js

@@ -0,0 +1,5 @@
+var AgentMemoryError=class extends Error{constructor(message){super(message);this.name="AgentMemoryError";}};var AgentMemoryValidationError=class extends AgentMemoryError{constructor(message){super(message);this.name="AgentMemoryValidationError";}};var SAFE_SEGMENT=/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;var WINDOWS_ALIAS=/^(?:con|prn|aux|nul|com\d|lpt\d)(?:\.|$)|\.$/iu;var SECRET_LIKE=/(?:^|[-_.])(secret|token|credential|password|passwd|api[-_]?key|private[-_]?key|cookie)(?:$|[-_.])/iu;function safeSegment(value){return SAFE_SEGMENT.test(value)&&!WINDOWS_ALIAS.test(value)}function validateAgentMemoryPath(value){if(typeof value!=="string"||value.length===0||value.length>1024||/[\u0000\\]/u.test(value))throw new AgentMemoryValidationError("memory path is invalid");if(value==="MEMORY.md")return value;if(value.startsWith("/")||/[*?\[{]/u.test(value))throw new AgentMemoryValidationError("memory path must name exactly one file");const parts=value.split("/");if(parts.length<2||parts[0]!=="notes"||!value.endsWith(".md")||parts.some(part=>part===""||part==="."||part===".."||part===".byok"||!safeSegment(part)||SECRET_LIKE.test(part))){throw new AgentMemoryValidationError("memory path must be MEMORY.md or notes/<safe-relative>.md")}return value}
+
+export { AgentMemoryError, AgentMemoryValidationError, validateAgentMemoryPath };
+//# sourceMappingURL=agent-memory.js.map
+//# sourceMappingURL=agent-memory.js.map

package/dist/agent-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-memory.ts"],"names":[],"mappings":"AAYO,IAAM,gBAAA,CAAN,cAA+B,KAAM,CAC1C,YAAY,OAAA,CAAiB,CAAE,KAAA,CAAM,OAAO,CAAA,CAAG,IAAA,CAAK,IAAA,CAAO,mBAAoB,CACjF,EAMO,IAAM,0BAAA,CAAN,cAAyC,gBAAiB,CAC/D,WAAA,CAAY,OAAA,CAAiB,CAAE,KAAA,CAAM,OAAO,CAAA,CAAG,IAAA,CAAK,KAAO,6BAA8B,CAC3F,EAeA,IAAM,aAAe,qCAAA,CAGrB,IAAM,aAAA,CAAgB,gDAAA,CACtB,IAAM,WAAA,CAAc,sGAAA,CACpB,SAAS,YAAY,KAAA,CAAwB,CAAE,OAAO,YAAA,CAAa,IAAA,CAAK,KAAK,CAAA,EAAK,CAAC,cAAc,IAAA,CAAK,KAAK,CAAG,CAGvG,SAAS,uBAAA,CAAwB,KAAA,CAAwB,CAC9D,GAAI,OAAO,KAAA,GAAU,QAAA,EAAY,KAAA,CAAM,SAAW,CAAA,EAAK,KAAA,CAAM,MAAA,CAAS,IAAA,EAAQ,cAAc,IAAA,CAAK,KAAK,CAAA,CAAG,MAAM,IAAI,0BAAA,CAA2B,wBAAwB,CAAA,CACtK,GAAI,KAAA,GAAU,WAAA,CAAa,OAAO,KAAA,CAElC,GAAI,KAAA,CAAM,UAAA,CAAW,GAAG,GAAK,UAAA,CAAW,IAAA,CAAK,KAAK,CAAA,CAAG,MAAM,IAAI,0BAAA,CAA2B,wCAAwC,EAClI,MAAM,KAAA,CAAQ,KAAA,CAAM,KAAA,CAAM,GAAG,CAAA,CAC7B,GAAI,KAAA,CAAM,MAAA,CAAS,GAAK,KAAA,CAAM,CAAC,CAAA,GAAM,OAAA,EAAW,CAAC,KAAA,CAAM,QAAA,CAAS,KAAK,GAAK,KAAA,CAAM,IAAA,CAAM,IAAA,EAAS,IAAA,GAAS,EAAA,EAAM,IAAA,GAAS,GAAA,EAAO,IAAA,GAAS,MAAQ,IAAA,GAAS,OAAA,EAAW,CAAC,WAAA,CAAY,IAAI,CAAA,EAAK,WAAA,CAAY,IAAA,CAAK,IAAI,CAAC,CAAA,CAAG,CAChN,MAAM,IAAI,0BAAA,CAA2B,2DAA2D,CAClG,CACA,OAAO,KACT","file":"agent-memory.js","sourcesContent":["/**\n * `@byok-sdk/protocol/agent-memory` — the Host-side Agent memory contract that both\n * `@byok-sdk/client` (the device) and `@byok-sdk/server/execution-core` (the Host)\n * use: the file and export shapes, the model path policy, the Host transport and\n * projection ports, and the memory error bases. It is zod-free so the embedded\n * `@byok-sdk/client/agent-memory` entry stays schema-free, and it is its own entry\n * so the error classes have one runtime definition.\n */\nimport type { AgentMemoryIntentCompletion, AgentMemoryIntentReservation } from './agent-memory-intent';\nimport type { AgentMemoryProjectionMutation } from './agent-memory-projection';\nimport type { AgentRef } from './messages';\n\nexport class AgentMemoryError extends Error {\n  constructor(message: string) { super(message); this.name = 'AgentMemoryError'; }\n}\n/**\n * Deterministic refusal: the same input against the same home state fails the\n * same way on every retry (an invalid path, a forbidden delete, an oversized or\n * non-UTF-8 file, a non-regular leaf, a platform without a secure backend).\n */\nexport class AgentMemoryValidationError extends AgentMemoryError {\n  constructor(message: string) { super(message); this.name = 'AgentMemoryValidationError'; }\n}\n\nexport interface AgentMemoryFile { readonly path: string; readonly revision: string; readonly byteCount: number; readonly content: string; }\nexport interface AgentMemorySnapshot { readonly files: readonly AgentMemoryFile[]; readonly totalBytes: number; }\n\n/** Raw local-only Host result. Never send this through the redacted projection port. */\nexport interface AgentMemoryExport extends AgentMemorySnapshot {\n  /** Validated Host request, not proof of a globally current profile revision. */\n  readonly requestedAgentRef: AgentRef;\n  /** Present only when the home has a durable applied profile projection. */\n  readonly appliedProfileRevision?: string;\n  /** sha256 of UTF-8 JSON [\"byok-agent-memory-export.v1\", [[path, revision, byteCount], ...]]. */\n  readonly snapshotDigest: string;\n}\n\nconst SAFE_SEGMENT = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;\n// Windows maps a device name, with or without an extension, and a name that\n// ends in a dot to another name. Every platform refuses them.\nconst WINDOWS_ALIAS = /^(?:con|prn|aux|nul|com\\d|lpt\\d)(?:\\.|$)|\\.$/iu;\nconst SECRET_LIKE = /(?:^|[-_.])(secret|token|credential|password|passwd|api[-_]?key|private[-_]?key|cookie)(?:$|[-_.])/iu;\nfunction safeSegment(value: string): boolean { return SAFE_SEGMENT.test(value) && !WINDOWS_ALIAS.test(value); }\n\n/** Model input can name one allowed file, never a root, directory, glob, or internal SDK state. */\nexport function validateAgentMemoryPath(value: unknown): string {\n  if (typeof value !== 'string' || value.length === 0 || value.length > 1024 || /[\\u0000\\\\]/u.test(value)) throw new AgentMemoryValidationError('memory path is invalid');\n  if (value === 'MEMORY.md') return value;\n  // POSIX absoluteness is exactly a leading '/'; backslashes were refused above.\n  if (value.startsWith('/') || /[*?\\[{]/u.test(value)) throw new AgentMemoryValidationError('memory path must name exactly one file');\n  const parts = value.split('/');\n  if (parts.length < 2 || parts[0] !== 'notes' || !value.endsWith('.md') || parts.some((part) => part === '' || part === '.' || part === '..' || part === '.byok' || !safeSegment(part) || SECRET_LIKE.test(part))) {\n    throw new AgentMemoryValidationError('memory path must be MEMORY.md or notes/<safe-relative>.md');\n  }\n  return value;\n}\n\n/** Exactly what the daemon hands the Host transport for one fetch. */\nexport interface AgentMemoryIntentFetchInput {\n  readonly intentId: string;\n  readonly agentRef: AgentRef;\n  /** `held`: a ledger slot is reserved; `none`: the Host must not release or change state. */\n  readonly reservation: AgentMemoryIntentReservation;\n}\n\n/**\n * Host-injected transport for Host-approved Agent memory intents. The Host\n * authenticates the device on its own routes; the SDK never sees an assertion.\n *\n * - `fetch` resolves with the Host's fetch answer (release / withheld /\n *   terminal / deferred) for exactly this intent and reservation.\n * - `complete` delivers one terminal completion and resolves with the Host's\n *   DURABLE readback for it.\n *\n * Both answers are copied into inert plain data and strictly parsed. A throw\n * from either is a transport failure: the notice is not acknowledged and a\n * redelivery retries. Neither is ever called while the Agent home is leased.\n */\nexport interface AgentMemoryIntentTransport {\n  fetch(request: AgentMemoryIntentFetchInput): Promise<unknown>;\n  complete(completion: AgentMemoryIntentCompletion): Promise<unknown>;\n}\n\n/**\n * Optional bridge to a complete hosted client. It receives the canonical,\n * already-redacted protocol mutation only; the SDK intentionally owns no\n * consent, cloud transport, or raw-source upload fallback.\n */\nexport interface AgentMemoryProjectionPort {\n  publish(input: Readonly<{ mutation: AgentMemoryProjectionMutation }>): Promise<{ readonly accepted: boolean }>;\n}\n"]}

package/dist/capability-constants.d.ts

@@ -60,6 +60,15 @@ export declare const SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY: 'sealed-output-cip
  * machine-readable runtime failure class (#869).
  */
 export declare const RUNTIME_FAILURE_CLASS_CAPABILITY: 'runtime-failure-class';
+/**
+ * The connection understands the typed pre-claim runtime-unavailable cause
+ * (#1103 D8): `task.decline.runtimeUnavailable`, `conn.hello.runtimeUnavailable`
+ * and the presence projection. A daemon declares it when it emits the cause.
+ * Older peers ignore the unknown flag; absence means the peer may not read
+ * the cause, so a Host falls back to `retryable` and treats the cause as
+ * unknown. It never infers availability or allow from absence.
+ */
+export declare const RUNTIME_UNAVAILABLE_CAUSE_CAPABILITY: 'runtime-unavailable-cause';
 /**
  * The closed classes of `task.fail.failure.class`: the vendored OAR
  * `FailureClass` values. `unknown` means the runtime gave no structured

package/dist/codec.d.ts

@@ -22,50 +22,14 @@ interface EnvelopeShapeOptions {
         taskId?: string;
         seq?: number;
     };
-    'conn.ack': {
-        taskId?: string;
-        seq: number;
-    };
     'task.offer': {
         taskId: string;
         seq: number;
     };
-    'task.offer_with_toolsets': {
-        taskId: string;
-        seq: number;
-    };
-    'task.offer_for_agent': {
-        taskId: string;
-        seq: number;
-    };
-    'task.offer_for_agent_with_egress': {
-        taskId: string;
-        seq: number;
-    };
-    'task.offer_for_agent_with_egress_fresh': {
-        taskId: string;
-        seq: number;
-    };
-    'task.offer_prepared': {
-        taskId: string;
-        seq: number;
-    };
-    'agent.egress.reliable': {
-        taskId?: string;
-        seq?: number;
-    };
     'agent.egress.ack': {
         taskId?: string;
         seq: number;
     };
-    'agent.message.draft': {
-        taskId: string;
-        seq?: number;
-    };
-    'agent.message.publish': {
-        taskId: string;
-        seq?: number;
-    };
     'agent.message.disposition': {
         taskId: string;
         seq: number;
@@ -90,14 +54,6 @@ interface EnvelopeShapeOptions {
         taskId?: never;
         seq: number;
     };
-    'e2ee.key_package.available': {
-        taskId?: never;
-        seq: number;
-    };
-    'agent.content.receipt': {
-        taskId?: string;
-        seq?: number;
-    };
     'task.approve': {
         taskId: string;
         seq: number;
@@ -114,6 +70,10 @@ interface EnvelopeShapeOptions {
         taskId: string;
         seq: number;
     };
+    'e2ee.key_package.available': {
+        taskId?: never;
+        seq: number;
+    };
     'task.claim': {
         taskId: string;
         seq?: number;
@@ -154,56 +114,20 @@ interface EnvelopeShapeOptions {
         taskId: string;
         seq?: number;
     };
-    'task.offer_sealed': {
-        taskId: string;
-        seq: number;
-    };
-    'task.offer_with_toolsets_sealed': {
-        taskId: string;
-        seq: number;
-    };
-    'task.offer_for_agent_sealed': {
-        taskId: string;
-        seq: number;
-    };
-    'task.offer_for_agent_with_egress_sealed': {
-        taskId: string;
-        seq: number;
-    };
-    'task.offer_for_agent_with_egress_fresh_sealed': {
-        taskId: string;
-        seq: number;
-    };
-    'task.steer_sealed': {
-        taskId: string;
-        seq: number;
-    };
-    'task.complete_sealed': {
-        taskId: string;
-        seq?: number;
-    };
-    'task.fail_sealed': {
-        taskId: string;
-        seq?: number;
-    };
-    'task.decline_sealed': {
-        taskId: string;
-        seq?: number;
-    };
-    'task.cancelled_sealed': {
-        taskId: string;
+    'agent.egress.reliable': {
+        taskId?: string;
         seq?: number;
     };
-    'task.progress_sealed': {
+    'agent.message.draft': {
         taskId: string;
         seq?: number;
     };
-    'task.artifact_sealed': {
+    'agent.message.publish': {
         taskId: string;
         seq?: number;
     };
-    'task.await_approval_sealed': {
-        taskId: string;
+    'agent.content.receipt': {
+        taskId?: string;
         seq?: number;
     };
 }

package/dist/constants.d.ts

@@ -2,9 +2,23 @@
 export * from './version';
 export * from './task-state';
 export * from './capability-constants';
+export * from './failure-reason';
 /** Maximum raw UTF-8 content bytes in one local Host Agent-memory export; no truncation. */
 export declare const AGENT_MEMORY_MAX_SNAPSHOT_BYTES: number;
 /** Maximum memory files in one local Host export, including MEMORY.md. */
 export declare const AGENT_MEMORY_MAX_SNAPSHOT_FILES = 128;
 /** The frozen wire runtime ids. Any other adapter id is a custom harness (`harnessId`). */
 export declare const RUNTIME_IDS: readonly ["pi", "claude", "codex"];
+/**
+ * Why a runtime is unavailable before claim (#1103 D6). Append-only: a cause is
+ * never renamed, removed or given a new meaning. The wire reads an unknown
+ * well-formed token as `unknown` and keeps it verbatim (#1121), so a newer
+ * device can add one without a protocol bump. Names are snake_case, unlike the
+ * kebab-case detection kinds, because the mapping is explicit and never a
+ * string transformation.
+ */
+export declare const RUNTIME_UNAVAILABLE_CAUSES: readonly ["not_installed", "not_executable", "probe_timeout", "probe_failed", "app_server_unavailable", "acp_unavailable", "platform_unsupported", "environment_unavailable", "version_blocked", "runtime_not_configured", "runtime_not_allowed", "none_available"];
+/** One append-only `runtime_unavailable` cause. */
+export type RuntimeUnavailableCause = (typeof RUNTIME_UNAVAILABLE_CAUSES)[number];
+/** Maximum length of a served model name. */
+export declare const TERMINAL_INFERENCE_USAGE_MODEL_MAX_LENGTH = 160;

package/dist/constants.js

@@ -1,117 +1,5 @@
-// src/capability-constants.ts
-var INPUT_PREPARATION_WIRE_VERSION = 9;
-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_MESSAGE_EGRESS_CAPABILITY = "agent-message-egress";
-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";
-var AGENT_HOME_PROJECTION_CAPABILITY = "agent-home-projection";
-var TERMINAL_PROJECTION_SELECTION_CAPABILITY = "terminal-projection-selection";
-var HOST_MCP_TASK_CONTEXT_CAPABILITY = "host-mcp-task-context";
-var PROVIDER_PROFILE_BINDING_CAPABILITY = "provider-profile-binding";
-var PROVIDER_PROVISIONING_CAPABILITY = "provider-provisioning.v1";
-var AGENT_MEMORY_INTENT_CAPABILITY = "agent-memory-intent.v1";
-var AGENT_MEMORY_PROJECTION_CAPABILITY = "agent.memory.projection";
-var AGENT_MEMORY_SELECTION_CAPABILITY = "agent-memory-selection";
-var AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY = "agent-memory-read-if-admitted";
-var AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY = "agent-memory-read-write-if-admitted";
-var AGENT_INPUT_PREPARATION_CAPABILITY = `agent-input-preparation-v${INPUT_PREPARATION_WIRE_VERSION}`;
-var SEALED_PAYLOAD_CAPABILITY = "sealed-payload-v1";
-var SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY = "sealed-output-ciphertext-ref";
-var RUNTIME_FAILURE_CLASS_CAPABILITY = "runtime-failure-class";
-var RUNTIME_FAILURE_CLASSES = [
-  "auth",
-  "quota",
-  "rate_limited",
-  "billing",
-  "model_unavailable",
-  "input_too_large",
-  "invalid_request",
-  "overloaded",
-  "provider",
-  "runtime_exited",
-  "limit_reached",
-  "output_schema",
-  "unknown"
-];
-var PREPARED_AGENT_MEMORY_MODES = ["none", "read", "read-write"];
-function isPreparedAgentMemoryMode(value) {
-  return typeof value === "string" && PREPARED_AGENT_MEMORY_MODES.some((mode) => mode === value);
-}
+var INPUT_PREPARATION_WIRE_VERSION=9;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_MESSAGE_EGRESS_CAPABILITY="agent-message-egress";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";var AGENT_HOME_PROJECTION_CAPABILITY="agent-home-projection";var TERMINAL_PROJECTION_SELECTION_CAPABILITY="terminal-projection-selection";var HOST_MCP_TASK_CONTEXT_CAPABILITY="host-mcp-task-context";var PROVIDER_PROFILE_BINDING_CAPABILITY="provider-profile-binding";var PROVIDER_PROVISIONING_CAPABILITY="provider-provisioning.v1";var AGENT_MEMORY_INTENT_CAPABILITY="agent-memory-intent.v1";var AGENT_MEMORY_PROJECTION_CAPABILITY="agent.memory.projection";var AGENT_MEMORY_SELECTION_CAPABILITY="agent-memory-selection";var AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY="agent-memory-read-if-admitted";var AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY="agent-memory-read-write-if-admitted";var AGENT_INPUT_PREPARATION_CAPABILITY=`agent-input-preparation-v${INPUT_PREPARATION_WIRE_VERSION}`;var SEALED_PAYLOAD_CAPABILITY="sealed-payload-v1";var SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY="sealed-output-ciphertext-ref";var RUNTIME_FAILURE_CLASS_CAPABILITY="runtime-failure-class";var RUNTIME_UNAVAILABLE_CAUSE_CAPABILITY="runtime-unavailable-cause";var RUNTIME_FAILURE_CLASSES=["auth","quota","rate_limited","billing","model_unavailable","input_too_large","invalid_request","overloaded","provider","runtime_exited","limit_reached","output_schema","unknown"];var PREPARED_AGENT_MEMORY_MODES=["none","read","read-write"];function isPreparedAgentMemoryMode(value){return typeof value==="string"&&PREPARED_AGENT_MEMORY_MODES.some(mode=>mode===value)}var MAILBOX_READ_AHEAD_MAX_SEQS=4096;var MAILBOX_READ_AHEAD_CAPABILITY="mailbox-read-ahead";var PROTOCOL_VERSION=4;var AGENT_HOME_READERS_CAPABILITY="agent-home-readers";var CUSTOM_HARNESS_CAPABILITY="custom-harness";var CAPABILITY_FLAGS=["steer","blob-upload","dispatch-selection",PROVIDER_PROFILE_BINDING_CAPABILITY,"toolset-selection","agent-home-contract",AGENT_HOME_READERS_CAPABILITY,AGENT_EGRESS_POLICY_CAPABILITY,AGENT_EGRESS_RELIABLE_ACK_CAPABILITY,AGENT_MESSAGE_EGRESS_CAPABILITY,AGENT_EGRESS_FRESH_SESSION_CAPABILITY,AGENT_CONTENT_WORKSPACE_READ_CAPABILITY,AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY,AGENT_CONTENT_ARTIFACT_READ_CAPABILITY,AGENT_HOME_PROJECTION_CAPABILITY,AGENT_INPUT_PREPARATION_CAPABILITY,TERMINAL_PROJECTION_SELECTION_CAPABILITY,HOST_MCP_TASK_CONTEXT_CAPABILITY,CUSTOM_HARNESS_CAPABILITY,MAILBOX_READ_AHEAD_CAPABILITY,PROVIDER_PROVISIONING_CAPABILITY,AGENT_MEMORY_INTENT_CAPABILITY,AGENT_MEMORY_SELECTION_CAPABILITY,AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY,AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY,"agent-message-draft",SEALED_PAYLOAD_CAPABILITY,SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY,RUNTIME_FAILURE_CLASS_CAPABILITY,RUNTIME_UNAVAILABLE_CAUSE_CAPABILITY];var TASK_STATES=["Offered","Claimed","Running","AwaitApproval","Complete","Failed","Cancelled"];var TASK_TRANSITIONS={Offered:["Claimed","Cancelled","Failed"],Claimed:["Running","Failed","Cancelled"],Running:["AwaitApproval","Complete","Failed","Cancelled"],AwaitApproval:["Running","Failed","Cancelled"],Complete:[],Failed:[],Cancelled:[]};function canTransition(from,to){return TASK_TRANSITIONS[from].includes(to)}var TASK_FAIL_REASON_MAX_BYTES=2048;var REDACTED="[redacted]";var VALUE=String.raw`(?:"(?:\\[^\n]|[^"\\\n])*(?:\\)?"?|'(?:\\[^\n]|[^'\\\n])*(?:\\)?'?|[^\s"'\[\u2026,;&|][^\s"',;&|]*)`;var GAP="[ \\t]{0,16}";var RULES=[[new RegExp(String.raw`\b((?:proxy-)?authorization)(["']?${GAP}[:=]${GAP})(?:(?:bearer|basic|token|digest)[ \t]{1,16})?${VALUE}`,"gi"),`$1$2${REDACTED}`],[/\b(bearer)[ \t]{1,16}[A-Za-z0-9._~+/=-]{8,}/gi,`$1 ${REDACTED}`],[new RegExp(String.raw`(key|token|secret|passw(?:or)?d[\w.-]{0,64})(["']?${GAP}[:=]${GAP})${VALUE}`,"gi"),`$1$2${REDACTED}`],[/:\/\/[^\s/?#@]{1,256}@/g,`://${REDACTED}@`],[/\bsk-[A-Za-z0-9_-]{16,}/g,REDACTED],[/\bxai-[A-Za-z0-9_-]{16,}/g,REDACTED],[/\bAIza[0-9A-Za-z_-]{30,}/g,REDACTED],[/\bgh[pousr]_[A-Za-z0-9]{20,}/g,REDACTED],[/\bgithub_pat_[A-Za-z0-9_]{20,}/g,REDACTED],[/\bAKIA[0-9A-Z]{16}/g,REDACTED],[/\beyJ[A-Za-z0-9_-]{10,}(?:\.[A-Za-z0-9_-]*){0,2}/g,REDACTED]];var encoder=new TextEncoder;var decoder=new TextDecoder("utf-8");function redact(text){let out=text;for(const[pattern,replacement]of RULES)out=out.replace(pattern,replacement);return out}function boundFailureReason(reason){const redacted=redact(reason);const bytes=encoder.encode(redacted);if(bytes.length<=TASK_FAIL_REASON_MAX_BYTES)return redacted;let keep=TASK_FAIL_REASON_MAX_BYTES-encoder.encode(`\u2026[truncated ${bytes.length} bytes]`).length;while(keep>0&&((bytes[keep]??0)&192)===128)keep-=1;return `${decoder.decode(bytes.subarray(0,keep))}\u2026[truncated ${bytes.length-keep} bytes]`}var AGENT_MEMORY_MAX_SNAPSHOT_BYTES=1024*1024;var AGENT_MEMORY_MAX_SNAPSHOT_FILES=128;var RUNTIME_IDS=Object.freeze(["pi","claude","codex"]);var RUNTIME_UNAVAILABLE_CAUSES=Object.freeze(["not_installed","not_executable","probe_timeout","probe_failed","app_server_unavailable","acp_unavailable","platform_unsupported","environment_unavailable","version_blocked","runtime_not_configured","runtime_not_allowed","none_available"]);var TERMINAL_INFERENCE_USAGE_MODEL_MAX_LENGTH=160;
 
-// src/version.ts
-var MAILBOX_READ_AHEAD_MAX_SEQS = 4096;
-var MAILBOX_READ_AHEAD_CAPABILITY = "mailbox-read-ahead";
-var PROTOCOL_VERSION = 3;
-var STRICT_AGENT_ONLY_CAPABILITY = "strict-agent-only";
-var AGENT_HOME_READERS_CAPABILITY = "agent-home-readers";
-var CUSTOM_HARNESS_CAPABILITY = "custom-harness";
-var CAPABILITY_FLAGS = [
-  "steer",
-  "blob-upload",
-  "interactive-approval",
-  "approval_resolved",
-  "approval-targeting",
-  "dispatch-selection",
-  PROVIDER_PROFILE_BINDING_CAPABILITY,
-  "toolset-selection",
-  "agent-home-contract",
-  AGENT_HOME_READERS_CAPABILITY,
-  STRICT_AGENT_ONLY_CAPABILITY,
-  AGENT_EGRESS_POLICY_CAPABILITY,
-  AGENT_EGRESS_RELIABLE_ACK_CAPABILITY,
-  AGENT_MESSAGE_EGRESS_CAPABILITY,
-  AGENT_EGRESS_FRESH_SESSION_CAPABILITY,
-  AGENT_CONTENT_WORKSPACE_READ_CAPABILITY,
-  AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY,
-  AGENT_CONTENT_ARTIFACT_READ_CAPABILITY,
-  AGENT_HOME_PROJECTION_CAPABILITY,
-  AGENT_INPUT_PREPARATION_CAPABILITY,
-  TERMINAL_PROJECTION_SELECTION_CAPABILITY,
-  HOST_MCP_TASK_CONTEXT_CAPABILITY,
-  CUSTOM_HARNESS_CAPABILITY,
-  MAILBOX_READ_AHEAD_CAPABILITY,
-  PROVIDER_PROVISIONING_CAPABILITY,
-  AGENT_MEMORY_INTENT_CAPABILITY,
-  AGENT_MEMORY_SELECTION_CAPABILITY,
-  AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY,
-  AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY,
-  "agent-message-draft",
-  SEALED_PAYLOAD_CAPABILITY,
-  SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY,
-  RUNTIME_FAILURE_CLASS_CAPABILITY
-];
-
-// src/task-state.ts
-var TASK_STATES = [
-  "Offered",
-  "Claimed",
-  "Running",
-  "AwaitApproval",
-  "Complete",
-  "Failed",
-  "Cancelled"
-];
-var TASK_TRANSITIONS = {
-  Offered: ["Claimed", "Cancelled", "Failed"],
-  Claimed: ["Running", "Failed", "Cancelled"],
-  Running: ["AwaitApproval", "Complete", "Failed", "Cancelled"],
-  AwaitApproval: ["Running", "Failed", "Cancelled"],
-  Complete: [],
-  Failed: [],
-  Cancelled: []
-};
-function canTransition(from, to) {
-  return TASK_TRANSITIONS[from].includes(to);
-}
-
-// src/constants.ts
-var AGENT_MEMORY_MAX_SNAPSHOT_BYTES = 1024 * 1024;
-var AGENT_MEMORY_MAX_SNAPSHOT_FILES = 128;
-var RUNTIME_IDS = Object.freeze(["pi", "claude", "codex"]);
-
-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_READERS_CAPABILITY, AGENT_INPUT_PREPARATION_CAPABILITY, AGENT_MEMORY_INTENT_CAPABILITY, AGENT_MEMORY_MAX_SNAPSHOT_BYTES, AGENT_MEMORY_MAX_SNAPSHOT_FILES, AGENT_MEMORY_PROJECTION_CAPABILITY, AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY, AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY, AGENT_MEMORY_SELECTION_CAPABILITY, AGENT_MESSAGE_EGRESS_CAPABILITY, CAPABILITY_FLAGS, CUSTOM_HARNESS_CAPABILITY, HOST_MCP_TASK_CONTEXT_CAPABILITY, INPUT_PREPARATION_WIRE_VERSION, MAILBOX_READ_AHEAD_CAPABILITY, MAILBOX_READ_AHEAD_MAX_SEQS, PREPARED_AGENT_MEMORY_MODES, PROTOCOL_VERSION, PROVIDER_PROFILE_BINDING_CAPABILITY, PROVIDER_PROVISIONING_CAPABILITY, RUNTIME_FAILURE_CLASSES, RUNTIME_FAILURE_CLASS_CAPABILITY, RUNTIME_IDS, SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY, SEALED_PAYLOAD_CAPABILITY, STRICT_AGENT_ONLY_CAPABILITY, TASK_STATES, TASK_TRANSITIONS, TERMINAL_PROJECTION_SELECTION_CAPABILITY, canTransition, isPreparedAgentMemoryMode };
+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_READERS_CAPABILITY, AGENT_INPUT_PREPARATION_CAPABILITY, AGENT_MEMORY_INTENT_CAPABILITY, AGENT_MEMORY_MAX_SNAPSHOT_BYTES, AGENT_MEMORY_MAX_SNAPSHOT_FILES, AGENT_MEMORY_PROJECTION_CAPABILITY, AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY, AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY, AGENT_MEMORY_SELECTION_CAPABILITY, AGENT_MESSAGE_EGRESS_CAPABILITY, CAPABILITY_FLAGS, CUSTOM_HARNESS_CAPABILITY, HOST_MCP_TASK_CONTEXT_CAPABILITY, INPUT_PREPARATION_WIRE_VERSION, MAILBOX_READ_AHEAD_CAPABILITY, MAILBOX_READ_AHEAD_MAX_SEQS, PREPARED_AGENT_MEMORY_MODES, PROTOCOL_VERSION, PROVIDER_PROFILE_BINDING_CAPABILITY, PROVIDER_PROVISIONING_CAPABILITY, RUNTIME_FAILURE_CLASSES, RUNTIME_FAILURE_CLASS_CAPABILITY, RUNTIME_IDS, RUNTIME_UNAVAILABLE_CAUSES, RUNTIME_UNAVAILABLE_CAUSE_CAPABILITY, SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY, SEALED_PAYLOAD_CAPABILITY, TASK_FAIL_REASON_MAX_BYTES, TASK_STATES, TASK_TRANSITIONS, TERMINAL_INFERENCE_USAGE_MODEL_MAX_LENGTH, TERMINAL_PROJECTION_SELECTION_CAPABILITY, boundFailureReason, canTransition, isPreparedAgentMemoryMode };
 //# sourceMappingURL=constants.js.map
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/capability-constants.ts","../src/version.ts","../src/task-state.ts","../src/constants.ts"],"names":[],"mappings":"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","file":"constants.js","sourcesContent":["/**\n * The ONE version of the input-preparation contract, shared by this relay wire\n * (the `agent.input.preparation` payload and the completion receipt summary)\n * and by the device-local request, receipt and artifact\n * (`@byok-sdk/client`'s `INPUT_PREPARATION_VERSION`, which is this value).\n *\n * The relay wire carries no version field of its own, so a version change is\n * made visible where admission actually happens: in the capability token\n * below. See `INPUT_PREPARATION_VERSION` in the client for what each version\n * changed.\n */\nexport const INPUT_PREPARATION_WIRE_VERSION = 9 as const;\n\n\n/** Additive daemon capability names. Server/cloud admission consumes these exactly. */\nexport const AGENT_EGRESS_POLICY_CAPABILITY = 'agent-egress-policy' as const;\n\nexport const AGENT_EGRESS_RELIABLE_ACK_CAPABILITY = 'agent-egress-reliable-ack' as const;\n\n/** Admits the distinct offer whose runtime mints its session only after start. */\nexport const AGENT_EGRESS_FRESH_SESSION_CAPABILITY = 'agent-egress-fresh-session' as const;\n\n/** Admits the distinct Agent-authored message lane; activity policy remains independent. */\nexport const AGENT_MESSAGE_EGRESS_CAPABILITY = 'agent-message-egress' as const;\n\nexport const AGENT_CONTENT_WORKSPACE_READ_CAPABILITY = 'agent-content-workspace-read' as const;\n\nexport const AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY = 'agent-content-transcript-read' as const;\n\nexport const AGENT_CONTENT_ARTIFACT_READ_CAPABILITY = 'agent-content-artifact-read' as const;\n\n/** Capability required before a task-free Agent-home projection is admitted. */\nexport const AGENT_HOME_PROJECTION_CAPABILITY = 'agent-home-projection' as const;\n\n/** Capability required before an offer may select terminal projection behavior. */\nexport const TERMINAL_PROJECTION_SELECTION_CAPABILITY = 'terminal-projection-selection' as const;\n\n/** Contract §8.1's capability gate for `byok-task-assertion-v1` tool authority. */\nexport const HOST_MCP_TASK_CONTEXT_CAPABILITY = 'host-mcp-task-context' as const;\n\n/** Daemon capability required before an exact local provider profile may be offered. */\nexport const PROVIDER_PROFILE_BINDING_CAPABILITY = 'provider-profile-binding' as const;\n\n/** Device capability required before a Host may enqueue `provider.provisioning.available`. */\nexport const PROVIDER_PROVISIONING_CAPABILITY = 'provider-provisioning.v1' as const;\n\n/** Device capability required before a Host may enqueue `agent.memory.intent.available`. */\nexport const AGENT_MEMORY_INTENT_CAPABILITY = 'agent-memory-intent.v1' as const;\n\n/** Capability required before the optional hosted Agent-memory projection can be used. */\nexport const AGENT_MEMORY_PROJECTION_CAPABILITY = 'agent.memory.projection' as const;\n\n/** Device capability required before an ordinary Agent offer may carry `agentMemory`. */\nexport const AGENT_MEMORY_SELECTION_CAPABILITY = 'agent-memory-selection' as const;\n\n/** Device capability required before an ordinary Agent offer may carry `agentMemory: 'read-if-admitted'`. */\nexport const AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY = 'agent-memory-read-if-admitted' as const;\n\n/** Device capability required before an ordinary Agent offer may carry `agentMemory: 'read-write-if-admitted'`. */\nexport const AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY = 'agent-memory-read-write-if-admitted' as const;\n\n/** Exact capability of the single input-preparation wire authority. */\nexport const AGENT_INPUT_PREPARATION_CAPABILITY =\n  `agent-input-preparation-v${INPUT_PREPARATION_WIRE_VERSION}` as const;\n\n/**\n * Sealed payload v1 (#654). A device advertises it before a Host may send it\n * a sealed offer or steer; a server advertises it before a device may send it\n * sealed task output or a sealed decline code. Both gates read\n * `WIRE_ADDITIONS`.\n */\nexport const SEALED_PAYLOAD_CAPABILITY = 'sealed-payload-v1' as const;\n\n/**\n * A server advertises it before a device may send a sealed task output that\n * names its ciphertext blob (`sealed.ciphertextRef`) instead of carrying it\n * inline. The server then holds the blob for the life of the task.\n */\nexport const SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY = 'sealed-output-ciphertext-ref' as const;\n\n/**\n * A server advertises it before a device may send `task.fail.failure`, the\n * machine-readable runtime failure class (#869).\n */\nexport const RUNTIME_FAILURE_CLASS_CAPABILITY = 'runtime-failure-class' as const;\n\n/**\n * The closed classes of `task.fail.failure.class`: the vendored OAR\n * `FailureClass` values. `unknown` means the runtime gave no structured\n * evidence. Single value authority shared by schema validation and\n * schema-free consumers.\n */\nexport const RUNTIME_FAILURE_CLASSES = [\n  'auth', 'quota', 'rate_limited', 'billing', 'model_unavailable', 'input_too_large', 'invalid_request',\n  'overloaded', 'provider', 'runtime_exited', 'limit_reached', 'output_schema', 'unknown',\n] as const;\n\n/** Single value authority shared by schema validation and schema-free consumers. */\nexport const PREPARED_AGENT_MEMORY_MODES = ['none', 'read', 'read-write'] as const;\n\nexport function isPreparedAgentMemoryMode(value: unknown): value is (typeof PREPARED_AGENT_MEMORY_MODES)[number] {\n  return typeof value === 'string' && PREPARED_AGENT_MEMORY_MODES.some(mode => mode === value);\n}\n","/** Bounded volatile navigation; only cursor is a durable acknowledgement. */\nexport const MAILBOX_READ_AHEAD_MAX_SEQS = 4096;\nexport const MAILBOX_READ_AHEAD_CAPABILITY = 'mailbox-read-ahead';\n\n/**\n * Wire protocol version. Every v3 change is a version bump, a gated addition\n * or a strip-safe addition: see docs/protocol.md \"Freeze rule\", which is the\n * one statement of the rule, and `src/wire-additions.ts`, which declares the\n * receiver-capability gates and additions. No v3 release has been published\n * yet, so `src/__tests__/compat.test.ts` has no published v3 decoder to prove\n * additions against; cross-release gates stay unproven until one exists.\n *\n * v3 makes `schema` required on the `terminalProjection.mode:\n * 'result-document'` arm (`terminal-projection.ts`, `result-schema.ts`): the\n * offer freezes the outcome schema, and the outcome reaches the Host only as\n * `task.complete.document`. That narrows a strict shape, so it is a wire\n * major. A v2 envelope is rejected; there is no v2 reader and no capability\n * negotiation between the two result-document shapes. Drain, then upgrade\n * server and client together. Every addition v2 declared is part of the v3\n * baseline, and the v2 `result-document` capability flag is gone: every v3\n * server keeps `task.complete.document`.\n *\n * v2 removed the task offer's `policy` (`PermissionPolicy`), the runtime\n * capability `permissionModes` and the input-preparation `permissionMode`.\n * Sessions run without an SDK permission gate; each local agent keeps its\n * own guardrails. A v1 envelope is rejected; there is no v1 reader.\n * v2 also removed the egress policy's `metadata-status` activity mode, its\n * `activity.mode` field and the `sanitizer_rejected` drop reason. Agent\n * egress goes to the Host as the runtime produced it.\n * v2 also removed the input-preparation artifact's `toolImplementationKinds`\n * and the readiness reason `executor_identity_unproven`. The SDK does not\n * attest tool executables. The artifact names its counted tools in\n * `toolNames`.\n */\nexport const PROTOCOL_VERSION = 3;\n\n/** Host declares that this device accepts only Agent-bound offer variants. */\nexport const STRICT_AGENT_ONLY_CAPABILITY = 'strict-agent-only' as const;\n\n/**\n * The device runs `homeAccess: 'memory-reader'` Agent offers: each reader\n * Attempt gets its own run directory under the Agent home, and readers are\n * counted apart from the one writer. The Agent offers are strict, so a host\n * must refuse a reader offer to a device without this flag before it creates\n * the task.\n */\nexport const AGENT_HOME_READERS_CAPABILITY = 'agent-home-readers' as const;\n\n/**\n * Capability flags. The daemon sends its flags in `conn.hello`; the server\n * sends its own on every long-poll response (`EventsPollResponse`). Additional\n * flags may be introduced without a protocol version bump; unrecognized flags\n * must be ignored by both sides.\n *\n * `interactive-approval` is RESERVED as of this addition: it gates the\n * (currently unexercised) approval seam — a server must not route an\n * approval-requiring policy to a daemon that hasn't advertised this flag. No\n * bundled runtime adapter emits it yet; that's expected until interactive\n * approval is actually wired up in a later wave.\n *\n * `approval_resolved` (additive-minor): a SERVER-advertised flag meaning\n * \"I understand the `task.approval_resolved` message\" (`messages.ts`). This\n * is the N/N-1 answer for that new daemon -> server message: an old server's\n * advertised capabilities never include it, so a new daemon talking to an old\n * server never sends `task.approval_resolved` at all (see `packages/client`'s\n * `task-runner.ts`) and falls back to the pre-existing implicit-resume inference\n * (the `relay.onTaskActivity` hook in `packages/server/src/index.ts`)\n * unconditionally, exactly as before this flag existed. Unlike\n * `interactive-approval`, this one IS exercised the moment both sides\n * support it — there is no reserved/dormant period for it.\n */\n/**\n * `approval-targeting` (M5, additive-minor): unlike `approval_resolved`\n * above, this flag is purely INFORMATIONAL/semantic, not a functional gate.\n * `task.await_approval`/`task.approve`/`task.reject` all carry their new\n * `approvalId` field UNCONDITIONALLY on both sides once each peer is\n * upgraded -- the wire is tolerant (a plain, non-`.strict()` `z.object()`\n * field, `messages.ts`), so no version/capability negotiation is needed just\n * to send it safely; an older peer that doesn't recognize the field simply\n * never reads it. Receivers decide whether to apply exact-match targeting\n * by FIELD PRESENCE on the specific message at hand (does this particular\n * `task.approve`/`task.reject`/`onApprovalResolved` payload carry an\n * `approvalId`, and does a stored one exist to compare it against?), never\n * by checking this flag -- see `approveTask`/`rejectTask` (`@byok-sdk/cloud`)\n * and `TaskRunner.handleApprove`/`handleReject` (`packages/client`'s\n * `task-runner.ts`). This flag exists only so each side can advertise\n * whether the OTHER side is new enough to participate in targeting at all (an\n * embedder could observe it through the old\n * reference server's `ConnectionHub.getDeviceCapabilities`; `@byok-sdk/server`\n * now reads it only internally) -- the same N/N-1-safe shape as every other\n * flag here, just consumed for observability instead of gating.\n */\n/**\n * `dispatch-selection` (additive-minor) is a correctness gate for the\n * optional `task.offer.dispatchSelection` control field. An older v1 daemon\n * legally strips unknown optional fields, so a server must never send an\n * authoritative provider/model selection unless the target connection\n * advertises this flag. Absence means reject before task creation, not send\n * a legacy runtime-only offer that could reach a different provider.\n *\n * `toolset-selection` (additive-minor) means the daemon understands\n * `task.offer_with_toolsets` and can resolve its logical ids against local\n * MCP configuration. The distinct message type is also the N/N-1 safety\n * boundary for long-poll: an older daemon skips it as unknown and therefore\n * cannot accidentally execute the instruction without the required tools.\n */\nexport const CUSTOM_HARNESS_CAPABILITY = 'custom-harness' as const;\n\nexport const CAPABILITY_FLAGS = [\n  'steer',\n  'blob-upload',\n  'interactive-approval',\n  'approval_resolved',\n  'approval-targeting',\n  'dispatch-selection',\n  PROVIDER_PROFILE_BINDING_CAPABILITY,\n  'toolset-selection',\n  'agent-home-contract',\n  AGENT_HOME_READERS_CAPABILITY,\n  STRICT_AGENT_ONLY_CAPABILITY,\n  AGENT_EGRESS_POLICY_CAPABILITY,\n  AGENT_EGRESS_RELIABLE_ACK_CAPABILITY,\n  AGENT_MESSAGE_EGRESS_CAPABILITY,\n  AGENT_EGRESS_FRESH_SESSION_CAPABILITY,\n  AGENT_CONTENT_WORKSPACE_READ_CAPABILITY,\n  AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY,\n  AGENT_CONTENT_ARTIFACT_READ_CAPABILITY,\n  AGENT_HOME_PROJECTION_CAPABILITY,\n  AGENT_INPUT_PREPARATION_CAPABILITY,\n  TERMINAL_PROJECTION_SELECTION_CAPABILITY,\n  HOST_MCP_TASK_CONTEXT_CAPABILITY,\n  CUSTOM_HARNESS_CAPABILITY,\n  MAILBOX_READ_AHEAD_CAPABILITY,\n  PROVIDER_PROVISIONING_CAPABILITY,\n  AGENT_MEMORY_INTENT_CAPABILITY,\n  AGENT_MEMORY_SELECTION_CAPABILITY,\n  AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY,\n  AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY,\n  'agent-message-draft',\n  SEALED_PAYLOAD_CAPABILITY,\n  SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY,\n  RUNTIME_FAILURE_CLASS_CAPABILITY,\n] as const;\n\nexport type CapabilityFlag = (typeof CAPABILITY_FLAGS)[number];\nimport {\n  AGENT_EGRESS_POLICY_CAPABILITY,\n  AGENT_EGRESS_RELIABLE_ACK_CAPABILITY,\n  AGENT_EGRESS_FRESH_SESSION_CAPABILITY,\n  AGENT_MESSAGE_EGRESS_CAPABILITY,\n  AGENT_CONTENT_WORKSPACE_READ_CAPABILITY,\n  AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY,\n  AGENT_CONTENT_ARTIFACT_READ_CAPABILITY,\n  AGENT_HOME_PROJECTION_CAPABILITY,\n  TERMINAL_PROJECTION_SELECTION_CAPABILITY,\n  HOST_MCP_TASK_CONTEXT_CAPABILITY,\n  PROVIDER_PROFILE_BINDING_CAPABILITY,\n  PROVIDER_PROVISIONING_CAPABILITY,\n  AGENT_MEMORY_INTENT_CAPABILITY,\n  AGENT_MEMORY_SELECTION_CAPABILITY,\n  AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY,\n  AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY,\n  AGENT_INPUT_PREPARATION_CAPABILITY,\n  SEALED_PAYLOAD_CAPABILITY,\n  SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY,\n  RUNTIME_FAILURE_CLASS_CAPABILITY,\n} from './capability-constants';\n","export const TASK_STATES = [\n  'Offered',\n  'Claimed',\n  'Running',\n  'AwaitApproval',\n  'Complete',\n  'Failed',\n  'Cancelled',\n] as const;\n\nexport type TaskState = (typeof TASK_STATES)[number];\n\n/**\n * Legal state transitions for a task. `Complete` / `Failed` / `Cancelled` are\n * terminal (no outgoing edges). `Running` and `AwaitApproval` form a loop:\n * the daemon can request approval mid-run and resume once the server\n * approves (or fail/cancel out of the approval wait).\n *\n * `Offered -> Failed` (M1 gap #5, \"Declined vs. Failed\"): a daemon that\n * declines an offer pre-claim (`task.decline`) reports it through the\n * existing `Failed` state rather than a new `Declined` state. A decline and\n * a post-claim failure are the same outcome from the dispatcher's point of\n * view — this attempt produced no result, `reason`/`retryable` say why and\n * whether retrying elsewhere makes sense — so reusing `Failed` keeps the\n * state machine minimal instead of forking every terminal-state consumer\n * into \"Failed or Declined, handle both\". See docs/protocol.md for the full\n * writeup.\n */\nexport const TASK_TRANSITIONS: Readonly<Record<TaskState, readonly TaskState[]>> = {\n  Offered: ['Claimed', 'Cancelled', 'Failed'],\n  Claimed: ['Running', 'Failed', 'Cancelled'],\n  Running: ['AwaitApproval', 'Complete', 'Failed', 'Cancelled'],\n  AwaitApproval: ['Running', 'Failed', 'Cancelled'],\n  Complete: [],\n  Failed: [],\n  Cancelled: [],\n};\n\n/** Whether `from -> to` is a legal transition per {@link TASK_TRANSITIONS}. */\nexport function canTransition(from: TaskState, to: TaskState): boolean {\n  return TASK_TRANSITIONS[from].includes(to);\n}\n","/** Schema-free protocol values. Import this entry when runtime schemas are unnecessary. */\nexport * from './version';\nexport * from './task-state';\nexport * from './capability-constants';\n\n/** Maximum raw UTF-8 content bytes in one local Host Agent-memory export; no truncation. */\nexport const AGENT_MEMORY_MAX_SNAPSHOT_BYTES = 1024 * 1024;\n/** Maximum memory files in one local Host export, including MEMORY.md. */\nexport const AGENT_MEMORY_MAX_SNAPSHOT_FILES = 128;\n\n/** The frozen wire runtime ids. Any other adapter id is a custom harness (`harnessId`). */\nexport const RUNTIME_IDS = Object.freeze(['pi', 'claude', 'codex'] as const);\n"]}
+{"version":3,"sources":["../src/capability-constants.ts","../src/version.ts","../src/task-state.ts","../src/failure-reason.ts","../src/constants.ts"],"names":[],"mappings":"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","file":"constants.js","sourcesContent":["/**\n * The ONE version of the input-preparation contract, shared by this relay wire\n * (the `agent.input.preparation` payload and the completion receipt summary)\n * and by the device-local request, receipt and artifact\n * (`@byok-sdk/client`'s `INPUT_PREPARATION_VERSION`, which is this value).\n *\n * The relay wire carries no version field of its own, so a version change is\n * made visible where admission actually happens: in the capability token\n * below. See `INPUT_PREPARATION_VERSION` in the client for what each version\n * changed.\n */\nexport const INPUT_PREPARATION_WIRE_VERSION = 9 as const;\n\n\n/** Additive daemon capability names. Server/cloud admission consumes these exactly. */\nexport const AGENT_EGRESS_POLICY_CAPABILITY = 'agent-egress-policy' as const;\n\nexport const AGENT_EGRESS_RELIABLE_ACK_CAPABILITY = 'agent-egress-reliable-ack' as const;\n\n/** Admits the distinct offer whose runtime mints its session only after start. */\nexport const AGENT_EGRESS_FRESH_SESSION_CAPABILITY = 'agent-egress-fresh-session' as const;\n\n/** Admits the distinct Agent-authored message lane; activity policy remains independent. */\nexport const AGENT_MESSAGE_EGRESS_CAPABILITY = 'agent-message-egress' as const;\n\nexport const AGENT_CONTENT_WORKSPACE_READ_CAPABILITY = 'agent-content-workspace-read' as const;\n\nexport const AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY = 'agent-content-transcript-read' as const;\n\nexport const AGENT_CONTENT_ARTIFACT_READ_CAPABILITY = 'agent-content-artifact-read' as const;\n\n/** Capability required before a task-free Agent-home projection is admitted. */\nexport const AGENT_HOME_PROJECTION_CAPABILITY = 'agent-home-projection' as const;\n\n/** Capability required before an offer may select terminal projection behavior. */\nexport const TERMINAL_PROJECTION_SELECTION_CAPABILITY = 'terminal-projection-selection' as const;\n\n/** Contract §8.1's capability gate for `byok-task-assertion-v1` tool authority. */\nexport const HOST_MCP_TASK_CONTEXT_CAPABILITY = 'host-mcp-task-context' as const;\n\n/** Daemon capability required before an exact local provider profile may be offered. */\nexport const PROVIDER_PROFILE_BINDING_CAPABILITY = 'provider-profile-binding' as const;\n\n/** Device capability required before a Host may enqueue `provider.provisioning.available`. */\nexport const PROVIDER_PROVISIONING_CAPABILITY = 'provider-provisioning.v1' as const;\n\n/** Device capability required before a Host may enqueue `agent.memory.intent.available`. */\nexport const AGENT_MEMORY_INTENT_CAPABILITY = 'agent-memory-intent.v1' as const;\n\n/** Capability required before the optional hosted Agent-memory projection can be used. */\nexport const AGENT_MEMORY_PROJECTION_CAPABILITY = 'agent.memory.projection' as const;\n\n/** Device capability required before an ordinary Agent offer may carry `agentMemory`. */\nexport const AGENT_MEMORY_SELECTION_CAPABILITY = 'agent-memory-selection' as const;\n\n/** Device capability required before an ordinary Agent offer may carry `agentMemory: 'read-if-admitted'`. */\nexport const AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY = 'agent-memory-read-if-admitted' as const;\n\n/** Device capability required before an ordinary Agent offer may carry `agentMemory: 'read-write-if-admitted'`. */\nexport const AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY = 'agent-memory-read-write-if-admitted' as const;\n\n/** Exact capability of the single input-preparation wire authority. */\nexport const AGENT_INPUT_PREPARATION_CAPABILITY =\n  `agent-input-preparation-v${INPUT_PREPARATION_WIRE_VERSION}` as const;\n\n/**\n * Sealed payload v1 (#654). A device advertises it before a Host may send it\n * a sealed offer or steer; a server advertises it before a device may send it\n * sealed task output or a sealed decline code. Both gates read\n * `WIRE_ADDITIONS`.\n */\nexport const SEALED_PAYLOAD_CAPABILITY = 'sealed-payload-v1' as const;\n\n/**\n * A server advertises it before a device may send a sealed task output that\n * names its ciphertext blob (`sealed.ciphertextRef`) instead of carrying it\n * inline. The server then holds the blob for the life of the task.\n */\nexport const SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY = 'sealed-output-ciphertext-ref' as const;\n\n/**\n * A server advertises it before a device may send `task.fail.failure`, the\n * machine-readable runtime failure class (#869).\n */\nexport const RUNTIME_FAILURE_CLASS_CAPABILITY = 'runtime-failure-class' as const;\n\n/**\n * The connection understands the typed pre-claim runtime-unavailable cause\n * (#1103 D8): `task.decline.runtimeUnavailable`, `conn.hello.runtimeUnavailable`\n * and the presence projection. A daemon declares it when it emits the cause.\n * Older peers ignore the unknown flag; absence means the peer may not read\n * the cause, so a Host falls back to `retryable` and treats the cause as\n * unknown. It never infers availability or allow from absence.\n */\nexport const RUNTIME_UNAVAILABLE_CAUSE_CAPABILITY = 'runtime-unavailable-cause' as const;\n/**\n * The closed classes of `task.fail.failure.class`: the vendored OAR\n * `FailureClass` values. `unknown` means the runtime gave no structured\n * evidence. Single value authority shared by schema validation and\n * schema-free consumers.\n */\nexport const RUNTIME_FAILURE_CLASSES = [\n  'auth', 'quota', 'rate_limited', 'billing', 'model_unavailable', 'input_too_large', 'invalid_request',\n  'overloaded', 'provider', 'runtime_exited', 'limit_reached', 'output_schema', 'unknown',\n] as const;\n\n/** Single value authority shared by schema validation and schema-free consumers. */\nexport const PREPARED_AGENT_MEMORY_MODES = ['none', 'read', 'read-write'] as const;\n\nexport function isPreparedAgentMemoryMode(value: unknown): value is (typeof PREPARED_AGENT_MEMORY_MODES)[number] {\n  return typeof value === 'string' && PREPARED_AGENT_MEMORY_MODES.some(mode => mode === value);\n}\n","/** Bounded volatile navigation; only cursor is a durable acknowledgement. */\nexport const MAILBOX_READ_AHEAD_MAX_SEQS = 4096;\nexport const MAILBOX_READ_AHEAD_CAPABILITY = 'mailbox-read-ahead';\n\n/**\n * Wire protocol version. Every v4 change is a version bump, a gated addition\n * or a strip-safe addition: see docs/protocol.md \"Freeze rule\", which is the\n * one statement of the rule, and `src/wire-additions.ts`, which declares the\n * receiver-capability gates and additions. No v4 release has been published\n * yet, so `src/__tests__/compat.test.ts` has no published v4 decoder to prove\n * additions against; cross-release gates stay unproven until one exists.\n *\n * v4 completes the ADR-034 cutover and retires the approval paths kept for\n * pre-M5 peers. It removes the v3 handshake answer, the runtime-only offers\n * (with and without toolsets) with their sealed twins, and the\n * `strict-agent-only` flag: every offer is Agent-bound. `approvalId` is\n * required on `task.await_approval`, `task.approve` and `task.reject`, so a\n * decision resolves only the approval it names. `task.approval_resolved` is\n * baseline: the daemon reports every locally resolved approval, and the\n * server no longer infers one from later task activity. The three approval\n * capability flags of v3 are gone. A v3 envelope is rejected; there is no v3 reader. Drain, then\n * upgrade server and client together.\n *\n * v3 made `schema` required on the `terminalProjection.mode:\n * 'result-document'` arm (`terminal-projection.ts`, `result-schema.ts`): the\n * offer freezes the outcome schema, and the outcome reaches the Host only as\n * `task.complete.document`. That narrows a strict shape, so it is a wire\n * major. A v2 envelope is rejected; there is no v2 reader and no capability\n * negotiation between the two result-document shapes. Drain, then upgrade\n * server and client together. Every addition v2 declared is part of the v3\n * baseline, and the v2 `result-document` capability flag is gone: every v3\n * server keeps `task.complete.document`.\n *\n * v2 removed the task offer's `policy` (`PermissionPolicy`), the runtime\n * capability `permissionModes` and the input-preparation `permissionMode`.\n * Sessions run without an SDK permission gate; each local agent keeps its\n * own guardrails. A v1 envelope is rejected; there is no v1 reader.\n * v2 also removed the egress policy's `metadata-status` activity mode, its\n * `activity.mode` field and the `sanitizer_rejected` drop reason. Agent\n * egress goes to the Host as the runtime produced it.\n * v2 also removed the input-preparation artifact's `toolImplementationKinds`\n * and the readiness reason `executor_identity_unproven`. The SDK does not\n * attest tool executables. The artifact names its counted tools in\n * `toolNames`.\n */\nexport const PROTOCOL_VERSION = 4;\n\n/**\n * The device runs `homeAccess: 'memory-reader'` Agent offers: each reader\n * Attempt gets its own run directory under the Agent home, and readers are\n * counted apart from the one writer. The Agent offers are strict, so a host\n * must refuse a reader offer to a device without this flag before it creates\n * the task.\n */\nexport const AGENT_HOME_READERS_CAPABILITY = 'agent-home-readers' as const;\n\n/**\n * Capability flags. The daemon sends its flags in `conn.hello`; the server\n * sends its own on every long-poll response (`EventsPollResponse`). Additional\n * flags may be introduced without a protocol version bump; unrecognized flags\n * must be ignored by both sides.\n *\n * `dispatch-selection` (additive-minor) is a correctness gate for the\n * optional offer `dispatchSelection` control field. An older v1 daemon\n * legally strips unknown optional fields, so a server must never send an\n * authoritative provider/model selection unless the target connection\n * advertises this flag. Absence means reject before task creation, not send\n * an offer that could reach a different provider.\n *\n * `toolset-selection` (additive-minor) means the daemon understands an\n * offer's `requiredToolsets` and can resolve its logical ids against local\n * MCP configuration.\n */\nexport const CUSTOM_HARNESS_CAPABILITY = 'custom-harness' as const;\n\nexport const CAPABILITY_FLAGS = [\n  'steer',\n  'blob-upload',\n  'dispatch-selection',\n  PROVIDER_PROFILE_BINDING_CAPABILITY,\n  'toolset-selection',\n  'agent-home-contract',\n  AGENT_HOME_READERS_CAPABILITY,\n  AGENT_EGRESS_POLICY_CAPABILITY,\n  AGENT_EGRESS_RELIABLE_ACK_CAPABILITY,\n  AGENT_MESSAGE_EGRESS_CAPABILITY,\n  AGENT_EGRESS_FRESH_SESSION_CAPABILITY,\n  AGENT_CONTENT_WORKSPACE_READ_CAPABILITY,\n  AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY,\n  AGENT_CONTENT_ARTIFACT_READ_CAPABILITY,\n  AGENT_HOME_PROJECTION_CAPABILITY,\n  AGENT_INPUT_PREPARATION_CAPABILITY,\n  TERMINAL_PROJECTION_SELECTION_CAPABILITY,\n  HOST_MCP_TASK_CONTEXT_CAPABILITY,\n  CUSTOM_HARNESS_CAPABILITY,\n  MAILBOX_READ_AHEAD_CAPABILITY,\n  PROVIDER_PROVISIONING_CAPABILITY,\n  AGENT_MEMORY_INTENT_CAPABILITY,\n  AGENT_MEMORY_SELECTION_CAPABILITY,\n  AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY,\n  AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY,\n  'agent-message-draft',\n  SEALED_PAYLOAD_CAPABILITY,\n  SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY,\n  RUNTIME_FAILURE_CLASS_CAPABILITY,\n  RUNTIME_UNAVAILABLE_CAUSE_CAPABILITY,\n] as const;\n\nexport type CapabilityFlag = (typeof CAPABILITY_FLAGS)[number];\nimport {\n  AGENT_EGRESS_POLICY_CAPABILITY,\n  AGENT_EGRESS_RELIABLE_ACK_CAPABILITY,\n  AGENT_EGRESS_FRESH_SESSION_CAPABILITY,\n  AGENT_MESSAGE_EGRESS_CAPABILITY,\n  AGENT_CONTENT_WORKSPACE_READ_CAPABILITY,\n  AGENT_CONTENT_TRANSCRIPT_READ_CAPABILITY,\n  AGENT_CONTENT_ARTIFACT_READ_CAPABILITY,\n  AGENT_HOME_PROJECTION_CAPABILITY,\n  TERMINAL_PROJECTION_SELECTION_CAPABILITY,\n  HOST_MCP_TASK_CONTEXT_CAPABILITY,\n  PROVIDER_PROFILE_BINDING_CAPABILITY,\n  PROVIDER_PROVISIONING_CAPABILITY,\n  AGENT_MEMORY_INTENT_CAPABILITY,\n  AGENT_MEMORY_SELECTION_CAPABILITY,\n  AGENT_MEMORY_READ_IF_ADMITTED_CAPABILITY,\n  AGENT_MEMORY_READ_WRITE_IF_ADMITTED_CAPABILITY,\n  AGENT_INPUT_PREPARATION_CAPABILITY,\n  SEALED_PAYLOAD_CAPABILITY,\n  SEALED_OUTPUT_CIPHERTEXT_REF_CAPABILITY,\n  RUNTIME_FAILURE_CLASS_CAPABILITY,\n  RUNTIME_UNAVAILABLE_CAUSE_CAPABILITY,\n} from './capability-constants';\n","export const TASK_STATES = [\n  'Offered',\n  'Claimed',\n  'Running',\n  'AwaitApproval',\n  'Complete',\n  'Failed',\n  'Cancelled',\n] as const;\n\nexport type TaskState = (typeof TASK_STATES)[number];\n\n/**\n * Legal state transitions for a task. `Complete` / `Failed` / `Cancelled` are\n * terminal (no outgoing edges). `Running` and `AwaitApproval` form a loop:\n * the daemon can request approval mid-run and resume once the server\n * approves (or fail/cancel out of the approval wait).\n *\n * `Offered -> Failed` (M1 gap #5, \"Declined vs. Failed\"): a daemon that\n * declines an offer pre-claim (`task.decline`) reports it through the\n * existing `Failed` state rather than a new `Declined` state. A decline and\n * a post-claim failure are the same outcome from the dispatcher's point of\n * view — this attempt produced no result, `reason`/`retryable` say why and\n * whether retrying elsewhere makes sense — so reusing `Failed` keeps the\n * state machine minimal instead of forking every terminal-state consumer\n * into \"Failed or Declined, handle both\". See docs/protocol.md for the full\n * writeup.\n */\nexport const TASK_TRANSITIONS: Readonly<Record<TaskState, readonly TaskState[]>> = {\n  Offered: ['Claimed', 'Cancelled', 'Failed'],\n  Claimed: ['Running', 'Failed', 'Cancelled'],\n  Running: ['AwaitApproval', 'Complete', 'Failed', 'Cancelled'],\n  AwaitApproval: ['Running', 'Failed', 'Cancelled'],\n  Complete: [],\n  Failed: [],\n  Cancelled: [],\n};\n\n/** Whether `from -> to` is a legal transition per {@link TASK_TRANSITIONS}. */\nexport function canTransition(from: TaskState, to: TaskState): boolean {\n  return TASK_TRANSITIONS[from].includes(to);\n}\n","/**\n * The single authority for the display text of a `task.fail` `reason` (#1124).\n *\n * A runtime's stderr tail can carry credentials a runtime or proxy printed\n * while failing. The `task.fail` schema applies this to `reason` on every\n * parse, so `createEnvelope` bounds what a daemon sends (sealed or not) and\n * every decode bounds what a receiver holds. The raw tail stays local, on the\n * adapter's `RuntimeExecutionFailure`. The result is a fixed point: applying\n * it to its own output changes nothing, so a bounded envelope round-trips\n * byte-for-byte.\n *\n * Every pattern starts at a literal and its runs never backtrack into a\n * failure, so the cost stays linear in the input length.\n */\n\n/** Maximum UTF-8 bytes of a `task.fail` `reason` after normalization, truncation marker included. */\nexport const TASK_FAIL_REASON_MAX_BYTES = 2048;\n\nconst REDACTED = '[redacted]';\n\n// A secret value: a quoted string (an unclosed quote runs to the end of the\n// line), or an unquoted run. A backslash and its following character belong\n// to the value together, so an escaped quote cannot expose a secret suffix.\n// A dangling backslash in an unclosed value is consumed too. Every alternative\n// succeeds greedily without backtracking. An unquoted value never starts with `[` or `…`, so a\n// redaction or truncation marker is never mistaken for a value on a second pass.\nconst VALUE = String.raw`(?:\"(?:\\\\[^\\n]|[^\"\\\\\\n])*(?:\\\\)?\"?|'(?:\\\\[^\\n]|[^'\\\\\\n])*(?:\\\\)?'?|[^\\s\"'\\[\\u2026,;&|][^\\s\"',;&|]*)`;\n\n// Bounded runs keep a failed match from rescanning a long run at every literal.\nconst GAP = '[ \\\\t]{0,16}';\n\nconst RULES: ReadonlyArray<readonly [RegExp, string]> = [\n  // `Authorization: Bearer …`, `proxy-authorization=Basic …`, JSON `\"authorization\": \"…\"`.\n  [new RegExp(String.raw`\\b((?:proxy-)?authorization)([\"']?${GAP}[:=]${GAP})(?:(?:bearer|basic|token|digest)[ \\t]{1,16})?${VALUE}`, 'gi'), `$1$2${REDACTED}`],\n  [/\\b(bearer)[ \\t]{1,16}[A-Za-z0-9._~+/=-]{8,}/gi, `$1 ${REDACTED}`],\n  // `ANTHROPIC_API_KEY=…`, `x-api-key: …`, `GITHUB_TOKEN=…`, `client_secret: …`, `DB_PASSWORD_FILE=…`.\n  [new RegExp(String.raw`(key|token|secret|passw(?:or)?d[\\w.-]{0,64})([\"']?${GAP}[:=]${GAP})${VALUE}`, 'gi'), `$1$2${REDACTED}`],\n  // URL userinfo: `postgres://user:pass@host`, `https://token@host`.\n  [/:\\/\\/[^\\s/?#@]{1,256}@/g, `://${REDACTED}@`],\n  // Provider key shapes.\n  [/\\bsk-[A-Za-z0-9_-]{16,}/g, REDACTED],\n  [/\\bxai-[A-Za-z0-9_-]{16,}/g, REDACTED],\n  [/\\bAIza[0-9A-Za-z_-]{30,}/g, REDACTED],\n  [/\\bgh[pousr]_[A-Za-z0-9]{20,}/g, REDACTED],\n  [/\\bgithub_pat_[A-Za-z0-9_]{20,}/g, REDACTED],\n  [/\\bAKIA[0-9A-Z]{16}/g, REDACTED],\n  // JWT-like tokens.\n  [/\\beyJ[A-Za-z0-9_-]{10,}(?:\\.[A-Za-z0-9_-]*){0,2}/g, REDACTED],\n];\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder('utf-8');\n\nfunction redact(text: string): string {\n  let out = text;\n  for (const [pattern, replacement] of RULES) out = out.replace(pattern, replacement);\n  return out;\n}\n\n/**\n * Redact credentials from a failure reason, then cap it at\n * {@link TASK_FAIL_REASON_MAX_BYTES} UTF-8 bytes on a code-point boundary\n * with a `…[truncated N bytes]` marker, where N counts the dropped redacted\n * bytes.\n */\nexport function boundFailureReason(reason: string): string {\n  const redacted = redact(reason);\n  const bytes = encoder.encode(redacted);\n  if (bytes.length <= TASK_FAIL_REASON_MAX_BYTES) return redacted;\n  // Reserve the widest marker this input can need; the final one is no wider.\n  let keep = TASK_FAIL_REASON_MAX_BYTES - encoder.encode(`\\u2026[truncated ${bytes.length} bytes]`).length;\n  while (keep > 0 && ((bytes[keep] ?? 0) & 0xc0) === 0x80) keep -= 1;\n  return `${decoder.decode(bytes.subarray(0, keep))}\\u2026[truncated ${bytes.length - keep} bytes]`;\n}\n","/** Schema-free protocol values. Import this entry when runtime schemas are unnecessary. */\nexport * from './version';\nexport * from './task-state';\nexport * from './capability-constants';\nexport * from './failure-reason';\n\n/** Maximum raw UTF-8 content bytes in one local Host Agent-memory export; no truncation. */\nexport const AGENT_MEMORY_MAX_SNAPSHOT_BYTES = 1024 * 1024;\n/** Maximum memory files in one local Host export, including MEMORY.md. */\nexport const AGENT_MEMORY_MAX_SNAPSHOT_FILES = 128;\n\n/** The frozen wire runtime ids. Any other adapter id is a custom harness (`harnessId`). */\nexport const RUNTIME_IDS = Object.freeze(['pi', 'claude', 'codex'] as const);\n\n/**\n * Why a runtime is unavailable before claim (#1103 D6). Append-only: a cause is\n * never renamed, removed or given a new meaning. The wire reads an unknown\n * well-formed token as `unknown` and keeps it verbatim (#1121), so a newer\n * device can add one without a protocol bump. Names are snake_case, unlike the\n * kebab-case detection kinds, because the mapping is explicit and never a\n * string transformation.\n */\nexport const RUNTIME_UNAVAILABLE_CAUSES = Object.freeze([\n  /** Detection: `not-found`. */\n  'not_installed',\n  /** Detection: `not-executable`. */\n  'not_executable',\n  /** Detection: `timeout`. */\n  'probe_timeout',\n  /** Detection: `probe-failed`. */\n  'probe_failed',\n  /** Detection: `refused` / `app_server_unavailable`. */\n  'app_server_unavailable',\n  /** Detection: `refused` / `acp_unavailable`. */\n  'acp_unavailable',\n  /** Detection: `refused` / `platform_unsupported`. */\n  'platform_unsupported',\n  /** The login-shell environment capture failed (#1095). */\n  'environment_unavailable',\n  /** A Host-configured version policy blocked the installed token (#1103). */\n  'version_blocked',\n  /** The offer named an id this daemon has no adapter for. */\n  'runtime_not_configured',\n  /** The device runtime allowlist excludes the requested id. */\n  'runtime_not_allowed',\n  /** Automatic selection exhausted every candidate. */\n  'none_available',\n] as const);\n\n/** One append-only `runtime_unavailable` cause. */\nexport type RuntimeUnavailableCause = (typeof RUNTIME_UNAVAILABLE_CAUSES)[number];\n\n/** Maximum length of a served model name. */\nexport const TERMINAL_INFERENCE_USAGE_MODEL_MAX_LENGTH = 160;\n"]}

package/dist/envelope.d.ts

@@ -31,7 +31,7 @@ type EnvelopeShape<T extends MessageType, TaskId extends z.ZodTypeAny, Seq exten
  *   optional for daemon -> server types (M1 redelivery cursor; see
  *   `conn.hello.cursor` in `messages.ts`).
  */
-export declare const EnvelopeSchema: z.ZodDiscriminatedUnion<[EnvelopeShape<"conn.hello", z.ZodOptional<z.ZodString>, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"conn.ack", z.ZodOptional<z.ZodString>, z.ZodNumber>, EnvelopeShape<"task.offer", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.offer_with_toolsets", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.offer_for_agent", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.offer_for_agent_with_egress", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.offer_for_agent_with_egress_fresh", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.offer_prepared", z.ZodString, z.ZodNumber>, EnvelopeShape<"agent.egress.ack", z.ZodOptional<z.ZodString>, z.ZodNumber>, EnvelopeShape<"agent.message.disposition", z.ZodString, z.ZodNumber>, EnvelopeShape<"agent.content.read", z.ZodOptional<z.ZodString>, z.ZodNumber>, EnvelopeShape<"agent.home.projection", z.ZodOptional<z.ZodNever>, z.ZodNumber>, EnvelopeShape<"agent.input.preparation", z.ZodOptional<z.ZodNever>, z.ZodNumber>, EnvelopeShape<"provider.provisioning.available", z.ZodOptional<z.ZodNever>, z.ZodNumber>, EnvelopeShape<"agent.memory.intent.available", z.ZodOptional<z.ZodNever>, z.ZodNumber>, EnvelopeShape<"task.approve", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.reject", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.cancel", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.steer", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.claim", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.started", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.decline", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.progress", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.artifact", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.await_approval", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.complete", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.fail", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.cancelled", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.approval_resolved", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"agent.egress.reliable", z.ZodOptional<z.ZodString>, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"agent.message.draft", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"agent.message.publish", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"agent.content.receipt", z.ZodOptional<z.ZodString>, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.offer_sealed", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.offer_with_toolsets_sealed", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.offer_for_agent_sealed", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.offer_for_agent_with_egress_sealed", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.offer_for_agent_with_egress_fresh_sealed", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.steer_sealed", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.complete_sealed", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.fail_sealed", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.decline_sealed", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.cancelled_sealed", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.progress_sealed", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.artifact_sealed", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.await_approval_sealed", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"e2ee.key_package.available", z.ZodOptional<z.ZodNever>, z.ZodNumber>], "type">;
+export declare const EnvelopeSchema: z.ZodDiscriminatedUnion<[EnvelopeShape<"conn.hello", z.ZodOptional<z.ZodString>, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.offer", z.ZodString, z.ZodNumber>, EnvelopeShape<"agent.egress.ack", z.ZodOptional<z.ZodString>, z.ZodNumber>, EnvelopeShape<"agent.message.disposition", z.ZodString, z.ZodNumber>, EnvelopeShape<"agent.content.read", z.ZodOptional<z.ZodString>, z.ZodNumber>, EnvelopeShape<"agent.home.projection", z.ZodOptional<z.ZodNever>, z.ZodNumber>, EnvelopeShape<"agent.input.preparation", z.ZodOptional<z.ZodNever>, z.ZodNumber>, EnvelopeShape<"provider.provisioning.available", z.ZodOptional<z.ZodNever>, z.ZodNumber>, EnvelopeShape<"agent.memory.intent.available", z.ZodOptional<z.ZodNever>, z.ZodNumber>, EnvelopeShape<"task.approve", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.reject", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.cancel", z.ZodString, z.ZodNumber>, EnvelopeShape<"task.steer", z.ZodString, z.ZodNumber>, EnvelopeShape<"e2ee.key_package.available", z.ZodOptional<z.ZodNever>, z.ZodNumber>, EnvelopeShape<"task.claim", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.started", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.decline", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.progress", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.artifact", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.await_approval", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.complete", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.fail", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.cancelled", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"task.approval_resolved", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"agent.egress.reliable", z.ZodOptional<z.ZodString>, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"agent.message.draft", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"agent.message.publish", z.ZodString, z.ZodOptional<z.ZodNumber>>, EnvelopeShape<"agent.content.receipt", z.ZodOptional<z.ZodString>, z.ZodOptional<z.ZodNumber>>], "type">;
 export type Envelope = z.infer<typeof EnvelopeSchema>;
 /** `true` for every message type the server sends to the daemon (envelope `seq` is required for these). */
 export declare function isServerToDaemonType(type: MessageType): boolean;

package/dist/failure-reason.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The single authority for the display text of a `task.fail` `reason` (#1124).
+ *
+ * A runtime's stderr tail can carry credentials a runtime or proxy printed
+ * while failing. The `task.fail` schema applies this to `reason` on every
+ * parse, so `createEnvelope` bounds what a daemon sends (sealed or not) and
+ * every decode bounds what a receiver holds. The raw tail stays local, on the
+ * adapter's `RuntimeExecutionFailure`. The result is a fixed point: applying
+ * it to its own output changes nothing, so a bounded envelope round-trips
+ * byte-for-byte.
+ *
+ * Every pattern starts at a literal and its runs never backtrack into a
+ * failure, so the cost stays linear in the input length.
+ */
+/** Maximum UTF-8 bytes of a `task.fail` `reason` after normalization, truncation marker included. */
+export declare const TASK_FAIL_REASON_MAX_BYTES = 2048;
+/**
+ * Redact credentials from a failure reason, then cap it at
+ * {@link TASK_FAIL_REASON_MAX_BYTES} UTF-8 bytes on a code-point boundary
+ * with a `…[truncated N bytes]` marker, where N counts the dropped redacted
+ * bytes.
+ */
+export declare function boundFailureReason(reason: string): string;