@gobing-ai/ts-ai-runner 0.5.20 → 0.5.21

package/README.md

@@ -832,6 +832,21 @@ Applications own decision policy and evidence selection. For example, Spur can a
 `HitlResponder` to use DecisionMaker while retaining its own HITL actions and fallback behavior;
 the workflow engine itself has no dependency on ai-runner.
 
+### Shared validators for external drivers
+
+Out-of-tree drivers reuse the same two validators instead of reimplementing neutral validation.
+Both are named exports of the main barrel:
+
+| Export | Signature | Purpose |
+| ------ | --------- | ------- |
+| `validateQuestions` | `(questions: unknown) => asserts questions is Record<string, Question>` | Rejects a malformed question map before any transport. |
+| `validateAnswers` | `(questions: Record<string, Question>, answers: unknown) => void` | Verifies answer names/kinds, label and level keys, bounded probabilities/confidence, normalized mass (tolerance `1e-6`) and rubric bounds. |
+
+The facade already runs both around every `ask`, so a driver that also calls them reports matching
+errors from its own boundary. Driver-local concerns the neutral validators do not cover (provider
+question/option counts, JSON-serializability of `state`, provider response caps) stay in the
+driver — see [`@gobing-ai/ts-decision-clef`](../decision-clef/README.md) for a worked example.
+
 ### Adding a backend driver
 
 Additional backend drivers are the intended extension point. A driver implements only `ask` —

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './ai-runner';
 export * from './decision/decision-maker';
 export * from './decision/errors';
 export * from './decision/types';
+export * from './decision/validation';
 export * from './doctor-runner';
 export * from './events';
 export * from './identity';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@ export * from './ai-runner.js';
 export * from './decision/decision-maker.js';
 export * from './decision/errors.js';
 export * from './decision/types.js';
+export * from './decision/validation.js';
 export * from './doctor-runner.js';
 export * from './events.js';
 export * from './identity.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-ai-runner",
-    "version": "0.5.20",
+    "version": "0.5.21",
     "description": "@gobing-ai/ts-ai-runner — Coding-agent shims, detection, doctor checks, and prompt execution.",
     "keywords": [
         "typescript",
@@ -47,13 +47,13 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-ai-runner-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-infra": "^0.5.20",
-        "@gobing-ai/ts-runtime": "^0.5.20",
+        "@gobing-ai/ts-infra": "^0.5.21",
+        "@gobing-ai/ts-runtime": "^0.5.21",
         "@typesafe-ai/sdk": "0.6.0"
     },
     "devDependencies": {
         "@types/bun": "1.3.14",
-        "@gobing-ai/ts-db": "^0.5.20"
+        "@gobing-ai/ts-db": "^0.5.21"
     },
     "publishConfig": {
         "access": "public"

package/src/index.ts

@@ -6,6 +6,7 @@ export * from './ai-runner';
 export * from './decision/decision-maker';
 export * from './decision/errors';
 export * from './decision/types';
+export * from './decision/validation';
 export * from './doctor-runner';
 export * from './events';
 export * from './identity';