@capybara-hq/testing 0.0.0-stage → 0.1.0-rc.1

package/fixtures/extensions/fake-tools-ui/.capybara-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "schemaVersion": 1,
+  "name": "fake-tools-ui",
+  "version": "0.1.0",
+  "publisher": "Capybara",
+  "description": "Test fake: an extension tool with a conversation view, a migration, a skill and a connector template"
+}

package/fixtures/extensions/fake-tools-ui/connectors/fake-notes.json

@@ -0,0 +1,11 @@
+{
+  "displayName": { "zh": "笔记服务", "en": "Notes service" },
+  "description": "A connector template of the fake-tools-ui bundle (fake connector, kind fake)",
+  "template": {
+    "plugin": "fake-connector",
+    "connector": "fake",
+    "endpoint": { "url": "https://notes.example.com/mcp" },
+    "editableEndpoint": ["url"],
+    "auth": { "type": "bearer", "ownership": "org" }
+  }
+}

package/fixtures/extensions/fake-tools-ui/migrations/0001_init.sql

@@ -0,0 +1,7 @@
+-- Runs with search_path "plugin_fake_tools_ui, public": table names carry no schema prefix.
+-- One item list per conversation (replaced as a whole on every write).
+CREATE TABLE IF NOT EXISTS items (
+  conversation_id text PRIMARY KEY,
+  items jsonb NOT NULL,
+  updated_at timestamptz NOT NULL DEFAULT now()
+);

package/fixtures/extensions/fake-tools-ui/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@capybara-hq/test-plugin-fake-tools-ui",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Test fake: an extension tool with a conversation view, a migration, a skill and a connector template",
+  "license": "Apache-2.0",
+  "type": "module",
+  "dependencies": {
+    "@capybara-hq/plugin-sdk": "^0.1.0-rc.0",
+    "zod": "^4.6.7"
+  }
+}

package/fixtures/extensions/fake-tools-ui/skills/fake-notes/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: fake-notes
+description: Keep a short item list for the conversation with the fake-tools-ui write tool. Test fixture only.
+---
+# fake-notes
+
+Call `fake-tools-ui__write` with every item of the list.

package/fixtures/extensions/fake-tools-ui/src/index.ts

@@ -0,0 +1,140 @@
+import {
+  defineExtension,
+  type ExtensionContext,
+  ToolError,
+  type ToolSpec,
+  type UiView,
+} from "@capybara-hq/plugin-sdk";
+import { z } from "zod";
+
+/**
+ * Test fake of a tool + UI extension: the kernel contracts an extension tool, a schema-rendered
+ * view, a migration and a full plugin bundle exercise, without the official todo plugin. Like todo
+ * it needs no object store (storage is `fake-storage-user`'s).
+ * - tool `write` (model-visible `fake-tools-ui__write`, default policy allow): replaces the
+ *   conversation's item list in the extension's own table, then invalidates the view `tasks`;
+ * - view `tasks` (conversation tab): badge `<done>/<total>` and a checklist;
+ * - the plugin also ships the skill `fake-notes` and the connector template `fake-notes`
+ *   (for the `fake-connector` extension).
+ */
+
+type Db = ExtensionContext["db"];
+
+const Item = z.object({
+  text: z.string().min(1),
+  status: z.enum(["pending", "in_progress", "completed"]),
+});
+const WriteInput = z.object({ items: z.array(Item).max(100) });
+
+/** One item of the list. */
+export type FakeItem = z.infer<typeof Item>;
+
+const WRITE: ToolSpec = {
+  name: "write",
+  description:
+    "Replace the item list of the current conversation. Send every item each time; status is " +
+    "pending, in_progress or completed. Test fixture only.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      items: {
+        type: "array",
+        maxItems: 100,
+        description: "The complete list, in order.",
+        items: {
+          type: "object",
+          properties: {
+            text: { type: "string", minLength: 1, description: "What the item is." },
+            status: {
+              type: "string",
+              enum: ["pending", "in_progress", "completed"],
+              description: "Progress of the item.",
+            },
+          },
+          required: ["text", "status"],
+          additionalProperties: false,
+        },
+      },
+    },
+    required: ["items"],
+    additionalProperties: false,
+  },
+  defaultPolicy: "allow",
+};
+
+const render = (items: FakeItem[]): string =>
+  items.length === 0
+    ? "The list is now empty."
+    : `List updated (${items.length} items):\n${items.map((i) => `[${i.status}] ${i.text}`).join("\n")}`;
+
+async function writeItems(db: Db, conversationId: string, items: FakeItem[]): Promise<void> {
+  await db
+    .insertInto("items")
+    .values({ conversation_id: conversationId, items: JSON.stringify(items) })
+    .onConflict((oc) =>
+      oc.column("conversation_id").doUpdateSet((eb) => ({
+        items: eb.ref("excluded.items"),
+        updated_at: new Date(),
+      })),
+    )
+    .execute();
+}
+
+async function readItems(db: Db, conversationId: string): Promise<FakeItem[]> {
+  const row = await db
+    .selectFrom("items")
+    .select("items")
+    .where("conversation_id", "=", conversationId)
+    .executeTakeFirst();
+  return row === undefined ? [] : (row.items as FakeItem[]);
+}
+
+/** The `tasks` view of a list. */
+export function tasksView(items: FakeItem[]): UiView {
+  const done = items.filter((i) => i.status === "completed").length;
+  return {
+    badge: `${done}/${items.length}`,
+    blocks: [{ type: "checklist", items: items.map((i) => ({ text: i.text, status: i.status })) }],
+  };
+}
+
+export default defineExtension({
+  name: "fake-tools-ui",
+  version: "0.1.0",
+  sdk: "^0.1.0-rc.0",
+  provides: [],
+  migrations: "../migrations",
+  ui: [{ id: "tasks", title: { zh: "条目", en: "Items" }, place: "conversation", kind: "view" }],
+  permissions: { tools: ["write"], ui: { views: ["tasks"] } },
+  setup(ctx) {
+    ctx.tools.register(WRITE, async (input, tctx) => {
+      const parsed = WriteInput.safeParse(input);
+      if (!parsed.success) {
+        throw new ToolError(
+          "Invalid items: pass an array of { text, status } where status is pending, in_progress or completed.",
+        );
+      }
+      const items = parsed.data.items;
+      await writeItems(ctx.db, tctx.conversationId, items);
+      await ctx.ui
+        .invalidate({
+          orgId: tctx.orgId,
+          conversationId: tctx.conversationId,
+          contribution: "tasks",
+        })
+        .catch(() => {});
+      return {
+        content: [{ type: "text", text: render(items) }],
+        display: {
+          summary: {
+            zh: `更新条目（${items.length} 项）`,
+            en: `Updated items (${items.length})`,
+          },
+        },
+      };
+    });
+    ctx.ui.view("tasks", async ({ conversationId }) =>
+      tasksView(conversationId === undefined ? [] : await readItems(ctx.db, conversationId)),
+    );
+  },
+});

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@capybara-hq/testing",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-rc.1",
+  "description": "Test helpers for Capybara: test containers, dual-replica harness and fake third-party servers",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/capybara-hq/core.git",
+    "directory": "packages/testing"
+  },
+  "homepage": "https://github.com/capybara-hq/core/tree/main/packages/testing#readme",
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./global-setup": {
+      "types": "./dist/global-setup.d.ts",
+      "import": "./dist/global-setup.js",
+      "default": "./dist/global-setup.js"
+    }
+  },
+  "files": [
+    "dist",
+    "fixtures",
+    "README.md",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.1154.0",
+    "@aws-sdk/s3-presigned-post": "^3.1154.0",
+    "@aws-sdk/s3-request-presigner": "^3.1154.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "@testcontainers/postgresql": "^12.2.1",
+    "ioredis": "^6.0.0",
+    "kysely": "^0.29.6",
+    "pg": "^8.23.1",
+    "protobufjs": "^7.5.4",
+    "testcontainers": "^12.2.1",
+    "tsx": "^4.23.15",
+    "ws": "^8.22.0",
+    "zod": "^4.6.7",
+    "@capybara-hq/kernel": "^0.1.0-rc.0"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.23.1",
+    "@types/ws": "^8.18.2",
+    "@capybara-hq/plugin-sdk": "^0.1.0-rc.0"
+  },
+  "peerDependencies": {
+    "vitest": "^5.0.5",
+    "@capybara-hq/plugin-sdk": "^0.1.0-rc.0",
+    "@capybara-hq/plugin-tools": "^0.1.0-rc.1"
+  },
+  "peerDependenciesMeta": {
+    "@capybara-hq/plugin-tools": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
 }