@xopcai/xopc 0.0.83 → 0.0.85

package/dist/src/i18n/share-tool-bundle.d.ts

@@ -0,0 +1,20 @@
+import shareToolEn from './locales/share-tool.en.json';
+import { type ServerLocale } from './locale.js';
+export type ShareToolMessages = typeof shareToolEn;
+export declare function shareToolMessages(locale: ServerLocale): ShareToolMessages;
+/**
+ * Best-effort locale resolution for tools that don't yet receive an explicit
+ * locale signal. Order: explicit arg → env (LANG / LC_ALL / LANGUAGE) → default.
+ */
+export declare function resolveToolLocale(explicit?: string | null): ServerLocale;
+export declare function shareToolSuccessLines(locale: ServerLocale, vars: {
+    kind: string;
+    shareUrl: string;
+    title: string;
+    expiresAt: string;
+    thumbnailUrl: string;
+    reachability: string;
+    reachabilityHint: string;
+    isPublic: boolean;
+}): string[];
+export declare function shareToolErrorLine(locale: ServerLocale, message: string): string;

package/dist/src/i18n/share-tool-bundle.js

@@ -0,0 +1,56 @@
+import share_tool_en_default from "./locales/share-tool.en.js";
+import share_tool_zh_default from "./locales/share-tool.zh.js";
+import { formatI18n } from "./format.js";
+import { normalizeServerLocale, serverLocaleOrFallback } from "./locale.js";
+//#region src/i18n/share-tool-bundle.ts
+const byLocale = {
+	en: share_tool_en_default,
+	zh: share_tool_zh_default
+};
+function shareToolMessages(locale) {
+	return byLocale[serverLocaleOrFallback(locale)];
+}
+/**
+* Best-effort locale resolution for tools that don't yet receive an explicit
+* locale signal. Order: explicit arg → env (LANG / LC_ALL / LANGUAGE) → default.
+*/
+function resolveToolLocale(explicit) {
+	if (explicit) {
+		const n = normalizeServerLocale(explicit);
+		if (n) return n;
+	}
+	for (const key of [
+		"LC_ALL",
+		"LANG",
+		"LANGUAGE"
+	]) {
+		const v = process.env[key];
+		if (!v) continue;
+		const n = normalizeServerLocale(v.split(".")[0].replace(/_/g, "-"));
+		if (n) return n;
+	}
+	return "en";
+}
+function shareToolSuccessLines(locale, vars) {
+	const m = shareToolMessages(locale).success;
+	return [
+		formatI18n(m.headline, {
+			kind: vars.kind,
+			shareUrl: vars.shareUrl
+		}),
+		vars.isPublic ? "" : formatI18n(m.reachabilityWarning, {
+			reachability: vars.reachability,
+			hint: vars.reachabilityHint
+		}),
+		formatI18n(m.title, { title: vars.title }),
+		formatI18n(m.expiresAt, { expiresAt: vars.expiresAt }),
+		formatI18n(m.thumbnail, { thumbnailUrl: vars.thumbnailUrl })
+	];
+}
+function shareToolErrorLine(locale, message) {
+	return formatI18n(shareToolMessages(locale).error.prefix, { message });
+}
+//#endregion
+export { resolveToolLocale, shareToolErrorLine, shareToolMessages, shareToolSuccessLines };
+
+//# sourceMappingURL=share-tool-bundle.js.map

package/dist/src/i18n/share-tool-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-tool-bundle.js","names":["shareToolEn","shareToolZh"],"sources":["../../../src/i18n/share-tool-bundle.ts"],"sourcesContent":["import shareToolEn from './locales/share-tool.en.json';\nimport shareToolZh from './locales/share-tool.zh.json';\n\nimport { formatI18n } from './format.js';\nimport {\n  DEFAULT_SERVER_LOCALE,\n  normalizeServerLocale,\n  serverLocaleOrFallback,\n  type ServerLocale,\n} from './locale.js';\n\nexport type ShareToolMessages = typeof shareToolEn;\n\nconst byLocale: Record<ServerLocale, ShareToolMessages> = {\n  en: shareToolEn,\n  zh: shareToolZh,\n};\n\nexport function shareToolMessages(locale: ServerLocale): ShareToolMessages {\n  return byLocale[serverLocaleOrFallback(locale)];\n}\n\n/**\n * Best-effort locale resolution for tools that don't yet receive an explicit\n * locale signal. Order: explicit arg → env (LANG / LC_ALL / LANGUAGE) → default.\n */\nexport function resolveToolLocale(explicit?: string | null): ServerLocale {\n  if (explicit) {\n    const n = normalizeServerLocale(explicit);\n    if (n) return n;\n  }\n  for (const key of ['LC_ALL', 'LANG', 'LANGUAGE'] as const) {\n    const v = process.env[key];\n    if (!v) continue;\n    // Unix env vars use `zh_CN.UTF-8`; normalizer expects `zh-CN`.\n    const stripped = v.split('.')[0].replace(/_/g, '-');\n    const n = normalizeServerLocale(stripped);\n    if (n) return n;\n  }\n  return DEFAULT_SERVER_LOCALE;\n}\n\nexport function shareToolSuccessLines(\n  locale: ServerLocale,\n  vars: {\n    kind: string;\n    shareUrl: string;\n    title: string;\n    expiresAt: string;\n    thumbnailUrl: string;\n    reachability: string;\n    reachabilityHint: string;\n    isPublic: boolean;\n  },\n): string[] {\n  const m = shareToolMessages(locale).success;\n  return [\n    formatI18n(m.headline, { kind: vars.kind, shareUrl: vars.shareUrl }),\n    vars.isPublic\n      ? ''\n      : formatI18n(m.reachabilityWarning, {\n          reachability: vars.reachability,\n          hint: vars.reachabilityHint,\n        }),\n    formatI18n(m.title, { title: vars.title }),\n    formatI18n(m.expiresAt, { expiresAt: vars.expiresAt }),\n    formatI18n(m.thumbnail, { thumbnailUrl: vars.thumbnailUrl }),\n  ];\n}\n\nexport function shareToolErrorLine(locale: ServerLocale, message: string): string {\n  return formatI18n(shareToolMessages(locale).error.prefix, { message });\n}\n"],"mappings":";;;;;AAaA,MAAM,WAAoD;CACxD,IAAIA;CACJ,IAAIC;CACL;AAED,SAAgB,kBAAkB,QAAyC;AACzE,QAAO,SAAS,uBAAuB,OAAO;;;;;;AAOhD,SAAgB,kBAAkB,UAAwC;AACxE,KAAI,UAAU;EACZ,MAAM,IAAI,sBAAsB,SAAS;AACzC,MAAI,EAAG,QAAO;;AAEhB,MAAK,MAAM,OAAO;EAAC;EAAU;EAAQ;EAAW,EAAW;EACzD,MAAM,IAAI,QAAQ,IAAI;AACtB,MAAI,CAAC,EAAG;EAGR,MAAM,IAAI,sBADO,EAAE,MAAM,IAAI,CAAC,GAAG,QAAQ,MAAM,IACP,CAAC;AACzC,MAAI,EAAG,QAAO;;AAEhB,QAAA;;AAGF,SAAgB,sBACd,QACA,MAUU;CACV,MAAM,IAAI,kBAAkB,OAAO,CAAC;AACpC,QAAO;EACL,WAAW,EAAE,UAAU;GAAE,MAAM,KAAK;GAAM,UAAU,KAAK;GAAU,CAAC;EACpE,KAAK,WACD,KACA,WAAW,EAAE,qBAAqB;GAChC,cAAc,KAAK;GACnB,MAAM,KAAK;GACZ,CAAC;EACN,WAAW,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;EAC1C,WAAW,EAAE,WAAW,EAAE,WAAW,KAAK,WAAW,CAAC;EACtD,WAAW,EAAE,WAAW,EAAE,cAAc,KAAK,cAAc,CAAC;EAC7D;;AAGH,SAAgB,mBAAmB,QAAsB,SAAyB;AAChF,QAAO,WAAW,kBAAkB,OAAO,CAAC,MAAM,QAAQ,EAAE,SAAS,CAAC"}

package/dist/src/infra/gateway-processes.js

@@ -41,6 +41,7 @@ function readGatewayProcessArgsSync(pid) {
 function signalVerifiedGatewayPidSync(pid, signal) {
 	const args = readGatewayProcessArgsSync(pid);
 	if (!args || !isGatewayArgv(args, { allowGatewayBinary: true })) throw new Error(`refusing to signal non-gateway process pid ${pid}`);
+	if (signal === "SIGUSR1" && process.platform === "win32") throw new Error("SIGUSR1 is not supported on Windows; use SIGTERM with a restart intent file instead");
 	process.kill(pid, signal);
 }
 function findGatewayPidsOnPortSync(port) {

package/dist/src/infra/gateway-processes.js.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-processes.js","names":[],"sources":["../../../src/infra/gateway-processes.ts"],"sourcesContent":["import { spawnSync } from 'node:child_process';\nimport fsSync from 'node:fs';\nimport { listPortListeners } from '../gateway/ports.js';\nimport { isGatewayArgv, parseProcCmdline } from './gateway-process-argv.js';\n\nexport function readGatewayProcessArgsSync(pid: number): string[] | null {\n  if (process.platform === 'linux') {\n    try {\n      return parseProcCmdline(fsSync.readFileSync(`/proc/${pid}/cmdline`, 'utf8'));\n    } catch {\n      return null;\n    }\n  }\n  if (process.platform === 'darwin') {\n    const ps = spawnSync('ps', ['-o', 'command=', '-p', String(pid)], {\n      encoding: 'utf8',\n      timeout: 1000,\n    });\n    if (ps.error || ps.status !== 0) {\n      return null;\n    }\n    const command = ps.stdout.trim();\n    return command ? command.split(/\\s+/) : null;\n  }\n  if (process.platform === 'win32') {\n    const ps = spawnSync(\n      'powershell',\n      [\n        '-NoProfile',\n        '-Command',\n        `(Get-CimInstance Win32_Process -Filter \"ProcessId=${pid}\").CommandLine`,\n      ],\n      { encoding: 'utf8', timeout: 3000 },\n    );\n    if (ps.error || ps.status !== 0) {\n      return null;\n    }\n    const command = ps.stdout.trim();\n    return command ? command.split(/\\s+/) : null;\n  }\n  return null;\n}\n\nexport function signalVerifiedGatewayPidSync(pid: number, signal: 'SIGTERM' | 'SIGUSR1'): void {\n  const args = readGatewayProcessArgsSync(pid);\n  if (!args || !isGatewayArgv(args, { allowGatewayBinary: true })) {\n    throw new Error(`refusing to signal non-gateway process pid ${pid}`);\n  }\n  process.kill(pid, signal);\n}\n\nexport function findGatewayPidsOnPortSync(port: number): number[] {\n  try {\n    return listPortListeners(port)\n      .map((entry) => entry.pid)\n      .filter((pid): pid is number => Number.isFinite(pid) && pid > 0);\n  } catch {\n    return [];\n  }\n}\n\nexport function findVerifiedGatewayListenerPidsOnPortSync(port: number): number[] {\n  return Array.from(new Set(findGatewayPidsOnPortSync(port)))\n    .filter((pid) => pid !== process.pid)\n    .filter((pid) => {\n      const args = readGatewayProcessArgsSync(pid);\n      return args != null && isGatewayArgv(args, { allowGatewayBinary: true });\n    });\n}\n\nexport function formatGatewayPidList(pids: number[]): string {\n  return pids.join(', ');\n}\n"],"mappings":";;;;;AAKA,SAAgB,2BAA2B,KAA8B;AACvE,KAAI,QAAQ,aAAa,QACvB,KAAI;AACF,SAAO,iBAAiB,OAAO,aAAa,SAAS,IAAI,WAAW,OAAO,CAAC;SACtE;AACN,SAAO;;AAGX,KAAI,QAAQ,aAAa,UAAU;EACjC,MAAM,KAAK,UAAU,MAAM;GAAC;GAAM;GAAY;GAAM,OAAO,IAAI;GAAC,EAAE;GAChE,UAAU;GACV,SAAS;GACV,CAAC;AACF,MAAI,GAAG,SAAS,GAAG,WAAW,EAC5B,QAAO;EAET,MAAM,UAAU,GAAG,OAAO,MAAM;AAChC,SAAO,UAAU,QAAQ,MAAM,MAAM,GAAG;;AAE1C,KAAI,QAAQ,aAAa,SAAS;EAChC,MAAM,KAAK,UACT,cACA;GACE;GACA;GACA,qDAAqD,IAAI;GAC1D,EACD;GAAE,UAAU;GAAQ,SAAS;GAAM,CACpC;AACD,MAAI,GAAG,SAAS,GAAG,WAAW,EAC5B,QAAO;EAET,MAAM,UAAU,GAAG,OAAO,MAAM;AAChC,SAAO,UAAU,QAAQ,MAAM,MAAM,GAAG;;AAE1C,QAAO;;AAGT,SAAgB,6BAA6B,KAAa,QAAqC;CAC7F,MAAM,OAAO,2BAA2B,IAAI;AAC5C,KAAI,CAAC,QAAQ,CAAC,cAAc,MAAM,EAAE,oBAAoB,MAAM,CAAC,CAC7D,OAAM,IAAI,MAAM,8CAA8C,MAAM;AAEtE,SAAQ,KAAK,KAAK,OAAO;;AAG3B,SAAgB,0BAA0B,MAAwB;AAChE,KAAI;AACF,SAAO,kBAAkB,KAAK,CAC3B,KAAK,UAAU,MAAM,IAAI,CACzB,QAAQ,QAAuB,OAAO,SAAS,IAAI,IAAI,MAAM,EAAE;SAC5D;AACN,SAAO,EAAE;;;AAIb,SAAgB,0CAA0C,MAAwB;AAChF,QAAO,MAAM,KAAK,IAAI,IAAI,0BAA0B,KAAK,CAAC,CAAC,CACxD,QAAQ,QAAQ,QAAQ,QAAQ,IAAI,CACpC,QAAQ,QAAQ;EACf,MAAM,OAAO,2BAA2B,IAAI;AAC5C,SAAO,QAAQ,QAAQ,cAAc,MAAM,EAAE,oBAAoB,MAAM,CAAC;GACxE;;AAGN,SAAgB,qBAAqB,MAAwB;AAC3D,QAAO,KAAK,KAAK,KAAK"}
+{"version":3,"file":"gateway-processes.js","names":[],"sources":["../../../src/infra/gateway-processes.ts"],"sourcesContent":["import { spawnSync } from 'node:child_process';\nimport fsSync from 'node:fs';\nimport { listPortListeners } from '../gateway/ports.js';\nimport { isGatewayArgv, parseProcCmdline } from './gateway-process-argv.js';\n\nexport function readGatewayProcessArgsSync(pid: number): string[] | null {\n  if (process.platform === 'linux') {\n    try {\n      return parseProcCmdline(fsSync.readFileSync(`/proc/${pid}/cmdline`, 'utf8'));\n    } catch {\n      return null;\n    }\n  }\n  if (process.platform === 'darwin') {\n    const ps = spawnSync('ps', ['-o', 'command=', '-p', String(pid)], {\n      encoding: 'utf8',\n      timeout: 1000,\n    });\n    if (ps.error || ps.status !== 0) {\n      return null;\n    }\n    const command = ps.stdout.trim();\n    return command ? command.split(/\\s+/) : null;\n  }\n  if (process.platform === 'win32') {\n    const ps = spawnSync(\n      'powershell',\n      [\n        '-NoProfile',\n        '-Command',\n        `(Get-CimInstance Win32_Process -Filter \"ProcessId=${pid}\").CommandLine`,\n      ],\n      { encoding: 'utf8', timeout: 3000 },\n    );\n    if (ps.error || ps.status !== 0) {\n      return null;\n    }\n    const command = ps.stdout.trim();\n    return command ? command.split(/\\s+/) : null;\n  }\n  return null;\n}\n\nexport function signalVerifiedGatewayPidSync(pid: number, signal: 'SIGTERM' | 'SIGUSR1'): void {\n  const args = readGatewayProcessArgsSync(pid);\n  if (!args || !isGatewayArgv(args, { allowGatewayBinary: true })) {\n    throw new Error(`refusing to signal non-gateway process pid ${pid}`);\n  }\n  if (signal === 'SIGUSR1' && process.platform === 'win32') {\n    throw new Error(\n      'SIGUSR1 is not supported on Windows; use SIGTERM with a restart intent file instead',\n    );\n  }\n  process.kill(pid, signal);\n}\n\nexport function findGatewayPidsOnPortSync(port: number): number[] {\n  try {\n    return listPortListeners(port)\n      .map((entry) => entry.pid)\n      .filter((pid): pid is number => Number.isFinite(pid) && pid > 0);\n  } catch {\n    return [];\n  }\n}\n\nexport function findVerifiedGatewayListenerPidsOnPortSync(port: number): number[] {\n  return Array.from(new Set(findGatewayPidsOnPortSync(port)))\n    .filter((pid) => pid !== process.pid)\n    .filter((pid) => {\n      const args = readGatewayProcessArgsSync(pid);\n      return args != null && isGatewayArgv(args, { allowGatewayBinary: true });\n    });\n}\n\nexport function formatGatewayPidList(pids: number[]): string {\n  return pids.join(', ');\n}\n"],"mappings":";;;;;AAKA,SAAgB,2BAA2B,KAA8B;AACvE,KAAI,QAAQ,aAAa,QACvB,KAAI;AACF,SAAO,iBAAiB,OAAO,aAAa,SAAS,IAAI,WAAW,OAAO,CAAC;SACtE;AACN,SAAO;;AAGX,KAAI,QAAQ,aAAa,UAAU;EACjC,MAAM,KAAK,UAAU,MAAM;GAAC;GAAM;GAAY;GAAM,OAAO,IAAI;GAAC,EAAE;GAChE,UAAU;GACV,SAAS;GACV,CAAC;AACF,MAAI,GAAG,SAAS,GAAG,WAAW,EAC5B,QAAO;EAET,MAAM,UAAU,GAAG,OAAO,MAAM;AAChC,SAAO,UAAU,QAAQ,MAAM,MAAM,GAAG;;AAE1C,KAAI,QAAQ,aAAa,SAAS;EAChC,MAAM,KAAK,UACT,cACA;GACE;GACA;GACA,qDAAqD,IAAI;GAC1D,EACD;GAAE,UAAU;GAAQ,SAAS;GAAM,CACpC;AACD,MAAI,GAAG,SAAS,GAAG,WAAW,EAC5B,QAAO;EAET,MAAM,UAAU,GAAG,OAAO,MAAM;AAChC,SAAO,UAAU,QAAQ,MAAM,MAAM,GAAG;;AAE1C,QAAO;;AAGT,SAAgB,6BAA6B,KAAa,QAAqC;CAC7F,MAAM,OAAO,2BAA2B,IAAI;AAC5C,KAAI,CAAC,QAAQ,CAAC,cAAc,MAAM,EAAE,oBAAoB,MAAM,CAAC,CAC7D,OAAM,IAAI,MAAM,8CAA8C,MAAM;AAEtE,KAAI,WAAW,aAAa,QAAQ,aAAa,QAC/C,OAAM,IAAI,MACR,sFACD;AAEH,SAAQ,KAAK,KAAK,OAAO;;AAG3B,SAAgB,0BAA0B,MAAwB;AAChE,KAAI;AACF,SAAO,kBAAkB,KAAK,CAC3B,KAAK,UAAU,MAAM,IAAI,CACzB,QAAQ,QAAuB,OAAO,SAAS,IAAI,IAAI,MAAM,EAAE;SAC5D;AACN,SAAO,EAAE;;;AAIb,SAAgB,0CAA0C,MAAwB;AAChF,QAAO,MAAM,KAAK,IAAI,IAAI,0BAA0B,KAAK,CAAC,CAAC,CACxD,QAAQ,QAAQ,QAAQ,QAAQ,IAAI,CACpC,QAAQ,QAAQ;EACf,MAAM,OAAO,2BAA2B,IAAI;AAC5C,SAAO,QAAQ,QAAQ,cAAc,MAAM,EAAE,oBAAoB,MAAM,CAAC;GACxE;;AAGN,SAAgB,qBAAqB,MAAwB;AAC3D,QAAO,KAAK,KAAK,KAAK"}

package/dist/src/infra/restart.js

@@ -1,8 +1,8 @@
+import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
-import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 //#region src/infra/restart.ts
 /**
 * Gateway restart coordination — OpenClaw-aligned SIGUSR1 authorization and restart intent.

package/dist/src/infra/update-check.js

@@ -1,7 +1,7 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
 import { channelToNpmTag } from "./update-channels.js";
-import { access, readFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
+import { access, readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 //#region src/infra/update-check.ts
 init_package_version();

package/dist/src/infra/update-lock.js

@@ -1,9 +1,9 @@
-import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
+import { init_paths_state, resolveUpdateLockPath } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths_state, resolveUpdateLockPath } from "../config/paths-state.js";
-import { mkdir, readFile, unlink } from "node:fs/promises";
+import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
 import { dirname } from "node:path";
+import { mkdir, readFile, unlink } from "node:fs/promises";
 //#region src/infra/update-lock.ts
 init_write_file_atomic();
 init_paths_state();

package/dist/src/infra/update-runner.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { access, readdir, unlink } from "node:fs/promises";
 import { join } from "node:path";
+import { access, readdir, unlink } from "node:fs/promises";
 import { spawn } from "node:child_process";
 //#region src/infra/update-runner.ts
 init_logger();

package/dist/src/infra/update-startup.js

@@ -1,8 +1,8 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
-import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
+import { init_paths_state, resolveUpdateCheckStatePath } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths_state, resolveUpdateCheckStatePath } from "../config/paths-state.js";
+import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
 import { acquireUpdateLock } from "./update-lock.js";
 import { normalizeUpdateChannel } from "./update-channels.js";
 import { compareSemver, detectInstallKind, resolveNpmChannelTag, resolvePackageRoot } from "./update-check.js";

package/dist/src/infra/write-file-atomic.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { randomUUID } from "node:crypto";
+import path from "node:path";
 import { chmodSync, closeSync, copyFileSync, fsyncSync, mkdirSync, openSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
 import { chmod, copyFile, mkdir, open, rename, rm } from "node:fs/promises";
-import path from "node:path";
 //#region src/infra/write-file-atomic.ts
 /**
 * Durable single-file writes: temp file → fsync → rename to target.

package/dist/src/providers/auth-runtime/auth-profile-store.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 //#region src/providers/auth-runtime/auth-profile-store.ts
 /**
 * {@link AuthProfileStore} implementations.

package/dist/src/providers/index.js

@@ -1,8 +1,8 @@
 import { __esmMin, __exportAll } from "../../_virtual/_rolldown/runtime.js";
-import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
-import { CredentialResolver, hasCredentials, init_credentials, resolveApiKey } from "../auth/credentials.js";
 import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
+import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { ModelRegistry, getModelRegistry, init_model_registry, prewarmModelRegistry, resetModelRegistry } from "./model-registry.js";
+import { CredentialResolver, hasCredentials, init_credentials, resolveApiKey } from "../auth/credentials.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";
 import { getModel, getModels, getProviders } from "@earendil-works/pi-ai";
 //#region src/providers/index.ts

package/dist/src/providers/model-registry.js

@@ -1,10 +1,10 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { resolveModelsJsonPath } from "../config/paths.js";
 import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
 import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
+import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { existsSync, readFileSync } from "fs";
 import { getModels, getProviders } from "@earendil-works/pi-ai";
 //#region src/providers/model-registry.ts

package/dist/src/session/config-store.js

@@ -1,9 +1,9 @@
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { mkdir, readFile } from "fs/promises";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { join } from "path";
 import { existsSync } from "fs";
+import { mkdir, readFile } from "fs/promises";
 //#region src/session/config-store.ts
 /**
 * Session Config Store

package/dist/src/session/parity/jsonl-transcript-io.js

@@ -3,9 +3,9 @@ import { loadEntriesFromFile } from "./load-jsonl-entries.js";
 import { withTranscriptFileLock } from "./transcript-file-lock.js";
 import { emitSessionTranscriptUpdate } from "../transcript-events.js";
 import { buildSessionContextForLlm, isTranscriptContextEntry } from "../session-context-for-llm.js";
-import { randomUUID } from "node:crypto";
-import { existsSync } from "node:fs";
 import path from "node:path";
+import { existsSync } from "node:fs";
+import { randomUUID } from "node:crypto";
 import { CURRENT_SESSION_VERSION, SessionManager } from "@earendil-works/pi-coding-agent";
 //#region src/session/parity/jsonl-transcript-io.ts
 init_write_file_atomic();

package/dist/src/session/parity/sessions-json-file.js

@@ -1,9 +1,9 @@
 import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { readSessionsJsonFileRaw } from "./sessions-json-file-read.js";
 import { commitSessionsJsonWrite, getSessionsJsonWriteStats, invalidateSessionsJsonCache, noteSessionsJsonWritten, readSessionsJsonCached, resetSessionsJsonCacheForTest } from "./sessions-json-cache.js";
+import { dirname } from "node:path";
 import { existsSync } from "node:fs";
 import { mkdir } from "node:fs/promises";
-import { dirname } from "node:path";
 import lockfile from "proper-lockfile";
 //#region src/session/parity/sessions-json-file.ts
 init_write_file_atomic();

package/dist/src/session/parity/transcript-file-lock.js

@@ -1,7 +1,7 @@
-import { createHash } from "node:crypto";
+import path from "node:path";
 import { existsSync } from "node:fs";
+import { createHash } from "node:crypto";
 import { mkdir, open, readFile, rm, stat } from "node:fs/promises";
-import path from "node:path";
 //#region src/session/parity/transcript-file-lock.ts
 /**
 * Cross-process (and re-entrant same-process) advisory lock for session transcript JSONL.

package/dist/src/session/parity/transcript-paths.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { formatSessionArchiveTimestamp, init_artifacts } from "./artifacts.js";
 import { init_session_id, validateSessionId } from "./session-id.js";
-import fsSync from "node:fs";
 import { dirname, relative, resolve } from "node:path";
+import fsSync from "node:fs";
 //#region src/session/parity/transcript-paths.ts
 function resolveSessionsDir(opts) {
 	const sessionsDir = opts?.sessionsDir?.trim();

package/dist/src/session/search-index-cache.js

@@ -1,7 +1,7 @@
 import { FILENAMES, init_paths } from "../config/paths.js";
 import { SessionSearchIndex } from "./search-index.js";
-import { stat } from "node:fs/promises";
 import { join } from "node:path";
+import { stat } from "node:fs/promises";
 //#region src/session/search-index-cache.ts
 /**
 * Shared cache for {@link SessionSearchIndex} builds (invalidated on session writes).

package/dist/src/session/search-index.js

@@ -2,8 +2,8 @@ import { init_transcript_paths, resolveSessionFilePath } from "./parity/transcri
 import { FILENAMES, init_paths } from "../config/paths.js";
 import { isTranscriptContextEntry } from "./session-context-for-llm.js";
 import { readTranscriptRowsFromFile, rowsToLlmMessages } from "./parity/jsonl-transcript-io.js";
-import { readFile } from "node:fs/promises";
 import { join } from "node:path";
+import { readFile } from "node:fs/promises";
 //#region src/session/search-index.ts
 /**
 * In-memory inverted index over session transcripts (`sessions.json` + JSONL).

package/dist/src/session/session-title.js

@@ -1,8 +1,9 @@
+import { init_session_key, isCronSessionKey, parseSessionKey } from "../routing/session-key.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_session_key, isCronSessionKey, parseSessionKey } from "../routing/session-key.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
+import { stripSessionStartupContextFromUserText } from "../agent/reply/startup-context.js";
 import { stripInboundFileMetadataFromText } from "../channels/attachments/inbound-persist.js";
 import { stripEnvelopeTimestampPrefix } from "../channels/envelope-timestamp.js";
 import { complete } from "@earendil-works/pi-ai";
@@ -31,7 +32,7 @@ function extractTextFromMessage(m) {
 function firstUserText(messages) {
 	const u = messages.find((m) => m.role === "user");
 	if (!u) return "";
-	return stripInboundFileMetadataFromText(stripEnvelopeTimestampPrefix(extractTextFromMessage(u)));
+	return stripInboundFileMetadataFromText(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(extractTextFromMessage(u))));
 }
 /** First assistant message that has visible text (skips tool-only assistant rows). */
 function firstAssistantText(messages) {

package/dist/src/session/session-title.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-title.js","names":[],"sources":["../../../src/session/session-title.ts"],"sourcesContent":["/**\n * LLM-generated session titles (webchat and any path using SessionStore).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport { stripInboundFileMetadataFromText } from '../channels/attachments/inbound-persist.js';\nimport { stripEnvelopeTimestampPrefix } from '../channels/envelope-timestamp.js';\nimport { isCronSessionKey, parseSessionKey } from '../routing/session-key.js';\nimport { resolveModel } from '../providers/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { readAgentMessageContent } from '../agent/memory/agent-message-access.js';\nimport type { SessionStore } from './store.js';\n\nconst log = createLogger('SessionAutoTitle');\n\nconst MAX_TITLE_LEN = 80;\n\n/** Collect visible text from any content block that exposes `text` (pi-ai / OpenAI / Anthropic shapes). */\nfunction extractTextFromMessage(m: AgentMessage): string {\n  const raw = readAgentMessageContent(m);\n  if (typeof raw === 'string') return raw.trim();\n  if (Array.isArray(raw)) {\n    const parts: string[] = [];\n    for (const c of raw) {\n      if (c && typeof c === 'object') {\n        const o = c as unknown as Record<string, unknown>;\n        const type = typeof o.type === 'string' ? o.type : '';\n        if (type === 'toolCall' || type === 'tool_use' || type === 'tool_result') continue;\n        if (typeof o.text === 'string' && o.text.trim()) {\n          parts.push(o.text.trim());\n        }\n      }\n    }\n    return parts.join(' ').trim();\n  }\n  return '';\n}\n\nfunction firstUserText(messages: AgentMessage[]): string {\n  const u = messages.find((m) => m.role === 'user');\n  if (!u) return '';\n  const raw = extractTextFromMessage(u);\n  // User turns include `formatInboundFileTextBlock` text blocks; do not feed [File:…] into title LLM / fallback.\n  // Inbound pipeline / webchat prepends `[YYYY-MM-DD HH:MM TZ]`; strip so titles are not timestamp-led.\n  return stripInboundFileMetadataFromText(stripEnvelopeTimestampPrefix(raw));\n}\n\n/** First assistant message that has visible text (skips tool-only assistant rows). */\nfunction firstAssistantText(messages: AgentMessage[]): string {\n  for (const m of messages) {\n    if (m.role === 'assistant') {\n      const t = extractTextFromMessage(m);\n      if (t.length > 0) return t;\n    }\n  }\n  return '';\n}\n\nexport function isWebchatSessionKey(sessionKey: string): boolean {\n  const p = parseSessionKey(sessionKey);\n  if (p?.source === 'webchat') return true;\n  return sessionKey.includes(':webchat:');\n}\n\n/** Whether to run LLM/fallback session naming for this key (excludes cron, heartbeat). */\nexport function shouldAutoTitleSessionKey(sessionKey: string): boolean {\n  const raw = (sessionKey ?? '').trim();\n  if (!raw) return false;\n  if (isCronSessionKey(raw)) return false;\n  if (raw.toLowerCase().startsWith('heartbeat:')) return false;\n  return true;\n}\n\nexport function sanitizeSessionTitle(raw: string): string {\n  let s = raw.trim();\n  if ((s.startsWith('\"') && s.endsWith('\"')) || (s.startsWith(\"'\") && s.endsWith(\"'\"))) {\n    s = s.slice(1, -1).trim();\n  }\n  const lineBreak = s.indexOf('\\n');\n  if (lineBreak !== -1) s = s.slice(0, lineBreak).trim();\n  if (s.length > MAX_TITLE_LEN) s = s.slice(0, MAX_TITLE_LEN - 1).trimEnd() + '…';\n  return s;\n}\n\n/** Non-LLM title: first line of first user text, else first assistant line. */\nexport function fallbackTitleFromMessages(messages: AgentMessage[]): string | null {\n  const u = firstUserText(messages);\n  if (u) {\n    const line = u.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  const a = firstAssistantText(messages);\n  if (a) {\n    const line = a.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  return null;\n}\n\n/**\n * Returns a title string, or null if generation should be skipped or failed.\n */\nexport async function generateSessionTitleFromMessages(\n  modelRef: string,\n  messages: AgentMessage[],\n  signal?: AbortSignal,\n): Promise<string | null> {\n  const userText = firstUserText(messages);\n  const assistantText = firstAssistantText(messages);\n  if (!userText && !assistantText) return null;\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    log.warn({ err, modelRef }, 'Cannot resolve model for session title');\n    return null;\n  }\n\n  const prompt =\n    userText && assistantText\n      ? `You label chat sessions. Given the first user message and the start of the assistant reply, output ONE short title (max 8 words). No quotes. No punctuation at the end. Use the same language as the user when possible.\n\nUser: ${userText.slice(0, 2000)}\n\nAssistant: ${assistantText.slice(0, 2000)}\n\nTitle:`\n      : userText\n        ? `The assistant reply only used tools (no visible text yet). Output ONE short title (max 8 words) based only on the user's first message. No quotes. No punctuation at the end. Use the same language as the user.\n\nUser: ${userText.slice(0, 2000)}\n\nTitle:`\n        : `Output ONE short title (max 8 words) for this assistant reply. No quotes. No punctuation at the end.\n\nAssistant: ${assistantText!.slice(0, 2000)}\n\nTitle:`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 64,\n        temperature: 0.35,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const cleaned = sanitizeSessionTitle(text);\n    return cleaned.length > 0 ? cleaned : null;\n  } catch (err) {\n    log.warn({ err }, 'Session title LLM call failed');\n    return null;\n  }\n}\n\n/**\n * If the session is still unnamed, set `name` (LLM when possible, else first-line fallback).\n * Skips cron/heartbeat keys. Ensures index row exists by re-saving when metadata is missing (fixes index lag).\n */\nexport async function maybeAutoTitleSessionStore(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  modelRef: string | undefined,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let messages = await sessionStore.load(sessionKey);\n  if (!messages.length) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) {\n    await sessionStore.save(sessionKey, messages);\n    meta = await sessionStore.getMetadata(sessionKey);\n  }\n  if (!meta) {\n    log.warn({ sessionKey }, 'Session title: metadata missing after save');\n    return;\n  }\n  if (meta.name && meta.name.trim().length > 0) return;\n\n  let title: string | null = null;\n  const ref = modelRef?.trim();\n  if (ref) {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 25_000);\n    try {\n      title = await generateSessionTitleFromMessages(ref, messages, controller.signal);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n  if (!title) {\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, { name: title });\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: updateMetadata failed');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"session-title.js","names":[],"sources":["../../../src/session/session-title.ts"],"sourcesContent":["/**\n * LLM-generated session titles (webchat and any path using SessionStore).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport { stripSessionStartupContextFromUserText } from '../agent/reply/startup-context.js';\nimport { stripInboundFileMetadataFromText } from '../channels/attachments/inbound-persist.js';\nimport { stripEnvelopeTimestampPrefix } from '../channels/envelope-timestamp.js';\nimport { isCronSessionKey, parseSessionKey } from '../routing/session-key.js';\nimport { resolveModel } from '../providers/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { readAgentMessageContent } from '../agent/memory/agent-message-access.js';\nimport type { SessionStore } from './store.js';\n\nconst log = createLogger('SessionAutoTitle');\n\nconst MAX_TITLE_LEN = 80;\n\n/** Collect visible text from any content block that exposes `text` (pi-ai / OpenAI / Anthropic shapes). */\nfunction extractTextFromMessage(m: AgentMessage): string {\n  const raw = readAgentMessageContent(m);\n  if (typeof raw === 'string') return raw.trim();\n  if (Array.isArray(raw)) {\n    const parts: string[] = [];\n    for (const c of raw) {\n      if (c && typeof c === 'object') {\n        const o = c as unknown as Record<string, unknown>;\n        const type = typeof o.type === 'string' ? o.type : '';\n        if (type === 'toolCall' || type === 'tool_use' || type === 'tool_result') continue;\n        if (typeof o.text === 'string' && o.text.trim()) {\n          parts.push(o.text.trim());\n        }\n      }\n    }\n    return parts.join(' ').trim();\n  }\n  return '';\n}\n\nfunction firstUserText(messages: AgentMessage[]): string {\n  const u = messages.find((m) => m.role === 'user');\n  if (!u) return '';\n  const raw = extractTextFromMessage(u);\n  // User turns include `formatInboundFileTextBlock` text blocks; do not feed [File:…] into title LLM / fallback.\n  // Inbound pipeline / webchat prepends `[YYYY-MM-DD HH:MM TZ]`; strip so titles are not timestamp-led.\n  return stripInboundFileMetadataFromText(\n    stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw)),\n  );\n}\n\n/** First assistant message that has visible text (skips tool-only assistant rows). */\nfunction firstAssistantText(messages: AgentMessage[]): string {\n  for (const m of messages) {\n    if (m.role === 'assistant') {\n      const t = extractTextFromMessage(m);\n      if (t.length > 0) return t;\n    }\n  }\n  return '';\n}\n\nexport function isWebchatSessionKey(sessionKey: string): boolean {\n  const p = parseSessionKey(sessionKey);\n  if (p?.source === 'webchat') return true;\n  return sessionKey.includes(':webchat:');\n}\n\n/** Whether to run LLM/fallback session naming for this key (excludes cron, heartbeat). */\nexport function shouldAutoTitleSessionKey(sessionKey: string): boolean {\n  const raw = (sessionKey ?? '').trim();\n  if (!raw) return false;\n  if (isCronSessionKey(raw)) return false;\n  if (raw.toLowerCase().startsWith('heartbeat:')) return false;\n  return true;\n}\n\nexport function sanitizeSessionTitle(raw: string): string {\n  let s = raw.trim();\n  if ((s.startsWith('\"') && s.endsWith('\"')) || (s.startsWith(\"'\") && s.endsWith(\"'\"))) {\n    s = s.slice(1, -1).trim();\n  }\n  const lineBreak = s.indexOf('\\n');\n  if (lineBreak !== -1) s = s.slice(0, lineBreak).trim();\n  if (s.length > MAX_TITLE_LEN) s = s.slice(0, MAX_TITLE_LEN - 1).trimEnd() + '…';\n  return s;\n}\n\n/** Non-LLM title: first line of first user text, else first assistant line. */\nexport function fallbackTitleFromMessages(messages: AgentMessage[]): string | null {\n  const u = firstUserText(messages);\n  if (u) {\n    const line = u.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  const a = firstAssistantText(messages);\n  if (a) {\n    const line = a.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  return null;\n}\n\n/**\n * Returns a title string, or null if generation should be skipped or failed.\n */\nexport async function generateSessionTitleFromMessages(\n  modelRef: string,\n  messages: AgentMessage[],\n  signal?: AbortSignal,\n): Promise<string | null> {\n  const userText = firstUserText(messages);\n  const assistantText = firstAssistantText(messages);\n  if (!userText && !assistantText) return null;\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    log.warn({ err, modelRef }, 'Cannot resolve model for session title');\n    return null;\n  }\n\n  const prompt =\n    userText && assistantText\n      ? `You label chat sessions. Given the first user message and the start of the assistant reply, output ONE short title (max 8 words). No quotes. No punctuation at the end. Use the same language as the user when possible.\n\nUser: ${userText.slice(0, 2000)}\n\nAssistant: ${assistantText.slice(0, 2000)}\n\nTitle:`\n      : userText\n        ? `The assistant reply only used tools (no visible text yet). Output ONE short title (max 8 words) based only on the user's first message. No quotes. No punctuation at the end. Use the same language as the user.\n\nUser: ${userText.slice(0, 2000)}\n\nTitle:`\n        : `Output ONE short title (max 8 words) for this assistant reply. No quotes. No punctuation at the end.\n\nAssistant: ${assistantText!.slice(0, 2000)}\n\nTitle:`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 64,\n        temperature: 0.35,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const cleaned = sanitizeSessionTitle(text);\n    return cleaned.length > 0 ? cleaned : null;\n  } catch (err) {\n    log.warn({ err }, 'Session title LLM call failed');\n    return null;\n  }\n}\n\n/**\n * If the session is still unnamed, set `name` (LLM when possible, else first-line fallback).\n * Skips cron/heartbeat keys. Ensures index row exists by re-saving when metadata is missing (fixes index lag).\n */\nexport async function maybeAutoTitleSessionStore(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  modelRef: string | undefined,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let messages = await sessionStore.load(sessionKey);\n  if (!messages.length) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) {\n    await sessionStore.save(sessionKey, messages);\n    meta = await sessionStore.getMetadata(sessionKey);\n  }\n  if (!meta) {\n    log.warn({ sessionKey }, 'Session title: metadata missing after save');\n    return;\n  }\n  if (meta.name && meta.name.trim().length > 0) return;\n\n  let title: string | null = null;\n  const ref = modelRef?.trim();\n  if (ref) {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 25_000);\n    try {\n      title = await generateSessionTitleFromMessages(ref, messages, controller.signal);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n  if (!title) {\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, { name: title });\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: updateMetadata failed');\n  }\n}\n"],"mappings":"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"}

package/dist/src/session/store.js

@@ -1,12 +1,12 @@
+import { init_agent_scope, listAgentEntries, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { init_session_key, parseSessionKey } from "../routing/session-key.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_agent_scope, listAgentEntries, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_artifacts, parseCompactionCheckpointTranscriptFileName } from "./parity/artifacts.js";
 import { init_session_id, validateSessionId } from "./parity/session-id.js";
 import { archiveFileOnDisk, init_transcript_paths, resolveSessionFilePath, resolveSessionTranscriptPathInDir } from "./parity/transcript-paths.js";
 import { FILENAMES, init_paths, resolveSessionsDir } from "../config/paths.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { loadEntriesFromFile } from "./parity/load-jsonl-entries.js";
 import { mergeLlmMessagesPreservingContextRows } from "./session-context-for-llm.js";
 import { appendPiTranscriptContextEntry, persistMergedTranscriptRows, readTranscriptRowsFromFile, rowsToLlmMessages, writeTranscriptJsonl } from "./parity/jsonl-transcript-io.js";
@@ -19,10 +19,10 @@ import "./types.js";
 import { readSessionsJsonFile, withSessionsJsonLock } from "./parity/sessions-json-file.js";
 import { buildSessionsJsonStatsPatch, incrementSessionsJsonStatsForAppend, isAppendOnlyLlmTranscriptMessage, patchSessionsJsonEntryStats } from "./parity/sessions-json-patch.js";
 import { countTranscriptMessageRows, readDisplayMessagePageFromTranscriptFile } from "./parity/transcript-pagination.js";
-import { copyFile, mkdir, readdir, stat, unlink } from "fs/promises";
-import { randomUUID } from "node:crypto";
 import { join } from "path";
 import { existsSync } from "fs";
+import { copyFile, mkdir, readdir, stat, unlink } from "fs/promises";
+import { randomUUID } from "node:crypto";
 //#region src/session/store.ts
 init_paths();
 init_agent_scope();

package/dist/src/share/share-auto.d.ts

@@ -0,0 +1,74 @@
+export type ShareAudience = 'friend' | 'colleague' | 'public';
+export type ShareAutoMode = 'auto' | 'force-file' | 'force-site' | 'force-zip';
+export type ShareAutoKind = 'file' | 'site' | 'zip';
+export interface ShareAutoDecision {
+    kind: ShareAutoKind;
+    isDirectory: boolean;
+    reason: 'html-single-file' | 'html-with-assets' | 'small-image' | 'large-binary' | 'directory-zip' | 'directory-browse' | 'forced';
+    hint: string;
+}
+export interface ShareAutoProbe {
+    absolutePath: string;
+    kind: 'file' | 'directory';
+    size: number;
+    mimeType: string;
+    hasIndexHtml: boolean;
+}
+export interface ShareAutoDefaults {
+    ttlMs: number;
+    maxViews: number | null;
+}
+/** Convert an audience hint into TTL/maxViews defaults. */
+export declare function audienceDefaults(audience: ShareAudience | undefined): ShareAutoDefaults;
+/** Run filesystem probes needed by the routing logic. */
+export declare function probeShareTarget(workspaceRoot: string, relPath: string): Promise<ShareAutoProbe>;
+/** Pure decision function — exported for tests. */
+export declare function decideShareKind(probe: ShareAutoProbe, mode: ShareAutoMode | undefined): ShareAutoDecision;
+/** Build the user-facing title (trimmed, no extension). */
+export declare function makeTitle(fileName: string, override?: string): string;
+/** Build the user-facing description (audience + TTL hint baked in). */
+export declare function makeDescription(opts: {
+    audience: ShareAudience | undefined;
+    expiresAt: string;
+    override?: string;
+}): string;
+/** Subfolder under the workspace where single-HTML site shares are staged. */
+export declare const STAGING_DIR_NAME = ".xopc-share-staging";
+export interface StagedSite {
+    /** Absolute path of the freshly-created staging directory. */
+    stagingDir: string;
+    /** Workspace-relative path to feed into SiteShareStore.create({ path }). */
+    relativePath: string;
+}
+/**
+ * Copy a single HTML file into `<workspaceRoot>/.xopc-share-staging/<uuid>/index.html`
+ * so it can be served as a site (SiteShareStore needs a directory root).
+ *
+ * The caller must register a cleanup that calls `cleanupStagedSite(stagingDir)`
+ * when the underlying site share is revoked / expires.
+ */
+export declare function stageSingleHtmlAsSite(workspaceRoot: string, absoluteHtmlPath: string): Promise<StagedSite>;
+/** Best-effort cleanup; never throws. */
+export declare function cleanupStagedSite(stagingDir: string): Promise<void>;
+export declare function rememberStagedSite(recordId: string, stagingDir: string): void;
+export declare function forgetStagedSite(recordId: string): string | undefined;
+/**
+ * Walk `<workspaceRoot>/.xopc-share-staging/` and drop directories that are
+ * no longer referenced by any live site-share record. Call at gateway boot.
+ */
+export declare function sweepOrphanedStagingDirs(workspaceRoot: string, liveStagingDirs: Set<string>): Promise<void>;
+/**
+ * Boot-time housekeeping:
+ *  1. Walk active static site shares whose source lives under STAGING_DIR_NAME
+ *     (i.e. created via `stageSingleHtmlAsSite`).
+ *  2. Re-register them in the in-process registry so the SiteShareStore
+ *     cleanup hook still wipes the right directory on revoke/expire after a
+ *     restart.
+ *  3. Sweep each workspace's `.xopc-share-staging/` for entries that are not
+ *     referenced by any live record — these are leftovers from a previous
+ *     process death between create-staging and persist.
+ *
+ * Safe to call multiple times; idempotent. Best invoked from gateway.start().
+ */
+export declare function runStagingSweep(): Promise<void>;
+export declare function resetStagedSiteRegistryForTests(): void;