@frockbot/plugin-identity 0.0.0 → 0.1.0

package/frockbot.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 2,
+  "id": "identity",
+  "displayName": "FrockBot Identity",
+  "version": "0.0.1",
+  "compatibility": {
+    "frockbot": ">=0.0.1"
+  },
+  "contributions": {
+    "runtime": {
+      "entry": "./agent"
+    }
+  },
+  "permissions": []
+}

package/package.json

@@ -1,14 +1,38 @@
 {
   "name": "@frockbot/plugin-identity",
-  "version": "0.0.0",
-  "description": "Placeholder reserving this name for trusted publishing. Superseded by the first release.",
-  "license": "UNLICENSED",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./agent": "./src/agent.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.0",
+    "@frockbot/plugin-prompt": "0.1.0",
+    "cordis": "4.0.0-rc.8"
+  },
+  "devDependencies": {
+    "@frockbot/plugin-testkit": "0.1.0",
+    "@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-identity"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

package/src/agent.test.ts

@@ -0,0 +1,69 @@
+import { describe, expect, test } from "bun:test";
+import { SystemPromptRegistry } from "@frockbot/plugin-prompt";
+import {
+  createPluginHarness,
+  verifyPluginPackage,
+} from "@frockbot/plugin-testkit";
+import manifest from "../frockbot.json" with { type: "json" };
+import packageJson from "../package.json" with { type: "json" };
+import { createIdentityPlugin, DEFAULT_IDENTITY_TEXT } from "./agent.js";
+
+describe("identity plugin", () => {
+  test("registers and disposes a prompt section", async () => {
+    const harness = await createPluginHarness([SystemPromptRegistry]);
+    const fiber = await harness.mount(createIdentityPlugin());
+
+    expect(
+      await harness.root.systemPrompt.assemble({
+        sessionId: "session",
+        provider: "fixture",
+        model: "fixture",
+        turnType: "chat",
+      }),
+    ).toMatchObject({
+      text: DEFAULT_IDENTITY_TEXT,
+      sections: [{ id: "identity", text: DEFAULT_IDENTITY_TEXT }],
+    });
+
+    await fiber.dispose();
+    expect(
+      await harness.root.systemPrompt.assemble({
+        sessionId: "session",
+        provider: "fixture",
+        model: "fixture",
+        turnType: "chat",
+      }),
+    ).toEqual({ text: "", sections: [] });
+    await harness.dispose();
+  });
+
+  test("supports package-owned identity configuration", async () => {
+    const harness = await createPluginHarness([SystemPromptRegistry]);
+    await harness.mount(
+      createIdentityPlugin({
+        sectionId: "persona",
+        text: "You are a test bot.",
+        order: 50,
+      }),
+    );
+
+    expect(
+      await harness.root.systemPrompt.assemble({
+        sessionId: "session",
+        provider: "fixture",
+        model: "fixture",
+        turnType: "chat",
+      }),
+    ).toMatchObject({
+      sections: [{ id: "persona", text: "You are a test bot." }],
+    });
+    await harness.dispose();
+  });
+
+  test("satisfies plugin package conventions", () => {
+    expect(verifyPluginPackage({ packageJson, manifest })).toMatchObject({
+      name: "@frockbot/plugin-identity",
+      contributionKinds: ["runtime"],
+    });
+  });
+});

package/src/agent.ts

@@ -0,0 +1,37 @@
+import { type PromptSection } from "@frockbot/kernel-contracts";
+import type { Plugin } from "cordis";
+
+// This contribution is runtime-neutral and can mount in Node or Workers.
+export const DEFAULT_IDENTITY_SECTION = "identity";
+export const DEFAULT_IDENTITY_TEXT =
+  "You are FrockBot running on the custom Cordis agent loop.";
+
+export interface IdentityPluginConfig {
+  sectionId?: string;
+  text?: string;
+  order?: number;
+}
+
+export function createIdentityPlugin(
+  config: IdentityPluginConfig = {},
+): Plugin.Function {
+  const sectionId = config.sectionId?.trim() || DEFAULT_IDENTITY_SECTION;
+  const text = config.text?.trim() || DEFAULT_IDENTITY_TEXT;
+  const order = config.order ?? 0;
+  if (!Number.isFinite(order)) {
+    throw new Error("identity section order must be finite");
+  }
+
+  const section: PromptSection = {
+    id: sectionId,
+    order,
+    render: () => text,
+  };
+  const plugin: Plugin.Function = (ctx) => ctx.systemPrompt.register(section);
+  plugin.inject = ["systemPrompt"];
+  return plugin;
+}
+
+const identityPlugin = createIdentityPlugin();
+
+export default identityPlugin;

package/src/index.ts

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

package/src/manifest.ts

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

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-identity
-
-Placeholder reserving this name. See https://github.com/timoconnellaus/frockbot.