@workglow/test-contract 0.6.1

package/dist/worker-proxy.js

@@ -0,0 +1,389 @@
+// src/worker-proxy/browserOnlyStub.ts
+import { describe, it } from "vitest";
+function browserOnlyStubBlock(opts) {
+  describe.skipIf(opts.skip)(`Worker-proxy boundary: ${opts.name}`, () => {
+    it.skip(`${opts.name}: requires browser test runner (browserOnly: true)`, () => {});
+  });
+}
+// src/worker-proxy/runWorkerProxyBoundary.ts
+import { afterAll, beforeAll, describe as describe5 } from "vitest";
+
+// src/worker-proxy/assertions/backlogOrdering.ts
+import { describe as describe2, expect, it as it3 } from "vitest";
+
+// src/creditExhaustedSkip.ts
+import { it as vitestIt } from "vitest";
+var BILLING_CODES = new Set([
+  "insufficient_quota",
+  "billing_hard_limit_reached",
+  "insufficient_credits",
+  "insufficient_balance"
+]);
+var CREDIT_MESSAGE = /insufficient credits|not enough credits|no credits remaining|out of credits|insufficient[\s_-]balance|balance is (?:too low|insufficient)|exceeded[\s\S]{0,80}credits|monthly included credits|payment required|exceeded your current quota|check your plan and billing|billing_hard_limit/i;
+var HTTP_402_MESSAGE = /\bHTTP\/?\d?(?:\.\d)?\s*402\b|\bstatus(?:\s*code)?\s*[:=]\s*402\b|\berror code:?\s*402\b|(?:^|:\s+)402\s+[a-z]/im;
+function isCreditExhaustedError(err) {
+  const seen = new Set;
+  let current = err;
+  while (current !== undefined && current !== null && !seen.has(current)) {
+    seen.add(current);
+    if (matchesCreditExhaustion(current))
+      return true;
+    current = causeOf(current);
+  }
+  return false;
+}
+function matchesCreditExhaustion(err) {
+  if (typeof err === "string")
+    return messageLooksLikeCreditExhaustion(err);
+  if (!err || typeof err !== "object")
+    return false;
+  const rec = err;
+  const status = numericStatus(rec);
+  if (status === 402)
+    return true;
+  const code = stringish(rec.code) ?? stringish(nested(rec.error, "code"));
+  const type = stringish(rec.type) ?? stringish(nested(rec.error, "type"));
+  if (code && BILLING_CODES.has(code))
+    return true;
+  if (type && BILLING_CODES.has(type))
+    return true;
+  const message = [
+    stringish(rec.message),
+    stringish(nested(rec.error, "message")),
+    stringifyUnknown(err)
+  ].filter((part) => typeof part === "string").join(`
+`);
+  return messageLooksLikeCreditExhaustion(message);
+}
+function messageLooksLikeCreditExhaustion(message) {
+  return CREDIT_MESSAGE.test(message) || HTTP_402_MESSAGE.test(message);
+}
+function numericStatus(rec) {
+  for (const key of ["status", "statusCode"]) {
+    const value = rec[key];
+    if (typeof value === "number" && Number.isFinite(value))
+      return value;
+  }
+  const nestedStatus = nested(rec.error, "status");
+  if (typeof nestedStatus === "number" && Number.isFinite(nestedStatus))
+    return nestedStatus;
+  return;
+}
+function nested(value, key) {
+  if (!value || typeof value !== "object")
+    return;
+  return value[key];
+}
+function stringish(value) {
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function stringifyUnknown(err) {
+  if (err instanceof Error)
+    return err.message;
+  return String(err);
+}
+function causeOf(err) {
+  if (!err || typeof err !== "object")
+    return;
+  return err.cause;
+}
+function creditSkipNote(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  return `skipped: provider out of credits (${message})`;
+}
+var SKIP_OVERRIDE_ENV = "WORKGLOW_CREDIT_EXHAUSTED_SKIP";
+function isTruthyFlag(value) {
+  return !/^(?:0|false|off|no)$/i.test(value.trim());
+}
+function creditExhaustionSkipsTest(env = process.env) {
+  const override = env[SKIP_OVERRIDE_ENV];
+  if (override !== undefined && override.trim() !== "")
+    return isTruthyFlag(override);
+  for (const key of ["CI", "GITHUB_ACTIONS"]) {
+    const value = env[key];
+    if (value !== undefined && value.trim() !== "" && isTruthyFlag(value))
+      return true;
+  }
+  return false;
+}
+function reportLocalCreditFailure(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  console.error(`provider out of credits (${message})
+` + `  Failing because this is not CI. Top the account up, or set ${SKIP_OVERRIDE_ENV}=1 to skip instead.`);
+}
+async function runWithCreditSkip(ctx, fn) {
+  try {
+    return await fn();
+  } catch (err) {
+    if (isCreditExhaustedError(err)) {
+      if (!creditExhaustionSkipsTest()) {
+        reportLocalCreditFailure(err);
+        throw err;
+      }
+      ctx.skip(creditSkipNote(err));
+      return;
+    }
+    throw err;
+  }
+}
+function wrapTestBodyForCreditSkip(fn) {
+  return async function wrapped(...args) {
+    try {
+      return await fn.apply(this, args);
+    } catch (err) {
+      if (!isCreditExhaustedError(err))
+        throw err;
+      if (!creditExhaustionSkipsTest()) {
+        reportLocalCreditFailure(err);
+        throw err;
+      }
+      const ctx = args[0];
+      if (ctx && typeof ctx.skip === "function") {
+        ctx.skip(creditSkipNote(err));
+        return;
+      }
+      console.warn(creditSkipNote(err));
+      return;
+    }
+  };
+}
+function wrapCallable(fn) {
+  return new Proxy(fn, {
+    apply(target, thisArg, argArray) {
+      const wrapped = argArray.map((arg) => typeof arg === "function" ? wrapTestBodyForCreditSkip(arg) : arg);
+      const result = Reflect.apply(target, thisArg, wrapped);
+      return typeof result === "function" ? wrapCallable(result) : result;
+    },
+    get(target, prop, receiver) {
+      const value = Reflect.get(target, prop, receiver);
+      if (typeof value === "function") {
+        return wrapCallable(value.bind(target));
+      }
+      return value;
+    }
+  });
+}
+var it2 = wrapCallable(vitestIt);
+
+// src/itExpectFail.ts
+var itExpectFail = (name, fn, timeout) => {
+  const native = it2.fails;
+  if (typeof native === "function") {
+    native(name, fn, timeout);
+    return;
+  }
+  it2(`${name} [expected-fail]`, async () => {
+    let passed = false;
+    try {
+      await fn();
+      passed = true;
+    } catch (err) {
+      if (isCreditExhaustedError(err))
+        throw err;
+    }
+    if (passed) {
+      throw new Error(`Test "${name}" was marked as expected-fail but passed. Remove its name from opts.expectedFailures.`);
+    }
+  }, timeout);
+};
+
+// src/worker-proxy/assertions/providerCallHelpers.ts
+import {
+  collectStream,
+  createEmitQueue,
+  getAiProviderRegistry,
+  getGlobalModelRepository,
+  textGeneration
+} from "@workglow/ai";
+var TEXT_GENERATION = ["text.generation"];
+async function runProviderTextGeneration(modelId, prompt, callOpts) {
+  const result = await textGeneration({
+    model: modelId,
+    prompt,
+    maxTokens: callOpts.maxTokens
+  }, { timeout: callOpts.timeoutMs });
+  return { text: result.text ?? "" };
+}
+async function* streamProviderTextGeneration(modelId, prompt, callOpts) {
+  const model = await getGlobalModelRepository().findByName(modelId);
+  if (!model)
+    throw new Error(`Model not registered: ${modelId}`);
+  const registry = getAiProviderRegistry();
+  const streamFn = registry.getRunFnFor(model.provider, TEXT_GENERATION);
+  if (!streamFn) {
+    throw new Error(`No run-fn registered for ${model.provider} serving ["text.generation"]`);
+  }
+  const ac = new AbortController;
+  const onCallerAbort = () => ac.abort(callOpts.signal?.reason);
+  const t = setTimeout(() => ac.abort(new Error("timeout")), callOpts.timeoutMs);
+  if (callOpts.signal) {
+    if (callOpts.signal.aborted) {
+      clearTimeout(t);
+      ac.abort(callOpts.signal.reason);
+    } else {
+      callOpts.signal.addEventListener("abort", onCallerAbort, { once: true });
+    }
+  }
+  const q = createEmitQueue();
+  const runP = streamFn({ prompt, maxTokens: callOpts.maxTokens }, model, ac.signal, (e) => q.push(e), undefined, undefined).then(() => q.close(), (err) => q.fail(err));
+  try {
+    for await (const event of q.iterable) {
+      yield event;
+    }
+  } finally {
+    clearTimeout(t);
+    callOpts.signal?.removeEventListener("abort", onCallerAbort);
+    await runP.catch(() => {});
+  }
+}
+
+// src/worker-proxy/assertions/backlogOrdering.ts
+var FAIL_KEY = "boundary.backlogOrdering";
+async function collectStream2(modelId, prompt, timeoutMs) {
+  const events = [];
+  let finishCount = 0;
+  for await (const ev of streamProviderTextGeneration(modelId, prompt, {
+    maxTokens: 32,
+    timeoutMs
+  })) {
+    const e = ev;
+    events.push({ type: e.type });
+    if (e.type === "finish")
+      finishCount += 1;
+  }
+  return { events, finishCount };
+}
+function backlogOrderingBlock(opts) {
+  const failing = opts.expectedFailures?.includes(FAIL_KEY) ?? false;
+  const test = failing ? itExpectFail : it3;
+  describe2("PostMessage handles concurrent streams independently", () => {
+    test("three concurrent streams each deliver deltas before exactly one finish event", async () => {
+      const modelId = opts.models.textGeneration;
+      if (!modelId) {
+        throw new Error(`${opts.name}: models.textGeneration is required for boundary tests`);
+      }
+      const prompts = [
+        "Reply with the single word ALPHA.",
+        "Reply with the single word BETA.",
+        "Reply with the single word GAMMA."
+      ];
+      const runs = await Promise.all(prompts.map((p) => collectStream2(modelId, p, opts.timeout / 2)));
+      for (const run of runs) {
+        expect(run.finishCount).toBe(1);
+        expect(run.events[run.events.length - 1]?.type).toBe("finish");
+        const deltaTypes = run.events.slice(0, -1).map((e) => e.type).filter((t) => t.endsWith("-delta"));
+        expect(deltaTypes.length).toBeGreaterThan(0);
+      }
+    }, opts.timeout);
+  });
+}
+
+// src/worker-proxy/assertions/disposeTerminatesWorker.ts
+import { describe as describe3, expect as expect2, it as it4 } from "vitest";
+var FAIL_KEY2 = "boundary.disposeTerminatesWorker";
+function disposeTerminatesWorkerBlock(opts, getHandle, markDisposed) {
+  const failing = opts.expectedFailures?.includes(FAIL_KEY2) ?? false;
+  const test = failing ? itExpectFail : it4;
+  describe3("Dispose terminates worker", () => {
+    test("after dispose() the worker no longer responds to traffic", async () => {
+      const handle = getHandle();
+      const modelId = opts.models.textGeneration;
+      if (!modelId) {
+        throw new Error(`${opts.name}: models.textGeneration is required for boundary tests`);
+      }
+      const before = await runProviderTextGeneration(modelId, "Reply with the single word READY.", { maxTokens: 8, timeoutMs: opts.timeout / 4 });
+      expect2(before.text.length).toBeGreaterThan(0);
+      await handle.dispose();
+      markDisposed();
+      const after = runProviderTextGeneration(modelId, "Reply with the single word LATE.", {
+        maxTokens: 8,
+        timeoutMs: opts.timeout / 4
+      });
+      await expect2(after).rejects.toThrow(/.+/);
+    }, opts.timeout);
+  });
+}
+
+// src/worker-proxy/assertions/errorPropagation.ts
+import { describe as describe4, expect as expect3, it as it5 } from "vitest";
+var FAIL_KEY3 = "boundary.errorPropagation";
+function errorPropagationBlock(opts) {
+  const failing = opts.expectedFailures?.includes(FAIL_KEY3) ?? false;
+  const test = failing ? itExpectFail : it5;
+  describe4("Worker-side throw surfaces on main thread", () => {
+    test("provider rejection from inside the worker surfaces as a thrown error", async () => {
+      const modelId = opts.models.textGeneration;
+      if (!modelId) {
+        throw new Error(`${opts.name}: models.textGeneration is required for boundary tests`);
+      }
+      await expect3(runProviderTextGeneration(modelId, "ignored", {
+        maxTokens: 1e9,
+        timeoutMs: opts.timeout / 4
+      })).rejects.toThrow(/.+/);
+    }, opts.timeout);
+    if (opts.capabilities.errorPropagation) {
+      test("worker-thrown Error preserves name and non-empty message across postMessage", async () => {
+        const modelId = opts.models.textGeneration;
+        if (!modelId) {
+          throw new Error(`${opts.name}: models.textGeneration is required for boundary tests`);
+        }
+        let captured;
+        try {
+          await runProviderTextGeneration(modelId, "ignored", {
+            maxTokens: 1e9,
+            timeoutMs: opts.timeout / 4
+          });
+        } catch (err) {
+          captured = err;
+        }
+        expect3(captured).toBeInstanceOf(Error);
+        const e = captured;
+        expect3(e.message.length).toBeGreaterThan(0);
+        expect3(e.name.length).toBeGreaterThan(0);
+      }, opts.timeout);
+    }
+  });
+}
+
+// src/worker-proxy/runWorkerProxyBoundary.ts
+function runWorkerProxyBoundary(opts) {
+  if (opts.capabilities.browserOnly) {
+    browserOnlyStubBlock(opts);
+    return;
+  }
+  describe5.skipIf(opts.skip)(`Worker-proxy boundary: ${opts.name}`, () => {
+    let handle;
+    let disposed = false;
+    const getHandle = () => {
+      if (!handle)
+        throw new Error("worker-proxy handle not initialized");
+      return handle;
+    };
+    const markDisposed = () => {
+      disposed = true;
+    };
+    beforeAll(async () => {
+      handle = await opts.factory();
+      await handle.register();
+    }, opts.timeout);
+    afterAll(async () => {
+      if (handle && !disposed)
+        await handle.dispose();
+    });
+    errorPropagationBlock(opts);
+    backlogOrderingBlock(opts);
+    disposeTerminatesWorkerBlock(opts, getHandle, markDisposed);
+  });
+}
+export {
+  backlogOrderingBlock,
+  browserOnlyStubBlock,
+  collectStream,
+  disposeTerminatesWorkerBlock,
+  errorPropagationBlock,
+  runProviderTextGeneration,
+  runWorkerProxyBoundary,
+  streamProviderTextGeneration
+};
+
+//# debugId=292FD920B04AD20B64756E2164756E21

package/dist/worker-proxy.js.map

@@ -0,0 +1,17 @@
+{
+  "version": 3,
+  "sources": ["../src/worker-proxy/browserOnlyStub.ts", "../src/worker-proxy/runWorkerProxyBoundary.ts", "../src/worker-proxy/assertions/backlogOrdering.ts", "../src/creditExhaustedSkip.ts", "../src/itExpectFail.ts", "../src/worker-proxy/assertions/providerCallHelpers.ts", "../src/worker-proxy/assertions/disposeTerminatesWorker.ts", "../src/worker-proxy/assertions/errorPropagation.ts"],
+  "sourcesContent": [
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { describe, it } from \"vitest\";\n\nimport type { WorkerProxyBoundaryOpts } from \"./types\";\n\nexport function browserOnlyStubBlock(opts: WorkerProxyBoundaryOpts): void {\n  describe.skipIf(opts.skip)(`Worker-proxy boundary: ${opts.name}`, () => {\n    it.skip(`${opts.name}: requires browser test runner (browserOnly: true)`, () => {});\n  });\n}\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { afterAll, beforeAll, describe } from \"vitest\";\n\nimport type { ConformanceHandle } from \"../ai-provider/types\";\nimport { backlogOrderingBlock } from \"./assertions/backlogOrdering\";\nimport { disposeTerminatesWorkerBlock } from \"./assertions/disposeTerminatesWorker\";\nimport { errorPropagationBlock } from \"./assertions/errorPropagation\";\nimport { browserOnlyStubBlock } from \"./browserOnlyStub\";\nimport type { WorkerProxyBoundaryOpts } from \"./types\";\n\nexport function runWorkerProxyBoundary(opts: WorkerProxyBoundaryOpts): void {\n  if (opts.capabilities.browserOnly) {\n    browserOnlyStubBlock(opts);\n    return;\n  }\n\n  describe.skipIf(opts.skip)(`Worker-proxy boundary: ${opts.name}`, () => {\n    let handle: ConformanceHandle | undefined;\n    let disposed = false;\n    const getHandle = (): ConformanceHandle => {\n      if (!handle) throw new Error(\"worker-proxy handle not initialized\");\n      return handle;\n    };\n    const markDisposed = (): void => {\n      disposed = true;\n    };\n\n    beforeAll(async () => {\n      handle = await opts.factory();\n      await handle.register();\n    }, opts.timeout);\n\n    afterAll(async () => {\n      if (handle && !disposed) await handle.dispose();\n    });\n\n    // Order matters: dispose runs last so the live-worker assertions above\n    // execute against an undisposed handle. `markDisposed` flips the shared\n    // flag so afterAll skips a second dispose.\n    errorPropagationBlock(opts);\n    backlogOrderingBlock(opts);\n    disposeTerminatesWorkerBlock(opts, getHandle, markDisposed);\n  });\n}\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { describe, expect, it } from \"vitest\";\n\nimport { itExpectFail } from \"../../itExpectFail\";\nimport type { WorkerProxyBoundaryOpts } from \"../types\";\nimport { streamProviderTextGeneration } from \"./providerCallHelpers\";\n\nconst FAIL_KEY = \"boundary.backlogOrdering\";\n\ninterface CollectedRun {\n  readonly events: ReadonlyArray<{ readonly type: string }>;\n  readonly finishCount: number;\n}\n\nasync function collectStream(\n  modelId: string,\n  prompt: string,\n  timeoutMs: number\n): Promise<CollectedRun> {\n  const events: Array<{ readonly type: string }> = [];\n  let finishCount = 0;\n  for await (const ev of streamProviderTextGeneration(modelId, prompt, {\n    maxTokens: 32,\n    timeoutMs,\n  })) {\n    const e = ev as { type: string };\n    events.push({ type: e.type });\n    if (e.type === \"finish\") finishCount += 1;\n  }\n  return { events, finishCount };\n}\n\nexport function backlogOrderingBlock(opts: WorkerProxyBoundaryOpts): void {\n  const failing = opts.expectedFailures?.includes(FAIL_KEY) ?? false;\n  const test = failing ? itExpectFail : it;\n\n  describe(\"PostMessage handles concurrent streams independently\", () => {\n    test(\n      \"three concurrent streams each deliver deltas before exactly one finish event\",\n      async () => {\n        const modelId = opts.models.textGeneration;\n        if (!modelId) {\n          throw new Error(`${opts.name}: models.textGeneration is required for boundary tests`);\n        }\n        const prompts = [\n          \"Reply with the single word ALPHA.\",\n          \"Reply with the single word BETA.\",\n          \"Reply with the single word GAMMA.\",\n        ];\n        const runs = await Promise.all(\n          prompts.map((p) => collectStream(modelId, p, opts.timeout / 2))\n        );\n\n        for (const run of runs) {\n          expect(run.finishCount).toBe(1);\n          expect(run.events[run.events.length - 1]?.type).toBe(\"finish\");\n          const deltaTypes = run.events\n            .slice(0, -1)\n            .map((e) => e.type)\n            .filter((t) => t.endsWith(\"-delta\"));\n          expect(deltaTypes.length).toBeGreaterThan(0);\n        }\n      },\n      opts.timeout\n    );\n  });\n}\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { it as vitestIt } from \"vitest\";\n\n/**\n * Live provider tests treat \"the account is out of credits\" as a billing\n * condition rather than a product bug. A key being present is not the same as\n * the account being able to pay; HuggingFace / OpenRouter 402s, Anthropic's\n * credit-balance error, DeepSeek's `Insufficient Balance`, and OpenAI's\n * `insufficient_quota` are all billing.\n *\n * Rate limits (429 + `rate_limit_exceeded`) are NOT this: those are transient\n * and the existing retry policy handles them.\n *\n * Where it skips and where it fails is a deliberate split\n * ({@link creditExhaustionSkipsTest}): on CI it skips for every provider,\n * because a red build tells a reviewer nothing they can act on; locally it\n * fails, because the developer running the suite is the one who can top the\n * account up. `WORKGLOW_CREDIT_EXHAUSTED_SKIP=1` forces the skip locally\n * (and `=0` forces the failure on CI).\n */\n\nconst BILLING_CODES = new Set([\n  \"insufficient_quota\",\n  \"billing_hard_limit_reached\",\n  \"insufficient_credits\",\n  \"insufficient_balance\",\n]);\n\nconst CREDIT_MESSAGE =\n  /insufficient credits|not enough credits|no credits remaining|out of credits|insufficient[\\s_-]balance|balance is (?:too low|insufficient)|exceeded[\\s\\S]{0,80}credits|monthly included credits|payment required|exceeded your current quota|check your plan and billing|billing_hard_limit/i;\n\n/**\n * A 402 that survives only as text. `classifyProviderError` rebuilds the error\n * as a `PermanentJobError` carrying the message and no `cause`, so by the time\n * a live test sees a DeepSeek billing failure the numeric `status` is gone and\n * the OpenAI-SDK message shape (`402 Insufficient Balance`) is all that is\n * left. Anchored to an HTTP-shaped position — start of a line, or after a\n * summary line's colon — so prose that merely contains the number\n * (\"Item 402(c)\") is not scavenged as a status.\n */\nconst HTTP_402_MESSAGE =\n  /\\bHTTP\\/?\\d?(?:\\.\\d)?\\s*402\\b|\\bstatus(?:\\s*code)?\\s*[:=]\\s*402\\b|\\berror code:?\\s*402\\b|(?:^|:\\s+)402\\s+[a-z]/im;\n\nexport function isCreditExhaustedError(err: unknown): boolean {\n  const seen = new Set<unknown>();\n  let current: unknown = err;\n  while (current !== undefined && current !== null && !seen.has(current)) {\n    seen.add(current);\n    if (matchesCreditExhaustion(current)) return true;\n    current = causeOf(current);\n  }\n  return false;\n}\n\nfunction matchesCreditExhaustion(err: unknown): boolean {\n  if (typeof err === \"string\") return messageLooksLikeCreditExhaustion(err);\n\n  if (!err || typeof err !== \"object\") return false;\n\n  const rec = err as Record<string, unknown>;\n  const status = numericStatus(rec);\n  if (status === 402) return true;\n\n  const code = stringish(rec.code) ?? stringish(nested(rec.error, \"code\"));\n  const type = stringish(rec.type) ?? stringish(nested(rec.error, \"type\"));\n  if (code && BILLING_CODES.has(code)) return true;\n  if (type && BILLING_CODES.has(type)) return true;\n\n  const message = [\n    stringish(rec.message),\n    stringish(nested(rec.error, \"message\")),\n    stringifyUnknown(err),\n  ]\n    .filter((part): part is string => typeof part === \"string\")\n    .join(\"\\n\");\n  return messageLooksLikeCreditExhaustion(message);\n}\n\nfunction messageLooksLikeCreditExhaustion(message: string): boolean {\n  return CREDIT_MESSAGE.test(message) || HTTP_402_MESSAGE.test(message);\n}\n\nfunction numericStatus(rec: Record<string, unknown>): number | undefined {\n  for (const key of [\"status\", \"statusCode\"] as const) {\n    const value = rec[key];\n    if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  }\n  const nestedStatus = nested(rec.error, \"status\");\n  if (typeof nestedStatus === \"number\" && Number.isFinite(nestedStatus)) return nestedStatus;\n  return undefined;\n}\n\nfunction nested(value: unknown, key: string): unknown {\n  if (!value || typeof value !== \"object\") return undefined;\n  return (value as Record<string, unknown>)[key];\n}\n\nfunction stringish(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nfunction stringifyUnknown(err: unknown): string {\n  if (err instanceof Error) return err.message;\n  return String(err);\n}\n\nfunction causeOf(err: unknown): unknown {\n  if (!err || typeof err !== \"object\") return undefined;\n  return (err as { cause?: unknown }).cause;\n}\n\nexport function creditSkipNote(err: unknown): string {\n  const message = err instanceof Error ? err.message : String(err);\n  return `skipped: provider out of credits (${message})`;\n}\n\nconst SKIP_OVERRIDE_ENV = \"WORKGLOW_CREDIT_EXHAUSTED_SKIP\";\n\nfunction isTruthyFlag(value: string): boolean {\n  return !/^(?:0|false|off|no)$/i.test(value.trim());\n}\n\n/**\n * Whether a billing failure skips the test or fails it.\n *\n * CI skips: nobody watching a build can top an account up, and one exhausted\n * key would otherwise turn every provider suite red for a change that touched\n * none of them — so the leniency is provider-agnostic by construction, keyed on\n * the environment rather than on which vendor ran out.\n *\n * Locally it fails, loudly, because the developer running the suite IS the\n * person who can act on it — and a silently green local run is how an\n * exhausted account goes unnoticed until CI is the only thing exercising the\n * provider at all.\n *\n * `WORKGLOW_CREDIT_EXHAUSTED_SKIP` overrides in both directions.\n */\nexport function creditExhaustionSkipsTest(\n  env: Record<string, string | undefined> = process.env\n): boolean {\n  const override = env[SKIP_OVERRIDE_ENV];\n  if (override !== undefined && override.trim() !== \"\") return isTruthyFlag(override);\n  for (const key of [\"CI\", \"GITHUB_ACTIONS\"] as const) {\n    const value = env[key];\n    if (value !== undefined && value.trim() !== \"\" && isTruthyFlag(value)) return true;\n  }\n  return false;\n}\n\n/**\n * The local-failure path. Rethrows the provider's own error unchanged — its\n * identity and stack are what makes the failure diagnosable — after one line\n * saying why it was not skipped and how to skip it.\n */\nfunction reportLocalCreditFailure(err: unknown): void {\n  const message = err instanceof Error ? err.message : String(err);\n  console.error(\n    `provider out of credits (${message})\\n` +\n      `  Failing because this is not CI. Top the account up, or set ${SKIP_OVERRIDE_ENV}=1 to skip instead.`\n  );\n}\n\nexport async function runWithCreditSkip<T>(\n  ctx: { skip: (note?: string) => void },\n  fn: () => Promise<T> | T\n): Promise<T> {\n  try {\n    return await fn();\n  } catch (err) {\n    if (isCreditExhaustedError(err)) {\n      if (!creditExhaustionSkipsTest()) {\n        reportLocalCreditFailure(err);\n        throw err;\n      }\n      ctx.skip(creditSkipNote(err));\n      // vitest's skip() is `never` (throws). Mocks used in unit tests return.\n      return undefined as T;\n    }\n    throw err;\n  }\n}\n\n/**\n * Wraps one test body. This is the seam every conformance assertion actually\n * runs through (the exported {@link it} proxies each callback through it), so\n * the CI-skips / locally-fails policy is applied here rather than at each\n * call site.\n */\nexport function wrapTestBodyForCreditSkip(\n  fn: (...args: never[]) => unknown\n): (...args: never[]) => unknown {\n  return async function wrapped(this: unknown, ...args: never[]): Promise<unknown> {\n    try {\n      return await fn.apply(this, args);\n    } catch (err) {\n      if (!isCreditExhaustedError(err)) throw err;\n      if (!creditExhaustionSkipsTest()) {\n        reportLocalCreditFailure(err);\n        throw err;\n      }\n      const ctx = args[0] as { skip?: (note?: string) => void } | undefined;\n      if (ctx && typeof ctx.skip === \"function\") {\n        ctx.skip(creditSkipNote(err));\n        return undefined;\n      }\n      // bun:test has no TestContext.skip; passing is \"don't fail the test\".\n      console.warn(creditSkipNote(err));\n      return undefined;\n    }\n  };\n}\n\nfunction wrapCallable(fn: CallableFunction): CallableFunction {\n  return new Proxy(fn, {\n    apply(target, thisArg, argArray: unknown[]) {\n      const wrapped = argArray.map((arg) =>\n        typeof arg === \"function\" ? wrapTestBodyForCreditSkip(arg as never) : arg\n      );\n      const result = Reflect.apply(target, thisArg, wrapped);\n      return typeof result === \"function\" ? wrapCallable(result) : result;\n    },\n    get(target, prop, receiver) {\n      const value = Reflect.get(target, prop, receiver);\n      if (typeof value === \"function\") {\n        return wrapCallable((value as CallableFunction).bind(target));\n      }\n      return value;\n    },\n  });\n}\n\n/**\n * Drop-in `it` for live provider tests: a credit/billing error skips the test on\n * CI and fails it locally (see {@link creditExhaustionSkipsTest}).\n */\nexport const it = wrapCallable(vitestIt) as typeof vitestIt;\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { isCreditExhaustedError, it } from \"./creditExhaustedSkip\";\n\ntype ItFn = (name: string, fn: () => Promise<void> | void, timeout?: number) => void;\n\n/**\n * Cross-runner polyfill for `it.fails`. Vitest exposes it natively; bun's\n * native `bun test` runner does not. Under bun we wrap the body in a\n * try/catch and assert that it threw — so a passing-when-expected-fail\n * test still surfaces as a CI failure (signalling \"remove from\n * expectedFailures\").\n */\nexport const itExpectFail: ItFn = (name, fn, timeout) => {\n  const native = (it as unknown as { fails?: ItFn }).fails;\n  if (typeof native === \"function\") {\n    native(name, fn, timeout);\n    return;\n  }\n  it(\n    `${name} [expected-fail]`,\n    async () => {\n      let passed = false;\n      try {\n        await fn();\n        passed = true;\n      } catch (err) {\n        // Billing exhaustion is not the adapter bug this marker records.\n        if (isCreditExhaustedError(err)) throw err;\n        // expected; the test was supposed to fail\n      }\n      if (passed) {\n        throw new Error(\n          `Test \"${name}\" was marked as expected-fail but passed. Remove its name from opts.expectedFailures.`\n        );\n      }\n    },\n    timeout\n  );\n};\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { Capability } from \"@workglow/ai\";\nimport {\n  collectStream,\n  createEmitQueue,\n  getAiProviderRegistry,\n  getGlobalModelRepository,\n  textGeneration,\n} from \"@workglow/ai\";\nimport type { StreamEvent, TaskOutput } from \"@workglow/task-graph\";\n\nconst TEXT_GENERATION: readonly Capability[] = [\"text.generation\"];\n\nexport interface CallOpts {\n  readonly maxTokens: number;\n  readonly timeoutMs: number;\n  readonly signal?: AbortSignal;\n}\n\nexport interface CallResult {\n  readonly text: string;\n}\n\nexport async function runProviderTextGeneration(\n  modelId: string,\n  prompt: string,\n  callOpts: CallOpts\n): Promise<CallResult> {\n  const result = await textGeneration(\n    {\n      model: modelId,\n      prompt,\n      maxTokens: callOpts.maxTokens,\n    },\n    { timeout: callOpts.timeoutMs }\n  );\n  return { text: (result as { text?: string }).text ?? \"\" };\n}\n\n/**\n * Helper used by worker-proxy conformance tests to drive a streaming\n * text-generation run-fn end-to-end against the dispatched provider. Yields\n * the raw `StreamEvent` objects so callers can assert on the event sequence;\n * use {@link collectStream} when only the final output matters.\n */\nexport async function* streamProviderTextGeneration(\n  modelId: string,\n  prompt: string,\n  callOpts: CallOpts\n): AsyncGenerator<unknown, void, void> {\n  const model = await getGlobalModelRepository().findByName(modelId);\n  if (!model) throw new Error(`Model not registered: ${modelId}`);\n  const registry = getAiProviderRegistry();\n  const streamFn = registry.getRunFnFor(model.provider, TEXT_GENERATION);\n  if (!streamFn) {\n    throw new Error(`No run-fn registered for ${model.provider} serving [\"text.generation\"]`);\n  }\n  const ac = new AbortController();\n  const onCallerAbort = (): void => ac.abort(callOpts.signal?.reason);\n  const t = setTimeout(() => ac.abort(new Error(\"timeout\")), callOpts.timeoutMs);\n  if (callOpts.signal) {\n    if (callOpts.signal.aborted) {\n      clearTimeout(t);\n      ac.abort(callOpts.signal.reason);\n    } else {\n      callOpts.signal.addEventListener(\"abort\", onCallerAbort, { once: true });\n    }\n  }\n  // Bridge Promise+emit run-fn back to an async generator for callers that\n  // want to inspect the raw event sequence.\n  const q = createEmitQueue<StreamEvent<TaskOutput>>();\n  const runP = streamFn(\n    { prompt, maxTokens: callOpts.maxTokens },\n    model,\n    ac.signal,\n    (e) => q.push(e as StreamEvent<TaskOutput>),\n    undefined,\n    undefined\n  ).then(\n    () => q.close(),\n    (err) => q.fail(err)\n  );\n  try {\n    for await (const event of q.iterable) {\n      yield event;\n    }\n  } finally {\n    clearTimeout(t);\n    callOpts.signal?.removeEventListener(\"abort\", onCallerAbort);\n    await runP.catch(() => {});\n  }\n}\n\n// Re-export collectStream so worker-proxy tests can use it without a second import.\nexport { collectStream };\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { describe, expect, it } from \"vitest\";\n\nimport type { ConformanceHandle } from \"../../ai-provider/types\";\nimport { itExpectFail } from \"../../itExpectFail\";\nimport type { WorkerProxyBoundaryOpts } from \"../types\";\nimport { runProviderTextGeneration } from \"./providerCallHelpers\";\n\nconst FAIL_KEY = \"boundary.disposeTerminatesWorker\";\n\nexport function disposeTerminatesWorkerBlock(\n  opts: WorkerProxyBoundaryOpts,\n  getHandle: () => ConformanceHandle,\n  markDisposed: () => void\n): void {\n  const failing = opts.expectedFailures?.includes(FAIL_KEY) ?? false;\n  const test = failing ? itExpectFail : it;\n\n  describe(\"Dispose terminates worker\", () => {\n    test(\n      \"after dispose() the worker no longer responds to traffic\",\n      async () => {\n        const handle = getHandle();\n        const modelId = opts.models.textGeneration;\n        if (!modelId) {\n          throw new Error(`${opts.name}: models.textGeneration is required for boundary tests`);\n        }\n\n        // Sanity request — must succeed before dispose.\n        const before = await runProviderTextGeneration(\n          modelId,\n          \"Reply with the single word READY.\",\n          { maxTokens: 8, timeoutMs: opts.timeout / 4 }\n        );\n        expect(before.text.length).toBeGreaterThan(0);\n\n        await handle.dispose();\n        markDisposed();\n\n        const after = runProviderTextGeneration(modelId, \"Reply with the single word LATE.\", {\n          maxTokens: 8,\n          timeoutMs: opts.timeout / 4,\n        });\n        await expect(after).rejects.toThrow(/.+/);\n      },\n      opts.timeout\n    );\n  });\n}\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { describe, expect, it } from \"vitest\";\n\nimport { itExpectFail } from \"../../itExpectFail\";\nimport type { WorkerProxyBoundaryOpts } from \"../types\";\nimport { runProviderTextGeneration } from \"./providerCallHelpers\";\n\nconst FAIL_KEY = \"boundary.errorPropagation\";\n\nexport function errorPropagationBlock(opts: WorkerProxyBoundaryOpts): void {\n  const failing = opts.expectedFailures?.includes(FAIL_KEY) ?? false;\n  const test = failing ? itExpectFail : it;\n\n  describe(\"Worker-side throw surfaces on main thread\", () => {\n    test(\n      \"provider rejection from inside the worker surfaces as a thrown error\",\n      async () => {\n        const modelId = opts.models.textGeneration;\n        if (!modelId) {\n          throw new Error(`${opts.name}: models.textGeneration is required for boundary tests`);\n        }\n        // Use a registered model so resolution succeeds and the call is\n        // dispatched into the worker. The provider's run fn rejects when\n        // asked for an absurd token budget — the rejection therefore\n        // originates inside the worker and must cross the postMessage\n        // boundary to surface here.\n        await expect(\n          runProviderTextGeneration(modelId, \"ignored\", {\n            maxTokens: 1_000_000_000,\n            timeoutMs: opts.timeout / 4,\n          })\n        ).rejects.toThrow(/.+/);\n      },\n      opts.timeout\n    );\n\n    if (opts.capabilities.errorPropagation) {\n      test(\n        \"worker-thrown Error preserves name and non-empty message across postMessage\",\n        async () => {\n          const modelId = opts.models.textGeneration;\n          if (!modelId) {\n            throw new Error(`${opts.name}: models.textGeneration is required for boundary tests`);\n          }\n          let captured: unknown;\n          try {\n            await runProviderTextGeneration(modelId, \"ignored\", {\n              maxTokens: 1_000_000_000,\n              timeoutMs: opts.timeout / 4,\n            });\n          } catch (err) {\n            captured = err;\n          }\n          // WorkerManager reconstructs cross-boundary errors on the main\n          // thread and only round-trips `message` + `name` (the worker's\n          // stack is not preserved). Verifying these two fields are intact\n          // is the strongest structural check the harness can make without\n          // assuming internal symbol names appear in stack frames.\n          expect(captured).toBeInstanceOf(Error);\n          const e = captured as Error;\n          expect(e.message.length).toBeGreaterThan(0);\n          expect(e.name.length).toBeGreaterThan(0);\n        },\n        opts.timeout\n      );\n    }\n  });\n}\n"
+  ],
+  "mappings": ";AAMA;AAIO,SAAS,oBAAoB,CAAC,MAAqC;AAAA,EACxE,SAAS,OAAO,KAAK,IAAI,EAAE,0BAA0B,KAAK,QAAQ,MAAM;AAAA,IACtE,GAAG,KAAK,GAAG,KAAK,0DAA0D,MAAM,EAAE;AAAA,GACnF;AAAA;;ACPH,0CAA8B;;;ACA9B,qBAAS,yBAAkB;;;ACA3B,eAAS;AAoBT,IAAM,gBAAgB,IAAI,IAAI;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,IAAM,iBACJ;AAWF,IAAM,mBACJ;AAEK,SAAS,sBAAsB,CAAC,KAAuB;AAAA,EAC5D,MAAM,OAAO,IAAI;AAAA,EACjB,IAAI,UAAmB;AAAA,EACvB,OAAO,YAAY,aAAa,YAAY,QAAQ,CAAC,KAAK,IAAI,OAAO,GAAG;AAAA,IACtE,KAAK,IAAI,OAAO;AAAA,IAChB,IAAI,wBAAwB,OAAO;AAAA,MAAG,OAAO;AAAA,IAC7C,UAAU,QAAQ,OAAO;AAAA,EAC3B;AAAA,EACA,OAAO;AAAA;AAGT,SAAS,uBAAuB,CAAC,KAAuB;AAAA,EACtD,IAAI,OAAO,QAAQ;AAAA,IAAU,OAAO,iCAAiC,GAAG;AAAA,EAExE,IAAI,CAAC,OAAO,OAAO,QAAQ;AAAA,IAAU,OAAO;AAAA,EAE5C,MAAM,MAAM;AAAA,EACZ,MAAM,SAAS,cAAc,GAAG;AAAA,EAChC,IAAI,WAAW;AAAA,IAAK,OAAO;AAAA,EAE3B,MAAM,OAAO,UAAU,IAAI,IAAI,KAAK,UAAU,OAAO,IAAI,OAAO,MAAM,CAAC;AAAA,EACvE,MAAM,OAAO,UAAU,IAAI,IAAI,KAAK,UAAU,OAAO,IAAI,OAAO,MAAM,CAAC;AAAA,EACvE,IAAI,QAAQ,cAAc,IAAI,IAAI;AAAA,IAAG,OAAO;AAAA,EAC5C,IAAI,QAAQ,cAAc,IAAI,IAAI;AAAA,IAAG,OAAO;AAAA,EAE5C,MAAM,UAAU;AAAA,IACd,UAAU,IAAI,OAAO;AAAA,IACrB,UAAU,OAAO,IAAI,OAAO,SAAS,CAAC;AAAA,IACtC,iBAAiB,GAAG;AAAA,EACtB,EACG,OAAO,CAAC,SAAyB,OAAO,SAAS,QAAQ,EACzD,KAAK;AAAA,CAAI;AAAA,EACZ,OAAO,iCAAiC,OAAO;AAAA;AAGjD,SAAS,gCAAgC,CAAC,SAA0B;AAAA,EAClE,OAAO,eAAe,KAAK,OAAO,KAAK,iBAAiB,KAAK,OAAO;AAAA;AAGtE,SAAS,aAAa,CAAC,KAAkD;AAAA,EACvE,WAAW,OAAO,CAAC,UAAU,YAAY,GAAY;AAAA,IACnD,MAAM,QAAQ,IAAI;AAAA,IAClB,IAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK;AAAA,MAAG,OAAO;AAAA,EAClE;AAAA,EACA,MAAM,eAAe,OAAO,IAAI,OAAO,QAAQ;AAAA,EAC/C,IAAI,OAAO,iBAAiB,YAAY,OAAO,SAAS,YAAY;AAAA,IAAG,OAAO;AAAA,EAC9E;AAAA;AAGF,SAAS,MAAM,CAAC,OAAgB,KAAsB;AAAA,EACpD,IAAI,CAAC,SAAS,OAAO,UAAU;AAAA,IAAU;AAAA,EACzC,OAAQ,MAAkC;AAAA;AAG5C,SAAS,SAAS,CAAC,OAAoC;AAAA,EACrD,OAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AAAA;AAGjE,SAAS,gBAAgB,CAAC,KAAsB;AAAA,EAC9C,IAAI,eAAe;AAAA,IAAO,OAAO,IAAI;AAAA,EACrC,OAAO,OAAO,GAAG;AAAA;AAGnB,SAAS,OAAO,CAAC,KAAuB;AAAA,EACtC,IAAI,CAAC,OAAO,OAAO,QAAQ;AAAA,IAAU;AAAA,EACrC,OAAQ,IAA4B;AAAA;AAG/B,SAAS,cAAc,CAAC,KAAsB;AAAA,EACnD,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,EAC/D,OAAO,qCAAqC;AAAA;AAG9C,IAAM,oBAAoB;AAE1B,SAAS,YAAY,CAAC,OAAwB;AAAA,EAC5C,OAAO,CAAC,wBAAwB,KAAK,MAAM,KAAK,CAAC;AAAA;AAkB5C,SAAS,yBAAyB,CACvC,MAA0C,QAAQ,KACzC;AAAA,EACT,MAAM,WAAW,IAAI;AAAA,EACrB,IAAI,aAAa,aAAa,SAAS,KAAK,MAAM;AAAA,IAAI,OAAO,aAAa,QAAQ;AAAA,EAClF,WAAW,OAAO,CAAC,MAAM,gBAAgB,GAAY;AAAA,IACnD,MAAM,QAAQ,IAAI;AAAA,IAClB,IAAI,UAAU,aAAa,MAAM,KAAK,MAAM,MAAM,aAAa,KAAK;AAAA,MAAG,OAAO;AAAA,EAChF;AAAA,EACA,OAAO;AAAA;AAQT,SAAS,wBAAwB,CAAC,KAAoB;AAAA,EACpD,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,EAC/D,QAAQ,MACN,4BAA4B;AAAA,IAC1B,gEAAgE,sCACpE;AAAA;AAGF,eAAsB,iBAAoB,CACxC,KACA,IACY;AAAA,EACZ,IAAI;AAAA,IACF,OAAO,MAAM,GAAG;AAAA,IAChB,OAAO,KAAK;AAAA,IACZ,IAAI,uBAAuB,GAAG,GAAG;AAAA,MAC/B,IAAI,CAAC,0BAA0B,GAAG;AAAA,QAChC,yBAAyB,GAAG;AAAA,QAC5B,MAAM;AAAA,MACR;AAAA,MACA,IAAI,KAAK,eAAe,GAAG,CAAC;AAAA,MAE5B;AAAA,IACF;AAAA,IACA,MAAM;AAAA;AAAA;AAUH,SAAS,yBAAyB,CACvC,IAC+B;AAAA,EAC/B,OAAO,eAAe,OAAO,IAAmB,MAAiC;AAAA,IAC/E,IAAI;AAAA,MACF,OAAO,MAAM,GAAG,MAAM,MAAM,IAAI;AAAA,MAChC,OAAO,KAAK;AAAA,MACZ,IAAI,CAAC,uBAAuB,GAAG;AAAA,QAAG,MAAM;AAAA,MACxC,IAAI,CAAC,0BAA0B,GAAG;AAAA,QAChC,yBAAyB,GAAG;AAAA,QAC5B,MAAM;AAAA,MACR;AAAA,MACA,MAAM,MAAM,KAAK;AAAA,MACjB,IAAI,OAAO,OAAO,IAAI,SAAS,YAAY;AAAA,QACzC,IAAI,KAAK,eAAe,GAAG,CAAC;AAAA,QAC5B;AAAA,MACF;AAAA,MAEA,QAAQ,KAAK,eAAe,GAAG,CAAC;AAAA,MAChC;AAAA;AAAA;AAAA;AAKN,SAAS,YAAY,CAAC,IAAwC;AAAA,EAC5D,OAAO,IAAI,MAAM,IAAI;AAAA,IACnB,KAAK,CAAC,QAAQ,SAAS,UAAqB;AAAA,MAC1C,MAAM,UAAU,SAAS,IAAI,CAAC,QAC5B,OAAO,QAAQ,aAAa,0BAA0B,GAAY,IAAI,GACxE;AAAA,MACA,MAAM,SAAS,QAAQ,MAAM,QAAQ,SAAS,OAAO;AAAA,MACrD,OAAO,OAAO,WAAW,aAAa,aAAa,MAAM,IAAI;AAAA;AAAA,IAE/D,GAAG,CAAC,QAAQ,MAAM,UAAU;AAAA,MAC1B,MAAM,QAAQ,QAAQ,IAAI,QAAQ,MAAM,QAAQ;AAAA,MAChD,IAAI,OAAO,UAAU,YAAY;AAAA,QAC/B,OAAO,aAAc,MAA2B,KAAK,MAAM,CAAC;AAAA,MAC9D;AAAA,MACA,OAAO;AAAA;AAAA,EAEX,CAAC;AAAA;AAOI,IAAM,MAAK,aAAa,QAAQ;;;AC/NhC,IAAM,eAAqB,CAAC,MAAM,IAAI,YAAY;AAAA,EACvD,MAAM,SAAU,IAAmC;AAAA,EACnD,IAAI,OAAO,WAAW,YAAY;AAAA,IAChC,OAAO,MAAM,IAAI,OAAO;AAAA,IACxB;AAAA,EACF;AAAA,EACA,IACE,GAAG,wBACH,YAAY;AAAA,IACV,IAAI,SAAS;AAAA,IACb,IAAI;AAAA,MACF,MAAM,GAAG;AAAA,MACT,SAAS;AAAA,MACT,OAAO,KAAK;AAAA,MAEZ,IAAI,uBAAuB,GAAG;AAAA,QAAG,MAAM;AAAA;AAAA,IAGzC,IAAI,QAAQ;AAAA,MACV,MAAM,IAAI,MACR,SAAS,2FACX;AAAA,IACF;AAAA,KAEF,OACF;AAAA;;;ACnCF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,IAAM,kBAAyC,CAAC,iBAAiB;AAYjE,eAAsB,yBAAyB,CAC7C,SACA,QACA,UACqB;AAAA,EACrB,MAAM,SAAS,MAAM,eACnB;AAAA,IACE,OAAO;AAAA,IACP;AAAA,IACA,WAAW,SAAS;AAAA,EACtB,GACA,EAAE,SAAS,SAAS,UAAU,CAChC;AAAA,EACA,OAAO,EAAE,MAAO,OAA6B,QAAQ,GAAG;AAAA;AAS1D,gBAAuB,4BAA4B,CACjD,SACA,QACA,UACqC;AAAA,EACrC,MAAM,QAAQ,MAAM,yBAAyB,EAAE,WAAW,OAAO;AAAA,EACjE,IAAI,CAAC;AAAA,IAAO,MAAM,IAAI,MAAM,yBAAyB,SAAS;AAAA,EAC9D,MAAM,WAAW,sBAAsB;AAAA,EACvC,MAAM,WAAW,SAAS,YAAY,MAAM,UAAU,eAAe;AAAA,EACrE,IAAI,CAAC,UAAU;AAAA,IACb,MAAM,IAAI,MAAM,4BAA4B,MAAM,sCAAsC;AAAA,EAC1F;AAAA,EACA,MAAM,KAAK,IAAI;AAAA,EACf,MAAM,gBAAgB,MAAY,GAAG,MAAM,SAAS,QAAQ,MAAM;AAAA,EAClE,MAAM,IAAI,WAAW,MAAM,GAAG,MAAM,IAAI,MAAM,SAAS,CAAC,GAAG,SAAS,SAAS;AAAA,EAC7E,IAAI,SAAS,QAAQ;AAAA,IACnB,IAAI,SAAS,OAAO,SAAS;AAAA,MAC3B,aAAa,CAAC;AAAA,MACd,GAAG,MAAM,SAAS,OAAO,MAAM;AAAA,IACjC,EAAO;AAAA,MACL,SAAS,OAAO,iBAAiB,SAAS,eAAe,EAAE,MAAM,KAAK,CAAC;AAAA;AAAA,EAE3E;AAAA,EAGA,MAAM,IAAI,gBAAyC;AAAA,EACnD,MAAM,OAAO,SACX,EAAE,QAAQ,WAAW,SAAS,UAAU,GACxC,OACA,GAAG,QACH,CAAC,MAAM,EAAE,KAAK,CAA4B,GAC1C,WACA,SACF,EAAE,KACA,MAAM,EAAE,MAAM,GACd,CAAC,QAAQ,EAAE,KAAK,GAAG,CACrB;AAAA,EACA,IAAI;AAAA,IACF,iBAAiB,SAAS,EAAE,UAAU;AAAA,MACpC,MAAM;AAAA,IACR;AAAA,YACA;AAAA,IACA,aAAa,CAAC;AAAA,IACd,SAAS,QAAQ,oBAAoB,SAAS,aAAa;AAAA,IAC3D,MAAM,KAAK,MAAM,MAAM,EAAE;AAAA;AAAA;;;AHlF7B,IAAM,WAAW;AAOjB,eAAe,cAAa,CAC1B,SACA,QACA,WACuB;AAAA,EACvB,MAAM,SAA2C,CAAC;AAAA,EAClD,IAAI,cAAc;AAAA,EAClB,iBAAiB,MAAM,6BAA6B,SAAS,QAAQ;AAAA,IACnE,WAAW;AAAA,IACX;AAAA,EACF,CAAC,GAAG;AAAA,IACF,MAAM,IAAI;AAAA,IACV,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;AAAA,IAC5B,IAAI,EAAE,SAAS;AAAA,MAAU,eAAe;AAAA,EAC1C;AAAA,EACA,OAAO,EAAE,QAAQ,YAAY;AAAA;AAGxB,SAAS,oBAAoB,CAAC,MAAqC;AAAA,EACxE,MAAM,UAAU,KAAK,kBAAkB,SAAS,QAAQ,KAAK;AAAA,EAC7D,MAAM,OAAO,UAAU,eAAe;AAAA,EAEtC,UAAS,wDAAwD,MAAM;AAAA,IACrE,KACE,gFACA,YAAY;AAAA,MACV,MAAM,UAAU,KAAK,OAAO;AAAA,MAC5B,IAAI,CAAC,SAAS;AAAA,QACZ,MAAM,IAAI,MAAM,GAAG,KAAK,4DAA4D;AAAA,MACtF;AAAA,MACA,MAAM,UAAU;AAAA,QACd;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MACA,MAAM,OAAO,MAAM,QAAQ,IACzB,QAAQ,IAAI,CAAC,MAAM,eAAc,SAAS,GAAG,KAAK,UAAU,CAAC,CAAC,CAChE;AAAA,MAEA,WAAW,OAAO,MAAM;AAAA,QACtB,OAAO,IAAI,WAAW,EAAE,KAAK,CAAC;AAAA,QAC9B,OAAO,IAAI,OAAO,IAAI,OAAO,SAAS,IAAI,IAAI,EAAE,KAAK,QAAQ;AAAA,QAC7D,MAAM,aAAa,IAAI,OACpB,MAAM,GAAG,EAAE,EACX,IAAI,CAAC,MAAM,EAAE,IAAI,EACjB,OAAO,CAAC,MAAM,EAAE,SAAS,QAAQ,CAAC;AAAA,QACrC,OAAO,WAAW,MAAM,EAAE,gBAAgB,CAAC;AAAA,MAC7C;AAAA,OAEF,KAAK,OACP;AAAA,GACD;AAAA;;;AIhEH,qBAAS,qBAAU,eAAQ;AAO3B,IAAM,YAAW;AAEV,SAAS,4BAA4B,CAC1C,MACA,WACA,cACM;AAAA,EACN,MAAM,UAAU,KAAK,kBAAkB,SAAS,SAAQ,KAAK;AAAA,EAC7D,MAAM,OAAO,UAAU,eAAe;AAAA,EAEtC,UAAS,6BAA6B,MAAM;AAAA,IAC1C,KACE,4DACA,YAAY;AAAA,MACV,MAAM,SAAS,UAAU;AAAA,MACzB,MAAM,UAAU,KAAK,OAAO;AAAA,MAC5B,IAAI,CAAC,SAAS;AAAA,QACZ,MAAM,IAAI,MAAM,GAAG,KAAK,4DAA4D;AAAA,MACtF;AAAA,MAGA,MAAM,SAAS,MAAM,0BACnB,SACA,qCACA,EAAE,WAAW,GAAG,WAAW,KAAK,UAAU,EAAE,CAC9C;AAAA,MACA,QAAO,OAAO,KAAK,MAAM,EAAE,gBAAgB,CAAC;AAAA,MAE5C,MAAM,OAAO,QAAQ;AAAA,MACrB,aAAa;AAAA,MAEb,MAAM,QAAQ,0BAA0B,SAAS,oCAAoC;AAAA,QACnF,WAAW;AAAA,QACX,WAAW,KAAK,UAAU;AAAA,MAC5B,CAAC;AAAA,MACD,MAAM,QAAO,KAAK,EAAE,QAAQ,QAAQ,IAAI;AAAA,OAE1C,KAAK,OACP;AAAA,GACD;AAAA;;;AC9CH,qBAAS,qBAAU,eAAQ;AAM3B,IAAM,YAAW;AAEV,SAAS,qBAAqB,CAAC,MAAqC;AAAA,EACzE,MAAM,UAAU,KAAK,kBAAkB,SAAS,SAAQ,KAAK;AAAA,EAC7D,MAAM,OAAO,UAAU,eAAe;AAAA,EAEtC,UAAS,6CAA6C,MAAM;AAAA,IAC1D,KACE,wEACA,YAAY;AAAA,MACV,MAAM,UAAU,KAAK,OAAO;AAAA,MAC5B,IAAI,CAAC,SAAS;AAAA,QACZ,MAAM,IAAI,MAAM,GAAG,KAAK,4DAA4D;AAAA,MACtF;AAAA,MAMA,MAAM,QACJ,0BAA0B,SAAS,WAAW;AAAA,QAC5C,WAAW;AAAA,QACX,WAAW,KAAK,UAAU;AAAA,MAC5B,CAAC,CACH,EAAE,QAAQ,QAAQ,IAAI;AAAA,OAExB,KAAK,OACP;AAAA,IAEA,IAAI,KAAK,aAAa,kBAAkB;AAAA,MACtC,KACE,+EACA,YAAY;AAAA,QACV,MAAM,UAAU,KAAK,OAAO;AAAA,QAC5B,IAAI,CAAC,SAAS;AAAA,UACZ,MAAM,IAAI,MAAM,GAAG,KAAK,4DAA4D;AAAA,QACtF;AAAA,QACA,IAAI;AAAA,QACJ,IAAI;AAAA,UACF,MAAM,0BAA0B,SAAS,WAAW;AAAA,YAClD,WAAW;AAAA,YACX,WAAW,KAAK,UAAU;AAAA,UAC5B,CAAC;AAAA,UACD,OAAO,KAAK;AAAA,UACZ,WAAW;AAAA;AAAA,QAOb,QAAO,QAAQ,EAAE,eAAe,KAAK;AAAA,QACrC,MAAM,IAAI;AAAA,QACV,QAAO,EAAE,QAAQ,MAAM,EAAE,gBAAgB,CAAC;AAAA,QAC1C,QAAO,EAAE,KAAK,MAAM,EAAE,gBAAgB,CAAC;AAAA,SAEzC,KAAK,OACP;AAAA,IACF;AAAA,GACD;AAAA;;;ANxDI,SAAS,sBAAsB,CAAC,MAAqC;AAAA,EAC1E,IAAI,KAAK,aAAa,aAAa;AAAA,IACjC,qBAAqB,IAAI;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,UAAS,OAAO,KAAK,IAAI,EAAE,0BAA0B,KAAK,QAAQ,MAAM;AAAA,IACtE,IAAI;AAAA,IACJ,IAAI,WAAW;AAAA,IACf,MAAM,YAAY,MAAyB;AAAA,MACzC,IAAI,CAAC;AAAA,QAAQ,MAAM,IAAI,MAAM,qCAAqC;AAAA,MAClE,OAAO;AAAA;AAAA,IAET,MAAM,eAAe,MAAY;AAAA,MAC/B,WAAW;AAAA;AAAA,IAGb,UAAU,YAAY;AAAA,MACpB,SAAS,MAAM,KAAK,QAAQ;AAAA,MAC5B,MAAM,OAAO,SAAS;AAAA,OACrB,KAAK,OAAO;AAAA,IAEf,SAAS,YAAY;AAAA,MACnB,IAAI,UAAU,CAAC;AAAA,QAAU,MAAM,OAAO,QAAQ;AAAA,KAC/C;AAAA,IAKD,sBAAsB,IAAI;AAAA,IAC1B,qBAAqB,IAAI;AAAA,IACzB,6BAA6B,MAAM,WAAW,YAAY;AAAA,GAC3D;AAAA;",
+  "debugId": "292FD920B04AD20B64756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,120 @@
+{
+  "name": "@workglow/test-contract",
+  "type": "module",
+  "version": "0.6.1",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/workglow-dev/libs.git",
+    "directory": "packages/test-contract"
+  },
+  "bugs": {
+    "url": "https://github.com/workglow-dev/libs/issues"
+  },
+  "description": "Parameterized conformance suites for the Workglow interfaces, so an adapter outside this repo inherits the same behavioral assertions its in-repo siblings run.",
+  "homepage": "https://workglow.dev",
+  "scripts": {
+    "watch": "concurrently -c 'auto' 'bun:watch-*'",
+    "watch-js": "bun build --watch --no-clear-screen --target=node --sourcemap=external --packages=external --root ./src --outdir ./dist ./src/ai-provider.ts ./src/browser-context.ts ./src/entitlement-profile.ts ./src/human-connector.ts ./src/storage-migrations.ts ./src/tabular-migrations.ts ./src/tabular-storage.ts ./src/vector-storage.ts ./src/web-search.ts ./src/worker-proxy.ts ./src/creditExhaustedSkip.ts ./src/itExpectFail.ts",
+    "watch-types": "tsc --watch --preserveWatchOutput",
+    "build-package": "bun run build-js && bun run build-types",
+    "build-js": "bun build --target=node --sourcemap=external --packages=external --root ./src --outdir ./dist ./src/ai-provider.ts ./src/browser-context.ts ./src/entitlement-profile.ts ./src/human-connector.ts ./src/storage-migrations.ts ./src/tabular-migrations.ts ./src/tabular-storage.ts ./src/vector-storage.ts ./src/web-search.ts ./src/worker-proxy.ts ./src/creditExhaustedSkip.ts ./src/itExpectFail.ts",
+    "build-clean": "rm -fr dist/* tsconfig.tsbuildinfo",
+    "build-types": "rm -f tsconfig.tsbuildinfo && tsc"
+  },
+  "exports": {
+    "./ai-provider": {
+      "types": "./dist/ai-provider.d.ts",
+      "import": "./dist/ai-provider.js"
+    },
+    "./browser-context": {
+      "types": "./dist/browser-context.d.ts",
+      "import": "./dist/browser-context.js"
+    },
+    "./entitlement-profile": {
+      "types": "./dist/entitlement-profile.d.ts",
+      "import": "./dist/entitlement-profile.js"
+    },
+    "./human-connector": {
+      "types": "./dist/human-connector.d.ts",
+      "import": "./dist/human-connector.js"
+    },
+    "./storage-migrations": {
+      "types": "./dist/storage-migrations.d.ts",
+      "import": "./dist/storage-migrations.js"
+    },
+    "./tabular-migrations": {
+      "types": "./dist/tabular-migrations.d.ts",
+      "import": "./dist/tabular-migrations.js"
+    },
+    "./tabular-storage": {
+      "types": "./dist/tabular-storage.d.ts",
+      "import": "./dist/tabular-storage.js"
+    },
+    "./vector-storage": {
+      "types": "./dist/vector-storage.d.ts",
+      "import": "./dist/vector-storage.js"
+    },
+    "./worker-proxy": {
+      "types": "./dist/worker-proxy.d.ts",
+      "import": "./dist/worker-proxy.js"
+    },
+    "./credit-exhausted-skip": {
+      "types": "./dist/creditExhaustedSkip.d.ts",
+      "import": "./dist/creditExhaustedSkip.js"
+    },
+    "./expect-fail": {
+      "types": "./dist/itExpectFail.d.ts",
+      "import": "./dist/itExpectFail.js"
+    },
+    "./web-search": {
+      "types": "./dist/web-search.d.ts",
+      "import": "./dist/web-search.js"
+    }
+  },
+  "peerDependencies": {
+    "@workglow/ai": "0.6.1",
+    "@workglow/browser-control": "0.6.1",
+    "@workglow/storage": "0.6.1",
+    "@workglow/task-graph": "0.6.1",
+    "@workglow/util": "0.6.1",
+    "@workglow/web-search": "0.6.1",
+    "vitest": "^5.0.1"
+  },
+  "peerDependenciesMeta": {
+    "@workglow/ai": {
+      "optional": true
+    },
+    "@workglow/browser-control": {
+      "optional": true
+    },
+    "@workglow/storage": {
+      "optional": true
+    },
+    "@workglow/task-graph": {
+      "optional": true
+    },
+    "@workglow/util": {
+      "optional": true
+    },
+    "@workglow/web-search": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@workglow/ai": "0.6.1",
+    "@workglow/browser-control": "0.6.1",
+    "@workglow/storage": "0.6.1",
+    "@workglow/task-graph": "0.6.1",
+    "@workglow/util": "0.6.1",
+    "@workglow/web-search": "0.6.1",
+    "vitest": "^5.0.1"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}