@swarmclawai/swarmclaw 1.7.3 → 1.8.1

package/src/lib/server/sharing/share-resolver.test.ts

@@ -0,0 +1,129 @@
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { after, before, describe, it } from 'node:test'
+
+import type { Mission, MissionReport } from '@/types'
+
+const originalEnv = {
+  DATA_DIR: process.env.DATA_DIR,
+  WORKSPACE_DIR: process.env.WORKSPACE_DIR,
+  SWARMCLAW_BUILD_MODE: process.env.SWARMCLAW_BUILD_MODE,
+}
+
+let tempDir = ''
+let repo: typeof import('@/lib/server/missions/mission-repository')
+let resolver: typeof import('./share-resolver')
+
+function makeMission(overrides: Partial<Mission> = {}): Mission {
+  const now = Date.now()
+  return {
+    id: overrides.id ?? 'mi_share_1',
+    title: 'Shared mission',
+    goal: 'Produce a launch report',
+    successCriteria: ['Report exists', 'Evidence is cited'],
+    rootSessionId: 'share_session_1',
+    agentIds: ['agent_1'],
+    status: 'running',
+    budget: {
+      maxUsd: 2,
+      maxTokens: 100_000,
+      maxToolCalls: null,
+      maxWallclockSec: 86_400,
+      maxTurns: 120,
+      warnAtFractions: [0.5, 0.8, 0.95],
+    },
+    usage: {
+      usdSpent: 0.42,
+      tokensUsed: 12_345,
+      toolCallsUsed: 9,
+      turnsRun: 12,
+      wallclockMsElapsed: 900_000,
+      startedAt: now - 900_000,
+      lastUpdatedAt: now,
+      warnFractionsHit: [],
+    },
+    milestones: [
+      {
+        id: 'ms_1',
+        at: now - 1000,
+        kind: 'subgoal_done',
+        summary: 'Release evidence collected',
+        evidence: ['run_1'],
+        sessionId: 'share_session_1',
+        runId: 'run_1',
+      },
+    ],
+    reportSchedule: null,
+    reportConnectorIds: [],
+    createdAt: now - 1_000_000,
+    updatedAt: now,
+    ...overrides,
+  }
+}
+
+function makeReport(missionId: string, overrides: Partial<MissionReport> = {}): MissionReport {
+  const now = Date.now()
+  return {
+    id: overrides.id ?? 'mrep_share_1',
+    missionId,
+    generatedAt: overrides.generatedAt ?? now,
+    format: 'markdown',
+    fromAt: now - 10_000,
+    toAt: now,
+    title: overrides.title ?? 'Shared mission: progress update',
+    body: overrides.body ?? '# Shared mission\n\nEvidence is ready.',
+    deliveredTo: [],
+    highlights: [],
+    ...overrides,
+  }
+}
+
+before(async () => {
+  tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'swarmclaw-share-resolver-'))
+  process.env.DATA_DIR = path.join(tempDir, 'data')
+  process.env.WORKSPACE_DIR = path.join(tempDir, 'workspace')
+  process.env.SWARMCLAW_BUILD_MODE = '1'
+  repo = await import('@/lib/server/missions/mission-repository')
+  resolver = await import('./share-resolver')
+})
+
+after(() => {
+  if (originalEnv.DATA_DIR === undefined) delete process.env.DATA_DIR
+  else process.env.DATA_DIR = originalEnv.DATA_DIR
+  if (originalEnv.WORKSPACE_DIR === undefined) delete process.env.WORKSPACE_DIR
+  else process.env.WORKSPACE_DIR = originalEnv.WORKSPACE_DIR
+  if (originalEnv.SWARMCLAW_BUILD_MODE === undefined) delete process.env.SWARMCLAW_BUILD_MODE
+  else process.env.SWARMCLAW_BUILD_MODE = originalEnv.SWARMCLAW_BUILD_MODE
+  fs.rmSync(tempDir, { recursive: true, force: true })
+})
+
+describe('share-resolver', () => {
+  it('resolves a public mission payload with summary milestones and safe report metadata', () => {
+    const mission = makeMission({ id: 'mi_public_share' })
+    repo.upsertMission(mission)
+    repo.saveMissionReport(makeReport(mission.id, { id: 'mrep_old', generatedAt: mission.createdAt + 1000, title: 'Old report' }))
+    repo.saveMissionReport(makeReport(mission.id, { id: 'mrep_new', generatedAt: mission.createdAt + 2000, title: 'Latest report' }))
+
+    const payload = resolver.resolveSharedEntity({
+      id: 'share_1',
+      token: 'tok',
+      entityType: 'mission',
+      entityId: mission.id,
+      label: null,
+      createdAt: Date.now(),
+      expiresAt: null,
+      revokedAt: null,
+    })
+
+    assert.equal(payload?.kind, 'mission')
+    if (payload?.kind !== 'mission') return
+    assert.equal(payload.milestones[0]?.summary, 'Release evidence collected')
+    assert.equal(Object.hasOwn(payload.milestones[0] ?? {}, 'note'), false)
+    assert.equal(payload.usage.turnsRun, 12)
+    assert.equal(payload.budget.maxUsd, 2)
+    assert.equal(payload.latestReport?.title, 'Latest report')
+    assert.deepEqual(payload.reports.map((r) => r.title), ['Latest report', 'Old report'])
+  })
+})

package/src/lib/server/sharing/share-resolver.ts

@@ -10,8 +10,25 @@ export interface SharedMissionPayload {
   successCriteria: string[]
   status: string
   createdAt: number
-  milestones: Array<{ at: number; note: string; kind: string }>
-  reports: Array<{ at: number; format: string; content: string }>
+  updatedAt: number | null
+  usage: {
+    usdSpent: number
+    tokensUsed: number
+    toolCallsUsed: number
+    turnsRun: number
+    wallclockMsElapsed: number
+    startedAt: number | null
+  }
+  budget: {
+    maxUsd: number | null
+    maxTokens: number | null
+    maxToolCalls: number | null
+    maxWallclockSec: number | null
+    maxTurns: number | null
+  }
+  milestones: Array<{ at: number; summary: string; kind: string; evidence: string[] }>
+  reports: Array<{ id: string; at: number; title: string; format: string; content: string }>
+  latestReport: { id: string; at: number; title: string; format: string; content: string } | null
 }
 
 export interface SharedSkillPayload {
@@ -56,6 +73,8 @@ export function resolveSharedEntity(link: ShareLink): SharedPayload | null {
 function resolveMission(id: string): SharedMissionPayload | null {
   const raw = loadStoredItem('agent_missions', id) as Record<string, unknown> | null
   if (!raw) return null
+  const usageRaw = (raw.usage || {}) as Record<string, unknown>
+  const budgetRaw = (raw.budget || {}) as Record<string, unknown>
   const milestonesRaw = Array.isArray(raw.milestones) ? raw.milestones : []
   const milestones = milestonesRaw
     .slice(-MAX_MILESTONES)
@@ -63,8 +82,15 @@ function resolveMission(id: string): SharedMissionPayload | null {
       const entry = (m || {}) as Record<string, unknown>
       return {
         at: typeof entry.at === 'number' ? entry.at : 0,
-        note: typeof entry.note === 'string' ? entry.note : '',
+        summary: typeof entry.summary === 'string'
+          ? entry.summary
+          : typeof entry.note === 'string'
+            ? entry.note
+            : '',
         kind: typeof entry.kind === 'string' ? entry.kind : 'note',
+        evidence: Array.isArray(entry.evidence)
+          ? entry.evidence.filter((x): x is string => typeof x === 'string')
+          : [],
       }
     })
 
@@ -72,7 +98,9 @@ function resolveMission(id: string): SharedMissionPayload | null {
   try {
     const rows = listMissionReports(id, MAX_REPORTS)
     reports = rows.map((r) => ({
+      id: r.id,
       at: r.generatedAt,
+      title: r.title,
       format: String(r.format),
       content: r.body,
     }))
@@ -90,8 +118,25 @@ function resolveMission(id: string): SharedMissionPayload | null {
       : [],
     status: typeof raw.status === 'string' ? raw.status : 'unknown',
     createdAt: typeof raw.createdAt === 'number' ? raw.createdAt : 0,
+    updatedAt: typeof raw.updatedAt === 'number' ? raw.updatedAt : null,
+    usage: {
+      usdSpent: typeof usageRaw.usdSpent === 'number' ? usageRaw.usdSpent : 0,
+      tokensUsed: typeof usageRaw.tokensUsed === 'number' ? usageRaw.tokensUsed : 0,
+      toolCallsUsed: typeof usageRaw.toolCallsUsed === 'number' ? usageRaw.toolCallsUsed : 0,
+      turnsRun: typeof usageRaw.turnsRun === 'number' ? usageRaw.turnsRun : 0,
+      wallclockMsElapsed: typeof usageRaw.wallclockMsElapsed === 'number' ? usageRaw.wallclockMsElapsed : 0,
+      startedAt: typeof usageRaw.startedAt === 'number' ? usageRaw.startedAt : null,
+    },
+    budget: {
+      maxUsd: typeof budgetRaw.maxUsd === 'number' ? budgetRaw.maxUsd : null,
+      maxTokens: typeof budgetRaw.maxTokens === 'number' ? budgetRaw.maxTokens : null,
+      maxToolCalls: typeof budgetRaw.maxToolCalls === 'number' ? budgetRaw.maxToolCalls : null,
+      maxWallclockSec: typeof budgetRaw.maxWallclockSec === 'number' ? budgetRaw.maxWallclockSec : null,
+      maxTurns: typeof budgetRaw.maxTurns === 'number' ? budgetRaw.maxTurns : null,
+    },
     milestones,
     reports,
+    latestReport: reports[0] ?? null,
   }
 }
 

package/src/types/artifact.ts

@@ -0,0 +1,28 @@
+export type EvidenceArtifactKind =
+  | 'task_artifact'
+  | 'task_output'
+  | 'completion_report'
+  | 'task_result'
+  | 'protocol_artifact'
+  | 'mission_report'
+  | 'share_link'
+  | 'mission_milestone'
+  | 'run_result'
+  | 'run_error'
+  | 'run_citation'
+
+export interface EvidenceArtifact {
+  id: string
+  kind: EvidenceArtifactKind
+  title: string
+  description?: string | null
+  url?: string | null
+  href?: string | null
+  preview?: string | null
+  createdAt?: number | null
+  source: {
+    type: 'run' | 'mission' | 'task' | 'protocol' | 'share'
+    id: string
+    label?: string | null
+  }
+}

package/src/types/index.ts

@@ -15,6 +15,9 @@ export * from './approval'
 export * from './misc'
 export * from './goal'
 export * from './mission'
+export * from './operations'
+export * from './run-brief'
+export * from './artifact'
 export * from './swarmdock'
 export * from './dream'
 export * from './swarmfeed'

package/src/types/operations.ts

@@ -0,0 +1,39 @@
+export type OperationPulseRange = '24h' | '7d'
+
+export type OperationPulseSeverity = 'low' | 'medium' | 'high'
+
+export type OperationPulseActionKind =
+  | 'mission'
+  | 'run'
+  | 'approval'
+  | 'connector'
+  | 'budget'
+  | 'quality'
+
+export interface OperationPulseKpis {
+  activeMissions: number
+  runningRuns: number
+  failedRuns: number
+  pendingApprovals: number
+  connectorAttention: number
+  budgetWarnings: number
+}
+
+export interface OperationPulseAction {
+  id: string
+  kind: OperationPulseActionKind
+  severity: OperationPulseSeverity
+  title: string
+  summary: string
+  href: string
+  evidence: string[]
+  createdAt: number | null
+}
+
+export interface OperationPulse {
+  generatedAt: number
+  range: OperationPulseRange
+  windowStart: number
+  kpis: OperationPulseKpis
+  actions: OperationPulseAction[]
+}

package/src/types/run-brief.ts

@@ -0,0 +1,41 @@
+import type { ExecutionOwnerType, SessionRunStatus } from './run'
+
+export interface RunBriefTimelineItem {
+  label: string
+  status?: SessionRunStatus
+  at: number
+  detail?: string | null
+}
+
+export interface RunBriefEvidenceItem {
+  id: string
+  kind: 'citation' | 'retrieval' | 'event'
+  title: string
+  summary: string
+  url?: string | null
+  sourceId?: string | null
+  createdAt?: number | null
+}
+
+export interface RunBrief {
+  runId: string
+  sessionId: string
+  title: string
+  objective: string
+  status: SessionRunStatus
+  source: string
+  owner: { type: ExecutionOwnerType; id: string } | null
+  timeline: RunBriefTimelineItem[]
+  result: string | null
+  error: string | null
+  warnings: string[]
+  usage: {
+    inputTokens: number | null
+    outputTokens: number | null
+    estimatedCost: number | null
+    citationCount: number
+    sourceIds: string[]
+  }
+  evidence: RunBriefEvidenceItem[]
+  generatedAt: number
+}