@forumone/throughline-plugin-contract 0.2.1

package/README.md

@@ -0,0 +1,16 @@
+# @forumone/throughline-plugin-contract
+
+Shared type contracts every Throughline core plugin satisfies, plus the cross-plugin runtime registry. Core packages import from here so the plugin surface stays consistent across the framework. It is published because every core plugin imports `getPluginRegistry` from it at runtime.
+
+## What's in here
+
+- `CorePlugin<Options>` — the Payload plugin signature every core package exports
+- `BaseCorePluginOptions` — options every plugin accepts (`enabled`, `routePrefix`, `logger`)
+- `McpToolDefinition`, `McpToolContext`, `McpMeta` — the MCP server surface
+- `McpAuthenticator`, `McpAuthResult`, `AuthenticatedUser` — shared bearer-token auth types
+- `getPluginRegistry` — the runtime registry plugins use to announce themselves and check for sibling plugins
+- `examplePlugin` — a reference implementation showing the exact shape every future plugin follows
+
+## Authoring a plugin
+
+See `docs/building-plugins.md` at the repo root.

package/dist/auth.d.ts

@@ -0,0 +1,19 @@
+import type { AuthenticatedUser } from './mcp.js';
+/**
+ * Validates an incoming MCP request and resolves the caller's identity.
+ * Plugins accept an optional `authenticator` option; if omitted they fall
+ * back to the default Payload bearer-token authenticator.
+ */
+export interface McpAuthenticator {
+    /**
+     * Inspects the `Authorization` header on the request and returns an
+     * {@link McpAuthResult} if the token is valid, or `null` otherwise.
+     */
+    authenticate(request: Request): Promise<McpAuthResult | null>;
+}
+export interface McpAuthResult {
+    user: AuthenticatedUser;
+    apiKeyName: string;
+    apiKeyId: string;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;CAC9D;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB"}

package/dist/auth.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":""}

package/dist/example-plugin-pattern.d.ts

@@ -0,0 +1,12 @@
+import type { BaseCorePluginOptions, CorePlugin } from './index.js';
+/**
+ * EXAMPLE ONLY — not a real plugin. Reference implementation showing the
+ * shape every Throughline core plugin follows. Every future plugin should
+ * lift this structure and fill in the feature-specific parts.
+ */
+export interface ExamplePluginOptions extends BaseCorePluginOptions {
+    /** A plugin-specific option. */
+    greeting?: string;
+}
+export declare const examplePlugin: CorePlugin<ExamplePluginOptions>;
+//# sourceMappingURL=example-plugin-pattern.d.ts.map

package/dist/example-plugin-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-plugin-pattern.d.ts","sourceRoot":"","sources":["../src/example-plugin-pattern.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGnE;;;;GAIG;AAEH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAKD,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,oBAAoB,CAuD1D,CAAA"}

package/dist/example-plugin-pattern.js

@@ -0,0 +1,58 @@
+import { getPluginRegistry } from './registry.js';
+const EXAMPLE_PLUGIN_ID = '@forumone/throughline-example';
+const EXAMPLE_PLUGIN_VERSION = '0.0.0';
+export const examplePlugin = (options) => {
+    return (incomingConfig) => {
+        // Step 1 — honour the disabled flag before doing any work.
+        if (options.enabled === false)
+            return incomingConfig;
+        // Step 2 — apply defaults. Note: route prefixes here MUST NOT include
+        // `/api` — Payload mounts top-level endpoints under its API base
+        // (default `/api`), so the user-facing URL becomes `/api/example/mcp`.
+        const greeting = options.greeting ?? 'Hello';
+        const routePrefix = options.routePrefix ?? '/example';
+        // Step 3 — extend the incoming config by spreading and appending.
+        //          Never replace existing arrays; always concatenate.
+        return {
+            ...incomingConfig,
+            collections: [
+                ...(incomingConfig.collections ?? []),
+                // Plugin's own collections go here.
+            ],
+            endpoints: [
+                ...(incomingConfig.endpoints ?? []),
+                {
+                    path: `${routePrefix}/mcp`,
+                    method: 'post',
+                    handler: async () => {
+                        // Real plugins delegate this to an MCP server implementation.
+                        return new Response(JSON.stringify({ greeting }), {
+                            headers: { 'content-type': 'application/json' },
+                        });
+                    },
+                },
+            ],
+            hooks: {
+                ...(incomingConfig.hooks ?? {}),
+                afterError: [
+                    ...(incomingConfig.hooks?.afterError ?? []),
+                    // Plugin's global error hooks go here.
+                ],
+            },
+            onInit: async (payload) => {
+                // Always run any pre-existing onInit first so plugins compose cleanly.
+                if (incomingConfig.onInit) {
+                    await incomingConfig.onInit(payload);
+                }
+                // Announce presence and assert required capabilities from siblings.
+                const registry = getPluginRegistry(payload);
+                registry.register({
+                    id: EXAMPLE_PLUGIN_ID,
+                    version: EXAMPLE_PLUGIN_VERSION,
+                    capabilities: ['example'],
+                });
+            },
+        };
+    };
+};
+//# sourceMappingURL=example-plugin-pattern.js.map

package/dist/example-plugin-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-plugin-pattern.js","sourceRoot":"","sources":["../src/example-plugin-pattern.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAajD,MAAM,iBAAiB,GAAG,+BAA+B,CAAA;AACzD,MAAM,sBAAsB,GAAG,OAAO,CAAA;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAqC,CAAC,OAAO,EAAE,EAAE;IACzE,OAAO,CAAC,cAAsB,EAAU,EAAE;QACxC,2DAA2D;QAC3D,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;YAAE,OAAO,cAAc,CAAA;QAEpD,sEAAsE;QACtE,iEAAiE;QACjE,uEAAuE;QACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAA;QAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,UAAU,CAAA;QAErD,kEAAkE;QAClE,8DAA8D;QAC9D,OAAO;YACL,GAAG,cAAc;YACjB,WAAW,EAAE;gBACX,GAAG,CAAC,cAAc,CAAC,WAAW,IAAI,EAAE,CAAC;gBACrC,oCAAoC;aACrC;YACD,SAAS,EAAE;gBACT,GAAG,CAAC,cAAc,CAAC,SAAS,IAAI,EAAE,CAAC;gBACnC;oBACE,IAAI,EAAE,GAAG,WAAW,MAAM;oBAC1B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,KAAK,IAAI,EAAE;wBAClB,8DAA8D;wBAC9D,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;4BAChD,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;yBAChD,CAAC,CAAA;oBACJ,CAAC;iBACF;aACF;YACD,KAAK,EAAE;gBACL,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC/B,UAAU,EAAE;oBACV,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,IAAI,EAAE,CAAC;oBAC3C,uCAAuC;iBACxC;aACF;YACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBACxB,uEAAuE;gBACvE,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC;oBAC1B,MAAM,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;gBACtC,CAAC;gBAED,oEAAoE;gBACpE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;gBAC3C,QAAQ,CAAC,QAAQ,CAAC;oBAChB,EAAE,EAAE,iBAAiB;oBACrB,OAAO,EAAE,sBAAsB;oBAC/B,YAAY,EAAE,CAAC,SAAS,CAAC;iBAC1B,CAAC,CAAA;YACJ,CAAC;SACF,CAAA;IACH,CAAC,CAAA;AACH,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import type { Plugin } from 'payload';
+/**
+ * Options every Throughline core plugin accepts. Plugin-specific options
+ * extend this interface.
+ */
+export interface BaseCorePluginOptions {
+    /** Enable or disable the plugin without removing it from the config. Defaults to `true`. */
+    enabled?: boolean;
+    /**
+     * Route prefix the plugin mounts its MCP server and API endpoints under.
+     * Defaults to a plugin-specific value (e.g. `/api/publishing`). Override
+     * to avoid collisions or to expose under a different path.
+     */
+    routePrefix?: string;
+    /** Logger used for plugin diagnostics. Falls back to a console logger if omitted. */
+    logger?: Logger;
+}
+export interface Logger {
+    debug: (message: string, context?: Record<string, unknown>) => void;
+    info: (message: string, context?: Record<string, unknown>) => void;
+    warn: (message: string, context?: Record<string, unknown>) => void;
+    error: (message: string, context?: Record<string, unknown>) => void;
+}
+/**
+ * The Throughline core plugin signature. A plugin takes its options and
+ * returns a standard Payload {@link Plugin}.
+ */
+export type CorePlugin<Options extends BaseCorePluginOptions = BaseCorePluginOptions> = (options: Options) => Plugin;
+export * from './mcp.js';
+export * from './auth.js';
+export * from './registry.js';
+export * from './example-plugin-pattern.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACnE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAClE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAClE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CACpE;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,OAAO,SAAS,qBAAqB,GAAG,qBAAqB,IAAI,CACtF,OAAO,EAAE,OAAO,KACb,MAAM,CAAA;AAEX,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,6BAA6B,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './mcp.js';
+export * from './auth.js';
+export * from './registry.js';
+export * from './example-plugin-pattern.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkCA,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,6BAA6B,CAAA"}

package/dist/mcp.d.ts

@@ -0,0 +1,42 @@
+import type { z } from 'zod';
+import type { Logger } from './index.js';
+/**
+ * A single tool exposed by a Throughline MCP server.
+ */
+export interface McpToolDefinition<Input extends z.ZodType = z.ZodType, Output = unknown> {
+    /** The tool's name as exposed to the MCP client. */
+    name: string;
+    /** Human-readable description the MCP client uses to decide when to call this tool. */
+    description: string;
+    /** Zod schema for the input; used for validation and for generating the MCP tool schema. */
+    inputSchema: Input;
+    /** Handler invoked with validated input plus per-request context. */
+    handler: (input: z.infer<Input>, context: McpToolContext) => Promise<Output>;
+}
+export interface McpToolContext {
+    /** The user identified by the API key used for this request. */
+    user: AuthenticatedUser | null;
+    /** The API key's name, for audit logging. */
+    apiKeyName: string;
+    /** The session ID from the MCP client, if provided. */
+    sessionId?: string;
+    /** Request-scoped logger. */
+    logger: Logger;
+}
+export interface AuthenticatedUser {
+    id: string;
+    email: string;
+    name: string;
+    roles: string[];
+    groups: string[];
+}
+/**
+ * Optional `_meta` parameters clients may pass alongside consequential tool calls.
+ * Consumed by the audit system to capture prompt and reasoning context.
+ */
+export interface McpMeta {
+    userPrompt?: string;
+    reasoning?: string;
+    changesSummary?: string;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IACtF,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAA;IACnB,4FAA4F;IAC5F,WAAW,EAAE,KAAK,CAAA;IAClB,qEAAqE;IACrE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7E;AAED,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC9B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB"}

package/dist/mcp.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":""}

package/dist/registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A lightweight registry plugins use to announce their presence and discover
+ * sibling plugins. Attached to the Payload instance via a symbol so it does
+ * not pollute the public API surface.
+ */
+export interface PluginRegistryEntry {
+    id: string;
+    version: string;
+    capabilities: string[];
+}
+export interface PluginRegistry {
+    register(entry: PluginRegistryEntry): void;
+    has(id: string): boolean;
+    get(id: string): PluginRegistryEntry | undefined;
+    list(): PluginRegistryEntry[];
+    requireCapability(capability: string, requiredBy: string): void;
+}
+/**
+ * Returns the registry attached to the given target (typically the Payload
+ * instance passed to `onInit`). Creates and attaches one on first access.
+ */
+export declare function getPluginRegistry(target: object): PluginRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAA;IAC1C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAA;IAChD,IAAI,IAAI,mBAAmB,EAAE,CAAA;IAC7B,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAChE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAahE"}

package/dist/registry.js

@@ -0,0 +1,51 @@
+/**
+ * A lightweight registry plugins use to announce their presence and discover
+ * sibling plugins. Attached to the Payload instance via a symbol so it does
+ * not pollute the public API surface.
+ */
+const REGISTRY_SYMBOL = Symbol.for('@forumone/throughline/plugin-registry');
+/**
+ * Returns the registry attached to the given target (typically the Payload
+ * instance passed to `onInit`). Creates and attaches one on first access.
+ */
+export function getPluginRegistry(target) {
+    const host = target;
+    const existing = host[REGISTRY_SYMBOL];
+    if (existing)
+        return existing;
+    const registry = createRegistry();
+    Object.defineProperty(target, REGISTRY_SYMBOL, {
+        value: registry,
+        enumerable: false,
+        writable: false,
+        configurable: false,
+    });
+    return registry;
+}
+function createRegistry() {
+    const entries = new Map();
+    return {
+        register(entry) {
+            if (entries.has(entry.id)) {
+                throw new Error(`Plugin ${entry.id} is already registered`);
+            }
+            entries.set(entry.id, entry);
+        },
+        has(id) {
+            return entries.has(id);
+        },
+        get(id) {
+            return entries.get(id);
+        },
+        list() {
+            return Array.from(entries.values());
+        },
+        requireCapability(capability, requiredBy) {
+            const providers = Array.from(entries.values()).filter((entry) => entry.capabilities.includes(capability));
+            if (providers.length === 0) {
+                throw new Error(`Plugin ${requiredBy} requires capability "${capability}", but no registered plugin provides it.`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAA;AAgB3E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,IAAI,GAAG,MAAoD,CAAA;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,CAAA;IACtC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAE7B,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;IACjC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE;QAC7C,KAAK,EAAE,QAAQ;QACf,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;KACpB,CAAC,CAAA;IACF,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAA;IAEtD,OAAO;QACL,QAAQ,CAAC,KAAK;YACZ,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAAA;YAC7D,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QAC9B,CAAC;QACD,GAAG,CAAC,EAAE;YACJ,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACxB,CAAC;QACD,GAAG,CAAC,EAAE;YACJ,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACxB,CAAC;QACD,IAAI;YACF,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QACrC,CAAC;QACD,iBAAiB,CAAC,UAAU,EAAE,UAAU;YACtC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9D,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CACxC,CAAA;YACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CACb,UAAU,UAAU,yBAAyB,UAAU,0CAA0C,CAClG,CAAA;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@forumone/throughline-plugin-contract",
+  "version": "0.2.1",
+  "description": "Shared plugin and MCP contract types and the cross-plugin registry for @forumone/throughline core packages.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/forumone/throughline.git",
+    "directory": "packages/plugin-contract"
+  },
+  "homepage": "https://github.com/forumone/throughline/tree/main/packages/plugin-contract#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b -w",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  },
+  "dependencies": {
+    "payload": "^3.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@forumone/throughline-eslint-config": "workspace:*",
+    "@forumone/throughline-tsconfig": "workspace:*",
+    "@types/node": "^20.17.0",
+    "eslint": "^9.15.0",
+    "typescript": "^5.6.0"
+  }
+}