@collage-dam/mcp-server 0.1.0

package/dist/tools/bulk-normalize-filenames.js

@@ -0,0 +1,237 @@
+// ── bulk_normalize_filenames (T8, Phase 1.5) ─────────────────────────
+//
+// Mutating tool. Applies a deterministic filename normalisation function
+// to many assets in a single confirmed call. Built on the shared
+// `MutatingTool` base.
+//
+// Input shape:
+//   { asset_ids: string[], style: 'kebab-case' | 'snake_case' |
+//       'lowercase' | 'no_spaces' | 'pascal_case' | 'camel_case' }
+//
+// The plan phase looks up each asset's current name via the client,
+// computes the normalised target, and produces a per-asset diff. The
+// caller can spot-check the preview before confirming, so the operation
+// stays reversible-in-practice (each diff row shows the before name in
+// case of accidental over-aggressive normalisation).
+//
+// Notable invariants:
+//   - File extensions are preserved verbatim (only the stem is
+//     normalised), since changing the extension on `.png → .PNG` is never
+//     what callers want and renaming a `.psd` to `.png` would mislead
+//     downstream tooling.
+//   - Empty stems after normalisation fall back to the original name and
+//     surface a `would_clear_name` risk flag (critical) so the caller
+//     doesn't end up with empty / all-dot filenames.
+//   - Two assets that normalise to the same target name surface a
+//     `duplicate_target` flag (critical).
+import { z } from 'zod';
+import { MutatingTool, } from '../conventions/dry-run/index.js';
+import { createToolError } from '../conventions/errors.js';
+import { IdSchema } from '../types.js';
+// ── Input ────────────────────────────────────────────────────────────
+export const NormalizeStyleSchema = z.enum([
+    'kebab-case',
+    'snake_case',
+    'lowercase',
+    'no_spaces',
+    'PascalCase',
+    'camelCase',
+]);
+export const BulkNormalizeFilenamesInputSchema = z.object({
+    asset_ids: z.array(IdSchema).min(1).max(1000),
+    style: NormalizeStyleSchema,
+});
+export const BULK_NORMALIZE_FILENAMES_DESCRIPTION = 'Normalise asset filenames to a uniform style across many assets in ' +
+    'a single confirmed call. Supported styles: kebab-case, snake_case, ' +
+    'lowercase, no_spaces, PascalCase, camelCase. File extensions are ' +
+    'preserved verbatim. Two-step preview/confirm flow.';
+export class BulkNormalizeFilenamesTool extends MutatingTool {
+    name = 'bulk_normalize_filenames';
+    chunkSize = 50;
+    client;
+    constructor(deps) {
+        super(deps);
+        this.client = deps.client;
+    }
+    async plan(input) {
+        const changes = [];
+        let noopCount = 0;
+        let wouldClearCount = 0;
+        const targetOccurrences = new Map();
+        for (const rawId of input.asset_ids) {
+            const id = String(rawId);
+            const current = (await this.client.getCurrentName(id)) ?? '';
+            if (current.length === 0) {
+                // Surface an empty current name as a no-op + risk-flagged change so
+                // the caller can see which assets we couldn't read. We push the
+                // change anyway so the per-item ledger has a row for each input id.
+                wouldClearCount++;
+                changes.push({
+                    id,
+                    operation: 'update',
+                    before: { name: '(unknown)' },
+                    after: { name: '(unknown)' },
+                    metadata: { new_name: null },
+                });
+                continue;
+            }
+            const next = normalizeFilename(current, input.style);
+            if (next === current)
+                noopCount++;
+            const stem = stripExtension(next).stem;
+            if (stem.length === 0)
+                wouldClearCount++;
+            targetOccurrences.set(next, (targetOccurrences.get(next) ?? 0) + 1);
+            changes.push({
+                id,
+                operation: 'update',
+                before: { name: current },
+                after: { name: next },
+                metadata: { new_name: next },
+            });
+        }
+        let duplicateTargetCount = 0;
+        for (const [, count] of targetOccurrences) {
+            if (count > 1)
+                duplicateTargetCount += count;
+        }
+        const riskFlags = [];
+        if (input.asset_ids.length === 0) {
+            riskFlags.push({
+                code: 'empty_input',
+                severity: 'warning',
+                message: 'bulk_normalize_filenames received zero asset ids',
+                count: 0,
+            });
+        }
+        if (noopCount > 0) {
+            riskFlags.push({
+                code: 'noop_normalize',
+                severity: 'info',
+                message: 'name already conforms to the target style (no-op)',
+                count: noopCount,
+            });
+        }
+        if (wouldClearCount > 0) {
+            riskFlags.push({
+                code: 'would_clear_name',
+                severity: 'critical',
+                message: 'normalisation would produce an empty name; original kept (review preview row)',
+                count: wouldClearCount,
+            });
+        }
+        if (duplicateTargetCount > 0) {
+            riskFlags.push({
+                code: 'duplicate_target',
+                severity: 'critical',
+                message: 'multiple assets normalise to the same target name; the resulting workspace will have name collisions',
+                count: duplicateTargetCount,
+            });
+        }
+        return {
+            changes,
+            riskFlags,
+            extraAggregates: {
+                normalized: input.asset_ids.length,
+                noops: noopCount,
+                would_clear: wouldClearCount,
+                duplicate_targets: duplicateTargetCount,
+            },
+        };
+    }
+    apply = async (change) => {
+        const before = change.before?.['name'] ?? '(unknown)';
+        const meta = (change.metadata ?? {});
+        const newName = typeof meta.new_name === 'string' && meta.new_name.length > 0
+            ? meta.new_name
+            : null;
+        if (newName === null) {
+            return {
+                ok: false,
+                error: createToolError('VALIDATION', `change ${change.id}: no valid target name (normalisation skipped or empty)`),
+            };
+        }
+        if (newName === before) {
+            // No-op rename: report success without round-tripping the API.
+            return {
+                ok: true,
+                result: { asset_id: change.id, before_name: before, after_name: newName },
+            };
+        }
+        const result = await this.client.renameAsset(change.id, newName);
+        if (!result.ok)
+            return { ok: false, error: result.error };
+        return {
+            ok: true,
+            result: { asset_id: change.id, before_name: before, after_name: newName },
+        };
+    };
+}
+export function buildBulkNormalizeFilenamesTool(deps) {
+    return new BulkNormalizeFilenamesTool(deps);
+}
+export function stripExtension(name) {
+    const dot = name.lastIndexOf('.');
+    if (dot <= 0 || dot === name.length - 1)
+        return { stem: name, extension: '' };
+    return { stem: name.slice(0, dot), extension: name.slice(dot) };
+}
+/**
+ * Normalise a single filename. Pure function; the file extension (the
+ * portion after the final `.`) is preserved verbatim, only the stem is
+ * normalised. If the resulting stem would be empty, the original name is
+ * returned unchanged (a `would_clear_name` flag is surfaced by the plan
+ * phase so the caller is informed).
+ */
+export function normalizeFilename(name, style) {
+    const { stem, extension } = stripExtension(name);
+    const tokens = tokenize(stem);
+    if (tokens.length === 0)
+        return name;
+    let nextStem;
+    switch (style) {
+        case 'kebab-case':
+            nextStem = tokens.map((t) => t.toLowerCase()).join('-');
+            break;
+        case 'snake_case':
+            nextStem = tokens.map((t) => t.toLowerCase()).join('_');
+            break;
+        case 'lowercase':
+            nextStem = tokens.map((t) => t.toLowerCase()).join('-');
+            break;
+        case 'no_spaces':
+            // Preserve original casing but join on `-`; matches the regex
+            // `\S+` used by audit_naming_conventions.
+            nextStem = tokens.join('-');
+            break;
+        case 'PascalCase':
+            nextStem = tokens.map((t) => capitalize(t.toLowerCase())).join('');
+            break;
+        case 'camelCase':
+            nextStem = tokens
+                .map((t, i) => i === 0 ? t.toLowerCase() : capitalize(t.toLowerCase()))
+                .join('');
+            break;
+    }
+    if (nextStem.length === 0)
+        return name;
+    return `${nextStem}${extension}`;
+}
+/**
+ * Split a filename stem into tokens. Splits on whitespace, hyphens,
+ * underscores, dots, and the case boundary between a lowercase letter
+ * and an uppercase letter (so `camelCase` → ['camel', 'Case']). Empty
+ * tokens are dropped.
+ */
+function tokenize(stem) {
+    const withBoundaries = stem.replace(/([a-z0-9])([A-Z])/g, '$1 $2');
+    return withBoundaries
+        .split(/[\s\-_.]+/)
+        .filter((t) => t.length > 0);
+}
+function capitalize(s) {
+    if (s.length === 0)
+        return s;
+    return s[0].toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=bulk-normalize-filenames.js.map

package/dist/tools/bulk-normalize-filenames.js.map

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

package/dist/tools/bulk-rename-assets.d.ts

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { MutatingTool, type ApplyFn, type MutatingToolDeps, type PlanResult } from '../conventions/dry-run/index.js';
+import type { DryRunPlan } from '../conventions/dry-run/index.js';
+import { type McpToolError } from '../conventions/errors.js';
+export declare const BulkRenameAssetItemSchema: z.ZodObject<{
+    asset_id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+    /** Current name; if absent the plan looks it up via the rename client. */
+    current_name: z.ZodOptional<z.ZodString>;
+    new_name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    asset_id: string | number;
+    new_name: string;
+    current_name?: string | undefined;
+}, {
+    asset_id: string | number;
+    new_name: string;
+    current_name?: string | undefined;
+}>;
+export type BulkRenameAssetItem = z.infer<typeof BulkRenameAssetItemSchema>;
+export declare const BulkRenameAssetsInputSchema: z.ZodObject<{
+    renames: z.ZodArray<z.ZodObject<{
+        asset_id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        /** Current name; if absent the plan looks it up via the rename client. */
+        current_name: z.ZodOptional<z.ZodString>;
+        new_name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        asset_id: string | number;
+        new_name: string;
+        current_name?: string | undefined;
+    }, {
+        asset_id: string | number;
+        new_name: string;
+        current_name?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    renames: {
+        asset_id: string | number;
+        new_name: string;
+        current_name?: string | undefined;
+    }[];
+}, {
+    renames: {
+        asset_id: string | number;
+        new_name: string;
+        current_name?: string | undefined;
+    }[];
+}>;
+export type BulkRenameAssetsInput = z.infer<typeof BulkRenameAssetsInputSchema>;
+export declare const BULK_RENAME_ASSETS_DESCRIPTION: string;
+export interface BulkRenameItemResult {
+    asset_id: string;
+    before_name: string;
+    after_name: string;
+}
+export interface BulkRenameClient {
+    /** Read the current name for diff display. Returns null when unavailable. */
+    getCurrentName(assetId: string): Promise<string | null>;
+    /** Perform the rename. */
+    renameAsset(assetId: string, newName: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+}
+export interface BulkRenameAssetsDeps extends MutatingToolDeps<BulkRenameAssetsInput> {
+    client: BulkRenameClient;
+}
+export declare class BulkRenameAssetsTool extends MutatingTool<BulkRenameAssetsInput, BulkRenameItemResult> {
+    readonly name = "bulk_rename_assets";
+    protected readonly chunkSize = 50;
+    private readonly client;
+    constructor(deps: BulkRenameAssetsDeps);
+    protected plan(input: BulkRenameAssetsInput): Promise<PlanResult>;
+    protected apply: ApplyFn<BulkRenameItemResult>;
+}
+export declare function buildBulkRenameAssetsTool(deps: BulkRenameAssetsDeps): BulkRenameAssetsTool;
+export type BulkRenameAssetsPlan = DryRunPlan<BulkRenameAssetsInput>;
+//# sourceMappingURL=bulk-rename-assets.d.ts.map

package/dist/tools/bulk-rename-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-rename-assets.d.ts","sourceRoot":"","sources":["../../src/tools/bulk-rename-assets.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK9E,eAAO,MAAM,yBAAyB;;IAEpC,0EAA0E;;;;;;;;;;;EAG1E,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B;;;QANtC,0EAA0E;;;;;;;;;;;;;;;;;;;;;;;;EAQ1E,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,8BAA8B,QAIoB,CAAC;AAIhE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxD,0BAA0B;IAC1B,WAAW,CACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;CAC/D;AAID,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB,CAAC,qBAAqB,CAAC;IACnF,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,qBAAa,oBAAqB,SAAQ,YAAY,CACpD,qBAAqB,EACrB,oBAAoB,CACrB;IACC,QAAQ,CAAC,IAAI,wBAAwB;IACrC,mBAA4B,SAAS,MAAM;IAE3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,IAAI,EAAE,oBAAoB;cAKtB,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IA+EvE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAmB5C;CACH;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,oBAAoB,GACzB,oBAAoB,CAEtB;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/tools/bulk-rename-assets.js

@@ -0,0 +1,139 @@
+// ── bulk_rename_assets (T6, Phase 1.5) ───────────────────────────────
+//
+// Mutating tool. Renames many assets in a single confirmed call. Built on
+// top of the shared `MutatingTool` base (so the dry-run / confirmation /
+// per-item-ledger framework wraps the operation automatically).
+//
+// Input is a list of explicit `{ asset_id, new_name, current_name? }`
+// entries — same shape as `rename_asset`'s `RenameAssetItem`, just at the
+// bulk surface. Selection-style (query / collection_id) does NOT belong
+// here: rename is per-asset and needs a target name per asset, so callers
+// must enumerate explicitly.
+//
+// Risk flags emitted in the plan phase:
+//   - `noop_rename`         (info)     — rename to identical name
+//   - `long_name`           (warning)  — new_name longer than 200 chars
+//   - `duplicate_target`    (critical) — two items rename to the same name
+//   - `empty_input`         (warning)  — zero renames in input
+import { z } from 'zod';
+import { MutatingTool, } from '../conventions/dry-run/index.js';
+import { createToolError } from '../conventions/errors.js';
+import { IdSchema } from '../types.js';
+// ── Input ────────────────────────────────────────────────────────────
+export const BulkRenameAssetItemSchema = z.object({
+    asset_id: IdSchema,
+    /** Current name; if absent the plan looks it up via the rename client. */
+    current_name: z.string().min(1).optional(),
+    new_name: z.string().min(1).max(255),
+});
+export const BulkRenameAssetsInputSchema = z.object({
+    renames: z.array(BulkRenameAssetItemSchema).min(1).max(1000),
+});
+export const BULK_RENAME_ASSETS_DESCRIPTION = 'Rename many Collage assets in a single confirmed call. Each entry is ' +
+    '`{ asset_id, new_name, current_name? }`. Two-step: first call returns ' +
+    'a preview + confirmation_token; second call (with the token) executes ' +
+    'the renames in batches of 50 and returns a per-item ledger.';
+export class BulkRenameAssetsTool extends MutatingTool {
+    name = 'bulk_rename_assets';
+    chunkSize = 50;
+    client;
+    constructor(deps) {
+        super(deps);
+        this.client = deps.client;
+    }
+    async plan(input) {
+        const changes = [];
+        let noopCount = 0;
+        let longNameCount = 0;
+        const nameOccurrences = new Map();
+        for (const item of input.renames) {
+            const id = String(item.asset_id);
+            const before = item.current_name ?? (await this.client.getCurrentName(id)) ?? '(unknown)';
+            const isNoop = before === item.new_name;
+            if (isNoop)
+                noopCount++;
+            if (item.new_name.length > 200)
+                longNameCount++;
+            nameOccurrences.set(item.new_name, (nameOccurrences.get(item.new_name) ?? 0) + 1);
+            changes.push({
+                id,
+                operation: 'update',
+                before: { name: before },
+                after: { name: item.new_name },
+                metadata: { new_name: item.new_name },
+            });
+        }
+        let duplicateTargetCount = 0;
+        for (const [, count] of nameOccurrences) {
+            if (count > 1)
+                duplicateTargetCount += count;
+        }
+        const riskFlags = [];
+        if (input.renames.length === 0) {
+            riskFlags.push({
+                code: 'empty_input',
+                severity: 'warning',
+                message: 'bulk_rename_assets received zero rename entries',
+                count: 0,
+            });
+        }
+        if (noopCount > 0) {
+            riskFlags.push({
+                code: 'noop_rename',
+                severity: 'info',
+                message: 'rename to identical name (no-op)',
+                count: noopCount,
+            });
+        }
+        if (longNameCount > 0) {
+            riskFlags.push({
+                code: 'long_name',
+                severity: 'warning',
+                message: 'name exceeds 200 characters',
+                count: longNameCount,
+            });
+        }
+        if (duplicateTargetCount > 0) {
+            riskFlags.push({
+                code: 'duplicate_target',
+                severity: 'critical',
+                message: 'multiple items rename to the same target name; the resulting workspace will have name collisions',
+                count: duplicateTargetCount,
+            });
+        }
+        return {
+            changes,
+            riskFlags,
+            extraAggregates: {
+                renames: input.renames.length,
+                noops: noopCount,
+                long_names: longNameCount,
+                duplicate_targets: duplicateTargetCount,
+            },
+        };
+    }
+    apply = async (change) => {
+        const before = change.before?.['name'] ?? '(unknown)';
+        const meta = (change.metadata ?? {});
+        const newName = typeof meta.new_name === 'string' && meta.new_name.length > 0
+            ? meta.new_name
+            : change.after?.['name'] ?? null;
+        if (newName === null) {
+            return {
+                ok: false,
+                error: createToolError('VALIDATION', `change ${change.id} missing new_name`),
+            };
+        }
+        const result = await this.client.renameAsset(change.id, newName);
+        if (!result.ok)
+            return { ok: false, error: result.error };
+        return {
+            ok: true,
+            result: { asset_id: change.id, before_name: before, after_name: newName },
+        };
+    };
+}
+export function buildBulkRenameAssetsTool(deps) {
+    return new BulkRenameAssetsTool(deps);
+}
+//# sourceMappingURL=bulk-rename-assets.js.map

package/dist/tools/bulk-rename-assets.js.map

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

package/dist/tools/bulk-tags.d.ts

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { MutatingTool, type ApplyFn, type MutatingToolDeps, type PlanResult } from '../conventions/dry-run/index.js';
+import type { DryRunPlan } from '../conventions/dry-run/index.js';
+import { createToolError, type McpToolError } from '../conventions/errors.js';
+import { type AssetSearchAdapter, type AssetSelection, type CollectionLookup } from './asset-selection.js';
+export declare const BulkTagsInputSchema: z.ZodObject<{
+    selection: z.ZodEffects<z.ZodObject<{
+        query: z.ZodOptional<z.ZodString>;
+        ids: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>;
+        collection_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    }, "strip", z.ZodTypeAny, {
+        query?: string | undefined;
+        collection_id?: string | number | undefined;
+        ids?: (string | number)[] | undefined;
+    }, {
+        query?: string | undefined;
+        collection_id?: string | number | undefined;
+        ids?: (string | number)[] | undefined;
+    }>, {
+        query?: string | undefined;
+        collection_id?: string | number | undefined;
+        ids?: (string | number)[] | undefined;
+    }, {
+        query?: string | undefined;
+        collection_id?: string | number | undefined;
+        ids?: (string | number)[] | undefined;
+    }>;
+    tags: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    tags: string[];
+    selection: {
+        query?: string | undefined;
+        collection_id?: string | number | undefined;
+        ids?: (string | number)[] | undefined;
+    };
+}, {
+    tags: string[];
+    selection: {
+        query?: string | undefined;
+        collection_id?: string | number | undefined;
+        ids?: (string | number)[] | undefined;
+    };
+}>;
+export type BulkTagsInput = z.infer<typeof BulkTagsInputSchema>;
+export declare const BULK_SET_TAGS_DESCRIPTION: string;
+export declare const BULK_ADD_TAGS_DESCRIPTION: string;
+export declare const BULK_REMOVE_TAGS_DESCRIPTION: string;
+export interface BulkTagsItemResult {
+    asset_id: string;
+    before_tags: string[];
+    after_tags: string[];
+}
+export interface BulkTagsClient {
+    /**
+     * Read the current tag list for an asset. Returns null only if the asset
+     * itself can't be resolved (NOT_FOUND); empty array means "no tags".
+     */
+    getCurrentTags(assetId: string): Promise<{
+        ok: true;
+        tags: string[];
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+    /** Replace the tag set on an asset with the provided list. */
+    setTags(assetId: string, tags: string[]): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+}
+type BulkTagOp = 'set' | 'add' | 'remove';
+export interface BulkTagsDeps extends MutatingToolDeps<BulkTagsInput> {
+    client: BulkTagsClient;
+    search: AssetSearchAdapter;
+    collections: CollectionLookup;
+}
+declare abstract class BulkTagsTool extends MutatingTool<BulkTagsInput, BulkTagsItemResult> {
+    protected readonly chunkSize = 50;
+    protected abstract readonly op: BulkTagOp;
+    protected readonly client: BulkTagsClient;
+    protected readonly search: AssetSearchAdapter;
+    protected readonly collections: CollectionLookup;
+    constructor(deps: BulkTagsDeps);
+    protected plan(input: BulkTagsInput): Promise<PlanResult>;
+    protected apply: ApplyFn<BulkTagsItemResult>;
+}
+export declare class BulkSetTagsTool extends BulkTagsTool {
+    readonly name = "bulk_set_tags";
+    protected readonly op: BulkTagOp;
+}
+export declare class BulkAddTagsTool extends BulkTagsTool {
+    readonly name = "bulk_add_tags";
+    protected readonly op: BulkTagOp;
+}
+export declare class BulkRemoveTagsTool extends BulkTagsTool {
+    readonly name = "bulk_remove_tags";
+    protected readonly op: BulkTagOp;
+}
+export declare function buildBulkSetTagsTool(deps: BulkTagsDeps): BulkSetTagsTool;
+export declare function buildBulkAddTagsTool(deps: BulkTagsDeps): BulkAddTagsTool;
+export declare function buildBulkRemoveTagsTool(deps: BulkTagsDeps): BulkRemoveTagsTool;
+export type BulkTagsPlan = DryRunPlan<BulkTagsInput>;
+export type { AssetSelection };
+export { createToolError };
+//# sourceMappingURL=bulk-tags.d.ts.map

package/dist/tools/bulk-tags.d.ts.map

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