@swarmclawai/swarmclaw 1.9.13 → 1.9.15

package/README.md

@@ -399,6 +399,24 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.15 Highlights
+
+Run handoff release: SwarmClaw now turns completed, failed, queued, or running execution records into copyable handoff packets with outcome, evidence, artifacts, timeline, usage, resume commands, and recommended next actions.
+
+- **Run handoff API.** `GET /api/runs/:id/handoff` returns structured handoff JSON, and `?format=markdown` returns copyable markdown.
+- **Run Review copy action.** The run detail sheet exposes a copy handoff button so operators can move outcome evidence into another session without replaying the full event log.
+- **CLI access.** `swarmclaw runs handoff <runId> --query format=markdown` exposes the same packet for scripts and release automation.
+- **Readiness guidance.** Packets mark failed, cancelled, running, warning, or under-evidenced runs as blocked or needing attention before another operator relies on the result.
+
+### v1.9.14 Highlights
+
+Session context-pack release: SwarmClaw now turns a live chat into a concise handoff packet with session metadata, recent visible turns, linked tasks, attachments, resume handles, and next actions.
+
+- **Context-pack API.** `GET /api/chats/:id/context-pack` returns structured handoff JSON, and `?format=markdown` returns copyable markdown.
+- **Chat header copy action.** Active chats with messages expose a context-pack button for quick handoff to another operator or backend.
+- **CLI access.** `swarmclaw chats context-pack <chatId> --query format=markdown` exposes the same packet for scripts and release automation.
+- **Smoke coverage.** Runtime tests and the browser smoke gate now verify the context-pack route and markdown response.
+
 ### v1.9.13 Highlights
 
 Architecture health release: SwarmClaw now turns runtime ownership, dispatch, memory, startup, and quality evidence into a scored operator report.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.13",
+  "version": "1.9.15",
   "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",
@@ -88,7 +88,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/eval/baseline.test.ts src/lib/server/eval/environment-plan.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/schedules/schedule-history.test.ts src/lib/quality/release-readiness.test.ts src/lib/quality/architecture-health.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-execution-policy.test.ts src/lib/server/tasks/task-handoff.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/schedules/schedule-history-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/eval/baseline.test.ts src/lib/server/eval/environment-plan.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/chats/session-context-pack.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/runs/run-handoff.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/schedules/schedule-history.test.ts src/lib/quality/release-readiness.test.ts src/lib/quality/architecture-health.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-execution-policy.test.ts src/lib/server/tasks/task-handoff.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-pack-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/runs/run-handoff-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/schedules/schedule-history-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/chats/[id]/context-pack/route.ts

@@ -0,0 +1,43 @@
+import { NextResponse } from 'next/server'
+
+import { buildSessionContextPack, formatSessionContextPackMarkdown } from '@/lib/server/chats/session-context-pack'
+import { notFound } from '@/lib/server/collection-helpers'
+import { getMessages } from '@/lib/server/messages/message-repository'
+import { getSession } from '@/lib/server/sessions/session-repository'
+import { listTasks } from '@/lib/server/tasks/task-repository'
+
+const DEFAULT_RECENT_MESSAGES = 12
+const MAX_RECENT_MESSAGES = 40
+
+function parseMaxRecentMessages(req: Request): number {
+  const url = new URL(req.url)
+  const raw = url.searchParams.get('messages') || url.searchParams.get('maxRecentMessages')
+  const parsed = Number.parseInt(raw || '', 10)
+  if (!Number.isFinite(parsed)) return DEFAULT_RECENT_MESSAGES
+  return Math.max(1, Math.min(MAX_RECENT_MESSAGES, parsed))
+}
+
+export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const session = getSession(id)
+  if (!session) return notFound()
+
+  const url = new URL(req.url)
+  const format = url.searchParams.get('format')
+  const pack = buildSessionContextPack({
+    session,
+    messages: getMessages(id),
+    tasks: listTasks(),
+    maxRecentMessages: parseMaxRecentMessages(req),
+  })
+
+  if (format === 'markdown') {
+    return new Response(formatSessionContextPackMarkdown(pack), {
+      headers: {
+        'content-type': 'text/markdown; charset=utf-8',
+      },
+    })
+  }
+
+  return NextResponse.json(pack)
+}

package/src/app/api/chats/context-pack-route.test.ts

@@ -0,0 +1,109 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { runWithTempDataDir } from '@/lib/server/test-utils/run-with-temp-data-dir'
+
+test('GET /api/chats/[id]/context-pack returns structured and markdown handoff context', () => {
+  const output = runWithTempDataDir<{
+    status: number
+    markdownStatus: number
+    missingStatus: number
+    schemaVersion: number
+    linkedTaskCount: number
+    recentMessageCount: number
+    markdownContentType: string
+    markdownIncludesTitle: boolean
+    markdownIncludesTask: boolean
+  }>(`
+    const storageMod = await import('./src/lib/server/storage')
+    const repoMod = await import('@/lib/server/messages/message-repository')
+    const routeMod = await import('./src/app/api/chats/[id]/context-pack/route')
+    const storage = storageMod.default || storageMod
+    const repo = repoMod.default || repoMod
+    const route = routeMod.default || routeMod
+
+    const now = Date.now()
+    storage.saveSessions({
+      sess_pack_1: {
+        id: 'sess_pack_1',
+        name: 'Context pack test',
+        cwd: process.env.WORKSPACE_DIR,
+        user: 'tester',
+        provider: 'openai',
+        model: 'gpt-4o-mini',
+        claudeSessionId: null,
+        codexThreadId: 'codex-pack-thread',
+        messages: [],
+        createdAt: now,
+        lastActiveAt: now,
+        runContext: {
+          objective: 'Hand off a release session.',
+          constraints: ['Keep the pack short.'],
+          keyFacts: ['The current tag is local only.'],
+          discoveries: [],
+          failedApproaches: [],
+          currentPlan: ['Run checks'],
+          completedSteps: [],
+          blockers: [],
+          parentContext: null,
+          updatedAt: now,
+          version: 1,
+        },
+      },
+    })
+    storage.saveTasks({
+      task_pack_1: {
+        id: 'task_pack_1',
+        title: 'Verify context pack',
+        description: 'Exercise API route.',
+        status: 'running',
+        sessionId: 'sess_pack_1',
+        agentId: null,
+        createdAt: now,
+        updatedAt: now + 3,
+      },
+    })
+
+    repo.appendMessage('sess_pack_1', { role: 'user', text: 'Prepare handoff.', time: now, attachedFiles: ['/tmp/handoff.md'] })
+    repo.appendMessage('sess_pack_1', { role: 'assistant', text: 'Ready.', time: now + 1 })
+
+    const response = await route.GET(
+      new Request('http://local/api/chats/sess_pack_1/context-pack?messages=1'),
+      { params: Promise.resolve({ id: 'sess_pack_1' }) },
+    )
+    const payload = await response.json()
+
+    const markdownResponse = await route.GET(
+      new Request('http://local/api/chats/sess_pack_1/context-pack?format=markdown'),
+      { params: Promise.resolve({ id: 'sess_pack_1' }) },
+    )
+    const markdown = await markdownResponse.text()
+
+    const missingResponse = await route.GET(
+      new Request('http://local/api/chats/missing/context-pack'),
+      { params: Promise.resolve({ id: 'missing' }) },
+    )
+
+    console.log(JSON.stringify({
+      status: response.status,
+      markdownStatus: markdownResponse.status,
+      missingStatus: missingResponse.status,
+      schemaVersion: payload.schemaVersion,
+      linkedTaskCount: payload.linkedTasks.length,
+      recentMessageCount: payload.recentMessages.length,
+      markdownContentType: markdownResponse.headers.get('content-type') || '',
+      markdownIncludesTitle: markdown.includes('# Session Context Pack: Context pack test'),
+      markdownIncludesTask: markdown.includes('Verify context pack'),
+    }))
+  `, { prefix: 'swarmclaw-context-pack-route-' })
+
+  assert.equal(output.status, 200)
+  assert.equal(output.markdownStatus, 200)
+  assert.equal(output.missingStatus, 404)
+  assert.equal(output.schemaVersion, 1)
+  assert.equal(output.linkedTaskCount, 1)
+  assert.equal(output.recentMessageCount, 1)
+  assert.match(output.markdownContentType, /text\/markdown/)
+  assert.equal(output.markdownIncludesTitle, true)
+  assert.equal(output.markdownIncludesTask, true)
+})

package/src/app/api/runs/[id]/handoff/route.ts

@@ -0,0 +1,26 @@
+import { NextResponse } from 'next/server'
+import { listEvidenceArtifacts } from '@/lib/server/artifacts/artifact-resolver'
+import { buildRunBrief } from '@/lib/server/runs/run-brief'
+import { buildRunHandoffPacket, formatRunHandoffMarkdown } from '@/lib/server/runs/run-handoff'
+import { getUnifiedRunById, listUnifiedRunEvents } from '@/lib/server/runs/unified-run-queries'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const run = getUnifiedRunById(id)
+  if (!run) return NextResponse.json({ error: 'Run not found' }, { status: 404 })
+
+  const events = listUnifiedRunEvents(id, 300)
+  const brief = buildRunBrief(run, events)
+  const packet = buildRunHandoffPacket(run, brief, listEvidenceArtifacts({ runId: id }))
+  const url = new URL(req.url)
+
+  if (url.searchParams.get('format') === 'markdown') {
+    return new NextResponse(formatRunHandoffMarkdown(packet), {
+      headers: { 'content-type': 'text/markdown; charset=utf-8' },
+    })
+  }
+
+  return NextResponse.json(packet)
+}

package/src/app/api/runs/run-handoff-route.test.ts

@@ -0,0 +1,120 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { runWithTempDataDir } from '@/lib/server/test-utils/run-with-temp-data-dir'
+
+test('GET /api/runs/[id]/handoff returns structured and markdown handoff context', () => {
+  const output = runWithTempDataDir<{
+    status: number
+    markdownStatus: number
+    missingStatus: number
+    schemaVersion: number
+    readiness: string
+    artifactCount: number
+    markdownContentType: string
+    markdownIncludesTitle: boolean
+    markdownIncludesCommand: boolean
+  }>(`
+    const storageMod = await import('./src/lib/server/storage')
+    const ledgerMod = await import('./src/lib/server/runtime/run-ledger')
+    const routeMod = await import('./src/app/api/runs/[id]/handoff/route')
+    const storage = storageMod.default || storageMod
+    const ledger = ledgerMod.default || ledgerMod
+    const route = routeMod.default || routeMod
+
+    const now = Date.now()
+    storage.saveSessions({
+      sess_run_handoff: {
+        id: 'sess_run_handoff',
+        name: 'Run handoff session',
+        cwd: process.env.WORKSPACE_DIR,
+        user: 'tester',
+        provider: 'openai',
+        model: 'gpt-4o-mini',
+        messages: [],
+        createdAt: now,
+        lastActiveAt: now,
+      },
+    })
+
+    ledger.persistRun({
+      id: 'run_handoff_1',
+      sessionId: 'sess_run_handoff',
+      source: 'task',
+      internal: false,
+      mode: 'direct',
+      status: 'completed',
+      messagePreview: 'Ship the next fix',
+      queuedAt: now - 5000,
+      startedAt: now - 4000,
+      endedAt: now - 1000,
+      resultPreview: 'Fix shipped and verified.',
+      totalInputTokens: 11,
+      totalOutputTokens: 22,
+      retrievalSummary: { citationCount: 1, sourceIds: ['source_1'] },
+    })
+    ledger.appendPersistedRunEvent({
+      runId: 'run_handoff_1',
+      sessionId: 'sess_run_handoff',
+      phase: 'status',
+      status: 'completed',
+      timestamp: now - 1000,
+      event: { t: 'md', text: 'Fix shipped and verified.' },
+      citations: [{
+        sourceId: 'source_1',
+        sourceTitle: 'Release evidence',
+        sourceKind: 'manual',
+        sourceUrl: 'https://example.test/release',
+        sourceLabel: null,
+        chunkId: 'chunk_1',
+        chunkIndex: 0,
+        chunkCount: 1,
+        charStart: 0,
+        charEnd: 20,
+        sectionLabel: null,
+        snippet: 'Release checks passed.',
+        whyMatched: null,
+        score: 0.9,
+      }],
+    })
+
+    const response = await route.GET(
+      new Request('http://local/api/runs/run_handoff_1/handoff'),
+      { params: Promise.resolve({ id: 'run_handoff_1' }) },
+    )
+    const payload = await response.json()
+
+    const markdownResponse = await route.GET(
+      new Request('http://local/api/runs/run_handoff_1/handoff?format=markdown'),
+      { params: Promise.resolve({ id: 'run_handoff_1' }) },
+    )
+    const markdown = await markdownResponse.text()
+
+    const missingResponse = await route.GET(
+      new Request('http://local/api/runs/missing/handoff'),
+      { params: Promise.resolve({ id: 'missing' }) },
+    )
+
+    console.log(JSON.stringify({
+      status: response.status,
+      markdownStatus: markdownResponse.status,
+      missingStatus: missingResponse.status,
+      schemaVersion: payload.schemaVersion,
+      readiness: payload.readiness.status,
+      artifactCount: payload.artifacts.length,
+      markdownContentType: markdownResponse.headers.get('content-type') || '',
+      markdownIncludesTitle: markdown.includes('# Run Handoff: Ship the next fix'),
+      markdownIncludesCommand: markdown.includes('swarmclaw runs handoff run_handoff_1'),
+    }))
+  `, { prefix: 'swarmclaw-run-handoff-route-' })
+
+  assert.equal(output.status, 200)
+  assert.equal(output.markdownStatus, 200)
+  assert.equal(output.missingStatus, 404)
+  assert.equal(output.schemaVersion, 1)
+  assert.equal(output.readiness, 'ready')
+  assert.equal(output.artifactCount >= 1, true)
+  assert.match(output.markdownContentType, /text\/markdown/)
+  assert.equal(output.markdownIncludesTitle, true)
+  assert.equal(output.markdownIncludesCommand, true)
+})

package/src/cli/index.js

@@ -572,6 +572,7 @@ const COMMAND_GROUPS = [
       cmd('get', 'GET', '/runs/:id', 'Get run by id'),
       cmd('events', 'GET', '/runs/:id/events', 'Get run event history by run id'),
       cmd('brief', 'GET', '/runs/:id/brief', 'Get deterministic run brief by run id'),
+      cmd('handoff', 'GET', '/runs/:id/handoff', 'Get run handoff packet by run id'),
     ],
   },
   {
@@ -627,6 +628,7 @@ const COMMAND_GROUPS = [
       cmd('clear-undo', 'POST', '/chats/:id/clear/undo', 'Restore a cleared chat via its undoToken', { expectsJsonBody: true }),
       cmd('compact', 'POST', '/chats/:id/compact', 'Summarize and compact chat history (accepts optional keepLastN)', { expectsJsonBody: true }),
       cmd('context-status', 'GET', '/chats/:id/context-status', 'Report token usage and context-window status for a chat'),
+      cmd('context-pack', 'GET', '/chats/:id/context-pack', 'Get a copyable session context pack for handoff'),
       cmd('browser-status', 'GET', '/chats/:id/browser', 'Check browser status'),
       cmd('browser-close', 'DELETE', '/chats/:id/browser', 'Close browser'),
       cmd('mailbox', 'GET', '/chats/:id/mailbox', 'List chat mailbox envelopes'),

package/src/cli/spec.js

@@ -458,6 +458,7 @@ const COMMAND_GROUPS = {
       'clear-undo': { description: 'Restore a cleared chat via its undoToken', method: 'POST', path: '/chats/:id/clear/undo', params: ['id'] },
       compact: { description: 'Summarize and compact chat history', method: 'POST', path: '/chats/:id/compact', params: ['id'] },
       'context-status': { description: 'Report token usage and context-window status', method: 'GET', path: '/chats/:id/context-status', params: ['id'] },
+      'context-pack': { description: 'Get a copyable session context pack for handoff', method: 'GET', path: '/chats/:id/context-pack', params: ['id'] },
       mailbox: { description: 'List mailbox envelopes for a chat', method: 'GET', path: '/chats/:id/mailbox', params: ['id'] },
       'mailbox-action': { description: 'Send/ack/clear mailbox envelopes', method: 'POST', path: '/chats/:id/mailbox', params: ['id'] },
       queue: { description: 'List queued follow-up turns for a chat', method: 'GET', path: '/chats/:id/queue', params: ['id'] },
@@ -551,6 +552,7 @@ const COMMAND_GROUPS = {
       get: { description: 'Get run by id', method: 'GET', path: '/runs/:id', params: ['id'] },
       events: { description: 'Get run event history by run id', method: 'GET', path: '/runs/:id/events', params: ['id'] },
       brief: { description: 'Get deterministic run brief by run id', method: 'GET', path: '/runs/:id/brief', params: ['id'] },
+      handoff: { description: 'Get run handoff packet by run id', method: 'GET', path: '/runs/:id/handoff', params: ['id'] },
     },
   },
   webhooks: {

package/src/components/chat/chat-header.tsx

@@ -1,7 +1,7 @@
 'use client'
 
 import { useEffect, useState, useMemo, useRef, type ReactNode } from 'react'
-import { Plus } from 'lucide-react'
+import { ClipboardList, Plus } from 'lucide-react'
 import type { Session } from '@/types'
 import { useAppStore } from '@/stores/use-app-store'
 import { useChatStore } from '@/stores/use-chat-store'
@@ -108,6 +108,8 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
   const connectorMeta = connector ? resolveConnectorPlatformMeta(connector.platform) : null
   const connectorPresence = connector?.presence
   const [copied, setCopied] = useState(false)
+  const [contextPackCopied, setContextPackCopied] = useState(false)
+  const [contextPackLoading, setContextPackLoading] = useState(false)
   const [sourceDropdownOpen, setSourceDropdownOpen] = useState(false)
   const sourceDropdownRef = useRef<HTMLDivElement>(null)
   const [renaming, setRenaming] = useState(false)
@@ -220,6 +222,22 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
     })
   }
 
+  const handleCopyContextPack = async () => {
+    if (contextPackLoading) return
+    setContextPackLoading(true)
+    try {
+      const markdown = await api<string>('GET', `/chats/${session.id}/context-pack?format=markdown`)
+      const copiedPack = await copyTextToClipboard(markdown)
+      if (!copiedPack) return
+      setContextPackCopied(true)
+      setTimeout(() => setContextPackCopied(false), 2000)
+    } catch {
+      // Best-effort clipboard helper; the route remains available from the CLI.
+    } finally {
+      setContextPackLoading(false)
+    }
+  }
+
   const handleDismissResumeHandle = async (e: React.MouseEvent) => {
     e.stopPropagation()
     try {
@@ -302,10 +320,11 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
     }
   }, [session.name, loadConnectors])
 
-  // Context bar shows for memories, source filter, task links, resume handles, browser
+  // Context bar shows for handoff packs, memories, source filter, task links, resume handles, browser
+  const hasContextPack = messageCount > 0
   const hasMemoryLink = !!(agent && getEnabledToolIds(session).includes('memory'))
   const hasSourceFilter = !!hasMultipleSources
-  const hasContextBar = !!(hasMemoryLink || hasSourceFilter || linkedTask || resumeHandle || browserActive)
+  const hasContextBar = !!(hasContextPack || hasMemoryLink || hasSourceFilter || linkedTask || resumeHandle || browserActive)
 
   return (
     <>
@@ -523,6 +542,20 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
       {hasContextBar && (
         <div className="border-t border-white/[0.05] bg-black/[0.08] px-4 py-2">
         <div className="flex items-center gap-1.5 flex-wrap">
+          {hasContextPack && (
+            <Tip label="Copy session context pack">
+            <button
+              type="button"
+              onClick={handleCopyContextPack}
+              disabled={contextPackLoading}
+              aria-label="Copy session context pack"
+              className="flex min-w-[122px] items-center justify-center gap-1 px-2.5 py-1 rounded-[8px] bg-white/[0.03] hover:bg-white/[0.06] disabled:opacity-70 disabled:cursor-wait transition-colors cursor-pointer text-[10px] font-600 text-text-3/60 hover:text-text-2 shrink-0"
+            >
+              <ClipboardList className="h-3 w-3 shrink-0" aria-hidden="true" strokeWidth={2.2} />
+              <span>{contextPackLoading ? 'Packing' : contextPackCopied ? 'Copied' : 'Context pack'}</span>
+            </button>
+            </Tip>
+          )}
           {hasMemoryLink && (
             <Tip label="View agent memories">
             <button

package/src/components/runs/run-list.tsx

@@ -1,6 +1,7 @@
 'use client'
 
 import { useEffect, useMemo, useState, useCallback } from 'react'
+import { ClipboardList } from 'lucide-react'
 import { api } from '@/lib/app/api-client'
 import { useNow } from '@/hooks/use-now'
 import { useWs } from '@/hooks/use-ws'
@@ -10,6 +11,7 @@ import type { EvidenceArtifact, RunBrief, RunEventRecord, SessionRunRecord, Sess
 import { PageLoader } from '@/components/ui/page-loader'
 import { formatElapsed } from '@/lib/format-display'
 import { GroundingPanel } from '@/components/knowledge/grounding-panel'
+import { copyTextToClipboard } from '@/lib/clipboard'
 
 const STATUS_COLORS: Record<SessionRunStatus, { bg: string; text: string }> = {
   queued: { bg: 'bg-yellow-500/10', text: 'text-yellow-400' },
@@ -47,6 +49,9 @@ export function RunList() {
   const [eventsLoading, setEventsLoading] = useState(false)
   const [briefLoading, setBriefLoading] = useState(false)
   const [artifactsLoading, setArtifactsLoading] = useState(false)
+  const [handoffCopying, setHandoffCopying] = useState(false)
+  const [handoffCopied, setHandoffCopied] = useState(false)
+  const [handoffError, setHandoffError] = useState<string | null>(null)
 
   const fetchRuns = useCallback(async () => {
     try {
@@ -57,7 +62,6 @@ export function RunList() {
   }, [])
 
   useEffect(() => {
-    // eslint-disable-next-line react-hooks/set-state-in-effect
     fetchRuns()
   }, [fetchRuns])
 
@@ -102,8 +106,30 @@ export function RunList() {
     setEventsLoading(true)
     setBriefLoading(true)
     setArtifactsLoading(true)
+    setHandoffCopied(false)
+    setHandoffError(null)
   }, [])
 
+  const copyRunHandoff = useCallback(async () => {
+    if (!selected || handoffCopying) return
+    setHandoffCopying(true)
+    setHandoffError(null)
+    try {
+      const markdown = await api<string>('GET', `/runs/${selected.id}/handoff?format=markdown`)
+      const copied = await copyTextToClipboard(markdown)
+      if (!copied) {
+        setHandoffError('Clipboard unavailable.')
+        return
+      }
+      setHandoffCopied(true)
+      setTimeout(() => setHandoffCopied(false), 2000)
+    } catch {
+      setHandoffError('Could not copy handoff.')
+    } finally {
+      setHandoffCopying(false)
+    }
+  }, [handoffCopying, selected])
+
   const sources = useMemo(() => {
     return Array.from(new Set(runs.map((run) => run.source).filter(Boolean))).sort((a, b) => a.localeCompare(b))
   }, [runs])
@@ -248,12 +274,24 @@ export function RunList() {
         {selected && (
           <div style={{ animation: 'fade-in 0.3s ease' }}>
             <div className="mb-6">
-              <div className="flex items-center gap-3 mb-3">
-                <span className={`text-[11px] font-700 uppercase tracking-wider px-2.5 py-1 rounded-[6px] ${STATUS_COLORS[selected.status].bg} ${STATUS_COLORS[selected.status].text}`}>
-                  {selected.status}
-                </span>
-                <span className="text-[12px] font-mono text-text-3/60">{selected.source}</span>
+              <div className="mb-3 flex flex-wrap items-center gap-3">
+                <div className="flex min-w-0 items-center gap-3">
+                  <span className={`text-[11px] font-700 uppercase tracking-wider px-2.5 py-1 rounded-[6px] ${STATUS_COLORS[selected.status].bg} ${STATUS_COLORS[selected.status].text}`}>
+                    {selected.status}
+                  </span>
+                  <span className="text-[12px] font-mono text-text-3/60">{selected.source}</span>
+                </div>
+                <button
+                  type="button"
+                  onClick={copyRunHandoff}
+                  disabled={handoffCopying}
+                  className="ml-auto inline-flex items-center gap-1.5 rounded-[8px] border border-white/[0.07] bg-white/[0.04] px-2.5 py-1.5 text-[11px] font-700 text-text-2 transition-colors hover:bg-white/[0.07] disabled:cursor-not-allowed disabled:opacity-60"
+                >
+                  <ClipboardList size={13} />
+                  {handoffCopied ? 'Copied' : handoffCopying ? 'Copying...' : 'Copy Handoff'}
+                </button>
               </div>
+              {handoffError && <p className="mb-3 text-[11px] font-600 text-red-400">{handoffError}</p>}
               <h2 className="font-display text-[20px] font-700 tracking-[-0.02em] mb-2 leading-snug">
                 Run Details
               </h2>

package/src/lib/server/agents/main-agent-loop.test.ts

@@ -307,7 +307,7 @@ describe('main-agent-loop', () => {
           agentId: 'agent-a',
           taskIds: [],
           currentStep: 'Verify the release checklist',
-          plannerSummary: 'Use the mission controller instead of legacy tags.',
+          plannerSummary: 'Use the mission runtime instead of legacy tags.',
           verifierSummary: null,
           blockerSummary: null,
           waitState: null,