@axiastudio/aioc 0.2.6 → 0.2.7

package/README.md

@@ -43,6 +43,11 @@ AIOC `0.2.6` adds descriptor-level conditional agent handoffs with boolean `wher
 
 ### Experimental Packages
 
+`@axiastudio/aioc-regression-judge` implements the RFC-0012 companion judge
+helpers outside the core runtime package. It builds bounded judge inputs for
+run-regression suites and parses structured `RunJudgeResult` outputs while the
+host application owns the model invocation.
+
 `@axiastudio/aioc-governance-events` implements the RFC-0009 governance-event
 mapper outside the core runtime package. It derives reduced, redacted,
 event-shaped records from `RunRecord` values.
@@ -266,8 +271,8 @@ This repository also contains `aioc-inspect`, a private reference example UI for
 
 Suggested reading path: start with `example:hello`, then policy, approval,
 tool-policy, and policy-composition. Use run-record and harness examples after
-the basics; `example:non-regression` and `example:run-regression` are advanced
-workflows.
+the basics; `example:non-regression`, `example:run-regression`, and
+`example:run-regression-judge` are advanced workflows.
 
 | Command | Purpose | Needs API key |
 |---|---|---|
@@ -285,15 +290,30 @@ workflows.
 | `npm run example:rru:04-replay-hybrid` | Minimal hybrid replay | No |
 | `npm run example:non-regression` | Advanced v1/v2 run-record diff | Yes (`AIOC_EXAMPLE_PROVIDER` + matching provider API key) |
 | `npm run example:run-regression` | Local `runRegressionSuite(...)` over a modified harness | Yes (`OPENAI_API_KEY`) |
+| `npm run example:run-regression-judge` | Local `runRegressionSuite(...)` with an LLM judge | Yes (`OPENAI_API_KEY`) |
 
 Notes:
 
 - for live-provider examples, set `AIOC_EXAMPLE_PROVIDER` to `openai` or `mistral`; the matching API key must also be available
-- `example:harness-rerun` and `example:run-regression` configure OpenAI directly from `OPENAI_API_KEY`; the model is declared in the YAML descriptor
+- `example:harness-rerun`, `example:run-regression`, and `example:run-regression-judge` configure OpenAI directly from `OPENAI_API_KEY`; harness models are declared in YAML descriptors
 - run-record utility examples are deterministic and do not need a provider
 - `example:non-regression` is educational and can be non-deterministic because it uses a live provider.
 - canonical examples guide: `docs/CANONICAL-EXAMPLES.md`.
 
+### Optional LangChain Examples
+
+Optional LangChain interoperability examples live in `examples/langchain`.
+They use their own `package.json` so LangChain dependencies do not become
+dependencies of the core `@axiastudio/aioc` runtime package.
+
+They demonstrate two composition patterns:
+
+- **aioc-first, LangChain-extended**: aioc owns the governed agent run while
+  LangChain provides OSS components behind aioc tools, such as retrieval.
+- **LangGraph-orchestrated, aioc-governed**: LangGraph owns workflow
+  orchestration while selected graph nodes call aioc for policy-gated execution
+  and portable audit evidence.
+
 ## Test Commands
 
 - `npm run test:unit`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiastudio/aioc",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -14,41 +14,45 @@
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "build": "tsc -p tsconfig.json",
     "build:package": "npm run clean && tsc -p tsconfig.build.json",
+    "examples:check": "tsc -p tsconfig.examples.json --noEmit",
     "lint": "eslint ./src --ext .ts",
     "test:unit": "npm run build && node dist/tests/unit/index.js",
     "test:integration": "npm run build && node dist/tests/integration/index.js",
     "test:regression": "npm run build && node dist/tests/regression/index.js",
     "test:ci": "npm run lint && npm run build && node dist/tests/unit/index.js && node dist/tests/integration/index.js && node dist/tests/regression/index.js",
     "test:ci:stability": "npm run test:ci && npm run test:ci",
-    "example:hello": "tsx src/examples/basic/hello-world.ts",
-    "example:policy": "tsx src/examples/basic/policy.ts",
-    "example:approval-required": "tsx src/examples/basic/approval-required.ts",
-    "example:approval-evidence": "tsx src/examples/basic/approval-evidence.ts",
-    "example:tool-policy": "tsx src/examples/basic/tools.ts",
-    "example:policy-composition": "tsx src/examples/basic/policy-composition.ts",
-    "example:harness": "tsx src/examples/harness-descriptor/customer-support.ts",
-    "example:harness-rerun": "tsx src/examples/harness-descriptor/rerun-modified-harness.ts",
-    "example:run-record": "tsx src/examples/basic/run-record-sink.ts",
-    "example:rru:01-extract": "tsx src/examples/run-record-utils-minimal/01-extract-tool-calls.ts",
-    "example:rru:02-compare": "tsx src/examples/run-record-utils-minimal/02-compare-run-records.ts",
-    "example:rru:03-replay-strict": "tsx src/examples/run-record-utils-minimal/03-replay-strict.ts",
-    "example:rru:04-replay-hybrid": "tsx src/examples/run-record-utils-minimal/04-replay-hybrid.ts",
-    "example:non-regression": "tsx src/examples/non-regression/v1-v2-runrecord-diff.ts",
-    "example:run-regression": "tsx src/examples/run-regression/age-adapted-suite.ts",
+    "example:hello": "tsx examples/core/basic/hello-world.ts",
+    "example:policy": "tsx examples/core/basic/policy.ts",
+    "example:approval-required": "tsx examples/core/basic/approval-required.ts",
+    "example:approval-evidence": "tsx examples/core/basic/approval-evidence.ts",
+    "example:tool-policy": "tsx examples/core/basic/tools.ts",
+    "example:policy-composition": "tsx examples/core/basic/policy-composition.ts",
+    "example:harness": "tsx examples/core/harness-descriptor/customer-support.ts",
+    "example:harness-rerun": "tsx examples/core/harness-descriptor/rerun-modified-harness.ts",
+    "example:run-record": "tsx examples/core/basic/run-record-sink.ts",
+    "example:rru:01-extract": "tsx examples/core/run-record-utils-minimal/01-extract-tool-calls.ts",
+    "example:rru:02-compare": "tsx examples/core/run-record-utils-minimal/02-compare-run-records.ts",
+    "example:rru:03-replay-strict": "tsx examples/core/run-record-utils-minimal/03-replay-strict.ts",
+    "example:rru:04-replay-hybrid": "tsx examples/core/run-record-utils-minimal/04-replay-hybrid.ts",
+    "example:non-regression": "tsx examples/core/non-regression/v1-v2-runrecord-diff.ts",
+    "example:run-regression": "tsx examples/core/run-regression/age-adapted-suite.ts",
+    "example:run-regression-judge": "npm run regression-judge:build && tsx packages/aioc-regression-judge/examples/age-adapted-suite-with-judge.ts",
     "inspect:samples": "tsx scripts/generate-aioc-inspect-samples.ts",
     "docs:sync": "node scripts/sync-aioc-docs.mjs",
     "docs:dev": "npm run docs:sync && cd apps/aioc-docs && zsh -lc 'npm run dev'",
     "docs:build": "npm run docs:sync && cd apps/aioc-docs && zsh -lc 'npm run build'",
     "docs:preview": "cd apps/aioc-docs && zsh -lc 'npm run preview'",
-    "packages:build": "npm run governance-events:build && npm run build -w @axiastudio/aioc-export-otel && npm run build -w @axiastudio/aioc-inspect-ui",
-    "packages:test": "npm run governance-events:test && npm run export-otel:test",
+    "packages:build": "npm run governance-events:build && npm run regression-judge:build && npm run build -w @axiastudio/aioc-export-otel && npm run build -w @axiastudio/aioc-inspect-ui",
+    "packages:test": "npm run governance-events:test && npm run export-otel:test && npm run regression-judge:test",
     "governance-events:build": "npm run build && npm run build -w @axiastudio/aioc-governance-events",
     "governance-events:test": "npm run build && npm test -w @axiastudio/aioc-governance-events",
+    "regression-judge:build": "npm run build && npm run build -w @axiastudio/aioc-regression-judge",
+    "regression-judge:test": "npm run build && npm test -w @axiastudio/aioc-regression-judge",
     "export-otel:build": "npm run governance-events:build && npm run build -w @axiastudio/aioc-export-otel",
     "export-otel:test": "npm run governance-events:build && npm test -w @axiastudio/aioc-export-otel",
     "export-otel:console": "npm run governance-events:build && npm run console -w @axiastudio/aioc-export-otel",
     "export-otel:signoz": "npm run governance-events:build && npm run signoz -w @axiastudio/aioc-export-otel",
-    "test:mistral": "tsx src/examples/mistral-smoke.ts",
+    "test:mistral": "tsx examples/core/mistral-smoke.ts",
     "prepack": "npm run build:package"
   },
   "keywords": [