@collage-dam/mcp-server 0.1.0

package/dist/prompts/usage-insights.js

@@ -0,0 +1,98 @@
+// ── usage_insights ──────────────────────────────────────────────────
+// Distribution-engagement summary. MVP ships a degraded slice backed
+// only by the dashboard and analytics resources — the deeper
+// `analyze_share_links` / `report_*` tools are Phase 2.
+import { z } from 'zod';
+import { parseEnum, playbookMessage } from './helpers.js';
+export const USAGE_INSIGHTS_NAME = 'usage_insights';
+export const USAGE_INSIGHTS_DESCRIPTION = 'Summarize how your distribution surfaces are performing — share-link ' +
+    'engagement, asset activation, top performers, stale content. MVP ships ' +
+    'a high-level overview backed by the workspace dashboard; richer ' +
+    'per-share-link and per-asset analytics arrive in a future release.';
+export const USAGE_INSIGHTS_ARGS = {
+    time_window: z
+        .string()
+        .optional()
+        .describe('Time window: 7d | 30d | 90d | all. Default 30d.'),
+    scope: z
+        .string()
+        .optional()
+        .describe('What to analyse: portals | share_links | assets | all. Default all.'),
+};
+const WINDOWS = ['7d', '30d', '90d', 'all'];
+const SCOPES = ['portals', 'share_links', 'assets', 'all'];
+export function buildUsageInsightsPrompt(args) {
+    const window = parseEnum(args.time_window, WINDOWS, '30d');
+    const scope = parseEnum(args.scope, SCOPES, 'all');
+    const body = {
+        workflow: 'usage_insights',
+        time_window: window,
+        scope,
+        degraded_in_mvp: true,
+        degraded_reason: 'Per-share-link engagement, per-asset activation, top-N performers, ' +
+            'and stale-content scoring depend on the Phase 2 distribution-insights ' +
+            'tools (analyze_share_links, report_asset_activation, ' +
+            'report_top_assets, report_stale_assets). MVP ships only the ' +
+            'workspace-level dashboard summary. Tell the user which analyses are ' +
+            'currently available and which are in a future release.',
+        instructions: 'Pull workspace-level engagement signals from the available resources, ' +
+            'compile a structured report, and tell the user which deeper analyses ' +
+            'are not yet available so they can decide whether to wait for them or ' +
+            'proceed with what we have.',
+        orchestration: [
+            {
+                step: 1,
+                action: 'Load dashboard resource',
+                resources: ['collage://dashboard'],
+                purpose: 'Workspace-level KPIs: total assets, total collections, recent ' +
+                    'upload velocity, total share links, etc. Pass through the raw ' +
+                    'projection — do not invent fields.',
+            },
+            {
+                step: 2,
+                action: 'Inventory share links (in scope)',
+                tools: ['list_share_links'],
+                args: { page_size: 100 },
+                purpose: 'List share links with their view counts, expiration, and download ' +
+                    'flags. Sort by view_count desc to surface the most-engaged. The ' +
+                    'list endpoint exposes total view counts but not time-bucketed ' +
+                    'history — call out that limitation in the report.',
+                included_when: scope === 'share_links' || scope === 'all',
+            },
+            {
+                step: 3,
+                action: 'Identify recently-uploaded assets (in scope)',
+                resources: ['collage://assets/recent'],
+                purpose: 'Pull recent uploads from the resource. The MVP dashboard does NOT ' +
+                    'currently report per-asset download counts — flag that in the report.',
+                included_when: scope === 'assets' || scope === 'all',
+            },
+            {
+                step: 4,
+                action: 'Compile the report',
+                purpose: 'Aggregate signals from steps 1-3 into a single structured report. ' +
+                    'For every section that depends on Phase 2 tools, emit a placeholder ' +
+                    'with a friendly "this analysis is in a future release" note rather ' +
+                    'than fabricating numbers.',
+            },
+        ],
+        output_shape: {
+            time_window: window,
+            scope,
+            workspace_summary: 'object — passthrough of collage://dashboard',
+            share_link_engagement: 'Array<{ id, title, view_count, expiration }> | "Phase 2: per-share-link analytics"',
+            top_assets: '"Phase 2: report_top_assets pending"',
+            stale_assets: '"Phase 2: report_stale_assets pending"',
+            asset_activation: '"Phase 2: report_asset_activation pending"',
+            degraded_notice: 'string — friendly summary of what is and isn\'t available',
+            next_actions: 'Array<{ tool, args }>',
+        },
+        guardrails: [
+            'Read-only — no mutations.',
+            'Never fabricate engagement numbers; if a metric requires Phase 2 tools, say so.',
+            'If collage://dashboard returns an UPSTREAM error, surface code+request_id; do not pretend the report succeeded.',
+        ],
+    };
+    return playbookMessage(`Usage insights (window: ${window}, scope: ${scope}) — degraded MVP slice`, body);
+}
+//# sourceMappingURL=usage-insights.js.map

package/dist/prompts/usage-insights.js.map

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

package/dist/prompts/wrap-prompt-as-tool.d.ts

@@ -0,0 +1,48 @@
+import { z, type ZodTypeAny } from 'zod';
+import type { GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const FALLBACK_NOTICE: string;
+interface PromptDefinition<Args extends Record<string, ZodTypeAny>> {
+    /** Underlying prompt name (the canonical MCP prompt). */
+    promptName: string;
+    /** Tool-alias name registered alongside the prompt. */
+    toolName: string;
+    /** Human-readable description for the underlying prompt. */
+    promptDescription: string;
+    /** Argument schema; mirrors the prompt's argsSchema exactly. */
+    argsSchema: Args;
+    /** Builder that returns the prompt's GetPromptResult. */
+    build: (args: z.objectOutputType<Args, ZodTypeAny>) => GetPromptResult;
+}
+export interface ToolAliasResult {
+    /** Always present — keeps the tool result self-describing. */
+    alias_for_prompt: string;
+    /** Free-text description copied from the underlying prompt. */
+    description: string | undefined;
+    /** Stringified playbook body (the JSON from the prompt's user message). */
+    playbook: unknown;
+    /** Notice telling the LLM this is a fallback. */
+    notice: string;
+}
+interface BuiltAliasTool<Args extends Record<string, ZodTypeAny>> {
+    toolName: string;
+    toolDescription: string;
+    argsSchema: Args;
+    handler: (args: z.objectOutputType<Args, ZodTypeAny>) => Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+        structuredContent: Record<string, unknown>;
+        isError?: boolean;
+    }>;
+}
+/**
+ * Wrap a prompt's builder as an MCP tool handler. The tool reads the
+ * playbook body from the prompt result, parses it back to JSON (since
+ * the prompt builder serialises before storing in the message), and
+ * re-emits it under a stable `playbook` key. Schema-version stamping
+ * mirrors the rest of the mutating-tool surface.
+ */
+export declare function wrapPromptAsTool<Args extends Record<string, ZodTypeAny>>(def: PromptDefinition<Args>): BuiltAliasTool<Args>;
+export {};
+//# sourceMappingURL=wrap-prompt-as-tool.d.ts.map

package/dist/prompts/wrap-prompt-as-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-prompt-as-tool.d.ts","sourceRoot":"","sources":["../../src/prompts/wrap-prompt-as-tool.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAG1E,eAAO,MAAM,eAAe,QAKW,CAAC;AAExC,UAAU,gBAAgB,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAChE,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,UAAU,EAAE,IAAI,CAAC;IACjB,yDAAyD;IACzD,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,eAAe,CAAC;CACxE;AAED,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,cAAc,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC;QAC/D,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACtE,GAAG,EAAE,gBAAgB,CAAC,IAAI,CAAC,GAC1B,cAAc,CAAC,IAAI,CAAC,CA+BtB"}

package/dist/prompts/wrap-prompt-as-tool.js

@@ -0,0 +1,61 @@
+// ── wrapPromptAsTool ─────────────────────────────────────────────────
+// Temporary fallback while Claude Desktop's UI does not expose MCP
+// prompts in its slash or attachment menus. Each guided-workflow prompt
+// gets a thin tool wrapper that re-emits the same playbook body as a
+// tool-call result — and tools DO surface in Claude Desktop today.
+//
+// Once Anthropic ships native prompt UI, the alias tools are sunset and
+// callers move back to invoking the prompts directly. The tool
+// descriptions name this explicitly so future readers know the wrappers
+// are temporary.
+//
+// See spec `.mm/specs/2026-05-01-mcp-prompts-ui-fallback/spec.md`.
+import { addSchemaVersion } from '../conventions/schema-version.js';
+export const FALLBACK_NOTICE = 'TEMPORARY FALLBACK: Claude Desktop\'s current UI does not expose MCP ' +
+    'prompts. This tool re-emits the same guided-workflow playbook so it ' +
+    'can be invoked through the standard tool surface. Prefer the native ' +
+    'MCP prompt where supported; this alias will be removed once Claude ' +
+    'Desktop surfaces prompts in its UI.';
+/**
+ * Wrap a prompt's builder as an MCP tool handler. The tool reads the
+ * playbook body from the prompt result, parses it back to JSON (since
+ * the prompt builder serialises before storing in the message), and
+ * re-emits it under a stable `playbook` key. Schema-version stamping
+ * mirrors the rest of the mutating-tool surface.
+ */
+export function wrapPromptAsTool(def) {
+    const toolDescription = `${def.promptDescription}\n\n${FALLBACK_NOTICE}`;
+    return {
+        toolName: def.toolName,
+        toolDescription,
+        argsSchema: def.argsSchema,
+        handler: async (args) => {
+            const promptResult = def.build(args);
+            const message = promptResult.messages[0];
+            const playbook = message !== undefined && message.content.type === 'text'
+                ? safeJsonParse(message.content.text)
+                : null;
+            const structured = addSchemaVersion({
+                alias_for_prompt: def.promptName,
+                description: promptResult.description,
+                playbook,
+                notice: FALLBACK_NOTICE,
+            });
+            return {
+                content: [
+                    { type: 'text', text: JSON.stringify(structured, null, 2) },
+                ],
+                structuredContent: structured,
+            };
+        },
+    };
+}
+function safeJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=wrap-prompt-as-tool.js.map

package/dist/prompts/wrap-prompt-as-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-prompt-as-tool.js","sourceRoot":"","sources":["../../src/prompts/wrap-prompt-as-tool.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,mEAAmE;AACnE,wEAAwE;AACxE,qEAAqE;AACrE,mEAAmE;AACnE,EAAE;AACF,wEAAwE;AACxE,+DAA+D;AAC/D,wEAAwE;AACxE,iBAAiB;AACjB,EAAE;AACF,mEAAmE;AAInE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,MAAM,CAAC,MAAM,eAAe,GAC1B,uEAAuE;IACvE,sEAAsE;IACtE,sEAAsE;IACtE,qEAAqE;IACrE,qCAAqC,CAAC;AAqCxC;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAA2B;IAE3B,MAAM,eAAe,GACnB,GAAG,GAAG,CAAC,iBAAiB,OAAO,eAAe,EAAE,CAAC;IAEnD,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,eAAe;QACf,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,QAAQ,GACZ,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM;gBACtD,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;gBACrC,CAAC,CAAC,IAAI,CAAC;YAEX,MAAM,UAAU,GAA8C,gBAAgB,CAAC;gBAC7E,gBAAgB,EAAE,GAAG,CAAC,UAAU;gBAChC,WAAW,EAAE,YAAY,CAAC,WAAW;gBACrC,QAAQ;gBACR,MAAM,EAAE,eAAe;aACxB,CAA8C,CAAC;YAEhD,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;iBACrE;gBACD,iBAAiB,EAAE,UAAU;aAC9B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/resources/asset-by-id.d.ts

@@ -0,0 +1,4 @@
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CollageClient } from '../client.js';
+export declare function buildAssetByIdReader(client: CollageClient): (uri: URL, variables: Record<string, string | string[]>) => Promise<ReadResourceResult>;
+//# sourceMappingURL=asset-by-id.d.ts.map

package/dist/resources/asset-by-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-by-id.d.ts","sourceRoot":"","sources":["../../src/resources/asset-by-id.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,IAEtD,KAAK,GAAG,EACR,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,KAC3C,OAAO,CAAC,kBAAkB,CAAC,CAqB/B"}

package/dist/resources/asset-by-id.js

@@ -0,0 +1,27 @@
+// ── collage://assets/{id} ─────────────────────────────────────────────
+// Backed by POST /digital-assets/view-detail (CollageClient.getAssetDetails).
+// Returns the full asset projection — metadata, tags, breadcrumb, and
+// signed S3 thumbnail/compress URLs (24h expiry).
+//
+// Per the spec: visibility fields stay numeric (0=public, 1=private) and
+// raw Collage field names (e.g. `digital_assets_id`) flow through as-is.
+import { createToolError } from '../conventions/errors.js';
+import { errorResource, jsonResource } from './helpers.js';
+export function buildAssetByIdReader(client) {
+    return async (uri, variables) => {
+        const idVar = variables['id'];
+        const id = Array.isArray(idVar) ? idVar[0] : idVar;
+        if (id === undefined || id === '') {
+            return errorResource(uri, createToolError('VALIDATION', 'collage://assets/{id} requires an id'), 'no-request');
+        }
+        const result = await client.getAssetDetails(id);
+        if (!result.ok) {
+            return errorResource(uri, result.error, result.request_id);
+        }
+        return jsonResource(uri, {
+            asset: result.data,
+            request_id: result.request_id,
+        });
+    };
+}
+//# sourceMappingURL=asset-by-id.js.map

package/dist/resources/asset-by-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-by-id.js","sourceRoot":"","sources":["../../src/resources/asset-by-id.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,8EAA8E;AAC9E,sEAAsE;AACtE,kDAAkD;AAClD,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AAIzE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,OAAO,KAAK,EACV,GAAQ,EACR,SAA4C,EACf,EAAE;QAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnD,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAClC,OAAO,aAAa,CAClB,GAAG,EACH,eAAe,CAAC,YAAY,EAAE,sCAAsC,CAAC,EACrE,YAAY,CACb,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,YAAY,CAAC,GAAG,EAAE;YACvB,KAAK,EAAE,MAAM,CAAC,IAAI;YAClB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/resources/collections.d.ts

@@ -0,0 +1,5 @@
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CollageClient } from '../client.js';
+export declare function buildCollectionsListReader(client: CollageClient): (uri: URL) => Promise<ReadResourceResult>;
+export declare function buildCollectionByIdReader(client: CollageClient): (uri: URL, variables: Record<string, string | string[]>) => Promise<ReadResourceResult>;
+//# sourceMappingURL=collections.d.ts.map

package/dist/resources/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/resources/collections.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAUlD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,IAChD,KAAK,GAAG,KAAG,OAAO,CAAC,kBAAkB,CAAC,CAmBrD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,IAE3D,KAAK,GAAG,EACR,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,KAC3C,OAAO,CAAC,kBAAkB,CAAC,CAwB/B"}

package/dist/resources/collections.js

@@ -0,0 +1,48 @@
+// ── collage://collections  and  collage://collections/{id} ──────────
+// Backed by GET /digital-assets/collection/get-all. Collage exposes only
+// the list endpoint for collections (no per-id route), so the by-id
+// reader filters the list client-side via `getCollection(id)` — same
+// trade-off the rest of the read-side surface uses.
+//
+// The static list resource budgets/paginates the response so very large
+// workspaces stay within the 12K token cap.
+import { createToolError } from '../conventions/errors.js';
+import { budgetList, decodeOffsetCursor, errorResource, jsonResource, } from './helpers.js';
+import { clampPageSize } from '../conventions/pagination.js';
+export function buildCollectionsListReader(client) {
+    return async (uri) => {
+        const offset = decodeOffsetCursor(uri);
+        const pageSize = clampPageSize(Number(uri.searchParams.get('page_size') ?? undefined) || undefined);
+        const result = await client.listCollections();
+        if (!result.ok) {
+            return errorResource(uri, result.error, result.request_id);
+        }
+        const slice = result.data.slice(offset);
+        const budgeted = budgetList(slice, offset, pageSize);
+        return jsonResource(uri, {
+            items: budgeted.data,
+            total: result.data.length,
+            next_cursor: budgeted.next_cursor,
+            truncated: budgeted.truncated,
+            request_id: result.request_id,
+        });
+    };
+}
+export function buildCollectionByIdReader(client) {
+    return async (uri, variables) => {
+        const idVar = variables['id'];
+        const id = Array.isArray(idVar) ? idVar[0] : idVar;
+        if (id === undefined || id === '') {
+            return errorResource(uri, createToolError('VALIDATION', 'collage://collections/{id} requires an id'), 'no-request');
+        }
+        const result = await client.getCollection(id);
+        if (!result.ok) {
+            return errorResource(uri, result.error, result.request_id);
+        }
+        return jsonResource(uri, {
+            collection: result.data,
+            request_id: result.request_id,
+        });
+    };
+}
+//# sourceMappingURL=collections.js.map

package/dist/resources/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/resources/collections.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yEAAyE;AACzE,oEAAoE;AACpE,qEAAqE;AACrE,oDAAoD;AACpD,EAAE;AACF,wEAAwE;AACxE,4CAA4C;AAI5C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,UAAU,0BAA0B,CAAC,MAAqB;IAC9D,OAAO,KAAK,EAAE,GAAQ,EAA+B,EAAE;QACrD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,aAAa,CAC5B,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,IAAI,SAAS,CACpE,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACrD,OAAO,YAAY,CAAC,GAAG,EAAE;YACvB,KAAK,EAAE,QAAQ,CAAC,IAAI;YACpB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;YACzB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAqB;IAC7D,OAAO,KAAK,EACV,GAAQ,EACR,SAA4C,EACf,EAAE;QAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnD,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAClC,OAAO,aAAa,CAClB,GAAG,EACH,eAAe,CACb,YAAY,EACZ,2CAA2C,CAC5C,EACD,YAAY,CACb,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,YAAY,CAAC,GAAG,EAAE;YACvB,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/resources/custom-fields.d.ts

@@ -0,0 +1,4 @@
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CollageClient } from '../client.js';
+export declare function buildCustomFieldsReader(client: CollageClient): (uri: URL) => Promise<ReadResourceResult>;
+//# sourceMappingURL=custom-fields.d.ts.map

package/dist/resources/custom-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-fields.d.ts","sourceRoot":"","sources":["../../src/resources/custom-fields.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AASlD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,IAC7C,KAAK,GAAG,KAAG,OAAO,CAAC,kBAAkB,CAAC,CAmBrD"}

package/dist/resources/custom-fields.js

@@ -0,0 +1,30 @@
+// ── collage://custom-fields ──────────────────────────────────────────
+// Backed by GET /digital-assets/custom-field/list (CollageClient.listCustomFields).
+// Returns the workspace-scoped custom-field definitions used by the
+// metadata-tagging tools — `{ id, field_label, field_type, status, ... }`.
+//
+// Workspace custom fields are typically a short list (< few dozen), so
+// pagination is overkill. We still apply the response budget guard for
+// the rare workspace that defines hundreds.
+import { budgetList, decodeOffsetCursor, errorResource, jsonResource, } from './helpers.js';
+import { clampPageSize } from '../conventions/pagination.js';
+export function buildCustomFieldsReader(client) {
+    return async (uri) => {
+        const offset = decodeOffsetCursor(uri);
+        const pageSize = clampPageSize(Number(uri.searchParams.get('page_size') ?? undefined) || undefined);
+        const result = await client.listCustomFields();
+        if (!result.ok) {
+            return errorResource(uri, result.error, result.request_id);
+        }
+        const slice = result.data.slice(offset);
+        const budgeted = budgetList(slice, offset, pageSize);
+        return jsonResource(uri, {
+            items: budgeted.data,
+            total: result.data.length,
+            next_cursor: budgeted.next_cursor,
+            truncated: budgeted.truncated,
+            request_id: result.request_id,
+        });
+    };
+}
+//# sourceMappingURL=custom-fields.js.map

package/dist/resources/custom-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-fields.js","sourceRoot":"","sources":["../../src/resources/custom-fields.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,oFAAoF;AACpF,oEAAoE;AACpE,2EAA2E;AAC3E,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,4CAA4C;AAI5C,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,UAAU,uBAAuB,CAAC,MAAqB;IAC3D,OAAO,KAAK,EAAE,GAAQ,EAA+B,EAAE;QACrD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,aAAa,CAC5B,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,IAAI,SAAS,CACpE,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACrD,OAAO,YAAY,CAAC,GAAG,EAAE;YACvB,KAAK,EAAE,QAAQ,CAAC,IAAI;YACpB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;YACzB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/resources/folders.d.ts

@@ -0,0 +1,5 @@
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CollageClient } from '../client.js';
+export declare function buildFoldersListReader(client: CollageClient): (uri: URL) => Promise<ReadResourceResult>;
+export declare function buildFolderByIdReader(client: CollageClient): (uri: URL, variables: Record<string, string | string[]>) => Promise<ReadResourceResult>;
+//# sourceMappingURL=folders.d.ts.map

package/dist/resources/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/resources/folders.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAUlD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,IAC5C,KAAK,GAAG,KAAG,OAAO,CAAC,kBAAkB,CAAC,CAgBrD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,IAEvD,KAAK,GAAG,EACR,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,KAC3C,OAAO,CAAC,kBAAkB,CAAC,CAmD/B"}

package/dist/resources/folders.js

@@ -0,0 +1,73 @@
+// ── collage://folders  and  collage://folders/{id} ──────────────────
+// Two resources backed by the now-unblocked category endpoints.
+//
+// Static `collage://folders` returns the FULL folder tree as a flat list
+// with `parent_id` populated on every row (null for roots). Upstream's
+// `all-category-list` is flat-by-design and only returns roots, so this
+// resource walks via `listAllCategoriesRecursive()` to recover the tree.
+// Budget-applied so very large workspaces don't blow the 12K cap.
+//
+// Parameterised `collage://folders/{id}` returns one folder's row + its
+// immediate sub-folders + a paginated page of assets. Asset paging uses
+// `?cursor=` on the URI. Folder lookup also uses the recursive walk so
+// nested folders resolve correctly.
+import { createToolError } from '../conventions/errors.js';
+import { clampPageSize } from '../conventions/pagination.js';
+import { budgetList, decodeOffsetCursor, errorResource, jsonResource, } from './helpers.js';
+export function buildFoldersListReader(client) {
+    return async (uri) => {
+        const offset = decodeOffsetCursor(uri);
+        const result = await client.listAllCategoriesRecursive();
+        if (!result.ok) {
+            return errorResource(uri, result.error, result.request_id);
+        }
+        const slice = result.data.slice(offset);
+        const budgeted = budgetList(slice, offset, slice.length);
+        return jsonResource(uri, {
+            items: budgeted.data,
+            total: result.data.length,
+            next_cursor: budgeted.next_cursor,
+            truncated: budgeted.truncated,
+            request_id: result.request_id,
+        });
+    };
+}
+export function buildFolderByIdReader(client) {
+    return async (uri, variables) => {
+        const idVar = variables['id'];
+        const id = Array.isArray(idVar) ? idVar[0] : idVar;
+        if (id === undefined || id === '') {
+            return errorResource(uri, createToolError('VALIDATION', 'collage://folders/{id} requires an id'), 'no-request');
+        }
+        const all = await client.listAllCategoriesRecursive();
+        if (!all.ok) {
+            return errorResource(uri, all.error, all.request_id);
+        }
+        const folder = all.data.find((c) => String(c.id) === String(id));
+        if (folder === undefined) {
+            return errorResource(uri, createToolError('NOT_FOUND', `folder ${id} not found in workspace`), all.request_id);
+        }
+        const subs = await client.listSubCategories(id);
+        if (!subs.ok) {
+            return errorResource(uri, subs.error, subs.request_id);
+        }
+        const pageSize = clampPageSize(Number(uri.searchParams.get('page_size') ?? undefined) || undefined);
+        const offset = decodeOffsetCursor(uri);
+        const upstreamPage = Math.floor(offset / pageSize) + 1;
+        const assets = await client.listAssetsByCategory(id, upstreamPage);
+        if (!assets.ok) {
+            return errorResource(uri, assets.error, assets.request_id);
+        }
+        const budgeted = budgetList(assets.data.assets, offset, pageSize);
+        return jsonResource(uri, {
+            folder,
+            subcategories: subs.data,
+            assets: budgeted.data,
+            total_assets: assets.data.total,
+            next_cursor: budgeted.next_cursor,
+            truncated: budgeted.truncated,
+            request_id: assets.request_id,
+        });
+    };
+}
+//# sourceMappingURL=folders.js.map

package/dist/resources/folders.js.map

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

package/dist/resources/helpers.d.ts

@@ -0,0 +1,17 @@
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import type { McpToolError } from '../conventions/errors.js';
+import { type ResponseBudgetResult } from '../conventions/response-budget.js';
+export declare function jsonResource(uri: URL, body: unknown): ReadResourceResult;
+export declare function errorResource(uri: URL, error: McpToolError, request_id: string): ReadResourceResult;
+/**
+ * Apply the shared 12K-token response budget to a list-shaped resource
+ * payload, returning the truncated slice plus a `next_cursor` when more
+ * remains.
+ */
+export declare function budgetList<T>(items: T[], offset: number, pageSize: number): ResponseBudgetResult<T[]>;
+/**
+ * Decode a `?cursor=…` (base64 of a non-negative integer offset). Defaults
+ * to 0 if absent or malformed — same lenient behaviour as the tools.
+ */
+export declare function decodeOffsetCursor(uri: URL): number;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/resources/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/resources/helpers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,mCAAmC,CAAC;AAI3C,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAQxE;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,GACjB,kBAAkB,CASpB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,EAAE,EACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAM3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAUnD"}

package/dist/resources/helpers.js

@@ -0,0 +1,59 @@
+// ── Resource helpers ─────────────────────────────────────────────────
+// Small utilities shared by the MCP resource handlers. Resources return
+// a `{ contents: [...] }` envelope per the SDK; we always emit a single
+// JSON-stringified text item with mimeType `application/json`.
+//
+// Errors are converted to a structured JSON body (not thrown) so MCP
+// clients always receive a parseable response — the upstream error code
+// and request_id are surfaced in the body.
+import { applyResponseBudget, estimateTokens, warnIfOverBudget, } from '../conventions/response-budget.js';
+const JSON_MIME = 'application/json';
+export function jsonResource(uri, body) {
+    const text = JSON.stringify(body, null, 2);
+    warnIfOverBudget(estimateTokens(text), uri.toString());
+    return {
+        contents: [
+            { uri: uri.toString(), mimeType: JSON_MIME, text },
+        ],
+    };
+}
+export function errorResource(uri, error, request_id) {
+    return jsonResource(uri, {
+        error: {
+            code: error.code,
+            message: error.message,
+            retriable: error.retriable,
+        },
+        request_id,
+    });
+}
+/**
+ * Apply the shared 12K-token response budget to a list-shaped resource
+ * payload, returning the truncated slice plus a `next_cursor` when more
+ * remains.
+ */
+export function budgetList(items, offset, pageSize) {
+    return applyResponseBudget(items, {
+        serialize: (item) => JSON.stringify(item),
+        offset,
+        pageSize,
+    });
+}
+/**
+ * Decode a `?cursor=…` (base64 of a non-negative integer offset). Defaults
+ * to 0 if absent or malformed — same lenient behaviour as the tools.
+ */
+export function decodeOffsetCursor(uri) {
+    const raw = uri.searchParams.get('cursor');
+    if (raw === null)
+        return 0;
+    try {
+        const decoded = Buffer.from(raw, 'base64').toString('utf-8');
+        const n = Number(decoded);
+        return Number.isFinite(n) && n >= 0 && Number.isInteger(n) ? n : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/resources/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/resources/helpers.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wEAAwE;AACxE,wEAAwE;AACxE,+DAA+D;AAC/D,EAAE;AACF,qEAAqE;AACrE,wEAAwE;AACxE,2CAA2C;AAI3C,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GAEjB,MAAM,mCAAmC,CAAC;AAE3C,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC,MAAM,UAAU,YAAY,CAAC,GAAQ,EAAE,IAAa;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,gBAAgB,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvD,OAAO;QACL,QAAQ,EAAE;YACR,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;SACnD;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,GAAQ,EACR,KAAmB,EACnB,UAAkB;IAElB,OAAO,YAAY,CAAC,GAAG,EAAE;QACvB,KAAK,EAAE;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B;QACD,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,KAAU,EACV,MAAc,EACd,QAAgB;IAEhB,OAAO,mBAAmB,CAAC,KAAK,EAAE;QAChC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QACzC,MAAM;QACN,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAQ;IACzC,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7D,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/resources/portals.d.ts

@@ -0,0 +1,5 @@
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CollageClient } from '../client.js';
+export declare function buildPortalsListReader(client: CollageClient): (uri: URL) => Promise<ReadResourceResult>;
+export declare function buildPortalByIdReader(client: CollageClient): (uri: URL, variables: Record<string, string | string[]>) => Promise<ReadResourceResult>;
+//# sourceMappingURL=portals.d.ts.map

package/dist/resources/portals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portals.d.ts","sourceRoot":"","sources":["../../src/resources/portals.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,IAC5C,KAAK,GAAG,KAAG,OAAO,CAAC,kBAAkB,CAAC,CAUrD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,IAEvD,KAAK,GAAG,EACR,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,KAC3C,OAAO,CAAC,kBAAkB,CAAC,CA8B/B"}