@harness-gw/sdk 0.8.0 → 0.10.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.8.0 \
+     ghcr.io/almogbaku/harness-gw:0.10.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.8.0 \
+     ghcr.io/almogbaku/harness-gw:0.10.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-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.d.ts

@@ -186,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/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)

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,6 +15,8 @@ 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 gateway withdraws the request, which needs no answer. */
@@ -22,6 +24,8 @@ export type AcpPendingRequest = {
 } | {
     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/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/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.8.0",
+  "version": "0.10.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",