@xopcai/xopc 0.0.114 → 0.0.116

package/dist/src/gateway/hono/routes/goals.js.map

@@ -1 +1 @@
-{"version":3,"file":"goals.js","names":[],"sources":["../../../../../src/gateway/hono/routes/goals.ts"],"sourcesContent":["import type { Hono } from 'hono';\n\nimport { createWorkflowCatalog } from '../../../agent/workflow/catalog.js';\nimport {\n  GoalService,\n  normalizeGoalUiLocale,\n  type GoalChecklistItem,\n  type GoalEvent,\n  type GoalEvidence,\n  type GoalQueueItemSnapshot,\n  type GoalRun,\n  type GoalStatus,\n} from '../../../goals/index.js';\nimport { buildSessionKey, sanitizeSegment } from '../../../routing/session-key.js';\nimport { getDefaultAgentId } from '../../../routing/resolve-route.js';\nimport type { WorkflowRunSummary } from '../../../workflows/domain/index.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nfunction parseLimit(raw: string | undefined, fallback = 50): number {\n  if (!raw) return fallback;\n  const n = Number.parseInt(raw, 10);\n  return Number.isFinite(n) ? Math.min(500, Math.max(1, n)) : fallback;\n}\n\nfunction parseStatuses(raw: string | undefined): GoalStatus[] | undefined {\n  if (!raw?.trim()) return undefined;\n  const statuses = raw\n    .split(',')\n    .map((s) => s.trim())\n    .filter((s): s is GoalStatus =>\n      s === 'active' ||\n      s === 'paused' ||\n      s === 'blocked' ||\n      s === 'needs_input' ||\n      s === 'done' ||\n      s === 'archived',\n    );\n  return statuses.length ? statuses : undefined;\n}\n\nfunction parseBodyGoalStatus(raw: unknown): GoalStatus | null {\n  return raw === 'active' ||\n    raw === 'paused' ||\n    raw === 'blocked' ||\n    raw === 'needs_input' ||\n    raw === 'done' ||\n    raw === 'archived'\n    ? raw\n    : null;\n}\n\nfunction parsePriority(raw: unknown): 'low' | 'normal' | 'high' | undefined {\n  return raw === 'low' || raw === 'normal' || raw === 'high' ? raw : undefined;\n}\n\ntype GoalActivityItem = {\n  id: string;\n  kind: 'queue' | 'goal_run' | 'workflow_run' | 'event' | 'evidence';\n  status?: string;\n  title: string;\n  summary?: string;\n  createdAt: number;\n  link?: { type: 'chat' | 'workflow_run'; value: string };\n  data?: unknown;\n};\n\ntype GoalWorkflowSuggestion = {\n  definitionId: string;\n  name: string;\n  title: string;\n  description: string;\n  score: number;\n  reasons: string[];\n  tags: string[];\n  successRate?: number;\n  lastRunStatus?: WorkflowRunSummary['status'];\n};\n\nconst STOP_WORDS = new Set([\n  'a',\n  'an',\n  'and',\n  'are',\n  'as',\n  'for',\n  'in',\n  'is',\n  'of',\n  'on',\n  'or',\n  'the',\n  'to',\n  'with',\n  '一个',\n  '这个',\n  '需要',\n  '进行',\n  '推进',\n]);\n\nfunction tokenizeForWorkflowMatch(text: string): string[] {\n  const normalized = text.toLowerCase();\n  const tokens = normalized.match(/[\\p{L}\\p{N}_-]+/gu) ?? [];\n  return tokens\n    .map((token) => token.trim())\n    .filter((token) => token.length >= 2 && !STOP_WORDS.has(token));\n}\n\nfunction goalSearchText(goal: NonNullable<ReturnType<GoalService['get']>>): string {\n  return [\n    goal.title,\n    goal.description,\n    goal.nextAction,\n    goal.blockedReason,\n    ...goal.checklist.map((item: GoalChecklistItem) => `${item.text} ${item.evidenceSummary ?? ''}`),\n  ].filter(Boolean).join('\\n');\n}\n\nfunction buildGoalWorkflowSuggestions(params: {\n  goal: NonNullable<ReturnType<GoalService['get']>>;\n  workflowRuns: WorkflowRunSummary[];\n}): GoalWorkflowSuggestion[] {\n  const goalTokens = new Set(tokenizeForWorkflowMatch(goalSearchText(params.goal)));\n  const runsByDefinition = new Map<string, WorkflowRunSummary[]>();\n  for (const run of params.workflowRuns) {\n    const list = runsByDefinition.get(run.definitionId) ?? [];\n    list.push(run);\n    runsByDefinition.set(run.definitionId, list);\n  }\n\n  const suggestions: GoalWorkflowSuggestion[] = [];\n  for (const entry of createWorkflowCatalog().list()) {\n    const candidateText = [\n      entry.name,\n      entry.title,\n      entry.description,\n      entry.whenToUse,\n      ...(entry.tags ?? []),\n    ].filter(Boolean).join('\\n');\n    const candidateTokens = new Set(tokenizeForWorkflowMatch(candidateText));\n    const matched = [...goalTokens].filter((token) => candidateTokens.has(token));\n    const relatedRuns = runsByDefinition.get(entry.name) ?? [];\n    const terminalRuns = relatedRuns.filter((run) => run.status !== 'queued' && run.status !== 'running');\n    const succeededRuns = terminalRuns.filter((run) => run.status === 'succeeded');\n    const successRate = terminalRuns.length ? succeededRuns.length / terminalRuns.length : undefined;\n    const lastRun = relatedRuns.toSorted((left, right) => right.createdAtMs - left.createdAtMs)[0];\n\n    let score = matched.length * 8;\n    if (entry.tags?.some((tag) => goalTokens.has(tag.toLowerCase()))) score += 8;\n    if (entry.whenToUse && matched.length > 0) score += 4;\n    if (successRate != null) score += Math.round(successRate * 10);\n    if (lastRun?.status === 'succeeded') score += 4;\n    if (lastRun?.status === 'failed' || lastRun?.status === 'timeout') score -= 3;\n    if (score <= 0) score = entry.source === 'builtin' ? 1 : 0;\n\n    const reasons: string[] = [];\n    if (matched.length) reasons.push(`matches ${matched.slice(0, 4).join(', ')}`);\n    if (successRate != null) reasons.push(`${Math.round(successRate * 100)}% success rate`);\n    if (lastRun) reasons.push(`last run ${lastRun.status}`);\n    if (!reasons.length && entry.whenToUse) reasons.push('general workflow fit');\n\n    if (score > 0) {\n      suggestions.push({\n        definitionId: entry.name,\n        name: entry.name,\n        title: entry.title || entry.name,\n        description: entry.description,\n        score,\n        reasons,\n        tags: entry.tags ?? [],\n        successRate,\n        lastRunStatus: lastRun?.status,\n      });\n    }\n  }\n\n  return suggestions\n    .sort((left, right) => right.score - left.score || left.name.localeCompare(right.name))\n    .slice(0, 5);\n}\n\nfunction buildGoalActivities(input: {\n  goalId: string;\n  queue: GoalQueueItemSnapshot[];\n  runs: GoalRun[];\n  workflowRuns: WorkflowRunSummary[];\n  events: GoalEvent[];\n  evidence: GoalEvidence[];\n  limit: number;\n}): GoalActivityItem[] {\n  const activities: GoalActivityItem[] = [];\n\n  for (const item of input.queue.filter((queueItem) => queueItem.goalId === input.goalId)) {\n    activities.push({\n      id: `queue:${item.id}`,\n      kind: 'queue',\n      status: item.status,\n      title: 'Goal queued',\n      summary: item.lastError || item.message || undefined,\n      createdAt: item.finishedAt ?? item.startedAt ?? item.nextRunAt ?? item.enqueuedAt,\n      link: item.sessionKey ? { type: 'chat', value: item.sessionKey } : undefined,\n      data: item,\n    });\n  }\n\n  for (const run of input.runs) {\n    activities.push({\n      id: `goal_run:${run.id}`,\n      kind: 'goal_run',\n      status: run.verdict ?? run.status,\n      title: 'Goal run judged',\n      summary: run.reason || run.assistantPreview || run.nextAction,\n      createdAt: run.finishedAt ?? run.startedAt,\n      data: run,\n    });\n  }\n\n  for (const run of input.workflowRuns) {\n    activities.push({\n      id: `workflow_run:${run.id}`,\n      kind: 'workflow_run',\n      status: run.status,\n      title: run.title || run.definitionId,\n      summary: run.definitionId,\n      createdAt: run.completedAtMs ?? run.startedAtMs ?? run.createdAtMs,\n      link: { type: 'workflow_run', value: run.id },\n      data: run,\n    });\n  }\n\n  for (const event of input.events) {\n    activities.push({\n      id: `event:${event.id}`,\n      kind: 'event',\n      status: event.kind,\n      title: event.kind,\n      summary: event.message,\n      createdAt: event.createdAt,\n      data: event,\n    });\n  }\n\n  for (const item of input.evidence) {\n    activities.push({\n      id: `evidence:${item.id}`,\n      kind: 'evidence',\n      status: item.kind,\n      title: item.title,\n      summary: item.summary || item.uri,\n      createdAt: item.createdAt,\n      data: item,\n    });\n  }\n\n  return activities\n    .sort((left, right) => right.createdAt - left.createdAt)\n    .slice(0, input.limit);\n}\n\nfunction abortActiveWebchatRunForGoal(\n  deps: AuthenticatedRouteDeps,\n  goal: NonNullable<ReturnType<GoalService['get']>>,\n): { aborted?: boolean; abortedRunId?: string } {\n  const sessionKey = goal.activeSessionKey?.trim();\n  if (!sessionKey) return {};\n  const runId = deps.service.getActiveWebchatRunId(sessionKey);\n  if (!runId) return {};\n  return {\n    abortedRunId: runId,\n    aborted: deps.service.abortAgentRun(runId),\n  };\n}\n\n/** First-class Goal API. Sessions are execution context; goals are durable product objects. */\nexport function registerGoalsRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const goals = new GoalService();\n  const cfg = () => deps.service.currentConfig;\n  const workflowRunService = deps.service.createWorkflowRunService();\n\n  authenticated.get('/api/goals/current', async (c) => {\n    const sessionKey = c.req.query('sessionKey')?.trim();\n    if (!sessionKey) return c.json({ ok: false, error: 'Missing sessionKey' }, 400);\n    return c.json({ ok: true, goal: goals.getActiveForSession(sessionKey) });\n  });\n\n  authenticated.get('/api/goals', async (c) => {\n    const status = parseStatuses(c.req.query('status'));\n    const agentId = c.req.query('agentId')?.trim() || undefined;\n    const sessionKey = c.req.query('sessionKey')?.trim() || undefined;\n    const limit = parseLimit(c.req.query('limit'));\n    const offsetRaw = c.req.query('offset')?.trim();\n    const offset = offsetRaw ? Math.max(0, Number.parseInt(offsetRaw, 10) || 0) : 0;\n    return c.json({ ok: true, goals: goals.list({ status, agentId, sessionKey, limit, offset }) });\n  });\n\n  authenticated.get('/api/goals/queue', async (c) => {\n    return c.json({ ok: true, queue: deps.service.getGoalQueueSnapshot() });\n  });\n\n  authenticated.post('/api/goals', async (c) => {\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const title = typeof body.title === 'string' ? body.title.trim() : '';\n    if (!title) return c.json({ ok: false, error: 'Missing title' }, 400);\n\n    const sessionKey = typeof body.sessionKey === 'string' && body.sessionKey.trim() ? body.sessionKey.trim() : undefined;\n    const agentId =\n      typeof body.agentId === 'string' && body.agentId.trim()\n        ? body.agentId.trim()\n        : sessionKey\n          ? undefined\n          : getDefaultAgentId(cfg());\n    const maxTurns =\n      typeof body.maxTurns === 'number' && Number.isFinite(body.maxTurns)\n        ? Math.max(1, Math.min(500, Math.floor(body.maxTurns)))\n        : undefined;\n    const goal = goals.create({\n      title,\n      description: typeof body.description === 'string' ? body.description : undefined,\n      sessionKey,\n      agentId,\n      priority: body.priority === 'low' || body.priority === 'high' ? body.priority : 'normal',\n      deadlineAt: typeof body.deadlineAt === 'number' && Number.isFinite(body.deadlineAt) ? body.deadlineAt : undefined,\n      judgeModelRef: typeof body.judgeModelRef === 'string' ? body.judgeModelRef : undefined,\n      maxTurns,\n      uiLocale: normalizeGoalUiLocale(body.uiLocale),\n      source: body.source === 'cli' || body.source === 'cron' || body.source === 'workflow' || body.source === 'channel' || body.source === 'api'\n        ? body.source\n        : 'chat',\n      config: cfg(),\n    });\n\n    if (sessionKey) {\n      deps.service.enqueueWebchatPersistentGoalKickoff(sessionKey, title);\n    }\n\n    return c.json({ ok: true, goal: goals.get(goal.id) });\n  });\n\n  authenticated.get('/api/goals/:goalId/workflow-runs', async (c) => {\n    const goalId = c.req.param('goalId');\n    const goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const runStore = workflowRunService.createRunStore(goal.agentId || getDefaultAgentId(cfg()));\n    const runs = await runStore.listRunSummariesForGoal(goalId, parseLimit(c.req.query('limit')));\n    return c.json({ ok: true, runs });\n  });\n\n  authenticated.post('/api/goals/:goalId/workflows/run', async (c) => {\n    const goalId = c.req.param('goalId');\n    const goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (goal.status === 'done' || goal.status === 'archived') {\n      return c.json({ ok: false, error: `Goal is ${goal.status}` }, 409);\n    }\n\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const definitionId = typeof body.definitionId === 'string' ? body.definitionId.trim() : '';\n    if (!definitionId) return c.json({ ok: false, error: 'Missing definitionId' }, 400);\n\n    try {\n      createWorkflowCatalog().load(definitionId);\n    } catch {\n      return c.json({ ok: false, error: 'Workflow definition not found' }, 404);\n    }\n\n    const result = await workflowRunService.startWorkflowRun({\n      agentId: goal.agentId || getDefaultAgentId(cfg()),\n      definitionId,\n      goalId,\n      goal: typeof body.goal === 'string' && body.goal.trim() ? body.goal.trim() : goal.nextAction || goal.title,\n      input: body.input ?? {\n        goal: goal.title,\n        description: goal.description,\n        nextAction: goal.nextAction,\n        checklist: goal.checklist.map((item) => ({\n          text: item.text,\n          status: item.status,\n          evidenceSummary: item.evidenceSummary,\n        })),\n      },\n      parentSessionKey: goal.activeSessionKey,\n      source: { kind: 'webui' },\n      concurrency: typeof body.concurrency === 'number' ? body.concurrency : undefined,\n      maxSubagents: typeof body.maxSubagents === 'number' ? body.maxSubagents : undefined,\n    });\n    if (result.ok === false) {\n      return c.json({ ok: false, error: result.message, code: result.code }, result.httpStatus);\n    }\n    return c.json({ ok: true, runId: result.runId, sessionKey: result.sessionKey }, 202);\n  });\n\n  authenticated.get('/api/goals/:goalId/activity', async (c) => {\n    const goalId = c.req.param('goalId');\n    const goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n\n    const limit = parseLimit(c.req.query('limit'), 100);\n    const runStore = workflowRunService.createRunStore(goal.agentId || getDefaultAgentId(cfg()));\n    const workflowRuns = await runStore.listRunSummariesForGoal(goalId, limit);\n    const activities = buildGoalActivities({\n      goalId,\n      queue: deps.service.getGoalQueueSnapshot(),\n      runs: goals.listRuns(goalId, limit),\n      workflowRuns,\n      events: goals.listEvents(goalId, limit),\n      evidence: goals.listEvidence(goalId, limit),\n      limit,\n    });\n    return c.json({ ok: true, activities });\n  });\n\n  authenticated.get('/api/goals/:goalId/workflow-suggestions', async (c) => {\n    const goalId = c.req.param('goalId');\n    const goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n\n    const runStore = workflowRunService.createRunStore(goal.agentId || getDefaultAgentId(cfg()));\n    const workflowRuns = await runStore.listRunSummaries(500);\n    return c.json({\n      ok: true,\n      suggestions: buildGoalWorkflowSuggestions({ goal, workflowRuns }),\n    });\n  });\n\n  authenticated.get('/api/goals/:goalId', async (c) => {\n    const goal = goals.get(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.patch('/api/goals/:goalId', async (c) => {\n    const goalId = c.req.param('goalId');\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const status = parseBodyGoalStatus(body.status);\n    let goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const patch: Parameters<GoalService['update']>[1] = {};\n    if (typeof body.title === 'string') patch.title = body.title;\n    if ('description' in body) patch.description = typeof body.description === 'string' ? body.description : undefined;\n    const priority = parsePriority(body.priority);\n    if (priority) patch.priority = priority;\n    if ('deadlineAt' in body) {\n      patch.deadlineAt = typeof body.deadlineAt === 'number' && Number.isFinite(body.deadlineAt) ? body.deadlineAt : undefined;\n    }\n    if (typeof body.maxTurns === 'number' && Number.isFinite(body.maxTurns)) patch.maxTurns = body.maxTurns;\n    if ('judgeModelRef' in body) patch.judgeModelRef = typeof body.judgeModelRef === 'string' ? body.judgeModelRef : undefined;\n    if ('nextAction' in body) patch.nextAction = typeof body.nextAction === 'string' ? body.nextAction : undefined;\n    if ('blockedReason' in body) patch.blockedReason = typeof body.blockedReason === 'string' ? body.blockedReason : undefined;\n    const locale = normalizeGoalUiLocale(body.uiLocale);\n    if (locale) patch.uiLocale = locale;\n    if (Object.keys(patch).length > 0) {\n      goal = goals.update(goalId, patch);\n    }\n    if (status) {\n      const previousStatus = goal?.status;\n      goal = goals.setStatus(goalId, status, {\n        reason: typeof body.reason === 'string' ? body.reason : undefined,\n      });\n      const abortResult = goal && status === 'archived' ? abortActiveWebchatRunForGoal(deps, goal) : {};\n      if (goal && previousStatus !== goal.status) {\n        deps.service.emit('goal.status.updated', {\n          goalId,\n          previousStatus,\n          status: goal.status,\n          goal,\n        });\n      }\n      return c.json({ ok: true, goal, ...abortResult });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/continue', async (c) => {\n    const goalId = c.req.param('goalId');\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    let sessionKey =\n      typeof body.sessionKey === 'string' && body.sessionKey.trim()\n        ? body.sessionKey.trim()\n        : goal.activeSessionKey;\n\n    if (!sessionKey) {\n      const agentId = goal.agentId || getDefaultAgentId(cfg());\n      const peerId = `goal-${sanitizeSegment(goal.id) || Date.now()}`;\n      sessionKey = buildSessionKey({\n        agentId,\n        source: 'webchat',\n        accountId: 'default',\n        peerKind: 'direct',\n        peerId,\n      });\n      await deps.service.sessionIndexInstance.saveMessages(sessionKey, [], {\n        metadata: {\n          sourceChannel: 'webchat',\n          sourceChatId: `default:direct:${peerId}`,\n          sessionType: 'chat',\n          routing: {\n            agentId,\n            source: 'webchat',\n            accountId: 'default',\n            peerKind: 'direct',\n            peerId,\n          },\n        },\n      });\n      goals.attachSession(goalId, sessionKey);\n    }\n\n    const queued = deps.service.enqueueGoalRun(goalId, {\n      message: typeof body.message === 'string' ? body.message : undefined,\n      maxRetries: typeof body.maxRetries === 'number' && Number.isFinite(body.maxRetries) ? body.maxRetries : undefined,\n      source: 'api',\n    });\n    const nextGoal = goals.get(goalId);\n    return c.json({ ok: true, goal: nextGoal, sessionKey, queued });\n  });\n\n  authenticated.post('/api/goals/:goalId/enqueue', async (c) => {\n    const goalId = c.req.param('goalId');\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const item = deps.service.enqueueGoalRun(goalId, {\n      message: typeof body.message === 'string' ? body.message : undefined,\n      maxRetries: typeof body.maxRetries === 'number' && Number.isFinite(body.maxRetries) ? body.maxRetries : undefined,\n      source: 'api',\n    });\n    return c.json({ ok: true, item });\n  });\n\n  authenticated.post('/api/goals/:goalId/pause', async (c) => {\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.pause(\n      c.req.param('goalId'),\n      typeof body.reason === 'string' && body.reason.trim() ? body.reason.trim() : 'user-paused',\n    );\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/resume', async (c) => {\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.resume(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/reopen', async (c) => {\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.reopen(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/complete', async (c) => {\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.complete(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/archive', async (c) => {\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.archive(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const abortResult = abortActiveWebchatRunForGoal(deps, goal);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal, ...abortResult });\n  });\n\n  authenticated.post('/api/goals/:goalId/unarchive', async (c) => {\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.unarchive(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/attach', async (c) => {\n    const goalId = c.req.param('goalId');\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const sessionKey = typeof body.sessionKey === 'string' ? body.sessionKey.trim() : '';\n    if (!sessionKey) return c.json({ ok: false, error: 'Missing sessionKey' }, 400);\n    const goal = goals.attachSession(goalId, sessionKey);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/detach', async (c) => {\n    const goal = goals.update(c.req.param('goalId'), { activeSessionKey: undefined });\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.get('/api/goals/:goalId/runs', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, runs: goals.listRuns(goalId, parseLimit(c.req.query('limit'))) });\n  });\n\n  authenticated.get('/api/goals/:goalId/events', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, events: goals.listEvents(goalId, parseLimit(c.req.query('limit'), 100)) });\n  });\n\n  authenticated.get('/api/goals/:goalId/evidence', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, evidence: goals.listEvidence(goalId, parseLimit(c.req.query('limit'), 100)) });\n  });\n\n  authenticated.post('/api/goals/:goalId/evidence', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const title = typeof body.title === 'string' ? body.title.trim() : '';\n    const kind = body.kind;\n    if (!title) return c.json({ ok: false, error: 'Missing title' }, 400);\n    if (kind !== 'file' && kind !== 'diff' && kind !== 'command' && kind !== 'test' && kind !== 'link' && kind !== 'message' && kind !== 'artifact') {\n      return c.json({ ok: false, error: 'Invalid evidence kind' }, 400);\n    }\n    const evidence = goals.addEvidence({\n      goalId,\n      runId: typeof body.runId === 'string' ? body.runId : undefined,\n      kind,\n      title,\n      summary: typeof body.summary === 'string' ? body.summary : undefined,\n      uri: typeof body.uri === 'string' ? body.uri : undefined,\n      data: body.data,\n    });\n    return c.json({ ok: true, evidence });\n  });\n\n  authenticated.post('/api/goals/:goalId/checklist', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const text = typeof body.text === 'string' ? body.text.trim() : '';\n    if (!text) return c.json({ ok: false, error: 'Missing text' }, 400);\n    const goal = goals.updateChecklist(goalId, { type: 'add', text, addedBy: 'user' });\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.patch('/api/goals/:goalId/checklist/:itemId', async (c) => {\n    const goalId = c.req.param('goalId');\n    const itemId = c.req.param('itemId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const status = body.status;\n    if (status !== 'pending' && status !== 'completed' && status !== 'impossible') {\n      return c.json({ ok: false, error: 'Invalid checklist status' }, 400);\n    }\n    const goal = goals.updateChecklist(goalId, {\n      type: 'mark',\n      itemId,\n      status,\n      evidenceSummary: typeof body.evidenceSummary === 'string' ? body.evidenceSummary : undefined,\n    });\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.delete('/api/goals/:goalId/checklist/:itemId', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const goal = goals.updateChecklist(goalId, { type: 'remove', itemId: c.req.param('itemId') });\n    return c.json({ ok: true, goal });\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"goals.js","names":[],"sources":["../../../../../src/gateway/hono/routes/goals.ts"],"sourcesContent":["import type { Hono } from 'hono';\n\nimport { createWorkflowCatalog } from '../../../agent/workflow/catalog.js';\nimport {\n  GoalService,\n  normalizeGoalUiLocale,\n  type GoalChecklistItem,\n  type GoalEvent,\n  type GoalEvidence,\n  type GoalQueueItemSnapshot,\n  type GoalRun,\n  type GoalStatus,\n} from '../../../goals/index.js';\nimport { buildSessionKey, sanitizeSegment } from '../../../routing/session-key.js';\nimport { getDefaultAgentId } from '../../../routing/resolve-route.js';\nimport type { WorkflowRunSummary } from '../../../workflows/domain/index.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\nimport { MAX_CHAT_ATTACHMENTS, MAX_WEBCHAT_ATTACHMENT_FILE_BYTES } from '../../chat-limits.js';\nimport type { UserTurnAttachment, UserTurnInput } from '../../user-turn-input.js';\n\nfunction parseLimit(raw: string | undefined, fallback = 50): number {\n  if (!raw) return fallback;\n  const n = Number.parseInt(raw, 10);\n  return Number.isFinite(n) ? Math.min(500, Math.max(1, n)) : fallback;\n}\n\nfunction parseStatuses(raw: string | undefined): GoalStatus[] | undefined {\n  if (!raw?.trim()) return undefined;\n  const statuses = raw\n    .split(',')\n    .map((s) => s.trim())\n    .filter((s): s is GoalStatus =>\n      s === 'active' ||\n      s === 'paused' ||\n      s === 'blocked' ||\n      s === 'needs_input' ||\n      s === 'done' ||\n      s === 'archived',\n    );\n  return statuses.length ? statuses : undefined;\n}\n\nfunction parseBodyGoalStatus(raw: unknown): GoalStatus | null {\n  return raw === 'active' ||\n    raw === 'paused' ||\n    raw === 'blocked' ||\n    raw === 'needs_input' ||\n    raw === 'done' ||\n    raw === 'archived'\n    ? raw\n    : null;\n}\n\nfunction parsePriority(raw: unknown): 'low' | 'normal' | 'high' | undefined {\n  return raw === 'low' || raw === 'normal' || raw === 'high' ? raw : undefined;\n}\n\nfunction maxBase64CharsForBinary(maxBinaryBytes: number): number {\n  return 4 * Math.ceil(maxBinaryBytes / 3);\n}\n\nfunction parseUserTurnAttachment(raw: unknown): UserTurnAttachment | null {\n  if (!raw || typeof raw !== 'object') return null;\n  const value = raw as Record<string, unknown>;\n  const type = typeof value.type === 'string' && value.type.trim() ? value.type.trim() : 'file';\n  const out: UserTurnAttachment = { type };\n  if (typeof value.id === 'string' && value.id.trim()) out.id = value.id.trim();\n  if (typeof value.mimeType === 'string' && value.mimeType.trim()) out.mimeType = value.mimeType.trim();\n  if (typeof value.data === 'string' && value.data.trim()) out.data = value.data;\n  if (typeof value.uri === 'string' && value.uri.trim()) out.uri = value.uri.trim();\n  if (typeof value.name === 'string' && value.name.trim()) out.name = value.name.trim();\n  if (typeof value.size === 'number' && Number.isFinite(value.size)) out.size = Math.max(0, Math.floor(value.size));\n  if (typeof value.workspaceRelativePath === 'string' && value.workspaceRelativePath.trim()) {\n    out.workspaceRelativePath = value.workspaceRelativePath.trim();\n  }\n  if (typeof value.durationSeconds === 'number' && Number.isFinite(value.durationSeconds)) {\n    out.durationSeconds = value.durationSeconds;\n  }\n  return out.data || out.uri ? out : null;\n}\n\nfunction parseUserTurnInput(raw: unknown): UserTurnInput | undefined {\n  if (!raw || typeof raw !== 'object') return undefined;\n  const value = raw as Record<string, unknown>;\n  const text = typeof value.text === 'string' ? value.text.trim() : '';\n  const attachments = Array.isArray(value.attachments)\n    ? value.attachments.map(parseUserTurnAttachment).filter((item): item is UserTurnAttachment => item !== null)\n    : undefined;\n  if (!text && !attachments?.length) return undefined;\n  return { text, ...(attachments?.length ? { attachments } : {}) };\n}\n\nfunction validateUserTurnAttachments(attachments: UserTurnAttachment[] | undefined): string | null {\n  if (!attachments?.length) return null;\n  if (attachments.length > MAX_CHAT_ATTACHMENTS) {\n    return `Too many attachments (max ${MAX_CHAT_ATTACHMENTS})`;\n  }\n  const maxDataChars = maxBase64CharsForBinary(MAX_WEBCHAT_ATTACHMENT_FILE_BYTES);\n  for (const attachment of attachments) {\n    if (attachment.data && attachment.data.length > maxDataChars) {\n      return `Attachment exceeds maximum size (${MAX_WEBCHAT_ATTACHMENT_FILE_BYTES} bytes)`;\n    }\n  }\n  return null;\n}\n\ntype GoalActivityItem = {\n  id: string;\n  kind: 'queue' | 'goal_run' | 'workflow_run' | 'event' | 'evidence';\n  status?: string;\n  title: string;\n  summary?: string;\n  createdAt: number;\n  link?: { type: 'chat' | 'workflow_run'; value: string };\n  data?: unknown;\n};\n\ntype GoalWorkflowSuggestion = {\n  definitionId: string;\n  name: string;\n  title: string;\n  description: string;\n  score: number;\n  reasons: string[];\n  tags: string[];\n  successRate?: number;\n  lastRunStatus?: WorkflowRunSummary['status'];\n};\n\nconst STOP_WORDS = new Set([\n  'a',\n  'an',\n  'and',\n  'are',\n  'as',\n  'for',\n  'in',\n  'is',\n  'of',\n  'on',\n  'or',\n  'the',\n  'to',\n  'with',\n  '一个',\n  '这个',\n  '需要',\n  '进行',\n  '推进',\n]);\n\nfunction tokenizeForWorkflowMatch(text: string): string[] {\n  const normalized = text.toLowerCase();\n  const tokens = normalized.match(/[\\p{L}\\p{N}_-]+/gu) ?? [];\n  return tokens\n    .map((token) => token.trim())\n    .filter((token) => token.length >= 2 && !STOP_WORDS.has(token));\n}\n\nfunction goalSearchText(goal: NonNullable<ReturnType<GoalService['get']>>): string {\n  return [\n    goal.title,\n    goal.description,\n    goal.nextAction,\n    goal.blockedReason,\n    ...goal.checklist.map((item: GoalChecklistItem) => `${item.text} ${item.evidenceSummary ?? ''}`),\n  ].filter(Boolean).join('\\n');\n}\n\nfunction buildGoalWorkflowSuggestions(params: {\n  goal: NonNullable<ReturnType<GoalService['get']>>;\n  workflowRuns: WorkflowRunSummary[];\n}): GoalWorkflowSuggestion[] {\n  const goalTokens = new Set(tokenizeForWorkflowMatch(goalSearchText(params.goal)));\n  const runsByDefinition = new Map<string, WorkflowRunSummary[]>();\n  for (const run of params.workflowRuns) {\n    const list = runsByDefinition.get(run.definitionId) ?? [];\n    list.push(run);\n    runsByDefinition.set(run.definitionId, list);\n  }\n\n  const suggestions: GoalWorkflowSuggestion[] = [];\n  for (const entry of createWorkflowCatalog().list()) {\n    const candidateText = [\n      entry.name,\n      entry.title,\n      entry.description,\n      entry.whenToUse,\n      ...(entry.tags ?? []),\n    ].filter(Boolean).join('\\n');\n    const candidateTokens = new Set(tokenizeForWorkflowMatch(candidateText));\n    const matched = [...goalTokens].filter((token) => candidateTokens.has(token));\n    const relatedRuns = runsByDefinition.get(entry.name) ?? [];\n    const terminalRuns = relatedRuns.filter((run) => run.status !== 'queued' && run.status !== 'running');\n    const succeededRuns = terminalRuns.filter((run) => run.status === 'succeeded');\n    const successRate = terminalRuns.length ? succeededRuns.length / terminalRuns.length : undefined;\n    const lastRun = relatedRuns.toSorted((left, right) => right.createdAtMs - left.createdAtMs)[0];\n\n    let score = matched.length * 8;\n    if (entry.tags?.some((tag) => goalTokens.has(tag.toLowerCase()))) score += 8;\n    if (entry.whenToUse && matched.length > 0) score += 4;\n    if (successRate != null) score += Math.round(successRate * 10);\n    if (lastRun?.status === 'succeeded') score += 4;\n    if (lastRun?.status === 'failed' || lastRun?.status === 'timeout') score -= 3;\n    if (score <= 0) score = entry.source === 'builtin' ? 1 : 0;\n\n    const reasons: string[] = [];\n    if (matched.length) reasons.push(`matches ${matched.slice(0, 4).join(', ')}`);\n    if (successRate != null) reasons.push(`${Math.round(successRate * 100)}% success rate`);\n    if (lastRun) reasons.push(`last run ${lastRun.status}`);\n    if (!reasons.length && entry.whenToUse) reasons.push('general workflow fit');\n\n    if (score > 0) {\n      suggestions.push({\n        definitionId: entry.name,\n        name: entry.name,\n        title: entry.title || entry.name,\n        description: entry.description,\n        score,\n        reasons,\n        tags: entry.tags ?? [],\n        successRate,\n        lastRunStatus: lastRun?.status,\n      });\n    }\n  }\n\n  return suggestions\n    .sort((left, right) => right.score - left.score || left.name.localeCompare(right.name))\n    .slice(0, 5);\n}\n\nfunction buildGoalActivities(input: {\n  goalId: string;\n  queue: GoalQueueItemSnapshot[];\n  runs: GoalRun[];\n  workflowRuns: WorkflowRunSummary[];\n  events: GoalEvent[];\n  evidence: GoalEvidence[];\n  limit: number;\n}): GoalActivityItem[] {\n  const activities: GoalActivityItem[] = [];\n\n  for (const item of input.queue.filter((queueItem) => queueItem.goalId === input.goalId)) {\n    activities.push({\n      id: `queue:${item.id}`,\n      kind: 'queue',\n      status: item.status,\n      title: 'Goal queued',\n      summary: item.lastError || item.userTurn?.text || undefined,\n      createdAt: item.finishedAt ?? item.startedAt ?? item.nextRunAt ?? item.enqueuedAt,\n      link: item.sessionKey ? { type: 'chat', value: item.sessionKey } : undefined,\n      data: item,\n    });\n  }\n\n  for (const run of input.runs) {\n    activities.push({\n      id: `goal_run:${run.id}`,\n      kind: 'goal_run',\n      status: run.verdict ?? run.status,\n      title: 'Goal run judged',\n      summary: run.reason || run.assistantPreview || run.nextAction,\n      createdAt: run.finishedAt ?? run.startedAt,\n      data: run,\n    });\n  }\n\n  for (const run of input.workflowRuns) {\n    activities.push({\n      id: `workflow_run:${run.id}`,\n      kind: 'workflow_run',\n      status: run.status,\n      title: run.title || run.definitionId,\n      summary: run.definitionId,\n      createdAt: run.completedAtMs ?? run.startedAtMs ?? run.createdAtMs,\n      link: { type: 'workflow_run', value: run.id },\n      data: run,\n    });\n  }\n\n  for (const event of input.events) {\n    activities.push({\n      id: `event:${event.id}`,\n      kind: 'event',\n      status: event.kind,\n      title: event.kind,\n      summary: event.message,\n      createdAt: event.createdAt,\n      data: event,\n    });\n  }\n\n  for (const item of input.evidence) {\n    activities.push({\n      id: `evidence:${item.id}`,\n      kind: 'evidence',\n      status: item.kind,\n      title: item.title,\n      summary: item.summary || item.uri,\n      createdAt: item.createdAt,\n      data: item,\n    });\n  }\n\n  return activities\n    .sort((left, right) => right.createdAt - left.createdAt)\n    .slice(0, input.limit);\n}\n\nfunction abortActiveWebchatRunForGoal(\n  deps: AuthenticatedRouteDeps,\n  goal: NonNullable<ReturnType<GoalService['get']>>,\n): { aborted?: boolean; abortedRunId?: string } {\n  const sessionKey = goal.activeSessionKey?.trim();\n  if (!sessionKey) return {};\n  const runId = deps.service.getActiveWebchatRunId(sessionKey);\n  if (!runId) return {};\n  return {\n    abortedRunId: runId,\n    aborted: deps.service.abortAgentRun(runId),\n  };\n}\n\n/** First-class Goal API. Sessions are execution context; goals are durable product objects. */\nexport function registerGoalsRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const goals = new GoalService();\n  const cfg = () => deps.service.currentConfig;\n  const workflowRunService = deps.service.createWorkflowRunService();\n\n  authenticated.get('/api/goals/current', async (c) => {\n    const sessionKey = c.req.query('sessionKey')?.trim();\n    if (!sessionKey) return c.json({ ok: false, error: 'Missing sessionKey' }, 400);\n    return c.json({ ok: true, goal: goals.getActiveForSession(sessionKey) });\n  });\n\n  authenticated.get('/api/goals', async (c) => {\n    const status = parseStatuses(c.req.query('status'));\n    const agentId = c.req.query('agentId')?.trim() || undefined;\n    const sessionKey = c.req.query('sessionKey')?.trim() || undefined;\n    const limit = parseLimit(c.req.query('limit'));\n    const offsetRaw = c.req.query('offset')?.trim();\n    const offset = offsetRaw ? Math.max(0, Number.parseInt(offsetRaw, 10) || 0) : 0;\n    return c.json({ ok: true, goals: goals.list({ status, agentId, sessionKey, limit, offset }) });\n  });\n\n  authenticated.get('/api/goals/queue', async (c) => {\n    return c.json({ ok: true, queue: deps.service.getGoalQueueSnapshot() });\n  });\n\n  authenticated.post('/api/goals', async (c) => {\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const title = typeof body.title === 'string' ? body.title.trim() : '';\n    if (!title) return c.json({ ok: false, error: 'Missing title' }, 400);\n\n    const sessionKey = typeof body.sessionKey === 'string' && body.sessionKey.trim() ? body.sessionKey.trim() : undefined;\n    const contextMessage = parseUserTurnInput(body.contextMessage) ?? { text: '' };\n    const attachmentError = validateUserTurnAttachments(contextMessage.attachments);\n    if (attachmentError) return c.json({ ok: false, error: attachmentError }, 400);\n    const preparedContextAttachments = contextMessage.attachments?.length\n      ? await deps.service.agentService.prepareInboundAttachments(sessionKey ?? `goal:${Date.now()}`, contextMessage.attachments)\n      : undefined;\n    const agentId =\n      typeof body.agentId === 'string' && body.agentId.trim()\n        ? body.agentId.trim()\n        : sessionKey\n          ? undefined\n          : getDefaultAgentId(cfg());\n    const maxTurns =\n      typeof body.maxTurns === 'number' && Number.isFinite(body.maxTurns)\n        ? Math.max(1, Math.min(500, Math.floor(body.maxTurns)))\n        : undefined;\n    const goal = goals.create({\n      title,\n      description: contextMessage.text || undefined,\n      sessionKey,\n      agentId,\n      priority: body.priority === 'low' || body.priority === 'high' ? body.priority : 'normal',\n      deadlineAt: typeof body.deadlineAt === 'number' && Number.isFinite(body.deadlineAt) ? body.deadlineAt : undefined,\n      judgeModelRef: typeof body.judgeModelRef === 'string' ? body.judgeModelRef : undefined,\n      maxTurns,\n      uiLocale: normalizeGoalUiLocale(body.uiLocale),\n      source: body.source === 'cli' || body.source === 'cron' || body.source === 'workflow' || body.source === 'channel' || body.source === 'api'\n        ? body.source\n        : 'chat',\n      config: cfg(),\n    });\n\n    goals.setContextMessage({\n      goalId: goal.id,\n      text: contextMessage.text,\n      attachments: preparedContextAttachments,\n    });\n\n    return c.json({ ok: true, goal: goals.get(goal.id) });\n  });\n\n  authenticated.get('/api/goals/:goalId/workflow-runs', async (c) => {\n    const goalId = c.req.param('goalId');\n    const goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const runStore = workflowRunService.createRunStore(goal.agentId || getDefaultAgentId(cfg()));\n    const runs = await runStore.listRunSummariesForGoal(goalId, parseLimit(c.req.query('limit')));\n    return c.json({ ok: true, runs });\n  });\n\n  authenticated.post('/api/goals/:goalId/workflows/run', async (c) => {\n    const goalId = c.req.param('goalId');\n    const goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (goal.status === 'done' || goal.status === 'archived') {\n      return c.json({ ok: false, error: `Goal is ${goal.status}` }, 409);\n    }\n\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const definitionId = typeof body.definitionId === 'string' ? body.definitionId.trim() : '';\n    if (!definitionId) return c.json({ ok: false, error: 'Missing definitionId' }, 400);\n\n    try {\n      createWorkflowCatalog().load(definitionId);\n    } catch {\n      return c.json({ ok: false, error: 'Workflow definition not found' }, 404);\n    }\n\n    const result = await workflowRunService.startWorkflowRun({\n      agentId: goal.agentId || getDefaultAgentId(cfg()),\n      definitionId,\n      goalId,\n      goal: typeof body.goal === 'string' && body.goal.trim() ? body.goal.trim() : goal.nextAction || goal.title,\n      input: body.input ?? {\n        goal: goal.title,\n        description: goal.description,\n        nextAction: goal.nextAction,\n        checklist: goal.checklist.map((item) => ({\n          text: item.text,\n          status: item.status,\n          evidenceSummary: item.evidenceSummary,\n        })),\n      },\n      parentSessionKey: goal.activeSessionKey,\n      source: { kind: 'webui' },\n      concurrency: typeof body.concurrency === 'number' ? body.concurrency : undefined,\n      maxSubagents: typeof body.maxSubagents === 'number' ? body.maxSubagents : undefined,\n    });\n    if (result.ok === false) {\n      return c.json({ ok: false, error: result.message, code: result.code }, result.httpStatus);\n    }\n    return c.json({ ok: true, runId: result.runId, sessionKey: result.sessionKey }, 202);\n  });\n\n  authenticated.get('/api/goals/:goalId/activity', async (c) => {\n    const goalId = c.req.param('goalId');\n    const goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n\n    const limit = parseLimit(c.req.query('limit'), 100);\n    const runStore = workflowRunService.createRunStore(goal.agentId || getDefaultAgentId(cfg()));\n    const workflowRuns = await runStore.listRunSummariesForGoal(goalId, limit);\n    const activities = buildGoalActivities({\n      goalId,\n      queue: deps.service.getGoalQueueSnapshot(),\n      runs: goals.listRuns(goalId, limit),\n      workflowRuns,\n      events: goals.listEvents(goalId, limit),\n      evidence: goals.listEvidence(goalId, limit),\n      limit,\n    });\n    return c.json({ ok: true, activities });\n  });\n\n  authenticated.get('/api/goals/:goalId/workflow-suggestions', async (c) => {\n    const goalId = c.req.param('goalId');\n    const goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n\n    const runStore = workflowRunService.createRunStore(goal.agentId || getDefaultAgentId(cfg()));\n    const workflowRuns = await runStore.listRunSummaries(500);\n    return c.json({\n      ok: true,\n      suggestions: buildGoalWorkflowSuggestions({ goal, workflowRuns }),\n    });\n  });\n\n  authenticated.get('/api/goals/:goalId', async (c) => {\n    const goal = goals.get(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.patch('/api/goals/:goalId', async (c) => {\n    const goalId = c.req.param('goalId');\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const status = parseBodyGoalStatus(body.status);\n    let goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const patch: Parameters<GoalService['update']>[1] = {};\n    if (typeof body.title === 'string') patch.title = body.title;\n    if ('description' in body) patch.description = typeof body.description === 'string' ? body.description : undefined;\n    const priority = parsePriority(body.priority);\n    if (priority) patch.priority = priority;\n    if ('deadlineAt' in body) {\n      patch.deadlineAt = typeof body.deadlineAt === 'number' && Number.isFinite(body.deadlineAt) ? body.deadlineAt : undefined;\n    }\n    if (typeof body.maxTurns === 'number' && Number.isFinite(body.maxTurns)) patch.maxTurns = body.maxTurns;\n    if ('judgeModelRef' in body) patch.judgeModelRef = typeof body.judgeModelRef === 'string' ? body.judgeModelRef : undefined;\n    if ('nextAction' in body) patch.nextAction = typeof body.nextAction === 'string' ? body.nextAction : undefined;\n    if ('blockedReason' in body) patch.blockedReason = typeof body.blockedReason === 'string' ? body.blockedReason : undefined;\n    const locale = normalizeGoalUiLocale(body.uiLocale);\n    if (locale) patch.uiLocale = locale;\n    if (Object.keys(patch).length > 0) {\n      goal = goals.update(goalId, patch);\n    }\n    if (status) {\n      const previousStatus = goal?.status;\n      goal = goals.setStatus(goalId, status, {\n        reason: typeof body.reason === 'string' ? body.reason : undefined,\n      });\n      const abortResult = goal && status === 'archived' ? abortActiveWebchatRunForGoal(deps, goal) : {};\n      if (goal && previousStatus !== goal.status) {\n        deps.service.emit('goal.status.updated', {\n          goalId,\n          previousStatus,\n          status: goal.status,\n          goal,\n        });\n      }\n      return c.json({ ok: true, goal, ...abortResult });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/continue', async (c) => {\n    const goalId = c.req.param('goalId');\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const goal = goals.get(goalId);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    let sessionKey =\n      typeof body.sessionKey === 'string' && body.sessionKey.trim()\n        ? body.sessionKey.trim()\n        : goal.activeSessionKey;\n\n    if (!sessionKey) {\n      const agentId = goal.agentId || getDefaultAgentId(cfg());\n      const peerId = `goal-${sanitizeSegment(goal.id) || Date.now()}`;\n      sessionKey = buildSessionKey({\n        agentId,\n        source: 'webchat',\n        accountId: 'default',\n        peerKind: 'direct',\n        peerId,\n      });\n      await deps.service.sessionIndexInstance.saveMessages(sessionKey, [], {\n        metadata: {\n          sourceChannel: 'webchat',\n          sourceChatId: `default:direct:${peerId}`,\n          sessionType: 'chat',\n          routing: {\n            agentId,\n            source: 'webchat',\n            accountId: 'default',\n            peerKind: 'direct',\n            peerId,\n          },\n        },\n      });\n      goals.attachSession(goalId, sessionKey);\n    }\n\n    const queued = deps.service.enqueueGoalRun(goalId, {\n      userTurn: parseUserTurnInput(body.userTurn),\n      maxRetries: typeof body.maxRetries === 'number' && Number.isFinite(body.maxRetries) ? body.maxRetries : undefined,\n      source: 'api',\n    });\n    const nextGoal = goals.get(goalId);\n    return c.json({ ok: true, goal: nextGoal, sessionKey, queued });\n  });\n\n  authenticated.post('/api/goals/:goalId/enqueue', async (c) => {\n    const goalId = c.req.param('goalId');\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const item = deps.service.enqueueGoalRun(goalId, {\n      userTurn: parseUserTurnInput(body.userTurn),\n      maxRetries: typeof body.maxRetries === 'number' && Number.isFinite(body.maxRetries) ? body.maxRetries : undefined,\n      source: 'api',\n    });\n    return c.json({ ok: true, item });\n  });\n\n  authenticated.post('/api/goals/:goalId/pause', async (c) => {\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.pause(\n      c.req.param('goalId'),\n      typeof body.reason === 'string' && body.reason.trim() ? body.reason.trim() : 'user-paused',\n    );\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/resume', async (c) => {\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.resume(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/reopen', async (c) => {\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.reopen(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/complete', async (c) => {\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.complete(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/archive', async (c) => {\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.archive(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const abortResult = abortActiveWebchatRunForGoal(deps, goal);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal, ...abortResult });\n  });\n\n  authenticated.post('/api/goals/:goalId/unarchive', async (c) => {\n    const before = goals.get(c.req.param('goalId'));\n    const goal = goals.unarchive(c.req.param('goalId'));\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    if (before?.status !== goal.status) {\n      deps.service.emit('goal.status.updated', {\n        goalId: goal.id,\n        previousStatus: before?.status,\n        status: goal.status,\n        goal,\n      });\n    }\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/attach', async (c) => {\n    const goalId = c.req.param('goalId');\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const sessionKey = typeof body.sessionKey === 'string' ? body.sessionKey.trim() : '';\n    if (!sessionKey) return c.json({ ok: false, error: 'Missing sessionKey' }, 400);\n    const goal = goals.attachSession(goalId, sessionKey);\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.post('/api/goals/:goalId/detach', async (c) => {\n    const goal = goals.update(c.req.param('goalId'), { activeSessionKey: undefined });\n    if (!goal) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.get('/api/goals/:goalId/runs', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, runs: goals.listRuns(goalId, parseLimit(c.req.query('limit'))) });\n  });\n\n  authenticated.get('/api/goals/:goalId/events', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, events: goals.listEvents(goalId, parseLimit(c.req.query('limit'), 100)) });\n  });\n\n  authenticated.get('/api/goals/:goalId/evidence', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    return c.json({ ok: true, evidence: goals.listEvidence(goalId, parseLimit(c.req.query('limit'), 100)) });\n  });\n\n  authenticated.post('/api/goals/:goalId/evidence', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const title = typeof body.title === 'string' ? body.title.trim() : '';\n    const kind = body.kind;\n    if (!title) return c.json({ ok: false, error: 'Missing title' }, 400);\n    if (kind !== 'file' && kind !== 'diff' && kind !== 'command' && kind !== 'test' && kind !== 'link' && kind !== 'message' && kind !== 'artifact') {\n      return c.json({ ok: false, error: 'Invalid evidence kind' }, 400);\n    }\n    const evidence = goals.addEvidence({\n      goalId,\n      runId: typeof body.runId === 'string' ? body.runId : undefined,\n      kind,\n      title,\n      summary: typeof body.summary === 'string' ? body.summary : undefined,\n      uri: typeof body.uri === 'string' ? body.uri : undefined,\n      data: body.data,\n    });\n    return c.json({ ok: true, evidence });\n  });\n\n  authenticated.post('/api/goals/:goalId/checklist', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const text = typeof body.text === 'string' ? body.text.trim() : '';\n    if (!text) return c.json({ ok: false, error: 'Missing text' }, 400);\n    const goal = goals.updateChecklist(goalId, { type: 'add', text, addedBy: 'user' });\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.patch('/api/goals/:goalId/checklist/:itemId', async (c) => {\n    const goalId = c.req.param('goalId');\n    const itemId = c.req.param('itemId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;\n    const status = body.status;\n    if (status !== 'pending' && status !== 'completed' && status !== 'impossible') {\n      return c.json({ ok: false, error: 'Invalid checklist status' }, 400);\n    }\n    const goal = goals.updateChecklist(goalId, {\n      type: 'mark',\n      itemId,\n      status,\n      evidenceSummary: typeof body.evidenceSummary === 'string' ? body.evidenceSummary : undefined,\n    });\n    return c.json({ ok: true, goal });\n  });\n\n  authenticated.delete('/api/goals/:goalId/checklist/:itemId', async (c) => {\n    const goalId = c.req.param('goalId');\n    if (!goals.get(goalId)) return c.json({ ok: false, error: 'Goal not found' }, 404);\n    const goal = goals.updateChecklist(goalId, { type: 'remove', itemId: c.req.param('itemId') });\n    return c.json({ ok: true, goal });\n  });\n}\n"],"mappings":"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"}

package/dist/src/gateway/hono/routes/voice.js

@@ -174,10 +174,18 @@ function registerVoiceRoutes(authenticated, deps) {
 		const config = service.currentConfig;
 		const baseTtsConfig = mergeTtsConfigFromAppConfig(config.messages?.tts);
 		const provider = typeof body.provider === "string" && body.provider.trim() ? body.provider.trim() : baseTtsConfig.provider;
+		const providerConfig = body.providerConfig && typeof body.providerConfig === "object" && !Array.isArray(body.providerConfig) ? body.providerConfig : void 0;
 		const ttsConfig = {
 			...baseTtsConfig,
 			enabled: true,
 			provider,
+			providers: {
+				...baseTtsConfig.providers ?? {},
+				...providerConfig ? { [provider]: {
+					...baseTtsConfig.providers?.[provider] ?? {},
+					...providerConfig
+				} } : {}
+			},
 			fallback: {
 				enabled: false,
 				order: [provider]
@@ -188,6 +196,7 @@ function registerVoiceRoutes(authenticated, deps) {
 			error: { message: `TTS provider "${provider}" is not configured.` }
 		}, 503);
 		try {
+			const startedAt = Date.now();
 			const result = await speak(text, ttsConfig, {
 				appConfig: config,
 				parseDirectives: false,
@@ -196,13 +205,17 @@ function registerVoiceRoutes(authenticated, deps) {
 					...typeof body.voice === "string" && body.voice.trim() ? { voice: body.voice.trim() } : {}
 				}
 			});
+			if (!result.audio.length) throw new Error(`TTS provider "${result.provider}" returned empty audio`);
+			const mimeType = result.format === "opus" || result.format === "ogg" ? "audio/ogg" : result.format === "mp3" || result.format === "mpeg" ? "audio/mpeg" : result.format === "wav" ? "audio/wav" : `audio/${result.format}`;
 			return c.json({
 				ok: true,
 				payload: {
 					audio: result.audio.toString("base64"),
+					mimeType,
 					format: result.format,
 					provider: result.provider,
-					...result.duration !== void 0 ? { duration: result.duration } : {}
+					latencyMs: Date.now() - startedAt,
+					audioSize: result.audio.length
 				}
 			});
 		} catch (error) {

package/dist/src/gateway/hono/routes/voice.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice.js","names":[],"sources":["../../../../../src/gateway/hono/routes/voice.ts"],"sourcesContent":["/**\n * Voice routes — POST /api/voice/transcribe\n *\n * Single endpoint that:\n *   1. Runs STT (Whisper preferred for low latency, Alibaba fallback)\n *   2. Optionally runs LLM refine on the raw transcript\n *   3. Returns { raw, refined?, language }\n *\n * LLM refine is auto-applied when a model is resolvable; gracefully degrades\n * to raw-only when no LLM is configured.\n */\n\nimport type { Hono } from 'hono';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../../providers/index.js';\nimport { isSTTAvailable, transcribe } from '../../../voice/stt/index.js';\nimport { isTTSAvailable, mergeTtsConfigFromAppConfig, speak } from '../../../voice/tts/index.js';\nimport { listTtsProvidersForApi } from '../../../voice/tts/list-providers.js';\nimport { listSttProvidersForApi } from '../../../voice/stt/list-providers.js';\nimport { mergeSttConfigFromAppConfig } from '../../../channels/attachments/voice-stt-webchat.js';\nimport { resolveSttProviderConfigSlice } from '../../../voice/stt/config-slice.js';\nimport { resolveTtsProviderConfigSlice } from '../../../voice/tts/config-slice.js';\nimport { createGatewayRouteLogger } from '../lib/route-logger.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst log = createGatewayRouteLogger('Voice');\n\nfunction readVoiceApiKeyFromConfigFileOnly(\n  cfg: Config,\n  kind: 'stt' | 'tts',\n  providerId: string,\n): string | undefined {\n  const id = providerId.trim();\n  if (!id) return undefined;\n  const slice =\n    kind === 'stt'\n      ? resolveSttProviderConfigSlice(id, cfg.tools?.media?.audio)\n      : resolveTtsProviderConfigSlice(id, cfg.messages?.tts);\n  const key = slice.apiKey;\n  return typeof key === 'string' && key.trim() ? key.trim() : undefined;\n}\n\nconst REFINE_TIMEOUT_MS = 15_000;\nconst MAX_AUDIO_BYTES = 25 * 1024 * 1024; // 25 MB\n\nconst REFINE_SYSTEM_PROMPT = `你是语音转文字后处理助手。将语音转写原文整理为高质量文本输入。\n\n规则：\n1. 修正明显的语音识别错误\n2. 添加正确的标点符号\n3. 去除口语赘词（嗯、啊、那个、就是说、然后就是）\n4. 保持原意不变，不要扩写或改变语义\n5. 如果原文已经很好，原样输出\n6. 只输出整理后的文字，不要解释`;\n\nfunction resolveRefineModel(config: Config | undefined): ReturnType<typeof resolveModel> | null {\n  const envRef = process.env.XOPC_VOICE_REFINE_MODEL?.trim();\n  if (envRef) {\n    try {\n      return resolveModel(envRef);\n    } catch { /* fall through */ }\n  }\n  for (const candidate of ['openai/gpt-4o-mini', 'google/gemini-2.0-flash']) {\n    try {\n      return resolveModel(candidate);\n    } catch { /* next */ }\n  }\n  try {\n    return resolveModel(getDefaultModelSync(config));\n  } catch {\n    return null;\n  }\n}\n\nasync function refineTranscript(\n  raw: string,\n  config: Config | undefined,\n  signal?: AbortSignal,\n): Promise<string | undefined> {\n  if (!raw.trim()) return undefined;\n\n  const model = resolveRefineModel(config);\n  if (!model) {\n    log.debug('No LLM model available for voice refine; returning raw only');\n    return undefined;\n  }\n\n  try {\n    const userMsg: UserMessage = {\n      role: 'user',\n      content: `${REFINE_SYSTEM_PROMPT}\\n\\n原文：${raw}`,\n      timestamp: Date.now(),\n    };\n\n    const timeoutSignal =\n      typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n        ? AbortSignal.timeout(REFINE_TIMEOUT_MS)\n        : undefined;\n    const mergedSignal =\n      signal && timeoutSignal && typeof AbortSignal.any === 'function'\n        ? AbortSignal.any([signal, timeoutSignal])\n        : signal ?? timeoutSignal;\n\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: Math.min(raw.length * 3, 4096),\n        temperature: 0.2,\n        signal: mergedSignal as AbortSignal,\n      },\n    );\n\n    let out = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          out += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const refined = out.trim();\n    if (!refined || refined === raw.trim()) return undefined;\n    return refined;\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error);\n    log.warn({ errorMessage: msg }, 'Voice refine failed; returning raw only');\n    return undefined;\n  }\n}\n\nexport function registerVoiceRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const { service, strictRateLimitMiddleware } = deps;\n\n  /**\n   * GET /api/voice/providers\n   *\n   * Lists registered SpeechProviderPlugin ids with configured state for the\n   * current gateway config (OpenClaw `tts.providers` equivalent).\n   */\n  authenticated.get('/api/voice/providers', (c) => {\n    const config = service.currentConfig as Config;\n    const payload = listTtsProvidersForApi(config);\n    return c.json({ ok: true, payload });\n  });\n\n  /**\n   * GET /api/voice/stt-providers\n   *\n   * Lists registered MediaUnderstandingProvider ids with configured state for\n   * the current gateway config (OpenClaw `tools.media.audio.providers` equivalent).\n   */\n  authenticated.get('/api/voice/stt-providers', (c) => {\n    const config = service.currentConfig as Config;\n    const payload = listSttProvidersForApi(config);\n    return c.json({ ok: true, payload });\n  });\n\n  /**\n   * POST /api/voice/reveal-api-key — return plaintext voice provider apiKey from config file only.\n   * Body: `{ kind: 'stt' | 'tts', provider: string }`\n   */\n  authenticated.post('/api/voice/reveal-api-key', strictRateLimitMiddleware, async (c) => {\n    let body: { kind?: unknown; provider?: unknown } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n    const kind = body.kind === 'stt' || body.kind === 'tts' ? body.kind : null;\n    const provider = typeof body.provider === 'string' ? body.provider.trim() : '';\n    if (!kind) {\n      return c.json({ ok: false, error: { message: 'kind must be \"stt\" or \"tts\"' } }, 400);\n    }\n    if (!provider) {\n      return c.json({ ok: false, error: { message: 'provider is required' } }, 400);\n    }\n\n    const cfg = service.currentConfig as Config;\n    const apiKey = readVoiceApiKeyFromConfigFileOnly(cfg, kind, provider);\n    return c.json({\n      ok: true,\n      payload: {\n        kind,\n        provider,\n        apiKey: apiKey ?? null,\n        source: apiKey ? ('config' as const) : ('none' as const),\n      },\n    });\n  });\n\n  /**\n   * POST /api/voice/tts-test\n   *\n   * Body: { text: string, provider?: string, model?: string, voice?: string }\n   * Response: { ok: true, payload: { audio: string, format: string, provider: string } }\n   */\n  authenticated.post('/api/voice/tts-test', strictRateLimitMiddleware, async (c) => {\n    let body: { text?: unknown; provider?: unknown; model?: unknown; voice?: unknown } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n\n    const text = typeof body.text === 'string' ? body.text.trim() : '';\n    if (!text) {\n      return c.json({ ok: false, error: { message: 'text is required' } }, 400);\n    }\n    if (text.length > 1000) {\n      return c.json({ ok: false, error: { message: 'text exceeds 1000 characters' } }, 400);\n    }\n\n    const config = service.currentConfig as Config;\n    const baseTtsConfig = mergeTtsConfigFromAppConfig(config.messages?.tts);\n    const provider = typeof body.provider === 'string' && body.provider.trim() ? body.provider.trim() : baseTtsConfig.provider;\n    const ttsConfig = {\n      ...baseTtsConfig,\n      enabled: true,\n      provider,\n      fallback: { enabled: false, order: [provider] },\n    };\n\n    if (!isTTSAvailable(ttsConfig)) {\n      return c.json({\n        ok: false,\n        error: { message: `TTS provider \"${provider}\" is not configured.` },\n      }, 503);\n    }\n\n    try {\n      const result = await speak(text, ttsConfig, {\n        appConfig: config,\n        parseDirectives: false,\n        tts: {\n          ...(typeof body.model === 'string' && body.model.trim() ? { model: body.model.trim() } : {}),\n          ...(typeof body.voice === 'string' && body.voice.trim() ? { voice: body.voice.trim() } : {}),\n        },\n      });\n      return c.json({\n        ok: true,\n        payload: {\n          audio: result.audio.toString('base64'),\n          format: result.format,\n          provider: result.provider,\n          ...(result.duration !== undefined ? { duration: result.duration } : {}),\n        },\n      });\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      log.error({ errorMessage: msg, provider }, 'Voice TTS test failed');\n      return c.json({ ok: false, error: { message: `TTS test failed: ${msg}` } }, 502);\n    }\n  });\n\n  /**\n   * POST /api/voice/transcribe\n   *\n   * Body: { audio: string (base64), mimeType: string, language?: string }\n   * Response: { ok: true, payload: { raw: string, refined?: string, language?: string } }\n   */\n  authenticated.post('/api/voice/transcribe', async (c) => {\n    let body: { audio?: string; mimeType?: string; language?: string } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n\n    const { audio, mimeType, language } = body;\n    if (!audio || typeof audio !== 'string') {\n      return c.json({ ok: false, error: { message: 'Missing required field: audio (base64)' } }, 400);\n    }\n    if (!mimeType || typeof mimeType !== 'string') {\n      return c.json({ ok: false, error: { message: 'Missing required field: mimeType' } }, 400);\n    }\n\n    // Decode base64 audio\n    let audioBuffer: Buffer;\n    try {\n      audioBuffer = Buffer.from(audio, 'base64');\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid base64 audio data' } }, 400);\n    }\n\n    if (audioBuffer.length === 0) {\n      return c.json({ ok: false, error: { message: 'Empty audio data' } }, 400);\n    }\n    if (audioBuffer.length > MAX_AUDIO_BYTES) {\n      return c.json({ ok: false, error: { message: 'Audio data exceeds 25 MB limit' } }, 400);\n    }\n\n    // Resolve STT config from app config\n    const config = service.currentConfig as Config;\n    const sttConfigRaw = config.tools?.media?.audio;\n    const sttConfig = mergeSttConfigFromAppConfig(sttConfigRaw, config.tools?.media);\n\n    if (!isSTTAvailable(sttConfig)) {\n      return c.json({\n        ok: false,\n        error: { message: 'STT is not configured. Enable STT in gateway config (tools.media.audio).' },\n      }, 503);\n    }\n\n    // Run STT\n    let raw: string;\n    let detectedLanguage: string | undefined;\n    try {\n      const result = await transcribe(audioBuffer, sttConfig, {\n        language: language || (sttConfig.provider === 'alibaba' ? 'zh' : undefined),\n      });\n      raw = result.text;\n      detectedLanguage = result.language ?? language;\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      log.error({ errorMessage: msg }, 'Voice transcription failed');\n      return c.json({ ok: false, error: { message: `Transcription failed: ${msg}` } }, 502);\n    }\n\n    if (!raw.trim()) {\n      return c.json({\n        ok: true,\n        payload: { raw: '', language: detectedLanguage },\n      });\n    }\n\n    // Run LLM refine (auto, best-effort)\n    const refined = await refineTranscript(raw, config);\n\n    return c.json({\n      ok: true,\n      payload: {\n        raw,\n        ...(refined ? { refined } : {}),\n        ...(detectedLanguage ? { language: detectedLanguage } : {}),\n      },\n    });\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"voice.js","names":[],"sources":["../../../../../src/gateway/hono/routes/voice.ts"],"sourcesContent":["/**\n * Voice routes — POST /api/voice/transcribe\n *\n * Single endpoint that:\n *   1. Runs STT (Whisper preferred for low latency, Alibaba fallback)\n *   2. Optionally runs LLM refine on the raw transcript\n *   3. Returns { raw, refined?, language }\n *\n * LLM refine is auto-applied when a model is resolvable; gracefully degrades\n * to raw-only when no LLM is configured.\n */\n\nimport type { Hono } from 'hono';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../../providers/index.js';\nimport { isSTTAvailable, transcribe } from '../../../voice/stt/index.js';\nimport { isTTSAvailable, mergeTtsConfigFromAppConfig, speak } from '../../../voice/tts/index.js';\nimport { listTtsProvidersForApi } from '../../../voice/tts/list-providers.js';\nimport { listSttProvidersForApi } from '../../../voice/stt/list-providers.js';\nimport { mergeSttConfigFromAppConfig } from '../../../channels/attachments/voice-stt-webchat.js';\nimport { resolveSttProviderConfigSlice } from '../../../voice/stt/config-slice.js';\nimport { resolveTtsProviderConfigSlice } from '../../../voice/tts/config-slice.js';\nimport { createGatewayRouteLogger } from '../lib/route-logger.js';\nimport type { AuthenticatedRouteDeps } from './deps.js';\n\nconst log = createGatewayRouteLogger('Voice');\n\nfunction readVoiceApiKeyFromConfigFileOnly(\n  cfg: Config,\n  kind: 'stt' | 'tts',\n  providerId: string,\n): string | undefined {\n  const id = providerId.trim();\n  if (!id) return undefined;\n  const slice =\n    kind === 'stt'\n      ? resolveSttProviderConfigSlice(id, cfg.tools?.media?.audio)\n      : resolveTtsProviderConfigSlice(id, cfg.messages?.tts);\n  const key = slice.apiKey;\n  return typeof key === 'string' && key.trim() ? key.trim() : undefined;\n}\n\nconst REFINE_TIMEOUT_MS = 15_000;\nconst MAX_AUDIO_BYTES = 25 * 1024 * 1024; // 25 MB\n\nconst REFINE_SYSTEM_PROMPT = `你是语音转文字后处理助手。将语音转写原文整理为高质量文本输入。\n\n规则：\n1. 修正明显的语音识别错误\n2. 添加正确的标点符号\n3. 去除口语赘词（嗯、啊、那个、就是说、然后就是）\n4. 保持原意不变，不要扩写或改变语义\n5. 如果原文已经很好，原样输出\n6. 只输出整理后的文字，不要解释`;\n\nfunction resolveRefineModel(config: Config | undefined): ReturnType<typeof resolveModel> | null {\n  const envRef = process.env.XOPC_VOICE_REFINE_MODEL?.trim();\n  if (envRef) {\n    try {\n      return resolveModel(envRef);\n    } catch { /* fall through */ }\n  }\n  for (const candidate of ['openai/gpt-4o-mini', 'google/gemini-2.0-flash']) {\n    try {\n      return resolveModel(candidate);\n    } catch { /* next */ }\n  }\n  try {\n    return resolveModel(getDefaultModelSync(config));\n  } catch {\n    return null;\n  }\n}\n\nasync function refineTranscript(\n  raw: string,\n  config: Config | undefined,\n  signal?: AbortSignal,\n): Promise<string | undefined> {\n  if (!raw.trim()) return undefined;\n\n  const model = resolveRefineModel(config);\n  if (!model) {\n    log.debug('No LLM model available for voice refine; returning raw only');\n    return undefined;\n  }\n\n  try {\n    const userMsg: UserMessage = {\n      role: 'user',\n      content: `${REFINE_SYSTEM_PROMPT}\\n\\n原文：${raw}`,\n      timestamp: Date.now(),\n    };\n\n    const timeoutSignal =\n      typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n        ? AbortSignal.timeout(REFINE_TIMEOUT_MS)\n        : undefined;\n    const mergedSignal =\n      signal && timeoutSignal && typeof AbortSignal.any === 'function'\n        ? AbortSignal.any([signal, timeoutSignal])\n        : signal ?? timeoutSignal;\n\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: Math.min(raw.length * 3, 4096),\n        temperature: 0.2,\n        signal: mergedSignal as AbortSignal,\n      },\n    );\n\n    let out = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          out += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const refined = out.trim();\n    if (!refined || refined === raw.trim()) return undefined;\n    return refined;\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error);\n    log.warn({ errorMessage: msg }, 'Voice refine failed; returning raw only');\n    return undefined;\n  }\n}\n\nexport function registerVoiceRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void {\n  const { service, strictRateLimitMiddleware } = deps;\n\n  /**\n   * GET /api/voice/providers\n   *\n   * Lists registered SpeechProviderPlugin ids with configured state for the\n   * current gateway config (OpenClaw `tts.providers` equivalent).\n   */\n  authenticated.get('/api/voice/providers', (c) => {\n    const config = service.currentConfig as Config;\n    const payload = listTtsProvidersForApi(config);\n    return c.json({ ok: true, payload });\n  });\n\n  /**\n   * GET /api/voice/stt-providers\n   *\n   * Lists registered MediaUnderstandingProvider ids with configured state for\n   * the current gateway config (OpenClaw `tools.media.audio.providers` equivalent).\n   */\n  authenticated.get('/api/voice/stt-providers', (c) => {\n    const config = service.currentConfig as Config;\n    const payload = listSttProvidersForApi(config);\n    return c.json({ ok: true, payload });\n  });\n\n  /**\n   * POST /api/voice/reveal-api-key — return plaintext voice provider apiKey from config file only.\n   * Body: `{ kind: 'stt' | 'tts', provider: string }`\n   */\n  authenticated.post('/api/voice/reveal-api-key', strictRateLimitMiddleware, async (c) => {\n    let body: { kind?: unknown; provider?: unknown } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n    const kind = body.kind === 'stt' || body.kind === 'tts' ? body.kind : null;\n    const provider = typeof body.provider === 'string' ? body.provider.trim() : '';\n    if (!kind) {\n      return c.json({ ok: false, error: { message: 'kind must be \"stt\" or \"tts\"' } }, 400);\n    }\n    if (!provider) {\n      return c.json({ ok: false, error: { message: 'provider is required' } }, 400);\n    }\n\n    const cfg = service.currentConfig as Config;\n    const apiKey = readVoiceApiKeyFromConfigFileOnly(cfg, kind, provider);\n    return c.json({\n      ok: true,\n      payload: {\n        kind,\n        provider,\n        apiKey: apiKey ?? null,\n        source: apiKey ? ('config' as const) : ('none' as const),\n      },\n    });\n  });\n\n  /**\n   * POST /api/voice/tts-test\n   *\n   * Body: { text: string, provider?: string, model?: string, voice?: string }\n   * Response: { ok: true, payload: { audio: string, format: string, provider: string } }\n   */\n  authenticated.post('/api/voice/tts-test', strictRateLimitMiddleware, async (c) => {\n    let body: { text?: unknown; provider?: unknown; model?: unknown; voice?: unknown; providerConfig?: unknown } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n\n    const text = typeof body.text === 'string' ? body.text.trim() : '';\n    if (!text) {\n      return c.json({ ok: false, error: { message: 'text is required' } }, 400);\n    }\n    if (text.length > 1000) {\n      return c.json({ ok: false, error: { message: 'text exceeds 1000 characters' } }, 400);\n    }\n\n    const config = service.currentConfig as Config;\n    const baseTtsConfig = mergeTtsConfigFromAppConfig(config.messages?.tts);\n    const provider = typeof body.provider === 'string' && body.provider.trim() ? body.provider.trim() : baseTtsConfig.provider;\n    const providerConfig =\n      body.providerConfig && typeof body.providerConfig === 'object' && !Array.isArray(body.providerConfig)\n        ? (body.providerConfig as Record<string, unknown>)\n        : undefined;\n    const ttsConfig = {\n      ...baseTtsConfig,\n      enabled: true,\n      provider,\n      providers: {\n        ...(baseTtsConfig.providers ?? {}),\n        ...(providerConfig ? { [provider]: { ...(baseTtsConfig.providers?.[provider] ?? {}), ...providerConfig } } : {}),\n      },\n      fallback: { enabled: false, order: [provider] },\n    };\n\n    if (!isTTSAvailable(ttsConfig)) {\n      return c.json({\n        ok: false,\n        error: { message: `TTS provider \"${provider}\" is not configured.` },\n      }, 503);\n    }\n\n    try {\n      const startedAt = Date.now();\n      const result = await speak(text, ttsConfig, {\n        appConfig: config,\n        parseDirectives: false,\n        tts: {\n          ...(typeof body.model === 'string' && body.model.trim() ? { model: body.model.trim() } : {}),\n          ...(typeof body.voice === 'string' && body.voice.trim() ? { voice: body.voice.trim() } : {}),\n        },\n      });\n      if (!result.audio.length) {\n        throw new Error(`TTS provider \"${result.provider}\" returned empty audio`);\n      }\n      const mimeType =\n        result.format === 'opus' || result.format === 'ogg'\n          ? 'audio/ogg'\n          : result.format === 'mp3' || result.format === 'mpeg'\n            ? 'audio/mpeg'\n            : result.format === 'wav'\n              ? 'audio/wav'\n              : `audio/${result.format}`;\n      return c.json({\n        ok: true,\n        payload: {\n          audio: result.audio.toString('base64'),\n          mimeType,\n          format: result.format,\n          provider: result.provider,\n          latencyMs: Date.now() - startedAt,\n          audioSize: result.audio.length,\n        },\n      });\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      log.error({ errorMessage: msg, provider }, 'Voice TTS test failed');\n      return c.json({ ok: false, error: { message: `TTS test failed: ${msg}` } }, 502);\n    }\n  });\n\n  /**\n   * POST /api/voice/transcribe\n   *\n   * Body: { audio: string (base64), mimeType: string, language?: string }\n   * Response: { ok: true, payload: { raw: string, refined?: string, language?: string } }\n   */\n  authenticated.post('/api/voice/transcribe', async (c) => {\n    let body: { audio?: string; mimeType?: string; language?: string } = {};\n    try {\n      body = (await c.req.json()) as typeof body;\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid JSON body' } }, 400);\n    }\n\n    const { audio, mimeType, language } = body;\n    if (!audio || typeof audio !== 'string') {\n      return c.json({ ok: false, error: { message: 'Missing required field: audio (base64)' } }, 400);\n    }\n    if (!mimeType || typeof mimeType !== 'string') {\n      return c.json({ ok: false, error: { message: 'Missing required field: mimeType' } }, 400);\n    }\n\n    // Decode base64 audio\n    let audioBuffer: Buffer;\n    try {\n      audioBuffer = Buffer.from(audio, 'base64');\n    } catch {\n      return c.json({ ok: false, error: { message: 'Invalid base64 audio data' } }, 400);\n    }\n\n    if (audioBuffer.length === 0) {\n      return c.json({ ok: false, error: { message: 'Empty audio data' } }, 400);\n    }\n    if (audioBuffer.length > MAX_AUDIO_BYTES) {\n      return c.json({ ok: false, error: { message: 'Audio data exceeds 25 MB limit' } }, 400);\n    }\n\n    // Resolve STT config from app config\n    const config = service.currentConfig as Config;\n    const sttConfigRaw = config.tools?.media?.audio;\n    const sttConfig = mergeSttConfigFromAppConfig(sttConfigRaw, config.tools?.media);\n\n    if (!isSTTAvailable(sttConfig)) {\n      return c.json({\n        ok: false,\n        error: { message: 'STT is not configured. Enable STT in gateway config (tools.media.audio).' },\n      }, 503);\n    }\n\n    // Run STT\n    let raw: string;\n    let detectedLanguage: string | undefined;\n    try {\n      const result = await transcribe(audioBuffer, sttConfig, {\n        language: language || (sttConfig.provider === 'alibaba' ? 'zh' : undefined),\n      });\n      raw = result.text;\n      detectedLanguage = result.language ?? language;\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      log.error({ errorMessage: msg }, 'Voice transcription failed');\n      return c.json({ ok: false, error: { message: `Transcription failed: ${msg}` } }, 502);\n    }\n\n    if (!raw.trim()) {\n      return c.json({\n        ok: true,\n        payload: { raw: '', language: detectedLanguage },\n      });\n    }\n\n    // Run LLM refine (auto, best-effort)\n    const refined = await refineTranscript(raw, config);\n\n    return c.json({\n      ok: true,\n      payload: {\n        raw,\n        ...(refined ? { refined } : {}),\n        ...(detectedLanguage ? { language: detectedLanguage } : {}),\n      },\n    });\n  });\n}\n"],"mappings":"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"}

package/dist/src/gateway/hono/sse.js.map

@@ -1 +1 @@
-{"version":3,"file":"sse.js","names":[],"sources":["../../../../src/gateway/hono/sse.ts"],"sourcesContent":["import { streamSSE } from 'hono/streaming';\nimport type { Context } from 'hono';\nimport type { GatewayService } from '../service.js';\nimport { MAX_WEBCHAT_ATTACHMENT_FILE_BYTES } from '../chat-limits.js';\nimport { createLogger, updateAsyncLogContext } from '../../utils/logger.js';\nimport { stringifySSEData } from './sse-json.js';\nimport { resolveWebchatSessionKey } from '../resolve-webchat-session-key.js';\n\nconst log = createLogger('Gateway:SSE');\n\n// Active SSE connections tracking for connection limiting\nconst activeConnections = new Map<string, AbortController>();\n\nexport interface SSEHandlerConfig {\n  service: GatewayService;\n  maxSseConnections?: number;\n}\n\n// Type validation for agent request body\ninterface AgentRequestBody {\n  message: string;\n  channel?: string;\n  sessionKey?: string;\n  /** Epoch ms when the client started this send (abort cutoff / stale POST drop). */\n  clientCreatedAtMs?: number;\n  thinking?: string;\n  attachments?: Array<{\n    type: string;\n    mimeType?: string;\n    data?: string;\n    uri?: string;\n    name?: string;\n    size?: number;\n    workspaceRelativePath?: string;\n    durationSeconds?: number;\n  }>;\n}\n\nfunction isValidAgentRequest(body: unknown): body is AgentRequestBody {\n  if (!body || typeof body !== 'object') return false;\n  const b = body as Record<string, unknown>;\n  // Allow empty message if attachments are provided\n  const hasMessage = typeof b.message === 'string';\n  const hasAttachments = Array.isArray(b.attachments) && b.attachments.length > 0;\n  return hasMessage || hasAttachments;\n}\n\n/** Max base64 character length that can decode to `MAX_WEBCHAT_ATTACHMENT_FILE_BYTES`. */\nfunction maxBase64CharsForBinary(maxBinaryBytes: number): number {\n  return 4 * Math.ceil(maxBinaryBytes / 3);\n}\n\n/**\n * POST /api/agent — Send a message to the agent, stream response via SSE.\n *\n * Request body: { message, channel?, sessionKey, attachments? }\n * Accept: text/event-stream → SSE stream\n * Accept: application/json → wait for full response, return JSON\n *\n * SSE events follow XOPC Chat Stream Protocol v1:\n *   run_start, user_message, user_transcript, assistant_message_start,\n *   assistant_delta, thinking_delta, thinking_end, tool_start, tool_update,\n *   tool_end, assistant_message_end, compaction, tts_audio, clarify_request,\n *   run_end, error.\n */\nexport function createAgentSSEHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => null);\n\n    // Input validation\n    if (!isValidAgentRequest(body)) {\n      return c.json({\n        ok: false,\n        error: { code: 'BAD_REQUEST', message: 'Missing required field: message or attachments' }\n      }, 400);\n    }\n\n    const { message, channel = 'webchat', attachments, thinking } = body;\n    const clientCreatedAtMs =\n      typeof body.clientCreatedAtMs === 'number' && Number.isFinite(body.clientCreatedAtMs)\n        ? body.clientCreatedAtMs\n        : undefined;\n    const resolved = resolveWebchatSessionKey({\n      sessionKey: typeof body.sessionKey === 'string' ? body.sessionKey : undefined,\n    });\n    if (resolved.ok === false) {\n      return c.json({\n        ok: false,\n        error: { code: 'BAD_REQUEST', message: resolved.error },\n      }, 400);\n    }\n    const chatId = resolved.sessionKey;\n\n    updateAsyncLogContext({ sessionKey: String(chatId) });\n\n    if (Array.isArray(attachments)) {\n      const maxDataChars = maxBase64CharsForBinary(MAX_WEBCHAT_ATTACHMENT_FILE_BYTES);\n      for (const a of attachments) {\n        if (!a || typeof a !== 'object') continue;\n        const data = (a as { data?: unknown }).data;\n        if (typeof data === 'string' && data.length > maxDataChars) {\n          return c.json(\n            {\n              ok: false,\n              error: {\n                code: 'BAD_REQUEST',\n                message: `Attachment exceeds maximum size (${MAX_WEBCHAT_ATTACHMENT_FILE_BYTES} bytes)`,\n              },\n            },\n            400,\n          );\n        }\n      }\n    }\n\n    const accept = c.req.header('Accept') || '';\n    const wantSSE = accept.includes('text/event-stream');\n\n    const clientAbort = new AbortController();\n    const raw = c.req.raw;\n    // Keep webchat runs alive across transient disconnects (page refresh / tab route switch)\n    // so the client can reattach via /api/agent/resume using runId from `run_start`.\n    // Explicit cancellation still goes through /api/agent/abort.\n    if (channel !== 'webchat') {\n      if (raw.signal.aborted) {\n        clientAbort.abort();\n      } else {\n        raw.signal.addEventListener('abort', () => clientAbort.abort(), { once: true });\n      }\n    }\n\n    // --- Non-streaming fallback: collect everything, return JSON ---\n    if (!wantSSE) {\n      const jsonSessionKey = channel === 'webchat' ? chatId : undefined;\n\n      const generator = service.runAgent(message, channel, chatId, attachments, thinking, {\n        signal: clientAbort.signal,\n        ...(clientCreatedAtMs !== undefined ? { clientCreatedAtMs } : {}),\n      });\n      try {\n        let finalResult: { status: string; summary: string } | undefined;\n        const tokens: string[] = [];\n\n        while (true) {\n          const { done, value } = await generator.next();\n          if (done) {\n            finalResult = value as { status: string; summary: string };\n            break;\n          }\n          const chunk = value as { type: string; payload?: { delta?: unknown } };\n          if (chunk.type === 'assistant_delta' && typeof chunk.payload?.delta === 'string') {\n            tokens.push(chunk.payload.delta);\n          }\n        }\n\n        return c.json({\n          ok: true,\n          payload: {\n            ...finalResult,\n            content: tokens.join(''),\n            ...(jsonSessionKey !== undefined\n              ? { sessionKey: jsonSessionKey, key: jsonSessionKey }\n              : {}),\n          },\n        });\n      } catch (error) {\n        const em = error instanceof Error ? error.message : String(error);\n        log.error(\n          { err: error, errorMessage: em, phase: 'gateway.agent_run', sessionKey: jsonSessionKey, channel },\n          `Agent run failed (JSON mode): ${em}`,\n        );\n        return c.json({\n          ok: false,\n          error: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n        }, 500);\n      }\n    }\n\n    // --- SSE streaming ---\n    c.header('X-Accel-Buffering', 'no');\n    return streamSSE(c, async (stream) => {\n      if (channel !== 'webchat') {\n        stream.onAbort(() => {\n          clientAbort.abort();\n        });\n      }\n\n      const generator = service.runAgent(message, channel, chatId, attachments, thinking, {\n        signal: clientAbort.signal,\n        ...(clientCreatedAtMs !== undefined ? { clientCreatedAtMs } : {}),\n      });\n\n      let eventId = 0;\n\n      try {\n        while (true) {\n          const { done, value } = await generator.next();\n\n          if (done) break;\n\n          const chunk = value as { type: string; seq?: unknown };\n          await stream.writeSSE({\n            id: typeof chunk.seq === 'number' ? String(chunk.seq) : String(++eventId),\n            event: chunk.type || 'message',\n            data: stringifySSEData(chunk),\n          });\n        }\n      } catch (error) {\n        log.error({ err: error }, 'Agent run failed (SSE mode)');\n        await stream.writeSSE({\n          id: String(++eventId),\n          event: 'error',\n          data: stringifySSEData({\n            type: 'error',\n            runId: 'unknown',\n            sessionKey: chatId,\n            timestamp: Date.now(),\n            payload: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n          }),\n        });\n      }\n    });\n  };\n}\n\n/**\n * POST /api/agent/resume — Re-attach to an in-progress agent run via SSE.\n *\n * Request body: { runId, sessionKey }\n * The relay replays all buffered events from the beginning and then live-tails\n * until the run completes.\n *\n * SSE events are identical to those from POST /api/agent.\n */\nexport function createAgentResumeHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => null);\n    if (!body || typeof body !== 'object') {\n      return c.json({ ok: false, error: { code: 'BAD_REQUEST', message: 'Invalid JSON body' } }, 400);\n    }\n\n    const { runId, sessionKey } = body as { runId?: string; sessionKey?: string };\n    if (typeof sessionKey === 'string' && sessionKey.trim()) {\n      updateAsyncLogContext({ sessionKey: sessionKey.trim() });\n    }\n    if (!runId || typeof runId !== 'string') {\n      return c.json({ ok: false, error: { code: 'BAD_REQUEST', message: 'Missing required field: runId' } }, 400);\n    }\n\n    if (!service.runRelay.hasRun(runId)) {\n      return c.json({ ok: false, error: { code: 'NOT_FOUND', message: 'Run not found or already expired' } }, 404);\n    }\n\n    c.header('X-Accel-Buffering', 'no');\n    return streamSSE(c, async (stream) => {\n      let eventId = 0;\n      try {\n        for await (const event of service.runRelay.subscribe(runId)) {\n          await stream.writeSSE({\n            id: typeof event.seq === 'number' ? String(event.seq) : String(++eventId),\n            event: event.type || 'message',\n            data: stringifySSEData(event),\n          });\n        }\n      } catch (error) {\n        log.error({ err: error, runId }, 'Resume stream failed');\n        await stream.writeSSE({\n          id: String(++eventId),\n          event: 'error',\n          data: stringifySSEData({\n            type: 'error',\n            runId,\n            sessionKey: typeof sessionKey === 'string' ? sessionKey : '',\n            timestamp: Date.now(),\n            payload: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n          }),\n        });\n      }\n    });\n  };\n}\n\n/**\n * POST /api/send — Send a message through a channel (non-streaming).\n */\nexport function createSendHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => ({}));\n    const channel = body.channel as string;\n    const chatId = body.chatId as string;\n    const content = body.content as string;\n\n    if (!channel || !chatId || !content) {\n      return c.json(\n        { ok: false, error: { code: 'BAD_REQUEST', message: 'Missing required fields: channel, chatId, content' } },\n        400,\n      );\n    }\n\n    try {\n      const result = await service.sendMessage(channel, chatId, content);\n      return c.json({ ok: true, payload: result });\n    } catch (error) {\n      log.error({ err: error }, 'Send failed');\n      return c.json(\n        { ok: false, error: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' } },\n        500,\n      );\n    }\n  };\n}\n\n/**\n * GET /api/events — Server-pushed event stream (SSE).\n *\n * The client opens this long-lived connection to receive:\n *   - channel status changes\n *   - config reload notifications\n *   - cron execution results\n *   - any other server-initiated events\n *\n * Supports Last-Event-ID for reconnection.\n * Enforces maximum connection limit to prevent DoS.\n */\nexport function createEventsSSEHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n  const maxConnections = config.maxSseConnections ?? 100;\n\n  return async (c: Context) => {\n    // Check maximum connections limit\n    if (activeConnections.size >= maxConnections) {\n      log.warn({ current: activeConnections.size, max: maxConnections }, 'SSE connection limit reached');\n      return c.json({\n        ok: false,\n        error: { code: 'TOO_MANY_CONNECTIONS', message: 'Maximum SSE connections exceeded' }\n      }, 503);\n    }\n\n    const lastEventId = c.req.header('Last-Event-ID') || undefined;\n    const sessionId = c.req.header('X-Session-Id')\n      || c.req.query('sessionId')\n      || crypto.randomUUID();\n\n    updateAsyncLogContext({ sessionId: String(sessionId) });\n\n    const abortController = new AbortController();\n    activeConnections.set(sessionId, abortController);\n\n    return streamSSE(c, async (stream) => {\n      let aborted = false;\n\n      // Send a hello event so the client knows the stream is established\n      await stream.writeSSE({\n        id: '0',\n        event: 'connected',\n        data: JSON.stringify({ sessionId }),\n      });\n\n      // Subscribe to service events\n      const cleanup = service.subscribe(sessionId, async (event) => {\n        if (aborted) return;\n        try {\n          await stream.writeSSE({\n            id: event.id,\n            event: event.type,\n            data: JSON.stringify(event.payload),\n          });\n        } catch {\n          // Stream closed, will be cleaned up by onAbort\n        }\n      });\n\n      // Replay missed events on reconnect\n      if (lastEventId) {\n        const missed = service.getEventsSince(sessionId, lastEventId);\n        for (const event of missed) {\n          await stream.writeSSE({\n            id: event.id,\n            event: event.type,\n            data: JSON.stringify(event.payload),\n          });\n        }\n      }\n\n      // Keep alive with periodic comments (every 30s)\n      const keepAlive = setInterval(async () => {\n        if (aborted) { clearInterval(keepAlive); return; }\n        try {\n          await stream.writeSSE({ event: 'ping', data: '' });\n        } catch {\n          clearInterval(keepAlive);\n        }\n      }, 30_000);\n\n      // Block until aborted — streamSSE closes when the callback returns\n      await new Promise<void>((resolve) => {\n        stream.onAbort(() => {\n          aborted = true;\n          clearInterval(keepAlive);\n          cleanup();\n          activeConnections.delete(sessionId);\n          log.debug({ sessionId }, 'Event stream disconnected');\n          resolve();\n        });\n      });\n    });\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"sse.js","names":[],"sources":["../../../../src/gateway/hono/sse.ts"],"sourcesContent":["import { streamSSE } from 'hono/streaming';\nimport type { Context } from 'hono';\nimport type { GatewayService } from '../service.js';\nimport { MAX_WEBCHAT_ATTACHMENT_FILE_BYTES } from '../chat-limits.js';\nimport { createLogger, updateAsyncLogContext } from '../../utils/logger.js';\nimport { stringifySSEData } from './sse-json.js';\nimport { resolveWebchatSessionKey } from '../resolve-webchat-session-key.js';\nimport type { UserTurnAttachment } from '../user-turn-input.js';\n\nconst log = createLogger('Gateway:SSE');\n\n// Active SSE connections tracking for connection limiting\nconst activeConnections = new Map<string, AbortController>();\n\nexport interface SSEHandlerConfig {\n  service: GatewayService;\n  maxSseConnections?: number;\n}\n\n// Type validation for agent request body\ninterface AgentRequestBody {\n  message: string;\n  channel?: string;\n  sessionKey?: string;\n  /** Epoch ms when the client started this send (abort cutoff / stale POST drop). */\n  clientCreatedAtMs?: number;\n  thinking?: string;\n  attachments?: UserTurnAttachment[];\n}\n\nfunction isValidAgentRequest(body: unknown): body is AgentRequestBody {\n  if (!body || typeof body !== 'object') return false;\n  const b = body as Record<string, unknown>;\n  // Allow empty message if attachments are provided\n  const hasMessage = typeof b.message === 'string';\n  const hasAttachments = Array.isArray(b.attachments) && b.attachments.length > 0;\n  return hasMessage || hasAttachments;\n}\n\n/** Max base64 character length that can decode to `MAX_WEBCHAT_ATTACHMENT_FILE_BYTES`. */\nfunction maxBase64CharsForBinary(maxBinaryBytes: number): number {\n  return 4 * Math.ceil(maxBinaryBytes / 3);\n}\n\n/**\n * POST /api/agent — Send a message to the agent, stream response via SSE.\n *\n * Request body: { message, channel?, sessionKey, attachments? }\n * Accept: text/event-stream → SSE stream\n * Accept: application/json → wait for full response, return JSON\n *\n * SSE events follow XOPC Chat Stream Protocol v1:\n *   run_start, user_message, user_transcript, assistant_message_start,\n *   assistant_delta, thinking_delta, thinking_end, tool_start, tool_update,\n *   tool_end, assistant_message_end, compaction, tts_audio, clarify_request,\n *   run_end, error.\n */\nexport function createAgentSSEHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => null);\n\n    // Input validation\n    if (!isValidAgentRequest(body)) {\n      return c.json({\n        ok: false,\n        error: { code: 'BAD_REQUEST', message: 'Missing required field: message or attachments' }\n      }, 400);\n    }\n\n    const { message, channel = 'webchat', attachments, thinking } = body;\n    const clientCreatedAtMs =\n      typeof body.clientCreatedAtMs === 'number' && Number.isFinite(body.clientCreatedAtMs)\n        ? body.clientCreatedAtMs\n        : undefined;\n    const resolved = resolveWebchatSessionKey({\n      sessionKey: typeof body.sessionKey === 'string' ? body.sessionKey : undefined,\n    });\n    if (resolved.ok === false) {\n      return c.json({\n        ok: false,\n        error: { code: 'BAD_REQUEST', message: resolved.error },\n      }, 400);\n    }\n    const chatId = resolved.sessionKey;\n\n    updateAsyncLogContext({ sessionKey: String(chatId) });\n\n    if (Array.isArray(attachments)) {\n      const maxDataChars = maxBase64CharsForBinary(MAX_WEBCHAT_ATTACHMENT_FILE_BYTES);\n      for (const a of attachments) {\n        if (!a || typeof a !== 'object') continue;\n        const data = (a as { data?: unknown }).data;\n        if (typeof data === 'string' && data.length > maxDataChars) {\n          return c.json(\n            {\n              ok: false,\n              error: {\n                code: 'BAD_REQUEST',\n                message: `Attachment exceeds maximum size (${MAX_WEBCHAT_ATTACHMENT_FILE_BYTES} bytes)`,\n              },\n            },\n            400,\n          );\n        }\n      }\n    }\n\n    const accept = c.req.header('Accept') || '';\n    const wantSSE = accept.includes('text/event-stream');\n\n    const clientAbort = new AbortController();\n    const raw = c.req.raw;\n    // Keep webchat runs alive across transient disconnects (page refresh / tab route switch)\n    // so the client can reattach via /api/agent/resume using runId from `run_start`.\n    // Explicit cancellation still goes through /api/agent/abort.\n    if (channel !== 'webchat') {\n      if (raw.signal.aborted) {\n        clientAbort.abort();\n      } else {\n        raw.signal.addEventListener('abort', () => clientAbort.abort(), { once: true });\n      }\n    }\n\n    // --- Non-streaming fallback: collect everything, return JSON ---\n    if (!wantSSE) {\n      const jsonSessionKey = channel === 'webchat' ? chatId : undefined;\n\n      const generator = service.runAgent(message, channel, chatId, attachments, thinking, {\n        signal: clientAbort.signal,\n        ...(clientCreatedAtMs !== undefined ? { clientCreatedAtMs } : {}),\n      });\n      try {\n        let finalResult: { status: string; summary: string } | undefined;\n        const tokens: string[] = [];\n\n        while (true) {\n          const { done, value } = await generator.next();\n          if (done) {\n            finalResult = value as { status: string; summary: string };\n            break;\n          }\n          const chunk = value as { type: string; payload?: { delta?: unknown } };\n          if (chunk.type === 'assistant_delta' && typeof chunk.payload?.delta === 'string') {\n            tokens.push(chunk.payload.delta);\n          }\n        }\n\n        return c.json({\n          ok: true,\n          payload: {\n            ...finalResult,\n            content: tokens.join(''),\n            ...(jsonSessionKey !== undefined\n              ? { sessionKey: jsonSessionKey, key: jsonSessionKey }\n              : {}),\n          },\n        });\n      } catch (error) {\n        const em = error instanceof Error ? error.message : String(error);\n        log.error(\n          { err: error, errorMessage: em, phase: 'gateway.agent_run', sessionKey: jsonSessionKey, channel },\n          `Agent run failed (JSON mode): ${em}`,\n        );\n        return c.json({\n          ok: false,\n          error: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n        }, 500);\n      }\n    }\n\n    // --- SSE streaming ---\n    c.header('X-Accel-Buffering', 'no');\n    return streamSSE(c, async (stream) => {\n      if (channel !== 'webchat') {\n        stream.onAbort(() => {\n          clientAbort.abort();\n        });\n      }\n\n      const generator = service.runAgent(message, channel, chatId, attachments, thinking, {\n        signal: clientAbort.signal,\n        ...(clientCreatedAtMs !== undefined ? { clientCreatedAtMs } : {}),\n      });\n\n      let eventId = 0;\n\n      try {\n        while (true) {\n          const { done, value } = await generator.next();\n\n          if (done) break;\n\n          const chunk = value as { type: string; seq?: unknown };\n          await stream.writeSSE({\n            id: typeof chunk.seq === 'number' ? String(chunk.seq) : String(++eventId),\n            event: chunk.type || 'message',\n            data: stringifySSEData(chunk),\n          });\n        }\n      } catch (error) {\n        log.error({ err: error }, 'Agent run failed (SSE mode)');\n        await stream.writeSSE({\n          id: String(++eventId),\n          event: 'error',\n          data: stringifySSEData({\n            type: 'error',\n            runId: 'unknown',\n            sessionKey: chatId,\n            timestamp: Date.now(),\n            payload: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n          }),\n        });\n      }\n    });\n  };\n}\n\n/**\n * POST /api/agent/resume — Re-attach to an in-progress agent run via SSE.\n *\n * Request body: { runId, sessionKey }\n * The relay replays all buffered events from the beginning and then live-tails\n * until the run completes.\n *\n * SSE events are identical to those from POST /api/agent.\n */\nexport function createAgentResumeHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => null);\n    if (!body || typeof body !== 'object') {\n      return c.json({ ok: false, error: { code: 'BAD_REQUEST', message: 'Invalid JSON body' } }, 400);\n    }\n\n    const { runId, sessionKey } = body as { runId?: string; sessionKey?: string };\n    if (typeof sessionKey === 'string' && sessionKey.trim()) {\n      updateAsyncLogContext({ sessionKey: sessionKey.trim() });\n    }\n    if (!runId || typeof runId !== 'string') {\n      return c.json({ ok: false, error: { code: 'BAD_REQUEST', message: 'Missing required field: runId' } }, 400);\n    }\n\n    if (!service.runRelay.hasRun(runId)) {\n      return c.json({ ok: false, error: { code: 'NOT_FOUND', message: 'Run not found or already expired' } }, 404);\n    }\n\n    c.header('X-Accel-Buffering', 'no');\n    return streamSSE(c, async (stream) => {\n      let eventId = 0;\n      try {\n        for await (const event of service.runRelay.subscribe(runId)) {\n          await stream.writeSSE({\n            id: typeof event.seq === 'number' ? String(event.seq) : String(++eventId),\n            event: event.type || 'message',\n            data: stringifySSEData(event),\n          });\n        }\n      } catch (error) {\n        log.error({ err: error, runId }, 'Resume stream failed');\n        await stream.writeSSE({\n          id: String(++eventId),\n          event: 'error',\n          data: stringifySSEData({\n            type: 'error',\n            runId,\n            sessionKey: typeof sessionKey === 'string' ? sessionKey : '',\n            timestamp: Date.now(),\n            payload: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' },\n          }),\n        });\n      }\n    });\n  };\n}\n\n/**\n * POST /api/send — Send a message through a channel (non-streaming).\n */\nexport function createSendHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n\n  return async (c: Context) => {\n    const body = await c.req.json().catch(() => ({}));\n    const channel = body.channel as string;\n    const chatId = body.chatId as string;\n    const content = body.content as string;\n\n    if (!channel || !chatId || !content) {\n      return c.json(\n        { ok: false, error: { code: 'BAD_REQUEST', message: 'Missing required fields: channel, chatId, content' } },\n        400,\n      );\n    }\n\n    try {\n      const result = await service.sendMessage(channel, chatId, content);\n      return c.json({ ok: true, payload: result });\n    } catch (error) {\n      log.error({ err: error }, 'Send failed');\n      return c.json(\n        { ok: false, error: { code: 'INTERNAL_ERROR', message: error instanceof Error ? error.message : 'Unknown error' } },\n        500,\n      );\n    }\n  };\n}\n\n/**\n * GET /api/events — Server-pushed event stream (SSE).\n *\n * The client opens this long-lived connection to receive:\n *   - channel status changes\n *   - config reload notifications\n *   - cron execution results\n *   - any other server-initiated events\n *\n * Supports Last-Event-ID for reconnection.\n * Enforces maximum connection limit to prevent DoS.\n */\nexport function createEventsSSEHandler(config: SSEHandlerConfig) {\n  const { service } = config;\n  const maxConnections = config.maxSseConnections ?? 100;\n\n  return async (c: Context) => {\n    // Check maximum connections limit\n    if (activeConnections.size >= maxConnections) {\n      log.warn({ current: activeConnections.size, max: maxConnections }, 'SSE connection limit reached');\n      return c.json({\n        ok: false,\n        error: { code: 'TOO_MANY_CONNECTIONS', message: 'Maximum SSE connections exceeded' }\n      }, 503);\n    }\n\n    const lastEventId = c.req.header('Last-Event-ID') || undefined;\n    const sessionId = c.req.header('X-Session-Id')\n      || c.req.query('sessionId')\n      || crypto.randomUUID();\n\n    updateAsyncLogContext({ sessionId: String(sessionId) });\n\n    const abortController = new AbortController();\n    activeConnections.set(sessionId, abortController);\n\n    return streamSSE(c, async (stream) => {\n      let aborted = false;\n\n      // Send a hello event so the client knows the stream is established\n      await stream.writeSSE({\n        id: '0',\n        event: 'connected',\n        data: JSON.stringify({ sessionId }),\n      });\n\n      // Subscribe to service events\n      const cleanup = service.subscribe(sessionId, async (event) => {\n        if (aborted) return;\n        try {\n          await stream.writeSSE({\n            id: event.id,\n            event: event.type,\n            data: JSON.stringify(event.payload),\n          });\n        } catch {\n          // Stream closed, will be cleaned up by onAbort\n        }\n      });\n\n      // Replay missed events on reconnect\n      if (lastEventId) {\n        const missed = service.getEventsSince(sessionId, lastEventId);\n        for (const event of missed) {\n          await stream.writeSSE({\n            id: event.id,\n            event: event.type,\n            data: JSON.stringify(event.payload),\n          });\n        }\n      }\n\n      // Keep alive with periodic comments (every 30s)\n      const keepAlive = setInterval(async () => {\n        if (aborted) { clearInterval(keepAlive); return; }\n        try {\n          await stream.writeSSE({ event: 'ping', data: '' });\n        } catch {\n          clearInterval(keepAlive);\n        }\n      }, 30_000);\n\n      // Block until aborted — streamSSE closes when the callback returns\n      await new Promise<void>((resolve) => {\n        stream.onAbort(() => {\n          aborted = true;\n          clearInterval(keepAlive);\n          cleanup();\n          activeConnections.delete(sessionId);\n          log.debug({ sessionId }, 'Event stream disconnected');\n          resolve();\n        });\n      });\n    });\n  };\n}\n"],"mappings":"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"}

package/dist/src/gateway/rate-limit/buckets.d.ts

@@ -35,6 +35,7 @@ declare class BucketRegistry {
     private authFailureLimiter?;
     private authFailureSignature?;
     private strictApiLimiter?;
+    private channelApiLimiter?;
     private tunnelMutateLimiter?;
     private pairingExchangeLimiter?;
     private sharePublicShortLimiter?;
@@ -47,6 +48,8 @@ declare class BucketRegistry {
     authFailure(cfg: ResolvedAuthRateLimitConfig): FailureLimiter;
     /** Sensitive admin / mutation endpoints — 15 req / 60 s per client IP. */
     strictApi(): RateLimiter;
+    /** Channel mutation/action endpoints — 20 req / 60 s per client IP. */
+    channelApi(): RateLimiter;
     /** Tunnel mutation calls — 12 req / 5 min per gateway-token fingerprint. */
     tunnelMutate(): RateLimiter;
     /** Failed pairing-exchange attempts — 30 failures / 5 min per client IP. */

package/dist/src/gateway/rate-limit/buckets.js

@@ -47,6 +47,7 @@ var BucketRegistry = class {
 	authFailureLimiter;
 	authFailureSignature;
 	strictApiLimiter;
+	channelApiLimiter;
 	tunnelMutateLimiter;
 	pairingExchangeLimiter;
 	sharePublicShortLimiter;
@@ -78,6 +79,14 @@ var BucketRegistry = class {
 		});
 		return this.strictApiLimiter;
 	}
+	/** Channel mutation/action endpoints — 20 req / 60 s per client IP. */
+	channelApi() {
+		if (!this.channelApiLimiter) this.channelApiLimiter = new RateLimiter({
+			maxRequests: 20,
+			windowMs: 6e4
+		});
+		return this.channelApiLimiter;
+	}
 	/** Tunnel mutation calls — 12 req / 5 min per gateway-token fingerprint. */
 	tunnelMutate() {
 		if (!this.tunnelMutateLimiter) this.tunnelMutateLimiter = new RateLimiter({
@@ -114,12 +123,14 @@ var BucketRegistry = class {
 	destroyAll() {
 		this.authFailureLimiter?.destroy();
 		this.strictApiLimiter?.destroy();
+		this.channelApiLimiter?.destroy();
 		this.tunnelMutateLimiter?.destroy();
 		this.pairingExchangeLimiter?.destroy();
 		this.sharePublicShortLimiter?.destroy();
 		this.sharePublicLongLimiter?.destroy();
 		this.authFailureLimiter = void 0;
 		this.strictApiLimiter = void 0;
+		this.channelApiLimiter = void 0;
 		this.tunnelMutateLimiter = void 0;
 		this.pairingExchangeLimiter = void 0;
 		this.sharePublicShortLimiter = void 0;
@@ -130,6 +141,7 @@ var BucketRegistry = class {
 	resetAllForTests() {
 		this.authFailureLimiter?.resetForTests();
 		this.strictApiLimiter?.resetForTests();
+		this.channelApiLimiter?.resetForTests();
 		this.tunnelMutateLimiter?.resetForTests();
 		this.pairingExchangeLimiter?.resetForTests();
 		this.sharePublicShortLimiter?.resetForTests();

package/dist/src/gateway/rate-limit/buckets.js.map

@@ -1 +1 @@
-{"version":3,"file":"buckets.js","names":[],"sources":["../../../../src/gateway/rate-limit/buckets.ts"],"sourcesContent":["/**\n * Named rate-limit buckets used across the gateway. Each is a thin wrapper\n * over a primitive limiter ({@link RateLimiter} or {@link FailureLimiter})\n * that hard-codes its config and exposes a small surface.\n *\n * All buckets are owned by a process-level singleton {@link BucketRegistry}\n * so that:\n *   - lifecycle (cleanup timers) is centralized — `destroyAll()` on shutdown,\n *   - tests get one obvious reset entry point (`resetAllForTests`),\n *   - new buckets are added in exactly one place.\n *\n * Tuning policy:\n *   - `auth_failure` is read from runtime config because users tune it per\n *     deployment. Other buckets keep static defaults until a real need\n *     emerges to expose them. (YAGNI > premature configurability.)\n */\n\nimport { FailureLimiter, RateLimiter } from '../../infra/rate-limit/index.js';\n\nimport type { GatewayAuthRateLimitConfig } from '../../config/schema.js';\nimport type { AuthRateLimitPolicyConfig } from './auth-policy.js';\n\n/**\n * Auth-failure config validated/normalized into the shape both the limiter\n * primitive and the policy layer need.\n */\nexport type ResolvedAuthRateLimitConfig = {\n  enabled: boolean;\n  maxFailures: number;\n  windowMs: number;\n  blockDurationMs: number;\n  burstCoalesceMs: number;\n  exemptLoopback: boolean;\n};\n\nconst DEFAULT_AUTH_RATE_LIMIT: ResolvedAuthRateLimitConfig = {\n  enabled: true,\n  maxFailures: 5,\n  windowMs: 15 * 60 * 1000,\n  blockDurationMs: 5 * 60 * 1000,\n  burstCoalesceMs: 1000,\n  exemptLoopback: true,\n};\n\nexport function resolveAuthRateLimit(\n  input: GatewayAuthRateLimitConfig | undefined,\n): ResolvedAuthRateLimitConfig {\n  if (!input) return { ...DEFAULT_AUTH_RATE_LIMIT };\n  const blockDurationMs =\n    input.blockDurationMs ?? input.lockoutMs ?? DEFAULT_AUTH_RATE_LIMIT.blockDurationMs;\n  return {\n    enabled: input.enabled ?? DEFAULT_AUTH_RATE_LIMIT.enabled,\n    maxFailures: Math.max(1, Math.floor(input.maxAttempts ?? DEFAULT_AUTH_RATE_LIMIT.maxFailures)),\n    windowMs: Math.max(1000, Math.floor(input.windowMs ?? DEFAULT_AUTH_RATE_LIMIT.windowMs)),\n    blockDurationMs: Math.max(1000, Math.floor(blockDurationMs)),\n    burstCoalesceMs: Math.max(\n      0,\n      Math.floor(input.burstCoalesceMs ?? DEFAULT_AUTH_RATE_LIMIT.burstCoalesceMs),\n    ),\n    exemptLoopback: input.exemptLoopback ?? DEFAULT_AUTH_RATE_LIMIT.exemptLoopback,\n  };\n}\n\nexport function authPolicyConfig(\n  cfg: ResolvedAuthRateLimitConfig,\n): AuthRateLimitPolicyConfig {\n  return { enabled: cfg.enabled, exemptLoopback: cfg.exemptLoopback };\n}\n\nclass BucketRegistry {\n  private authFailureLimiter?: FailureLimiter;\n  private authFailureSignature?: string;\n\n  private strictApiLimiter?: RateLimiter;\n  private tunnelMutateLimiter?: RateLimiter;\n  private pairingExchangeLimiter?: FailureLimiter;\n  private sharePublicShortLimiter?: RateLimiter;\n  private sharePublicLongLimiter?: RateLimiter;\n\n  /**\n   * Reconfigured on the fly when `gateway.auth.rateLimit` is reloaded —\n   * compares a stable signature to avoid swapping out a hot bucket on every\n   * config read.\n   */\n  authFailure(cfg: ResolvedAuthRateLimitConfig): FailureLimiter {\n    const sig = `${cfg.maxFailures}|${cfg.windowMs}|${cfg.blockDurationMs}|${cfg.burstCoalesceMs}`;\n    if (!this.authFailureLimiter || this.authFailureSignature !== sig) {\n      this.authFailureLimiter?.destroy();\n      this.authFailureLimiter = new FailureLimiter({\n        maxFailures: cfg.maxFailures,\n        windowMs: cfg.windowMs,\n        blockDurationMs: cfg.blockDurationMs,\n        burstCoalesceMs: cfg.burstCoalesceMs,\n      });\n      this.authFailureSignature = sig;\n    }\n    return this.authFailureLimiter;\n  }\n\n  /** Sensitive admin / mutation endpoints — 15 req / 60 s per client IP. */\n  strictApi(): RateLimiter {\n    if (!this.strictApiLimiter) {\n      this.strictApiLimiter = new RateLimiter({ maxRequests: 15, windowMs: 60_000 });\n    }\n    return this.strictApiLimiter;\n  }\n\n  /** Tunnel mutation calls — 12 req / 5 min per gateway-token fingerprint. */\n  tunnelMutate(): RateLimiter {\n    if (!this.tunnelMutateLimiter) {\n      this.tunnelMutateLimiter = new RateLimiter({\n        maxRequests: 12,\n        windowMs: 5 * 60_000,\n      });\n    }\n    return this.tunnelMutateLimiter;\n  }\n\n  /** Failed pairing-exchange attempts — 30 failures / 5 min per client IP. */\n  pairingExchange(): FailureLimiter {\n    if (!this.pairingExchangeLimiter) {\n      this.pairingExchangeLimiter = new FailureLimiter({\n        maxFailures: 30,\n        windowMs: 5 * 60_000,\n        blockDurationMs: 5 * 60_000,\n      });\n    }\n    return this.pairingExchangeLimiter;\n  }\n\n  /** Public share download short window — 60 req / min per client IP. */\n  sharePublicShort(): RateLimiter {\n    if (!this.sharePublicShortLimiter) {\n      this.sharePublicShortLimiter = new RateLimiter({\n        maxRequests: 60,\n        windowMs: 60_000,\n      });\n    }\n    return this.sharePublicShortLimiter;\n  }\n\n  /** Public share download long window — 300 req / 15 min per client IP. */\n  sharePublicLong(): RateLimiter {\n    if (!this.sharePublicLongLimiter) {\n      this.sharePublicLongLimiter = new RateLimiter({\n        maxRequests: 300,\n        windowMs: 15 * 60_000,\n      });\n    }\n    return this.sharePublicLongLimiter;\n  }\n\n  destroyAll(): void {\n    this.authFailureLimiter?.destroy();\n    this.strictApiLimiter?.destroy();\n    this.tunnelMutateLimiter?.destroy();\n    this.pairingExchangeLimiter?.destroy();\n    this.sharePublicShortLimiter?.destroy();\n    this.sharePublicLongLimiter?.destroy();\n    this.authFailureLimiter = undefined;\n    this.strictApiLimiter = undefined;\n    this.tunnelMutateLimiter = undefined;\n    this.pairingExchangeLimiter = undefined;\n    this.sharePublicShortLimiter = undefined;\n    this.sharePublicLongLimiter = undefined;\n    this.authFailureSignature = undefined;\n  }\n\n  /** @internal */\n  resetAllForTests(): void {\n    this.authFailureLimiter?.resetForTests();\n    this.strictApiLimiter?.resetForTests();\n    this.tunnelMutateLimiter?.resetForTests();\n    this.pairingExchangeLimiter?.resetForTests();\n    this.sharePublicShortLimiter?.resetForTests();\n    this.sharePublicLongLimiter?.resetForTests();\n  }\n}\n\nexport const buckets = new BucketRegistry();\n"],"mappings":"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"}
+{"version":3,"file":"buckets.js","names":[],"sources":["../../../../src/gateway/rate-limit/buckets.ts"],"sourcesContent":["/**\n * Named rate-limit buckets used across the gateway. Each is a thin wrapper\n * over a primitive limiter ({@link RateLimiter} or {@link FailureLimiter})\n * that hard-codes its config and exposes a small surface.\n *\n * All buckets are owned by a process-level singleton {@link BucketRegistry}\n * so that:\n *   - lifecycle (cleanup timers) is centralized — `destroyAll()` on shutdown,\n *   - tests get one obvious reset entry point (`resetAllForTests`),\n *   - new buckets are added in exactly one place.\n *\n * Tuning policy:\n *   - `auth_failure` is read from runtime config because users tune it per\n *     deployment. Other buckets keep static defaults until a real need\n *     emerges to expose them. (YAGNI > premature configurability.)\n */\n\nimport { FailureLimiter, RateLimiter } from '../../infra/rate-limit/index.js';\n\nimport type { GatewayAuthRateLimitConfig } from '../../config/schema.js';\nimport type { AuthRateLimitPolicyConfig } from './auth-policy.js';\n\n/**\n * Auth-failure config validated/normalized into the shape both the limiter\n * primitive and the policy layer need.\n */\nexport type ResolvedAuthRateLimitConfig = {\n  enabled: boolean;\n  maxFailures: number;\n  windowMs: number;\n  blockDurationMs: number;\n  burstCoalesceMs: number;\n  exemptLoopback: boolean;\n};\n\nconst DEFAULT_AUTH_RATE_LIMIT: ResolvedAuthRateLimitConfig = {\n  enabled: true,\n  maxFailures: 5,\n  windowMs: 15 * 60 * 1000,\n  blockDurationMs: 5 * 60 * 1000,\n  burstCoalesceMs: 1000,\n  exemptLoopback: true,\n};\n\nexport function resolveAuthRateLimit(\n  input: GatewayAuthRateLimitConfig | undefined,\n): ResolvedAuthRateLimitConfig {\n  if (!input) return { ...DEFAULT_AUTH_RATE_LIMIT };\n  const blockDurationMs =\n    input.blockDurationMs ?? input.lockoutMs ?? DEFAULT_AUTH_RATE_LIMIT.blockDurationMs;\n  return {\n    enabled: input.enabled ?? DEFAULT_AUTH_RATE_LIMIT.enabled,\n    maxFailures: Math.max(1, Math.floor(input.maxAttempts ?? DEFAULT_AUTH_RATE_LIMIT.maxFailures)),\n    windowMs: Math.max(1000, Math.floor(input.windowMs ?? DEFAULT_AUTH_RATE_LIMIT.windowMs)),\n    blockDurationMs: Math.max(1000, Math.floor(blockDurationMs)),\n    burstCoalesceMs: Math.max(\n      0,\n      Math.floor(input.burstCoalesceMs ?? DEFAULT_AUTH_RATE_LIMIT.burstCoalesceMs),\n    ),\n    exemptLoopback: input.exemptLoopback ?? DEFAULT_AUTH_RATE_LIMIT.exemptLoopback,\n  };\n}\n\nexport function authPolicyConfig(\n  cfg: ResolvedAuthRateLimitConfig,\n): AuthRateLimitPolicyConfig {\n  return { enabled: cfg.enabled, exemptLoopback: cfg.exemptLoopback };\n}\n\nclass BucketRegistry {\n  private authFailureLimiter?: FailureLimiter;\n  private authFailureSignature?: string;\n\n  private strictApiLimiter?: RateLimiter;\n  private channelApiLimiter?: RateLimiter;\n  private tunnelMutateLimiter?: RateLimiter;\n  private pairingExchangeLimiter?: FailureLimiter;\n  private sharePublicShortLimiter?: RateLimiter;\n  private sharePublicLongLimiter?: RateLimiter;\n\n  /**\n   * Reconfigured on the fly when `gateway.auth.rateLimit` is reloaded —\n   * compares a stable signature to avoid swapping out a hot bucket on every\n   * config read.\n   */\n  authFailure(cfg: ResolvedAuthRateLimitConfig): FailureLimiter {\n    const sig = `${cfg.maxFailures}|${cfg.windowMs}|${cfg.blockDurationMs}|${cfg.burstCoalesceMs}`;\n    if (!this.authFailureLimiter || this.authFailureSignature !== sig) {\n      this.authFailureLimiter?.destroy();\n      this.authFailureLimiter = new FailureLimiter({\n        maxFailures: cfg.maxFailures,\n        windowMs: cfg.windowMs,\n        blockDurationMs: cfg.blockDurationMs,\n        burstCoalesceMs: cfg.burstCoalesceMs,\n      });\n      this.authFailureSignature = sig;\n    }\n    return this.authFailureLimiter;\n  }\n\n  /** Sensitive admin / mutation endpoints — 15 req / 60 s per client IP. */\n  strictApi(): RateLimiter {\n    if (!this.strictApiLimiter) {\n      this.strictApiLimiter = new RateLimiter({ maxRequests: 15, windowMs: 60_000 });\n    }\n    return this.strictApiLimiter;\n  }\n\n  /** Channel mutation/action endpoints — 20 req / 60 s per client IP. */\n  channelApi(): RateLimiter {\n    if (!this.channelApiLimiter) {\n      this.channelApiLimiter = new RateLimiter({ maxRequests: 20, windowMs: 60_000 });\n    }\n    return this.channelApiLimiter;\n  }\n\n  /** Tunnel mutation calls — 12 req / 5 min per gateway-token fingerprint. */\n  tunnelMutate(): RateLimiter {\n    if (!this.tunnelMutateLimiter) {\n      this.tunnelMutateLimiter = new RateLimiter({\n        maxRequests: 12,\n        windowMs: 5 * 60_000,\n      });\n    }\n    return this.tunnelMutateLimiter;\n  }\n\n  /** Failed pairing-exchange attempts — 30 failures / 5 min per client IP. */\n  pairingExchange(): FailureLimiter {\n    if (!this.pairingExchangeLimiter) {\n      this.pairingExchangeLimiter = new FailureLimiter({\n        maxFailures: 30,\n        windowMs: 5 * 60_000,\n        blockDurationMs: 5 * 60_000,\n      });\n    }\n    return this.pairingExchangeLimiter;\n  }\n\n  /** Public share download short window — 60 req / min per client IP. */\n  sharePublicShort(): RateLimiter {\n    if (!this.sharePublicShortLimiter) {\n      this.sharePublicShortLimiter = new RateLimiter({\n        maxRequests: 60,\n        windowMs: 60_000,\n      });\n    }\n    return this.sharePublicShortLimiter;\n  }\n\n  /** Public share download long window — 300 req / 15 min per client IP. */\n  sharePublicLong(): RateLimiter {\n    if (!this.sharePublicLongLimiter) {\n      this.sharePublicLongLimiter = new RateLimiter({\n        maxRequests: 300,\n        windowMs: 15 * 60_000,\n      });\n    }\n    return this.sharePublicLongLimiter;\n  }\n\n  destroyAll(): void {\n    this.authFailureLimiter?.destroy();\n    this.strictApiLimiter?.destroy();\n    this.channelApiLimiter?.destroy();\n    this.tunnelMutateLimiter?.destroy();\n    this.pairingExchangeLimiter?.destroy();\n    this.sharePublicShortLimiter?.destroy();\n    this.sharePublicLongLimiter?.destroy();\n    this.authFailureLimiter = undefined;\n    this.strictApiLimiter = undefined;\n    this.channelApiLimiter = undefined;\n    this.tunnelMutateLimiter = undefined;\n    this.pairingExchangeLimiter = undefined;\n    this.sharePublicShortLimiter = undefined;\n    this.sharePublicLongLimiter = undefined;\n    this.authFailureSignature = undefined;\n  }\n\n  /** @internal */\n  resetAllForTests(): void {\n    this.authFailureLimiter?.resetForTests();\n    this.strictApiLimiter?.resetForTests();\n    this.channelApiLimiter?.resetForTests();\n    this.tunnelMutateLimiter?.resetForTests();\n    this.pairingExchangeLimiter?.resetForTests();\n    this.sharePublicShortLimiter?.resetForTests();\n    this.sharePublicLongLimiter?.resetForTests();\n  }\n}\n\nexport const buckets = new BucketRegistry();\n"],"mappings":"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"}