@frockbot/plugin-provider-foundation 0.3.14 → 0.3.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frockbot/plugin-provider-foundation",
-  "version": "0.3.14",
+  "version": "0.3.16",
   "private": false,
   "type": "module",
   "exports": {
@@ -18,12 +18,12 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@frockbot/kernel-contracts": "0.3.14",
-    "@frockbot/plugin-models": "0.3.14",
+    "@frockbot/kernel-contracts": "0.3.16",
+    "@frockbot/plugin-models": "0.3.16",
     "cordis": "4.0.0-rc.8"
   },
   "devDependencies": {
-    "@frockbot/plugin-testkit": "0.3.14",
+    "@frockbot/plugin-testkit": "0.3.16",
     "@types/bun": "1.4.0",
     "typescript": "^7.0.2"
   },

package/src/runtime.test.ts

@@ -11,6 +11,7 @@ import {
 import manifest from "../frockbot.json" with { type: "json" };
 import packageJson from "../package.json" with { type: "json" };
 import foundationProviderPlugin, {
+  classifyFoundationFailureV1,
   FOUNDATION_MODEL,
   FOUNDATION_PROVIDER,
 } from "./runtime.js";
@@ -33,6 +34,11 @@ async function collect(
 }
 
 describe("foundation provider plugin", () => {
+  test("classifies its only pre-stream failure shape as unknown", () => {
+    const failure = classifyFoundationFailureV1(new Error("local failure"));
+    expect(failure.classification).toBe("unknown");
+    expect(failure.providerReason).toBe("local failure");
+  });
   test("registers deterministic provider behavior for its fiber lifetime", async () => {
     const harness = await createPluginHarness([LlmRegistry]);
     const fiber = await harness.mount(foundationProviderPlugin);

package/src/runtime.ts

@@ -1,6 +1,7 @@
 import {
   type LlmProvider,
   type LlmStreamEvent,
+  ModelProviderFailureError,
 } from "@frockbot/kernel-contracts";
 import type { Plugin } from "cordis";
 
@@ -73,9 +74,40 @@ async function foundationReconciliation(
   return events;
 }
 
+/** Foundation has no remote status surface; an unexpected pre-stream fault is unknown. */
+export function classifyFoundationFailureV1(
+  error: unknown,
+): ModelProviderFailureError {
+  return error instanceof ModelProviderFailureError
+    ? error
+    : new ModelProviderFailureError({
+        classification: "unknown",
+        reason:
+          error instanceof Error
+            ? error.message
+            : "Foundation model failed before replying",
+      });
+}
+
+async function* classifiedFoundationStream(
+  request: Parameters<LlmProvider["stream"]>[0],
+  signal: AbortSignal,
+): AsyncGenerator<LlmStreamEvent> {
+  let started = false;
+  try {
+    for await (const event of foundationStream(request, signal)) {
+      started = true;
+      yield event;
+    }
+  } catch (error) {
+    if (started || signal.aborted) throw error;
+    throw classifyFoundationFailureV1(error);
+  }
+}
+
 export const foundationProvider: LlmProvider = {
   id: FOUNDATION_PROVIDER,
-  stream: foundationStream,
+  stream: classifiedFoundationStream,
   reconciliation: {
     retrieve: async (effect, signal) =>
       ({