orbit-agent-runtime 0.8.0

package/dist/test/openai_compat_channel.test.js

@@ -0,0 +1,325 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const strict_1 = __importDefault(require("node:assert/strict"));
+const core_hub_1 = require("@orbit/core-hub");
+/** Minimal fake fetch returning a canned chat completion. */
+function fakeFetchOk(content, calls) {
+    return (async (url, init) => {
+        calls.push({ url: String(url), init: init });
+        return {
+            ok: true,
+            status: 200,
+            statusText: "OK",
+            json: async () => ({ choices: [{ message: { role: "assistant", content } }] })
+        };
+    });
+}
+/** Fake fetch that fails N times with the given status, then succeeds. */
+function fakeFetchRetrySequence(failures, finalContent, calls) {
+    let attempt = 0;
+    return (async (url, init) => {
+        calls.push({ url: String(url), init: init });
+        const failure = failures[attempt];
+        attempt += 1;
+        if (failure) {
+            const headers = new Map();
+            if (failure.retryAfter !== undefined)
+                headers.set("retry-after", failure.retryAfter);
+            return {
+                ok: false,
+                status: failure.status,
+                statusText: "ERR",
+                headers: { get: (name) => headers.get(name.toLowerCase()) ?? null },
+                json: async () => ({ error: { message: `attempt ${attempt} failed` } })
+            };
+        }
+        return {
+            ok: true,
+            status: 200,
+            statusText: "OK",
+            json: async () => ({ choices: [{ message: { role: "assistant", content: finalContent } }] })
+        };
+    });
+}
+function fakeFetchError(status, message) {
+    return (async () => ({
+        ok: false,
+        status,
+        statusText: "ERR",
+        json: async () => ({ error: { message } })
+    }));
+}
+// ------------------------------------------------------------- construction
+(0, node_test_1.test)("DeepSeekChannel: requires an api key field (empty allowed for unauthenticated endpoints)", () => {
+    strict_1.default.throws(() => new core_hub_1.DeepSeekChannel({ apiKey: undefined }), /apiKey/);
+});
+// ------------------------------------------------------------- happy path
+(0, node_test_1.test)("DeepSeekChannel: chatRound posts OpenAI-compatible payload and returns content", async () => {
+    const calls = [];
+    const channel = new core_hub_1.DeepSeekChannel({
+        apiKey: "sk-test",
+        model: "deepseek-chat",
+        fetchImpl: fakeFetchOk("reproducibility is trust", calls)
+    });
+    const out = await channel.chatRound("why?");
+    strict_1.default.equal(out, "reproducibility is trust");
+    strict_1.default.equal(calls.length, 1);
+    strict_1.default.equal(calls[0].url, "https://api.deepseek.com/chat/completions");
+    const headers = calls[0].init.headers;
+    strict_1.default.equal(headers.Authorization, "Bearer sk-test");
+    const body = JSON.parse(String(calls[0].init.body));
+    strict_1.default.equal(body.model, "deepseek-chat");
+    strict_1.default.equal(body.messages[0].role, "user");
+    strict_1.default.equal(body.stream, false);
+});
+(0, node_test_1.test)("OpenAICompatChannel: works against any compatible endpoint", async () => {
+    const calls = [];
+    const channel = new core_hub_1.OpenAICompatChannel({
+        apiKey: "sk-ollama",
+        baseUrl: "http://localhost:11434/v1",
+        model: "llama3",
+        fetchImpl: fakeFetchOk("local answer", calls)
+    });
+    const out = await channel.chatRound("hi");
+    strict_1.default.equal(out, "local answer");
+    strict_1.default.equal(calls[0].url, "http://localhost:11434/v1/chat/completions");
+    const body = JSON.parse(String(calls[0].init.body));
+    strict_1.default.equal(body.model, "llama3");
+});
+(0, node_test_1.test)("OpenAICompatChannel: requires an api key field (empty allowed for unauthenticated endpoints)", () => {
+    strict_1.default.throws(() => new core_hub_1.OpenAICompatChannel({ apiKey: undefined, baseUrl: "https://x" }), /apiKey/);
+    // empty key is legal: local endpoints like Ollama need no auth
+    const channel = new core_hub_1.OpenAICompatChannel({ apiKey: "", baseUrl: "http://localhost:11434/v1" });
+    strict_1.default.ok(channel);
+});
+(0, node_test_1.test)("OpenAICompatChannel: omits Authorization header when key is empty", async () => {
+    const calls = [];
+    const channel = new core_hub_1.OpenAICompatChannel({
+        apiKey: "",
+        baseUrl: "http://localhost:11434/v1",
+        fetchImpl: fakeFetchOk("local", calls)
+    });
+    await channel.chatRound("hi");
+    const headers = calls[0].init.headers;
+    strict_1.default.equal(headers.Authorization, undefined);
+});
+// ----------------------------------------------------- per-call options
+(0, node_test_1.test)("chatRound: opts.messages replaces the single user prompt", async () => {
+    const calls = [];
+    const channel = new core_hub_1.OpenAICompatChannel({
+        apiKey: "sk-test",
+        baseUrl: "https://x",
+        fetchImpl: fakeFetchOk("ok", calls)
+    });
+    await channel.chatRound("ignored-when-messages-present", {
+        messages: [
+            { role: "system", content: "be terse" },
+            { role: "user", content: "hello" }
+        ]
+    });
+    const body = JSON.parse(String(calls[0].init.body));
+    strict_1.default.deepEqual(body.messages.map((m) => m.role), ["system", "user"]);
+});
+(0, node_test_1.test)("chatRound: per-call seed/temperature/maxTokens/response_format override config", async () => {
+    const calls = [];
+    const channel = new core_hub_1.OpenAICompatChannel({
+        apiKey: "sk-test",
+        baseUrl: "https://x",
+        temperature: 0.9,
+        fetchImpl: fakeFetchOk("ok", calls)
+    });
+    await channel.chatRound("hi", { temperature: 0, seed: 42, maxTokens: 128, responseFormat: "json" });
+    const body = JSON.parse(String(calls[0].init.body));
+    strict_1.default.equal(body.temperature, 0);
+    strict_1.default.equal(body.seed, 42);
+    strict_1.default.equal(body.max_tokens, 128);
+    strict_1.default.deepEqual(body.response_format, { type: "json" });
+});
+// ------------------------------------------------------ fault taxonomy
+(0, node_test_1.test)("fault taxonomy: retryable vs non-retryable kinds", () => {
+    for (const kind of ["timeout", "network", "rate_limited", "server_error"]) {
+        strict_1.default.equal((0, core_hub_1.isRetryableLlmFault)(kind), true, kind);
+    }
+    for (const kind of ["auth", "bad_request", "not_found", "no_content", "invalid_response"]) {
+        strict_1.default.equal((0, core_hub_1.isRetryableLlmFault)(kind), false, kind);
+    }
+});
+(0, node_test_1.test)("chatRound: HTTP 401 classifies as non-retryable auth fault", async () => {
+    const channel = new core_hub_1.DeepSeekChannel({ apiKey: "sk-bad", fetchImpl: fakeFetchError(401, "invalid key") });
+    await strict_1.default.rejects(channel.chatRound("hi"), (err) => {
+        strict_1.default.ok(err instanceof core_hub_1.LlmChannelFaultError);
+        strict_1.default.equal(err.faultKind, "auth");
+        strict_1.default.equal(err.httpStatus, 401);
+        strict_1.default.equal(err.retryable, false);
+        strict_1.default.match(err.message, /LLM API error 401 \(auth\): invalid key/);
+        return true;
+    });
+});
+(0, node_test_1.test)("chatRound: non-JSON error bodies classify by status", async () => {
+    const channel = new core_hub_1.DeepSeekChannel({
+        apiKey: "sk-test",
+        fetchImpl: (async () => ({
+            ok: false,
+            status: 502,
+            statusText: "Bad Gateway",
+            json: async () => {
+                throw new SyntaxError("Unexpected token '<'");
+            }
+        }))
+    });
+    await strict_1.default.rejects(channel.chatRound("hi"), (err) => {
+        strict_1.default.ok(err instanceof core_hub_1.LlmChannelFaultError);
+        strict_1.default.equal(err.faultKind, "server_error");
+        strict_1.default.match(err.message, /502/);
+        return true;
+    });
+});
+(0, node_test_1.test)("chatRound: network failures classify as retryable network fault", async () => {
+    const channel = new core_hub_1.DeepSeekChannel({
+        apiKey: "sk-test",
+        maxRetries: 1,
+        initialRetryDelayMs: 1,
+        fetchImpl: (async () => {
+            throw new TypeError("fetch failed");
+        })
+    });
+    await strict_1.default.rejects(channel.chatRound("hi"), (err) => {
+        strict_1.default.ok(err instanceof core_hub_1.LlmChannelFaultError);
+        strict_1.default.equal(err.faultKind, "network");
+        strict_1.default.equal(err.attempts, 2); // 1 initial + 1 retry
+        return true;
+    });
+});
+(0, node_test_1.test)("chatRound: rejects empty completions as no_content", async () => {
+    const channel = new core_hub_1.DeepSeekChannel({
+        apiKey: "sk-test",
+        fetchImpl: (async () => ({ ok: true, status: 200, statusText: "OK", json: async () => ({ choices: [] }) }))
+    });
+    await strict_1.default.rejects(channel.chatRound("hi"), (err) => {
+        strict_1.default.ok(err instanceof core_hub_1.LlmChannelFaultError);
+        strict_1.default.equal(err.faultKind, "no_content");
+        return true;
+    });
+});
+(0, node_test_1.test)("chatRound: HTTP 200 with error payload classifies as invalid_response", async () => {
+    const channel = new core_hub_1.DeepSeekChannel({
+        apiKey: "sk-test",
+        fetchImpl: (async () => ({
+            ok: true,
+            status: 200,
+            statusText: "OK",
+            json: async () => ({ error: { message: "gateway says no" } })
+        }))
+    });
+    await strict_1.default.rejects(channel.chatRound("hi"), (err) => {
+        strict_1.default.ok(err instanceof core_hub_1.LlmChannelFaultError);
+        strict_1.default.equal(err.faultKind, "invalid_response");
+        return true;
+    });
+});
+(0, node_test_1.test)("chatRound: timeout surfaces a classified timeout fault", async () => {
+    const timeoutError = new Error("The operation was aborted due to timeout");
+    timeoutError.name = "TimeoutError";
+    const channel = new core_hub_1.OpenAICompatChannel({
+        apiKey: "sk-test",
+        baseUrl: "https://x",
+        fetchImpl: (async () => {
+            throw timeoutError;
+        })
+    });
+    await strict_1.default.rejects(channel.chatRound("hi"), (err) => {
+        strict_1.default.ok(err instanceof core_hub_1.LlmChannelFaultError);
+        strict_1.default.equal(err.faultKind, "timeout");
+        strict_1.default.equal(err.retryable, true);
+        return true;
+    });
+});
+// ---------------------------------------------------------- retry policy
+(0, node_test_1.test)("retry: 429 twice then 200 succeeds on the third attempt", async () => {
+    const calls = [];
+    const channel = new core_hub_1.DeepSeekChannel({
+        apiKey: "sk-test",
+        maxRetries: 2,
+        initialRetryDelayMs: 1,
+        fetchImpl: fakeFetchRetrySequence([{ status: 429 }, { status: 429 }], "third time lucky", calls)
+    });
+    const out = await channel.chatRound("hi");
+    strict_1.default.equal(out, "third time lucky");
+    strict_1.default.equal(calls.length, 3);
+});
+(0, node_test_1.test)("retry: non-retryable auth fault never retries (single fetch call)", async () => {
+    const calls = [];
+    const channel = new core_hub_1.DeepSeekChannel({
+        apiKey: "sk-bad",
+        maxRetries: 3,
+        initialRetryDelayMs: 1,
+        fetchImpl: fakeFetchRetrySequence([{ status: 401 }], "never", calls)
+    });
+    await strict_1.default.rejects(channel.chatRound("hi"), (err) => {
+        strict_1.default.ok(err instanceof core_hub_1.LlmChannelFaultError);
+        strict_1.default.equal(err.faultKind, "auth");
+        return true;
+    });
+    strict_1.default.equal(calls.length, 1);
+});
+(0, node_test_1.test)("retry: exhausted retries report the attempt count", async () => {
+    const calls = [];
+    const channel = new core_hub_1.DeepSeekChannel({
+        apiKey: "sk-test",
+        maxRetries: 1,
+        initialRetryDelayMs: 1,
+        fetchImpl: fakeFetchRetrySequence([{ status: 500 }, { status: 500 }], "never", calls)
+    });
+    await strict_1.default.rejects(channel.chatRound("hi"), (err) => {
+        strict_1.default.ok(err instanceof core_hub_1.LlmChannelFaultError);
+        strict_1.default.equal(err.faultKind, "server_error");
+        strict_1.default.equal(err.attempts, 2);
+        return true;
+    });
+    strict_1.default.equal(calls.length, 2);
+});
+(0, node_test_1.test)("retry: Retry-After header is parsed onto the fault", async () => {
+    const calls = [];
+    const channel = new core_hub_1.DeepSeekChannel({
+        apiKey: "sk-test",
+        maxRetries: 0,
+        initialRetryDelayMs: 1,
+        fetchImpl: fakeFetchRetrySequence([{ status: 429, retryAfter: "3" }], "never", calls)
+    });
+    await strict_1.default.rejects(channel.chatRound("hi"), (err) => {
+        strict_1.default.ok(err instanceof core_hub_1.LlmChannelFaultError);
+        strict_1.default.equal(err.retryAfterSeconds, 3);
+        return true;
+    });
+});
+(0, node_test_1.test)("retry: backoff is deterministic — no Math.random anywhere in the retry path", async () => {
+    const calls = [];
+    const channel = new core_hub_1.DeepSeekChannel({
+        apiKey: "sk-test",
+        maxRetries: 2,
+        initialRetryDelayMs: 1,
+        fetchImpl: fakeFetchRetrySequence([{ status: 429 }, { status: 500 }], "recovered", calls)
+    });
+    const originalRandom = Math.random;
+    Math.random = () => {
+        throw new Error("bare Math.random detected inside a channel (charter violation)");
+    };
+    try {
+        const out = await channel.chatRound("hi");
+        strict_1.default.equal(out, "recovered");
+    }
+    finally {
+        Math.random = originalRandom;
+    }
+    strict_1.default.equal(calls.length, 3);
+});
+// ------------------------------------------------------ replay contract
+(0, node_test_1.test)("DeepSeekChannel: replay contract is stochastic + inject", () => {
+    const channel = new core_hub_1.DeepSeekChannel({ apiKey: "sk-test", fetchImpl: fakeFetchOk("x", []) });
+    strict_1.default.deepEqual(channel.determinismMeta, { determinism: "stochastic", seedable: true, replayPolicy: "inject" });
+});
+//# sourceMappingURL=openai_compat_channel.test.js.map

package/dist/test/openai_compat_channel.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai_compat_channel.test.js","sourceRoot":"","sources":["../../test/openai_compat_channel.test.ts"],"names":[],"mappings":"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"}

package/dist/test/openapi_adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openapi_adapter.test.d.ts.map

package/dist/test/openapi_adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi_adapter.test.d.ts","sourceRoot":"","sources":["../../test/openapi_adapter.test.ts"],"names":[],"mappings":""}

package/dist/test/openapi_adapter.test.js

@@ -0,0 +1,270 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const strict_1 = __importDefault(require("node:assert/strict"));
+const index_1 = require("../src/index");
+/**
+ * W17 — OpenAPI adapter suite.
+ *
+ * Three layers under test, kept separate like the MCP suite:
+ *
+ * 1. **spec** — pure parsing and request-building, so untrusted-document
+ *    handling and URL determinism are verifiable without any I/O;
+ * 2. **transport** — the real `fetch` path with a stubbed client, so status
+ *    handling and deadlines are exercised without a live server;
+ * 3. **adapter + host** — that a parsed foreign surface is registered, governed,
+ *    recorded and replayed exactly like a native one, and that the transport is
+ *    released on teardown.
+ */
+const CTX = { traceMarkId: "tm-openapi", maxWaitMs: 1000 };
+// ---------------------------------------------------------------------------
+// Spec — parsing
+// ---------------------------------------------------------------------------
+const SAMPLE_DOC = {
+    openapi: "3.0.1",
+    info: { title: "Pet Store", version: "1.4.2" },
+    servers: [{ url: "https://api.example.com/v1" }],
+    paths: {
+        "/users/{id}": {
+            get: {
+                operationId: "getUser",
+                summary: "Fetch a user",
+                parameters: [{ name: "id", in: "path", required: true }]
+            }
+        },
+        "/users": {
+            get: {
+                operationId: "listUsers",
+                parameters: [
+                    { name: "limit", in: "query" },
+                    { name: "offset", in: "query" }
+                ]
+            },
+            post: {
+                operationId: "createUser",
+                summary: "Create a user",
+                requestBody: {}
+            }
+        },
+        "/search": {
+            get: {
+                parameters: [{ name: "q", in: "query", required: true }]
+            }
+        }
+    }
+};
+(0, node_test_1.test)("openapi spec: parses operations with ids, paths and parameters", () => {
+    const parsed = (0, index_1.parseOpenApiDocument)(SAMPLE_DOC);
+    const ids = parsed.operations.map((o) => o.id).sort();
+    strict_1.default.deepEqual(ids, ["createUser", "getUser", "get_search", "listUsers"]);
+    const getUser = parsed.operations.find((o) => o.id === "getUser");
+    strict_1.default.equal(getUser.method, "get");
+    strict_1.default.equal(getUser.path, "/users/{id}");
+    strict_1.default.equal(getUser.parameters[0].name, "id");
+    strict_1.default.equal(getUser.parameters[0].required, true);
+    strict_1.default.equal(parsed.info.version, "1.4.2");
+});
+(0, node_test_1.test)("openapi spec: synthesizes an operation id when none is given", () => {
+    const parsed = (0, index_1.parseOpenApiDocument)({
+        openapi: "3.0.0",
+        paths: { "/weird/path/{x}": { delete: {} } }
+    });
+    strict_1.default.equal(parsed.operations.length, 1);
+    strict_1.default.equal(parsed.operations[0].id, "delete_weird_path__x");
+});
+(0, node_test_1.test)("openapi spec: rejects a document with no usable version", () => {
+    strict_1.default.throws(() => (0, index_1.parseOpenApiDocument)({ paths: {} }), /neither `openapi` nor `swagger`/);
+});
+(0, node_test_1.test)("openapi spec: rejects duplicate operation ids", () => {
+    strict_1.default.throws(() => (0, index_1.parseOpenApiDocument)({
+        openapi: "3.0.0",
+        paths: { "/a": { get: { operationId: "dup" } }, "/b": { post: { operationId: "dup" } } }
+    }), /duplicate operation id dup/);
+});
+(0, node_test_1.test)("openapi spec: rejects cookie parameters (kernel never sends ambient creds)", () => {
+    strict_1.default.throws(() => (0, index_1.parseOpenApiDocument)({
+        openapi: "3.0.0",
+        paths: { "/a": { get: { parameters: [{ name: "sid", in: "cookie" }] } } }
+    }), /cookie parameter/);
+});
+(0, node_test_1.test)("openapi spec: path-level parameters merge into each operation", () => {
+    const parsed = (0, index_1.parseOpenApiDocument)({
+        openapi: "3.0.0",
+        paths: {
+            "/items/{itemId}": {
+                parameters: [{ name: "itemId", in: "path", required: true }],
+                get: { operationId: "getItem" }
+            }
+        }
+    });
+    const op = parsed.operations.find((o) => o.id === "getItem");
+    strict_1.default.equal(op.parameters.length, 1);
+    strict_1.default.equal(op.parameters[0].name, "itemId");
+});
+// ---------------------------------------------------------------------------
+// Spec — request building
+// ---------------------------------------------------------------------------
+const GET_USER_OP = (0, index_1.parseOpenApiDocument)(SAMPLE_DOC).operations.find((o) => o.id === "getUser");
+const LIST_USERS_OP = (0, index_1.parseOpenApiDocument)(SAMPLE_DOC).operations.find((o) => o.id === "listUsers");
+const CREATE_USER_OP = (0, index_1.parseOpenApiDocument)(SAMPLE_DOC).operations.find((o) => o.id === "createUser");
+const SEARCH_OP = (0, index_1.parseOpenApiDocument)(SAMPLE_DOC).operations.find((o) => o.id === "get_/search");
+(0, node_test_1.test)("openapi spec: substitutes path params and rejects missing ones", () => {
+    const req = (0, index_1.buildHttpRequest)(GET_USER_OP, [{ id: "42" }], "https://api.example.com/v1", "getUser", "a1");
+    strict_1.default.equal(req.method, "GET");
+    strict_1.default.equal(req.url, "https://api.example.com/v1/users/42");
+    strict_1.default.throws(() => (0, index_1.buildHttpRequest)(GET_USER_OP, [{}], "https://api.example.com/v1", "getUser", "a1"), /missing required path parameter id/);
+});
+(0, node_test_1.test)("openapi spec: query params serialise in sorted order for digest stability", () => {
+    const req = (0, index_1.buildHttpRequest)(LIST_USERS_OP, [{ limit: 10, offset: 5 }], "https://x.com", "listUsers", "a1");
+    strict_1.default.match(req.url, /\?limit=10&offset=5$/);
+});
+(0, node_test_1.test)("openapi spec: remaining keys become the JSON body when a body is declared", () => {
+    const req = (0, index_1.buildHttpRequest)(CREATE_USER_OP, [{ name: "Ada", email: "a@x.com" }], "https://x.com", "createUser", "a1");
+    strict_1.default.equal(req.headers["content-type"], "application/json");
+    strict_1.default.deepEqual(JSON.parse(req.body), { name: "Ada", email: "a@x.com" });
+});
+(0, node_test_1.test)("openapi spec: leftover args without a body are a hard error (no silent drop)", () => {
+    strict_1.default.throws(() => (0, index_1.buildHttpRequest)(GET_USER_OP, [{ id: "1", surprise: true }], "https://x.com", "getUser", "a1"), /unknown argument\(s\): surprise/);
+});
+(0, node_test_1.test)("openapi spec: positional (non-object) args are rejected", () => {
+    strict_1.default.throws(() => (0, index_1.buildHttpRequest)(GET_USER_OP, ["42"], "https://x.com", "getUser", "a1"), /expects a single named-argument object/);
+});
+(0, node_test_1.test)("openapi spec: non-JSON bodies normalise to a string, JSON parses to a value", () => {
+    strict_1.default.deepEqual((0, index_1.normaliseHttpResponse)(200, '{"ok":true}'), { value: { ok: true }, degraded: false });
+    const raw = (0, index_1.normaliseHttpResponse)(200, "plain text");
+    strict_1.default.equal(raw.value, "plain text");
+    strict_1.default.equal(raw.degraded, true);
+    strict_1.default.deepEqual((0, index_1.normaliseHttpResponse)(204, ""), { value: null, degraded: false });
+});
+(0, node_test_1.test)("openapi spec: success predicate and body tail", () => {
+    strict_1.default.equal((0, index_1.isHttpSuccess)(200), true);
+    strict_1.default.equal((0, index_1.isHttpSuccess)(404), false);
+    strict_1.default.equal((0, index_1.bodyTail)("x".repeat(5000)).endsWith("… (5000 bytes total)"), true);
+});
+// ---------------------------------------------------------------------------
+// Transport — real fetch path with a stubbed client
+// ---------------------------------------------------------------------------
+function fakeFetch(status, body) {
+    return async (_url, _init) => ({
+        status,
+        text: async () => body
+    });
+}
+(0, node_test_1.test)("openapi transport: InMemoryHttpTransport round-trips a request", async () => {
+    let seen = null;
+    const t = new index_1.InMemoryHttpTransport((req) => {
+        seen = req;
+        return { status: 200, body: JSON.stringify({ echoed: req.url }) };
+    });
+    const res = await t.send({ method: "GET", url: "https://x.com/a", headers: {} }, 1000);
+    strict_1.default.equal(res.status, 200);
+    strict_1.default.deepEqual(JSON.parse(res.body), { echoed: "https://x.com/a" });
+    strict_1.default.ok(seen !== null);
+    await t.close();
+    await strict_1.default.rejects(() => t.send({ method: "GET", url: "x", headers: {} }, 1));
+});
+(0, node_test_1.test)("openapi transport: FetchHttpTransport maps status and body through the real path", async () => {
+    const t = new index_1.FetchHttpTransport({
+        baseUrl: "https://api.example.com",
+        fetchImpl: fakeFetch(201, JSON.stringify({ id: 7 }))
+    });
+    const res = await t.send({ method: "POST", url: "/users", headers: {}, body: "{}" }, 1000);
+    strict_1.default.equal(res.status, 201);
+    strict_1.default.deepEqual(JSON.parse(res.body), { id: 7 });
+    await t.close();
+});
+// ---------------------------------------------------------------------------
+// Adapter + host — registration, governance, recording, release
+// ---------------------------------------------------------------------------
+function makeAdapter(handler, opts = {}) {
+    return new index_1.OpenApiPaeAdapter({
+        adapterId: opts.id ?? "openapi-petstore",
+        document: SAMPLE_DOC,
+        transport: new index_1.InMemoryHttpTransport((req) => {
+            if (handler)
+                return handler(req);
+            return { status: 200, body: JSON.stringify({ url: req.url }) };
+        }),
+        toolNamePrefix: opts.toolNamePrefix
+    });
+}
+(0, node_test_1.test)("openapi adapter: rejects missing identity, transport or document", () => {
+    strict_1.default.throws(() => new index_1.OpenApiPaeAdapter({ adapterId: "", document: SAMPLE_DOC, transport: new index_1.InMemoryHttpTransport(() => ({ status: 200, body: "" })) }), /requires an adapterId/);
+    strict_1.default.throws(() => new index_1.OpenApiPaeAdapter({ adapterId: "x", document: SAMPLE_DOC }), /requires a transport/);
+    strict_1.default.throws(() => new index_1.OpenApiPaeAdapter({ adapterId: "x", transport: new index_1.InMemoryHttpTransport(() => ({ status: 200, body: "" })), document: null }), /requires an OpenAPI document/);
+    strict_1.default.throws(() => new index_1.OpenApiPaeAdapter({
+        adapterId: "x",
+        transport: new index_1.InMemoryHttpTransport(() => ({ status: 200, body: "" })),
+        document: { openapi: "3.0.0", paths: { "/a": { get: { operationId: "a" } } } }
+    }), /needs a baseUrl/);
+});
+(0, node_test_1.test)("openapi adapter: meta reports openapi kind, L2, semver edition, reduced default fidelity", () => {
+    const a = makeAdapter();
+    strict_1.default.equal(a.meta.kind, "openapi");
+    strict_1.default.equal(a.meta.isolation, "L2");
+    strict_1.default.equal(a.meta.sourceEdition, "1.4.2");
+    const surface = a.describe();
+    strict_1.default.equal(surface.length, 4);
+    const getUser = surface.find((s) => s.name === "getUser");
+    strict_1.default.equal(getUser.fidelity, "reduced");
+    strict_1.default.equal(getUser.determinism, index_1.DeterminismLevel.IO_BOUND);
+    strict_1.default.equal(getUser.fidelityNote, index_1.OPENAPI_DEFAULT_FIDELITY_NOTE);
+});
+(0, node_test_1.test)("openapi adapter: unknown tool is PaeToolMissingError, HTTP error is PaeRemoteError", async () => {
+    const a = makeAdapter();
+    await a.setup(CTX);
+    await strict_1.default.rejects(() => a.invoke("nope", [], CTX), (e) => e instanceof index_1.PaeToolMissingError);
+    const failing = new index_1.OpenApiPaeAdapter({
+        adapterId: "openapi-fail",
+        document: SAMPLE_DOC,
+        baseUrl: "https://x.com",
+        transport: new index_1.InMemoryHttpTransport(() => ({ status: 404, body: '{"error":"not found"}' }))
+    });
+    await failing.setup(CTX);
+    await strict_1.default.rejects(() => failing.invoke("getUser", [{ id: "1" }], CTX), (e) => {
+        if (!(e instanceof index_1.PaeRemoteError))
+            return false;
+        return /HTTP 404/.test(e.message);
+    });
+});
+(0, node_test_1.test)("openapi adapter: teardown releases the transport", async () => {
+    const transport = new index_1.InMemoryHttpTransport(() => ({ status: 200, body: "" }));
+    const a = new index_1.OpenApiPaeAdapter({
+        adapterId: "openapi-close",
+        document: SAMPLE_DOC,
+        transport
+    });
+    await a.setup(CTX);
+    strict_1.default.equal(a.isConnected, true);
+    await a.teardown();
+    strict_1.default.equal(a.isConnected, false);
+    strict_1.default.equal(transport.closed, true);
+});
+(0, node_test_1.test)("openapi adapter: two adapters need a toolNamePrefix to avoid collision", async () => {
+    const r1 = new index_1.PaeAdapterRegistry();
+    const a1 = makeAdapter();
+    await a1.setup(CTX);
+    r1.register(a1);
+    const a2 = makeAdapter(undefined, { toolNamePrefix: "v2_", id: "openapi-petstore-2" });
+    await a2.setup(CTX);
+    r1.register(a2);
+    strict_1.default.equal(r1.listAdapters().length, 2);
+});
+(0, node_test_1.test)("openapi adapter: host routes a call through the gateway like a native tool", async () => {
+    const adapter = makeAdapter();
+    const host = new index_1.OrbitRuntimeHost();
+    await host.connectPaeToolAdapter(adapter);
+    const out = await host.capabilityInvoke({
+        kind: index_1.ChannelKind.PAE_TOOL,
+        pluginId: "openapi-petstore",
+        funcName: "getUser",
+        args: [{ id: "9" }],
+        mode: "record"
+    });
+    strict_1.default.deepEqual(out, { url: "https://api.example.com/v1/users/9" });
+    await host.unregisterPaeToolAdapter("openapi-petstore");
+});
+//# sourceMappingURL=openapi_adapter.test.js.map