@swarmclawai/swarmclaw 1.3.0 → 1.3.2

package/README.md

@@ -204,6 +204,19 @@ Read the full setup guide in [`SWARMDOCK.md`](./SWARMDOCK.md), browse the public
 
 ## Release Notes
 
+### v1.3.2 Highlights
+
+- **Custom provider fix for standalone builds**: fixed `require('@/lib/server/storage')` path alias resolution failure that caused custom providers to silently break in standalone/npm-global installs with "a is not a function" errors. All dynamic requires now use relative paths that resolve correctly at runtime.
+- **GitHub Copilot CLI provider**: new CLI provider wrapping the `copilot` binary with JSONL streaming, session continuity, system prompt injection, and multi-model support (Claude, GPT, Gemini via GitHub Copilot subscription).
+
+### v1.3.1 Highlights
+
+- **SwarmDock SDK v0.2.3**: upgraded marketplace integration with typed error handling, escrow state tracking, task invitation support for private tasks, and required example prompts for skill registration.
+- **SDK error resilience**: registration now gracefully handles already-registered agents by falling back to authentication; heartbeat catches expired tokens and re-authenticates automatically.
+- **Escrow event tracking**: new `escrow.releasing`, `escrow.refunding`, `escrow.release_failed`, and `escrow.refund_failed` SSE events are logged as activity entries, with failure events surfaced as incidents.
+- **Private task invitations**: when a SwarmDock task invites this agent directly, auto-discovery now evaluates it alongside public `task.created` events.
+- **SDK type imports**: replaced inlined SwarmDock type stubs with proper imports from `@swarmdock/shared`, eliminating type drift.
+
 ### v1.3.0 Highlights
 
 - **SwarmDock SDK v0.2.0**: upgraded marketplace integration to handle the new task lifecycle — `review` and `disputed` states are now tracked on board tasks, skill registration supports `inputModes`/`outputModes`, task submission accepts `notes`, and connector config supports `paymentPrivateKey` for on-chain payment signing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Self-hosted AI runtime for OpenClaw, delegation, autonomy, runtime skills, crypto wallets, and chat platform connectors.",
   "license": "MIT",
   "publishConfig": {
@@ -87,7 +87,7 @@
     "@multiavatar/multiavatar": "^1.0.7",
     "@playwright/mcp": "^0.0.68",
     "@slack/bolt": "^4.6.0",
-    "@swarmdock/sdk": "^0.2.0",
+    "@swarmdock/sdk": "^0.2.3",
     "@tailwindcss/postcss": "^4",
     "@tanstack/react-query": "^5.91.0",
     "@types/better-sqlite3": "^7.6.13",

package/src/lib/provider-sets.ts

@@ -1,8 +1,8 @@
 /** CLI providers that use their own tool execution outside the shared tool-runtime path. */
-export const NON_LANGGRAPH_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli'])
+export const NON_LANGGRAPH_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli'])
 
 /** Providers with native tool/capability support (CLI providers + OpenClaw). */
-export const NATIVE_CAPABILITY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'openclaw'])
+export const NATIVE_CAPABILITY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'openclaw'])
 
 /** Providers that can only act as workers — no coordinator role, no heartbeat, no advanced settings. */
-export const WORKER_ONLY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'openclaw'])
+export const WORKER_ONLY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'openclaw'])

package/src/lib/providers/cli-utils.ts

@@ -39,6 +39,12 @@ const KNOWN_BINARY_PATHS: Record<string, string[]> = {
     '/usr/local/bin/gemini',
     '/opt/homebrew/bin/gemini',
   ],
+  copilot: [
+    path.join(os.homedir(), '.local/bin/copilot'),
+    '/usr/local/bin/copilot',
+    '/opt/homebrew/bin/copilot',
+    path.join(os.homedir(), '.npm-global/bin/copilot'),
+  ],
 }
 
 function getNvmBinaryPaths(name: string): string[] {
@@ -144,7 +150,7 @@ export interface AuthProbeResult {
  */
 export function probeCliAuth(
   binary: string,
-  backend: 'claude' | 'codex' | 'opencode' | 'gemini',
+  backend: 'claude' | 'codex' | 'opencode' | 'gemini' | 'copilot',
   env: NodeJS.ProcessEnv,
   cwd?: string,
 ): AuthProbeResult {
@@ -224,6 +230,37 @@ export function probeCliAuth(
     return { authenticated: true }
   }
 
+  if (backend === 'copilot') {
+    // Check for GitHub token in env first
+    if (process.env.GH_TOKEN || process.env.GITHUB_TOKEN || process.env.COPILOT_GITHUB_TOKEN) {
+      return { authenticated: true }
+    }
+    // Try `gh auth status` as fallback (copilot inherits gh auth)
+    try {
+      const probe = spawnSync('gh', ['auth', 'status'], {
+        cwd, env, encoding: 'utf-8', timeout: 8000,
+      })
+      const probeText = `${probe.stdout || ''}\n${probe.stderr || ''}`.toLowerCase()
+      if ((probe.status ?? 1) === 0 || probeText.includes('logged in')) {
+        return { authenticated: true }
+      }
+    } catch { /* gh may not be installed */ }
+
+    // Fall back to config file check
+    const configPaths = [
+      path.join(os.homedir(), '.copilot/config.json'),
+      path.join(os.homedir(), '.config/copilot/config.json'),
+    ]
+    const hasConfig = configPaths.some((p) => fs.existsSync(p))
+    if (!hasConfig) {
+      return {
+        authenticated: false,
+        errorMessage: 'Copilot CLI is not authenticated. Run `copilot /login`, `gh auth login`, or set GH_TOKEN and try again.',
+      }
+    }
+    return { authenticated: true }
+  }
+
   return { authenticated: true }
 }
 
@@ -308,6 +345,7 @@ export const CLI_PROVIDER_CAPABILITIES: Record<string, string> = {
   'codex-cli': 'code generation, file creation, automated coding tasks',
   'opencode-cli': 'code analysis, generation across multiple LLM backends',
   'gemini-cli': 'code generation, analysis with Gemini models',
+  'copilot-cli': 'code generation, analysis, multi-model support via GitHub Copilot',
 }
 
 /** Check if a provider ID is a CLI-based provider. */

package/src/lib/providers/copilot-cli.ts

@@ -0,0 +1,222 @@
+import fs from 'fs'
+import os from 'os'
+import path from 'path'
+import { spawn } from 'child_process'
+import type { StreamChatOptions } from './index'
+import { log } from '../server/logger'
+import { loadRuntimeSettings } from '@/lib/server/runtime/runtime-settings'
+import { resolveCliBinary, buildCliEnv, probeCliAuth, attachAbortHandler, symlinkConfigFiles, isStderrNoise } from './cli-utils'
+
+/**
+ * GitHub Copilot CLI provider — spawns `copilot -p <message> --output-format=json -s --yolo`.
+ * Tracks `session.copilotSessionId` from streamed JSON events to support multi-turn continuity.
+ */
+export function streamCopilotCliChat({ session, message, imagePath, systemPrompt, write, active, signal }: StreamChatOptions): Promise<string> {
+  const processTimeoutMs = loadRuntimeSettings().cliProcessTimeoutMs
+  const binary = resolveCliBinary('copilot')
+  if (!binary) {
+    const msg = 'Copilot CLI not found. Install it (brew install copilot-cli, npm i -g @github/copilot, or https://gh.io/copilot-install) and ensure it is on your PATH.'
+    write(`data: ${JSON.stringify({ t: 'err', text: msg })}\n\n`)
+    return Promise.resolve('')
+  }
+
+  const env = buildCliEnv()
+
+  // Pass GitHub token if available via session API key
+  if (session.apiKey) {
+    env.GH_TOKEN = session.apiKey
+  }
+
+  // Auth probe
+  if (!session.apiKey) {
+    const auth = probeCliAuth(binary, 'copilot', env, session.cwd)
+    if (!auth.authenticated) {
+      log.error('copilot-cli', auth.errorMessage || 'Auth failed')
+      write(`data: ${JSON.stringify({ t: 'err', text: auth.errorMessage || 'Copilot CLI is not authenticated.' })}\n\n`)
+      return Promise.resolve('')
+    }
+  }
+
+  // Build prompt with optional system instructions
+  const promptParts: string[] = []
+  if (imagePath) {
+    promptParts.push(`[The user has shared an image at: ${imagePath}]`)
+  }
+  promptParts.push(message)
+  const prompt = promptParts.join('\n\n')
+
+  const args = ['-p', prompt, '--output-format=json', '-s', '--yolo']
+  if (session.copilotSessionId) args.push('--resume', session.copilotSessionId)
+  if (session.model) args.push('--model', session.model)
+
+  // System prompt: write temp AGENTS.override.md in a temp config dir
+  // Symlink auth files from the real config dir so auth still works
+  let tempCopilotHome: string | null = null
+  if (systemPrompt && !session.copilotSessionId) {
+    const realCopilotHome = process.env.COPILOT_HOME || path.join(os.homedir(), '.copilot')
+    tempCopilotHome = path.join(os.tmpdir(), `swarmclaw-copilot-${session.id}`)
+    fs.mkdirSync(tempCopilotHome, { recursive: true })
+
+    // Symlink auth/config files from real home into temp dir
+    symlinkConfigFiles(realCopilotHome, tempCopilotHome)
+
+    // Write system prompt as AGENTS.override.md
+    fs.writeFileSync(path.join(tempCopilotHome, 'AGENTS.override.md'), systemPrompt)
+    env.COPILOT_HOME = tempCopilotHome
+  }
+
+  log.info('copilot-cli', `Spawning: ${binary}`, {
+    args: args.map((a) => a.length > 100 ? a.slice(0, 100) + '...' : a),
+    cwd: session.cwd,
+    promptLen: prompt.length,
+    hasSystemPrompt: !!systemPrompt,
+    resumeSessionId: session.copilotSessionId || null,
+  })
+
+  const proc = spawn(binary, args, {
+    cwd: session.cwd,
+    env,
+    stdio: ['ignore', 'pipe', 'pipe'],
+    timeout: processTimeoutMs,
+  })
+
+  log.info('copilot-cli', `Process spawned: pid=${proc.pid}`)
+  active.set(session.id, proc)
+  attachAbortHandler(proc, signal)
+
+  let fullResponse = ''
+  let buf = ''
+  let eventCount = 0
+  let stderrText = ''
+
+  proc.stdout!.on('data', (chunk: Buffer) => {
+    const raw = chunk.toString()
+    buf += raw
+
+    if (eventCount === 0) {
+      log.debug('copilot-cli', `First stdout chunk (${raw.length} bytes)`, raw.slice(0, 500))
+    }
+
+    const lines = buf.split('\n')
+    buf = lines.pop()!
+
+    for (const line of lines) {
+      if (!line.trim()) continue
+      try {
+        const ev = JSON.parse(line) as Record<string, unknown>
+        eventCount++
+
+        // Capture session ID from init event
+        if (ev.type === 'init' && typeof ev.session_id === 'string') {
+          session.copilotSessionId = ev.session_id
+          log.info('copilot-cli', `Got session_id: ${ev.session_id}`)
+        }
+
+        // Streaming text deltas
+        if (ev.type === 'content_block_delta') {
+          const delta = ev.delta as Record<string, unknown> | undefined
+          if (typeof delta?.text === 'string') {
+            fullResponse += delta.text
+            write(`data: ${JSON.stringify({ t: 'd', text: delta.text })}\n\n`)
+          }
+        }
+
+        // Agent message chunks (ACP format)
+        else if (ev.type === 'agent_message_chunk' && typeof ev.text === 'string') {
+          fullResponse += ev.text
+          write(`data: ${JSON.stringify({ t: 'd', text: ev.text })}\n\n`)
+        }
+
+        // Assistant message content
+        else if (ev.type === 'message' && ev.role === 'assistant' && typeof ev.content === 'string') {
+          fullResponse += ev.content
+          write(`data: ${JSON.stringify({ t: 'd', text: ev.content })}\n\n`)
+        }
+
+        // Completed item with agent_message
+        else if (ev.type === 'item.completed' && (ev.item as Record<string, unknown>)?.type === 'agent_message') {
+          const item = ev.item as Record<string, unknown>
+          if (typeof item.text === 'string') {
+            fullResponse = item.text
+            write(`data: ${JSON.stringify({ t: 'r', text: item.text })}\n\n`)
+            log.debug('copilot-cli', `Agent message (${item.text.length} chars)`)
+          }
+        }
+
+        // Final result
+        else if (ev.type === 'result' && typeof ev.result === 'string') {
+          fullResponse = ev.result
+          write(`data: ${JSON.stringify({ t: 'r', text: ev.result })}\n\n`)
+          log.debug('copilot-cli', `Result event (${ev.result.length} chars)`)
+        }
+
+        // Error result
+        else if (ev.type === 'result' && ev.status === 'error') {
+          const errMsg = typeof ev.error === 'string' ? ev.error : 'Copilot error'
+          write(`data: ${JSON.stringify({ t: 'err', text: errMsg })}\n\n`)
+          log.warn('copilot-cli', `Error result: ${errMsg}`)
+        }
+
+        // Event error
+        else if (ev.type === 'error') {
+          const errMsg = typeof ev.message === 'string'
+            ? ev.message
+            : typeof ev.error === 'string'
+              ? ev.error
+              : 'Unknown Copilot error'
+          write(`data: ${JSON.stringify({ t: 'err', text: errMsg })}\n\n`)
+          log.warn('copilot-cli', `Event error: ${errMsg}`)
+        }
+
+        else if (eventCount <= 10) {
+          log.debug('copilot-cli', `Event: ${String(ev.type)}`)
+        }
+      } catch {
+        if (line.trim()) {
+          log.debug('copilot-cli', `Non-JSON stdout line`, line.slice(0, 300))
+          fullResponse += line + '\n'
+          write(`data: ${JSON.stringify({ t: 'd', text: line + '\n' })}\n\n`)
+        }
+      }
+    }
+  })
+
+  proc.stderr!.on('data', (chunk: Buffer) => {
+    const text = chunk.toString()
+    stderrText += text
+    if (stderrText.length > 16_000) stderrText = stderrText.slice(-16_000)
+    if (isStderrNoise(text)) {
+      log.debug('copilot-cli', `stderr noise [${session.id}]`, text.slice(0, 500))
+    } else {
+      log.warn('copilot-cli', `stderr [${session.id}]`, text.slice(0, 500))
+    }
+  })
+
+  return new Promise((resolve) => {
+    proc.on('close', (code, sig) => {
+      log.info('copilot-cli', `Process closed: code=${code} signal=${sig} events=${eventCount} response=${fullResponse.length}chars`)
+      active.delete(session.id)
+      // Clean up temp config dir
+      if (tempCopilotHome) {
+        try { fs.rmSync(tempCopilotHome, { recursive: true }) } catch { /* ignore */ }
+      }
+      if ((code ?? 0) !== 0 && !fullResponse.trim()) {
+        const msg = stderrText.trim()
+          ? `Copilot CLI exited with code ${code ?? 'unknown'}${sig ? ` (${sig})` : ''}: ${stderrText.trim().slice(0, 1200)}`
+          : `Copilot CLI exited with code ${code ?? 'unknown'}${sig ? ` (${sig})` : ''} and returned no output.`
+        write(`data: ${JSON.stringify({ t: 'err', text: msg })}\n\n`)
+      }
+      resolve(fullResponse)
+    })
+
+    proc.on('error', (e) => {
+      log.error('copilot-cli', `Process error: ${e.message}`)
+      active.delete(session.id)
+      if (tempCopilotHome) {
+        try { fs.rmSync(tempCopilotHome, { recursive: true }) } catch { /* ignore */ }
+      }
+      write(`data: ${JSON.stringify({ t: 'err', text: e.message })}\n\n`)
+      resolve(fullResponse)
+    })
+  })
+}

package/src/lib/providers/index.ts

@@ -2,6 +2,7 @@ import { streamClaudeCliChat } from './claude-cli'
 import { streamCodexCliChat } from './codex-cli'
 import { streamOpenCodeCliChat } from './opencode-cli'
 import { streamGeminiCliChat } from './gemini-cli'
+import { streamCopilotCliChat } from './copilot-cli'
 import { streamOpenAiChat } from './openai'
 import { streamOllamaChat } from './ollama'
 import { streamAnthropicChat } from './anthropic'
@@ -102,6 +103,14 @@ export const PROVIDERS: Record<string, BuiltinProviderConfig> = {
     requiresEndpoint: false,
     handler: { streamChat: streamGeminiCliChat },
   },
+  'copilot-cli': {
+    id: 'copilot-cli',
+    name: 'GitHub Copilot CLI',
+    models: ['claude-sonnet-4-5', 'gpt-4.1', 'gemini-3-pro'],
+    requiresApiKey: false,
+    requiresEndpoint: false,
+    handler: { streamChat: streamCopilotCliChat },
+  },
   google: {
     id: 'google',
     name: 'Google Gemini',
@@ -281,7 +290,7 @@ export const PROVIDERS: Record<string, BuiltinProviderConfig> = {
 function getCustomProviders(): Record<string, CustomProviderConfig> {
   try {
     // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { loadProviderConfigs } = require('@/lib/server/storage') as typeof import('@/lib/server/storage')
+    const { loadProviderConfigs } = require('../server/storage') as typeof import('@/lib/server/storage')
     const configs = loadProviderConfigs() as Record<string, CustomProviderConfig>
     return Object.fromEntries(
       Object.entries(configs).filter(([, config]) => config?.type === 'custom'),
@@ -295,7 +304,7 @@ function getCustomProviders(): Record<string, CustomProviderConfig> {
 function getModelOverrides(): Record<string, string[]> {
   try {
     // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { loadModelOverrides } = require('@/lib/server/storage') as typeof import('@/lib/server/storage')
+    const { loadModelOverrides } = require('../server/storage') as typeof import('@/lib/server/storage')
     return loadModelOverrides()
   } catch {
     return {}
@@ -313,7 +322,7 @@ export function getProviderList(): ProviderInfo[] {
         ...info,
         models: overrides[info.id] || info.models,
         defaultModels: info.models,
-        supportsModelDiscovery: !['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'fireworks'].includes(info.id),
+        supportsModelDiscovery: !['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'fireworks'].includes(info.id),
       }
     })
   
@@ -383,7 +392,7 @@ export function getProvider(id: string): BuiltinProviderConfig | null {
   if (id.startsWith('custom-') && !custom) {
     try {
       // eslint-disable-next-line @typescript-eslint/no-require-imports
-      const { loadStoredItem } = require('@/lib/server/storage') as typeof import('@/lib/server/storage')
+      const { loadStoredItem } = require('../server/storage') as typeof import('@/lib/server/storage')
       const directConfig = loadStoredItem('provider_configs', id) as CustomProviderConfig | null
       if (directConfig?.type === 'custom' && directConfig.isEnabled) {
         log.info(TAG, `Resolved custom provider '${id}' via direct DB lookup (batch load missed it)`)
@@ -447,7 +456,7 @@ export async function streamChatWithFailover(
       if (credId && i > 0) {
         // Need to decrypt fallback credential
         // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const { loadCredentials, decryptKey } = require('@/lib/server/storage') as typeof import('@/lib/server/storage')
+        const { loadCredentials, decryptKey } = require('../server/storage') as typeof import('@/lib/server/storage')
         const creds = loadCredentials()
         const cred = creds[credId]
         if (cred?.encryptedKey) {

package/src/lib/server/agents/agent-availability.test.ts

@@ -4,7 +4,7 @@ import type { Agent, ProviderType } from '@/types'
 import { isWorkerOnlyAgent, buildWorkerOnlyAgentMessage } from './agent-availability'
 
 describe('isWorkerOnlyAgent', () => {
-  const CLI_PROVIDERS = ['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'openclaw'] satisfies ProviderType[]
+  const CLI_PROVIDERS = ['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'openclaw'] satisfies ProviderType[]
   const NON_CLI_PROVIDERS = ['openai', 'anthropic', 'google', 'deepseek', 'groq', 'together'] satisfies ProviderType[]
 
   function withProvider(provider: unknown): Pick<Agent, 'provider'> {

package/src/lib/server/agents/subagent-swarm.ts

@@ -160,7 +160,7 @@ function notifySwarmChanged() {
 function persistSwarmSnapshot(swarm: SwarmHandle): void {
   try {
     // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { upsertStoredItem } = require('@/lib/server/storage')
+    const { upsertStoredItem } = require('../storage')
     upsertStoredItem('swarm_snapshots', swarm.swarmId, {
       swarmId: swarm.swarmId,
       parentSessionId: swarm.parentSessionId,
@@ -550,7 +550,7 @@ export function getSwarmSnapshot(swarmId: string): SwarmSnapshot | null {
   // Fallback to persisted store for swarms from previous process lifetimes
   try {
     // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { loadStoredItem } = require('@/lib/server/storage')
+    const { loadStoredItem } = require('../storage')
     const persisted = loadStoredItem('swarm_snapshots', swarmId)
     return persisted ? (persisted as SwarmSnapshot) : null
   } catch { return null }
@@ -641,7 +641,7 @@ function buildSwarmSnapshot(swarm: SwarmHandle): SwarmSnapshot {
 export function restoreSwarmRegistry(): number {
   try {
     // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { loadCollection, upsertStoredItem } = require('@/lib/server/storage')
+    const { loadCollection, upsertStoredItem } = require('../storage')
     const persisted = loadCollection('swarm_snapshots') as Record<string, SwarmSnapshot>
     let lost = 0
     for (const [id, record] of Object.entries(persisted)) {

package/src/lib/server/chat-execution/prompt-builder.ts

@@ -45,9 +45,9 @@ function buildExtensionCapabilityLines(enabledExtensions: string[], opts?: { del
       if (opts.agentId) {
         try {
           // eslint-disable-next-line @typescript-eslint/no-require-imports
-          const { loadAgents } = require('@/lib/server/storage')
+          const { loadAgents } = require('../storage')
           // eslint-disable-next-line @typescript-eslint/no-require-imports
-          const { resolveTeam } = require('@/lib/server/agents/team-resolution')
+          const { resolveTeam } = require('../agents/team-resolution')
           const agents = loadAgents() as Record<string, Record<string, unknown>>
           const team = resolveTeam(opts.agentId, agents)
           if (team.mode === 'team') {

package/src/lib/server/connectors/swarmdock-bidding.ts

@@ -1,15 +1,8 @@
 import { log } from '@/lib/server/logger'
-import type { BidCreateInput } from '@swarmdock/shared'
+import type { Task, BidCreateInput } from '@swarmdock/shared'
 
 const TAG = 'swarmdock-bid'
 
-interface SwarmDockTask {
-  id: string
-  title: string
-  skillRequirements: string[]
-  budgetMax: string
-}
-
 interface SwarmDockConfig {
   skills: string
   maxBudget: string
@@ -20,7 +13,7 @@ interface SwarmDockConfig {
  * Determine if the agent should auto-bid on a discovered task.
  * Checks skill overlap and budget limits.
  */
-export function shouldAutoBid(task: SwarmDockTask, config: SwarmDockConfig): boolean {
+export function shouldAutoBid(task: Task, config: SwarmDockConfig): boolean {
   if (!config.autoDiscover) return false
 
   // Check budget

package/src/lib/server/connectors/swarmdock-payloads.test.ts

@@ -2,7 +2,7 @@ import assert from 'node:assert/strict'
 import test from 'node:test'
 
 import { submitAutoBid } from '@/lib/server/connectors/swarmdock-bidding'
-import { submitSwarmdockTaskResult } from '@/lib/server/connectors/swarmdock'
+import { submitSwarmdockTaskResult, generateExamplePrompts } from '@/lib/server/connectors/swarmdock'
 
 test('submitAutoBid includes empty portfolio refs for SDK compatibility', async () => {
   const seen: {
@@ -37,6 +37,23 @@ test('submitAutoBid includes empty portfolio refs for SDK compatibility', async
   })
 })
 
+test('generateExamplePrompts returns exactly 5 non-empty strings', () => {
+  const prompts = generateExamplePrompts('data-analysis')
+  assert.equal(prompts.length, 5)
+  for (const prompt of prompts) {
+    assert.equal(typeof prompt, 'string')
+    assert.ok(prompt.length > 0, 'prompt must be non-empty')
+    assert.ok(prompt.includes('data analysis'), 'prompt should include the humanized skill name')
+  }
+
+  // Single-word skill
+  const simple = generateExamplePrompts('coding')
+  assert.equal(simple.length, 5)
+  for (const prompt of simple) {
+    assert.ok(prompt.includes('coding'))
+  }
+})
+
 test('submitSwarmdockTaskResult includes empty files and propagates submit errors', async () => {
   const seen: {
     taskId?: string

package/src/lib/server/connectors/swarmdock-tasks.ts

@@ -2,23 +2,14 @@ import { genId } from '@/lib/id'
 import { loadTasks, saveTasks } from '@/lib/server/tasks/task-repository'
 import { logActivity } from '@/lib/server/activity/activity-log'
 import type { BoardTask } from '@/types/task'
-
-interface SwarmDockTask {
-  id: string
-  requesterId: string
-  title: string
-  description: string
-  skillRequirements: string[]
-  budgetMax: string
-  deadline: string | null
-}
+import type { Task } from '@swarmdock/shared'
 
 /**
  * Create a SwarmClaw BoardTask from a SwarmDock task assignment.
  * Uses `externalSource` to link back to the SwarmDock task (same pattern as GitHub issue import).
  */
 export async function createBoardTaskFromAssignment(
-  task: SwarmDockTask,
+  task: Task,
   agentId: string,
   connectorId: string,
   apiUrl: string,

package/src/lib/server/connectors/swarmdock.ts

@@ -5,29 +5,10 @@ import type { Connector, InboundMessage } from '@/types/connector'
 import type { PlatformConnector, ConnectorInstance } from '@/lib/server/connectors/types'
 import { createBoardTaskFromAssignment, updateBoardTaskFromEvent, findBoardTaskBySwarmdockId } from './swarmdock-tasks'
 import { shouldAutoBid, submitAutoBid } from './swarmdock-bidding'
-import type { TaskSubmitInput } from '@swarmdock/shared'
+import type { Task, SSEEvent, TaskSubmitInput } from '@swarmdock/shared'
 
 const TAG = 'swarmdock'
 
-// SDK types inlined until @swarmdock/sdk is built and linked
-interface SwarmDockTask {
-  id: string
-  requesterId: string
-  assigneeId: string | null
-  title: string
-  description: string
-  skillRequirements: string[]
-  budgetMax: string
-  status: string
-  deadline: string | null
-}
-
-interface SwarmDockSSEEvent {
-  type: string
-  data: Record<string, unknown>
-  timestamp: string
-}
-
 interface SwarmDockConfig {
   apiUrl: string
   walletAddress: string
@@ -51,7 +32,7 @@ function parseConfig(connector: Connector): SwarmDockConfig {
   }
 }
 
-function buildTaskPrompt(task: SwarmDockTask): string {
+function buildTaskPrompt(task: Task): string {
   const lines: string[] = [
     `# SwarmDock Task: ${task.title}`,
     '',
@@ -65,6 +46,17 @@ function buildTaskPrompt(task: SwarmDockTask): string {
   return lines.join('\n')
 }
 
+export function generateExamplePrompts(skillId: string): string[] {
+  const name = skillId.replace(/-/g, ' ')
+  return [
+    `Perform a ${name} task`,
+    `Help me with ${name}`,
+    `I need ${name} work done`,
+    `Complete a ${name} assignment`,
+    `Handle a ${name} request`,
+  ]
+}
+
 function formatUsdc(microUnits: string): string {
   const cents = BigInt(microUnits)
   const dollars = Number(cents) / 1_000_000
@@ -98,11 +90,15 @@ const swarmdock: PlatformConnector = {
     if (!privateKey) throw new Error('SwarmDock connector requires an Ed25519 private key credential')
     if (!config.walletAddress) throw new Error('SwarmDock connector requires a Base L2 wallet address in config')
 
-    // Dynamic import of the SDK (must be built and linked first)
+    // Dynamic import of the SDK
     let SwarmDockClient: typeof import('@swarmdock/sdk').SwarmDockClient
+    let ConflictError: typeof import('@swarmdock/sdk').ConflictError
+    let AuthenticationError: typeof import('@swarmdock/sdk').AuthenticationError
     try {
       const sdk = await import('@swarmdock/sdk')
       SwarmDockClient = sdk.SwarmDockClient
+      ConflictError = sdk.ConflictError
+      AuthenticationError = sdk.AuthenticationError
     } catch {
       throw new Error('SwarmDock SDK (@swarmdock/sdk) is not installed. Run: npm install @swarmdock/sdk')
     }
@@ -128,36 +124,47 @@ const swarmdock: PlatformConnector = {
         basePrice: '1000000', // $1.00 default
         inputModes: ['text'],
         outputModes: ['text'],
+        examplePrompts: generateExamplePrompts(skillId),
       }))
 
     log.info(TAG, `Registering agent "${connector.name}" on SwarmDock at ${config.apiUrl}`)
-    const registration = await client.register({
-      displayName: connector.name,
-      description: config.agentDescription,
-      framework: 'swarmclaw',
-      walletAddress: config.walletAddress,
-      skills: skillList,
-    })
-    log.info(TAG, `Registered as ${registration.agent.did} (trust level ${registration.agent.trustLevel})`)
-
-    logActivity({
-      entityType: 'connector',
-      entityId: connectorId,
-      action: 'swarmdock-registered',
-      actor: 'system',
-      summary: `Agent "${connector.name}" registered on SwarmDock as ${registration.agent.did}`,
-    })
+    try {
+      const registration = await client.register({
+        displayName: connector.name,
+        description: config.agentDescription,
+        framework: 'swarmclaw',
+        walletAddress: config.walletAddress,
+        skills: skillList,
+      })
+      log.info(TAG, `Registered as ${registration.agent.did} (trust level ${registration.agent.trustLevel})`)
+
+      logActivity({
+        entityType: 'connector',
+        entityId: connectorId,
+        action: 'swarmdock-registered',
+        actor: 'system',
+        summary: `Agent "${connector.name}" registered on SwarmDock as ${registration.agent.did}`,
+      })
+    } catch (err) {
+      if (err instanceof ConflictError) {
+        log.info(TAG, `Agent already registered, authenticating`)
+        await client.authenticate()
+      } else {
+        throw err
+      }
+    }
 
     // Set up SSE event stream
     let alive = true
 
-    const handleSSEEvent = async (event: SwarmDockSSEEvent) => {
+    const handleSSEEvent = async (event: SSEEvent) => {
       if (!alive) return
       try {
         switch (event.type) {
-          case 'task.created': {
+          case 'task.created':
+          case 'task.invited': {
             if (!config.autoDiscover) break
-            const task = event.data as unknown as SwarmDockTask
+            const task = event.data as unknown as Task
             if (shouldAutoBid(task, config)) {
               await submitAutoBid(client, task.id, config)
               logActivity({
@@ -172,7 +179,7 @@ const swarmdock: PlatformConnector = {
           }
 
           case 'task.assigned': {
-            const task = event.data as unknown as SwarmDockTask
+            const task = event.data as unknown as Task
             if (!task.assigneeId) break
 
             // Signal work started on SwarmDock
@@ -236,6 +243,32 @@ const swarmdock: PlatformConnector = {
             })
             break
           }
+
+          case 'escrow.releasing':
+          case 'escrow.refunding': {
+            const data = event.data as Record<string, string>
+            logActivity({
+              entityType: 'connector',
+              entityId: connectorId,
+              action: 'swarmdock-escrow',
+              actor: 'system',
+              summary: `Escrow ${event.type.split('.')[1]} for task ${data.taskId}`,
+            })
+            break
+          }
+
+          case 'escrow.release_failed':
+          case 'escrow.refund_failed': {
+            const data = event.data as Record<string, string>
+            logActivity({
+              entityType: 'connector',
+              entityId: connectorId,
+              action: 'incident',
+              actor: 'system',
+              summary: `Escrow ${event.type.replace('escrow.', '')} for task ${data.taskId}`,
+            })
+            break
+          }
         }
       } catch (err) {
         log.error(TAG, `Error handling SSE event ${event.type}: ${err instanceof Error ? err.message : String(err)}`)
@@ -250,7 +283,12 @@ const swarmdock: PlatformConnector = {
         await client.heartbeat()
         log.debug(TAG, 'SwarmDock token refreshed')
       } catch (err) {
-        log.error(TAG, `SwarmDock heartbeat failed: ${err instanceof Error ? err.message : String(err)}`)
+        if (err instanceof AuthenticationError) {
+          log.warn(TAG, 'SwarmDock token expired, re-authenticating')
+          try { await client.authenticate() } catch {}
+        } else {
+          log.error(TAG, `SwarmDock heartbeat failed: ${err instanceof Error ? err.message : String(err)}`)
+        }
       }
     }, 23 * 60 * 60 * 1000)
 

package/src/lib/server/provider-health.ts

@@ -71,7 +71,7 @@ export function markProviderFailure(providerId: string, error: string, credentia
   })
   try {
     // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { upsertStoredItem } = require('@/lib/server/storage')
+    const { upsertStoredItem } = require('./storage')
     upsertStoredItem('provider_health', key, states.get(key)!)
   } catch {}
 }
@@ -89,7 +89,7 @@ export function markProviderSuccess(providerId: string, credentialId?: string |
   })
   try {
     // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { upsertStoredItem } = require('@/lib/server/storage')
+    const { upsertStoredItem } = require('./storage')
     upsertStoredItem('provider_health', key, states.get(key)!)
   } catch {}
 }
@@ -188,7 +188,7 @@ export function getProviderHealthSnapshot(): Record<string, ProviderHealthState
 export function restoreProviderHealthState(): number {
   try {
     // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { loadCollection } = require('@/lib/server/storage')
+    const { loadCollection } = require('./storage')
     const persisted = loadCollection('provider_health') as Record<string, ProviderHealthState>
     let restored = 0
     for (const [id, record] of Object.entries(persisted)) {
@@ -323,7 +323,7 @@ export async function pingProvider(
   apiKey: string | undefined,
   endpoint: string | undefined,
 ): Promise<{ ok: boolean; message: string }> {
-  const CLI_PROVIDERS = ['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli']
+  const CLI_PROVIDERS = ['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli']
   if (CLI_PROVIDERS.includes(provider)) return { ok: true, message: 'CLI provider — skipped.' }
 
   try {

package/src/lib/server/storage-normalization.ts

@@ -620,6 +620,8 @@ function normalizeStoredRecordInner(
   }
   // Default geminiSessionId for new field
   if (session.geminiSessionId === undefined) session.geminiSessionId = null
+  // Default copilotSessionId for new field
+  if (session.copilotSessionId === undefined) session.copilotSessionId = null
   // Default injectedMemoryIds for proactive recall dedup
   if (!session.injectedMemoryIds || typeof session.injectedMemoryIds !== 'object') {
     session.injectedMemoryIds = {}

package/src/types/provider.ts

@@ -1,4 +1,4 @@
-export type ProviderType = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'gemini-cli' | 'openai' | 'ollama' | 'anthropic' | 'openclaw' | 'google' | 'deepseek' | 'groq' | 'together' | 'mistral' | 'xai' | 'fireworks' | 'nebius' | 'deepinfra'
+export type ProviderType = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'gemini-cli' | 'copilot-cli' | 'openai' | 'ollama' | 'anthropic' | 'openclaw' | 'google' | 'deepseek' | 'groq' | 'together' | 'mistral' | 'xai' | 'fireworks' | 'nebius' | 'deepinfra'
 export type ProviderId = ProviderType | (string & {})
 
 export interface ProviderInfo {

package/src/types/session.ts

@@ -70,11 +70,13 @@ export interface Session {
   codexThreadId?: string | null
   opencodeSessionId?: string | null
   geminiSessionId?: string | null
+  copilotSessionId?: string | null
   delegateResumeIds?: {
     claudeCode?: string | null
     codex?: string | null
     opencode?: string | null
     gemini?: string | null
+    copilot?: string | null
   }
   /** @deprecated Messages are stored in session_messages table. Use message-repository. */
   messages: Message[]