@collage-dam/mcp-server 0.1.0

package/dist/tools/rename-folder.d.ts

@@ -0,0 +1,55 @@
+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 RenameFolderInputSchema: z.ZodObject<{
+    category_id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+    new_name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Optional current name for diff display; looked up if absent. */
+    current_name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    category_id: string | number;
+    new_name: string;
+    description?: string | null | undefined;
+    current_name?: string | undefined;
+}, {
+    category_id: string | number;
+    new_name: string;
+    description?: string | null | undefined;
+    current_name?: string | undefined;
+}>;
+export type RenameFolderInput = z.infer<typeof RenameFolderInputSchema>;
+export declare const RENAME_FOLDER_DESCRIPTION: string;
+export interface RenameFolderItemResult {
+    folder_id: string;
+    new_name: string;
+    description: string | null;
+}
+export interface RenameFolderClient {
+    /** Lookup current name for diff display. Returns null if unavailable. */
+    getCurrentFolderName(categoryId: string): Promise<string | null>;
+    renameFolder(input: {
+        category_id: string;
+        folder_name: string;
+        description?: string | null;
+    }): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+}
+export interface RenameFolderDeps extends MutatingToolDeps<RenameFolderInput> {
+    client: RenameFolderClient;
+}
+export declare class RenameFolderTool extends MutatingTool<RenameFolderInput, RenameFolderItemResult> {
+    readonly name = "rename_folder";
+    protected readonly chunkSize = 1;
+    private readonly client;
+    constructor(deps: RenameFolderDeps);
+    protected plan(input: RenameFolderInput): Promise<PlanResult>;
+    protected apply: ApplyFn<RenameFolderItemResult>;
+}
+export type RenameFolderPlan = DryRunPlan<RenameFolderInput>;
+//# sourceMappingURL=rename-folder.d.ts.map

package/dist/tools/rename-folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-folder.d.ts","sourceRoot":"","sources":["../../src/tools/rename-folder.ts"],"names":[],"mappings":"AASA,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;AAG9E,eAAO,MAAM,uBAAuB;;;;IAIlC,mEAAmE;;;;;;;;;;;;EAEnE,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,yBAAyB,QAGG,CAAC;AAE1C,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjE,YAAY,CAAC,KAAK,EAAE;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB,CAAC,iBAAiB,CAAC;IAC3E,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,qBAAa,gBAAiB,SAAQ,YAAY,CAChD,iBAAiB,EACjB,sBAAsB,CACvB;IACC,QAAQ,CAAC,IAAI,mBAAmB;IAChC,mBAA4B,SAAS,KAAK;IAE1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBAEhC,IAAI,EAAE,gBAAgB;cAKlB,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IA6CnE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,sBAAsB,CAAC,CA0C9C;CACH;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/tools/rename-folder.js

@@ -0,0 +1,101 @@
+// ── rename_folder ────────────────────────────────────────────────────
+// Renames one folder, optionally updating its description. Two-step
+// dry-run flow.
+//
+// Upstream surface:
+//   POST digital-assets/category/rename/{id}  { workspace_id, folder_name, description? }
+//
+// MVP scope: one folder per call. Bulk rename is Phase 1.5.
+import { z } from 'zod';
+import { MutatingTool, } from '../conventions/dry-run/index.js';
+import { createToolError } from '../conventions/errors.js';
+import { IdSchema } from '../types.js';
+export const RenameFolderInputSchema = z.object({
+    category_id: IdSchema,
+    new_name: z.string().min(1).max(255),
+    description: z.string().max(10_000).nullable().optional(),
+    /** Optional current name for diff display; looked up if absent. */
+    current_name: z.string().optional(),
+});
+export const RENAME_FOLDER_DESCRIPTION = 'Rename a folder (and optionally update its description). Two-step: ' +
+    'first call returns a preview plus a confirmation_token; second call ' +
+    '(with the token) executes the rename.';
+export class RenameFolderTool extends MutatingTool {
+    name = 'rename_folder';
+    chunkSize = 1;
+    client;
+    constructor(deps) {
+        super(deps);
+        this.client = deps.client;
+    }
+    async plan(input) {
+        const id = String(input.category_id);
+        const before = input.current_name ??
+            (await this.client.getCurrentFolderName(id)) ??
+            '(unknown)';
+        const after = { folder_name: input.new_name };
+        if (input.description !== undefined) {
+            after['description'] = input.description ?? '';
+        }
+        const change = {
+            id,
+            operation: 'update',
+            before: { folder_name: before },
+            after,
+            metadata: {
+                category_id: id,
+                new_name: input.new_name,
+                description: input.description ?? null,
+            },
+        };
+        const riskFlags = [];
+        if (before === input.new_name) {
+            riskFlags.push({
+                code: 'noop_rename',
+                severity: 'info',
+                message: 'rename to identical name (no-op)',
+                count: 1,
+            });
+        }
+        if (input.new_name.length > 100) {
+            riskFlags.push({
+                code: 'long_folder_name',
+                severity: 'warning',
+                message: 'name exceeds 100 characters',
+                count: 1,
+            });
+        }
+        return { changes: [change], riskFlags };
+    }
+    apply = async (change) => {
+        const meta = (change.metadata ?? {});
+        if (typeof meta.category_id !== 'string' ||
+            typeof meta.new_name !== 'string' ||
+            meta.new_name.length === 0) {
+            return {
+                ok: false,
+                error: createToolError('VALIDATION', `change ${change.id} missing category_id or new_name`),
+            };
+        }
+        const callInput = {
+            category_id: meta.category_id,
+            folder_name: meta.new_name,
+        };
+        if (meta.description !== undefined && meta.description !== null) {
+            callInput.description = meta.description;
+        }
+        const result = await this.client.renameFolder(callInput);
+        if (!result.ok) {
+            return { ok: false, error: result.error };
+        }
+        return {
+            ok: true,
+            result: {
+                folder_id: meta.category_id,
+                new_name: meta.new_name,
+                description: meta.description ?? null,
+            },
+        };
+    };
+}
+//# sourceMappingURL=rename-folder.js.map

package/dist/tools/rename-folder.js.map

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

package/dist/tools/revoke-share-link.d.ts

@@ -0,0 +1,55 @@
+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 RevokeShareLinkInputSchema: z.ZodObject<{
+    share_id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+}, "strip", z.ZodTypeAny, {
+    share_id: string | number;
+}, {
+    share_id: string | number;
+}>;
+export type RevokeShareLinkInput = z.infer<typeof RevokeShareLinkInputSchema>;
+export declare const REVOKE_SHARE_LINK_DESCRIPTION: string;
+export interface RevokeShareLinkItemResult {
+    share_id: string;
+    revoked: true;
+}
+export interface ShareLinkSnapshot {
+    id: string;
+    title: string | null;
+    share_url: string | null;
+    expiration: string | null;
+    password_protected: boolean;
+}
+export interface RevokeShareLinkClient {
+    /** Read the current state of the share link for diff display. */
+    getShareLink(shareId: string): Promise<{
+        ok: true;
+        snapshot: ShareLinkSnapshot;
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+    /** Revoke the share link. */
+    revokeShareLink(shareId: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: McpToolError;
+    }>;
+}
+export interface RevokeShareLinkDeps extends MutatingToolDeps<RevokeShareLinkInput> {
+    client: RevokeShareLinkClient;
+}
+export declare class RevokeShareLinkTool extends MutatingTool<RevokeShareLinkInput, RevokeShareLinkItemResult> {
+    readonly name = "revoke_share_link";
+    protected readonly chunkSize = 1;
+    private readonly client;
+    constructor(deps: RevokeShareLinkDeps);
+    protected plan(input: RevokeShareLinkInput): Promise<PlanResult>;
+    protected apply: ApplyFn<RevokeShareLinkItemResult>;
+}
+export declare function buildRevokeShareLinkTool(deps: RevokeShareLinkDeps): RevokeShareLinkTool;
+export type RevokeShareLinkPlan = DryRunPlan<RevokeShareLinkInput>;
+//# sourceMappingURL=revoke-share-link.d.ts.map

package/dist/tools/revoke-share-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revoke-share-link.d.ts","sourceRoot":"","sources":["../../src/tools/revoke-share-link.ts"],"names":[],"mappings":"AAcA,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,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,eAAO,MAAM,0BAA0B;;;;;;EAErC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,6BAA6B,QAIF,CAAC;AAIzC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,IAAI,CAAC;CACf;AAID,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,YAAY,CACV,OAAO,EAAE,MAAM,GACd,OAAO,CACN;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAA;KAAE,GACzC;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CACrC,CAAC;IACF,6BAA6B;IAC7B,eAAe,CACb,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,mBACf,SAAQ,gBAAgB,CAAC,oBAAoB,CAAC;IAC9C,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,qBAAa,mBAAoB,SAAQ,YAAY,CACnD,oBAAoB,EACpB,yBAAyB,CAC1B;IACC,QAAQ,CAAC,IAAI,uBAAuB;IACpC,mBAA4B,SAAS,KAAK;IAE1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,IAAI,EAAE,mBAAmB;cAKrB,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAsCtE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,yBAAyB,CAAC,CASjD;CACH;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,mBAAmB,GACxB,mBAAmB,CAErB;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/tools/revoke-share-link.js

@@ -0,0 +1,77 @@
+// ── revoke_share_link ────────────────────────────────────────────────
+// Revokes a single share link — once revoked, the URL stops working.
+// Wraps the dry-run framework so the preview shows the link being revoked
+// plus its current state before execute.
+//
+// Upstream surface (verified via Admin-Frontend
+// `pages/_workspace_id/dam/sharing/index.vue:1059`):
+//   POST digital-assets/dashboard/delete-share-assets-url
+//     body: { workspace_id, share_url_id: number[] }
+//
+// We send a single-id list because this tool is one-at-a-time. Bulk
+// revocation can be layered on later via the same upstream endpoint
+// (`delete-multiple-share-assets-url`) if SOW priorities shift.
+import { z } from 'zod';
+import { MutatingTool, } from '../conventions/dry-run/index.js';
+import { IdSchema } from '../types.js';
+// ── Tool I/O Schema ──────────────────────────────────────────────────
+export const RevokeShareLinkInputSchema = z.object({
+    share_id: IdSchema,
+});
+export const REVOKE_SHARE_LINK_DESCRIPTION = 'Revoke a single share link. Two-step: first call returns a preview ' +
+    '(with the link being revoked and its current state) plus a ' +
+    'confirmation_token; second call (with the token) executes the revoke. ' +
+    'Once revoked, the URL stops working.';
+export class RevokeShareLinkTool extends MutatingTool {
+    name = 'revoke_share_link';
+    chunkSize = 1;
+    client;
+    constructor(deps) {
+        super(deps);
+        this.client = deps.client;
+    }
+    async plan(input) {
+        const id = String(input.share_id);
+        const snap = await this.client.getShareLink(id);
+        if (!snap.ok) {
+            throw new Error(`failed to read share link ${id}: ${snap.error.code} — ${snap.error.message}`);
+        }
+        const before = {
+            id: snap.snapshot.id,
+            title: snap.snapshot.title,
+            share_url: snap.snapshot.share_url,
+            expiration: snap.snapshot.expiration,
+            password_protected: snap.snapshot.password_protected,
+            revoked: false,
+        };
+        const after = { ...before, revoked: true };
+        const change = {
+            id,
+            operation: 'delete',
+            before,
+            after,
+        };
+        const riskFlags = [];
+        riskFlags.push({
+            code: 'irreversible',
+            severity: 'warning',
+            message: 'Revoke is irreversible: once executed, the share URL stops working immediately and recipients lose access.',
+            count: 1,
+        });
+        return { changes: [change], riskFlags };
+    }
+    apply = async (change) => {
+        const result = await this.client.revokeShareLink(change.id);
+        if (!result.ok) {
+            return { ok: false, error: result.error };
+        }
+        return {
+            ok: true,
+            result: { share_id: change.id, revoked: true },
+        };
+    };
+}
+export function buildRevokeShareLinkTool(deps) {
+    return new RevokeShareLinkTool(deps);
+}
+//# sourceMappingURL=revoke-share-link.js.map

package/dist/tools/revoke-share-link.js.map

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

package/dist/tools/search/facets.d.ts

@@ -0,0 +1,34 @@
+import type { RawFacetCount } from '../../typesense.js';
+import type { CompactAssetHit, SearchFacets, SearchNextStepHint, VerboseAssetHit } from './types.js';
+/**
+ * Project raw Typesense facet counts into the structured `SearchFacets`
+ * block. Unknown facet fields are dropped on the floor — we only surface
+ * the ones the spec explicitly enumerates.
+ */
+export declare function buildSearchFacets(rawFacets: ReadonlyArray<RawFacetCount>, hits: ReadonlyArray<CompactAssetHit | VerboseAssetHit>, topN?: number): SearchFacets;
+interface HintGeneratorContext {
+    found: number;
+    truncated: boolean;
+    /** Has at least one tag been returned? Used to avoid a hint when no tags exist. */
+    hasTags: boolean;
+    /** Number of hits where `tags` is empty/missing. */
+    untaggedCount: number;
+}
+/**
+ * Generate structured next-step hints for a `search_assets` response.
+ * Hints are emitted only when there is something *useful* to suggest —
+ * empty arrays mean "no obvious next step." Consumers can chain these
+ * into multi-tool LLM workflows without re-interpreting search results.
+ */
+export declare function buildAssetSearchNextSteps(ctx: HintGeneratorContext): SearchNextStepHint[];
+/**
+ * Next-step hints for `search_collections` — currently lighter than the
+ * asset side because the dam_collections index has fewer signals to act
+ * on. Surfaces a single hint when results are empty so the LLM can fall
+ * back to `list_collections`.
+ */
+export declare function buildCollectionSearchNextSteps(found: number): SearchNextStepHint[];
+/** Count untagged hits in a verbose projection. Compact projection has no tags column. */
+export declare function countUntagged(hits: ReadonlyArray<CompactAssetHit | VerboseAssetHit>): number;
+export {};
+//# sourceMappingURL=facets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facets.d.ts","sourceRoot":"","sources":["../../../src/tools/search/facets.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACZ,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,EACvC,IAAI,EAAE,aAAa,CAAC,eAAe,GAAG,eAAe,CAAC,EACtD,IAAI,SAAK,GACR,YAAY,CAkCd;AAqCD,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,oBAAoB,GACxB,kBAAkB,EAAE,CA8BtB;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,GACZ,kBAAkB,EAAE,CAWtB;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAC3B,IAAI,EAAE,aAAa,CAAC,eAAe,GAAG,eAAe,CAAC,GACrD,MAAM,CAUR"}

package/dist/tools/search/facets.js

@@ -0,0 +1,147 @@
+// ── Facets + Next-step hints generator ───────────────────────────────
+// Shapes the raw Typesense `facet_counts` array into the structured
+// `SearchFacets` block declared in `./types.ts`, and produces a list of
+// machine-readable `next_step_hints` based on what the search returned.
+//
+// Both generators are pure — given the same inputs they emit the same
+// outputs, which makes them trivial to unit-test without touching
+// Typesense.
+/**
+ * Project raw Typesense facet counts into the structured `SearchFacets`
+ * block. Unknown facet fields are dropped on the floor — we only surface
+ * the ones the spec explicitly enumerates.
+ */
+export function buildSearchFacets(rawFacets, hits, topN = 10) {
+    const facets = {
+        tags: [],
+        file_type: [],
+        date_histogram: [],
+        score_distribution: [],
+    };
+    for (const f of rawFacets) {
+        const counts = f.counts.slice(0, topN).map((c) => ({
+            value: c.value,
+            count: c.count,
+        }));
+        if (f.field_name === 'tags')
+            facets.tags = counts;
+        else if (f.field_name === 'file_type')
+            facets.file_type = counts;
+        else if (f.field_name === 'modified_at') {
+            facets.date_histogram = bucketDateFacets(counts);
+        }
+    }
+    // Score distribution — Typesense doesn't surface this as a facet, so we
+    // synthesise it from the hit-side (each hit's `_text_match` would need
+    // to be passed down for a true distribution). Keeping it empty here is
+    // intentional; richer scoring lives in the verbose-projection path
+    // when we hydrate via `view-detail`.
+    if (hits.length === 0) {
+        facets.score_distribution = [];
+    }
+    else {
+        facets.score_distribution = [
+            { value: 'returned', count: hits.length },
+        ];
+    }
+    return facets;
+}
+/**
+ * Bucket raw `modified_at` facet values (already strings of unix-seconds)
+ * into the four canonical buckets: 30d, 90d, 365d, older.
+ */
+function bucketDateFacets(counts) {
+    const now = Math.floor(Date.now() / 1000);
+    const day = 86_400;
+    const buckets = {
+        '30d': 0,
+        '90d': 0,
+        '365d': 0,
+        older: 0,
+    };
+    for (const c of counts) {
+        const ts = Number(c.value);
+        if (!Number.isFinite(ts)) {
+            buckets.older += c.count;
+            continue;
+        }
+        const ageDays = (now - ts) / day;
+        if (ageDays <= 30)
+            buckets['30d'] += c.count;
+        else if (ageDays <= 90)
+            buckets['90d'] += c.count;
+        else if (ageDays <= 365)
+            buckets['365d'] += c.count;
+        else
+            buckets.older += c.count;
+    }
+    return [
+        { value: '30d', count: buckets['30d'] },
+        { value: '90d', count: buckets['90d'] },
+        { value: '365d', count: buckets['365d'] },
+        { value: 'older', count: buckets.older },
+    ];
+}
+/**
+ * Generate structured next-step hints for a `search_assets` response.
+ * Hints are emitted only when there is something *useful* to suggest —
+ * empty arrays mean "no obvious next step." Consumers can chain these
+ * into multi-tool LLM workflows without re-interpreting search results.
+ */
+export function buildAssetSearchNextSteps(ctx) {
+    const hints = [];
+    if (ctx.untaggedCount > 0) {
+        hints.push({
+            tool: 'audit_tagging_hygiene',
+            reason_code: 'untagged_assets_found',
+            reason: `${ctx.untaggedCount} hit(s) have no tags — consider running the tagging-hygiene audit.`,
+        });
+    }
+    if (ctx.truncated) {
+        hints.push({
+            tool: 'search_assets',
+            reason_code: 'response_truncated',
+            reason: 'Result page was hard-capped to stay under the response budget. Use the returned next_cursor to continue.',
+        });
+    }
+    if (ctx.found > 1000) {
+        hints.push({
+            tool: 'search_assets',
+            reason_code: 'large_result_set',
+            reason: 'Result set is large; consider narrowing with tag/file_type/date filters before bulk operations.',
+        });
+    }
+    return hints;
+}
+/**
+ * Next-step hints for `search_collections` — currently lighter than the
+ * asset side because the dam_collections index has fewer signals to act
+ * on. Surfaces a single hint when results are empty so the LLM can fall
+ * back to `list_collections`.
+ */
+export function buildCollectionSearchNextSteps(found) {
+    if (found === 0) {
+        return [
+            {
+                tool: 'list_collections',
+                reason_code: 'empty_result',
+                reason: 'No matches found — list all collections in the workspace as a fallback.',
+            },
+        ];
+    }
+    return [];
+}
+/** Count untagged hits in a verbose projection. Compact projection has no tags column. */
+export function countUntagged(hits) {
+    let n = 0;
+    for (const h of hits) {
+        if (!('tags' in h) || h.tags === null || h.tags === undefined) {
+            n += 1;
+            continue;
+        }
+        if (Array.isArray(h.tags) && h.tags.length === 0)
+            n += 1;
+    }
+    return n;
+}
+//# sourceMappingURL=facets.js.map

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

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

package/dist/tools/search/filter-builder.d.ts

@@ -0,0 +1,33 @@
+import type { SearchAssetFilters, Visibility } from './types.js';
+/** Convert a `Visibility` enum value to the numeric Typesense column. */
+export declare function visibilityToNumber(v: Visibility): 0 | 1;
+/**
+ * Coerce a date bound (ISO-8601 string or unix-second integer) to a unix
+ * timestamp in seconds. Returns null if the input is unparseable.
+ */
+export declare function toUnixSeconds(bound: number | string): number | null;
+/**
+ * Build the `filter_by` clauses for the asset filters. Returns an array of
+ * clause strings (each already wrapped in parens where needed) — the
+ * caller joins them with ` && ` and prepends the workspace clause via the
+ * wrapper.
+ *
+ * Ordering and grammar match the Admin-Frontend
+ * `mixins/search-common-functions.js` builders. See
+ * `docs/typesense-filter-schema.md` for the full citation set.
+ */
+export declare function buildAssetFilterClauses(filters: SearchAssetFilters | undefined): string[];
+/**
+ * Escape a value for use inside a `filter_by` clause. Typesense supports
+ * backtick-quoted strings to handle special characters; for the asset
+ * filter surface (tag names, file types, IDs) we keep escaping minimal —
+ * if the value contains `,`, `]`, ``` ` ```, or whitespace we wrap in
+ * backticks. Plain identifiers pass through.
+ */
+export declare function escapeFilterValue(value: string): string;
+/**
+ * Join filter clauses with ` && `. Empty array → empty string.
+ * Exposed for tests so they can validate the output as a plain string.
+ */
+export declare function joinFilterClauses(clauses: ReadonlyArray<string>): string;
+//# sourceMappingURL=filter-builder.d.ts.map

package/dist/tools/search/filter-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-builder.d.ts","sourceRoot":"","sources":["../../../src/tools/search/filter-builder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjE,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,GAAG,CAAC,CAGvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CASnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACtC,MAAM,EAAE,CAsDV;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAExE"}

package/dist/tools/search/filter-builder.js

@@ -0,0 +1,111 @@
+// ── Typesense filter_by builder ──────────────────────────────────────
+// Translates the typed `SearchAssetFilters` envelope into the literal
+// `filter_by` string Typesense expects. Clause grammar is documented in
+// `docs/typesense-filter-schema.md`.
+/** Convert a `Visibility` enum value to the numeric Typesense column. */
+export function visibilityToNumber(v) {
+    if (v === 'public' || v === 0)
+        return 0;
+    return 1;
+}
+/**
+ * Coerce a date bound (ISO-8601 string or unix-second integer) to a unix
+ * timestamp in seconds. Returns null if the input is unparseable.
+ */
+export function toUnixSeconds(bound) {
+    if (typeof bound === 'number') {
+        if (!Number.isFinite(bound) || bound < 0)
+            return null;
+        return Math.floor(bound);
+    }
+    // ISO-8601 or any Date.parse-recognised string
+    const ms = Date.parse(bound);
+    if (Number.isNaN(ms))
+        return null;
+    return Math.floor(ms / 1000);
+}
+/**
+ * Build the `filter_by` clauses for the asset filters. Returns an array of
+ * clause strings (each already wrapped in parens where needed) — the
+ * caller joins them with ` && ` and prepends the workspace clause via the
+ * wrapper.
+ *
+ * Ordering and grammar match the Admin-Frontend
+ * `mixins/search-common-functions.js` builders. See
+ * `docs/typesense-filter-schema.md` for the full citation set.
+ */
+export function buildAssetFilterClauses(filters) {
+    if (filters === undefined)
+        return [];
+    const clauses = [];
+    if (filters.tags !== undefined && filters.tags.length > 0) {
+        // Use the `tags:=[a,b,c]` array shorthand which Typesense interprets
+        // as include-any-of. Avoids the backslash-escape used by the frontend
+        // for exact match — semantically equivalent for non-special tag names.
+        const list = filters.tags
+            .map((t) => escapeFilterValue(t))
+            .join(',');
+        clauses.push(`tags:=[${list}]`);
+    }
+    if (filters.file_type !== undefined && filters.file_type.length > 0) {
+        const list = filters.file_type
+            .map((t) => escapeFilterValue(t))
+            .join(',');
+        clauses.push(`file_type:=[${list}]`);
+    }
+    if (filters.visibility !== undefined) {
+        clauses.push(`visibility:=${visibilityToNumber(filters.visibility)}`);
+    }
+    if (filters.collection_ids !== undefined && filters.collection_ids.length > 0) {
+        const list = filters.collection_ids
+            .map((id) => escapeFilterValue(String(id)))
+            .join(',');
+        clauses.push(`collection_ids:=[${list}]`);
+    }
+    if (filters.category_id !== undefined) {
+        clauses.push(`category_id:=${escapeFilterValue(String(filters.category_id))}`);
+    }
+    if (filters.created_after !== undefined) {
+        const ts = toUnixSeconds(filters.created_after);
+        if (ts !== null)
+            clauses.push(`created_at:>=${ts}`);
+    }
+    if (filters.created_before !== undefined) {
+        const ts = toUnixSeconds(filters.created_before);
+        if (ts !== null)
+            clauses.push(`created_at:<=${ts}`);
+    }
+    if (filters.modified_after !== undefined) {
+        const ts = toUnixSeconds(filters.modified_after);
+        if (ts !== null)
+            clauses.push(`modified_at:>=${ts}`);
+    }
+    if (filters.modified_before !== undefined) {
+        const ts = toUnixSeconds(filters.modified_before);
+        if (ts !== null)
+            clauses.push(`modified_at:<=${ts}`);
+    }
+    return clauses;
+}
+/**
+ * Escape a value for use inside a `filter_by` clause. Typesense supports
+ * backtick-quoted strings to handle special characters; for the asset
+ * filter surface (tag names, file types, IDs) we keep escaping minimal —
+ * if the value contains `,`, `]`, ``` ` ```, or whitespace we wrap in
+ * backticks. Plain identifiers pass through.
+ */
+export function escapeFilterValue(value) {
+    if (/[\s,\]`\\]/.test(value)) {
+        const escaped = value.replace(/`/g, '\\`');
+        return '`' + escaped + '`';
+    }
+    return value;
+}
+/**
+ * Join filter clauses with ` && `. Empty array → empty string.
+ * Exposed for tests so they can validate the output as a plain string.
+ */
+export function joinFilterClauses(clauses) {
+    return clauses.filter((c) => c.length > 0).join(' && ');
+}
+//# sourceMappingURL=filter-builder.js.map