@collage-dam/mcp-server 0.1.0

package/dist/tools/bulk-tags.js

@@ -0,0 +1,220 @@
+// ── bulk_set_tags / bulk_add_tags / bulk_remove_tags ─────────────────
+// Three separate `MutatingTool` subclasses sharing a common selection
+// resolver, planning skeleton, and per-item executor. Each tool computes
+// the eventual tag set per asset deterministically in `plan()` so the
+// preview shows exactly what will land.
+//
+//   set    — replaces the current tag set with `tags`
+//   add    — union(current, tags)
+//   remove — current \ tags
+//
+// All three default to a chunk size of 50 and surface aggregate
+// overwrite-risk flags via `summary.ts` (extended in T4).
+import { z } from 'zod';
+import { MutatingTool, } from '../conventions/dry-run/index.js';
+import { createToolError } from '../conventions/errors.js';
+import { AssetSelectionSchema, resolveAssetSelection, } from './asset-selection.js';
+// ── Shared Input ─────────────────────────────────────────────────────
+const TagSchema = z.string().min(1).max(255);
+export const BulkTagsInputSchema = z.object({
+    selection: AssetSelectionSchema,
+    tags: z.array(TagSchema).min(1).max(500),
+});
+export const BULK_SET_TAGS_DESCRIPTION = 'Replace the tag set on every asset matched by `selection` with the ' +
+    'provided `tags`. Two-step: first call returns a preview plus a ' +
+    'confirmation_token; second call (with the token) executes the change in ' +
+    'batches of 50 and returns a per-item ledger. Selection accepts query, ' +
+    'ids, or collection_id (exactly one).';
+export const BULK_ADD_TAGS_DESCRIPTION = 'Add `tags` to the tag set on every asset matched by `selection` (union, ' +
+    'duplicates ignored). Two-step preview/confirm flow.';
+export const BULK_REMOVE_TAGS_DESCRIPTION = 'Remove `tags` from the tag set on every asset matched by `selection`. ' +
+    'Tags not present on an asset are ignored. Two-step preview/confirm flow.';
+function applyOp(current, inputTags, op) {
+    if (op === 'set') {
+        return dedupePreserveOrder(inputTags);
+    }
+    if (op === 'add') {
+        return dedupePreserveOrder([...current, ...inputTags]);
+    }
+    // remove
+    const drop = new Set(inputTags);
+    return current.filter((t) => !drop.has(t));
+}
+function dedupePreserveOrder(tags) {
+    const seen = new Set();
+    const out = [];
+    for (const tag of tags) {
+        if (!seen.has(tag)) {
+            seen.add(tag);
+            out.push(tag);
+        }
+    }
+    return out;
+}
+class BulkTagsTool extends MutatingTool {
+    chunkSize = 50;
+    client;
+    search;
+    collections;
+    constructor(deps) {
+        super(deps);
+        this.client = deps.client;
+        this.search = deps.search;
+        this.collections = deps.collections;
+    }
+    async plan(input) {
+        const resolved = await resolveAssetSelection(input.selection, {
+            search: this.search,
+            collections: this.collections,
+        });
+        if (!resolved.ok) {
+            throw new Error(`selection failed: ${resolved.error.code} — ${resolved.error.message}`);
+        }
+        const changes = [];
+        let overwriteCount = 0;
+        let noopCount = 0;
+        let nonExistentRemovals = 0;
+        let dataLossOnSet = 0;
+        for (const id of resolved.asset_ids) {
+            const snapshot = pickSnapshot(resolved.snapshots.get(id));
+            let currentTags;
+            if (snapshot !== null) {
+                currentTags = snapshot;
+            }
+            else {
+                const fetched = await this.client.getCurrentTags(id);
+                if (!fetched.ok) {
+                    throw new Error(`failed to read current tags for asset ${id}: ${fetched.error.code} — ${fetched.error.message}`);
+                }
+                currentTags = fetched.tags;
+            }
+            const nextTags = applyOp(currentTags, input.tags, this.op);
+            const isNoop = sameTagSet(currentTags, nextTags);
+            if (isNoop)
+                noopCount++;
+            // Overwrite/data-loss bookkeeping per operation.
+            if (this.op === 'set') {
+                // Anything in current that won't survive in next == overwrite.
+                const next = new Set(nextTags);
+                const lost = currentTags.filter((t) => !next.has(t)).length;
+                if (lost > 0) {
+                    overwriteCount++;
+                    dataLossOnSet += lost;
+                }
+            }
+            else if (this.op === 'add') {
+                // No data loss on add. Track partial-overlap as informational.
+            }
+            else if (this.op === 'remove') {
+                const cur = new Set(currentTags);
+                const present = input.tags.filter((t) => cur.has(t)).length;
+                if (present === 0)
+                    nonExistentRemovals++;
+            }
+            changes.push({
+                id,
+                operation: 'update',
+                before: { tags: currentTags },
+                after: { tags: nextTags },
+                metadata: { next_tags: nextTags },
+            });
+        }
+        const riskFlags = [];
+        if (resolved.asset_ids.length === 0) {
+            riskFlags.push({
+                code: 'empty_selection',
+                severity: 'warning',
+                message: 'selection matched zero assets',
+                count: 0,
+            });
+        }
+        if (noopCount > 0) {
+            riskFlags.push({
+                code: 'noop_tag_change',
+                severity: 'info',
+                message: 'tag operation is a no-op (no change)',
+                count: noopCount,
+            });
+        }
+        if (overwriteCount > 0) {
+            riskFlags.push({
+                code: 'tag_overwrite',
+                severity: 'critical',
+                message: `set will overwrite existing tags on ${overwriteCount} asset${overwriteCount === 1 ? '' : 's'}`,
+                count: overwriteCount,
+            });
+        }
+        if (nonExistentRemovals > 0) {
+            riskFlags.push({
+                code: 'remove_missing_tag',
+                severity: 'info',
+                message: 'no requested tag was present on the asset',
+                count: nonExistentRemovals,
+            });
+        }
+        return {
+            changes,
+            riskFlags,
+            extraAggregates: {
+                selected: resolved.asset_ids.length,
+                noops: noopCount,
+                overwrites: overwriteCount,
+                tags_lost: dataLossOnSet,
+            },
+        };
+    }
+    apply = async (change) => {
+        const before = change.before?.['tags'] ?? [];
+        const after = change.after?.['tags'] ?? [];
+        const result = await this.client.setTags(change.id, after);
+        if (!result.ok) {
+            return { ok: false, error: result.error };
+        }
+        return {
+            ok: true,
+            result: { asset_id: change.id, before_tags: before, after_tags: after },
+        };
+    };
+}
+// ── Concrete Subclasses ──────────────────────────────────────────────
+export class BulkSetTagsTool extends BulkTagsTool {
+    name = 'bulk_set_tags';
+    op = 'set';
+}
+export class BulkAddTagsTool extends BulkTagsTool {
+    name = 'bulk_add_tags';
+    op = 'add';
+}
+export class BulkRemoveTagsTool extends BulkTagsTool {
+    name = 'bulk_remove_tags';
+    op = 'remove';
+}
+export function buildBulkSetTagsTool(deps) {
+    return new BulkSetTagsTool(deps);
+}
+export function buildBulkAddTagsTool(deps) {
+    return new BulkAddTagsTool(deps);
+}
+export function buildBulkRemoveTagsTool(deps) {
+    return new BulkRemoveTagsTool(deps);
+}
+export { createToolError };
+// ── Helpers ──────────────────────────────────────────────────────────
+function pickSnapshot(asset) {
+    if (asset === undefined)
+        return null;
+    if (asset.tags === undefined)
+        return null;
+    return [...asset.tags];
+}
+function sameTagSet(a, b) {
+    if (a.length !== b.length)
+        return false;
+    const sa = new Set(a);
+    for (const tag of b) {
+        if (!sa.has(tag))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=bulk-tags.js.map

package/dist/tools/bulk-tags.js.map

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

package/dist/tools/client-adapters.d.ts

@@ -0,0 +1,76 @@
+import type { CollageClient } from '../client.js';
+import type { AssetEnumerator, AuditAsset } from './audit/audit-tagging-hygiene.js';
+import type { RenameAssetClient } from './rename-asset.js';
+import type { UpdateAssetMetadataClient } from './update-asset-metadata.js';
+import type { BulkTagsClient } from './bulk-tags.js';
+import type { CreateCollectionClient } from './create-collection.js';
+import type { UpdateCollectionClient } from './update-collection.js';
+import type { CollectionMembershipClient } from './collection-membership.js';
+import type { CreateFolderClient } from './create-folder.js';
+import type { RenameFolderClient } from './rename-folder.js';
+import type { MoveAssetClient } from './move-asset.js';
+import type { AssetSearchAdapter } from './asset-selection.js';
+import type { CollageSearchClient } from '../typesense.js';
+import { type ShareLinkEnumerator } from './insights/analyze-share-links.js';
+/**
+ * Backed by `CollageClient.enumerateAssets()` which iterates folders via
+ * `view-files-with-category`. Workspace-wide flat enumeration is otherwise
+ * Typesense-only.
+ *
+ * Returns a typed `UPSTREAM` error if folder listing 402s (current
+ * BREZ-workspace state) — the audit tool surfaces that to the caller as
+ * a structured failure instead of an empty result.
+ */
+export declare function buildAssetEnumerator(client: CollageClient): AssetEnumerator;
+/** Helper for tests / future swap-in: enumerator backed by an in-memory list. */
+export declare function fixedAssetEnumerator(assets: ReadonlyArray<AuditAsset>): AssetEnumerator;
+/**
+ * Default unavailable adapter — kept for tests and for the
+ * pre-Typesense-provisioned mode.
+ */
+export declare function buildSearchAdapter(_client: CollageClient): AssetSearchAdapter;
+/**
+ * Search adapter backed by the Collage Nuxt search proxy. Bridges the
+ * bulk-tag tools' `AssetSearchAdapter` interface to the workspace-scoped
+ * `search_assets` runner. Returns up to the first page (per_page=250) of
+ * hits, projected down to the `ResolvedAsset` shape expected by the
+ * resolver. The `tags` array is only present when the index actually
+ * has tags indexed for the row — empty when the indexer has not yet
+ * caught up.
+ */
+export declare function buildTypesenseSearchAdapter(searchClient: CollageSearchClient, workspaceId: string): AssetSearchAdapter;
+export declare function buildRenameAssetClient(client: CollageClient): RenameAssetClient;
+/**
+ * `view-detail` carries `display_file_name` and `description` directly. We
+ * map `display_file_name` onto the tool's `title` slot (the
+ * Admin-Frontend rename UI does the same — there is no separate "title"
+ * column in `digital_assets`).
+ *
+ * Custom fields come from a separate `get-custom-fields` call, projected
+ * by `name` (with `field_name` as fallback) into `Record<string, CustomFieldValue>`.
+ * Update side: we re-fetch the same projection, overwrite each `value` for
+ * the requested keys, and POST the full array back via `update-custom-fields`.
+ */
+export declare function buildUpdateAssetMetadataClient(client: CollageClient): UpdateAssetMetadataClient;
+/**
+ * Tag read uses `view-detail.tags` (array of `{id, tag_name}`). Write side:
+ * `setTags` is a full-replace — diff against current, add new via
+ * `add-tags-to-multiple-file`, remove others via
+ * `delete-tag-from-multiple-file` (called once per removed tag because the
+ * upstream takes a single `tag_name` per request).
+ */
+export declare function buildBulkTagsClient(client: CollageClient): BulkTagsClient;
+export declare function buildCreateCollectionClient(client: CollageClient): CreateCollectionClient;
+export declare function buildUpdateCollectionClient(client: CollageClient): UpdateCollectionClient;
+export declare function buildCollectionMembershipClient(client: CollageClient): CollectionMembershipClient;
+import type { CreateShareLinkClient } from './create-share-link.js';
+import type { RevokeShareLinkClient } from './revoke-share-link.js';
+export declare function buildCreateShareLinkClient(client: CollageClient): CreateShareLinkClient;
+export declare function buildRevokeShareLinkClient(client: CollageClient): RevokeShareLinkClient;
+export declare function buildCreateFolderClient(client: CollageClient): CreateFolderClient;
+export declare function buildRenameFolderClient(client: CollageClient): RenameFolderClient;
+export declare function buildMoveAssetClient(client: CollageClient): MoveAssetClient;
+export declare function buildShareLinkAnalyticsEnumerator(client: Pick<CollageClient, 'listShareLinks'>): ShareLinkEnumerator;
+import type { DashboardCommonDataReader } from './insights/report-asset-activation.js';
+export declare function buildDashboardCommonDataReader(client: Pick<CollageClient, 'getDashboardCommonData'>): DashboardCommonDataReader;
+//# sourceMappingURL=client-adapters.d.ts.map

package/dist/tools/client-adapters.d.ts.map

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