@harness-gw/sdk 0.4.1 → 0.5.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.4.1 \
+     ghcr.io/almogbaku/harness-gw:0.5.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.4.1 \
+     ghcr.io/almogbaku/harness-gw:0.5.0 \
      serve --config /run/harness-gw/config.yaml
    ```
 

package/dist/chunks/index.js

@@ -84,7 +84,8 @@ var AgentSummarySchema = z.strictObject({
   activity: z.enum(["active", "idle", "unknown"]).optional(),
   visibility: z.enum(["visible", "hidden"]).optional(),
   role: z.literal("creator").optional(),
-  avatar: AgentAvatarSchema2.optional()
+  avatar: AgentAvatarSchema2.optional(),
+  muted: z.literal(true).optional()
 });
 var AgentCatalogEntrySchema2 = z.strictObject({
   summary: AgentSummarySchema,
@@ -92,6 +93,7 @@ var AgentCatalogEntrySchema2 = z.strictObject({
   selectable: z.boolean(),
   editable: z.boolean(),
   avatarEditable: z.boolean(),
+  muteEditable: z.boolean(),
   revision: IdentifierSchema
 });
 var AgentCatalogResponseSchema2 = z.strictObject({
@@ -101,12 +103,13 @@ var AgentCatalogResponseSchema2 = z.strictObject({
 var AgentUpdateFields2 = {
   visibility: z.enum(["visible", "hidden"]).optional(),
   avatar: AgentAvatarSchema2.nullable().optional(),
+  muted: z.boolean().optional(),
   revision: IdentifierSchema
 };
 function writesAgentField2(value) {
-  return value.visibility !== undefined || value.avatar !== undefined;
+  return value.visibility !== undefined || value.avatar !== undefined || value.muted !== undefined;
 }
-var AgentUpdateRequestSchema2 = z.strictObject(AgentUpdateFields2).refine(writesAgentField2, "At least one of visibility, avatar");
+var AgentUpdateRequestSchema2 = z.strictObject(AgentUpdateFields2).refine(writesAgentField2, "At least one of visibility, avatar, muted");
 var AgentUpdateResponseSchema2 = z.strictObject({
   revision: IdentifierSchema,
   agent: AgentCatalogEntrySchema2
@@ -842,7 +845,7 @@ var HgwFocusRequestSchema2 = z2.strictObject({
   idle: z2.boolean().optional()
 });
 var HgwAgentsListResponseSchema2 = AgentCatalogResponseSchema2;
-var HgwAgentUpdateRequestSchema2 = z2.strictObject({ agentId: IdentifierSchema2, ...AgentUpdateFields2 }).refine(writesAgentField2, "At least one of visibility, avatar");
+var HgwAgentUpdateRequestSchema2 = z2.strictObject({ agentId: IdentifierSchema2, ...AgentUpdateFields2 }).refine(writesAgentField2, "At least one of visibility, avatar, muted");
 var HgwAgentUpdateResponseSchema2 = AgentUpdateResponseSchema2;
 var TurnMetaBase = {
   sequence: SequenceSchema,
@@ -980,10 +983,12 @@ var HgwErrorNotificationSchema2 = readObject({
   code: z2.string().min(1).max(128),
   message: z2.string().max(4096)
 });
+var HGW_REQUEST_TEXT_MAX2 = 200;
 var ActivityBase = {
   agentId: IdentifierSchema2,
   sessionId: IdentifierSchema2,
-  occurredAt: z2.iso.datetime()
+  occurredAt: z2.iso.datetime(),
+  replayed: z2.literal(true).optional()
 };
 var HgwActivityNotificationSchema2 = z2.discriminatedUnion("type", [
   readObject({
@@ -995,7 +1000,9 @@ var HgwActivityNotificationSchema2 = z2.discriminatedUnion("type", [
     ...ActivityBase,
     type: z2.literal("attention-requested"),
     requestId: IdentifierSchema2,
-    attentionKind: z2.enum(["question", "permission"])
+    attentionKind: z2.enum(["question", "permission"]),
+    requestText: z2.string().min(1).max(HGW_REQUEST_TEXT_MAX2).optional(),
+    requestMore: z2.number().int().min(1).optional()
   }),
   readObject({
     ...ActivityBase,
@@ -1036,15 +1043,24 @@ var COALESCE_WINDOW_MS2 = {
   failure: 5000,
   completion: 20000
 };
+var PUSH_TEXT_LIMITS2 = {
+  agentName: 64,
+  sessionTitle: 120,
+  requestText: HGW_REQUEST_TEXT_MAX2
+};
+var pushText = (max) => z3.string().min(1).max(max);
 var PushMessageSchema2 = z3.strictObject({
-  v: z3.literal(1),
+  v: z3.literal(2),
   category: PushCategorySchema2,
-  count: z3.number().int().min(1),
-  agentId: IdentifierSchema2.optional(),
-  sessionId: IdentifierSchema2.optional(),
+  agentId: IdentifierSchema2,
+  sessionId: IdentifierSchema2,
   occurredAt: z3.iso.datetime(),
-  locale: PushLocaleSchema2
-}).refine((message) => message.count === 1 === (message.agentId !== undefined && message.sessionId !== undefined), { message: "A single-Session push carries both ids; a count carries none" });
+  locale: PushLocaleSchema2,
+  agentName: pushText(PUSH_TEXT_LIMITS2.agentName).optional(),
+  sessionTitle: pushText(PUSH_TEXT_LIMITS2.sessionTitle).optional(),
+  requestText: pushText(PUSH_TEXT_LIMITS2.requestText).optional(),
+  requestMore: z3.number().int().min(1).optional()
+});
 var PushCategoriesSchema2 = z3.strictObject({
   input: z3.boolean(),
   failure: z3.boolean(),
@@ -1164,4 +1180,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, 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, HgwActivityNotificationSchema2, PushCategorySchema2, categoryOf2, PushLocaleSchema2, PRESENCE_IDLE_MS2, PRESENCE_HEARTBEAT_MS2, PRESENCE_GRACE_MS2, PRESENCE_CLOSED_GRACE_MS2, COALESCE_WINDOW_MS2, 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, 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, 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 };

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

@@ -17,6 +17,13 @@ export type AcpSessionStoreOptions = {
 export declare function createAcpSessionStore({ connection, now, onTurnFinished, }: AcpSessionStoreOptions): {
     subscribe: (sessionId: string, agentId?: string) => () => void;
     dispose(): void;
+    /**
+     * A connection that starts over re-sends every request still open as it
+     * catches up, so one the old connection left open and the new one does
+     * not name was settled while nobody was listening; and what it re-sends
+     * is no longer marked as already seen.
+     */
+    startOver(): void;
     put: (sessionId: string, info: HgwSessionInfoMeta, updatedAt?: string | null) => void;
     rowsFor: (sessionIds: Iterable<string>) => {
         sessionId: string;

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

@@ -28,6 +28,7 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
         visibility?: "visible" | "hidden" | undefined;
         role?: "creator" | undefined;
         avatar?: string | undefined;
+        muted?: true | undefined;
     }[]>;
     refreshAgents(): Promise<{
         kind: "ready";
@@ -39,6 +40,7 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
         visibility?: "visible" | "hidden" | undefined;
         role?: "creator" | undefined;
         avatar?: string | undefined;
+        muted?: true | undefined;
     }[]>;
     listAgentCatalog(): Promise<{
         summary: {
@@ -51,11 +53,13 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
             visibility?: "visible" | "hidden" | undefined;
             role?: "creator" | undefined;
             avatar?: string | undefined;
+            muted?: true | undefined;
         };
         visibility: "visible" | "hidden";
         selectable: boolean;
         editable: boolean;
         avatarEditable: boolean;
+        muteEditable: boolean;
     }[]>;
     updateAgent: (agentId: string, patch: AgentUpdate) => Promise<void>;
     subscribeAgentCatalog: (listener: () => void) => () => void;

package/dist/client/index.js

@@ -1518,8 +1518,15 @@ function statusFromState(update) {
   const stopReason = update.stopReason;
   return stopReason === HGW_STOP_REASONS2.error || stopReason === HGW_STOP_REASONS2.uncertain ? "failed" : "idle";
 }
-function activityEventOf(notification) {
-  const { agentId, sessionId, occurredAt, type } = notification;
+var FEED_STATUS = {
+  "turn-started": "running",
+  "attention-requested": "waiting-for-input",
+  "attention-resolved": "running",
+  "turn-finished": "idle",
+  "turn-failed": "failed"
+};
+function activityEventOf(notification, marksReplays) {
+  const { agentId, sessionId, occurredAt, type, replayed } = notification;
   if (type === "unread-changed")
     return;
   const key = "turnId" in notification ? notification.turnId : ("requestId" in notification) ? notification.requestId : occurredAt;
@@ -1527,15 +1534,20 @@ function activityEventOf(notification) {
     id: `${sessionId}:${key}:${type}`,
     agentId,
     sessionId,
-    occurredAt
+    occurredAt,
+    ...replayed && marksReplays ? { replayed } : {}
   };
-  if (type === "attention-requested")
+  if (type === "attention-requested") {
+    const { requestText, requestMore } = notification;
     return {
       ...base,
       type,
       requestId: notification.requestId,
-      attentionKind: notification.attentionKind
+      attentionKind: notification.attentionKind,
+      ...requestText === undefined ? {} : { requestText },
+      ...requestMore === undefined ? {} : { requestMore }
     };
+  }
   if (type === "attention-resolved")
     return { ...base, type, requestId: notification.requestId };
   return { ...base, type, turnId: notification.turnId };
@@ -1553,6 +1565,9 @@ function createAcpSessionStore({
   const todos = new Map;
   const replaying = new Map;
   const subscriptions = new Set;
+  const subscribed = new Map;
+  const openRequests = new Map;
+  let marksReplays = true;
   const todoListeners = new Map;
   const activityListeners = new Set;
   const invalidationListeners = new Map;
@@ -1660,16 +1675,43 @@ function createAcpSessionStore({
       update: (update, meta) => acceptUpdate(sessionId, update, meta),
       replay: () => holdReplayedStatus(sessionId)
     });
+    subscribed.set(sessionId, (subscribed.get(sessionId) ?? 0) + 1);
     return () => {
       leave();
+      const holders = (subscribed.get(sessionId) ?? 1) - 1;
+      if (holders > 0)
+        subscribed.set(sessionId, holders);
+      else
+        subscribed.delete(sessionId);
       todos.delete(sessionId);
       replaying.delete(sessionId);
     };
   }
+  function noteActivity(notification) {
+    const { sessionId, type } = notification;
+    const open = openRequests.get(sessionId) ?? new Set;
+    if (type === "attention-requested")
+      open.add(notification.requestId);
+    else if (type === "attention-resolved")
+      open.delete(notification.requestId);
+    else if (type === "turn-finished" || type === "turn-failed")
+      open.clear();
+    if (open.size > 0)
+      openRequests.set(sessionId, open);
+    else
+      openRequests.delete(sessionId);
+    const status = FEED_STATUS[type];
+    if (!status || subscribed.has(sessionId))
+      return;
+    if (type === "attention-resolved" && open.size > 0)
+      return;
+    patch(sessionId, { status });
+  }
   const leaveActivity = subscribeHgwNotification(connection, HGW_METHODS2.notify.activity, HgwActivityNotificationSchema2, (notification) => {
     if (notification.type === "unread-changed")
       return patch(notification.sessionId, { unread: notification.unread });
-    const event = activityEventOf(notification);
+    noteActivity(notification);
+    const event = activityEventOf(notification, marksReplays);
     if (event)
       emitActivity(event);
   });
@@ -1678,6 +1720,10 @@ function createAcpSessionStore({
     dispose() {
       leaveActivity();
     },
+    startOver() {
+      openRequests.clear();
+      marksReplays = false;
+    },
     put,
     rowsFor,
     setTitle: (sessionId, title) => titles.set(sessionId, title),
@@ -1922,8 +1968,10 @@ function createAcpWorkspaceClient({
   let connectionCurrentlyReady = connectionEverReady;
   const leaveStatus = connection.subscribeStatus((status) => {
     if (status === "ready") {
-      if (connectionEverReady && !connectionCurrentlyReady)
+      if (connectionEverReady && !connectionCurrentlyReady) {
+        store.startOver();
         scheduleSessionRelist();
+      }
       connectionEverReady = true;
       connectionCurrentlyReady = true;
     } else {
@@ -1971,12 +2019,20 @@ function createAcpWorkspaceClient({
       return (await catalog()).agents.map(({ summary }) => summary);
     },
     async listAgentCatalog() {
-      return (await catalog()).agents.map(({ summary, visibility, selectable, editable, avatarEditable }) => ({
+      return (await catalog()).agents.map(({
+        summary,
+        visibility,
+        selectable,
+        editable,
+        avatarEditable,
+        muteEditable
+      }) => ({
         summary,
         visibility,
         selectable,
         editable,
-        avatarEditable
+        avatarEditable,
+        muteEditable
       }));
     },
     updateAgent,

package/dist/client/workspace.d.ts

@@ -9,6 +9,8 @@ export type AgentVisibility = "visible" | "hidden";
 export type AgentUpdate = {
     visibility?: AgentVisibility;
     avatar?: string | null;
+    /** Mutes the Agent's notifications, or with `false` unmutes them. */
+    muted?: boolean;
 };
 /** Actionable Agent update refusals; all other failures remain ordinary Errors. */
 export declare class AgentUpdateError extends Error {
@@ -21,6 +23,8 @@ export type ActivityBase = {
     agentId: string;
     sessionId: string;
     occurredAt: string;
+    /** Re-sent on connect from what the gateway already held. */
+    replayed?: true;
 };
 export type WorkspaceActivityEvent = (ActivityBase & {
     type: "turn-started";
@@ -32,6 +36,10 @@ export type WorkspaceActivityEvent = (ActivityBase & {
     type: "attention-requested";
     attentionKind: "question" | "permission";
     requestId: string;
+    /** One masked line of what is asked; absent when nothing can be shown. */
+    requestText?: string;
+    /** How many further questions the request asks. */
+    requestMore?: number;
 }) | (ActivityBase & {
     type: "attention-resolved";
     requestId: string;

package/dist/protocol/acp.d.ts

@@ -335,6 +335,7 @@ export declare const HgwAgentsListResponseSchema: z.ZodObject<{
             }>>;
             role: z.ZodOptional<z.ZodLiteral<"creator">>;
             avatar: z.ZodOptional<z.ZodString>;
+            muted: z.ZodOptional<z.ZodLiteral<true>>;
         }, z.core.$strict>;
         visibility: z.ZodEnum<{
             visible: "visible";
@@ -343,16 +344,18 @@ export declare const HgwAgentsListResponseSchema: z.ZodObject<{
         selectable: z.ZodBoolean;
         editable: z.ZodBoolean;
         avatarEditable: z.ZodBoolean;
+        muteEditable: z.ZodBoolean;
         revision: z.ZodString;
     }, z.core.$strict>>;
 }, z.core.$strict>;
-/** `_hgw/agents/update` params: at least one of visibility and avatar. */
+/** `_hgw/agents/update` params: at least one of visibility, avatar, and muted. */
 export declare const HgwAgentUpdateRequestSchema: z.ZodObject<{
     visibility: z.ZodOptional<z.ZodEnum<{
         visible: "visible";
         hidden: "hidden";
     }>>;
     avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    muted: z.ZodOptional<z.ZodBoolean>;
     revision: z.ZodString;
     agentId: z.ZodString;
 }, z.core.$strict>;
@@ -383,6 +386,7 @@ export declare const HgwAgentUpdateResponseSchema: z.ZodObject<{
             }>>;
             role: z.ZodOptional<z.ZodLiteral<"creator">>;
             avatar: z.ZodOptional<z.ZodString>;
+            muted: z.ZodOptional<z.ZodLiteral<true>>;
         }, z.core.$strict>;
         visibility: z.ZodEnum<{
             visible: "visible";
@@ -391,6 +395,7 @@ export declare const HgwAgentUpdateResponseSchema: z.ZodObject<{
         selectable: z.ZodBoolean;
         editable: z.ZodBoolean;
         avatarEditable: z.ZodBoolean;
+        muteEditable: z.ZodBoolean;
         revision: z.ZodString;
     }, z.core.$strict>;
 }, z.core.$strict>;
@@ -803,9 +808,16 @@ export declare const HgwErrorNotificationSchema: z.ZodObject<{
     message: z.ZodString;
 }, z.core.$strip>;
 /**
- * `_hgw/activity`: content-free workspace events for every Session the
- * connection may observe. Hydrated on connect from coordinator snapshots and
- * the session list.
+ * The longest a request preview may be, in UTF-16 units, as zod's `.max`
+ * counts; the push payload's `requestText` shares it.
+ */
+export declare const HGW_REQUEST_TEXT_MAX = 200;
+/**
+ * `_hgw/activity`: workspace events for every Session the connection may
+ * observe, in ids, times, and kinds. An attention request also carries a
+ * one-line preview of what it asks, with credentials masked, and how many
+ * questions follow it. Hydrated on connect from coordinator snapshots and the
+ * session list, and those items are marked `replayed`.
  */
 export declare const HgwActivityNotificationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodEnum<{
@@ -817,6 +829,7 @@ export declare const HgwActivityNotificationSchema: z.ZodDiscriminatedUnion<[z.Z
     agentId: z.ZodString;
     sessionId: z.ZodString;
     occurredAt: z.ZodISODateTime;
+    replayed: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"attention-requested">;
     requestId: z.ZodString;
@@ -824,20 +837,25 @@ export declare const HgwActivityNotificationSchema: z.ZodDiscriminatedUnion<[z.Z
         question: "question";
         permission: "permission";
     }>;
+    requestText: z.ZodOptional<z.ZodString>;
+    requestMore: z.ZodOptional<z.ZodNumber>;
     agentId: z.ZodString;
     sessionId: z.ZodString;
     occurredAt: z.ZodISODateTime;
+    replayed: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"attention-resolved">;
     requestId: z.ZodString;
     agentId: z.ZodString;
     sessionId: z.ZodString;
     occurredAt: z.ZodISODateTime;
+    replayed: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"unread-changed">;
     unread: z.ZodBoolean;
     agentId: z.ZodString;
     sessionId: z.ZodString;
     occurredAt: z.ZodISODateTime;
+    replayed: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>], "type">;
 export type HgwActivityNotification = z.infer<typeof HgwActivityNotificationSchema>;

package/dist/protocol/index.d.ts

@@ -166,6 +166,7 @@ export declare const AgentCatalogEntrySchema: z.ZodObject<{
         }>>;
         role: z.ZodOptional<z.ZodLiteral<"creator">>;
         avatar: z.ZodOptional<z.ZodString>;
+        muted: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strict>;
     visibility: z.ZodEnum<{
         visible: "visible";
@@ -174,6 +175,7 @@ export declare const AgentCatalogEntrySchema: z.ZodObject<{
     selectable: z.ZodBoolean;
     editable: z.ZodBoolean;
     avatarEditable: z.ZodBoolean;
+    muteEditable: z.ZodBoolean;
     revision: z.ZodString;
 }, z.core.$strict>;
 export type AgentCatalogEntry = z.infer<typeof AgentCatalogEntrySchema>;
@@ -203,6 +205,7 @@ export declare const AgentCatalogResponseSchema: z.ZodObject<{
             }>>;
             role: z.ZodOptional<z.ZodLiteral<"creator">>;
             avatar: z.ZodOptional<z.ZodString>;
+            muted: z.ZodOptional<z.ZodLiteral<true>>;
         }, z.core.$strict>;
         visibility: z.ZodEnum<{
             visible: "visible";
@@ -211,6 +214,7 @@ export declare const AgentCatalogResponseSchema: z.ZodObject<{
         selectable: z.ZodBoolean;
         editable: z.ZodBoolean;
         avatarEditable: z.ZodBoolean;
+        muteEditable: z.ZodBoolean;
         revision: z.ZodString;
     }, z.core.$strict>>;
 }, z.core.$strict>;
@@ -222,12 +226,15 @@ export declare const AgentUpdateFields: {
         hidden: "hidden";
     }>>;
     avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Mutes the Agent's notifications, or with `false` unmutes them. */
+    muted: z.ZodOptional<z.ZodBoolean>;
     revision: z.ZodString;
 };
 /** At least one field besides the revision. */
 export declare function writesAgentField(value: {
     visibility?: unknown;
     avatar?: unknown;
+    muted?: unknown;
 }): boolean;
 export declare const AgentUpdateRequestSchema: z.ZodObject<{
     visibility: z.ZodOptional<z.ZodEnum<{
@@ -235,6 +242,7 @@ export declare const AgentUpdateRequestSchema: z.ZodObject<{
         hidden: "hidden";
     }>>;
     avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    muted: z.ZodOptional<z.ZodBoolean>;
     revision: z.ZodString;
 }, z.core.$strict>;
 export type AgentUpdateRequest = z.infer<typeof AgentUpdateRequestSchema>;
@@ -266,6 +274,7 @@ export declare const AgentUpdateResponseSchema: z.ZodObject<{
             }>>;
             role: z.ZodOptional<z.ZodLiteral<"creator">>;
             avatar: z.ZodOptional<z.ZodString>;
+            muted: z.ZodOptional<z.ZodLiteral<true>>;
         }, z.core.$strict>;
         visibility: z.ZodEnum<{
             visible: "visible";
@@ -274,6 +283,7 @@ export declare const AgentUpdateResponseSchema: z.ZodObject<{
         selectable: z.ZodBoolean;
         editable: z.ZodBoolean;
         avatarEditable: z.ZodBoolean;
+        muteEditable: z.ZodBoolean;
         revision: z.ZodString;
     }, z.core.$strict>;
 }, z.core.$strict>;

package/dist/protocol/push.d.ts

@@ -1,8 +1,12 @@
 import { z } from "zod";
 /**
  * Web Push contract shared by the browser, the service worker, and the gateway.
- * Content-free by construction: a category, a count, opaque ids when exactly
- * one Session is meant, a timestamp, and the device locale.
+ * One message is about one Session. It always carries the category, the Agent
+ * and Session ids, when the Session's newest event happened, and the device
+ * locale. A device whose registration is under 30 days old may also get the
+ * Agent's name, the Session's title, and a preview of what is asked: each one
+ * line, cut to its `PUSH_TEXT_LIMITS` entry, with credentials masked. Every
+ * encrypted message is padded to one size.
  */
 export declare const PushCategorySchema: z.ZodEnum<{
     input: "input";
@@ -31,24 +35,40 @@ export declare const PRESENCE_GRACE_MS = 60000;
  * operator who really left is owed, inside a 3-second input window.
  */
 export declare const PRESENCE_CLOSED_GRACE_MS = 2000;
-/** Fixed window from the first event in which one push per category is sent. */
+/**
+ * Fixed window from a category's first event. When it closes, each Session
+ * that had an event inside it gets one push, about its newest one.
+ */
 export declare const COALESCE_WINDOW_MS: Readonly<Record<PushCategory, number>>;
-/** The encrypted payload a device receives; ids are present iff count is 1. */
+/** The longest each text field may be, in UTF-16 units, as zod's `.max` counts. */
+export declare const PUSH_TEXT_LIMITS: {
+    readonly agentName: 64;
+    readonly sessionTitle: 120;
+    readonly requestText: 200;
+};
+/**
+ * The encrypted payload a device receives. `v` versions it on its own, apart
+ * from the ACP extension version; `requestMore` counts the questions asked
+ * after the one `requestText` previews.
+ */
 export declare const PushMessageSchema: z.ZodObject<{
-    v: z.ZodLiteral<1>;
+    v: z.ZodLiteral<2>;
     category: z.ZodEnum<{
         input: "input";
         failure: "failure";
         completion: "completion";
     }>;
-    count: z.ZodNumber;
-    agentId: z.ZodOptional<z.ZodString>;
-    sessionId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodString;
+    sessionId: z.ZodString;
     occurredAt: z.ZodISODateTime;
     locale: z.ZodEnum<{
         en: "en";
         he: "he";
     }>;
+    agentName: z.ZodOptional<z.ZodString>;
+    sessionTitle: z.ZodOptional<z.ZodString>;
+    requestText: z.ZodOptional<z.ZodString>;
+    requestMore: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export type PushMessage = z.infer<typeof PushMessageSchema>;
 export declare const PushCategoriesSchema: z.ZodObject<{

package/dist/protocol/sdk.js

@@ -112,6 +112,7 @@ import {
   parseArtifactUri2,
   HgwComposerPrefillNotificationSchema2,
   HgwErrorNotificationSchema2,
+  HGW_REQUEST_TEXT_MAX2,
   HgwActivityNotificationSchema2,
   PushCategorySchema2,
   categoryOf2,
@@ -121,6 +122,7 @@ import {
   PRESENCE_GRACE_MS2,
   PRESENCE_CLOSED_GRACE_MS2,
   COALESCE_WINDOW_MS2,
+  PUSH_TEXT_LIMITS2,
   PushMessageSchema2,
   PushCategoriesSchema2,
   PushSubscriptionJsonSchema2,
@@ -218,6 +220,7 @@ 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_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,
@@ -283,6 +286,7 @@ export {
   PRESENCE_GRACE_MS2 as PRESENCE_GRACE_MS,
   PRESENCE_HEARTBEAT_MS2 as PRESENCE_HEARTBEAT_MS,
   PRESENCE_IDLE_MS2 as PRESENCE_IDLE_MS,
+  PUSH_TEXT_LIMITS2 as PUSH_TEXT_LIMITS,
   PushCategoriesSchema2 as PushCategoriesSchema,
   PushCategorySchema2 as PushCategorySchema,
   PushInfoSchema2 as PushInfoSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-gw/sdk",
-  "version": "0.4.1",
+  "version": "0.5.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",
@@ -56,6 +56,7 @@
     "@openclaw/gateway-client": "2026.10.2",
     "@openclaw/gateway-protocol": "2026.10.2",
     "@opencode-ai/sdk": "1.19.0",
+    "@sanity-labs/secret-scan": "1.1.0",
     "@types/bun": "^1.4.3",
     "@types/ms": "2.1.0",
     "@types/node": "^26",