@harness-gw/sdk 0.4.1 → 0.5.1

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

@@ -44,7 +44,7 @@ export declare class HgwRemoteClient {
             id: string;
             name: string;
         };
-        status: "unavailable" | "ready" | "degraded";
+        status: "degraded" | "ready" | "unavailable";
         capabilities: {
             agentCatalog: {
                 status: "available";
@@ -174,8 +174,8 @@ export declare class HgwRemoteClient {
             filename?: string | undefined;
         } | {
             type: "file";
-            mimeType: string;
             filename?: string | undefined;
+            mimeType: string;
         })[];
     }>;
     readArtifact(sessionId: string, artifactId: string, signal?: AbortSignal): Promise<Blob>;
@@ -202,11 +202,27 @@ export declare class HgwRemoteClient {
         toolInput?: Record<string, unknown> | undefined;
         toolResult?: {
             [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                "io.modelcontextprotocol/serverInfo"?: {
+                    version: string;
+                    websiteUrl?: string | undefined;
+                    description?: string | undefined;
+                    icons?: {
+                        src: string;
+                        mimeType?: string | undefined;
+                        sizes?: string[] | undefined;
+                        theme?: "dark" | "light" | undefined;
+                    }[] | undefined;
+                    name: string;
+                    title?: string | undefined;
+                } | undefined;
+            } | undefined;
             content: ({
                 type: "text";
                 text: string;
                 annotations?: {
-                    audience?: ("user" | "assistant")[] | undefined;
+                    audience?: ("assistant" | "user")[] | undefined;
                     priority?: number | undefined;
                     lastModified?: string | undefined;
                 } | undefined;
@@ -216,7 +232,7 @@ export declare class HgwRemoteClient {
                 data: string;
                 mimeType: string;
                 annotations?: {
-                    audience?: ("user" | "assistant")[] | undefined;
+                    audience?: ("assistant" | "user")[] | undefined;
                     priority?: number | undefined;
                     lastModified?: string | undefined;
                 } | undefined;
@@ -226,20 +242,18 @@ export declare class HgwRemoteClient {
                 data: string;
                 mimeType: string;
                 annotations?: {
-                    audience?: ("user" | "assistant")[] | undefined;
+                    audience?: ("assistant" | "user")[] | undefined;
                     priority?: number | undefined;
                     lastModified?: string | undefined;
                 } | undefined;
                 _meta?: Record<string, unknown> | undefined;
             } | {
                 uri: string;
-                name: string;
-                type: "resource_link";
                 description?: string | undefined;
                 mimeType?: string | undefined;
                 size?: number | undefined;
                 annotations?: {
-                    audience?: ("user" | "assistant")[] | undefined;
+                    audience?: ("assistant" | "user")[] | undefined;
                     priority?: number | undefined;
                     lastModified?: string | undefined;
                 } | undefined;
@@ -250,45 +264,31 @@ export declare class HgwRemoteClient {
                     src: string;
                     mimeType?: string | undefined;
                     sizes?: string[] | undefined;
-                    theme?: "light" | "dark" | undefined;
+                    theme?: "dark" | "light" | undefined;
                 }[] | undefined;
+                name: string;
                 title?: string | undefined;
+                type: "resource_link";
             } | {
                 type: "resource";
                 resource: {
                     uri: string;
-                    text: string;
                     mimeType?: string | undefined;
                     _meta?: Record<string, unknown> | undefined;
+                    text: string;
                 } | {
                     uri: string;
-                    blob: string;
                     mimeType?: string | undefined;
                     _meta?: Record<string, unknown> | undefined;
+                    blob: string;
                 };
                 annotations?: {
-                    audience?: ("user" | "assistant")[] | undefined;
+                    audience?: ("assistant" | "user")[] | undefined;
                     priority?: number | undefined;
                     lastModified?: string | undefined;
                 } | undefined;
                 _meta?: Record<string, unknown> | undefined;
             })[];
-            _meta?: {
-                [x: string]: unknown;
-                "io.modelcontextprotocol/serverInfo"?: {
-                    version: string;
-                    name: string;
-                    websiteUrl?: string | undefined;
-                    description?: string | undefined;
-                    icons?: {
-                        src: string;
-                        mimeType?: string | undefined;
-                        sizes?: string[] | undefined;
-                        theme?: "light" | "dark" | undefined;
-                    }[] | undefined;
-                    title?: string | undefined;
-                } | undefined;
-            } | undefined;
             structuredContent?: unknown;
             isError?: boolean | undefined;
         } | undefined;
@@ -305,11 +305,27 @@ export declare class HgwRemoteClient {
     /** A tool call the App view makes, answered by the proxy's MCP server. */
     callMcpAppTool(sessionId: string, toolCallId: string, request: McpAppToolCallRequest): Promise<{
         [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            "io.modelcontextprotocol/serverInfo"?: {
+                version: string;
+                websiteUrl?: string | undefined;
+                description?: string | undefined;
+                icons?: {
+                    src: string;
+                    mimeType?: string | undefined;
+                    sizes?: string[] | undefined;
+                    theme?: "dark" | "light" | undefined;
+                }[] | undefined;
+                name: string;
+                title?: string | undefined;
+            } | undefined;
+        } | undefined;
         content: ({
             type: "text";
             text: string;
             annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
+                audience?: ("assistant" | "user")[] | undefined;
                 priority?: number | undefined;
                 lastModified?: string | undefined;
             } | undefined;
@@ -319,7 +335,7 @@ export declare class HgwRemoteClient {
             data: string;
             mimeType: string;
             annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
+                audience?: ("assistant" | "user")[] | undefined;
                 priority?: number | undefined;
                 lastModified?: string | undefined;
             } | undefined;
@@ -329,20 +345,18 @@ export declare class HgwRemoteClient {
             data: string;
             mimeType: string;
             annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
+                audience?: ("assistant" | "user")[] | undefined;
                 priority?: number | undefined;
                 lastModified?: string | undefined;
             } | undefined;
             _meta?: Record<string, unknown> | undefined;
         } | {
             uri: string;
-            name: string;
-            type: "resource_link";
             description?: string | undefined;
             mimeType?: string | undefined;
             size?: number | undefined;
             annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
+                audience?: ("assistant" | "user")[] | undefined;
                 priority?: number | undefined;
                 lastModified?: string | undefined;
             } | undefined;
@@ -353,78 +367,64 @@ export declare class HgwRemoteClient {
                 src: string;
                 mimeType?: string | undefined;
                 sizes?: string[] | undefined;
-                theme?: "light" | "dark" | undefined;
+                theme?: "dark" | "light" | undefined;
             }[] | undefined;
+            name: string;
             title?: string | undefined;
+            type: "resource_link";
         } | {
             type: "resource";
             resource: {
                 uri: string;
-                text: string;
                 mimeType?: string | undefined;
                 _meta?: Record<string, unknown> | undefined;
+                text: string;
             } | {
                 uri: string;
-                blob: string;
                 mimeType?: string | undefined;
                 _meta?: Record<string, unknown> | undefined;
+                blob: string;
             };
             annotations?: {
-                audience?: ("user" | "assistant")[] | undefined;
+                audience?: ("assistant" | "user")[] | undefined;
                 priority?: number | undefined;
                 lastModified?: string | undefined;
             } | undefined;
             _meta?: Record<string, unknown> | undefined;
         })[];
+        structuredContent?: unknown;
+        isError?: boolean | undefined;
+    }>;
+    /** A resource read the App view makes, answered by the proxy's MCP server. */
+    readMcpAppResource(sessionId: string, subject: McpAppSubject, request: McpAppResourceReadRequest): Promise<{
+        [x: string]: unknown;
         _meta?: {
             [x: string]: unknown;
             "io.modelcontextprotocol/serverInfo"?: {
                 version: string;
-                name: string;
                 websiteUrl?: string | undefined;
                 description?: string | undefined;
                 icons?: {
                     src: string;
                     mimeType?: string | undefined;
                     sizes?: string[] | undefined;
-                    theme?: "light" | "dark" | undefined;
+                    theme?: "dark" | "light" | undefined;
                 }[] | undefined;
+                name: string;
                 title?: string | undefined;
             } | undefined;
         } | undefined;
-        structuredContent?: unknown;
-        isError?: boolean | undefined;
-    }>;
-    /** A resource read the App view makes, answered by the proxy's MCP server. */
-    readMcpAppResource(sessionId: string, subject: McpAppSubject, request: McpAppResourceReadRequest): Promise<{
-        [x: string]: unknown;
         contents: ({
             uri: string;
-            text: string;
             mimeType?: string | undefined;
             _meta?: Record<string, unknown> | undefined;
+            text: string;
         } | {
             uri: string;
-            blob: string;
             mimeType?: string | undefined;
             _meta?: Record<string, unknown> | undefined;
+            blob: string;
         })[];
-        _meta?: {
-            [x: string]: unknown;
-            "io.modelcontextprotocol/serverInfo"?: {
-                version: string;
-                name: string;
-                websiteUrl?: string | undefined;
-                description?: string | undefined;
-                icons?: {
-                    src: string;
-                    mimeType?: string | undefined;
-                    sizes?: string[] | undefined;
-                    theme?: "light" | "dark" | undefined;
-                }[] | undefined;
-                title?: string | undefined;
-            } | undefined;
-        } | undefined;
     }>;
     transcribe(sessionId: string, audio: Blob, signal?: AbortSignal): Promise<string>;
     transcribeForAgent(agentId: string, audio: Blob, signal?: AbortSignal): Promise<string>;

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/log.d.ts

@@ -20,11 +20,11 @@ type Json = Record<string, unknown>;
  * the message itself without its credentials.
  */
 export declare function frameFields(direction: "in" | "out", message: unknown): {
-    frame: Json;
-    sessionId?: string | undefined;
-    method?: string | undefined;
+    direction: "in" | "out";
     requestId?: {} | null | undefined;
-    direction: "out" | "in";
+    method?: string | undefined;
+    sessionId?: string | undefined;
+    frame: Json;
 };
 /** `stream` with one `acp.frame` debug line per message, each way. */
 export declare function loggedStream(stream: WireStream, logger: Logger): WireStream;

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;