@hanphone/dsh-a2a 0.2.0 → 0.3.0

package/src/commands.ts

@@ -1,6 +1,8 @@
 /**
- * The `/a2a` command surface: status, server enable/disable, card, agents,
- * and task control — the P0 operations surface (the settings panel is P1).
+ * The `/a2a` command surface: status, inbound/outbound server CRUD +
+ * enable/disable, and task control — a text backup to the GUI (the settings
+ * panel is the primary surface). All operations delegate to the same
+ * `A2AServiceImpl` facade as the dashboard API.
  * @module dsh-a2a/commands
  */
 
@@ -11,55 +13,67 @@ import type { A2AServiceImpl } from './service.ts'
 export function buildA2aCommand(impl: A2AServiceImpl): CommandDefinition {
   return {
     name: 'a2a',
-    description: 'Manage the A2A plugin: status, server, agents, tasks, card.',
+    description: 'Manage the A2A plugin: status, inbound/outbound servers, tasks.',
     handler: async (invocation: CommandInvocation): Promise<CommandResult> => {
       const [verb, ...rest] = invocation.rawInput.trim().split(/\s+/)
       switch (verb ?? '') {
-        case '': {
-          const status = impl.status() as { server?: unknown; client?: unknown }
-          return success(`A2A status\n${JSON.stringify(status, null, 2)}`)
-        }
+        case '':
         case 'status':
           return success(JSON.stringify(impl.status(), null, 2))
-        case 'enable':
-          return outcome(await impl.enableServer(true))
-        case 'disable':
-          return outcome(await impl.enableServer(false))
-        case 'card':
-          return success(JSON.stringify(impl.listTasks(), null, 2).slice(0, 4000))
-        case 'agents':
-          return success(JSON.stringify(impl.agents(), null, 2))
-        case 'agent': {
-          const [action, ...args] = rest
+        case 'presets':
+          return success(JSON.stringify(await impl.presets(), null, 2))
+        case 'inbound': {
+          const [action, id, ...args] = rest
+          switch (action ?? '') {
+            case 'list':
+              return success(JSON.stringify(impl.listInboundServers(), null, 2))
+            case 'create': {
+              const name = args[0]
+              if (!name) return error('usage: /a2a inbound create <name> [preset] [description]')
+              const preset = args[1]
+              return outcome(await impl.createInboundServer({
+                name,
+                description: args[2] ?? 'An A2A inbound server',
+                version: '1.0.0',
+                ...(preset && preset !== 'default' ? { preset } : {}),
+              }))
+            }
+            case 'remove':
+              return id ? outcome(await impl.removeInboundServer(id)) : error('usage: /a2a inbound remove <id>')
+            case 'enable':
+              return id ? outcome(await impl.setInboundServerEnabled(id, true)) : error('usage: /a2a inbound enable <id>')
+            case 'disable':
+              return id ? outcome(await impl.setInboundServerEnabled(id, false)) : error('usage: /a2a inbound disable <id>')
+            default:
+              return error('usage: /a2a inbound list|create|remove|enable|disable ...')
+          }
+        }
+        case 'outbound': {
+          const [action, id, ...args] = rest
           switch (action ?? '') {
-            case 'add': {
+            case 'list':
+              return success(JSON.stringify(impl.listOutboundServers(), null, 2))
+            case 'create': {
               const url = args[0]
-              if (!url) return error('usage: /a2a agent add <agentCardUrl> [name]')
+              if (!url) return error('usage: /a2a outbound create <agentCardUrl> [name] [preset]')
               const name = args[1] ?? url
-              return outcome(await impl.addAgent({ name, agentCardUrl: url }))
-            }
-            case 'remove': {
-              const id = args[0]
-              if (!id) return error('usage: /a2a agent remove <id>')
-              return outcome(await impl.removeAgent(id))
-            }
-            case 'enable': {
-              const id = args[0]
-              if (!id) return error('usage: /a2a agent enable <id>')
-              return outcome(await impl.setAgentEnabled(id, true))
-            }
-            case 'disable': {
-              const id = args[0]
-              if (!id) return error('usage: /a2a agent disable <id>')
-              return outcome(await impl.setAgentEnabled(id, false))
-            }
-            case 'refresh': {
-              const id = args[0]
-              if (!id) return error('usage: /a2a agent refresh <id>')
-              return outcome(await impl.refreshAgentCard(id))
+              const preset = args[2]
+              return outcome(await impl.createOutboundServer({
+                name,
+                agentCardUrl: url,
+                ...(preset && preset !== 'default' ? { preset } : {}),
+              }))
             }
+            case 'remove':
+              return id ? outcome(await impl.removeOutboundServer(id)) : error('usage: /a2a outbound remove <id>')
+            case 'enable':
+              return id ? outcome(await impl.setOutboundServerEnabled(id, true)) : error('usage: /a2a outbound enable <id>')
+            case 'disable':
+              return id ? outcome(await impl.setOutboundServerEnabled(id, false)) : error('usage: /a2a outbound disable <id>')
+            case 'refresh':
+              return id ? outcome(await impl.refreshOutboundServer(id)) : error('usage: /a2a outbound refresh <id>')
             default:
-              return error('usage: /a2a agent add|remove|enable|disable|refresh ...')
+              return error('usage: /a2a outbound list|create|remove|enable|disable|refresh ...')
           }
         }
         case 'tasks':
@@ -70,8 +84,10 @@ export function buildA2aCommand(impl: A2AServiceImpl): CommandDefinition {
           if (action === 'cancel' && id) return outcome(await impl.cancelTask(id))
           return error('usage: /a2a task get|cancel <taskId>')
         }
+        case 'peers':
+          return success(JSON.stringify(impl.inbounds(), null, 2))
         case 'help':
-          return success('a2a commands: status | enable | disable | card | agents | agent add/remove/enable/disable/refresh | tasks | task get/cancel <id> | help')
+          return success('a2a: status | presets | inbound list/create/remove/enable/disable | outbound list/create/remove/enable/disable/refresh | tasks | task get/cancel <id> | peers | help')
         default:
           return error(`unknown a2a verb "${verb}" (try /a2a help)`)
       }
@@ -89,4 +105,4 @@ function error(text: string): CommandResult {
 
 function outcome(result: { readonly ok: boolean; readonly message: string }): CommandResult {
   return result.ok ? success(result.message) : error(result.message)
-}
+}

package/src/events.ts

@@ -25,15 +25,22 @@ export interface InboundTaskDecision {
 /** The facade other plugins read as `ctx.a2a`. */
 export interface A2AServiceLike {
   status(): unknown
-  enableServer(enable: boolean): Promise<{ readonly ok: boolean; readonly message: string }>
-  listTasks(): unknown
+  presets(): Promise<Array<{ id: string; name?: string; description?: string }>>
+  listInboundServers(): unknown
+  createInboundServer(input: unknown): Promise<{ readonly ok: boolean; readonly message: string }>
+  removeInboundServer(id: string): Promise<{ readonly ok: boolean; readonly message: string }>
+  setInboundServerEnabled(id: string, enabled: boolean): Promise<{ readonly ok: boolean; readonly message: string }>
+  updateInboundServer(id: string, patch: unknown): Promise<{ readonly ok: boolean; readonly message: string }>
+  listOutboundServers(): unknown
+  createOutboundServer(input: unknown): Promise<{ readonly ok: boolean; readonly message: string }>
+  removeOutboundServer(id: string): Promise<{ readonly ok: boolean; readonly message: string }>
+  setOutboundServerEnabled(id: string, enabled: boolean): Promise<{ readonly ok: boolean; readonly message: string }>
+  refreshOutboundServer(id: string): Promise<{ readonly ok: boolean; readonly message: string }>
   getTask(taskId: string): unknown
+  listTasks(): unknown
   cancelTask(taskId: string): Promise<{ readonly ok: boolean; readonly message: string }>
-  agents(): unknown
-  addAgent(spec: unknown): Promise<{ readonly ok: boolean; readonly message: string }>
-  removeAgent(id: string): Promise<{ readonly ok: boolean; readonly message: string }>
-  setAgentEnabled(id: string, enabled: boolean): Promise<{ readonly ok: boolean; readonly message: string }>
-  refreshAgentCard(id: string): Promise<{ readonly ok: boolean; readonly message: string }>
+  inbounds(): unknown
+  closeInbound(peerId: string): Promise<{ readonly ok: boolean; readonly message: string }>
 }
 
 declare module '@deepseek-ai/cordis' {