@xopcai/xopc 0.0.103 → 0.0.105

package/dist/src/notes/store.js

@@ -4,6 +4,7 @@ import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { buildNoteIndexMeta } from "./note-index-meta.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "../storage/sqlite/notes-repository.js";
+import { deleteNoteAgentContextRecord } from "../storage/sqlite/note-agent-context-repository.js";
 import "../storage/sqlite/index.js";
 import { resolveNoteHistoryDir, resolveNoteMediaDir } from "./paths.js";
 import { randomUUID } from "node:crypto";
@@ -46,6 +47,7 @@ var NotesStore = class {
 	async deleteNote(id) {
 		requireXopcDatabase();
 		if (!deleteNoteRecord(id)) return false;
+		deleteNoteAgentContextRecord(id);
 		await rm(resolveNoteMediaDir(id), {
 			recursive: true,
 			force: true

package/dist/src/notes/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","names":[],"sources":["../../../src/notes/store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { readFile, mkdir, writeFile, rm, readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  deleteNoteRecord,\n  getNoteRecord,\n  listNoteRecords,\n  requireXopcDatabase,\n  upsertNoteRecord,\n} from '../storage/sqlite/index.js';\nimport { buildNoteIndexMeta } from './note-index-meta.js';\nimport { resolveNoteMediaDir, resolveNoteHistoryDir } from './paths.js';\nimport type {\n  Note,\n  NoteIndexEntry,\n  NoteSnapshot,\n  NoteSnapshotEntry,\n  NotesListQuery,\n  SnapshotTrigger,\n} from './types.js';\n\nconst log = createLogger('NotesStore');\n\nexport class NotesStore {\n  private initialized = false;\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n    requireXopcDatabase();\n    this.initialized = true;\n    log.debug('NotesStore initialized');\n  }\n\n  async addNote(note: Note): Promise<void> {\n    requireXopcDatabase();\n    upsertNoteRecord(note);\n  }\n\n  async getNote(id: string): Promise<Note | null> {\n    requireXopcDatabase();\n    return getNoteRecord(id);\n  }\n\n  async updateNote(id: string, patch: Partial<Note>): Promise<Note | null> {\n    const existing = await this.getNote(id);\n    if (!existing) return null;\n\n    const updated: Note = {\n      ...existing,\n      ...patch,\n      id: existing.id,\n      createdAt: existing.createdAt,\n      updatedAt: Date.now(),\n    };\n\n    requireXopcDatabase();\n    upsertNoteRecord(updated);\n    return updated;\n  }\n\n  async deleteNote(id: string): Promise<boolean> {\n    requireXopcDatabase();\n    const deleted = deleteNoteRecord(id);\n    if (!deleted) {\n      return false;\n    }\n\n    const mediaDir = resolveNoteMediaDir(id);\n    await rm(mediaDir, { recursive: true, force: true }).catch(() => undefined);\n    return true;\n  }\n\n  async listNotes(query: NotesListQuery = {}): Promise<{\n    items: NoteIndexEntry[];\n    total: number;\n    limit: number;\n    offset: number;\n    hasMore: boolean;\n  }> {\n    requireXopcDatabase();\n    return listNoteRecords(query);\n  }\n\n  async saveAttachment(\n    noteId: string,\n    fileName: string,\n    buffer: Buffer,\n  ): Promise<{ relativePath: string; size: number }> {\n    const mediaDir = resolveNoteMediaDir(noteId);\n    await mkdir(mediaDir, { recursive: true });\n    const safeName = `${randomUUID().slice(0, 8)}_${fileName.replace(/[^a-zA-Z0-9._-]/g, '_')}`;\n    const filePath = join(mediaDir, safeName);\n    await writeFile(filePath, buffer);\n    return { relativePath: safeName, size: buffer.length };\n  }\n\n  resolveAttachmentPath(noteId: string, relativePath: string): string {\n    return join(resolveNoteMediaDir(noteId), relativePath);\n  }\n\n  async deleteAttachmentFile(noteId: string, relativePath: string): Promise<void> {\n    const filePath = this.resolveAttachmentPath(noteId, relativePath);\n    await rm(filePath, { force: true }).catch((err) => {\n      log.warn({ err, noteId, relativePath }, 'Failed to remove note attachment file');\n    });\n  }\n\n  async saveSnapshot(note: Note, trigger: SnapshotTrigger): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(note.id);\n    await mkdir(historyDir, { recursive: true });\n    const snapshot: NoteSnapshot = {\n      noteId: note.id,\n      timestamp: Date.now(),\n      trigger,\n      title: note.title,\n      markdown: note.markdown,\n      tags: note.tags,\n      kind: note.kind,\n      status: note.status,\n    };\n    const filePath = join(historyDir, `${snapshot.timestamp}.json`);\n    await writeTextAtomic(filePath, JSON.stringify(snapshot, null, 2));\n    log.debug({ noteId: note.id, trigger, timestamp: snapshot.timestamp }, 'Snapshot saved');\n  }\n\n  async listSnapshots(noteId: string): Promise<NoteSnapshotEntry[]> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return [];\n    }\n    const entries: NoteSnapshotEntry[] = [];\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const timestamp = parseInt(file.slice(0, -'.json'.length), 10);\n      if (!Number.isFinite(timestamp)) continue;\n      try {\n        const content = await readFile(join(historyDir, file), 'utf-8');\n        const snapshot = JSON.parse(content) as NoteSnapshot;\n        const rawText = snapshot.markdown ?? '';\n        entries.push({\n          timestamp: snapshot.timestamp,\n          trigger: snapshot.trigger,\n          snippet: rawText.slice(0, 80) || undefined,\n        });\n      } catch {\n        log.debug({ noteId, file }, 'Skipped unreadable snapshot');\n      }\n    }\n    entries.sort((a, b) => b.timestamp - a.timestamp);\n    return entries;\n  }\n\n  async getSnapshot(noteId: string, timestamp: number): Promise<NoteSnapshot | null> {\n    const filePath = join(resolveNoteHistoryDir(noteId), `${timestamp}.json`);\n    try {\n      const content = await readFile(filePath, 'utf-8');\n      return JSON.parse(content) as NoteSnapshot;\n    } catch {\n      return null;\n    }\n  }\n\n  async pruneSnapshots(noteId: string, maxCount: number): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return;\n    }\n    const jsonFiles = files.filter((f) => f.endsWith('.json')).sort();\n    if (jsonFiles.length <= maxCount) return;\n    const toDelete = jsonFiles.slice(0, jsonFiles.length - maxCount);\n    for (const file of toDelete) {\n      await rm(join(historyDir, file), { force: true }).catch(() => undefined);\n    }\n    log.debug({ noteId, deleted: toDelete.length }, 'Pruned old snapshots');\n  }\n\n  async deleteAllSnapshots(noteId: string): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    await rm(historyDir, { recursive: true, force: true }).catch(() => undefined);\n  }\n\n  /** No-op: SQLite writes are synchronous. Kept for API compatibility with tests. */\n  async flush(): Promise<void> {}\n}\n\nexport { buildNoteIndexMeta };\n"],"mappings":"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"}
+{"version":3,"file":"store.js","names":[],"sources":["../../../src/notes/store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { readFile, mkdir, writeFile, rm, readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  deleteNoteAgentContextRecord,\n  deleteNoteRecord,\n  getNoteRecord,\n  listNoteRecords,\n  requireXopcDatabase,\n  upsertNoteRecord,\n} from '../storage/sqlite/index.js';\nimport { buildNoteIndexMeta } from './note-index-meta.js';\nimport { resolveNoteMediaDir, resolveNoteHistoryDir } from './paths.js';\nimport type {\n  Note,\n  NoteIndexEntry,\n  NoteSnapshot,\n  NoteSnapshotEntry,\n  NotesListQuery,\n  SnapshotTrigger,\n} from './types.js';\n\nconst log = createLogger('NotesStore');\n\nexport class NotesStore {\n  private initialized = false;\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n    requireXopcDatabase();\n    this.initialized = true;\n    log.debug('NotesStore initialized');\n  }\n\n  async addNote(note: Note): Promise<void> {\n    requireXopcDatabase();\n    upsertNoteRecord(note);\n  }\n\n  async getNote(id: string): Promise<Note | null> {\n    requireXopcDatabase();\n    return getNoteRecord(id);\n  }\n\n  async updateNote(id: string, patch: Partial<Note>): Promise<Note | null> {\n    const existing = await this.getNote(id);\n    if (!existing) return null;\n\n    const updated: Note = {\n      ...existing,\n      ...patch,\n      id: existing.id,\n      createdAt: existing.createdAt,\n      updatedAt: Date.now(),\n    };\n\n    requireXopcDatabase();\n    upsertNoteRecord(updated);\n    return updated;\n  }\n\n  async deleteNote(id: string): Promise<boolean> {\n    requireXopcDatabase();\n    const deleted = deleteNoteRecord(id);\n    if (!deleted) {\n      return false;\n    }\n\n    deleteNoteAgentContextRecord(id);\n    const mediaDir = resolveNoteMediaDir(id);\n    await rm(mediaDir, { recursive: true, force: true }).catch(() => undefined);\n    return true;\n  }\n\n  async listNotes(query: NotesListQuery = {}): Promise<{\n    items: NoteIndexEntry[];\n    total: number;\n    limit: number;\n    offset: number;\n    hasMore: boolean;\n  }> {\n    requireXopcDatabase();\n    return listNoteRecords(query);\n  }\n\n  async saveAttachment(\n    noteId: string,\n    fileName: string,\n    buffer: Buffer,\n  ): Promise<{ relativePath: string; size: number }> {\n    const mediaDir = resolveNoteMediaDir(noteId);\n    await mkdir(mediaDir, { recursive: true });\n    const safeName = `${randomUUID().slice(0, 8)}_${fileName.replace(/[^a-zA-Z0-9._-]/g, '_')}`;\n    const filePath = join(mediaDir, safeName);\n    await writeFile(filePath, buffer);\n    return { relativePath: safeName, size: buffer.length };\n  }\n\n  resolveAttachmentPath(noteId: string, relativePath: string): string {\n    return join(resolveNoteMediaDir(noteId), relativePath);\n  }\n\n  async deleteAttachmentFile(noteId: string, relativePath: string): Promise<void> {\n    const filePath = this.resolveAttachmentPath(noteId, relativePath);\n    await rm(filePath, { force: true }).catch((err) => {\n      log.warn({ err, noteId, relativePath }, 'Failed to remove note attachment file');\n    });\n  }\n\n  async saveSnapshot(note: Note, trigger: SnapshotTrigger): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(note.id);\n    await mkdir(historyDir, { recursive: true });\n    const snapshot: NoteSnapshot = {\n      noteId: note.id,\n      timestamp: Date.now(),\n      trigger,\n      title: note.title,\n      markdown: note.markdown,\n      tags: note.tags,\n      kind: note.kind,\n      status: note.status,\n    };\n    const filePath = join(historyDir, `${snapshot.timestamp}.json`);\n    await writeTextAtomic(filePath, JSON.stringify(snapshot, null, 2));\n    log.debug({ noteId: note.id, trigger, timestamp: snapshot.timestamp }, 'Snapshot saved');\n  }\n\n  async listSnapshots(noteId: string): Promise<NoteSnapshotEntry[]> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return [];\n    }\n    const entries: NoteSnapshotEntry[] = [];\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const timestamp = parseInt(file.slice(0, -'.json'.length), 10);\n      if (!Number.isFinite(timestamp)) continue;\n      try {\n        const content = await readFile(join(historyDir, file), 'utf-8');\n        const snapshot = JSON.parse(content) as NoteSnapshot;\n        const rawText = snapshot.markdown ?? '';\n        entries.push({\n          timestamp: snapshot.timestamp,\n          trigger: snapshot.trigger,\n          snippet: rawText.slice(0, 80) || undefined,\n        });\n      } catch {\n        log.debug({ noteId, file }, 'Skipped unreadable snapshot');\n      }\n    }\n    entries.sort((a, b) => b.timestamp - a.timestamp);\n    return entries;\n  }\n\n  async getSnapshot(noteId: string, timestamp: number): Promise<NoteSnapshot | null> {\n    const filePath = join(resolveNoteHistoryDir(noteId), `${timestamp}.json`);\n    try {\n      const content = await readFile(filePath, 'utf-8');\n      return JSON.parse(content) as NoteSnapshot;\n    } catch {\n      return null;\n    }\n  }\n\n  async pruneSnapshots(noteId: string, maxCount: number): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return;\n    }\n    const jsonFiles = files.filter((f) => f.endsWith('.json')).sort();\n    if (jsonFiles.length <= maxCount) return;\n    const toDelete = jsonFiles.slice(0, jsonFiles.length - maxCount);\n    for (const file of toDelete) {\n      await rm(join(historyDir, file), { force: true }).catch(() => undefined);\n    }\n    log.debug({ noteId, deleted: toDelete.length }, 'Pruned old snapshots');\n  }\n\n  async deleteAllSnapshots(noteId: string): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    await rm(historyDir, { recursive: true, force: true }).catch(() => undefined);\n  }\n\n  /** No-op: SQLite writes are synchronous. Kept for API compatibility with tests. */\n  async flush(): Promise<void> {}\n}\n\nexport { buildNoteIndexMeta };\n"],"mappings":"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"}

package/dist/src/project-trust/trust-store.d.ts

@@ -0,0 +1,30 @@
+export type ProjectTrustDecision = boolean | null;
+export interface ProjectTrustStoreEntry {
+    path: string;
+    decision: boolean;
+}
+export interface ProjectTrustUpdate {
+    path: string;
+    decision: ProjectTrustDecision;
+}
+export interface ProjectTrustOption {
+    label: string;
+    trusted: boolean;
+    updates: ProjectTrustUpdate[];
+    savedPath?: string;
+}
+export declare function resolveProjectTrustStorePath(): string;
+export declare function getProjectTrustParentPath(cwd: string): string | undefined;
+export declare function getProjectTrustOptions(cwd: string, options?: {
+    includeSessionOnly?: boolean;
+}): ProjectTrustOption[];
+export declare function hasTrustRequiringProjectResources(cwd: string): boolean;
+export declare class ProjectTrustStore {
+    private readonly trustPath;
+    constructor(trustPath?: string);
+    getPath(): string;
+    get(cwd: string): ProjectTrustDecision;
+    getEntry(cwd: string): ProjectTrustStoreEntry | null;
+    set(cwd: string, decision: ProjectTrustDecision): void;
+    setMany(decisions: ProjectTrustUpdate[]): void;
+}

package/dist/src/project-trust/trust-store.js

@@ -0,0 +1,194 @@
+import { resolveStateDir } from "../config/paths-state.js";
+import { init_paths } from "../config/paths.js";
+import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+import lockfile from "proper-lockfile";
+//#region src/project-trust/trust-store.ts
+init_paths();
+const TRUST_REQUIRING_XOPC_PROJECT_RESOURCES = [
+	"settings.json",
+	"extensions",
+	"skills",
+	"prompts",
+	"themes",
+	"SYSTEM.md",
+	"APPEND_SYSTEM.md",
+	"workspace.json"
+];
+function canonicalizePath(path) {
+	const resolved = resolve(path);
+	try {
+		return realpathSync.native(resolved);
+	} catch {
+		return resolved;
+	}
+}
+function normalizeCwd(cwd) {
+	return canonicalizePath(cwd);
+}
+function readTrustFile(path) {
+	if (!existsSync(path)) return {};
+	let parsed;
+	try {
+		parsed = JSON.parse(readFileSync(path, "utf8"));
+	} catch (err) {
+		const errorMessage = err instanceof Error ? err.message : String(err);
+		throw new Error(`Failed to read project trust store ${path}: ${errorMessage}`);
+	}
+	if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new Error(`Invalid project trust store ${path}: expected an object`);
+	const data = {};
+	for (const [key, value] of Object.entries(parsed)) {
+		if (value !== true && value !== false && value !== null) throw new Error(`Invalid project trust store ${path}: value for ${JSON.stringify(key)} must be true, false, or null`);
+		data[normalizeCwd(key)] = value;
+	}
+	return data;
+}
+function writeTrustFile(path, data) {
+	const sorted = {};
+	for (const key of Object.keys(data).sort()) {
+		const value = data[key];
+		if (value === true || value === false || value === null) sorted[key] = value;
+	}
+	mkdirSync(dirname(path), { recursive: true });
+	writeFileSync(path, `${JSON.stringify(sorted, null, 2)}\n`, "utf8");
+}
+function acquireTrustLockSync(path) {
+	const trustDir = dirname(path);
+	mkdirSync(trustDir, { recursive: true });
+	const maxAttempts = 10;
+	const delayMs = 20;
+	for (let attempt = 1; attempt <= maxAttempts; attempt++) try {
+		return lockfile.lockSync(trustDir, {
+			realpath: false,
+			lockfilePath: `${path}.lock`
+		});
+	} catch (err) {
+		if ((typeof err === "object" && err !== null && "code" in err ? String(err.code) : void 0) !== "ELOCKED" || attempt === maxAttempts) throw err;
+		const startedAt = Date.now();
+		while (Date.now() - startedAt < delayMs);
+	}
+	throw new Error("Failed to acquire project trust store lock");
+}
+function withTrustFileLock(path, fn) {
+	const release = acquireTrustLockSync(path);
+	try {
+		return fn();
+	} finally {
+		release();
+	}
+}
+function findNearestTrustEntry(data, cwd) {
+	let currentDir = normalizeCwd(cwd);
+	while (true) {
+		const value = data[currentDir];
+		if (value === true || value === false) return {
+			path: currentDir,
+			decision: value
+		};
+		const parentDir = dirname(currentDir);
+		if (parentDir === currentDir) return null;
+		currentDir = parentDir;
+	}
+}
+function resolveProjectTrustStorePath() {
+	return join(resolveStateDir(), "trust.json");
+}
+function getProjectTrustParentPath(cwd) {
+	const trustPath = normalizeCwd(cwd);
+	const parentDir = dirname(trustPath);
+	return parentDir === trustPath ? void 0 : parentDir;
+}
+function getProjectTrustOptions(cwd, options = {}) {
+	const trustPath = normalizeCwd(cwd);
+	const trustOptions = [{
+		label: "Trust",
+		trusted: true,
+		updates: [{
+			path: trustPath,
+			decision: true
+		}],
+		savedPath: trustPath
+	}];
+	const parentPath = getProjectTrustParentPath(cwd);
+	if (parentPath) trustOptions.push({
+		label: `Trust parent folder (${parentPath})`,
+		trusted: true,
+		updates: [{
+			path: parentPath,
+			decision: true
+		}, {
+			path: trustPath,
+			decision: null
+		}],
+		savedPath: parentPath
+	});
+	if (options.includeSessionOnly) trustOptions.push({
+		label: "Trust (this session only)",
+		trusted: true,
+		updates: []
+	});
+	trustOptions.push({
+		label: "Do not trust",
+		trusted: false,
+		updates: [{
+			path: trustPath,
+			decision: false
+		}],
+		savedPath: trustPath
+	});
+	if (options.includeSessionOnly) trustOptions.push({
+		label: "Do not trust (this session only)",
+		trusted: false,
+		updates: []
+	});
+	return trustOptions;
+}
+function hasTrustRequiringProjectResources(cwd) {
+	const userAgentsSkillsDir = join(canonicalizePath(process.env.HOME || homedir()), ".agents", "skills");
+	let currentDir = canonicalizePath(cwd);
+	const xopcProjectDir = join(currentDir, ".xopc");
+	if (TRUST_REQUIRING_XOPC_PROJECT_RESOURCES.some((entry) => existsSync(join(xopcProjectDir, entry)))) return true;
+	while (true) {
+		const agentsSkillsDir = join(currentDir, ".agents", "skills");
+		if (agentsSkillsDir !== userAgentsSkillsDir && existsSync(agentsSkillsDir)) return true;
+		const parentDir = dirname(currentDir);
+		if (parentDir === currentDir) return false;
+		currentDir = parentDir;
+	}
+}
+var ProjectTrustStore = class {
+	constructor(trustPath = resolveProjectTrustStorePath()) {
+		this.trustPath = trustPath;
+	}
+	getPath() {
+		return this.trustPath;
+	}
+	get(cwd) {
+		return this.getEntry(cwd)?.decision ?? null;
+	}
+	getEntry(cwd) {
+		return withTrustFileLock(this.trustPath, () => findNearestTrustEntry(readTrustFile(this.trustPath), cwd));
+	}
+	set(cwd, decision) {
+		this.setMany([{
+			path: cwd,
+			decision
+		}]);
+	}
+	setMany(decisions) {
+		withTrustFileLock(this.trustPath, () => {
+			const data = readTrustFile(this.trustPath);
+			for (const { path, decision } of decisions) {
+				const key = normalizeCwd(path);
+				if (decision === null) delete data[key];
+				else data[key] = decision;
+			}
+			writeTrustFile(this.trustPath, data);
+		});
+	}
+};
+//#endregion
+export { ProjectTrustStore, getProjectTrustOptions, getProjectTrustParentPath, hasTrustRequiringProjectResources, resolveProjectTrustStorePath };
+
+//# sourceMappingURL=trust-store.js.map

package/dist/src/project-trust/trust-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-store.js","names":["resolvePath"],"sources":["../../../src/project-trust/trust-store.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { dirname, join, resolve as resolvePath } from 'node:path';\n\nimport lockfile from 'proper-lockfile';\n\nimport { resolveStateDir } from '../config/paths.js';\n\nexport type ProjectTrustDecision = boolean | null;\n\nexport interface ProjectTrustStoreEntry {\n  path: string;\n  decision: boolean;\n}\n\nexport interface ProjectTrustUpdate {\n  path: string;\n  decision: ProjectTrustDecision;\n}\n\nexport interface ProjectTrustOption {\n  label: string;\n  trusted: boolean;\n  updates: ProjectTrustUpdate[];\n  savedPath?: string;\n}\n\ntype TrustFile = Record<string, boolean | null | undefined>;\n\nconst TRUST_REQUIRING_XOPC_PROJECT_RESOURCES = [\n  'settings.json',\n  'extensions',\n  'skills',\n  'prompts',\n  'themes',\n  'SYSTEM.md',\n  'APPEND_SYSTEM.md',\n  'workspace.json',\n] as const;\n\nfunction canonicalizePath(path: string): string {\n  const resolved = resolvePath(path);\n  try {\n    return realpathSync.native(resolved);\n  } catch {\n    return resolved;\n  }\n}\n\nfunction normalizeCwd(cwd: string): string {\n  return canonicalizePath(cwd);\n}\n\nfunction readTrustFile(path: string): TrustFile {\n  if (!existsSync(path)) return {};\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(readFileSync(path, 'utf8'));\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to read project trust store ${path}: ${errorMessage}`);\n  }\n\n  if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n    throw new Error(`Invalid project trust store ${path}: expected an object`);\n  }\n\n  const data: TrustFile = {};\n  for (const [key, value] of Object.entries(parsed)) {\n    if (value !== true && value !== false && value !== null) {\n      throw new Error(`Invalid project trust store ${path}: value for ${JSON.stringify(key)} must be true, false, or null`);\n    }\n    data[normalizeCwd(key)] = value;\n  }\n  return data;\n}\n\nfunction writeTrustFile(path: string, data: TrustFile): void {\n  const sorted: TrustFile = {};\n  for (const key of Object.keys(data).sort()) {\n    const value = data[key];\n    if (value === true || value === false || value === null) {\n      sorted[key] = value;\n    }\n  }\n  mkdirSync(dirname(path), { recursive: true });\n  writeFileSync(path, `${JSON.stringify(sorted, null, 2)}\\n`, 'utf8');\n}\n\nfunction acquireTrustLockSync(path: string): () => void {\n  const trustDir = dirname(path);\n  mkdirSync(trustDir, { recursive: true });\n  const maxAttempts = 10;\n  const delayMs = 20;\n\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return lockfile.lockSync(trustDir, { realpath: false, lockfilePath: `${path}.lock` });\n    } catch (err) {\n      const code =\n        typeof err === 'object' && err !== null && 'code' in err\n          ? String((err as { code?: unknown }).code)\n          : undefined;\n      if (code !== 'ELOCKED' || attempt === maxAttempts) {\n        throw err;\n      }\n      const startedAt = Date.now();\n      while (Date.now() - startedAt < delayMs) {\n        // Synchronous callers need a tiny bounded wait while another TUI updates trust.json.\n      }\n    }\n  }\n\n  throw new Error('Failed to acquire project trust store lock');\n}\n\nfunction withTrustFileLock<T>(path: string, fn: () => T): T {\n  const release = acquireTrustLockSync(path);\n  try {\n    return fn();\n  } finally {\n    release();\n  }\n}\n\nfunction findNearestTrustEntry(data: TrustFile, cwd: string): ProjectTrustStoreEntry | null {\n  let currentDir = normalizeCwd(cwd);\n  while (true) {\n    const value = data[currentDir];\n    if (value === true || value === false) {\n      return { path: currentDir, decision: value };\n    }\n\n    const parentDir = dirname(currentDir);\n    if (parentDir === currentDir) return null;\n    currentDir = parentDir;\n  }\n}\n\nexport function resolveProjectTrustStorePath(): string {\n  return join(resolveStateDir(), 'trust.json');\n}\n\nexport function getProjectTrustParentPath(cwd: string): string | undefined {\n  const trustPath = normalizeCwd(cwd);\n  const parentDir = dirname(trustPath);\n  return parentDir === trustPath ? undefined : parentDir;\n}\n\nexport function getProjectTrustOptions(\n  cwd: string,\n  options: { includeSessionOnly?: boolean } = {},\n): ProjectTrustOption[] {\n  const trustPath = normalizeCwd(cwd);\n  const trustOptions: ProjectTrustOption[] = [\n    { label: 'Trust', trusted: true, updates: [{ path: trustPath, decision: true }], savedPath: trustPath },\n  ];\n  const parentPath = getProjectTrustParentPath(cwd);\n  if (parentPath) {\n    trustOptions.push({\n      label: `Trust parent folder (${parentPath})`,\n      trusted: true,\n      updates: [\n        { path: parentPath, decision: true },\n        { path: trustPath, decision: null },\n      ],\n      savedPath: parentPath,\n    });\n  }\n  if (options.includeSessionOnly) {\n    trustOptions.push({ label: 'Trust (this session only)', trusted: true, updates: [] });\n  }\n  trustOptions.push({\n    label: 'Do not trust',\n    trusted: false,\n    updates: [{ path: trustPath, decision: false }],\n    savedPath: trustPath,\n  });\n  if (options.includeSessionOnly) {\n    trustOptions.push({ label: 'Do not trust (this session only)', trusted: false, updates: [] });\n  }\n  return trustOptions;\n}\n\nexport function hasTrustRequiringProjectResources(cwd: string): boolean {\n  const homeDir = canonicalizePath(process.env.HOME || homedir());\n  const userAgentsSkillsDir = join(homeDir, '.agents', 'skills');\n  let currentDir = canonicalizePath(cwd);\n\n  const xopcProjectDir = join(currentDir, '.xopc');\n  if (TRUST_REQUIRING_XOPC_PROJECT_RESOURCES.some((entry) => existsSync(join(xopcProjectDir, entry)))) {\n    return true;\n  }\n\n  while (true) {\n    const agentsSkillsDir = join(currentDir, '.agents', 'skills');\n    if (agentsSkillsDir !== userAgentsSkillsDir && existsSync(agentsSkillsDir)) {\n      return true;\n    }\n\n    const parentDir = dirname(currentDir);\n    if (parentDir === currentDir) return false;\n    currentDir = parentDir;\n  }\n}\n\nexport class ProjectTrustStore {\n  constructor(private readonly trustPath: string = resolveProjectTrustStorePath()) {}\n\n  getPath(): string {\n    return this.trustPath;\n  }\n\n  get(cwd: string): ProjectTrustDecision {\n    return this.getEntry(cwd)?.decision ?? null;\n  }\n\n  getEntry(cwd: string): ProjectTrustStoreEntry | null {\n    return withTrustFileLock(this.trustPath, () => findNearestTrustEntry(readTrustFile(this.trustPath), cwd));\n  }\n\n  set(cwd: string, decision: ProjectTrustDecision): void {\n    this.setMany([{ path: cwd, decision }]);\n  }\n\n  setMany(decisions: ProjectTrustUpdate[]): void {\n    withTrustFileLock(this.trustPath, () => {\n      const data = readTrustFile(this.trustPath);\n      for (const { path, decision } of decisions) {\n        const key = normalizeCwd(path);\n        if (decision === null) {\n          delete data[key];\n        } else {\n          data[key] = decision;\n        }\n      }\n      writeTrustFile(this.trustPath, data);\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/src/providers/index.d.ts

@@ -60,7 +60,7 @@ export declare function providerSupportsApiKey(provider: string): boolean;
 /**
  * Get a default model reference.
  * Priority:
- * 1. Explicitly configured model in agents.defaults.model (if set and available)
+ * 1. Explicitly configured model in agents.defaults.models.chat (if set and available)
  * 2. Default fallback: openai/gpt-5.5
  */
 export declare function getDefaultModel(config?: Config | null | undefined): Promise<string>;

package/dist/src/providers/index.js

@@ -216,8 +216,19 @@ async function getAvailableModels() {
 	const allModels = getAllModels();
 	const pluginRegistry = getProviderRegistry();
 	const available = [];
-	for (const model of allModels) if (pluginRegistry.has(model.provider)) available.push(model);
-	else if (await isProviderConfigured(model.provider)) available.push(model);
+	const configuredByProvider = /* @__PURE__ */ new Map();
+	for (const model of allModels) {
+		if (pluginRegistry.has(model.provider)) {
+			available.push(model);
+			continue;
+		}
+		let configured = configuredByProvider.get(model.provider);
+		if (configured === void 0) {
+			configured = await isProviderConfigured(model.provider);
+			configuredByProvider.set(model.provider, configured);
+		}
+		if (configured) available.push(model);
+	}
 	return available;
 }
 function getSortedProviders() {
@@ -251,13 +262,13 @@ function providerSupportsApiKey(provider) {
 /**
 * Get a default model reference.
 * Priority:
-* 1. Explicitly configured model in agents.defaults.model (if set and available)
+* 1. Explicitly configured model in agents.defaults.models.chat (if set and available)
 * 2. Default fallback: openai/gpt-5.5
 */
 async function getDefaultModel(config) {
-	const defaultModel = config?.agents?.defaults?.model;
+	const defaultModel = config?.agents?.defaults?.models?.chat;
 	if (defaultModel) {
-		const modelRef = typeof defaultModel === "string" ? defaultModel : defaultModel.primary;
+		const modelRef = defaultModel.primary;
 		if (modelRef) {
 			const configured = (await getAvailableModels()).find((m) => `${m.provider}/${m.id}` === modelRef || m.id === modelRef);
 			if (configured) return `${configured.provider}/${configured.id}`;
@@ -275,9 +286,9 @@ async function getDefaultModel(config) {
 * full catalog.
 */
 function getDefaultModelSync(config) {
-	const defaultModel = config?.agents?.defaults?.model;
+	const defaultModel = config?.agents?.defaults?.models?.chat;
 	if (defaultModel) {
-		const modelRef = typeof defaultModel === "string" ? defaultModel : defaultModel.primary;
+		const modelRef = defaultModel.primary;
 		if (modelRef) return modelRef;
 	}
 	return DEFAULT_FALLBACK_MODEL;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["getPiAiModel","getPiAiProviders","getPiAiModels"],"sources":["../../../src/providers/index.ts"],"sourcesContent":["/**\n * Model provider module - integrates built-in models with custom models from models.json\n */\n\nimport {\n\tgetModel as getPiAiModel,\n\tgetModels as getPiAiModels,\n\tgetProviders as getPiAiProviders,\n\ttype Model,\n\ttype Api,\n} from '@earendil-works/pi-ai';\nimport type { Config } from '../config/schema.js';\nimport { getModelRegistry } from './model-registry.js';\nimport { CredentialResolver, resolveApiKey, hasCredentials } from '../auth/credentials.js';\nimport { hasProviderAuthOnDiskSync } from '../auth/sync-provider-auth.js';\nimport { getApiKeyFromEnv } from './env-keys.js';\nimport { getProviderRegistry } from './plugin-registry.js';\nimport type { ProviderModelDefinition } from '../extensions/types/providers.js';\n\nexport { getApiKeyFromEnv, PROVIDER_ENV_MAP } from './env-keys.js';\n\n/** Sentinel base URL: model is served by an extension {@link ProviderPluginRegistry} provider. */\nexport const EXTENSION_PROVIDER_BASE_URL = 'extension://provider-plugin';\nconst OPENAI_CODEX_CANONICAL_BASE_URL = 'https://chatgpt.com/backend-api/codex';\n\nfunction normalizeProviderModel(model: Model<Api>): Model<Api> {\n\tif (model.provider === 'openai-codex' && model.api === 'openai-codex-responses') {\n\t\treturn { ...model, baseUrl: OPENAI_CODEX_CANONICAL_BASE_URL } as Model<Api>;\n\t}\n\treturn model;\n}\n\n/** Map a plugin registry model to the pi-ai {@link Model} shape. */\nexport function pluginModelToModel(providerId: string, definition: ProviderModelDefinition): Model<Api> {\n\treturn {\n\t\tprovider: providerId,\n\t\tid: definition.id,\n\t\tname: definition.name,\n\t\tapi: 'openai-completions' as Api,\n\t\tbaseUrl: EXTENSION_PROVIDER_BASE_URL,\n\t\treasoning: false,\n\t\tinput: definition.supportsImages ? (['text', 'image'] as ('text' | 'image')[]) : (['text'] as ('text' | 'image')[]),\n\t\tcontextWindow: definition.contextWindow ?? 128000,\n\t\tmaxTokens: definition.maxOutputTokens ?? 4096,\n\t\tcost: {\n\t\t\tinput: definition.pricing?.input ?? 0,\n\t\t\toutput: definition.pricing?.output ?? 0,\n\t\t\tcacheRead: 0,\n\t\t\tcacheWrite: 0,\n\t\t},\n\t} as Model<Api>;\n}\n\n/**\n * Get API key synchronously: checks registry (models.json) first, then environment variables.\n * Use this for Agent's getApiKey callback which must be synchronous.\n */\nexport function getApiKeySync(provider: string): string | undefined {\n  const pluginRegistry = getProviderRegistry();\n  if (pluginRegistry.has(provider)) return 'extension-managed';\n\n  const registry = getModelRegistry();\n  const registryKey = registry.getApiKey(provider);\n  if (registryKey) {\n    return registryKey;\n  }\n  return getApiKeyFromEnv(provider);\n}\n\n/**\n * Resolve model reference. Supports:\n * - \"provider/modelId\" format\n * - \"modelId\" auto-detection via pi-ai or custom models\n * @throws if model not found\n */\nexport function resolveModel(ref: string): Model<Api> {\n\t// First try ModelRegistry (includes custom models)\n\tconst registry = getModelRegistry();\n\tconst customModel = registry.resolve(ref);\n\tif (customModel) {\n\t\treturn customModel;\n\t}\n\n\tif (ref.includes('/')) {\n\t\tconst [provider, modelId] = ref.split('/');\n\t\tconst piAiModel = getPiAiModel(provider as any, modelId as any);\n\t\tif (piAiModel) return normalizeProviderModel(piAiModel as Model<Api>);\n\n\t\tconst pluginRegistry = getProviderRegistry();\n\t\tconst plugin = pluginRegistry.get(provider);\n\t\tif (plugin) {\n\t\t\tconst pluginModel = plugin.models.find(m => m.id === modelId);\n\t\t\tif (pluginModel) return pluginModelToModel(provider, pluginModel);\n\t\t}\n\t\tthrow new Error(`Model not found: ${ref}`);\n\t}\n\n\tfor (const provider of getPiAiProviders()) {\n\t\ttry {\n\t\t\tconst models = getPiAiModels(provider);\n\t\t\tconst found = models.find(m => m.id === ref);\n\t\t\tif (found) return normalizeProviderModel(found as Model<Api>);\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t}\n\n\tconst pluginRegistry = getProviderRegistry();\n\tfor (const plugin of pluginRegistry.listAll()) {\n\t\tconst found = plugin.models.find(m => m.id === ref);\n\t\tif (found) return pluginModelToModel(plugin.id, found);\n\t}\n\n\tthrow new Error(`Model not found: ${ref}. Use format: provider/model-id`);\n}\n\nexport function getModelsByProvider(provider: string): readonly Model<Api>[] {\n\tconst registry = getModelRegistry();\n\tconst fromRegistry = registry.getAll().filter(m => m.provider === provider).map(normalizeProviderModel);\n\tconst plugin = getProviderRegistry().get(provider);\n\tif (!plugin) return fromRegistry;\n\tconst pluginModels = plugin.models.map(m => pluginModelToModel(provider, m));\n\treturn [...fromRegistry, ...pluginModels];\n}\n\nexport function getAllProviders(): string[] {\n\tconst registry = getModelRegistry();\n\tconst providers = new Set<string>();\n\n\t// Add built-in providers\n\tfor (const p of getPiAiProviders()) {\n\t\tproviders.add(p);\n\t}\n\n\t// Add custom providers from registry\n\tfor (const m of registry.getAll()) {\n\t\tproviders.add(m.provider);\n\t}\n\n\tfor (const plugin of getProviderRegistry().listAll()) {\n\t\tproviders.add(plugin.id);\n\t}\n\n\treturn Array.from(providers);\n}\n\nexport async function getApiKey(provider: string): Promise<string | undefined> {\n\tif (getProviderRegistry().has(provider)) return 'extension-managed';\n\n\t// Use new credential resolver first (checks: agent private > global > oauth > env)\n\tconst credentialKey = await resolveApiKey(provider);\n\tif (credentialKey) {\n\t\treturn credentialKey;\n\t}\n\n\t// Check registry for custom providers (from models.json)\n\tconst registry = getModelRegistry();\n\tconst registryKey = registry.getApiKey(provider);\n\tif (registryKey) {\n\t\treturn registryKey;\n\t}\n\n\t// Fallback to environment variables\n\treturn getApiKeyFromEnv(provider);\n}\n\n/**\n * Synchronous version for use in non-async contexts\n * Only checks environment variables and registry, not credential system\n */\nexport function isProviderConfiguredSync(provider: string): boolean {\n\tif (getProviderRegistry().has(provider)) return true;\n\n\t// Check registry for custom providers\n\tconst registry = getModelRegistry();\n\tif (registry.getApiKey(provider)) {\n\t\treturn true;\n\t}\n\t// Check environment variables\n\tif (getApiKeyFromEnv(provider)) {\n\t\treturn true;\n\t}\n\t// Gateway UI / CLI store keys in auth-profiles.json (async CredentialResolver); sync path for fallback list\n\treturn hasProviderAuthOnDiskSync(provider);\n}\n\nexport async function isProviderConfigured(provider: string): Promise<boolean> {\n  if (getProviderRegistry().has(provider)) return true;\n\n  // Check registry first for custom providers (from models.json)\n  const registry = getModelRegistry();\n  if (registry.getApiKey(provider)) {\n    return true;\n  }\n  return await hasCredentials(provider);\n}\n\n/** Where runtime {@link getApiKey} resolves the key from (no secret values). */\nexport type ProviderActiveKeySource = 'none' | 'agent' | 'gateway' | 'oauth' | 'env' | 'models_json' | 'extension';\n\nexport type ProviderAuthMode = ProviderActiveKeySource;\nexport type ProviderAuthStatus = 'connected' | 'expired' | 'not_connected';\n\nexport interface ProviderAuthState {\n  authMode: ProviderAuthMode;\n  authStatus: ProviderAuthStatus;\n  expiresAt?: number;\n}\n\nexport async function getProviderActiveKeySource(provider: string): Promise<ProviderActiveKeySource> {\n  const authState = await getProviderAuthState(provider);\n  return authState.authMode;\n}\n\nexport async function getProviderAuthState(provider: string): Promise<ProviderAuthState> {\n  if (getProviderRegistry().has(provider)) {\n    return { authMode: 'extension', authStatus: 'connected' };\n  }\n\n  const resolver = new CredentialResolver();\n  const fromCredentials = await resolver.resolveApiKeySource(provider);\n  if (fromCredentials === 'agent') return { authMode: 'agent', authStatus: 'connected' };\n  if (fromCredentials === 'global') return { authMode: 'gateway', authStatus: 'connected' };\n  if (fromCredentials === 'oauth') {\n    const token = await resolver.loadOAuthTokenRecord(provider);\n    const expired = Boolean(token?.expiresAt && token.expiresAt < Date.now());\n    return {\n      authMode: 'oauth',\n      authStatus: expired ? 'expired' : 'connected',\n      ...(token?.expiresAt ? { expiresAt: token.expiresAt } : {}),\n    };\n  }\n  if (fromCredentials === 'env') return { authMode: 'env', authStatus: 'connected' };\n\n  const expiredOAuthToken = await resolver.loadOAuthTokenRecord(provider);\n  if (expiredOAuthToken?.expiresAt && expiredOAuthToken.expiresAt < Date.now()) {\n    return {\n      authMode: 'oauth',\n      authStatus: 'expired',\n      expiresAt: expiredOAuthToken.expiresAt,\n    };\n  }\n\n  const registry = getModelRegistry();\n  if (registry.getApiKey(provider)) {\n    return { authMode: 'models_json', authStatus: 'connected' };\n  }\n\n  return { authMode: 'none', authStatus: 'not_connected' };\n}\n\nexport async function getConfiguredProviders(): Promise<string[]> {\n\tconst allProviders = getAllProviders();\n\tconst configured: string[] = [];\n\tfor (const p of allProviders) {\n\t\tif (await isProviderConfigured(p)) {\n\t\t\tconfigured.push(p);\n\t\t}\n\t}\n\treturn configured;\n}\n\nexport function getAllModels(): readonly Model<Api>[] {\n\tconst registry = getModelRegistry();\n\tconst registryModels = registry.getAll().map(normalizeProviderModel);\n\tconst pluginProviders = getProviderRegistry().listAll();\n\tif (pluginProviders.length === 0) return registryModels;\n\n\tconst existingIds = new Set(registryModels.map(m => `${m.provider}/${m.id}`));\n\tconst merged: Model<Api>[] = [...registryModels];\n\tfor (const plugin of pluginProviders) {\n\t\tfor (const model of plugin.models) {\n\t\t\tconst compositeId = `${plugin.id}/${model.id}`;\n\t\t\tif (!existingIds.has(compositeId)) {\n\t\t\t\tmerged.push(pluginModelToModel(plugin.id, model));\n\t\t\t\texistingIds.add(compositeId);\n\t\t\t}\n\t\t}\n\t}\n\treturn merged;\n}\n\nexport async function getAvailableModels(): Promise<readonly Model<Api>[]> {\n\tconst allModels = getAllModels();\n\tconst pluginRegistry = getProviderRegistry();\n\tconst available: Model<Api>[] = [];\n\n\tfor (const model of allModels) {\n\t\tif (pluginRegistry.has(model.provider)) {\n\t\t\tavailable.push(model);\n\t\t} else if (await isProviderConfigured(model.provider)) {\n\t\t\tavailable.push(model);\n\t\t}\n\t}\n\treturn available;\n}\n\nexport type { Model, Api } from '@earendil-works/pi-ai';\n\nexport type ProviderCategory = 'common' | 'specialty' | 'oauth' | 'enterprise' | 'extension';\n\nexport interface ProviderMeta {\n  name: string;\n  category: ProviderCategory;\n  supportsOAuth?: boolean;\n  supportsApiKey?: boolean;\n}\n\nexport const PROVIDER_META: Record<string, ProviderMeta> = {\n  'openai': { name: 'OpenAI', category: 'common', supportsApiKey: true },\n  'anthropic': { name: 'Anthropic', category: 'common', supportsApiKey: true, supportsOAuth: true },\n  'deepseek': { name: 'DeepSeek', category: 'common', supportsApiKey: true },\n  'google': { name: 'Google AI', category: 'common', supportsApiKey: true },\n  'groq': { name: 'Groq', category: 'common', supportsApiKey: true },\n  'minimax': { name: 'MiniMax', category: 'common', supportsApiKey: true, supportsOAuth: true },\n  'minimax-cn': { name: 'MiniMax CN', category: 'common', supportsApiKey: true, supportsOAuth: true },\n  'kimi-coding': { name: 'Kimi For Coding', category: 'common', supportsApiKey: true, supportsOAuth: true },\n  'xai': { name: 'xAI', category: 'specialty', supportsApiKey: true },\n  'mistral': { name: 'Mistral AI', category: 'specialty', supportsApiKey: true },\n  'cerebras': { name: 'Cerebras', category: 'specialty', supportsApiKey: true },\n  'openrouter': { name: 'OpenRouter', category: 'specialty', supportsApiKey: true },\n  'huggingface': { name: 'Hugging Face', category: 'specialty', supportsApiKey: true },\n  moonshotai: { name: 'Moonshot AI (Kimi · International)', category: 'common', supportsApiKey: true },\n  'moonshotai-cn': { name: 'Moonshot AI (Kimi · China)', category: 'common', supportsApiKey: true },\n  fireworks: { name: 'Fireworks AI', category: 'specialty', supportsApiKey: true },\n  together: { name: 'Together AI', category: 'specialty', supportsApiKey: true },\n  'cloudflare-workers-ai': { name: 'Cloudflare Workers AI', category: 'enterprise', supportsApiKey: true },\n  'cloudflare-ai-gateway': { name: 'Cloudflare AI Gateway', category: 'enterprise', supportsApiKey: true },\n  xiaomi: { name: 'Xiaomi Mimo', category: 'specialty', supportsApiKey: true },\n  'xiaomi-token-plan-cn': { name: 'Xiaomi Token Plan (CN)', category: 'specialty', supportsApiKey: true },\n  'xiaomi-token-plan-ams': { name: 'Xiaomi Token Plan (AMS)', category: 'specialty', supportsApiKey: true },\n  'xiaomi-token-plan-sgp': { name: 'Xiaomi Token Plan (SGP)', category: 'specialty', supportsApiKey: true },\n  'opencode': { name: 'OpenCode', category: 'specialty', supportsApiKey: true },\n  'opencode-go': { name: 'OpenCode Go', category: 'specialty', supportsApiKey: true },\n  /** DashScope (Alibaba) — image, speech, STT; not an LLM KnownProvider. */\n  'dashscope': { name: 'DashScope (Alibaba)', category: 'specialty', supportsApiKey: true },\n  /** International GLM (api.z.ai). Auth: API key (ZAI_API_KEY); no published OAuth for this HTTP API. */\n  'zai': { name: 'Zhipu GLM (International · z.ai)', category: 'common', supportsApiKey: true },\n  'amazon-bedrock': { name: 'Amazon Bedrock', category: 'enterprise', supportsApiKey: true },\n  'azure-openai-responses': { name: 'Azure OpenAI', category: 'enterprise', supportsApiKey: true },\n  'google-vertex': { name: 'Google Vertex AI', category: 'enterprise', supportsApiKey: true },\n  'vercel-ai-gateway': { name: 'Vercel AI Gateway', category: 'enterprise', supportsApiKey: true },\n  'github-copilot': { name: 'GitHub Copilot (OAuth)', category: 'oauth', supportsOAuth: true, supportsApiKey: false },\n  'openai-codex': { name: 'OpenAI Codex (OAuth)', category: 'oauth', supportsOAuth: true, supportsApiKey: false },\n  'google-gemini-cli': { name: 'Google Gemini CLI (OAuth)', category: 'oauth', supportsOAuth: true, supportsApiKey: false },\n  'google-antigravity': { name: 'Google Antigravity (OAuth)', category: 'oauth', supportsOAuth: true, supportsApiKey: false },\n};\n\nexport function getSortedProviders(): string[] {\n  const all = getAllProviders();\n  const catOrder: Record<ProviderCategory, number> = { common: 0, specialty: 1, enterprise: 2, oauth: 3, extension: 4 };\n  const pluginRegistry = getProviderRegistry();\n\n  return [...all].sort((a, b) => {\n    const catA = pluginRegistry.has(a) ? 'extension' : (PROVIDER_META[a]?.category ?? 'specialty');\n    const catB = pluginRegistry.has(b) ? 'extension' : (PROVIDER_META[b]?.category ?? 'specialty');\n    if (catOrder[catA] !== catOrder[catB]) {\n      return catOrder[catA] - catOrder[catB];\n    }\n    return a.localeCompare(b);\n  });\n}\n\nexport function getProviderDisplayName(provider: string): string {\n  const plugin = getProviderRegistry().get(provider);\n  if (plugin) return plugin.name;\n  return PROVIDER_META[provider]?.name || provider;\n}\n\nexport function providerSupportsOAuth(provider: string): boolean {\n  return PROVIDER_META[provider]?.supportsOAuth ?? false;\n}\n\nexport function providerSupportsApiKey(provider: string): boolean {\n  return PROVIDER_META[provider]?.supportsApiKey ?? true;\n}\n\n// ============================================\n// Dynamic Default Model Resolution\n// ============================================\n\n/** Preferred default model when no explicit model is configured. */\nconst DEFAULT_FALLBACK_MODEL = 'openai/gpt-5.5';\n\n/**\n * Get a default model reference.\n * Priority:\n * 1. Explicitly configured model in agents.defaults.model (if set and available)\n * 2. Default fallback: openai/gpt-5.5\n */\nexport async function getDefaultModel(config?: Config | null | undefined): Promise<string> {\n  const defaultModel = config?.agents?.defaults?.model;\n  if (defaultModel) {\n    const modelRef = typeof defaultModel === 'string' ? defaultModel : defaultModel.primary;\n    if (modelRef) {\n      const availableModels = await getAvailableModels();\n      const configured = availableModels.find(m => \n        `${m.provider}/${m.id}` === modelRef ||\n        m.id === modelRef\n      );\n      if (configured) {\n        return `${configured.provider}/${configured.id}`;\n      }\n      return modelRef;\n    }\n  }\n\n  return DEFAULT_FALLBACK_MODEL;\n}\n\n/**\n * Synchronous default model resolution for constructors and sync code paths.\n * Uses catalog/registry only (no async credential checks).\n *\n * When no model is explicitly configured, returns the preferred default\n * (`openai/gpt-5.5`) rather than picking an arbitrary first model from the\n * full catalog.\n */\nexport function getDefaultModelSync(config?: Config | null | undefined): string {\n  const defaultModel = config?.agents?.defaults?.model;\n  if (defaultModel) {\n    const modelRef = typeof defaultModel === 'string' ? defaultModel : defaultModel.primary;\n    if (modelRef) {\n      return modelRef;\n    }\n  }\n\n  return DEFAULT_FALLBACK_MODEL;\n}\n\n// Re-export ModelRegistry for advanced use cases\nexport { ModelRegistry, getModelRegistry, resetModelRegistry, prewarmModelRegistry } from './model-registry.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAS,uBAAuB,OAA+B;AAC9D,KAAI,MAAM,aAAa,kBAAkB,MAAM,QAAQ,yBACtD,QAAO;EAAE,GAAG;EAAO,SAAS;EAAiC;AAE9D,QAAO;;;AAIR,SAAgB,mBAAmB,YAAoB,YAAiD;AACvG,QAAO;EACN,UAAU;EACV,IAAI,WAAW;EACf,MAAM,WAAW;EACjB,KAAK;EACL,SAAS;EACT,WAAW;EACX,OAAO,WAAW,iBAAkB,CAAC,QAAQ,QAAQ,GAA6B,CAAC,OAAO;EAC1F,eAAe,WAAW,iBAAiB;EAC3C,WAAW,WAAW,mBAAmB;EACzC,MAAM;GACL,OAAO,WAAW,SAAS,SAAS;GACpC,QAAQ,WAAW,SAAS,UAAU;GACtC,WAAW;GACX,YAAY;GACZ;EACD;;;;;;AAOF,SAAgB,cAAc,UAAsC;AAElE,KADuB,qBACL,CAAC,IAAI,SAAS,CAAE,QAAO;CAGzC,MAAM,cADW,kBACW,CAAC,UAAU,SAAS;AAChD,KAAI,YACF,QAAO;AAET,QAAO,iBAAiB,SAAS;;;;;;;;AASnC,SAAgB,aAAa,KAAyB;CAGrD,MAAM,cADW,kBACW,CAAC,QAAQ,IAAI;AACzC,KAAI,YACH,QAAO;AAGR,KAAI,IAAI,SAAS,IAAI,EAAE;EACtB,MAAM,CAAC,UAAU,WAAW,IAAI,MAAM,IAAI;EAC1C,MAAM,YAAYA,SAAa,UAAiB,QAAe;AAC/D,MAAI,UAAW,QAAO,uBAAuB,UAAwB;EAGrE,MAAM,SADiB,qBACM,CAAC,IAAI,SAAS;AAC3C,MAAI,QAAQ;GACX,MAAM,cAAc,OAAO,OAAO,MAAK,MAAK,EAAE,OAAO,QAAQ;AAC7D,OAAI,YAAa,QAAO,mBAAmB,UAAU,YAAY;;AAElE,QAAM,IAAI,MAAM,oBAAoB,MAAM;;AAG3C,MAAK,MAAM,YAAYC,cAAkB,CACxC,KAAI;EAEH,MAAM,QADSC,UAAc,SACT,CAAC,MAAK,MAAK,EAAE,OAAO,IAAI;AAC5C,MAAI,MAAO,QAAO,uBAAuB,MAAoB;SACtD;AACP;;CAIF,MAAM,iBAAiB,qBAAqB;AAC5C,MAAK,MAAM,UAAU,eAAe,SAAS,EAAE;EAC9C,MAAM,QAAQ,OAAO,OAAO,MAAK,MAAK,EAAE,OAAO,IAAI;AACnD,MAAI,MAAO,QAAO,mBAAmB,OAAO,IAAI,MAAM;;AAGvD,OAAM,IAAI,MAAM,oBAAoB,IAAI,iCAAiC;;AAG1E,SAAgB,oBAAoB,UAAyC;CAE5E,MAAM,eADW,kBACY,CAAC,QAAQ,CAAC,QAAO,MAAK,EAAE,aAAa,SAAS,CAAC,IAAI,uBAAuB;CACvG,MAAM,SAAS,qBAAqB,CAAC,IAAI,SAAS;AAClD,KAAI,CAAC,OAAQ,QAAO;CACpB,MAAM,eAAe,OAAO,OAAO,KAAI,MAAK,mBAAmB,UAAU,EAAE,CAAC;AAC5E,QAAO,CAAC,GAAG,cAAc,GAAG,aAAa;;AAG1C,SAAgB,kBAA4B;CAC3C,MAAM,WAAW,kBAAkB;CACnC,MAAM,4BAAY,IAAI,KAAa;AAGnC,MAAK,MAAM,KAAKD,cAAkB,CACjC,WAAU,IAAI,EAAE;AAIjB,MAAK,MAAM,KAAK,SAAS,QAAQ,CAChC,WAAU,IAAI,EAAE,SAAS;AAG1B,MAAK,MAAM,UAAU,qBAAqB,CAAC,SAAS,CACnD,WAAU,IAAI,OAAO,GAAG;AAGzB,QAAO,MAAM,KAAK,UAAU;;AAG7B,eAAsB,UAAU,UAA+C;AAC9E,KAAI,qBAAqB,CAAC,IAAI,SAAS,CAAE,QAAO;CAGhD,MAAM,gBAAgB,MAAM,cAAc,SAAS;AACnD,KAAI,cACH,QAAO;CAKR,MAAM,cADW,kBACW,CAAC,UAAU,SAAS;AAChD,KAAI,YACH,QAAO;AAIR,QAAO,iBAAiB,SAAS;;;;;;AAOlC,SAAgB,yBAAyB,UAA2B;AACnE,KAAI,qBAAqB,CAAC,IAAI,SAAS,CAAE,QAAO;AAIhD,KADiB,kBACL,CAAC,UAAU,SAAS,CAC/B,QAAO;AAGR,KAAI,iBAAiB,SAAS,CAC7B,QAAO;AAGR,QAAO,0BAA0B,SAAS;;AAG3C,eAAsB,qBAAqB,UAAoC;AAC7E,KAAI,qBAAqB,CAAC,IAAI,SAAS,CAAE,QAAO;AAIhD,KADiB,kBACL,CAAC,UAAU,SAAS,CAC9B,QAAO;AAET,QAAO,MAAM,eAAe,SAAS;;AAevC,eAAsB,2BAA2B,UAAoD;AAEnG,SAAO,MADiB,qBAAqB,SAAS,EACrC;;AAGnB,eAAsB,qBAAqB,UAA8C;AACvF,KAAI,qBAAqB,CAAC,IAAI,SAAS,CACrC,QAAO;EAAE,UAAU;EAAa,YAAY;EAAa;CAG3D,MAAM,WAAW,IAAI,oBAAoB;CACzC,MAAM,kBAAkB,MAAM,SAAS,oBAAoB,SAAS;AACpE,KAAI,oBAAoB,QAAS,QAAO;EAAE,UAAU;EAAS,YAAY;EAAa;AACtF,KAAI,oBAAoB,SAAU,QAAO;EAAE,UAAU;EAAW,YAAY;EAAa;AACzF,KAAI,oBAAoB,SAAS;EAC/B,MAAM,QAAQ,MAAM,SAAS,qBAAqB,SAAS;AAE3D,SAAO;GACL,UAAU;GACV,YAHc,QAAQ,OAAO,aAAa,MAAM,YAAY,KAAK,KAAK,CAGnD,GAAG,YAAY;GAClC,GAAI,OAAO,YAAY,EAAE,WAAW,MAAM,WAAW,GAAG,EAAE;GAC3D;;AAEH,KAAI,oBAAoB,MAAO,QAAO;EAAE,UAAU;EAAO,YAAY;EAAa;CAElF,MAAM,oBAAoB,MAAM,SAAS,qBAAqB,SAAS;AACvE,KAAI,mBAAmB,aAAa,kBAAkB,YAAY,KAAK,KAAK,CAC1E,QAAO;EACL,UAAU;EACV,YAAY;EACZ,WAAW,kBAAkB;EAC9B;AAIH,KADiB,kBACL,CAAC,UAAU,SAAS,CAC9B,QAAO;EAAE,UAAU;EAAe,YAAY;EAAa;AAG7D,QAAO;EAAE,UAAU;EAAQ,YAAY;EAAiB;;AAG1D,eAAsB,yBAA4C;CACjE,MAAM,eAAe,iBAAiB;CACtC,MAAM,aAAuB,EAAE;AAC/B,MAAK,MAAM,KAAK,aACf,KAAI,MAAM,qBAAqB,EAAE,CAChC,YAAW,KAAK,EAAE;AAGpB,QAAO;;AAGR,SAAgB,eAAsC;CAErD,MAAM,iBADW,kBACc,CAAC,QAAQ,CAAC,IAAI,uBAAuB;CACpE,MAAM,kBAAkB,qBAAqB,CAAC,SAAS;AACvD,KAAI,gBAAgB,WAAW,EAAG,QAAO;CAEzC,MAAM,cAAc,IAAI,IAAI,eAAe,KAAI,MAAK,GAAG,EAAE,SAAS,GAAG,EAAE,KAAK,CAAC;CAC7E,MAAM,SAAuB,CAAC,GAAG,eAAe;AAChD,MAAK,MAAM,UAAU,gBACpB,MAAK,MAAM,SAAS,OAAO,QAAQ;EAClC,MAAM,cAAc,GAAG,OAAO,GAAG,GAAG,MAAM;AAC1C,MAAI,CAAC,YAAY,IAAI,YAAY,EAAE;AAClC,UAAO,KAAK,mBAAmB,OAAO,IAAI,MAAM,CAAC;AACjD,eAAY,IAAI,YAAY;;;AAI/B,QAAO;;AAGR,eAAsB,qBAAqD;CAC1E,MAAM,YAAY,cAAc;CAChC,MAAM,iBAAiB,qBAAqB;CAC5C,MAAM,YAA0B,EAAE;AAElC,MAAK,MAAM,SAAS,UACnB,KAAI,eAAe,IAAI,MAAM,SAAS,CACrC,WAAU,KAAK,MAAM;UACX,MAAM,qBAAqB,MAAM,SAAS,CACpD,WAAU,KAAK,MAAM;AAGvB,QAAO;;AAsDR,SAAgB,qBAA+B;CAC7C,MAAM,MAAM,iBAAiB;CAC7B,MAAM,WAA6C;EAAE,QAAQ;EAAG,WAAW;EAAG,YAAY;EAAG,OAAO;EAAG,WAAW;EAAG;CACrH,MAAM,iBAAiB,qBAAqB;AAE5C,QAAO,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM;EAC7B,MAAM,OAAO,eAAe,IAAI,EAAE,GAAG,cAAe,cAAc,IAAI,YAAY;EAClF,MAAM,OAAO,eAAe,IAAI,EAAE,GAAG,cAAe,cAAc,IAAI,YAAY;AAClF,MAAI,SAAS,UAAU,SAAS,MAC9B,QAAO,SAAS,QAAQ,SAAS;AAEnC,SAAO,EAAE,cAAc,EAAE;GACzB;;AAGJ,SAAgB,uBAAuB,UAA0B;CAC/D,MAAM,SAAS,qBAAqB,CAAC,IAAI,SAAS;AAClD,KAAI,OAAQ,QAAO,OAAO;AAC1B,QAAO,cAAc,WAAW,QAAQ;;AAG1C,SAAgB,sBAAsB,UAA2B;AAC/D,QAAO,cAAc,WAAW,iBAAiB;;AAGnD,SAAgB,uBAAuB,UAA2B;AAChE,QAAO,cAAc,WAAW,kBAAkB;;;;;;;;AAgBpD,eAAsB,gBAAgB,QAAqD;CACzF,MAAM,eAAe,QAAQ,QAAQ,UAAU;AAC/C,KAAI,cAAc;EAChB,MAAM,WAAW,OAAO,iBAAiB,WAAW,eAAe,aAAa;AAChF,MAAI,UAAU;GAEZ,MAAM,cAAa,MADW,oBAAoB,EACf,MAAK,MACtC,GAAG,EAAE,SAAS,GAAG,EAAE,SAAS,YAC5B,EAAE,OAAO,SACV;AACD,OAAI,WACF,QAAO,GAAG,WAAW,SAAS,GAAG,WAAW;AAE9C,UAAO;;;AAIX,QAAO;;;;;;;;;;AAWT,SAAgB,oBAAoB,QAA4C;CAC9E,MAAM,eAAe,QAAQ,QAAQ,UAAU;AAC/C,KAAI,cAAc;EAChB,MAAM,WAAW,OAAO,iBAAiB,WAAW,eAAe,aAAa;AAChF,MAAI,SACF,QAAO;;AAIX,QAAO;;;;sBA/Z8C;mBACoC;0BACjB;gBACzB;uBACU;AAM9C,+BAA8B;AACrC,mCAAkC;AA6R3B,iBAA8C;EACzD,UAAU;GAAE,MAAM;GAAU,UAAU;GAAU,gBAAgB;GAAM;EACtE,aAAa;GAAE,MAAM;GAAa,UAAU;GAAU,gBAAgB;GAAM,eAAe;GAAM;EACjG,YAAY;GAAE,MAAM;GAAY,UAAU;GAAU,gBAAgB;GAAM;EAC1E,UAAU;GAAE,MAAM;GAAa,UAAU;GAAU,gBAAgB;GAAM;EACzE,QAAQ;GAAE,MAAM;GAAQ,UAAU;GAAU,gBAAgB;GAAM;EAClE,WAAW;GAAE,MAAM;GAAW,UAAU;GAAU,gBAAgB;GAAM,eAAe;GAAM;EAC7F,cAAc;GAAE,MAAM;GAAc,UAAU;GAAU,gBAAgB;GAAM,eAAe;GAAM;EACnG,eAAe;GAAE,MAAM;GAAmB,UAAU;GAAU,gBAAgB;GAAM,eAAe;GAAM;EACzG,OAAO;GAAE,MAAM;GAAO,UAAU;GAAa,gBAAgB;GAAM;EACnE,WAAW;GAAE,MAAM;GAAc,UAAU;GAAa,gBAAgB;GAAM;EAC9E,YAAY;GAAE,MAAM;GAAY,UAAU;GAAa,gBAAgB;GAAM;EAC7E,cAAc;GAAE,MAAM;GAAc,UAAU;GAAa,gBAAgB;GAAM;EACjF,eAAe;GAAE,MAAM;GAAgB,UAAU;GAAa,gBAAgB;GAAM;EACpF,YAAY;GAAE,MAAM;GAAsC,UAAU;GAAU,gBAAgB;GAAM;EACpG,iBAAiB;GAAE,MAAM;GAA8B,UAAU;GAAU,gBAAgB;GAAM;EACjG,WAAW;GAAE,MAAM;GAAgB,UAAU;GAAa,gBAAgB;GAAM;EAChF,UAAU;GAAE,MAAM;GAAe,UAAU;GAAa,gBAAgB;GAAM;EAC9E,yBAAyB;GAAE,MAAM;GAAyB,UAAU;GAAc,gBAAgB;GAAM;EACxG,yBAAyB;GAAE,MAAM;GAAyB,UAAU;GAAc,gBAAgB;GAAM;EACxG,QAAQ;GAAE,MAAM;GAAe,UAAU;GAAa,gBAAgB;GAAM;EAC5E,wBAAwB;GAAE,MAAM;GAA0B,UAAU;GAAa,gBAAgB;GAAM;EACvG,yBAAyB;GAAE,MAAM;GAA2B,UAAU;GAAa,gBAAgB;GAAM;EACzG,yBAAyB;GAAE,MAAM;GAA2B,UAAU;GAAa,gBAAgB;GAAM;EACzG,YAAY;GAAE,MAAM;GAAY,UAAU;GAAa,gBAAgB;GAAM;EAC7E,eAAe;GAAE,MAAM;GAAe,UAAU;GAAa,gBAAgB;GAAM;;EAEnF,aAAa;GAAE,MAAM;GAAuB,UAAU;GAAa,gBAAgB;GAAM;;EAEzF,OAAO;GAAE,MAAM;GAAoC,UAAU;GAAU,gBAAgB;GAAM;EAC7F,kBAAkB;GAAE,MAAM;GAAkB,UAAU;GAAc,gBAAgB;GAAM;EAC1F,0BAA0B;GAAE,MAAM;GAAgB,UAAU;GAAc,gBAAgB;GAAM;EAChG,iBAAiB;GAAE,MAAM;GAAoB,UAAU;GAAc,gBAAgB;GAAM;EAC3F,qBAAqB;GAAE,MAAM;GAAqB,UAAU;GAAc,gBAAgB;GAAM;EAChG,kBAAkB;GAAE,MAAM;GAA0B,UAAU;GAAS,eAAe;GAAM,gBAAgB;GAAO;EACnH,gBAAgB;GAAE,MAAM;GAAwB,UAAU;GAAS,eAAe;GAAM,gBAAgB;GAAO;EAC/G,qBAAqB;GAAE,MAAM;GAA6B,UAAU;GAAS,eAAe;GAAM,gBAAgB;GAAO;EACzH,sBAAsB;GAAE,MAAM;GAA8B,UAAU;GAAS,eAAe;GAAM,gBAAgB;GAAO;EAC5H;AAoCK,0BAAyB"}
+{"version":3,"file":"index.js","names":["getPiAiModel","getPiAiProviders","getPiAiModels"],"sources":["../../../src/providers/index.ts"],"sourcesContent":["/**\n * Model provider module - integrates built-in models with custom models from models.json\n */\n\nimport {\n\tgetModel as getPiAiModel,\n\tgetModels as getPiAiModels,\n\tgetProviders as getPiAiProviders,\n\ttype Model,\n\ttype Api,\n} from '@earendil-works/pi-ai';\nimport type { Config } from '../config/schema.js';\nimport { getModelRegistry } from './model-registry.js';\nimport { CredentialResolver, resolveApiKey, hasCredentials } from '../auth/credentials.js';\nimport { hasProviderAuthOnDiskSync } from '../auth/sync-provider-auth.js';\nimport { getApiKeyFromEnv } from './env-keys.js';\nimport { getProviderRegistry } from './plugin-registry.js';\nimport type { ProviderModelDefinition } from '../extensions/types/providers.js';\n\nexport { getApiKeyFromEnv, PROVIDER_ENV_MAP } from './env-keys.js';\n\n/** Sentinel base URL: model is served by an extension {@link ProviderPluginRegistry} provider. */\nexport const EXTENSION_PROVIDER_BASE_URL = 'extension://provider-plugin';\nconst OPENAI_CODEX_CANONICAL_BASE_URL = 'https://chatgpt.com/backend-api/codex';\n\nfunction normalizeProviderModel(model: Model<Api>): Model<Api> {\n\tif (model.provider === 'openai-codex' && model.api === 'openai-codex-responses') {\n\t\treturn { ...model, baseUrl: OPENAI_CODEX_CANONICAL_BASE_URL } as Model<Api>;\n\t}\n\treturn model;\n}\n\n/** Map a plugin registry model to the pi-ai {@link Model} shape. */\nexport function pluginModelToModel(providerId: string, definition: ProviderModelDefinition): Model<Api> {\n\treturn {\n\t\tprovider: providerId,\n\t\tid: definition.id,\n\t\tname: definition.name,\n\t\tapi: 'openai-completions' as Api,\n\t\tbaseUrl: EXTENSION_PROVIDER_BASE_URL,\n\t\treasoning: false,\n\t\tinput: definition.supportsImages ? (['text', 'image'] as ('text' | 'image')[]) : (['text'] as ('text' | 'image')[]),\n\t\tcontextWindow: definition.contextWindow ?? 128000,\n\t\tmaxTokens: definition.maxOutputTokens ?? 4096,\n\t\tcost: {\n\t\t\tinput: definition.pricing?.input ?? 0,\n\t\t\toutput: definition.pricing?.output ?? 0,\n\t\t\tcacheRead: 0,\n\t\t\tcacheWrite: 0,\n\t\t},\n\t} as Model<Api>;\n}\n\n/**\n * Get API key synchronously: checks registry (models.json) first, then environment variables.\n * Use this for Agent's getApiKey callback which must be synchronous.\n */\nexport function getApiKeySync(provider: string): string | undefined {\n  const pluginRegistry = getProviderRegistry();\n  if (pluginRegistry.has(provider)) return 'extension-managed';\n\n  const registry = getModelRegistry();\n  const registryKey = registry.getApiKey(provider);\n  if (registryKey) {\n    return registryKey;\n  }\n  return getApiKeyFromEnv(provider);\n}\n\n/**\n * Resolve model reference. Supports:\n * - \"provider/modelId\" format\n * - \"modelId\" auto-detection via pi-ai or custom models\n * @throws if model not found\n */\nexport function resolveModel(ref: string): Model<Api> {\n\t// First try ModelRegistry (includes custom models)\n\tconst registry = getModelRegistry();\n\tconst customModel = registry.resolve(ref);\n\tif (customModel) {\n\t\treturn customModel;\n\t}\n\n\tif (ref.includes('/')) {\n\t\tconst [provider, modelId] = ref.split('/');\n\t\tconst piAiModel = getPiAiModel(provider as any, modelId as any);\n\t\tif (piAiModel) return normalizeProviderModel(piAiModel as Model<Api>);\n\n\t\tconst pluginRegistry = getProviderRegistry();\n\t\tconst plugin = pluginRegistry.get(provider);\n\t\tif (plugin) {\n\t\t\tconst pluginModel = plugin.models.find(m => m.id === modelId);\n\t\t\tif (pluginModel) return pluginModelToModel(provider, pluginModel);\n\t\t}\n\t\tthrow new Error(`Model not found: ${ref}`);\n\t}\n\n\tfor (const provider of getPiAiProviders()) {\n\t\ttry {\n\t\t\tconst models = getPiAiModels(provider);\n\t\t\tconst found = models.find(m => m.id === ref);\n\t\t\tif (found) return normalizeProviderModel(found as Model<Api>);\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t}\n\n\tconst pluginRegistry = getProviderRegistry();\n\tfor (const plugin of pluginRegistry.listAll()) {\n\t\tconst found = plugin.models.find(m => m.id === ref);\n\t\tif (found) return pluginModelToModel(plugin.id, found);\n\t}\n\n\tthrow new Error(`Model not found: ${ref}. Use format: provider/model-id`);\n}\n\nexport function getModelsByProvider(provider: string): readonly Model<Api>[] {\n\tconst registry = getModelRegistry();\n\tconst fromRegistry = registry.getAll().filter(m => m.provider === provider).map(normalizeProviderModel);\n\tconst plugin = getProviderRegistry().get(provider);\n\tif (!plugin) return fromRegistry;\n\tconst pluginModels = plugin.models.map(m => pluginModelToModel(provider, m));\n\treturn [...fromRegistry, ...pluginModels];\n}\n\nexport function getAllProviders(): string[] {\n\tconst registry = getModelRegistry();\n\tconst providers = new Set<string>();\n\n\t// Add built-in providers\n\tfor (const p of getPiAiProviders()) {\n\t\tproviders.add(p);\n\t}\n\n\t// Add custom providers from registry\n\tfor (const m of registry.getAll()) {\n\t\tproviders.add(m.provider);\n\t}\n\n\tfor (const plugin of getProviderRegistry().listAll()) {\n\t\tproviders.add(plugin.id);\n\t}\n\n\treturn Array.from(providers);\n}\n\nexport async function getApiKey(provider: string): Promise<string | undefined> {\n\tif (getProviderRegistry().has(provider)) return 'extension-managed';\n\n\t// Use new credential resolver first (checks: agent private > global > oauth > env)\n\tconst credentialKey = await resolveApiKey(provider);\n\tif (credentialKey) {\n\t\treturn credentialKey;\n\t}\n\n\t// Check registry for custom providers (from models.json)\n\tconst registry = getModelRegistry();\n\tconst registryKey = registry.getApiKey(provider);\n\tif (registryKey) {\n\t\treturn registryKey;\n\t}\n\n\t// Fallback to environment variables\n\treturn getApiKeyFromEnv(provider);\n}\n\n/**\n * Synchronous version for use in non-async contexts\n * Only checks environment variables and registry, not credential system\n */\nexport function isProviderConfiguredSync(provider: string): boolean {\n\tif (getProviderRegistry().has(provider)) return true;\n\n\t// Check registry for custom providers\n\tconst registry = getModelRegistry();\n\tif (registry.getApiKey(provider)) {\n\t\treturn true;\n\t}\n\t// Check environment variables\n\tif (getApiKeyFromEnv(provider)) {\n\t\treturn true;\n\t}\n\t// Gateway UI / CLI store keys in auth-profiles.json (async CredentialResolver); sync path for fallback list\n\treturn hasProviderAuthOnDiskSync(provider);\n}\n\nexport async function isProviderConfigured(provider: string): Promise<boolean> {\n  if (getProviderRegistry().has(provider)) return true;\n\n  // Check registry first for custom providers (from models.json)\n  const registry = getModelRegistry();\n  if (registry.getApiKey(provider)) {\n    return true;\n  }\n  return await hasCredentials(provider);\n}\n\n/** Where runtime {@link getApiKey} resolves the key from (no secret values). */\nexport type ProviderActiveKeySource = 'none' | 'agent' | 'gateway' | 'oauth' | 'env' | 'models_json' | 'extension';\n\nexport type ProviderAuthMode = ProviderActiveKeySource;\nexport type ProviderAuthStatus = 'connected' | 'expired' | 'not_connected';\n\nexport interface ProviderAuthState {\n  authMode: ProviderAuthMode;\n  authStatus: ProviderAuthStatus;\n  expiresAt?: number;\n}\n\nexport async function getProviderActiveKeySource(provider: string): Promise<ProviderActiveKeySource> {\n  const authState = await getProviderAuthState(provider);\n  return authState.authMode;\n}\n\nexport async function getProviderAuthState(provider: string): Promise<ProviderAuthState> {\n  if (getProviderRegistry().has(provider)) {\n    return { authMode: 'extension', authStatus: 'connected' };\n  }\n\n  const resolver = new CredentialResolver();\n  const fromCredentials = await resolver.resolveApiKeySource(provider);\n  if (fromCredentials === 'agent') return { authMode: 'agent', authStatus: 'connected' };\n  if (fromCredentials === 'global') return { authMode: 'gateway', authStatus: 'connected' };\n  if (fromCredentials === 'oauth') {\n    const token = await resolver.loadOAuthTokenRecord(provider);\n    const expired = Boolean(token?.expiresAt && token.expiresAt < Date.now());\n    return {\n      authMode: 'oauth',\n      authStatus: expired ? 'expired' : 'connected',\n      ...(token?.expiresAt ? { expiresAt: token.expiresAt } : {}),\n    };\n  }\n  if (fromCredentials === 'env') return { authMode: 'env', authStatus: 'connected' };\n\n  const expiredOAuthToken = await resolver.loadOAuthTokenRecord(provider);\n  if (expiredOAuthToken?.expiresAt && expiredOAuthToken.expiresAt < Date.now()) {\n    return {\n      authMode: 'oauth',\n      authStatus: 'expired',\n      expiresAt: expiredOAuthToken.expiresAt,\n    };\n  }\n\n  const registry = getModelRegistry();\n  if (registry.getApiKey(provider)) {\n    return { authMode: 'models_json', authStatus: 'connected' };\n  }\n\n  return { authMode: 'none', authStatus: 'not_connected' };\n}\n\nexport async function getConfiguredProviders(): Promise<string[]> {\n\tconst allProviders = getAllProviders();\n\tconst configured: string[] = [];\n\tfor (const p of allProviders) {\n\t\tif (await isProviderConfigured(p)) {\n\t\t\tconfigured.push(p);\n\t\t}\n\t}\n\treturn configured;\n}\n\nexport function getAllModels(): readonly Model<Api>[] {\n\tconst registry = getModelRegistry();\n\tconst registryModels = registry.getAll().map(normalizeProviderModel);\n\tconst pluginProviders = getProviderRegistry().listAll();\n\tif (pluginProviders.length === 0) return registryModels;\n\n\tconst existingIds = new Set(registryModels.map(m => `${m.provider}/${m.id}`));\n\tconst merged: Model<Api>[] = [...registryModels];\n\tfor (const plugin of pluginProviders) {\n\t\tfor (const model of plugin.models) {\n\t\t\tconst compositeId = `${plugin.id}/${model.id}`;\n\t\t\tif (!existingIds.has(compositeId)) {\n\t\t\t\tmerged.push(pluginModelToModel(plugin.id, model));\n\t\t\t\texistingIds.add(compositeId);\n\t\t\t}\n\t\t}\n\t}\n\treturn merged;\n}\n\nexport async function getAvailableModels(): Promise<readonly Model<Api>[]> {\n\tconst allModels = getAllModels();\n\tconst pluginRegistry = getProviderRegistry();\n\tconst available: Model<Api>[] = [];\n\tconst configuredByProvider = new Map<string, boolean>();\n\n\tfor (const model of allModels) {\n\t\tif (pluginRegistry.has(model.provider)) {\n\t\t\tavailable.push(model);\n\t\t\tcontinue;\n\t\t}\n\t\tlet configured = configuredByProvider.get(model.provider);\n\t\tif (configured === undefined) {\n\t\t\tconfigured = await isProviderConfigured(model.provider);\n\t\t\tconfiguredByProvider.set(model.provider, configured);\n\t\t}\n\t\tif (configured) {\n\t\t\tavailable.push(model);\n\t\t}\n\t}\n\treturn available;\n}\n\nexport type { Model, Api } from '@earendil-works/pi-ai';\n\nexport type ProviderCategory = 'common' | 'specialty' | 'oauth' | 'enterprise' | 'extension';\n\nexport interface ProviderMeta {\n  name: string;\n  category: ProviderCategory;\n  supportsOAuth?: boolean;\n  supportsApiKey?: boolean;\n}\n\nexport const PROVIDER_META: Record<string, ProviderMeta> = {\n  'openai': { name: 'OpenAI', category: 'common', supportsApiKey: true },\n  'anthropic': { name: 'Anthropic', category: 'common', supportsApiKey: true, supportsOAuth: true },\n  'deepseek': { name: 'DeepSeek', category: 'common', supportsApiKey: true },\n  'google': { name: 'Google AI', category: 'common', supportsApiKey: true },\n  'groq': { name: 'Groq', category: 'common', supportsApiKey: true },\n  'minimax': { name: 'MiniMax', category: 'common', supportsApiKey: true, supportsOAuth: true },\n  'minimax-cn': { name: 'MiniMax CN', category: 'common', supportsApiKey: true, supportsOAuth: true },\n  'kimi-coding': { name: 'Kimi For Coding', category: 'common', supportsApiKey: true, supportsOAuth: true },\n  'xai': { name: 'xAI', category: 'specialty', supportsApiKey: true },\n  'mistral': { name: 'Mistral AI', category: 'specialty', supportsApiKey: true },\n  'cerebras': { name: 'Cerebras', category: 'specialty', supportsApiKey: true },\n  'openrouter': { name: 'OpenRouter', category: 'specialty', supportsApiKey: true },\n  'huggingface': { name: 'Hugging Face', category: 'specialty', supportsApiKey: true },\n  moonshotai: { name: 'Moonshot AI (Kimi · International)', category: 'common', supportsApiKey: true },\n  'moonshotai-cn': { name: 'Moonshot AI (Kimi · China)', category: 'common', supportsApiKey: true },\n  fireworks: { name: 'Fireworks AI', category: 'specialty', supportsApiKey: true },\n  together: { name: 'Together AI', category: 'specialty', supportsApiKey: true },\n  'cloudflare-workers-ai': { name: 'Cloudflare Workers AI', category: 'enterprise', supportsApiKey: true },\n  'cloudflare-ai-gateway': { name: 'Cloudflare AI Gateway', category: 'enterprise', supportsApiKey: true },\n  xiaomi: { name: 'Xiaomi Mimo', category: 'specialty', supportsApiKey: true },\n  'xiaomi-token-plan-cn': { name: 'Xiaomi Token Plan (CN)', category: 'specialty', supportsApiKey: true },\n  'xiaomi-token-plan-ams': { name: 'Xiaomi Token Plan (AMS)', category: 'specialty', supportsApiKey: true },\n  'xiaomi-token-plan-sgp': { name: 'Xiaomi Token Plan (SGP)', category: 'specialty', supportsApiKey: true },\n  'opencode': { name: 'OpenCode', category: 'specialty', supportsApiKey: true },\n  'opencode-go': { name: 'OpenCode Go', category: 'specialty', supportsApiKey: true },\n  /** DashScope (Alibaba) — image, speech, STT; not an LLM KnownProvider. */\n  'dashscope': { name: 'DashScope (Alibaba)', category: 'specialty', supportsApiKey: true },\n  /** International GLM (api.z.ai). Auth: API key (ZAI_API_KEY); no published OAuth for this HTTP API. */\n  'zai': { name: 'Zhipu GLM (International · z.ai)', category: 'common', supportsApiKey: true },\n  'amazon-bedrock': { name: 'Amazon Bedrock', category: 'enterprise', supportsApiKey: true },\n  'azure-openai-responses': { name: 'Azure OpenAI', category: 'enterprise', supportsApiKey: true },\n  'google-vertex': { name: 'Google Vertex AI', category: 'enterprise', supportsApiKey: true },\n  'vercel-ai-gateway': { name: 'Vercel AI Gateway', category: 'enterprise', supportsApiKey: true },\n  'github-copilot': { name: 'GitHub Copilot (OAuth)', category: 'oauth', supportsOAuth: true, supportsApiKey: false },\n  'openai-codex': { name: 'OpenAI Codex (OAuth)', category: 'oauth', supportsOAuth: true, supportsApiKey: false },\n  'google-gemini-cli': { name: 'Google Gemini CLI (OAuth)', category: 'oauth', supportsOAuth: true, supportsApiKey: false },\n  'google-antigravity': { name: 'Google Antigravity (OAuth)', category: 'oauth', supportsOAuth: true, supportsApiKey: false },\n};\n\nexport function getSortedProviders(): string[] {\n  const all = getAllProviders();\n  const catOrder: Record<ProviderCategory, number> = { common: 0, specialty: 1, enterprise: 2, oauth: 3, extension: 4 };\n  const pluginRegistry = getProviderRegistry();\n\n  return [...all].sort((a, b) => {\n    const catA = pluginRegistry.has(a) ? 'extension' : (PROVIDER_META[a]?.category ?? 'specialty');\n    const catB = pluginRegistry.has(b) ? 'extension' : (PROVIDER_META[b]?.category ?? 'specialty');\n    if (catOrder[catA] !== catOrder[catB]) {\n      return catOrder[catA] - catOrder[catB];\n    }\n    return a.localeCompare(b);\n  });\n}\n\nexport function getProviderDisplayName(provider: string): string {\n  const plugin = getProviderRegistry().get(provider);\n  if (plugin) return plugin.name;\n  return PROVIDER_META[provider]?.name || provider;\n}\n\nexport function providerSupportsOAuth(provider: string): boolean {\n  return PROVIDER_META[provider]?.supportsOAuth ?? false;\n}\n\nexport function providerSupportsApiKey(provider: string): boolean {\n  return PROVIDER_META[provider]?.supportsApiKey ?? true;\n}\n\n// ============================================\n// Dynamic Default Model Resolution\n// ============================================\n\n/** Preferred default model when no explicit model is configured. */\nconst DEFAULT_FALLBACK_MODEL = 'openai/gpt-5.5';\n\n/**\n * Get a default model reference.\n * Priority:\n * 1. Explicitly configured model in agents.defaults.models.chat (if set and available)\n * 2. Default fallback: openai/gpt-5.5\n */\nexport async function getDefaultModel(config?: Config | null | undefined): Promise<string> {\n  const defaultModel = config?.agents?.defaults?.models?.chat;\n  if (defaultModel) {\n    const modelRef = defaultModel.primary;\n    if (modelRef) {\n      const availableModels = await getAvailableModels();\n      const configured = availableModels.find(m => \n        `${m.provider}/${m.id}` === modelRef ||\n        m.id === modelRef\n      );\n      if (configured) {\n        return `${configured.provider}/${configured.id}`;\n      }\n      return modelRef;\n    }\n  }\n\n  return DEFAULT_FALLBACK_MODEL;\n}\n\n/**\n * Synchronous default model resolution for constructors and sync code paths.\n * Uses catalog/registry only (no async credential checks).\n *\n * When no model is explicitly configured, returns the preferred default\n * (`openai/gpt-5.5`) rather than picking an arbitrary first model from the\n * full catalog.\n */\nexport function getDefaultModelSync(config?: Config | null | undefined): string {\n  const defaultModel = config?.agents?.defaults?.models?.chat;\n  if (defaultModel) {\n    const modelRef = defaultModel.primary;\n    if (modelRef) {\n      return modelRef;\n    }\n  }\n\n  return DEFAULT_FALLBACK_MODEL;\n}\n\n// Re-export ModelRegistry for advanced use cases\nexport { ModelRegistry, getModelRegistry, resetModelRegistry, prewarmModelRegistry } from './model-registry.js';\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