@xopcai/xopc 0.0.102 → 0.0.104

package/dist/src/providers/presentation.js

@@ -0,0 +1,162 @@
+import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";
+import { PROVIDER_META, getAllModels, getAllProviders, getModelsByProvider, getProviderDisplayName, init_providers, isProviderConfigured } from "./index.js";
+//#region src/providers/presentation.ts
+init_providers();
+init_plugin_registry();
+const FEATURED_PROVIDER_ORDER = [
+	"openai",
+	"anthropic",
+	"xai",
+	"google",
+	"openrouter",
+	"deepseek"
+];
+const PROVIDER_HINTS = {
+	openai: "Frontier OpenAI models from the official API.",
+	anthropic: "Claude models for coding, long context, and reasoning.",
+	xai: "Grok models from xAI.",
+	google: "Gemini models with strong multimodal and long-context support.",
+	openrouter: "Route many hosted models through one API key.",
+	deepseek: "DeepSeek V4 models with strong price/performance.",
+	"openai-codex": "OpenAI Codex models through OAuth.",
+	"google-gemini-cli": "Gemini through Google Cloud Code Assist OAuth.",
+	"google-antigravity": "Gemini/Antigravity OAuth model access."
+};
+const RECOMMENDED_MODEL_PATTERNS = {
+	openai: [
+		/^gpt-5\.5$/i,
+		/^gpt-5\.4$/i,
+		/^gpt-5\.4-mini$/i,
+		/^gpt-5\.4-pro$/i
+	],
+	"openai-codex": [
+		/^gpt-5\.5$/i,
+		/^gpt-5\.4$/i,
+		/^gpt-5\.4-mini$/i
+	],
+	anthropic: [
+		/^claude-sonnet-4/i,
+		/^claude-opus-4/i,
+		/^claude-haiku-4/i
+	],
+	google: [
+		/^gemini-3/i,
+		/^gemini-2\.5-pro$/i,
+		/^gemini-2\.5-flash$/i
+	],
+	"google-vertex": [
+		/^gemini-3/i,
+		/^gemini-2\.5-pro$/i,
+		/^gemini-2\.5-flash$/i
+	],
+	xai: [
+		/^grok-4/i,
+		/^grok-3/i,
+		/^grok-code/i
+	],
+	deepseek: [/^deepseek-v4-flash$/i, /^deepseek-v4-pro$/i],
+	openrouter: [
+		/^openai\/gpt-5/i,
+		/^anthropic\/claude-sonnet-4/i,
+		/^google\/gemini-3/i
+	],
+	moonshotai: [
+		/^kimi-k2\.6$/i,
+		/^kimi-k2\.5$/i,
+		/^kimi-k2-thinking/i
+	],
+	"moonshotai-cn": [
+		/^kimi-k2\.6$/i,
+		/^kimi-k2\.5$/i,
+		/^kimi-k2-thinking/i
+	]
+};
+function modelRef(model) {
+	return `${model.provider}/${model.id}`;
+}
+function recommendedRank(provider, modelId) {
+	const idx = (RECOMMENDED_MODEL_PATTERNS[provider] ?? []).findIndex((pattern) => pattern.test(modelId));
+	return idx === -1 ? Number.POSITIVE_INFINITY : idx;
+}
+function isRecommendedModel(provider, modelId) {
+	return Number.isFinite(recommendedRank(provider, modelId));
+}
+function modelToCatalogView(model) {
+	const input = model.input ?? ["text"];
+	return {
+		ref: modelRef(model),
+		provider: model.provider,
+		id: model.id,
+		name: model.name || model.id,
+		reasoning: model.reasoning ?? false,
+		input,
+		...model.contextWindow ? { contextWindow: model.contextWindow } : {},
+		...model.maxTokens ? { maxTokens: model.maxTokens } : {},
+		vision: input.includes("image"),
+		recommended: isRecommendedModel(model.provider, model.id)
+	};
+}
+function sortModelsForPicker(models) {
+	return [...models].sort((a, b) => {
+		const aRank = recommendedRank(a.provider, a.id);
+		const bRank = recommendedRank(b.provider, b.id);
+		if (aRank !== bRank) return aRank - bRank;
+		if (a.provider !== b.provider) return a.provider.localeCompare(b.provider);
+		return (a.name || a.id).localeCompare(b.name || b.id, void 0, { sensitivity: "base" });
+	});
+}
+function getRecommendedModelsForProvider(provider, limit = 4) {
+	return sortModelsForPicker(getModelsByProvider(provider)).filter((model) => isRecommendedModel(provider, model.id)).slice(0, limit).map(modelToCatalogView);
+}
+function getProviderHint(provider) {
+	return PROVIDER_HINTS[provider];
+}
+function getOnboardingFeaturedProviders() {
+	const providers = new Set(getAllProviders());
+	return FEATURED_PROVIDER_ORDER.filter((provider) => providers.has(provider));
+}
+function sortProvidersForPicker(providers) {
+	const featuredRank = new Map(FEATURED_PROVIDER_ORDER.map((provider, index) => [provider, index]));
+	return [...providers].sort((a, b) => {
+		const aRank = featuredRank.get(a) ?? Number.POSITIVE_INFINITY;
+		const bRank = featuredRank.get(b) ?? Number.POSITIVE_INFINITY;
+		if (aRank !== bRank) return aRank - bRank;
+		const catA = PROVIDER_META[a]?.category ?? "specialty";
+		const catB = PROVIDER_META[b]?.category ?? "specialty";
+		const catOrder = {
+			common: 0,
+			specialty: 1,
+			enterprise: 2,
+			oauth: 3,
+			extension: 4
+		};
+		if (catOrder[catA] !== catOrder[catB]) return catOrder[catA] - catOrder[catB];
+		return getProviderDisplayName(a).localeCompare(getProviderDisplayName(b), void 0, { sensitivity: "base" });
+	});
+}
+async function getProviderCatalogViews() {
+	const pluginRegistry = getProviderRegistry();
+	const providers = sortProvidersForPicker(getAllProviders());
+	const modelCounts = /* @__PURE__ */ new Map();
+	for (const model of getAllModels()) modelCounts.set(model.provider, (modelCounts.get(model.provider) ?? 0) + 1);
+	return Promise.all(providers.map(async (provider) => {
+		const plugin = pluginRegistry.get(provider);
+		const meta = PROVIDER_META[provider];
+		return {
+			id: provider,
+			name: plugin?.name ?? getProviderDisplayName(provider),
+			category: plugin ? "extension" : meta?.category ?? "specialty",
+			supportsOAuth: plugin ? false : meta?.supportsOAuth ?? false,
+			supportsApiKey: plugin ? false : meta?.supportsApiKey ?? true,
+			configured: plugin ? true : await isProviderConfigured(provider),
+			onboardingFeatured: FEATURED_PROVIDER_ORDER.includes(provider),
+			recommendedModels: getRecommendedModelsForProvider(provider),
+			modelCount: modelCounts.get(provider) ?? 0,
+			...getProviderHint(provider) ? { hint: getProviderHint(provider) } : {}
+		};
+	}));
+}
+//#endregion
+export { getOnboardingFeaturedProviders, getProviderCatalogViews, getProviderHint, getRecommendedModelsForProvider, isRecommendedModel, modelToCatalogView, sortModelsForPicker, sortProvidersForPicker };
+
+//# sourceMappingURL=presentation.js.map

package/dist/src/providers/presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","names":[],"sources":["../../../src/providers/presentation.ts"],"sourcesContent":["import type { Api, Model } from '@earendil-works/pi-ai';\n\nimport {\n  getAllModels,\n  getAllProviders,\n  getModelsByProvider,\n  getProviderDisplayName,\n  isProviderConfigured,\n  PROVIDER_META,\n  type ProviderCategory,\n} from './index.js';\nimport { getProviderRegistry } from './plugin-registry.js';\n\nexport interface ModelCatalogView {\n  ref: string;\n  provider: string;\n  id: string;\n  name: string;\n  reasoning: boolean;\n  input: Array<'text' | 'image'>;\n  contextWindow?: number;\n  maxTokens?: number;\n  vision: boolean;\n  recommended: boolean;\n}\n\nexport interface ProviderCatalogView {\n  id: string;\n  name: string;\n  category: ProviderCategory;\n  supportsOAuth: boolean;\n  supportsApiKey: boolean;\n  configured: boolean;\n  onboardingFeatured: boolean;\n  recommendedModels: ModelCatalogView[];\n  modelCount: number;\n  hint?: string;\n}\n\nconst FEATURED_PROVIDER_ORDER = ['openai', 'anthropic', 'xai', 'google', 'openrouter', 'deepseek'];\n\nconst PROVIDER_HINTS: Record<string, string> = {\n  openai: 'Frontier OpenAI models from the official API.',\n  anthropic: 'Claude models for coding, long context, and reasoning.',\n  xai: 'Grok models from xAI.',\n  google: 'Gemini models with strong multimodal and long-context support.',\n  openrouter: 'Route many hosted models through one API key.',\n  deepseek: 'DeepSeek V4 models with strong price/performance.',\n  'openai-codex': 'OpenAI Codex models through OAuth.',\n  'google-gemini-cli': 'Gemini through Google Cloud Code Assist OAuth.',\n  'google-antigravity': 'Gemini/Antigravity OAuth model access.',\n};\n\nconst RECOMMENDED_MODEL_PATTERNS: Record<string, RegExp[]> = {\n  openai: [/^gpt-5\\.5$/i, /^gpt-5\\.4$/i, /^gpt-5\\.4-mini$/i, /^gpt-5\\.4-pro$/i],\n  'openai-codex': [/^gpt-5\\.5$/i, /^gpt-5\\.4$/i, /^gpt-5\\.4-mini$/i],\n  anthropic: [/^claude-sonnet-4/i, /^claude-opus-4/i, /^claude-haiku-4/i],\n  google: [/^gemini-3/i, /^gemini-2\\.5-pro$/i, /^gemini-2\\.5-flash$/i],\n  'google-vertex': [/^gemini-3/i, /^gemini-2\\.5-pro$/i, /^gemini-2\\.5-flash$/i],\n  xai: [/^grok-4/i, /^grok-3/i, /^grok-code/i],\n  deepseek: [/^deepseek-v4-flash$/i, /^deepseek-v4-pro$/i],\n  openrouter: [/^openai\\/gpt-5/i, /^anthropic\\/claude-sonnet-4/i, /^google\\/gemini-3/i],\n  moonshotai: [/^kimi-k2\\.6$/i, /^kimi-k2\\.5$/i, /^kimi-k2-thinking/i],\n  'moonshotai-cn': [/^kimi-k2\\.6$/i, /^kimi-k2\\.5$/i, /^kimi-k2-thinking/i],\n};\n\nfunction modelRef(model: Pick<Model<Api>, 'provider' | 'id'>): string {\n  return `${model.provider}/${model.id}`;\n}\n\nfunction recommendedRank(provider: string, modelId: string): number {\n  const patterns = RECOMMENDED_MODEL_PATTERNS[provider] ?? [];\n  const idx = patterns.findIndex((pattern) => pattern.test(modelId));\n  return idx === -1 ? Number.POSITIVE_INFINITY : idx;\n}\n\nexport function isRecommendedModel(provider: string, modelId: string): boolean {\n  return Number.isFinite(recommendedRank(provider, modelId));\n}\n\nexport function modelToCatalogView(model: Model<Api>): ModelCatalogView {\n  const input = (model.input ?? ['text']) as Array<'text' | 'image'>;\n  return {\n    ref: modelRef(model),\n    provider: model.provider,\n    id: model.id,\n    name: model.name || model.id,\n    reasoning: model.reasoning ?? false,\n    input,\n    ...(model.contextWindow ? { contextWindow: model.contextWindow } : {}),\n    ...(model.maxTokens ? { maxTokens: model.maxTokens } : {}),\n    vision: input.includes('image'),\n    recommended: isRecommendedModel(model.provider, model.id),\n  };\n}\n\nexport function sortModelsForPicker(models: readonly Model<Api>[]): Model<Api>[] {\n  return [...models].sort((a, b) => {\n    const aRank = recommendedRank(a.provider, a.id);\n    const bRank = recommendedRank(b.provider, b.id);\n    if (aRank !== bRank) return aRank - bRank;\n    if (a.provider !== b.provider) return a.provider.localeCompare(b.provider);\n    return (a.name || a.id).localeCompare(b.name || b.id, undefined, { sensitivity: 'base' });\n  });\n}\n\nexport function getRecommendedModelsForProvider(provider: string, limit = 4): ModelCatalogView[] {\n  const models = sortModelsForPicker(getModelsByProvider(provider));\n  return models\n    .filter((model) => isRecommendedModel(provider, model.id))\n    .slice(0, limit)\n    .map(modelToCatalogView);\n}\n\nexport function getProviderHint(provider: string): string | undefined {\n  return PROVIDER_HINTS[provider];\n}\n\nexport function getOnboardingFeaturedProviders(): string[] {\n  const providers = new Set(getAllProviders());\n  return FEATURED_PROVIDER_ORDER.filter((provider) => providers.has(provider));\n}\n\nexport function sortProvidersForPicker(providers: readonly string[]): string[] {\n  const featuredRank = new Map(FEATURED_PROVIDER_ORDER.map((provider, index) => [provider, index] as const));\n  return [...providers].sort((a, b) => {\n    const aRank = featuredRank.get(a) ?? Number.POSITIVE_INFINITY;\n    const bRank = featuredRank.get(b) ?? Number.POSITIVE_INFINITY;\n    if (aRank !== bRank) return aRank - bRank;\n    const catA = PROVIDER_META[a]?.category ?? 'specialty';\n    const catB = PROVIDER_META[b]?.category ?? 'specialty';\n    const catOrder: Record<ProviderCategory, number> = { common: 0, specialty: 1, enterprise: 2, oauth: 3, extension: 4 };\n    if (catOrder[catA] !== catOrder[catB]) return catOrder[catA] - catOrder[catB];\n    return getProviderDisplayName(a).localeCompare(getProviderDisplayName(b), undefined, { sensitivity: 'base' });\n  });\n}\n\nexport async function getProviderCatalogViews(): Promise<ProviderCatalogView[]> {\n  const pluginRegistry = getProviderRegistry();\n  const providers = sortProvidersForPicker(getAllProviders());\n  const modelCounts = new Map<string, number>();\n  for (const model of getAllModels()) {\n    modelCounts.set(model.provider, (modelCounts.get(model.provider) ?? 0) + 1);\n  }\n\n  return Promise.all(\n    providers.map(async (provider) => {\n      const plugin = pluginRegistry.get(provider);\n      const meta = PROVIDER_META[provider];\n      return {\n        id: provider,\n        name: plugin?.name ?? getProviderDisplayName(provider),\n        category: plugin ? 'extension' : (meta?.category ?? 'specialty'),\n        supportsOAuth: plugin ? false : (meta?.supportsOAuth ?? false),\n        supportsApiKey: plugin ? false : (meta?.supportsApiKey ?? true),\n        configured: plugin ? true : await isProviderConfigured(provider),\n        onboardingFeatured: FEATURED_PROVIDER_ORDER.includes(provider),\n        recommendedModels: getRecommendedModelsForProvider(provider),\n        modelCount: modelCounts.get(provider) ?? 0,\n        ...(getProviderHint(provider) ? { hint: getProviderHint(provider) } : {}),\n      };\n    }),\n  );\n}\n"],"mappings":"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"}

package/dist/src/routing/resolve-route.d.ts

@@ -3,7 +3,6 @@
  *
  * Combines binding rules, identity links, and config to pick an agent and session keys.
  */
-import type { LocalizedText } from '../config/localized-text.js';
 import type { BindingRule, RouteInput, RouteResult } from './bindings.js';
 /**
  * Route context type (alias for RouteInput)
@@ -53,8 +52,6 @@ export interface AgentConfig {
     /** Registered agents */
     list?: Array<{
         id: string;
-        name?: LocalizedText;
-        description?: LocalizedText;
         enabled?: boolean;
         [key: string]: unknown;
     }>;

package/dist/src/routing/resolve-route.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-route.js","names":["resolveDefaultAgentIdFromConfig","resolveBindingRoute"],"sources":["../../../src/routing/resolve-route.ts"],"sourcesContent":["/**\n * Route resolution\n *\n * Combines binding rules, identity links, and config to pick an agent and session keys.\n */\n\nimport { resolveDefaultAgentId as resolveDefaultAgentIdFromConfig } from '../agent/agent-scope.js';\nimport type { Config } from '../config/schema.js';\nimport type { LocalizedText } from '../config/localized-text.js';\nimport type { BindingRule, RouteInput, RouteResult } from './bindings.js';\n\n/**\n * Route context type (alias for RouteInput)\n */\nexport type RouteContext = RouteInput;\nimport { parseBindingRules, resolveRoute as resolveBindingRoute } from './bindings.js';\nimport { buildSessionKey, normalizeSessionKey, parseSessionKey } from './session-key.js';\nimport {\n  buildAgentMainSessionKey,\n  buildAgentPeerSessionKey,\n} from './agent-session-key.js';\nimport { normalizeAccountId } from './account-id.js';\n\n/**\n * Identity link map: canonical peer id -> aliases across channels.\n *\n * Shape: `{ canonicalName: [alias1, alias2, ...] }`\n */\nexport type IdentityLinks = Record<string, string[]>;\n\n/**\n * Session-related routing options.\n */\nexport interface SessionConfig {\n  scope?: 'per-sender' | 'global';\n  mainKey?: string;\n  /** How DM sessions are scoped / merged */\n  dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';\n  /** Cross-channel identity aliases */\n  identityLinks?: IdentityLinks;\n  resetTriggers?: string[];\n  idleMinutes?: number;\n  reset?: {\n    mode?: 'daily' | 'idle';\n    atHour?: number;\n    idleMinutes?: number;\n  };\n  resetByType?: {\n    direct?: SessionConfig['reset'];\n    group?: SessionConfig['reset'];\n    thread?: SessionConfig['reset'];\n  };\n  resetByChannel?: Record<string, NonNullable<SessionConfig['reset']>>;\n  /** Optional session store tuning */\n  storage?: {\n    pruneAfterMs?: number;\n    maxEntries?: number;\n  };\n}\n\n/**\n * Agent list and default id from config.\n */\nexport interface AgentConfig {\n  /** Default agent id */\n  default?: string;\n  /** Registered agents */\n  list?: Array<{\n    id: string;\n    name?: LocalizedText;\n    description?: LocalizedText;\n    enabled?: boolean;\n    [key: string]: unknown;\n  }>;\n}\n\n/**\n * Subset of app config used for routing.\n */\nexport interface RoutingConfig {\n  agents?: AgentConfig;\n  bindings?: BindingRule[] | any[];\n  session?: SessionConfig;\n}\n\n/**\n * Input to `resolveRoute`.\n */\nexport interface ResolveRouteInput extends RouteInput {\n  /** Routing config snapshot */\n  config: RoutingConfig;\n  /** Optional thread id for threaded channels */\n  threadId?: string | null;\n}\n\n/**\n * Resolved route including session keys.\n */\nexport interface ResolveRouteResult extends RouteResult {\n  /** Active session key for this turn */\n  sessionKey: string;\n  /** Main session key (DM merge target) */\n  mainSessionKey: string;\n  /** Whether routing used the main or a per-session key */\n  lastRoutePolicy: 'main' | 'session';\n}\n\n/**\n * Apply identity links and return a canonical lowercased peer id.\n */\nexport function applyIdentityLinks(\n  peerId: string,\n  channel: string,\n  identityLinks?: IdentityLinks\n): string {\n  if (!identityLinks) {\n    return peerId.toLowerCase();\n  }\n  \n  const normalizedPeerId = peerId.trim().toLowerCase();\n  if (!normalizedPeerId) {\n    return normalizedPeerId;\n  }\n  \n  const candidates = new Set<string>();\n  candidates.add(normalizedPeerId);\n  \n  const channelPrefix = channel.trim().toLowerCase();\n  if (channelPrefix) {\n    candidates.add(`${channelPrefix}:${normalizedPeerId}`);\n  }\n  \n  // Match any alias to its canonical id\n  for (const [canonical, aliases] of Object.entries(identityLinks)) {\n    if (!Array.isArray(aliases)) {\n      continue;\n    }\n    \n    for (const alias of aliases) {\n      const normalizedAlias = alias.trim().toLowerCase();\n      if (candidates.has(normalizedAlias)) {\n        return canonical.trim().toLowerCase();\n      }\n    }\n  }\n  \n  return normalizedPeerId;\n}\n\n/**\n * Default agent id from config (`agents.default`, `list[].default`, or `main`).\n */\nexport function getDefaultAgentId(config: RoutingConfig): string {\n  return resolveDefaultAgentIdFromConfig(config as Config);\n}\n\n/**\n * Whether `agentId` appears in the enabled agent list (or list is absent).\n */\nexport function agentExists(agentId: string, config: RoutingConfig): boolean {\n  if (!config.agents?.list) {\n    return true; // No list: treat every id as valid\n  }\n  \n  return config.agents.list.some(\n    (agent) => agent.enabled !== false && agent.id.toLowerCase() === agentId.toLowerCase()\n  );\n}\n\n/**\n * Return `agentId` if listed, otherwise the default agent id.\n */\nexport function pickFirstExistingAgentId(agentId: string, config: RoutingConfig): string {\n  if (!agentId) {\n    return getDefaultAgentId(config);\n  }\n  \n  if (agentExists(agentId, config)) {\n    return agentId.toLowerCase();\n  }\n  \n  return getDefaultAgentId(config);\n}\n\n/**\n * Thin wrapper around `buildSessionKey` for route inputs.\n */\nexport function buildRouteSessionKey(\n  agentId: string,\n  channel: string,\n  accountId: string,\n  peerKind: string,\n  peerId: string,\n  threadId?: string | null,\n  scopeId?: string | null,\n): string {\n  return buildSessionKey({\n    agentId,\n    source: channel,\n    accountId,\n    peerKind,\n    peerId,\n    threadId: threadId || undefined,\n    scopeId: scopeId || undefined,\n    dmScope: peerKind === 'dm' || peerKind === 'direct' ? 'per-account-channel-peer' : undefined,\n  });\n}\n\n/**\n * Map session vs main key to policy label.\n */\nexport function deriveLastRoutePolicy(\n  sessionKey: string,\n  mainSessionKey: string\n): 'main' | 'session' {\n  return sessionKey === mainSessionKey ? 'main' : 'session';\n}\n\n/**\n * Resolve agent and session keys from channel context and config.\n */\nexport function resolveRoute(input: ResolveRouteInput): ResolveRouteResult {\n  const { config, threadId } = input;\n  \n  const channel = (input.channel ?? '').trim().toLowerCase() || 'unknown';\n  const accountId = normalizeAccountId(input.accountId);\n  const peerKind = (input.peerKind ?? 'dm').toLowerCase();\n  const rawPeerId = (input.peerId ?? '').trim();\n  \n  const peerId = applyIdentityLinks(rawPeerId, channel, config.session?.identityLinks ?? {});\n  \n  const rules = Array.isArray(config.bindings)\n    ? parseBindingRules({ bindings: config.bindings })\n    : [];\n  \n  const bindingResult = resolveBindingRoute(\n    {\n      channel,\n      accountId,\n      peerKind: input.peerKind,\n      peerId: rawPeerId,\n      guildId: input.guildId,\n      teamId: input.teamId,\n      memberRoleIds: input.memberRoleIds,\n    },\n    rules,\n    getDefaultAgentId(config)\n  );\n  \n  const agentId = pickFirstExistingAgentId(bindingResult.agentId, config);\n  \n  const dmScope = config.session?.dmScope ?? 'main';\n\n  let sessionKey: string;\n  let mainSessionKey: string;\n\n  const identityLinks = config.session?.identityLinks;\n  const mainKey = undefined;\n\n  if (peerKind === 'dm' || peerKind === 'direct') {\n    mainSessionKey = buildAgentMainSessionKey({ agentId, mainKey });\n\n    sessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: 'direct',\n      peerId,\n      identityLinks,\n      dmScope,\n    });\n  } else {\n    const mappedKind = peerKind === 'group' || peerKind === 'channel' ? peerKind : peerKind;\n    sessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: mappedKind as 'group' | 'channel',\n      peerId,\n      identityLinks,\n    });\n    mainSessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: mappedKind as 'group' | 'channel',\n      peerId: 'main',\n      identityLinks,\n    });\n  }\n\n  if (threadId && !sessionKey.includes(':thread:')) {\n    sessionKey = `${sessionKey}:thread:${threadId.toLowerCase()}`;\n  }\n  \n  sessionKey = normalizeSessionKey(sessionKey);\n  mainSessionKey = normalizeSessionKey(mainSessionKey);\n  \n  return {\n    ...bindingResult,\n    agentId,\n    sessionKey,\n    mainSessionKey,\n    lastRoutePolicy: deriveLastRoutePolicy(sessionKey, mainSessionKey),\n  };\n}\n\n/**\n * Parse basic routing fields from a session key string.\n */\nexport function resolveRouteFromSessionKey(\n  sessionKey: string,\n  _config: RoutingConfig\n): { agentId: string; source: string; accountId: string; peerKind: string; peerId: string } | null {\n  const parsed = parseSessionKey(sessionKey);\n  if (!parsed) {\n    return null;\n  }\n  \n  return {\n    agentId: parsed.agentId,\n    source: parsed.source,\n    accountId: parsed.accountId,\n    peerKind: parsed.peerKind,\n    peerId: parsed.peerId,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolve-route.js","names":["resolveDefaultAgentIdFromConfig","resolveBindingRoute"],"sources":["../../../src/routing/resolve-route.ts"],"sourcesContent":["/**\n * Route resolution\n *\n * Combines binding rules, identity links, and config to pick an agent and session keys.\n */\n\nimport { resolveDefaultAgentId as resolveDefaultAgentIdFromConfig } from '../agent/agent-scope.js';\nimport type { Config } from '../config/schema.js';\nimport type { BindingRule, RouteInput, RouteResult } from './bindings.js';\n\n/**\n * Route context type (alias for RouteInput)\n */\nexport type RouteContext = RouteInput;\nimport { parseBindingRules, resolveRoute as resolveBindingRoute } from './bindings.js';\nimport { buildSessionKey, normalizeSessionKey, parseSessionKey } from './session-key.js';\nimport {\n  buildAgentMainSessionKey,\n  buildAgentPeerSessionKey,\n} from './agent-session-key.js';\nimport { normalizeAccountId } from './account-id.js';\n\n/**\n * Identity link map: canonical peer id -> aliases across channels.\n *\n * Shape: `{ canonicalName: [alias1, alias2, ...] }`\n */\nexport type IdentityLinks = Record<string, string[]>;\n\n/**\n * Session-related routing options.\n */\nexport interface SessionConfig {\n  scope?: 'per-sender' | 'global';\n  mainKey?: string;\n  /** How DM sessions are scoped / merged */\n  dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';\n  /** Cross-channel identity aliases */\n  identityLinks?: IdentityLinks;\n  resetTriggers?: string[];\n  idleMinutes?: number;\n  reset?: {\n    mode?: 'daily' | 'idle';\n    atHour?: number;\n    idleMinutes?: number;\n  };\n  resetByType?: {\n    direct?: SessionConfig['reset'];\n    group?: SessionConfig['reset'];\n    thread?: SessionConfig['reset'];\n  };\n  resetByChannel?: Record<string, NonNullable<SessionConfig['reset']>>;\n  /** Optional session store tuning */\n  storage?: {\n    pruneAfterMs?: number;\n    maxEntries?: number;\n  };\n}\n\n/**\n * Agent list and default id from config.\n */\nexport interface AgentConfig {\n  /** Default agent id */\n  default?: string;\n  /** Registered agents */\n  list?: Array<{\n    id: string;\n    enabled?: boolean;\n    [key: string]: unknown;\n  }>;\n}\n\n/**\n * Subset of app config used for routing.\n */\nexport interface RoutingConfig {\n  agents?: AgentConfig;\n  bindings?: BindingRule[] | any[];\n  session?: SessionConfig;\n}\n\n/**\n * Input to `resolveRoute`.\n */\nexport interface ResolveRouteInput extends RouteInput {\n  /** Routing config snapshot */\n  config: RoutingConfig;\n  /** Optional thread id for threaded channels */\n  threadId?: string | null;\n}\n\n/**\n * Resolved route including session keys.\n */\nexport interface ResolveRouteResult extends RouteResult {\n  /** Active session key for this turn */\n  sessionKey: string;\n  /** Main session key (DM merge target) */\n  mainSessionKey: string;\n  /** Whether routing used the main or a per-session key */\n  lastRoutePolicy: 'main' | 'session';\n}\n\n/**\n * Apply identity links and return a canonical lowercased peer id.\n */\nexport function applyIdentityLinks(\n  peerId: string,\n  channel: string,\n  identityLinks?: IdentityLinks\n): string {\n  if (!identityLinks) {\n    return peerId.toLowerCase();\n  }\n  \n  const normalizedPeerId = peerId.trim().toLowerCase();\n  if (!normalizedPeerId) {\n    return normalizedPeerId;\n  }\n  \n  const candidates = new Set<string>();\n  candidates.add(normalizedPeerId);\n  \n  const channelPrefix = channel.trim().toLowerCase();\n  if (channelPrefix) {\n    candidates.add(`${channelPrefix}:${normalizedPeerId}`);\n  }\n  \n  // Match any alias to its canonical id\n  for (const [canonical, aliases] of Object.entries(identityLinks)) {\n    if (!Array.isArray(aliases)) {\n      continue;\n    }\n    \n    for (const alias of aliases) {\n      const normalizedAlias = alias.trim().toLowerCase();\n      if (candidates.has(normalizedAlias)) {\n        return canonical.trim().toLowerCase();\n      }\n    }\n  }\n  \n  return normalizedPeerId;\n}\n\n/**\n * Default agent id from config (`agents.default`, `list[].default`, or `main`).\n */\nexport function getDefaultAgentId(config: RoutingConfig): string {\n  return resolveDefaultAgentIdFromConfig(config as Config);\n}\n\n/**\n * Whether `agentId` appears in the enabled agent list (or list is absent).\n */\nexport function agentExists(agentId: string, config: RoutingConfig): boolean {\n  if (!config.agents?.list) {\n    return true; // No list: treat every id as valid\n  }\n  \n  return config.agents.list.some(\n    (agent) => agent.enabled !== false && agent.id.toLowerCase() === agentId.toLowerCase()\n  );\n}\n\n/**\n * Return `agentId` if listed, otherwise the default agent id.\n */\nexport function pickFirstExistingAgentId(agentId: string, config: RoutingConfig): string {\n  if (!agentId) {\n    return getDefaultAgentId(config);\n  }\n  \n  if (agentExists(agentId, config)) {\n    return agentId.toLowerCase();\n  }\n  \n  return getDefaultAgentId(config);\n}\n\n/**\n * Thin wrapper around `buildSessionKey` for route inputs.\n */\nexport function buildRouteSessionKey(\n  agentId: string,\n  channel: string,\n  accountId: string,\n  peerKind: string,\n  peerId: string,\n  threadId?: string | null,\n  scopeId?: string | null,\n): string {\n  return buildSessionKey({\n    agentId,\n    source: channel,\n    accountId,\n    peerKind,\n    peerId,\n    threadId: threadId || undefined,\n    scopeId: scopeId || undefined,\n    dmScope: peerKind === 'dm' || peerKind === 'direct' ? 'per-account-channel-peer' : undefined,\n  });\n}\n\n/**\n * Map session vs main key to policy label.\n */\nexport function deriveLastRoutePolicy(\n  sessionKey: string,\n  mainSessionKey: string\n): 'main' | 'session' {\n  return sessionKey === mainSessionKey ? 'main' : 'session';\n}\n\n/**\n * Resolve agent and session keys from channel context and config.\n */\nexport function resolveRoute(input: ResolveRouteInput): ResolveRouteResult {\n  const { config, threadId } = input;\n  \n  const channel = (input.channel ?? '').trim().toLowerCase() || 'unknown';\n  const accountId = normalizeAccountId(input.accountId);\n  const peerKind = (input.peerKind ?? 'dm').toLowerCase();\n  const rawPeerId = (input.peerId ?? '').trim();\n  \n  const peerId = applyIdentityLinks(rawPeerId, channel, config.session?.identityLinks ?? {});\n  \n  const rules = Array.isArray(config.bindings)\n    ? parseBindingRules({ bindings: config.bindings })\n    : [];\n  \n  const bindingResult = resolveBindingRoute(\n    {\n      channel,\n      accountId,\n      peerKind: input.peerKind,\n      peerId: rawPeerId,\n      guildId: input.guildId,\n      teamId: input.teamId,\n      memberRoleIds: input.memberRoleIds,\n    },\n    rules,\n    getDefaultAgentId(config)\n  );\n  \n  const agentId = pickFirstExistingAgentId(bindingResult.agentId, config);\n  \n  const dmScope = config.session?.dmScope ?? 'main';\n\n  let sessionKey: string;\n  let mainSessionKey: string;\n\n  const identityLinks = config.session?.identityLinks;\n  const mainKey = undefined;\n\n  if (peerKind === 'dm' || peerKind === 'direct') {\n    mainSessionKey = buildAgentMainSessionKey({ agentId, mainKey });\n\n    sessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: 'direct',\n      peerId,\n      identityLinks,\n      dmScope,\n    });\n  } else {\n    const mappedKind = peerKind === 'group' || peerKind === 'channel' ? peerKind : peerKind;\n    sessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: mappedKind as 'group' | 'channel',\n      peerId,\n      identityLinks,\n    });\n    mainSessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: mappedKind as 'group' | 'channel',\n      peerId: 'main',\n      identityLinks,\n    });\n  }\n\n  if (threadId && !sessionKey.includes(':thread:')) {\n    sessionKey = `${sessionKey}:thread:${threadId.toLowerCase()}`;\n  }\n  \n  sessionKey = normalizeSessionKey(sessionKey);\n  mainSessionKey = normalizeSessionKey(mainSessionKey);\n  \n  return {\n    ...bindingResult,\n    agentId,\n    sessionKey,\n    mainSessionKey,\n    lastRoutePolicy: deriveLastRoutePolicy(sessionKey, mainSessionKey),\n  };\n}\n\n/**\n * Parse basic routing fields from a session key string.\n */\nexport function resolveRouteFromSessionKey(\n  sessionKey: string,\n  _config: RoutingConfig\n): { agentId: string; source: string; accountId: string; peerKind: string; peerId: string } | null {\n  const parsed = parseSessionKey(sessionKey);\n  if (!parsed) {\n    return null;\n  }\n  \n  return {\n    agentId: parsed.agentId,\n    source: parsed.source,\n    accountId: parsed.accountId,\n    peerKind: parsed.peerKind,\n    peerId: parsed.peerId,\n  };\n}\n"],"mappings":"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"}

package/dist/src/routing/resolve-tui-session-key.d.ts

@@ -12,11 +12,13 @@ export declare function resolveInitialTuiAgentId(params: {
     initialSessionInput?: string;
     cwd?: string;
 }): string;
+export declare function createDefaultTuiSessionKeySuffix(): string;
 /** Resolve TUI startup session key from CLI options and config. */
 export declare function resolveTuiStartupSessionKey(params: {
     cfg: Config;
     sessionOption?: string;
     cwd?: string;
+    createSessionKeySuffix?: () => string;
 }): {
     sessionKey: string;
     agentId: string;

package/dist/src/routing/resolve-tui-session-key.js

@@ -2,6 +2,7 @@ import { init_agent_scope, resolveAgentIdByWorkspacePath, resolveDefaultAgentId
 import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../utils/string-coerce.js";
 import { parseAgentSessionKey } from "./session-key-utils.js";
 import { buildAgentMainSessionKey, init_agent_session_key, normalizeAgentId, normalizeMainKey } from "./agent-session-key.js";
+import { randomUUID } from "node:crypto";
 //#region src/routing/resolve-tui-session-key.ts
 init_agent_scope();
 init_agent_session_key();
@@ -26,19 +27,23 @@ function resolveInitialTuiAgentId(params) {
 	if (inferredFromWorkspace) return inferredFromWorkspace;
 	return normalizeAgentId(params.fallbackAgentId);
 }
+function createDefaultTuiSessionKeySuffix() {
+	return `tui-${randomUUID()}`;
+}
 /** Resolve TUI startup session key from CLI options and config. */
 function resolveTuiStartupSessionKey(params) {
 	const sessionScope = params.cfg.session?.scope ?? "per-sender";
 	const sessionMainKey = normalizeMainKey(params.cfg.session?.mainKey);
+	const sessionOption = (params.sessionOption ?? "").trim();
 	const agentId = resolveInitialTuiAgentId({
 		cfg: params.cfg,
 		fallbackAgentId: resolveDefaultAgentId(params.cfg),
-		initialSessionInput: (params.sessionOption ?? "").trim(),
+		initialSessionInput: sessionOption,
 		cwd: params.cwd ?? process.cwd()
 	});
 	return {
 		sessionKey: resolveTuiSessionKey({
-			raw: params.sessionOption,
+			raw: sessionOption || (params.createSessionKeySuffix ?? createDefaultTuiSessionKeySuffix)(),
 			sessionScope,
 			currentAgentId: agentId,
 			sessionMainKey
@@ -49,6 +54,6 @@ function resolveTuiStartupSessionKey(params) {
 	};
 }
 //#endregion
-export { resolveInitialTuiAgentId, resolveTuiSessionKey, resolveTuiStartupSessionKey };
+export { createDefaultTuiSessionKeySuffix, resolveInitialTuiAgentId, resolveTuiSessionKey, resolveTuiStartupSessionKey };
 
 //# sourceMappingURL=resolve-tui-session-key.js.map

package/dist/src/routing/resolve-tui-session-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-tui-session-key.js","names":[],"sources":["../../../src/routing/resolve-tui-session-key.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport {\n  resolveAgentIdByWorkspacePath,\n  resolveDefaultAgentId,\n} from '../agent/agent-scope.js';\nimport {\n  buildAgentMainSessionKey,\n  normalizeAgentId,\n  normalizeMainKey,\n  parseAgentSessionKey,\n} from './agent-session-key.js';\nimport { normalizeLowercaseStringOrEmpty } from '../utils/string-coerce.js';\n\nexport type SessionScope = 'per-sender' | 'global';\n\nexport function resolveTuiSessionKey(params: {\n  raw?: string;\n  sessionScope: SessionScope;\n  currentAgentId: string;\n  sessionMainKey: string;\n}): string {\n  const trimmed = (params.raw ?? '').trim();\n  if (!trimmed) {\n    if (params.sessionScope === 'global') {\n      return 'global';\n    }\n    return buildAgentMainSessionKey({\n      agentId: params.currentAgentId,\n      mainKey: params.sessionMainKey,\n    });\n  }\n  if (trimmed === 'global' || trimmed === 'unknown') {\n    return trimmed;\n  }\n  if (trimmed.startsWith('agent:')) {\n    return normalizeLowercaseStringOrEmpty(trimmed);\n  }\n  return `agent:${params.currentAgentId}:${normalizeLowercaseStringOrEmpty(trimmed)}`;\n}\n\nexport function resolveInitialTuiAgentId(params: {\n  cfg: Config;\n  fallbackAgentId: string;\n  initialSessionInput?: string;\n  cwd?: string;\n}): string {\n  const parsed = parseAgentSessionKey((params.initialSessionInput ?? '').trim());\n  if (parsed?.agentId) {\n    return normalizeAgentId(parsed.agentId);\n  }\n\n  const inferredFromWorkspace = resolveAgentIdByWorkspacePath(\n    params.cfg,\n    params.cwd ?? process.cwd(),\n  );\n  if (inferredFromWorkspace) {\n    return inferredFromWorkspace;\n  }\n\n  return normalizeAgentId(params.fallbackAgentId);\n}\n\n/** Resolve TUI startup session key from CLI options and config. */\nexport function resolveTuiStartupSessionKey(params: {\n  cfg: Config;\n  sessionOption?: string;\n  cwd?: string;\n}): { sessionKey: string; agentId: string; sessionScope: SessionScope; sessionMainKey: string } {\n  const sessionScope = (params.cfg.session?.scope ?? 'per-sender') as SessionScope;\n  const sessionMainKey = normalizeMainKey(params.cfg.session?.mainKey);\n  const agentId = resolveInitialTuiAgentId({\n    cfg: params.cfg,\n    fallbackAgentId: resolveDefaultAgentId(params.cfg),\n    initialSessionInput: (params.sessionOption ?? '').trim(),\n    cwd: params.cwd ?? process.cwd(),\n  });\n  const sessionKey = resolveTuiSessionKey({\n    raw: params.sessionOption,\n    sessionScope,\n    currentAgentId: agentId,\n    sessionMainKey,\n  });\n  return { sessionKey, agentId, sessionScope, sessionMainKey };\n}\n"],"mappings":";;;;;kBAIiC;wBAMD;oBAC4C;AAI5E,SAAgB,qBAAqB,QAK1B;CACT,MAAM,WAAW,OAAO,OAAO,IAAI,MAAM;AACzC,KAAI,CAAC,SAAS;AACZ,MAAI,OAAO,iBAAiB,SAC1B,QAAO;AAET,SAAO,yBAAyB;GAC9B,SAAS,OAAO;GAChB,SAAS,OAAO;GACjB,CAAC;;AAEJ,KAAI,YAAY,YAAY,YAAY,UACtC,QAAO;AAET,KAAI,QAAQ,WAAW,SAAS,CAC9B,QAAO,gCAAgC,QAAQ;AAEjD,QAAO,SAAS,OAAO,eAAe,GAAG,gCAAgC,QAAQ;;AAGnF,SAAgB,yBAAyB,QAK9B;CACT,MAAM,SAAS,sBAAsB,OAAO,uBAAuB,IAAI,MAAM,CAAC;AAC9E,KAAI,QAAQ,QACV,QAAO,iBAAiB,OAAO,QAAQ;CAGzC,MAAM,wBAAwB,8BAC5B,OAAO,KACP,OAAO,OAAO,QAAQ,KAAK,CAC5B;AACD,KAAI,sBACF,QAAO;AAGT,QAAO,iBAAiB,OAAO,gBAAgB;;;AAIjD,SAAgB,4BAA4B,QAIoD;CAC9F,MAAM,eAAgB,OAAO,IAAI,SAAS,SAAS;CACnD,MAAM,iBAAiB,iBAAiB,OAAO,IAAI,SAAS,QAAQ;CACpE,MAAM,UAAU,yBAAyB;EACvC,KAAK,OAAO;EACZ,iBAAiB,sBAAsB,OAAO,IAAI;EAClD,sBAAsB,OAAO,iBAAiB,IAAI,MAAM;EACxD,KAAK,OAAO,OAAO,QAAQ,KAAK;EACjC,CAAC;AAOF,QAAO;EAAE,YANU,qBAAqB;GACtC,KAAK,OAAO;GACZ;GACA,gBAAgB;GAChB;GACD,CACkB;EAAE;EAAS;EAAc;EAAgB"}
+{"version":3,"file":"resolve-tui-session-key.js","names":[],"sources":["../../../src/routing/resolve-tui-session-key.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { Config } from '../config/schema.js';\nimport {\n  resolveAgentIdByWorkspacePath,\n  resolveDefaultAgentId,\n} from '../agent/agent-scope.js';\nimport {\n  buildAgentMainSessionKey,\n  normalizeAgentId,\n  normalizeMainKey,\n  parseAgentSessionKey,\n} from './agent-session-key.js';\nimport { normalizeLowercaseStringOrEmpty } from '../utils/string-coerce.js';\n\nexport type SessionScope = 'per-sender' | 'global';\n\nexport function resolveTuiSessionKey(params: {\n  raw?: string;\n  sessionScope: SessionScope;\n  currentAgentId: string;\n  sessionMainKey: string;\n}): string {\n  const trimmed = (params.raw ?? '').trim();\n  if (!trimmed) {\n    if (params.sessionScope === 'global') {\n      return 'global';\n    }\n    return buildAgentMainSessionKey({\n      agentId: params.currentAgentId,\n      mainKey: params.sessionMainKey,\n    });\n  }\n  if (trimmed === 'global' || trimmed === 'unknown') {\n    return trimmed;\n  }\n  if (trimmed.startsWith('agent:')) {\n    return normalizeLowercaseStringOrEmpty(trimmed);\n  }\n  return `agent:${params.currentAgentId}:${normalizeLowercaseStringOrEmpty(trimmed)}`;\n}\n\nexport function resolveInitialTuiAgentId(params: {\n  cfg: Config;\n  fallbackAgentId: string;\n  initialSessionInput?: string;\n  cwd?: string;\n}): string {\n  const parsed = parseAgentSessionKey((params.initialSessionInput ?? '').trim());\n  if (parsed?.agentId) {\n    return normalizeAgentId(parsed.agentId);\n  }\n\n  const inferredFromWorkspace = resolveAgentIdByWorkspacePath(\n    params.cfg,\n    params.cwd ?? process.cwd(),\n  );\n  if (inferredFromWorkspace) {\n    return inferredFromWorkspace;\n  }\n\n  return normalizeAgentId(params.fallbackAgentId);\n}\n\nexport function createDefaultTuiSessionKeySuffix(): string {\n  return `tui-${randomUUID()}`;\n}\n\n/** Resolve TUI startup session key from CLI options and config. */\nexport function resolveTuiStartupSessionKey(params: {\n  cfg: Config;\n  sessionOption?: string;\n  cwd?: string;\n  createSessionKeySuffix?: () => string;\n}): { sessionKey: string; agentId: string; sessionScope: SessionScope; sessionMainKey: string } {\n  const sessionScope = (params.cfg.session?.scope ?? 'per-sender') as SessionScope;\n  const sessionMainKey = normalizeMainKey(params.cfg.session?.mainKey);\n  const sessionOption = (params.sessionOption ?? '').trim();\n  const agentId = resolveInitialTuiAgentId({\n    cfg: params.cfg,\n    fallbackAgentId: resolveDefaultAgentId(params.cfg),\n    initialSessionInput: sessionOption,\n    cwd: params.cwd ?? process.cwd(),\n  });\n  const sessionKey = resolveTuiSessionKey({\n    raw: sessionOption || (params.createSessionKeySuffix ?? createDefaultTuiSessionKeySuffix)(),\n    sessionScope,\n    currentAgentId: agentId,\n    sessionMainKey,\n  });\n  return { sessionKey, agentId, sessionScope, sessionMainKey };\n}\n"],"mappings":";;;;;;kBAMiC;wBAMD;oBAC4C;AAI5E,SAAgB,qBAAqB,QAK1B;CACT,MAAM,WAAW,OAAO,OAAO,IAAI,MAAM;AACzC,KAAI,CAAC,SAAS;AACZ,MAAI,OAAO,iBAAiB,SAC1B,QAAO;AAET,SAAO,yBAAyB;GAC9B,SAAS,OAAO;GAChB,SAAS,OAAO;GACjB,CAAC;;AAEJ,KAAI,YAAY,YAAY,YAAY,UACtC,QAAO;AAET,KAAI,QAAQ,WAAW,SAAS,CAC9B,QAAO,gCAAgC,QAAQ;AAEjD,QAAO,SAAS,OAAO,eAAe,GAAG,gCAAgC,QAAQ;;AAGnF,SAAgB,yBAAyB,QAK9B;CACT,MAAM,SAAS,sBAAsB,OAAO,uBAAuB,IAAI,MAAM,CAAC;AAC9E,KAAI,QAAQ,QACV,QAAO,iBAAiB,OAAO,QAAQ;CAGzC,MAAM,wBAAwB,8BAC5B,OAAO,KACP,OAAO,OAAO,QAAQ,KAAK,CAC5B;AACD,KAAI,sBACF,QAAO;AAGT,QAAO,iBAAiB,OAAO,gBAAgB;;AAGjD,SAAgB,mCAA2C;AACzD,QAAO,OAAO,YAAY;;;AAI5B,SAAgB,4BAA4B,QAKoD;CAC9F,MAAM,eAAgB,OAAO,IAAI,SAAS,SAAS;CACnD,MAAM,iBAAiB,iBAAiB,OAAO,IAAI,SAAS,QAAQ;CACpE,MAAM,iBAAiB,OAAO,iBAAiB,IAAI,MAAM;CACzD,MAAM,UAAU,yBAAyB;EACvC,KAAK,OAAO;EACZ,iBAAiB,sBAAsB,OAAO,IAAI;EAClD,qBAAqB;EACrB,KAAK,OAAO,OAAO,QAAQ,KAAK;EACjC,CAAC;AAOF,QAAO;EAAE,YANU,qBAAqB;GACtC,KAAK,kBAAkB,OAAO,0BAA0B,mCAAmC;GAC3F;GACA,gBAAgB;GAChB;GACD,CACkB;EAAE;EAAS;EAAc;EAAgB"}

package/dist/src/session/client-history.d.ts

@@ -1,9 +1,34 @@
 import type { Message } from './types.js';
+import type { TranscriptStoredRow } from './session-context-for-llm.js';
 /** Transcript row for TUI and HTTP clients (flattened from persisted session messages). */
 export interface ClientHistoryMessage {
+    id?: string;
     role: 'user' | 'assistant' | 'system';
     content: string;
+    rawContent?: string | unknown[];
     timestamp?: number;
+    kind?: 'message' | 'compaction' | 'context' | 'bash' | 'custom' | 'branch';
+    tokensBefore?: number;
+    tokensAfter?: number;
+    bash?: {
+        command: string;
+        output?: string;
+        exitCode?: number | null;
+        signal?: string | null;
+        excludeFromContext?: boolean;
+        truncated?: boolean;
+        fullOutputPath?: string;
+    };
+    custom?: {
+        customType: string;
+        details?: unknown;
+        state?: boolean;
+        display?: boolean;
+    };
+    branch?: {
+        summary: string;
+        fromId?: string;
+    };
     toolCalls?: Array<{
         name: string;
         args?: unknown;
@@ -19,3 +44,10 @@ export declare function flattenMessageContent(content: string | unknown[]): stri
 export declare function messagesToClientHistory(messages: Message[], opts?: {
     limit?: number;
 }): ClientHistoryMessage[];
+/**
+ * Maps persisted transcript rows into linear chat history, preserving non-LLM
+ * audit rows that the TUI can render as dedicated components.
+ */
+export declare function transcriptRowsToClientHistory(rows: TranscriptStoredRow[], opts?: {
+    limit?: number;
+}): ClientHistoryMessage[];

package/dist/src/session/client-history.js

@@ -83,7 +83,238 @@ function messagesToClientHistory(messages, opts) {
 	}
 	return out;
 }
+function asHistoryMessageRow(row) {
+	const role = row.role;
+	if (typeof role !== "string" || ![
+		"system",
+		"user",
+		"assistant",
+		"tool",
+		"toolResult"
+	].includes(role)) return null;
+	return row;
+}
+function parseTimestampValue(ts) {
+	if (typeof ts === "number") return Number.isFinite(ts) ? ts : void 0;
+	return parseTimestamp(ts);
+}
+function collectHistoryToolResults(messages) {
+	const map = /* @__PURE__ */ new Map();
+	for (const m of messages) {
+		if (m.role !== "tool" && m.role !== "toolResult") continue;
+		const id = m.tool_call_id ?? m.toolCallId;
+		if (!id || typeof id !== "string") continue;
+		map.set(id, {
+			text: flattenMessageContent(m.content ?? ""),
+			isError: m.isError
+		});
+	}
+	return map;
+}
+function isCompactionRow(row) {
+	return row.type === "compaction";
+}
+function compactionSummaryRowToClientHistory(row) {
+	const r = row;
+	if (r.role !== "compactionSummary") return null;
+	return {
+		role: "system",
+		kind: "compaction",
+		content: optionalString(r.summary) ?? "",
+		timestamp: parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0),
+		tokensBefore: typeof r.tokensBefore === "number" ? r.tokensBefore : void 0
+	};
+}
+function contextRowToClientHistory(row) {
+	if (row.kind !== "context") return null;
+	const text = row.text;
+	if (typeof text !== "string" || !text.trim()) return null;
+	const createdAt = row.createdAt;
+	return {
+		role: "system",
+		kind: "context",
+		content: text,
+		timestamp: typeof createdAt === "string" ? parseTimestamp(createdAt) : void 0
+	};
+}
+function optionalString(value) {
+	return typeof value === "string" ? value : void 0;
+}
+function bashRowToClientHistory(row) {
+	const r = row;
+	if (r.role !== "bashExecution") return null;
+	const command = optionalString(r.command) ?? optionalString(r.content)?.trim();
+	if (!command) return null;
+	const output = Array.isArray(r.output) || typeof r.output === "string" ? flattenMessageContent(r.output) : optionalString(r.output);
+	const exitCode = typeof r.exitCode === "number" ? r.exitCode : r.exitCode === null ? null : void 0;
+	const signal = typeof r.signal === "string" ? r.signal : r.signal === null ? null : void 0;
+	const excludeFromContext = typeof r.excludeFromContext === "boolean" ? r.excludeFromContext : typeof r.excludedFromContext === "boolean" ? r.excludedFromContext : void 0;
+	return {
+		role: "system",
+		kind: "bash",
+		content: output || command,
+		timestamp: parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0),
+		bash: {
+			command,
+			output,
+			exitCode,
+			signal,
+			excludeFromContext,
+			truncated: typeof r.truncated === "boolean" ? r.truncated : void 0,
+			fullOutputPath: optionalString(r.fullOutputPath)
+		}
+	};
+}
+function customRowToClientHistory(row) {
+	const r = row;
+	if (r.role !== "custom" && r.type !== "custom_message") return null;
+	const customType = optionalString(r.customType)?.trim();
+	if (!customType) return null;
+	const content = Array.isArray(r.content) || typeof r.content === "string" ? flattenMessageContent(r.content) : "";
+	const timestamp = parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0);
+	return {
+		role: "system",
+		kind: "custom",
+		content,
+		rawContent: Array.isArray(r.content) || typeof r.content === "string" ? r.content : void 0,
+		timestamp,
+		custom: {
+			customType,
+			details: r.details,
+			display: r.display === false ? false : true
+		}
+	};
+}
+function customStateRowToClientHistory(row) {
+	const r = row;
+	if (r.type !== "custom") return null;
+	const customType = optionalString(r.customType)?.trim();
+	if (!customType) return null;
+	return {
+		role: "system",
+		kind: "custom",
+		content: "",
+		timestamp: parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0),
+		custom: {
+			customType,
+			details: r.data,
+			state: true
+		}
+	};
+}
+function branchSummaryRowToClientHistory(row) {
+	const r = row;
+	if (r.role !== "branchSummary") return null;
+	const summary = optionalString(r.summary)?.trim();
+	if (!summary) return null;
+	const fromId = optionalString(r.fromId);
+	return {
+		role: "system",
+		kind: "branch",
+		content: summary,
+		timestamp: parseTimestampValue(typeof r.timestamp === "string" || typeof r.timestamp === "number" ? r.timestamp : void 0),
+		branch: {
+			summary,
+			fromId
+		}
+	};
+}
+/**
+* Maps persisted transcript rows into linear chat history, preserving non-LLM
+* audit rows that the TUI can render as dedicated components.
+*/
+function transcriptRowsToClientHistory(rows, opts) {
+	const startIndex = opts?.limit !== void 0 && rows.length > opts.limit ? rows.length - opts.limit : 0;
+	const slice = opts?.limit !== void 0 && rows.length > opts.limit ? rows.slice(-opts.limit) : rows;
+	const results = collectHistoryToolResults(slice.map(asHistoryMessageRow).filter((row) => row !== null));
+	const out = [];
+	for (const [offset, row] of slice.entries()) {
+		const id = `row-${startIndex + offset + 1}`;
+		if (isCompactionRow(row)) {
+			out.push({
+				id,
+				role: "system",
+				kind: "compaction",
+				content: typeof row.summary === "string" ? row.summary : "",
+				timestamp: parseTimestamp(row.at),
+				tokensBefore: row.tokensBefore,
+				tokensAfter: row.tokensAfter
+			});
+			continue;
+		}
+		const compactionSummaryRow = compactionSummaryRowToClientHistory(row);
+		if (compactionSummaryRow) {
+			out.push({
+				id,
+				...compactionSummaryRow
+			});
+			continue;
+		}
+		const contextRow = contextRowToClientHistory(row);
+		if (contextRow) {
+			out.push({
+				id,
+				...contextRow
+			});
+			continue;
+		}
+		const bashRow = bashRowToClientHistory(row);
+		if (bashRow) {
+			out.push({
+				id,
+				...bashRow
+			});
+			continue;
+		}
+		const customRow = customRowToClientHistory(row);
+		if (customRow) {
+			out.push({
+				id,
+				...customRow
+			});
+			continue;
+		}
+		const customStateRow = customStateRowToClientHistory(row);
+		if (customStateRow) {
+			out.push({
+				id,
+				...customStateRow
+			});
+			continue;
+		}
+		const branchSummaryRow = branchSummaryRowToClientHistory(row);
+		if (branchSummaryRow) {
+			out.push({
+				id,
+				...branchSummaryRow
+			});
+			continue;
+		}
+		const messageRow = asHistoryMessageRow(row);
+		if (!messageRow) continue;
+		if (messageRow.role === "tool" || messageRow.role === "toolResult") continue;
+		if (messageRow.role === "user" || messageRow.role === "system") {
+			out.push({
+				id,
+				role: messageRow.role,
+				kind: "message",
+				content: flattenMessageContent(messageRow.content ?? ""),
+				timestamp: parseTimestampValue(messageRow.timestamp)
+			});
+			continue;
+		}
+		out.push({
+			id,
+			role: "assistant",
+			kind: "message",
+			content: flattenMessageContent(messageRow.content ?? ""),
+			timestamp: parseTimestampValue(messageRow.timestamp),
+			toolCalls: toolCallsWithResults(messageRow.tool_calls ?? messageRow.toolCalls, results)
+		});
+	}
+	return out;
+}
 //#endregion
-export { flattenMessageContent, messagesToClientHistory };
+export { flattenMessageContent, messagesToClientHistory, transcriptRowsToClientHistory };
 
 //# sourceMappingURL=client-history.js.map