@plumbus/core 0.7.3 → 0.7.5

package/instructions/ai.md

@@ -56,6 +56,11 @@ const invoice = await ctx.ai.extract({
 
 ### Classify
 
+**Start with [the classification recipe](ai-classification.md)** for provider/model
+selection, TypeSafe/Jev and Laya registration, defaults, thresholds, and cost hooks
+(core **0.7.4+**). Use `classify()` for matching labels and `decide()` for richer
+typed questions. Keep calls inside capabilities/flows.
+
 Classify text into provided categories:
 
 ```ts
@@ -101,7 +106,7 @@ await ctx.ai.generateWithUsage({
 });
 ```
 
-Omit `reasoning` to inherit prompt/config; use `null` to restore the provider/model default for one call, clearing both inherited `reasoning` and inherited legacy `reasoningEffort`. Explicit modes are `{ mode:'disabled' }`, `{ mode:'effort', effort:'minimal'|'low'|'medium'|'high'|'xhigh'|'max' }`, and `{ mode:'budget', maxTokens }`. Built-in core adapters translate the intent: OpenAI uses Chat Completions normally and switches caller-tool requests that need active/default GPT-5.6 reasoning to the Responses API; Anthropic uses `thinking` + `output_config.effort`. Responses tool continuations are stateless (`store:false`) and preserve encrypted reasoning items through server-owned `providerState`. Custom providers translate the contract in their own `AIProviderAdapter`. Unsupported modes fail with `AIInvalidRequestError` before provider I/O when the adapter can identify the incompatibility. Deprecated `reasoningEffort` remains the unchanged OpenAI-only `'low' | 'medium' | 'high'` shorthand.
+Omit `reasoning` to inherit prompt/config; use `null` to restore the provider/model default for one call, clearing both inherited `reasoning` and inherited legacy `reasoningEffort`. Explicit modes are `{ mode:'disabled' }`, `{ mode:'effort', effort:'minimal'|'low'|'medium'|'high'|'xhigh'|'max' }`, and `{ mode:'budget', maxTokens }`. Built-in core adapters translate the intent: OpenAI uses Chat Completions normally and switches caller-tool requests that need active/default GPT-5.6 or GPT-6 reasoning to the Responses API; Anthropic uses `thinking` + `output_config.effort`. GPT-6 Chat Completions use `max_completion_tokens`; GPT-6 requests omit sampling temperature unless reasoning is explicitly disabled. Responses tool continuations are stateless (`store:false`) and preserve encrypted reasoning items through server-owned `providerState`. Custom providers translate the contract in their own `AIProviderAdapter`. Unsupported modes fail with `AIInvalidRequestError` before provider I/O when the adapter can identify the incompatibility. Deprecated `reasoningEffort` remains the unchanged OpenAI-only `'low' | 'medium' | 'high'` shorthand.
 
 ### Tool calling (provider-native)
 

package/instructions/peer-dependencies.md

@@ -41,4 +41,4 @@ Run lint, format checking, typechecking, tests, and packed npm install checks be
 
 ## Consumer upgrade
 
-Read [upgrading-security-release.md](./upgrading-security-release.md), explicitly select the new package versions for every installed Plumbus add-on, and run `plumbus init --patch` for agent wiring **v16**. Keep application business logic in Plumbus primitives and `ctx.*`; do not bypass security checks to make a migration pass.
+Read [upgrading-security-release.md](./upgrading-security-release.md), explicitly select the new package versions for every installed Plumbus add-on, and run `plumbus init --patch --agent all` for current agent wiring (**v17** with core 0.7.4+). For classification/provider/model selection, read [ai-classification.md](./ai-classification.md). Keep application business logic in Plumbus primitives and `ctx.*`; do not bypass security checks to make a migration pass.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumbus/core",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "Plumbus framework core — types, SDK, runtime, CLI, test utilities",
   "type": "module",
   "main": "./dist/index.js",
@@ -72,7 +72,7 @@
     "xpath": "^0.0.34",
     "zod": "^3.24.0",
     "zod-to-json-schema": "^3.25.2",
-    "@plumbus/ai-decision": "~0.2.1"
+    "@plumbus/ai-decision": "~0.2.2"
   },
   "peerDependencies": {
     "@plumbus/api": "0.2.x",
@@ -104,10 +104,10 @@
     "@vitest/browser": "^3.0.0",
     "esbuild": "^0.25.12",
     "typescript": "^5.7.0",
-    "@plumbus/api": "0.2.1",
     "@plumbus/mcp": "0.6.1",
+    "@plumbus/voice": "0.5.2",
     "@plumbus/ai-bedrock": "0.2.1",
-    "@plumbus/voice": "0.5.2"
+    "@plumbus/api": "0.2.1"
   },
   "scripts": {
     "build": "tsc -b",