tiptap-apcore 0.2.1 → 0.3.0

package/README.md

@@ -1,9 +1,12 @@
 # tiptap-apcore
 
-Let AI safely control your TipTap editor via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) and OpenAI Function Calling.
+> Let AI safely control your TipTap editor via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) and OpenAI Function Calling.
 
 **tiptap-apcore** wraps every TipTap editor command as a schema-driven [APCore](https://github.com/aipartnerup) module — complete with JSON Schema validation, safety annotations, and fine-grained access control. Any MCP-compatible AI agent can then discover and invoke these modules to read, format, insert, or restructure rich-text content.
 
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
+[![TipTap](https://img.shields.io/badge/TipTap-v2-green.svg)](https://tiptap.dev)
+
 ## Features
 
 - **79 built-in commands** across 7 categories (query, format, content, destructive, selection, history, unknown)
@@ -13,8 +16,9 @@ Let AI safely control your TipTap editor via the [Model Context Protocol (MCP)](
 - **Role-based ACL** — `readonly`, `editor`, `admin` roles with tag-level and module-level overrides
 - **Safety annotations** — every command tagged `readonly`, `destructive`, `idempotent`, `requiresApproval`, `openWorld`, `streaming`
 - **Strict JSON Schemas** — `inputSchema` + `outputSchema` with `additionalProperties: false` for all known commands
-- **Dynamic re-discovery** — call `registry.discover()` to pick up extensions added at runtime
-- **925 tests**, 99.7% statement coverage
+- **Dynamic re-discovery** — call `apcore.refresh()` or `registry.discover()` to pick up extensions added at runtime
+- **Dynamic ACL** — call `apcore.setAcl()` to switch roles without recreating the instance
+- **Framework agnostic** — works with React, Vue, Angular, or Vanilla JS
 
 ## Installation
 
@@ -26,10 +30,12 @@ npm install tiptap-apcore apcore-js apcore-mcp @tiptap/core
 
 ## Quick Start
 
+### Using `TiptapAPCore` class (recommended)
+
 ```typescript
 import { Editor } from "@tiptap/core";
 import StarterKit from "@tiptap/starter-kit";
-import { withApcore, serve, toOpenaiTools } from "tiptap-apcore";
+import { TiptapAPCore } from "tiptap-apcore";
 
 // 1. Create a TipTap editor
 const editor = new Editor({
@@ -37,22 +43,41 @@ const editor = new Editor({
   content: "<p>Hello world</p>",
 });
 
-// 2. Create APCore registry + executor
-const { registry, executor } = withApcore(editor, {
+// 2. Create the APCore instance
+const apcore = new TiptapAPCore(editor, {
   acl: { role: "editor" },   // no destructive ops
 });
 
-// 3a. Launch an MCP Server (stdio)
-await serve(executor);
+// 3. Call commands directly
+await apcore.call("tiptap.format.toggleBold", {});
+const { html } = await apcore.call("tiptap.query.getHTML", {});
 
-// 3b. Or export OpenAI tool definitions
-const tools = toOpenaiTools(executor);
+// 4. Switch roles at runtime (e.g. when user toggles admin mode)
+apcore.setAcl({ role: "admin" });
+
+// 5. Launch an MCP Server (Node.js only — import from tiptap-apcore/server)
+import { serve } from "tiptap-apcore/server";
+await serve(apcore.executor);
+
+// 6. Or export OpenAI tool definitions
+import { toOpenaiTools } from "tiptap-apcore/server";
+const tools = toOpenaiTools(apcore.executor);
+```
+
+### Using `withApcore` factory (shortcut)
+
+```typescript
+import { withApcore } from "tiptap-apcore";
+
+const { registry, executor } = withApcore(editor, {
+  acl: { role: "editor" },
+});
 
-// 3c. Or call commands directly
 await executor.call("tiptap.format.toggleBold", {});
-const { html } = await executor.call("tiptap.query.getHTML", {});
 ```
 
+`withApcore` returns a `{ registry, executor }` pair. Use it when you don't need dynamic ACL updates or the convenience methods on `TiptapAPCore`.
+
 ## Commands
 
 All commands follow the module ID pattern `{prefix}.{category}.{commandName}`.
@@ -100,24 +125,27 @@ Commands discovered from extensions but not in the built-in catalog. Excluded by
 
 ```typescript
 // Read-only: only query commands
-withApcore(editor, { acl: { role: "readonly" } });
+new TiptapAPCore(editor, { acl: { role: "readonly" } });
 
 // Editor: query + format + content + history + selection
-withApcore(editor, { acl: { role: "editor" } });
+new TiptapAPCore(editor, { acl: { role: "editor" } });
 
 // Admin: everything including destructive
-withApcore(editor, { acl: { role: "admin" } });
+new TiptapAPCore(editor, { acl: { role: "admin" } });
 
 // Custom: readonly base + allow format tag
-withApcore(editor, { acl: { role: "readonly", allowTags: ["format"] } });
+new TiptapAPCore(editor, { acl: { role: "readonly", allowTags: ["format"] } });
 
 // Custom: admin but deny destructive tag
-withApcore(editor, { acl: { role: "admin", denyTags: ["destructive"] } });
+new TiptapAPCore(editor, { acl: { role: "admin", denyTags: ["destructive"] } });
 
 // Module-level: deny specific commands
-withApcore(editor, {
+new TiptapAPCore(editor, {
   acl: { role: "admin", denyModules: ["tiptap.destructive.clearContent"] },
 });
+
+// Dynamic: switch roles at runtime
+apcore.setAcl({ role: "admin" });
 ```
 
 **Precedence:** `denyModules` > `allowModules` > `denyTags` > `allowTags` > role
@@ -126,32 +154,80 @@ withApcore(editor, {
 
 ## MCP Server
 
+Server functions must be imported from the `tiptap-apcore/server` subpath (Node.js only).
+
 ```typescript
-import { withApcore, serve } from "tiptap-apcore";
+import { TiptapAPCore } from "tiptap-apcore";
+import { serve } from "tiptap-apcore/server";
 
-const { executor } = withApcore(editor);
+const apcore = new TiptapAPCore(editor);
 
 // stdio (default)
-await serve(executor);
+await serve(apcore.executor);
 
 // HTTP streaming
-await serve(executor, {
+await serve(apcore.executor, {
   transport: "streamable-http",
   host: "127.0.0.1",
   port: 8000,
 });
 
 // Server-Sent Events
-await serve(executor, { transport: "sse", port: 3000 });
+await serve(apcore.executor, { transport: "sse", port: 3000 });
+```
+
+### Embedding in Express / Koa / Fastify (`asyncServe`)
+
+`asyncServe` returns a Node.js HTTP request handler that you can mount in any existing server — no separate process needed.
+
+```typescript
+import express from "express";
+import { TiptapAPCore } from "tiptap-apcore";
+import { asyncServe } from "tiptap-apcore/server";
+
+const app = express();
+const apcore = new TiptapAPCore(editor, { acl: { role: "admin" } });
+
+// Create the MCP handler with the built-in Tool Explorer UI
+const { handler, close } = await asyncServe(apcore.executor, {
+  endpoint: "/mcp",           // MCP protocol endpoint
+  explorer: true,             // Enable /explorer UI for interactive testing
+  explorerPrefix: "/explorer",
+  allowExecute: true,         // Allow tool execution from the explorer
+  name: "my-editor-mcp",
+});
+
+// Mount alongside your existing routes
+app.all("/mcp", (req, res) => handler(req, res));
+app.all("/explorer", (req, res) => handler(req, res));
+app.all("/explorer/*", (req, res) => handler(req, res));
+
+app.listen(8000);
+
+// On shutdown:
+await close();
+```
+
+MCP clients (Claude Desktop, Cursor, etc.) can then connect to your server:
+
+```json
+{
+  "mcpServers": {
+    "my-editor": {
+      "url": "http://localhost:8000/mcp"
+    }
+  }
+}
 ```
 
 ## OpenAI Function Calling
 
 ```typescript
-import { withApcore, toOpenaiTools } from "tiptap-apcore";
+import { TiptapAPCore } from "tiptap-apcore";
+import { toOpenaiTools } from "tiptap-apcore/server";
 
-const { executor } = withApcore(editor);
-const tools = toOpenaiTools(executor);
+const apcore = new TiptapAPCore(editor);
+const tools = toOpenaiTools(apcore.executor);
 
 // Use with OpenAI API
 const response = await openai.chat.completions.create({
@@ -168,18 +244,18 @@ APCore's JSON schemas work directly with AI SDK's `jsonSchema()` — no Zod conv
 ```typescript
 import { generateText, tool, jsonSchema } from "ai";
 import { openai } from "@ai-sdk/openai";
-import { withApcore } from "tiptap-apcore";
+import { TiptapAPCore } from "tiptap-apcore";
 
-const { registry, executor } = withApcore(editor, { acl: { role: "editor" } });
+const apcore = new TiptapAPCore(editor, { acl: { role: "editor" } });
 
 // Convert APCore modules to AI SDK tools
 const tools: Record<string, CoreTool> = {};
-for (const id of registry.list()) {
-  const def = registry.getDefinition(id)!;
-  tools[id.replaceAll(".", "-")] = tool({
+for (const id of apcore.list()) {
+  const def = apcore.getDefinition(id)!;
+  tools[id.replaceAll(".", "--")] = tool({
     description: def.description,
     parameters: jsonSchema(def.inputSchema),
-    execute: (args) => executor.call(id, args),
+    execute: (args) => apcore.call(id, args),
   });
 }
 
@@ -194,15 +270,35 @@ const { text, steps } = await generateText({
 
 ## API Reference
 
-### `withApcore(editor, options?)`
+### `TiptapAPCore` class
 
-Creates an APCore `{ registry, executor }` pair from a TipTap editor.
+The primary entry point. Encapsulates registry, executor, ACL, and extension discovery.
+
+```typescript
+const apcore = new TiptapAPCore(editor, options?);
+```
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `prefix` | `string` | `"tiptap"` | Module ID prefix (lowercase alphanumeric) |
 | `acl` | `AclConfig` | `undefined` | Access control configuration (permissive if omitted) |
 | `includeUnsafe` | `boolean` | `false` | Include commands not in the built-in catalog |
+| `logger` | `Logger` | `undefined` | Logger for diagnostic output |
+| `sanitizeHtml` | `(html: string) => string` | `undefined` | HTML sanitizer for insertContent/setContent |
+
+| Method / Property | Description |
+|-------------------|-------------|
+| `registry` | The APCore Registry (read-only) |
+| `executor` | The APCore Executor (read-only) |
+| `call(moduleId, inputs)` | Execute a command (async) |
+| `list(options?)` | List module IDs, optionally filtered by `tags` and/or `prefix` |
+| `getDefinition(moduleId)` | Get full `ModuleDescriptor` or `null` |
+| `setAcl(acl)` | Update ACL configuration at runtime (validates role) |
+| `refresh()` | Re-scan extensions and update registry; returns module count |
+
+### `withApcore(editor, options?)`
+
+Factory function that creates a `TiptapAPCore` instance and returns `{ registry, executor }`. Accepts the same options as `TiptapAPCore`.
 
 ### Registry Methods
 
@@ -223,9 +319,24 @@ Creates an APCore `{ registry, executor }` pair from a TipTap editor.
 |--------|-------------|
 | `call(moduleId, inputs)` | Execute a module (async) |
 | `callAsync(moduleId, inputs)` | Alias for `call()` |
+| `registry` | Access the underlying registry |
 
 ### Error Codes
 
+All errors are instances of `TiptapModuleError` (extends `Error`).
+
+```typescript
+import { TiptapModuleError, ErrorCodes } from "tiptap-apcore";
+
+try {
+  await apcore.call("tiptap.format.toggleBold", {});
+} catch (err) {
+  if (err instanceof TiptapModuleError) {
+    console.log(err.code, err.message, err.details);
+  }
+}
+```
+
 | Code | Description |
 |------|-------------|
 | `MODULE_NOT_FOUND` | Module ID not registered |
@@ -236,96 +347,56 @@ Creates an APCore `{ registry, executor }` pair from a TipTap editor.
 | `SCHEMA_VALIDATION_ERROR` | Invalid options (bad prefix, bad role) |
 | `INTERNAL_ERROR` | Unexpected error |
 
-## Comparison with TipTap AI Toolkit
-
-TipTap's official AI solution is the **[AI Toolkit](https://tiptap.dev/docs/ai-toolkit/getting-started/overview)** (`@tiptap-pro/ai-toolkit`), a paid extension for client-side AI-powered editing. The two projects serve different use cases and are complementary.
-
-### Architecture
-
-| | TipTap AI Toolkit | tiptap-apcore |
-|---|---|---|
-| **Type** | Client-side TipTap extension | Server-side / headless adapter |
-| **License** | Proprietary (TipTap Pro subscription) | Apache-2.0 (open source) |
-| **Runtime** | Browser only | Browser + Node.js + headless |
-| **Protocol** | Provider-specific adapters | MCP standard + OpenAI Function Calling |
-| **Approach** | AI generates content, streams into editor | AI invokes structured commands on editor |
-
-### Command Granularity
-
-| | TipTap AI Toolkit | tiptap-apcore |
-|---|---|---|
-| **Tools exposed** | 5 coarse tools | 79+ fine-grained commands |
-| **Read** | `tiptapRead`, `tiptapReadSelection` | `getHTML`, `getJSON`, `getText`, `isActive`, `getAttributes`, `isEmpty`, `isEditable`, `isFocused`, `getCharacterCount`, `getWordCount` |
-| **Write** | `tiptapEdit` (accepts operations array) | Individual commands: `toggleBold`, `insertContent`, `setNode`, `wrapIn`, ... |
-| **Comments** | `getThreads`, `editThreads` | Not supported |
-| **Schemas** | Tool parameters with descriptions | Strict JSON Schema per command (`additionalProperties: false`) |
-
-The AI Toolkit bundles all editing into a single `tiptapEdit` tool that accepts an array of operations. tiptap-apcore exposes each operation as a standalone tool with its own schema — this gives the LLM more precise tool selection and lower token usage per call.
-
-### Security
+### Server Exports (`tiptap-apcore/server`)
 
-| | TipTap AI Toolkit | tiptap-apcore |
-|---|---|---|
-| **Access control** | None built-in | 3 roles + tag/module allow/deny lists |
-| **Safety annotations** | None | `readonly`, `destructive`, `idempotent`, `requiresApproval`, `openWorld`, `streaming` per command |
-| **Approval workflow** | Review mode (accept/reject UI) | `requiresApproval` annotation for MCP clients |
-| **Input validation** | Basic parameter types | Strict JSON Schema with `additionalProperties: false` |
+| Function | Description |
+|----------|-------------|
+| `serve(executor, options?)` | Launch an MCP server (stdio / streamable-http / sse) |
+| `asyncServe(executor, options?)` | Build an embeddable HTTP handler — returns `{ handler, close }` |
+| `toOpenaiTools(executor, options?)` | Export OpenAI Function Calling tool definitions |
+| `resolveRegistry(executor)` | Access the registry from an executor |
+| `resolveExecutor(registry)` | Create an executor from a registry |
 
-### Protocol Support
+#### `asyncServe` Options
 
-| | TipTap AI Toolkit | tiptap-apcore |
-|---|---|---|
-| **MCP** | Not supported | stdio, streamable-http, SSE |
-| **OpenAI** | Via adapter (`@tiptap-pro/ai-adapter-openai`) | `toOpenaiTools()` one-liner |
-| **Anthropic** | Via adapter (`@tiptap-pro/ai-adapter-anthropic`) | Via MCP (any MCP client) |
-| **Vercel AI SDK** | Via adapter | Direct (`generateText` + `tool` + `jsonSchema`) or via MCP |
-| **Custom agents** | Adapter required per provider | Any MCP-compatible agent works |
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `name` | `string` | `"apcore-mcp"` | MCP server name |
+| `endpoint` | `string` | `"/mcp"` | MCP protocol endpoint path |
+| `explorer` | `boolean` | `false` | Enable the browser-based Tool Explorer UI |
+| `explorerPrefix` | `string` | `"/explorer"` | URL prefix for the explorer |
+| `allowExecute` | `boolean` | `false` | Allow tool execution from the explorer UI |
+| `validateInputs` | `boolean` | `false` | Validate inputs against JSON schemas |
+| `tags` | `string[]` | `null` | Filter modules by tags |
+| `prefix` | `string` | `null` | Filter modules by prefix |
 
-### AI Content Generation
+`asyncServe` returns `{ handler, close }` where `handler` is `(IncomingMessage, ServerResponse) => Promise<void>`.
 
-| | TipTap AI Toolkit | tiptap-apcore |
-|---|---|---|
-| **Streaming output** | `streamText()`, `streamHtml()` | Not yet supported |
-| **Review mode** | Accept / Reject UI | Not supported (planned) |
-| **Content generation** | Built-in (prompts → editor) | Delegated to LLM (tool use → commands) |
+## Architecture
 
-The AI Toolkit streams LLM-generated content directly into the editor with a review UI. tiptap-apcore takes a different approach: the LLM decides *which commands* to call, and the executor applies them. Content generation is the LLM's responsibility, not the editor's.
+```
+┌──────────────────┐     ┌──────────────────┐     ┌──────────────┐
+│  TipTap Editor   │────▶│  tiptap-apcore   │────▶│  apcore-mcp  │
+│  (@tiptap/core)  │     │  (this package)  │     │  (protocol)  │
+└──────────────────┘     └──────────────────┘     └──────────────┘
+                          Registry + Executor       MCP / OpenAI
+```
 
-### Server-Side & Headless
+**tiptap-apcore provides:**
+- Extension discovery (`ExtensionScanner`)
+- Module building (`ModuleBuilder` + `AnnotationCatalog` + `SchemaCatalog`)
+- Command execution (`TiptapExecutor`)
+- Access control (`AclGuard`)
 
-| | TipTap AI Toolkit | tiptap-apcore |
-|---|---|---|
-| **Headless mode** | Not supported | Full support |
-| **Batch processing** | Not possible | Process multiple documents programmatically |
-| **CI/CD pipelines** | Not applicable | Can validate, transform, or test content |
-| **Multi-tenant** | One editor per user | One executor per editor, server-side isolation |
-
-### When to Use Which
-
-**Use TipTap AI Toolkit when:**
-- You need real-time streaming of AI-generated content into the editor
-- You want a built-in accept/reject review UI
-- You're building a client-side-only application
-- You need comment thread management with AI
-
-**Use tiptap-apcore when:**
-- You want any MCP-compatible agent to control the editor
-- You need fine-grained access control (roles, tag/module blocking)
-- You're running headless / server-side (batch processing, CI/CD)
-- You want strict schema validation and safety annotations
-- You need to support multiple AI providers without per-provider adapters
-- You want open-source with no licensing fees
-
-**Use both when:**
-- You want streaming AI content generation (AI Toolkit) AND structured command control (tiptap-apcore) in the same application
-- You want client-side AI chat + server-side AI automation on the same editor
+**apcore-mcp provides:**
+- `serve(executor)` — Launch an MCP server (stdio / HTTP / SSE)
+- `toOpenaiTools(executor)` — Export OpenAI Function Calling tool definitions
+- Types and constants for the APCore protocol
 
 ## AI Capabilities
 
 ### Supported (79 commands)
 
-tiptap-apcore exposes 79 built-in commands that an AI agent can invoke:
-
 | Category | Count | Commands |
 |----------|-------|----------|
 | **Query** | 10 | `getHTML`, `getJSON`, `getText`, `isActive`, `getAttributes`, `isEmpty`, `isEditable`, `isFocused`, `getCharacterCount`, `getWordCount` |
@@ -348,58 +419,66 @@ The `selectText` command enables semantic text selection — the AI can select t
 | Streaming content generation | Content generation is delegated to the LLM; the executor applies discrete commands |
 | Comment threads | Not part of core TipTap — requires `@tiptap-pro` extensions |
 
-## Architecture
+## Comparison with TipTap AI Toolkit
 
-### tiptap-apcore vs apcore-mcp
+TipTap's official AI solution is the **[AI Toolkit](https://tiptap.dev/docs/ai-toolkit/getting-started/overview)** (`@tiptap-pro/ai-toolkit`), a paid extension for client-side AI-powered editing. The two projects serve different use cases and are complementary.
 
-**tiptap-apcore** is the TipTap adapter that wraps editor commands as APCore modules. **apcore-mcp** is the protocol layer that exposes those modules to AI agents via MCP or OpenAI Function Calling.
+| | TipTap AI Toolkit | tiptap-apcore |
+|---|---|---|
+| **Type** | Client-side TipTap extension | Server-side / headless adapter |
+| **License** | Proprietary (TipTap Pro subscription) | Apache-2.0 (open source) |
+| **Runtime** | Browser only | Browser + Node.js + headless |
+| **Protocol** | Provider-specific adapters | MCP standard + OpenAI Function Calling |
+| **Tools exposed** | 5 coarse tools | 79+ fine-grained commands |
+| **Access control** | None built-in | 3 roles + tag/module allow/deny lists |
+| **Safety annotations** | None | `readonly`, `destructive`, `idempotent`, `requiresApproval` per command |
+| **Streaming output** | `streamText()`, `streamHtml()` | Not yet supported |
+| **Headless mode** | Not supported | Full support |
 
-```
-┌──────────────────┐     ┌──────────────────┐     ┌──────────────┐
-│  TipTap Editor   │────▶│  tiptap-apcore   │────▶│  apcore-mcp  │
-│  (@tiptap/core)  │     │  (this package)  │     │  (protocol)  │
-└──────────────────┘     └──────────────────┘     └──────────────┘
-                          Registry + Executor       MCP / OpenAI
-```
+**Use TipTap AI Toolkit when** you need real-time streaming of AI-generated content with a built-in accept/reject review UI.
 
-**tiptap-apcore provides:**
-- Extension discovery (`ExtensionScanner`)
-- Module building (`ModuleBuilder` + `AnnotationCatalog` + `SchemaCatalog`)
-- Command execution (`TiptapExecutor`)
-- Access control (`AclGuard`)
+**Use tiptap-apcore when** you want any MCP-compatible agent to control the editor with fine-grained access control, strict schema validation, and headless/server-side support.
 
-**apcore-mcp provides:**
-- `serve(executor)` — Launch an MCP server (stdio / HTTP / SSE)
-- `toOpenaiTools(executor)` — Export OpenAI Function Calling tool definitions
-- `resolveRegistry(executor)` — Access the registry from an executor
-- `resolveExecutor(registry)` — Create an executor from a registry
-- Types and constants for the APCore protocol
+**Use both** when you want streaming AI content generation AND structured command control in the same application.
 
 ## Demo
 
-The `demo/` directory contains a full-stack example: a React + Vite frontend with a TipTap editor, and an Express backend that uses the [Vercel AI SDK](https://ai-sdk.dev/) to let any LLM edit the document via APCore tools.
+The `demo/` directory contains a full-stack example with two modes:
 
 ```bash
 cd demo/server && npm install && npm run dev   # Terminal 1
-cd demo && npm install && npm run dev           # Terminal 2
+cd demo/frontend && npm install && npm run dev # Terminal 2
+# Open http://localhost:5173
 ```
 
 Set `LLM_MODEL` (e.g. `openai:gpt-4o`, `anthropic:claude-sonnet-4-5`) in `demo/.env`. See [`demo/README.md`](demo/README.md) for details.
 
-## Development
+### AI Editor Demo tab
 
-```bash
-# Install dependencies
-npm install
+A React + Vite frontend with a TipTap editor and an Express backend that uses the [Vercel AI SDK](https://ai-sdk.dev/) to let any LLM edit the document via APCore tools. Includes role-based ACL switching, demo scenarios, and a tool call log.
+
+### MCP Server tab
+
+A persistent headless TipTap editor exposed as an MCP `streamable-http` endpoint via `asyncServe()`. The tab shows:
+
+- **Status** — live server status, tool count, and endpoint URL
+- **Tool Explorer** — embedded `/explorer` UI for browsing and executing all 79+ tools interactively
+- **Connect** — copy-paste config snippets for Claude Desktop, Cursor, and generic MCP clients
 
-# Run tests
-npm test
+The MCP endpoint is available at `http://localhost:8000/mcp` — connect any MCP client to control the editor remotely.
 
-# Type check
-npm run typecheck
+## Documentation
 
-# Build
-npm run build
+- [Getting Started Guide](docs/GETTING_STARTED.md) — React integration, ACL roles, MCP and AI SDK setup.
+- [Technical Design](docs/tiptap-apcore/tech-design.md) — Architecture, security model, and design decisions.
+
+## Development
+
+```bash
+npm install       # Install dependencies
+npm test          # Run tests
+npm run typecheck # Type check
+npm run build     # Build
 ```
 
 ## License

package/dist/index.d.ts

@@ -9,6 +9,7 @@
  * - toOpenaiTools(registryOrExecutor, options?) - Export OpenAI tool definitions
  */
 export { withApcore } from "./withApcore.js";
+export { TiptapAPCore } from "./runtime/TiptapAPCore.js";
 export type { ApcoreOptions, ApcoreResult, AclConfig, ExtensionCommandInfo, AnnotationEntry, SelectionEffect, SchemaEntry, Logger, EditorLike, ChainLike, Registry, Executor, ModuleDescriptor, ModuleAnnotations, JsonSchema, } from "./types.js";
 export { TiptapModuleError, ErrorCodes } from "./errors/index.js";
 export { TiptapRegistry } from "./runtime/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,WAAW,EACX,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,WAAW,EACX,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -9,6 +9,7 @@
  * - toOpenaiTools(registryOrExecutor, options?) - Export OpenAI tool definitions
  */
 export { withApcore } from "./withApcore.js";
+export { TiptapAPCore } from "./runtime/TiptapAPCore.js";
 export { TiptapModuleError, ErrorCodes } from "./errors/index.js";
 export { TiptapRegistry } from "./runtime/index.js";
 export { TiptapExecutor } from "./runtime/index.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAkB7C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAW/C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAkBzD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAW/C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/runtime/TiptapAPCore.d.ts

@@ -0,0 +1,61 @@
+import type { ApcoreOptions, EditorLike, AclConfig, ModuleDescriptor } from "../types.js";
+import { TiptapRegistry } from "./TiptapRegistry.js";
+import { TiptapExecutor } from "./TiptapExecutor.js";
+/**
+ * TiptapAPCore - Unified entry point for TipTap editor AI control.
+ *
+ * This class encapsulates the registry, executor, and discovery logic,
+ * providing a simplified API for developers.
+ */
+export declare class TiptapAPCore {
+    private _editor;
+    private _options;
+    private _registry;
+    private _executor;
+    private _aclGuard;
+    private _scanner;
+    private _builder;
+    constructor(editor: EditorLike, options?: ApcoreOptions);
+    /** The APCore Registry containing all discovered module definitions */
+    get registry(): TiptapRegistry;
+    /** The APCore Executor for running commands against the editor */
+    get executor(): TiptapExecutor;
+    /**
+     * Execute an editor command via APCore.
+     *
+     * @param moduleId - The module ID (e.g., 'tiptap.format.toggleBold')
+     * @param inputs - Input arguments for the command
+     * @returns The execution result
+     */
+    call(moduleId: string, inputs: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * List available modules in the registry.
+     *
+     * @param options - Optional filters (tags, prefix)
+     * @returns Array of module IDs
+     */
+    list(options?: {
+        tags?: string[];
+        prefix?: string;
+    }): string[];
+    /**
+     * Get the full definition of a module.
+     *
+     * @param moduleId - The module ID to look up
+     * @returns The module descriptor or null if not found
+     */
+    getDefinition(moduleId: string): ModuleDescriptor | null;
+    /**
+     * Update the ACL configuration without recreating the instance.
+     *
+     * @param acl - The new ACL configuration
+     */
+    setAcl(acl: AclConfig): void;
+    /**
+     * Trigger a re-scan of TipTap extensions to update the registry.
+     *
+     * @returns The number of modules discovered
+     */
+    refresh(): number;
+}
+//# sourceMappingURL=TiptapAPCore.d.ts.map

package/dist/runtime/TiptapAPCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiptapAPCore.d.ts","sourceRoot":"","sources":["../../src/runtime/TiptapAPCore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa;IAyDvD,uEAAuE;IACvE,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED,kEAAkE;IAClE,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED;;;;;;OAMG;IACG,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAInC;;;;;OAKG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE;IAI9D;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIxD;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAa5B;;;;OAIG;IACH,OAAO,IAAI,MAAM;CA6BlB"}

package/dist/runtime/TiptapAPCore.js

@@ -0,0 +1,131 @@
+import { ExtensionScanner } from "../discovery/index.js";
+import { ModuleBuilder } from "../builder/index.js";
+import { TiptapRegistry } from "./TiptapRegistry.js";
+import { TiptapExecutor } from "./TiptapExecutor.js";
+import { AclGuard } from "../security/index.js";
+import { TiptapModuleError, ErrorCodes } from "../errors/index.js";
+const PREFIX_PATTERN = /^[a-z][a-z0-9]*$/;
+/**
+ * TiptapAPCore - Unified entry point for TipTap editor AI control.
+ *
+ * This class encapsulates the registry, executor, and discovery logic,
+ * providing a simplified API for developers.
+ */
+export class TiptapAPCore {
+    _editor;
+    _options;
+    _registry;
+    _executor;
+    _aclGuard;
+    _scanner;
+    _builder;
+    constructor(editor, options) {
+        if (editor == null) {
+            throw new TypeError("editor must be a valid TipTap Editor instance");
+        }
+        if (editor.isDestroyed) {
+            throw new TiptapModuleError(ErrorCodes.EDITOR_NOT_READY, "Editor is not ready", { editorDestroyed: true });
+        }
+        this._editor = editor;
+        this._options = { ...options };
+        // Validate options
+        const prefix = this._options.prefix ?? "tiptap";
+        if (!PREFIX_PATTERN.test(prefix)) {
+            throw new TiptapModuleError(ErrorCodes.SCHEMA_VALIDATION_ERROR, `Invalid prefix '${prefix}': must match /^[a-z][a-z0-9]*$/`, { field: "prefix", value: prefix });
+        }
+        const validRoles = ["readonly", "editor", "admin"];
+        if (this._options.acl?.role &&
+            !validRoles.includes(this._options.acl.role)) {
+            throw new TiptapModuleError(ErrorCodes.SCHEMA_VALIDATION_ERROR, `Invalid ACL role '${this._options.acl.role}': must be one of ${validRoles.join(", ")}`, { field: "acl.role", value: this._options.acl.role });
+        }
+        // 1. Initialize components
+        this._scanner = new ExtensionScanner(this._options.logger);
+        this._builder = new ModuleBuilder(prefix);
+        this._registry = new TiptapRegistry();
+        this._aclGuard = new AclGuard(this._options.acl, this._options.logger);
+        this._executor = new TiptapExecutor(editor, this._registry, this._aclGuard, this._options.sanitizeHtml);
+        // 2. Initial discovery
+        this.refresh();
+        // 3. Set up deferred discovery (for SDK compatibility)
+        this._registry.setScanFunction(() => this.refresh());
+    }
+    /** The APCore Registry containing all discovered module definitions */
+    get registry() {
+        return this._registry;
+    }
+    /** The APCore Executor for running commands against the editor */
+    get executor() {
+        return this._executor;
+    }
+    /**
+     * Execute an editor command via APCore.
+     *
+     * @param moduleId - The module ID (e.g., 'tiptap.format.toggleBold')
+     * @param inputs - Input arguments for the command
+     * @returns The execution result
+     */
+    async call(moduleId, inputs) {
+        return this._executor.call(moduleId, inputs);
+    }
+    /**
+     * List available modules in the registry.
+     *
+     * @param options - Optional filters (tags, prefix)
+     * @returns Array of module IDs
+     */
+    list(options) {
+        return this._registry.list(options);
+    }
+    /**
+     * Get the full definition of a module.
+     *
+     * @param moduleId - The module ID to look up
+     * @returns The module descriptor or null if not found
+     */
+    getDefinition(moduleId) {
+        return this._registry.getDefinition(moduleId);
+    }
+    /**
+     * Update the ACL configuration without recreating the instance.
+     *
+     * @param acl - The new ACL configuration
+     */
+    setAcl(acl) {
+        const validRoles = ["readonly", "editor", "admin"];
+        if (acl.role && !validRoles.includes(acl.role)) {
+            throw new TiptapModuleError(ErrorCodes.SCHEMA_VALIDATION_ERROR, `Invalid ACL role '${acl.role}': must be one of ${validRoles.join(", ")}`, { field: "acl.role", value: acl.role });
+        }
+        this._options.acl = acl;
+        this._aclGuard.updateConfig(acl);
+    }
+    /**
+     * Trigger a re-scan of TipTap extensions to update the registry.
+     *
+     * @returns The number of modules discovered
+     */
+    refresh() {
+        const includeUnsafe = this._options.includeUnsafe ?? false;
+        const extensionMap = this._scanner.scan(this._editor);
+        const newIds = new Set();
+        // Register new/updated
+        for (const [, extensionInfo] of extensionMap) {
+            for (const commandName of extensionInfo.commandNames) {
+                const descriptor = this._builder.build(commandName, extensionInfo);
+                // Skip unknown commands if includeUnsafe is false
+                if (!includeUnsafe && descriptor.tags?.includes("unknown")) {
+                    continue;
+                }
+                newIds.add(descriptor.moduleId);
+                this._registry.register(descriptor);
+            }
+        }
+        // Unregister removed
+        for (const oldId of this._registry.list()) {
+            if (!newIds.has(oldId)) {
+                this._registry.unregister(oldId);
+            }
+        }
+        return newIds.size;
+    }
+}
+//# sourceMappingURL=TiptapAPCore.js.map

package/dist/runtime/TiptapAPCore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiptapAPCore.js","sourceRoot":"","sources":["../../src/runtime/TiptapAPCore.ts"],"names":[],"mappings":"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"}

package/dist/runtime/index.d.ts

@@ -1,3 +1,4 @@
+export { TiptapAPCore } from "./TiptapAPCore.js";
 export { TiptapRegistry } from "./TiptapRegistry.js";
 export { TiptapExecutor } from "./TiptapExecutor.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/runtime/index.js

@@ -1,4 +1,5 @@
-// Runtime layer - TiptapRegistry, TiptapExecutor (Tasks 6, 9)
+// Runtime layer - TiptapAPCore, TiptapRegistry, TiptapExecutor
+export { TiptapAPCore } from "./TiptapAPCore.js";
 export { TiptapRegistry } from "./TiptapRegistry.js";
 export { TiptapExecutor } from "./TiptapExecutor.js";
 //# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/security/AclGuard.d.ts

@@ -3,6 +3,8 @@ export declare class AclGuard {
     private config;
     private logger;
     constructor(config?: AclConfig, logger?: Logger);
+    /** Update ACL configuration at runtime */
+    updateConfig(config: AclConfig | undefined): void;
     check(moduleId: string, descriptor: ModuleDescriptor): void;
     isAllowed(moduleId: string, descriptor: ModuleDescriptor): boolean;
     private getDenialReason;

package/dist/security/AclGuard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AclGuard.d.ts","sourceRoot":"","sources":["../../src/security/AclGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASvE,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM;IAK/C,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAY3D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO;IAwClE,OAAO,CAAC,eAAe;CAgDxB"}
+{"version":3,"file":"AclGuard.d.ts","sourceRoot":"","sources":["../../src/security/AclGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASvE,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM;IAK/C,0CAA0C;IAC1C,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI;IAKjD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAY3D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO;IAwClE,OAAO,CAAC,eAAe;CAgDxB"}

package/dist/security/AclGuard.js

@@ -11,6 +11,11 @@ export class AclGuard {
         this.config = config;
         this.logger = logger;
     }
+    /** Update ACL configuration at runtime */
+    updateConfig(config) {
+        this.config = config;
+        this.logger?.info?.("ACL configuration updated", { role: config?.role });
+    }
     check(moduleId, descriptor) {
         if (!this.isAllowed(moduleId, descriptor)) {
             const reason = this.getDenialReason(moduleId, descriptor);

package/dist/security/AclGuard.js.map

@@ -1 +1 @@
-{"version":3,"file":"AclGuard.js","sourceRoot":"","sources":["../../src/security/AclGuard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AclGuard.js","sourceRoot":"","sources":["../../src/security/AclGuard.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -8,6 +8,7 @@ export type { Registry, Executor, ModuleDescriptor, ModuleAnnotations, JsonSchem
 import type { ModuleAnnotations, JsonSchema } from "apcore-mcp";
 /** Minimal logger interface for diagnostic output */
 export interface Logger {
+    info?(msg: string, ctx?: Record<string, unknown>): void;
     warn(msg: string, ctx?: Record<string, unknown>): void;
     error(msg: string, ctx?: Record<string, unknown>): void;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/withApcore.d.ts

@@ -1,6 +1,8 @@
 /**
- * withApcore - Factory function that creates an APCore Registry + Executor
- * from a TipTap editor instance.
+ * withApcore - Factory function that creates a TiptapAPCore instance.
+ *
+ * This function is kept for backward compatibility and as a shortcut
+ * for simple integrations.
  */
 import type { ApcoreOptions, ApcoreResult, EditorLike } from "./types.js";
 /**

package/dist/withApcore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withApcore.d.ts","sourceRoot":"","sources":["../src/withApcore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU1E;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,CAsFd"}
+{"version":3,"file":"withApcore.d.ts","sourceRoot":"","sources":["../src/withApcore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG1E;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,CAMd"}

package/dist/withApcore.js

@@ -1,14 +1,10 @@
 /**
- * withApcore - Factory function that creates an APCore Registry + Executor
- * from a TipTap editor instance.
+ * withApcore - Factory function that creates a TiptapAPCore instance.
+ *
+ * This function is kept for backward compatibility and as a shortcut
+ * for simple integrations.
  */
-import { ExtensionScanner } from "./discovery/index.js";
-import { ModuleBuilder } from "./builder/index.js";
-import { TiptapRegistry } from "./runtime/TiptapRegistry.js";
-import { TiptapExecutor } from "./runtime/TiptapExecutor.js";
-import { AclGuard } from "./security/index.js";
-import { TiptapModuleError, ErrorCodes } from "./errors/index.js";
-const PREFIX_PATTERN = /^[a-z][a-z0-9]*$/;
+import { TiptapAPCore } from "./runtime/TiptapAPCore.js";
 /**
  * Create an APCore Registry + Executor from a TipTap editor instance.
  *
@@ -17,65 +13,10 @@ const PREFIX_PATTERN = /^[a-z][a-z0-9]*$/;
  * @returns { registry, executor } pair compatible with apcore-mcp SDK
  */
 export function withApcore(editor, options) {
-    // Validate editor
-    if (editor == null) {
-        throw new TypeError("editor must be a valid TipTap Editor instance");
-    }
-    if (editor.isDestroyed) {
-        throw new TiptapModuleError(ErrorCodes.EDITOR_NOT_READY, "Editor is not ready", { editorDestroyed: true });
-    }
-    // Validate options
-    const prefix = options?.prefix ?? "tiptap";
-    if (!PREFIX_PATTERN.test(prefix)) {
-        throw new TiptapModuleError(ErrorCodes.SCHEMA_VALIDATION_ERROR, `Invalid prefix '${prefix}': must match /^[a-z][a-z0-9]*$/`, { field: "prefix", value: prefix });
-    }
-    const validRoles = ["readonly", "editor", "admin"];
-    if (options?.acl?.role && !validRoles.includes(options.acl.role)) {
-        throw new TiptapModuleError(ErrorCodes.SCHEMA_VALIDATION_ERROR, `Invalid ACL role '${options.acl.role}': must be one of ${validRoles.join(", ")}`, { field: "acl.role", value: options.acl.role });
-    }
-    // C-2: Default includeUnsafe to false
-    const includeUnsafe = options?.includeUnsafe ?? false;
-    const logger = options?.logger;
-    // 1. Scan extensions (H-11 + H-12: wire logger)
-    const scanner = new ExtensionScanner(logger);
-    const extensionMap = scanner.scan(editor);
-    // 2. Build module descriptors
-    const builder = new ModuleBuilder(prefix);
-    const registry = new TiptapRegistry();
-    for (const [, extensionInfo] of extensionMap) {
-        for (const commandName of extensionInfo.commandNames) {
-            const descriptor = builder.build(commandName, extensionInfo);
-            // Skip unknown commands if includeUnsafe is false
-            if (!includeUnsafe && descriptor.tags?.includes("unknown")) {
-                continue;
-            }
-            registry.register(descriptor);
-        }
-    }
-    // 3. Create executor with ACL (H-7 + H-11: wire logger to AclGuard; H-1: wire sanitizeHtml)
-    const aclGuard = new AclGuard(options?.acl, logger);
-    const executor = new TiptapExecutor(editor, registry, aclGuard, options?.sanitizeHtml);
-    // 4. H-5: Diff-based discover — only emit register/unregister for changed modules
-    registry.setScanFunction(() => {
-        const newExtensionMap = scanner.scan(editor);
-        const newIds = new Set();
-        // Register new/updated
-        for (const [, extInfo] of newExtensionMap) {
-            for (const cmdName of extInfo.commandNames) {
-                const desc = builder.build(cmdName, extInfo);
-                if (!includeUnsafe && desc.tags?.includes("unknown"))
-                    continue;
-                newIds.add(desc.moduleId);
-                registry.register(desc);
-            }
-        }
-        // Unregister removed
-        for (const oldId of registry.list()) {
-            if (!newIds.has(oldId))
-                registry.unregister(oldId);
-        }
-        return newIds.size;
-    });
-    return { registry, executor };
+    const instance = new TiptapAPCore(editor, options);
+    return {
+        registry: instance.registry,
+        executor: instance.executor,
+    };
 }
 //# sourceMappingURL=withApcore.js.map

package/dist/withApcore.js.map

@@ -1 +1 @@
-{"version":3,"file":"withApcore.js","sourceRoot":"","sources":["../src/withApcore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"withApcore.js","sourceRoot":"","sources":["../src/withApcore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,MAAkB,EAClB,OAAuB;IAEvB,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiptap-apcore",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "TipTap editor APCore modules - let AI safely control your TipTap editor",
   "type": "module",
   "main": "./dist/index.js",
@@ -39,7 +39,7 @@
     "@vitest/coverage-v8": "^3.0.0",
     "apcore-js": "^0.13.0",
     "apcore-mcp": "^0.10.0",
-    "apdev-js": "^0.1.1",
+    "apdev-js": "^0.2.2",
     "jsdom": "^25.0.0",
     "typescript": "^5.5.0",
     "vitest": "^3.0.0"