npm - @xopcai/xopc - Versions diffs - 0.0.92 → 0.0.94 - Mend

@xopcai/xopc 0.0.92 → 0.0.94

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (194) hide show

package/dist/src/agent/workflow/progress-broker.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"progress-broker.js","names":[],"sources":["../../../../src/agent/workflow/progress-broker.ts"],"sourcesContent":["/*\n WorkflowProgressBroker — the single seam that turns mid-run `workflow`\n * snapshots into IM messages (Telegram today, more channels later).\n \n Architecture:\n \n pi-agent ──tool_execution_update──▶ AgentEventHandler / SessionEventBus\n * │\n * attachTo(handler) │\n * ▼\n * WorkflowProgressBroker\n * │\n * per-(sessionKey, toolCallId) state\n * │\n * ┌───────────────────┼───────────────────┐\n * ▼ ▼ ▼\n * Telegram cap Feishu cap WeChat cap\n \n Why broker + capability instead of \"each channel subscribes the bus\"?\n * - DRY snapshot aggregation and key-event detection.\n * - Per-channel throttling is enforced by the broker, so a slow / rate-limited\n * channel can't block a fast one.\n * - Adding a new channel = one capability + one register call. Broker code\n * never grows.\n /\n\nimport type { AgentEvent } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../utils/logger.js';\nimport type { Config } from '../../config/schema.js';\n\nimport type {\n ChannelProgressCapability,\n WorkflowProgressMode,\n} from './channel-capability.js';\nimport { renderWorkflowText } from './snapshot.js';\nimport type { WorkflowAgentSnapshot, WorkflowSnapshot } from './types.js';\n\nconst log = createLogger('workflow-progress-broker');\n\nconst WORKFLOW_TOOL_NAME = 'workflow';\nconst RENDER_MAX_AGENTS_PER_PHASE = 4;\nconst RENDER_MAX_LOGS = 2;\n\n/* Per-channel resolved settings after applying config overrides on capability defaults. /\ninterface ChannelResolvedSettings {\n enabled: boolean;\n throttleMs: number;\n mode: WorkflowProgressMode;\n}\n\n/* Per-(sessionKey, toolCallId) progress state. /\ninterface RunState {\n /* Latest snapshot seen for this run. Always overwritten on update. /\n snapshot: WorkflowSnapshot;\n /* Previous snapshot used to detect \"key events\" (phase change, new errors). /\n prevSnapshot?: WorkflowSnapshot;\n /* Per-channel last-send bookkeeping. /\n perChannel: Map<string, ChannelRunState>;\n}\n\ninterface ChannelRunState {\n /* Server timestamp of the last successful postProgress. /\n lastSentAt: number;\n /* Returned messageId of the last successful postProgress — drives edit mode. /\n lastMessageId?: string;\n /* Pending timer id (Node `setTimeout`) when a throttled flush is scheduled. /\n pendingTimer?: ReturnType<typeof setTimeout>;\n /* Inflight `postProgress` promise; we serialise per-(state, channel) to avoid race. /\n inflight?: Promise<void>;\n}\n\nexport interface BrokerListenerHandle {\n /* Detach broker from the session bus and clear all in-flight state. /\n dispose(): void;\n}\n\n/\n Tiny façade onto the AgentEventHandler. We don't import the concrete class to\n * keep this module test-friendly — a stub listener pump is fine for unit tests.\n /\nexport interface SessionBusLike {\n registerListener(\n type: AgentEvent['type'] \| 'all',\n listener: (event: AgentEvent, context: { sessionKey: string }) => void,\n ): () => void;\n}\n\nexport class WorkflowProgressBroker {\n private subscribers: ChannelProgressCapability[] = [];\n private states = new Map<string, RunState>();\n /* Now() factory — overridable in tests for deterministic time. /\n private readonly now: () => number;\n /* Cached resolved settings per (channelId), invalidated on registration. /\n private resolved = new Map<string, ChannelResolvedSettings>();\n\n constructor(\n private readonly opts: {\n getConfig?: () => Config \| undefined;\n now?: () => number;\n } = {},\n ) {\n this.now = opts.now ?? (() => Date.now());\n }\n\n // ── Registration ────────────────────────────────────────────────────────────\n\n registerChannel(cap: ChannelProgressCapability): () => void {\n if (this.subscribers.some((s) => s.channelId === cap.channelId)) {\n log.warn({ channelId: cap.channelId }, 'channel capability already registered; replacing');\n this.subscribers = this.subscribers.filter((s) => s.channelId !== cap.channelId);\n }\n this.subscribers.push(cap);\n this.resolved.delete(cap.channelId);\n return () => {\n this.subscribers = this.subscribers.filter((s) => s !== cap);\n this.resolved.delete(cap.channelId);\n };\n }\n\n attachTo(bus: SessionBusLike): BrokerListenerHandle {\n const offUpdate = bus.registerListener('tool_execution_update', (event, ctx) => {\n const e = event as Extract<AgentEvent, { type: 'tool_execution_update' }>;\n if (e.toolName !== WORKFLOW_TOOL_NAME) return;\n const snap = extractWorkflowSnapshot(e.partialResult);\n if (!snap) return;\n this.onUpdate(ctx.sessionKey, e.toolCallId, snap);\n });\n\n const offEnd = bus.registerListener('tool_execution_end', (event, ctx) => {\n const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n if (e.toolName !== WORKFLOW_TOOL_NAME) return;\n // tool_end ships the final envelope in `result`; reach in for the\n // authoritative snapshot (durationMs / result / final counts).\n const snap = extractWorkflowSnapshot(e.result, { fromResultEnvelope: true });\n this.onEnd(ctx.sessionKey, e.toolCallId, snap);\n });\n\n return {\n dispose: () => {\n offUpdate();\n offEnd();\n this.disposeAllPending();\n },\n };\n }\n\n // ── Core state machine ──────────────────────────────────────────────────────\n\n /* Visible for tests — direct entry path bypassing the SessionBus glue. /\n onUpdate(sessionKey: string, toolCallId: string, snapshot: WorkflowSnapshot): void {\n const key = stateKey(sessionKey, toolCallId);\n const state = this.getOrCreateState(key, snapshot);\n state.prevSnapshot = state.snapshot;\n state.snapshot = snapshot;\n\n const isKey = isKeyEvent(state.prevSnapshot, snapshot);\n for (const cap of this.subscribers) {\n this.dispatchToChannel(state, sessionKey, cap, { isFinal: false, isKey });\n }\n }\n\n /* Visible for tests — direct entry path bypassing the SessionBus glue. /\n onEnd(sessionKey: string, toolCallId: string, snapshot: WorkflowSnapshot \| null): void {\n const key = stateKey(sessionKey, toolCallId);\n const state = this.states.get(key);\n if (!state) return;\n if (snapshot) state.snapshot = snapshot;\n\n for (const cap of this.subscribers) {\n // Always flush the final message — bypass throttle and any pending timer.\n this.cancelPending(state, cap.channelId);\n this.dispatchToChannel(state, sessionKey, cap, { isFinal: true, isKey: true });\n }\n // State is GC'd lazily after a small grace period so any straggler\n // `update` event arriving after `end` is silently dropped (instead of\n // resurrecting the run).\n setTimeout(() => this.states.delete(key), 2_000);\n }\n\n // ── Dispatch + throttle ─────────────────────────────────────────────────────\n\n private dispatchToChannel(\n state: RunState,\n sessionKey: string,\n cap: ChannelProgressCapability,\n flags: { isFinal: boolean; isKey: boolean },\n ): void {\n const cfg = this.resolveChannelSettings(cap);\n if (!cfg.enabled) return;\n if (cfg.mode === 'final-only' && !flags.isFinal) return;\n\n const chState = this.getOrCreateChannelState(state, cap.channelId);\n\n // Key events and the final message bypass throttle.\n if (flags.isFinal \|\| flags.isKey) {\n this.cancelPending(state, cap.channelId);\n void this.sendNow(state, sessionKey, cap, cfg, flags.isFinal);\n return;\n }\n\n const elapsed = this.now() - chState.lastSentAt;\n const wait = Math.max(0, cfg.throttleMs - elapsed);\n if (wait === 0) {\n void this.sendNow(state, sessionKey, cap, cfg, false);\n return;\n }\n if (chState.pendingTimer) return; // already scheduled; latest snapshot will be picked up\n chState.pendingTimer = setTimeout(() => {\n chState.pendingTimer = undefined;\n void this.sendNow(state, sessionKey, cap, cfg, false);\n }, wait);\n }\n\n private async sendNow(\n state: RunState,\n sessionKey: string,\n cap: ChannelProgressCapability,\n cfg: ChannelResolvedSettings,\n isFinal: boolean,\n ): Promise<void> {\n const chState = this.getOrCreateChannelState(state, cap.channelId);\n // Serialise per-channel sends so a slow editMessage call doesn't get\n // overtaken by a faster one and leave the bubble out of order.\n if (chState.inflight) await chState.inflight.catch(() => undefined);\n\n const text = renderWorkflowText(state.snapshot, isFinal, {\n maxAgentsPerPhase: RENDER_MAX_AGENTS_PER_PHASE,\n maxLogs: RENDER_MAX_LOGS,\n showResultPreviews: isFinal,\n });\n\n const previousMessageId = cfg.mode === 'edit' ? chState.lastMessageId : undefined;\n const task = cap\n .postProgress({ sessionKey, text, previousMessageId, isFinal, mode: cfg.mode })\n .then((r) => {\n chState.lastMessageId = r.messageId;\n chState.lastSentAt = this.now();\n })\n .catch((err) => {\n const msg = err instanceof Error ? err.message : String(err);\n log.warn(\n { err, errorMessage: msg, channelId: cap.channelId, sessionKey },\n `workflow progress postProgress failed: ${msg}`,\n );\n })\n .finally(() => {\n chState.inflight = undefined;\n });\n\n chState.inflight = task;\n await task;\n }\n\n private cancelPending(state: RunState, channelId: string): void {\n const chState = state.perChannel.get(channelId);\n if (chState?.pendingTimer) {\n clearTimeout(chState.pendingTimer);\n chState.pendingTimer = undefined;\n }\n }\n\n private disposeAllPending(): void {\n for (const state of this.states.values()) {\n for (const ch of state.perChannel.values()) {\n if (ch.pendingTimer) clearTimeout(ch.pendingTimer);\n }\n }\n this.states.clear();\n }\n\n // ── State helpers ───────────────────────────────────────────────────────────\n\n private getOrCreateState(key: string, snapshot: WorkflowSnapshot): RunState {\n let state = this.states.get(key);\n if (!state) {\n state = { snapshot, perChannel: new Map() };\n this.states.set(key, state);\n }\n return state;\n }\n\n private getOrCreateChannelState(state: RunState, channelId: string): ChannelRunState {\n let ch = state.perChannel.get(channelId);\n if (!ch) {\n ch = { lastSentAt: 0 };\n state.perChannel.set(channelId, ch);\n }\n return ch;\n }\n\n /* Resolved (enabled / throttleMs / mode) for a channel, with config overrides. /\n private resolveChannelSettings(cap: ChannelProgressCapability): ChannelResolvedSettings {\n const cached = this.resolved.get(cap.channelId);\n if (cached) return cached;\n const override = readChannelConfig(this.opts.getConfig?.(), cap.channelId);\n const resolved: ChannelResolvedSettings = {\n enabled: override?.enabled ?? true,\n throttleMs: override?.throttleMs ?? cap.defaultThrottleMs,\n mode: override?.mode ?? cap.defaultMode,\n };\n this.resolved.set(cap.channelId, resolved);\n return resolved;\n }\n\n /* Drop any cached config so the next dispatch re-reads. Call after config reload. /\n invalidateConfigCache(): void {\n this.resolved.clear();\n }\n\n // ── Test introspection ──────────────────────────────────────────────────────\n\n /* @internal — for tests only. /\n _stateCount(): number {\n return this.states.size;\n }\n}\n\n// ── Singleton ───────────────────────────────────────────────────────────────\n\nlet singleton: WorkflowProgressBroker \| null = null;\n\n/\n Process-wide broker singleton. Channels register against this one; the\n * service wires it to the session bus during startup.\n /\nexport function getWorkflowProgressBroker(): WorkflowProgressBroker {\n if (!singleton) singleton = new WorkflowProgressBroker();\n return singleton;\n}\n\n/* Test-only — reset the singleton between cases. /\nexport function _resetWorkflowProgressBrokerForTests(): void {\n singleton = null;\n}\n\n// ── Pure helpers ────────────────────────────────────────────────────────────\n\nfunction stateKey(sessionKey: string, toolCallId: string \| undefined): string {\n return `${sessionKey}\u0001${toolCallId ?? ''}`;\n}\n\n/\n Compare two snapshots and decide whether the new one is \"key\" — i.e. worth\n * bypassing the per-channel throttle. Anything visible to the user as a\n * progress milestone qualifies; counts ticking by alone do not.\n /\nfunction isKeyEvent(prev: WorkflowSnapshot \| undefined, next: WorkflowSnapshot): boolean {\n if (!prev) return true; // first update of the run\n if (prev.currentPhase !== next.currentPhase) return true;\n if (next.errorCount > prev.errorCount) return true;\n if (next.skippedCount > prev.skippedCount) return true;\n // New phase row in the rollup (declared via `phase(...)` mid-run)\n if (prev.phases.length !== next.phases.length) return true;\n if (hasNewFailedAgent(prev.agents, next.agents)) return true;\n return false;\n}\n\nfunction hasNewFailedAgent(\n prev: WorkflowAgentSnapshot[],\n next: WorkflowAgentSnapshot[],\n): boolean {\n const prevBad = new Set(\n prev.filter((a) => a.status === 'error' \|\| a.status === 'skipped').map((a) => a.id),\n );\n for (const a of next) {\n if ((a.status === 'error' \|\| a.status === 'skipped') && !prevBad.has(a.id)) return true;\n }\n return false;\n}\n\n/\n Pull a {@link WorkflowSnapshot} out of an AgentToolResult-shaped value.\n * Returns null when the payload is not snapshot-shaped (text-only updates,\n * non-workflow tools, etc.).\n \n `fromResultEnvelope = true` (used for `tool_end.result`) tolerates the\n * `{ content, details }` wrapper.\n */\nfunction extractWorkflowSnapshot(\n payload: unknown,\n opts: { fromResultEnvelope?: boolean } = {},\n): WorkflowSnapshot \| null {\n if (!payload \|\| typeof payload !== 'object') return null;\n const rec = payload as Record<string, unknown>;\n if (opts.fromResultEnvelope) {\n const details = rec.details;\n if (details && typeof details === 'object') return coerce(details);\n return null;\n }\n if ('details' in rec) {\n const details = rec.details;\n if (details && typeof details === 'object') return coerce(details);\n return null;\n }\n return coerce(rec);\n}\n\nfunction coerce(value: unknown): WorkflowSnapshot \| null {\n if (!value \|\| typeof value !== 'object') return null;\n const rec = value as Record<string, unknown>;\n if (typeof rec.name !== 'string') return null;\n if (!Array.isArray(rec.agents)) return null;\n return value as WorkflowSnapshot;\n}\n\nfunction readChannelConfig(\n config: Config \| undefined,\n channelId: string,\n): { enabled?: boolean; throttleMs?: number; mode?: WorkflowProgressMode } \| undefined {\n const channels = config?.channels as Record<string, unknown> \| undefined;\n if (!channels) return undefined;\n const cfg = channels[channelId];\n if (!cfg \|\| typeof cfg !== 'object') return undefined;\n const wf = (cfg as { workflowProgress?: unknown }).workflowProgress;\n if (!wf \|\| typeof wf !== 'object') return undefined;\n return wf as { enabled?: boolean; throttleMs?: number; mode?: WorkflowProgressMode };\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"progress-broker.js","names":[],"sources":["../../../../src/agent/workflow/progress-broker.ts"],"sourcesContent":["/*\n WorkflowProgressBroker — the single seam that turns mid-run `workflow`\n * snapshots into IM messages (Telegram today, more channels later).\n \n Architecture:\n \n pi-agent ──tool_execution_update──▶ AgentEventHandler / SessionEventBus\n * │\n * attachTo(handler) │\n * ▼\n * WorkflowProgressBroker\n * │\n * per-(sessionKey, toolCallId) state\n * │\n * ┌───────────────────┼───────────────────┐\n * ▼ ▼ ▼\n * Telegram cap Feishu cap WeChat cap\n \n Why broker + capability instead of \"each channel subscribes the bus\"?\n * - DRY snapshot aggregation and key-event detection.\n * - Per-channel throttling is enforced by the broker, so a slow / rate-limited\n * channel can't block a fast one.\n * - Adding a new channel = one capability + one register call. Broker code\n * never grows.\n /\n\nimport type { AgentEvent } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../utils/logger.js';\nimport type { Config } from '../../config/schema.js';\n\nimport type {\n ChannelProgressCapability,\n WorkflowProgressMode,\n} from './channel-capability.js';\nimport { renderWorkflowText } from './snapshot.js';\nimport type { WorkflowAgentSnapshot, WorkflowSnapshot } from './types.js';\n\nconst log = createLogger('Agent:WorkflowProgress');\n\nconst WORKFLOW_TOOL_NAME = 'workflow';\nconst RENDER_MAX_AGENTS_PER_PHASE = 4;\nconst RENDER_MAX_LOGS = 2;\n\n/* Per-channel resolved settings after applying config overrides on capability defaults. /\ninterface ChannelResolvedSettings {\n enabled: boolean;\n throttleMs: number;\n mode: WorkflowProgressMode;\n}\n\n/* Per-(sessionKey, toolCallId) progress state. /\ninterface RunState {\n /* Latest snapshot seen for this run. Always overwritten on update. /\n snapshot: WorkflowSnapshot;\n /* Previous snapshot used to detect \"key events\" (phase change, new errors). /\n prevSnapshot?: WorkflowSnapshot;\n /* Per-channel last-send bookkeeping. /\n perChannel: Map<string, ChannelRunState>;\n}\n\ninterface ChannelRunState {\n /* Server timestamp of the last successful postProgress. /\n lastSentAt: number;\n /* Returned messageId of the last successful postProgress — drives edit mode. /\n lastMessageId?: string;\n /* Pending timer id (Node `setTimeout`) when a throttled flush is scheduled. /\n pendingTimer?: ReturnType<typeof setTimeout>;\n /* Inflight `postProgress` promise; we serialise per-(state, channel) to avoid race. /\n inflight?: Promise<void>;\n}\n\nexport interface BrokerListenerHandle {\n /* Detach broker from the session bus and clear all in-flight state. /\n dispose(): void;\n}\n\n/\n Tiny façade onto the AgentEventHandler. We don't import the concrete class to\n * keep this module test-friendly — a stub listener pump is fine for unit tests.\n /\nexport interface SessionBusLike {\n registerListener(\n type: AgentEvent['type'] \| 'all',\n listener: (event: AgentEvent, context: { sessionKey: string }) => void,\n ): () => void;\n}\n\nexport class WorkflowProgressBroker {\n private subscribers: ChannelProgressCapability[] = [];\n private states = new Map<string, RunState>();\n /* Now() factory — overridable in tests for deterministic time. /\n private readonly now: () => number;\n /* Cached resolved settings per (channelId), invalidated on registration. /\n private resolved = new Map<string, ChannelResolvedSettings>();\n\n constructor(\n private readonly opts: {\n getConfig?: () => Config \| undefined;\n now?: () => number;\n } = {},\n ) {\n this.now = opts.now ?? (() => Date.now());\n }\n\n // ── Registration ────────────────────────────────────────────────────────────\n\n registerChannel(cap: ChannelProgressCapability): () => void {\n if (this.subscribers.some((s) => s.channelId === cap.channelId)) {\n log.warn({ channelId: cap.channelId }, 'channel capability already registered; replacing');\n this.subscribers = this.subscribers.filter((s) => s.channelId !== cap.channelId);\n }\n this.subscribers.push(cap);\n this.resolved.delete(cap.channelId);\n return () => {\n this.subscribers = this.subscribers.filter((s) => s !== cap);\n this.resolved.delete(cap.channelId);\n };\n }\n\n attachTo(bus: SessionBusLike): BrokerListenerHandle {\n const offUpdate = bus.registerListener('tool_execution_update', (event, ctx) => {\n const e = event as Extract<AgentEvent, { type: 'tool_execution_update' }>;\n if (e.toolName !== WORKFLOW_TOOL_NAME) return;\n const snap = extractWorkflowSnapshot(e.partialResult);\n if (!snap) return;\n this.onUpdate(ctx.sessionKey, e.toolCallId, snap);\n });\n\n const offEnd = bus.registerListener('tool_execution_end', (event, ctx) => {\n const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n if (e.toolName !== WORKFLOW_TOOL_NAME) return;\n // tool_end ships the final envelope in `result`; reach in for the\n // authoritative snapshot (durationMs / result / final counts).\n const snap = extractWorkflowSnapshot(e.result, { fromResultEnvelope: true });\n this.onEnd(ctx.sessionKey, e.toolCallId, snap);\n });\n\n return {\n dispose: () => {\n offUpdate();\n offEnd();\n this.disposeAllPending();\n },\n };\n }\n\n // ── Core state machine ──────────────────────────────────────────────────────\n\n /* Visible for tests — direct entry path bypassing the SessionBus glue. /\n onUpdate(sessionKey: string, toolCallId: string, snapshot: WorkflowSnapshot): void {\n const key = stateKey(sessionKey, toolCallId);\n const state = this.getOrCreateState(key, snapshot);\n state.prevSnapshot = state.snapshot;\n state.snapshot = snapshot;\n\n const isKey = isKeyEvent(state.prevSnapshot, snapshot);\n for (const cap of this.subscribers) {\n this.dispatchToChannel(state, sessionKey, cap, { isFinal: false, isKey });\n }\n }\n\n /* Visible for tests — direct entry path bypassing the SessionBus glue. /\n onEnd(sessionKey: string, toolCallId: string, snapshot: WorkflowSnapshot \| null): void {\n const key = stateKey(sessionKey, toolCallId);\n const state = this.states.get(key);\n if (!state) return;\n if (snapshot) state.snapshot = snapshot;\n\n for (const cap of this.subscribers) {\n // Always flush the final message — bypass throttle and any pending timer.\n this.cancelPending(state, cap.channelId);\n this.dispatchToChannel(state, sessionKey, cap, { isFinal: true, isKey: true });\n }\n // State is GC'd lazily after a small grace period so any straggler\n // `update` event arriving after `end` is silently dropped (instead of\n // resurrecting the run).\n setTimeout(() => this.states.delete(key), 2_000);\n }\n\n // ── Dispatch + throttle ─────────────────────────────────────────────────────\n\n private dispatchToChannel(\n state: RunState,\n sessionKey: string,\n cap: ChannelProgressCapability,\n flags: { isFinal: boolean; isKey: boolean },\n ): void {\n const cfg = this.resolveChannelSettings(cap);\n if (!cfg.enabled) return;\n if (cfg.mode === 'final-only' && !flags.isFinal) return;\n\n const chState = this.getOrCreateChannelState(state, cap.channelId);\n\n // Key events and the final message bypass throttle.\n if (flags.isFinal \|\| flags.isKey) {\n this.cancelPending(state, cap.channelId);\n void this.sendNow(state, sessionKey, cap, cfg, flags.isFinal);\n return;\n }\n\n const elapsed = this.now() - chState.lastSentAt;\n const wait = Math.max(0, cfg.throttleMs - elapsed);\n if (wait === 0) {\n void this.sendNow(state, sessionKey, cap, cfg, false);\n return;\n }\n if (chState.pendingTimer) return; // already scheduled; latest snapshot will be picked up\n chState.pendingTimer = setTimeout(() => {\n chState.pendingTimer = undefined;\n void this.sendNow(state, sessionKey, cap, cfg, false);\n }, wait);\n }\n\n private async sendNow(\n state: RunState,\n sessionKey: string,\n cap: ChannelProgressCapability,\n cfg: ChannelResolvedSettings,\n isFinal: boolean,\n ): Promise<void> {\n const chState = this.getOrCreateChannelState(state, cap.channelId);\n // Serialise per-channel sends so a slow editMessage call doesn't get\n // overtaken by a faster one and leave the bubble out of order.\n if (chState.inflight) await chState.inflight.catch(() => undefined);\n\n const text = renderWorkflowText(state.snapshot, isFinal, {\n maxAgentsPerPhase: RENDER_MAX_AGENTS_PER_PHASE,\n maxLogs: RENDER_MAX_LOGS,\n showResultPreviews: isFinal,\n });\n\n const previousMessageId = cfg.mode === 'edit' ? chState.lastMessageId : undefined;\n const task = cap\n .postProgress({ sessionKey, text, previousMessageId, isFinal, mode: cfg.mode })\n .then((r) => {\n chState.lastMessageId = r.messageId;\n chState.lastSentAt = this.now();\n })\n .catch((err) => {\n const msg = err instanceof Error ? err.message : String(err);\n log.warn(\n { err, errorMessage: msg, channelId: cap.channelId, sessionKey },\n `workflow progress postProgress failed: ${msg}`,\n );\n })\n .finally(() => {\n chState.inflight = undefined;\n });\n\n chState.inflight = task;\n await task;\n }\n\n private cancelPending(state: RunState, channelId: string): void {\n const chState = state.perChannel.get(channelId);\n if (chState?.pendingTimer) {\n clearTimeout(chState.pendingTimer);\n chState.pendingTimer = undefined;\n }\n }\n\n private disposeAllPending(): void {\n for (const state of this.states.values()) {\n for (const ch of state.perChannel.values()) {\n if (ch.pendingTimer) clearTimeout(ch.pendingTimer);\n }\n }\n this.states.clear();\n }\n\n // ── State helpers ───────────────────────────────────────────────────────────\n\n private getOrCreateState(key: string, snapshot: WorkflowSnapshot): RunState {\n let state = this.states.get(key);\n if (!state) {\n state = { snapshot, perChannel: new Map() };\n this.states.set(key, state);\n }\n return state;\n }\n\n private getOrCreateChannelState(state: RunState, channelId: string): ChannelRunState {\n let ch = state.perChannel.get(channelId);\n if (!ch) {\n ch = { lastSentAt: 0 };\n state.perChannel.set(channelId, ch);\n }\n return ch;\n }\n\n /* Resolved (enabled / throttleMs / mode) for a channel, with config overrides. /\n private resolveChannelSettings(cap: ChannelProgressCapability): ChannelResolvedSettings {\n const cached = this.resolved.get(cap.channelId);\n if (cached) return cached;\n const override = readChannelConfig(this.opts.getConfig?.(), cap.channelId);\n const resolved: ChannelResolvedSettings = {\n enabled: override?.enabled ?? true,\n throttleMs: override?.throttleMs ?? cap.defaultThrottleMs,\n mode: override?.mode ?? cap.defaultMode,\n };\n this.resolved.set(cap.channelId, resolved);\n return resolved;\n }\n\n /* Drop any cached config so the next dispatch re-reads. Call after config reload. /\n invalidateConfigCache(): void {\n this.resolved.clear();\n }\n\n // ── Test introspection ──────────────────────────────────────────────────────\n\n /* @internal — for tests only. /\n _stateCount(): number {\n return this.states.size;\n }\n}\n\n// ── Singleton ───────────────────────────────────────────────────────────────\n\nlet singleton: WorkflowProgressBroker \| null = null;\n\n/\n Process-wide broker singleton. Channels register against this one; the\n * service wires it to the session bus during startup.\n /\nexport function getWorkflowProgressBroker(): WorkflowProgressBroker {\n if (!singleton) singleton = new WorkflowProgressBroker();\n return singleton;\n}\n\n/* Test-only — reset the singleton between cases. /\nexport function _resetWorkflowProgressBrokerForTests(): void {\n singleton = null;\n}\n\n// ── Pure helpers ────────────────────────────────────────────────────────────\n\nfunction stateKey(sessionKey: string, toolCallId: string \| undefined): string {\n return `${sessionKey}\u0001${toolCallId ?? ''}`;\n}\n\n/\n Compare two snapshots and decide whether the new one is \"key\" — i.e. worth\n * bypassing the per-channel throttle. Anything visible to the user as a\n * progress milestone qualifies; counts ticking by alone do not.\n /\nfunction isKeyEvent(prev: WorkflowSnapshot \| undefined, next: WorkflowSnapshot): boolean {\n if (!prev) return true; // first update of the run\n if (prev.currentPhase !== next.currentPhase) return true;\n if (next.errorCount > prev.errorCount) return true;\n if (next.skippedCount > prev.skippedCount) return true;\n // New phase row in the rollup (declared via `phase(...)` mid-run)\n if (prev.phases.length !== next.phases.length) return true;\n if (hasNewFailedAgent(prev.agents, next.agents)) return true;\n return false;\n}\n\nfunction hasNewFailedAgent(\n prev: WorkflowAgentSnapshot[],\n next: WorkflowAgentSnapshot[],\n): boolean {\n const prevBad = new Set(\n prev.filter((a) => a.status === 'error' \|\| a.status === 'skipped').map((a) => a.id),\n );\n for (const a of next) {\n if ((a.status === 'error' \|\| a.status === 'skipped') && !prevBad.has(a.id)) return true;\n }\n return false;\n}\n\n/\n Pull a {@link WorkflowSnapshot} out of an AgentToolResult-shaped value.\n * Returns null when the payload is not snapshot-shaped (text-only updates,\n * non-workflow tools, etc.).\n \n `fromResultEnvelope = true` (used for `tool_end.result`) tolerates the\n * `{ content, details }` wrapper.\n */\nfunction extractWorkflowSnapshot(\n payload: unknown,\n opts: { fromResultEnvelope?: boolean } = {},\n): WorkflowSnapshot \| null {\n if (!payload \|\| typeof payload !== 'object') return null;\n const rec = payload as Record<string, unknown>;\n if (opts.fromResultEnvelope) {\n const details = rec.details;\n if (details && typeof details === 'object') return coerce(details);\n return null;\n }\n if ('details' in rec) {\n const details = rec.details;\n if (details && typeof details === 'object') return coerce(details);\n return null;\n }\n return coerce(rec);\n}\n\nfunction coerce(value: unknown): WorkflowSnapshot \| null {\n if (!value \|\| typeof value !== 'object') return null;\n const rec = value as Record<string, unknown>;\n if (typeof rec.name !== 'string') return null;\n if (!Array.isArray(rec.agents)) return null;\n return value as WorkflowSnapshot;\n}\n\nfunction readChannelConfig(\n config: Config \| undefined,\n channelId: string,\n): { enabled?: boolean; throttleMs?: number; mode?: WorkflowProgressMode } \| undefined {\n const channels = config?.channels as Record<string, unknown> \| undefined;\n if (!channels) return undefined;\n const cfg = channels[channelId];\n if (!cfg \|\| typeof cfg !== 'object') return undefined;\n const wf = (cfg as { workflowProgress?: unknown }).workflowProgress;\n if (!wf \|\| typeof wf !== 'object') return undefined;\n return wf as { enabled?: boolean; throttleMs?: number; mode?: WorkflowProgressMode };\n}\n"],"mappings":"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"}

package/dist/src/agent/workflow/subagent-runner.js CHANGED Viewed

@@ -5,7 +5,7 @@ import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS } from "../tools/delegat
 import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
 //#region src/agent/workflow/subagent-runner.ts
 init_logger();
-const log = createLogger("workflow-subagent-runner");
+const log = createLogger("Agent:WorkflowSubagent");
 const DEFAULT_MAX_ITERATIONS = 30;
 var DelegateSubagentRunner = class {
 	constructor(deps) {

package/dist/src/agent/workflow/subagent-runner.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"subagent-runner.js","names":[],"sources":["../../../../src/agent/workflow/subagent-runner.ts"],"sourcesContent":["/*\n Adapter: spawns one isolated child agent per `agent()` call from a workflow.\n \n Wraps the existing `createDelegateChildHandle` so the workflow runtime stays\n * decoupled from the LLM stack (it sees only the `SubagentRunner` interface).\n \n Key behaviour:\n * - When `opts.schema` is provided, we inject `structured_output` into the child\n * tool set and unwrap the captured value on success. If the subagent finishes\n * without ever calling `structured_output`, we treat it as failure (`null`).\n * - Failures and aborts resolve to `null`. The workflow runtime continues — this\n * matches the pi-dynamic-workflows contract and keeps fan-out pipelines robust.\n * - We do NOT mutate `createDelegateChildHandle` — we just leverage its\n * `buildChildTools` injection point.\n /\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n type BuildChildToolsOptions,\n createDelegateChildHandle,\n type DelegateChildHandleOptions,\n} from '../child-agent-factory.js';\nimport {\n DEFAULT_DELEGATE_TOOLS,\n DELEGATE_BLOCKED_TOOLS,\n} from '../tools/delegate-tool.js';\nimport type { ToolExecutorConfig } from '../tools/executor.js';\n\nimport {\n createStructuredOutputTool,\n STRUCTURED_OUTPUT_TOOL_NAME,\n type StructuredOutputCapture,\n} from './structured-output-tool.js';\nimport type { SubagentRunOptions, SubagentRunner, SubagentProgressEvent } from './types.js';\n\nconst log = createLogger('workflow-subagent-runner');\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport interface DelegateSubagentRunnerDeps {\n workspace: string;\n bus: MessageBus;\n /* Resolves the default subagent model (typically the parent agent's primary model). /\n getDefaultModel: () => Model<Api>;\n getConfig: () => Config \| undefined;\n toolExecutorConfig?: Partial<ToolExecutorConfig>;\n /\n Provided by the workflow tool from `AgentToolsFactory` — mirrors how\n * `delegate-tool` is wired (avoids importing `tools/factory.ts` here and\n * breaking the existing factory ↔ delegate-tool ↔ child-agent-factory\n * dependency contract).\n */\n buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class DelegateSubagentRunner implements SubagentRunner {\n constructor(private readonly deps: DelegateSubagentRunnerDeps) {}\n\n async run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T \| null> {\n if (opts.signal?.aborted) return null;\n\n const capture: StructuredOutputCapture<T> = { called: false, value: undefined };\n const wantStructured = Boolean(opts.schema);\n\n const allowed = resolveAllowedToolNames(opts.allowedToolNames, wantStructured);\n const model = opts.model ?? safeResolveDefaultModel(this.deps.getDefaultModel);\n if (!model) {\n log.warn({ label: opts.label }, 'subagent run skipped: no primary model resolved');\n return null;\n }\n\n const fullPrompt = buildPrompt(prompt, opts, wantStructured);\n const streamMode = resolveSubagentStreamMode(this.deps.getConfig);\n\n const childOptions: DelegateChildHandleOptions = {\n workspace: this.deps.workspace,\n goal: fullPrompt,\n allowedToolNames: allowed,\n maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,\n model,\n bus: this.deps.bus,\n getConfig: this.deps.getConfig,\n toolExecutorConfig: this.deps.toolExecutorConfig,\n buildChildTools: (childOpts) => {\n const base = this.deps.buildChildTools(childOpts);\n if (!wantStructured \|\| !opts.schema) return base;\n // Replace any existing tool with the same name so the per-run capture wins.\n const filtered = base.filter((t) => t.name !== STRUCTURED_OUTPUT_TOOL_NAME);\n return [\n ...filtered,\n createStructuredOutputTool({ schema: opts.schema, capture }) as unknown as AgentTool<any, any>,\n ];\n },\n progressHooks:\n opts.onProgress && streamMode !== 'off'\n ? {\n mode: streamMode === 'full' ? 'full' : 'steps',\n onProgress: (event) => {\n opts.onProgress?.(mapChildProgressEvent(event));\n },\n }\n : undefined,\n };\n\n const handle = createDelegateChildHandle(childOptions);\n const onAbort = () => handle.abort();\n opts.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n const { summary } = await handle.run();\n if (opts.signal?.aborted) return null;\n\n if (wantStructured) {\n if (!capture.called) {\n log.warn({ label: opts.label }, 'subagent finished without calling structured_output');\n return null;\n }\n return capture.value as T;\n }\n return summary as unknown as T;\n } catch (e) {\n if (opts.rethrow) throw e;\n const msg = e instanceof Error ? e.message : String(e);\n log.warn({ err: e, label: opts.label, errorMessage: msg }, `subagent run failed: ${msg}`);\n return null;\n } finally {\n opts.signal?.removeEventListener('abort', onAbort);\n }\n }\n}\n\nfunction resolveAllowedToolNames(\n requested: string[] \| undefined,\n wantStructured: boolean,\n): string[] {\n const base = requested && requested.length > 0 ? requested : [...DEFAULT_DELEGATE_TOOLS];\n const filtered = base\n .map((s) => String(s).trim())\n .filter((s) => s.length > 0)\n .filter((s) => !DELEGATE_BLOCKED_TOOLS.has(s));\n if (wantStructured && !filtered.includes(STRUCTURED_OUTPUT_TOOL_NAME)) {\n filtered.push(STRUCTURED_OUTPUT_TOOL_NAME);\n }\n return [...new Set(filtered)];\n}\n\nfunction buildPrompt(prompt: string, opts: SubagentRunOptions<unknown>, structured: boolean): string {\n const parts: string[] = [];\n if (opts.instructions?.trim()) parts.push(opts.instructions.trim());\n if (opts.label) parts.push(`Task label: ${opts.label}`);\n if (opts.phase) parts.push(`Workflow phase: ${opts.phase}`);\n parts.push(prompt);\n if (structured) {\n parts.push(\n [\n 'Final output contract:',\n '- Your final action MUST be a structured_output tool call.',\n '- The structured_output arguments are the return value of this subagent.',\n '- Do not emit a prose final answer instead of structured_output.',\n '- If you need to inspect files or run commands first, do so, then call structured_output exactly once.',\n ].join('\\n'),\n );\n }\n return parts.join('\\n\\n');\n}\n\nfunction safeResolveDefaultModel(get: () => Model<Api>): Model<Api> \| null {\n try {\n return get();\n } catch (e) {\n log.warn({ err: e }, 'failed to resolve default subagent model');\n return null;\n }\n}\n\nfunction resolveSubagentStreamMode(\n getConfig: () => Config \| undefined,\n): 'off' \| 'steps' \| 'full' {\n const mode = getConfig()?.agents?.defaults?.workflow?.subagentStream;\n if (mode === 'off' \|\| mode === 'steps' \|\| mode === 'full') return mode;\n return 'steps';\n}\n\nfunction mapChildProgressEvent(event: {\n type: 'tool_start' \| 'tool_end' \| 'iteration' \| 'text_delta' \| 'thinking_delta';\n toolCallId?: string;\n toolName?: string;\n args?: Record<string, unknown>;\n isError?: boolean;\n resultPreview?: string;\n error?: string;\n count?: number;\n max?: number;\n delta?: string;\n}): SubagentProgressEvent {\n switch (event.type) {\n case 'tool_start':\n return {\n type: 'tool_start',\n toolCallId: event.toolCallId ?? '',\n toolName: event.toolName ?? 'tool',\n args: event.args ?? {},\n };\n case 'tool_end':\n return {\n type: 'tool_end',\n toolCallId: event.toolCallId ?? '',\n toolName: event.toolName ?? 'tool',\n isError: Boolean(event.isError),\n resultPreview: event.resultPreview,\n error: event.error,\n };\n case 'iteration':\n return {\n type: 'iteration',\n count: event.count ?? 0,\n max: event.max ?? 0,\n };\n case 'text_delta':\n return { type: 'text_delta', delta: event.delta ?? '' };\n case 'thinking_delta':\n return { type: 'thinking_delta', delta: event.delta ?? '' };\n default:\n return { type: 'text_delta', delta: '' };\n }\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"subagent-runner.js","names":[],"sources":["../../../../src/agent/workflow/subagent-runner.ts"],"sourcesContent":["/*\n Adapter: spawns one isolated child agent per `agent()` call from a workflow.\n \n Wraps the existing `createDelegateChildHandle` so the workflow runtime stays\n * decoupled from the LLM stack (it sees only the `SubagentRunner` interface).\n \n Key behaviour:\n * - When `opts.schema` is provided, we inject `structured_output` into the child\n * tool set and unwrap the captured value on success. If the subagent finishes\n * without ever calling `structured_output`, we treat it as failure (`null`).\n * - Failures and aborts resolve to `null`. The workflow runtime continues — this\n * matches the pi-dynamic-workflows contract and keeps fan-out pipelines robust.\n * - We do NOT mutate `createDelegateChildHandle` — we just leverage its\n * `buildChildTools` injection point.\n /\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n type BuildChildToolsOptions,\n createDelegateChildHandle,\n type DelegateChildHandleOptions,\n} from '../child-agent-factory.js';\nimport {\n DEFAULT_DELEGATE_TOOLS,\n DELEGATE_BLOCKED_TOOLS,\n} from '../tools/delegate-tool.js';\nimport type { ToolExecutorConfig } from '../tools/executor.js';\n\nimport {\n createStructuredOutputTool,\n STRUCTURED_OUTPUT_TOOL_NAME,\n type StructuredOutputCapture,\n} from './structured-output-tool.js';\nimport type { SubagentRunOptions, SubagentRunner, SubagentProgressEvent } from './types.js';\n\nconst log = createLogger('Agent:WorkflowSubagent');\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport interface DelegateSubagentRunnerDeps {\n workspace: string;\n bus: MessageBus;\n /* Resolves the default subagent model (typically the parent agent's primary model). /\n getDefaultModel: () => Model<Api>;\n getConfig: () => Config \| undefined;\n toolExecutorConfig?: Partial<ToolExecutorConfig>;\n /\n Provided by the workflow tool from `AgentToolsFactory` — mirrors how\n * `delegate-tool` is wired (avoids importing `tools/factory.ts` here and\n * breaking the existing factory ↔ delegate-tool ↔ child-agent-factory\n * dependency contract).\n */\n buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class DelegateSubagentRunner implements SubagentRunner {\n constructor(private readonly deps: DelegateSubagentRunnerDeps) {}\n\n async run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T \| null> {\n if (opts.signal?.aborted) return null;\n\n const capture: StructuredOutputCapture<T> = { called: false, value: undefined };\n const wantStructured = Boolean(opts.schema);\n\n const allowed = resolveAllowedToolNames(opts.allowedToolNames, wantStructured);\n const model = opts.model ?? safeResolveDefaultModel(this.deps.getDefaultModel);\n if (!model) {\n log.warn({ label: opts.label }, 'subagent run skipped: no primary model resolved');\n return null;\n }\n\n const fullPrompt = buildPrompt(prompt, opts, wantStructured);\n const streamMode = resolveSubagentStreamMode(this.deps.getConfig);\n\n const childOptions: DelegateChildHandleOptions = {\n workspace: this.deps.workspace,\n goal: fullPrompt,\n allowedToolNames: allowed,\n maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,\n model,\n bus: this.deps.bus,\n getConfig: this.deps.getConfig,\n toolExecutorConfig: this.deps.toolExecutorConfig,\n buildChildTools: (childOpts) => {\n const base = this.deps.buildChildTools(childOpts);\n if (!wantStructured \|\| !opts.schema) return base;\n // Replace any existing tool with the same name so the per-run capture wins.\n const filtered = base.filter((t) => t.name !== STRUCTURED_OUTPUT_TOOL_NAME);\n return [\n ...filtered,\n createStructuredOutputTool({ schema: opts.schema, capture }) as unknown as AgentTool<any, any>,\n ];\n },\n progressHooks:\n opts.onProgress && streamMode !== 'off'\n ? {\n mode: streamMode === 'full' ? 'full' : 'steps',\n onProgress: (event) => {\n opts.onProgress?.(mapChildProgressEvent(event));\n },\n }\n : undefined,\n };\n\n const handle = createDelegateChildHandle(childOptions);\n const onAbort = () => handle.abort();\n opts.signal?.addEventListener('abort', onAbort, { once: true });\n\n try {\n const { summary } = await handle.run();\n if (opts.signal?.aborted) return null;\n\n if (wantStructured) {\n if (!capture.called) {\n log.warn({ label: opts.label }, 'subagent finished without calling structured_output');\n return null;\n }\n return capture.value as T;\n }\n return summary as unknown as T;\n } catch (e) {\n if (opts.rethrow) throw e;\n const msg = e instanceof Error ? e.message : String(e);\n log.warn({ err: e, label: opts.label, errorMessage: msg }, `subagent run failed: ${msg}`);\n return null;\n } finally {\n opts.signal?.removeEventListener('abort', onAbort);\n }\n }\n}\n\nfunction resolveAllowedToolNames(\n requested: string[] \| undefined,\n wantStructured: boolean,\n): string[] {\n const base = requested && requested.length > 0 ? requested : [...DEFAULT_DELEGATE_TOOLS];\n const filtered = base\n .map((s) => String(s).trim())\n .filter((s) => s.length > 0)\n .filter((s) => !DELEGATE_BLOCKED_TOOLS.has(s));\n if (wantStructured && !filtered.includes(STRUCTURED_OUTPUT_TOOL_NAME)) {\n filtered.push(STRUCTURED_OUTPUT_TOOL_NAME);\n }\n return [...new Set(filtered)];\n}\n\nfunction buildPrompt(prompt: string, opts: SubagentRunOptions<unknown>, structured: boolean): string {\n const parts: string[] = [];\n if (opts.instructions?.trim()) parts.push(opts.instructions.trim());\n if (opts.label) parts.push(`Task label: ${opts.label}`);\n if (opts.phase) parts.push(`Workflow phase: ${opts.phase}`);\n parts.push(prompt);\n if (structured) {\n parts.push(\n [\n 'Final output contract:',\n '- Your final action MUST be a structured_output tool call.',\n '- The structured_output arguments are the return value of this subagent.',\n '- Do not emit a prose final answer instead of structured_output.',\n '- If you need to inspect files or run commands first, do so, then call structured_output exactly once.',\n ].join('\\n'),\n );\n }\n return parts.join('\\n\\n');\n}\n\nfunction safeResolveDefaultModel(get: () => Model<Api>): Model<Api> \| null {\n try {\n return get();\n } catch (e) {\n log.warn({ err: e }, 'failed to resolve default subagent model');\n return null;\n }\n}\n\nfunction resolveSubagentStreamMode(\n getConfig: () => Config \| undefined,\n): 'off' \| 'steps' \| 'full' {\n const mode = getConfig()?.agents?.defaults?.workflow?.subagentStream;\n if (mode === 'off' \|\| mode === 'steps' \|\| mode === 'full') return mode;\n return 'steps';\n}\n\nfunction mapChildProgressEvent(event: {\n type: 'tool_start' \| 'tool_end' \| 'iteration' \| 'text_delta' \| 'thinking_delta';\n toolCallId?: string;\n toolName?: string;\n args?: Record<string, unknown>;\n isError?: boolean;\n resultPreview?: string;\n error?: string;\n count?: number;\n max?: number;\n delta?: string;\n}): SubagentProgressEvent {\n switch (event.type) {\n case 'tool_start':\n return {\n type: 'tool_start',\n toolCallId: event.toolCallId ?? '',\n toolName: event.toolName ?? 'tool',\n args: event.args ?? {},\n };\n case 'tool_end':\n return {\n type: 'tool_end',\n toolCallId: event.toolCallId ?? '',\n toolName: event.toolName ?? 'tool',\n isError: Boolean(event.isError),\n resultPreview: event.resultPreview,\n error: event.error,\n };\n case 'iteration':\n return {\n type: 'iteration',\n count: event.count ?? 0,\n max: event.max ?? 0,\n };\n case 'text_delta':\n return { type: 'text_delta', delta: event.delta ?? '' };\n case 'thinking_delta':\n return { type: 'thinking_delta', delta: event.delta ?? '' };\n default:\n return { type: 'text_delta', delta: '' };\n }\n}\n"],"mappings":"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"}

package/dist/src/channels/pipeline.js CHANGED Viewed

@@ -61,8 +61,9 @@ var MessagePipeline = class {
 			} catch (err) {
 				log.error({
 					channel,
-					err
-				}, "Process handler error");
+					err,
+					phase: "channel.inbound"
+				}, `Process handler error: ${err instanceof Error ? err.message : String(err)}`);
 				this.onError?.(err, processedCtx);
 				return;
 			}

package/dist/src/channels/pipeline.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"pipeline.js","names":[],"sources":["../../../src/channels/pipeline.ts"],"sourcesContent":["/*\n Message Processing Pipeline\n * \n * Three-stage pipeline:\n * - Preflight: Filter empty messages, self-messages, detect commands\n * - Process: Transform format, extract metadata\n * - Delivery: Send to Agent\n /\n\nimport { randomUUID } from 'node:crypto';\n\nimport { createLogger, runWithLogContext, updateAsyncLogContext } from '../utils/logger.js';\nimport type { AgentResponse } from './plugin-types.js';\nimport { formatEnvelopeTimestamp } from './envelope-timestamp.js';\n\n// Re-export for convenience\nexport type { AgentResponse } from './plugin-types.js';\n\nconst log = createLogger('Pipeline');\n\nfunction pipelineLogRequestId(ctx: PipelineMessageContext): string {\n const raw = ctx.metadata?.requestId;\n if (typeof raw === 'string' && raw.trim().length > 0) {\n return raw.trim();\n }\n return randomUUID();\n}\n\nfunction pipelineLogSessionId(ctx: PipelineMessageContext): string {\n const sk = ctx.metadata?.sessionKey;\n if (typeof sk === 'string' && sk.trim().length > 0) {\n return sk.trim();\n }\n return `${ctx.channel}:${ctx.chatId}`;\n}\n\n// ============================================\n// Types\n// ============================================\n\nexport interface PipelineMessageContext {\n /* Channel identifier /\n channel: string;\n /* Account ID /\n accountId: string;\n /* Chat ID /\n chatId: string;\n /* Sender ID /\n senderId: string;\n /* Message content /\n content: string;\n /* Original message metadata /\n metadata: Record<string, unknown>;\n /* Is group chat /\n isGroup: boolean;\n /* Is direct message /\n isDm: boolean;\n /* Thread ID (optional) /\n threadId?: string;\n /* Message ID (optional) /\n messageId?: string;\n}\n\nexport interface PipelineMediaRef {\n type: 'photo' \| 'video' \| 'audio' \| 'document' \| 'voice';\n fileId: string;\n mimeType?: string;\n fileName?: string;\n url?: string;\n}\n\n// ============================================\n// Handler Interfaces\n// ============================================\n\nexport interface PreflightHandler {\n /* Handler name /\n name: string;\n /* Preflight - return null to skip message /\n preflight?(ctx: PipelineMessageContext): Promise<PipelineMessageContext \| null>;\n}\n\nexport interface ProcessHandler {\n /* Handler name /\n name: string;\n /* Process message - transform and extract /\n process(ctx: PipelineMessageContext): Promise<PipelineMessageContext>;\n}\n\nexport interface DeliveryHandler {\n /* Handler name /\n name: string;\n /* Deliver message to Agent /\n deliver(ctx: PipelineMessageContext, response: AgentResponse): Promise<void>;\n}\n\n// ============================================\n// Pipeline Options\n// ============================================\n\nexport interface PipelineOptions {\n /* Channel name /\n channel: string;\n /* Preflight handlers /\n preflightHandlers?: PreflightHandler[];\n /* Process handlers /\n processHandlers?: ProcessHandler[];\n /* Delivery handlers /\n deliveryHandlers?: DeliveryHandler[];\n /* Agent callback /\n agentInvoke?: (ctx: PipelineMessageContext) => Promise<AgentResponse>;\n /* Error handler /\n onError?: (err: unknown, ctx: PipelineMessageContext) => void;\n}\n\n// ============================================\n// Pipeline Implementation\n// ============================================\n\nexport class MessagePipeline {\n private channel: string;\n private preflightHandlers: PreflightHandler[];\n private processHandlers: ProcessHandler[];\n private deliveryHandlers: DeliveryHandler[];\n private agentInvoke?: PipelineOptions['agentInvoke'];\n private onError?: PipelineOptions['onError'];\n\n constructor(options: PipelineOptions) {\n this.channel = options.channel;\n this.preflightHandlers = options.preflightHandlers ?? [];\n this.processHandlers = options.processHandlers ?? [];\n this.deliveryHandlers = options.deliveryHandlers ?? [];\n this.agentInvoke = options.agentInvoke;\n this.onError = options.onError;\n }\n\n /\n Handle inbound message\n /\n async handleMessage(ctx: PipelineMessageContext): Promise<void> {\n const channel = this.channel;\n const requestId = pipelineLogRequestId(ctx);\n\n await runWithLogContext(\n {\n requestId,\n sessionId: pipelineLogSessionId(ctx),\n },\n async () => {\n // 1. Preflight stage\n let processedCtx = await this.runPreflight(ctx);\n if (!processedCtx) {\n log.debug({ channel, chatId: ctx.chatId }, 'Message filtered in preflight');\n return;\n }\n\n // 2. Process stage\n try {\n processedCtx = await this.runProcess(processedCtx);\n } catch (err) {\n log.error({ channel, err }, 'Process handler error');\n this.onError?.(err, processedCtx);\n return;\n }\n\n const resolvedSk = processedCtx.metadata?.sessionKey;\n if (typeof resolvedSk === 'string' && resolvedSk.trim().length > 0) {\n updateAsyncLogContext({ sessionId: resolvedSk.trim() });\n }\n\n // 3. Deliver to Agent\n if (!this.agentInvoke) {\n log.warn({ channel }, 'No agentInvoke configured');\n return;\n }\n\n let response: AgentResponse;\n try {\n response = await this.agentInvoke(processedCtx);\n } catch (err) {\n log.error({ channel, err }, 'Agent invocation error');\n this.onError?.(err, processedCtx);\n return;\n }\n\n // 4. Delivery stage\n try {\n await this.runDelivery(processedCtx, response);\n } catch (err) {\n log.error({ channel, err }, 'Delivery handler error');\n this.onError?.(err, processedCtx);\n }\n },\n );\n }\n\n private async runPreflight(ctx: PipelineMessageContext): Promise<PipelineMessageContext \| null> {\n for (const handler of this.preflightHandlers) {\n try {\n const result = await handler.preflight?.(ctx);\n if (!result) {\n log.debug({ channel: this.channel, handler: handler.name }, 'Preflight filtered message');\n return null;\n }\n ctx = result;\n } catch (err) {\n log.error({ channel: this.channel, handler: handler.name, err }, 'Preflight handler error');\n return null;\n }\n }\n return ctx;\n }\n\n private async runProcess(ctx: PipelineMessageContext): Promise<PipelineMessageContext> {\n for (const handler of this.processHandlers) {\n try {\n ctx = await handler.process(ctx);\n } catch (err) {\n log.error({ channel: this.channel, handler: handler.name, err }, 'Process handler error');\n throw err;\n }\n }\n return ctx;\n }\n\n private async runDelivery(ctx: PipelineMessageContext, response: AgentResponse): Promise<void> {\n for (const handler of this.deliveryHandlers) {\n try {\n await handler.deliver(ctx, response);\n } catch (err) {\n log.error({ channel: this.channel, handler: handler.name, err }, 'Delivery handler error');\n throw err;\n }\n }\n }\n}\n\n// ============================================\n// Standard Handlers\n// ============================================\n\n/\n Create filter-self handler\n /\nexport function createFilterSelfHandler(currentBotId: string): PreflightHandler {\n return {\n name: 'filterSelf',\n preflight: async (ctx) => {\n if (ctx.senderId === currentBotId) {\n return null;\n }\n return ctx;\n },\n };\n}\n\n/\n Create filter-empty handler\n /\nexport function createFilterEmptyHandler(): PreflightHandler {\n return {\n name: 'filterEmpty',\n preflight: async (ctx) => {\n const content = ctx.content?.trim() ?? '';\n if (!content && (!ctx.metadata.media \|\| (ctx.metadata.media as PipelineMediaRef[]).length === 0)) {\n return null;\n }\n return ctx;\n },\n };\n}\n\n/\n Create filter-commands handler\n /\nexport function createFilterCommandsHandler(commands: string[]): PreflightHandler {\n const commandSet = new Set(commands.map(c => c.toLowerCase()));\n return {\n name: 'filterCommands',\n preflight: async (ctx) => {\n const firstWord = ctx.content?.split(/\\s/)[0]?.toLowerCase() ?? '';\n if (firstWord.startsWith('/') && commandSet.has(firstWord.slice(1))) {\n ctx.metadata.isCommand = true;\n ctx.metadata.command = firstWord.slice(1);\n }\n return ctx;\n },\n };\n}\n\n/\n Create standard preflight handlers\n /\nexport function standardPreflightHandlers(botId: string): PreflightHandler[] {\n return [\n createFilterSelfHandler(botId),\n createFilterEmptyHandler(),\n createFilterCommandsHandler(['start', 'help', 'status', 'stop']),\n ];\n}\n\n/\n Prepends a per-turn `[YYYY-MM-DD HH:MM TZ]` prefix to inbound text so the model has\n * a stable \"now\" without changing the system prompt (prompt-cache friendly).\n /\nexport function createEnvelopeTimestampHandler(timezone?: string): ProcessHandler {\n return {\n name: 'envelopeTimestamp',\n process: async (ctx) => {\n const text = ctx.content?.trim();\n if (!text) {\n return ctx;\n }\n const timestamp = formatEnvelopeTimestamp(timezone);\n return { ...ctx, content: `[${timestamp}] ${ctx.content}` };\n },\n };\n}\n\n/\n Create standard process handlers\n /\nexport function standardProcessHandlers(timezone?: string): ProcessHandler[] {\n return [createEnvelopeTimestampHandler(timezone)];\n}\n\n// ============================================\n// Factory\n// ============================================\n\nexport interface CreatePipelineParams {\n channel: string;\n botId: string;\n agentInvoke: PipelineOptions['agentInvoke'];\n onError?: PipelineOptions['onError'];\n /* IANA timezone — matches userTimezone from agent config / USER.md /\n timezone?: string;\n}\n\n/\n Create message processing pipeline\n */\nexport function createPipeline(params: CreatePipelineParams): MessagePipeline {\n return new MessagePipeline({\n channel: params.channel,\n preflightHandlers: standardPreflightHandlers(params.botId),\n processHandlers: standardProcessHandlers(params.timezone),\n agentInvoke: params.agentInvoke,\n onError: params.onError,\n });\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"pipeline.js","names":[],"sources":["../../../src/channels/pipeline.ts"],"sourcesContent":["/*\n Message Processing Pipeline\n * \n * Three-stage pipeline:\n * - Preflight: Filter empty messages, self-messages, detect commands\n * - Process: Transform format, extract metadata\n * - Delivery: Send to Agent\n /\n\nimport { randomUUID } from 'node:crypto';\n\nimport { createLogger, runWithLogContext, updateAsyncLogContext } from '../utils/logger.js';\nimport type { AgentResponse } from './plugin-types.js';\nimport { formatEnvelopeTimestamp } from './envelope-timestamp.js';\n\n// Re-export for convenience\nexport type { AgentResponse } from './plugin-types.js';\n\nconst log = createLogger('Pipeline');\n\nfunction pipelineLogRequestId(ctx: PipelineMessageContext): string {\n const raw = ctx.metadata?.requestId;\n if (typeof raw === 'string' && raw.trim().length > 0) {\n return raw.trim();\n }\n return randomUUID();\n}\n\nfunction pipelineLogSessionId(ctx: PipelineMessageContext): string {\n const sk = ctx.metadata?.sessionKey;\n if (typeof sk === 'string' && sk.trim().length > 0) {\n return sk.trim();\n }\n return `${ctx.channel}:${ctx.chatId}`;\n}\n\n// ============================================\n// Types\n// ============================================\n\nexport interface PipelineMessageContext {\n /* Channel identifier /\n channel: string;\n /* Account ID /\n accountId: string;\n /* Chat ID /\n chatId: string;\n /* Sender ID /\n senderId: string;\n /* Message content /\n content: string;\n /* Original message metadata /\n metadata: Record<string, unknown>;\n /* Is group chat /\n isGroup: boolean;\n /* Is direct message /\n isDm: boolean;\n /* Thread ID (optional) /\n threadId?: string;\n /* Message ID (optional) /\n messageId?: string;\n}\n\nexport interface PipelineMediaRef {\n type: 'photo' \| 'video' \| 'audio' \| 'document' \| 'voice';\n fileId: string;\n mimeType?: string;\n fileName?: string;\n url?: string;\n}\n\n// ============================================\n// Handler Interfaces\n// ============================================\n\nexport interface PreflightHandler {\n /* Handler name /\n name: string;\n /* Preflight - return null to skip message /\n preflight?(ctx: PipelineMessageContext): Promise<PipelineMessageContext \| null>;\n}\n\nexport interface ProcessHandler {\n /* Handler name /\n name: string;\n /* Process message - transform and extract /\n process(ctx: PipelineMessageContext): Promise<PipelineMessageContext>;\n}\n\nexport interface DeliveryHandler {\n /* Handler name /\n name: string;\n /* Deliver message to Agent /\n deliver(ctx: PipelineMessageContext, response: AgentResponse): Promise<void>;\n}\n\n// ============================================\n// Pipeline Options\n// ============================================\n\nexport interface PipelineOptions {\n /* Channel name /\n channel: string;\n /* Preflight handlers /\n preflightHandlers?: PreflightHandler[];\n /* Process handlers /\n processHandlers?: ProcessHandler[];\n /* Delivery handlers /\n deliveryHandlers?: DeliveryHandler[];\n /* Agent callback /\n agentInvoke?: (ctx: PipelineMessageContext) => Promise<AgentResponse>;\n /* Error handler /\n onError?: (err: unknown, ctx: PipelineMessageContext) => void;\n}\n\n// ============================================\n// Pipeline Implementation\n// ============================================\n\nexport class MessagePipeline {\n private channel: string;\n private preflightHandlers: PreflightHandler[];\n private processHandlers: ProcessHandler[];\n private deliveryHandlers: DeliveryHandler[];\n private agentInvoke?: PipelineOptions['agentInvoke'];\n private onError?: PipelineOptions['onError'];\n\n constructor(options: PipelineOptions) {\n this.channel = options.channel;\n this.preflightHandlers = options.preflightHandlers ?? [];\n this.processHandlers = options.processHandlers ?? [];\n this.deliveryHandlers = options.deliveryHandlers ?? [];\n this.agentInvoke = options.agentInvoke;\n this.onError = options.onError;\n }\n\n /\n Handle inbound message\n /\n async handleMessage(ctx: PipelineMessageContext): Promise<void> {\n const channel = this.channel;\n const requestId = pipelineLogRequestId(ctx);\n\n await runWithLogContext(\n {\n requestId,\n sessionId: pipelineLogSessionId(ctx),\n },\n async () => {\n // 1. Preflight stage\n let processedCtx = await this.runPreflight(ctx);\n if (!processedCtx) {\n log.debug({ channel, chatId: ctx.chatId }, 'Message filtered in preflight');\n return;\n }\n\n // 2. Process stage\n try {\n processedCtx = await this.runProcess(processedCtx);\n } catch (err) {\n log.error({ channel, err, phase: 'channel.inbound' }, `Process handler error: ${err instanceof Error ? err.message : String(err)}`);\n this.onError?.(err, processedCtx);\n return;\n }\n\n const resolvedSk = processedCtx.metadata?.sessionKey;\n if (typeof resolvedSk === 'string' && resolvedSk.trim().length > 0) {\n updateAsyncLogContext({ sessionId: resolvedSk.trim() });\n }\n\n // 3. Deliver to Agent\n if (!this.agentInvoke) {\n log.warn({ channel }, 'No agentInvoke configured');\n return;\n }\n\n let response: AgentResponse;\n try {\n response = await this.agentInvoke(processedCtx);\n } catch (err) {\n log.error({ channel, err }, 'Agent invocation error');\n this.onError?.(err, processedCtx);\n return;\n }\n\n // 4. Delivery stage\n try {\n await this.runDelivery(processedCtx, response);\n } catch (err) {\n log.error({ channel, err }, 'Delivery handler error');\n this.onError?.(err, processedCtx);\n }\n },\n );\n }\n\n private async runPreflight(ctx: PipelineMessageContext): Promise<PipelineMessageContext \| null> {\n for (const handler of this.preflightHandlers) {\n try {\n const result = await handler.preflight?.(ctx);\n if (!result) {\n log.debug({ channel: this.channel, handler: handler.name }, 'Preflight filtered message');\n return null;\n }\n ctx = result;\n } catch (err) {\n log.error({ channel: this.channel, handler: handler.name, err }, 'Preflight handler error');\n return null;\n }\n }\n return ctx;\n }\n\n private async runProcess(ctx: PipelineMessageContext): Promise<PipelineMessageContext> {\n for (const handler of this.processHandlers) {\n try {\n ctx = await handler.process(ctx);\n } catch (err) {\n log.error({ channel: this.channel, handler: handler.name, err }, 'Process handler error');\n throw err;\n }\n }\n return ctx;\n }\n\n private async runDelivery(ctx: PipelineMessageContext, response: AgentResponse): Promise<void> {\n for (const handler of this.deliveryHandlers) {\n try {\n await handler.deliver(ctx, response);\n } catch (err) {\n log.error({ channel: this.channel, handler: handler.name, err }, 'Delivery handler error');\n throw err;\n }\n }\n }\n}\n\n// ============================================\n// Standard Handlers\n// ============================================\n\n/\n Create filter-self handler\n /\nexport function createFilterSelfHandler(currentBotId: string): PreflightHandler {\n return {\n name: 'filterSelf',\n preflight: async (ctx) => {\n if (ctx.senderId === currentBotId) {\n return null;\n }\n return ctx;\n },\n };\n}\n\n/\n Create filter-empty handler\n /\nexport function createFilterEmptyHandler(): PreflightHandler {\n return {\n name: 'filterEmpty',\n preflight: async (ctx) => {\n const content = ctx.content?.trim() ?? '';\n if (!content && (!ctx.metadata.media \|\| (ctx.metadata.media as PipelineMediaRef[]).length === 0)) {\n return null;\n }\n return ctx;\n },\n };\n}\n\n/\n Create filter-commands handler\n /\nexport function createFilterCommandsHandler(commands: string[]): PreflightHandler {\n const commandSet = new Set(commands.map(c => c.toLowerCase()));\n return {\n name: 'filterCommands',\n preflight: async (ctx) => {\n const firstWord = ctx.content?.split(/\\s/)[0]?.toLowerCase() ?? '';\n if (firstWord.startsWith('/') && commandSet.has(firstWord.slice(1))) {\n ctx.metadata.isCommand = true;\n ctx.metadata.command = firstWord.slice(1);\n }\n return ctx;\n },\n };\n}\n\n/\n Create standard preflight handlers\n /\nexport function standardPreflightHandlers(botId: string): PreflightHandler[] {\n return [\n createFilterSelfHandler(botId),\n createFilterEmptyHandler(),\n createFilterCommandsHandler(['start', 'help', 'status', 'stop']),\n ];\n}\n\n/\n Prepends a per-turn `[YYYY-MM-DD HH:MM TZ]` prefix to inbound text so the model has\n * a stable \"now\" without changing the system prompt (prompt-cache friendly).\n /\nexport function createEnvelopeTimestampHandler(timezone?: string): ProcessHandler {\n return {\n name: 'envelopeTimestamp',\n process: async (ctx) => {\n const text = ctx.content?.trim();\n if (!text) {\n return ctx;\n }\n const timestamp = formatEnvelopeTimestamp(timezone);\n return { ...ctx, content: `[${timestamp}] ${ctx.content}` };\n },\n };\n}\n\n/\n Create standard process handlers\n /\nexport function standardProcessHandlers(timezone?: string): ProcessHandler[] {\n return [createEnvelopeTimestampHandler(timezone)];\n}\n\n// ============================================\n// Factory\n// ============================================\n\nexport interface CreatePipelineParams {\n channel: string;\n botId: string;\n agentInvoke: PipelineOptions['agentInvoke'];\n onError?: PipelineOptions['onError'];\n /* IANA timezone — matches userTimezone from agent config / USER.md /\n timezone?: string;\n}\n\n/\n Create message processing pipeline\n */\nexport function createPipeline(params: CreatePipelineParams): MessagePipeline {\n return new MessagePipeline({\n channel: params.channel,\n preflightHandlers: standardPreflightHandlers(params.botId),\n processHandlers: standardProcessHandlers(params.timezone),\n agentInvoke: params.agentInvoke,\n onError: params.onError,\n });\n}\n"],"mappings":"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"}

package/dist/src/cli/cli-log-level-preset.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 /**
  * Default the CLI console to `warn` when no log level is set, so routine `info`
  * output (extensions, diagnostics, etc.) does not clutter the terminal.
- * Opt in with `XOPC_LOG_LEVEL`, `LOG_LEVEL`, `DEBUG`, or `--verbose` / `-v`.
+ * Opt in with `XOPC_LOG_LEVEL` or `--verbose` / `-v`.
  * This module must load before any import of `../utils/logger.js`.
  */
 declare const env: NodeJS.ProcessEnv;

package/dist/src/cli/cli-log-level-preset.js CHANGED Viewed

@@ -2,11 +2,11 @@
 /**
 * Default the CLI console to `warn` when no log level is set, so routine `info`
 * output (extensions, diagnostics, etc.) does not clutter the terminal.
-* Opt in with `XOPC_LOG_LEVEL`, `LOG_LEVEL`, `DEBUG`, or `--verbose` / `-v`.
+* Opt in with `XOPC_LOG_LEVEL` or `--verbose` / `-v`.
 * This module must load before any import of `../utils/logger.js`.
 */
 const env = process.env;
-if (!env.VITEST && !env.TEST && !env.XOPC_LOG_LEVEL && !env.LOG_LEVEL && !env.DEBUG && !process.argv.includes("--verbose") && !process.argv.includes("-v")) env.XOPC_LOG_LEVEL = "warn";
+if (!env.VITEST && !env.TEST && !env.XOPC_LOG_LEVEL && !process.argv.includes("--verbose") && !process.argv.includes("-v")) env.XOPC_LOG_LEVEL = "warn";
 //#endregion
 export {};

package/dist/src/cli/cli-log-level-preset.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-log-level-preset.js","names":[],"sources":["../../../src/cli/cli-log-level-preset.ts"],"sourcesContent":["/*\n Default the CLI console to `warn` when no log level is set, so routine `info`\n * output (extensions, diagnostics, etc.) does not clutter the terminal.\n * Opt in with `XOPC_LOG_LEVEL`, `~~LOG_LEVEL`,~~ ~~`DEBUG`,~~ or `--verbose` / `-v`.\n * This module must load before any import of `../utils/logger.js`.\n */\nconst env = process.env;\nif (\n !env.VITEST &&\n !env.TEST &&\n !env.XOPC_LOG_LEVEL &&\n !~~env.LOG_LEVEL &&\n !env.DEBUG &&\n !~~process.argv.includes('--verbose') &&\n !process.argv.includes('-v')\n) {\n env.XOPC_LOG_LEVEL = 'warn';\n}\n"],"mappings":";;;;;;;AAMA,MAAM,MAAM,QAAQ;AACpB,IACE,CAAC,IAAI,UACL,CAAC,IAAI,QACL,CAAC,IAAI,kBACL,CAAC,~~IAAI,aACL,CAAC,IAAI,SACL,CAAC,~~QAAQ,KAAK,SAAS,YAAY,IACnC,CAAC,QAAQ,KAAK,SAAS,KAAK,CAE5B,KAAI,iBAAiB"}
1	+ {"version":3,"file":"cli-log-level-preset.js","names":[],"sources":["../../../src/cli/cli-log-level-preset.ts"],"sourcesContent":["/*\n Default the CLI console to `warn` when no log level is set, so routine `info`\n * output (extensions, diagnostics, etc.) does not clutter the terminal.\n * Opt in with `XOPC_LOG_LEVEL` or `--verbose` / `-v`.\n * This module must load before any import of `../utils/logger.js`.\n */\nconst env = process.env;\nif (\n !env.VITEST &&\n !env.TEST &&\n !env.XOPC_LOG_LEVEL &&\n !process.argv.includes('--verbose') &&\n !process.argv.includes('-v')\n) {\n env.XOPC_LOG_LEVEL = 'warn';\n}\n"],"mappings":";;;;;;;AAMA,MAAM,MAAM,QAAQ;AACpB,IACE,CAAC,IAAI,UACL,CAAC,IAAI,QACL,CAAC,IAAI,kBACL,CAAC,QAAQ,KAAK,SAAS,YAAY,IACnC,CAAC,QAAQ,KAAK,SAAS,KAAK,CAE5B,KAAI,iBAAiB"}

package/dist/src/cli/commands/logs.js CHANGED Viewed

@@ -1,7 +1,7 @@
 import { getLoggerConfig, init_config } from "../../utils/logger/config.js";
-import { init_rotation, rotateLogs } from "../../utils/logger/rotation.js";
+import { cleanOldLogs, init_rotation, rotateLogs } from "../../utils/logger/rotation.js";
 import { register } from "../registry.js";
-import { cleanOldLogs, getLogFiles, getLogStats, queryLogs } from "../../utils/logger/log-store.js";
+import { getFileLogStats, getLogFiles, queryLogs } from "../../utils/logger/log-store.js";
 import { Command } from "commander";
 //#region src/cli/commands/logs.ts
 /**
@@ -92,7 +92,7 @@ function createLogsCommand(_ctx) {
 	});
 	command.command("stats").description("Show log statistics").option("--json", "Output as JSON").action(async (options) => {
 		try {
-			const stats = await getLogStats();
+			const stats = await getFileLogStats();
 			const config = getLoggerConfig();
 			if (options.json) {
 				console.log(JSON.stringify({

package/dist/src/cli/commands/logs.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"logs.js","names":["fetchLogStats"],"sources":["../../../../src/cli/commands/logs.ts"],"sourcesContent":["/*\n Logs CLI Command\n * \n * Query and analyze logs: list, query, stats, tail, clean\n /\n\nimport { Command } from 'commander';\nimport { register, type CLIContext } from '../registry.js';\nimport {\n getLogFiles,\n queryLogs,\n getLogStats as fetchLogStats,\n cleanOldLogs,\n type LogQuery,\n type LogEntry,\n} from '../../utils/logger/log-store.js';\nimport { getLoggerConfig } from '../../utils/logger/config.js';\nimport { rotateLogs } from '../../utils/logger/rotation.js';\n\nfunction createLogsCommand(_ctx: CLIContext): Command {\n const command = new Command('logs');\n command.description('Manage and query logs');\n\n // List log files\n command\n .command('list')\n .description('List log files')\n .option('-t, --type <type>', 'Filter by type (app\|error\|audit\|access)')\n .option('-s, --sort <field>', 'Sort by (name\|size\|date)', 'date')\n .option('--json', 'Output as JSON')\n .action(async (options) => {\n try {\n let files = getLogFiles();\n \n // Filter by type\n if (options.type) {\n files = files.filter(f => f.type === options.type);\n }\n \n // Sort\n const sortField = options.sort \|\| 'date';\n files.sort((a, b) => {\n if (sortField === 'name') return a.name.localeCompare(b.name);\n if (sortField === 'size') return b.size - a.size;\n return new Date(b.modified).getTime() - new Date(a.modified).getTime();\n });\n \n if (options.json) {\n console.log(JSON.stringify({ files }, null, 2));\n return;\n }\n \n const config = getLoggerConfig();\n console.log(`\\n📁 Log directory: ${config.logDir}\\n`);\n \n if (files.length === 0) {\n console.log('No log files found.');\n return;\n }\n \n console.log(`Found ${files.length} log file(s):\\n`);\n \n const typeEmoji: Record<string, string> = {\n app: '📝',\n error: '❌',\n audit: '🔒',\n access: '🌐',\n };\n \n for (const file of files) {\n const emoji = typeEmoji[file.type] \|\| '📄';\n const sizeKB = (file.size / 1024).toFixed(1);\n const date = new Date(file.modified).toLocaleString();\n console.log(`${emoji} ${file.name}`);\n console.log(` Size: ${sizeKB} KB \| Modified: ${date}`);\n }\n } catch (err) {\n console.error('Failed to list logs:', err);\n process.exit(1);\n }\n });\n\n // Query logs\n command\n .command('query')\n .description('Query log entries')\n .option('-l, --level <level>', 'Filter by level (trace\|debug\|info\|warn\|error\|fatal)')\n .option('-m, --module <module>', 'Filter by module')\n .option('-e, --extension <ext>', 'Filter by extension')\n .option('-q, --search <text>', 'Text search')\n .option('--session-id <id>', 'Filter by session ID')\n .option('--request-id <id>', 'Filter by request ID')\n .option('--from <date>', 'Start date (ISO 8601)')\n .option('--to <date>', 'End date (ISO 8601)')\n .option('-n, --limit <number>', 'Number of results', '50')\n .option('--json', 'Output as JSON')\n .action(async (options) => {\n try {\n const query: LogQuery = {\n levels: options.level ? [options.level as 'trace' \| 'debug' \| 'info' \| 'warn' \| 'error' \| 'fatal'] : undefined,\n module: options.module,\n extension: options.extension,\n q: options.search,\n sessionId: options.sessionId,\n requestId: options.requestId,\n from: options.from,\n to: options.to,\n limit: parseInt(options.limit, 10),\n order: 'desc',\n };\n \n const entries = await queryLogs(query);\n \n if (options.json) {\n console.log(JSON.stringify({ entries }, null, 2));\n return;\n }\n \n if (entries.length === 0) {\n console.log('No matching log entries found.');\n return;\n }\n \n console.log(`\\nFound ${entries.length} log entry(ies):\\n`);\n \n for (const entry of entries) {\n const timestamp = new Date(entry.timestamp).toLocaleTimeString();\n const levelColor = getLevelColor(entry.level);\n const module = entry.module ? `[${entry.module}]` : '';\n const session = (entry as any).sessionId ? `{session:${(entry as any).sessionId.slice(0,8)}}` : '';\n \n console.log(`${timestamp} ${levelColor(entry.level)} ${module} ${session} ${entry.message}`);\n \n // Show context if present\n if (entry.requestId) {\n console.log(` ↳ requestId: ${entry.requestId}`);\n }\n if (entry.userId) {\n console.log(` ↳ userId: ${entry.userId}`);\n }\n }\n } catch (err) {\n console.error('Failed to query logs:', err);\n process.exit(1);\n }\n });\n\n // Show statistics\n command\n .command('stats')\n .description('Show log statistics')\n .option('--json', 'Output as JSON')\n .action(async (options) => {\n try {\n const stats = await fetchLogStats();\n const config = getLoggerConfig();\n \n if (options.json) {\n console.log(JSON.stringify({ config, stats }, null, 2));\n return;\n }\n \n console.log('\\n📊 Log Statistics\\n');\n console.log(`📁 Log directory: ${config.logDir}`);\n console.log(`📝 Retention: ${config.retentionDays} days`);\n console.log(`📏 Max file size: ${config.maxFileSizeMB} MB\\n`);\n \n console.log('By Level:');\n const byLevel = stats.byLevel as Record<string, number>;\n const total = Object.values(byLevel).reduce((a, b) => a + b, 0);\n for (const [level, count] of Object.entries(byLevel)) {\n const bar = '█'.repeat(Math.min(50, total > 0 ? Math.round((count / total) 50) : 0));\n const percent = total > 0 ? ((count / total) * 100).toFixed(1) : '0';\n console.log(` ${level.padEnd(5)}: ${count.toString().padStart(6)} (${percent}%) ${bar}`);\n }\n \n console.log(`\\n📈 Total entries: ${total}`);\n } catch (err) {\n console.error('Failed to get stats:', err);\n process.exit(1);\n }\n });\n\n // Tail logs\n command\n .command('tail')\n .description('Tail log entries in real-time')\n .option('-n, --lines <number>', 'Number of lines to show', '20')\n .option('-f, --follow', 'Follow new entries (Ctrl+C to exit)', false)\n .option('-t, --type <type>', 'Filter by type (app\|error\|audit\|access)', 'app')\n .action(async (options) => {\n try {\n const lines = parseInt(options.lines, 10);\n \n // Initial query\n const query: LogQuery = {\n limit: lines,\n order: 'desc',\n };\n \n const entries = await queryLogs(query);\n \n // Print in chronological order\n const reversed = [...entries].reverse();\n \n for (const entry of reversed) {\n printLogEntry(entry);\n }\n \n if (options.follow) {\n console.log('\\n⏳ Watching for new entries (Ctrl+C to exit)...');\n // Note: Full follow mode would require file watching\n // For now, just show initial results\n }\n } catch (err) {\n console.error('Failed to tail logs:', err);\n process.exit(1);\n }\n });\n\n // Clean old logs\n command\n .command('clean')\n .description('Clean old log files')\n .option('-d, --days <number>', 'Keep logs for N days', '7')\n .option('--dry-run', 'Show what would be deleted without actually deleting')\n .option('--json', 'Output as JSON')\n .action(async (options) => {\n try {\n const keepDays = parseInt(options.days, 10);\n \n if (options.dryRun) {\n console.log(`\\n🔍 Dry run: would delete logs older than ${keepDays} days\\n`);\n }\n \n const result = cleanOldLogs(keepDays);\n \n if (options.json) {\n console.log(JSON.stringify(result, null, 2));\n return;\n }\n \n if (result.deleted === 0) {\n console.log('✅ No old logs to clean.');\n return;\n }\n \n console.log(`\\n🧹 Cleaned ${result.deleted} log file(s)`);\n \n if (result.errors.length > 0) {\n console.log('\\n⚠️ Errors:');\n for (const err of result.errors) {\n console.log(` - ${err}`);\n }\n }\n } catch (err) {\n console.error('Failed to clean logs:', err);\n process.exit(1);\n }\n });\n\n // Rotate logs\n command\n .command('rotate')\n .description('Rotate large log files')\n .option('--dry-run', 'Show what would be rotated without rotating')\n .option('--json', 'Output as JSON')\n .action(async (options) => {\n try {\n if (options.dryRun) {\n console.log('\\n🔍 Dry run: would rotate large log files\\n');\n }\n \n const result = await rotateLogs();\n \n if (options.json) {\n console.log(JSON.stringify(result, null, 2));\n return;\n }\n \n if (result.rotated === 0) {\n console.log('✅ No logs need rotation.');\n return;\n }\n \n console.log(`\\n🔄 Rotated ${result.rotated} log file(s)`);\n console.log(` Compressed: ${result.compressed}`);\n \n if (result.errors.length > 0) {\n console.log('\\n⚠️ Errors:');\n for (const err of result.errors) {\n console.log(` - ${err}`);\n }\n }\n } catch (err) {\n console.error('Failed to rotate logs:', err);\n process.exit(1);\n }\n });\n\n return command;\n}\n\n// Helper functions\nfunction getLevelColor(level: string): (s: string) => string {\n const colors: Record<string, (s: string) => string> = {\n trace: (s) => `🔍 ${s}`,\n debug: (s) => `🔧 ${s}`,\n info: (s) => `ℹ️ ${s}`,\n warn: (s) => `⚠️ ${s}`,\n error: (s) => `❌ ${s}`,\n fatal: (s) => `🔥 ${s}`,\n };\n return colors[level] \|\| ((s) => s);\n}\n\nfunction printLogEntry(entry: LogEntry): void {\n const timestamp = new Date(entry.timestamp).toLocaleTimeString();\n const levelColor = getLevelColor(entry.level);\n const module = entry.module ? `[${entry.module}]` : '';\n \n console.log(`${timestamp} ${levelColor(entry.level)} ${module} ${entry.message}`);\n}\n\n// Register command\nregister({\n id: 'logs',\n name: 'logs',\n description: 'Manage and query logs',\n factory: createLogsCommand,\n metadata: { category: 'maintenance' },\n});\n"],"mappings":"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"}
1	+ {"version":3,"file":"logs.js","names":[],"sources":["../../../../src/cli/commands/logs.ts"],"sourcesContent":["/*\n Logs CLI Command\n * \n * Query and analyze logs: list, query, stats, tail, clean\n /\n\nimport { Command } from 'commander';\nimport { register, type CLIContext } from '../registry.js';\nimport {\n getLogFiles,\n queryLogs,\n getFileLogStats,\n type LogQuery,\n type LogEntry,\n} from '../../utils/logger/log-store.js';\nimport { getLoggerConfig } from '../../utils/logger/config.js';\nimport { rotateLogs, cleanOldLogs } from '../../utils/logger/rotation.js';\n\nfunction createLogsCommand(_ctx: CLIContext): Command {\n const command = new Command('logs');\n command.description('Manage and query logs');\n\n // List log files\n command\n .command('list')\n .description('List log files')\n .option('-t, --type <type>', 'Filter by type (app\|error\|audit\|access)')\n .option('-s, --sort <field>', 'Sort by (name\|size\|date)', 'date')\n .option('--json', 'Output as JSON')\n .action(async (options) => {\n try {\n let files = getLogFiles();\n \n // Filter by type\n if (options.type) {\n files = files.filter(f => f.type === options.type);\n }\n \n // Sort\n const sortField = options.sort \|\| 'date';\n files.sort((a, b) => {\n if (sortField === 'name') return a.name.localeCompare(b.name);\n if (sortField === 'size') return b.size - a.size;\n return new Date(b.modified).getTime() - new Date(a.modified).getTime();\n });\n \n if (options.json) {\n console.log(JSON.stringify({ files }, null, 2));\n return;\n }\n \n const config = getLoggerConfig();\n console.log(`\\n📁 Log directory: ${config.logDir}\\n`);\n \n if (files.length === 0) {\n console.log('No log files found.');\n return;\n }\n \n console.log(`Found ${files.length} log file(s):\\n`);\n \n const typeEmoji: Record<string, string> = {\n app: '📝',\n error: '❌',\n audit: '🔒',\n access: '🌐',\n };\n \n for (const file of files) {\n const emoji = typeEmoji[file.type] \|\| '📄';\n const sizeKB = (file.size / 1024).toFixed(1);\n const date = new Date(file.modified).toLocaleString();\n console.log(`${emoji} ${file.name}`);\n console.log(` Size: ${sizeKB} KB \| Modified: ${date}`);\n }\n } catch (err) {\n console.error('Failed to list logs:', err);\n process.exit(1);\n }\n });\n\n // Query logs\n command\n .command('query')\n .description('Query log entries')\n .option('-l, --level <level>', 'Filter by level (trace\|debug\|info\|warn\|error\|fatal)')\n .option('-m, --module <module>', 'Filter by module')\n .option('-e, --extension <ext>', 'Filter by extension')\n .option('-q, --search <text>', 'Text search')\n .option('--session-id <id>', 'Filter by session ID')\n .option('--request-id <id>', 'Filter by request ID')\n .option('--from <date>', 'Start date (ISO 8601)')\n .option('--to <date>', 'End date (ISO 8601)')\n .option('-n, --limit <number>', 'Number of results', '50')\n .option('--json', 'Output as JSON')\n .action(async (options) => {\n try {\n const query: LogQuery = {\n levels: options.level ? [options.level as 'trace' \| 'debug' \| 'info' \| 'warn' \| 'error' \| 'fatal'] : undefined,\n module: options.module,\n extension: options.extension,\n q: options.search,\n sessionId: options.sessionId,\n requestId: options.requestId,\n from: options.from,\n to: options.to,\n limit: parseInt(options.limit, 10),\n order: 'desc',\n };\n \n const entries = await queryLogs(query);\n \n if (options.json) {\n console.log(JSON.stringify({ entries }, null, 2));\n return;\n }\n \n if (entries.length === 0) {\n console.log('No matching log entries found.');\n return;\n }\n \n console.log(`\\nFound ${entries.length} log entry(ies):\\n`);\n \n for (const entry of entries) {\n const timestamp = new Date(entry.timestamp).toLocaleTimeString();\n const levelColor = getLevelColor(entry.level);\n const module = entry.module ? `[${entry.module}]` : '';\n const session = (entry as any).sessionId ? `{session:${(entry as any).sessionId.slice(0,8)}}` : '';\n \n console.log(`${timestamp} ${levelColor(entry.level)} ${module} ${session} ${entry.message}`);\n \n // Show context if present\n if (entry.requestId) {\n console.log(` ↳ requestId: ${entry.requestId}`);\n }\n if (entry.userId) {\n console.log(` ↳ userId: ${entry.userId}`);\n }\n }\n } catch (err) {\n console.error('Failed to query logs:', err);\n process.exit(1);\n }\n });\n\n // Show statistics\n command\n .command('stats')\n .description('Show log statistics')\n .option('--json', 'Output as JSON')\n .action(async (options) => {\n try {\n const stats = await getFileLogStats();\n const config = getLoggerConfig();\n \n if (options.json) {\n console.log(JSON.stringify({ config, stats }, null, 2));\n return;\n }\n \n console.log('\\n📊 Log Statistics\\n');\n console.log(`📁 Log directory: ${config.logDir}`);\n console.log(`📝 Retention: ${config.retentionDays} days`);\n console.log(`📏 Max file size: ${config.maxFileSizeMB} MB\\n`);\n \n console.log('By Level:');\n const byLevel = stats.byLevel as Record<string, number>;\n const total = Object.values(byLevel).reduce((a, b) => a + b, 0);\n for (const [level, count] of Object.entries(byLevel)) {\n const bar = '█'.repeat(Math.min(50, total > 0 ? Math.round((count / total) 50) : 0));\n const percent = total > 0 ? ((count / total) * 100).toFixed(1) : '0';\n console.log(` ${level.padEnd(5)}: ${count.toString().padStart(6)} (${percent}%) ${bar}`);\n }\n \n console.log(`\\n📈 Total entries: ${total}`);\n } catch (err) {\n console.error('Failed to get stats:', err);\n process.exit(1);\n }\n });\n\n // Tail logs\n command\n .command('tail')\n .description('Tail log entries in real-time')\n .option('-n, --lines <number>', 'Number of lines to show', '20')\n .option('-f, --follow', 'Follow new entries (Ctrl+C to exit)', false)\n .option('-t, --type <type>', 'Filter by type (app\|error\|audit\|access)', 'app')\n .action(async (options) => {\n try {\n const lines = parseInt(options.lines, 10);\n \n // Initial query\n const query: LogQuery = {\n limit: lines,\n order: 'desc',\n };\n \n const entries = await queryLogs(query);\n \n // Print in chronological order\n const reversed = [...entries].reverse();\n \n for (const entry of reversed) {\n printLogEntry(entry);\n }\n \n if (options.follow) {\n console.log('\\n⏳ Watching for new entries (Ctrl+C to exit)...');\n // Note: Full follow mode would require file watching\n // For now, just show initial results\n }\n } catch (err) {\n console.error('Failed to tail logs:', err);\n process.exit(1);\n }\n });\n\n // Clean old logs\n command\n .command('clean')\n .description('Clean old log files')\n .option('-d, --days <number>', 'Keep logs for N days', '7')\n .option('--dry-run', 'Show what would be deleted without actually deleting')\n .option('--json', 'Output as JSON')\n .action(async (options) => {\n try {\n const keepDays = parseInt(options.days, 10);\n \n if (options.dryRun) {\n console.log(`\\n🔍 Dry run: would delete logs older than ${keepDays} days\\n`);\n }\n \n const result = cleanOldLogs(keepDays);\n \n if (options.json) {\n console.log(JSON.stringify(result, null, 2));\n return;\n }\n \n if (result.deleted === 0) {\n console.log('✅ No old logs to clean.');\n return;\n }\n \n console.log(`\\n🧹 Cleaned ${result.deleted} log file(s)`);\n \n if (result.errors.length > 0) {\n console.log('\\n⚠️ Errors:');\n for (const err of result.errors) {\n console.log(` - ${err}`);\n }\n }\n } catch (err) {\n console.error('Failed to clean logs:', err);\n process.exit(1);\n }\n });\n\n // Rotate logs\n command\n .command('rotate')\n .description('Rotate large log files')\n .option('--dry-run', 'Show what would be rotated without rotating')\n .option('--json', 'Output as JSON')\n .action(async (options) => {\n try {\n if (options.dryRun) {\n console.log('\\n🔍 Dry run: would rotate large log files\\n');\n }\n \n const result = await rotateLogs();\n \n if (options.json) {\n console.log(JSON.stringify(result, null, 2));\n return;\n }\n \n if (result.rotated === 0) {\n console.log('✅ No logs need rotation.');\n return;\n }\n \n console.log(`\\n🔄 Rotated ${result.rotated} log file(s)`);\n console.log(` Compressed: ${result.compressed}`);\n \n if (result.errors.length > 0) {\n console.log('\\n⚠️ Errors:');\n for (const err of result.errors) {\n console.log(` - ${err}`);\n }\n }\n } catch (err) {\n console.error('Failed to rotate logs:', err);\n process.exit(1);\n }\n });\n\n return command;\n}\n\n// Helper functions\nfunction getLevelColor(level: string): (s: string) => string {\n const colors: Record<string, (s: string) => string> = {\n trace: (s) => `🔍 ${s}`,\n debug: (s) => `🔧 ${s}`,\n info: (s) => `ℹ️ ${s}`,\n warn: (s) => `⚠️ ${s}`,\n error: (s) => `❌ ${s}`,\n fatal: (s) => `🔥 ${s}`,\n };\n return colors[level] \|\| ((s) => s);\n}\n\nfunction printLogEntry(entry: LogEntry): void {\n const timestamp = new Date(entry.timestamp).toLocaleTimeString();\n const levelColor = getLevelColor(entry.level);\n const module = entry.module ? `[${entry.module}]` : '';\n \n console.log(`${timestamp} ${levelColor(entry.level)} ${module} ${entry.message}`);\n}\n\n// Register command\nregister({\n id: 'logs',\n name: 'logs',\n description: 'Manage and query logs',\n factory: createLogsCommand,\n metadata: { category: 'maintenance' },\n});\n"],"mappings":"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"}

package/dist/src/cron/executor.js CHANGED Viewed

@@ -120,8 +120,9 @@ var DefaultJobExecutor = class {
 			else log.error({
 				jobId: job.id,
 				executionId,
-				error: result.error
-			}, "Job failed");
+				errorMessage: result.error,
+				phase: "cron.execute"
+			}, `Job failed: ${result.error ?? "unknown"}`);
 			if (result.status === "ok" && this.heartbeatService) try {
 				this.heartbeatService.requestNow({ reason: `cron:${job.id}` });
 			} catch (e) {
@@ -136,10 +137,12 @@ var DefaultJobExecutor = class {
 			execution.duration = Date.now() - new Date(execution.startedAt).getTime();
 			execution.error = error instanceof Error ? error.message : String(error);
 			log.error({
+				err: error,
+				errorMessage: execution.error,
 				jobId: job.id,
 				executionId,
-				error: execution.error
-			}, "Job execution error");
+				phase: "cron.execute"
+			}, `Job execution error: ${execution.error}`);
 			result = {
 				status: "error",
 				error: execution.error