@arnilo/prism-coding-agent 0.0.24 → 0.0.25

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.0.25] - 2026-08-06
+
+### Added
+- `ask_user_decision` durable elicitation hook maps onto shared pending decisions (blocking `ask()` unchanged for process-local path).
+
+### Changed
+- Released with exact 0.0.25 graph.
+
+See [migration guide](../../docs/migration.md) for the 0.0.24 → 0.0.25 notes.
+
 ## [0.0.24] - 2026-08-04
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # @arnilo/prism-coding-agent
 
-Optional first-party coding tools package for [Prism](https://www.npmjs.com/package/@arnilo/prism). Provides host shell/filesystem/repository tools — `shell`, `read`, `write`, `edit`, `repo_list`, `repo_search`, `glob`, `delete`, `move` — plus opt-in structured Git/check tools via `createGitTools()`, opt-in `createAskUserDecisionTool({ ask })`, and durable plan/checkpoint helpers for workflow composition — as Prism `ToolDefinition` objects. **Inert until a host imports it and registers the tools into a `ToolRegistry`.** No tool is auto-registered; hosts pick factories (or filter aggregator output) and may mix in their own `ToolDefinition`s.
+Optional first-party coding tools package for [Prism](https://www.npmjs.com/package/@arnilo/prism). Provides host shell/filesystem/repository tools — `shell`, `read`, `write`, `edit`, `repo_list`, `repo_search`, `glob`, `delete`, `move` — plus opt-in structured Git/check tools via `createGitTools()`, opt-in `createAskUserDecisionTool({ ask })` (durable runs surface as shared elicitation decisions), and durable plan/checkpoint helpers for workflow composition — as Prism `ToolDefinition` objects. **Inert until a host imports it and registers the tools into a `ToolRegistry`.** No tool is auto-registered; hosts pick factories (or filter aggregator output) and may mix in their own `ToolDefinition`s.
 
 Behavior is a behavioral port of the pi coding agent's `bash`/`read`/`write`/`edit` tools, adapted to Prism's `ToolDefinition` / `ToolResult` contracts (no `@earendil-works/*` or `typebox` dependencies). List/search/glob/Git are native Prism tools (hand-rolled glob; no picomatch/ripgrep).
 

package/dist/ask-user-decision.js

@@ -257,6 +257,31 @@ export function createAskUserDecisionTool(options) {
             required: ["question", "options"],
             additionalProperties: false,
         },
+        // Shared elicitation mapping (Phase 8): a durable gated run surfaces this call as a
+        // kind:"elicitation" pending decision; the answer payload resolves it without executing ask().
+        // The full UX payload (question + options with pros/cons) rides on the schema's extension key.
+        elicitation: (args) => {
+            let parsed;
+            try {
+                parsed = parseAskUserDecisionArgs(args, limits);
+            }
+            catch {
+                return undefined; // malformed args fall back to plain tool approval; execute reports the parse error
+            }
+            return {
+                schema: {
+                    ...askUserDecisionResumeSchema(parsed),
+                    "x-prism-ask-user-decision": toAskUserDecisionSuspendData(parsed),
+                },
+                reason: parsed.question,
+                validate: (payload) => {
+                    resolveAskUserDecisionAnswer(payload, parsed.selectionMode, parsed.options, {
+                        allowCustom: parsed.allowCustom,
+                        maxCustomTextBytes: limits.maxCustomTextBytes,
+                    });
+                },
+            };
+        },
         async execute(args, context) {
             const toolCallId = context.toolCallId;
             if (context.signal?.aborted)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arnilo/prism-coding-agent",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "description": "Optional coding-agent tools (shell, read, write, edit, repo_list, repo_search, glob, delete, move, opt-in Git/check/ask-user-decision, and durable plan/checkpoint helpers) package for Prism.",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,8 +28,8 @@
     "diff": "^9.0.0"
   },
   "peerDependencies": {
-    "@arnilo/prism": "0.0.24",
-    "@arnilo/prism-workflows": "0.0.24"
+    "@arnilo/prism": "0.0.25",
+    "@arnilo/prism-workflows": "0.0.25"
   },
   "devDependencies": {
     "@arnilo/prism": "file:../..",