@forumone/throughline 1.2.0 → 1.3.0-pr-285-01cb291

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @forumone/throughline
 
+## 1.3.0-pr-285-01cb291
+
+### Minor Changes
+
+- f920034: Adds `@forumone/throughline/content` and a `content:` option on `throughline()`, with the MCP tools an agent uses to read before it writes a draft: `describe_content_type`, `find_documents`, `find_related` and `get_document`. Each call runs as the person behind the API key. Field types, limits and a blocks field's allowed blocks come from the live config. Draft-writing tools follow in a later release.
+
+  **Upgrading: a migration.** The audit log's `mcpServer` gains `content`, a new value on `enum_audit_events_mcp_server`. A site that turns the tools on also gets four new checkbox columns on `payload-mcp-api-keys`. Run `migrate:create` and apply it before deploying.
+
+### Patch Changes
+
+- @forumone/throughline-design-system@1.3.0-pr-285-01cb291
+
 ## 1.2.0
 
 ### Minor Changes

package/dist/audit/types.d.ts

@@ -11,6 +11,6 @@ export type AuditAction = (typeof AUDIT_ACTIONS)[number];
  * The last four arrived in 1.1, so that a throw in those tools is recorded as a
  * `system.error` like everyone else's.
  */
-export declare const AUDIT_MCP_SERVERS: readonly ["payload", "component", "publishing", "approvals", "audit", "forms", "integrations", "editorial", "references", "fields", "observability"];
+export declare const AUDIT_MCP_SERVERS: readonly ["payload", "component", "publishing", "approvals", "audit", "forms", "integrations", "editorial", "references", "fields", "observability", "content"];
 export type AuditMcpServer = (typeof AUDIT_MCP_SERVERS)[number];
 //# sourceMappingURL=types.d.ts.map

package/dist/audit/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,aAAa,6jBA4BhB,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,sJAYpB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,aAAa,6jBA4BhB,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,iKAapB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/audit/types.js

@@ -50,5 +50,6 @@ export const AUDIT_MCP_SERVERS = [
     'references',
     'fields',
     'observability',
+    'content',
 ];
 //# sourceMappingURL=types.js.map

package/dist/audit/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;IACb,gBAAgB;IAChB,iBAAiB;IACjB,qBAAqB;IACrB,0BAA0B;IAC1B,kBAAkB;IAClB,oBAAoB;IACpB,sBAAsB;IACtB,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;IACpB,kBAAkB;IAClB,mBAAmB;IACnB,4BAA4B;IAC5B,kBAAkB;IAClB,oBAAoB;IACpB,cAAc;IACd,cAAc;IACd,0BAA0B;IAC1B,oBAAoB;IACpB,oBAAoB;IACpB,cAAc;IACd,oBAAoB;CACZ,CAAA;AAIV;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS;IACT,WAAW;IACX,YAAY;IACZ,WAAW;IACX,OAAO;IACP,OAAO;IACP,cAAc;IACd,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,eAAe;CACP,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;IACb,gBAAgB;IAChB,iBAAiB;IACjB,qBAAqB;IACrB,0BAA0B;IAC1B,kBAAkB;IAClB,oBAAoB;IACpB,sBAAsB;IACtB,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;IACpB,kBAAkB;IAClB,mBAAmB;IACnB,4BAA4B;IAC5B,kBAAkB;IAClB,oBAAoB;IACpB,cAAc;IACd,cAAc;IACd,0BAA0B;IAC1B,oBAAoB;IACpB,oBAAoB;IACpB,cAAc;IACd,oBAAoB;CACZ,CAAA;AAIV;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS;IACT,WAAW;IACX,YAAY;IACZ,WAAW;IACX,OAAO;IACP,OAAO;IACP,cAAc;IACd,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,eAAe;IACf,SAAS;CACD,CAAA"}

package/dist/content/describe.d.ts

@@ -0,0 +1,61 @@
+import type { Block, Field, PayloadRequest } from 'payload';
+/** One field an author may set. */
+export interface FieldDescription {
+    name: string;
+    type: string;
+    label?: string;
+    description?: string;
+    required?: true;
+    hasMany?: true;
+    minLength?: number;
+    maxLength?: number;
+    min?: number;
+    max?: number;
+    minRows?: number;
+    maxRows?: number;
+    /** A select's or radio's values. */
+    options?: string[];
+    /** A relationship's or upload's target collection(s). */
+    relationTo?: string | string[];
+    /** How to find a value for it: the `find_related` kind that searches its target. */
+    findWith?: string;
+    /**
+     * The exact matches the field itself requires of what it links to, ready to
+     * pass as `find_related`'s `where` — a topics field that takes only terms of
+     * type `topic`, say. From the field's own `filterOptions`.
+     */
+    findWhere?: Record<string, string | number | boolean>;
+    /** The field's `filterOptions` when it is more than exact matches, as a Payload `where`. */
+    filter?: unknown;
+    /** A group's or array row's fields. */
+    fields?: FieldDescription[];
+    /** A blocks field's blocks: what may be added. */
+    blocks?: BlockDescription[];
+}
+export interface BlockDescription {
+    slug: string;
+    label?: string;
+    /** The picker shelf it sits on. */
+    group?: string;
+}
+export interface DescribeContext {
+    /** The config's block registry, for a blocks field that refers to blocks by slug. */
+    blocks: ReadonlyMap<string, Block>;
+    /** For a `filterOptions` that reads the request. */
+    req: PayloadRequest;
+    /** Collection slug → the `find_related` kind that searches it. */
+    findWith: ReadonlyMap<string, string>;
+}
+/**
+ * The named fields at the top of a document, looking through unnamed tabs,
+ * collapsibles and rows: the names a document is stored under.
+ */
+export declare function topLevelFields(fields: readonly Field[]): Field[];
+/** The fields a collection lets an author set, in the order the admin shows them. */
+export declare function writableFields(fields: readonly Field[], names: readonly string[]): Field[];
+/** The names in `names` that are not top-level fields of `fields`. */
+export declare function unknownFieldNames(fields: readonly Field[], names: readonly string[]): string[];
+/** One field, and what is inside it. */
+export declare function describeField(field: Field, ctx: DescribeContext): Promise<FieldDescription | undefined>;
+export declare function describeFields(fields: readonly Field[], ctx: DescribeContext): Promise<FieldDescription[]>;
+//# sourceMappingURL=describe.d.ts.map

package/dist/content/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/content/describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAY3D,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IACrD,4FAA4F;IAC5F,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,uCAAuC;IACvC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC3B,kDAAkD;IAClD,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAClC,oDAAoD;IACpD,GAAG,EAAE,cAAc,CAAA;IACnB,kEAAkE;IAClE,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAOD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,EAAE,CAkBhE;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,EAAE,CAK1F;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAK9F;AAgHD,wCAAwC;AACxC,wBAAsB,aAAa,CACjC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CA0CvC;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAO7B"}

package/dist/content/describe.js

@@ -0,0 +1,201 @@
+/** A field that stores nothing of its own and only arranges others. */
+function isWrapper(field) {
+    return !('name' in field) || typeof field.name !== 'string' || field.name === '';
+}
+/**
+ * The named fields at the top of a document, looking through unnamed tabs,
+ * collapsibles and rows: the names a document is stored under.
+ */
+export function topLevelFields(fields) {
+    const out = [];
+    for (const field of fields) {
+        if (field.type === 'tabs') {
+            for (const tab of field.tabs) {
+                if ('name' in tab && typeof tab.name === 'string' && tab.name !== '') {
+                    out.push({ ...tab, type: 'group' });
+                }
+                else {
+                    out.push(...topLevelFields(tab.fields));
+                }
+            }
+        }
+        else if (isWrapper(field) && 'fields' in field && Array.isArray(field.fields)) {
+            out.push(...topLevelFields(field.fields));
+        }
+        else {
+            out.push(field);
+        }
+    }
+    return out;
+}
+/** The fields a collection lets an author set, in the order the admin shows them. */
+export function writableFields(fields, names) {
+    const wanted = new Set(names);
+    return topLevelFields(fields).filter((field) => 'name' in field && wanted.has(field.name));
+}
+/** The names in `names` that are not top-level fields of `fields`. */
+export function unknownFieldNames(fields, names) {
+    const known = new Set(topLevelFields(fields).map((field) => ('name' in field ? field.name : '')));
+    return names.filter((name) => !known.has(name));
+}
+function text(value) {
+    if (typeof value === 'string' && value.trim() !== '')
+        return value;
+    if (value && typeof value === 'object' && typeof value.en === 'string') {
+        return value.en;
+    }
+    return undefined;
+}
+/** Whether an author can set this field at all: it stores something and is not hidden or read-only. */
+function isAuthored(field) {
+    if (field.type === 'ui' || field.type === 'join')
+        return false;
+    if ('hidden' in field && field.hidden)
+        return false;
+    const admin = field
+        .admin;
+    if (admin?.hidden || admin?.readOnly || admin?.disabled)
+        return false;
+    if ('virtual' in field && field.virtual)
+        return false;
+    return true;
+}
+function optionValues(options) {
+    return options.map((option) => typeof option === 'string' ? option : String(option.value));
+}
+async function blocksOf(field, ctx) {
+    const all = [
+        ...(field.blocks ?? []),
+        ...(field.blockReferences ?? []).flatMap((ref) => {
+            const block = typeof ref === 'string' ? ctx.blocks.get(ref) : ref;
+            return block ? [block] : [];
+        }),
+    ];
+    /*
+    The picker's own question, asked for a document that holds nothing yet. A
+    `filterOptions` that keeps whatever a document already holds (so an existing
+    one stays saveable) adds nothing here, which is the point: this is what may be
+    *added*.
+    */
+    let allowed;
+    if (typeof field.filterOptions === 'function') {
+        const answer = await field.filterOptions({
+            data: {},
+            siblingData: {},
+            id: undefined,
+            req: ctx.req,
+            user: ctx.req.user,
+        });
+        if (Array.isArray(answer))
+            allowed = new Set(answer);
+    }
+    else if (Array.isArray(field.filterOptions)) {
+        allowed = new Set(field.filterOptions);
+    }
+    return all
+        .filter((block) => !allowed || allowed.has(block.slug))
+        .map((block) => {
+        const label = text(block.labels?.singular);
+        const group = text(block.admin?.group);
+        return { slug: block.slug, ...(label ? { label } : {}), ...(group ? { group } : {}) };
+    });
+}
+/*
+A relationship's `filterOptions` is what narrows the admin's picker — a topics
+field offering only terms of type `topic`. Asked the way the picker asks it, for
+a document that holds nothing yet. `true` means no narrowing, and so does an
+answer per collection for a field that links to several, which is rare enough
+to leave to the agent and the save-time validation.
+*/
+async function relationFilter(filterOptions, relationTo, ctx) {
+    if (typeof relationTo !== 'string' || filterOptions === undefined)
+        return undefined;
+    const answer = typeof filterOptions === 'function'
+        ? await filterOptions({
+            data: {},
+            siblingData: {},
+            blockData: undefined,
+            id: undefined,
+            relationTo,
+            req: ctx.req,
+            user: ctx.req.user,
+        })
+        : filterOptions;
+    return answer && typeof answer === 'object' && Object.keys(answer).length > 0
+        ? answer
+        : undefined;
+}
+/** `{ type: { equals: 'topic' } }` as `{ type: 'topic' }`; `undefined` for anything more. */
+function exactMatches(where) {
+    const out = {};
+    for (const [field, condition] of Object.entries(where)) {
+        if (field === 'and' || field === 'or' || !condition || typeof condition !== 'object')
+            return undefined;
+        const keys = Object.keys(condition);
+        const value = condition.equals;
+        if (keys.length !== 1 || keys[0] !== 'equals')
+            return undefined;
+        if (typeof value !== 'string' && typeof value !== 'number' && typeof value !== 'boolean')
+            return undefined;
+        out[field] = value;
+    }
+    return out;
+}
+/** One field, and what is inside it. */
+export async function describeField(field, ctx) {
+    if (!('name' in field) || !isAuthored(field))
+        return undefined;
+    const f = field;
+    const admin = f['admin'];
+    const out = { name: field.name, type: field.type };
+    const label = text(f['label']);
+    if (label)
+        out.label = label;
+    const description = text(admin?.description);
+    if (description)
+        out.description = description;
+    if (f['required'] === true)
+        out.required = true;
+    if (f['hasMany'] === true)
+        out.hasMany = true;
+    for (const key of ['minLength', 'maxLength', 'min', 'max', 'minRows', 'maxRows']) {
+        if (typeof f[key] === 'number')
+            out[key] = f[key];
+    }
+    if ((field.type === 'select' || field.type === 'radio') && Array.isArray(f['options'])) {
+        out.options = optionValues(f['options']);
+    }
+    if (field.type === 'relationship' || field.type === 'upload') {
+        const relationTo = f['relationTo'];
+        out.relationTo = relationTo;
+        const kind = typeof relationTo === 'string' ? ctx.findWith.get(relationTo) : undefined;
+        if (kind)
+            out.findWith = kind;
+        const where = await relationFilter(f['filterOptions'], relationTo, ctx);
+        if (where) {
+            const exact = exactMatches(where);
+            if (exact)
+                out.findWhere = exact;
+            else
+                out.filter = where;
+        }
+    }
+    if (field.type === 'group' || field.type === 'array') {
+        const children = await describeFields(topLevelFields(f['fields'] ?? []), ctx);
+        out.fields = children;
+    }
+    if (field.type === 'blocks') {
+        out.blocks = await blocksOf(field, ctx);
+    }
+    return out;
+}
+export async function describeFields(fields, ctx) {
+    const out = [];
+    for (const field of fields) {
+        const described = await describeField(field, ctx);
+        if (described)
+            out.push(described);
+    }
+    return out;
+}
+//# sourceMappingURL=describe.js.map

package/dist/content/describe.js.map

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

package/dist/content/index.d.ts

@@ -0,0 +1,7 @@
+export { contentPlugin } from './plugin.js';
+export type { ContentCollectionOptions, ContentPluginOptions, RelatedKindOptions, } from './options.js';
+export { describeField, describeFields, topLevelFields, unknownFieldNames, writableFields, } from './describe.js';
+export type { BlockDescription, DescribeContext, FieldDescription } from './describe.js';
+export { CONTENT_READ_TOOLS, CONTENT_READ_TOOL_DESCRIPTORS, createContentReadTools, createDescribeContentTypeTool, createFindDocumentsTool, createFindRelatedTool, createGetDocumentTool, toWriteShape, } from './tools.js';
+export type { ContentToolDeps } from './tools.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACxF,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,GACb,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}

package/dist/content/index.js

@@ -0,0 +1,4 @@
+export { contentPlugin } from './plugin.js';
+export { describeField, describeFields, topLevelFields, unknownFieldNames, writableFields, } from './describe.js';
+export { CONTENT_READ_TOOLS, CONTENT_READ_TOOL_DESCRIPTORS, createContentReadTools, createDescribeContentTypeTool, createFindDocumentsTool, createFindRelatedTool, createGetDocumentTool, toWriteShape, } from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/content/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAM3C,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,GACb,MAAM,YAAY,CAAA"}

package/dist/content/options.d.ts

@@ -0,0 +1,52 @@
+import type { McpToolContext } from '../plugin-contract/index.js';
+import type { McpToolCollector } from '../mcp/collector.js';
+export interface ContentCollectionOptions {
+    /**
+     * The top-level fields an author may set, by name: what an agent is told
+     * about and, from phase 2, what a write may contain. A group or an array is
+     * named whole. Fields inside tabs and collapsibles are named directly, as
+     * they are stored.
+     *
+     * An allow-list rather than a deny-list: a field added to the collection
+     * later is not writable over MCP until somebody decides it should be.
+     */
+    fields: readonly string[];
+    /**
+     * Blocks the collection's template already draws from the document's own
+     * fields, so an agent does not repeat them in `layout`. By slug. A blocks
+     * field's `filterOptions` already keeps the ones that may appear only once
+     * out of the picker; this says why, and covers those that may repeat.
+     */
+    templateDraws?: readonly string[];
+    /** What publishing this collection requires beyond its fields, in the words an agent reads. */
+    publishRequires?: readonly string[];
+}
+export interface RelatedKindOptions {
+    /** The collection a kind searches. */
+    collection: string;
+    /** Fields a lookup may also match on exactly, e.g. a taxonomy's `type`. */
+    filters?: readonly string[];
+    /**
+     * Fields the query is matched against, OR'd. Default: the collection's
+     * `useAsTitle`. For media, whose title is usually a filename, add `alt`.
+     */
+    searchFields?: readonly string[];
+    /** What the kind is, for the tool's description. */
+    description?: string;
+}
+export interface ContentPluginOptions {
+    enabled?: boolean;
+    /** The collections the tools read and write, by slug. */
+    collections: Readonly<Record<string, ContentCollectionOptions>>;
+    /**
+     * What `find_related` looks up, by the name an agent passes as `kind`:
+     * `{ people: { collection: 'people' }, media: { collection: 'media' } }`.
+     * An upload collection's results carry the file's alt text and dimensions.
+     */
+    related?: Readonly<Record<string, RelatedKindOptions>>;
+    /** Where the tools go. Omit for none. Must come before `mcpPlugin`. */
+    mcpTools?: McpToolCollector;
+    /** Who may call them. Default: a user with the `admin` or `editor` role. */
+    canUse?: (ctx: McpToolContext) => boolean;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/content/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/content/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAa3D,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;OAQG;IACH,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,+FAA+F;IAC/F,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yDAAyD;IACzD,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAA;IAC/D;;;;OAIG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAA;IACtD,uEAAuE;IACvE,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAA;CAC1C"}

package/dist/content/options.js

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

package/dist/content/options.js.map

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

package/dist/content/plugin.d.ts

@@ -0,0 +1,23 @@
+import type { Plugin } from 'payload';
+import type { ContentPluginOptions } from './options.js';
+/**
+ * The content tools: what an agent reads before it writes a draft, and — in
+ * the phases that follow — the drafts themselves. forumone-2026#803.
+ *
+ * Checks its options against the config as it loads, so a misspelt field or a
+ * collection that was renamed stops the boot rather than quietly leaving an
+ * agent unable to set something:
+ *
+ * ```ts
+ * contentPlugin({
+ *   collections: {
+ *     pages: { fields: ['title', 'slug', 'layout', 'meta'] },
+ *     posts: { fields: ['title', 'slug', 'intro', 'body', 'authors'], templateDraws: ['ArticleBody'] },
+ *   },
+ *   related: { people: { collection: 'people' }, media: { collection: 'media' } },
+ *   mcpTools,
+ * })
+ * ```
+ */
+export declare function contentPlugin(options: ContentPluginOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/content/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/content/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,SAAS,CAAA;AAG7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAGxD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAiDnE"}

package/dist/content/plugin.js

@@ -0,0 +1,68 @@
+import { findAuditWriter } from '../audit/plugin.js';
+import { unknownFieldNames } from './describe.js';
+import { CONTENT_READ_TOOL_DESCRIPTORS, createContentReadTools } from './tools.js';
+/**
+ * The content tools: what an agent reads before it writes a draft, and — in
+ * the phases that follow — the drafts themselves. forumone-2026#803.
+ *
+ * Checks its options against the config as it loads, so a misspelt field or a
+ * collection that was renamed stops the boot rather than quietly leaving an
+ * agent unable to set something:
+ *
+ * ```ts
+ * contentPlugin({
+ *   collections: {
+ *     pages: { fields: ['title', 'slug', 'layout', 'meta'] },
+ *     posts: { fields: ['title', 'slug', 'intro', 'body', 'authors'], templateDraws: ['ArticleBody'] },
+ *   },
+ *   related: { people: { collection: 'people' }, media: { collection: 'media' } },
+ *   mcpTools,
+ * })
+ * ```
+ */
+export function contentPlugin(options) {
+    return (incoming) => {
+        if (options.enabled === false)
+            return incoming;
+        const bySlug = new Map((incoming.collections ?? []).map((c) => [c.slug, c]));
+        const problems = [];
+        for (const [slug, entry] of Object.entries(options.collections)) {
+            const collection = bySlug.get(slug);
+            if (!collection) {
+                problems.push(`no collection "${slug}"`);
+                continue;
+            }
+            const unknown = unknownFieldNames(collection.fields, entry.fields);
+            if (unknown.length > 0) {
+                problems.push(`"${slug}" has no top-level field ${unknown.map((n) => `"${n}"`).join(', ')}`);
+            }
+        }
+        for (const [kind, entry] of Object.entries(options.related ?? {})) {
+            if (!bySlug.has(entry.collection)) {
+                problems.push(`related kind "${kind}" names no collection "${entry.collection}"`);
+            }
+        }
+        if (problems.length > 0) {
+            throw new Error(`contentPlugin: ${problems.join('; ')}. Register it after the plugins that add those collections, and name fields as they are stored.`);
+        }
+        // Declared at config time so `mcpPlugin` makes a checkbox per tool; bound at `onInit`.
+        options.mcpTools?.declare(CONTENT_READ_TOOL_DESCRIPTORS, { serverName: 'content' });
+        return {
+            ...incoming,
+            onInit: async (payload) => {
+                if (incoming.onInit)
+                    await incoming.onInit(payload);
+                if (!options.mcpTools)
+                    return;
+                const audit = findAuditWriter(payload);
+                options.mcpTools.add(createContentReadTools({
+                    payload,
+                    collections: options.collections,
+                    related: options.related ?? {},
+                    ...(options.canUse ? { canUse: options.canUse } : {}),
+                }), { serverName: 'content', ...(audit ? { audit } : {}) });
+            },
+        };
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/content/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/content/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAElF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,OAAO,CAAC,QAAgB,EAAU,EAAE;QAClC,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;YAAE,OAAO,QAAQ,CAAA;QAE9C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5E,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAChE,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACnC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,QAAQ,CAAC,IAAI,CAAC,kBAAkB,IAAI,GAAG,CAAC,CAAA;gBACxC,SAAQ;YACV,CAAC;YACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YAClE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,4BAA4B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC9F,CAAC;QACH,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;YAClE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,IAAI,0BAA0B,KAAK,CAAC,UAAU,GAAG,CAAC,CAAA;YACnF,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,kBAAkB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,iGAAiG,CACvI,CAAA;QACH,CAAC;QAED,uFAAuF;QACvF,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,6BAA6B,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAA;QAEnF,OAAO;YACL,GAAG,QAAQ;YACX,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBACxB,IAAI,QAAQ,CAAC,MAAM;oBAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;gBACnD,IAAI,CAAC,OAAO,CAAC,QAAQ;oBAAE,OAAM;gBAC7B,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;gBACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAClB,sBAAsB,CAAC;oBACrB,OAAO;oBACP,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;oBAC9B,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtD,CAAC,EACF,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CACvD,CAAA;YACH,CAAC;SACF,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/content/tools.d.ts

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { type Payload } from 'payload';
+import type { McpToolContext, McpToolDefinition } from '../plugin-contract/index.js';
+import type { McpToolDescriptor } from '../mcp/collector.js';
+import type { ContentCollectionOptions, RelatedKindOptions } from './options.js';
+export declare const CONTENT_READ_TOOLS: {
+    readonly describeContentType: {
+        readonly name: "describe_content_type";
+        readonly description: "What a content type is made of, before creating or editing one: every field an author may set, with its type, limits, whether it is required, a select's options, and for a link to another document the `find_related` kind that finds one. A blocks field lists the blocks it accepts (look each up with `get_contract`). Also what the page template already draws, so the layout does not repeat it, and what publishing requires. Read from the live configuration.";
+    };
+    readonly findDocuments: {
+        readonly name: "find_documents";
+        readonly description: "Finds documents of one content type by title or slug, drafts included, newest first. Each result has its id, title, slug, status (draft or published, of the latest version), when it was last changed, and its admin and preview links. Use before creating something, so an existing document is edited rather than duplicated.";
+    };
+    readonly findRelated: {
+        readonly name: "find_related";
+        readonly description: "Looks up something a document links to — an author, a client, a taxonomy term, an image — by a few letters of its name, to get the id a field needs. Images come back with their alt text and dimensions. Which kinds exist is in each field's `findWith` from `describe_content_type`. Read only.";
+    };
+    readonly getDocument: {
+        readonly name: "get_document";
+        readonly description: "Reads one document in the shape the write tools accept: the fields an author may set, relationships as ids, and blocks with their ids. The latest draft by default; pass draft: false for the published version. Also its status and its admin and preview links.";
+    };
+};
+export declare const CONTENT_READ_TOOL_DESCRIPTORS: readonly McpToolDescriptor[];
+export interface ContentToolDeps {
+    payload: Payload;
+    collections: Readonly<Record<string, ContentCollectionOptions>>;
+    related: Readonly<Record<string, RelatedKindOptions>>;
+    canUse?: (ctx: McpToolContext) => boolean;
+}
+declare const describeInput: z.ZodObject<{
+    collection: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+}, {
+    collection: string;
+}>;
+export declare function createDescribeContentTypeTool(deps: ContentToolDeps): McpToolDefinition<typeof describeInput>;
+declare const findInput: z.ZodObject<{
+    collection: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    limit?: number | undefined;
+    query?: string | undefined;
+}, {
+    collection: string;
+    limit?: number | undefined;
+    query?: string | undefined;
+}>;
+export declare function createFindDocumentsTool(deps: ContentToolDeps): McpToolDefinition<typeof findInput>;
+declare const relatedInput: z.ZodObject<{
+    kind: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
+    where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: string;
+    where?: Record<string, string | number | boolean> | undefined;
+    limit?: number | undefined;
+    query?: string | undefined;
+}, {
+    kind: string;
+    where?: Record<string, string | number | boolean> | undefined;
+    limit?: number | undefined;
+    query?: string | undefined;
+}>;
+export declare function createFindRelatedTool(deps: ContentToolDeps): McpToolDefinition<typeof relatedInput>;
+declare const getInput: z.ZodObject<{
+    collection: z.ZodString;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    draft: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    id: string | number;
+    draft?: boolean | undefined;
+}, {
+    collection: string;
+    id: string | number;
+    draft?: boolean | undefined;
+}>;
+/** The authored fields of a document, as the write tools take them. */
+export declare function toWriteShape(doc: Record<string, unknown>, fieldNames: readonly string[]): Record<string, unknown>;
+export declare function createGetDocumentTool(deps: ContentToolDeps): McpToolDefinition<typeof getInput>;
+export declare function createContentReadTools(deps: ContentToolDeps): McpToolDefinition[];
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/content/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/content/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAIL,KAAK,OAAO,EAGb,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAI5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAWhF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;CAqBuB,CAAA;AAEtD,eAAO,MAAM,6BAA6B,EAAE,SAAS,iBAAiB,EACnC,CAAA;AAEnC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAA;IAC/D,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAA;IACrD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAA;CAC1C;AAoFD,QAAA,MAAM,aAAa;;;;;;EAEjB,CAAA;AAEF,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,eAAe,GACpB,iBAAiB,CAAC,OAAO,aAAa,CAAC,CAsCzC;AAID,QAAA,MAAM,SAAS;;;;;;;;;;;;EAOb,CAAA;AAEF,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,eAAe,GACpB,iBAAiB,CAAC,OAAO,SAAS,CAAC,CA6DrC;AAID,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;EAQhB,CAAA;AAWF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,GACpB,iBAAiB,CAAC,OAAO,YAAY,CAAC,CAgExC;AAID,QAAA,MAAM,QAAQ;;;;;;;;;;;;EAOZ,CAAA;AAEF,uEAAuE;AACvE,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,GACpB,iBAAiB,CAAC,OAAO,QAAQ,CAAC,CA0CpC;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,EAAE,CAOjF"}