@xopcai/xopc 0.0.103 → 0.0.104

package/dist/src/gateway/chat-stream/mapper.js

@@ -0,0 +1,244 @@
+//#region src/gateway/chat-stream/mapper.ts
+var ChatStreamMapper = class {
+	assistantIndex = 0;
+	currentAssistantMessageId;
+	currentAssistantText = "";
+	toolCallToMessageId = /* @__PURE__ */ new Map();
+	started = false;
+	ended = false;
+	constructor(opts) {
+		this.opts = opts;
+	}
+	map(input) {
+		const event = input;
+		switch (event.type) {
+			case "agent_start": return this.start();
+			case "agent_end": return this.end("success");
+			case "message_start": return this.mapMessageStart(event.message);
+			case "message_update": return this.mapMessageUpdate(event);
+			case "message_end": return this.mapMessageEnd(event.message);
+			case "tool_execution_start": return this.mapToolStart(event);
+			case "tool_execution_update": return this.mapToolUpdate(event);
+			case "tool_execution_end": return this.mapToolEnd(event);
+			case "user_message": return [this.make("user_message", { message: userMessageFromLegacyEvent(event) })];
+			case "user_transcript": return [this.make("user_transcript", {
+				text: String(event.text ?? ""),
+				media: event.media
+			})];
+			case "progress": return [this.make("progress", {
+				stage: String(event.stage ?? ""),
+				message: String(event.message ?? "")
+			})];
+			case "compaction": return [this.make("compaction", {
+				status: event.status === "completed" || event.status === "skipped" ? event.status : "started",
+				tokensBefore: typeof event.tokensBefore === "number" ? event.tokensBefore : void 0,
+				tokensAfter: typeof event.tokensAfter === "number" ? event.tokensAfter : void 0,
+				summary: typeof event.summary === "string" ? event.summary : void 0
+			})];
+			case "tts_audio": return [this.make("tts_audio", {
+				uri: String(event.uri ?? ""),
+				mimeType: String(event.mimeType ?? "audio/mpeg"),
+				name: String(event.name ?? "voice.mp3")
+			})];
+			case "clarify_request": return [this.make("clarify_request", {
+				requestId: String(event.requestId ?? ""),
+				question: String(event.question ?? ""),
+				choices: Array.isArray(event.choices) ? event.choices.filter((x) => typeof x === "string") : void 0,
+				default: typeof event.default === "string" ? event.default : void 0
+			})];
+			case "error": return [this.make("error", {
+				code: "AGENT_RUN_ERROR",
+				message: String(event.content ?? event.message ?? "Unknown error")
+			})];
+			default: return [];
+		}
+	}
+	start() {
+		if (this.started) return [];
+		this.started = true;
+		return [this.make("run_start", { channel: this.opts.channel })];
+	}
+	end(status, summary) {
+		if (this.ended) return [];
+		this.ended = true;
+		return [this.make("run_end", {
+			status,
+			summary
+		})];
+	}
+	error(message, code = "AGENT_RUN_ERROR") {
+		return [this.make("error", {
+			code,
+			message
+		})];
+	}
+	mapMessageStart(raw) {
+		if (raw?.role !== "assistant") return [];
+		const messageId = this.nextAssistantMessageId();
+		this.currentAssistantMessageId = messageId;
+		this.currentAssistantText = "";
+		return [this.make("assistant_message_start", { messageId })];
+	}
+	mapMessageUpdate(event) {
+		const message = event.message;
+		if (message?.role !== "assistant") return [];
+		const messageId = this.ensureAssistantMessageId();
+		const delta = event.assistantMessageEvent;
+		if (delta?.type === "text_delta" && typeof delta.delta === "string" && delta.delta) {
+			this.currentAssistantText += delta.delta;
+			return [this.make("assistant_delta", {
+				messageId,
+				delta: delta.delta
+			})];
+		}
+		if (delta?.type === "thinking_delta" && typeof delta.delta === "string" && delta.delta) return [this.make("thinking_delta", {
+			messageId,
+			delta: delta.delta
+		})];
+		const text = extractTextFromMessage(message);
+		const suffix = appendSuffix(this.currentAssistantText, text);
+		this.currentAssistantText = text || this.currentAssistantText;
+		return suffix ? [this.make("assistant_delta", {
+			messageId,
+			delta: suffix
+		})] : [];
+	}
+	mapMessageEnd(raw) {
+		const message = raw;
+		if (message?.role !== "assistant") return [];
+		const messageId = this.ensureAssistantMessageId();
+		const events = [];
+		const text = extractTextFromMessage(message);
+		const suffix = appendSuffix(this.currentAssistantText, text);
+		if (suffix) events.push(this.make("assistant_delta", {
+			messageId,
+			delta: suffix
+		}));
+		this.currentAssistantText = text || this.currentAssistantText;
+		events.push(this.make("thinking_end", { messageId }));
+		events.push(this.make("assistant_message_end", {
+			messageId,
+			usage: extractUsage(message)
+		}));
+		this.currentAssistantMessageId = void 0;
+		this.currentAssistantText = "";
+		return events;
+	}
+	mapToolStart(event) {
+		const toolCallId = String(event.toolCallId ?? "");
+		if (!toolCallId) return [];
+		const messageId = this.ensureAssistantMessageId();
+		this.toolCallToMessageId.set(toolCallId, messageId);
+		return [this.make("tool_start", {
+			messageId,
+			toolCallId,
+			toolName: String(event.toolName ?? "unknown"),
+			args: event.args
+		})];
+	}
+	mapToolUpdate(event) {
+		const toolCallId = String(event.toolCallId ?? "");
+		if (!toolCallId) return [];
+		const messageId = this.toolCallToMessageId.get(toolCallId) ?? this.ensureAssistantMessageId();
+		const partial = event.partialResult;
+		const details = extractDetails(partial);
+		const textDelta = extractText(partial);
+		return [this.make("tool_update", {
+			messageId,
+			toolCallId,
+			toolName: String(event.toolName ?? "unknown"),
+			details,
+			textDelta
+		})];
+	}
+	mapToolEnd(event) {
+		const toolCallId = String(event.toolCallId ?? "");
+		if (!toolCallId) return [];
+		const messageId = this.toolCallToMessageId.get(toolCallId) ?? this.ensureAssistantMessageId();
+		const result = normalizeToolResult(event.result);
+		return [this.make("tool_end", {
+			messageId,
+			toolCallId,
+			toolName: String(event.toolName ?? "unknown"),
+			status: event.isError ? "error" : "success",
+			result,
+			errorMessage: event.isError ? result?.text : void 0
+		})];
+	}
+	ensureAssistantMessageId() {
+		if (!this.currentAssistantMessageId) this.currentAssistantMessageId = this.nextAssistantMessageId();
+		return this.currentAssistantMessageId;
+	}
+	nextAssistantMessageId() {
+		this.assistantIndex += 1;
+		return `msg_${this.opts.runId.replace(/[^a-zA-Z0-9_-]/g, "_")}_${this.assistantIndex}`;
+	}
+	make(type, payload) {
+		return {
+			type,
+			runId: this.opts.runId,
+			sessionKey: this.opts.sessionKey,
+			timestamp: Date.now(),
+			payload
+		};
+	}
+};
+function userMessageFromLegacyEvent(event) {
+	return {
+		role: "user",
+		content: event.content ?? [],
+		attachments: event.media,
+		timestamp: typeof event.timestamp === "number" ? event.timestamp : Date.now()
+	};
+}
+function extractTextFromMessage(message) {
+	return extractText(message.content);
+}
+function extractText(value) {
+	if (typeof value === "string") return value;
+	if (!Array.isArray(value)) return void 0;
+	return value.map((block) => {
+		if (!block || typeof block !== "object") return "";
+		const rec = block;
+		return rec.type === "text" && typeof rec.text === "string" ? rec.text : "";
+	}).join("") || void 0;
+}
+function appendSuffix(base, next) {
+	if (!next) return "";
+	if (!base) return next;
+	if (next === base || base.endsWith(next)) return "";
+	if (next.startsWith(base)) return next.slice(base.length);
+	const max = Math.min(base.length, next.length, 512);
+	for (let overlap = max; overlap > 0; overlap--) if (base.slice(-overlap) === next.slice(0, overlap)) return next.slice(overlap);
+	return next;
+}
+function extractUsage(message) {
+	const usage = message.usage;
+	if (!usage || typeof usage !== "object") return void 0;
+	const rec = usage;
+	return {
+		inputTokens: typeof rec.inputTokens === "number" ? rec.inputTokens : void 0,
+		outputTokens: typeof rec.outputTokens === "number" ? rec.outputTokens : void 0,
+		totalTokens: typeof rec.totalTokens === "number" ? rec.totalTokens : void 0,
+		cost: typeof rec.cost === "number" ? rec.cost : void 0
+	};
+}
+function extractDetails(value) {
+	if (!value || typeof value !== "object") return void 0;
+	return value.details;
+}
+function normalizeToolResult(value) {
+	if (value == null) return void 0;
+	if (typeof value === "string") return { text: value };
+	if (typeof value !== "object") return { text: String(value) };
+	const rec = value;
+	return {
+		content: Array.isArray(rec.content) ? rec.content : void 0,
+		details: rec.details,
+		text: extractText(rec.content) ?? (typeof rec.text === "string" ? rec.text : void 0)
+	};
+}
+//#endregion
+export { ChatStreamMapper };
+
+//# sourceMappingURL=mapper.js.map

package/dist/src/gateway/chat-stream/mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.js","names":["message"],"sources":["../../../../src/gateway/chat-stream/mapper.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { EmbeddedStreamEvent } from '../../agent/embedded/types.js';\nimport type { ChatStreamEvent, ChatStreamStatus } from './protocol.js';\n\nexport type RuntimeStreamEvent = EmbeddedStreamEvent | { type: string; [key: string]: unknown };\n\nexport interface ChatStreamMapperOptions {\n  runId: string;\n  sessionKey: string;\n  channel: string;\n}\n\ntype ToolResultEnvelope = { content?: unknown[]; details?: unknown; text?: string };\n\nexport class ChatStreamMapper {\n  private assistantIndex = 0;\n  private currentAssistantMessageId: string | undefined;\n  private currentAssistantText = '';\n  private toolCallToMessageId = new Map<string, string>();\n  private started = false;\n  private ended = false;\n\n  constructor(private readonly opts: ChatStreamMapperOptions) {}\n\n  map(input: RuntimeStreamEvent): ChatStreamEvent[] {\n    const event = input as { type: string; [key: string]: unknown };\n    switch (event.type) {\n      case 'agent_start':\n        return this.start();\n      case 'agent_end':\n        return this.end('success');\n      case 'message_start':\n        return this.mapMessageStart(event.message);\n      case 'message_update':\n        return this.mapMessageUpdate(event);\n      case 'message_end':\n        return this.mapMessageEnd(event.message);\n      case 'tool_execution_start':\n        return this.mapToolStart(event);\n      case 'tool_execution_update':\n        return this.mapToolUpdate(event);\n      case 'tool_execution_end':\n        return this.mapToolEnd(event);\n      case 'user_message':\n        return [this.make('user_message', { message: userMessageFromLegacyEvent(event) })];\n      case 'user_transcript':\n        return [this.make('user_transcript', { text: String(event.text ?? ''), media: event.media })];\n      case 'progress':\n        return [this.make('progress', { stage: String(event.stage ?? ''), message: String(event.message ?? '') })];\n      case 'compaction':\n        return [\n          this.make('compaction', {\n            status: event.status === 'completed' || event.status === 'skipped' ? event.status : 'started',\n            tokensBefore: typeof event.tokensBefore === 'number' ? event.tokensBefore : undefined,\n            tokensAfter: typeof event.tokensAfter === 'number' ? event.tokensAfter : undefined,\n            summary: typeof event.summary === 'string' ? event.summary : undefined,\n          }),\n        ];\n      case 'tts_audio':\n        return [\n          this.make('tts_audio', {\n            uri: String(event.uri ?? ''),\n            mimeType: String(event.mimeType ?? 'audio/mpeg'),\n            name: String(event.name ?? 'voice.mp3'),\n          }),\n        ];\n      case 'clarify_request':\n        return [\n          this.make('clarify_request', {\n            requestId: String(event.requestId ?? ''),\n            question: String(event.question ?? ''),\n            choices: Array.isArray(event.choices) ? event.choices.filter((x): x is string => typeof x === 'string') : undefined,\n            default: typeof event.default === 'string' ? event.default : undefined,\n          }),\n        ];\n      case 'error':\n        return [this.make('error', { code: 'AGENT_RUN_ERROR', message: String(event.content ?? event.message ?? 'Unknown error') })];\n      default:\n        return [];\n    }\n  }\n\n  start(): ChatStreamEvent[] {\n    if (this.started) return [];\n    this.started = true;\n    return [this.make('run_start', { channel: this.opts.channel })];\n  }\n\n  end(status: ChatStreamStatus, summary?: string): ChatStreamEvent[] {\n    if (this.ended) return [];\n    this.ended = true;\n    return [this.make('run_end', { status, summary })];\n  }\n\n  error(message: string, code = 'AGENT_RUN_ERROR'): ChatStreamEvent[] {\n    return [this.make('error', { code, message })];\n  }\n\n  private mapMessageStart(raw: unknown): ChatStreamEvent[] {\n    const message = raw as AgentMessage | undefined;\n    if (message?.role !== 'assistant') return [];\n    const messageId = this.nextAssistantMessageId();\n    this.currentAssistantMessageId = messageId;\n    this.currentAssistantText = '';\n    return [this.make('assistant_message_start', { messageId })];\n  }\n\n  private mapMessageUpdate(event: { [key: string]: unknown }): ChatStreamEvent[] {\n    const message = event.message as AgentMessage | undefined;\n    if (message?.role !== 'assistant') return [];\n    const messageId = this.ensureAssistantMessageId();\n    const delta = event.assistantMessageEvent as { type?: unknown; delta?: unknown } | undefined;\n    if (delta?.type === 'text_delta' && typeof delta.delta === 'string' && delta.delta) {\n      this.currentAssistantText += delta.delta;\n      return [this.make('assistant_delta', { messageId, delta: delta.delta })];\n    }\n    if (delta?.type === 'thinking_delta' && typeof delta.delta === 'string' && delta.delta) {\n      return [this.make('thinking_delta', { messageId, delta: delta.delta })];\n    }\n\n    const text = extractTextFromMessage(message);\n    const suffix = appendSuffix(this.currentAssistantText, text);\n    this.currentAssistantText = text || this.currentAssistantText;\n    return suffix ? [this.make('assistant_delta', { messageId, delta: suffix })] : [];\n  }\n\n  private mapMessageEnd(raw: unknown): ChatStreamEvent[] {\n    const message = raw as AgentMessage | undefined;\n    if (message?.role !== 'assistant') return [];\n    const messageId = this.ensureAssistantMessageId();\n    const events: ChatStreamEvent[] = [];\n    const text = extractTextFromMessage(message);\n    const suffix = appendSuffix(this.currentAssistantText, text);\n    if (suffix) events.push(this.make('assistant_delta', { messageId, delta: suffix }));\n    this.currentAssistantText = text || this.currentAssistantText;\n    events.push(this.make('thinking_end', { messageId }));\n    events.push(this.make('assistant_message_end', { messageId, usage: extractUsage(message) }));\n    this.currentAssistantMessageId = undefined;\n    this.currentAssistantText = '';\n    return events;\n  }\n\n  private mapToolStart(event: { [key: string]: unknown }): ChatStreamEvent[] {\n    const toolCallId = String(event.toolCallId ?? '');\n    if (!toolCallId) return [];\n    const messageId = this.ensureAssistantMessageId();\n    this.toolCallToMessageId.set(toolCallId, messageId);\n    return [\n      this.make('tool_start', {\n        messageId,\n        toolCallId,\n        toolName: String(event.toolName ?? 'unknown'),\n        args: event.args,\n      }),\n    ];\n  }\n\n  private mapToolUpdate(event: { [key: string]: unknown }): ChatStreamEvent[] {\n    const toolCallId = String(event.toolCallId ?? '');\n    if (!toolCallId) return [];\n    const messageId = this.toolCallToMessageId.get(toolCallId) ?? this.ensureAssistantMessageId();\n    const partial = event.partialResult;\n    const details = extractDetails(partial);\n    const textDelta = extractText(partial);\n    return [\n      this.make('tool_update', {\n        messageId,\n        toolCallId,\n        toolName: String(event.toolName ?? 'unknown'),\n        details,\n        textDelta,\n      }),\n    ];\n  }\n\n  private mapToolEnd(event: { [key: string]: unknown }): ChatStreamEvent[] {\n    const toolCallId = String(event.toolCallId ?? '');\n    if (!toolCallId) return [];\n    const messageId = this.toolCallToMessageId.get(toolCallId) ?? this.ensureAssistantMessageId();\n    const result = normalizeToolResult(event.result);\n    return [\n      this.make('tool_end', {\n        messageId,\n        toolCallId,\n        toolName: String(event.toolName ?? 'unknown'),\n        status: event.isError ? 'error' : 'success',\n        result,\n        errorMessage: event.isError ? result?.text : undefined,\n      }),\n    ];\n  }\n\n  private ensureAssistantMessageId(): string {\n    if (!this.currentAssistantMessageId) {\n      this.currentAssistantMessageId = this.nextAssistantMessageId();\n    }\n    return this.currentAssistantMessageId;\n  }\n\n  private nextAssistantMessageId(): string {\n    this.assistantIndex += 1;\n    return `msg_${this.opts.runId.replace(/[^a-zA-Z0-9_-]/g, '_')}_${this.assistantIndex}`;\n  }\n\n  private make<T extends ChatStreamEvent['type']>(\n    type: T,\n    payload: Extract<ChatStreamEvent, { type: T }>['payload'],\n  ): Extract<ChatStreamEvent, { type: T }> {\n    return {\n      type,\n      runId: this.opts.runId,\n      sessionKey: this.opts.sessionKey,\n      timestamp: Date.now(),\n      payload,\n    } as Extract<ChatStreamEvent, { type: T }>;\n  }\n}\n\nfunction userMessageFromLegacyEvent(event: { [key: string]: unknown }): unknown {\n  return {\n    role: 'user',\n    content: event.content ?? [],\n    attachments: event.media,\n    timestamp: typeof event.timestamp === 'number' ? event.timestamp : Date.now(),\n  };\n}\n\nfunction extractTextFromMessage(message: AgentMessage): string {\n  return extractText((message as { content?: unknown }).content);\n}\n\nfunction extractText(value: unknown): string | undefined {\n  if (typeof value === 'string') return value;\n  if (!Array.isArray(value)) return undefined;\n  const text = value\n    .map((block) => {\n      if (!block || typeof block !== 'object') return '';\n      const rec = block as { type?: unknown; text?: unknown };\n      return rec.type === 'text' && typeof rec.text === 'string' ? rec.text : '';\n    })\n    .join('');\n  return text || undefined;\n}\n\nfunction appendSuffix(base: string, next: string | undefined): string {\n  if (!next) return '';\n  if (!base) return next;\n  if (next === base || base.endsWith(next)) return '';\n  if (next.startsWith(base)) return next.slice(base.length);\n  const max = Math.min(base.length, next.length, 512);\n  for (let overlap = max; overlap > 0; overlap--) {\n    if (base.slice(-overlap) === next.slice(0, overlap)) return next.slice(overlap);\n  }\n  return next;\n}\n\nfunction extractUsage(message: AgentMessage): AssistantMessageEndEventPayload['usage'] {\n  const usage = (message as { usage?: unknown }).usage;\n  if (!usage || typeof usage !== 'object') return undefined;\n  const rec = usage as Record<string, unknown>;\n  return {\n    inputTokens: typeof rec.inputTokens === 'number' ? rec.inputTokens : undefined,\n    outputTokens: typeof rec.outputTokens === 'number' ? rec.outputTokens : undefined,\n    totalTokens: typeof rec.totalTokens === 'number' ? rec.totalTokens : undefined,\n    cost: typeof rec.cost === 'number' ? rec.cost : undefined,\n  };\n}\n\ntype AssistantMessageEndEventPayload = Extract<ChatStreamEvent, { type: 'assistant_message_end' }>['payload'];\n\nfunction extractDetails(value: unknown): unknown {\n  if (!value || typeof value !== 'object') return undefined;\n  return (value as Record<string, unknown>).details;\n}\n\nfunction normalizeToolResult(value: unknown): ToolResultEnvelope | undefined {\n  if (value == null) return undefined;\n  if (typeof value === 'string') return { text: value };\n  if (typeof value !== 'object') return { text: String(value) };\n  const rec = value as Record<string, unknown>;\n  return {\n    content: Array.isArray(rec.content) ? rec.content : undefined,\n    details: rec.details,\n    text: extractText(rec.content) ?? (typeof rec.text === 'string' ? rec.text : undefined),\n  };\n}\n"],"mappings":"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"}

package/dist/src/gateway/chat-stream/protocol.d.ts

@@ -0,0 +1,100 @@
+export type ChatStreamStatus = 'success' | 'error' | 'cancelled';
+export interface ChatStreamEnvelope<TType extends string, TPayload> {
+    type: TType;
+    seq?: number;
+    runId: string;
+    sessionKey: string;
+    timestamp: number;
+    payload: TPayload;
+}
+export type RunStartEvent = ChatStreamEnvelope<'run_start', {
+    channel: string;
+}>;
+export type UserMessageEvent = ChatStreamEnvelope<'user_message', {
+    message: unknown;
+}>;
+export type UserTranscriptEvent = ChatStreamEnvelope<'user_transcript', {
+    text: string;
+    media?: unknown;
+}>;
+export type AssistantMessageStartEvent = ChatStreamEnvelope<'assistant_message_start', {
+    messageId: string;
+}>;
+export type AssistantDeltaEvent = ChatStreamEnvelope<'assistant_delta', {
+    messageId: string;
+    delta: string;
+}>;
+export type ThinkingDeltaEvent = ChatStreamEnvelope<'thinking_delta', {
+    messageId: string;
+    delta: string;
+}>;
+export type ThinkingEndEvent = ChatStreamEnvelope<'thinking_end', {
+    messageId: string;
+}>;
+export type ToolStartEvent = ChatStreamEnvelope<'tool_start', {
+    messageId: string;
+    toolCallId: string;
+    toolName: string;
+    args?: unknown;
+}>;
+export type ToolUpdateEvent = ChatStreamEnvelope<'tool_update', {
+    messageId: string;
+    toolCallId: string;
+    toolName: string;
+    details?: unknown;
+    textDelta?: string;
+}>;
+export type ToolEndEvent = ChatStreamEnvelope<'tool_end', {
+    messageId: string;
+    toolCallId: string;
+    toolName: string;
+    status: ChatStreamStatus;
+    result?: {
+        content?: unknown[];
+        details?: unknown;
+        text?: string;
+    };
+    errorMessage?: string;
+}>;
+export type AssistantMessageEndEvent = ChatStreamEnvelope<'assistant_message_end', {
+    messageId: string;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+        cost?: number;
+    };
+}>;
+export type ProgressEvent = ChatStreamEnvelope<'progress', {
+    stage: string;
+    message: string;
+    detail?: string;
+    toolName?: string;
+}>;
+export type CompactionEvent = ChatStreamEnvelope<'compaction', {
+    status: 'started' | 'completed' | 'skipped';
+    tokensBefore?: number;
+    tokensAfter?: number;
+    summary?: string;
+}>;
+export type TtsAudioEvent = ChatStreamEnvelope<'tts_audio', {
+    uri: string;
+    mimeType: string;
+    name: string;
+}>;
+export type ClarifyRequestEvent = ChatStreamEnvelope<'clarify_request', {
+    requestId: string;
+    question: string;
+    choices?: string[];
+    default?: string;
+}>;
+export type RunEndEvent = ChatStreamEnvelope<'run_end', {
+    status: ChatStreamStatus;
+    summary?: string;
+}>;
+export type StreamErrorEvent = ChatStreamEnvelope<'error', {
+    code: string;
+    message: string;
+    recoverable?: boolean;
+}>;
+export type ChatStreamEvent = RunStartEvent | UserMessageEvent | UserTranscriptEvent | AssistantMessageStartEvent | AssistantDeltaEvent | ThinkingDeltaEvent | ThinkingEndEvent | ToolStartEvent | ToolUpdateEvent | ToolEndEvent | AssistantMessageEndEvent | ProgressEvent | CompactionEvent | TtsAudioEvent | ClarifyRequestEvent | RunEndEvent | StreamErrorEvent;

package/dist/src/gateway/chat-stream/protocol.js

@@ -0,0 +1 @@
+export {};

package/dist/src/gateway/heartbeat/service.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { shouldSilence, stripHeartbeatToken } from "../../heartbeat/tokens.js";
+import { appendCronEventLines } from "../../heartbeat/event-prompt.js";
 import { isWithinActiveHours } from "../../heartbeat/active-hours.js";
 import { isHeartbeatContentEmpty } from "../../heartbeat/content-check.js";
-import { appendCronEventLines } from "../../heartbeat/event-prompt.js";
 import { createHeartbeatWake } from "../../heartbeat/wake.js";
 import { resolveHeartbeatMdPath } from "../workspace-heartbeat-path.js";
 import { readFile } from "fs/promises";

package/dist/src/gateway/hono/lib/agent-model.d.ts

@@ -1,10 +1,10 @@
 import type { AgentTypedModel } from '../../../config/schema.js';
 /**
- * Coerce PATCH body `models[]` into validated typed model entries.
- * Returns `null` to clear, `undefined` when input should be skipped, or cleaned array.
- * Empty array after filtering → `null` (same as clear).
+ * Coerce PATCH body `{ roles: Record<id, role> }` into validated typed model roles.
+ * Returns `null` to clear, `undefined` when input should be skipped, or cleaned roles.
+ * Empty roles after filtering → `null` (same as clear).
  */
-export declare function normalizePatchTypedModels(v: unknown): AgentTypedModel[] | null | undefined;
+export declare function normalizePatchTypedModels(v: unknown): Record<string, Omit<AgentTypedModel, 'id'>> | null | undefined;
 /** Read `primary` from an `AgentModelConfig` object. */
 export declare function agentModelRefToString(ref: unknown): string | undefined;
 export declare function agentModelFallbacksToArray(ref: unknown): string[];

package/dist/src/gateway/hono/lib/agent-model.js

@@ -6,16 +6,22 @@ function isValidProviderModelRef(ref) {
 	return idx > 0 && idx < trimmed.length - 1;
 }
 /**
-* Coerce PATCH body `models[]` into validated typed model entries.
-* Returns `null` to clear, `undefined` when input should be skipped, or cleaned array.
-* Empty array after filtering → `null` (same as clear).
+* Coerce PATCH body `{ roles: Record<id, role> }` into validated typed model roles.
+* Returns `null` to clear, `undefined` when input should be skipped, or cleaned roles.
+* Empty roles after filtering → `null` (same as clear).
 */
 function normalizePatchTypedModels(v) {
 	if (v === void 0) return void 0;
 	if (v === null) return null;
-	if (!Array.isArray(v)) return void 0;
+	if (!v || typeof v !== "object" || Array.isArray(v) || !("roles" in v)) return void 0;
+	const rawRoles = v.roles;
+	if (!rawRoles || typeof rawRoles !== "object" || Array.isArray(rawRoles)) return void 0;
+	const rows = Object.entries(rawRoles).map(([id, role]) => ({
+		id,
+		...role
+	}));
 	const byId = /* @__PURE__ */ new Map();
-	for (const raw of v) {
+	for (const raw of rows) {
 		if (!raw || typeof raw !== "object" || Array.isArray(raw)) continue;
 		const o = raw;
 		const id = typeof o.id === "string" ? o.id.trim() : "";
@@ -23,16 +29,12 @@ function normalizePatchTypedModels(v) {
 		if (!id || !TYPED_MODEL_ID_RE.test(id) || !model || !isValidProviderModelRef(model)) continue;
 		const description = typeof o.description === "string" && o.description.trim() ? o.description.trim().slice(0, 500) : void 0;
 		byId.set(id, description ? {
-			id,
 			description,
 			model
-		} : {
-			id,
-			model
-		});
+		} : { model });
 	}
 	if (byId.size === 0) return null;
-	return [...byId.values()];
+	return Object.fromEntries(byId.entries());
 }
 /** Read `primary` from an `AgentModelConfig` object. */
 function agentModelRefToString(ref) {

package/dist/src/gateway/hono/lib/agent-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-model.js","names":[],"sources":["../../../../../src/gateway/hono/lib/agent-model.ts"],"sourcesContent":["import type { AgentTypedModel } from '../../../config/schema.js';\n\nconst TYPED_MODEL_ID_RE = /^[a-z][a-z0-9_-]{0,63}$/;\n\nfunction isValidProviderModelRef(ref: string): boolean {\n  const trimmed = ref.trim();\n  const idx = trimmed.indexOf('/');\n  return idx > 0 && idx < trimmed.length - 1;\n}\n\n/**\n * Coerce PATCH body `models[]` into validated typed model entries.\n * Returns `null` to clear, `undefined` when input should be skipped, or cleaned array.\n * Empty array after filtering → `null` (same as clear).\n */\nexport function normalizePatchTypedModels(v: unknown): AgentTypedModel[] | null | undefined {\n  if (v === undefined) return undefined;\n  if (v === null) return null;\n  if (!Array.isArray(v)) return undefined;\n\n  const byId = new Map<string, AgentTypedModel>();\n  for (const raw of v) {\n    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) continue;\n    const o = raw as Record<string, unknown>;\n    const id = typeof o.id === 'string' ? o.id.trim() : '';\n    const model = typeof o.model === 'string' ? o.model.trim() : '';\n    if (!id || !TYPED_MODEL_ID_RE.test(id) || !model || !isValidProviderModelRef(model)) continue;\n    const description =\n      typeof o.description === 'string' && o.description.trim()\n        ? o.description.trim().slice(0, 500)\n        : undefined;\n    byId.set(id, description ? { id, description, model } : { id, model });\n  }\n\n  if (byId.size === 0) return null;\n  return [...byId.values()];\n}\n\n/** Read `primary` from an `AgentModelConfig` object. */\nexport function agentModelRefToString(ref: unknown): string | undefined {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return undefined;\n  const p = (ref as { primary?: string }).primary;\n  return typeof p === 'string' && p.trim() ? p : undefined;\n}\n\nexport function agentModelFallbacksToArray(ref: unknown): string[] {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return [];\n  const f = (ref as { fallbacks?: unknown }).fallbacks;\n  if (!Array.isArray(f)) return [];\n  return f.filter((x): x is string => typeof x === 'string' && x.trim().length > 0);\n}\n\n/**\n * Coerce a PATCH body `model` value into the canonical `{ primary, fallbacks? }`\n * object form. Returns `undefined` when the input has no usable primary so the\n * caller can skip the assignment.\n */\nexport function normalizePatchAgentModel(v: unknown): { primary: string; fallbacks?: string[] } | undefined {\n  if (!v || typeof v !== 'object' || Array.isArray(v)) return undefined;\n  const o = v as Record<string, unknown>;\n  const primary = typeof o.primary === 'string' ? o.primary.trim() : '';\n  if (!primary) return undefined;\n  const fallbacks = Array.isArray(o.fallbacks)\n    ? o.fallbacks.filter((x): x is string => typeof x === 'string' && x.trim().length > 0)\n    : [];\n  return fallbacks.length > 0 ? { primary, fallbacks } : { primary };\n}\n\n/** Read `timeoutMs` from an image-generation model ref (only set when ref is an object). */\nexport function agentImageGenerationModelTimeoutMs(ref: unknown): number | null {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return null;\n  const v = (ref as { timeoutMs?: unknown }).timeoutMs;\n  return typeof v === 'number' && Number.isFinite(v) && v > 0 ? v : null;\n}\n\n/** Read `autoProviderFallback` from an image-generation model ref. Defaults to false. */\nexport function agentImageGenerationModelAutoProviderFallback(ref: unknown): boolean {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return false;\n  return (ref as { autoProviderFallback?: unknown }).autoProviderFallback === true;\n}\n\n/**\n * PATCH body normalizer for `agents.defaults.imageGenerationModel`. Always\n * emits `{ primary, fallbacks?, timeoutMs?, autoProviderFallback? }`. Returns\n * `undefined` when the input has no usable primary so the caller can skip the\n * assignment.\n */\nexport function normalizePatchAgentImageGenerationModel(\n  v: unknown,\n): { primary: string; fallbacks?: string[]; timeoutMs?: number; autoProviderFallback?: true } | undefined {\n  if (!v || typeof v !== 'object' || Array.isArray(v)) return undefined;\n  const o = v as Record<string, unknown>;\n  const primary = typeof o.primary === 'string' ? o.primary.trim() : '';\n  if (!primary) return undefined;\n  const out: { primary: string; fallbacks?: string[]; timeoutMs?: number; autoProviderFallback?: true } = { primary };\n  const fallbacks = Array.isArray(o.fallbacks)\n    ? o.fallbacks\n        .filter((x): x is string => typeof x === 'string' && x.trim().length > 0)\n        .map((x) => x.trim())\n    : [];\n  if (fallbacks.length > 0) out.fallbacks = fallbacks;\n  if (typeof o.timeoutMs === 'number' && Number.isFinite(o.timeoutMs) && o.timeoutMs > 0) {\n    out.timeoutMs = Math.floor(o.timeoutMs);\n  }\n  if (o.autoProviderFallback === true) out.autoProviderFallback = true;\n  return out;\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent-model.js","names":[],"sources":["../../../../../src/gateway/hono/lib/agent-model.ts"],"sourcesContent":["import type { AgentTypedModel } from '../../../config/schema.js';\n\nconst TYPED_MODEL_ID_RE = /^[a-z][a-z0-9_-]{0,63}$/;\n\nfunction isValidProviderModelRef(ref: string): boolean {\n  const trimmed = ref.trim();\n  const idx = trimmed.indexOf('/');\n  return idx > 0 && idx < trimmed.length - 1;\n}\n\n/**\n * Coerce PATCH body `{ roles: Record<id, role> }` into validated typed model roles.\n * Returns `null` to clear, `undefined` when input should be skipped, or cleaned roles.\n * Empty roles after filtering → `null` (same as clear).\n */\nexport function normalizePatchTypedModels(\n  v: unknown,\n): Record<string, Omit<AgentTypedModel, 'id'>> | null | undefined {\n  if (v === undefined) return undefined;\n  if (v === null) return null;\n  if (!v || typeof v !== 'object' || Array.isArray(v) || !('roles' in v)) return undefined;\n  const rawRoles = (v as { roles?: unknown }).roles;\n  if (!rawRoles || typeof rawRoles !== 'object' || Array.isArray(rawRoles)) return undefined;\n  const rows = Object.entries(rawRoles).map(([id, role]) => ({ id, ...(role as object) }));\n\n  const byId = new Map<string, Omit<AgentTypedModel, 'id'>>();\n  for (const raw of rows) {\n    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) continue;\n    const o = raw as Record<string, unknown>;\n    const id = typeof o.id === 'string' ? o.id.trim() : '';\n    const model = typeof o.model === 'string' ? o.model.trim() : '';\n    if (!id || !TYPED_MODEL_ID_RE.test(id) || !model || !isValidProviderModelRef(model)) continue;\n    const description =\n      typeof o.description === 'string' && o.description.trim()\n        ? o.description.trim().slice(0, 500)\n        : undefined;\n    byId.set(id, description ? { description, model } : { model });\n  }\n\n  if (byId.size === 0) return null;\n  return Object.fromEntries(byId.entries());\n}\n\n/** Read `primary` from an `AgentModelConfig` object. */\nexport function agentModelRefToString(ref: unknown): string | undefined {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return undefined;\n  const p = (ref as { primary?: string }).primary;\n  return typeof p === 'string' && p.trim() ? p : undefined;\n}\n\nexport function agentModelFallbacksToArray(ref: unknown): string[] {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return [];\n  const f = (ref as { fallbacks?: unknown }).fallbacks;\n  if (!Array.isArray(f)) return [];\n  return f.filter((x): x is string => typeof x === 'string' && x.trim().length > 0);\n}\n\n/**\n * Coerce a PATCH body `model` value into the canonical `{ primary, fallbacks? }`\n * object form. Returns `undefined` when the input has no usable primary so the\n * caller can skip the assignment.\n */\nexport function normalizePatchAgentModel(v: unknown): { primary: string; fallbacks?: string[] } | undefined {\n  if (!v || typeof v !== 'object' || Array.isArray(v)) return undefined;\n  const o = v as Record<string, unknown>;\n  const primary = typeof o.primary === 'string' ? o.primary.trim() : '';\n  if (!primary) return undefined;\n  const fallbacks = Array.isArray(o.fallbacks)\n    ? o.fallbacks.filter((x): x is string => typeof x === 'string' && x.trim().length > 0)\n    : [];\n  return fallbacks.length > 0 ? { primary, fallbacks } : { primary };\n}\n\n/** Read `timeoutMs` from an image-generation model ref (only set when ref is an object). */\nexport function agentImageGenerationModelTimeoutMs(ref: unknown): number | null {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return null;\n  const v = (ref as { timeoutMs?: unknown }).timeoutMs;\n  return typeof v === 'number' && Number.isFinite(v) && v > 0 ? v : null;\n}\n\n/** Read `autoProviderFallback` from an image-generation model ref. Defaults to false. */\nexport function agentImageGenerationModelAutoProviderFallback(ref: unknown): boolean {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return false;\n  return (ref as { autoProviderFallback?: unknown }).autoProviderFallback === true;\n}\n\n/**\n * PATCH body normalizer for `agents.defaults.imageGenerationModel`. Always\n * emits `{ primary, fallbacks?, timeoutMs?, autoProviderFallback? }`. Returns\n * `undefined` when the input has no usable primary so the caller can skip the\n * assignment.\n */\nexport function normalizePatchAgentImageGenerationModel(\n  v: unknown,\n): { primary: string; fallbacks?: string[]; timeoutMs?: number; autoProviderFallback?: true } | undefined {\n  if (!v || typeof v !== 'object' || Array.isArray(v)) return undefined;\n  const o = v as Record<string, unknown>;\n  const primary = typeof o.primary === 'string' ? o.primary.trim() : '';\n  if (!primary) return undefined;\n  const out: { primary: string; fallbacks?: string[]; timeoutMs?: number; autoProviderFallback?: true } = { primary };\n  const fallbacks = Array.isArray(o.fallbacks)\n    ? o.fallbacks\n        .filter((x): x is string => typeof x === 'string' && x.trim().length > 0)\n        .map((x) => x.trim())\n    : [];\n  if (fallbacks.length > 0) out.fallbacks = fallbacks;\n  if (typeof o.timeoutMs === 'number' && Number.isFinite(o.timeoutMs) && o.timeoutMs > 0) {\n    out.timeoutMs = Math.floor(o.timeoutMs);\n  }\n  if (o.autoProviderFallback === true) out.autoProviderFallback = true;\n  return out;\n}\n"],"mappings":"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"}

package/dist/src/gateway/hono/lib/config-payload.d.ts

@@ -36,11 +36,12 @@ export declare function buildSafeBrowserConfigForWeb(browser: Config['agents']['
     dialogTimeoutSeconds: number;
 };
 /** Sanitized config snapshot for GET/PATCH `/api/config` (matches persisted `service.currentConfig`). */
-export declare function buildSafeWebConfigPayload(service: GatewayService): Promise<{
+export declare function buildSafeWebConfigPayload(service: GatewayService, options?: {
+    locale?: string;
+}): Promise<{
     agents: {
         defaultId: string;
         list: {
-            name?: string;
             id: string;
         }[];
         defaults: {
@@ -179,15 +180,26 @@ export declare function buildSafeWebConfigPayload(service: GatewayService): Prom
                 disable?: string[];
             };
             models: {
-                id: string;
-                model: string;
-                description?: string;
-            }[];
+                chat?: {
+                    primary: string;
+                    fallbacks?: string[];
+                };
+                roles?: Record<string, {
+                    model: string;
+                    description?: string;
+                }>;
+            };
             params: Record<string, unknown>;
         };
     };
     channels: {
-        [k: string]: Record<string, unknown>;
+        [k: string]: {
+            enabled: unknown;
+            configured: boolean;
+            config: Record<string, unknown>;
+            schema: Record<string, unknown>;
+            uiHints: Record<string, import("../../../extensions/index.js").ChannelConfigUiHint>;
+        };
     };
     providers: any;
     /** Masked `cfg.providers` for capability keys (image / STT / etc.). */

package/dist/src/gateway/hono/lib/config-payload.js

@@ -1,13 +1,12 @@
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";
+import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, init_channel_catalog_service, isChannelConfigured } from "../../../channels/catalog/channel-catalog-service.js";
 import { init_models_json, loadModelsJson } from "../../../config/models-json.js";
 import { getProviderRegistry, init_plugin_registry } from "../../../providers/plugin-registry.js";
 import { getAllProviders, init_providers, isProviderConfigured } from "../../../providers/index.js";
 import { resolveShareConfig } from "../../../share/share-config.js";
-import { listChannelPlugins, syncChannelPluginsFromManager } from "../../../channels/plugins/registry.js";
 import { normalizeConfiguredMcpServers } from "../../../config/mcp-config-normalize.js";
-import { bundledChannelPlugins } from "../../../generated/bundled-channel-plugins.js";
 import { resolveCronConfigForWeb, resolveGoalsConfigForWeb, resolveSessionConfigForWeb, resolveUpdateConfigForWeb } from "../../../config/web-patch.js";
 import { GENERIC_MASKED_SECRET, maskSecretLength } from "./mask-secret-length.js";
 import { safeToolsWebForGet } from "../../config-tools-web.js";
@@ -17,6 +16,7 @@ import { buildSafeProvidersConfigForWeb } from "./safe-providers-config.js";
 import { maskSttConfigForWeb, maskTtsConfigForWeb } from "./safe-voice-config.js";
 //#region src/gateway/hono/lib/config-payload.ts
 init_agent_scope();
+init_channel_catalog_service();
 init_credentials();
 init_models_json();
 init_providers();
@@ -89,27 +89,28 @@ function buildSafeBrowserConfigForWeb(browser) {
 	};
 }
 /** Sanitized config snapshot for GET/PATCH `/api/config` (matches persisted `service.currentConfig`). */
-async function buildSafeWebConfigPayload(service) {
+async function buildSafeWebConfigPayload(service, options = {}) {
 	const config = service.currentConfig;
-	if (listChannelPlugins().length === 0) syncChannelPluginsFromManager(bundledChannelPlugins);
-	const channelsPayload = Object.fromEntries(listChannelPlugins().map((plugin) => {
-		if (plugin.configSurface) return [plugin.id, plugin.configSurface.buildConfigSurface(config)];
-		const channelCfg = config.channels?.[plugin.id];
-		return [plugin.id, {
+	const snapshot = (typeof service.getExtensionLoader === "function" ? service.getExtensionLoader() : void 0)?.getManifestSnapshot();
+	const catalog = snapshot ? buildChannelCatalogFromSnapshot(snapshot, { locale: options.locale }) : buildChannelCatalogForConfig(config, { locale: options.locale });
+	const channelsPayload = Object.fromEntries(catalog.entries.map((entry) => {
+		const plugin = typeof service.getChannelRuntimePlugin === "function" ? service.getChannelRuntimePlugin(entry.id) : void 0;
+		const channelCfg = config.channels?.[entry.id];
+		return [entry.id, {
 			enabled: channelCfg?.enabled ?? false,
-			configured: plugin.config.listAccountIds(config).length > 0
+			configured: isChannelConfigured(config, entry.id),
+			config: plugin?.configSurface?.buildConfigSurface(config) ?? channelCfg ?? {},
+			schema: entry.configSchema,
+			uiHints: entry.uiHints
 		}];
 	}));
 	return {
 		agents: {
 			defaultId: resolveDefaultAgentId(config),
-			list: listAgentEntries(config).filter((e) => e.enabled !== false).map((e) => ({
-				id: normalizeAgentId(e.id),
-				...typeof e.name === "string" && e.name.trim() ? { name: e.name.trim() } : {}
-			})),
+			list: listAgentEntries(config).filter((e) => e.enabled !== false).map((e) => ({ id: normalizeAgentId(e.id) })),
 			defaults: {
-				model: agentModelRefToString(config.agents?.defaults?.model) ?? "",
-				modelFallbacks: agentModelFallbacksToArray(config.agents?.defaults?.model),
+				model: agentModelRefToString(config.agents?.defaults?.models?.chat) ?? "",
+				modelFallbacks: agentModelFallbacksToArray(config.agents?.defaults?.models?.chat),
 				imageModel: agentModelRefToString(config.agents?.defaults?.imageModel) ?? null,
 				imageModelFallbacks: agentModelFallbacksToArray(config.agents?.defaults?.imageModel),
 				imageGenerationModel: agentModelRefToString(config.agents?.defaults?.imageGenerationModel) ?? null,