@harness-gw/sdk 0.1.3 → 0.2.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.1.3 \
+     ghcr.io/almogbaku/harness-gw:0.2.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.1.3 \
+     ghcr.io/almogbaku/harness-gw:0.2.0 \
      serve --config /run/harness-gw/config.yaml
    ```
 

package/dist/chunks/index.js

@@ -696,6 +696,9 @@ var HGW_METHODS2 = {
     focus: "_hgw/session/focus",
     part: "_hgw/session/part"
   },
+  sessions: {
+    search: "_hgw/sessions/search"
+  },
   agents: {
     list: "_hgw/agents/list",
     update: "_hgw/agents/update"
@@ -760,6 +763,19 @@ var HgwSessionNewMetaSchema2 = z2.strictObject({
 var HgwSessionListMetaSchema2 = z2.strictObject({
   agentId: IdentifierSchema2.optional()
 });
+var HgwSessionSearchMetaSchema2 = z2.strictObject({
+  agentId: IdentifierSchema2.optional(),
+  query: z2.string().min(1).max(512)
+});
+var HgwSessionSearchResponseSchema2 = readObject({
+  sessions: z2.array(readObject({
+    sessionId: IdentifierSchema2,
+    cwd: z2.string(),
+    title: z2.string().nullish(),
+    updatedAt: z2.string().nullish(),
+    _meta: z2.record(z2.string(), z2.unknown()).nullish()
+  }))
+});
 var HgwSessionInfoMetaSchema2 = readObject({
   agentId: IdentifierSchema2,
   status: SessionStatusSchema2,
@@ -1146,4 +1162,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, 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, 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 };

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

@@ -1,6 +1,7 @@
+import type { SessionInfo } from "@agentclientprotocol/sdk/experimental/v2";
 import { type Clock, type Logger } from "../lifecycle/index.js";
 import type { SessionModelUpdateRequest, SessionModelUpdateResponse } from "../protocol/index.js";
-import type { AgentUpdate, SessionActionCapabilities, SessionCreationOptions } from "./workspace.js";
+import type { AgentUpdate, SessionActionCapabilities, SessionCreationOptions, SessionSearchResult } from "./workspace.js";
 import type { HgwRemoteClient } from "./hgw-client.js";
 import type { AcpConnection } from "./types.js";
 /** What the workspace still reads over REST, delegated to the AOS client. */
@@ -73,12 +74,17 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
         }[];
     }>;
     readSessionPage: (meta: Parameters<AcpConnection["listSessions"]>[0], cursor?: string) => Promise<{
-        sessions: import("@agentclientprotocol/sdk/experimental/v2").SessionInfo[];
+        sessions: SessionInfo[];
         nextCursor?: string;
     }>;
     scopeSessionCatalog(agentId: string): void;
     /** The Agent the thread list pages History for, once one is selected. */
     sessionCatalogScope: () => string | undefined;
+    /**
+     * The Sessions the runtime matches to a query, across every Agent or the
+     * one named. Each lands in the row cache as a listed one does.
+     */
+    searchSessions(query: string, agentId?: string): Promise<SessionSearchResult[]>;
     subscribeSessionCatalog(listener: (sessionIds: readonly string[]) => void): () => boolean;
     getSessionMetadata(sessionIds: string[]): Promise<{
         sessionId: string;

package/dist/client/index.js

@@ -15,6 +15,8 @@ import {
   HGW_PERMISSION_KIND_SESSION2,
   HGW_JSONRPC_ERRORS2,
   HgwInitializeMetaSchema2,
+  HgwSessionSearchMetaSchema2,
+  HgwSessionSearchResponseSchema2,
   HgwSessionInfoMetaSchema2,
   HGW_REPLAY_BEFORE2,
   HgwHistoryPageResponseMetaSchema2,
@@ -1212,6 +1214,11 @@ function createAcpConnection(options) {
         ...response.nextCursor ? { nextCursor: response.nextCursor } : {}
       };
     },
+    async searchSessions(meta) {
+      return HgwSessionSearchResponseSchema2.parse(await request("short", (agent, options) => agent.request(HGW_METHODS2.sessions.search, {
+        _meta: { [HGW_META_KEY2]: HgwSessionSearchMetaSchema2.parse(meta) }
+      }, options)));
+    },
     subscribe,
     joined,
     replay,
@@ -1799,6 +1806,14 @@ function createAcpWorkspaceClient({
     listedAgentIds = new Set(response.agents.map(({ summary }) => summary.id));
     return response;
   }
+  function rememberRows(sessions) {
+    for (const session of sessions) {
+      const row = rowOf(session);
+      remember(row.sessionId, row.info, row.updatedAt);
+      if (row.title)
+        store.setTitle(row.sessionId, row.title);
+    }
+  }
   const pageReads = new Map;
   let catalogScope;
   function readSessionPage(meta, cursor) {
@@ -1807,12 +1822,7 @@ function createAcpWorkspaceClient({
     if (inFlight)
       return inFlight;
     const read = connection.listSessions(meta, cursor).then((page) => {
-      for (const session of page.sessions) {
-        const row = rowOf(session);
-        remember(row.sessionId, row.info, row.updatedAt);
-        if (row.title)
-          store.setTitle(row.sessionId, row.title);
-      }
+      rememberRows(page.sessions);
       return page;
     }).finally(() => pageReads.delete(key));
     pageReads.set(key, read);
@@ -1977,6 +1987,20 @@ function createAcpWorkspaceClient({
       catalogScope = agentId;
     },
     sessionCatalogScope: () => catalogScope,
+    async searchSessions(query, agentId) {
+      const { sessions } = await connection.searchSessions({
+        query,
+        ...agentId === undefined ? {} : { agentId }
+      });
+      rememberRows(sessions);
+      const titles = new Map(sessions.map(({ sessionId, title }) => [sessionId, title ?? ""]));
+      return store.rowsFor(sessions.map(({ sessionId }) => sessionId)).map(({ sessionId, agentId, updatedAt }) => ({
+        sessionId,
+        agentId,
+        title: titles.get(sessionId) ?? "",
+        updatedAt
+      }));
+    },
     subscribeSessionCatalog(listener) {
       catalogListeners.add(listener);
       return () => catalogListeners.delete(listener);

package/dist/client/types.d.ts

@@ -1,7 +1,7 @@
 import type { 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, HgwSessionUpdateRequestSchema, HgwSteerRequestSchema, HgwSteerResponseSchema } from "../protocol/acp.js";
+import type { HgwAgentUpdateRequest, HgwAgentUpdateResponseSchema, HgwHistoryCursor, HgwInitializeMetaSchema, HgwPromptMetaSchema, HgwSessionListMetaSchema, HgwSessionNewMetaSchema, HgwSessionSearchMeta, HgwSessionUpdateRequestSchema, HgwSteerRequestSchema, HgwSteerResponseSchema } from "../protocol/acp.js";
 /**
  * The browser-side seam over one ACP v2 WebSocket connection to the gateway.
  * `connection.ts` implements it; the runtime, thread list, interactions, and
@@ -96,6 +96,13 @@ export interface AcpConnection {
         sessions: SessionInfo[];
         nextCursor?: string;
     }>;
+    /**
+     * The Sessions matching a query, at most one window of them, newest first
+     * where the runtime orders them. Operators only.
+     */
+    searchSessions(meta: HgwSessionSearchMeta): Promise<{
+        sessions: SessionInfo[];
+    }>;
     /**
      * Opens the Session while any listener subscribes. The connection joins it,
      * replaying it from the start the first time, rejoins it from its own

package/dist/client/workspace.d.ts

@@ -54,6 +54,11 @@ export type SessionMetadata = {
     /** External platform the Session came from; absent for AOS-native Sessions. */
     platform?: SessionPlatform;
 };
+/** One Session a search matched, as its row cache now holds it. */
+export type SessionSearchResult = Pick<SessionMetadata, "sessionId" | "agentId" | "updatedAt"> & {
+    /** The provider's title, or empty when it reports none. */
+    title: string;
+};
 /** Which Session actions the selected runtime declares it performs. */
 export type SessionActionCapabilities = {
     rename: boolean;

package/dist/protocol/acp.d.ts

@@ -40,6 +40,9 @@ export declare const HGW_METHODS: {
         readonly focus: "_hgw/session/focus";
         readonly part: "_hgw/session/part";
     };
+    readonly sessions: {
+        readonly search: "_hgw/sessions/search";
+    };
     readonly agents: {
         readonly list: "_hgw/agents/list";
         readonly update: "_hgw/agents/update";
@@ -131,6 +134,25 @@ export declare const HgwSessionNewMetaSchema: z.ZodObject<{
 export declare const HgwSessionListMetaSchema: z.ZodObject<{
     agentId: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
+/** `_hgw/sessions/search` request `_meta.hgw`. */
+export declare const HgwSessionSearchMetaSchema: z.ZodObject<{
+    agentId: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+}, z.core.$strict>;
+export type HgwSessionSearchMeta = z.infer<typeof HgwSessionSearchMetaSchema>;
+/**
+ * The `_hgw/sessions/search` response: matching Sessions as `session/list`
+ * entries, which ACP's own schema validates for `session/list` alone.
+ */
+export declare const HgwSessionSearchResponseSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        sessionId: z.ZodString;
+        cwd: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        updatedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        _meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * `SessionInfo._meta.hgw` on `session/list` entries and
  * `session_info_update._meta.hgw`. `unread`, `pinned`, and `createdAt` are

package/dist/protocol/sdk.js

@@ -72,6 +72,8 @@ import {
   HgwLoginMetaSchema2,
   HgwSessionNewMetaSchema2,
   HgwSessionListMetaSchema2,
+  HgwSessionSearchMetaSchema2,
+  HgwSessionSearchResponseSchema2,
   HgwSessionInfoMetaSchema2,
   HgwSessionResumeMetaSchema2,
   HGW_REPLAY_BEFORE2,
@@ -251,6 +253,8 @@ export {
   HgwSessionPartRequestSchema2 as HgwSessionPartRequestSchema,
   HgwSessionResumeMetaSchema2 as HgwSessionResumeMetaSchema,
   HgwSessionResumeResponseMetaSchema2 as HgwSessionResumeResponseMetaSchema,
+  HgwSessionSearchMetaSchema2 as HgwSessionSearchMetaSchema,
+  HgwSessionSearchResponseSchema2 as HgwSessionSearchResponseSchema,
   HgwSessionUpdateRequestSchema2 as HgwSessionUpdateRequestSchema,
   HgwStateMetaSchema2 as HgwStateMetaSchema,
   HgwSteerRequestSchema2 as HgwSteerRequestSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-gw/sdk",
-  "version": "0.1.3",
+  "version": "0.2.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",