@particle-academy/prism-harness 0.9.2 → 0.10.0

package/README.md

@@ -58,9 +58,17 @@ creates no session, thread or index entry and makes no model/provider request
 or logical state change. Reads may physically purge expired entries, exactly as
 an ordinary store read does. Explicit state writes during resolution refuse.
 
-For named agents, the mode list is the ceiling even when a caller supplies tool
-names. Legacy sessions retain caller-list selection by default; set
-`AgentRuntimeOptions.narrowRequestedTools` to `true` to apply the ceiling there.
+The mode list is the ceiling for named and legacy sessions. Caller-supplied
+names narrow it; omitting names uses the mode's full list, and an empty list
+offers no tools. A requested `*` selects the mode's ceiling. Other names outside
+the ceiling fail before the model is called.
+
+Legacy callers that intentionally need the previous replacement behavior can
+set `AgentRuntimeOptions.allowLegacyToolListWidening` to `true`. This permits
+widening only in the legacy namespace; the configured authorizer still filters
+the offer and tool calls. Named agents always retain their ceiling. Remove an
+old explicit `narrowRequestedTools: false`: it now raises a migration error.
+Explicit `true` remains supported, and conflicts with the widening opt-out.
 Named agents inherit no legacy authority. Builtins require explicit registration and
 mode selection. Named-agent duplicates are refused; use
 tools.forAgent('support').replace(replacement, 'app.support', 'app.support.v2')

package/dist/runtime.d.ts

@@ -110,8 +110,10 @@ export interface PendingApproval {
     arguments: JsonObject;
 }
 export interface AgentRuntimeOptions {
-    /** Legacy compatibility default. Named agents always enforce their mode ceiling. */
+    /** Explicit true retains strict behavior. Explicit false now requires migration to the widening opt-out. */
     narrowRequestedTools?: boolean;
+    /** Permit caller names to replace a LEGACY session's mode list. Named agents remain strict; authorizers still apply. */
+    allowLegacyToolListWidening?: boolean;
     config?: RuntimeConfig;
     agents?: Record<string, RuntimeConfig>;
     client: LlmClient;

package/dist/runtime.js

@@ -39,7 +39,13 @@ export class AgentRuntime {
     constructor(options) {
         if (options.narrowRequestedTools !== undefined && typeof options.narrowRequestedTools !== 'boolean')
             throw new TypeError('narrowRequestedTools must be a boolean');
-        this.#narrowRequestedTools = options.narrowRequestedTools ?? false;
+        if (options.allowLegacyToolListWidening !== undefined && typeof options.allowLegacyToolListWidening !== 'boolean')
+            throw new TypeError('allowLegacyToolListWidening must be a boolean');
+        if (options.narrowRequestedTools === false)
+            throw new TypeError('narrowRequestedTools: false is no longer supported. Remove it; use allowLegacyToolListWidening: true only to explicitly permit legacy tool-list widening.');
+        if (options.narrowRequestedTools === true && options.allowLegacyToolListWidening === true)
+            throw new TypeError('narrowRequestedTools: true conflicts with allowLegacyToolListWidening: true.');
+        this.#narrowRequestedTools = options.allowLegacyToolListWidening !== true;
         this.#client = options.client;
         this.#modes = options.modes;
         this.#tools = options.tools;

package/dist/stores/file-owner-lock.js

@@ -126,6 +126,9 @@ async function inspect(lockPath, local) {
             return 'held';
         if (!owner.released && !lockPidIsDead(owner.pid))
             return 'held';
+        // A proven stale owner's temporary file may still be open on Windows.
+        // Cleanup errors use inspection's held handling and the existing wait budget.
+        await cleanFileLockOwner(lockPath, owner, temporary);
     }
     catch (error) {
         if (code(error) === 'ENOENT')
@@ -134,7 +137,6 @@ async function inspect(lockPath, local) {
             return 'held';
         throw error;
     }
-    await cleanFileLockOwner(lockPath, owner, temporary);
     return 'retry';
 }
 async function release(progress) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/prism-harness",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "Durable agent sessions for TypeScript — threads, session state and store drivers.",
   "type": "module",
   "sideEffects": false,
@@ -25,7 +25,8 @@
   "devDependencies": {
     "@types/node": "^26.3.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.11"
+    "vite": "^8.3.5",
+    "vitest": "^4.1.12"
   },
   "repository": {
     "type": "git",