@hanphone/dsh-a2a 0.2.0 → 0.3.0

package/lib/types/service.js

@@ -1,7 +1,7 @@
 /**
- * The `ctx.a2a` service facade: the thin read/control surface commands and
- * other plugins use. Registered as a Cordis Service so the key disappears
- * with the plugin fiber.
+ * The `ctx.a2a` service facade: the thin read/control surface commands, the
+ * GUI API, and other plugins use. Registered as a Cordis Service so the key
+ * disappears with the plugin fiber.
  * @module dsh-a2a/service
  */
 import { Service } from '@deepseek-ai/cordis';
@@ -15,44 +15,53 @@ export class A2AService extends Service {
     status() {
         return this.impl.status();
     }
-    async enableServer(enable) {
-        return this.impl.enableServer(enable);
+    async presets() {
+        return this.impl.presets();
     }
-    getTask(taskId) {
-        return this.impl.getTask(taskId);
+    listInboundServers() {
+        return this.impl.listInboundServers();
     }
-    listTasks() {
-        return this.impl.listTasks();
+    async createInboundServer(input) {
+        return this.impl.createInboundServer(input);
     }
-    async cancelTask(taskId) {
-        return this.impl.cancelTask(taskId);
+    async removeInboundServer(id) {
+        return this.impl.removeInboundServer(id);
     }
-    agents() {
-        return this.impl.agents();
+    async setInboundServerEnabled(id, enabled) {
+        return this.impl.setInboundServerEnabled(id, enabled);
     }
-    async addAgent(spec) {
-        return this.impl.addAgent(spec);
+    async updateInboundServer(id, patch) {
+        return this.impl.updateInboundServer(id, patch);
     }
-    async removeAgent(id) {
-        return this.impl.removeAgent(id);
+    listOutboundServers() {
+        return this.impl.listOutboundServers();
     }
-    async setAgentEnabled(id, enabled) {
-        return this.impl.setAgentEnabled(id, enabled);
+    async createOutboundServer(input) {
+        return this.impl.createOutboundServer(input);
     }
-    async refreshAgentCard(id) {
-        return this.impl.refreshAgentCard(id);
+    async removeOutboundServer(id) {
+        return this.impl.removeOutboundServer(id);
     }
-    identity() {
-        return this.impl.identity();
+    async setOutboundServerEnabled(id, enabled) {
+        return this.impl.setOutboundServerEnabled(id, enabled);
     }
-    async updateIdentity(patch) {
-        return this.impl.updateIdentity(patch);
+    async refreshOutboundServer(id) {
+        return this.impl.refreshOutboundServer(id);
     }
-    async closeInbound(peerId) {
-        return this.impl.closeInbound(peerId);
+    getTask(taskId) {
+        return this.impl.getTask(taskId);
+    }
+    listTasks() {
+        return this.impl.listTasks();
+    }
+    async cancelTask(taskId) {
+        return this.impl.cancelTask(taskId);
     }
     inbounds() {
         return this.impl.inbounds();
     }
+    async closeInbound(peerId) {
+        return this.impl.closeInbound(peerId);
+    }
 }
 //# sourceMappingURL=service.js.map

package/lib/types/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,qBAAqB,CAAA;AA6B3D,mDAAmD;AACnD,MAAM,OAAO,UAAW,SAAQ,OAAO;IAGlB;IAFnB,YACE,GAAY,EACK,IAAoB;QAErC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAFA,SAAI,GAAJ,IAAI,CAAgB;IAGvC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAe;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAClC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAgG;QAC7G,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;IAClC,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,EAAU,EAAE,OAAgB;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAC/C,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,EAAU;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAA2F;QAC9G,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC7B,CAAC;CACF"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,qBAAqB,CAAA;AAsG3D,mDAAmD;AACnD,MAAM,OAAO,UAAW,SAAQ,OAAO;IAGlB;IAFnB,YACE,GAAY,EACK,IAAoB;QAErC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAFA,SAAI,GAAJ,IAAI,CAAgB;IAGvC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA;IAC5B,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAA;IACvC,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,KAAyB;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,EAAU;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,EAAU,EAAE,OAAgB;QACxD,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,EAAU,EAAE,KAA8J;QAClM,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;IACjD,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,KAA0B;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,EAAU;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED,KAAK,CAAC,wBAAwB,CAAC,EAAU,EAAE,OAAgB;QACzD,OAAO,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACxD,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,EAAU;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAClC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC;CACF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hanphone/dsh-a2a",
-  "version": "0.2.0",
-  "description": "Agent2Agent (A2A) v1.0 dual-end plugin for DeepSeek Harness: governed inbound tasks, durable task store, pluggable executors, multi-agent outbound consumption, GUI management dashboard.",
+  "version": "0.3.0",
+  "description": "Agent2Agent (A2A) v1.0.1 dual-end plugin for DeepSeek Harness: multiple inbound servers (per-instance agent presets, creator-declared skill advertisements), multiple outbound connections, GUI-managed instance lifecycle.",
   "type": "module",
   "license": "MIT",
   "keywords": [

package/src/api.ts

@@ -1,9 +1,10 @@
 /**
  * GUI control API for the A2A settings dashboard: one `GET /a2a/api`
- * snapshot plus `POST /a2a/api` control actions (server toggle, outbound
- * agent management, task view). The browser half talks only to this route;
- * it carries no protocol knowledge. Loopback-only by default so the
- * dashboard cannot be driven from the wire.
+ * snapshot plus `POST /a2a/api` control actions (inbound/outbound server
+ * CRUD + enable/disable, task view/cancel) and `GET /a2a/api/presets` for the
+ * preset roster the pickers need. The browser half talks only to this route;
+ * it carries no protocol knowledge. Loopback-only by default so the dashboard
+ * cannot be driven from the wire.
  *
  * The route body is bound to the same `A2AServiceImpl` facade the `/a2a`
  * command surface uses, so GUI actions and commands cannot disagree.
@@ -15,27 +16,19 @@ import type { A2AServiceImpl } from './service.ts'
 
 /** Control actions the dashboard can issue. */
 export type ApiAction =
-  | { readonly action: 'server.enable' | 'server.disable' }
-  | { readonly action: 'agent.add'; readonly name: string; readonly agentCardUrl: string; readonly bearerTokenEnv?: string }
-  | { readonly action: 'agent.remove' | 'agent.enable' | 'agent.disable' | 'agent.refresh'; readonly id: string }
+  | { readonly action: 'inbound.create'; readonly name: string; readonly description: string; readonly version: string; readonly endpointPath?: string; readonly preset?: string; readonly authTokenEnv?: string; readonly skills?: readonly { id: string; name: string; description?: string }[]; readonly enabled?: boolean }
+  | { readonly action: 'inbound.remove' | 'inbound.enable' | 'inbound.disable' | 'inbound.update'; readonly id: string; readonly name?: string; readonly description?: string; readonly version?: string; readonly endpointPath?: string; readonly preset?: string; readonly authTokenEnv?: string; readonly skills?: readonly { id: string; name: string; description?: string }[] }
+  | { readonly action: 'outbound.create'; readonly name: string; readonly agentCardUrl: string; readonly bearerTokenEnv?: string; readonly preset?: string; readonly enabled?: boolean; readonly timeoutMs?: number }
+  | { readonly action: 'outbound.remove' | 'outbound.enable' | 'outbound.disable' | 'outbound.refresh'; readonly id: string }
   | { readonly action: 'task.cancel'; readonly id: string }
-  | { readonly action: 'identity.update'; readonly name?: string; readonly description?: string; readonly version?: string }
   | { readonly action: 'inbound.close'; readonly id: string }
 
 /** One snapshot of the whole plugin for the dashboard. */
 export interface ApiSnapshot {
-  readonly server: {
-    readonly enabled: boolean
-    readonly cardUrl?: string
-    readonly skills: readonly string[]
-    readonly name?: string
-    readonly description?: string
-    readonly version?: string
-    readonly configured: boolean
-  }
-  readonly tasks: readonly unknown[]
-  readonly agents: readonly unknown[]
   readonly inbounds: readonly unknown[]
+  readonly outbounds: readonly unknown[]
+  readonly tasks: readonly unknown[]
+  readonly peers: readonly unknown[]
 }
 
 function readBody(req: IncomingMessage): Promise<string> {
@@ -69,6 +62,11 @@ export async function handleApiRequest(
     res.end('forbidden')
     return
   }
+  const path = (req.url ?? '').split('?')[0] ?? ''
+  if (req.method === 'GET' && path === '/a2a/api/presets') {
+    json(res, 200, await impl.presets())
+    return
+  }
   if (req.method === 'GET') {
     json(res, 200, snapshotOf(impl))
     return
@@ -90,51 +88,67 @@ export async function handleApiRequest(
 }
 
 function snapshotOf(impl: A2AServiceImpl): ApiSnapshot {
-  const status = impl.status() as {
-    server: {
-      enabled: boolean
-      cardUrl?: string
-      skills: readonly string[]
-      name?: string
-      description?: string
-      version?: string
-      configured: boolean
-    }
-    tasks: number
-    agents: readonly unknown[]
-    inbounds: readonly unknown[]
-  }
+  const status = impl.status() as { inbounds: readonly unknown[]; outbounds: readonly unknown[]; tasks: number; peers?: readonly unknown[] }
   return {
-    server: status.server,
-    tasks: impl.listTasks() as readonly unknown[],
-    agents: impl.agents() as readonly unknown[],
     inbounds: status.inbounds ?? [],
+    outbounds: status.outbounds ?? [],
+    tasks: impl.listTasks() as readonly unknown[],
+    // `status()` may already carry aggregated peers; fall back to the facade.
+    peers: (status.peers ?? impl.inbounds()) as readonly unknown[],
   }
 }
 
 async function dispatch(payload: ApiAction, impl: A2AServiceImpl): Promise<{ readonly ok: boolean; readonly message: string }> {
   switch (payload.action) {
-    case 'server.enable':
-      return impl.enableServer(true)
-    case 'server.disable':
-      return impl.enableServer(false)
-    case 'agent.add':
-      return impl.addAgent({ name: payload.name, agentCardUrl: payload.agentCardUrl, ...(payload.bearerTokenEnv ? { bearerTokenEnv: payload.bearerTokenEnv } : {}) })
-    case 'agent.remove':
-      return impl.removeAgent(payload.id)
-    case 'agent.enable':
-      return impl.setAgentEnabled(payload.id, true)
-    case 'agent.disable':
-      return impl.setAgentEnabled(payload.id, false)
-    case 'agent.refresh':
-      return impl.refreshAgentCard(payload.id)
+    case 'inbound.create':
+      return impl.createInboundServer({
+        name: payload.name,
+        description: payload.description,
+        version: payload.version,
+        ...(payload.endpointPath !== undefined ? { endpointPath: payload.endpointPath } : {}),
+        ...(payload.preset !== undefined ? { preset: payload.preset } : {}),
+        ...(payload.authTokenEnv !== undefined ? { authTokenEnv: payload.authTokenEnv } : {}),
+        ...(payload.skills !== undefined ? { skills: payload.skills } : {}),
+        ...(payload.enabled !== undefined ? { enabled: payload.enabled } : {}),
+      })
+    case 'inbound.remove':
+      return impl.removeInboundServer(payload.id)
+    case 'inbound.enable':
+      return impl.setInboundServerEnabled(payload.id, true)
+    case 'inbound.disable':
+      return impl.setInboundServerEnabled(payload.id, false)
+    case 'inbound.update':
+      return impl.updateInboundServer(payload.id, {
+        ...(payload.name !== undefined ? { name: payload.name } : {}),
+        ...(payload.description !== undefined ? { description: payload.description } : {}),
+        ...(payload.version !== undefined ? { version: payload.version } : {}),
+        ...(payload.endpointPath !== undefined ? { endpointPath: payload.endpointPath } : {}),
+        ...(payload.preset !== undefined ? { preset: payload.preset } : {}),
+        ...(payload.authTokenEnv !== undefined ? { authTokenEnv: payload.authTokenEnv } : {}),
+        ...(payload.skills !== undefined ? { skills: payload.skills } : {}),
+      })
+    case 'outbound.create':
+      return impl.createOutboundServer({
+        name: payload.name,
+        agentCardUrl: payload.agentCardUrl,
+        ...(payload.bearerTokenEnv !== undefined ? { bearerTokenEnv: payload.bearerTokenEnv } : {}),
+        ...(payload.preset !== undefined ? { preset: payload.preset } : {}),
+        ...(payload.enabled !== undefined ? { enabled: payload.enabled } : {}),
+        ...(payload.timeoutMs !== undefined ? { timeoutMs: payload.timeoutMs } : {}),
+      })
+    case 'outbound.remove':
+      return impl.removeOutboundServer(payload.id)
+    case 'outbound.enable':
+      return impl.setOutboundServerEnabled(payload.id, true)
+    case 'outbound.disable':
+      return impl.setOutboundServerEnabled(payload.id, false)
+    case 'outbound.refresh':
+      return impl.refreshOutboundServer(payload.id)
     case 'task.cancel':
       return impl.cancelTask(payload.id)
-    case 'identity.update':
-      return impl.updateIdentity({ ...(payload.name !== undefined ? { name: payload.name } : {}), ...(payload.description !== undefined ? { description: payload.description } : {}), ...(payload.version !== undefined ? { version: payload.version } : {}) })
     case 'inbound.close':
       return impl.closeInbound(payload.id)
     default:
       return { ok: false, message: `unknown action ${String((payload as { action?: unknown }).action)}` }
   }
-}
+}