@plumbus/ai-decision-laya 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.2.0 — 2026-09-23
+
+- Initial optional self-hosted Laya HTTP adapter for typed choices, scores, and probabilities, using `@plumbus/ai-decision` contracts and validation.
+- Ship a persistent Python reference service pinned to Laya `0.3.5` and a CPU Dockerfile. Support preloaded English, multilingual, and typed-decision checkpoints with explicit routing identity and token-budget preflight checks.
+- Bound request/response sizes, JSON depth, HTTP handler capacity, and concurrent inference. Validate bearer authentication, content metadata, and message framing, and handle client disconnects.
+- Add a repository smoke example that manages a local server/password, retains the model cache with correct ownership, and tests both decision adapters with real inference.
+- Ship offline adapter tests, Node-to-Python HTTP tests, Python service tests, and consumer agent instructions. Python/model dependencies are installed separately from pnpm.
+- Give the combined Python contract suite an explicit Vitest timeout longer than its subprocess deadline, avoiding false failures under parallel workspace load.
+- Requires core `0.7.x`. Core `ctx.ai.decide()`, provider registration, automatic budgets/auditing, and agent discovery remain deferred.

package/README.md

@@ -0,0 +1,48 @@
+# @plumbus/ai-decision-laya
+
+Release notes: [changelog](./CHANGELOG.md) and [version/upgrade guide](../../docs/upgrading-voice-and-decision-release.md).
+
+Laya provider for self-hosted typed decision inference, with a persistent Python reference service.
+
+Version `0.2.0`; required peer `@plumbus/core` exactly `0.7.x`; Node.js 20.6+.
+Install explicitly with `pnpm add @plumbus/ai-decision-laya`. Provider packages install
+`@plumbus/ai-decision` transitively. There is no dependency on the other provider.
+
+## Scope
+
+This is the package-only foundation. Core `ctx.ai.decide()`, named definitions,
+provider registration, automatic budgets/auditing, and agent discovery are deferred.
+Do not put this adapter into core's text-generation `providers` registry.
+
+## Quick start (infrastructure / smoke testing)
+
+```ts
+import { createLayaDecisionAdapter } from '@plumbus/ai-decision-laya';
+
+const adapter = createLayaDecisionAdapter({ baseUrl: 'http://127.0.0.1:8080/v1', apiKey: process.env.LAYA_API_KEY });
+const result = await adapter.decide({
+  state: 'Please refund the duplicate charge.',
+  questions: { refund: { type: 'probability', instructions: 'Is a refund requested?' } },
+});
+console.log(result.answers.refund.probability);
+```
+
+
+Business logic belongs in Plumbus capabilities/flows and `ctx.*`. These examples
+exercise the provider protocol only; they do not provide the core execution lifecycle.
+
+## Documentation
+
+Read the [decision providers guide](https://github.com/plumbus-framework/plumbus/blob/main/docs/ai/decision-providers.md)
+for the complete contract, failure behavior, pricing, deployment, and live test environment.
+Local monorepo copy: [docs/ai/decision-providers.md](../../docs/ai/decision-providers.md).
+
+## Agent recipes
+
+- [Instructions index](instructions/README.md)
+- [Framework boundary and usage](instructions/framework.md)
+- [Testing](instructions/testing.md)
+
+## The Plumbus ecosystem
+
+`@plumbus/ai-decision-laya` is one package in the Plumbus framework. For the full list of packages and when to use each, see the [Plumbus monorepo README](https://github.com/plumbus-framework/plumbus#packages).