@xopcai/xopc 0.0.103 → 0.0.104

package/dist/src/workflows/service/workflow-run-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-run-service.js","names":["resolveModelById"],"sources":["../../../../src/workflows/service/workflow-run-service.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport type { BuildChildToolsOptions } from '../../agent/child-agent-factory.js';\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport { resolveModelRef } from '../../config/agent-typed-models.js';\nimport type { GatewayWorkflowHost } from '../../gateway/gateway-workflow-host.types.js';\nimport { resolveModel as resolveModelById } from '../../providers/index.js';\nimport { createWorkflowCatalog } from '../../agent/workflow/catalog.js';\nimport { DelegateSubagentRunner } from '../../agent/workflow/subagent-runner.js';\nimport type {\n  WorkflowDefinition,\n  WorkflowRunDefinitionSnapshot,\n  WorkflowRunInputEnvelope,\n  WorkflowRunMetadata,\n  WorkflowRunSource,\n} from '../domain/index.js';\nimport { buildWorkflowDefinition, isTerminalWorkflowRunStatus } from '../domain/index.js';\nimport { WorkflowEngine } from '../engine/index.js';\nimport { WorkflowEventStore } from '../store/event-store.js';\nimport { WorkflowRunStore } from '../store/run-store.js';\nimport type { WorkflowSessionBridge } from './workflow-session-bridge.js';\nexport type {\n  CancelWorkflowRunResult,\n  CancelWorkflowRunServiceParams,\n  CancelWorkflowRunServiceResult,\n  RetryWorkflowRunServiceParams,\n  StartWorkflowRunServiceParams,\n  StartWorkflowRunServiceResult,\n  WorkflowRunServiceErrorCode,\n  WorkflowRunServiceErrorResult,\n  WorkflowRunServiceResult,\n} from './workflow-run-service.types.js';\n\nimport type {\n  CancelWorkflowRunResult,\n  CancelWorkflowRunServiceParams,\n  RetryWorkflowRunServiceParams,\n  StartWorkflowRunServiceParams,\n  WorkflowRunServiceResult,\n} from './workflow-run-service.types.js';\n\nexport interface WorkflowRunServiceOptions {\n  service: GatewayWorkflowHost;\n  sessionBridge: WorkflowSessionBridge;\n  buildChildTools: (childOptions: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class WorkflowRunService {\n  private readonly activeRuns = new Map<string, AbortController>();\n\n  constructor(private readonly options: WorkflowRunServiceOptions) {}\n\n  async startWorkflowRun(params: StartWorkflowRunServiceParams): Promise<WorkflowRunServiceResult> {\n    const definition = this.loadDefinition(params.definitionId);\n    if (!definition) {\n      return {\n        ok: false,\n        code: 'definition_not_found',\n        message: 'Workflow definition not found',\n        httpStatus: 404,\n      };\n    }\n\n    const runId = randomUUID();\n    const goal = params.goal ?? '';\n    const { sessionKey } = await this.options.sessionBridge.prepareRunSession({\n      runId,\n      agentId: params.agentId,\n      definitionId: params.definitionId,\n      definitionTitle: definition.title,\n      goal,\n      parentSessionKey: params.parentSessionKey,\n    });\n    const source = normalizeWorkflowRunSourceForSession(params.source, sessionKey, params.parentSessionKey);\n    const abortController = new AbortController();\n    const eventStore = new WorkflowEventStore(this.options.service.currentConfig, params.agentId);\n    const runStore = new WorkflowRunStore(this.options.service.currentConfig, params.agentId, eventStore);\n    const engine = this.createWorkflowEngine({\n      eventStore,\n      runStore,\n      sessionKey,\n    });\n    const inputEnvelope = params.inputEnvelope ?? buildWorkflowRunInputEnvelope(params.input, params.goal);\n\n    this.activeRuns.set(runId, abortController);\n    void engine.startRun(definition, {\n      runId,\n      input: inputEnvelope.payload,\n      goal: inputEnvelope.goal ?? params.goal,\n      source,\n      metadata: buildWorkflowRunMetadata({\n        definition,\n        agentId: params.agentId,\n        sessionKey,\n        source,\n        input: inputEnvelope,\n        retryOfRunId: params.retryOfRunId,\n        idempotencyKey: params.idempotencyKey,\n      }),\n      signal: abortController.signal,\n      concurrency: params.concurrency,\n      maxSubagents: params.maxSubagents,\n      tokenBudget: params.tokenBudget,\n    }).catch((err) => {\n      this.options.service.emit('workflow.run.error', {\n        runId,\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }).finally(() => {\n      this.activeRuns.delete(runId);\n    });\n\n    return { ok: true, runId, sessionKey };\n  }\n\n  async retryWorkflowRun(params: RetryWorkflowRunServiceParams): Promise<WorkflowRunServiceResult> {\n    const runStore = this.createRunStore(params.agentId);\n    const existing = await runStore.readRunView(params.runId);\n    if (!existing) {\n      return {\n        ok: false,\n        code: 'run_not_found',\n        message: 'Workflow run not found',\n        httpStatus: 404,\n      };\n    }\n\n    const parentSessionKey =\n      existing.run.source.kind === 'chat' ? existing.run.source.sessionKey : undefined;\n\n    return this.startWorkflowRun({\n      agentId: params.agentId,\n      definitionId: existing.run.definitionId,\n      input: existing.run.input,\n      goal: existing.run.goal,\n      source: existing.run.source,\n      parentSessionKey,\n      retryOfRunId: existing.run.id,\n    });\n  }\n\n  async cancelWorkflowRun(params: CancelWorkflowRunServiceParams): Promise<CancelWorkflowRunResult> {\n    const controller = this.activeRuns.get(params.runId);\n    if (controller) {\n      controller.abort();\n      this.activeRuns.delete(params.runId);\n      return { ok: true, cancelled: true };\n    }\n\n    const runStore = this.createRunStore(params.agentId);\n    const view = await runStore.readRunView(params.runId);\n    if (!view) {\n      return {\n        ok: false,\n        code: 'run_not_found',\n        message: 'Workflow run not found',\n        httpStatus: 404,\n      };\n    }\n\n    if (isTerminalWorkflowRunStatus(view.run.status)) {\n      return { ok: true, cancelled: true, alreadyFinished: true };\n    }\n\n    const eventStore = new WorkflowEventStore(this.options.service.currentConfig, params.agentId);\n    await eventStore.append({\n      runId: params.runId,\n      type: 'run_cancelled',\n      payload: { reason: params.reason ?? 'Cancelled by user' },\n    });\n    const updated = await runStore.rebuildRunView(params.runId);\n    if (updated) {\n      this.options.service.emit('workflow.run.updated', { runId: params.runId, view: updated });\n      void this.options.sessionBridge.handleRunViewUpdated(updated);\n    }\n    return { ok: true, cancelled: true };\n  }\n\n  createRunStore(agentId: string): WorkflowRunStore {\n    const eventStore = new WorkflowEventStore(this.options.service.currentConfig, agentId);\n    return new WorkflowRunStore(this.options.service.currentConfig, agentId, eventStore);\n  }\n\n  async readWorkflowRunView(agentId: string, runId: string) {\n    return this.createRunStore(agentId).readRunView(runId);\n  }\n\n  private loadDefinition(definitionId: string): WorkflowDefinition | null {\n    const catalog = createWorkflowCatalog();\n    try {\n      const loaded = catalog.load(definitionId);\n      return buildWorkflowDefinition({\n        name: loaded.name,\n        source: loaded.source,\n        script: loaded.script,\n        meta: loaded.meta,\n      });\n    } catch {\n      return null;\n    }\n  }\n\n  private createWorkflowEngine(params: {\n    eventStore: WorkflowEventStore;\n    runStore: WorkflowRunStore;\n    sessionKey: string;\n  }): WorkflowEngine {\n    const gatewayService = this.options.service;\n    const runner = new DelegateSubagentRunner({\n      workspace: gatewayService.currentWorkspacePath,\n      bus: gatewayService.messageBusInstance,\n      getDefaultModel: () => resolveModelById(gatewayService.agentService.getModelForSession(params.sessionKey)),\n      getConfig: () => gatewayService.currentConfig,\n      buildChildTools: (childOptions) => this.options.buildChildTools(childOptions),\n    });\n\n    return new WorkflowEngine({\n      cwd: gatewayService.currentWorkspacePath,\n      eventStore: params.eventStore,\n      runStore: params.runStore,\n      runner,\n      resolveModelId: (modelId) => {\n        const agentId = extractProfileAgentId(params.sessionKey, gatewayService.currentConfig);\n        return resolveModelById(resolveModelRef(gatewayService.currentConfig, agentId, modelId));\n      },\n      onEventAppended: (event) => {\n        gatewayService.emit('workflow.event.appended', { runId: event.runId, event });\n      },\n      onRunViewUpdated: (view) => {\n        gatewayService.emit('workflow.run.updated', { runId: view.run.id, view });\n        void this.options.sessionBridge.handleRunViewUpdated(view);\n      },\n    });\n  }\n}\n\nfunction normalizeWorkflowRunSourceForSession(\n  source: WorkflowRunSource,\n  workflowSessionKey: string,\n  parentSessionKey?: string,\n): WorkflowRunSource {\n  if (parentSessionKey?.trim()) {\n    return { kind: 'chat', sessionKey: parentSessionKey.trim() };\n  }\n  if (source.kind === 'webui') {\n    return { ...source, sessionKey: workflowSessionKey };\n  }\n  if (source.kind === 'chat') {\n    return source;\n  }\n  return source;\n}\n\nexport function buildWorkflowRunInputEnvelope(input: unknown, goal?: string): WorkflowRunInputEnvelope {\n  if (isWorkflowRunInputEnvelope(input)) {\n    return input;\n  }\n  return {\n    payload: input ?? {},\n    goal,\n  };\n}\n\nexport function buildWorkflowRunMetadata(params: {\n  definition: WorkflowDefinition;\n  agentId: string;\n  sessionKey: string;\n  source: WorkflowRunSource;\n  input: WorkflowRunInputEnvelope;\n  retryOfRunId?: string;\n  idempotencyKey?: string;\n}): WorkflowRunMetadata {\n  return {\n    sessionKey: params.sessionKey,\n    triggerSource: params.source.kind,\n    agentId: params.agentId,\n    retryOfRunId: params.retryOfRunId,\n    definition: buildWorkflowRunDefinitionSnapshot(params.definition),\n    input: params.input,\n    correlation: {\n      idempotencyKey: params.idempotencyKey,\n    },\n    origin: buildWorkflowRunOrigin(params.source),\n    schedule: params.source.kind === 'cron'\n      ? { scheduleId: params.source.scheduleId, fireId: params.source.fireId }\n      : undefined,\n  };\n}\n\nexport function buildWorkflowRunDefinitionSnapshot(definition: WorkflowDefinition): WorkflowRunDefinitionSnapshot {\n  return {\n    id: definition.id,\n    name: definition.name,\n    title: definition.title,\n    version: definition.version,\n    source: definition.metadata.source,\n    tags: [...definition.metadata.tags],\n    phaseCount: definition.phases.length,\n    estimatedAgents: definition.metadata.estimatedAgents,\n  };\n}\n\nexport function extractWorkflowRunSessionKey(source: WorkflowRunSource): string | null {\n  if ('sessionKey' in source && typeof source.sessionKey === 'string' && source.sessionKey.trim()) {\n    return source.sessionKey.trim();\n  }\n  return null;\n}\n\nfunction buildWorkflowRunOrigin(source: WorkflowRunSource): WorkflowRunMetadata['origin'] {\n  switch (source.kind) {\n    case 'chat':\n      return { channel: 'chat', sessionKey: source.sessionKey, messageId: source.messageId };\n    case 'webui':\n      return { channel: 'webui', sessionKey: source.sessionKey };\n    case 'cron':\n      return { channel: 'cron', scheduleId: source.scheduleId, fireId: source.fireId };\n    case 'api':\n      return { channel: 'api', requestId: source.requestId };\n    case 'im':\n      return { channel: source.channel, chatId: source.chatId, messageId: source.messageId };\n  }\n}\n\nfunction isWorkflowRunInputEnvelope(input: unknown): input is WorkflowRunInputEnvelope {\n  if (!input || typeof input !== 'object' || Array.isArray(input)) {\n    return false;\n  }\n  return 'payload' in input || 'variables' in input || 'context' in input;\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflow-run-service.js","names":["resolveModelById"],"sources":["../../../../src/workflows/service/workflow-run-service.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport type { BuildChildToolsOptions } from '../../agent/child-agent-factory.js';\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport { resolveModelRef } from '../../config/agent-typed-models.js';\nimport type { GatewayWorkflowHost } from '../../gateway/gateway-workflow-host.types.js';\nimport { resolveModel as resolveModelById } from '../../providers/index.js';\nimport { DelegateSubagentRunner } from '../../agent/workflow/subagent-runner.js';\nimport { CatalogWorkflowDefinitionRegistry } from '../registry/catalog-workflow-definition-registry.js';\nimport type { WorkflowDefinitionRegistry } from '../registry/workflow-definition-registry.js';\nimport type {\n  WorkflowDefinition,\n  WorkflowRunDefinitionSnapshot,\n  WorkflowRunInputEnvelope,\n  WorkflowRunMetadata,\n  WorkflowRunSource,\n} from '../domain/index.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/index.js';\nimport { WorkflowEngine } from '../engine/index.js';\nimport { WorkflowEventStore } from '../store/event-store.js';\nimport { WorkflowRunStore } from '../store/run-store.js';\nimport type { WorkflowSessionBridge } from './workflow-session-bridge.js';\nexport type {\n  CancelWorkflowRunResult,\n  CancelWorkflowRunServiceParams,\n  CancelWorkflowRunServiceResult,\n  RetryWorkflowRunServiceParams,\n  StartWorkflowRunServiceParams,\n  StartWorkflowRunServiceResult,\n  WorkflowRunServiceErrorCode,\n  WorkflowRunServiceErrorResult,\n  WorkflowRunServiceResult,\n} from './workflow-run-service.types.js';\n\nimport type {\n  CancelWorkflowRunResult,\n  CancelWorkflowRunServiceParams,\n  RetryWorkflowRunServiceParams,\n  StartWorkflowRunServiceParams,\n  WorkflowRunServiceResult,\n} from './workflow-run-service.types.js';\n\nexport interface WorkflowRunServiceOptions {\n  service: GatewayWorkflowHost;\n  sessionBridge: WorkflowSessionBridge;\n  buildChildTools: (childOptions: BuildChildToolsOptions) => AgentTool<any, any>[];\n  definitionRegistry?: WorkflowDefinitionRegistry;\n}\n\nexport class WorkflowRunService {\n  private readonly activeRuns = new Map<string, AbortController>();\n  private readonly definitionRegistry: WorkflowDefinitionRegistry;\n\n  constructor(private readonly options: WorkflowRunServiceOptions) {\n    this.definitionRegistry = options.definitionRegistry ?? new CatalogWorkflowDefinitionRegistry();\n  }\n\n  async startWorkflowRun(params: StartWorkflowRunServiceParams): Promise<WorkflowRunServiceResult> {\n    const definition = await this.loadDefinition(params.definitionId);\n    if (!definition) {\n      return {\n        ok: false,\n        code: 'definition_not_found',\n        message: 'Workflow definition not found',\n        httpStatus: 404,\n      };\n    }\n\n    const runId = randomUUID();\n    const goal = params.goal ?? '';\n    const { sessionKey } = await this.options.sessionBridge.prepareRunSession({\n      runId,\n      agentId: params.agentId,\n      definitionId: params.definitionId,\n      definitionTitle: definition.title,\n      goal,\n      parentSessionKey: params.parentSessionKey,\n    });\n    const source = normalizeWorkflowRunSourceForSession(params.source, sessionKey, params.parentSessionKey);\n    const abortController = new AbortController();\n    const eventStore = new WorkflowEventStore(this.options.service.currentConfig, params.agentId);\n    const runStore = new WorkflowRunStore(this.options.service.currentConfig, params.agentId, eventStore);\n    const engine = this.createWorkflowEngine({\n      eventStore,\n      runStore,\n      sessionKey,\n    });\n    const inputEnvelope = params.inputEnvelope ?? buildWorkflowRunInputEnvelope(params.input, params.goal);\n\n    this.activeRuns.set(runId, abortController);\n    void engine.startRun(definition, {\n      runId,\n      input: inputEnvelope.payload,\n      goal: inputEnvelope.goal ?? params.goal,\n      source,\n      metadata: buildWorkflowRunMetadata({\n        definition,\n        agentId: params.agentId,\n        sessionKey,\n        source,\n        input: inputEnvelope,\n        retryOfRunId: params.retryOfRunId,\n        idempotencyKey: params.idempotencyKey,\n      }),\n      signal: abortController.signal,\n      concurrency: params.concurrency,\n      maxSubagents: params.maxSubagents,\n      tokenBudget: params.tokenBudget,\n    }).catch((err) => {\n      this.options.service.emit('workflow.run.error', {\n        runId,\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }).finally(() => {\n      this.activeRuns.delete(runId);\n    });\n\n    return { ok: true, runId, sessionKey };\n  }\n\n  async retryWorkflowRun(params: RetryWorkflowRunServiceParams): Promise<WorkflowRunServiceResult> {\n    const runStore = this.createRunStore(params.agentId);\n    const existing = await runStore.readRunView(params.runId);\n    if (!existing) {\n      return {\n        ok: false,\n        code: 'run_not_found',\n        message: 'Workflow run not found',\n        httpStatus: 404,\n      };\n    }\n\n    const parentSessionKey =\n      existing.run.source.kind === 'chat' ? existing.run.source.sessionKey : undefined;\n\n    return this.startWorkflowRun({\n      agentId: params.agentId,\n      definitionId: existing.run.definitionId,\n      input: existing.run.input,\n      goal: existing.run.goal,\n      source: existing.run.source,\n      parentSessionKey,\n      retryOfRunId: existing.run.id,\n    });\n  }\n\n  async cancelWorkflowRun(params: CancelWorkflowRunServiceParams): Promise<CancelWorkflowRunResult> {\n    const controller = this.activeRuns.get(params.runId);\n    if (controller) {\n      controller.abort();\n      this.activeRuns.delete(params.runId);\n      return { ok: true, cancelled: true };\n    }\n\n    const runStore = this.createRunStore(params.agentId);\n    const view = await runStore.readRunView(params.runId);\n    if (!view) {\n      return {\n        ok: false,\n        code: 'run_not_found',\n        message: 'Workflow run not found',\n        httpStatus: 404,\n      };\n    }\n\n    if (isTerminalWorkflowRunStatus(view.run.status)) {\n      return { ok: true, cancelled: true, alreadyFinished: true };\n    }\n\n    const eventStore = new WorkflowEventStore(this.options.service.currentConfig, params.agentId);\n    await eventStore.append({\n      runId: params.runId,\n      type: 'run_cancelled',\n      payload: { reason: params.reason ?? 'Cancelled by user' },\n    });\n    const updated = await runStore.rebuildRunView(params.runId);\n    if (updated) {\n      this.options.service.emit('workflow.run.updated', { runId: params.runId, view: updated });\n      void this.options.sessionBridge.handleRunViewUpdated(updated);\n    }\n    return { ok: true, cancelled: true };\n  }\n\n  createRunStore(agentId: string): WorkflowRunStore {\n    const eventStore = new WorkflowEventStore(this.options.service.currentConfig, agentId);\n    return new WorkflowRunStore(this.options.service.currentConfig, agentId, eventStore);\n  }\n\n  async readWorkflowRunView(agentId: string, runId: string) {\n    return this.createRunStore(agentId).readRunView(runId);\n  }\n\n  private loadDefinition(definitionId: string): Promise<WorkflowDefinition | null> {\n    return this.definitionRegistry.get(definitionId);\n  }\n\n  private createWorkflowEngine(params: {\n    eventStore: WorkflowEventStore;\n    runStore: WorkflowRunStore;\n    sessionKey: string;\n  }): WorkflowEngine {\n    const gatewayService = this.options.service;\n    const runner = new DelegateSubagentRunner({\n      workspace: gatewayService.currentWorkspacePath,\n      bus: gatewayService.messageBusInstance,\n      getDefaultModel: () => resolveModelById(gatewayService.agentService.getModelForSession(params.sessionKey)),\n      getConfig: () => gatewayService.currentConfig,\n      sessionStore: gatewayService.sessionIndexInstance.getStore(),\n      buildChildTools: (childOptions) => this.options.buildChildTools(childOptions),\n    });\n\n    return new WorkflowEngine({\n      cwd: gatewayService.currentWorkspacePath,\n      eventStore: params.eventStore,\n      runStore: params.runStore,\n      runner,\n      resolveModelId: (modelId) => {\n        const agentId = extractProfileAgentId(params.sessionKey, gatewayService.currentConfig);\n        return resolveModelById(resolveModelRef(gatewayService.currentConfig, agentId, modelId));\n      },\n      parentSessionKey: params.sessionKey,\n      subagentSessionKeyFactory: ({ runId, agentId }) => {\n        const profileAgentId = extractProfileAgentId(params.sessionKey, gatewayService.currentConfig);\n        return `agent:${profileAgentId}:workflow:${runId}:subagent:${agentId}`;\n      },\n      onEventAppended: (event) => {\n        gatewayService.emit('workflow.event.appended', { runId: event.runId, event });\n      },\n      onRunViewUpdated: (view) => {\n        gatewayService.emit('workflow.run.updated', { runId: view.run.id, view });\n        void this.options.sessionBridge.handleRunViewUpdated(view);\n      },\n    });\n  }\n}\n\nfunction normalizeWorkflowRunSourceForSession(\n  source: WorkflowRunSource,\n  workflowSessionKey: string,\n  parentSessionKey?: string,\n): WorkflowRunSource {\n  if (parentSessionKey?.trim()) {\n    return { kind: 'chat', sessionKey: parentSessionKey.trim() };\n  }\n  if (source.kind === 'webui') {\n    return { ...source, sessionKey: workflowSessionKey };\n  }\n  if (source.kind === 'chat') {\n    return source;\n  }\n  return source;\n}\n\nexport function buildWorkflowRunInputEnvelope(input: unknown, goal?: string): WorkflowRunInputEnvelope {\n  if (isWorkflowRunInputEnvelope(input)) {\n    return input;\n  }\n  return {\n    payload: input ?? {},\n    goal,\n  };\n}\n\nexport function buildWorkflowRunMetadata(params: {\n  definition: WorkflowDefinition;\n  agentId: string;\n  sessionKey: string;\n  source: WorkflowRunSource;\n  input: WorkflowRunInputEnvelope;\n  retryOfRunId?: string;\n  idempotencyKey?: string;\n}): WorkflowRunMetadata {\n  return {\n    sessionKey: params.sessionKey,\n    triggerSource: params.source.kind,\n    agentId: params.agentId,\n    retryOfRunId: params.retryOfRunId,\n    definition: buildWorkflowRunDefinitionSnapshot(params.definition),\n    input: params.input,\n    correlation: {\n      idempotencyKey: params.idempotencyKey,\n    },\n    origin: buildWorkflowRunOrigin(params.source),\n    schedule: params.source.kind === 'cron'\n      ? { scheduleId: params.source.scheduleId, fireId: params.source.fireId }\n      : undefined,\n  };\n}\n\nexport function buildWorkflowRunDefinitionSnapshot(definition: WorkflowDefinition): WorkflowRunDefinitionSnapshot {\n  return {\n    id: definition.id,\n    name: definition.name,\n    title: definition.title,\n    version: definition.version,\n    source: definition.metadata.source,\n    tags: [...definition.metadata.tags],\n    phaseCount: definition.phases.length,\n    estimatedAgents: definition.metadata.estimatedAgents,\n  };\n}\n\nexport function extractWorkflowRunSessionKey(source: WorkflowRunSource): string | null {\n  if ('sessionKey' in source && typeof source.sessionKey === 'string' && source.sessionKey.trim()) {\n    return source.sessionKey.trim();\n  }\n  return null;\n}\n\nfunction buildWorkflowRunOrigin(source: WorkflowRunSource): WorkflowRunMetadata['origin'] {\n  switch (source.kind) {\n    case 'chat':\n      return { channel: 'chat', sessionKey: source.sessionKey, messageId: source.messageId };\n    case 'webui':\n      return { channel: 'webui', sessionKey: source.sessionKey };\n    case 'cron':\n      return { channel: 'cron', scheduleId: source.scheduleId, fireId: source.fireId };\n    case 'api':\n      return { channel: 'api', requestId: source.requestId };\n    case 'im':\n      return { channel: source.channel, chatId: source.chatId, messageId: source.messageId };\n  }\n}\n\nfunction isWorkflowRunInputEnvelope(input: unknown): input is WorkflowRunInputEnvelope {\n  if (!input || typeof input !== 'object' || Array.isArray(input)) {\n    return false;\n  }\n  return 'payload' in input || 'variables' in input || 'context' in input;\n}\n"],"mappings":"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"}

package/dist/src/workflows/service/workflow-session-bridge.d.ts

@@ -1,6 +1,6 @@
 import type { GatewayWorkflowHost } from '../../gateway/gateway-workflow-host.types.js';
 import type { WorkflowRunView } from '../domain/index.js';
-export declare const WORKFLOW_SESSION_TYPE = "workflow";
+export declare const WORKFLOW_SESSION_TYPE = "workflow-run";
 export declare const WORKFLOW_RUN_LINK_CONTEXT_KIND = "workflow-run-link";
 export interface PrepareWorkflowRunSessionParams {
     runId: string;

package/dist/src/workflows/service/workflow-session-bridge.js

@@ -6,7 +6,7 @@ import { runViewToSnapshot } from "./run-view-to-snapshot.js";
 import { buildWorkflowRunSessionKey } from "./workflow-session-key.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/service/workflow-session-bridge.ts
-const WORKFLOW_SESSION_TYPE = "workflow";
+const WORKFLOW_SESSION_TYPE = "workflow-run";
 const WORKFLOW_RUN_LINK_CONTEXT_KIND = "workflow-run-link";
 var WorkflowSessionBridge = class {
 	terminalPersistedRunIds = /* @__PURE__ */ new Set();
@@ -21,6 +21,9 @@ var WorkflowSessionBridge = class {
 		await store.resolveTranscriptPath(sessionKey);
 		await store.updateMetadata(sessionKey, {
 			sessionType: WORKFLOW_SESSION_TYPE,
+			hiddenFromSessionList: true,
+			workflowRunId: params.runId,
+			workflowDefinitionId: params.definitionId,
 			name: sessionName,
 			tags: ["workflow", params.definitionId],
 			customData: {

package/dist/src/workflows/service/workflow-session-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-session-bridge.js","names":[],"sources":["../../../../src/workflows/service/workflow-session-bridge.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { GatewayWorkflowHost } from '../../gateway/gateway-workflow-host.types.js';\nimport { renderWorkflowText } from '../../agent/workflow/snapshot.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { SessionStatus } from '../../session/types.js';\nimport type { WorkflowRunView } from '../domain/index.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/index.js';\n\nimport { runViewToSnapshot } from './run-view-to-snapshot.js';\nimport { buildWorkflowRunSessionKey } from './workflow-session-key.js';\n\nexport const WORKFLOW_SESSION_TYPE = 'workflow';\nexport const WORKFLOW_RUN_LINK_CONTEXT_KIND = 'workflow-run-link';\n\nexport interface PrepareWorkflowRunSessionParams {\n  runId: string;\n  agentId: string;\n  definitionId: string;\n  definitionTitle: string;\n  goal: string;\n  parentSessionKey?: string;\n}\n\nexport interface PrepareWorkflowRunSessionResult {\n  sessionKey: string;\n}\n\nexport class WorkflowSessionBridge {\n  private readonly terminalPersistedRunIds = new Set<string>();\n\n  constructor(private readonly gateway: GatewayWorkflowHost) {}\n\n  async prepareRunSession(params: PrepareWorkflowRunSessionParams): Promise<PrepareWorkflowRunSessionResult> {\n    const sessionKey = buildWorkflowRunSessionKey(params.agentId, params.runId);\n    const goalText = formatWorkflowGoalUserMessage(params.definitionId, params.goal);\n    const sessionName = truncateSessionName(params.goal.trim() || params.definitionTitle || params.definitionId);\n\n    const store = this.gateway.sessionIndexInstance.getStore();\n    await store.resolveTranscriptPath(sessionKey);\n    await store.updateMetadata(sessionKey, {\n      sessionType: WORKFLOW_SESSION_TYPE,\n      name: sessionName,\n      tags: ['workflow', params.definitionId],\n      customData: {\n        workflowRunId: params.runId,\n        workflowDefinitionId: params.definitionId,\n        workflowGoal: params.goal,\n        ...(params.parentSessionKey ? { parentSessionKey: params.parentSessionKey } : {}),\n      },\n    });\n\n    await store.appendTranscriptMessage(sessionKey, {\n      role: 'user',\n      content: [{ type: 'text', text: goalText }],\n      timestamp: Date.now(),\n    });\n\n    if (params.parentSessionKey?.trim()) {\n      await this.writeParentRunLink({\n        parentSessionKey: params.parentSessionKey.trim(),\n        runId: params.runId,\n        workflowSessionKey: sessionKey,\n        definitionId: params.definitionId,\n        goal: params.goal,\n        status: 'running',\n      });\n    }\n\n    this.gateway.emit('session.updated', { key: sessionKey, name: sessionName });\n    return { sessionKey };\n  }\n\n  async handleRunViewUpdated(view: WorkflowRunView): Promise<void> {\n    const runId = view.run.id;\n    const sessionKey = view.run.metadata?.sessionKey?.trim();\n    if (!sessionKey || !isTerminalWorkflowRunStatus(view.run.status)) {\n      return;\n    }\n    if (this.terminalPersistedRunIds.has(runId)) {\n      return;\n    }\n    this.terminalPersistedRunIds.add(runId);\n\n    await this.persistTerminalTranscript(sessionKey, view);\n\n    const parentSessionKey = readParentSessionKey(view);\n    if (parentSessionKey) {\n      await this.writeParentRunLink({\n        parentSessionKey,\n        runId,\n        workflowSessionKey: sessionKey,\n        definitionId: view.run.definitionId,\n        goal: view.run.goal,\n        status: view.run.status,\n      });\n    }\n  }\n\n  private async persistTerminalTranscript(sessionKey: string, view: WorkflowRunView): Promise<void> {\n    const store = this.gateway.sessionIndexInstance.getStore();\n    const snapshot = runViewToSnapshot(view);\n    const toolCallId = randomUUID();\n    const completed = view.run.status === 'succeeded';\n    const resultText = renderWorkflowText(snapshot, completed, { showResultPreviews: true });\n    const envelope = {\n      content: [{ type: 'text', text: resultText }],\n      details: snapshot,\n    };\n    const isError = view.run.status === 'failed' || view.run.status === 'timeout';\n\n    await store.appendTranscriptMessage(sessionKey, {\n      role: 'assistant',\n      content: [\n        {\n          type: 'toolCall',\n          id: toolCallId,\n          name: 'workflow',\n          arguments: { name: view.run.definitionId },\n        },\n      ],\n      timestamp: Date.now(),\n    } as unknown as Parameters<SessionStore['appendTranscriptMessage']>[1]);\n\n    await store.appendTranscriptMessage(sessionKey, {\n      role: 'toolResult',\n      toolCallId,\n      content: [{ type: 'text', text: JSON.stringify(envelope) }],\n      details: snapshot,\n      isError,\n      timestamp: Date.now(),\n    } as unknown as Parameters<SessionStore['appendTranscriptMessage']>[1]);\n\n    await store.updateMetadata(sessionKey, {\n      status: SessionStatus.ACTIVE,\n    });\n  }\n\n  private async writeParentRunLink(params: {\n    parentSessionKey: string;\n    runId: string;\n    workflowSessionKey: string;\n    definitionId: string;\n    goal: string;\n    status: WorkflowRunView['run']['status'];\n  }): Promise<void> {\n    const store = this.gateway.sessionIndexInstance.getStore();\n    const text = formatParentRunLinkText(params);\n    await store.appendTranscriptContextEntry(params.parentSessionKey, {\n      kind: 'context',\n      id: `workflow-run-link:${params.runId}`,\n      text,\n      data: {\n        kind: WORKFLOW_RUN_LINK_CONTEXT_KIND,\n        runId: params.runId,\n        workflowSessionKey: params.workflowSessionKey,\n        definitionId: params.definitionId,\n        goal: params.goal,\n        status: params.status,\n      },\n      createdAt: new Date().toISOString(),\n    });\n  }\n}\n\nfunction formatWorkflowGoalUserMessage(definitionId: string, goal: string): string {\n  const trimmedGoal = goal.trim();\n  if (trimmedGoal) {\n    return `Run workflow \\`${definitionId}\\`:\\n\\n${trimmedGoal}`;\n  }\n  return `Run workflow \\`${definitionId}\\``;\n}\n\nfunction truncateSessionName(name: string): string {\n  const trimmed = name.trim();\n  if (trimmed.length <= 80) return trimmed;\n  return `${trimmed.slice(0, 77)}…`;\n}\n\nfunction readParentSessionKey(view: WorkflowRunView): string | null {\n  if (view.run.source.kind === 'chat') {\n    const originKey = view.run.source.sessionKey?.trim();\n    if (originKey) return originKey;\n  }\n  const customParent = view.run.metadata?.origin?.sessionKey?.trim();\n  if (customParent && view.run.metadata?.triggerSource === 'chat') {\n    return customParent;\n  }\n  return null;\n}\n\nexport function formatParentRunLinkText(params: {\n  definitionId: string;\n  goal: string;\n  status: WorkflowRunView['run']['status'];\n}): string {\n  const label = params.goal.trim() || params.definitionId;\n  if (params.status === 'running' || params.status === 'queued') {\n    return `Workflow \\`${params.definitionId}\\` is running: ${label}`;\n  }\n  if (params.status === 'succeeded') {\n    return `Workflow \\`${params.definitionId}\\` completed: ${label}`;\n  }\n  return `Workflow \\`${params.definitionId}\\` finished (${params.status}): ${label}`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflow-session-bridge.js","names":[],"sources":["../../../../src/workflows/service/workflow-session-bridge.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { GatewayWorkflowHost } from '../../gateway/gateway-workflow-host.types.js';\nimport { renderWorkflowText } from '../../agent/workflow/snapshot.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { SessionStatus } from '../../session/types.js';\nimport type { WorkflowRunView } from '../domain/index.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/index.js';\n\nimport { runViewToSnapshot } from './run-view-to-snapshot.js';\nimport { buildWorkflowRunSessionKey } from './workflow-session-key.js';\n\nexport const WORKFLOW_SESSION_TYPE = 'workflow-run';\nexport const WORKFLOW_RUN_LINK_CONTEXT_KIND = 'workflow-run-link';\n\nexport interface PrepareWorkflowRunSessionParams {\n  runId: string;\n  agentId: string;\n  definitionId: string;\n  definitionTitle: string;\n  goal: string;\n  parentSessionKey?: string;\n}\n\nexport interface PrepareWorkflowRunSessionResult {\n  sessionKey: string;\n}\n\nexport class WorkflowSessionBridge {\n  private readonly terminalPersistedRunIds = new Set<string>();\n\n  constructor(private readonly gateway: GatewayWorkflowHost) {}\n\n  async prepareRunSession(params: PrepareWorkflowRunSessionParams): Promise<PrepareWorkflowRunSessionResult> {\n    const sessionKey = buildWorkflowRunSessionKey(params.agentId, params.runId);\n    const goalText = formatWorkflowGoalUserMessage(params.definitionId, params.goal);\n    const sessionName = truncateSessionName(params.goal.trim() || params.definitionTitle || params.definitionId);\n\n    const store = this.gateway.sessionIndexInstance.getStore();\n    await store.resolveTranscriptPath(sessionKey);\n    await store.updateMetadata(sessionKey, {\n      sessionType: WORKFLOW_SESSION_TYPE,\n      hiddenFromSessionList: true,\n      workflowRunId: params.runId,\n      workflowDefinitionId: params.definitionId,\n      name: sessionName,\n      tags: ['workflow', params.definitionId],\n      customData: {\n        workflowRunId: params.runId,\n        workflowDefinitionId: params.definitionId,\n        workflowGoal: params.goal,\n        ...(params.parentSessionKey ? { parentSessionKey: params.parentSessionKey } : {}),\n      },\n    });\n\n    await store.appendTranscriptMessage(sessionKey, {\n      role: 'user',\n      content: [{ type: 'text', text: goalText }],\n      timestamp: Date.now(),\n    });\n\n    if (params.parentSessionKey?.trim()) {\n      await this.writeParentRunLink({\n        parentSessionKey: params.parentSessionKey.trim(),\n        runId: params.runId,\n        workflowSessionKey: sessionKey,\n        definitionId: params.definitionId,\n        goal: params.goal,\n        status: 'running',\n      });\n    }\n\n    this.gateway.emit('session.updated', { key: sessionKey, name: sessionName });\n    return { sessionKey };\n  }\n\n  async handleRunViewUpdated(view: WorkflowRunView): Promise<void> {\n    const runId = view.run.id;\n    const sessionKey = view.run.metadata?.sessionKey?.trim();\n    if (!sessionKey || !isTerminalWorkflowRunStatus(view.run.status)) {\n      return;\n    }\n    if (this.terminalPersistedRunIds.has(runId)) {\n      return;\n    }\n    this.terminalPersistedRunIds.add(runId);\n\n    await this.persistTerminalTranscript(sessionKey, view);\n\n    const parentSessionKey = readParentSessionKey(view);\n    if (parentSessionKey) {\n      await this.writeParentRunLink({\n        parentSessionKey,\n        runId,\n        workflowSessionKey: sessionKey,\n        definitionId: view.run.definitionId,\n        goal: view.run.goal,\n        status: view.run.status,\n      });\n    }\n  }\n\n  private async persistTerminalTranscript(sessionKey: string, view: WorkflowRunView): Promise<void> {\n    const store = this.gateway.sessionIndexInstance.getStore();\n    const snapshot = runViewToSnapshot(view);\n    const toolCallId = randomUUID();\n    const completed = view.run.status === 'succeeded';\n    const resultText = renderWorkflowText(snapshot, completed, { showResultPreviews: true });\n    const envelope = {\n      content: [{ type: 'text', text: resultText }],\n      details: snapshot,\n    };\n    const isError = view.run.status === 'failed' || view.run.status === 'timeout';\n\n    await store.appendTranscriptMessage(sessionKey, {\n      role: 'assistant',\n      content: [\n        {\n          type: 'toolCall',\n          id: toolCallId,\n          name: 'workflow',\n          arguments: { name: view.run.definitionId },\n        },\n      ],\n      timestamp: Date.now(),\n    } as unknown as Parameters<SessionStore['appendTranscriptMessage']>[1]);\n\n    await store.appendTranscriptMessage(sessionKey, {\n      role: 'toolResult',\n      toolCallId,\n      content: [{ type: 'text', text: JSON.stringify(envelope) }],\n      details: snapshot,\n      isError,\n      timestamp: Date.now(),\n    } as unknown as Parameters<SessionStore['appendTranscriptMessage']>[1]);\n\n    await store.updateMetadata(sessionKey, {\n      status: SessionStatus.ACTIVE,\n    });\n  }\n\n  private async writeParentRunLink(params: {\n    parentSessionKey: string;\n    runId: string;\n    workflowSessionKey: string;\n    definitionId: string;\n    goal: string;\n    status: WorkflowRunView['run']['status'];\n  }): Promise<void> {\n    const store = this.gateway.sessionIndexInstance.getStore();\n    const text = formatParentRunLinkText(params);\n    await store.appendTranscriptContextEntry(params.parentSessionKey, {\n      kind: 'context',\n      id: `workflow-run-link:${params.runId}`,\n      text,\n      data: {\n        kind: WORKFLOW_RUN_LINK_CONTEXT_KIND,\n        runId: params.runId,\n        workflowSessionKey: params.workflowSessionKey,\n        definitionId: params.definitionId,\n        goal: params.goal,\n        status: params.status,\n      },\n      createdAt: new Date().toISOString(),\n    });\n  }\n}\n\nfunction formatWorkflowGoalUserMessage(definitionId: string, goal: string): string {\n  const trimmedGoal = goal.trim();\n  if (trimmedGoal) {\n    return `Run workflow \\`${definitionId}\\`:\\n\\n${trimmedGoal}`;\n  }\n  return `Run workflow \\`${definitionId}\\``;\n}\n\nfunction truncateSessionName(name: string): string {\n  const trimmed = name.trim();\n  if (trimmed.length <= 80) return trimmed;\n  return `${trimmed.slice(0, 77)}…`;\n}\n\nfunction readParentSessionKey(view: WorkflowRunView): string | null {\n  if (view.run.source.kind === 'chat') {\n    const originKey = view.run.source.sessionKey?.trim();\n    if (originKey) return originKey;\n  }\n  const customParent = view.run.metadata?.origin?.sessionKey?.trim();\n  if (customParent && view.run.metadata?.triggerSource === 'chat') {\n    return customParent;\n  }\n  return null;\n}\n\nexport function formatParentRunLinkText(params: {\n  definitionId: string;\n  goal: string;\n  status: WorkflowRunView['run']['status'];\n}): string {\n  const label = params.goal.trim() || params.definitionId;\n  if (params.status === 'running' || params.status === 'queued') {\n    return `Workflow \\`${params.definitionId}\\` is running: ${label}`;\n  }\n  if (params.status === 'succeeded') {\n    return `Workflow \\`${params.definitionId}\\` completed: ${label}`;\n  }\n  return `Workflow \\`${params.definitionId}\\` finished (${params.status}): ${label}`;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.103",
-  "description": "The OPC workstation that grows with you: AI assistant for One Person Companies — CLI, gateway, multi-channel (Telegram/WeChat), 20+ LLM providers via pi-ai, extensions and skills.",
+  "version": "0.0.104",
+  "description": "Goal Loop OS for long-term AI work: a local-first multi-surface agent system with workflow automation, multi-agent routing, and extensibility via extensions/skills.",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -30,15 +30,22 @@
     "access": "public"
   },
   "keywords": [
-    "ai",
-    "agent",
-    "chatbot",
-    "personal-assistant",
+    "agent-os",
+    "cli",
+    "cron",
+    "desktop",
+    "extensions",
+    "gateway",
+    "goal-loop-os",
     "llm",
-    "openai",
-    "claude",
+    "local-first",
+    "mcp",
+    "multi-agent",
+    "self-hosted",
     "telegram",
-    "automation"
+    "voice-ai",
+    "weixin",
+    "workflow"
   ],
   "author": "xopcai <lyxopc.ai@gmail.com>",
   "license": "MIT",
@@ -54,10 +61,10 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@earendil-works/pi-agent-core": "^0.78.1",
-    "@earendil-works/pi-ai": "^0.78.1",
-    "@earendil-works/pi-coding-agent": "^0.78.1",
-    "@earendil-works/pi-tui": "^0.78.1",
+    "@earendil-works/pi-agent-core": "^0.79.7",
+    "@earendil-works/pi-ai": "^0.79.7",
+    "@earendil-works/pi-coding-agent": "^0.79.7",
+    "@earendil-works/pi-tui": "^0.79.7",
     "@grammyjs/runner": "^2.0.3",
     "@hono/node-server": "^2.0.4",
     "@inquirer/prompts": "^8.5.0",
@@ -127,9 +134,8 @@
     "vue": "^3.5.35"
   },
   "scripts": {
-    "generate:bundled-channels": "node scripts/generate-bundled-channel-plugins.mjs",
     "generate:bundled-image-providers": "node scripts/generate-bundled-image-providers.mjs",
-    "generate:bundled": "pnpm run generate:bundled-channels && pnpm run generate:bundled-image-providers",
+    "generate:bundled": "pnpm run generate:bundled-image-providers",
     "build:node": "node scripts/tsdown-build.mjs",
     "build:types": "tsc -p tsconfig.dts.json",
     "build:ci": "pnpm run generate:bundled && pnpm run build:node && pnpm run build:web",

package/skills/creative/frontend-design/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: frontend-design
-description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
+description: Create distinctive, production-grade frontend interfaces, pages, components, dashboards, and HTML/CSS layouts.
 license: Complete terms in LICENSE.txt
 ---
 

package/skills/creative/theme-factory/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: theme-factory
-description: Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.
+description: Apply or generate cohesive color and font themes for artifacts, slides, documents, reports, and landing pages.
 license: Complete terms in LICENSE.txt
 ---
 

package/skills/documents/xlsx/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: xlsx
-description: "Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like \"the xlsx in my downloads\") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved."
+description: "Create, read, edit, clean, format, chart, or convert spreadsheet files such as .xlsx, .xlsm, .csv, and .tsv."
 license: Proprietary. LICENSE.txt has complete terms
 ---
 

package/skills/engineering/diagnose/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: diagnose
-description: Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
+description: Disciplined reproduce → minimise → hypothesise → instrument → fix loop for hard bugs and performance regressions.
 ---
 
 # Diagnose
@@ -114,4 +114,4 @@ Required before declaring done:
 - [ ] Throwaway prototypes deleted (or moved to a clearly-marked debug location)
 - [ ] The hypothesis that turned out correct is stated in the commit / PR message — so the next debugger learns
 
-**Then ask: what would have prevented this bug?** If the answer involves architectural change (no good test seam, tangled callers, hidden coupling) hand off to the `/improve-codebase-architecture` skill with the specifics. Make the recommendation **after** the fix is in, not before — you have more information now than when you started.
+**Then ask: what would have prevented this bug?** If the answer involves architectural change (no good test seam, tangled callers, hidden coupling), summarize the refactor candidate and ask whether the user wants a separate architecture pass. Make the recommendation **after** the fix is in, not before — you have more information now than when you started.

package/skills/engineering/tdd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tdd
-description: Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
+description: Test-driven development using a red-green-refactor loop for features, bug fixes, and integration tests.
 ---
 
 # Test-Driven Development

package/skills/tools/github/SKILL.md

@@ -1,7 +1,12 @@
 ---
 name: github
-description: "Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries."
+description: "Interact with GitHub using the `gh` CLI for issues, PRs, CI runs, and advanced API queries."
 license: MIT
+metadata:
+  xopc:
+    requires_toolsets: [terminal]
+    requires:
+      bins: [gh]
 ---
 
 # GitHub Skill

package/skills/tools/webapp-testing/SKILL.md

@@ -1,7 +1,10 @@
 ---
 name: webapp-testing
-description: Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
+description: Test local web applications with Playwright scripts, screenshots, browser logs, and UI behavior checks.
 license: Complete terms in LICENSE.txt
+metadata:
+  xopc:
+    requires_toolsets: [terminal]
 ---
 
 # Web Application Testing

package/dist/extensions/telegram/src/adapters/config-surface.d.ts

@@ -1,2 +0,0 @@
-import type { ChannelConfigSurfaceAdapter } from '@xopcai/xopc/channels/plugins/types.adapters.js';
-export declare const telegramConfigSurface: ChannelConfigSurfaceAdapter;

package/dist/extensions/telegram/src/adapters/config-surface.js

@@ -1,26 +0,0 @@
-//#region extensions/telegram/src/adapters/config-surface.ts
-const telegramConfigSurface = { buildConfigSurface(cfg) {
-	const telegram = cfg.channels?.telegram;
-	const accounts = telegram?.accounts;
-	const defTok = accounts?.default && typeof accounts.default === "object" ? accounts.default.botToken : void 0;
-	return {
-		enabled: telegram?.enabled,
-		botToken: typeof defTok === "string" ? defTok : "",
-		allowFrom: telegram?.allowFrom || [],
-		groupAllowFrom: telegram?.groupAllowFrom || [],
-		apiRoot: telegram?.apiRoot || "",
-		debug: telegram?.debug || false,
-		dmPolicy: telegram?.dmPolicy || "pairing",
-		groupPolicy: telegram?.groupPolicy || "open",
-		replyToMode: telegram?.replyToMode || "off",
-		streamMode: (accounts?.default?.streaming)?.mode || (telegram?.streaming)?.mode || "partial",
-		historyLimit: telegram?.historyLimit || 50,
-		textChunkLimit: telegram?.textChunkLimit || 4e3,
-		proxy: telegram?.proxy || "",
-		accounts: telegram?.accounts || {}
-	};
-} };
-//#endregion
-export { telegramConfigSurface };
-
-//# sourceMappingURL=config-surface.js.map

package/dist/extensions/telegram/src/adapters/config-surface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config-surface.js","names":[],"sources":["../../../../../extensions/telegram/src/adapters/config-surface.ts"],"sourcesContent":["import type { Config } from '@xopcai/xopc/config/index.js';\nimport type { ChannelConfigSurfaceAdapter } from '@xopcai/xopc/channels/plugins/types.adapters.js';\n\nexport const telegramConfigSurface: ChannelConfigSurfaceAdapter = {\n  buildConfigSurface(cfg: Config): Record<string, unknown> {\n    const telegram = cfg.channels?.telegram as Record<string, unknown> | undefined;\n    const accounts = telegram?.accounts as\n      | Record<string, { botToken?: string; streaming?: { mode?: string } }>\n      | undefined;\n    const defTok =\n      accounts?.default && typeof accounts.default === 'object'\n        ? accounts.default.botToken\n        : undefined;\n    return {\n      enabled: telegram?.enabled,\n      // Send the real token to the authenticated settings UI.\n      // The web UI is responsible for masking it by default.\n      botToken: typeof defTok === 'string' ? defTok : '',\n      allowFrom: telegram?.allowFrom || [],\n      groupAllowFrom: telegram?.groupAllowFrom || [],\n      apiRoot: telegram?.apiRoot || '',\n      debug: telegram?.debug || false,\n      dmPolicy: telegram?.dmPolicy || 'pairing',\n      groupPolicy: telegram?.groupPolicy || 'open',\n      replyToMode: telegram?.replyToMode || 'off',\n      streamMode:\n        (accounts?.default?.streaming as { mode?: string } | undefined)?.mode ||\n        (telegram?.streaming as { mode?: string } | undefined)?.mode || 'partial',\n      historyLimit: telegram?.historyLimit || 50,\n      textChunkLimit: telegram?.textChunkLimit || 4000,\n      proxy: telegram?.proxy || '',\n      accounts: telegram?.accounts || {},\n    };\n  },\n};\n"],"mappings":";AAGA,MAAa,wBAAqD,EAChE,mBAAmB,KAAsC;CACvD,MAAM,WAAW,IAAI,UAAU;CAC/B,MAAM,WAAW,UAAU;CAG3B,MAAM,SACJ,UAAU,WAAW,OAAO,SAAS,YAAY,WAC7C,SAAS,QAAQ,WACjB,KAAA;AACN,QAAO;EACL,SAAS,UAAU;EAGnB,UAAU,OAAO,WAAW,WAAW,SAAS;EAChD,WAAW,UAAU,aAAa,EAAE;EACpC,gBAAgB,UAAU,kBAAkB,EAAE;EAC9C,SAAS,UAAU,WAAW;EAC9B,OAAO,UAAU,SAAS;EAC1B,UAAU,UAAU,YAAY;EAChC,aAAa,UAAU,eAAe;EACtC,aAAa,UAAU,eAAe;EACtC,aACG,UAAU,SAAS,YAA6C,SAChE,UAAU,YAA6C,QAAQ;EAClE,cAAc,UAAU,gBAAgB;EACxC,gBAAgB,UAAU,kBAAkB;EAC5C,OAAO,UAAU,SAAS;EAC1B,UAAU,UAAU,YAAY,EAAE;EACnC;GAEJ"}

package/dist/extensions/weixin/src/__tests__/workflow-progress.test.js

@@ -1,158 +0,0 @@
-import { getContextToken } from "../messaging/inbound.js";
-import { sendMessageWeixin } from "../messaging/send.js";
-import { ensureWeixinContextTokenForOutbound } from "../messaging/context-token-init.js";
-import { createWeixinWorkflowProgressCapability } from "../workflow-progress.js";
-import { describe, expect, it, vi } from "vitest";
-//#region extensions/weixin/src/__tests__/workflow-progress.test.ts
-vi.mock("../auth/accounts.js", () => ({ resolveWeixinAccount: () => ({
-	accountId: "default",
-	enabled: true,
-	configured: true,
-	token: "tok-x",
-	baseUrl: "https://example/weixin",
-	routeTag: void 0
-}) }));
-vi.mock("../messaging/inbound.js", () => ({
-	getContextToken: vi.fn(),
-	restoreContextTokens: vi.fn()
-}));
-vi.mock("../messaging/context-token-init.js", () => ({ ensureWeixinContextTokenForOutbound: vi.fn() }));
-vi.mock("../messaging/send.js", async () => {
-	return {
-		...await vi.importActual("../messaging/send.js"),
-		sendMessageWeixin: vi.fn().mockResolvedValue({ messageId: "weixin-1" })
-	};
-});
-const getCtxMock = vi.mocked(getContextToken);
-const ensureMock = vi.mocked(ensureWeixinContextTokenForOutbound);
-const sendMock = vi.mocked(sendMessageWeixin);
-const SESSION = "agent:main:weixin:default:direct:ilink_user_abc";
-function mkCap() {
-	return createWeixinWorkflowProgressCapability({ getConfig: () => ({}) });
-}
-describe("weixin workflow progress capability", () => {
-	it("declares final-only defaults (no editMessage on WeChat)", () => {
-		const cap = mkCap();
-		expect(cap.channelId).toBe("weixin");
-		expect(cap.supportsEdit).toBe(false);
-		expect(cap.defaultMode).toBe("final-only");
-		expect(cap.defaultThrottleMs).toBeGreaterThanOrEqual(3e4);
-	});
-	it("sends the final message when a cached context token exists", async () => {
-		getCtxMock.mockReturnValue("tok-cached");
-		sendMock.mockClear();
-		ensureMock.mockClear();
-		const r = await mkCap().postProgress({
-			sessionKey: SESSION,
-			text: "done",
-			isFinal: true
-		});
-		expect(ensureMock).not.toHaveBeenCalled();
-		expect(sendMock).toHaveBeenCalledWith(expect.objectContaining({
-			to: "ilink_user_abc",
-			text: "done",
-			opts: expect.objectContaining({ contextToken: "tok-cached" })
-		}));
-		expect(r.messageId).toBe("weixin-1");
-	});
-	it("hydrates a context token on demand when cache is empty", async () => {
-		getCtxMock.mockReturnValue(void 0);
-		ensureMock.mockResolvedValue("tok-hydrated");
-		sendMock.mockClear();
-		await mkCap().postProgress({
-			sessionKey: SESSION,
-			text: "done",
-			isFinal: true
-		});
-		expect(ensureMock).toHaveBeenCalled();
-		const sendArg = sendMock.mock.calls[0][0];
-		expect(sendArg.opts.contextToken).toBe("tok-hydrated");
-	});
-	it("returns an empty messageId without sending when no context token can be found", async () => {
-		getCtxMock.mockReturnValue(void 0);
-		ensureMock.mockResolvedValue(void 0);
-		sendMock.mockClear();
-		const r = await mkCap().postProgress({
-			sessionKey: SESSION,
-			text: "done",
-			isFinal: true
-		});
-		expect(sendMock).not.toHaveBeenCalled();
-		expect(r.messageId).toBe("");
-	});
-	it("throws on unroutable sessionKey", async () => {
-		await expect(mkCap().postProgress({
-			sessionKey: "agent:main:telegram:default:direct:123",
-			text: "x",
-			isFinal: true
-		})).rejects.toThrow(/cannot route/);
-	});
-	it("clamps oversized text to WeChat limit", async () => {
-		getCtxMock.mockReturnValue("tok");
-		sendMock.mockClear();
-		await mkCap().postProgress({
-			sessionKey: SESSION,
-			text: "x".repeat(1e4),
-			isFinal: true
-		});
-		const text = sendMock.mock.calls[0][0].text;
-		expect(text.length).toBeLessThanOrEqual(4e3);
-		expect(text.endsWith("…")).toBe(true);
-	});
-	describe("append-mode message decoration", () => {
-		it("prefixes mid-run append messages with \"工作流进展\" header", async () => {
-			getCtxMock.mockReturnValue("tok");
-			sendMock.mockClear();
-			await mkCap().postProgress({
-				sessionKey: SESSION,
-				text: "Inventory done · Review running",
-				isFinal: false,
-				mode: "append"
-			});
-			const text = sendMock.mock.calls[0][0].text;
-			expect(text.startsWith("▾ 工作流进展\n")).toBe(true);
-			expect(text).toContain("Inventory done · Review running");
-		});
-		it("prefixes final append message with \"工作流完成\" header", async () => {
-			getCtxMock.mockReturnValue("tok");
-			sendMock.mockClear();
-			await mkCap().postProgress({
-				sessionKey: SESSION,
-				text: "Top findings (3): …",
-				isFinal: true,
-				mode: "append"
-			});
-			const text = sendMock.mock.calls[0][0].text;
-			expect(text.startsWith("✓ 工作流完成\n")).toBe(true);
-			expect(text).toContain("Top findings (3): …");
-		});
-		it("does NOT add a header in final-only mode (existing behaviour preserved)", async () => {
-			getCtxMock.mockReturnValue("tok");
-			sendMock.mockClear();
-			await mkCap().postProgress({
-				sessionKey: SESSION,
-				text: "Top findings (3): …",
-				isFinal: true,
-				mode: "final-only"
-			});
-			const text = sendMock.mock.calls[0][0].text;
-			expect(text).not.toContain("工作流");
-			expect(text).toBe("Top findings (3): …");
-		});
-		it("does NOT add a header when mode is omitted (back-compat)", async () => {
-			getCtxMock.mockReturnValue("tok");
-			sendMock.mockClear();
-			await mkCap().postProgress({
-				sessionKey: SESSION,
-				text: "plain",
-				isFinal: true
-			});
-			const text = sendMock.mock.calls[0][0].text;
-			expect(text).toBe("plain");
-		});
-	});
-});
-//#endregion
-export {};
-
-//# sourceMappingURL=workflow-progress.test.js.map

package/dist/extensions/weixin/src/__tests__/workflow-progress.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-progress.test.js","names":[],"sources":["../../../../../extensions/weixin/src/__tests__/workflow-progress.test.ts"],"sourcesContent":["import { describe, expect, it, vi } from 'vitest';\n\nimport { createWeixinWorkflowProgressCapability } from '../workflow-progress.js';\n\nvi.mock('../auth/accounts.js', () => ({\n  resolveWeixinAccount: () => ({\n    accountId: 'default',\n    enabled: true,\n    configured: true,\n    token: 'tok-x',\n    baseUrl: 'https://example/weixin',\n    routeTag: undefined,\n  }),\n}));\n\nvi.mock('../messaging/inbound.js', () => ({\n  getContextToken: vi.fn(),\n  restoreContextTokens: vi.fn(),\n}));\n\nvi.mock('../messaging/context-token-init.js', () => ({\n  ensureWeixinContextTokenForOutbound: vi.fn(),\n}));\n\nvi.mock('../messaging/send.js', async () => {\n  const actual = await vi.importActual<typeof import('../messaging/send.js')>('../messaging/send.js');\n  return {\n    ...actual,\n    sendMessageWeixin: vi.fn().mockResolvedValue({ messageId: 'weixin-1' }),\n  };\n});\n\nimport { getContextToken } from '../messaging/inbound.js';\nimport { ensureWeixinContextTokenForOutbound } from '../messaging/context-token-init.js';\nimport { sendMessageWeixin } from '../messaging/send.js';\n\nconst getCtxMock = vi.mocked(getContextToken);\nconst ensureMock = vi.mocked(ensureWeixinContextTokenForOutbound);\nconst sendMock = vi.mocked(sendMessageWeixin);\n\nconst SESSION = 'agent:main:weixin:default:direct:ilink_user_abc';\n\nfunction mkCap() {\n  return createWeixinWorkflowProgressCapability({\n    getConfig: () => ({}) as never,\n  });\n}\n\ndescribe('weixin workflow progress capability', () => {\n  it('declares final-only defaults (no editMessage on WeChat)', () => {\n    const cap = mkCap();\n    expect(cap.channelId).toBe('weixin');\n    expect(cap.supportsEdit).toBe(false);\n    expect(cap.defaultMode).toBe('final-only');\n    expect(cap.defaultThrottleMs).toBeGreaterThanOrEqual(30_000);\n  });\n\n  it('sends the final message when a cached context token exists', async () => {\n    getCtxMock.mockReturnValue('tok-cached');\n    sendMock.mockClear();\n    ensureMock.mockClear();\n    const cap = mkCap();\n    const r = await cap.postProgress({ sessionKey: SESSION, text: 'done', isFinal: true });\n    expect(ensureMock).not.toHaveBeenCalled();\n    expect(sendMock).toHaveBeenCalledWith(\n      expect.objectContaining({\n        to: 'ilink_user_abc',\n        text: 'done',\n        opts: expect.objectContaining({ contextToken: 'tok-cached' }),\n      }),\n    );\n    expect(r.messageId).toBe('weixin-1');\n  });\n\n  it('hydrates a context token on demand when cache is empty', async () => {\n    getCtxMock.mockReturnValue(undefined);\n    ensureMock.mockResolvedValue('tok-hydrated');\n    sendMock.mockClear();\n    const cap = mkCap();\n    await cap.postProgress({ sessionKey: SESSION, text: 'done', isFinal: true });\n    expect(ensureMock).toHaveBeenCalled();\n    const sendArg = sendMock.mock.calls[0][0];\n    expect(sendArg.opts.contextToken).toBe('tok-hydrated');\n  });\n\n  it('returns an empty messageId without sending when no context token can be found', async () => {\n    getCtxMock.mockReturnValue(undefined);\n    ensureMock.mockResolvedValue(undefined);\n    sendMock.mockClear();\n    const cap = mkCap();\n    const r = await cap.postProgress({ sessionKey: SESSION, text: 'done', isFinal: true });\n    expect(sendMock).not.toHaveBeenCalled();\n    expect(r.messageId).toBe('');\n  });\n\n  it('throws on unroutable sessionKey', async () => {\n    const cap = mkCap();\n    await expect(\n      cap.postProgress({\n        sessionKey: 'agent:main:telegram:default:direct:123',\n        text: 'x',\n        isFinal: true,\n      }),\n    ).rejects.toThrow(/cannot route/);\n  });\n\n  it('clamps oversized text to WeChat limit', async () => {\n    getCtxMock.mockReturnValue('tok');\n    sendMock.mockClear();\n    const cap = mkCap();\n    await cap.postProgress({ sessionKey: SESSION, text: 'x'.repeat(10_000), isFinal: true });\n    const text = sendMock.mock.calls[0][0].text;\n    expect(text.length).toBeLessThanOrEqual(4_000);\n    expect(text.endsWith('…')).toBe(true);\n  });\n\n  describe('append-mode message decoration', () => {\n    it('prefixes mid-run append messages with \"工作流进展\" header', async () => {\n      getCtxMock.mockReturnValue('tok');\n      sendMock.mockClear();\n      const cap = mkCap();\n      await cap.postProgress({\n        sessionKey: SESSION,\n        text: 'Inventory done · Review running',\n        isFinal: false,\n        mode: 'append',\n      });\n      const text = sendMock.mock.calls[0][0].text;\n      expect(text.startsWith('▾ 工作流进展\\n')).toBe(true);\n      expect(text).toContain('Inventory done · Review running');\n    });\n\n    it('prefixes final append message with \"工作流完成\" header', async () => {\n      getCtxMock.mockReturnValue('tok');\n      sendMock.mockClear();\n      const cap = mkCap();\n      await cap.postProgress({\n        sessionKey: SESSION,\n        text: 'Top findings (3): …',\n        isFinal: true,\n        mode: 'append',\n      });\n      const text = sendMock.mock.calls[0][0].text;\n      expect(text.startsWith('✓ 工作流完成\\n')).toBe(true);\n      expect(text).toContain('Top findings (3): …');\n    });\n\n    it('does NOT add a header in final-only mode (existing behaviour preserved)', async () => {\n      getCtxMock.mockReturnValue('tok');\n      sendMock.mockClear();\n      const cap = mkCap();\n      await cap.postProgress({\n        sessionKey: SESSION,\n        text: 'Top findings (3): …',\n        isFinal: true,\n        mode: 'final-only',\n      });\n      const text = sendMock.mock.calls[0][0].text;\n      expect(text).not.toContain('工作流');\n      expect(text).toBe('Top findings (3): …');\n    });\n\n    it('does NOT add a header when mode is omitted (back-compat)', async () => {\n      getCtxMock.mockReturnValue('tok');\n      sendMock.mockClear();\n      const cap = mkCap();\n      await cap.postProgress({ sessionKey: SESSION, text: 'plain', isFinal: true });\n      const text = sendMock.mock.calls[0][0].text;\n      expect(text).toBe('plain');\n    });\n  });\n});\n"],"mappings":"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"}