@harness-gw/sdk 0.7.0 → 0.9.0

package/README.md

@@ -63,7 +63,7 @@ You need a running harness. Hermes is the primary one; see
    docker run --rm \
      -v "$PWD/config.yaml:/run/harness-gw/config.yaml:ro" \
      -v "$PWD/hermes-token:/run/secrets/hermes-token:ro" \
-     ghcr.io/almogbaku/harness-gw:0.7.0 \
+     ghcr.io/almogbaku/harness-gw:0.9.0 \
      config check --config /run/harness-gw/config.yaml
    ```
 
@@ -73,7 +73,7 @@ You need a running harness. Hermes is the primary one; see
    docker run --rm -p 127.0.0.1:4100:4100 \
      -v "$PWD/config.yaml:/run/harness-gw/config.yaml:ro" \
      -v "$PWD/hermes-token:/run/secrets/hermes-token:ro" \
-     ghcr.io/almogbaku/harness-gw:0.7.0 \
+     ghcr.io/almogbaku/harness-gw:0.9.0 \
      serve --config /run/harness-gw/config.yaml
    ```
 

package/dist/chunks/index.js

@@ -282,11 +282,49 @@ var SessionPlanActivityMessageSchema2 = z.strictObject({
     todos: z.array(TodoSchema).max(1e4)
   })
 });
+var SessionCompactionActivityMessageSchema2 = z.strictObject({
+  id: IdentifierSchema,
+  role: z.literal("activity"),
+  activityType: z.literal("COMPACTION"),
+  content: z.strictObject({
+    compactionId: IdentifierSchema,
+    summary: z.string().max(1e6).optional()
+  })
+});
+var SessionChildActivityMessageSchema2 = z.strictObject({
+  id: IdentifierSchema,
+  role: z.literal("activity"),
+  activityType: z.literal("CHILD_SESSION"),
+  content: z.strictObject({
+    childSessionId: IdentifierSchema,
+    toolCallId: IdentifierSchema.optional(),
+    title: z.string().max(65536).optional(),
+    description: z.string().max(65536).optional(),
+    status: z.enum([
+      "running",
+      "waiting-for-input",
+      "idle",
+      "failed",
+      "cancelled",
+      "unknown"
+    ]).optional(),
+    model: z.string().min(1).max(256).optional(),
+    filesRead: z.array(z.string().max(4096)).max(1000).optional(),
+    filesWritten: z.array(z.string().max(4096)).max(1000).optional(),
+    durationMs: z.number().int().nonnegative().optional(),
+    summary: z.string().max(65536).optional()
+  })
+});
+var SessionActivityMessageSchema2 = z.discriminatedUnion("activityType", [
+  SessionPlanActivityMessageSchema2,
+  SessionCompactionActivityMessageSchema2,
+  SessionChildActivityMessageSchema2
+]);
 var SessionHistoryResponseSchema2 = z.strictObject({
   sessionId: IdentifierSchema,
   messages: z.array(z.discriminatedUnion("role", [
     SessionMessageSchema2,
-    SessionPlanActivityMessageSchema2
+    SessionActivityMessageSchema2
   ])).max(501),
   total: z.number().int().min(0),
   limit: z.number().int().min(1).max(500),
@@ -392,6 +430,13 @@ var SessionWorkspaceCapabilitiesResponseSchema2 = z.strictObject({
       }),
       CapabilityUnavailableSchema
     ]),
+    rewind: z.union([
+      z.strictObject({
+        status: z.literal("available"),
+        scope: z.literal("user-turn")
+      }),
+      CapabilityUnavailableSchema
+    ]),
     approvals: z.strictObject({
       status: z.literal("available"),
       protocol: z.literal(INTERACTION_PROTOCOL2),
@@ -690,7 +735,7 @@ function hgwAcpAgentPath2(agentId) {
   return `${HGW_ACP_AGENTS_PATH2}/${encodeURIComponent(agentId)}`;
 }
 var HGW_META_KEY2 = "hgw";
-var HGW_EXTENSION_VERSION2 = 1;
+var HGW_EXTENSION_VERSION2 = 2;
 var HGW_AUTH_METHOD_INVITE2 = "hgw-invite";
 var HGW_ATTACHMENT_URI_SCHEME2 = "hgw-attachment:";
 var HGW_ARTIFACT_URI_SCHEME2 = "artifact:";
@@ -715,10 +760,6 @@ var HGW_METHODS2 = {
     error: "_hgw/error"
   }
 };
-var HGW_STOP_REASONS2 = {
-  error: "_hgw_error",
-  uncertain: "_hgw_uncertain"
-};
 var HGW_PERMISSION_KIND_SESSION2 = "_allow_session";
 var HGW_PLAN_ID2 = "todos";
 var HGW_JSONRPC_ERRORS2 = {
@@ -727,7 +768,6 @@ var HGW_JSONRPC_ERRORS2 = {
   revisionConflict: -31012,
   temporarilyUnavailable: -31013,
   uncertainMutation: -31014,
-  unsupported: -31015,
   requestTooLarge: -31016
 };
 var HGW_MAX_FRAME_BYTES2 = 1100000;
@@ -793,9 +833,14 @@ var HgwSessionInfoMetaSchema2 = readObject({
   platform: SessionPlatformSchema2.optional()
 });
 var HgwSessionResumeMetaSchema2 = z2.strictObject({
-  agentId: IdentifierSchema2.optional(),
-  after: SequenceSchema.optional(),
-  turnId: IdentifierSchema2.optional()
+  agentId: IdentifierSchema2.optional()
+});
+var HGW_REPLAY_POSITION2 = "_hgw/position";
+var HgwReplayPositionSchema2 = z2.strictObject({
+  type: z2.literal(HGW_REPLAY_POSITION2),
+  turnId: IdentifierSchema2.optional(),
+  from: z2.number().int().min(1).optional(),
+  _meta: z2.record(z2.string(), z2.unknown()).nullish()
 });
 var HGW_REPLAY_BEFORE2 = "_hgw/before";
 var HgwReplayBeforeSchema2 = z2.strictObject({
@@ -851,7 +896,8 @@ var HgwAgentUpdateRequestSchema2 = z2.strictObject({ agentId: IdentifierSchema2,
 var HgwAgentUpdateResponseSchema2 = AgentUpdateResponseSchema2;
 var TurnMetaBase = {
   sequence: SequenceSchema,
-  turnId: IdentifierSchema2
+  turnId: IdentifierSchema2,
+  background: z2.literal(true).optional()
 };
 var HgwTurnMetaSchema2 = readObject(TurnMetaBase);
 var NoticeKindSchema = z2.string().min(1).max(64);
@@ -871,29 +917,15 @@ var HgwCostSchema2 = readObject({
   amount: z2.number().nonnegative(),
   currency: z2.string().min(1).max(16)
 });
-var HGW_SUBAGENT_STATUSES2 = [
-  "running",
-  "completed",
-  "failed",
-  "cancelled"
-];
-var HgwSubagentSchema2 = readObject({
-  id: IdentifierSchema2,
-  goal: z2.string().max(65536).optional(),
+var HgwChildSessionMetaSchema2 = readObject({
+  ...TurnMetaBase,
+  toolCallId: IdentifierSchema2.optional(),
   model: z2.string().min(1).max(256).optional(),
-  depth: z2.number().int().min(1).optional(),
-  status: z2.enum(HGW_SUBAGENT_STATUSES2).optional(),
-  tokens: CountSchema.optional(),
-  filesRead: z2.array(z2.string()).optional(),
-  filesWritten: z2.array(z2.string()).optional(),
+  filesRead: z2.array(z2.string().max(4096)).max(1000).optional(),
+  filesWritten: z2.array(z2.string().max(4096)).max(1000).optional(),
   durationMs: CountSchema.optional(),
-  childSessionId: IdentifierSchema2.optional(),
   summary: z2.string().max(65536).optional()
 });
-var SubagentAttribution = {
-  subagentId: IdentifierSchema2.optional(),
-  parentToolCallId: IdentifierSchema2.optional()
-};
 var HgwStateMetaSchema2 = readObject({
   ...TurnMetaBase,
   at: z2.iso.datetime().optional(),
@@ -904,20 +936,15 @@ var HgwStateMetaSchema2 = readObject({
   model: z2.string().min(1).max(256).optional(),
   cost: HgwCostSchema2.optional()
 });
-var HgwChunkMetaSchema2 = readObject({
-  ...TurnMetaBase,
-  ...SubagentAttribution
-});
+var HgwChunkMetaSchema2 = readObject({ ...TurnMetaBase });
 var HgwToolCallMetaSchema2 = readObject({
   ...TurnMetaBase,
-  ...SubagentAttribution,
   messageId: IdentifierSchema2,
   argsTextDelta: z2.string().optional(),
   argsText: z2.string().optional(),
   startedAt: z2.iso.datetime().optional(),
   completedAt: z2.iso.datetime().optional(),
   durationMs: CountSchema.optional(),
-  subagent: HgwSubagentSchema2.optional(),
   app: z2.strictObject({}).optional()
 });
 var HgwPlanMetaSchema2 = readObject({
@@ -1182,4 +1209,4 @@ var MCP_APP_SANDBOX_CSP2 = [
   "frame-ancestors 'self'"
 ].join("; ");
 
-export { SESSION_CATALOG_MAX_WINDOW2, RuntimeAuthStateSchema2, OperationCapabilitySchema2, RuntimeInfoSchema2, AgentAvatarSchema2, AgentCatalogEntrySchema2, AgentCatalogResponseSchema2, AgentUpdateFields2, writesAgentField2, AgentUpdateRequestSchema2, AgentUpdateResponseSchema2, SessionStatusSchema2, SessionPlatformSchema2, SessionSchema2, newestSessionFirst2, SessionCatalogResponseSchema2, StopReason2, ToolKind2, ToolLocationSchema2, DiffOperation2, DiffChangeSchema2, ToolDiffSchema2, SessionMessageErrorStatusSchema2, SessionMessageSchema2, SessionPlanActivityMessageSchema2, SessionHistoryResponseSchema2, SessionCreateRequestSchema2, SessionCreateResponseSchema2, SessionPatchRequestSchema2, TurnStopResponseSchema2, TurnSteerRequestSchema2, TurnSteerResponseSchema2, SlashCommandSchema2, MAX_SLASH_COMMANDS2, INTERACTION_PROTOCOL2, SessionWorkspaceCapabilitiesResponseSchema2, GuestRuntimeCapabilitiesResponseSchema2, SessionModelsResponseSchema2, SessionModelUpdateRequestSchema2, SessionModelUpdateResponseSchema2, SessionContextResponseSchema2, ArtifactDescriptorSchema2, SessionTodosResponseSchema2, SessionActivityResponseSchema2, SessionAttachmentStageRequestSchema2, SessionAttachmentStageResponseSchema2, SessionAudioResponseSchema2, SessionTranscriptionRequestSchema2, SessionTranscriptionResponseSchema2, SessionSpeechRequestSchema2, ErrorResponseSchema2, ACP_PROTOCOL_VERSION2, HGW_API_PREFIX2, HGW_ACP_PATH2, HGW_ACP_AGENTS_PATH2, hgwAcpAgentPath2, HGW_META_KEY2, HGW_EXTENSION_VERSION2, HGW_AUTH_METHOD_INVITE2, HGW_ATTACHMENT_URI_SCHEME2, HGW_ARTIFACT_URI_SCHEME2, HGW_METHODS2, HGW_STOP_REASONS2, HGW_PERMISSION_KIND_SESSION2, HGW_PLAN_ID2, HGW_JSONRPC_ERRORS2, HGW_MAX_FRAME_BYTES2, IdentifierSchema2, HgwExtensionsSchema2, HgwClientCapabilitiesMetaSchema2, HgwInitializeMetaSchema2, HgwLoginMetaSchema2, HgwSessionNewMetaSchema2, HgwSessionListMetaSchema2, HgwSessionSearchMetaSchema2, HgwSessionSearchResponseSchema2, HgwSessionInfoMetaSchema2, HgwSessionResumeMetaSchema2, HGW_REPLAY_BEFORE2, HgwReplayBeforeSchema2, HgwHistoryCursorSchema2, HgwHistoryPageResponseMetaSchema2, HgwHistoryPageTagSchema2, HgwSessionResumeResponseMetaSchema2, HgwPromptMetaSchema2, HgwSessionUpdateRequestSchema2, HgwSessionPartRequestSchema2, HgwSteerRequestSchema2, HgwSteerResponseSchema2, HgwFocusRequestSchema2, HgwAgentsListResponseSchema2, HgwAgentUpdateRequestSchema2, HgwAgentUpdateResponseSchema2, HgwTurnMetaSchema2, HgwNoticeMetaSchema2, HgwMessageMetaSchema2, HgwCostSchema2, HGW_SUBAGENT_STATUSES2, HgwSubagentSchema2, HgwStateMetaSchema2, HgwChunkMetaSchema2, HgwToolCallMetaSchema2, HgwPlanMetaSchema2, HgwUsageMetaSchema2, HgwAvailableCommandsMetaSchema2, HgwPermissionMetaSchema2, HgwQuestionOptionSchema2, HgwQuestionSchema2, HgwElicitationMetaSchema2, HgwArtifactDescriptorSchema2, formatArtifactUri2, parseArtifactUri2, HgwComposerPrefillNotificationSchema2, HgwErrorNotificationSchema2, HGW_REQUEST_TEXT_MAX2, HgwActivityNotificationSchema2, PushCategorySchema2, categoryOf2, PushLocaleSchema2, PRESENCE_IDLE_MS2, PRESENCE_HEARTBEAT_MS2, PRESENCE_GRACE_MS2, PRESENCE_CLOSED_GRACE_MS2, COALESCE_WINDOW_MS2, PUSH_TEXT_LIMITS2, PushMessageSchema2, PushCategoriesSchema2, PushSubscriptionJsonSchema2, PushInfoSchema2, PushRegistrationSchema2, PushUnregistrationSchema2, CallToolResultSchema2, ReadResourceResultSchema2, McpUiCspSchema2, isMcpAppCspDomain2, McpUiPermissionsSchema2, McpAppFilesSchema2, McpAppViewSchema2, viewerFileResult2, McpAppToolCallRequestSchema2, McpAppResourceReadRequestSchema2, MCP_APP_SANDBOX_PATH2, MCP_APP_SANDBOX_CSP2 };
+export { SESSION_CATALOG_MAX_WINDOW2, RuntimeAuthStateSchema2, OperationCapabilitySchema2, RuntimeInfoSchema2, AgentAvatarSchema2, AgentCatalogEntrySchema2, AgentCatalogResponseSchema2, AgentUpdateFields2, writesAgentField2, AgentUpdateRequestSchema2, AgentUpdateResponseSchema2, SessionStatusSchema2, SessionPlatformSchema2, SessionSchema2, newestSessionFirst2, SessionCatalogResponseSchema2, StopReason2, ToolKind2, ToolLocationSchema2, DiffOperation2, DiffChangeSchema2, ToolDiffSchema2, SessionMessageErrorStatusSchema2, SessionMessageSchema2, SessionPlanActivityMessageSchema2, SessionCompactionActivityMessageSchema2, SessionChildActivityMessageSchema2, SessionActivityMessageSchema2, SessionHistoryResponseSchema2, SessionCreateRequestSchema2, SessionCreateResponseSchema2, SessionPatchRequestSchema2, TurnStopResponseSchema2, TurnSteerRequestSchema2, TurnSteerResponseSchema2, SlashCommandSchema2, MAX_SLASH_COMMANDS2, INTERACTION_PROTOCOL2, SessionWorkspaceCapabilitiesResponseSchema2, GuestRuntimeCapabilitiesResponseSchema2, SessionModelsResponseSchema2, SessionModelUpdateRequestSchema2, SessionModelUpdateResponseSchema2, SessionContextResponseSchema2, ArtifactDescriptorSchema2, SessionTodosResponseSchema2, SessionActivityResponseSchema2, SessionAttachmentStageRequestSchema2, SessionAttachmentStageResponseSchema2, SessionAudioResponseSchema2, SessionTranscriptionRequestSchema2, SessionTranscriptionResponseSchema2, SessionSpeechRequestSchema2, ErrorResponseSchema2, ACP_PROTOCOL_VERSION2, HGW_API_PREFIX2, HGW_ACP_PATH2, HGW_ACP_AGENTS_PATH2, hgwAcpAgentPath2, HGW_META_KEY2, HGW_EXTENSION_VERSION2, HGW_AUTH_METHOD_INVITE2, HGW_ATTACHMENT_URI_SCHEME2, HGW_ARTIFACT_URI_SCHEME2, HGW_METHODS2, HGW_PERMISSION_KIND_SESSION2, HGW_PLAN_ID2, HGW_JSONRPC_ERRORS2, HGW_MAX_FRAME_BYTES2, IdentifierSchema2, HgwExtensionsSchema2, HgwClientCapabilitiesMetaSchema2, HgwInitializeMetaSchema2, HgwLoginMetaSchema2, HgwSessionNewMetaSchema2, HgwSessionListMetaSchema2, HgwSessionSearchMetaSchema2, HgwSessionSearchResponseSchema2, HgwSessionInfoMetaSchema2, HgwSessionResumeMetaSchema2, HGW_REPLAY_POSITION2, HgwReplayPositionSchema2, HGW_REPLAY_BEFORE2, HgwReplayBeforeSchema2, HgwHistoryCursorSchema2, HgwHistoryPageResponseMetaSchema2, HgwHistoryPageTagSchema2, HgwSessionResumeResponseMetaSchema2, HgwPromptMetaSchema2, HgwSessionUpdateRequestSchema2, HgwSessionPartRequestSchema2, HgwSteerRequestSchema2, HgwSteerResponseSchema2, HgwFocusRequestSchema2, HgwAgentsListResponseSchema2, HgwAgentUpdateRequestSchema2, HgwAgentUpdateResponseSchema2, HgwTurnMetaSchema2, HgwNoticeMetaSchema2, HgwMessageMetaSchema2, HgwCostSchema2, HgwChildSessionMetaSchema2, HgwStateMetaSchema2, HgwChunkMetaSchema2, HgwToolCallMetaSchema2, HgwPlanMetaSchema2, HgwUsageMetaSchema2, HgwAvailableCommandsMetaSchema2, HgwPermissionMetaSchema2, HgwQuestionOptionSchema2, HgwQuestionSchema2, HgwElicitationMetaSchema2, HgwArtifactDescriptorSchema2, formatArtifactUri2, parseArtifactUri2, HgwComposerPrefillNotificationSchema2, HgwErrorNotificationSchema2, HGW_REQUEST_TEXT_MAX2, HgwActivityNotificationSchema2, PushCategorySchema2, categoryOf2, PushLocaleSchema2, PRESENCE_IDLE_MS2, PRESENCE_HEARTBEAT_MS2, PRESENCE_GRACE_MS2, PRESENCE_CLOSED_GRACE_MS2, COALESCE_WINDOW_MS2, PUSH_TEXT_LIMITS2, PushMessageSchema2, PushCategoriesSchema2, PushSubscriptionJsonSchema2, PushInfoSchema2, PushRegistrationSchema2, PushUnregistrationSchema2, CallToolResultSchema2, ReadResourceResultSchema2, McpUiCspSchema2, isMcpAppCspDomain2, McpUiPermissionsSchema2, McpAppFilesSchema2, McpAppViewSchema2, viewerFileResult2, McpAppToolCallRequestSchema2, McpAppResourceReadRequestSchema2, MCP_APP_SANDBOX_PATH2, MCP_APP_SANDBOX_CSP2 };

package/dist/client/acp-approvals.d.ts

@@ -21,7 +21,7 @@ export type AcpApprovalOption = {
 };
 export type AcpApproval = {
     readonly id: string;
-    /** The tool call the request guards, when the proxy knows it. */
+    /** The tool call the request guards, when the gateway knows it. */
     readonly toolCallId?: string;
     /** The operation asked for, which is the request's title. */
     readonly action: string;

package/dist/client/acp-workspace-client-composer.d.ts

@@ -90,6 +90,13 @@ export declare function createAcpComposerStore(connection: AcpConnection): {
                 input: "text";
                 fallback: "provider-queue";
             };
+            rewind: {
+                status: "unavailable";
+                reason: string;
+            } | {
+                status: "available";
+                scope: "user-turn";
+            };
             approvals: {
                 status: "available";
                 protocol: "acp-request";

package/dist/client/acp-workspace-client-sessions.d.ts

@@ -43,8 +43,11 @@ export declare function createAcpSessionStore({ connection, now, onTurnFinished,
     answer(sessionIds: readonly string[]): void;
     /** The provider's title, as a list page or a subscribed Session reports it. */
     setTitle: (sessionId: string, title: string) => Map<string, string>;
-    /** The proxy's read state, or the operator's own optimistic ack. */
-    setUnread: (sessionId: string, unread: boolean) => void;
+    /**
+     * The gateway's read state, or the operator's own optimistic write;
+     * `undefined` restores a refused one.
+     */
+    setUnread: (sessionId: string, unread: boolean | undefined) => void;
     /** The operator's own optimistic pin; `undefined` restores a refused one. */
     setPinned: (sessionId: string, pinned: boolean | undefined) => void;
     setStatus: (sessionId: string, status: SessionStatus) => void;

package/dist/client/acp-workspace-client.d.ts

@@ -109,6 +109,8 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
     markSessionRead(sessionId: string): Promise<void>;
     /** The row leads the write, so a refused pin has to be taken back. */
     setSessionPinned(sessionId: string, pinned: boolean): Promise<void>;
+    /** As a pin does, the row leads the write and a refusal takes it back. */
+    markSessionUnread(sessionId: string): Promise<void>;
     /**
      * The runtime's own report, read once. A failed read is not an answer, so
      * it is not remembered.
@@ -184,6 +186,13 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
                 input: "text";
                 fallback: "provider-queue";
             };
+            rewind: {
+                status: "unavailable";
+                reason: string;
+            } | {
+                status: "available";
+                scope: "user-turn";
+            };
             approvals: {
                 status: "available";
                 protocol: "acp-request";

package/dist/client/connection.d.ts

@@ -48,7 +48,7 @@ export type AcpConnectionOptions = {
     url?: never;
     socketConstructor?: never;
 });
-/** Whether the proxy refused an invitation it cannot redeem. */
+/** Whether the gateway refused an invitation it cannot redeem. */
 export declare function isAuthenticationRequired(error: unknown): boolean;
 /** One of the gateway's ACP listener paths as a WebSocket URL from `base`. */
 export declare function acpSocketUrl(path: string, base: string): string;

package/dist/client/hgw-client.d.ts

@@ -6,7 +6,7 @@ import type { StagedAttachment } from "./workspace.js";
 export type HgwWorkspaceCapabilities = z.infer<typeof SessionWorkspaceCapabilitiesResponseSchema>;
 export type HgwModelChoices = z.infer<typeof SessionModelsResponseSchema>;
 export type HgwContext = z.infer<typeof SessionContextResponseSchema>;
-export type HgwClientFailure = "connection-interrupted" | "provider-unavailable" | "proxy-failure"
+export type HgwClientFailure = "connection-interrupted" | "provider-unavailable" | "gateway-failure"
 /** The provider no longer holds the bytes a published receipt points at. */
  | "artifact-missing";
 /** What an MCP App view is opened for: a tool call, or a published Artifact. */
@@ -18,10 +18,10 @@ export type McpAppSubject = {
 export declare class HgwClientError extends Error {
     readonly kind: HgwClientFailure;
     readonly code?: string | undefined;
-    /** The proxy's HTTP status, when it answered. */
+    /** The gateway's HTTP status, when it answered. */
     readonly status?: number | undefined;
     constructor(kind: HgwClientFailure, message?: string, code?: string | undefined, 
-    /** The proxy's HTTP status, when it answered. */
+    /** The gateway's HTTP status, when it answered. */
     status?: number | undefined);
 }
 /** The `fetch` the client sends every request with. */
@@ -302,7 +302,7 @@ export declare class HgwRemoteClient {
         addresses: Record<string, string>;
         expiresAt?: string | undefined;
     }>;
-    /** A tool call the App view makes, answered by the proxy's MCP server. */
+    /** A tool call the App view makes, answered by the gateway's MCP server. */
     callMcpAppTool(sessionId: string, toolCallId: string, request: McpAppToolCallRequest): Promise<{
         [x: string]: unknown;
         _meta?: {
@@ -395,7 +395,7 @@ export declare class HgwRemoteClient {
         structuredContent?: unknown;
         isError?: boolean | undefined;
     }>;
-    /** A resource read the App view makes, answered by the proxy's MCP server. */
+    /** A resource read the App view makes, answered by the gateway's MCP server. */
     readMcpAppResource(sessionId: string, subject: McpAppSubject, request: McpAppResourceReadRequest): Promise<{
         [x: string]: unknown;
         _meta?: {

package/dist/client/hgw-notification.d.ts

@@ -1,4 +1,4 @@
 import type { z } from "zod";
 import type { AcpConnection } from "./types.js";
-/** Runs `handler` for every notification of `method` the proxy sends. */
+/** Runs `handler` for every notification of `method` the gateway sends. */
 export declare function subscribeHgwNotification<Value>(connection: Pick<AcpConnection, "subscribeNotification">, method: string, schema: Pick<z.ZodType<Value>, "safeParse">, handler: (value: Value) => void): () => void;

package/dist/client/index.js

@@ -11,7 +11,6 @@ import {
   HGW_EXTENSION_VERSION2,
   HGW_AUTH_METHOD_INVITE2,
   HGW_METHODS2,
-  HGW_STOP_REASONS2,
   HGW_PERMISSION_KIND_SESSION2,
   HGW_JSONRPC_ERRORS2,
   HGW_MAX_FRAME_BYTES2,
@@ -19,6 +18,7 @@ import {
   HgwSessionSearchMetaSchema2,
   HgwSessionSearchResponseSchema2,
   HgwSessionInfoMetaSchema2,
+  HGW_REPLAY_POSITION2,
   HGW_REPLAY_BEFORE2,
   HgwHistoryPageResponseMetaSchema2,
   HgwHistoryPageTagSchema2,
@@ -50,7 +50,8 @@ import {
 import {
   client,
   methods as methods2,
-  RequestError
+  RequestError,
+  SessionUpdate
 } from "@agentclientprotocol/sdk/experimental/v2";
 import {
   createWebSocketStream
@@ -444,7 +445,7 @@ var SESSION_STATES = new Map([
   ["gone", "gone"]
 ]);
 function agentUpdateError(error) {
-  if (codeOf(error) === HGW_JSONRPC_ERRORS2.unsupported)
+  if (codeOf(error) === RequestError.invalidParams().code)
     return new AgentUpdateError("unsupported", "This runtime cannot store that Agent field");
   if (codeOf(error) === HGW_JSONRPC_ERRORS2.revisionConflict)
     return new AgentUpdateError("conflict", "The Agent changed; reload it");
@@ -459,6 +460,12 @@ function acpSocketUrl(path, base) {
   url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
   return url.toString();
 }
+function rejoinCursor(position) {
+  return {
+    type: HGW_REPLAY_POSITION2,
+    ...position === undefined ? {} : { turnId: position.turnId, from: position.after + 1 }
+  };
+}
 function subscribeTo(listeners, listener) {
   listeners.add(listener);
   return () => {
@@ -703,6 +710,8 @@ function createAcpConnection(options) {
   const outageListeners = new Set;
   const sessions = new Map;
   const owners = new Map;
+  const children = new Map;
+  let agentCapabilities;
   let status = "connecting";
   let outage;
   let started = false;
@@ -735,7 +744,19 @@ function createAcpConnection(options) {
     outage = next;
     callEach(outageListeners, logger, "acp.listener.failed", next);
   }
+  function ownerOf(sessionId) {
+    let owner = children.get(sessionId);
+    for (let depth = 0;owner !== undefined && depth < 8; depth += 1) {
+      if (sessions.has(owner))
+        return owner;
+      owner = children.get(owner);
+    }
+    return;
+  }
   function emitPending(request) {
+    const parentSessionId = request.sessionId === undefined ? undefined : ownerOf(request.sessionId);
+    if (parentSessionId !== undefined)
+      request = { ...request, parentSessionId };
     for (const listener of pendingListeners)
       try {
         listener(request);
@@ -793,23 +814,37 @@ function createAcpConnection(options) {
       });
     });
   }
+  function deliverChild(open, childSessionId, update, meta) {
+    for (const { listener } of open.listeners)
+      callEach(listener.child ? [listener.child] : [], logger, "acp.listener.failed", childSessionId, update, meta);
+  }
   const app = client({ name: clientInfo.name }).onNotification(methods2.client.session.update, ({ params }) => {
     const meta = hgwMetaOf(params.update._meta);
-    const open = sessions.get(params.sessionId);
+    if (SessionUpdate.isSubagentUpdate(params.update))
+      children.set(params.update.sessionId, params.sessionId);
+    const owner = sessions.has(params.sessionId) ? undefined : ownerOf(params.sessionId);
+    const open = sessions.get(owner ?? params.sessionId);
     if (!open)
       return;
     if (HgwHistoryPageTagSchema2.safeParse(meta).data?.historyPage) {
-      open.page?.push({ update: params.update, meta });
+      if (owner !== undefined)
+        deliverChild(open, params.sessionId, params.update, meta);
+      else
+        open.page?.push({ update: params.update, meta });
       return;
     }
     const position = HgwChunkMetaSchema2.safeParse(meta);
-    if (position.success)
+    if (position.success && !position.data.background)
       open.position = {
         turnId: position.data.turnId,
         after: position.data.sequence
       };
     if (open.replaying)
       open.replaying.delivered = true;
+    if (owner !== undefined) {
+      deliverChild(open, params.sessionId, params.update, meta);
+      return;
+    }
     for (const { listener } of open.listeners)
       callEach(listener.update ? [listener.update] : [], logger, "acp.listener.failed", params.update, meta);
   }).onRequest(methods2.client.session.requestPermission, ({ params, signal }) => permissionRequest(params, signal)).onRequest(methods2.client.elicitation.create, ({ params, signal }) => elicitationRequest(params, signal));
@@ -903,6 +938,7 @@ function createAcpConnection(options) {
       }
     });
     const announced = hgwMetaOf(response._meta);
+    agentCapabilities = response.capabilities ?? undefined;
     if (announced?.version !== HGW_EXTENSION_VERSION2) {
       const error = new Error(`The gateway speaks hgw extension version ${String(announced?.version)}; this client speaks version ${HGW_EXTENSION_VERSION2}`);
       failInitialized?.(error);
@@ -952,12 +988,9 @@ function createAcpConnection(options) {
       const response = await requestOn(transport, fromStart ? "long" : "medium", (agent, options) => agent.request(methods2.agent.session.resume, {
         sessionId,
         cwd: AGENT_CWD,
-        ...fromStart ? { replayFrom: { type: "start" } } : {},
+        replayFrom: fromStart ? { type: "start" } : rejoinCursor(open.position),
         _meta: {
-          [HGW_META_KEY2]: {
-            ...agentId === undefined ? {} : { agentId },
-            ...fromStart ? {} : open.position
-          }
+          [HGW_META_KEY2]: agentId === undefined ? {} : { agentId }
         }
       }, options), signal);
       const meta = HgwSessionResumeResponseMetaSchema2.parse(hgwMetaOf(response._meta));
@@ -1088,6 +1121,9 @@ function createAcpConnection(options) {
   function part(sessionId, open) {
     sessions.delete(sessionId);
     owners.delete(sessionId);
+    for (const [child, parent] of children)
+      if (parent === sessionId)
+        children.delete(child);
     open.owner?.dispose();
     open.waiters?.reject(notOpen());
     open.waiters = undefined;
@@ -1255,6 +1291,9 @@ function createAcpConnection(options) {
     get status() {
       return status;
     },
+    get capabilities() {
+      return agentCapabilities;
+    },
     start,
     initialized,
     subscribeStatus: (listener) => subscribeTo(statusListeners, listener),
@@ -1272,6 +1311,17 @@ function createAcpConnection(options) {
       }
       return { sessionId };
     },
+    async forkSession(sessionId) {
+      const forked = await request("short", (agent, options) => agent.request(methods2.agent.session.fork, { sessionId, cwd: AGENT_CWD }, options));
+      const agentId = owners.get(sessionId);
+      if (agentId !== undefined)
+        owners.set(forked.sessionId, agentId);
+      if (!sessions.has(forked.sessionId)) {
+        const open = openSession(forked.sessionId, [], true);
+        open.grace = clock.setTimeout(() => part(forked.sessionId, open), PART_GRACE_MS);
+      }
+      return { sessionId: forked.sessionId };
+    },
     async listSessions(meta, cursor) {
       const response = await request("short", (agent, options) => agent.request(methods2.agent.session.list, {
         ...cursor === undefined ? {} : { cursor },
@@ -1352,7 +1402,7 @@ function createAcpConnection(options) {
 // client/acp-workspace-client-composer.ts
 import {
   SessionConfigOption,
-  SessionUpdate
+  SessionUpdate as SessionUpdate2
 } from "@agentclientprotocol/sdk/experimental/v2";
 var MODEL_CATEGORY = "model";
 var EFFORT_CATEGORY = "thought_level";
@@ -1493,9 +1543,9 @@ function createAcpComposerStore(connection) {
   function accept(sessionId, update, meta) {
     const known = sessions.get(sessionId) ?? { projection: {}, writes: 0 };
     sessions.set(sessionId, known);
-    if (SessionUpdate.isConfigOptionUpdate(update)) {
+    if (SessionUpdate2.isConfigOptionUpdate(update)) {
       project(known, sessionId, projectModels(update.configOptions));
-    } else if (SessionUpdate.isAvailableCommandsUpdate(update)) {
+    } else if (SessionUpdate2.isAvailableCommandsUpdate(update)) {
       known.commands = update.availableCommands.map(({ name, description }) => ({ name, description }));
       const aos = HgwAvailableCommandsMetaSchema2.safeParse(meta);
       if (aos.success)
@@ -1503,13 +1553,13 @@ function createAcpComposerStore(connection) {
       if (known.reported)
         known.capabilities = capabilitiesOf(known.reported, known.commands);
       notify(listeners, sessionId);
-    } else if (SessionUpdate.isUsageUpdate(update)) {
+    } else if (SessionUpdate2.isUsageUpdate(update)) {
       const context = projectContext(update, meta);
       if (!context)
         return;
       known.context = context;
       notify(listeners, sessionId);
-    } else if (SessionUpdate.isStateUpdate(update) && update.state === "idle") {
+    } else if (SessionUpdate2.isStateUpdate(update) && update.state === "idle") {
       const aos = HgwStateMetaSchema2.safeParse(meta);
       const turns = foldTurnUsage(known.turns, isUsage(update.usage) ? update.usage : undefined, aos.success ? aos.data.cost : undefined);
       if (turns === known.turns)
@@ -1575,7 +1625,7 @@ function createAcpComposerStore(connection) {
 
 // client/acp-workspace-client-sessions.ts
 import {
-  SessionUpdate as SessionUpdate2,
+  SessionUpdate as SessionUpdate3,
   StateUpdate
 } from "@agentclientprotocol/sdk/experimental/v2";
 
@@ -1594,10 +1644,11 @@ function statusFromState(update) {
     return "running";
   if (StateUpdate.isRequiresAction(update))
     return "waiting-for-input";
+  if (StateUpdate.isUnknown(update))
+    return "failed";
   if (!StateUpdate.isIdle(update))
     return "unknown";
-  const stopReason = update.stopReason;
-  return stopReason === HGW_STOP_REASONS2.error || stopReason === HGW_STOP_REASONS2.uncertain ? "failed" : "idle";
+  return update.stopReason === "error" ? "failed" : "idle";
 }
 var FEED_STATUS = {
   "turn-started": "running",
@@ -1715,7 +1766,7 @@ function createAcpSessionStore({
     callEach(invalidationListeners.get(sessionId) ?? [], logger, "sessions.listener.failed");
   }
   function acceptUpdate(sessionId, update, meta) {
-    if (SessionUpdate2.isStateUpdate(update)) {
+    if (SessionUpdate3.isStateUpdate(update)) {
       const status = statusFromState(update);
       if (replaying.has(sessionId))
         return void replaying.set(sessionId, status);
@@ -1725,7 +1776,7 @@ function createAcpSessionStore({
         onTurnFinished?.(sessionId);
       return;
     }
-    if (SessionUpdate2.isSessionInfoUpdate(update)) {
+    if (SessionUpdate3.isSessionInfoUpdate(update)) {
       if (update.title && update.title !== titles.get(sessionId)) {
         titles.set(sessionId, update.title);
         invalidate(sessionId);
@@ -1735,7 +1786,7 @@ function createAcpSessionStore({
         put(sessionId, info.data, update.updatedAt);
       return;
     }
-    if (!SessionUpdate2.isPlanUpdate(update))
+    if (!SessionUpdate3.isPlanUpdate(update))
       return;
     const plan = HgwPlanMetaSchema2.safeParse(meta);
     if (plan.success)
@@ -2191,12 +2242,23 @@ function createAcpWorkspaceClient({
         throw reason;
       }
     },
+    async markSessionUnread(sessionId) {
+      const [previous] = store.rowsFor([sessionId]);
+      store.setUnread(sessionId, true);
+      try {
+        await connection.updateSession({ sessionId, unread: true });
+      } catch (reason) {
+        store.setUnread(sessionId, previous?.unread);
+        throw reason;
+      }
+    },
     sessionActionCapabilities() {
       sessionActions ??= rest.runtimeInfo().then(({ capabilities }) => ({
         rename: offers(capabilities.sessionTitle),
         archive: offers(capabilities.sessionArchival),
         delete: offers(capabilities.sessionDeletion),
-        pin: offers(capabilities.sessionPin)
+        pin: offers(capabilities.sessionPin),
+        unread: offers(capabilities.sessionReadState)
       })).catch((reason) => {
         sessionActions = undefined;
         throw reason;
@@ -2470,7 +2532,7 @@ class HgwClientError extends Error {
   kind;
   code;
   status;
-  constructor(kind, message = "AOS proxy request failed", code, status) {
+  constructor(kind, message = "Gateway request failed", code, status) {
     super(message);
     this.kind = kind;
     this.code = code;
@@ -2504,7 +2566,7 @@ class HgwRemoteClient {
     this.#authorization = options.authorization;
     this.#origin = options.origin;
   }
-  async#read(path, schema, init, notFound = "proxy-failure") {
+  async#read(path, schema, init, notFound = "gateway-failure") {
     let response;
     try {
       const headers = new Headers(init?.headers);
@@ -2521,17 +2583,17 @@ class HgwRemoteClient {
     }
     if (!response.ok) {
       const error = await normalizedError(response);
-      throw new HgwClientError(response.status === 503 ? "provider-unavailable" : response.status === 404 ? notFound : "proxy-failure", error?.description, error?.code, response.status);
+      throw new HgwClientError(response.status === 503 ? "provider-unavailable" : response.status === 404 ? notFound : "gateway-failure", error?.description, error?.code, response.status);
     }
     let payload;
     try {
       payload = await response.json();
     } catch {
-      throw new HgwClientError("proxy-failure", "Invalid AOS proxy response");
+      throw new HgwClientError("gateway-failure", "Invalid gateway response");
     }
     const parsed = schema.safeParse(payload);
     if (!parsed.success)
-      throw new HgwClientError("proxy-failure", "Invalid AOS proxy response");
+      throw new HgwClientError("gateway-failure", "Invalid gateway response");
     return parsed.data;
   }
   runtimeInfo(signal) {
@@ -2546,7 +2608,7 @@ class HgwRemoteClient {
   async deletePushSubscription(endpoint) {
     const request = PushUnregistrationSchema2.safeParse({ endpoint });
     if (!request.success || !endpoint.trim())
-      throw new HgwClientError("proxy-failure", "Invalid push subscription");
+      throw new HgwClientError("gateway-failure", "Invalid push subscription");
     await this.#write("/push/subscriptions", "DELETE", request.data);
   }
   adoptSessionOwnership(sessionId, agentId) {
@@ -2567,7 +2629,7 @@ class HgwRemoteClient {
       })
     });
     if (!request.success)
-      throw new HgwClientError("proxy-failure", "Invalid attachment staging request");
+      throw new HgwClientError("gateway-failure", "Invalid attachment staging request");
     return this.#read(this.#sessionPath(sessionId, "/attachments/stage"), SessionAttachmentStageResponseSchema2, {
       method: "POST",
       headers: { "content-type": "application/json" },
@@ -2576,11 +2638,11 @@ class HgwRemoteClient {
   }
   async readArtifact(sessionId, artifactId, signal) {
     if (!artifactId.trim() || artifactId.length > 512)
-      throw new HgwClientError("proxy-failure", "Invalid artifact reference");
+      throw new HgwClientError("gateway-failure", "Invalid artifact reference");
     return this.#readBlob(this.#sessionPath(sessionId, `/artifacts/${encodeURIComponent(artifactId)}`), { signal }, "artifact-missing");
   }
   async openMcpApp(sessionId, subject, signal) {
-    const view = await this.#read(this.#mcpAppPath(sessionId, subject), McpAppViewSchema2, { signal }, "artifactId" in subject ? "artifact-missing" : "proxy-failure");
+    const view = await this.#read(this.#mcpAppPath(sessionId, subject), McpAppViewSchema2, { signal }, "artifactId" in subject ? "artifact-missing" : "gateway-failure");
     return view.files ? { ...view, files: this.#absoluteFiles(view.files) } : view;
   }
   async renewMcpAppFiles(sessionId, subject) {
@@ -2607,13 +2669,13 @@ class HgwRemoteClient {
   }
   async transcribeForAgent(agentId, audio, signal) {
     if (!audio.size || !audio.type)
-      throw new HgwClientError("proxy-failure", "Invalid audio recording");
+      throw new HgwClientError("gateway-failure", "Invalid audio recording");
     const request = SessionTranscriptionRequestSchema2.safeParse({
       dataUrl: await dataUrl(audio),
       mimeType: audio.type
     });
     if (!request.success)
-      throw new HgwClientError("proxy-failure", "Invalid audio recording");
+      throw new HgwClientError("gateway-failure", "Invalid audio recording");
     const path = `/agents/${encodeURIComponent(agentId)}/audio/transcribe`;
     const response = await this.#read(path, SessionTranscriptionResponseSchema2, {
       method: "POST",
@@ -2629,7 +2691,7 @@ class HgwRemoteClient {
   async speakForAgent(agentId, text, signal) {
     const request = SessionSpeechRequestSchema2.safeParse({ text });
     if (!request.success)
-      throw new HgwClientError("proxy-failure", "Invalid speech input");
+      throw new HgwClientError("gateway-failure", "Invalid speech input");
     const path = `/agents/${encodeURIComponent(agentId)}/audio/speak`;
     return this.#readBlob(path, {
       method: "POST",
@@ -2655,18 +2717,18 @@ class HgwRemoteClient {
     }
     if (!response.ok) {
       const error = await normalizedError(response);
-      throw new HgwClientError(response.status === 503 ? "provider-unavailable" : "proxy-failure", error?.description, error?.code, response.status);
+      throw new HgwClientError(response.status === 503 ? "provider-unavailable" : "gateway-failure", error?.description, error?.code, response.status);
     }
   }
   #mcpAppPath(sessionId, subject, suffix = "") {
     const [collection, id] = "toolCallId" in subject ? ["tool-calls", subject.toolCallId] : ["artifacts", subject.artifactId];
     if (!id.trim() || id.length > 512)
-      throw new HgwClientError("proxy-failure", "Invalid MCP App reference");
+      throw new HgwClientError("gateway-failure", "Invalid MCP App reference");
     return this.#sessionPath(sessionId, `/${collection}/${encodeURIComponent(id)}/app${suffix}`);
   }
   async#postMcpApp(sessionId, subject, suffix, request, schema) {
     if (!request.success)
-      throw new HgwClientError("proxy-failure", "Invalid MCP App request");
+      throw new HgwClientError("gateway-failure", "Invalid MCP App request");
     return this.#read(this.#mcpAppPath(sessionId, subject, suffix), schema, {
       method: "POST",
       headers: { "content-type": "application/json" },
@@ -2677,7 +2739,7 @@ class HgwRemoteClient {
     const agentId = this.#owner(sessionId);
     return `/agents/${encodeURIComponent(agentId)}/sessions/${encodeURIComponent(sessionId)}${suffix}`;
   }
-  async#readBlob(path, init, notFound = "proxy-failure") {
+  async#readBlob(path, init, notFound = "gateway-failure") {
     let response;
     try {
       const headers = new Headers(init?.headers);
@@ -2694,15 +2756,15 @@ class HgwRemoteClient {
     }
     if (!response.ok) {
       const error = await normalizedError(response);
-      throw new HgwClientError(response.status === 503 ? "provider-unavailable" : response.status === 404 ? notFound : "proxy-failure", error?.description, error?.code, response.status);
+      throw new HgwClientError(response.status === 503 ? "provider-unavailable" : response.status === 404 ? notFound : "gateway-failure", error?.description, error?.code, response.status);
     }
     const contentType = response.headers.get("content-type");
     if (!contentType || /[\r\n]/u.test(contentType))
-      throw new HgwClientError("proxy-failure", "Invalid AOS proxy response");
+      throw new HgwClientError("gateway-failure", "Invalid gateway response");
     try {
       return await response.blob();
     } catch {
-      throw new HgwClientError("proxy-failure", "Invalid AOS proxy response");
+      throw new HgwClientError("gateway-failure", "Invalid gateway response");
     }
   }
   #owner(sessionId) {

package/dist/client/limits.d.ts

@@ -33,7 +33,7 @@ export declare const STABLE_AFTER_MS = 60000;
  * neither a close nor a resume.
  */
 export declare const PART_GRACE_MS = 2000;
-/** The window a reopen waits in after the proxy closes at capacity. */
+/** The window a reopen waits in after the gateway closes at capacity. */
 export declare const CAPACITY_BACKOFF: {
     minMs: number;
     maxMs: number;

package/dist/client/types.d.ts

@@ -1,4 +1,4 @@
-import type { ContentBlock, CreateElicitationRequest, CreateElicitationResponse, RequestPermissionRequest, RequestPermissionResponse, SessionConfigOption, SessionInfo, SessionUpdate } from "@agentclientprotocol/sdk/experimental/v2";
+import type { AgentCapabilities, ContentBlock, CreateElicitationRequest, CreateElicitationResponse, RequestPermissionRequest, RequestPermissionResponse, SessionConfigOption, SessionInfo, SessionUpdate } from "@agentclientprotocol/sdk/experimental/v2";
 import type { z } from "zod";
 import type { AgentCatalogResponseSchema } from "../protocol/index.js";
 import type { HgwAgentUpdateRequest, HgwAgentUpdateResponseSchema, HgwHistoryCursor, HgwInitializeMetaSchema, HgwPromptMetaSchema, HgwSessionListMetaSchema, HgwSessionNewMetaSchema, HgwSessionSearchMeta, HgwSessionUpdateRequestSchema, HgwSteerRequestSchema, HgwSteerResponseSchema } from "../protocol/acp.js";
@@ -15,13 +15,17 @@ export type AcpConnectionOutage = "reconnecting" | "capacity";
 export type AcpPendingRequest = {
     kind: "permission";
     sessionId: string;
+    /** The Session that owns the child Session `sessionId` names, if it is one. */
+    parentSessionId?: string;
     request: RequestPermissionRequest;
     respond(response: RequestPermissionResponse): void;
-    /** Aborts when the proxy withdraws the request, which needs no answer. */
+    /** Aborts when the gateway withdraws the request, which needs no answer. */
     signal: AbortSignal;
 } | {
     kind: "elicitation";
     sessionId: string | undefined;
+    /** The Session that owns the child Session `sessionId` names, if it is one. */
+    parentSessionId?: string;
     request: CreateElicitationRequest;
     respond(response: CreateElicitationResponse): void;
     signal: AbortSignal;
@@ -55,6 +59,12 @@ export type AcpSessionListener = {
     agentId?: string;
     /** `session/update` notifications for the Session, with `_meta.hgw`. */
     update?: AcpSessionUpdateListener;
+    /**
+     * The updates of a child Session this one owns, announced by a
+     * `subagent_update` this listener's `update` saw: ACP sends them under the
+     * child's own id, on this connection.
+     */
+    child?: (childSessionId: string, update: SessionUpdate, meta: Record<string, unknown> | undefined) => void;
     /**
      * Fires just before a from-start replay is requested, so whoever projects
      * the Session can drop the transcript that replay is about to resend. It
@@ -81,6 +91,11 @@ export interface AcpConnection {
     start(): void;
     /** Resolves with `InitializeResponse._meta.hgw` once the handshake settles. */
     readonly initialized: Promise<z.infer<typeof HgwInitializeMetaSchema>>;
+    /**
+     * ACP's `InitializeResponse.capabilities` from the latest handshake:
+     * `session.fork` says the gateway forks. Undefined before one settles.
+     */
+    readonly capabilities: AgentCapabilities | undefined;
     subscribeStatus(listener: (status: AcpConnectionStatus) => void): () => void;
     /**
      * Set from a close until the transport is ready again. Each Session's
@@ -102,6 +117,14 @@ export interface AcpConnection {
     }): Promise<{
         sessionId: string;
     }>;
+    /**
+     * Forks a Session into a new one holding its conversation so far, where
+     * `capabilities.session.fork` says the gateway forks; the gateway joins
+     * this connection to it, as `newSession` does.
+     */
+    forkSession(sessionId: string): Promise<{
+        sessionId: string;
+    }>;
     listSessions(meta: z.infer<typeof HgwSessionListMetaSchema>, cursor?: string): Promise<{
         sessions: SessionInfo[];
         nextCursor?: string;

package/dist/client/workspace.d.ts

@@ -82,6 +82,7 @@ export type SessionActionCapabilities = {
     archive: boolean;
     delete: boolean;
     pin: boolean;
+    unread: boolean;
 };
 export type TodoStatus = "pending" | "active" | "completed" | "failed";
 export type TodoItem = {

package/dist/protocol/acp.d.ts

@@ -44,7 +44,7 @@ export declare const HGW_ACP_AGENTS_PATH: "/api/v1/acp/agents";
 /** One Agent's own ACP address, its id one path segment. */
 export declare function hgwAcpAgentPath(agentId: string): string;
 export declare const HGW_META_KEY: "hgw";
-export declare const HGW_EXTENSION_VERSION: 1;
+export declare const HGW_EXTENSION_VERSION: 2;
 export declare const HGW_AUTH_METHOD_INVITE: "hgw-invite";
 export declare const HGW_ATTACHMENT_URI_SCHEME: "hgw-attachment:";
 export declare const HGW_ARTIFACT_URI_SCHEME: "artifact:";
@@ -69,11 +69,6 @@ export declare const HGW_METHODS: {
         readonly error: "_hgw/error";
     };
 };
-/** Vendor stop reasons used on `state_update { state: "idle" }`. */
-export declare const HGW_STOP_REASONS: {
-    readonly error: "_hgw_error";
-    readonly uncertain: "_hgw_uncertain";
-};
 /** Vendor permission option kind for Hermes' "allow for this session" scope. */
 export declare const HGW_PERMISSION_KIND_SESSION: "_allow_session";
 /** The single plan a Session carries: its Todos. */
@@ -89,7 +84,6 @@ export declare const HGW_JSONRPC_ERRORS: {
     readonly revisionConflict: -31012;
     readonly temporarilyUnavailable: -31013;
     readonly uncertainMutation: -31014;
-    readonly unsupported: -31015;
     /**
      * Params too large for one frame. The client raises it before sending and
      * the gateway never sends it, so it has no machine name on the wire.
@@ -126,7 +120,7 @@ export declare const HgwClientCapabilitiesMetaSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** `InitializeResponse._meta.hgw` */
 export declare const HgwInitializeMetaSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
+    version: z.ZodLiteral<2>;
     role: z.ZodEnum<{
         guest: "guest";
         operator: "operator";
@@ -210,8 +204,20 @@ export type HgwSessionInfoMeta = z.infer<typeof HgwSessionInfoMetaSchema>;
 /** `ResumeSessionRequest._meta.hgw` */
 export declare const HgwSessionResumeMetaSchema: z.ZodObject<{
     agentId: z.ZodOptional<z.ZodString>;
-    after: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * The reserved `replayFrom` variant that resumes a view from where it already
+ * reaches in the live turn: `from` is the first `_meta.hgw.sequence` of
+ * `turnId` the client still needs, inclusive as every ACP cursor is. One that
+ * names neither replays the live turn from its first event, or rebuilds the
+ * view from history once the journal no longer holds that.
+ */
+export declare const HGW_REPLAY_POSITION: "_hgw/position";
+export declare const HgwReplayPositionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"_hgw/position">;
     turnId: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodNumber>;
+    _meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, z.core.$strict>;
 /**
  * The reserved `replayFrom` extension variant that reads one older page of a
@@ -417,6 +423,7 @@ export declare const HgwAgentUpdateResponseSchema: z.ZodObject<{
 export declare const HgwTurnMetaSchema: z.ZodObject<{
     sequence: z.ZodNumber;
     turnId: z.ZodString;
+    background: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>;
 /**
  * `_meta.hgw` of a Session-scoped `notice`: the provider's own status kind,
@@ -452,35 +459,29 @@ export declare const HgwCostSchema: z.ZodObject<{
     currency: z.ZodString;
 }, z.core.$strip>;
 export type HgwCost = z.infer<typeof HgwCostSchema>;
-/** How far a delegated subagent has got. */
-export declare const HGW_SUBAGENT_STATUSES: readonly ["running", "completed", "failed", "cancelled"];
 /**
- * One delegated subagent, as a patch keyed by `id`: a later report restates
- * only what changed, so an omitted key leaves the known value standing.
+ * `subagent_update._meta.hgw`: what ACP's child Session announcement has no
+ * field for. `toolCallId` names the parent's call that spawned the child; the
+ * rest are the facts its runtime reports. A child's tokens arrive in its own
+ * idle usage, apart from its parent's.
  */
-export declare const HgwSubagentSchema: z.ZodObject<{
-    id: z.ZodString;
-    goal: z.ZodOptional<z.ZodString>;
+export declare const HgwChildSessionMetaSchema: z.ZodObject<{
+    sequence: z.ZodNumber;
+    turnId: z.ZodString;
+    background: z.ZodOptional<z.ZodLiteral<true>>;
+    toolCallId: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
-    depth: z.ZodOptional<z.ZodNumber>;
-    status: z.ZodOptional<z.ZodEnum<{
-        cancelled: "cancelled";
-        completed: "completed";
-        failed: "failed";
-        running: "running";
-    }>>;
-    tokens: z.ZodOptional<z.ZodNumber>;
     filesRead: z.ZodOptional<z.ZodArray<z.ZodString>>;
     filesWritten: z.ZodOptional<z.ZodArray<z.ZodString>>;
     durationMs: z.ZodOptional<z.ZodNumber>;
-    childSessionId: z.ZodOptional<z.ZodString>;
     summary: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type HgwSubagent = z.infer<typeof HgwSubagentSchema>;
+export type HgwChildSessionMeta = z.infer<typeof HgwChildSessionMetaSchema>;
 /** `state_update._meta.hgw` */
 export declare const HgwStateMetaSchema: z.ZodObject<{
     sequence: z.ZodNumber;
     turnId: z.ZodString;
+    background: z.ZodOptional<z.ZodLiteral<true>>;
     at: z.ZodOptional<z.ZodISODateTime>;
     execution: z.ZodOptional<z.ZodLiteral<"stopping">>;
     code: z.ZodOptional<z.ZodString>;
@@ -496,39 +497,19 @@ export declare const HgwStateMetaSchema: z.ZodObject<{
 export declare const HgwChunkMetaSchema: z.ZodObject<{
     sequence: z.ZodNumber;
     turnId: z.ZodString;
-    subagentId: z.ZodOptional<z.ZodString>;
-    parentToolCallId: z.ZodOptional<z.ZodString>;
+    background: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>;
 /** `tool_call_update` / `tool_call_content_chunk` `_meta.hgw` */
 export declare const HgwToolCallMetaSchema: z.ZodObject<{
     sequence: z.ZodNumber;
     turnId: z.ZodString;
-    subagentId: z.ZodOptional<z.ZodString>;
-    parentToolCallId: z.ZodOptional<z.ZodString>;
+    background: z.ZodOptional<z.ZodLiteral<true>>;
     messageId: z.ZodString;
     argsTextDelta: z.ZodOptional<z.ZodString>;
     argsText: z.ZodOptional<z.ZodString>;
     startedAt: z.ZodOptional<z.ZodISODateTime>;
     completedAt: z.ZodOptional<z.ZodISODateTime>;
     durationMs: z.ZodOptional<z.ZodNumber>;
-    subagent: z.ZodOptional<z.ZodObject<{
-        id: z.ZodString;
-        goal: z.ZodOptional<z.ZodString>;
-        model: z.ZodOptional<z.ZodString>;
-        depth: z.ZodOptional<z.ZodNumber>;
-        status: z.ZodOptional<z.ZodEnum<{
-            cancelled: "cancelled";
-            completed: "completed";
-            failed: "failed";
-            running: "running";
-        }>>;
-        tokens: z.ZodOptional<z.ZodNumber>;
-        filesRead: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        filesWritten: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        durationMs: z.ZodOptional<z.ZodNumber>;
-        childSessionId: z.ZodOptional<z.ZodString>;
-        summary: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
     app: z.ZodOptional<z.ZodObject<{}, z.core.$strict>>;
 }, z.core.$strip>;
 /** `plan_update._meta.hgw`: the lossless Session Todos. */
@@ -632,6 +613,13 @@ export declare const HgwAvailableCommandsMetaSchema: z.ZodObject<{
                 status: z.ZodLiteral<"unavailable">;
                 reason: z.ZodString;
             }, z.core.$strict>]>;
+            rewind: z.ZodUnion<readonly [z.ZodObject<{
+                status: z.ZodLiteral<"available">;
+                scope: z.ZodLiteral<"user-turn">;
+            }, z.core.$strict>, z.ZodObject<{
+                status: z.ZodLiteral<"unavailable">;
+                reason: z.ZodString;
+            }, z.core.$strict>]>;
             approvals: z.ZodObject<{
                 status: z.ZodLiteral<"available">;
                 protocol: z.ZodLiteral<"acp-request">;

package/dist/protocol/index.d.ts

@@ -568,6 +568,102 @@ export declare const SessionPlanActivityMessageSchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>;
 export type SessionPlanActivityMessage = z.infer<typeof SessionPlanActivityMessageSchema>;
+/**
+ * A compaction the provider stored: where it summarized the conversation's
+ * context, under the id its live `compaction_update` carried, and the summary
+ * where it keeps one. It replays as that compaction, completed.
+ */
+export declare const SessionCompactionActivityMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodLiteral<"activity">;
+    activityType: z.ZodLiteral<"COMPACTION">;
+    content: z.ZodObject<{
+        compactionId: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type SessionCompactionActivityMessage = z.infer<typeof SessionCompactionActivityMessageSchema>;
+/**
+ * A child Session a turn of this one spawned, as its runtime stored it: its
+ * id, the call that spawned it, its display text, and its final state and
+ * facts. It replays as the child's announcement, ahead of the child's own
+ * transcript.
+ */
+export declare const SessionChildActivityMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodLiteral<"activity">;
+    activityType: z.ZodLiteral<"CHILD_SESSION">;
+    content: z.ZodObject<{
+        childSessionId: z.ZodString;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            cancelled: "cancelled";
+            failed: "failed";
+            idle: "idle";
+            running: "running";
+            unknown: "unknown";
+            "waiting-for-input": "waiting-for-input";
+        }>>;
+        model: z.ZodOptional<z.ZodString>;
+        filesRead: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        filesWritten: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type SessionChildActivityMessage = z.infer<typeof SessionChildActivityMessageSchema>;
+/** A stored row of the Session's activity, not of its conversation. */
+export declare const SessionActivityMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodLiteral<"activity">;
+    activityType: z.ZodLiteral<"PLAN">;
+    content: z.ZodObject<{
+        todos: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            status: z.ZodEnum<{
+                active: "active";
+                completed: "completed";
+                failed: "failed";
+                pending: "pending";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodLiteral<"activity">;
+    activityType: z.ZodLiteral<"COMPACTION">;
+    content: z.ZodObject<{
+        compactionId: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodLiteral<"activity">;
+    activityType: z.ZodLiteral<"CHILD_SESSION">;
+    content: z.ZodObject<{
+        childSessionId: z.ZodString;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            cancelled: "cancelled";
+            failed: "failed";
+            idle: "idle";
+            running: "running";
+            unknown: "unknown";
+            "waiting-for-input": "waiting-for-input";
+        }>>;
+        model: z.ZodOptional<z.ZodString>;
+        filesRead: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        filesWritten: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "activityType">;
+export type SessionActivityMessage = z.infer<typeof SessionActivityMessageSchema>;
 export declare const SessionHistoryResponseSchema: z.ZodObject<{
     sessionId: z.ZodString;
     messages: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -670,7 +766,7 @@ export declare const SessionHistoryResponseSchema: z.ZodObject<{
         correction: z.ZodOptional<z.ZodLiteral<true>>;
         opensTurn: z.ZodOptional<z.ZodLiteral<true>>;
         turnErrorCode: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodString;
         role: z.ZodLiteral<"activity">;
         activityType: z.ZodLiteral<"PLAN">;
@@ -686,7 +782,38 @@ export declare const SessionHistoryResponseSchema: z.ZodObject<{
                 }>;
             }, z.core.$strict>>;
         }, z.core.$strict>;
-    }, z.core.$strict>], "role">>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodLiteral<"activity">;
+        activityType: z.ZodLiteral<"COMPACTION">;
+        content: z.ZodObject<{
+            compactionId: z.ZodString;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodLiteral<"activity">;
+        activityType: z.ZodLiteral<"CHILD_SESSION">;
+        content: z.ZodObject<{
+            childSessionId: z.ZodString;
+            toolCallId: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodEnum<{
+                cancelled: "cancelled";
+                failed: "failed";
+                idle: "idle";
+                running: "running";
+                unknown: "unknown";
+                "waiting-for-input": "waiting-for-input";
+            }>>;
+            model: z.ZodOptional<z.ZodString>;
+            filesRead: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            filesWritten: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "activityType">], "role">>;
     total: z.ZodNumber;
     limit: z.ZodNumber;
     offset: z.ZodNumber;
@@ -811,6 +938,13 @@ export declare const SessionWorkspaceCapabilitiesResponseSchema: z.ZodObject<{
             status: z.ZodLiteral<"unavailable">;
             reason: z.ZodString;
         }, z.core.$strict>]>;
+        rewind: z.ZodUnion<readonly [z.ZodObject<{
+            status: z.ZodLiteral<"available">;
+            scope: z.ZodLiteral<"user-turn">;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodLiteral<"unavailable">;
+            reason: z.ZodString;
+        }, z.core.$strict>]>;
         approvals: z.ZodObject<{
             status: z.ZodLiteral<"available">;
             protocol: z.ZodLiteral<"acp-request">;
@@ -988,6 +1122,13 @@ export declare const GuestRuntimeCapabilitiesResponseSchema: z.ZodObject<{
         }, z.core.$strict>]>>>;
     }, z.core.$strict>>>;
     interactions: z.ZodObject<{
+        rewind: z.ZodUnion<readonly [z.ZodObject<{
+            status: z.ZodLiteral<"available">;
+            scope: z.ZodLiteral<"user-turn">;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodLiteral<"unavailable">;
+            reason: z.ZodString;
+        }, z.core.$strict>]>;
         questions: z.ZodObject<{
             status: z.ZodLiteral<"available">;
             protocol: z.ZodLiteral<"acp-request">;

package/dist/protocol/mcp-apps.d.ts

@@ -199,7 +199,7 @@ export declare const McpAppResourceReadRequestSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type McpAppResourceReadRequest = z.infer<typeof McpAppResourceReadRequestSchema>;
 /**
- * The MCP App sandbox proxy: a static page, served beside the workspace on
+ * The MCP App sandbox gateway: a static page, served beside the workspace on
  * every listener, that holds only the relay creating the App's own frame. It
  * is a real document rather than `srcdoc` so it carries this policy instead of
  * inheriting the embedding page's, which on the guest surface forbids inline

package/dist/protocol/sdk.js

@@ -24,6 +24,9 @@ import {
   SessionMessageErrorStatusSchema2,
   SessionMessageSchema2,
   SessionPlanActivityMessageSchema2,
+  SessionCompactionActivityMessageSchema2,
+  SessionChildActivityMessageSchema2,
+  SessionActivityMessageSchema2,
   SessionHistoryResponseSchema2,
   SessionCreateRequestSchema2,
   SessionCreateResponseSchema2,
@@ -61,7 +64,6 @@ import {
   HGW_ATTACHMENT_URI_SCHEME2,
   HGW_ARTIFACT_URI_SCHEME2,
   HGW_METHODS2,
-  HGW_STOP_REASONS2,
   HGW_PERMISSION_KIND_SESSION2,
   HGW_PLAN_ID2,
   HGW_JSONRPC_ERRORS2,
@@ -77,6 +79,8 @@ import {
   HgwSessionSearchResponseSchema2,
   HgwSessionInfoMetaSchema2,
   HgwSessionResumeMetaSchema2,
+  HGW_REPLAY_POSITION2,
+  HgwReplayPositionSchema2,
   HGW_REPLAY_BEFORE2,
   HgwReplayBeforeSchema2,
   HgwHistoryCursorSchema2,
@@ -96,8 +100,7 @@ import {
   HgwNoticeMetaSchema2,
   HgwMessageMetaSchema2,
   HgwCostSchema2,
-  HGW_SUBAGENT_STATUSES2,
-  HgwSubagentSchema2,
+  HgwChildSessionMetaSchema2,
   HgwStateMetaSchema2,
   HgwChunkMetaSchema2,
   HgwToolCallMetaSchema2,
@@ -222,15 +225,15 @@ export {
   HGW_PERMISSION_KIND_SESSION2 as HGW_PERMISSION_KIND_SESSION,
   HGW_PLAN_ID2 as HGW_PLAN_ID,
   HGW_REPLAY_BEFORE2 as HGW_REPLAY_BEFORE,
+  HGW_REPLAY_POSITION2 as HGW_REPLAY_POSITION,
   HGW_REQUEST_TEXT_MAX2 as HGW_REQUEST_TEXT_MAX,
-  HGW_STOP_REASONS2 as HGW_STOP_REASONS,
-  HGW_SUBAGENT_STATUSES2 as HGW_SUBAGENT_STATUSES,
   HgwActivityNotificationSchema2 as HgwActivityNotificationSchema,
   HgwAgentUpdateRequestSchema2 as HgwAgentUpdateRequestSchema,
   HgwAgentUpdateResponseSchema2 as HgwAgentUpdateResponseSchema,
   HgwAgentsListResponseSchema2 as HgwAgentsListResponseSchema,
   HgwArtifactDescriptorSchema2 as HgwArtifactDescriptorSchema,
   HgwAvailableCommandsMetaSchema2 as HgwAvailableCommandsMetaSchema,
+  HgwChildSessionMetaSchema2 as HgwChildSessionMetaSchema,
   HgwChunkMetaSchema2 as HgwChunkMetaSchema,
   HgwClientCapabilitiesMetaSchema2 as HgwClientCapabilitiesMetaSchema,
   HgwComposerPrefillNotificationSchema2 as HgwComposerPrefillNotificationSchema,
@@ -252,6 +255,7 @@ export {
   HgwQuestionOptionSchema2 as HgwQuestionOptionSchema,
   HgwQuestionSchema2 as HgwQuestionSchema,
   HgwReplayBeforeSchema2 as HgwReplayBeforeSchema,
+  HgwReplayPositionSchema2 as HgwReplayPositionSchema,
   HgwSessionInfoMetaSchema2 as HgwSessionInfoMetaSchema,
   HgwSessionListMetaSchema2 as HgwSessionListMetaSchema,
   HgwSessionNewMetaSchema2 as HgwSessionNewMetaSchema,
@@ -264,7 +268,6 @@ export {
   HgwStateMetaSchema2 as HgwStateMetaSchema,
   HgwSteerRequestSchema2 as HgwSteerRequestSchema,
   HgwSteerResponseSchema2 as HgwSteerResponseSchema,
-  HgwSubagentSchema2 as HgwSubagentSchema,
   HgwToolCallMetaSchema2 as HgwToolCallMetaSchema,
   HgwTurnMetaSchema2 as HgwTurnMetaSchema,
   HgwUsageMetaSchema2 as HgwUsageMetaSchema,
@@ -304,11 +307,14 @@ export {
   RuntimeInfoSchema2 as RuntimeInfoSchema,
   SESSION_CATALOG_MAX_WINDOW2 as SESSION_CATALOG_MAX_WINDOW,
   SPEECH_MIME_TYPES,
+  SessionActivityMessageSchema2 as SessionActivityMessageSchema,
   SessionActivityResponseSchema2 as SessionActivityResponseSchema,
   SessionAttachmentStageRequestSchema2 as SessionAttachmentStageRequestSchema,
   SessionAttachmentStageResponseSchema2 as SessionAttachmentStageResponseSchema,
   SessionAudioResponseSchema2 as SessionAudioResponseSchema,
   SessionCatalogResponseSchema2 as SessionCatalogResponseSchema,
+  SessionChildActivityMessageSchema2 as SessionChildActivityMessageSchema,
+  SessionCompactionActivityMessageSchema2 as SessionCompactionActivityMessageSchema,
   SessionContextResponseSchema2 as SessionContextResponseSchema,
   SessionCreateRequestSchema2 as SessionCreateRequestSchema,
   SessionCreateResponseSchema2 as SessionCreateResponseSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-gw/sdk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "A gateway that puts Hermes, OpenClaw, and OpenCode behind one ACP WebSocket, and the browser client and protocol SDK for it.",
   "license": "Apache-2.0",
   "type": "module",