reasonix 0.12.8 → 0.12.13

package/dist/index.d.ts

@@ -491,11 +491,28 @@ interface ImmutablePrefixOptions {
 }
 declare class ImmutablePrefix {
     readonly system: string;
-    readonly toolSpecs: readonly ToolSpec[];
+    /**
+     * Backing array for `toolSpecs`. Originally `Object.freeze`d at
+     * construction (hence the class name) — but `addTool` now lets the
+     * dashboard register `semantic_search` after a mid-session
+     * `reasonix index` build without forcing the user to restart. Each
+     * add is documented to cost one cache-miss turn (the cached prefix
+     * on DeepSeek's side is keyed by the full tool list); subsequent
+     * turns re-cache against the new shape.
+     */
+    private _toolSpecs;
     readonly fewShots: readonly ChatMessage[];
     constructor(opts: ImmutablePrefixOptions);
+    get toolSpecs(): readonly ToolSpec[];
     toMessages(): ChatMessage[];
     tools(): ToolSpec[];
+    /**
+     * Add a tool spec to the prefix. Returns `true` if added, `false`
+     * if a tool with the same name was already present (callers can
+     * decide whether to ignore or surface the no-op). The model picks
+     * up the new tool on the next turn after the cache busts once.
+     */
+    addTool(spec: ToolSpec): boolean;
     get fingerprint(): string;
 }
 declare class AppendOnlyLog {

package/dist/index.js

@@ -1157,23 +1157,48 @@ function blockToString(block) {
 import { createHash } from "crypto";
 var ImmutablePrefix = class {
   system;
-  toolSpecs;
+  /**
+   * Backing array for `toolSpecs`. Originally `Object.freeze`d at
+   * construction (hence the class name) — but `addTool` now lets the
+   * dashboard register `semantic_search` after a mid-session
+   * `reasonix index` build without forcing the user to restart. Each
+   * add is documented to cost one cache-miss turn (the cached prefix
+   * on DeepSeek's side is keyed by the full tool list); subsequent
+   * turns re-cache against the new shape.
+   */
+  _toolSpecs;
   fewShots;
   constructor(opts) {
     this.system = opts.system;
-    this.toolSpecs = Object.freeze([...opts.toolSpecs ?? []]);
+    this._toolSpecs = [...opts.toolSpecs ?? []];
     this.fewShots = Object.freeze([...opts.fewShots ?? []]);
   }
+  get toolSpecs() {
+    return this._toolSpecs;
+  }
   toMessages() {
     return [{ role: "system", content: this.system }, ...this.fewShots.map((m) => ({ ...m }))];
   }
   tools() {
-    return this.toolSpecs.map((t) => structuredClone(t));
+    return this._toolSpecs.map((t) => structuredClone(t));
+  }
+  /**
+   * Add a tool spec to the prefix. Returns `true` if added, `false`
+   * if a tool with the same name was already present (callers can
+   * decide whether to ignore or surface the no-op). The model picks
+   * up the new tool on the next turn after the cache busts once.
+   */
+  addTool(spec) {
+    const name = spec.function?.name;
+    if (!name) return false;
+    if (this._toolSpecs.some((t) => t.function?.name === name)) return false;
+    this._toolSpecs.push(spec);
+    return true;
   }
   get fingerprint() {
     const blob = JSON.stringify({
       system: this.system,
-      tools: this.toolSpecs,
+      tools: this._toolSpecs,
       shots: this.fewShots
     });
     return createHash("sha256").update(blob).digest("hex").slice(0, 16);