@plumbus/ai-decision-laya 0.2.0 → 0.2.2

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

@@ -1 +1 @@
-{"version":3,"file":"laya-adapter.d.ts","sourceRoot":"","sources":["../src/laya-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,uBAAuB,CAgDzB"}
+{"version":3,"file":"laya-adapter.d.ts","sourceRoot":"","sources":["../src/laya-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,uBAAuB,CAgEzB"}

package/dist/laya-adapter.js

@@ -24,9 +24,26 @@ export function createLayaDecisionAdapter(config) {
                 ...(model === 'auto' ? {} : { model }),
                 ...(settings.data.language ? { lang: settings.data.language } : {}),
             }, input);
-            const result = parseDecisionResponse(wire, input.questions, 'laya');
+            let result;
+            try {
+                result = parseDecisionResponse(wire, input.questions, 'laya');
+            }
+            catch (error) {
+                if (error instanceof DecisionProviderError && error.usage && error.model) {
+                    throw new DecisionProviderError('laya', error.kind, error.message, {
+                        model: error.model,
+                        usage: error.usage,
+                        cost: settings.data.costPerRequestUsd ?? null,
+                    });
+                }
+                throw error;
+            }
             if (!z.object({ routing: z.object({}) }).safeParse(result).success) {
-                throw new DecisionProviderError('laya', 'invalid_response', 'Laya response is missing checkpoint routing identity', { model: result.model, usage: result.usage });
+                throw new DecisionProviderError('laya', 'invalid_response', 'Laya response is missing checkpoint routing identity', {
+                    model: result.model,
+                    usage: result.usage,
+                    cost: settings.data.costPerRequestUsd ?? null,
+                });
             }
             const cost = settings.data.costPerRequestUsd ?? null;
             return {

package/dist/laya-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"laya-adapter.js","sourceRoot":"","sources":["../src/laya-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,GAGxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAUtC,wFAAwF;AACxF,MAAM,UAAU,yBAAyB,CACvC,MAAiC;IAEjC,MAAM,QAAQ,GAAG,CAAC;SACf,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACxD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QACrD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;KAChE,CAAC;SACD,SAAS,CAAC,MAAM,CAAC,CAAC;IACrB,IAAI,CAAC,QAAQ,CAAC,OAAO;QACnB,MAAM,IAAI,qBAAqB,CAC7B,MAAM,EACN,eAAe,EACf,qDAAqD,CACtD,CAAC;IACJ,MAAM,IAAI,GAAG,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,KAAK,CAAC,MAAM,CAAC,OAAO;YAClB,MAAM,KAAK,GAAG,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YACjD,MAAM,IAAI,GAAG,MAAM,IAAI,CACrB;gBACE,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,SAAS,EAAE,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC;gBAChD,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;gBACtC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpE,EACD,KAAK,CACN,CAAC;YACF,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACpE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;gBACnE,MAAM,IAAI,qBAAqB,CAC7B,MAAM,EACN,kBAAkB,EAClB,sDAAsD,EACtD,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAC7C,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC;YACrD,OAAO;gBACL,GAAG,MAAM;gBACT,IAAI;gBACJ,aAAa,EAAE,IAAI,KAAK,IAAI;gBAC5B,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK;aACrC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"laya-adapter.js","sourceRoot":"","sources":["../src/laya-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: `createLayaDecisionAdapter` — construct an explicitly configur
 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 { createLayaDecisionAdapter } from '@plumbus/ai-decision-laya';
@@ -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-laya",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Self-hosted Laya typed decision adapter and Python reference service for Plumbus.",
   "type": "module",
   "main": "./dist/index.js",
@@ -43,10 +43,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",

package/service/test_audit_round_two.py

@@ -93,6 +93,14 @@ class ServiceRoundTwo(unittest.TestCase):
             return original(body)
         backend.predict = wait
         server = create_server(("127.0.0.1", 0), backend, "test-key", max_connections=1)
+        released = threading.Event()
+        process_request_thread = server.process_request_thread
+        def observe_handler_exit(*args):
+            try:
+                process_request_thread(*args)
+            finally:
+                released.set()
+        server.process_request_thread = observe_handler_exit
         thread = threading.Thread(target=lambda: server.serve_forever(poll_interval=0.01), daemon=True)
         results = []
         first = threading.Thread(target=lambda: results.append(self.send(address=server.server_address)[0]))
@@ -104,6 +112,8 @@ class ServiceRoundTwo(unittest.TestCase):
             finish.set()
             first.join(2)
             self.assertEqual(results, [200])
+            # Receiving the body can precede the server thread's semaphore release.
+            self.assertTrue(released.wait(2))
             self.assertEqual(self.send(address=server.server_address)[0], 200)
         finally:
             finish.set()