omk-adaptorch-wpl 0.96.2 → 0.98.0

package/README.md

@@ -1,16 +1,16 @@
 # omk-adaptorch-wpl
 
-> **Status**: Stable (v0.91.0). Wired into `open-multi-agent-kit` as a runtime dependency.
-> This package implements the AdaptOrch-native Work Packet Loop (WPL) design, an original
-> execution loop whose only work-producing action is AdaptOrch's `adaptorch_run` tool. See
-> [AdaptOrch](https://adaptorch.com) for the backend product this integrates with; AdaptOrch is
-> still under active development and this integration currently targets its free **Start** tier.
+> **Status**: Published and installed as an `open-multi-agent-kit` runtime dependency.
+> The package provides Work Packet state, AdaptOrch client, adjudication, and verdict-projection
+> primitives. It does **not** wire an end-to-end dispatch loop into the default OMK CLI:
+> `src/loop.ts` explicitly excludes `adaptorch_run` submission/polling, request assembly, and
+> persistence. A caller or explicitly loaded extension must own those boundaries.
 
 ## Design documents
 
-The full design (state machine, verification layer, integration mapping, and the adversarial
-review that shaped the safety gates below) lives outside this package at
-`.omk/runs/adaptorch-native-loop-algorithm-20260701/`:
+The historical design record lives in the repository-local path
+`.omk/runs/adaptorch-native-loop-algorithm-20260701/`; it is not included in the
+published package. Current source and tests override that record:
 
 - `final-part1-core-algorithm.md` — Work Packet state machine, termination conditions, cancellation policy
 - `final-part2-verification-layer.md` — the Outcome Adjudicator (5-state verification)
@@ -22,7 +22,7 @@ review that shaped the safety gates below) lives outside this package at
 - `src/state-machine.ts` — the packet lifecycle state machine and transition guards
 - `src/adaptorch-client.ts` — thin typed wrapper around AdaptOrch's 10 MCP tools
 - `src/adjudicator.ts` + `src/adjudicator-registry.ts` — the Outcome Adjudicator and its per-`kind` registry
-- `src/loop.ts` — the integration layer wiring the state machine, AdaptOrch client, and adjudicator together
+- `src/loop.ts` — adjudication timeout, verdict projection, and next-transition helpers; not an end-to-end dispatcher
 - `src/b2c-mapper.ts` — B2C (Bridge-to-Code) mapping for patch-apply safety
 - `src/b2c-verdict.ts` — Verdict card schema for correctness wall decisions
 - `src/deep-wall.ts` — Deep verification wall for multi-runner evidence gating
@@ -30,12 +30,12 @@ review that shaped the safety gates below) lives outside this package at
 
 ## Integration
 
-The coding-agent consumes this package via:
+The default coding-agent source has no production importer that turns this package into a WPL execution path. Related surfaces are:
 
-- `packages/coding-agent/src/core/adaptorch-bridge.ts` — advisory-only bridge (default-off,
-  circuit-breaker protected, TTL-cached). Provides `getFreshHint` (sync, cache-read-only) and
-  `requestRefresh` (fire-and-forget) for the reasoning router's turn-start path.
-- `packages/coding-agent/docs/adaptorch-preview.md` — read-first planning pipeline spec.
+- `packages/coding-agent/src/core/adaptorch-bridge.ts` — separate advisory-only bridge,
+  default-off; its current transport returns no hint.
+- `packages/coding-agent/examples/extensions/correctness-wall/` — explicit opt-in extension that imports the package.
+- `packages/coding-agent/docs/adaptorch-preview.md` — planning blueprint and claim boundary.
 
 ## Safety notes (do not remove without updating the design docs)
 
@@ -46,4 +46,40 @@ The coding-agent consumes this package via:
 - Loop-level budgets (`max_dispatch_attempts`, `max_loop_duration`, dispatch-call budget) are
   immutable for a loop instance's lifetime; raising them requires a new instance under the same review.
 
+## AdaptOrch, the service
+
+This package is open source and MIT-licensed, like the rest of OMK. AdaptOrch
+itself is a separate, proprietary product: an evidence and risk layer that takes
+a change an AI wrote, runs it inside an isolated copy of the project, and
+returns one report of what the change touched, whether it ran, what the tests
+said before and after, and what looked suspicious.
+
+Nothing here calls it by default. `adaptorch-client.ts` is a typed wrapper a
+caller must configure and drive, and the coding agent's `adaptorch-bridge.ts`
+is advisory-only, default-off, and its current transport returns no hint.
+
+The division is deliberate and matches how the vendor describes its own
+boundary: AdaptOrch watches and reports, and does not rewrite code, choose a
+different answer, or merge anything. An advisory path must not acquire
+execution authority, because that is what keeps a remote suggestion from
+becoming a local action.
+
+Its published claim boundary (`DOC-CLM-001`) states what it does and does not
+claim. It verifies patch applicability through Docker-faithful apply gates,
+canonicalizes tool-generated patches into realized git diffs, separates runner
+health from candidate-caused failures, and records replayable evidence DAGs.
+It explicitly **does not prove semantic correctness** — shadow reports carry
+`correctness_claim=false` — and it blocks hidden tests, gold patches, and
+oracle labels as selector inputs. A verification pass, a manifest hash, or a
+signed receipt is evidence about a run, not authorization to ship it.
+
+The free Starter tier is self-hosted and runs on your own machine; bring-your-own
+model key is required on every tier, so no key means no run. Paid tiers add a
+hosted dashboard, shared projects, and exports.
+
+**[Review AdaptOrch plans →](https://adaptorch.com/?utm_source=github&utm_medium=package-readme&utm_campaign=omk-adaptorch-wpl#pricing)** · [claim boundary](https://adaptorch.com/claim-boundary?utm_source=github&utm_medium=package-readme&utm_campaign=omk-adaptorch-wpl)
+
+Using this package does not require AdaptOrch, and installing OMK does not
+create an account.
+
 Preview spec: [`../coding-agent/docs/adaptorch-preview.md`](../coding-agent/docs/adaptorch-preview.md)

package/dist/adaptorch-api-types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * AdaptOrch User API v1 data types.
+ *
+ * Projected from `contracts/openapi/adaptorch-user-api.v1.yaml` in the
+ * Adaptorch-MCP repository. Optional fields are optional here because the
+ * contract marks them so; a field absent from the contract is absent here.
+ */
+/** Lifecycle states a run can report. */
+export type RunStatus = "QUEUED" | "RUNNING" | "SUCCEEDED" | "FAILED" | "CANCELLING";
+export interface Run {
+    readonly run_id: string;
+    readonly status: RunStatus;
+    readonly kind?: string;
+    readonly phase?: string;
+    readonly created_at?: string;
+    readonly policy_version?: string;
+    readonly project_id?: string;
+    readonly links?: Record<string, unknown>;
+}
+export interface RunListResponse {
+    readonly items: readonly Run[];
+    readonly next_cursor?: string;
+}
+/** Body accepted by `POST /v1/runs`. The contract bounds `subtasks` to 1..50. */
+export interface RunSubmission {
+    readonly subtasks: readonly Record<string, unknown>[];
+    readonly dependencies?: readonly Record<string, unknown>[];
+    readonly model?: string | null;
+    readonly synthesis_mode?: string | null;
+    readonly global_context?: string | null;
+}
+export interface CapabilitySet {
+    readonly api_version: string;
+    readonly features: readonly string[];
+    readonly run_types?: readonly string[];
+}
+export interface Principal {
+    readonly subject_id: string;
+    readonly project_id?: string;
+}
+/** One graded check. `status` is a free-form outcome label such as `PASSED`. */
+export interface EvidenceCheck {
+    readonly name: string;
+    readonly status: string;
+}
+export interface EvidenceReport {
+    readonly run_id: string;
+    readonly checks: readonly EvidenceCheck[];
+}
+export interface Artifact {
+    readonly artifact_id: string;
+    readonly name: string;
+    readonly media_type?: string;
+    readonly size_bytes?: number;
+    readonly sha256?: string;
+    readonly download_url?: string;
+}
+export interface ArtifactListResponse {
+    readonly run_id: string;
+    readonly items: readonly Artifact[];
+}
+/** Documented filters for `GET /v1/runs`. */
+export interface ListRunsQuery {
+    readonly status?: RunStatus;
+    readonly projectId?: string;
+    readonly limit?: number;
+    readonly cursor?: string;
+}
+//# sourceMappingURL=adaptorch-api-types.d.ts.map

package/dist/adaptorch-api-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptorch-api-types.d.ts","sourceRoot":"","sources":["../src/adaptorch-api-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yCAAyC;AACzC,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAErF,MAAM,WAAW,GAAG;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CACpC;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB","sourcesContent":["/**\n * AdaptOrch User API v1 data types.\n *\n * Projected from `contracts/openapi/adaptorch-user-api.v1.yaml` in the\n * Adaptorch-MCP repository. Optional fields are optional here because the\n * contract marks them so; a field absent from the contract is absent here.\n */\n\n/** Lifecycle states a run can report. */\nexport type RunStatus = \"QUEUED\" | \"RUNNING\" | \"SUCCEEDED\" | \"FAILED\" | \"CANCELLING\";\n\nexport interface Run {\n\treadonly run_id: string;\n\treadonly status: RunStatus;\n\treadonly kind?: string;\n\treadonly phase?: string;\n\treadonly created_at?: string;\n\treadonly policy_version?: string;\n\treadonly project_id?: string;\n\treadonly links?: Record<string, unknown>;\n}\n\nexport interface RunListResponse {\n\treadonly items: readonly Run[];\n\treadonly next_cursor?: string;\n}\n\n/** Body accepted by `POST /v1/runs`. The contract bounds `subtasks` to 1..50. */\nexport interface RunSubmission {\n\treadonly subtasks: readonly Record<string, unknown>[];\n\treadonly dependencies?: readonly Record<string, unknown>[];\n\treadonly model?: string | null;\n\treadonly synthesis_mode?: string | null;\n\treadonly global_context?: string | null;\n}\n\nexport interface CapabilitySet {\n\treadonly api_version: string;\n\treadonly features: readonly string[];\n\treadonly run_types?: readonly string[];\n}\n\nexport interface Principal {\n\treadonly subject_id: string;\n\treadonly project_id?: string;\n}\n\n/** One graded check. `status` is a free-form outcome label such as `PASSED`. */\nexport interface EvidenceCheck {\n\treadonly name: string;\n\treadonly status: string;\n}\n\nexport interface EvidenceReport {\n\treadonly run_id: string;\n\treadonly checks: readonly EvidenceCheck[];\n}\n\nexport interface Artifact {\n\treadonly artifact_id: string;\n\treadonly name: string;\n\treadonly media_type?: string;\n\treadonly size_bytes?: number;\n\treadonly sha256?: string;\n\treadonly download_url?: string;\n}\n\nexport interface ArtifactListResponse {\n\treadonly run_id: string;\n\treadonly items: readonly Artifact[];\n}\n\n/** Documented filters for `GET /v1/runs`. */\nexport interface ListRunsQuery {\n\treadonly status?: RunStatus;\n\treadonly projectId?: string;\n\treadonly limit?: number;\n\treadonly cursor?: string;\n}\n"]}

package/dist/adaptorch-api-types.js

@@ -0,0 +1,9 @@
+/**
+ * AdaptOrch User API v1 data types.
+ *
+ * Projected from `contracts/openapi/adaptorch-user-api.v1.yaml` in the
+ * Adaptorch-MCP repository. Optional fields are optional here because the
+ * contract marks them so; a field absent from the contract is absent here.
+ */
+export {};
+//# sourceMappingURL=adaptorch-api-types.js.map

package/dist/adaptorch-api-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptorch-api-types.js","sourceRoot":"","sources":["../src/adaptorch-api-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * AdaptOrch User API v1 data types.\n *\n * Projected from `contracts/openapi/adaptorch-user-api.v1.yaml` in the\n * Adaptorch-MCP repository. Optional fields are optional here because the\n * contract marks them so; a field absent from the contract is absent here.\n */\n\n/** Lifecycle states a run can report. */\nexport type RunStatus = \"QUEUED\" | \"RUNNING\" | \"SUCCEEDED\" | \"FAILED\" | \"CANCELLING\";\n\nexport interface Run {\n\treadonly run_id: string;\n\treadonly status: RunStatus;\n\treadonly kind?: string;\n\treadonly phase?: string;\n\treadonly created_at?: string;\n\treadonly policy_version?: string;\n\treadonly project_id?: string;\n\treadonly links?: Record<string, unknown>;\n}\n\nexport interface RunListResponse {\n\treadonly items: readonly Run[];\n\treadonly next_cursor?: string;\n}\n\n/** Body accepted by `POST /v1/runs`. The contract bounds `subtasks` to 1..50. */\nexport interface RunSubmission {\n\treadonly subtasks: readonly Record<string, unknown>[];\n\treadonly dependencies?: readonly Record<string, unknown>[];\n\treadonly model?: string | null;\n\treadonly synthesis_mode?: string | null;\n\treadonly global_context?: string | null;\n}\n\nexport interface CapabilitySet {\n\treadonly api_version: string;\n\treadonly features: readonly string[];\n\treadonly run_types?: readonly string[];\n}\n\nexport interface Principal {\n\treadonly subject_id: string;\n\treadonly project_id?: string;\n}\n\n/** One graded check. `status` is a free-form outcome label such as `PASSED`. */\nexport interface EvidenceCheck {\n\treadonly name: string;\n\treadonly status: string;\n}\n\nexport interface EvidenceReport {\n\treadonly run_id: string;\n\treadonly checks: readonly EvidenceCheck[];\n}\n\nexport interface Artifact {\n\treadonly artifact_id: string;\n\treadonly name: string;\n\treadonly media_type?: string;\n\treadonly size_bytes?: number;\n\treadonly sha256?: string;\n\treadonly download_url?: string;\n}\n\nexport interface ArtifactListResponse {\n\treadonly run_id: string;\n\treadonly items: readonly Artifact[];\n}\n\n/** Documented filters for `GET /v1/runs`. */\nexport interface ListRunsQuery {\n\treadonly status?: RunStatus;\n\treadonly projectId?: string;\n\treadonly limit?: number;\n\treadonly cursor?: string;\n}\n"]}

package/dist/adaptorch-api.d.ts

@@ -0,0 +1,87 @@
+/**
+ * AdaptOrch User API v1 client.
+ *
+ * This is the hosted path, and it is deliberately separate from
+ * `adaptorch-client.ts`: that module wraps the MCP tool surface, which reaches
+ * a *local* parent engine, while this one speaks plain HTTPS to the control
+ * plane and needs nothing installed beyond an API key.
+ *
+ * Following the same rule as the MCP wrapper, this package still opens no
+ * network I/O of its own. The caller injects `fetch`, so a test never needs a
+ * socket and a host application keeps ownership of its HTTP stack.
+ */
+import type { ArtifactListResponse, CapabilitySet, EvidenceReport, ListRunsQuery, Principal, Run, RunListResponse, RunSubmission } from "./adaptorch-api-types.ts";
+export type * from "./adaptorch-api-types.ts";
+export interface AdaptOrchRequestInit {
+    readonly method: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body?: string;
+}
+export interface AdaptOrchHttpResponse {
+    readonly status: number;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+}
+/** Injected HTTP boundary. `globalThis.fetch` satisfies this shape. */
+export type AdaptOrchFetch = (url: string, init: AdaptOrchRequestInit) => Promise<AdaptOrchHttpResponse>;
+export interface AdaptOrchApiConfig {
+    readonly baseUrl: string;
+    readonly apiKey: string;
+    readonly fetch: AdaptOrchFetch;
+}
+/** A non-2xx response, carrying the server's sanitized code and message. */
+export declare class AdaptOrchApiError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    constructor(status: number, code: string | undefined, message: string);
+}
+/**
+ * Choose the credential header.
+ *
+ * A tenant dashboard key carries the documented `ado_` prefix and must travel
+ * only as `X-API-Key`; the contract explicitly forbids also sending it in
+ * `Authorization`. Anything else is a non-tenant service credential and uses a
+ * bearer token. Sending both would leak a tenant key into a header the control
+ * plane does not expect it in.
+ */
+export declare function resolveAuthHeaders(apiKey: string): Record<string, string>;
+/**
+ * Reject a base URL that would put a credential on the wire in plaintext.
+ * Plain HTTP is allowed only for an exact loopback host, so a lookalike such as
+ * `localhost.evil.test` does not slip through a prefix check.
+ */
+export declare function assertSafeApiUrl(baseUrl: string): void;
+/** Default control-plane origin, overridable with `ADAPTORCH_API_URL`. */
+export declare const ADAPTORCH_DEFAULT_API_URL = "https://api.adaptorch.com";
+/**
+ * Build a client from the environment: `ADAPTORCH_API_KEY` and an optional
+ * `ADAPTORCH_API_URL`. Returns `undefined` when no key is configured, so a
+ * caller can treat AdaptOrch as an opt-in the operator enables rather than a
+ * dependency that must be present.
+ */
+export declare function createAdaptOrchApiClientFromEnv(fetchImpl: AdaptOrchFetch, env?: Readonly<Record<string, string | undefined>>): AdaptOrchApiClient | undefined;
+/** Typed client for the AdaptOrch User API v1. */
+export declare class AdaptOrchApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly fetch;
+    constructor(config: AdaptOrchApiConfig);
+    private request;
+    /** `GET /v1/capabilities` — API version and enabled features. */
+    capabilities(): Promise<CapabilitySet>;
+    /** `GET /v1/whoami` — the calling principal, for verifying a key works. */
+    whoami(): Promise<Principal>;
+    /** `POST /v1/runs` — submit work. The contract bounds `subtasks` to 1..50. */
+    submitRun(submission: RunSubmission): Promise<Run>;
+    /** `GET /v1/runs` — list runs, filtered by the documented parameters only. */
+    listRuns(query?: ListRunsQuery): Promise<RunListResponse>;
+    /** `GET /v1/runs/{run_id}` — one run's current state. */
+    getRun(runId: string): Promise<Run>;
+    /** `PUT /v1/runs/{run_id}/cancel` — request cancellation. */
+    cancelRun(runId: string, reason?: string): Promise<Run>;
+    /** `GET /v1/runs/{run_id}/evidence` — the graded checks for a run. */
+    getEvidence(runId: string): Promise<EvidenceReport>;
+    /** `GET /v1/runs/{run_id}/artifacts` — artifacts a run produced. */
+    listArtifacts(runId: string): Promise<ArtifactListResponse>;
+}
+//# sourceMappingURL=adaptorch-api.d.ts.map

package/dist/adaptorch-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptorch-api.d.ts","sourceRoot":"","sources":["../src/adaptorch-api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AdaptOrch User API v1 client.\n *\n * This is the hosted path, and it is deliberately separate from\n * `adaptorch-client.ts`: that module wraps the MCP tool surface, which reaches\n * a *local* parent engine, while this one speaks plain HTTPS to the control\n * plane and needs nothing installed beyond an API key.\n *\n * Following the same rule as the MCP wrapper, this package still opens no\n * network I/O of its own. The caller injects `fetch`, so a test never needs a\n * socket and a host application keeps ownership of its HTTP stack.\n */\n\nimport type {\n\tArtifactListResponse,\n\tCapabilitySet,\n\tEvidenceReport,\n\tListRunsQuery,\n\tPrincipal,\n\tRun,\n\tRunListResponse,\n\tRunSubmission,\n} from \"./adaptorch-api-types.ts\";\n\nexport type * from \"./adaptorch-api-types.ts\";\n\nexport interface AdaptOrchRequestInit {\n\treadonly method: string;\n\treadonly headers: Readonly<Record<string, string>>;\n\treadonly body?: string;\n}\n\nexport interface AdaptOrchHttpResponse {\n\treadonly status: number;\n\tjson(): Promise<unknown>;\n\ttext(): Promise<string>;\n}\n\n/** Injected HTTP boundary. `globalThis.fetch` satisfies this shape. */\nexport type AdaptOrchFetch = (url: string, init: AdaptOrchRequestInit) => Promise<AdaptOrchHttpResponse>;\n\nexport interface AdaptOrchApiConfig {\n\treadonly baseUrl: string;\n\treadonly apiKey: string;\n\treadonly fetch: AdaptOrchFetch;\n}\n\n/** A non-2xx response, carrying the server's sanitized code and message. */\nexport class AdaptOrchApiError extends Error {\n\treadonly status: number;\n\treadonly code: string | undefined;\n\n\tconstructor(status: number, code: string | undefined, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"AdaptOrchApiError\";\n\t\tthis.status = status;\n\t\tthis.code = code;\n\t}\n}\n\nconst LOOPBACK_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"::1\"]);\n\n/**\n * Choose the credential header.\n *\n * A tenant dashboard key carries the documented `ado_` prefix and must travel\n * only as `X-API-Key`; the contract explicitly forbids also sending it in\n * `Authorization`. Anything else is a non-tenant service credential and uses a\n * bearer token. Sending both would leak a tenant key into a header the control\n * plane does not expect it in.\n */\nexport function resolveAuthHeaders(apiKey: string): Record<string, string> {\n\tconst key = apiKey.trim();\n\tif (key === \"\") throw new Error(\"AdaptOrch API key is required\");\n\treturn key.startsWith(\"ado_\") ? { \"X-API-Key\": key } : { Authorization: `Bearer ${key}` };\n}\n\n/**\n * Reject a base URL that would put a credential on the wire in plaintext.\n * Plain HTTP is allowed only for an exact loopback host, so a lookalike such as\n * `localhost.evil.test` does not slip through a prefix check.\n */\nexport function assertSafeApiUrl(baseUrl: string): void {\n\tlet url: URL;\n\ttry {\n\t\turl = new URL(baseUrl);\n\t} catch {\n\t\tthrow new Error(`AdaptOrch base URL is not a valid URL: ${baseUrl}`);\n\t}\n\tif (url.protocol === \"https:\") return;\n\tif (url.protocol === \"http:\" && LOOPBACK_HOSTS.has(url.hostname.replace(/^\\[|\\]$/g, \"\"))) return;\n\tthrow new Error(`AdaptOrch base URL must use https (or http on loopback): ${baseUrl}`);\n}\n\n/** Remove a credential from any text that is about to become an error message. */\nfunction redact(text: string, apiKey: string): string {\n\tconst key = apiKey.trim();\n\treturn key === \"\" ? text : text.split(key).join(\"[REDACTED]\");\n}\n\nfunction readErrorFields(body: unknown): { code?: string; message?: string } {\n\tif (typeof body !== \"object\" || body === null) return {};\n\tconst record = body as Record<string, unknown>;\n\treturn {\n\t\t...(typeof record.code === \"string\" ? { code: record.code } : {}),\n\t\t...(typeof record.message === \"string\" ? { message: record.message } : {}),\n\t};\n}\n\n/** Default control-plane origin, overridable with `ADAPTORCH_API_URL`. */\nexport const ADAPTORCH_DEFAULT_API_URL = \"https://api.adaptorch.com\";\n\n/**\n * Build a client from the environment: `ADAPTORCH_API_KEY` and an optional\n * `ADAPTORCH_API_URL`. Returns `undefined` when no key is configured, so a\n * caller can treat AdaptOrch as an opt-in the operator enables rather than a\n * dependency that must be present.\n */\nexport function createAdaptOrchApiClientFromEnv(\n\tfetchImpl: AdaptOrchFetch,\n\tenv: Readonly<Record<string, string | undefined>> = process.env,\n): AdaptOrchApiClient | undefined {\n\tconst apiKey = env.ADAPTORCH_API_KEY?.trim();\n\tif (!apiKey) return undefined;\n\treturn new AdaptOrchApiClient({\n\t\tbaseUrl: env.ADAPTORCH_API_URL?.trim() || ADAPTORCH_DEFAULT_API_URL,\n\t\tapiKey,\n\t\tfetch: fetchImpl,\n\t});\n}\n\n/** Typed client for the AdaptOrch User API v1. */\nexport class AdaptOrchApiClient {\n\tprivate readonly baseUrl: string;\n\tprivate readonly apiKey: string;\n\tprivate readonly fetch: AdaptOrchFetch;\n\n\tconstructor(config: AdaptOrchApiConfig) {\n\t\tassertSafeApiUrl(config.baseUrl);\n\t\tresolveAuthHeaders(config.apiKey);\n\t\tthis.baseUrl = config.baseUrl.replace(/\\/+$/, \"\");\n\t\tthis.apiKey = config.apiKey;\n\t\tthis.fetch = config.fetch;\n\t}\n\n\tprivate async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n\t\tconst init: AdaptOrchRequestInit = {\n\t\t\tmethod,\n\t\t\theaders: {\n\t\t\t\tAccept: \"application/json\",\n\t\t\t\t...resolveAuthHeaders(this.apiKey),\n\t\t\t\t...(body === undefined ? {} : { \"Content-Type\": \"application/json\" }),\n\t\t\t},\n\t\t\t...(body === undefined ? {} : { body: JSON.stringify(body) }),\n\t\t};\n\n\t\tlet response: AdaptOrchHttpResponse;\n\t\ttry {\n\t\t\tresponse = await this.fetch(`${this.baseUrl}${path}`, init);\n\t\t} catch (error) {\n\t\t\tconst detail = error instanceof Error ? error.message : String(error);\n\t\t\tthrow new Error(`AdaptOrch request failed: ${redact(detail, this.apiKey)}`);\n\t\t}\n\n\t\tlet payload: unknown;\n\t\ttry {\n\t\t\tpayload = await response.json();\n\t\t} catch {\n\t\t\t// A body that is absent or not JSON is not itself a failure: the status\n\t\t\t// still decides, and an error response keeps its generic message.\n\t\t\tpayload = undefined;\n\t\t}\n\t\tif (response.status < 200 || response.status >= 300) {\n\t\t\tconst { code, message } = readErrorFields(payload);\n\t\t\tthrow new AdaptOrchApiError(\n\t\t\t\tresponse.status,\n\t\t\t\tcode,\n\t\t\t\tredact(message ?? `AdaptOrch request failed with status ${response.status}`, this.apiKey),\n\t\t\t);\n\t\t}\n\t\treturn payload as T;\n\t}\n\n\t/** `GET /v1/capabilities` — API version and enabled features. */\n\tcapabilities(): Promise<CapabilitySet> {\n\t\treturn this.request<CapabilitySet>(\"GET\", \"/v1/capabilities\");\n\t}\n\n\t/** `GET /v1/whoami` — the calling principal, for verifying a key works. */\n\twhoami(): Promise<Principal> {\n\t\treturn this.request<Principal>(\"GET\", \"/v1/whoami\");\n\t}\n\n\t/** `POST /v1/runs` — submit work. The contract bounds `subtasks` to 1..50. */\n\tsubmitRun(submission: RunSubmission): Promise<Run> {\n\t\treturn this.request<Run>(\"POST\", \"/v1/runs\", submission);\n\t}\n\n\t/** `GET /v1/runs` — list runs, filtered by the documented parameters only. */\n\tlistRuns(query: ListRunsQuery = {}): Promise<RunListResponse> {\n\t\tconst params = new URLSearchParams();\n\t\tif (query.status !== undefined) params.set(\"status\", query.status);\n\t\tif (query.projectId !== undefined) params.set(\"project_id\", query.projectId);\n\t\tif (query.limit !== undefined) params.set(\"limit\", String(query.limit));\n\t\tif (query.cursor !== undefined) params.set(\"cursor\", query.cursor);\n\t\tconst suffix = params.size === 0 ? \"\" : `?${params.toString()}`;\n\t\treturn this.request<RunListResponse>(\"GET\", `/v1/runs${suffix}`);\n\t}\n\n\t/** `GET /v1/runs/{run_id}` — one run's current state. */\n\tgetRun(runId: string): Promise<Run> {\n\t\treturn this.request<Run>(\"GET\", `/v1/runs/${encodeURIComponent(runId)}`);\n\t}\n\n\t/** `PUT /v1/runs/{run_id}/cancel` — request cancellation. */\n\tcancelRun(runId: string, reason?: string): Promise<Run> {\n\t\treturn this.request<Run>(\n\t\t\t\"PUT\",\n\t\t\t`/v1/runs/${encodeURIComponent(runId)}/cancel`,\n\t\t\treason === undefined ? {} : { reason },\n\t\t);\n\t}\n\n\t/** `GET /v1/runs/{run_id}/evidence` — the graded checks for a run. */\n\tgetEvidence(runId: string): Promise<EvidenceReport> {\n\t\treturn this.request<EvidenceReport>(\"GET\", `/v1/runs/${encodeURIComponent(runId)}/evidence`);\n\t}\n\n\t/** `GET /v1/runs/{run_id}/artifacts` — artifacts a run produced. */\n\tlistArtifacts(runId: string): Promise<ArtifactListResponse> {\n\t\treturn this.request<ArtifactListResponse>(\"GET\", `/v1/runs/${encodeURIComponent(runId)}/artifacts`);\n\t}\n}\n"]}

package/dist/adaptorch-api.js

@@ -0,0 +1,179 @@
+/**
+ * AdaptOrch User API v1 client.
+ *
+ * This is the hosted path, and it is deliberately separate from
+ * `adaptorch-client.ts`: that module wraps the MCP tool surface, which reaches
+ * a *local* parent engine, while this one speaks plain HTTPS to the control
+ * plane and needs nothing installed beyond an API key.
+ *
+ * Following the same rule as the MCP wrapper, this package still opens no
+ * network I/O of its own. The caller injects `fetch`, so a test never needs a
+ * socket and a host application keeps ownership of its HTTP stack.
+ */
+/** A non-2xx response, carrying the server's sanitized code and message. */
+export class AdaptOrchApiError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.name = "AdaptOrchApiError";
+        this.status = status;
+        this.code = code;
+    }
+}
+const LOOPBACK_HOSTS = new Set(["localhost", "127.0.0.1", "::1"]);
+/**
+ * Choose the credential header.
+ *
+ * A tenant dashboard key carries the documented `ado_` prefix and must travel
+ * only as `X-API-Key`; the contract explicitly forbids also sending it in
+ * `Authorization`. Anything else is a non-tenant service credential and uses a
+ * bearer token. Sending both would leak a tenant key into a header the control
+ * plane does not expect it in.
+ */
+export function resolveAuthHeaders(apiKey) {
+    const key = apiKey.trim();
+    if (key === "")
+        throw new Error("AdaptOrch API key is required");
+    return key.startsWith("ado_") ? { "X-API-Key": key } : { Authorization: `Bearer ${key}` };
+}
+/**
+ * Reject a base URL that would put a credential on the wire in plaintext.
+ * Plain HTTP is allowed only for an exact loopback host, so a lookalike such as
+ * `localhost.evil.test` does not slip through a prefix check.
+ */
+export function assertSafeApiUrl(baseUrl) {
+    let url;
+    try {
+        url = new URL(baseUrl);
+    }
+    catch {
+        throw new Error(`AdaptOrch base URL is not a valid URL: ${baseUrl}`);
+    }
+    if (url.protocol === "https:")
+        return;
+    if (url.protocol === "http:" && LOOPBACK_HOSTS.has(url.hostname.replace(/^\[|\]$/g, "")))
+        return;
+    throw new Error(`AdaptOrch base URL must use https (or http on loopback): ${baseUrl}`);
+}
+/** Remove a credential from any text that is about to become an error message. */
+function redact(text, apiKey) {
+    const key = apiKey.trim();
+    return key === "" ? text : text.split(key).join("[REDACTED]");
+}
+function readErrorFields(body) {
+    if (typeof body !== "object" || body === null)
+        return {};
+    const record = body;
+    return {
+        ...(typeof record.code === "string" ? { code: record.code } : {}),
+        ...(typeof record.message === "string" ? { message: record.message } : {}),
+    };
+}
+/** Default control-plane origin, overridable with `ADAPTORCH_API_URL`. */
+export const ADAPTORCH_DEFAULT_API_URL = "https://api.adaptorch.com";
+/**
+ * Build a client from the environment: `ADAPTORCH_API_KEY` and an optional
+ * `ADAPTORCH_API_URL`. Returns `undefined` when no key is configured, so a
+ * caller can treat AdaptOrch as an opt-in the operator enables rather than a
+ * dependency that must be present.
+ */
+export function createAdaptOrchApiClientFromEnv(fetchImpl, env = process.env) {
+    const apiKey = env.ADAPTORCH_API_KEY?.trim();
+    if (!apiKey)
+        return undefined;
+    return new AdaptOrchApiClient({
+        baseUrl: env.ADAPTORCH_API_URL?.trim() || ADAPTORCH_DEFAULT_API_URL,
+        apiKey,
+        fetch: fetchImpl,
+    });
+}
+/** Typed client for the AdaptOrch User API v1. */
+export class AdaptOrchApiClient {
+    baseUrl;
+    apiKey;
+    fetch;
+    constructor(config) {
+        assertSafeApiUrl(config.baseUrl);
+        resolveAuthHeaders(config.apiKey);
+        this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+        this.apiKey = config.apiKey;
+        this.fetch = config.fetch;
+    }
+    async request(method, path, body) {
+        const init = {
+            method,
+            headers: {
+                Accept: "application/json",
+                ...resolveAuthHeaders(this.apiKey),
+                ...(body === undefined ? {} : { "Content-Type": "application/json" }),
+            },
+            ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+        };
+        let response;
+        try {
+            response = await this.fetch(`${this.baseUrl}${path}`, init);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            throw new Error(`AdaptOrch request failed: ${redact(detail, this.apiKey)}`);
+        }
+        let payload;
+        try {
+            payload = await response.json();
+        }
+        catch {
+            // A body that is absent or not JSON is not itself a failure: the status
+            // still decides, and an error response keeps its generic message.
+            payload = undefined;
+        }
+        if (response.status < 200 || response.status >= 300) {
+            const { code, message } = readErrorFields(payload);
+            throw new AdaptOrchApiError(response.status, code, redact(message ?? `AdaptOrch request failed with status ${response.status}`, this.apiKey));
+        }
+        return payload;
+    }
+    /** `GET /v1/capabilities` — API version and enabled features. */
+    capabilities() {
+        return this.request("GET", "/v1/capabilities");
+    }
+    /** `GET /v1/whoami` — the calling principal, for verifying a key works. */
+    whoami() {
+        return this.request("GET", "/v1/whoami");
+    }
+    /** `POST /v1/runs` — submit work. The contract bounds `subtasks` to 1..50. */
+    submitRun(submission) {
+        return this.request("POST", "/v1/runs", submission);
+    }
+    /** `GET /v1/runs` — list runs, filtered by the documented parameters only. */
+    listRuns(query = {}) {
+        const params = new URLSearchParams();
+        if (query.status !== undefined)
+            params.set("status", query.status);
+        if (query.projectId !== undefined)
+            params.set("project_id", query.projectId);
+        if (query.limit !== undefined)
+            params.set("limit", String(query.limit));
+        if (query.cursor !== undefined)
+            params.set("cursor", query.cursor);
+        const suffix = params.size === 0 ? "" : `?${params.toString()}`;
+        return this.request("GET", `/v1/runs${suffix}`);
+    }
+    /** `GET /v1/runs/{run_id}` — one run's current state. */
+    getRun(runId) {
+        return this.request("GET", `/v1/runs/${encodeURIComponent(runId)}`);
+    }
+    /** `PUT /v1/runs/{run_id}/cancel` — request cancellation. */
+    cancelRun(runId, reason) {
+        return this.request("PUT", `/v1/runs/${encodeURIComponent(runId)}/cancel`, reason === undefined ? {} : { reason });
+    }
+    /** `GET /v1/runs/{run_id}/evidence` — the graded checks for a run. */
+    getEvidence(runId) {
+        return this.request("GET", `/v1/runs/${encodeURIComponent(runId)}/evidence`);
+    }
+    /** `GET /v1/runs/{run_id}/artifacts` — artifacts a run produced. */
+    listArtifacts(runId) {
+        return this.request("GET", `/v1/runs/${encodeURIComponent(runId)}/artifacts`);
+    }
+}
+//# sourceMappingURL=adaptorch-api.js.map

package/dist/adaptorch-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptorch-api.js","sourceRoot":"","sources":["../src/adaptorch-api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AdaptOrch User API v1 client.\n *\n * This is the hosted path, and it is deliberately separate from\n * `adaptorch-client.ts`: that module wraps the MCP tool surface, which reaches\n * a *local* parent engine, while this one speaks plain HTTPS to the control\n * plane and needs nothing installed beyond an API key.\n *\n * Following the same rule as the MCP wrapper, this package still opens no\n * network I/O of its own. The caller injects `fetch`, so a test never needs a\n * socket and a host application keeps ownership of its HTTP stack.\n */\n\nimport type {\n\tArtifactListResponse,\n\tCapabilitySet,\n\tEvidenceReport,\n\tListRunsQuery,\n\tPrincipal,\n\tRun,\n\tRunListResponse,\n\tRunSubmission,\n} from \"./adaptorch-api-types.ts\";\n\nexport type * from \"./adaptorch-api-types.ts\";\n\nexport interface AdaptOrchRequestInit {\n\treadonly method: string;\n\treadonly headers: Readonly<Record<string, string>>;\n\treadonly body?: string;\n}\n\nexport interface AdaptOrchHttpResponse {\n\treadonly status: number;\n\tjson(): Promise<unknown>;\n\ttext(): Promise<string>;\n}\n\n/** Injected HTTP boundary. `globalThis.fetch` satisfies this shape. */\nexport type AdaptOrchFetch = (url: string, init: AdaptOrchRequestInit) => Promise<AdaptOrchHttpResponse>;\n\nexport interface AdaptOrchApiConfig {\n\treadonly baseUrl: string;\n\treadonly apiKey: string;\n\treadonly fetch: AdaptOrchFetch;\n}\n\n/** A non-2xx response, carrying the server's sanitized code and message. */\nexport class AdaptOrchApiError extends Error {\n\treadonly status: number;\n\treadonly code: string | undefined;\n\n\tconstructor(status: number, code: string | undefined, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"AdaptOrchApiError\";\n\t\tthis.status = status;\n\t\tthis.code = code;\n\t}\n}\n\nconst LOOPBACK_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"::1\"]);\n\n/**\n * Choose the credential header.\n *\n * A tenant dashboard key carries the documented `ado_` prefix and must travel\n * only as `X-API-Key`; the contract explicitly forbids also sending it in\n * `Authorization`. Anything else is a non-tenant service credential and uses a\n * bearer token. Sending both would leak a tenant key into a header the control\n * plane does not expect it in.\n */\nexport function resolveAuthHeaders(apiKey: string): Record<string, string> {\n\tconst key = apiKey.trim();\n\tif (key === \"\") throw new Error(\"AdaptOrch API key is required\");\n\treturn key.startsWith(\"ado_\") ? { \"X-API-Key\": key } : { Authorization: `Bearer ${key}` };\n}\n\n/**\n * Reject a base URL that would put a credential on the wire in plaintext.\n * Plain HTTP is allowed only for an exact loopback host, so a lookalike such as\n * `localhost.evil.test` does not slip through a prefix check.\n */\nexport function assertSafeApiUrl(baseUrl: string): void {\n\tlet url: URL;\n\ttry {\n\t\turl = new URL(baseUrl);\n\t} catch {\n\t\tthrow new Error(`AdaptOrch base URL is not a valid URL: ${baseUrl}`);\n\t}\n\tif (url.protocol === \"https:\") return;\n\tif (url.protocol === \"http:\" && LOOPBACK_HOSTS.has(url.hostname.replace(/^\\[|\\]$/g, \"\"))) return;\n\tthrow new Error(`AdaptOrch base URL must use https (or http on loopback): ${baseUrl}`);\n}\n\n/** Remove a credential from any text that is about to become an error message. */\nfunction redact(text: string, apiKey: string): string {\n\tconst key = apiKey.trim();\n\treturn key === \"\" ? text : text.split(key).join(\"[REDACTED]\");\n}\n\nfunction readErrorFields(body: unknown): { code?: string; message?: string } {\n\tif (typeof body !== \"object\" || body === null) return {};\n\tconst record = body as Record<string, unknown>;\n\treturn {\n\t\t...(typeof record.code === \"string\" ? { code: record.code } : {}),\n\t\t...(typeof record.message === \"string\" ? { message: record.message } : {}),\n\t};\n}\n\n/** Default control-plane origin, overridable with `ADAPTORCH_API_URL`. */\nexport const ADAPTORCH_DEFAULT_API_URL = \"https://api.adaptorch.com\";\n\n/**\n * Build a client from the environment: `ADAPTORCH_API_KEY` and an optional\n * `ADAPTORCH_API_URL`. Returns `undefined` when no key is configured, so a\n * caller can treat AdaptOrch as an opt-in the operator enables rather than a\n * dependency that must be present.\n */\nexport function createAdaptOrchApiClientFromEnv(\n\tfetchImpl: AdaptOrchFetch,\n\tenv: Readonly<Record<string, string | undefined>> = process.env,\n): AdaptOrchApiClient | undefined {\n\tconst apiKey = env.ADAPTORCH_API_KEY?.trim();\n\tif (!apiKey) return undefined;\n\treturn new AdaptOrchApiClient({\n\t\tbaseUrl: env.ADAPTORCH_API_URL?.trim() || ADAPTORCH_DEFAULT_API_URL,\n\t\tapiKey,\n\t\tfetch: fetchImpl,\n\t});\n}\n\n/** Typed client for the AdaptOrch User API v1. */\nexport class AdaptOrchApiClient {\n\tprivate readonly baseUrl: string;\n\tprivate readonly apiKey: string;\n\tprivate readonly fetch: AdaptOrchFetch;\n\n\tconstructor(config: AdaptOrchApiConfig) {\n\t\tassertSafeApiUrl(config.baseUrl);\n\t\tresolveAuthHeaders(config.apiKey);\n\t\tthis.baseUrl = config.baseUrl.replace(/\\/+$/, \"\");\n\t\tthis.apiKey = config.apiKey;\n\t\tthis.fetch = config.fetch;\n\t}\n\n\tprivate async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n\t\tconst init: AdaptOrchRequestInit = {\n\t\t\tmethod,\n\t\t\theaders: {\n\t\t\t\tAccept: \"application/json\",\n\t\t\t\t...resolveAuthHeaders(this.apiKey),\n\t\t\t\t...(body === undefined ? {} : { \"Content-Type\": \"application/json\" }),\n\t\t\t},\n\t\t\t...(body === undefined ? {} : { body: JSON.stringify(body) }),\n\t\t};\n\n\t\tlet response: AdaptOrchHttpResponse;\n\t\ttry {\n\t\t\tresponse = await this.fetch(`${this.baseUrl}${path}`, init);\n\t\t} catch (error) {\n\t\t\tconst detail = error instanceof Error ? error.message : String(error);\n\t\t\tthrow new Error(`AdaptOrch request failed: ${redact(detail, this.apiKey)}`);\n\t\t}\n\n\t\tlet payload: unknown;\n\t\ttry {\n\t\t\tpayload = await response.json();\n\t\t} catch {\n\t\t\t// A body that is absent or not JSON is not itself a failure: the status\n\t\t\t// still decides, and an error response keeps its generic message.\n\t\t\tpayload = undefined;\n\t\t}\n\t\tif (response.status < 200 || response.status >= 300) {\n\t\t\tconst { code, message } = readErrorFields(payload);\n\t\t\tthrow new AdaptOrchApiError(\n\t\t\t\tresponse.status,\n\t\t\t\tcode,\n\t\t\t\tredact(message ?? `AdaptOrch request failed with status ${response.status}`, this.apiKey),\n\t\t\t);\n\t\t}\n\t\treturn payload as T;\n\t}\n\n\t/** `GET /v1/capabilities` — API version and enabled features. */\n\tcapabilities(): Promise<CapabilitySet> {\n\t\treturn this.request<CapabilitySet>(\"GET\", \"/v1/capabilities\");\n\t}\n\n\t/** `GET /v1/whoami` — the calling principal, for verifying a key works. */\n\twhoami(): Promise<Principal> {\n\t\treturn this.request<Principal>(\"GET\", \"/v1/whoami\");\n\t}\n\n\t/** `POST /v1/runs` — submit work. The contract bounds `subtasks` to 1..50. */\n\tsubmitRun(submission: RunSubmission): Promise<Run> {\n\t\treturn this.request<Run>(\"POST\", \"/v1/runs\", submission);\n\t}\n\n\t/** `GET /v1/runs` — list runs, filtered by the documented parameters only. */\n\tlistRuns(query: ListRunsQuery = {}): Promise<RunListResponse> {\n\t\tconst params = new URLSearchParams();\n\t\tif (query.status !== undefined) params.set(\"status\", query.status);\n\t\tif (query.projectId !== undefined) params.set(\"project_id\", query.projectId);\n\t\tif (query.limit !== undefined) params.set(\"limit\", String(query.limit));\n\t\tif (query.cursor !== undefined) params.set(\"cursor\", query.cursor);\n\t\tconst suffix = params.size === 0 ? \"\" : `?${params.toString()}`;\n\t\treturn this.request<RunListResponse>(\"GET\", `/v1/runs${suffix}`);\n\t}\n\n\t/** `GET /v1/runs/{run_id}` — one run's current state. */\n\tgetRun(runId: string): Promise<Run> {\n\t\treturn this.request<Run>(\"GET\", `/v1/runs/${encodeURIComponent(runId)}`);\n\t}\n\n\t/** `PUT /v1/runs/{run_id}/cancel` — request cancellation. */\n\tcancelRun(runId: string, reason?: string): Promise<Run> {\n\t\treturn this.request<Run>(\n\t\t\t\"PUT\",\n\t\t\t`/v1/runs/${encodeURIComponent(runId)}/cancel`,\n\t\t\treason === undefined ? {} : { reason },\n\t\t);\n\t}\n\n\t/** `GET /v1/runs/{run_id}/evidence` — the graded checks for a run. */\n\tgetEvidence(runId: string): Promise<EvidenceReport> {\n\t\treturn this.request<EvidenceReport>(\"GET\", `/v1/runs/${encodeURIComponent(runId)}/evidence`);\n\t}\n\n\t/** `GET /v1/runs/{run_id}/artifacts` — artifacts a run produced. */\n\tlistArtifacts(runId: string): Promise<ArtifactListResponse> {\n\t\treturn this.request<ArtifactListResponse>(\"GET\", `/v1/runs/${encodeURIComponent(runId)}/artifacts`);\n\t}\n}\n"]}

package/dist/adaptorch-client.d.ts

@@ -6,14 +6,36 @@
  * their own transport (e.g. an adapter around an MCP SDK client) until one
  * ships in this package.
  *
- * Tool surface, names, and read/write classification are grounded in
- * `.omk/runs/lazycodex-adaptorch-loop-plan-20260701/lane2-adaptorch-tool-surface.md`,
- * which cross-checks the real AdaptOrch MCP server against
- * `docs/tools.md`, `README.md`, `mcp_server.py` dispatch, and
- * `diagnostics.py::EXPECTED_CORE_TOOLS`. There are exactly 10 real tools;
- * no "benchmark" or "verification" tools exist in the shipped surface.
+ * Tool surface, names, and read/write classification are derived from the
+ * server's own inventory: `diagnostics.py::EXPECTED_CORE_TOOLS` and
+ * `_FULL_ONLY_TOOLS`, cross-checked against `hardening.py::REMOTE_TOOL_NAMES`
+ * and the `output_schema.py` projector table. The surface is tiered: nine core
+ * tools every deployment exposes, plus two that exist only in a full or local
+ * deployment. No "benchmark" or "verification" tools exist in it.
  */
-import type { TopologyClassification } from "./types.ts";
+import { type TopologyClassification } from "./types.ts";
+/**
+ * Tools every AdaptOrch deployment exposes, including a remote tenant.
+ * Mirrors `diagnostics.py::EXPECTED_CORE_TOOLS` in server order.
+ */
+export declare const ADAPTORCH_REMOTE_TOOLS: readonly ["adaptorch_run", "adaptorch_get_run", "adaptorch_get_artifacts", "adaptorch_list_runs", "adaptorch_cancel_run", "adaptorch_server_metrics", "adaptorch_capabilities", "adaptorch_usage", "adaptorch_plan_catalog"];
+/**
+ * Tools a remote tenant cannot reach. Trace and topology reads need a full or
+ * local deployment, so a caller must not advertise them unconditionally.
+ */
+export declare const ADAPTORCH_FULL_ONLY_TOOLS: readonly ["adaptorch_get_traces", "adaptorch_route_topology"];
+/** The complete tool surface, core tier first. */
+export declare const ADAPTORCH_TOOLS: readonly ["adaptorch_run", "adaptorch_get_run", "adaptorch_get_artifacts", "adaptorch_list_runs", "adaptorch_cancel_run", "adaptorch_server_metrics", "adaptorch_capabilities", "adaptorch_usage", "adaptorch_plan_catalog", "adaptorch_get_traces", "adaptorch_route_topology"];
+/** One tenant's own usage window, as projected by `output_schema.py::_project_usage`. */
+export interface AdaptOrchUsage {
+    readonly used: number;
+    readonly limit: number;
+    readonly tenant_id?: string;
+    readonly plan_level?: string;
+    readonly period?: string;
+    readonly remaining?: number;
+    readonly usage_percentage?: number;
+}
 /**
  * Abstract transport for invoking AdaptOrch MCP tools by name.
  *
@@ -109,10 +131,9 @@ export interface AdaptOrchTraceSpan {
 /**
  * Result of `adaptorch_route_topology`.
  *
- * `classification` is the topology router's decision
- * (singleton/pipeline/DAG/ensemble, see doc section "Routing (pre-run
- * planning, local/no dispatch)"); `raw` retains the untyped transport
- * response for callers that need more than the classification.
+ * `classification` is the validated value from the current response's
+ * `topology` field; `raw` retains the transport response for callers that
+ * need the accompanying reason, stages, or features.
  */
 export interface AdaptOrchRouteTopologyResult {
     classification: TopologyClassification;
@@ -159,11 +180,7 @@ export declare class AdaptOrchClient {
      * `run_id`.
      */
     getTraces(runId: string): Promise<AdaptOrchTraceSpan[]>;
-    /**
-     * `adaptorch_route_topology` (read/local). Route a DAG locally through
-     * AdaptOrch's topology router (singleton/pipeline/DAG/ensemble) without
-     * submitting a run.
-     */
+    /** Route a DAG locally and fail closed if the MCP response drifts from the current topology contract. */
     routeTopology(payloadShape: unknown): Promise<AdaptOrchRouteTopologyResult>;
     /**
      * `adaptorch_server_metrics` (read/local). Read redacted MCP server
@@ -176,8 +193,14 @@ export declare class AdaptOrchClient {
      */
     capabilities(): Promise<Record<string, unknown>>;
     /**
-     * `adaptorch_plan_catalog` (read/local). Read the hosted plan catalog
-     * (Starter $0 / Pro $39 / Team $149).
+     * `adaptorch_usage` (read). Read this tenant's own usage window. The
+     * control plane scopes the response by key, so a caller never sees another
+     * tenant's counters.
+     */
+    usage(): Promise<AdaptOrchUsage>;
+    /**
+     * `adaptorch_plan_catalog` (read/local). Read the hosted plan catalog.
+     * Tier names and prices come from the server, never from this client.
      */
     planCatalog(): Promise<Record<string, unknown>>;
 }

package/dist/adaptorch-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adaptorch-client.d.ts","sourceRoot":"","sources":["../src/adaptorch-client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AdaptOrch MCP client wrapper.\n *\n * Design-stage / experimental: this module has no production\n * `AdaptOrchTransport` implementation wired in yet. Callers must supply\n * their own transport (e.g. an adapter around an MCP SDK client) until one\n * ships in this package.\n *\n * Tool surface, names, and read/write classification are grounded in\n * `.omk/runs/lazycodex-adaptorch-loop-plan-20260701/lane2-adaptorch-tool-surface.md`,\n * which cross-checks the real AdaptOrch MCP server against\n * `docs/tools.md`, `README.md`, `mcp_server.py` dispatch, and\n * `diagnostics.py::EXPECTED_CORE_TOOLS`. There are exactly 10 real tools;\n * no \"benchmark\" or \"verification\" tools exist in the shipped surface.\n */\n\nimport type { TopologyClassification } from \"./types.ts\";\n\n/**\n * Abstract transport for invoking AdaptOrch MCP tools by name.\n *\n * See doc section \"The real, current 10-tool MCP surface (grouped)\". No\n * concrete implementation ships with this package yet; a caller must\n * provide one (e.g. wrapping an MCP SDK client's `callTool`).\n */\nexport interface AdaptOrchTransport {\n\tcallTool(name: string, args: Record<string, unknown>): Promise<unknown>;\n}\n\n/**\n * Payload accepted by `adaptorch_run`.\n *\n * See doc section \"Run / lifecycle (submit, inspect, list, cancel)\":\n * `adaptorch_run` submits a task payload (prompt/context/raw payload,\n * connector, synthesis mode, budget policy) to the control-plane, and can\n * optionally block until the run reaches a terminal status.\n */\nexport interface AdaptOrchRunPayload {\n\ttaskPayload: unknown;\n\tconnector?: string;\n\tsynthesisMode?: string;\n\tbudgetPolicy?: unknown;\n\twaitForTerminal?: boolean;\n\ttimeoutSeconds?: number;\n\tpollIntervalSeconds?: number;\n}\n\n/**\n * Result of `adaptorch_run`.\n *\n * Shape is inferred from the doc's description of the tool's purpose, not\n * guaranteed by an official schema.\n */\nexport interface AdaptOrchRunResult {\n\trun_id: string;\n\tstatus?: string;\n}\n\n/**\n * Result of `adaptorch_get_run`.\n *\n * Shape is inferred from the doc's description (\"fetch a run summary by\n * run_id\"), not guaranteed by an official schema; extra fields are\n * expected to vary by connector/synthesis mode.\n */\nexport interface AdaptOrchRunSummary {\n\trun_id: string;\n\tstatus: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Entry in the result of `adaptorch_list_runs`.\n *\n * Shape is inferred, not guaranteed by an official schema.\n */\nexport interface AdaptOrchRunListEntry {\n\trun_id: string;\n\tstatus: string;\n}\n\n/**\n * Result of `adaptorch_cancel_run`.\n *\n * Shape is inferred from the doc's description (\"request cancellation of\n * an in-flight run by run_id\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchCancelResult {\n\trun_id: string;\n\tcancelled: boolean;\n}\n\n/**\n * Entry in the result of `adaptorch_get_artifacts`.\n *\n * Shape is inferred from the doc's description (\"fetch artifact metadata\n * for a run\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchArtifact {\n\tpath: string;\n\tsize_bytes?: number;\n\tcreated_at?: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Entry in the result of `adaptorch_get_traces`.\n *\n * Shape is inferred from the doc's description (\"fetch execution traces\n * for a run by run_id\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchTraceSpan {\n\tspan_id?: string;\n\tkind?: string;\n\tseverity?: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Result of `adaptorch_route_topology`.\n *\n * `classification` is the topology router's decision\n * (singleton/pipeline/DAG/ensemble, see doc section \"Routing (pre-run\n * planning, local/no dispatch)\"); `raw` retains the untyped transport\n * response for callers that need more than the classification.\n */\nexport interface AdaptOrchRouteTopologyResult {\n\tclassification: TopologyClassification;\n\traw: unknown;\n}\n\n/**\n * Typed wrapper around the 10 real AdaptOrch MCP tools.\n *\n * See doc section \"The real, current 10-tool MCP surface (grouped)\" for\n * the full tool list, purposes, and read/write classification. This\n * class only translates method calls into `transport.callTool` calls\n * with the exact tool names the doc lists; it does not implement a\n * transport itself.\n */\nexport class AdaptOrchClient {\n\tprivate readonly transport: AdaptOrchTransport;\n\n\tconstructor(transport: AdaptOrchTransport) {\n\t\tthis.transport = transport;\n\t}\n\n\t/**\n\t * `adaptorch_run` (write). Submit a task payload to the control-plane,\n\t * optionally blocking until the run reaches a terminal status.\n\t */\n\tasync run(payload: AdaptOrchRunPayload): Promise<AdaptOrchRunResult> {\n\t\t// The transport result shape is not schema-validated here; callers\n\t\t// relying on strict correctness should validate at the transport\n\t\t// boundary.\n\t\treturn (await this.transport.callTool(\"adaptorch_run\", { ...payload })) as AdaptOrchRunResult;\n\t}\n\n\t/**\n\t * `adaptorch_get_run` (read). Fetch a run summary by `run_id`.\n\t */\n\tasync getRun(runId: string): Promise<AdaptOrchRunSummary> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_run\", { run_id: runId })) as AdaptOrchRunSummary;\n\t}\n\n\t/**\n\t * `adaptorch_list_runs` (read). List recent control-plane runs.\n\t */\n\tasync listRuns(params?: { limit?: number }): Promise<AdaptOrchRunListEntry[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_list_runs\", { ...params })) as AdaptOrchRunListEntry[];\n\t}\n\n\t/**\n\t * `adaptorch_cancel_run` (write). Request cancellation of an in-flight\n\t * run by `run_id`.\n\t */\n\tasync cancelRun(runId: string): Promise<AdaptOrchCancelResult> {\n\t\treturn (await this.transport.callTool(\"adaptorch_cancel_run\", { run_id: runId })) as AdaptOrchCancelResult;\n\t}\n\n\t/**\n\t * `adaptorch_get_artifacts` (read). Fetch artifact metadata for a run.\n\t */\n\tasync getArtifacts(runId: string): Promise<AdaptOrchArtifact[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_artifacts\", { run_id: runId })) as AdaptOrchArtifact[];\n\t}\n\n\t/**\n\t * `adaptorch_get_traces` (read). Fetch execution traces for a run by\n\t * `run_id`.\n\t */\n\tasync getTraces(runId: string): Promise<AdaptOrchTraceSpan[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_traces\", { run_id: runId })) as AdaptOrchTraceSpan[];\n\t}\n\n\t/**\n\t * `adaptorch_route_topology` (read/local). Route a DAG locally through\n\t * AdaptOrch's topology router (singleton/pipeline/DAG/ensemble) without\n\t * submitting a run.\n\t */\n\tasync routeTopology(payloadShape: unknown): Promise<AdaptOrchRouteTopologyResult> {\n\t\tconst raw = await this.transport.callTool(\"adaptorch_route_topology\", { payload_shape: payloadShape });\n\t\t// The transport response is not schema-validated; classification is\n\t\t// extracted best-effort since no official schema is documented.\n\t\tconst classification = (raw as { classification?: TopologyClassification } | undefined)?.classification;\n\t\treturn {\n\t\t\tclassification: classification as TopologyClassification,\n\t\t\traw,\n\t\t};\n\t}\n\n\t/**\n\t * `adaptorch_server_metrics` (read/local). Read redacted MCP server\n\t * metrics (tool-call counters, latency percentiles).\n\t */\n\tasync serverMetrics(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_server_metrics\", {})) as Record<string, unknown>;\n\t}\n\n\t/**\n\t * `adaptorch_capabilities` (read/local). Read supported synthesis\n\t * modes, connectors, and server features.\n\t */\n\tasync capabilities(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_capabilities\", {})) as Record<string, unknown>;\n\t}\n\n\t/**\n\t * `adaptorch_plan_catalog` (read/local). Read the hosted plan catalog\n\t * (Starter $0 / Pro $39 / Team $149).\n\t */\n\tasync planCatalog(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_plan_catalog\", {})) as Record<string, unknown>;\n\t}\n}\n"]}
+{"version":3,"file":"adaptorch-client.d.ts","sourceRoot":"","sources":["../src/adaptorch-client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AdaptOrch MCP client wrapper.\n *\n * Design-stage / experimental: this module has no production\n * `AdaptOrchTransport` implementation wired in yet. Callers must supply\n * their own transport (e.g. an adapter around an MCP SDK client) until one\n * ships in this package.\n *\n * Tool surface, names, and read/write classification are derived from the\n * server's own inventory: `diagnostics.py::EXPECTED_CORE_TOOLS` and\n * `_FULL_ONLY_TOOLS`, cross-checked against `hardening.py::REMOTE_TOOL_NAMES`\n * and the `output_schema.py` projector table. The surface is tiered: nine core\n * tools every deployment exposes, plus two that exist only in a full or local\n * deployment. No \"benchmark\" or \"verification\" tools exist in it.\n */\n\nimport { isTopologyClassification, type TopologyClassification } from \"./types.ts\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Tools every AdaptOrch deployment exposes, including a remote tenant.\n * Mirrors `diagnostics.py::EXPECTED_CORE_TOOLS` in server order.\n */\nexport const ADAPTORCH_REMOTE_TOOLS = [\n\t\"adaptorch_run\",\n\t\"adaptorch_get_run\",\n\t\"adaptorch_get_artifacts\",\n\t\"adaptorch_list_runs\",\n\t\"adaptorch_cancel_run\",\n\t\"adaptorch_server_metrics\",\n\t\"adaptorch_capabilities\",\n\t\"adaptorch_usage\",\n\t\"adaptorch_plan_catalog\",\n] as const;\n\n/**\n * Tools a remote tenant cannot reach. Trace and topology reads need a full or\n * local deployment, so a caller must not advertise them unconditionally.\n */\nexport const ADAPTORCH_FULL_ONLY_TOOLS = [\"adaptorch_get_traces\", \"adaptorch_route_topology\"] as const;\n\n/** The complete tool surface, core tier first. */\nexport const ADAPTORCH_TOOLS = [...ADAPTORCH_REMOTE_TOOLS, ...ADAPTORCH_FULL_ONLY_TOOLS] as const;\n\n/** One tenant's own usage window, as projected by `output_schema.py::_project_usage`. */\nexport interface AdaptOrchUsage {\n\treadonly used: number;\n\treadonly limit: number;\n\treadonly tenant_id?: string;\n\treadonly plan_level?: string;\n\treadonly period?: string;\n\treadonly remaining?: number;\n\treadonly usage_percentage?: number;\n}\n\n/**\n * Abstract transport for invoking AdaptOrch MCP tools by name.\n *\n * See doc section \"The real, current 10-tool MCP surface (grouped)\". No\n * concrete implementation ships with this package yet; a caller must\n * provide one (e.g. wrapping an MCP SDK client's `callTool`).\n */\nexport interface AdaptOrchTransport {\n\tcallTool(name: string, args: Record<string, unknown>): Promise<unknown>;\n}\n\n/**\n * Payload accepted by `adaptorch_run`.\n *\n * See doc section \"Run / lifecycle (submit, inspect, list, cancel)\":\n * `adaptorch_run` submits a task payload (prompt/context/raw payload,\n * connector, synthesis mode, budget policy) to the control-plane, and can\n * optionally block until the run reaches a terminal status.\n */\nexport interface AdaptOrchRunPayload {\n\ttaskPayload: unknown;\n\tconnector?: string;\n\tsynthesisMode?: string;\n\tbudgetPolicy?: unknown;\n\twaitForTerminal?: boolean;\n\ttimeoutSeconds?: number;\n\tpollIntervalSeconds?: number;\n}\n\n/**\n * Result of `adaptorch_run`.\n *\n * Shape is inferred from the doc's description of the tool's purpose, not\n * guaranteed by an official schema.\n */\nexport interface AdaptOrchRunResult {\n\trun_id: string;\n\tstatus?: string;\n}\n\n/**\n * Result of `adaptorch_get_run`.\n *\n * Shape is inferred from the doc's description (\"fetch a run summary by\n * run_id\"), not guaranteed by an official schema; extra fields are\n * expected to vary by connector/synthesis mode.\n */\nexport interface AdaptOrchRunSummary {\n\trun_id: string;\n\tstatus: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Entry in the result of `adaptorch_list_runs`.\n *\n * Shape is inferred, not guaranteed by an official schema.\n */\nexport interface AdaptOrchRunListEntry {\n\trun_id: string;\n\tstatus: string;\n}\n\n/**\n * Result of `adaptorch_cancel_run`.\n *\n * Shape is inferred from the doc's description (\"request cancellation of\n * an in-flight run by run_id\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchCancelResult {\n\trun_id: string;\n\tcancelled: boolean;\n}\n\n/**\n * Entry in the result of `adaptorch_get_artifacts`.\n *\n * Shape is inferred from the doc's description (\"fetch artifact metadata\n * for a run\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchArtifact {\n\tpath: string;\n\tsize_bytes?: number;\n\tcreated_at?: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Entry in the result of `adaptorch_get_traces`.\n *\n * Shape is inferred from the doc's description (\"fetch execution traces\n * for a run by run_id\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchTraceSpan {\n\tspan_id?: string;\n\tkind?: string;\n\tseverity?: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Result of `adaptorch_route_topology`.\n *\n * `classification` is the validated value from the current response's\n * `topology` field; `raw` retains the transport response for callers that\n * need the accompanying reason, stages, or features.\n */\nexport interface AdaptOrchRouteTopologyResult {\n\tclassification: TopologyClassification;\n\traw: unknown;\n}\n\n/**\n * Typed wrapper around the 10 real AdaptOrch MCP tools.\n *\n * See doc section \"The real, current 10-tool MCP surface (grouped)\" for\n * the full tool list, purposes, and read/write classification. This\n * class only translates method calls into `transport.callTool` calls\n * with the exact tool names the doc lists; it does not implement a\n * transport itself.\n */\nexport class AdaptOrchClient {\n\tprivate readonly transport: AdaptOrchTransport;\n\n\tconstructor(transport: AdaptOrchTransport) {\n\t\tthis.transport = transport;\n\t}\n\n\t/**\n\t * `adaptorch_run` (write). Submit a task payload to the control-plane,\n\t * optionally blocking until the run reaches a terminal status.\n\t */\n\tasync run(payload: AdaptOrchRunPayload): Promise<AdaptOrchRunResult> {\n\t\t// The transport result shape is not schema-validated here; callers\n\t\t// relying on strict correctness should validate at the transport\n\t\t// boundary.\n\t\treturn (await this.transport.callTool(\"adaptorch_run\", { ...payload })) as AdaptOrchRunResult;\n\t}\n\n\t/**\n\t * `adaptorch_get_run` (read). Fetch a run summary by `run_id`.\n\t */\n\tasync getRun(runId: string): Promise<AdaptOrchRunSummary> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_run\", { run_id: runId })) as AdaptOrchRunSummary;\n\t}\n\n\t/**\n\t * `adaptorch_list_runs` (read). List recent control-plane runs.\n\t */\n\tasync listRuns(params?: { limit?: number }): Promise<AdaptOrchRunListEntry[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_list_runs\", { ...params })) as AdaptOrchRunListEntry[];\n\t}\n\n\t/**\n\t * `adaptorch_cancel_run` (write). Request cancellation of an in-flight\n\t * run by `run_id`.\n\t */\n\tasync cancelRun(runId: string): Promise<AdaptOrchCancelResult> {\n\t\treturn (await this.transport.callTool(\"adaptorch_cancel_run\", { run_id: runId })) as AdaptOrchCancelResult;\n\t}\n\n\t/**\n\t * `adaptorch_get_artifacts` (read). Fetch artifact metadata for a run.\n\t */\n\tasync getArtifacts(runId: string): Promise<AdaptOrchArtifact[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_artifacts\", { run_id: runId })) as AdaptOrchArtifact[];\n\t}\n\n\t/**\n\t * `adaptorch_get_traces` (read). Fetch execution traces for a run by\n\t * `run_id`.\n\t */\n\tasync getTraces(runId: string): Promise<AdaptOrchTraceSpan[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_traces\", { run_id: runId })) as AdaptOrchTraceSpan[];\n\t}\n\n\t/** Route a DAG locally and fail closed if the MCP response drifts from the current topology contract. */\n\tasync routeTopology(payloadShape: unknown): Promise<AdaptOrchRouteTopologyResult> {\n\t\tconst raw = await this.transport.callTool(\"adaptorch_route_topology\", { payload_shape: payloadShape });\n\t\tconst topology = isRecord(raw) ? raw.topology : undefined;\n\t\tif (!isTopologyClassification(topology)) {\n\t\t\tthrow new Error(\"AdaptOrch route response has invalid topology\");\n\t\t}\n\t\treturn { classification: topology, raw };\n\t}\n\n\t/**\n\t * `adaptorch_server_metrics` (read/local). Read redacted MCP server\n\t * metrics (tool-call counters, latency percentiles).\n\t */\n\tasync serverMetrics(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_server_metrics\", {})) as Record<string, unknown>;\n\t}\n\n\t/**\n\t * `adaptorch_capabilities` (read/local). Read supported synthesis\n\t * modes, connectors, and server features.\n\t */\n\tasync capabilities(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_capabilities\", {})) as Record<string, unknown>;\n\t}\n\n\t/**\n\t * `adaptorch_usage` (read). Read this tenant's own usage window. The\n\t * control plane scopes the response by key, so a caller never sees another\n\t * tenant's counters.\n\t */\n\tasync usage(): Promise<AdaptOrchUsage> {\n\t\treturn (await this.transport.callTool(\"adaptorch_usage\", {})) as AdaptOrchUsage;\n\t}\n\n\t/**\n\t * `adaptorch_plan_catalog` (read/local). Read the hosted plan catalog.\n\t * Tier names and prices come from the server, never from this client.\n\t */\n\tasync planCatalog(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_plan_catalog\", {})) as Record<string, unknown>;\n\t}\n}\n"]}

package/dist/adaptorch-client.js

@@ -6,13 +6,39 @@
  * their own transport (e.g. an adapter around an MCP SDK client) until one
  * ships in this package.
  *
- * Tool surface, names, and read/write classification are grounded in
- * `.omk/runs/lazycodex-adaptorch-loop-plan-20260701/lane2-adaptorch-tool-surface.md`,
- * which cross-checks the real AdaptOrch MCP server against
- * `docs/tools.md`, `README.md`, `mcp_server.py` dispatch, and
- * `diagnostics.py::EXPECTED_CORE_TOOLS`. There are exactly 10 real tools;
- * no "benchmark" or "verification" tools exist in the shipped surface.
+ * Tool surface, names, and read/write classification are derived from the
+ * server's own inventory: `diagnostics.py::EXPECTED_CORE_TOOLS` and
+ * `_FULL_ONLY_TOOLS`, cross-checked against `hardening.py::REMOTE_TOOL_NAMES`
+ * and the `output_schema.py` projector table. The surface is tiered: nine core
+ * tools every deployment exposes, plus two that exist only in a full or local
+ * deployment. No "benchmark" or "verification" tools exist in it.
  */
+import { isTopologyClassification } from "./types.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Tools every AdaptOrch deployment exposes, including a remote tenant.
+ * Mirrors `diagnostics.py::EXPECTED_CORE_TOOLS` in server order.
+ */
+export const ADAPTORCH_REMOTE_TOOLS = [
+    "adaptorch_run",
+    "adaptorch_get_run",
+    "adaptorch_get_artifacts",
+    "adaptorch_list_runs",
+    "adaptorch_cancel_run",
+    "adaptorch_server_metrics",
+    "adaptorch_capabilities",
+    "adaptorch_usage",
+    "adaptorch_plan_catalog",
+];
+/**
+ * Tools a remote tenant cannot reach. Trace and topology reads need a full or
+ * local deployment, so a caller must not advertise them unconditionally.
+ */
+export const ADAPTORCH_FULL_ONLY_TOOLS = ["adaptorch_get_traces", "adaptorch_route_topology"];
+/** The complete tool surface, core tier first. */
+export const ADAPTORCH_TOOLS = [...ADAPTORCH_REMOTE_TOOLS, ...ADAPTORCH_FULL_ONLY_TOOLS];
 /**
  * Typed wrapper around the 10 real AdaptOrch MCP tools.
  *
@@ -69,20 +95,14 @@ export class AdaptOrchClient {
     async getTraces(runId) {
         return (await this.transport.callTool("adaptorch_get_traces", { run_id: runId }));
     }
-    /**
-     * `adaptorch_route_topology` (read/local). Route a DAG locally through
-     * AdaptOrch's topology router (singleton/pipeline/DAG/ensemble) without
-     * submitting a run.
-     */
+    /** Route a DAG locally and fail closed if the MCP response drifts from the current topology contract. */
     async routeTopology(payloadShape) {
         const raw = await this.transport.callTool("adaptorch_route_topology", { payload_shape: payloadShape });
-        // The transport response is not schema-validated; classification is
-        // extracted best-effort since no official schema is documented.
-        const classification = raw?.classification;
-        return {
-            classification: classification,
-            raw,
-        };
+        const topology = isRecord(raw) ? raw.topology : undefined;
+        if (!isTopologyClassification(topology)) {
+            throw new Error("AdaptOrch route response has invalid topology");
+        }
+        return { classification: topology, raw };
     }
     /**
      * `adaptorch_server_metrics` (read/local). Read redacted MCP server
@@ -99,8 +119,16 @@ export class AdaptOrchClient {
         return (await this.transport.callTool("adaptorch_capabilities", {}));
     }
     /**
-     * `adaptorch_plan_catalog` (read/local). Read the hosted plan catalog
-     * (Starter $0 / Pro $39 / Team $149).
+     * `adaptorch_usage` (read). Read this tenant's own usage window. The
+     * control plane scopes the response by key, so a caller never sees another
+     * tenant's counters.
+     */
+    async usage() {
+        return (await this.transport.callTool("adaptorch_usage", {}));
+    }
+    /**
+     * `adaptorch_plan_catalog` (read/local). Read the hosted plan catalog.
+     * Tier names and prices come from the server, never from this client.
      */
     async planCatalog() {
         return (await this.transport.callTool("adaptorch_plan_catalog", {}));

package/dist/adaptorch-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"adaptorch-client.js","sourceRoot":"","sources":["../src/adaptorch-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAqHH;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IACV,SAAS,CAAqB;IAE/C,YAAY,SAA6B,EAAE;QAC1C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAAA,CAC3B;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,OAA4B,EAA+B;QACpE,mEAAmE;QACnE,iEAAiE;QACjE,YAAY;QACZ,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAuB,CAAC;IAAA,CAC9F;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAgC;QACzD,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAwB,CAAC;IAAA,CACtG;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAA2B,EAAoC;QAC7E,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAA4B,CAAC;IAAA,CACxG;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa,EAAkC;QAC9D,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAA0B,CAAC;IAAA,CAC3G;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,KAAa,EAAgC;QAC/D,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAwB,CAAC;IAAA,CAC5G;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa,EAAiC;QAC7D,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAyB,CAAC;IAAA,CAC1G;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,YAAqB,EAAyC;QACjF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,0BAA0B,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;QACvG,oEAAoE;QACpE,gEAAgE;QAChE,MAAM,cAAc,GAAI,GAA+D,EAAE,cAAc,CAAC;QACxG,OAAO;YACN,cAAc,EAAE,cAAwC;YACxD,GAAG;SACH,CAAC;IAAA,CACF;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,GAAqC;QACvD,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAA4B,CAAC;IAAA,CAClG;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,GAAqC;QACtD,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAA4B,CAAC;IAAA,CAChG;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,GAAqC;QACrD,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAA4B,CAAC;IAAA,CAChG;CACD","sourcesContent":["/**\n * AdaptOrch MCP client wrapper.\n *\n * Design-stage / experimental: this module has no production\n * `AdaptOrchTransport` implementation wired in yet. Callers must supply\n * their own transport (e.g. an adapter around an MCP SDK client) until one\n * ships in this package.\n *\n * Tool surface, names, and read/write classification are grounded in\n * `.omk/runs/lazycodex-adaptorch-loop-plan-20260701/lane2-adaptorch-tool-surface.md`,\n * which cross-checks the real AdaptOrch MCP server against\n * `docs/tools.md`, `README.md`, `mcp_server.py` dispatch, and\n * `diagnostics.py::EXPECTED_CORE_TOOLS`. There are exactly 10 real tools;\n * no \"benchmark\" or \"verification\" tools exist in the shipped surface.\n */\n\nimport type { TopologyClassification } from \"./types.ts\";\n\n/**\n * Abstract transport for invoking AdaptOrch MCP tools by name.\n *\n * See doc section \"The real, current 10-tool MCP surface (grouped)\". No\n * concrete implementation ships with this package yet; a caller must\n * provide one (e.g. wrapping an MCP SDK client's `callTool`).\n */\nexport interface AdaptOrchTransport {\n\tcallTool(name: string, args: Record<string, unknown>): Promise<unknown>;\n}\n\n/**\n * Payload accepted by `adaptorch_run`.\n *\n * See doc section \"Run / lifecycle (submit, inspect, list, cancel)\":\n * `adaptorch_run` submits a task payload (prompt/context/raw payload,\n * connector, synthesis mode, budget policy) to the control-plane, and can\n * optionally block until the run reaches a terminal status.\n */\nexport interface AdaptOrchRunPayload {\n\ttaskPayload: unknown;\n\tconnector?: string;\n\tsynthesisMode?: string;\n\tbudgetPolicy?: unknown;\n\twaitForTerminal?: boolean;\n\ttimeoutSeconds?: number;\n\tpollIntervalSeconds?: number;\n}\n\n/**\n * Result of `adaptorch_run`.\n *\n * Shape is inferred from the doc's description of the tool's purpose, not\n * guaranteed by an official schema.\n */\nexport interface AdaptOrchRunResult {\n\trun_id: string;\n\tstatus?: string;\n}\n\n/**\n * Result of `adaptorch_get_run`.\n *\n * Shape is inferred from the doc's description (\"fetch a run summary by\n * run_id\"), not guaranteed by an official schema; extra fields are\n * expected to vary by connector/synthesis mode.\n */\nexport interface AdaptOrchRunSummary {\n\trun_id: string;\n\tstatus: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Entry in the result of `adaptorch_list_runs`.\n *\n * Shape is inferred, not guaranteed by an official schema.\n */\nexport interface AdaptOrchRunListEntry {\n\trun_id: string;\n\tstatus: string;\n}\n\n/**\n * Result of `adaptorch_cancel_run`.\n *\n * Shape is inferred from the doc's description (\"request cancellation of\n * an in-flight run by run_id\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchCancelResult {\n\trun_id: string;\n\tcancelled: boolean;\n}\n\n/**\n * Entry in the result of `adaptorch_get_artifacts`.\n *\n * Shape is inferred from the doc's description (\"fetch artifact metadata\n * for a run\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchArtifact {\n\tpath: string;\n\tsize_bytes?: number;\n\tcreated_at?: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Entry in the result of `adaptorch_get_traces`.\n *\n * Shape is inferred from the doc's description (\"fetch execution traces\n * for a run by run_id\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchTraceSpan {\n\tspan_id?: string;\n\tkind?: string;\n\tseverity?: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Result of `adaptorch_route_topology`.\n *\n * `classification` is the topology router's decision\n * (singleton/pipeline/DAG/ensemble, see doc section \"Routing (pre-run\n * planning, local/no dispatch)\"); `raw` retains the untyped transport\n * response for callers that need more than the classification.\n */\nexport interface AdaptOrchRouteTopologyResult {\n\tclassification: TopologyClassification;\n\traw: unknown;\n}\n\n/**\n * Typed wrapper around the 10 real AdaptOrch MCP tools.\n *\n * See doc section \"The real, current 10-tool MCP surface (grouped)\" for\n * the full tool list, purposes, and read/write classification. This\n * class only translates method calls into `transport.callTool` calls\n * with the exact tool names the doc lists; it does not implement a\n * transport itself.\n */\nexport class AdaptOrchClient {\n\tprivate readonly transport: AdaptOrchTransport;\n\n\tconstructor(transport: AdaptOrchTransport) {\n\t\tthis.transport = transport;\n\t}\n\n\t/**\n\t * `adaptorch_run` (write). Submit a task payload to the control-plane,\n\t * optionally blocking until the run reaches a terminal status.\n\t */\n\tasync run(payload: AdaptOrchRunPayload): Promise<AdaptOrchRunResult> {\n\t\t// The transport result shape is not schema-validated here; callers\n\t\t// relying on strict correctness should validate at the transport\n\t\t// boundary.\n\t\treturn (await this.transport.callTool(\"adaptorch_run\", { ...payload })) as AdaptOrchRunResult;\n\t}\n\n\t/**\n\t * `adaptorch_get_run` (read). Fetch a run summary by `run_id`.\n\t */\n\tasync getRun(runId: string): Promise<AdaptOrchRunSummary> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_run\", { run_id: runId })) as AdaptOrchRunSummary;\n\t}\n\n\t/**\n\t * `adaptorch_list_runs` (read). List recent control-plane runs.\n\t */\n\tasync listRuns(params?: { limit?: number }): Promise<AdaptOrchRunListEntry[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_list_runs\", { ...params })) as AdaptOrchRunListEntry[];\n\t}\n\n\t/**\n\t * `adaptorch_cancel_run` (write). Request cancellation of an in-flight\n\t * run by `run_id`.\n\t */\n\tasync cancelRun(runId: string): Promise<AdaptOrchCancelResult> {\n\t\treturn (await this.transport.callTool(\"adaptorch_cancel_run\", { run_id: runId })) as AdaptOrchCancelResult;\n\t}\n\n\t/**\n\t * `adaptorch_get_artifacts` (read). Fetch artifact metadata for a run.\n\t */\n\tasync getArtifacts(runId: string): Promise<AdaptOrchArtifact[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_artifacts\", { run_id: runId })) as AdaptOrchArtifact[];\n\t}\n\n\t/**\n\t * `adaptorch_get_traces` (read). Fetch execution traces for a run by\n\t * `run_id`.\n\t */\n\tasync getTraces(runId: string): Promise<AdaptOrchTraceSpan[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_traces\", { run_id: runId })) as AdaptOrchTraceSpan[];\n\t}\n\n\t/**\n\t * `adaptorch_route_topology` (read/local). Route a DAG locally through\n\t * AdaptOrch's topology router (singleton/pipeline/DAG/ensemble) without\n\t * submitting a run.\n\t */\n\tasync routeTopology(payloadShape: unknown): Promise<AdaptOrchRouteTopologyResult> {\n\t\tconst raw = await this.transport.callTool(\"adaptorch_route_topology\", { payload_shape: payloadShape });\n\t\t// The transport response is not schema-validated; classification is\n\t\t// extracted best-effort since no official schema is documented.\n\t\tconst classification = (raw as { classification?: TopologyClassification } | undefined)?.classification;\n\t\treturn {\n\t\t\tclassification: classification as TopologyClassification,\n\t\t\traw,\n\t\t};\n\t}\n\n\t/**\n\t * `adaptorch_server_metrics` (read/local). Read redacted MCP server\n\t * metrics (tool-call counters, latency percentiles).\n\t */\n\tasync serverMetrics(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_server_metrics\", {})) as Record<string, unknown>;\n\t}\n\n\t/**\n\t * `adaptorch_capabilities` (read/local). Read supported synthesis\n\t * modes, connectors, and server features.\n\t */\n\tasync capabilities(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_capabilities\", {})) as Record<string, unknown>;\n\t}\n\n\t/**\n\t * `adaptorch_plan_catalog` (read/local). Read the hosted plan catalog\n\t * (Starter $0 / Pro $39 / Team $149).\n\t */\n\tasync planCatalog(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_plan_catalog\", {})) as Record<string, unknown>;\n\t}\n}\n"]}
+{"version":3,"file":"adaptorch-client.js","sourceRoot":"","sources":["../src/adaptorch-client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AdaptOrch MCP client wrapper.\n *\n * Design-stage / experimental: this module has no production\n * `AdaptOrchTransport` implementation wired in yet. Callers must supply\n * their own transport (e.g. an adapter around an MCP SDK client) until one\n * ships in this package.\n *\n * Tool surface, names, and read/write classification are derived from the\n * server's own inventory: `diagnostics.py::EXPECTED_CORE_TOOLS` and\n * `_FULL_ONLY_TOOLS`, cross-checked against `hardening.py::REMOTE_TOOL_NAMES`\n * and the `output_schema.py` projector table. The surface is tiered: nine core\n * tools every deployment exposes, plus two that exist only in a full or local\n * deployment. No \"benchmark\" or \"verification\" tools exist in it.\n */\n\nimport { isTopologyClassification, type TopologyClassification } from \"./types.ts\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Tools every AdaptOrch deployment exposes, including a remote tenant.\n * Mirrors `diagnostics.py::EXPECTED_CORE_TOOLS` in server order.\n */\nexport const ADAPTORCH_REMOTE_TOOLS = [\n\t\"adaptorch_run\",\n\t\"adaptorch_get_run\",\n\t\"adaptorch_get_artifacts\",\n\t\"adaptorch_list_runs\",\n\t\"adaptorch_cancel_run\",\n\t\"adaptorch_server_metrics\",\n\t\"adaptorch_capabilities\",\n\t\"adaptorch_usage\",\n\t\"adaptorch_plan_catalog\",\n] as const;\n\n/**\n * Tools a remote tenant cannot reach. Trace and topology reads need a full or\n * local deployment, so a caller must not advertise them unconditionally.\n */\nexport const ADAPTORCH_FULL_ONLY_TOOLS = [\"adaptorch_get_traces\", \"adaptorch_route_topology\"] as const;\n\n/** The complete tool surface, core tier first. */\nexport const ADAPTORCH_TOOLS = [...ADAPTORCH_REMOTE_TOOLS, ...ADAPTORCH_FULL_ONLY_TOOLS] as const;\n\n/** One tenant's own usage window, as projected by `output_schema.py::_project_usage`. */\nexport interface AdaptOrchUsage {\n\treadonly used: number;\n\treadonly limit: number;\n\treadonly tenant_id?: string;\n\treadonly plan_level?: string;\n\treadonly period?: string;\n\treadonly remaining?: number;\n\treadonly usage_percentage?: number;\n}\n\n/**\n * Abstract transport for invoking AdaptOrch MCP tools by name.\n *\n * See doc section \"The real, current 10-tool MCP surface (grouped)\". No\n * concrete implementation ships with this package yet; a caller must\n * provide one (e.g. wrapping an MCP SDK client's `callTool`).\n */\nexport interface AdaptOrchTransport {\n\tcallTool(name: string, args: Record<string, unknown>): Promise<unknown>;\n}\n\n/**\n * Payload accepted by `adaptorch_run`.\n *\n * See doc section \"Run / lifecycle (submit, inspect, list, cancel)\":\n * `adaptorch_run` submits a task payload (prompt/context/raw payload,\n * connector, synthesis mode, budget policy) to the control-plane, and can\n * optionally block until the run reaches a terminal status.\n */\nexport interface AdaptOrchRunPayload {\n\ttaskPayload: unknown;\n\tconnector?: string;\n\tsynthesisMode?: string;\n\tbudgetPolicy?: unknown;\n\twaitForTerminal?: boolean;\n\ttimeoutSeconds?: number;\n\tpollIntervalSeconds?: number;\n}\n\n/**\n * Result of `adaptorch_run`.\n *\n * Shape is inferred from the doc's description of the tool's purpose, not\n * guaranteed by an official schema.\n */\nexport interface AdaptOrchRunResult {\n\trun_id: string;\n\tstatus?: string;\n}\n\n/**\n * Result of `adaptorch_get_run`.\n *\n * Shape is inferred from the doc's description (\"fetch a run summary by\n * run_id\"), not guaranteed by an official schema; extra fields are\n * expected to vary by connector/synthesis mode.\n */\nexport interface AdaptOrchRunSummary {\n\trun_id: string;\n\tstatus: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Entry in the result of `adaptorch_list_runs`.\n *\n * Shape is inferred, not guaranteed by an official schema.\n */\nexport interface AdaptOrchRunListEntry {\n\trun_id: string;\n\tstatus: string;\n}\n\n/**\n * Result of `adaptorch_cancel_run`.\n *\n * Shape is inferred from the doc's description (\"request cancellation of\n * an in-flight run by run_id\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchCancelResult {\n\trun_id: string;\n\tcancelled: boolean;\n}\n\n/**\n * Entry in the result of `adaptorch_get_artifacts`.\n *\n * Shape is inferred from the doc's description (\"fetch artifact metadata\n * for a run\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchArtifact {\n\tpath: string;\n\tsize_bytes?: number;\n\tcreated_at?: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Entry in the result of `adaptorch_get_traces`.\n *\n * Shape is inferred from the doc's description (\"fetch execution traces\n * for a run by run_id\"), not guaranteed by an official schema.\n */\nexport interface AdaptOrchTraceSpan {\n\tspan_id?: string;\n\tkind?: string;\n\tseverity?: string;\n\t[key: string]: unknown;\n}\n\n/**\n * Result of `adaptorch_route_topology`.\n *\n * `classification` is the validated value from the current response's\n * `topology` field; `raw` retains the transport response for callers that\n * need the accompanying reason, stages, or features.\n */\nexport interface AdaptOrchRouteTopologyResult {\n\tclassification: TopologyClassification;\n\traw: unknown;\n}\n\n/**\n * Typed wrapper around the 10 real AdaptOrch MCP tools.\n *\n * See doc section \"The real, current 10-tool MCP surface (grouped)\" for\n * the full tool list, purposes, and read/write classification. This\n * class only translates method calls into `transport.callTool` calls\n * with the exact tool names the doc lists; it does not implement a\n * transport itself.\n */\nexport class AdaptOrchClient {\n\tprivate readonly transport: AdaptOrchTransport;\n\n\tconstructor(transport: AdaptOrchTransport) {\n\t\tthis.transport = transport;\n\t}\n\n\t/**\n\t * `adaptorch_run` (write). Submit a task payload to the control-plane,\n\t * optionally blocking until the run reaches a terminal status.\n\t */\n\tasync run(payload: AdaptOrchRunPayload): Promise<AdaptOrchRunResult> {\n\t\t// The transport result shape is not schema-validated here; callers\n\t\t// relying on strict correctness should validate at the transport\n\t\t// boundary.\n\t\treturn (await this.transport.callTool(\"adaptorch_run\", { ...payload })) as AdaptOrchRunResult;\n\t}\n\n\t/**\n\t * `adaptorch_get_run` (read). Fetch a run summary by `run_id`.\n\t */\n\tasync getRun(runId: string): Promise<AdaptOrchRunSummary> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_run\", { run_id: runId })) as AdaptOrchRunSummary;\n\t}\n\n\t/**\n\t * `adaptorch_list_runs` (read). List recent control-plane runs.\n\t */\n\tasync listRuns(params?: { limit?: number }): Promise<AdaptOrchRunListEntry[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_list_runs\", { ...params })) as AdaptOrchRunListEntry[];\n\t}\n\n\t/**\n\t * `adaptorch_cancel_run` (write). Request cancellation of an in-flight\n\t * run by `run_id`.\n\t */\n\tasync cancelRun(runId: string): Promise<AdaptOrchCancelResult> {\n\t\treturn (await this.transport.callTool(\"adaptorch_cancel_run\", { run_id: runId })) as AdaptOrchCancelResult;\n\t}\n\n\t/**\n\t * `adaptorch_get_artifacts` (read). Fetch artifact metadata for a run.\n\t */\n\tasync getArtifacts(runId: string): Promise<AdaptOrchArtifact[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_artifacts\", { run_id: runId })) as AdaptOrchArtifact[];\n\t}\n\n\t/**\n\t * `adaptorch_get_traces` (read). Fetch execution traces for a run by\n\t * `run_id`.\n\t */\n\tasync getTraces(runId: string): Promise<AdaptOrchTraceSpan[]> {\n\t\treturn (await this.transport.callTool(\"adaptorch_get_traces\", { run_id: runId })) as AdaptOrchTraceSpan[];\n\t}\n\n\t/** Route a DAG locally and fail closed if the MCP response drifts from the current topology contract. */\n\tasync routeTopology(payloadShape: unknown): Promise<AdaptOrchRouteTopologyResult> {\n\t\tconst raw = await this.transport.callTool(\"adaptorch_route_topology\", { payload_shape: payloadShape });\n\t\tconst topology = isRecord(raw) ? raw.topology : undefined;\n\t\tif (!isTopologyClassification(topology)) {\n\t\t\tthrow new Error(\"AdaptOrch route response has invalid topology\");\n\t\t}\n\t\treturn { classification: topology, raw };\n\t}\n\n\t/**\n\t * `adaptorch_server_metrics` (read/local). Read redacted MCP server\n\t * metrics (tool-call counters, latency percentiles).\n\t */\n\tasync serverMetrics(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_server_metrics\", {})) as Record<string, unknown>;\n\t}\n\n\t/**\n\t * `adaptorch_capabilities` (read/local). Read supported synthesis\n\t * modes, connectors, and server features.\n\t */\n\tasync capabilities(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_capabilities\", {})) as Record<string, unknown>;\n\t}\n\n\t/**\n\t * `adaptorch_usage` (read). Read this tenant's own usage window. The\n\t * control plane scopes the response by key, so a caller never sees another\n\t * tenant's counters.\n\t */\n\tasync usage(): Promise<AdaptOrchUsage> {\n\t\treturn (await this.transport.callTool(\"adaptorch_usage\", {})) as AdaptOrchUsage;\n\t}\n\n\t/**\n\t * `adaptorch_plan_catalog` (read/local). Read the hosted plan catalog.\n\t * Tier names and prices come from the server, never from this client.\n\t */\n\tasync planCatalog(): Promise<Record<string, unknown>> {\n\t\treturn (await this.transport.callTool(\"adaptorch_plan_catalog\", {})) as Record<string, unknown>;\n\t}\n}\n"]}

package/dist/index.d.ts

@@ -5,8 +5,10 @@
  * for the design this package implements. Ships as a runtime dependency of the
  * `open-multi-agent-kit` CLI.
  */
+export type { AdaptOrchApiConfig, AdaptOrchFetch, AdaptOrchHttpResponse, AdaptOrchRequestInit, Artifact, ArtifactListResponse, CapabilitySet, EvidenceCheck, EvidenceReport, ListRunsQuery, Principal, Run, RunListResponse, RunStatus, RunSubmission, } from "./adaptorch-api.ts";
+export { ADAPTORCH_DEFAULT_API_URL, AdaptOrchApiClient, AdaptOrchApiError, assertSafeApiUrl, createAdaptOrchApiClientFromEnv, resolveAuthHeaders, } from "./adaptorch-api.ts";
 export type { AdaptOrchTransport } from "./adaptorch-client.ts";
-export { AdaptOrchClient } from "./adaptorch-client.ts";
+export { ADAPTORCH_FULL_ONLY_TOOLS, ADAPTORCH_REMOTE_TOOLS, ADAPTORCH_TOOLS, AdaptOrchClient, } from "./adaptorch-client.ts";
 export type { AdjudicationRequest, AdjudicationResult, PerRunVerdict } from "./adjudicator.ts";
 export { adjudicate } from "./adjudicator.ts";
 export type { AdjudicationReasonCode, CheckResult, VerdictState, VerifierRegistryEntry, } from "./adjudicator-registry.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Public entry point for `omk-adaptorch-wpl` (stable since 0.91.0).\n *\n * See README.md and `.omk/runs/adaptorch-native-loop-algorithm-20260701/final-part{1,2,3}-*.md`\n * for the design this package implements. Ships as a runtime dependency of the\n * `open-multi-agent-kit` CLI.\n */\n\nexport type { AdaptOrchTransport } from \"./adaptorch-client.ts\";\nexport { AdaptOrchClient } from \"./adaptorch-client.ts\";\nexport type { AdjudicationRequest, AdjudicationResult, PerRunVerdict } from \"./adjudicator.ts\";\nexport { adjudicate } from \"./adjudicator.ts\";\nexport type {\n\tAdjudicationReasonCode,\n\tCheckResult,\n\tVerdictState,\n\tVerifierRegistryEntry,\n} from \"./adjudicator-registry.ts\";\nexport {\n\tADJUDICATION_REASON_CODES,\n\tcreateVerifierRegistry,\n\tDEFAULT_VERIFIER,\n\treduceReasonCodes,\n} from \"./adjudicator-registry.ts\";\nexport type { MapToB2CInput, MapToB2COutput } from \"./b2c-mapper.ts\";\nexport { BATCH1_NO_DOCKER_RUNNER, mapToB2C } from \"./b2c-mapper.ts\";\nexport type {\n\tUserRiskLevel,\n\tUserVerdict,\n\tVerdictCard,\n\tVerdictLimits,\n\tVerdictNextAction,\n\tVerificationReceipt,\n} from \"./b2c-verdict.ts\";\nexport { B2C_VERDICT_SCHEMA_VERSION } from \"./b2c-verdict.ts\";\nexport type {\n\tDeepWallPhase,\n\tDeepWallResult,\n\tDeepWallRunnerEvidence,\n\tDeepWallRunnerFn,\n\tDeepWallRunnerResult,\n\tDeepWallStatus,\n\tDeepWallStubResult,\n\tRunDeepWallStubParams,\n} from \"./deep-wall.ts\";\nexport {\n\tDEEP_RUNNER_ERROR,\n\tDEEP_RUNNER_EVIDENCE_MISSING,\n\tDEEP_RUNNER_NOT_WIRED,\n\tDEEP_WALL_UNAVAILABLE,\n\tisDeepRunnerCompletionAllowed,\n\tresolveDeepWallPhaseFromEnv,\n\trunDeepWall,\n\trunDeepWallStub,\n} from \"./deep-wall.ts\";\nexport type {\n\tEvaluateCorrectnessWallParams,\n\tEvaluateCorrectnessWallResult,\n} from \"./evaluate-correctness-wall.ts\";\nexport { evaluateCorrectnessWall } from \"./evaluate-correctness-wall.ts\";\nexport type { InMemoryAdaptOrchFixture } from \"./in-memory-adaptorch.ts\";\nexport { createInMemoryAdaptOrchClient } from \"./in-memory-adaptorch.ts\";\nexport type { AdaptOrchCallToolFn, OaTransportMode } from \"./live-adaptorch-transport.ts\";\nexport { createLiveAdaptOrchClient, parseOaTransportModeFromEnv } from \"./live-adaptorch-transport.ts\";\nexport type { NextActionKind, VerdictDisposition } from \"./loop.ts\";\nexport {\n\tdecideNextTransition,\n\thandleAdjudicationFailure,\n\tprojectVerdictToDisposition,\n\trunAdjudicationWithTimeout,\n} from \"./loop.ts\";\nexport type {\n\tCreateMcpIntrospectionTransportOptions,\n\tMcpIntrospectionMode,\n} from \"./mcp-introspection-transport.ts\";\nexport { createMcpIntrospectionClient } from \"./mcp-introspection-transport.ts\";\nexport type { PolicyFlag } from \"./policy-wall.ts\";\nexport {\n\tPOLICY_FLAG,\n\tparseDiffPaths,\n\tpathMatchesApprovedScope,\n\trunFastWall,\n\tscanDiffLinesForSecrets,\n} from \"./policy-wall.ts\";\nexport type { SignedWallReceipt, SignWallReceiptInput, VerifyWallReceiptInput } from \"./receipt-signature.ts\";\nexport { signWallReceipt, verifyWallReceipt } from \"./receipt-signature.ts\";\nexport type { BuildRegeneratePacketInput, RegeneratePacket } from \"./regenerate-packet.ts\";\nexport { buildRegeneratePacket } from \"./regenerate-packet.ts\";\nexport type { RepairBudgetState } from \"./repair-budget.ts\";\nexport { capRepairHints, parseRepairBudget, shouldOfferRepair } from \"./repair-budget.ts\";\nexport type { RepairHintInput } from \"./repair-loop.ts\";\nexport { deriveRepairHints } from \"./repair-loop.ts\";\nexport type {\n\tVerificationDigest,\n\tVerificationDigestInput,\n\tWallReceiptMeta,\n} from \"./signed-receipt.ts\";\nexport { buildVerificationDigest } from \"./signed-receipt.ts\";\nexport { applyTransition, canTransition, isTerminalState, requiresHumanApproval } from \"./state-machine.ts\";\nexport type {\n\tCardinalityMode,\n\tDispatchRecord,\n\tLoopConfig,\n\tLoopTerminationCondition,\n\tTopologyClassification,\n\tTransitionLogEntry,\n\tWorkPacket,\n\tWorkPacketState,\n} from \"./types.ts\";\nexport { ADJUDICATIONS_DIR, LOOP_STATE_FILE, PACKET_INDEX_FILE, PACKETS_DIR, RUN_MAP_FILE } from \"./types.ts\";\nexport { CORRECTNESS_WALL_VERSION } from \"./wall-meta.ts\";\n"]}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Public entry point for `omk-adaptorch-wpl` (stable since 0.91.0).\n *\n * See README.md and `.omk/runs/adaptorch-native-loop-algorithm-20260701/final-part{1,2,3}-*.md`\n * for the design this package implements. Ships as a runtime dependency of the\n * `open-multi-agent-kit` CLI.\n */\n\nexport type {\n\tAdaptOrchApiConfig,\n\tAdaptOrchFetch,\n\tAdaptOrchHttpResponse,\n\tAdaptOrchRequestInit,\n\tArtifact,\n\tArtifactListResponse,\n\tCapabilitySet,\n\tEvidenceCheck,\n\tEvidenceReport,\n\tListRunsQuery,\n\tPrincipal,\n\tRun,\n\tRunListResponse,\n\tRunStatus,\n\tRunSubmission,\n} from \"./adaptorch-api.ts\";\nexport {\n\tADAPTORCH_DEFAULT_API_URL,\n\tAdaptOrchApiClient,\n\tAdaptOrchApiError,\n\tassertSafeApiUrl,\n\tcreateAdaptOrchApiClientFromEnv,\n\tresolveAuthHeaders,\n} from \"./adaptorch-api.ts\";\nexport type { AdaptOrchTransport } from \"./adaptorch-client.ts\";\nexport {\n\tADAPTORCH_FULL_ONLY_TOOLS,\n\tADAPTORCH_REMOTE_TOOLS,\n\tADAPTORCH_TOOLS,\n\tAdaptOrchClient,\n} from \"./adaptorch-client.ts\";\nexport type { AdjudicationRequest, AdjudicationResult, PerRunVerdict } from \"./adjudicator.ts\";\nexport { adjudicate } from \"./adjudicator.ts\";\nexport type {\n\tAdjudicationReasonCode,\n\tCheckResult,\n\tVerdictState,\n\tVerifierRegistryEntry,\n} from \"./adjudicator-registry.ts\";\nexport {\n\tADJUDICATION_REASON_CODES,\n\tcreateVerifierRegistry,\n\tDEFAULT_VERIFIER,\n\treduceReasonCodes,\n} from \"./adjudicator-registry.ts\";\nexport type { MapToB2CInput, MapToB2COutput } from \"./b2c-mapper.ts\";\nexport { BATCH1_NO_DOCKER_RUNNER, mapToB2C } from \"./b2c-mapper.ts\";\nexport type {\n\tUserRiskLevel,\n\tUserVerdict,\n\tVerdictCard,\n\tVerdictLimits,\n\tVerdictNextAction,\n\tVerificationReceipt,\n} from \"./b2c-verdict.ts\";\nexport { B2C_VERDICT_SCHEMA_VERSION } from \"./b2c-verdict.ts\";\nexport type {\n\tDeepWallPhase,\n\tDeepWallResult,\n\tDeepWallRunnerEvidence,\n\tDeepWallRunnerFn,\n\tDeepWallRunnerResult,\n\tDeepWallStatus,\n\tDeepWallStubResult,\n\tRunDeepWallStubParams,\n} from \"./deep-wall.ts\";\nexport {\n\tDEEP_RUNNER_ERROR,\n\tDEEP_RUNNER_EVIDENCE_MISSING,\n\tDEEP_RUNNER_NOT_WIRED,\n\tDEEP_WALL_UNAVAILABLE,\n\tisDeepRunnerCompletionAllowed,\n\tresolveDeepWallPhaseFromEnv,\n\trunDeepWall,\n\trunDeepWallStub,\n} from \"./deep-wall.ts\";\nexport type {\n\tEvaluateCorrectnessWallParams,\n\tEvaluateCorrectnessWallResult,\n} from \"./evaluate-correctness-wall.ts\";\nexport { evaluateCorrectnessWall } from \"./evaluate-correctness-wall.ts\";\nexport type { InMemoryAdaptOrchFixture } from \"./in-memory-adaptorch.ts\";\nexport { createInMemoryAdaptOrchClient } from \"./in-memory-adaptorch.ts\";\nexport type { AdaptOrchCallToolFn, OaTransportMode } from \"./live-adaptorch-transport.ts\";\nexport { createLiveAdaptOrchClient, parseOaTransportModeFromEnv } from \"./live-adaptorch-transport.ts\";\nexport type { NextActionKind, VerdictDisposition } from \"./loop.ts\";\nexport {\n\tdecideNextTransition,\n\thandleAdjudicationFailure,\n\tprojectVerdictToDisposition,\n\trunAdjudicationWithTimeout,\n} from \"./loop.ts\";\nexport type {\n\tCreateMcpIntrospectionTransportOptions,\n\tMcpIntrospectionMode,\n} from \"./mcp-introspection-transport.ts\";\nexport { createMcpIntrospectionClient } from \"./mcp-introspection-transport.ts\";\nexport type { PolicyFlag } from \"./policy-wall.ts\";\nexport {\n\tPOLICY_FLAG,\n\tparseDiffPaths,\n\tpathMatchesApprovedScope,\n\trunFastWall,\n\tscanDiffLinesForSecrets,\n} from \"./policy-wall.ts\";\nexport type { SignedWallReceipt, SignWallReceiptInput, VerifyWallReceiptInput } from \"./receipt-signature.ts\";\nexport { signWallReceipt, verifyWallReceipt } from \"./receipt-signature.ts\";\nexport type { BuildRegeneratePacketInput, RegeneratePacket } from \"./regenerate-packet.ts\";\nexport { buildRegeneratePacket } from \"./regenerate-packet.ts\";\nexport type { RepairBudgetState } from \"./repair-budget.ts\";\nexport { capRepairHints, parseRepairBudget, shouldOfferRepair } from \"./repair-budget.ts\";\nexport type { RepairHintInput } from \"./repair-loop.ts\";\nexport { deriveRepairHints } from \"./repair-loop.ts\";\nexport type {\n\tVerificationDigest,\n\tVerificationDigestInput,\n\tWallReceiptMeta,\n} from \"./signed-receipt.ts\";\nexport { buildVerificationDigest } from \"./signed-receipt.ts\";\nexport { applyTransition, canTransition, isTerminalState, requiresHumanApproval } from \"./state-machine.ts\";\nexport type {\n\tCardinalityMode,\n\tDispatchRecord,\n\tLoopConfig,\n\tLoopTerminationCondition,\n\tTopologyClassification,\n\tTransitionLogEntry,\n\tWorkPacket,\n\tWorkPacketState,\n} from \"./types.ts\";\nexport { ADJUDICATIONS_DIR, LOOP_STATE_FILE, PACKET_INDEX_FILE, PACKETS_DIR, RUN_MAP_FILE } from \"./types.ts\";\nexport { CORRECTNESS_WALL_VERSION } from \"./wall-meta.ts\";\n"]}

package/dist/index.js

@@ -5,7 +5,8 @@
  * for the design this package implements. Ships as a runtime dependency of the
  * `open-multi-agent-kit` CLI.
  */
-export { AdaptOrchClient } from "./adaptorch-client.js";
+export { ADAPTORCH_DEFAULT_API_URL, AdaptOrchApiClient, AdaptOrchApiError, assertSafeApiUrl, createAdaptOrchApiClientFromEnv, resolveAuthHeaders, } from "./adaptorch-api.js";
+export { ADAPTORCH_FULL_ONLY_TOOLS, ADAPTORCH_REMOTE_TOOLS, ADAPTORCH_TOOLS, AdaptOrchClient, } from "./adaptorch-client.js";
 export { adjudicate } from "./adjudicator.js";
 export { ADJUDICATION_REASON_CODES, createVerifierRegistry, DEFAULT_VERIFIER, reduceReasonCodes, } from "./adjudicator-registry.js";
 export { BATCH1_NO_DOCKER_RUNNER, mapToB2C } from "./b2c-mapper.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO9C,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AASpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAW9D,OAAO,EACN,iBAAiB,EACjB,4BAA4B,EAC5B,qBAAqB,EACrB,qBAAqB,EACrB,6BAA6B,EAC7B,2BAA2B,EAC3B,WAAW,EACX,eAAe,GACf,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEvG,OAAO,EACN,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,GAC1B,MAAM,WAAW,CAAC;AAKnB,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAEhF,OAAO,EACN,WAAW,EACX,cAAc,EACd,wBAAwB,EACxB,WAAW,EACX,uBAAuB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAW5G,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9G,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["/**\n * Public entry point for `omk-adaptorch-wpl` (stable since 0.91.0).\n *\n * See README.md and `.omk/runs/adaptorch-native-loop-algorithm-20260701/final-part{1,2,3}-*.md`\n * for the design this package implements. Ships as a runtime dependency of the\n * `open-multi-agent-kit` CLI.\n */\n\nexport type { AdaptOrchTransport } from \"./adaptorch-client.ts\";\nexport { AdaptOrchClient } from \"./adaptorch-client.ts\";\nexport type { AdjudicationRequest, AdjudicationResult, PerRunVerdict } from \"./adjudicator.ts\";\nexport { adjudicate } from \"./adjudicator.ts\";\nexport type {\n\tAdjudicationReasonCode,\n\tCheckResult,\n\tVerdictState,\n\tVerifierRegistryEntry,\n} from \"./adjudicator-registry.ts\";\nexport {\n\tADJUDICATION_REASON_CODES,\n\tcreateVerifierRegistry,\n\tDEFAULT_VERIFIER,\n\treduceReasonCodes,\n} from \"./adjudicator-registry.ts\";\nexport type { MapToB2CInput, MapToB2COutput } from \"./b2c-mapper.ts\";\nexport { BATCH1_NO_DOCKER_RUNNER, mapToB2C } from \"./b2c-mapper.ts\";\nexport type {\n\tUserRiskLevel,\n\tUserVerdict,\n\tVerdictCard,\n\tVerdictLimits,\n\tVerdictNextAction,\n\tVerificationReceipt,\n} from \"./b2c-verdict.ts\";\nexport { B2C_VERDICT_SCHEMA_VERSION } from \"./b2c-verdict.ts\";\nexport type {\n\tDeepWallPhase,\n\tDeepWallResult,\n\tDeepWallRunnerEvidence,\n\tDeepWallRunnerFn,\n\tDeepWallRunnerResult,\n\tDeepWallStatus,\n\tDeepWallStubResult,\n\tRunDeepWallStubParams,\n} from \"./deep-wall.ts\";\nexport {\n\tDEEP_RUNNER_ERROR,\n\tDEEP_RUNNER_EVIDENCE_MISSING,\n\tDEEP_RUNNER_NOT_WIRED,\n\tDEEP_WALL_UNAVAILABLE,\n\tisDeepRunnerCompletionAllowed,\n\tresolveDeepWallPhaseFromEnv,\n\trunDeepWall,\n\trunDeepWallStub,\n} from \"./deep-wall.ts\";\nexport type {\n\tEvaluateCorrectnessWallParams,\n\tEvaluateCorrectnessWallResult,\n} from \"./evaluate-correctness-wall.ts\";\nexport { evaluateCorrectnessWall } from \"./evaluate-correctness-wall.ts\";\nexport type { InMemoryAdaptOrchFixture } from \"./in-memory-adaptorch.ts\";\nexport { createInMemoryAdaptOrchClient } from \"./in-memory-adaptorch.ts\";\nexport type { AdaptOrchCallToolFn, OaTransportMode } from \"./live-adaptorch-transport.ts\";\nexport { createLiveAdaptOrchClient, parseOaTransportModeFromEnv } from \"./live-adaptorch-transport.ts\";\nexport type { NextActionKind, VerdictDisposition } from \"./loop.ts\";\nexport {\n\tdecideNextTransition,\n\thandleAdjudicationFailure,\n\tprojectVerdictToDisposition,\n\trunAdjudicationWithTimeout,\n} from \"./loop.ts\";\nexport type {\n\tCreateMcpIntrospectionTransportOptions,\n\tMcpIntrospectionMode,\n} from \"./mcp-introspection-transport.ts\";\nexport { createMcpIntrospectionClient } from \"./mcp-introspection-transport.ts\";\nexport type { PolicyFlag } from \"./policy-wall.ts\";\nexport {\n\tPOLICY_FLAG,\n\tparseDiffPaths,\n\tpathMatchesApprovedScope,\n\trunFastWall,\n\tscanDiffLinesForSecrets,\n} from \"./policy-wall.ts\";\nexport type { SignedWallReceipt, SignWallReceiptInput, VerifyWallReceiptInput } from \"./receipt-signature.ts\";\nexport { signWallReceipt, verifyWallReceipt } from \"./receipt-signature.ts\";\nexport type { BuildRegeneratePacketInput, RegeneratePacket } from \"./regenerate-packet.ts\";\nexport { buildRegeneratePacket } from \"./regenerate-packet.ts\";\nexport type { RepairBudgetState } from \"./repair-budget.ts\";\nexport { capRepairHints, parseRepairBudget, shouldOfferRepair } from \"./repair-budget.ts\";\nexport type { RepairHintInput } from \"./repair-loop.ts\";\nexport { deriveRepairHints } from \"./repair-loop.ts\";\nexport type {\n\tVerificationDigest,\n\tVerificationDigestInput,\n\tWallReceiptMeta,\n} from \"./signed-receipt.ts\";\nexport { buildVerificationDigest } from \"./signed-receipt.ts\";\nexport { applyTransition, canTransition, isTerminalState, requiresHumanApproval } from \"./state-machine.ts\";\nexport type {\n\tCardinalityMode,\n\tDispatchRecord,\n\tLoopConfig,\n\tLoopTerminationCondition,\n\tTopologyClassification,\n\tTransitionLogEntry,\n\tWorkPacket,\n\tWorkPacketState,\n} from \"./types.ts\";\nexport { ADJUDICATIONS_DIR, LOOP_STATE_FILE, PACKET_INDEX_FILE, PACKETS_DIR, RUN_MAP_FILE } from \"./types.ts\";\nexport { CORRECTNESS_WALL_VERSION } from \"./wall-meta.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,OAAO,EACN,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,+BAA+B,EAC/B,kBAAkB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EACf,eAAe,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO9C,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AASpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAW9D,OAAO,EACN,iBAAiB,EACjB,4BAA4B,EAC5B,qBAAqB,EACrB,qBAAqB,EACrB,6BAA6B,EAC7B,2BAA2B,EAC3B,WAAW,EACX,eAAe,GACf,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEvG,OAAO,EACN,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,GAC1B,MAAM,WAAW,CAAC;AAKnB,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAEhF,OAAO,EACN,WAAW,EACX,cAAc,EACd,wBAAwB,EACxB,WAAW,EACX,uBAAuB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAW5G,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9G,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["/**\n * Public entry point for `omk-adaptorch-wpl` (stable since 0.91.0).\n *\n * See README.md and `.omk/runs/adaptorch-native-loop-algorithm-20260701/final-part{1,2,3}-*.md`\n * for the design this package implements. Ships as a runtime dependency of the\n * `open-multi-agent-kit` CLI.\n */\n\nexport type {\n\tAdaptOrchApiConfig,\n\tAdaptOrchFetch,\n\tAdaptOrchHttpResponse,\n\tAdaptOrchRequestInit,\n\tArtifact,\n\tArtifactListResponse,\n\tCapabilitySet,\n\tEvidenceCheck,\n\tEvidenceReport,\n\tListRunsQuery,\n\tPrincipal,\n\tRun,\n\tRunListResponse,\n\tRunStatus,\n\tRunSubmission,\n} from \"./adaptorch-api.ts\";\nexport {\n\tADAPTORCH_DEFAULT_API_URL,\n\tAdaptOrchApiClient,\n\tAdaptOrchApiError,\n\tassertSafeApiUrl,\n\tcreateAdaptOrchApiClientFromEnv,\n\tresolveAuthHeaders,\n} from \"./adaptorch-api.ts\";\nexport type { AdaptOrchTransport } from \"./adaptorch-client.ts\";\nexport {\n\tADAPTORCH_FULL_ONLY_TOOLS,\n\tADAPTORCH_REMOTE_TOOLS,\n\tADAPTORCH_TOOLS,\n\tAdaptOrchClient,\n} from \"./adaptorch-client.ts\";\nexport type { AdjudicationRequest, AdjudicationResult, PerRunVerdict } from \"./adjudicator.ts\";\nexport { adjudicate } from \"./adjudicator.ts\";\nexport type {\n\tAdjudicationReasonCode,\n\tCheckResult,\n\tVerdictState,\n\tVerifierRegistryEntry,\n} from \"./adjudicator-registry.ts\";\nexport {\n\tADJUDICATION_REASON_CODES,\n\tcreateVerifierRegistry,\n\tDEFAULT_VERIFIER,\n\treduceReasonCodes,\n} from \"./adjudicator-registry.ts\";\nexport type { MapToB2CInput, MapToB2COutput } from \"./b2c-mapper.ts\";\nexport { BATCH1_NO_DOCKER_RUNNER, mapToB2C } from \"./b2c-mapper.ts\";\nexport type {\n\tUserRiskLevel,\n\tUserVerdict,\n\tVerdictCard,\n\tVerdictLimits,\n\tVerdictNextAction,\n\tVerificationReceipt,\n} from \"./b2c-verdict.ts\";\nexport { B2C_VERDICT_SCHEMA_VERSION } from \"./b2c-verdict.ts\";\nexport type {\n\tDeepWallPhase,\n\tDeepWallResult,\n\tDeepWallRunnerEvidence,\n\tDeepWallRunnerFn,\n\tDeepWallRunnerResult,\n\tDeepWallStatus,\n\tDeepWallStubResult,\n\tRunDeepWallStubParams,\n} from \"./deep-wall.ts\";\nexport {\n\tDEEP_RUNNER_ERROR,\n\tDEEP_RUNNER_EVIDENCE_MISSING,\n\tDEEP_RUNNER_NOT_WIRED,\n\tDEEP_WALL_UNAVAILABLE,\n\tisDeepRunnerCompletionAllowed,\n\tresolveDeepWallPhaseFromEnv,\n\trunDeepWall,\n\trunDeepWallStub,\n} from \"./deep-wall.ts\";\nexport type {\n\tEvaluateCorrectnessWallParams,\n\tEvaluateCorrectnessWallResult,\n} from \"./evaluate-correctness-wall.ts\";\nexport { evaluateCorrectnessWall } from \"./evaluate-correctness-wall.ts\";\nexport type { InMemoryAdaptOrchFixture } from \"./in-memory-adaptorch.ts\";\nexport { createInMemoryAdaptOrchClient } from \"./in-memory-adaptorch.ts\";\nexport type { AdaptOrchCallToolFn, OaTransportMode } from \"./live-adaptorch-transport.ts\";\nexport { createLiveAdaptOrchClient, parseOaTransportModeFromEnv } from \"./live-adaptorch-transport.ts\";\nexport type { NextActionKind, VerdictDisposition } from \"./loop.ts\";\nexport {\n\tdecideNextTransition,\n\thandleAdjudicationFailure,\n\tprojectVerdictToDisposition,\n\trunAdjudicationWithTimeout,\n} from \"./loop.ts\";\nexport type {\n\tCreateMcpIntrospectionTransportOptions,\n\tMcpIntrospectionMode,\n} from \"./mcp-introspection-transport.ts\";\nexport { createMcpIntrospectionClient } from \"./mcp-introspection-transport.ts\";\nexport type { PolicyFlag } from \"./policy-wall.ts\";\nexport {\n\tPOLICY_FLAG,\n\tparseDiffPaths,\n\tpathMatchesApprovedScope,\n\trunFastWall,\n\tscanDiffLinesForSecrets,\n} from \"./policy-wall.ts\";\nexport type { SignedWallReceipt, SignWallReceiptInput, VerifyWallReceiptInput } from \"./receipt-signature.ts\";\nexport { signWallReceipt, verifyWallReceipt } from \"./receipt-signature.ts\";\nexport type { BuildRegeneratePacketInput, RegeneratePacket } from \"./regenerate-packet.ts\";\nexport { buildRegeneratePacket } from \"./regenerate-packet.ts\";\nexport type { RepairBudgetState } from \"./repair-budget.ts\";\nexport { capRepairHints, parseRepairBudget, shouldOfferRepair } from \"./repair-budget.ts\";\nexport type { RepairHintInput } from \"./repair-loop.ts\";\nexport { deriveRepairHints } from \"./repair-loop.ts\";\nexport type {\n\tVerificationDigest,\n\tVerificationDigestInput,\n\tWallReceiptMeta,\n} from \"./signed-receipt.ts\";\nexport { buildVerificationDigest } from \"./signed-receipt.ts\";\nexport { applyTransition, canTransition, isTerminalState, requiresHumanApproval } from \"./state-machine.ts\";\nexport type {\n\tCardinalityMode,\n\tDispatchRecord,\n\tLoopConfig,\n\tLoopTerminationCondition,\n\tTopologyClassification,\n\tTransitionLogEntry,\n\tWorkPacket,\n\tWorkPacketState,\n} from \"./types.ts\";\nexport { ADJUDICATIONS_DIR, LOOP_STATE_FILE, PACKET_INDEX_FILE, PACKETS_DIR, RUN_MAP_FILE } from \"./types.ts\";\nexport { CORRECTNESS_WALL_VERSION } from \"./wall-meta.ts\";\n"]}

package/dist/types.d.ts

@@ -18,11 +18,10 @@ export type WorkPacketState = "DRAFTED" | "ROUTED" | "AWAITING_APPROVAL" | "DISP
  * single-call-vs-client-side-fanout ambiguity.
  */
 export type CardinalityMode = "single_call" | "fanout_n";
-/**
- * Part 1 §3.1 — the four topology classes `adaptorch_route_topology` can return for a
- * packet's payload, decided once per packet before any `adaptorch_run` call.
- */
-export type TopologyClassification = "singleton" | "pipeline" | "dag" | "ensemble";
+/** Current `adaptorch_route_topology` values, synchronized with AdaptOrch's `Topology` enum. */
+export declare const TOPOLOGY_CLASSIFICATIONS: readonly ["parallel", "sequential", "hierarchical", "hybrid", "multi_model_ensemble", "multi_turn_debate"];
+export type TopologyClassification = (typeof TOPOLOGY_CLASSIFICATIONS)[number];
+export declare function isTopologyClassification(value: unknown): value is TopologyClassification;
 /**
  * Part 1 §3.3 / §7 — one concrete submission attempt for a Work Packet. A Dispatch Record
  * holds a run_id *set* (not a single run_id) tagged with its cardinality mode, so polling,

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Design-fidelity note: this file implements the Work Packet on-disk schema and supporting\n * type vocabulary defined in Part 1 (`final-part1-core-algorithm.md`), Sections 1, 2, 3, 4,\n * and 7. It is an implementation of that document, not a restatement of it — see the design\n * doc for rationale, transition semantics, and the open questions left for other lanes.\n */\n\n/**\n * Work Packet lifecycle states.\n *\n * Part 1 §2 — the fourteen states of the packet-level state machine, including the\n * ESCALATED / AWAITING_APPROVAL / ADJUDICATION_FAILED additions from this revision.\n */\nexport type WorkPacketState =\n\t| \"DRAFTED\"\n\t| \"ROUTED\"\n\t| \"AWAITING_APPROVAL\"\n\t| \"DISPATCHED\"\n\t| \"ACTIVE\"\n\t| \"HALTING\"\n\t| \"RAW_TERMINAL\"\n\t| \"UNDER_REVIEW\"\n\t| \"ADJUDICATION_FAILED\"\n\t| \"CONFIRMED\"\n\t| \"DECLINED\"\n\t| \"RETRY_QUEUED\"\n\t| \"ESCALATED\"\n\t| \"CLOSED\";\n\n/**\n * Part 1 §3.3 — whether a Dispatch Record's run_id set was produced by a single\n * `adaptorch_run` call (`single_call`) or by N calls the loop itself issued (`fanout_n`).\n * This tag is what lets the rest of the state machine stay agnostic to the Section 3.2\n * single-call-vs-client-side-fanout ambiguity.\n */\nexport type CardinalityMode = \"single_call\" | \"fanout_n\";\n\n/**\n * Part 1 §3.1 — the four topology classes `adaptorch_route_topology` can return for a\n * packet's payload, decided once per packet before any `adaptorch_run` call.\n */\nexport type TopologyClassification = \"singleton\" | \"pipeline\" | \"dag\" | \"ensemble\";\n\n/**\n * Part 1 §3.3 / §7 — one concrete submission attempt for a Work Packet. A Dispatch Record\n * holds a run_id *set* (not a single run_id) tagged with its cardinality mode, so polling,\n * cancellation, and review packaging work the same way regardless of which Section 3.2\n * reading turns out to be correct.\n */\nexport interface DispatchRecord {\n\tattempt_n: number;\n\tcardinality_mode: CardinalityMode;\n\trun_ids: string[];\n\tsubmitted_at: string;\n\tmode: \"blocking\" | \"polling\";\n\tterminal_status?: string;\n\tterminal_at?: string;\n}\n\n/**\n * Part 1 §7 — one append-only entry in a Work Packet's transition log. Recorded for every\n * state change, including adjudication-call failures that have no `AdjudicationResult` to\n * archive elsewhere.\n */\nexport interface TransitionLogEntry {\n\tfrom: WorkPacketState;\n\tto: WorkPacketState;\n\tat: string;\n\tcause: string;\n}\n\n/**\n * Part 1 §1 / §7 — the Work Packet: the durable unit of intent this loop manages, potentially\n * resubmitted across several Dispatch Records over its life.\n *\n * The design doc (§7) also describes `adjudication_retry_count` (a separate bounded counter\n * for retrying the `adjudicate()` call itself, Part 1 §2/§6) and\n * `last_human_approved_topology_class` as persisted fields. Those are not modeled on this\n * type in this cut; a later change can add them without breaking the fields defined here.\n */\nexport interface WorkPacket {\n\tpacket_id: string;\n\tkind: string;\n\tcreated_at: string;\n\tpayload: unknown;\n\ttopology_decision: {\n\t\tclassification: TopologyClassification;\n\t\tdecided_at: string;\n\t\traw_route_response: unknown;\n\t} | null;\n\tdispatch_records: DispatchRecord[];\n\tstate: WorkPacketState;\n\tretry_count: number;\n\ttransition_log: TransitionLogEntry[];\n\tlast_adjudication_ref: string | null;\n\t/** Part 1 §4 — the per-packet attempt budget (`max_dispatch_attempts`) and how much of it has been used. */\n\tattempt_budget: {\n\t\tmax_dispatch_attempts: number;\n\t\tdispatch_attempts_used: number;\n\t};\n\t/**\n\t * Part 1 §2 state 3 / §7 — the payload most recently approved by a human reviewer (or the\n\t * original payload at creation, implicitly approved). `null` only if the packet has not yet\n\t * been assigned an initial baseline. Used by `requiresHumanApproval` to decide whether the\n\t * next attempt needs an AWAITING_APPROVAL gate before its first dispatch.\n\t */\n\tlast_human_approved_payload: unknown | null;\n}\n\n/**\n * Part 1 §4 — the named reasons the loop stops admitting new DRAFTED packets and begins\n * draining. `capacity_ceiling` and the cardinality-mismatch guard are soft governors (they\n * reduce admission/concurrency rather than terminating the loop outright); the others are\n * hard termination conditions.\n */\nexport type LoopTerminationCondition =\n\t| \"completion_exhaustion\"\n\t| \"per_packet_attempt_budget\"\n\t| \"wall_clock_budget\"\n\t| \"dispatch_call_budget\"\n\t| \"stagnation_guard\"\n\t| \"capacity_ceiling\"\n\t| \"external_abort\";\n\n/**\n * Part 1 §4 — loop-instance configuration. Per the \"Budget immutability\" rule in §4, every\n * field here is fixed at loop-instance creation and must not be mutated for that instance's\n * lifetime; raising a threshold requires starting a new loop instance.\n */\nexport interface LoopConfig {\n\tloop_instance_id: string;\n\t/** Part 1 §4 \"Per-packet attempt budget\" — illustrative default in the design doc is 3. */\n\tmax_dispatch_attempts_per_packet: number;\n\t/** Part 1 §4 \"Loop wall-clock budget\", expressed in milliseconds. */\n\tmax_loop_duration_ms: number;\n\t/** Part 1 §4 \"Loop dispatch-call budget\" — total `adaptorch_run` invocations allowed across the loop's life. */\n\tmax_total_dispatch_calls: number;\n\t/**\n\t * Part 1 §4 \"Stagnation guard\" — the number of consecutive loop-wide DECLINED verdicts\n\t * with indistinguishable evidence (same reason text / same evidence digest) that triggers\n\t * a halt.\n\t */\n\tstagnation_repeat_threshold: number;\n\t/**\n\t * Part 1 §4 \"Capacity ceiling (soft governor)\". Shape chosen for this implementation, not\n\t * dictated verbatim by the design doc: a saturation fraction/duration pair that must be\n\t * sustained before the governor engages, and the reduced concurrency ceiling it engages to.\n\t */\n\tcapacity_governor_thresholds: {\n\t\t/** Fraction (0-1) of `adaptorch_server_metrics` saturation considered \"sustained saturation\". */\n\t\tsaturation_threshold: number;\n\t\t/** How long saturation must persist, in milliseconds, before the governor engages. */\n\t\tsustained_duration_ms: number;\n\t\t/** Concurrency budget (max packets allowed into ACTIVE at once) while the governor is engaged. */\n\t\treduced_concurrency_ceiling: number;\n\t};\n\t/**\n\t * Part 1 §2 state 3 — the documented opt-in escape hatch that skips AWAITING_APPROVAL\n\t * for every attempt in this loop instance, regardless of payload/topology drift.\n\t */\n\tpre_approved_batch: boolean;\n\t/**\n\t * Part 1 §3.4 — the result of the one-time cardinality calibration probe, or `null` before\n\t * that probe has run. Continuously cross-checked (at zero extra call cost) against later\n\t * `adaptorch_get_run`/reconciliation-sweep observations per §3.4.\n\t */\n\tobserved_cardinality_mode: CardinalityMode | null;\n}\n\n/**\n * Part 1 §7 — on-disk file layout constants, rooted at a loop-instance directory. Exported so\n * other modules never hardcode these path segments.\n */\nexport const PACKETS_DIR = \"packets\";\nexport const PACKET_INDEX_FILE = \"packet_index.json\";\nexport const RUN_MAP_FILE = \"run_map.json\";\nexport const LOOP_STATE_FILE = \"loop_state.json\";\nexport const ADJUDICATIONS_DIR = \"adjudications\";\n"]}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Design-fidelity note: this file implements the Work Packet on-disk schema and supporting\n * type vocabulary defined in Part 1 (`final-part1-core-algorithm.md`), Sections 1, 2, 3, 4,\n * and 7. It is an implementation of that document, not a restatement of it — see the design\n * doc for rationale, transition semantics, and the open questions left for other lanes.\n */\n\n/**\n * Work Packet lifecycle states.\n *\n * Part 1 §2 — the fourteen states of the packet-level state machine, including the\n * ESCALATED / AWAITING_APPROVAL / ADJUDICATION_FAILED additions from this revision.\n */\nexport type WorkPacketState =\n\t| \"DRAFTED\"\n\t| \"ROUTED\"\n\t| \"AWAITING_APPROVAL\"\n\t| \"DISPATCHED\"\n\t| \"ACTIVE\"\n\t| \"HALTING\"\n\t| \"RAW_TERMINAL\"\n\t| \"UNDER_REVIEW\"\n\t| \"ADJUDICATION_FAILED\"\n\t| \"CONFIRMED\"\n\t| \"DECLINED\"\n\t| \"RETRY_QUEUED\"\n\t| \"ESCALATED\"\n\t| \"CLOSED\";\n\n/**\n * Part 1 §3.3 — whether a Dispatch Record's run_id set was produced by a single\n * `adaptorch_run` call (`single_call`) or by N calls the loop itself issued (`fanout_n`).\n * This tag is what lets the rest of the state machine stay agnostic to the Section 3.2\n * single-call-vs-client-side-fanout ambiguity.\n */\nexport type CardinalityMode = \"single_call\" | \"fanout_n\";\n\n/** Current `adaptorch_route_topology` values, synchronized with AdaptOrch's `Topology` enum. */\nexport const TOPOLOGY_CLASSIFICATIONS = [\n\t\"parallel\",\n\t\"sequential\",\n\t\"hierarchical\",\n\t\"hybrid\",\n\t\"multi_model_ensemble\",\n\t\"multi_turn_debate\",\n] as const;\n\nexport type TopologyClassification = (typeof TOPOLOGY_CLASSIFICATIONS)[number];\n\nconst TOPOLOGY_CLASSIFICATION_SET: ReadonlySet<string> = new Set(TOPOLOGY_CLASSIFICATIONS);\n\nexport function isTopologyClassification(value: unknown): value is TopologyClassification {\n\treturn typeof value === \"string\" && TOPOLOGY_CLASSIFICATION_SET.has(value);\n}\n\n/**\n * Part 1 §3.3 / §7 — one concrete submission attempt for a Work Packet. A Dispatch Record\n * holds a run_id *set* (not a single run_id) tagged with its cardinality mode, so polling,\n * cancellation, and review packaging work the same way regardless of which Section 3.2\n * reading turns out to be correct.\n */\nexport interface DispatchRecord {\n\tattempt_n: number;\n\tcardinality_mode: CardinalityMode;\n\trun_ids: string[];\n\tsubmitted_at: string;\n\tmode: \"blocking\" | \"polling\";\n\tterminal_status?: string;\n\tterminal_at?: string;\n}\n\n/**\n * Part 1 §7 — one append-only entry in a Work Packet's transition log. Recorded for every\n * state change, including adjudication-call failures that have no `AdjudicationResult` to\n * archive elsewhere.\n */\nexport interface TransitionLogEntry {\n\tfrom: WorkPacketState;\n\tto: WorkPacketState;\n\tat: string;\n\tcause: string;\n}\n\n/**\n * Part 1 §1 / §7 — the Work Packet: the durable unit of intent this loop manages, potentially\n * resubmitted across several Dispatch Records over its life.\n *\n * The design doc (§7) also describes `adjudication_retry_count` (a separate bounded counter\n * for retrying the `adjudicate()` call itself, Part 1 §2/§6) and\n * `last_human_approved_topology_class` as persisted fields. Those are not modeled on this\n * type in this cut; a later change can add them without breaking the fields defined here.\n */\nexport interface WorkPacket {\n\tpacket_id: string;\n\tkind: string;\n\tcreated_at: string;\n\tpayload: unknown;\n\ttopology_decision: {\n\t\tclassification: TopologyClassification;\n\t\tdecided_at: string;\n\t\traw_route_response: unknown;\n\t} | null;\n\tdispatch_records: DispatchRecord[];\n\tstate: WorkPacketState;\n\tretry_count: number;\n\ttransition_log: TransitionLogEntry[];\n\tlast_adjudication_ref: string | null;\n\t/** Part 1 §4 — the per-packet attempt budget (`max_dispatch_attempts`) and how much of it has been used. */\n\tattempt_budget: {\n\t\tmax_dispatch_attempts: number;\n\t\tdispatch_attempts_used: number;\n\t};\n\t/**\n\t * Part 1 §2 state 3 / §7 — the payload most recently approved by a human reviewer (or the\n\t * original payload at creation, implicitly approved). `null` only if the packet has not yet\n\t * been assigned an initial baseline. Used by `requiresHumanApproval` to decide whether the\n\t * next attempt needs an AWAITING_APPROVAL gate before its first dispatch.\n\t */\n\tlast_human_approved_payload: unknown | null;\n}\n\n/**\n * Part 1 §4 — the named reasons the loop stops admitting new DRAFTED packets and begins\n * draining. `capacity_ceiling` and the cardinality-mismatch guard are soft governors (they\n * reduce admission/concurrency rather than terminating the loop outright); the others are\n * hard termination conditions.\n */\nexport type LoopTerminationCondition =\n\t| \"completion_exhaustion\"\n\t| \"per_packet_attempt_budget\"\n\t| \"wall_clock_budget\"\n\t| \"dispatch_call_budget\"\n\t| \"stagnation_guard\"\n\t| \"capacity_ceiling\"\n\t| \"external_abort\";\n\n/**\n * Part 1 §4 — loop-instance configuration. Per the \"Budget immutability\" rule in §4, every\n * field here is fixed at loop-instance creation and must not be mutated for that instance's\n * lifetime; raising a threshold requires starting a new loop instance.\n */\nexport interface LoopConfig {\n\tloop_instance_id: string;\n\t/** Part 1 §4 \"Per-packet attempt budget\" — illustrative default in the design doc is 3. */\n\tmax_dispatch_attempts_per_packet: number;\n\t/** Part 1 §4 \"Loop wall-clock budget\", expressed in milliseconds. */\n\tmax_loop_duration_ms: number;\n\t/** Part 1 §4 \"Loop dispatch-call budget\" — total `adaptorch_run` invocations allowed across the loop's life. */\n\tmax_total_dispatch_calls: number;\n\t/**\n\t * Part 1 §4 \"Stagnation guard\" — the number of consecutive loop-wide DECLINED verdicts\n\t * with indistinguishable evidence (same reason text / same evidence digest) that triggers\n\t * a halt.\n\t */\n\tstagnation_repeat_threshold: number;\n\t/**\n\t * Part 1 §4 \"Capacity ceiling (soft governor)\". Shape chosen for this implementation, not\n\t * dictated verbatim by the design doc: a saturation fraction/duration pair that must be\n\t * sustained before the governor engages, and the reduced concurrency ceiling it engages to.\n\t */\n\tcapacity_governor_thresholds: {\n\t\t/** Fraction (0-1) of `adaptorch_server_metrics` saturation considered \"sustained saturation\". */\n\t\tsaturation_threshold: number;\n\t\t/** How long saturation must persist, in milliseconds, before the governor engages. */\n\t\tsustained_duration_ms: number;\n\t\t/** Concurrency budget (max packets allowed into ACTIVE at once) while the governor is engaged. */\n\t\treduced_concurrency_ceiling: number;\n\t};\n\t/**\n\t * Part 1 §2 state 3 — the documented opt-in escape hatch that skips AWAITING_APPROVAL\n\t * for every attempt in this loop instance, regardless of payload/topology drift.\n\t */\n\tpre_approved_batch: boolean;\n\t/**\n\t * Part 1 §3.4 — the result of the one-time cardinality calibration probe, or `null` before\n\t * that probe has run. Continuously cross-checked (at zero extra call cost) against later\n\t * `adaptorch_get_run`/reconciliation-sweep observations per §3.4.\n\t */\n\tobserved_cardinality_mode: CardinalityMode | null;\n}\n\n/**\n * Part 1 §7 — on-disk file layout constants, rooted at a loop-instance directory. Exported so\n * other modules never hardcode these path segments.\n */\nexport const PACKETS_DIR = \"packets\";\nexport const PACKET_INDEX_FILE = \"packet_index.json\";\nexport const RUN_MAP_FILE = \"run_map.json\";\nexport const LOOP_STATE_FILE = \"loop_state.json\";\nexport const ADJUDICATIONS_DIR = \"adjudications\";\n"]}

package/dist/types.js

@@ -4,6 +4,19 @@
  * and 7. It is an implementation of that document, not a restatement of it — see the design
  * doc for rationale, transition semantics, and the open questions left for other lanes.
  */
+/** Current `adaptorch_route_topology` values, synchronized with AdaptOrch's `Topology` enum. */
+export const TOPOLOGY_CLASSIFICATIONS = [
+    "parallel",
+    "sequential",
+    "hierarchical",
+    "hybrid",
+    "multi_model_ensemble",
+    "multi_turn_debate",
+];
+const TOPOLOGY_CLASSIFICATION_SET = new Set(TOPOLOGY_CLASSIFICATIONS);
+export function isTopologyClassification(value) {
+    return typeof value === "string" && TOPOLOGY_CLASSIFICATION_SET.has(value);
+}
 /**
  * Part 1 §7 — on-disk file layout constants, rooted at a loop-instance directory. Exported so
  * other modules never hardcode these path segments.

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoKH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC","sourcesContent":["/**\n * Design-fidelity note: this file implements the Work Packet on-disk schema and supporting\n * type vocabulary defined in Part 1 (`final-part1-core-algorithm.md`), Sections 1, 2, 3, 4,\n * and 7. It is an implementation of that document, not a restatement of it — see the design\n * doc for rationale, transition semantics, and the open questions left for other lanes.\n */\n\n/**\n * Work Packet lifecycle states.\n *\n * Part 1 §2 — the fourteen states of the packet-level state machine, including the\n * ESCALATED / AWAITING_APPROVAL / ADJUDICATION_FAILED additions from this revision.\n */\nexport type WorkPacketState =\n\t| \"DRAFTED\"\n\t| \"ROUTED\"\n\t| \"AWAITING_APPROVAL\"\n\t| \"DISPATCHED\"\n\t| \"ACTIVE\"\n\t| \"HALTING\"\n\t| \"RAW_TERMINAL\"\n\t| \"UNDER_REVIEW\"\n\t| \"ADJUDICATION_FAILED\"\n\t| \"CONFIRMED\"\n\t| \"DECLINED\"\n\t| \"RETRY_QUEUED\"\n\t| \"ESCALATED\"\n\t| \"CLOSED\";\n\n/**\n * Part 1 §3.3 — whether a Dispatch Record's run_id set was produced by a single\n * `adaptorch_run` call (`single_call`) or by N calls the loop itself issued (`fanout_n`).\n * This tag is what lets the rest of the state machine stay agnostic to the Section 3.2\n * single-call-vs-client-side-fanout ambiguity.\n */\nexport type CardinalityMode = \"single_call\" | \"fanout_n\";\n\n/**\n * Part 1 §3.1 — the four topology classes `adaptorch_route_topology` can return for a\n * packet's payload, decided once per packet before any `adaptorch_run` call.\n */\nexport type TopologyClassification = \"singleton\" | \"pipeline\" | \"dag\" | \"ensemble\";\n\n/**\n * Part 1 §3.3 / §7 — one concrete submission attempt for a Work Packet. A Dispatch Record\n * holds a run_id *set* (not a single run_id) tagged with its cardinality mode, so polling,\n * cancellation, and review packaging work the same way regardless of which Section 3.2\n * reading turns out to be correct.\n */\nexport interface DispatchRecord {\n\tattempt_n: number;\n\tcardinality_mode: CardinalityMode;\n\trun_ids: string[];\n\tsubmitted_at: string;\n\tmode: \"blocking\" | \"polling\";\n\tterminal_status?: string;\n\tterminal_at?: string;\n}\n\n/**\n * Part 1 §7 — one append-only entry in a Work Packet's transition log. Recorded for every\n * state change, including adjudication-call failures that have no `AdjudicationResult` to\n * archive elsewhere.\n */\nexport interface TransitionLogEntry {\n\tfrom: WorkPacketState;\n\tto: WorkPacketState;\n\tat: string;\n\tcause: string;\n}\n\n/**\n * Part 1 §1 / §7 — the Work Packet: the durable unit of intent this loop manages, potentially\n * resubmitted across several Dispatch Records over its life.\n *\n * The design doc (§7) also describes `adjudication_retry_count` (a separate bounded counter\n * for retrying the `adjudicate()` call itself, Part 1 §2/§6) and\n * `last_human_approved_topology_class` as persisted fields. Those are not modeled on this\n * type in this cut; a later change can add them without breaking the fields defined here.\n */\nexport interface WorkPacket {\n\tpacket_id: string;\n\tkind: string;\n\tcreated_at: string;\n\tpayload: unknown;\n\ttopology_decision: {\n\t\tclassification: TopologyClassification;\n\t\tdecided_at: string;\n\t\traw_route_response: unknown;\n\t} | null;\n\tdispatch_records: DispatchRecord[];\n\tstate: WorkPacketState;\n\tretry_count: number;\n\ttransition_log: TransitionLogEntry[];\n\tlast_adjudication_ref: string | null;\n\t/** Part 1 §4 — the per-packet attempt budget (`max_dispatch_attempts`) and how much of it has been used. */\n\tattempt_budget: {\n\t\tmax_dispatch_attempts: number;\n\t\tdispatch_attempts_used: number;\n\t};\n\t/**\n\t * Part 1 §2 state 3 / §7 — the payload most recently approved by a human reviewer (or the\n\t * original payload at creation, implicitly approved). `null` only if the packet has not yet\n\t * been assigned an initial baseline. Used by `requiresHumanApproval` to decide whether the\n\t * next attempt needs an AWAITING_APPROVAL gate before its first dispatch.\n\t */\n\tlast_human_approved_payload: unknown | null;\n}\n\n/**\n * Part 1 §4 — the named reasons the loop stops admitting new DRAFTED packets and begins\n * draining. `capacity_ceiling` and the cardinality-mismatch guard are soft governors (they\n * reduce admission/concurrency rather than terminating the loop outright); the others are\n * hard termination conditions.\n */\nexport type LoopTerminationCondition =\n\t| \"completion_exhaustion\"\n\t| \"per_packet_attempt_budget\"\n\t| \"wall_clock_budget\"\n\t| \"dispatch_call_budget\"\n\t| \"stagnation_guard\"\n\t| \"capacity_ceiling\"\n\t| \"external_abort\";\n\n/**\n * Part 1 §4 — loop-instance configuration. Per the \"Budget immutability\" rule in §4, every\n * field here is fixed at loop-instance creation and must not be mutated for that instance's\n * lifetime; raising a threshold requires starting a new loop instance.\n */\nexport interface LoopConfig {\n\tloop_instance_id: string;\n\t/** Part 1 §4 \"Per-packet attempt budget\" — illustrative default in the design doc is 3. */\n\tmax_dispatch_attempts_per_packet: number;\n\t/** Part 1 §4 \"Loop wall-clock budget\", expressed in milliseconds. */\n\tmax_loop_duration_ms: number;\n\t/** Part 1 §4 \"Loop dispatch-call budget\" — total `adaptorch_run` invocations allowed across the loop's life. */\n\tmax_total_dispatch_calls: number;\n\t/**\n\t * Part 1 §4 \"Stagnation guard\" — the number of consecutive loop-wide DECLINED verdicts\n\t * with indistinguishable evidence (same reason text / same evidence digest) that triggers\n\t * a halt.\n\t */\n\tstagnation_repeat_threshold: number;\n\t/**\n\t * Part 1 §4 \"Capacity ceiling (soft governor)\". Shape chosen for this implementation, not\n\t * dictated verbatim by the design doc: a saturation fraction/duration pair that must be\n\t * sustained before the governor engages, and the reduced concurrency ceiling it engages to.\n\t */\n\tcapacity_governor_thresholds: {\n\t\t/** Fraction (0-1) of `adaptorch_server_metrics` saturation considered \"sustained saturation\". */\n\t\tsaturation_threshold: number;\n\t\t/** How long saturation must persist, in milliseconds, before the governor engages. */\n\t\tsustained_duration_ms: number;\n\t\t/** Concurrency budget (max packets allowed into ACTIVE at once) while the governor is engaged. */\n\t\treduced_concurrency_ceiling: number;\n\t};\n\t/**\n\t * Part 1 §2 state 3 — the documented opt-in escape hatch that skips AWAITING_APPROVAL\n\t * for every attempt in this loop instance, regardless of payload/topology drift.\n\t */\n\tpre_approved_batch: boolean;\n\t/**\n\t * Part 1 §3.4 — the result of the one-time cardinality calibration probe, or `null` before\n\t * that probe has run. Continuously cross-checked (at zero extra call cost) against later\n\t * `adaptorch_get_run`/reconciliation-sweep observations per §3.4.\n\t */\n\tobserved_cardinality_mode: CardinalityMode | null;\n}\n\n/**\n * Part 1 §7 — on-disk file layout constants, rooted at a loop-instance directory. Exported so\n * other modules never hardcode these path segments.\n */\nexport const PACKETS_DIR = \"packets\";\nexport const PACKET_INDEX_FILE = \"packet_index.json\";\nexport const RUN_MAP_FILE = \"run_map.json\";\nexport const LOOP_STATE_FILE = \"loop_state.json\";\nexport const ADJUDICATIONS_DIR = \"adjudications\";\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH,gGAAgG;AAChG,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACvC,UAAU;IACV,YAAY;IACZ,cAAc;IACd,QAAQ;IACR,sBAAsB;IACtB,mBAAmB;CACV,CAAC;AAIX,MAAM,2BAA2B,GAAwB,IAAI,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAE3F,MAAM,UAAU,wBAAwB,CAAC,KAAc,EAAmC;IACzF,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,2BAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAAA,CAC3E;AAgID;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC","sourcesContent":["/**\n * Design-fidelity note: this file implements the Work Packet on-disk schema and supporting\n * type vocabulary defined in Part 1 (`final-part1-core-algorithm.md`), Sections 1, 2, 3, 4,\n * and 7. It is an implementation of that document, not a restatement of it — see the design\n * doc for rationale, transition semantics, and the open questions left for other lanes.\n */\n\n/**\n * Work Packet lifecycle states.\n *\n * Part 1 §2 — the fourteen states of the packet-level state machine, including the\n * ESCALATED / AWAITING_APPROVAL / ADJUDICATION_FAILED additions from this revision.\n */\nexport type WorkPacketState =\n\t| \"DRAFTED\"\n\t| \"ROUTED\"\n\t| \"AWAITING_APPROVAL\"\n\t| \"DISPATCHED\"\n\t| \"ACTIVE\"\n\t| \"HALTING\"\n\t| \"RAW_TERMINAL\"\n\t| \"UNDER_REVIEW\"\n\t| \"ADJUDICATION_FAILED\"\n\t| \"CONFIRMED\"\n\t| \"DECLINED\"\n\t| \"RETRY_QUEUED\"\n\t| \"ESCALATED\"\n\t| \"CLOSED\";\n\n/**\n * Part 1 §3.3 — whether a Dispatch Record's run_id set was produced by a single\n * `adaptorch_run` call (`single_call`) or by N calls the loop itself issued (`fanout_n`).\n * This tag is what lets the rest of the state machine stay agnostic to the Section 3.2\n * single-call-vs-client-side-fanout ambiguity.\n */\nexport type CardinalityMode = \"single_call\" | \"fanout_n\";\n\n/** Current `adaptorch_route_topology` values, synchronized with AdaptOrch's `Topology` enum. */\nexport const TOPOLOGY_CLASSIFICATIONS = [\n\t\"parallel\",\n\t\"sequential\",\n\t\"hierarchical\",\n\t\"hybrid\",\n\t\"multi_model_ensemble\",\n\t\"multi_turn_debate\",\n] as const;\n\nexport type TopologyClassification = (typeof TOPOLOGY_CLASSIFICATIONS)[number];\n\nconst TOPOLOGY_CLASSIFICATION_SET: ReadonlySet<string> = new Set(TOPOLOGY_CLASSIFICATIONS);\n\nexport function isTopologyClassification(value: unknown): value is TopologyClassification {\n\treturn typeof value === \"string\" && TOPOLOGY_CLASSIFICATION_SET.has(value);\n}\n\n/**\n * Part 1 §3.3 / §7 — one concrete submission attempt for a Work Packet. A Dispatch Record\n * holds a run_id *set* (not a single run_id) tagged with its cardinality mode, so polling,\n * cancellation, and review packaging work the same way regardless of which Section 3.2\n * reading turns out to be correct.\n */\nexport interface DispatchRecord {\n\tattempt_n: number;\n\tcardinality_mode: CardinalityMode;\n\trun_ids: string[];\n\tsubmitted_at: string;\n\tmode: \"blocking\" | \"polling\";\n\tterminal_status?: string;\n\tterminal_at?: string;\n}\n\n/**\n * Part 1 §7 — one append-only entry in a Work Packet's transition log. Recorded for every\n * state change, including adjudication-call failures that have no `AdjudicationResult` to\n * archive elsewhere.\n */\nexport interface TransitionLogEntry {\n\tfrom: WorkPacketState;\n\tto: WorkPacketState;\n\tat: string;\n\tcause: string;\n}\n\n/**\n * Part 1 §1 / §7 — the Work Packet: the durable unit of intent this loop manages, potentially\n * resubmitted across several Dispatch Records over its life.\n *\n * The design doc (§7) also describes `adjudication_retry_count` (a separate bounded counter\n * for retrying the `adjudicate()` call itself, Part 1 §2/§6) and\n * `last_human_approved_topology_class` as persisted fields. Those are not modeled on this\n * type in this cut; a later change can add them without breaking the fields defined here.\n */\nexport interface WorkPacket {\n\tpacket_id: string;\n\tkind: string;\n\tcreated_at: string;\n\tpayload: unknown;\n\ttopology_decision: {\n\t\tclassification: TopologyClassification;\n\t\tdecided_at: string;\n\t\traw_route_response: unknown;\n\t} | null;\n\tdispatch_records: DispatchRecord[];\n\tstate: WorkPacketState;\n\tretry_count: number;\n\ttransition_log: TransitionLogEntry[];\n\tlast_adjudication_ref: string | null;\n\t/** Part 1 §4 — the per-packet attempt budget (`max_dispatch_attempts`) and how much of it has been used. */\n\tattempt_budget: {\n\t\tmax_dispatch_attempts: number;\n\t\tdispatch_attempts_used: number;\n\t};\n\t/**\n\t * Part 1 §2 state 3 / §7 — the payload most recently approved by a human reviewer (or the\n\t * original payload at creation, implicitly approved). `null` only if the packet has not yet\n\t * been assigned an initial baseline. Used by `requiresHumanApproval` to decide whether the\n\t * next attempt needs an AWAITING_APPROVAL gate before its first dispatch.\n\t */\n\tlast_human_approved_payload: unknown | null;\n}\n\n/**\n * Part 1 §4 — the named reasons the loop stops admitting new DRAFTED packets and begins\n * draining. `capacity_ceiling` and the cardinality-mismatch guard are soft governors (they\n * reduce admission/concurrency rather than terminating the loop outright); the others are\n * hard termination conditions.\n */\nexport type LoopTerminationCondition =\n\t| \"completion_exhaustion\"\n\t| \"per_packet_attempt_budget\"\n\t| \"wall_clock_budget\"\n\t| \"dispatch_call_budget\"\n\t| \"stagnation_guard\"\n\t| \"capacity_ceiling\"\n\t| \"external_abort\";\n\n/**\n * Part 1 §4 — loop-instance configuration. Per the \"Budget immutability\" rule in §4, every\n * field here is fixed at loop-instance creation and must not be mutated for that instance's\n * lifetime; raising a threshold requires starting a new loop instance.\n */\nexport interface LoopConfig {\n\tloop_instance_id: string;\n\t/** Part 1 §4 \"Per-packet attempt budget\" — illustrative default in the design doc is 3. */\n\tmax_dispatch_attempts_per_packet: number;\n\t/** Part 1 §4 \"Loop wall-clock budget\", expressed in milliseconds. */\n\tmax_loop_duration_ms: number;\n\t/** Part 1 §4 \"Loop dispatch-call budget\" — total `adaptorch_run` invocations allowed across the loop's life. */\n\tmax_total_dispatch_calls: number;\n\t/**\n\t * Part 1 §4 \"Stagnation guard\" — the number of consecutive loop-wide DECLINED verdicts\n\t * with indistinguishable evidence (same reason text / same evidence digest) that triggers\n\t * a halt.\n\t */\n\tstagnation_repeat_threshold: number;\n\t/**\n\t * Part 1 §4 \"Capacity ceiling (soft governor)\". Shape chosen for this implementation, not\n\t * dictated verbatim by the design doc: a saturation fraction/duration pair that must be\n\t * sustained before the governor engages, and the reduced concurrency ceiling it engages to.\n\t */\n\tcapacity_governor_thresholds: {\n\t\t/** Fraction (0-1) of `adaptorch_server_metrics` saturation considered \"sustained saturation\". */\n\t\tsaturation_threshold: number;\n\t\t/** How long saturation must persist, in milliseconds, before the governor engages. */\n\t\tsustained_duration_ms: number;\n\t\t/** Concurrency budget (max packets allowed into ACTIVE at once) while the governor is engaged. */\n\t\treduced_concurrency_ceiling: number;\n\t};\n\t/**\n\t * Part 1 §2 state 3 — the documented opt-in escape hatch that skips AWAITING_APPROVAL\n\t * for every attempt in this loop instance, regardless of payload/topology drift.\n\t */\n\tpre_approved_batch: boolean;\n\t/**\n\t * Part 1 §3.4 — the result of the one-time cardinality calibration probe, or `null` before\n\t * that probe has run. Continuously cross-checked (at zero extra call cost) against later\n\t * `adaptorch_get_run`/reconciliation-sweep observations per §3.4.\n\t */\n\tobserved_cardinality_mode: CardinalityMode | null;\n}\n\n/**\n * Part 1 §7 — on-disk file layout constants, rooted at a loop-instance directory. Exported so\n * other modules never hardcode these path segments.\n */\nexport const PACKETS_DIR = \"packets\";\nexport const PACKET_INDEX_FILE = \"packet_index.json\";\nexport const RUN_MAP_FILE = \"run_map.json\";\nexport const LOOP_STATE_FILE = \"loop_state.json\";\nexport const ADJUDICATIONS_DIR = \"adjudications\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "omk-adaptorch-wpl",
-	"version": "0.96.2",
+	"version": "0.98.0",
 	"description": "AdaptOrch-native Work Packet Loop (WPL) — state machine, verification layer, and integration bridge for OMK orchestration.",
 	"type": "module",
 	"main": "./dist/index.js",