@plumbus/ai-decision-typesafe 0.2.0 → 0.2.2

package/dist/typesafe-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typesafe-adapter.d.ts","sourceRoot":"","sources":["../src/typesafe-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,6BACf,SAAQ,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,QAAQ,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/C;AAED,4FAA4F;AAC5F,eAAO,MAAM,0BAA0B;;EAAyC,CAAC;AAEjF,kFAAkF;AAClF,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,6BAA6B,GACpC,uBAAuB,CA2DzB"}
+{"version":3,"file":"typesafe-adapter.d.ts","sourceRoot":"","sources":["../src/typesafe-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,6BACf,SAAQ,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,QAAQ,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/C;AAED,4FAA4F;AAC5F,eAAO,MAAM,0BAA0B;;EAAyC,CAAC;AAEjF,kFAAkF;AAClF,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,6BAA6B,GACpC,uBAAuB,CA+EzB"}

package/dist/typesafe-adapter.js

@@ -32,7 +32,27 @@ export function createTypeSafeDecisionAdapter(config) {
                 questions: toSystemOneQuestions(input.questions),
                 model: input.model ?? settings.data.model,
             }, input);
-            const result = parseDecisionResponse(wire, input.questions, 'typesafe');
+            let result;
+            try {
+                result = parseDecisionResponse(wire, input.questions, 'typesafe');
+            }
+            catch (error) {
+                if (error instanceof DecisionProviderError && error.model && error.usage) {
+                    const rate = Object.hasOwn(rates, error.model) ? rates[error.model] : undefined;
+                    const cost = rate === undefined ? null : (error.usage.inputTokens / 1_000_000) * rate;
+                    const validCost = cost !== null &&
+                        Number.isFinite(cost) &&
+                        (cost > 0 || error.usage.inputTokens === 0 || rate === 0)
+                        ? cost
+                        : null;
+                    throw new DecisionProviderError('typesafe', error.kind, error.message, {
+                        model: error.model,
+                        usage: error.usage,
+                        cost: validCost,
+                    });
+                }
+                throw error;
+            }
             const rate = Object.hasOwn(rates, result.model) ? rates[result.model] : undefined;
             const cost = rate === undefined ? null : (result.usage.inputTokens / 1_000_000) * rate;
             if (cost !== null &&

package/dist/typesafe-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"typesafe-adapter.js","sourceRoot":"","sources":["../src/typesafe-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"typesafe-adapter.js","sourceRoot":"","sources":["../src/typesafe-adapter.ts"],"names":[],"mappings":"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"}

package/instructions/README.md

@@ -5,8 +5,13 @@
 | [framework.md](framework.md) | Installation, public exports, adapter boundary, usage rules |
 | [testing.md](testing.md) | Offline validation and live environment setup |
 
-Keep app business logic in Plumbus primitives and `ctx.*`. These packages do not
-add `ctx.ai.decide()` or automatic provider discovery yet. Never route model
-predictions directly around capability access checks or confirmation policy.
+**Classification, categorization, provider/model selection, TypeSafe/Jev or Laya:**
+read `node_modules/@plumbus/core/instructions/ai-classification.md` first (core
+**0.7.4+**), then [framework.md](framework.md) for this package.
+
+Core 0.7.3+ provides `ctx.ai.decide()`; core 0.7.4+ also routes `ctx.ai.classify()`
+to explicitly registered decision adapters. Keep app business logic in Plumbus
+primitives and `ctx.*`. Never route predictions around capability access checks
+or confirmation policy. Provider registration is explicit in `app/server.ts`.
 
 [Package README](../README.md) · [Monorepo guide](https://github.com/plumbus-framework/plumbus/blob/main/docs/ai/decision-providers.md)

package/instructions/framework.md

@@ -14,7 +14,19 @@ Public exports: `createTypeSafeDecisionAdapter` — construct an explicitly conf
 File map: `src/index.ts` is the public barrel, `src/__tests__/` exercises the public
 API, `instructions/` contains these recipes. Laya alone also ships `service/`.
 
-## Minimal usage
+## Classification and model selection (core 0.7.4+)
+
+Read `node_modules/@plumbus/core/instructions/ai-classification.md` for the complete
+registration and usage recipe. Call `ctx.ai.classify({ text, labels, provider, model,
+threshold })` inside capabilities/flows. `provider` is your registered decision map
+key; `model` is an optional endpoint-supported ID. Native `threshold` defaults to
+0.5 and returns all matching labels. Use `decide()` for richer questions.
+
+Core records one `classify` cost row, including dispatched failures, with actual
+model/usage and identity. Omitted `provider` still uses the text default. Keep
+decision adapters under `decisions.providers`, separate from text providers.
+
+## Minimal usage (infrastructure / smoke testing)
 
 ```ts
 import { createTypeSafeDecisionAdapter } from '@plumbus/ai-decision-typesafe';
@@ -33,12 +45,13 @@ console.log(result.answers.refund.probability);
 1. Keep capabilities, flows, access policy and `ctx.*` as the application implementation path.
 2. Construct adapters at a server-owned infrastructure boundary and inject them. Keep keys on the server.
 3. Treat direct adapter usage as protocol integration, not a replacement for core's security/budget/audit lifecycle.
-4. Do not monkeypatch `ctx.ai`, register these as completion providers, or advertise `ctx.ai.decide()` as available.
+4. With core 0.7.3+, use `ctx.ai.decide()` in capabilities/flows. Export `decisions = { providers, defaultProvider }` from `app/server.ts`; API and workers share it. Do not register decision adapters as completion providers.
 5. Preserve distributions and provider confidence separately. A high confidence value is not authorization or proof of correctness.
 6. Validate thresholds on the actual task/model/language. Unknown cost is `null`, not free.
-7. Pass cancellation/deadlines explicitly during this package-only stage.
+7. Pass `signal: ctx.signal` and `timeoutMs` where needed. Flow steps supply their signal by default.
 8. Keep Python inference outside Node.js. Use the packaged Laya service or implement its documented HTTP protocol.
-9. There are no core CLI commands, environment discovery, or `plumbus init` instruction wiring for these packages yet.
+9. Define contracts using `defineDecision` from `@plumbus/ai-decision`; CLI startup discovers `app/decisions/`. No automatic environment provider discovery or dedicated decision CLI commands are provided.
+10. Core records one `operation: decide` row per dispatched logical call, including failed/cancelled calls, with tenant/actor and `costContext`. Persist it in the existing `onAICostRecorded` hook. Unknown cost is null; never convert it to free usage.
 
 Chat, voice and MCP still consume Plumbus capabilities; this package does not
 introduce a parallel runtime or transport for those surfaces.

package/instructions/testing.md

@@ -17,3 +17,13 @@ after building. Scripts are repository tools, not installed core CLI commands.
 Validate choices, scores, probabilities, actual model/routing, usage and unknown
 cost handling. Measure live accuracy and calibration separately from connection
 success. Do not assert a universal confidence cutoff or guaranteed live label.
+
+For core 0.7.4+ classification, use `mockAI({ classify: ['billing'] })` and test
+through `runCapability()` / `simulateFlow()`. Integration tests should assert
+provider/model forwarding, zero/multiple matches, inclusive thresholds, and one
+`classify` cost row. Use injected fetch; routine tests do not require live Laya.
+
+For core 0.7.3+ integration tests, configure `mockAI({ decide: result })` or a real
+`createAIService({ decisions, costTracker, onAICostRecorded })` with injected
+provider fetch. Assert exactly one cost row, identity, actual model/usage, unknown
+cost handling, billed validation failures, and budget rejection before dispatch.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumbus/ai-decision-typesafe",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "TypeSafe/Jev typed decision provider adapter for Plumbus.",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,10 +42,10 @@
     "@types/node": "^25.4.0",
     "typescript": "^5.7.0",
     "vitest": "^3.2.4",
-    "@plumbus/core": "0.7.2"
+    "@plumbus/core": "0.7.4"
   },
   "dependencies": {
-    "@plumbus/ai-decision": "~0.2.0"
+    "@plumbus/ai-decision": "~0.2.2"
   },
   "scripts": {
     "build": "tsc -b",