@automatalabs/pi-acp 0.2.0 → 0.2.1

package/README.md

@@ -21,6 +21,23 @@ await runner.run("Review this change", { model: "pi/openrouter/vendor/model-id"
 
 The runner strips exactly the first `pi/` segment and sends the remaining `provider/model-id` verbatim through ACP's reserved `model` config channel. Pi-acp advertises a configured `model` select populated from the completed credential- and provider-filter-aware Pi catalog; set requests refresh and require membership in that same catalog. An unknown model rejects with JSON-RPC `-32602` and `data.errorKind = "invalid_model"`.
 
+### Thinking levels
+
+Pi-acp's `thinkingLevel` select is model-aware. Its visible choices are Pi's
+`getSupportedThinkingLevels()` result for the selected model, in Pi's order: a model capped at
+`high` does not advertise `xhigh` or `max`, and a non-reasoning model advertises only `off`. Before
+a model is selected, the option uses Pi's complete recognized domain as an unknown-model
+best-effort fallback. That domain is derived once from Pi's helper with a synthetic model that
+supports every level; pi-acp does not maintain a parallel hardcoded vocabulary.
+
+The option carries the additive ACP metadata
+`_meta["@automatalabs/agentprism"].recognizedValues`. The visible choices remain the supported
+subset, while this metadata contains Pi's complete ordered domain so clients can distinguish an
+unsupported recognized value from garbage. A supported set request is applied unchanged. A
+recognized but unsupported request is clamped with Pi's `clampThinkingLevel()` and the response
+echoes the effective level. An unrecognized value fails loudly with JSON-RPC `-32602` and
+`data.errorKind = "invalid_config_value"`; it is never handed to Pi's lowest-level fallback.
+
 ## MCP and structured output
 
 Pi-acp serves stdio, Streamable HTTP, and legacy SSE MCP servers and consumes stable tools, resources, prompts, completion, logging, pagination, progress, and dynamic tool registration. It also provides MCP client sampling, the workspace root, and form/URL elicitation. Client-hosted `acp` transport remains runner-owned. For `agent({ schema })`, Pi receives the runner's client-hosted HTTP `StructuredOutput` tool through this standard MCP path and retains the common prompt-embedded schema plus validated last-text fallback.

package/dist/config.d.ts

@@ -1,8 +1,14 @@
 import type { SessionConfigOption } from "@agentclientprotocol/sdk";
 import type { AgentSession, ModelRuntime } from "@earendil-works/pi-coding-agent";
-import type { Api, Model } from "@earendil-works/pi-ai";
-export declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
-export type ThinkingLevel = (typeof THINKING_LEVELS)[number];
+import { type Api, type Model, type ModelThinkingLevel } from "@earendil-works/pi-ai";
+export type ThinkingLevel = ModelThinkingLevel;
+/** Additive ACP metadata understood by AgentPrism's generic config validator. */
+export declare const CONFIG_OPTION_META_NAMESPACE = "@automatalabs/agentprism";
+/**
+ * Pi's complete, ordered domain, derived once from pi's own model-aware helper.
+ * This is intentionally not a hardcoded mirror of pi's module-private ladder.
+ */
+export declare const RECOGNIZED_THINKING_LEVELS: readonly ModelThinkingLevel[];
 export declare function thinkingLevelOption(session: AgentSession): SessionConfigOption;
 export declare function modelOption(session: AgentSession, availableModels: readonly Model<Api>[]): SessionConfigOption;
 export declare function applyConfig(session: AgentSession, modelRuntime: ModelRuntime, _availableModels: readonly Model<Api>[], configId: string, value: string | boolean): Promise<{

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGxD,eAAO,MAAM,eAAe,sEAAuE,CAAC;AACpG,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,mBAAmB,CAS9E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,mBAAmB,CAS9G;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EACvC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,OAAO,GACtB,OAAO,CAAC;IAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;IAAC,eAAe,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,CAAA;CAAE,CAAC,CAmC3F"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAGL,KAAK,GAAG,EACR,KAAK,KAAK,EACV,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAE/C,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AASvE;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,kBAAkB,EAEnE,CAAC;AAOF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,mBAAmB,CAe9E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,mBAAmB,CAS9G;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EACvC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,OAAO,GACtB,OAAO,CAAC;IAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;IAAC,eAAe,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,CAAA;CAAE,CAAC,CAwC3F"}

package/dist/config.js

@@ -1,13 +1,36 @@
+import { clampThinkingLevel, getSupportedThinkingLevels, } from "@earendil-works/pi-ai";
 import { adapterError } from "./errors.js";
-export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+/** Additive ACP metadata understood by AgentPrism's generic config validator. */
+export const CONFIG_OPTION_META_NAMESPACE = "@automatalabs/agentprism";
+const SYNTHETIC_ALL_THINKING_MODEL = {
+    reasoning: {},
+    thinkingLevelMap: new Proxy({}, {
+        get: (_target, property) => typeof property === "string" ? property : undefined,
+    }),
+};
+/**
+ * Pi's complete, ordered domain, derived once from pi's own model-aware helper.
+ * This is intentionally not a hardcoded mirror of pi's module-private ladder.
+ */
+export const RECOGNIZED_THINKING_LEVELS = Object.freeze(getSupportedThinkingLevels(SYNTHETIC_ALL_THINKING_MODEL));
+function supportedThinkingLevels(model) {
+    // With no selected model, the pi-derived domain is the only safe best-effort catalog.
+    return model ? getSupportedThinkingLevels(model) : RECOGNIZED_THINKING_LEVELS;
+}
 export function thinkingLevelOption(session) {
+    const supported = supportedThinkingLevels(session.model);
     return {
         id: "thinkingLevel",
         name: "Thinking level",
         type: "select",
         category: "thought_level",
         currentValue: session.thinkingLevel,
-        options: THINKING_LEVELS.map((value) => ({ value, name: value })),
+        options: supported.map((value) => ({ value, name: value })),
+        _meta: {
+            [CONFIG_OPTION_META_NAMESPACE]: {
+                recognizedValues: RECOGNIZED_THINKING_LEVELS,
+            },
+        },
     };
 }
 export function modelOption(session, availableModels) {
@@ -27,11 +50,16 @@ export async function applyConfig(session, modelRuntime, _availableModels, confi
     if (typeof value !== "string")
         throw adapterError("invalid_config_type");
     if (configId === "thinkingLevel") {
-        if (!THINKING_LEVELS.includes(value)) {
+        if (!RECOGNIZED_THINKING_LEVELS.includes(value)) {
             throw adapterError("invalid_config_value");
         }
+        const requested = value;
+        const supported = supportedThinkingLevels(session.model);
+        const effective = session.model && !supported.includes(requested)
+            ? clampThinkingLevel(session.model, requested)
+            : requested;
         const availableModels = [...await modelRuntime.getAvailable()];
-        session.setThinkingLevel(value);
+        session.setThinkingLevel(effective);
         return {
             configOptions: [thinkingLevelOption(session), modelOption(session, availableModels)],
             availableModels,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automatalabs/pi-acp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "license": "Apache-2.0",
   "engines": {
     "node": ">=22.19.0"
@@ -31,13 +31,13 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "1.2.1",
+    "@earendil-works/pi-ai": "0.80.10",
     "@earendil-works/pi-coding-agent": "0.80.10",
     "@modelcontextprotocol/sdk": "1.29.0",
     "typebox": "1.3.2"
   },
   "devDependencies": {
-    "@earendil-works/pi-agent-core": "0.80.10",
-    "@earendil-works/pi-ai": "0.80.10"
+    "@earendil-works/pi-agent-core": "0.80.10"
   },
   "scripts": {
     "build": "tsc -b",