@forumone/throughline 0.0.0-stage → 1.0.0-next.0

package/dist/publishing/tools/descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.js","sourceRoot":"","sources":["../../../src/publishing/tools/descriptors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;EAYE;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EACT,2QAA2Q;KAC9Q;IACD,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,sNAAsN;KACzN;IACD,eAAe,EAAE;QACf,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,+TAA+T;KAClU;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,0RAA0R;KAC7R;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,2NAA2N;KAC9N;CACmD,CAAA;AAEtD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,2BAA2B,GACtC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA"}

package/dist/publishing/tools/get-publish-status.d.ts

@@ -0,0 +1,12 @@
+import type { Payload } from 'payload';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { PublishingPluginOptions } from '../options.js';
+import { type PublishingService } from '../service.js';
+export interface GetPublishStatusToolDeps {
+    payload: Payload;
+    options: PublishingPluginOptions;
+    /** Injected by the plugin so every channel shares one service instance. */
+    service?: PublishingService;
+}
+export declare function createGetPublishStatusTool(deps: GetPublishStatusToolDeps): McpToolDefinition;
+//# sourceMappingURL=get-publish-status.d.ts.map

package/dist/publishing/tools/get-publish-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-publish-status.d.ts","sourceRoot":"","sources":["../../../src/publishing/tools/get-publish-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAI/E,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,uBAAuB,CAAA;IAChC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG,iBAAiB,CA0C5F"}

package/dist/publishing/tools/get-publish-status.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { withMeta } from '../../mcp/meta.js';
+import { createPublishingService } from '../service.js';
+import { resolvePublishingActor } from './actor.js';
+import { PUBLISHING_TOOLS } from './descriptors.js';
+export function createGetPublishStatusTool(deps) {
+    const inputSchema = withMeta({
+        collection: z.string(),
+        id: z.string(),
+    });
+    const service = deps.service ??
+        createPublishingService({ ...deps, auditWriter: async () => { } });
+    return {
+        ...PUBLISHING_TOOLS.getPublishStatus,
+        inputSchema,
+        handler: async (input, ctx) => {
+            const actor = resolvePublishingActor(ctx);
+            if ('error' in actor)
+                return actor;
+            const status = await service.getStatus({
+                collection: input.collection,
+                id: input.id,
+                actor,
+            });
+            return {
+                currentStatus: status.status,
+                hasUnpublishedChanges: status.hasUnpublishedChanges,
+                lastPublished: status.publishedAt,
+                wouldPublish: {
+                    canPublish: status.publishable,
+                    ...(status.publishable
+                        ? {}
+                        : {
+                            blockedAt: status.failedAt,
+                            code: status.code,
+                            reason: status.reason,
+                            suggestion: status.suggestion,
+                            issues: status.issues ?? [],
+                        }),
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=get-publish-status.js.map

package/dist/publishing/tools/get-publish-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-publish-status.js","sourceRoot":"","sources":["../../../src/publishing/tools/get-publish-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,OAAO,EAAE,uBAAuB,EAA0B,MAAM,eAAe,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AASnD,MAAM,UAAU,0BAA0B,CAAC,IAA8B;IACvE,MAAM,WAAW,GAAG,QAAQ,CAAC;QAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;KACf,CAAC,CAAA;IAEF,MAAM,OAAO,GACX,IAAI,CAAC,OAAO;QACZ,uBAAuB,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,CAAC,CAAA;IAEnE,OAAO;QACL,GAAG,gBAAgB,CAAC,gBAAgB;QACpC,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;YACzC,IAAI,OAAO,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;YAElC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC;gBACrC,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,KAAK;aACN,CAAC,CAAA;YAEF,OAAO;gBACL,aAAa,EAAE,MAAM,CAAC,MAAM;gBAC5B,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;gBACnD,aAAa,EAAE,MAAM,CAAC,WAAW;gBACjC,YAAY,EAAE;oBACZ,UAAU,EAAE,MAAM,CAAC,WAAW;oBAC9B,GAAG,CAAC,MAAM,CAAC,WAAW;wBACpB,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC;4BACE,SAAS,EAAE,MAAM,CAAC,QAAQ;4BAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,MAAM,EAAE,MAAM,CAAC,MAAM;4BACrB,UAAU,EAAE,MAAM,CAAC,UAAU;4BAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;yBAC5B,CAAC;iBACP;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/publishing/tools/index.d.ts

@@ -0,0 +1,7 @@
+export { PUBLISHING_TOOLS, PUBLISHING_TOOL_DESCRIPTORS } from './descriptors.js';
+export { createPublishTool, type PublishToolDeps } from './publish.js';
+export { createUnpublishTool, type UnpublishToolDeps } from './unpublish.js';
+export { createSchedulePublishTool, type SchedulePublishToolDeps, } from './schedule-publish.js';
+export { createGetPublishStatusTool, type GetPublishStatusToolDeps, } from './get-publish-status.js';
+export { createRollbackTool, type RollbackToolDeps } from './rollback.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/publishing/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/publishing/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAC5E,OAAO,EACL,yBAAyB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,0BAA0B,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA"}

package/dist/publishing/tools/index.js

@@ -0,0 +1,7 @@
+export { PUBLISHING_TOOLS, PUBLISHING_TOOL_DESCRIPTORS } from './descriptors.js';
+export { createPublishTool } from './publish.js';
+export { createUnpublishTool } from './unpublish.js';
+export { createSchedulePublishTool, } from './schedule-publish.js';
+export { createGetPublishStatusTool, } from './get-publish-status.js';
+export { createRollbackTool } from './rollback.js';
+//# sourceMappingURL=index.js.map

package/dist/publishing/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/publishing/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAwB,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAA0B,MAAM,gBAAgB,CAAA;AAC5E,OAAO,EACL,yBAAyB,GAE1B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,0BAA0B,GAE3B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,kBAAkB,EAAyB,MAAM,eAAe,CAAA"}

package/dist/publishing/tools/publish.d.ts

@@ -0,0 +1,14 @@
+import type { Payload } from 'payload';
+import { type AuditWriter } from '../../audit/writer.js';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { PublishingPluginOptions } from '../options.js';
+import { type PublishingService } from '../service.js';
+export interface PublishToolDeps {
+    payload: Payload;
+    options: PublishingPluginOptions;
+    auditWriter: AuditWriter;
+    /** Injected by the plugin so every channel shares one service instance. */
+    service?: PublishingService;
+}
+export declare function createPublishTool(deps: PublishToolDeps): McpToolDefinition;
+//# sourceMappingURL=publish.d.ts.map

package/dist/publishing/tools/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../src/publishing/tools/publish.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAI/E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,uBAAuB,CAAA;IAChC,WAAW,EAAE,WAAW,CAAA;IACxB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CA8B1E"}

package/dist/publishing/tools/publish.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { withMeta } from '../../mcp/meta.js';
+import { createPublishingService } from '../service.js';
+import { resolvePublishingActor } from './actor.js';
+import { PUBLISHING_TOOLS } from './descriptors.js';
+export function createPublishTool(deps) {
+    const inputSchema = withMeta({
+        collection: z.string().describe('The collection slug (e.g. "pages")'),
+        id: z.string().describe('The document ID'),
+    });
+    const service = deps.service ?? createPublishingService(deps);
+    return {
+        ...PUBLISHING_TOOLS.publish,
+        /*
+        Declared, and read by nothing. The per-key checkbox `plugin-mcp` generates
+        is what gates this tool; this records that publishing is consequential, and
+        is the mapping a scope-aware default would be built from. See
+        `McpToolDefinition`.
+        */
+        requiredScope: 'publishing.execute',
+        inputSchema,
+        handler: async (input, ctx) => {
+            const actor = resolvePublishingActor(ctx);
+            if ('error' in actor)
+                return actor;
+            return service.publish({
+                collection: input.collection,
+                id: input.id,
+                actor,
+                ...(input._meta ? { meta: input._meta } : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=publish.js.map

package/dist/publishing/tools/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/publishing/tools/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,OAAO,EAAE,uBAAuB,EAA0B,MAAM,eAAe,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAUnD,MAAM,UAAU,iBAAiB,CAAC,IAAqB;IACrD,MAAM,WAAW,GAAG,QAAQ,CAAC;QAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACrE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KAC3C,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAE7D,OAAO;QACL,GAAG,gBAAgB,CAAC,OAAO;QAC3B;;;;;UAKE;QACF,aAAa,EAAE,oBAAoB;QACnC,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;YACzC,IAAI,OAAO,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;YAElC,OAAO,OAAO,CAAC,OAAO,CAAC;gBACrB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,KAAK;gBACL,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/publishing/tools/rollback.d.ts

@@ -0,0 +1,11 @@
+import type { Payload } from 'payload';
+import { type AuditWriter } from '../../audit/writer.js';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import { type PublishingPluginOptions } from '../options.js';
+export interface RollbackToolDeps {
+    payload: Payload;
+    options: PublishingPluginOptions;
+    auditWriter: AuditWriter;
+}
+export declare function createRollbackTool(deps: RollbackToolDeps): McpToolDefinition;
+//# sourceMappingURL=rollback.d.ts.map

package/dist/publishing/tools/rollback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../../../src/publishing/tools/rollback.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAErE,OAAO,EAAE,KAAK,uBAAuB,EAAqB,MAAM,eAAe,CAAA;AAI/E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,uBAAuB,CAAA;IAChC,WAAW,EAAE,WAAW,CAAA;CACzB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAkG5E"}

package/dist/publishing/tools/rollback.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { withMeta } from '../../mcp/meta.js';
+import { sendEventSafely } from '../events.js';
+import { resolveCollection } from '../options.js';
+import { resolvePublishingActor } from './actor.js';
+import { PUBLISHING_TOOLS } from './descriptors.js';
+export function createRollbackTool(deps) {
+    const inputSchema = withMeta({
+        collection: z.string(),
+        id: z.string().describe('The document ID'),
+        versionId: z.string().describe('The version ID to roll the document back to'),
+    });
+    return {
+        ...PUBLISHING_TOOLS.rollback,
+        requiredScope: 'publishing.execute',
+        inputSchema,
+        handler: async (input, ctx) => {
+            const actor = resolvePublishingActor(ctx);
+            if ('error' in actor)
+                return actor;
+            const collection = resolveCollection(deps.options, input.collection);
+            /*
+            Both reads and the restore run as the caller with `overrideAccess: false`.
+      
+            This tool had it worst of the five: the version lookup ran at the Local
+            API default, and `restoreVersion` was called with no user and no override
+            flag at all — so a rollback was a write to a published document that
+            consulted nothing. Audit 04 F-02.
+            */
+            const enforce = { user: actor.enforceAccessAs, overrideAccess: false };
+            // Confirm the version belongs to this document before restoring.
+            const versions = await deps.payload.findVersions({
+                collection: collection.slug,
+                where: {
+                    and: [{ id: { equals: input.versionId } }, { parent: { equals: input.id } }],
+                },
+                limit: 1,
+                ...enforce,
+            });
+            if (!versions.docs[0]) {
+                await deps.auditWriter({
+                    actor: { type: ctx.user ? 'user' : 'system', userId: ctx.user?.id, apiKeyName: ctx.apiKeyName },
+                    action: 'publishing.rollback',
+                    mcpServer: 'publishing',
+                    mcpTool: 'rollback',
+                    targetCollection: input.collection,
+                    targetId: input.id,
+                    success: false,
+                    errorMessage: 'Version not found for the supplied document',
+                });
+                return {
+                    restored: false,
+                    reason: `Version "${input.versionId}" not found for document "${input.id}" in "${input.collection}"`,
+                };
+            }
+            await deps.payload.restoreVersion({
+                collection: collection.slug,
+                id: input.versionId,
+                ...enforce,
+            });
+            // The version is already restored; a failed emission must not undo
+            // that or lose the audit record below.
+            const warning = await sendEventSafely(deps.options.inngest, {
+                name: 'content/page.rolled_back',
+                data: {
+                    collection: collection.slug,
+                    id: input.id,
+                    rolledBackBy: ctx.user?.id ?? 'system',
+                    toVersionId: input.versionId,
+                },
+            });
+            await deps.auditWriter({
+                actor: {
+                    type: ctx.user ? 'user' : 'system',
+                    userId: ctx.user?.id,
+                    userName: ctx.user?.name,
+                    apiKeyName: ctx.apiKeyName,
+                },
+                action: 'publishing.rollback',
+                mcpServer: 'publishing',
+                mcpTool: 'rollback',
+                targetCollection: input.collection,
+                targetId: input.id,
+                prompt: input._meta?.userPrompt,
+                reasoning: input._meta?.reasoning,
+                changesSummary: `Rolled back to version ${input.versionId}`,
+                success: true,
+            });
+            return {
+                restored: true,
+                toVersionId: input.versionId,
+                note: 'The restored content is a draft. Call `publish` to make it live.',
+                ...(warning ? { warnings: [warning] } : {}),
+            };
+        },
+    };
+}
+//# sourceMappingURL=rollback.js.map

package/dist/publishing/tools/rollback.js.map

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

package/dist/publishing/tools/schedule-publish.d.ts

@@ -0,0 +1,20 @@
+import type { Payload } from 'payload';
+import { type AuditWriter } from '../../audit/writer.js';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { PublishingPluginOptions } from '../options.js';
+import { type PublishingService } from '../service.js';
+export interface SchedulePublishToolDeps {
+    options: PublishingPluginOptions;
+    /** Injected by the plugin so every channel shares one service instance. */
+    service?: PublishingService;
+    /** Needed only when `service` is not supplied. */
+    payload?: Payload;
+    auditWriter?: AuditWriter;
+}
+/**
+ * Schedules a publish over MCP. The work is `PublishingService.schedule`, the
+ * same call the admin's Schedule control makes — so the two channels cannot
+ * disagree about what is checked, how the time is stored, or what is audited.
+ */
+export declare function createSchedulePublishTool(deps: SchedulePublishToolDeps): McpToolDefinition;
+//# sourceMappingURL=schedule-publish.d.ts.map

package/dist/publishing/tools/schedule-publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-publish.d.ts","sourceRoot":"","sources":["../../../src/publishing/tools/schedule-publish.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAI/E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,uBAAuB,CAAA;IAChC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,uBAAuB,GAAG,iBAAiB,CA6B1F"}

package/dist/publishing/tools/schedule-publish.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { withMeta } from '../../mcp/meta.js';
+import { createPublishingService } from '../service.js';
+import { resolvePublishingActor } from './actor.js';
+import { PUBLISHING_TOOLS } from './descriptors.js';
+/**
+ * Schedules a publish over MCP. The work is `PublishingService.schedule`, the
+ * same call the admin's Schedule control makes — so the two channels cannot
+ * disagree about what is checked, how the time is stored, or what is audited.
+ */
+export function createSchedulePublishTool(deps) {
+    const inputSchema = withMeta({
+        collection: z.string(),
+        id: z.string(),
+        publishAt: z
+            .string()
+            .datetime({ offset: true })
+            .describe('ISO 8601 timestamp at which the document should be published'),
+    });
+    const service = deps.service ?? createServiceFrom(deps);
+    return {
+        ...PUBLISHING_TOOLS.schedulePublish,
+        requiredScope: 'publishing.execute',
+        inputSchema,
+        handler: async (input, ctx) => {
+            const actor = resolvePublishingActor(ctx);
+            if ('error' in actor)
+                return actor;
+            return service.schedule({
+                collection: input.collection,
+                id: input.id,
+                publishAt: input.publishAt,
+                actor,
+                ...(input._meta ? { meta: input._meta } : {}),
+            });
+        },
+    };
+}
+function createServiceFrom(deps) {
+    if (!deps.payload || !deps.auditWriter) {
+        throw new Error('createSchedulePublishTool needs `service`, or `payload` and `auditWriter`');
+    }
+    return createPublishingService({
+        payload: deps.payload,
+        options: deps.options,
+        auditWriter: deps.auditWriter,
+    });
+}
+//# sourceMappingURL=schedule-publish.js.map

package/dist/publishing/tools/schedule-publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-publish.js","sourceRoot":"","sources":["../../../src/publishing/tools/schedule-publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,OAAO,EAAE,uBAAuB,EAA0B,MAAM,eAAe,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAWnD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAA6B;IACrE,MAAM,WAAW,GAAG,QAAQ,CAAC;QAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;aAC1B,QAAQ,CAAC,8DAA8D,CAAC;KAC5E,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAEvD,OAAO;QACL,GAAG,gBAAgB,CAAC,eAAe;QACnC,aAAa,EAAE,oBAAoB;QACnC,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;YACzC,IAAI,OAAO,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;YAElC,OAAO,OAAO,CAAC,QAAQ,CAAC;gBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,KAAK;gBACL,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,IAA6B;IACtD,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAA;IAC9F,CAAC;IACD,OAAO,uBAAuB,CAAC;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAA;AACJ,CAAC"}

package/dist/publishing/tools/unpublish.d.ts

@@ -0,0 +1,14 @@
+import type { Payload } from 'payload';
+import { type AuditWriter } from '../../audit/writer.js';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { PublishingPluginOptions } from '../options.js';
+import { type PublishingService } from '../service.js';
+export interface UnpublishToolDeps {
+    payload: Payload;
+    options: PublishingPluginOptions;
+    auditWriter: AuditWriter;
+    /** Injected by the plugin so every channel shares one service instance. */
+    service?: PublishingService;
+}
+export declare function createUnpublishTool(deps: UnpublishToolDeps): McpToolDefinition;
+//# sourceMappingURL=unpublish.d.ts.map

package/dist/publishing/tools/unpublish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpublish.d.ts","sourceRoot":"","sources":["../../../src/publishing/tools/unpublish.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAI/E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,uBAAuB,CAAA;IAChC,WAAW,EAAE,WAAW,CAAA;IACxB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAwB9E"}

package/dist/publishing/tools/unpublish.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { withMeta } from '../../mcp/meta.js';
+import { createPublishingService } from '../service.js';
+import { resolvePublishingActor } from './actor.js';
+import { PUBLISHING_TOOLS } from './descriptors.js';
+export function createUnpublishTool(deps) {
+    const inputSchema = withMeta({
+        collection: z.string(),
+        id: z.string(),
+    });
+    const service = deps.service ?? createPublishingService(deps);
+    return {
+        ...PUBLISHING_TOOLS.unpublish,
+        requiredScope: 'publishing.execute',
+        inputSchema,
+        handler: async (input, ctx) => {
+            const actor = resolvePublishingActor(ctx);
+            if ('error' in actor)
+                return actor;
+            return service.unpublish({
+                collection: input.collection,
+                id: input.id,
+                actor,
+                ...(input._meta ? { meta: input._meta } : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=unpublish.js.map

package/dist/publishing/tools/unpublish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpublish.js","sourceRoot":"","sources":["../../../src/publishing/tools/unpublish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,OAAO,EAAE,uBAAuB,EAA0B,MAAM,eAAe,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAUnD,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,MAAM,WAAW,GAAG,QAAQ,CAAC;QAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;KACf,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAE7D,OAAO;QACL,GAAG,gBAAgB,CAAC,SAAS;QAC7B,aAAa,EAAE,oBAAoB;QACnC,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;YACzC,IAAI,OAAO,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;YAElC,OAAO,OAAO,CAAC,SAAS,CAAC;gBACvB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,KAAK;gBACL,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/references/UsedOnPanel.d.ts

@@ -0,0 +1,3 @@
+import type { UIFieldServerComponent } from 'payload';
+export declare const UsedOnPanel: UIFieldServerComponent;
+//# sourceMappingURL=UsedOnPanel.d.ts.map

package/dist/references/UsedOnPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsedOnPanel.d.ts","sourceRoot":"","sources":["../../src/references/UsedOnPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,sBAAsB,EAAE,MAAM,SAAS,CAAA;AA6B5E,eAAO,MAAM,WAAW,EAAE,sBA8DzB,CAAA"}

package/dist/references/UsedOnPanel.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { findReferences } from './find.js';
+/*
+"Used on", in a document's sidebar.
+
+The other half of the delete guard, and the same query. Without it an editor
+cannot tell a shared asset from a single-use one: forumone-2026 had five
+`ImageHero` blocks pointing at one stock photograph and nothing in the admin
+said so, so changing the image on one page changed it on five.
+
+**A server component, so the scan runs where the data is.** A client component
+would need an endpoint of its own: a second public surface for something the
+admin already has a session for.
+
+**It renders nothing rather than failing.** A panel is an aid and the control is
+the guard. If the scan throws, the document still has to open; the guard makes
+the opposite choice, deliberately.
+
+`referencesPlugin` adds it as a sidebar `ui` field. Extra blocks, when a host
+passes any, ride on the field's `custom.references.blocks`.
+*/
+function adminHref(entry, adminRoute) {
+    return entry.global
+        ? `${adminRoute}/globals/${entry.collection}`
+        : `${adminRoute}/collections/${entry.collection}/${String(entry.id)}`;
+}
+export const UsedOnPanel = async ({ id, collectionSlug, field, payload, req, }) => {
+    // The create view has no document yet, so there is nothing to count.
+    if (id === undefined || id === null || !collectionSlug)
+        return null;
+    const blocks = field.custom
+        ?.references?.blocks;
+    let found;
+    try {
+        found = await findReferences(payload, { collection: collectionSlug, id }, {
+            req,
+            ...(blocks ? { blocks } : {}),
+        });
+    }
+    catch {
+        return null;
+    }
+    const adminRoute = payload.config.routes.admin;
+    const inBlocks = found.filter((entry) => entry.viaBlock).length;
+    return (_jsxs("div", { className: "field-type", children: [_jsx("div", { className: "field-label", children: "Used on" }), found.length === 0 ? (_jsx("p", { style: { opacity: 0.7 }, children: "Nothing uses this. It is safe to delete." })) : (_jsxs(_Fragment, { children: [_jsxs("p", { style: { opacity: 0.7 }, children: [found.length, " document", found.length === 1 ? '' : 's', ". Editing this changes", found.length === 1 ? ' it' : ' all of them', ".", inBlocks > 0 ? ` ${inBlocks} use it inside a block.` : ''] }), _jsx("ul", { style: { listStyle: 'none', margin: 0, padding: 0 }, children: found.map((entry) => (_jsxs("li", { style: { marginBottom: '.5rem' }, children: [_jsx("a", { href: adminHref(entry, adminRoute), children: entry.label }), _jsxs("div", { style: { opacity: 0.7, fontSize: '.8em' }, children: [entry.collection, entry.references.map((reference) => (_jsxs("div", { children: [reference.path, reference.viaBlock ? '' : ' (field)'] }, reference.path)))] })] }, `${entry.collection}:${String(entry.id)}`))) })] }))] }));
+};
+//# sourceMappingURL=UsedOnPanel.js.map

package/dist/references/UsedOnPanel.js.map

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

package/dist/references/find.d.ts

@@ -0,0 +1,46 @@
+import type { Block, CollectionSlug, Payload, PayloadRequest } from 'payload';
+import { type Reference } from './walk.js';
+/** One document or global that references the target. */
+export interface DocumentReferences {
+    /** The collection's slug, or the global's slug when `global` is true. */
+    collection: string;
+    id: number | string;
+    /** The document's title, name, slug or heading, or its id. */
+    label: string;
+    /** Every place inside it that points at the target. */
+    references: Reference[];
+    /** True when any reference is inside a block, and so has no foreign key. */
+    viaBlock: boolean;
+    /** True for a global, whose `id` is its slug. */
+    global?: boolean;
+}
+export interface FindReferencesOptions {
+    /** Joins the caller's transaction. A `beforeDelete` hook runs inside one. */
+    req?: PayloadRequest;
+    /**
+     * Blocks to resolve by slug beyond the config's `blocks` registry. A
+     * `blocks` field's own blocks are always used, so this is rarely needed.
+     */
+    blocks?: readonly Block[];
+}
+/** The config's block registry plus any extras, by slug. */
+export declare function blockRegistry(payload: Payload, extra?: readonly Block[]): Map<string, Block>;
+/**
+ * Every document and global that references `collection`'s document `id`,
+ * merged across the published and draft states.
+ */
+export declare function findReferences(payload: Payload, target: {
+    collection: CollectionSlug;
+    id: number | string;
+}, options?: FindReferencesOptions): Promise<DocumentReferences[]>;
+/**
+ * Every id in `collection` that anything references, from one read of the
+ * whole config. For a caller that needs the answer for a whole library at once
+ * (an "unused media" report) rather than one scan per document. Ids are
+ * strings, since a JSON block and a relationship column disagree on whether an
+ * id is a number.
+ */
+export declare function findReferencedIds(payload: Payload, collection: CollectionSlug, options?: FindReferencesOptions): Promise<Set<string>>;
+/** One line per document: `pages › Homepage (layout[2] › ImageHero › image)`. */
+export declare function describeReferences(found: readonly DocumentReferences[], limit?: number): string;
+//# sourceMappingURL=find.d.ts.map

package/dist/references/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/references/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAS,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACpF,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AA8CxE,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAA;IAClB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAA;IACjB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAA;CAC1B;AAYD,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,GAAE,SAAS,KAAK,EAAO,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAKhG;AAmED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE;IAAE,UAAU,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAC3D,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyC/B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,cAAc,EAC1B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAYtB;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,CAO1F"}