@frockbot/plugin-provider-frock-ai 0.0.0 → 0.3.13

package/frockbot.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": 4,
+  "id": "provider-flock-ai",
+  "displayName": "Frock AI",
+  "version": "0.0.1",
+  "compatibility": { "frockbot": ">=0.0.1" },
+  "dependencies": { "settings": ">=0.0.1" },
+  "contributions": {
+    "backend": [{ "entry": "./user", "host": "user" }],
+    "runtime": { "entry": "./runtime" }
+  },
+  "permissions": ["connections:manage", "models:invoke"],
+  "configuration": {
+    "connectionTypes": [
+      {
+        "id": "flock-ai-account",
+        "displayName": "Frock AI",
+        "allowMultiple": false,
+        "authorization": { "kind": "ambient-native" },
+        "capabilities": ["flock-ai-models"]
+      }
+    ],
+    "capabilities": [
+      {
+        "id": "flock-ai-models",
+        "kind": "model",
+        "connectionTypes": ["flock-ai-account"],
+        "admission": {
+          "turnTypes": ["chat", "automation", "subagent"]
+        }
+      }
+    ]
+  }
+}

package/package.json

@@ -1,14 +1,42 @@
 {
   "name": "@frockbot/plugin-provider-frock-ai",
-  "version": "0.0.0",
-  "description": "Placeholder reserving this name for trusted publishing. Superseded by the first release.",
-  "license": "UNLICENSED",
+  "version": "0.3.13",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./catalog": "./src/catalog.ts",
+    "./runtime": "./src/runtime.ts",
+    "./user": "./src/user.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/configuration-core": "0.3.13",
+    "@frockbot/connection-core": "0.3.13",
+    "@frockbot/kernel-contracts": "0.3.13",
+    "@frockbot/plugin-models": "0.3.13",
+    "@frockbot/provider-openai-compatible": "0.3.13",
+    "cordis": "4.0.0-rc.8"
+  },
+  "devDependencies": {
+    "@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-frock-ai"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

package/src/catalog.test.ts

@@ -0,0 +1,82 @@
+import { describe, expect, test } from "bun:test";
+import {
+  FROCK_AI_DEFAULT_MODEL,
+  cloudflareModelIdForFrockIdV1,
+  frockAiStaticCatalogV1,
+  frockModelIdForCloudflareIdV1,
+  gatewayModelForFrockIdV1,
+  normalizeFrockModelIdV1,
+} from "./catalog.js";
+
+describe("Frock AI catalog", () => {
+  test("presents Cloudflare ids as Frock AI ids and maps them back", () => {
+    const cloudflareId = "@cf/deepseek-ai/deepseek-v4-flash-0731";
+    const frockId = "@frock/deepseek-ai/deepseek-v4-flash-0731";
+
+    expect(frockModelIdForCloudflareIdV1(cloudflareId)).toBe(frockId);
+    expect(cloudflareModelIdForFrockIdV1(frockId)).toBe(cloudflareId);
+    expect(gatewayModelForFrockIdV1(frockId)).toBe(
+      `workers-ai/${cloudflareId}`,
+    );
+  });
+
+  test("lists Auto first and never exposes a Cloudflare id", () => {
+    const catalog = frockAiStaticCatalogV1();
+
+    expect(catalog.models[0]).toMatchObject({
+      providerModelId: FROCK_AI_DEFAULT_MODEL,
+      displayName: "Auto (recommended)",
+    });
+    expect(
+      catalog.models.every((model) =>
+        model.providerModelId.startsWith("@frock/"),
+      ),
+    ).toBe(true);
+  });
+
+  test("maps Auto to the configured dynamic route", () => {
+    expect(gatewayModelForFrockIdV1(FROCK_AI_DEFAULT_MODEL)).toBe(
+      "dynamic/flock-auto",
+    );
+    expect(
+      gatewayModelForFrockIdV1(FROCK_AI_DEFAULT_MODEL, "production-auto"),
+    ).toBe("dynamic/production-auto");
+  });
+
+  test("rejects ids outside the Frock AI namespace", () => {
+    expect(() => gatewayModelForFrockIdV1("@cf/not/frock")).toThrow(
+      'must start with "@frock/"',
+    );
+    expect(() => cloudflareModelIdForFrockIdV1("not-frock")).toThrow(
+      'must start with "@frock/"',
+    );
+    expect(() => frockModelIdForCloudflareIdV1("@frock/not-cf")).toThrow(
+      'must start with "@cf/"',
+    );
+  });
+
+  test("reads a pre-rename @flock/ id as the @frock/ id it always meant", () => {
+    expect(normalizeFrockModelIdV1("@flock/auto")).toBe(FROCK_AI_DEFAULT_MODEL);
+    expect(
+      normalizeFrockModelIdV1("@flock/deepseek-ai/deepseek-v4-flash-0731"),
+    ).toBe("@frock/deepseek-ai/deepseek-v4-flash-0731");
+    expect(normalizeFrockModelIdV1("@frock/auto")).toBe("@frock/auto");
+    expect(normalizeFrockModelIdV1("gpt-4o")).toBe("gpt-4o");
+  });
+
+  test("resolves a legacy id to the same gateway model as its new spelling", () => {
+    expect(gatewayModelForFrockIdV1("@flock/auto")).toBe(
+      gatewayModelForFrockIdV1(FROCK_AI_DEFAULT_MODEL),
+    );
+    expect(
+      gatewayModelForFrockIdV1("@flock/deepseek-ai/deepseek-v4-flash-0731"),
+    ).toBe(
+      gatewayModelForFrockIdV1("@frock/deepseek-ai/deepseek-v4-flash-0731"),
+    );
+    expect(
+      cloudflareModelIdForFrockIdV1(
+        "@flock/deepseek-ai/deepseek-v4-flash-0731",
+      ),
+    ).toBe("@cf/deepseek-ai/deepseek-v4-flash-0731");
+  });
+});

package/src/catalog.ts

@@ -0,0 +1,112 @@
+import type { ConnectionModelCatalogV1 } from "@frockbot/connection-core";
+
+// The provider is Frock AI. Its *stored* identity strings still read `flock-`:
+// every existing User has them written into their Connection, their installed
+// Package list and their Bots' model bindings, and renaming a stored id is a
+// data migration rather than a rename. They are never shown to a person — the
+// display name and the model ids are, and those moved.
+export const FROCK_AI_PACKAGE_ID = "provider-flock-ai";
+export const FROCK_AI_CONNECTION_TYPE_ID = "flock-ai-account";
+export const FROCK_AI_CAPABILITY_ID = "flock-ai-models";
+export const FROCK_AI_PROVIDER_TYPE = "flock-ai";
+export const FROCK_AI_CONNECTION_ID = "flock-ai-ambient";
+export const FROCK_AI_CONNECTION_GENERATION = "flock-ai-ambient-v1";
+export const FROCK_AI_DEFAULT_MODEL = "@frock/auto";
+/**
+ * The Cloudflare AI Gateway dynamic route. The dashboard resource is still
+ * named `flock-auto`; the value is the resource's name, not ours.
+ */
+export const FROCK_AI_DEFAULT_AUTO_ROUTE = "flock-auto";
+
+/** The pre-rename model-id prefix. Bots bound before the rename still carry it. */
+export const FROCK_AI_LEGACY_MODEL_PREFIX = "@flock/";
+export const FROCK_AI_MODEL_PREFIX = "@frock/";
+
+/**
+ * Read a Frock AI model id, accepting the pre-rename `@flock/` spelling.
+ * Every decode and resolution path runs ids through this, so a Bot bound to
+ * `@flock/auto` behaves exactly as one bound to `@frock/auto`; nothing writes
+ * the legacy prefix back.
+ */
+export function normalizeFrockModelIdV1(id: string): string {
+  return id.startsWith(FROCK_AI_LEGACY_MODEL_PREFIX)
+    ? `${FROCK_AI_MODEL_PREFIX}${id.slice(FROCK_AI_LEGACY_MODEL_PREFIX.length)}`
+    : id;
+}
+
+/** Whether an id names a Frock AI model under either spelling. */
+export function isFrockModelIdV1(id: string): boolean {
+  const normalized = normalizeFrockModelIdV1(id);
+  return (
+    normalized.startsWith(FROCK_AI_MODEL_PREFIX) &&
+    normalized.length > FROCK_AI_MODEL_PREFIX.length
+  );
+}
+
+const CLOUDFLARE_TEXT_MODELS = [
+  {
+    cloudflareModelId: "@cf/deepseek-ai/deepseek-v4-flash-0731",
+    displayName: "DeepSeek V4 Flash",
+    capabilities: { tools: true, vision: false, reasoning: true },
+  },
+] as const;
+
+export function frockModelIdForCloudflareIdV1(id: string): string {
+  if (!id.startsWith("@cf/") || id.length === "@cf/".length) {
+    throw new Error(`Cloudflare model id "${id}" must start with "@cf/"`);
+  }
+  return `@frock/${id.slice("@cf/".length)}`;
+}
+
+export function cloudflareModelIdForFrockIdV1(input: string): string {
+  const id = normalizeFrockModelIdV1(input);
+  if (!isFrockModelIdV1(id)) {
+    throw new Error(`Frock AI model id "${input}" must start with "@frock/"`);
+  }
+  if (id === FROCK_AI_DEFAULT_MODEL) {
+    throw new Error("Frock AI Auto does not name a Cloudflare model");
+  }
+  return `@cf/${id.slice(FROCK_AI_MODEL_PREFIX.length)}`;
+}
+
+export function gatewayModelForFrockIdV1(
+  input: string,
+  autoRoute = FROCK_AI_DEFAULT_AUTO_ROUTE,
+): string {
+  const id = normalizeFrockModelIdV1(input);
+  if (!isFrockModelIdV1(id)) {
+    throw new Error(`Frock AI model id "${input}" must start with "@frock/"`);
+  }
+  if (id === FROCK_AI_DEFAULT_MODEL) {
+    if (!/^[A-Za-z0-9-]+$/.test(autoRoute)) {
+      throw new Error(`Frock AI Auto route "${autoRoute}" is invalid`);
+    }
+    return `dynamic/${autoRoute}`;
+  }
+  return `workers-ai/${cloudflareModelIdForFrockIdV1(id)}`;
+}
+
+const STATIC_CATALOG: ConnectionModelCatalogV1 = {
+  schemaVersion: 1,
+  generation: "flock-ai-static-v1",
+  state: "fresh",
+  models: [
+    {
+      providerModelId: FROCK_AI_DEFAULT_MODEL,
+      displayName: "Auto (recommended)",
+      capabilities: { tools: true, vision: false, reasoning: true },
+      source: "discovered",
+    },
+    ...CLOUDFLARE_TEXT_MODELS.map((model) => ({
+      providerModelId: frockModelIdForCloudflareIdV1(model.cloudflareModelId),
+      displayName: model.displayName,
+      capabilities: model.capabilities,
+      source: "discovered" as const,
+    })),
+  ],
+};
+
+/** A deployment-safe advisory catalog; it requires no account token or REST call. */
+export function frockAiStaticCatalogV1(): ConnectionModelCatalogV1 {
+  return structuredClone(STATIC_CATALOG);
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./catalog.js";
+export * from "./runtime.js";

package/src/manifest.ts

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