@harness-gw/sdk 0.10.4 → 0.11.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.10.4 \
+     ghcr.io/almogbaku/harness-gw:0.11.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.10.4 \
+     ghcr.io/almogbaku/harness-gw:0.11.0 \
      serve --config /run/harness-gw/config.yaml
    ```
 

package/dist/chunks/index.js

@@ -9,6 +9,7 @@ var IdentifierSchema = z.string().min(1).max(256).refine((value) => [...value].e
   return code >= 32 && code !== 127;
 }));
 var Utf8MiBTextSchema = z.string().min(1).refine((value) => new TextEncoder().encode(value).byteLength <= 1048576);
+var JsonRecordSchema = z.record(z.string(), z.json());
 var RuntimeAuthStateSchema2 = z.discriminatedUnion("status", [
   z.strictObject({ status: z.literal("authenticated") }),
   z.strictObject({ status: z.literal("authentication-required") }),
@@ -83,9 +84,9 @@ var AgentSummarySchema = z.strictObject({
   status: z.enum(["idle", "active", "running", "attention", "unknown"]).optional(),
   activity: z.enum(["active", "idle", "unknown"]).optional(),
   visibility: z.enum(["visible", "hidden"]).optional(),
-  role: z.literal("creator").optional(),
   avatar: AgentAvatarSchema2.optional(),
-  muted: z.literal(true).optional()
+  muted: z.literal(true).optional(),
+  _meta: JsonRecordSchema.optional()
 });
 var AgentCatalogEntrySchema2 = z.strictObject({
   summary: AgentSummarySchema,
@@ -199,7 +200,6 @@ var ToolDiffSchema2 = z.strictObject({
   changes: z.array(DiffChangeSchema2).min(1),
   patch: z.string().optional()
 });
-var JsonRecordSchema = z.record(z.string(), z.json());
 var SessionMessagePartSchema = z.discriminatedUnion("type", [
   z.strictObject({ type: z.literal("text"), text: z.string().max(1e6) }),
   z.strictObject({
@@ -735,7 +735,7 @@ function hgwAcpAgentPath2(agentId) {
   return `${HGW_ACP_AGENTS_PATH2}/${encodeURIComponent(agentId)}`;
 }
 var HGW_META_KEY2 = "hgw";
-var HGW_EXTENSION_VERSION2 = 2;
+var HGW_EXTENSION_VERSION2 = 3;
 var HGW_AUTH_METHOD_INVITE2 = "hgw-invite";
 var HGW_ATTACHMENT_URI_SCHEME2 = "hgw-attachment:";
 var HGW_ARTIFACT_URI_SCHEME2 = "artifact:";
@@ -1053,10 +1053,8 @@ function categoryOf2(type) {
     case "attention-requested":
       return "input";
     case "turn-failed":
-    case "agent-activation-failed":
       return "failure";
     case "turn-finished":
-    case "agent-ready":
       return "completion";
     default:
       return;

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

@@ -12,12 +12,10 @@ type MetadataListener = (metadata: SessionMetadata[]) => void;
 export type AcpSessionStoreOptions = {
     connection: AcpConnection;
     now?: () => number;
-    /** A live turn of a subscribed Session just stopped, however it ended. */
-    onTurnFinished?: (sessionId: string) => void;
     /** Where a listener that throws is told; the others still hear. */
     logger?: Logger;
 };
-export declare function createAcpSessionStore({ connection, now, onTurnFinished, logger, }: AcpSessionStoreOptions): {
+export declare function createAcpSessionStore({ connection, now, logger, }: AcpSessionStoreOptions): {
     subscribe: (sessionId: string, agentId?: string) => () => void;
     dispose(): void;
     /**
@@ -59,7 +57,6 @@ export declare function createAcpSessionStore({ connection, now, onTurnFinished,
     subscribeMetadata(sessionIds: readonly string[], listener: MetadataListener): () => boolean;
     subscribeStatus(sessionId: string, listener: () => void): () => boolean;
     subscribeTodos(sessionId: string, listener: (todos: TodoItem[]) => void): () => void;
-    emitActivity: (event: WorkspaceActivityEvent) => void;
     subscribeActivity(listener: (event: WorkspaceActivityEvent) => void): () => boolean;
     subscribeInvalidation(sessionId: string, listener: () => void): () => void;
 };

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

@@ -26,9 +26,9 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
         status?: "active" | "attention" | "idle" | "running" | "unknown" | undefined;
         activity?: "active" | "idle" | "unknown" | undefined;
         visibility?: "hidden" | "visible" | undefined;
-        role?: "creator" | undefined;
         avatar?: string | undefined;
         muted?: true | undefined;
+        _meta?: Record<string, import("zod").JSONType> | undefined;
     }[]>;
     refreshAgents(): Promise<{
         kind: "ready";
@@ -38,9 +38,9 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
         status?: "active" | "attention" | "idle" | "running" | "unknown" | undefined;
         activity?: "active" | "idle" | "unknown" | undefined;
         visibility?: "hidden" | "visible" | undefined;
-        role?: "creator" | undefined;
         avatar?: string | undefined;
         muted?: true | undefined;
+        _meta?: Record<string, import("zod").JSONType> | undefined;
     }[]>;
     listAgentCatalog(): Promise<{
         summary: {
@@ -51,9 +51,9 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
             status?: "active" | "attention" | "idle" | "running" | "unknown" | undefined;
             activity?: "active" | "idle" | "unknown" | undefined;
             visibility?: "hidden" | "visible" | undefined;
-            role?: "creator" | undefined;
             avatar?: string | undefined;
             muted?: true | undefined;
+            _meta?: Record<string, import("zod").JSONType> | undefined;
         };
         visibility: "hidden" | "visible";
         selectable: boolean;

package/dist/client/index.js

@@ -1690,7 +1690,6 @@ function sameRow(left, right) {
 function createAcpSessionStore({
   connection,
   now = Date.now,
-  onTurnFinished,
   logger = SILENT_LOGGER
 }) {
   const rows = new Map;
@@ -1770,10 +1769,7 @@ function createAcpSessionStore({
       const status = statusFromState(update);
       if (replaying.has(sessionId))
         return void replaying.set(sessionId, status);
-      const previous = rows.get(sessionId)?.status;
       patch(sessionId, { status });
-      if ((previous === "running" || previous === "waiting-for-input") && (status === "idle" || status === "failed"))
-        onTurnFinished?.(sessionId);
       return;
     }
     if (SessionUpdate3.isSessionInfoUpdate(update)) {
@@ -1904,7 +1900,6 @@ function createAcpSessionStore({
           todoListeners.delete(sessionId);
       };
     },
-    emitActivity,
     subscribeActivity(listener) {
       activityListeners.add(listener);
       return () => activityListeners.delete(listener);
@@ -1947,10 +1942,7 @@ function createAcpWorkspaceClient({
   const store = createAcpSessionStore({
     connection,
     logger: clientLog,
-    ...now ? { now } : {},
-    onTurnFinished: (sessionId) => {
-      reportCreatedAgents(sessionId).catch((err) => clientLog.warn({ err }, "agent.report_created_failed"));
-    }
+    ...now ? { now } : {}
   });
   const composer = createAcpComposerStore(connection);
   const revisions = new Map;
@@ -1961,9 +1953,6 @@ function createAcpWorkspaceClient({
     const result = await connection.updateAgent({ agentId, ...patch, revision });
     revisions.set(agentId, result.agent.revision);
   }
-  let creatorId;
-  let listedAgentIds = new Set;
-  const creatorBaselines = new Map;
   let sessionActions;
   function adopt(sessionId, agentId) {
     try {
@@ -1988,8 +1977,6 @@ function createAcpWorkspaceClient({
     revisions.clear();
     for (const entry of response.agents)
       revisions.set(entry.summary.id, entry.revision);
-    creatorId = response.agents.find(({ summary }) => summary.role === "creator")?.summary.id;
-    listedAgentIds = new Set(response.agents.map(({ summary }) => summary.id));
     return response;
   }
   function rememberRows(sessions) {
@@ -2024,33 +2011,6 @@ function createAcpWorkspaceClient({
     pageReads.set(key, read);
     return read;
   }
-  function watchCreator(sessionId, agentId) {
-    if (agentId === creatorId && !creatorBaselines.has(sessionId))
-      creatorBaselines.set(sessionId, new Set(listedAgentIds));
-  }
-  async function reportCreatedAgents(sessionId) {
-    const baseline = creatorBaselines.get(sessionId);
-    if (!baseline)
-      return;
-    let agents;
-    try {
-      agents = (await catalog()).agents;
-    } catch {
-      return;
-    }
-    for (const { summary, visibility } of agents) {
-      if (baseline.has(summary.id))
-        continue;
-      baseline.add(summary.id);
-      store.emitActivity({
-        id: `${sessionId}:${summary.id}`,
-        type: visibility === "hidden" ? "agent-activation-failed" : "agent-ready",
-        agentId: summary.id,
-        sessionId,
-        occurredAt: new Date((now ?? Date.now)()).toISOString()
-      });
-    }
-  }
   async function listSessions(agentId, cursor) {
     const page = await readSessionPage(agentId === undefined ? {} : { agentId }, cursor);
     return {
@@ -2144,10 +2104,8 @@ function createAcpWorkspaceClient({
           leaveComposer();
         }
       });
-      if (agentId) {
+      if (agentId)
         adopt(sessionId, agentId);
-        watchCreator(sessionId, agentId);
-      }
     }
     let released = false;
     return () => {
@@ -2224,7 +2182,6 @@ function createAcpWorkspaceClient({
         ...options?.title ? { title: options.title } : {}
       });
       adopt(created.sessionId, agentId);
-      watchCreator(created.sessionId, agentId);
       return { sessionId: created.sessionId };
     },
     subscribeSession,

package/dist/client/workspace.d.ts

@@ -52,8 +52,6 @@ export type WorkspaceActivityEvent = (ActivityBase & {
 }) | (ActivityBase & {
     type: "attention-resolved";
     requestId: string;
-}) | (ActivityBase & {
-    type: "agent-ready" | "agent-activation-failed";
 });
 export type SessionMetadata = {
     sessionId: 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: 2;
+export declare const HGW_EXTENSION_VERSION: 3;
 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:";
@@ -120,7 +120,7 @@ export declare const HgwClientCapabilitiesMetaSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** `InitializeResponse._meta.hgw` */
 export declare const HgwInitializeMetaSchema: z.ZodObject<{
-    version: z.ZodLiteral<2>;
+    version: z.ZodLiteral<3>;
     role: z.ZodEnum<{
         guest: "guest";
         operator: "operator";
@@ -349,9 +349,9 @@ export declare const HgwAgentsListResponseSchema: z.ZodObject<{
                 hidden: "hidden";
                 visible: "visible";
             }>>;
-            role: z.ZodOptional<z.ZodLiteral<"creator">>;
             avatar: z.ZodOptional<z.ZodString>;
             muted: z.ZodOptional<z.ZodLiteral<true>>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
         }, z.core.$strict>;
         visibility: z.ZodEnum<{
             hidden: "hidden";
@@ -400,9 +400,9 @@ export declare const HgwAgentUpdateResponseSchema: z.ZodObject<{
                 hidden: "hidden";
                 visible: "visible";
             }>>;
-            role: z.ZodOptional<z.ZodLiteral<"creator">>;
             avatar: z.ZodOptional<z.ZodString>;
             muted: z.ZodOptional<z.ZodLiteral<true>>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
         }, z.core.$strict>;
         visibility: z.ZodEnum<{
             hidden: "hidden";

package/dist/protocol/index.d.ts

@@ -164,9 +164,9 @@ export declare const AgentCatalogEntrySchema: z.ZodObject<{
             hidden: "hidden";
             visible: "visible";
         }>>;
-        role: z.ZodOptional<z.ZodLiteral<"creator">>;
         avatar: z.ZodOptional<z.ZodString>;
         muted: z.ZodOptional<z.ZodLiteral<true>>;
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
     }, z.core.$strict>;
     visibility: z.ZodEnum<{
         hidden: "hidden";
@@ -203,9 +203,9 @@ export declare const AgentCatalogResponseSchema: z.ZodObject<{
                 hidden: "hidden";
                 visible: "visible";
             }>>;
-            role: z.ZodOptional<z.ZodLiteral<"creator">>;
             avatar: z.ZodOptional<z.ZodString>;
             muted: z.ZodOptional<z.ZodLiteral<true>>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
         }, z.core.$strict>;
         visibility: z.ZodEnum<{
             hidden: "hidden";
@@ -272,9 +272,9 @@ export declare const AgentUpdateResponseSchema: z.ZodObject<{
                 hidden: "hidden";
                 visible: "visible";
             }>>;
-            role: z.ZodOptional<z.ZodLiteral<"creator">>;
             avatar: z.ZodOptional<z.ZodString>;
             muted: z.ZodOptional<z.ZodLiteral<true>>;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
         }, z.core.$strict>;
         visibility: z.ZodEnum<{
             hidden: "hidden";

package/dist/protocol/push.d.ts

@@ -14,7 +14,7 @@ export declare const PushCategorySchema: z.ZodEnum<{
     input: "input";
 }>;
 export type PushCategory = z.infer<typeof PushCategorySchema>;
-/** Which category, if any, an execution or Agent lifecycle event notifies as. */
+/** Which category, if any, an execution event notifies as. */
 export declare function categoryOf(type: string): PushCategory | undefined;
 export declare const PushLocaleSchema: z.ZodEnum<{
     en: "en";

package/package.json

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