@swarmclawai/swarmclaw 1.9.4 → 1.9.5

package/README.md

@@ -399,6 +399,16 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.5 Highlights
+
+Bundled portability release: project-scoped workspace bundles, safer v2 imports, and preserved internal relationships for reusable teams.
+
+- **Project bundle export.** `/api/portability/export?projectId=...` now emits a scoped workspace template with the selected project, active agents, pinned skills, schedules, chatrooms, connectors, MCP servers, and goals.
+- **Downloadable project templates.** Project exports include a `scope` block and use readable `swarmclaw-project-...json` filenames for portable team handoff.
+- **v2 import preservation.** The import route now validates and preserves v2 resources instead of dropping connectors, chatrooms, MCP servers, projects, goals, extensions, or scope metadata.
+- **Reference remapping.** Imports now remap project, skill, MCP server, schedule, chatroom, connector, and goal relationships so restored bundles remain internally linked.
+- **Credential-safe bundles.** Connector credentials, MCP env values, and sensitive config keys stay scrubbed while non-secret setup hints are retained.
+
 ### v1.9.4 Highlights
 
 Bundled runtime-environment release: gateway execution visibility, task context handoff, and operator triage in one release cycle.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.4",
+  "version": "1.9.5",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
   "main": "electron-dist/main.js",
   "license": "MIT",
@@ -87,7 +87,7 @@
     "test:cli": "node --test src/cli/*.test.js bin/*.test.js scripts/electron-after-pack.test.mjs scripts/ensure-sandbox-browser-image.test.mjs scripts/postinstall.test.mjs scripts/run-next-build.test.mjs scripts/run-next-typegen.test.mjs",
     "test:setup": "tsx --test src/app/api/setup/check-provider/route.test.ts src/lib/server/provider-model-discovery.test.ts src/components/auth/setup-wizard/utils.test.ts src/components/auth/setup-wizard/types.test.ts src/hooks/setup-done-detection.test.ts src/lib/setup-defaults.test.ts src/lib/server/storage-auth.test.ts src/lib/server/storage-auth-docker.test.ts",
     "test:openclaw": "tsx --test src/lib/openclaw/openclaw-agent-id.test.ts src/lib/openclaw/openclaw-endpoint.test.ts src/lib/server/agents/agent-runtime-config.test.ts src/lib/server/build-llm.test.ts src/lib/server/connectors/connector-routing.test.ts src/lib/server/connectors/openclaw.test.ts src/lib/server/connectors/swarmdock.test.ts src/lib/server/gateway/protocol.test.ts src/lib/server/gateways/gateway-topology.test.ts src/lib/server/llm-response-cache.test.ts src/lib/server/mcp-conformance.test.ts src/lib/server/openclaw/agent-resolver.test.ts src/lib/server/openclaw/deploy.test.ts src/lib/server/openclaw/skills-normalize.test.ts src/lib/server/session-tools/openclaw-nodes.test.ts src/lib/server/session-tools/swarmdock.test.ts src/lib/server/tasks/task-quality-gate.test.ts src/lib/server/tasks/task-validation.test.ts src/lib/server/tool-capability-policy.test.ts src/lib/providers/openai.test.ts src/lib/providers/openclaw-exports.test.ts src/app/api/gateways/topology-route.test.ts src/app/api/openclaw/dashboard-url/route.test.ts",
-    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/strip-internal-metadata.test.ts src/lib/provider-sets.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-provider-metadata.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/agents/delegation-advisory.test.ts src/lib/server/cli-provider-readiness.test.ts src/lib/server/provider-health.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/extension-managed-resources.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/artifacts/artifact-resolver.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/server/sharing/share-link-repository.test.ts src/lib/server/sharing/share-resolver.test.ts src/lib/server/tasks/task-execution-workspace.test.ts src/lib/server/tasks/task-service.test.ts src/lib/server/session-tools/execute.test.ts src/lib/server/session-tools/manage-tasks.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/tasks/task-workspace-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/extensions/managed-resources/route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/portability/export/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/tts/route.test.ts",
+    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/strip-internal-metadata.test.ts src/lib/provider-sets.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-provider-metadata.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/agents/delegation-advisory.test.ts src/lib/server/cli-provider-readiness.test.ts src/lib/server/provider-health.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/extension-managed-resources.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/artifacts/artifact-resolver.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/server/sharing/share-link-repository.test.ts src/lib/server/sharing/share-resolver.test.ts src/lib/server/tasks/task-execution-workspace.test.ts src/lib/server/tasks/task-service.test.ts src/lib/server/session-tools/execute.test.ts src/lib/server/session-tools/manage-tasks.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/tasks/task-workspace-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/extensions/managed-resources/route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/portability/export/route.test.ts src/app/api/portability/import/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/tts/route.test.ts",
     "test:builder": "tsx --test src/features/protocols/builder/utils/nodes-to-template.test.ts src/features/protocols/builder/utils/template-to-nodes.test.ts src/features/protocols/builder/validators/dag-validator.test.ts",
     "test:e2e": "node --import tsx scripts/browser-e2e-smoke.ts",
     "test:mcp:conformance": "node --import tsx ./scripts/mcp-conformance-check.ts",

package/src/app/api/portability/export/route.test.ts

@@ -3,6 +3,7 @@ import { describe, it } from 'node:test'
 
 import { GET } from './route'
 import { buildPortableExportFilename } from '@/lib/server/portability/export'
+import { runWithTempDataDir } from '@/lib/server/test-utils/run-with-temp-data-dir'
 
 describe('GET /api/portability/export', () => {
   it('returns a collision-resistant attachment filename for downloads', async () => {
@@ -14,4 +15,228 @@ describe('GET /api/portability/export', () => {
     const body = await response.json()
     assert.equal(disposition, `attachment; filename="${buildPortableExportFilename(body)}"`)
   })
+
+  it('exports a scoped project bundle with scrubbed integrations', () => {
+    const output = runWithTempDataDir<{
+      status: number
+      disposition: string
+      scopeKind: string
+      projectNames: string[]
+      agentNames: string[]
+      skillNames: string[]
+      scheduleNames: string[]
+      chatroomNames: string[]
+      connectorNames: string[]
+      mcpServerNames: string[]
+      connectorConfig: Record<string, string>
+      connectorEnabled: boolean
+      missingStatus: number
+      missingError: string
+    }>(`
+      const storageMod = await import('./src/lib/server/storage')
+      const agentRepoMod = await import('./src/lib/server/agents/agent-repository')
+      const skillRepoMod = await import('./src/lib/server/skills/skill-repository')
+      const scheduleRepoMod = await import('./src/lib/server/schedules/schedule-repository')
+      const chatroomRepoMod = await import('./src/lib/server/chatrooms/chatroom-repository')
+      const connectorRepoMod = await import('./src/lib/server/connectors/connector-repository')
+      const routeMod = await import('./src/app/api/portability/export/route')
+      const storage = storageMod.default || storageMod
+      const agentRepo = agentRepoMod.default || agentRepoMod
+      const skillRepo = skillRepoMod.default || skillRepoMod
+      const scheduleRepo = scheduleRepoMod.default || scheduleRepoMod
+      const chatroomRepo = chatroomRepoMod.default || chatroomRepoMod
+      const connectorRepo = connectorRepoMod.default || connectorRepoMod
+      const route = routeMod.default || routeMod
+      const { saveProjects, saveMcpServers } = storage
+      const { saveAgents } = agentRepo
+      const { saveSkills } = skillRepo
+      const { saveSchedules } = scheduleRepo
+      const { upsertChatroom } = chatroomRepo
+      const { upsertConnector } = connectorRepo
+      const now = 1780000000000
+
+      saveProjects({
+        'project-a': {
+          id: 'project-a',
+          name: 'Launch Room',
+          description: 'Shipping workspace',
+          color: '#5b8def',
+          objective: 'Ship the next release',
+          createdAt: now,
+          updatedAt: now,
+        },
+        'project-b': {
+          id: 'project-b',
+          name: 'Backlog',
+          description: 'Separate workspace',
+          createdAt: now,
+          updatedAt: now,
+        },
+      })
+      saveSkills({
+        'skill-a': {
+          id: 'skill-a',
+          name: 'Release Notes',
+          filename: 'release-notes.md',
+          content: 'Summarize shipped changes',
+          projectId: 'project-a',
+          scope: 'global',
+          createdAt: now,
+          updatedAt: now,
+        },
+        'global-skill': {
+          id: 'global-skill',
+          name: 'Risk Scan',
+          filename: 'risk-scan.md',
+          content: 'Find release risks',
+          scope: 'global',
+          createdAt: now,
+          updatedAt: now,
+        },
+        'skill-b': {
+          id: 'skill-b',
+          name: 'Backlog Grooming',
+          filename: 'backlog-grooming.md',
+          content: 'Sort the backlog',
+          projectId: 'project-b',
+          scope: 'global',
+          createdAt: now,
+          updatedAt: now,
+        },
+      })
+      saveMcpServers({
+        'mcp-a': {
+          id: 'mcp-a',
+          name: 'Local Tools',
+          transport: 'stdio',
+          command: 'node',
+          args: ['tool.js'],
+          env: { API_TOKEN: 'secret-token' },
+          createdAt: now,
+          updatedAt: now,
+        },
+        'mcp-b': {
+          id: 'mcp-b',
+          name: 'Backlog Tools',
+          transport: 'stdio',
+          command: 'node',
+          createdAt: now,
+          updatedAt: now,
+        },
+      })
+      saveAgents({
+        'agent-a': {
+          id: 'agent-a',
+          name: 'Release Lead',
+          description: 'Owns launch execution',
+          systemPrompt: 'Ship safely',
+          provider: 'openai',
+          model: 'gpt-4o-mini',
+          projectId: 'project-a',
+          skillIds: ['skill-a', 'global-skill'],
+          mcpServerIds: ['mcp-a'],
+          createdAt: now,
+          updatedAt: now,
+        },
+        'agent-b': {
+          id: 'agent-b',
+          name: 'Backlog Lead',
+          description: 'Owns backlog',
+          systemPrompt: 'Plan later',
+          provider: 'openai',
+          model: 'gpt-4o-mini',
+          projectId: 'project-b',
+          skillIds: ['skill-b'],
+          mcpServerIds: ['mcp-b'],
+          createdAt: now,
+          updatedAt: now,
+        },
+      })
+      saveSchedules({
+        'schedule-a': {
+          id: 'schedule-a',
+          name: 'Daily Launch Check',
+          agentId: 'agent-a',
+          projectId: 'project-a',
+          taskPrompt: 'Check release readiness',
+          scheduleType: 'interval',
+          intervalMs: 60000,
+          status: 'active',
+          createdAt: now,
+          updatedAt: now,
+        },
+        'schedule-b': {
+          id: 'schedule-b',
+          name: 'Backlog Check',
+          agentId: 'agent-b',
+          projectId: 'project-b',
+          taskPrompt: 'Review backlog',
+          scheduleType: 'interval',
+          intervalMs: 60000,
+          status: 'active',
+          createdAt: now,
+          updatedAt: now,
+        },
+      })
+      upsertChatroom('room-a', {
+        id: 'room-a',
+        name: 'Launch Room Chat',
+        agentIds: ['agent-a'],
+        messages: [],
+        chatMode: 'parallel',
+        temporary: false,
+        createdAt: now,
+        updatedAt: now,
+      })
+      upsertConnector('connector-a', {
+        id: 'connector-a',
+        name: 'Launch Slack',
+        platform: 'slack',
+        agentId: 'agent-a',
+        chatroomId: 'room-a',
+        credentialId: 'credential-a',
+        config: { channel: 'launch', botToken: 'secret-token' },
+        isEnabled: true,
+        status: 'running',
+        createdAt: now,
+        updatedAt: now,
+      })
+
+      const response = await route.GET(new Request('http://local/api/portability/export?projectId=project-a&download=true'))
+      const body = await response.json()
+      const missingResponse = await route.GET(new Request('http://local/api/portability/export?projectId=missing-project'))
+      const missingPayload = await missingResponse.json()
+      console.log(JSON.stringify({
+        status: response.status,
+        disposition: response.headers.get('content-disposition') || '',
+        scopeKind: body.scope?.kind || null,
+        projectNames: (body.projects || []).map((project) => project.name),
+        agentNames: body.agents.map((agent) => agent.name),
+        skillNames: body.skills.map((skill) => skill.name).sort(),
+        scheduleNames: body.schedules.map((schedule) => schedule.name),
+        chatroomNames: (body.chatrooms || []).map((chatroom) => chatroom.name),
+        connectorNames: (body.connectors || []).map((connector) => connector.name),
+        mcpServerNames: (body.mcpServers || []).map((server) => server.name),
+        connectorConfig: body.connectors?.[0]?.config || {},
+        connectorEnabled: body.connectors?.[0]?.isEnabled ?? null,
+        missingStatus: missingResponse.status,
+        missingError: missingPayload.error,
+      }))
+    `)
+
+    assert.equal(output.status, 200)
+    assert.match(output.disposition, /^attachment; filename="swarmclaw-project-launch-room-\d{8}-\d{6}\d{3}Z\.json"$/)
+    assert.equal(output.scopeKind, 'project')
+    assert.deepEqual(output.projectNames, ['Launch Room'])
+    assert.deepEqual(output.agentNames, ['Release Lead'])
+    assert.deepEqual(output.skillNames, ['Release Notes', 'Risk Scan'])
+    assert.deepEqual(output.scheduleNames, ['Daily Launch Check'])
+    assert.deepEqual(output.chatroomNames, ['Launch Room Chat'])
+    assert.deepEqual(output.connectorNames, ['Launch Slack'])
+    assert.deepEqual(output.mcpServerNames, ['Local Tools'])
+    assert.deepEqual(output.connectorConfig, { channel: 'launch' })
+    assert.equal(output.connectorEnabled, false)
+    assert.equal(output.missingStatus, 404)
+    assert.equal(output.missingError, 'Project not found: missing-project')
+  })
 })

package/src/app/api/portability/export/route.ts

@@ -3,15 +3,24 @@ import { buildPortableExportFilename, exportConfig } from '@/lib/server/portabil
 export const dynamic = 'force-dynamic'
 
 export async function GET(req: Request) {
-  const manifest = exportConfig()
   const { searchParams } = new URL(req.url)
-  if (searchParams.get('download') === 'true') {
-    return new NextResponse(JSON.stringify(manifest, null, 2), {
-      headers: {
-        'content-type': 'application/json; charset=utf-8',
-        'content-disposition': `attachment; filename="${buildPortableExportFilename(manifest)}"`,
-      },
-    })
+  const projectId = searchParams.get('projectId')?.trim() || null
+  try {
+    const manifest = exportConfig({ projectId })
+    if (searchParams.get('download') === 'true') {
+      return new NextResponse(JSON.stringify(manifest, null, 2), {
+        headers: {
+          'content-type': 'application/json; charset=utf-8',
+          'content-disposition': `attachment; filename="${buildPortableExportFilename(manifest)}"`,
+        },
+      })
+    }
+    return NextResponse.json(manifest)
+  } catch (err) {
+    const message = err instanceof Error ? err.message : 'Failed to export manifest'
+    if (message.startsWith('Project not found: ')) {
+      return NextResponse.json({ error: message }, { status: 404 })
+    }
+    return NextResponse.json({ error: message }, { status: 500 })
   }
-  return NextResponse.json(manifest)
 }

package/src/app/api/portability/import/route.test.ts

@@ -1,39 +1,18 @@
 import assert from 'node:assert/strict'
-import fs from 'node:fs'
-import os from 'node:os'
-import path from 'node:path'
-import { spawnSync } from 'node:child_process'
 import test from 'node:test'
 
-const repoRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), '../../../../..')
-
-function runWithTempDataDir(script: string) {
-  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'swarmclaw-portability-import-'))
-  try {
-    const result = spawnSync(process.execPath, ['--import', 'tsx', '--input-type=module', '--eval', script], {
-      cwd: repoRoot,
-      env: {
-        ...process.env,
-        DATA_DIR: path.join(tempDir, 'data'),
-        WORKSPACE_DIR: path.join(tempDir, 'workspace'),
-      },
-      encoding: 'utf-8',
-    })
-    assert.equal(result.status, 0, result.stderr || result.stdout || 'subprocess failed')
-    const lines = (result.stdout || '')
-      .trim()
-      .split('\n')
-      .map((line) => line.trim())
-      .filter(Boolean)
-    const jsonLine = [...lines].reverse().find((line) => line.startsWith('{'))
-    return JSON.parse(jsonLine || '{}')
-  } finally {
-    fs.rmSync(tempDir, { recursive: true, force: true })
-  }
-}
+import { runWithTempDataDir } from '@/lib/server/test-utils/run-with-temp-data-dir'
 
 test('POST /api/portability/import validates manifest arrays before importing', () => {
-  const output = runWithTempDataDir(`
+  const output = runWithTempDataDir<{
+    invalidStatus: number
+    invalidError: string | null
+    invalidPaths: string[]
+    validStatus: number
+    validAgentsCreated: number | null
+    validSkillsCreated: number | null
+    validSchedulesCreated: number | null
+  }>(`
     const routeMod = await import('./src/app/api/portability/import/route')
     const route = routeMod.default || routeMod
 
@@ -78,3 +57,225 @@ test('POST /api/portability/import validates manifest arrays before importing',
   assert.equal(output.validSkillsCreated, 0)
   assert.equal(output.validSchedulesCreated, 0)
 })
+
+test('POST /api/portability/import preserves v2 bundle resources after validation', () => {
+  const output = runWithTempDataDir<{
+    status: number
+    created: Record<string, number>
+    projectId: string | null
+    agentId: string | null
+    agentProjectId: string | null
+    agentSkillIds: string[]
+    agentMcpServerIds: string[]
+    agentGoalId: string | null
+    skillId: string | null
+    skillProjectId: string | null
+    skillAgentIds: string[]
+    scheduleProjectId: string | null
+    scheduleParticipantIds: string[]
+    scheduleFacilitatorId: string | null
+    scheduleObserverIds: string[]
+    chatroomId: string | null
+    chatroomAgentIds: string[]
+    connectorAgentId: string | null
+    connectorChatroomId: string | null
+    connectorEnabled: boolean | null
+    mcpId: string | null
+    mcpEnvKeys: string[]
+    goalId: string | null
+    goalProjectId: string | null
+    goalAgentId: string | null
+    needsCredentials: string[]
+  }>(`
+    const routeMod = await import('./src/app/api/portability/import/route')
+    const storageMod = await import('./src/lib/server/storage')
+    const agentRepoMod = await import('./src/lib/server/agents/agent-repository')
+    const skillRepoMod = await import('./src/lib/server/skills/skill-repository')
+    const scheduleRepoMod = await import('./src/lib/server/schedules/schedule-repository')
+    const chatroomRepoMod = await import('./src/lib/server/chatrooms/chatroom-repository')
+    const connectorRepoMod = await import('./src/lib/server/connectors/connector-repository')
+    const route = routeMod.default || routeMod
+    const storage = storageMod.default || storageMod
+    const agentRepo = agentRepoMod.default || agentRepoMod
+    const skillRepo = skillRepoMod.default || skillRepoMod
+    const scheduleRepo = scheduleRepoMod.default || scheduleRepoMod
+    const chatroomRepo = chatroomRepoMod.default || chatroomRepoMod
+    const connectorRepo = connectorRepoMod.default || connectorRepoMod
+    const { loadProjects, loadMcpServers, loadGoals } = storage
+    const { loadAgents } = agentRepo
+    const { loadSkills } = skillRepo
+    const { loadSchedules } = scheduleRepo
+    const { loadChatrooms } = chatroomRepo
+    const { loadConnectors } = connectorRepo
+
+    const response = await route.POST(new Request('http://local/api/portability/import', {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({
+        formatVersion: 2,
+        exportedAt: '2026-05-05T00:00:00.000Z',
+        scope: { kind: 'project', originalProjectId: 'project-1', projectName: 'Launch Room' },
+        projects: [{
+          originalId: 'project-1',
+          name: 'Launch Room',
+          description: 'Shipping workspace',
+          objective: 'Ship the fix',
+        }],
+        skills: [{
+          originalId: 'skill-1',
+          originalProjectId: 'project-1',
+          originalAgentIds: ['agent-1'],
+          name: 'Release Skill',
+          content: 'Ship carefully',
+          scope: 'agent',
+        }],
+        mcpServers: [{
+          originalId: 'mcp-1',
+          name: 'Local Tools',
+          transport: 'stdio',
+          command: 'node',
+          args: ['tool.js'],
+          envKeys: ['API_TOKEN'],
+          credentialsScrubbed: true,
+        }],
+        agents: [{
+          originalId: 'agent-1',
+          name: 'Release Lead',
+          description: 'Owns launch execution',
+          systemPrompt: 'Ship safely',
+          provider: 'openai',
+          model: 'gpt-4o-mini',
+          projectId: 'project-1',
+          skillIds: ['skill-1'],
+          mcpServerIds: ['mcp-1'],
+          goalId: 'goal-1',
+        }],
+        schedules: [{
+          originalId: 'schedule-1',
+          originalAgentId: 'agent-1',
+          name: 'Launch Check',
+          projectId: 'project-1',
+          taskPrompt: 'Check release readiness',
+          taskMode: 'protocol',
+          protocolTemplateId: 'template-1',
+          protocolParticipantAgentIds: ['agent-1'],
+          protocolFacilitatorAgentId: 'agent-1',
+          protocolObserverAgentIds: ['agent-1'],
+          protocolConfig: { phase: 'ship' },
+          scheduleType: 'interval',
+          intervalMs: 60000,
+        }],
+        chatrooms: [{
+          originalId: 'room-1',
+          originalAgentIds: ['agent-1'],
+          name: 'Launch Room Chat',
+          chatMode: 'parallel',
+          autoAddress: true,
+          routingRules: [{
+            type: 'keyword',
+            keywords: ['release'],
+            originalAgentId: 'agent-1',
+            priority: 1,
+          }],
+        }],
+        connectors: [{
+          originalId: 'connector-1',
+          originalAgentId: 'agent-1',
+          originalChatroomId: 'room-1',
+          name: 'Launch Slack',
+          platform: 'slack',
+          isEnabled: false,
+          config: { channel: 'launch' },
+          credentialsScrubbed: true,
+        }],
+        goals: [{
+          originalId: 'goal-1',
+          originalProjectId: 'project-1',
+          originalAgentId: 'agent-1',
+          title: 'Ship fix',
+          level: 'project',
+          objective: 'Release the portability fix',
+          status: 'active',
+        }],
+        extensions: [{ name: 'builtin-checks' }],
+      }),
+    }))
+    const payload = await response.json()
+    const project = Object.values(loadProjects()).find((item) => item.name === 'Launch Room')
+    const agent = Object.values(loadAgents()).find((item) => item.name === 'Release Lead')
+    const skill = Object.values(loadSkills()).find((item) => item.name === 'Release Skill')
+    const schedule = Object.values(loadSchedules()).find((item) => item.name === 'Launch Check')
+    const chatroom = Object.values(loadChatrooms()).find((item) => item.name === 'Launch Room Chat')
+    const connector = Object.values(loadConnectors()).find((item) => item.name === 'Launch Slack')
+    const mcp = Object.values(loadMcpServers()).find((item) => item.name === 'Local Tools')
+    const goal = Object.values(loadGoals()).find((item) => item.title === 'Ship fix')
+
+    console.log(JSON.stringify({
+      status: response.status,
+      created: {
+        agents: payload.agents.created,
+        skills: payload.skills.created,
+        schedules: payload.schedules.created,
+        connectors: payload.connectors.created,
+        chatrooms: payload.chatrooms.created,
+        mcpServers: payload.mcpServers.created,
+        projects: payload.projects.created,
+        goals: payload.goals.created,
+      },
+      projectId: project?.id || null,
+      agentId: agent?.id || null,
+      agentProjectId: agent?.projectId || null,
+      agentSkillIds: agent?.skillIds || [],
+      agentMcpServerIds: agent?.mcpServerIds || [],
+      agentGoalId: agent?.goalId || null,
+      skillId: skill?.id || null,
+      skillProjectId: skill?.projectId || null,
+      skillAgentIds: skill?.agentIds || [],
+      scheduleProjectId: schedule?.projectId || null,
+      scheduleParticipantIds: schedule?.protocolParticipantAgentIds || [],
+      scheduleFacilitatorId: schedule?.protocolFacilitatorAgentId || null,
+      scheduleObserverIds: schedule?.protocolObserverAgentIds || [],
+      chatroomId: chatroom?.id || null,
+      chatroomAgentIds: chatroom?.agentIds || [],
+      connectorAgentId: connector?.agentId || null,
+      connectorChatroomId: connector?.chatroomId || null,
+      connectorEnabled: connector?.isEnabled ?? null,
+      mcpId: mcp?.id || null,
+      mcpEnvKeys: Object.keys(mcp?.env || {}),
+      goalId: goal?.id || null,
+      goalProjectId: goal?.projectId || null,
+      goalAgentId: goal?.agentId || null,
+      needsCredentials: payload.mcpServers.needsCredentials,
+    }))
+  `)
+
+  assert.equal(output.status, 200)
+  assert.deepEqual(output.created, {
+    agents: 1,
+    skills: 1,
+    schedules: 1,
+    connectors: 1,
+    chatrooms: 1,
+    mcpServers: 1,
+    projects: 1,
+    goals: 1,
+  })
+  assert.equal(output.agentProjectId, output.projectId)
+  assert.deepEqual(output.agentSkillIds, [output.skillId])
+  assert.deepEqual(output.agentMcpServerIds, [output.mcpId])
+  assert.equal(output.agentGoalId, output.goalId)
+  assert.equal(output.skillProjectId, output.projectId)
+  assert.deepEqual(output.skillAgentIds, [output.agentId])
+  assert.equal(output.scheduleProjectId, output.projectId)
+  assert.deepEqual(output.scheduleParticipantIds, [output.agentId])
+  assert.equal(output.scheduleFacilitatorId, output.agentId)
+  assert.deepEqual(output.scheduleObserverIds, [output.agentId])
+  assert.deepEqual(output.chatroomAgentIds, [output.agentId])
+  assert.equal(output.connectorAgentId, output.agentId)
+  assert.equal(output.connectorChatroomId, output.chatroomId)
+  assert.equal(output.connectorEnabled, false)
+  assert.deepEqual(output.mcpEnvKeys, ['API_TOKEN'])
+  assert.equal(output.goalProjectId, output.projectId)
+  assert.equal(output.goalAgentId, output.agentId)
+  assert.deepEqual(output.needsCredentials, ['Local Tools'])
+})

package/src/app/api/portability/import/route.ts

@@ -16,11 +16,11 @@ export async function POST(req: Request) {
   }
 
   try {
-    const result = importConfig(parsed.data as PortableManifest)
+    const result = importConfig(parsed.data as unknown as PortableManifest)
     return NextResponse.json(result)
   } catch (err) {
     const message = err instanceof Error ? err.message : 'Failed to import manifest'
-    if (/^Unsupported format version /i.test(message)) {
+    if (message.startsWith('Unsupported format version ')) {
       return NextResponse.json({ error: message }, { status: 400 })
     }
     return NextResponse.json({ error: message }, { status: 500 })