@harness-control/protocol 0.4.9 → 0.4.11

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<{
+            plan: "plan";
+            execute: "execute";
+        }>>;
+        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<{
+        plan: "plan";
+        execute: "execute";
+    }>>;
+    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<{
+                plan: "plan";
+                execute: "execute";
+            }>>;
+            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<{
+            plan: "plan";
+            execute: "execute";
+        }>>;
+        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<{
+                plan: "plan";
+                execute: "execute";
+            }>>;
+            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<{
+            plan: "plan";
+            execute: "execute";
+        }>>;
+        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/fixtures/conformance/invalid/accounts-negative-quota.json

@@ -1,35 +1,35 @@
-{
-  "id": "account-fixture",
-  "version": "hcp.v0",
-  "sent_at": "2026-09-12T00:00:00Z",
-  "type": "host.accounts.snapshot",
-  "payload": {
-    "request_id": "read-1",
-    "host_id": "host-1",
-    "providers": [
-      {
-        "provider_instance_id": "codex",
-        "observation": {
-          "status": "available",
-          "observed_at": "2026-09-12T00:00:00Z",
-          "account": {
-            "key": "account-1",
-            "provider": "codex",
-            "scope_source": "operator",
-            "label": "Work"
-          },
-          "source": "codex_app_server",
-          "limits": [
-            {
-              "id": "weekly",
-              "label": "Weekly",
-              "kind": "quota",
-              "used_percent": -1,
-              "resets_at": "2026-09-19T00:00:00Z"
-            }
-          ]
-        }
-      }
-    ]
-  }
-}
+{
+  "id": "account-fixture",
+  "version": "hcp.v0",
+  "sent_at": "2026-09-12T00:00:00Z",
+  "type": "host.accounts.snapshot",
+  "payload": {
+    "request_id": "read-1",
+    "host_id": "host-1",
+    "providers": [
+      {
+        "provider_instance_id": "codex",
+        "observation": {
+          "status": "available",
+          "observed_at": "2026-09-12T00:00:00Z",
+          "account": {
+            "key": "account-1",
+            "provider": "codex",
+            "scope_source": "operator",
+            "label": "Work"
+          },
+          "source": "codex_app_server",
+          "limits": [
+            {
+              "id": "weekly",
+              "label": "Weekly",
+              "kind": "quota",
+              "used_percent": -1,
+              "resets_at": "2026-09-19T00:00:00Z"
+            }
+          ]
+        }
+      }
+    ]
+  }
+}