@collage-dam/mcp-server 0.1.0

package/dist/tools/search/types.d.ts.map

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

package/dist/tools/search/types.js

@@ -0,0 +1,216 @@
+// ── Search Tool Shared Types ─────────────────────────────────────────
+// Shared Zod schemas and TypeScript types for `search_assets` and
+// `search_collections`. The Typesense filter surface is reverse-engineered
+// from `Admin-Frontend/api/typesense.js` and the search-common-functions
+// mixin — see `docs/typesense-filter-schema.md` for clause-by-clause
+// citations.
+//
+// Conventions reused from elsewhere in the codebase:
+//   - `IdSchema` from `src/types.ts`
+//   - cursor envelope helpers from `src/conventions/pagination.ts`
+//   - response-budget hard cap from `src/conventions/response-budget.ts`
+//   - canonical error taxonomy from `src/conventions/errors.ts`
+import { z } from 'zod';
+import { IdSchema } from '../../types.js';
+import { McpToolErrorSchema } from '../../conventions/errors.js';
+// ── Sort ─────────────────────────────────────────────────────────────
+const SortDirectionSchema = z.enum(['asc', 'desc']);
+/** Single `field:direction` clause. Matches the upstream regex `[A-Za-z0-9_]+:(asc|desc)`. */
+export const SortClauseSchema = z.object({
+    field: z.string().regex(/^[A-Za-z0-9_]+$/),
+    direction: SortDirectionSchema,
+});
+/** Default applied when no sort is provided (matches the frontend's default). */
+export const DEFAULT_SORT_BY = '_text_match:desc,modified_at:desc';
+// ── Projection ───────────────────────────────────────────────────────
+/**
+ * `compact` returns minimal fields only ({id, display_file_name,
+ * thumbnail_file, modified_at}); `verbose` hydrates the full indexed
+ * field projection. Default is `compact` to keep token usage small over
+ * 10K+ asset libraries.
+ */
+export const ProjectionSchema = z.enum(['compact', 'verbose']);
+// ── Filter envelope ──────────────────────────────────────────────────
+/** Visibility maps to the numeric upstream column (0=public, 1=private). */
+export const VisibilitySchema = z.union([
+    z.literal('public'),
+    z.literal('private'),
+    z.literal(0),
+    z.literal(1),
+]);
+/**
+ * Date filter accepts either a Unix-second integer or an ISO-8601 string.
+ * Coercion happens at the wrapper layer.
+ */
+export const DateBoundSchema = z.union([
+    z.number().int().nonnegative(),
+    z.string().min(1),
+]);
+export const SearchAssetFiltersSchema = z
+    .object({
+    tags: z.array(z.string().min(1)).max(50).optional(),
+    file_type: z.array(z.string().min(1)).max(20).optional(),
+    visibility: VisibilitySchema.optional(),
+    collection_ids: z.array(IdSchema).max(50).optional(),
+    category_id: IdSchema.optional(),
+    created_after: DateBoundSchema.optional(),
+    created_before: DateBoundSchema.optional(),
+    modified_after: DateBoundSchema.optional(),
+    modified_before: DateBoundSchema.optional(),
+})
+    .strict();
+export const SearchCollectionFiltersSchema = z
+    .object({
+/** No collection-domain filters in v1 — kept as a typed slot. */
+})
+    .strict();
+// ── Inputs (tool surfaces) ───────────────────────────────────────────
+const PerPageSchema = z.number().int().min(1).max(500);
+export const SearchAssetsInputSchema = z.object({
+    q: z.string().default('*'),
+    filters: SearchAssetFiltersSchema.optional(),
+    page: z.number().int().min(1).default(1),
+    per_page: PerPageSchema.default(50),
+    sort_by: z.string().min(1).default(DEFAULT_SORT_BY),
+    projection: ProjectionSchema.default('compact'),
+    /** Optional infix override; defaults to 'fallback' at the wrapper layer. */
+    infix: z.enum(['off', 'always', 'fallback']).optional(),
+    /** Optional Typesense `query_by` override. */
+    query_by: z.string().min(1).optional(),
+});
+export const SearchCollectionsInputSchema = z.object({
+    q: z.string().default('*'),
+    filters: SearchCollectionFiltersSchema.optional(),
+    page: z.number().int().min(1).default(1),
+    per_page: PerPageSchema.default(50),
+    sort_by: z.string().min(1).default(DEFAULT_SORT_BY),
+    projection: ProjectionSchema.default('compact'),
+    query_by: z.string().min(1).optional(),
+});
+// ── Hits (Typesense projections) ─────────────────────────────────────
+/** Compact asset projection — the default `search_assets` shape. */
+export const CompactAssetHitSchema = z
+    .object({
+    id: z.union([z.string(), z.number()]),
+    display_file_name: z.string().optional().nullable(),
+    thumbnail_file: z.string().optional().nullable(),
+    modified_at: z.union([z.number(), z.string()]).optional().nullable(),
+})
+    .passthrough();
+/** Verbose asset projection — the full indexed field set. */
+export const VerboseAssetHitSchema = z
+    .object({
+    id: z.union([z.string(), z.number()]),
+    workspace_id: z.union([z.string(), z.number()]).optional().nullable(),
+    instances_id: z.union([z.string(), z.number()]).optional().nullable(),
+    display_file_name: z.string().optional().nullable(),
+    search_name: z.string().optional().nullable(),
+    description: z.string().optional().nullable(),
+    file_type: z.string().optional().nullable(),
+    type: z.string().optional().nullable(),
+    thumbnail_file: z.string().optional().nullable(),
+    compress_file: z.string().optional().nullable(),
+    video_preview: z.string().optional().nullable(),
+    display_file: z.string().optional().nullable(),
+    file_size: z.number().optional().nullable(),
+    height: z.union([z.number(), z.string()]).optional().nullable(),
+    width: z.union([z.number(), z.string()]).optional().nullable(),
+    orientation: z.string().optional().nullable(),
+    is_external_upload: z
+        .union([z.boolean(), z.number()])
+        .optional()
+        .nullable(),
+    visibility: z.number().optional().nullable(),
+    category_id: z.union([z.string(), z.number()]).optional().nullable(),
+    is_collection: z.union([z.boolean(), z.number()]).optional().nullable(),
+    collection_ids: z
+        .array(z.union([z.string(), z.number()]))
+        .optional()
+        .nullable(),
+    created_by: z.string().optional().nullable(),
+    created_by_id: z.union([z.string(), z.number()]).optional().nullable(),
+    created_at: z.union([z.number(), z.string()]).optional().nullable(),
+    modified_at: z.union([z.number(), z.string()]).optional().nullable(),
+    tags: z.array(z.string()).optional().nullable(),
+    custom_fields: z.array(z.string()).optional().nullable(),
+    // The `digital_assets` index returns `breadcrumb` as a string[]
+    // (e.g. ["20646:AI Art"]). Typed as `z.string()` until 2026-05-14,
+    // which failed every verbose row in `projectHits()` — surfacing as
+    // total>0, hits=[] (F#5). Union-typed to tolerate either shape.
+    breadcrumb: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .nullable(),
+})
+    .passthrough();
+/** Collection hit shape — matches `dam_collections` index minimal fields. */
+export const CollectionHitSchema = z
+    .object({
+    id: z.union([z.string(), z.number()]),
+    collection_name: z.string().optional().nullable(),
+    description: z.string().optional().nullable(),
+    workspace_id: z.union([z.string(), z.number()]).optional().nullable(),
+    modified_at: z.union([z.number(), z.string()]).optional().nullable(),
+    created_at: z.union([z.number(), z.string()]).optional().nullable(),
+})
+    .passthrough();
+// ── Facets ───────────────────────────────────────────────────────────
+export const FacetCountSchema = z.object({
+    value: z.string(),
+    count: z.number().int().nonnegative(),
+});
+export const SearchFacetsSchema = z.object({
+    tags: z.array(FacetCountSchema).default([]),
+    file_type: z.array(FacetCountSchema).default([]),
+    /** Bucketed `modified_at` distribution (30d, 90d, 365d, older). */
+    date_histogram: z.array(FacetCountSchema).default([]),
+    /** Typesense `_text_match` distribution buckets when available. */
+    score_distribution: z.array(FacetCountSchema).default([]),
+});
+// ── Next-step hints ──────────────────────────────────────────────────
+/**
+ * Structured next-step hints surfaced alongside search responses. These
+ * are deliberately machine-readable — the consuming LLM decides what
+ * to do with them. Mirrors the audit tool's hint-shape sibling-side.
+ */
+export const SearchNextStepHintSchema = z.object({
+    tool: z.string().min(1),
+    reason_code: z.string().min(1),
+    reason: z.string().min(1).optional(),
+    /** Suggested arguments to pass to `tool` if the LLM acts on the hint. */
+    suggested_args: z.record(z.unknown()).optional(),
+});
+// ── Outputs ──────────────────────────────────────────────────────────
+const SearchResponseBaseSchema = z.object({
+    total: z.number().int().nonnegative(),
+    page: z.number().int().min(1),
+    per_page: z.number().int().min(1),
+    next_cursor: z.string().nullable(),
+    truncated: z.boolean().default(false),
+    facets: SearchFacetsSchema,
+    next_step_hints: z.array(SearchNextStepHintSchema).default([]),
+    request_id: z.string(),
+});
+export const SearchAssetsOutputSchema = SearchResponseBaseSchema.extend({
+    hits: z.array(z.union([CompactAssetHitSchema, VerboseAssetHitSchema])),
+});
+export const SearchCollectionsOutputSchema = SearchResponseBaseSchema.extend({
+    hits: z.array(CollectionHitSchema),
+});
+export const SearchErrorOutputSchema = z.object({
+    error: McpToolErrorSchema,
+    request_id: z.string(),
+});
+// ── Defaults ─────────────────────────────────────────────────────────
+export const DEFAULT_QUERY_BY_ASSETS = 'display_file_name,search_name,description,tags,custom_fields';
+// `search_name` is the lowercased searchable field on dam_collections (verified
+// against BREZ 2026-05-05). Earlier default targeted `collection_name` and
+// `description`, neither of which is indexed — every literal query returned 0
+// hits. TODO: revert defaults when Backend Search Endpoint v1 ships and Ross's
+// controller owns server-side defaults (see
+// `.mm/notes/search-endpoint-ross-reply-05-05-2026.md`).
+export const DEFAULT_QUERY_BY_COLLECTIONS = 'search_name';
+export const DEFAULT_FACET_BY_ASSETS = 'tags,file_type,modified_at';
+export const DEFAULT_FACET_BY_COLLECTIONS = 'modified_at';
+export const DEFAULT_MAX_FACET_VALUES = 10;
+//# sourceMappingURL=types.js.map

package/dist/tools/search/types.js.map

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

package/dist/tools/update-asset-metadata.d.ts

@@ -0,0 +1,78 @@
+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 CustomFieldValueSchema: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">]>;
+export type CustomFieldValue = z.infer<typeof CustomFieldValueSchema>;
+export declare const UpdateAssetMetadataInputSchema: z.ZodEffects<z.ZodObject<{
+    asset_id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">]>>>;
+}, "strip", z.ZodTypeAny, {
+    asset_id: string | number;
+    description?: string | null | undefined;
+    custom_fields?: Record<string, string | number | boolean | (string | number)[] | null> | undefined;
+    title?: string | undefined;
+}, {
+    asset_id: string | number;
+    description?: string | null | undefined;
+    custom_fields?: Record<string, string | number | boolean | (string | number)[] | null> | undefined;
+    title?: string | undefined;
+}>, {
+    asset_id: string | number;
+    description?: string | null | undefined;
+    custom_fields?: Record<string, string | number | boolean | (string | number)[] | null> | undefined;
+    title?: string | undefined;
+}, {
+    asset_id: string | number;
+    description?: string | null | undefined;
+    custom_fields?: Record<string, string | number | boolean | (string | number)[] | null> | undefined;
+    title?: string | undefined;
+}>;
+export type UpdateAssetMetadataInput = z.infer<typeof UpdateAssetMetadataInputSchema>;
+export declare const UPDATE_ASSET_METADATA_DESCRIPTION: string;
+export interface UpdateAssetMetadataItemResult {
+    asset_id: string;
+    fields_updated: string[];
+}
+export interface AssetMetadataSnapshot {
+    title: string | null;
+    description: string | null;
+    custom_fields: Record<string, CustomFieldValue>;
+}
+export interface UpdateAssetMetadataClient {
+    /** Read the current metadata snapshot for an asset (for diff display). */
+    getMetadata(assetId: string): Promise<{
+        ok: true;
+        snapshot: AssetMetadataSnapshot;
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+    /** Apply the metadata change. Returns ok or a typed error. */
+    updateMetadata(assetId: string, patch: {
+        title?: string;
+        description?: string | null;
+        custom_fields?: Record<string, CustomFieldValue>;
+    }): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+}
+export interface UpdateAssetMetadataDeps extends MutatingToolDeps<UpdateAssetMetadataInput> {
+    client: UpdateAssetMetadataClient;
+}
+export declare class UpdateAssetMetadataTool extends MutatingTool<UpdateAssetMetadataInput, UpdateAssetMetadataItemResult> {
+    readonly name = "update_asset_metadata";
+    protected readonly chunkSize = 1;
+    private readonly client;
+    constructor(deps: UpdateAssetMetadataDeps);
+    protected plan(input: UpdateAssetMetadataInput): Promise<PlanResult>;
+    protected apply: ApplyFn<UpdateAssetMetadataItemResult>;
+}
+export declare function buildUpdateAssetMetadataTool(deps: UpdateAssetMetadataDeps): UpdateAssetMetadataTool;
+export type UpdateAssetMetadataPlan = DryRunPlan<UpdateAssetMetadataInput>;
+//# sourceMappingURL=update-asset-metadata.d.ts.map

package/dist/tools/update-asset-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-asset-metadata.d.ts","sourceRoot":"","sources":["../../src/tools/update-asset-metadata.ts"],"names":[],"mappings":"AAYA,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,sBAAsB,6HAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;EAgBxC,CAAC;AACJ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,iCAAiC,QAKW,CAAC;AAI1D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAID,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,yBAAyB;IACxC,0EAA0E;IAC1E,WAAW,CACT,OAAO,EAAE,MAAM,GACd,OAAO,CACN;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,qBAAqB,CAAA;KAAE,GAC7C;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CACrC,CAAC;IACF,8DAA8D;IAC9D,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;KAClD,GACA,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,uBACf,SAAQ,gBAAgB,CAAC,wBAAwB,CAAC;IAClD,MAAM,EAAE,yBAAyB,CAAC;CACnC;AAED,qBAAa,uBAAwB,SAAQ,YAAY,CACvD,wBAAwB,EACxB,6BAA6B,CAC9B;IACC,QAAQ,CAAC,IAAI,2BAA2B;IACxC,mBAA4B,SAAS,KAAK;IAE1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEvC,IAAI,EAAE,uBAAuB;cAKzB,IAAI,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqH1E,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,6BAA6B,CAAC,CA4CrD;CACH;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,uBAAuB,GAC5B,uBAAuB,CAEzB;AAED,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/tools/update-asset-metadata.js

@@ -0,0 +1,203 @@
+// ── update_asset_metadata ────────────────────────────────────────────
+// Single-asset metadata edit (title / description / custom fields). Wraps
+// the dry-run framework like `rename_asset` does, so every call is a
+// plan → preview → execute round-trip. Bulk metadata edits are deferred to
+// Phase 1.5 (`bulk_update_metadata`).
+//
+// The "title" surface here maps onto the asset's `display_file_name` field
+// in the Collage REST API; `description` is the first-class column. Custom
+// fields are passed through as a map of `{ field_id|field_name: value }`
+// pairs and forwarded to the upstream PATCH so the server does not own the
+// schema.
+import { z } from 'zod';
+import { MutatingTool, } from '../conventions/dry-run/index.js';
+import { createToolError } from '../conventions/errors.js';
+import { IdSchema } from '../types.js';
+// ── Tool I/O Schema ──────────────────────────────────────────────────
+export const CustomFieldValueSchema = z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(z.union([z.string(), z.number()])),
+]);
+export const UpdateAssetMetadataInputSchema = z
+    .object({
+    asset_id: IdSchema,
+    title: z.string().min(1).max(255).optional(),
+    description: z.string().max(10_000).nullable().optional(),
+    custom_fields: z.record(CustomFieldValueSchema).optional(),
+})
+    .refine((input) => input.title !== undefined ||
+    input.description !== undefined ||
+    input.custom_fields !== undefined, {
+    message: 'At least one of `title`, `description`, or `custom_fields` must be provided.',
+});
+export const UPDATE_ASSET_METADATA_DESCRIPTION = 'Update title, description, and/or custom fields on a single Collage asset. ' +
+    'Two-step: first call returns a preview plus a confirmation_token; second ' +
+    'call (with the token) applies the change and returns a per-item ledger. ' +
+    'Use bulk_set_tags / bulk_add_tags / bulk_remove_tags for multi-asset tag ' +
+    'edits; bulk metadata edits are deferred to Phase 1.5.';
+export class UpdateAssetMetadataTool extends MutatingTool {
+    name = 'update_asset_metadata';
+    chunkSize = 1;
+    client;
+    constructor(deps) {
+        super(deps);
+        this.client = deps.client;
+    }
+    async plan(input) {
+        const id = String(input.asset_id);
+        const snapshot = await this.client.getMetadata(id);
+        if (!snapshot.ok) {
+            throw new Error(`failed to read current metadata for asset ${id}: ${snapshot.error.code} — ${snapshot.error.message}`);
+        }
+        const before = {};
+        const after = {};
+        const fieldsChanged = [];
+        const overwrittenCustomFields = [];
+        let titleOverwrite = false;
+        let descriptionOverwrite = false;
+        if (input.title !== undefined) {
+            before['title'] = snapshot.snapshot.title;
+            after['title'] = input.title;
+            if (snapshot.snapshot.title !== input.title) {
+                fieldsChanged.push('title');
+                if (snapshot.snapshot.title !== null &&
+                    snapshot.snapshot.title !== '' &&
+                    snapshot.snapshot.title !== input.title) {
+                    titleOverwrite = true;
+                }
+            }
+        }
+        if (input.description !== undefined) {
+            before['description'] = snapshot.snapshot.description;
+            after['description'] = input.description;
+            if (snapshot.snapshot.description !== input.description) {
+                fieldsChanged.push('description');
+                if (snapshot.snapshot.description !== null &&
+                    snapshot.snapshot.description !== '' &&
+                    snapshot.snapshot.description !== input.description) {
+                    descriptionOverwrite = true;
+                }
+            }
+        }
+        if (input.custom_fields !== undefined) {
+            const beforeCf = {};
+            const afterCf = {};
+            for (const [key, newValue] of Object.entries(input.custom_fields)) {
+                const existing = snapshot.snapshot.custom_fields[key];
+                beforeCf[key] = existing ?? null;
+                afterCf[key] = newValue;
+                if (!shallowEqualValue(existing, newValue)) {
+                    fieldsChanged.push(`custom_fields.${key}`);
+                    if (existing !== undefined &&
+                        existing !== null &&
+                        !(typeof existing === 'string' && existing === '')) {
+                        overwrittenCustomFields.push(key);
+                    }
+                }
+            }
+            before['custom_fields'] = beforeCf;
+            after['custom_fields'] = afterCf;
+        }
+        const change = {
+            id,
+            operation: 'update',
+            before,
+            after,
+            metadata: {
+                // Forwarded to apply() so the executor doesn't need to re-derive.
+                ...(input.title !== undefined ? { title: input.title } : {}),
+                ...(input.description !== undefined
+                    ? { description: input.description }
+                    : {}),
+                ...(input.custom_fields !== undefined
+                    ? { custom_fields: input.custom_fields }
+                    : {}),
+            },
+        };
+        const riskFlags = [];
+        if (fieldsChanged.length === 0) {
+            riskFlags.push({
+                code: 'noop_metadata_update',
+                severity: 'info',
+                message: 'all proposed values match current values (no-op)',
+                count: 1,
+            });
+        }
+        const overwriteCount = (titleOverwrite ? 1 : 0) +
+            (descriptionOverwrite ? 1 : 0) +
+            overwrittenCustomFields.length;
+        if (overwriteCount > 0) {
+            riskFlags.push({
+                code: 'metadata_overwrite',
+                severity: 'warning',
+                message: 'will overwrite existing values on this asset',
+                count: overwriteCount,
+            });
+        }
+        return {
+            changes: [change],
+            riskFlags,
+            extraAggregates: {
+                fields_changed: fieldsChanged.length,
+                overwrites: overwriteCount,
+            },
+        };
+    }
+    apply = async (change) => {
+        const meta = (change.metadata ?? {});
+        const patch = {};
+        const fieldsUpdated = [];
+        if (meta.title !== undefined) {
+            patch.title = meta.title;
+            fieldsUpdated.push('title');
+        }
+        if (meta.description !== undefined) {
+            patch.description = meta.description;
+            fieldsUpdated.push('description');
+        }
+        if (meta.custom_fields !== undefined) {
+            patch.custom_fields = meta.custom_fields;
+            for (const key of Object.keys(meta.custom_fields)) {
+                fieldsUpdated.push(`custom_fields.${key}`);
+            }
+        }
+        if (fieldsUpdated.length === 0) {
+            return {
+                ok: false,
+                error: createToolError('VALIDATION', `change ${change.id} carries no metadata patch`),
+            };
+        }
+        const result = await this.client.updateMetadata(change.id, patch);
+        if (!result.ok) {
+            return { ok: false, error: result.error };
+        }
+        return {
+            ok: true,
+            result: { asset_id: change.id, fields_updated: fieldsUpdated },
+        };
+    };
+}
+export function buildUpdateAssetMetadataTool(deps) {
+    return new UpdateAssetMetadataTool(deps);
+}
+// ── Helpers ──────────────────────────────────────────────────────────
+function shallowEqualValue(a, b) {
+    if (a === b)
+        return true;
+    if (a === undefined || a === null || b === null)
+        return a === b;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i++) {
+            if (a[i] !== b[i])
+                return false;
+        }
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=update-asset-metadata.js.map

package/dist/tools/update-asset-metadata.js.map

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

package/dist/tools/update-collection.d.ts

@@ -0,0 +1,69 @@
+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 UpdateCollectionInputSchema: z.ZodEffects<z.ZodObject<{
+    collection_id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    collection_id: string | number;
+    description?: string | null | undefined;
+    name?: string | undefined;
+}, {
+    collection_id: string | number;
+    description?: string | null | undefined;
+    name?: string | undefined;
+}>, {
+    collection_id: string | number;
+    description?: string | null | undefined;
+    name?: string | undefined;
+}, {
+    collection_id: string | number;
+    description?: string | null | undefined;
+    name?: string | undefined;
+}>;
+export type UpdateCollectionInput = z.infer<typeof UpdateCollectionInputSchema>;
+export declare const UPDATE_COLLECTION_DESCRIPTION: string;
+export interface UpdateCollectionItemResult {
+    collection_id: string;
+    fields_updated: string[];
+}
+export interface CollectionMetadataSnapshot {
+    name: string | null;
+    description: string | null;
+}
+export interface UpdateCollectionClient {
+    /** Read the current metadata snapshot for a collection (for diff display). */
+    getCollectionMetadata(collectionId: string): Promise<{
+        ok: true;
+        snapshot: CollectionMetadataSnapshot;
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+    /** Apply the metadata change. Returns ok or a typed error. */
+    updateCollectionMetadata(collectionId: string, patch: {
+        name?: string;
+        description?: string | null;
+    }): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+}
+export interface UpdateCollectionDeps extends MutatingToolDeps<UpdateCollectionInput> {
+    client: UpdateCollectionClient;
+}
+export declare class UpdateCollectionTool extends MutatingTool<UpdateCollectionInput, UpdateCollectionItemResult> {
+    readonly name = "update_collection";
+    protected readonly chunkSize = 1;
+    private readonly client;
+    constructor(deps: UpdateCollectionDeps);
+    protected plan(input: UpdateCollectionInput): Promise<PlanResult>;
+    protected apply: ApplyFn<UpdateCollectionItemResult>;
+}
+export declare function buildUpdateCollectionTool(deps: UpdateCollectionDeps): UpdateCollectionTool;
+export type UpdateCollectionPlan = DryRunPlan<UpdateCollectionInput>;
+//# sourceMappingURL=update-collection.d.ts.map

package/dist/tools/update-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-collection.d.ts","sourceRoot":"","sources":["../../src/tools/update-collection.ts"],"names":[],"mappings":"AAUA,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,2BAA2B;;;;;;;;;;;;;;;;;;;;EAYrC,CAAC;AACJ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,6BAA6B,QAK/B,CAAC;AAIZ,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAID,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,qBAAqB,CACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CACN;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,0BAA0B,CAAA;KAAE,GAClD;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CACrC,CAAC;IACF,8DAA8D;IAC9D,wBAAwB,CACtB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GACpD,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,oBACf,SAAQ,gBAAgB,CAAC,qBAAqB,CAAC;IAC/C,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,qBAAa,oBAAqB,SAAQ,YAAY,CACpD,qBAAqB,EACrB,0BAA0B,CAC3B;IACC,QAAQ,CAAC,IAAI,uBAAuB;IACpC,mBAA4B,SAAS,KAAK;IAE1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAEpC,IAAI,EAAE,oBAAoB;cAKtB,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAwFvE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAiClD;CACH;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,oBAAoB,GACzB,oBAAoB,CAEtB;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC"}