@harness-control/protocol 0.4.8 → 0.4.10

package/dist/conversation.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+export declare const hcpConversationRequestPayloadSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"read">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"rollback">;
+        num_turns: z.ZodNumber;
+        expected_history_hash: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"retire">;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+export declare const nativeConversationHistorySchema: z.ZodObject<{
+    history_hash: z.ZodString;
+    turn_count: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    turns: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodString;
+        items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const hcpConversationResultPayloadSchema: z.ZodObject<{
+    command_id: z.ZodString;
+    session_id: z.ZodString;
+    operation: z.ZodEnum<{
+        read: "read";
+        rollback: "rollback";
+        retire: "retire";
+    }>;
+    filesystem_undo: z.ZodLiteral<false>;
+    history: z.ZodOptional<z.ZodObject<{
+        history_hash: z.ZodString;
+        turn_count: z.ZodNumber;
+        truncated: z.ZodBoolean;
+        turns: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            status: z.ZodString;
+            items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type HcpConversationRequestPayload = z.infer<typeof hcpConversationRequestPayloadSchema>;
+export type HcpConversationResultPayload = z.infer<typeof hcpConversationResultPayloadSchema>;
+//# sourceMappingURL=conversation.d.ts.map

package/dist/conversation.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export const hcpConversationRequestPayloadSchema = z.object({ session_id: z.string().min(1).max(512),
+    operation: z.discriminatedUnion("kind", [z.object({ kind: z.literal("read") }).strict(),
+        z.object({ kind: z.literal("rollback"), num_turns: z.number().int().min(1).max(100), expected_history_hash: z.string().regex(/^[a-f0-9]{64}$/) }).strict(),
+        z.object({ kind: z.literal("retire") }).strict()]) }).strict();
+export const nativeConversationHistorySchema = z.object({ history_hash: z.string().regex(/^[a-f0-9]{64}$/),
+    turn_count: z.number().int().nonnegative(), truncated: z.boolean(),
+    turns: z.array(z.object({ id: z.string(), status: z.string(), items: z.array(z.record(z.string(), z.json())) }).strict()).max(100) }).strict();
+export const hcpConversationResultPayloadSchema = z.object({ command_id: z.string().min(1), session_id: z.string().min(1),
+    operation: z.enum(["read", "rollback", "retire"]), filesystem_undo: z.literal(false),
+    history: nativeConversationHistorySchema.optional() }).strict();
+//# sourceMappingURL=conversation.js.map

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { type HcpAccountsReadPayload, type HcpAccountsSnapshotPayload } from "./accounts.js";
 export * from "./accounts.js";
+import { type HcpConversationRequestPayload, type HcpConversationResultPayload } from "./conversation.js";
+export * from "./conversation.js";
 import { z } from "zod";
 export declare const HCP_VERSION: "hcp.v0";
 export declare const HCP_METADATA_MAX_ENCODED_BYTES: number;
@@ -7,11 +9,11 @@ export declare const HCP_PAYLOAD_MAX_ENCODED_BYTES: number;
 export declare const HCP_MESSAGE_MAX_ENCODED_BYTES: number;
 export type HcpVersion = typeof HCP_VERSION;
 export declare const HOST_LIFECYCLE_MESSAGE_TYPES: readonly ["host.accounts.read", "host.accounts.snapshot", "host.hello", "host.accepted", "host.rejected", "host.heartbeat", "host.capabilities.updated", "host.replay.unavailable", "host.workspaces.request", "host.workspaces.result"];
-export declare const CONTROL_PLANE_COMMAND_MESSAGE_TYPES: readonly ["harness.session.start", "harness.session.snapshot.request", "harness.turn.send", "harness.turn.cancel", "harness.session.stop", "harness.approval.respond", "harness.input.respond", "tool_servers.detach"];
+export declare const CONTROL_PLANE_COMMAND_MESSAGE_TYPES: readonly ["harness.session.start", "harness.conversation.request", "harness.session.snapshot.request", "harness.turn.send", "harness.turn.cancel", "harness.session.stop", "harness.approval.respond", "harness.input.respond", "tool_servers.detach"];
 export declare const COMMAND_ACK_MESSAGE_TYPES: readonly ["hcp.command.ack", "hcp.command.nack"];
 export declare const LOCAL_ACTION_MESSAGE_TYPES: readonly ["local.action.request", "local.action.response", "local.action.error"];
 export declare const RUNTIME_EVENT_MESSAGE_TYPES: readonly ["harness.event"];
-export declare const SESSION_SNAPSHOT_MESSAGE_TYPES: readonly ["harness.session.snapshot"];
+export declare const SESSION_SNAPSHOT_MESSAGE_TYPES: readonly ["harness.session.snapshot", "harness.conversation.result"];
 export declare const KNOWN_HCP_EVENT_TYPES: readonly ["session.started", "session.configured", "session.state.changed", "session.exited", "thread.started", "thread.state.changed", "thread.metadata.updated", "thread.token_usage.updated", "thread.realtime.started", "thread.realtime.item_added", "thread.realtime.audio_delta", "thread.realtime.error", "thread.realtime.closed", "auth.status", "account.updated", "account.rate_limits.updated", "turn.started", "turn.completed", "turn.failed", "turn.aborted", "turn.cancelled", "turn.plan.updated", "turn.proposed.delta", "turn.proposed.completed", "turn.diff.updated", "item.started", "item.updated", "item.completed", "content.delta", "reasoning.delta", "command.started", "command.completed", "local_capability.lease.created", "local_capability.lease.revoked", "local_capability.lease.expired", "local_capability.action.started", "local_capability.action.completed", "local_capability.action.failed", "file_change.started", "file_change.completed", "mcp_tool.started", "mcp_tool.completed", "mcp.status.updated", "mcp.oauth.completed", "approval.requested", "approval.resolved", "input.requested", "input.resolved", "request.opened", "request.resolved", "user_input.requested", "user_input.resolved", "task.started", "task.progress", "task.completed", "hook.started", "hook.progress", "hook.completed", "tool.progress", "tool.summary", "model.rerouted", "config.warning", "deprecation.notice", "files.persisted", "workspace.preflight.completed", "usage.updated", "runtime.warning", "runtime.error"];
 export type HostLifecycleMessageType = (typeof HOST_LIFECYCLE_MESSAGE_TYPES)[number];
 export type ControlPlaneCommandMessageType = (typeof CONTROL_PLANE_COMMAND_MESSAGE_TYPES)[number];
@@ -117,12 +119,16 @@ export type HarnessModel = {
     is_default?: boolean;
     capabilities: {
         option_descriptors: HarnessOptionDescriptor[];
+        image_input?: boolean;
     };
 };
 export type HarnessExecutionCapabilities = {
     streaming: boolean;
     multi_turn: boolean;
     session_continuation: boolean;
+    plan_mode?: boolean;
+    native_history?: boolean;
+    conversation_rollback?: boolean;
     sandbox_modes: Array<"read_only" | "workspace_write" | "danger_full_access">;
     approval_policies: Array<"ask" | "auto_edits" | "full_access">;
 };
@@ -281,6 +287,13 @@ export type HcpSessionStartPayload = {
     workspace_preflight?: WorkspacePreflight;
     local_capability_lease?: LocalCapabilityLease;
     mcp_servers: McpServerAttachment[];
+    first_turn?: {
+        turn_id: string;
+        input: string;
+        not_after: string;
+        mode?: "execute" | "plan";
+        images?: HcpImageInput[];
+    };
 };
 export type HcpSessionSnapshotRequestPayload = {
     session_id: string;
@@ -289,6 +302,8 @@ export type HcpTurnSendPayload = {
     session_id: string;
     turn_id: string;
     input: string;
+    mode?: "execute" | "plan";
+    images?: HcpImageInput[];
     model_selection?: HarnessModelSelection;
 };
 export type HcpTurnCancelPayload = {
@@ -774,6 +789,7 @@ export declare const harnessModelSchema: z.ZodObject<{
             current_value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>;
             prompt_injected_values: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
+        image_input: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 export declare const harnessProviderSnapshotSchema: z.ZodObject<{
@@ -781,6 +797,9 @@ export declare const harnessProviderSnapshotSchema: z.ZodObject<{
         streaming: z.ZodBoolean;
         multi_turn: z.ZodBoolean;
         session_continuation: z.ZodBoolean;
+        plan_mode: z.ZodOptional<z.ZodBoolean>;
+        native_history: z.ZodOptional<z.ZodBoolean>;
+        conversation_rollback: z.ZodOptional<z.ZodBoolean>;
         sandbox_modes: z.ZodArray<z.ZodEnum<{
             read_only: "read_only";
             workspace_write: "workspace_write";
@@ -846,6 +865,7 @@ export declare const harnessProviderSnapshotSchema: z.ZodObject<{
                 current_value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>;
                 prompt_injected_values: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
+            image_input: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>;
     }, z.core.$strict>>;
     hidden_models: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -962,6 +982,9 @@ export declare const hcpHostCapabilitiesUpdatedPayloadSchema: z.ZodObject<{
             streaming: z.ZodBoolean;
             multi_turn: z.ZodBoolean;
             session_continuation: z.ZodBoolean;
+            plan_mode: z.ZodOptional<z.ZodBoolean>;
+            native_history: z.ZodOptional<z.ZodBoolean>;
+            conversation_rollback: z.ZodOptional<z.ZodBoolean>;
             sandbox_modes: z.ZodArray<z.ZodEnum<{
                 read_only: "read_only";
                 workspace_write: "workspace_write";
@@ -1027,6 +1050,7 @@ export declare const hcpHostCapabilitiesUpdatedPayloadSchema: z.ZodObject<{
                     current_value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>;
                     prompt_injected_values: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 }, z.core.$strict>>;
+                image_input: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strict>;
         }, z.core.$strict>>;
         hidden_models: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1253,6 +1277,18 @@ export declare const mcpServerAttachmentSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     allowed_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     denied_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>], "transport">;
+export declare const HARNESS_IMAGE_MAX_BYTES: number;
+export declare const HARNESS_IMAGE_MIME_TYPES: readonly ["image/gif", "image/jpeg", "image/png", "image/webp"];
+export declare const hcpImageInputSchema: z.ZodObject<{
+    mime_type: z.ZodEnum<{
+        "image/gif": "image/gif";
+        "image/jpeg": "image/jpeg";
+        "image/png": "image/png";
+        "image/webp": "image/webp";
+    }>;
+    data_base64: z.ZodString;
+}, z.core.$strict>;
+export type HcpImageInput = z.infer<typeof hcpImageInputSchema>;
 export declare const hcpSessionStartPayloadSchema: z.ZodObject<{
     session_id: z.ZodString;
     workspace_id: z.ZodString;
@@ -1344,6 +1380,24 @@ export declare const hcpSessionStartPayloadSchema: z.ZodObject<{
         allowed_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         denied_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>], "transport">>;
+    first_turn: z.ZodOptional<z.ZodObject<{
+        turn_id: z.ZodString;
+        input: z.ZodString;
+        not_after: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<{
+            execute: "execute";
+            plan: "plan";
+        }>>;
+        images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            mime_type: z.ZodEnum<{
+                "image/gif": "image/gif";
+                "image/jpeg": "image/jpeg";
+                "image/png": "image/png";
+                "image/webp": "image/webp";
+            }>;
+            data_base64: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export declare const hcpSessionSnapshotRequestPayloadSchema: z.ZodObject<{
     session_id: z.ZodString;
@@ -1352,6 +1406,19 @@ export declare const hcpTurnSendPayloadSchema: z.ZodObject<{
     session_id: z.ZodString;
     turn_id: z.ZodString;
     input: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+        execute: "execute";
+        plan: "plan";
+    }>>;
+    images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        mime_type: z.ZodEnum<{
+            "image/gif": "image/gif";
+            "image/jpeg": "image/jpeg";
+            "image/png": "image/png";
+            "image/webp": "image/webp";
+        }>;
+        data_base64: z.ZodString;
+    }, z.core.$strict>>>;
     model_selection: z.ZodOptional<z.ZodObject<{
         model: z.ZodString;
         options: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -3397,6 +3464,9 @@ export declare const hcpHostCapabilitiesUpdatedMessageSchema: z.ZodObject<{
                 streaming: z.ZodBoolean;
                 multi_turn: z.ZodBoolean;
                 session_continuation: z.ZodBoolean;
+                plan_mode: z.ZodOptional<z.ZodBoolean>;
+                native_history: z.ZodOptional<z.ZodBoolean>;
+                conversation_rollback: z.ZodOptional<z.ZodBoolean>;
                 sandbox_modes: z.ZodArray<z.ZodEnum<{
                     read_only: "read_only";
                     workspace_write: "workspace_write";
@@ -3462,6 +3532,7 @@ export declare const hcpHostCapabilitiesUpdatedMessageSchema: z.ZodObject<{
                         current_value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>;
                         prompt_injected_values: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     }, z.core.$strict>>;
+                    image_input: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strict>;
             }, z.core.$strict>>;
             hidden_models: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -3629,6 +3700,24 @@ export declare const hcpSessionStartMessageSchema: z.ZodObject<{
             allowed_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             denied_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>], "transport">>;
+        first_turn: z.ZodOptional<z.ZodObject<{
+            turn_id: z.ZodString;
+            input: z.ZodString;
+            not_after: z.ZodString;
+            mode: z.ZodOptional<z.ZodEnum<{
+                execute: "execute";
+                plan: "plan";
+            }>>;
+            images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                mime_type: z.ZodEnum<{
+                    "image/gif": "image/gif";
+                    "image/jpeg": "image/jpeg";
+                    "image/png": "image/png";
+                    "image/webp": "image/webp";
+                }>;
+                data_base64: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
@@ -3721,6 +3810,19 @@ export declare const hcpTurnSendMessageSchema: z.ZodObject<{
         session_id: z.ZodString;
         turn_id: z.ZodString;
         input: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<{
+            execute: "execute";
+            plan: "plan";
+        }>>;
+        images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            mime_type: z.ZodEnum<{
+                "image/gif": "image/gif";
+                "image/jpeg": "image/jpeg";
+                "image/png": "image/png";
+                "image/webp": "image/webp";
+            }>;
+            data_base64: z.ZodString;
+        }, z.core.$strict>>>;
         model_selection: z.ZodOptional<z.ZodObject<{
             model: z.ZodString;
             options: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -5028,7 +5130,97 @@ export declare const hcpAccountsSnapshotMessageSchema: z.ZodObject<{
     }, z.core.$strict>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
+export declare const hcpConversationRequestMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"harness.conversation.request">;
+    version: z.ZodLiteral<"hcp.v0">;
+    sent_at: z.ZodString;
+    payload: z.ZodObject<{
+        session_id: z.ZodString;
+        operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"read">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"rollback">;
+            num_turns: z.ZodNumber;
+            expected_history_hash: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"retire">;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export declare const hcpConversationResultMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"harness.conversation.result">;
+    version: z.ZodLiteral<"hcp.v0">;
+    sent_at: z.ZodString;
+    payload: z.ZodObject<{
+        command_id: z.ZodString;
+        session_id: z.ZodString;
+        operation: z.ZodEnum<{
+            read: "read";
+            rollback: "rollback";
+            retire: "retire";
+        }>;
+        filesystem_undo: z.ZodLiteral<false>;
+        history: z.ZodOptional<z.ZodObject<{
+            history_hash: z.ZodString;
+            turn_count: z.ZodNumber;
+            truncated: z.ZodBoolean;
+            turns: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                status: z.ZodString;
+                items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
 export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"harness.conversation.request">;
+    version: z.ZodLiteral<"hcp.v0">;
+    sent_at: z.ZodString;
+    payload: z.ZodObject<{
+        session_id: z.ZodString;
+        operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"read">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"rollback">;
+            num_turns: z.ZodNumber;
+            expected_history_hash: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"retire">;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"harness.conversation.result">;
+    version: z.ZodLiteral<"hcp.v0">;
+    sent_at: z.ZodString;
+    payload: z.ZodObject<{
+        command_id: z.ZodString;
+        session_id: z.ZodString;
+        operation: z.ZodEnum<{
+            read: "read";
+            rollback: "rollback";
+            retire: "retire";
+        }>;
+        filesystem_undo: z.ZodLiteral<false>;
+        history: z.ZodOptional<z.ZodObject<{
+            history_hash: z.ZodString;
+            turn_count: z.ZodNumber;
+            truncated: z.ZodBoolean;
+            turns: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                status: z.ZodString;
+                items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
     id: z.ZodString;
     type: z.ZodLiteral<"host.accounts.read">;
     version: z.ZodLiteral<"hcp.v0">;
@@ -5255,6 +5447,9 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 streaming: z.ZodBoolean;
                 multi_turn: z.ZodBoolean;
                 session_continuation: z.ZodBoolean;
+                plan_mode: z.ZodOptional<z.ZodBoolean>;
+                native_history: z.ZodOptional<z.ZodBoolean>;
+                conversation_rollback: z.ZodOptional<z.ZodBoolean>;
                 sandbox_modes: z.ZodArray<z.ZodEnum<{
                     read_only: "read_only";
                     workspace_write: "workspace_write";
@@ -5320,6 +5515,7 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         current_value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber]>>;
                         prompt_injected_values: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     }, z.core.$strict>>;
+                    image_input: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strict>;
             }, z.core.$strict>>;
             hidden_models: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -5485,6 +5681,24 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             allowed_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             denied_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>], "transport">>;
+        first_turn: z.ZodOptional<z.ZodObject<{
+            turn_id: z.ZodString;
+            input: z.ZodString;
+            not_after: z.ZodString;
+            mode: z.ZodOptional<z.ZodEnum<{
+                execute: "execute";
+                plan: "plan";
+            }>>;
+            images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                mime_type: z.ZodEnum<{
+                    "image/gif": "image/gif";
+                    "image/jpeg": "image/jpeg";
+                    "image/png": "image/png";
+                    "image/webp": "image/webp";
+                }>;
+                data_base64: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>, z.ZodObject<{
@@ -5574,6 +5788,19 @@ export declare const hcpMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         session_id: z.ZodString;
         turn_id: z.ZodString;
         input: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<{
+            execute: "execute";
+            plan: "plan";
+        }>>;
+        images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            mime_type: z.ZodEnum<{
+                "image/gif": "image/gif";
+                "image/jpeg": "image/jpeg";
+                "image/png": "image/png";
+                "image/webp": "image/webp";
+            }>;
+            data_base64: z.ZodString;
+        }, z.core.$strict>>>;
         model_selection: z.ZodOptional<z.ZodObject<{
             model: z.ZodString;
             options: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -6763,7 +6990,7 @@ export type LocalActionRequestMessage = HcpEnvelope<"local.action.request", Loca
 export type LocalActionResponseMessage = HcpEnvelope<"local.action.response", LocalActionResponsePayload>;
 export type LocalActionErrorMessage = HcpEnvelope<"local.action.error", LocalActionErrorPayload>;
 export type HcpHarnessEventMessage = HcpEnvelope<"harness.event", HcpHarnessEventPayload>;
-export type HcpMessage = HcpEnvelope<"host.accounts.read", HcpAccountsReadPayload> | HcpEnvelope<"host.accounts.snapshot", HcpAccountsSnapshotPayload> | HcpEnvelope<"host.workspaces.request", HcpWorkspacesRequestPayload> | HcpEnvelope<"host.workspaces.result", HcpWorkspacesResultPayload> | HcpCommandAckMessage | HcpCommandNackMessage | HcpHostHelloMessage | HcpHostAcceptedMessage | HcpHostRejectedMessage | HcpHostHeartbeatMessage | HcpHostCapabilitiesUpdatedMessage | HcpHostReplayUnavailableMessage | HcpSessionStartMessage | HcpSessionSnapshotRequestMessage | HcpSessionSnapshotMessage | HcpTurnSendMessage | HcpTurnCancelMessage | HcpSessionStopMessage | HcpApprovalRespondMessage | HcpInputRespondMessage | ToolServersDetachMessage | LocalActionRequestMessage | LocalActionResponseMessage | LocalActionErrorMessage | HcpHarnessEventMessage;
+export type HcpMessage = HcpEnvelope<"host.accounts.read", HcpAccountsReadPayload> | HcpEnvelope<"host.accounts.snapshot", HcpAccountsSnapshotPayload> | HcpEnvelope<"host.workspaces.request", HcpWorkspacesRequestPayload> | HcpEnvelope<"host.workspaces.result", HcpWorkspacesResultPayload> | HcpCommandAckMessage | HcpCommandNackMessage | HcpHostHelloMessage | HcpHostAcceptedMessage | HcpHostRejectedMessage | HcpHostHeartbeatMessage | HcpHostCapabilitiesUpdatedMessage | HcpHostReplayUnavailableMessage | HcpSessionStartMessage | HcpSessionSnapshotRequestMessage | HcpSessionSnapshotMessage | HcpTurnSendMessage | HcpTurnCancelMessage | HcpSessionStopMessage | HcpApprovalRespondMessage | HcpInputRespondMessage | ToolServersDetachMessage | LocalActionRequestMessage | LocalActionResponseMessage | LocalActionErrorMessage | HcpEnvelope<"harness.conversation.request", HcpConversationRequestPayload> | HcpEnvelope<"harness.conversation.result", HcpConversationResultPayload> | HcpHarnessEventMessage;
 export type HcpKnownMessageType = HcpMessage["type"];
 export declare function parseHcpEnvelope(input: unknown): HcpEnvelope<string, unknown>;
 export declare function parseHcpMessage(input: unknown): HcpMessage;
@@ -6789,4 +7016,5 @@ export declare function parseHcpHarnessEventPayload(input: unknown): HcpHarnessE
 export { HcpSessionEventReducer, type HcpEventApplyResult, type HcpSnapshotApplyResult, } from "./session-reducer.js";
 export * from "./pairing.js";
 export * from "./mcp-review.js";
+export * from "./native-review.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,5 +1,7 @@
 import { hcpAccountsReadPayloadSchema, hcpAccountsSnapshotPayloadSchema } from "./accounts.js";
 export * from "./accounts.js";
+import { hcpConversationRequestPayloadSchema, hcpConversationResultPayloadSchema } from "./conversation.js";
+export * from "./conversation.js";
 import { z } from "zod";
 export const HCP_VERSION = "hcp.v0";
 export const HCP_METADATA_MAX_ENCODED_BYTES = 16 * 1024;
@@ -19,6 +21,7 @@ export const HOST_LIFECYCLE_MESSAGE_TYPES = [
 ];
 export const CONTROL_PLANE_COMMAND_MESSAGE_TYPES = [
     "harness.session.start",
+    "harness.conversation.request",
     "harness.session.snapshot.request",
     "harness.turn.send",
     "harness.turn.cancel",
@@ -34,7 +37,7 @@ export const LOCAL_ACTION_MESSAGE_TYPES = [
     "local.action.error",
 ];
 export const RUNTIME_EVENT_MESSAGE_TYPES = ["harness.event"];
-export const SESSION_SNAPSHOT_MESSAGE_TYPES = ["harness.session.snapshot"];
+export const SESSION_SNAPSHOT_MESSAGE_TYPES = ["harness.session.snapshot", "harness.conversation.result"];
 export const KNOWN_HCP_EVENT_TYPES = [
     "session.started",
     "session.configured",
@@ -260,6 +263,7 @@ export const harnessModelSchema = z
     capabilities: z
         .object({
         option_descriptors: z.array(harnessOptionDescriptorSchema),
+        image_input: z.boolean().optional(),
     })
         .strict(),
 })
@@ -270,6 +274,9 @@ export const harnessProviderSnapshotSchema = z
         streaming: z.boolean(),
         multi_turn: z.boolean(),
         session_continuation: z.boolean(),
+        plan_mode: z.boolean().optional(),
+        native_history: z.boolean().optional(),
+        conversation_rollback: z.boolean().optional(),
         sandbox_modes: z.array(z.enum(["read_only", "workspace_write", "danger_full_access"])),
         approval_policies: z.array(z.enum(["ask", "auto_edits", "full_access"])),
     }).strict().optional(),
@@ -489,6 +496,11 @@ export const mcpServerAttachmentSchema = z.discriminatedUnion("transport", [
     streamableHttpMcpServerAttachmentSchema,
     runnerStdioMcpProfileAttachmentSchema,
 ]);
+export const HARNESS_IMAGE_MAX_BYTES = 384 * 1024;
+export const HARNESS_IMAGE_MIME_TYPES = ["image/gif", "image/jpeg", "image/png", "image/webp"];
+export const hcpImageInputSchema = z.object({ mime_type: z.enum(HARNESS_IMAGE_MIME_TYPES),
+    data_base64: z.string().min(4).max(HARNESS_IMAGE_MAX_BYTES * 4 / 3).regex(/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/) }).strict();
+const harnessImagesSchema = z.array(hcpImageInputSchema).min(1).max(4).refine(images => images.reduce((bytes, image) => bytes + image.data_base64.length, 0) <= HARNESS_IMAGE_MAX_BYTES * 4 / 3, "Image aggregate exceeds the transport limit.");
 export const hcpSessionStartPayloadSchema = z
     .object({
     session_id: nonEmptyStringSchema,
@@ -504,6 +516,13 @@ export const hcpSessionStartPayloadSchema = z
     workspace_preflight: workspacePreflightSchema.optional(),
     local_capability_lease: localCapabilityLeaseSchema.optional(),
     mcp_servers: z.array(mcpServerAttachmentSchema),
+    first_turn: z.object({
+        turn_id: nonEmptyStringSchema,
+        input: z.string(),
+        not_after: timestampSchema,
+        mode: z.enum(["execute", "plan"]).optional(),
+        images: harnessImagesSchema.optional(),
+    }).strict().optional(),
 })
     .strict();
 export const hcpSessionSnapshotRequestPayloadSchema = z
@@ -516,6 +535,8 @@ export const hcpTurnSendPayloadSchema = z
     session_id: nonEmptyStringSchema,
     turn_id: nonEmptyStringSchema,
     input: z.string(),
+    mode: z.enum(["execute", "plan"]).optional(),
+    images: harnessImagesSchema.optional(),
     model_selection: harnessModelSelectionSchema.optional(),
 })
     .strict();
@@ -1309,6 +1330,7 @@ const sessionEventDataSchema = z
     exit_code: z.number().int().optional(),
     model_selection: harnessModelSelectionSchema.optional(),
     mcp_server_count: z.number().int().nonnegative().optional(),
+    native_conversation_ready: z.literal(true).optional(),
     local_capabilities: z.array(nonEmptyStringSchema).optional(),
     message: z.string().optional(),
 })
@@ -1833,7 +1855,10 @@ export const hcpWorkspacesRequestMessageSchema = hcpTypedEnvelopeSchema("host.wo
 export const hcpWorkspacesResultMessageSchema = hcpTypedEnvelopeSchema("host.workspaces.result", hcpWorkspacesResultPayloadSchema);
 export const hcpAccountsReadMessageSchema = hcpTypedEnvelopeSchema("host.accounts.read", hcpAccountsReadPayloadSchema);
 export const hcpAccountsSnapshotMessageSchema = hcpTypedEnvelopeSchema("host.accounts.snapshot", hcpAccountsSnapshotPayloadSchema);
+export const hcpConversationRequestMessageSchema = hcpTypedEnvelopeSchema("harness.conversation.request", hcpConversationRequestPayloadSchema);
+export const hcpConversationResultMessageSchema = hcpTypedEnvelopeSchema("harness.conversation.result", hcpConversationResultPayloadSchema);
 export const hcpMessageSchema = z.discriminatedUnion("type", [
+    hcpConversationRequestMessageSchema, hcpConversationResultMessageSchema,
     hcpAccountsReadMessageSchema,
     hcpAccountsSnapshotMessageSchema,
     hcpWorkspacesRequestMessageSchema,
@@ -1934,4 +1959,5 @@ export function parseHcpHarnessEventPayload(input) {
 export { HcpSessionEventReducer, } from "./session-reducer.js";
 export * from "./pairing.js";
 export * from "./mcp-review.js";
+export * from "./native-review.js";
 //# sourceMappingURL=index.js.map

package/dist/native-review.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+export declare const NATIVE_REVIEW_MAX_ACTION_BYTES: number;
+/** Credential-free presentation; the executable request remains owned by its native adapter. */
+export declare const nativeReviewActionSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"native_operation">;
+    operation: z.ZodEnum<{
+        command: "command";
+        file_change: "file_change";
+    }>;
+    details: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+}, z.core.$strict>;
+export type NativeReviewAction = z.infer<typeof nativeReviewActionSchema>;
+export declare function nativeReviewActionBytes(json: string): Uint8Array;
+export declare function hashNativeReviewAction(json: string): Promise<string>;
+//# sourceMappingURL=native-review.d.ts.map

package/dist/native-review.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export const NATIVE_REVIEW_MAX_ACTION_BYTES = 48 * 1024;
+/** Credential-free presentation; the executable request remains owned by its native adapter. */
+export const nativeReviewActionSchema = z.object({
+    kind: z.literal("native_operation"), operation: z.enum(["command", "file_change"]),
+    details: z.record(z.string(), z.json()),
+}).strict();
+export function nativeReviewActionBytes(json) {
+    const bytes = new TextEncoder().encode(json);
+    if (!bytes.length || bytes.length > NATIVE_REVIEW_MAX_ACTION_BYTES)
+        throw new Error("Native review action exceeds its UTF-8 limit.");
+    nativeReviewActionSchema.parse(JSON.parse(json));
+    return bytes;
+}
+export async function hashNativeReviewAction(json) {
+    const bytes = nativeReviewActionBytes(json);
+    return [...new Uint8Array(await crypto.subtle.digest("SHA-256", Uint8Array.from(bytes)))].map(byte => byte.toString(16).padStart(2, "0")).join("");
+}
+//# sourceMappingURL=native-review.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-control/protocol",
-  "version": "0.4.8",
+  "version": "0.4.10",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",

package/schemas/hcp-message.schema.json

@@ -1,6 +1,238 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "type": "string",
+          "const": "harness.conversation.request"
+        },
+        "version": {
+          "type": "string",
+          "const": "hcp.v0"
+        },
+        "sent_at": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+        },
+        "payload": {
+          "type": "object",
+          "properties": {
+            "session_id": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 512
+            },
+            "operation": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "read"
+                    }
+                  },
+                  "required": [
+                    "kind"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "rollback"
+                    },
+                    "num_turns": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 100
+                    },
+                    "expected_history_hash": {
+                      "type": "string",
+                      "pattern": "^[a-f0-9]{64}$"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "num_turns",
+                    "expected_history_hash"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "retire"
+                    }
+                  },
+                  "required": [
+                    "kind"
+                  ],
+                  "additionalProperties": false
+                }
+              ]
+            }
+          },
+          "required": [
+            "session_id",
+            "operation"
+          ],
+          "additionalProperties": false
+        },
+        "metadata": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "id",
+        "type",
+        "version",
+        "sent_at",
+        "payload"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "type": "string",
+          "const": "harness.conversation.result"
+        },
+        "version": {
+          "type": "string",
+          "const": "hcp.v0"
+        },
+        "sent_at": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+        },
+        "payload": {
+          "type": "object",
+          "properties": {
+            "command_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "session_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "operation": {
+              "type": "string",
+              "enum": [
+                "read",
+                "rollback",
+                "retire"
+              ]
+            },
+            "filesystem_undo": {
+              "type": "boolean",
+              "const": false
+            },
+            "history": {
+              "type": "object",
+              "properties": {
+                "history_hash": {
+                  "type": "string",
+                  "pattern": "^[a-f0-9]{64}$"
+                },
+                "turn_count": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "truncated": {
+                  "type": "boolean"
+                },
+                "turns": {
+                  "maxItems": 100,
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string"
+                      },
+                      "status": {
+                        "type": "string"
+                      },
+                      "items": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "propertyNames": {
+                            "type": "string"
+                          },
+                          "additionalProperties": {
+                            "$ref": "#/$defs/__schema0"
+                          }
+                        }
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "status",
+                      "items"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "history_hash",
+                "turn_count",
+                "truncated",
+                "turns"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "command_id",
+            "session_id",
+            "operation",
+            "filesystem_undo"
+          ],
+          "additionalProperties": false
+        },
+        "metadata": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "id",
+        "type",
+        "version",
+        "sent_at",
+        "payload"
+      ],
+      "additionalProperties": false
+    },
     {
       "type": "object",
       "properties": {
@@ -1168,6 +1400,15 @@
                       "session_continuation": {
                         "type": "boolean"
                       },
+                      "plan_mode": {
+                        "type": "boolean"
+                      },
+                      "native_history": {
+                        "type": "boolean"
+                      },
+                      "conversation_rollback": {
+                        "type": "boolean"
+                      },
                       "sandbox_modes": {
                         "type": "array",
                         "items": {
@@ -1387,6 +1628,9 @@
                                 ],
                                 "additionalProperties": false
                               }
+                            },
+                            "image_input": {
+                              "type": "boolean"
                             }
                           },
                           "required": [
@@ -2166,6 +2410,66 @@
                   }
                 ]
               }
+            },
+            "first_turn": {
+              "type": "object",
+              "properties": {
+                "turn_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "input": {
+                  "type": "string"
+                },
+                "not_after": {
+                  "type": "string",
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                },
+                "mode": {
+                  "type": "string",
+                  "enum": [
+                    "execute",
+                    "plan"
+                  ]
+                },
+                "images": {
+                  "minItems": 1,
+                  "maxItems": 4,
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "mime_type": {
+                        "type": "string",
+                        "enum": [
+                          "image/gif",
+                          "image/jpeg",
+                          "image/png",
+                          "image/webp"
+                        ]
+                      },
+                      "data_base64": {
+                        "type": "string",
+                        "minLength": 4,
+                        "maxLength": 524288,
+                        "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
+                      }
+                    },
+                    "required": [
+                      "mime_type",
+                      "data_base64"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "turn_id",
+                "input",
+                "not_after"
+              ],
+              "additionalProperties": false
             }
           },
           "required": [
@@ -2609,6 +2913,43 @@
             "input": {
               "type": "string"
             },
+            "mode": {
+              "type": "string",
+              "enum": [
+                "execute",
+                "plan"
+              ]
+            },
+            "images": {
+              "minItems": 1,
+              "maxItems": 4,
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "mime_type": {
+                    "type": "string",
+                    "enum": [
+                      "image/gif",
+                      "image/jpeg",
+                      "image/png",
+                      "image/webp"
+                    ]
+                  },
+                  "data_base64": {
+                    "type": "string",
+                    "minLength": 4,
+                    "maxLength": 524288,
+                    "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
+                  }
+                },
+                "required": [
+                  "mime_type",
+                  "data_base64"
+                ],
+                "additionalProperties": false
+              }
+            },
             "model_selection": {
               "type": "object",
               "properties": {
@@ -7959,6 +8300,10 @@
                   "minimum": 0,
                   "maximum": 9007199254740991
                 },
+                "native_conversation_ready": {
+                  "type": "boolean",
+                  "const": true
+                },
                 "local_capabilities": {
                   "type": "array",
                   "items": {
@@ -8153,6 +8498,10 @@
                   "minimum": 0,
                   "maximum": 9007199254740991
                 },
+                "native_conversation_ready": {
+                  "type": "boolean",
+                  "const": true
+                },
                 "local_capabilities": {
                   "type": "array",
                   "items": {
@@ -8347,6 +8696,10 @@
                   "minimum": 0,
                   "maximum": 9007199254740991
                 },
+                "native_conversation_ready": {
+                  "type": "boolean",
+                  "const": true
+                },
                 "local_capabilities": {
                   "type": "array",
                   "items": {
@@ -8541,6 +8894,10 @@
                   "minimum": 0,
                   "maximum": 9007199254740991
                 },
+                "native_conversation_ready": {
+                  "type": "boolean",
+                  "const": true
+                },
                 "local_capabilities": {
                   "type": "array",
                   "items": {
@@ -18962,6 +19319,39 @@
       "additionalProperties": false
     }
   ],
+  "$defs": {
+    "__schema0": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/__schema0"
+          }
+        },
+        {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/__schema0"
+          }
+        }
+      ]
+    }
+  },
   "$id": "https://schemas.harness-control.local/hcp.v0/message.schema.json",
   "title": "HCP protocol message",
   "description": "Structural JSON Schema for known hcp.v0 protocol messages. Runtime parsers enforce additional cross-field invariants such as lease-to-attribution equality."