@collage-dam/mcp-server 0.1.0

package/dist/tools/list-collections.d.ts

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+import type { CollageClient } from '../client.js';
+export declare const ListCollectionsOutputSchema: z.ZodObject<{
+    collections: z.ZodArray<z.ZodObject<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        name: z.ZodString;
+        assets_id: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>;
+        instance_visibility: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        workspace_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        instance_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        is_backend_user: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string | number;
+        name: string;
+        description?: string | null | undefined;
+        workspace_id?: string | number | undefined;
+        instance_visibility?: (string | number)[] | undefined;
+        user_id?: string | number | null | undefined;
+        created_at?: string | null | undefined;
+        updated_at?: string | null | undefined;
+        assets_id?: (string | number)[] | undefined;
+        instance_id?: string | number | undefined;
+        is_backend_user?: number | boolean | undefined;
+    }, {
+        id: string | number;
+        name: string;
+        description?: string | null | undefined;
+        workspace_id?: string | number | undefined;
+        instance_visibility?: (string | number)[] | undefined;
+        user_id?: string | number | null | undefined;
+        created_at?: string | null | undefined;
+        updated_at?: string | null | undefined;
+        assets_id?: (string | number)[] | undefined;
+        instance_id?: string | number | undefined;
+        is_backend_user?: number | boolean | undefined;
+    }>, "many">;
+    count: z.ZodNumber;
+    request_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    request_id: string;
+    count: number;
+    collections: {
+        id: string | number;
+        name: string;
+        description?: string | null | undefined;
+        workspace_id?: string | number | undefined;
+        instance_visibility?: (string | number)[] | undefined;
+        user_id?: string | number | null | undefined;
+        created_at?: string | null | undefined;
+        updated_at?: string | null | undefined;
+        assets_id?: (string | number)[] | undefined;
+        instance_id?: string | number | undefined;
+        is_backend_user?: number | boolean | undefined;
+    }[];
+}, {
+    request_id: string;
+    count: number;
+    collections: {
+        id: string | number;
+        name: string;
+        description?: string | null | undefined;
+        workspace_id?: string | number | undefined;
+        instance_visibility?: (string | number)[] | undefined;
+        user_id?: string | number | null | undefined;
+        created_at?: string | null | undefined;
+        updated_at?: string | null | undefined;
+        assets_id?: (string | number)[] | undefined;
+        instance_id?: string | number | undefined;
+        is_backend_user?: number | boolean | undefined;
+    }[];
+}>;
+export type ListCollectionsOutput = z.infer<typeof ListCollectionsOutputSchema>;
+export declare const LIST_COLLECTIONS_DESCRIPTION: string;
+/**
+ * Build the handler for the `list_collections` tool.
+ *
+ * Wraps `CollageClient.listCollections()`, which calls
+ * `GET /digital-assets/collection/get-all` and returns the API projection
+ * `{id, name, assets_id[], instance_visibility[]}`.
+ */
+export declare function buildListCollectionsHandler(client: CollageClient): () => Promise<{
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        error: {
+            code: "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION" | "RATE_LIMITED" | "UPSTREAM" | "CONFIRMATION_STALE" | "CONFIRMATION_MISSING" | "CONFIRMATION_STATE_DIVERGED" | "ENTITLEMENT" | "INTERNAL";
+            message: string;
+            retriable: boolean;
+            cause?: z.objectOutputType<{
+                upstream_status: z.ZodOptional<z.ZodNumber>;
+                request_id: z.ZodOptional<z.ZodString>;
+            }, z.ZodTypeAny, "passthrough"> | undefined;
+        };
+        request_id: string;
+    };
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        request_id: string;
+        count: number;
+        collections: {
+            id: string | number;
+            name: string;
+            description?: string | null | undefined;
+            workspace_id?: string | number | undefined;
+            instance_visibility?: (string | number)[] | undefined;
+            user_id?: string | number | null | undefined;
+            created_at?: string | null | undefined;
+            updated_at?: string | null | undefined;
+            assets_id?: (string | number)[] | undefined;
+            instance_id?: string | number | undefined;
+            is_backend_user?: number | boolean | undefined;
+        }[];
+    };
+    isError?: undefined;
+}>;
+//# sourceMappingURL=list-collections.d.ts.map

package/dist/tools/list-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-collections.d.ts","sourceRoot":"","sources":["../../src/tools/list-collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAItC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,4BAA4B,QAIA,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmChE"}

package/dist/tools/list-collections.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { CollectionSchema } from '../types.js';
+export const ListCollectionsOutputSchema = z.object({
+    collections: z.array(CollectionSchema),
+    count: z.number().int(),
+    request_id: z.string(),
+});
+export const LIST_COLLECTIONS_DESCRIPTION = 'List all DAM collections (Collages) in the configured workspace. Each ' +
+    'collection is a curated set of assets — useful for distribution, ' +
+    'campaigns, or themed groupings. Returns the collection ID, name, and ' +
+    'the asset IDs it contains. Read-only.';
+/**
+ * Build the handler for the `list_collections` tool.
+ *
+ * Wraps `CollageClient.listCollections()`, which calls
+ * `GET /digital-assets/collection/get-all` and returns the API projection
+ * `{id, name, assets_id[], instance_visibility[]}`.
+ */
+export function buildListCollectionsHandler(client) {
+    return async () => {
+        const result = await client.listCollections();
+        if (!result.ok) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `list_collections failed: ${result.error.code} — ${result.error.message}`,
+                    },
+                ],
+                structuredContent: {
+                    error: result.error,
+                    request_id: result.request_id,
+                },
+            };
+        }
+        const output = {
+            collections: result.data,
+            count: result.data.length,
+            request_id: result.request_id,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    };
+}
+//# sourceMappingURL=list-collections.js.map

package/dist/tools/list-collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-collections.js","sourceRoot":"","sources":["../../src/tools/list-collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,4BAA4B,GACvC,wEAAwE;IACxE,mEAAmE;IACnE,uEAAuE;IACvE,uCAAuC,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAqB;IAC/D,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,4BAA4B,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;qBAChF;iBACF;gBACD,iBAAiB,EAAE;oBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC9B;aACF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAA0B;YACpC,WAAW,EAAE,MAAM,CAAC,IAAI;YACxB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;YACD,iBAAiB,EAAE,MAAM;SAC1B,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/list-custom-fields.d.ts

@@ -0,0 +1,125 @@
+import { z } from 'zod';
+import type { CollageClient } from '../client.js';
+export declare const ListCustomFieldsOutputSchema: z.ZodObject<{
+    custom_fields: z.ZodArray<z.ZodObject<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        workspace_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        name: z.ZodOptional<z.ZodString>;
+        field_label: z.ZodOptional<z.ZodString>;
+        field_type: z.ZodOptional<z.ZodString>;
+        is_required: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        status: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+        values: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        workspace_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        name: z.ZodOptional<z.ZodString>;
+        field_label: z.ZodOptional<z.ZodString>;
+        field_type: z.ZodOptional<z.ZodString>;
+        is_required: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        status: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+        values: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        workspace_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        name: z.ZodOptional<z.ZodString>;
+        field_label: z.ZodOptional<z.ZodString>;
+        field_type: z.ZodOptional<z.ZodString>;
+        is_required: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        status: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+        values: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    count: z.ZodNumber;
+    request_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    request_id: string;
+    custom_fields: z.objectOutputType<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        workspace_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        name: z.ZodOptional<z.ZodString>;
+        field_label: z.ZodOptional<z.ZodString>;
+        field_type: z.ZodOptional<z.ZodString>;
+        is_required: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        status: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+        values: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough">[];
+    count: number;
+}, {
+    request_id: string;
+    custom_fields: z.objectInputType<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        workspace_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        name: z.ZodOptional<z.ZodString>;
+        field_label: z.ZodOptional<z.ZodString>;
+        field_type: z.ZodOptional<z.ZodString>;
+        is_required: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        status: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+        values: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough">[];
+    count: number;
+}>;
+export type ListCustomFieldsOutput = z.infer<typeof ListCustomFieldsOutputSchema>;
+export declare const LIST_CUSTOM_FIELDS_DESCRIPTION: string;
+/**
+ * Build the handler for the `list_custom_fields` tool. Wraps
+ * `CollageClient.listCustomFields()` which calls
+ * GET /digital-assets/custom-field/list.
+ */
+export declare function buildListCustomFieldsHandler(client: CollageClient): () => Promise<{
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        error: {
+            code: "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION" | "RATE_LIMITED" | "UPSTREAM" | "CONFIRMATION_STALE" | "CONFIRMATION_MISSING" | "CONFIRMATION_STATE_DIVERGED" | "ENTITLEMENT" | "INTERNAL";
+            message: string;
+            retriable: boolean;
+            cause?: z.objectOutputType<{
+                upstream_status: z.ZodOptional<z.ZodNumber>;
+                request_id: z.ZodOptional<z.ZodString>;
+            }, z.ZodTypeAny, "passthrough"> | undefined;
+        };
+        request_id: string;
+    };
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        request_id: string;
+        custom_fields: z.objectOutputType<{
+            id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            workspace_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+            name: z.ZodOptional<z.ZodString>;
+            field_label: z.ZodOptional<z.ZodString>;
+            field_type: z.ZodOptional<z.ZodString>;
+            is_required: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+            status: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+            options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+            values: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+            created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+            updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        }, z.ZodTypeAny, "passthrough">[];
+        count: number;
+    };
+    isError?: undefined;
+}>;
+//# sourceMappingURL=list-custom-fields.d.ts.map

package/dist/tools/list-custom-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-custom-fields.d.ts","sourceRoot":"","sources":["../../src/tools/list-custom-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,8BAA8B,QAIyB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCjE"}

package/dist/tools/list-custom-fields.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { CustomFieldSchema } from '../types.js';
+export const ListCustomFieldsOutputSchema = z.object({
+    custom_fields: z.array(CustomFieldSchema),
+    count: z.number().int(),
+    request_id: z.string(),
+});
+export const LIST_CUSTOM_FIELDS_DESCRIPTION = 'List the workspace custom-field definitions. Returns each field id, ' +
+    'label, type, and status. Useful before issuing a `search_assets` query ' +
+    'that filters on `custom_fields:` clauses, or before calling ' +
+    '`update_asset_metadata` with a `custom_fields` patch. Read-only.';
+/**
+ * Build the handler for the `list_custom_fields` tool. Wraps
+ * `CollageClient.listCustomFields()` which calls
+ * GET /digital-assets/custom-field/list.
+ */
+export function buildListCustomFieldsHandler(client) {
+    return async () => {
+        const result = await client.listCustomFields();
+        if (!result.ok) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `list_custom_fields failed: ${result.error.code} — ${result.error.message}`,
+                    },
+                ],
+                structuredContent: {
+                    error: result.error,
+                    request_id: result.request_id,
+                },
+            };
+        }
+        const output = {
+            custom_fields: result.data,
+            count: result.data.length,
+            request_id: result.request_id,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    };
+}
+//# sourceMappingURL=list-custom-fields.js.map

package/dist/tools/list-custom-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-custom-fields.js","sourceRoot":"","sources":["../../src/tools/list-custom-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,8BAA8B,GACzC,sEAAsE;IACtE,yEAAyE;IACzE,8DAA8D;IAC9D,kEAAkE,CAAC;AAErE;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAqB;IAChE,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,8BAA8B,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;qBAClF;iBACF;gBACD,iBAAiB,EAAE;oBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC9B;aACF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAA2B;YACrC,aAAa,EAAE,MAAM,CAAC,IAAI;YAC1B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;YACD,iBAAiB,EAAE,MAAM;SAC1B,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/list-share-links.d.ts

@@ -0,0 +1,192 @@
+import { z } from 'zod';
+import type { CollageClient } from '../client.js';
+export declare const ListShareLinksInputSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    page_size: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Mirrors the Admin-Frontend filter dropdown values
+     * (`active`, `expired`, `revoked`). Pass-through — upstream interprets.
+     */
+    filter_by: z.ZodOptional<z.ZodString>;
+    sort_by: z.ZodOptional<z.ZodEnum<["ASC", "DESC"]>>;
+    sort_value: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sort_by?: "ASC" | "DESC" | undefined;
+    sort_value?: string | undefined;
+    filter_by?: string | undefined;
+    cursor?: string | undefined;
+    page_size?: number | undefined;
+}, {
+    sort_by?: "ASC" | "DESC" | undefined;
+    sort_value?: string | undefined;
+    filter_by?: string | undefined;
+    cursor?: string | undefined;
+    page_size?: number | undefined;
+}>;
+export type ListShareLinksInput = z.infer<typeof ListShareLinksInputSchema>;
+export declare const ListShareLinksOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_new_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_origin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        expiration: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        password: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        hide_download: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodBoolean, z.ZodNumber, z.ZodString]>>>;
+        total_visited: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        generated_source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        workspace_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        asset_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_new_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_origin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        expiration: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        password: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        hide_download: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodBoolean, z.ZodNumber, z.ZodString]>>>;
+        total_visited: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        generated_source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        workspace_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        asset_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_new_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_origin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        expiration: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        password: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        hide_download: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodBoolean, z.ZodNumber, z.ZodString]>>>;
+        total_visited: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        generated_source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        workspace_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        asset_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    next_cursor: z.ZodNullable<z.ZodString>;
+    total_estimate: z.ZodNullable<z.ZodNumber>;
+    request_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    request_id: string;
+    items: z.objectOutputType<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_new_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_origin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        expiration: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        password: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        hide_download: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodBoolean, z.ZodNumber, z.ZodString]>>>;
+        total_visited: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        generated_source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        workspace_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        asset_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>>;
+    }, z.ZodTypeAny, "passthrough">[];
+    next_cursor: string | null;
+    total_estimate: number | null;
+}, {
+    request_id: string;
+    items: z.objectInputType<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_new_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        share_origin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        expiration: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        password: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        hide_download: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodBoolean, z.ZodNumber, z.ZodString]>>>;
+        total_visited: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+        generated_source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        workspace_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        asset_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>>;
+    }, z.ZodTypeAny, "passthrough">[];
+    next_cursor: string | null;
+    total_estimate: number | null;
+}>;
+export type ListShareLinksOutput = z.infer<typeof ListShareLinksOutputSchema>;
+/**
+ * Narrow surface used by the handler — kept minimal so tests can stub
+ * without instantiating the full CollageClient.
+ */
+export type ListShareLinksClient = Pick<CollageClient, 'listShareLinks'>;
+export declare const LIST_SHARE_LINKS_DESCRIPTION: string;
+/**
+ * The upstream uses 1-based page numbering with a `total_record` page
+ * size, which we map onto our base64 offset cursor by floor-dividing
+ * `offset / pageSize` and translating between pages and offsets at the
+ * boundary. Cursors that don't align to page boundaries are clamped to
+ * the next-lower page start — this is fine because we don't expose
+ * arbitrary offsets to callers; cursors are always derived from a prior
+ * `next_cursor`.
+ */
+export declare function buildListShareLinksHandler(client: ListShareLinksClient): (args: ListShareLinksInput) => Promise<{
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        error: {
+            code: "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION" | "RATE_LIMITED" | "UPSTREAM" | "CONFIRMATION_STALE" | "CONFIRMATION_MISSING" | "CONFIRMATION_STATE_DIVERGED" | "ENTITLEMENT" | "INTERNAL";
+            message: string;
+            retriable: boolean;
+            cause?: z.objectOutputType<{
+                upstream_status: z.ZodOptional<z.ZodNumber>;
+                request_id: z.ZodOptional<z.ZodString>;
+            }, z.ZodTypeAny, "passthrough"> | undefined;
+        };
+        request_id: string;
+    };
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        request_id: string;
+        items: z.objectOutputType<{
+            id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            share_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            share_new_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            share_origin: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            expiration: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            password: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            hide_download: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodBoolean, z.ZodNumber, z.ZodString]>>>;
+            total_visited: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+            created_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+            updated_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodString]>>>;
+            generated_source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            workspace_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+            user_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+            asset_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>>;
+        }, z.ZodTypeAny, "passthrough">[];
+        next_cursor: string | null;
+        total_estimate: number | null;
+    };
+    isError?: undefined;
+}>;
+//# sourceMappingURL=list-share-links.d.ts.map

package/dist/tools/list-share-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-share-links.d.ts","sourceRoot":"","sources":["../../src/tools/list-share-links.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AASlD,eAAO,MAAM,yBAAyB;;;IAGpC;;;OAGG;;;;;;;;;;;;;;;;EAIH,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;AAEzE,eAAO,MAAM,4BAA4B,QAI3B,CAAC;AAEf;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,IACvD,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDxC"}