@cjhyy/code-shell-core 0.5.0-rc.2 → 0.6.0-rc.1

package/dist/data/openrouter-models.d.ts

@@ -1,13 +1,18 @@
 /**
- * Runtime accessor for the OpenRouter model snapshot.
+ * Runtime accessor for the OpenRouter model snapshot (model pricing / context /
+ * modality metadata). Consumers: cost-tracker, model-pool, model-fetcher,
+ * onboarding, and the TUI connect screen.
  *
- * The snapshot is generated at build time by `scripts/sync-models.ts`
- * from https://openrouter.ai/api/v1/models. Reading happens lazily on
- * first call, so the JSON is parsed at most once per process.
+ * The snapshot is a committed JSON file (`openrouter-models.json`), regenerated
+ * manually by `scripts/sync-models.ts` (NOT run automatically during build —
+ * copy-assets ships the existing file). It is `require`d ONCE at module load.
  *
- * If the snapshot is missing or empty (e.g. first checkout before a
- * build, or sync failure with no prior file), accessors return [] and
- * callers should fall back to hardcoded defaults.
+ * If the file is missing at load (e.g. it was deleted, mis-gitignored, or
+ * copy-assets was broken), the require falls back to an EMPTY snapshot instead
+ * of throwing — the whole module would otherwise crash at import, taking down
+ * everything that transitively imports it. Callers already treat an empty
+ * `models: []` as "no metadata, use hardcoded defaults" (see model-fetcher's
+ * static-catalog fallback), so degrading to empty is safe.
  */
 export interface OpenRouterModel {
     id: string;
@@ -25,6 +30,12 @@ interface Snapshot {
     count: number;
     models: OpenRouterModel[];
 }
+/**
+ * Coerce an arbitrary `require`d value into a valid Snapshot, or the empty
+ * snapshot if it's malformed (missing/non-array `models`). Pure + exported so
+ * the missing/corrupt-file degradation is unit-testable without touching disk.
+ */
+export declare function coerceSnapshot(raw: unknown): Snapshot;
 /** Replace the in-memory snapshot for the rest of this process. */
 export declare function setOpenRouterSnapshot(next: Snapshot): void;
 export declare function getOpenRouterSnapshot(): Snapshot;

package/dist/data/openrouter-models.js

@@ -1,18 +1,45 @@
 /**
- * Runtime accessor for the OpenRouter model snapshot.
+ * Runtime accessor for the OpenRouter model snapshot (model pricing / context /
+ * modality metadata). Consumers: cost-tracker, model-pool, model-fetcher,
+ * onboarding, and the TUI connect screen.
  *
- * The snapshot is generated at build time by `scripts/sync-models.ts`
- * from https://openrouter.ai/api/v1/models. Reading happens lazily on
- * first call, so the JSON is parsed at most once per process.
+ * The snapshot is a committed JSON file (`openrouter-models.json`), regenerated
+ * manually by `scripts/sync-models.ts` (NOT run automatically during build —
+ * copy-assets ships the existing file). It is `require`d ONCE at module load.
  *
- * If the snapshot is missing or empty (e.g. first checkout before a
- * build, or sync failure with no prior file), accessors return [] and
- * callers should fall back to hardcoded defaults.
+ * If the file is missing at load (e.g. it was deleted, mis-gitignored, or
+ * copy-assets was broken), the require falls back to an EMPTY snapshot instead
+ * of throwing — the whole module would otherwise crash at import, taking down
+ * everything that transitively imports it. Callers already treat an empty
+ * `models: []` as "no metadata, use hardcoded defaults" (see model-fetcher's
+ * static-catalog fallback), so degrading to empty is safe.
  */
 import { createRequire } from "node:module";
 const requireJson = createRequire(import.meta.url);
-const bundled = requireJson("./openrouter-models.json");
+const EMPTY_SNAPSHOT = { fetchedAt: "", source: "", count: 0, models: [] };
+const bundled = loadBundled();
 let runtimeOverride = null;
+/**
+ * Coerce an arbitrary `require`d value into a valid Snapshot, or the empty
+ * snapshot if it's malformed (missing/non-array `models`). Pure + exported so
+ * the missing/corrupt-file degradation is unit-testable without touching disk.
+ */
+export function coerceSnapshot(raw) {
+    if (raw && typeof raw === "object" && Array.isArray(raw.models)) {
+        return raw;
+    }
+    return EMPTY_SNAPSHOT;
+}
+/** require the committed snapshot once; degrade to empty (never throw) if the
+ *  file is missing/corrupt so importing this module can't crash the process. */
+function loadBundled() {
+    try {
+        return coerceSnapshot(requireJson("./openrouter-models.json"));
+    }
+    catch {
+        return EMPTY_SNAPSHOT;
+    }
+}
 function loadSnapshot() {
     return runtimeOverride ?? bundled;
 }

package/dist/engine/aux-key.d.ts

@@ -0,0 +1,10 @@
+/**
+ * resolveAuxKey — pick the pool key for the background/aux client. Reads the
+ * unified store's settings.defaults.auxText (a connection id, also the pool
+ * key). Empty strings are treated as unset. (legacy settings.auxModelKey 已删除)
+ */
+export declare function resolveAuxKey(settings: {
+    defaults?: {
+        auxText?: string;
+    };
+}): string | undefined;

package/dist/engine/aux-key.js

@@ -0,0 +1,11 @@
+/**
+ * resolveAuxKey — pick the pool key for the background/aux client. Reads the
+ * unified store's settings.defaults.auxText (a connection id, also the pool
+ * key). Empty strings are treated as unset. (legacy settings.auxModelKey 已删除)
+ */
+export function resolveAuxKey(settings) {
+    const unified = settings.defaults?.auxText;
+    if (unified)
+        return unified;
+    return undefined;
+}

package/dist/engine/dynamic-tool-defs.d.ts

@@ -0,0 +1,19 @@
+import type { ToolDefinition } from "../types.js";
+import type { AgentDefinitionRegistry } from "../agent/agent-definition-registry.js";
+/**
+ * Rewrite a single tool definition with the live, per-engine dynamic bits the
+ * static def can't carry (the model only ever sees what we hand it each turn):
+ *
+ * - Agent: append the available-agent-types listing to the description AND
+ *   forward the rebuilt inputSchema. The schema carries the `agent_type` enum
+ *   of loaded role names — forwarding ONLY the description (the prior bug) left
+ *   agent_type a free optional string, so the model silently omitted it and the
+ *   configured roles' model/tools/skills never applied.
+ * - GenerateImage / GenerateVideo: name the configured providers in the
+ *   description (these defs never rebuild inputSchema, so description-only is
+ *   correct and intentional for them).
+ *
+ * Non-matching tools are returned by identity (no allocation). Pure: it never
+ * mutates the input or any shared const.
+ */
+export declare function applyDynamicToolDef(t: ToolDefinition, agentDefinitions: AgentDefinitionRegistry | undefined, guardCwd: string): ToolDefinition;

package/dist/engine/dynamic-tool-defs.js

@@ -0,0 +1,36 @@
+import { agentToolDefWithTypes } from "../tool-system/builtin/agent.js";
+import { generateImageToolDefFor } from "../tool-system/builtin/generate-image.js";
+import { generateVideoToolDefFor } from "../tool-system/builtin/generate-video.js";
+import { useCredentialToolDefFor } from "../credentials/use-credential-tool.js";
+/**
+ * Rewrite a single tool definition with the live, per-engine dynamic bits the
+ * static def can't carry (the model only ever sees what we hand it each turn):
+ *
+ * - Agent: append the available-agent-types listing to the description AND
+ *   forward the rebuilt inputSchema. The schema carries the `agent_type` enum
+ *   of loaded role names — forwarding ONLY the description (the prior bug) left
+ *   agent_type a free optional string, so the model silently omitted it and the
+ *   configured roles' model/tools/skills never applied.
+ * - GenerateImage / GenerateVideo: name the configured providers in the
+ *   description (these defs never rebuild inputSchema, so description-only is
+ *   correct and intentional for them).
+ *
+ * Non-matching tools are returned by identity (no allocation). Pure: it never
+ * mutates the input or any shared const.
+ */
+export function applyDynamicToolDef(t, agentDefinitions, guardCwd) {
+    if (t.name === "Agent") {
+        const def = agentToolDefWithTypes(agentDefinitions);
+        return { ...t, description: def.description, inputSchema: def.inputSchema };
+    }
+    if (t.name === "GenerateImage") {
+        return { ...t, description: generateImageToolDefFor(guardCwd).description };
+    }
+    if (t.name === "GenerateVideo") {
+        return { ...t, description: generateVideoToolDefFor(guardCwd).description };
+    }
+    if (t.name === "UseCredential") {
+        return { ...t, description: useCredentialToolDefFor(guardCwd).description };
+    }
+    return t;
+}