@frockbot/plugin-provider-foundation 0.0.0 → 0.1.1

package/frockbot.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 2,
+  "id": "provider-foundation",
+  "displayName": "Foundation Provider",
+  "version": "0.0.1",
+  "compatibility": {
+    "frockbot": ">=0.0.1"
+  },
+  "contributions": {
+    "runtime": {
+      "entry": "./runtime"
+    }
+  },
+  "permissions": []
+}

package/package.json

@@ -1,14 +1,38 @@
 {
   "name": "@frockbot/plugin-provider-foundation",
-  "version": "0.0.0",
-  "description": "Placeholder reserving this name for trusted publishing. Superseded by the first release.",
-  "license": "UNLICENSED",
+  "version": "0.1.1",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./runtime": "./src/runtime.ts",
+    "./manifest": "./src/manifest.ts",
+    "./frockbot.json": "./frockbot.json",
+    "./package.json": "./package.json"
+  },
+  "frockbot": {
+    "manifest": "./frockbot.json"
+  },
+  "scripts": {
+    "test": "bun test src",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "dependencies": {
+    "@frockbot/kernel-contracts": "0.1.1",
+    "@frockbot/plugin-models": "0.1.1",
+    "cordis": "4.0.0-rc.8"
+  },
+  "devDependencies": {
+    "@frockbot/plugin-testkit": "0.1.1",
+    "@types/bun": "1.4.0",
+    "typescript": "^7.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/timoconnellaus/frockbot.git",
     "directory": "packages/plugin-provider-foundation"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./runtime.js";
+export { default as foundationProviderManifest } from "./manifest.js";

package/src/manifest.ts

@@ -0,0 +1,3 @@
+import manifest from "../frockbot.json" with { type: "json" };
+
+export default manifest;

package/src/runtime.test.ts

@@ -0,0 +1,67 @@
+import { describe, expect, test } from "bun:test";
+import {
+  type LlmStreamEvent,
+  type NormalizedModelRequest,
+} from "@frockbot/kernel-contracts";
+import { LlmRegistry } from "@frockbot/plugin-models";
+import {
+  createPluginHarness,
+  verifyPluginPackage,
+} from "@frockbot/plugin-testkit";
+import manifest from "../frockbot.json" with { type: "json" };
+import packageJson from "../package.json" with { type: "json" };
+import foundationProviderPlugin, {
+  FOUNDATION_MODEL,
+  FOUNDATION_PROVIDER,
+} from "./runtime.js";
+
+const request: NormalizedModelRequest = {
+  requestId: "request",
+  provider: FOUNDATION_PROVIDER,
+  model: FOUNDATION_MODEL,
+  system: "",
+  messages: [{ role: "user", content: "hello" }],
+  tools: [],
+};
+
+async function collect(
+  source: AsyncIterable<LlmStreamEvent>,
+): Promise<LlmStreamEvent[]> {
+  const events: LlmStreamEvent[] = [];
+  for await (const event of source) events.push(event);
+  return events;
+}
+
+describe("foundation provider plugin", () => {
+  test("registers deterministic provider behavior for its fiber lifetime", async () => {
+    const harness = await createPluginHarness([LlmRegistry]);
+    const fiber = await harness.mount(foundationProviderPlugin);
+
+    expect(
+      await collect(
+        harness.root.llm.stream(request, new AbortController().signal),
+      ),
+    ).toEqual([
+      { type: "text-delta", text: "Cordis runtime: " },
+      { type: "text-delta", text: "hello" },
+      { type: "finish", reason: "completed" },
+    ]);
+
+    await fiber.dispose();
+    let failure: unknown;
+    try {
+      harness.root.llm.stream(request, new AbortController().signal);
+    } catch (error) {
+      failure = error;
+    }
+    expect(failure).toBeInstanceOf(Error);
+    await harness.dispose();
+  });
+
+  test("satisfies plugin package conventions", () => {
+    expect(verifyPluginPackage({ packageJson, manifest })).toMatchObject({
+      name: "@frockbot/plugin-provider-foundation",
+      contributionKinds: ["runtime"],
+    });
+  });
+});

package/src/runtime.ts

@@ -0,0 +1,61 @@
+import {
+  type LlmProvider,
+  type LlmStreamEvent,
+} from "@frockbot/kernel-contracts";
+import type { Plugin } from "cordis";
+
+export const FOUNDATION_PROVIDER = "foundation";
+export const FOUNDATION_MODEL = "deterministic-v1";
+
+async function* foundationStream(
+  request: Parameters<LlmProvider["stream"]>[0],
+  signal: AbortSignal,
+): AsyncGenerator<LlmStreamEvent> {
+  signal.throwIfAborted();
+  const latest = request.messages.at(-1);
+  if (latest?.role === "tool") {
+    const label = latest.name === "echo" ? "Echo" : latest.name;
+    yield { type: "text-delta", text: `${label}: ` };
+    await Promise.resolve();
+    signal.throwIfAborted();
+    yield { type: "text-delta", text: latest.content };
+    yield { type: "finish", reason: "completed" };
+    return;
+  }
+  const user = request.messages.findLast((message) => message.role === "user");
+  const text = user?.role === "user" ? user.content : "";
+  yield { type: "text-delta", text: "Cordis runtime: " };
+  await Promise.resolve();
+  signal.throwIfAborted();
+  yield { type: "text-delta", text };
+  yield { type: "finish", reason: "completed" };
+}
+
+async function foundationReconciliation(
+  request: Parameters<LlmProvider["stream"]>[0],
+  signal: AbortSignal,
+): Promise<LlmStreamEvent[]> {
+  const events: LlmStreamEvent[] = [];
+  for await (const event of foundationStream(request, signal)) {
+    events.push(event);
+  }
+  return events;
+}
+
+export const foundationProvider: LlmProvider = {
+  id: FOUNDATION_PROVIDER,
+  stream: foundationStream,
+  reconciliation: {
+    retrieve: async (effect, signal) =>
+      ({
+        status: "recovered",
+        events: await foundationReconciliation(effect.request, signal),
+      }) as const,
+  },
+};
+
+export const foundationProviderPlugin: Plugin.Function = (ctx) =>
+  ctx.llm.register(foundationProvider);
+foundationProviderPlugin.inject = ["llm"];
+
+export default foundationProviderPlugin;

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "lib": ["ES2023", "DOM"],
+    "types": ["bun"]
+  },
+  "include": ["src/**/*.ts"]
+}

package/README.md

@@ -1,3 +0,0 @@
-# @frockbot/plugin-provider-foundation
-
-Placeholder reserving this name. See https://github.com/timoconnellaus/frockbot.