@collage-dam/mcp-server 0.1.0

package/dist/tools/get-asset-details.d.ts

@@ -0,0 +1,401 @@
+import { z } from 'zod';
+import type { CollageClient } from '../client.js';
+export declare const GetAssetDetailsInputSchema: {
+    asset_id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+};
+export declare const GetAssetDetailsOutputSchema: z.ZodObject<{
+    asset: z.ZodObject<{
+        id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        version: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        assets_version_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, 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]>>>;
+        display_file_name: z.ZodString;
+        file_name: z.ZodString;
+        file_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        file_size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        height: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        width: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        auto_tag: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["0", "1", ""]>]>>>;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        category_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        is_categorized: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["0", "1"]>]>>;
+        is_public: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        is_archive: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        is_deleted: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        is_editorial_use: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        is_external_upload: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
+        thumbnail_file: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        compress_file: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        video_preview: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        watermark_file: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        watermark_original_file: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        checksum: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        file_preview_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        file_preview_status: z.ZodOptional<z.ZodEnum<["pending", "started", "success", "failure"]>>;
+        share_id: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>;
+        acl_permission: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            tag_name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string | number;
+            tag_name: string;
+        }, {
+            id: string | number;
+            tag_name: string;
+        }>, "many">>;
+        breadcrumb: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            folder_name: z.ZodNullable<z.ZodString>;
+            parent_id: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+            instance_visibility: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>;
+            parent: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string | number;
+            folder_name: string | null;
+            parent_id: string | number | null;
+            instance_visibility?: (string | number)[] | undefined;
+            parent?: unknown;
+        }, {
+            id: string | number;
+            folder_name: string | null;
+            parent_id: string | number | null;
+            instance_visibility?: (string | number)[] | undefined;
+            parent?: unknown;
+        }>>>;
+        file_meta_data: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            DateUploaded: z.ZodOptional<z.ZodString>;
+            LastModified: z.ZodOptional<z.ZodString>;
+            Credit: z.ZodOptional<z.ZodString>;
+            Dimensions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            DateUploaded: z.ZodOptional<z.ZodString>;
+            LastModified: z.ZodOptional<z.ZodString>;
+            Credit: z.ZodOptional<z.ZodString>;
+            Dimensions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            DateUploaded: z.ZodOptional<z.ZodString>;
+            LastModified: z.ZodOptional<z.ZodString>;
+            Credit: z.ZodOptional<z.ZodString>;
+            Dimensions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">>>>;
+        modified_at: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, 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]>>>;
+        custom_fields: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        file_name: string;
+        display_file_name: string;
+        id: string | number;
+        type?: string | null | undefined;
+        description?: string | null | undefined;
+        custom_fields?: unknown[] | null | undefined;
+        version?: number | null | undefined;
+        workspace_id?: string | number | null | undefined;
+        assets_version_id?: string | number | null | undefined;
+        user_id?: string | number | null | undefined;
+        file_type?: string | null | undefined;
+        file_size?: number | null | undefined;
+        height?: string | number | null | undefined;
+        width?: string | number | null | undefined;
+        auto_tag?: boolean | "" | "0" | "1" | null | undefined;
+        category_id?: string | number | null | undefined;
+        is_categorized?: boolean | "0" | "1" | undefined;
+        is_public?: number | boolean | undefined;
+        is_archive?: number | boolean | undefined;
+        is_deleted?: number | boolean | undefined;
+        is_editorial_use?: number | boolean | undefined;
+        is_external_upload?: number | boolean | undefined;
+        thumbnail_file?: string | null | undefined;
+        compress_file?: string | null | undefined;
+        video_preview?: string | null | undefined;
+        watermark_file?: string | null | undefined;
+        watermark_original_file?: string | null | undefined;
+        checksum?: string | null | undefined;
+        file_preview_id?: string | null | undefined;
+        file_preview_status?: "pending" | "started" | "success" | "failure" | undefined;
+        share_id?: (string | number)[] | undefined;
+        acl_permission?: unknown[] | undefined;
+        tags?: {
+            id: string | number;
+            tag_name: string;
+        }[] | undefined;
+        breadcrumb?: {
+            id: string | number;
+            folder_name: string | null;
+            parent_id: string | number | null;
+            instance_visibility?: (string | number)[] | undefined;
+            parent?: unknown;
+        } | null | undefined;
+        file_meta_data?: z.objectOutputType<{
+            DateUploaded: z.ZodOptional<z.ZodString>;
+            LastModified: z.ZodOptional<z.ZodString>;
+            Credit: z.ZodOptional<z.ZodString>;
+            Dimensions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough"> | null | undefined;
+        modified_at?: string | null | undefined;
+        created_at?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    }, {
+        file_name: string;
+        display_file_name: string;
+        id: string | number;
+        type?: string | null | undefined;
+        description?: string | null | undefined;
+        custom_fields?: unknown[] | null | undefined;
+        version?: number | null | undefined;
+        workspace_id?: string | number | null | undefined;
+        assets_version_id?: string | number | null | undefined;
+        user_id?: string | number | null | undefined;
+        file_type?: string | null | undefined;
+        file_size?: number | null | undefined;
+        height?: string | number | null | undefined;
+        width?: string | number | null | undefined;
+        auto_tag?: boolean | "" | "0" | "1" | null | undefined;
+        category_id?: string | number | null | undefined;
+        is_categorized?: boolean | "0" | "1" | undefined;
+        is_public?: number | boolean | undefined;
+        is_archive?: number | boolean | undefined;
+        is_deleted?: number | boolean | undefined;
+        is_editorial_use?: number | boolean | undefined;
+        is_external_upload?: number | boolean | undefined;
+        thumbnail_file?: string | null | undefined;
+        compress_file?: string | null | undefined;
+        video_preview?: string | null | undefined;
+        watermark_file?: string | null | undefined;
+        watermark_original_file?: string | null | undefined;
+        checksum?: string | null | undefined;
+        file_preview_id?: string | null | undefined;
+        file_preview_status?: "pending" | "started" | "success" | "failure" | undefined;
+        share_id?: (string | number)[] | undefined;
+        acl_permission?: unknown[] | undefined;
+        tags?: {
+            id: string | number;
+            tag_name: string;
+        }[] | undefined;
+        breadcrumb?: {
+            id: string | number;
+            folder_name: string | null;
+            parent_id: string | number | null;
+            instance_visibility?: (string | number)[] | undefined;
+            parent?: unknown;
+        } | null | undefined;
+        file_meta_data?: z.objectInputType<{
+            DateUploaded: z.ZodOptional<z.ZodString>;
+            LastModified: z.ZodOptional<z.ZodString>;
+            Credit: z.ZodOptional<z.ZodString>;
+            Dimensions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough"> | null | undefined;
+        modified_at?: string | null | undefined;
+        created_at?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    }>;
+    request_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    request_id: string;
+    asset: {
+        file_name: string;
+        display_file_name: string;
+        id: string | number;
+        type?: string | null | undefined;
+        description?: string | null | undefined;
+        custom_fields?: unknown[] | null | undefined;
+        version?: number | null | undefined;
+        workspace_id?: string | number | null | undefined;
+        assets_version_id?: string | number | null | undefined;
+        user_id?: string | number | null | undefined;
+        file_type?: string | null | undefined;
+        file_size?: number | null | undefined;
+        height?: string | number | null | undefined;
+        width?: string | number | null | undefined;
+        auto_tag?: boolean | "" | "0" | "1" | null | undefined;
+        category_id?: string | number | null | undefined;
+        is_categorized?: boolean | "0" | "1" | undefined;
+        is_public?: number | boolean | undefined;
+        is_archive?: number | boolean | undefined;
+        is_deleted?: number | boolean | undefined;
+        is_editorial_use?: number | boolean | undefined;
+        is_external_upload?: number | boolean | undefined;
+        thumbnail_file?: string | null | undefined;
+        compress_file?: string | null | undefined;
+        video_preview?: string | null | undefined;
+        watermark_file?: string | null | undefined;
+        watermark_original_file?: string | null | undefined;
+        checksum?: string | null | undefined;
+        file_preview_id?: string | null | undefined;
+        file_preview_status?: "pending" | "started" | "success" | "failure" | undefined;
+        share_id?: (string | number)[] | undefined;
+        acl_permission?: unknown[] | undefined;
+        tags?: {
+            id: string | number;
+            tag_name: string;
+        }[] | undefined;
+        breadcrumb?: {
+            id: string | number;
+            folder_name: string | null;
+            parent_id: string | number | null;
+            instance_visibility?: (string | number)[] | undefined;
+            parent?: unknown;
+        } | null | undefined;
+        file_meta_data?: z.objectOutputType<{
+            DateUploaded: z.ZodOptional<z.ZodString>;
+            LastModified: z.ZodOptional<z.ZodString>;
+            Credit: z.ZodOptional<z.ZodString>;
+            Dimensions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough"> | null | undefined;
+        modified_at?: string | null | undefined;
+        created_at?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    };
+}, {
+    request_id: string;
+    asset: {
+        file_name: string;
+        display_file_name: string;
+        id: string | number;
+        type?: string | null | undefined;
+        description?: string | null | undefined;
+        custom_fields?: unknown[] | null | undefined;
+        version?: number | null | undefined;
+        workspace_id?: string | number | null | undefined;
+        assets_version_id?: string | number | null | undefined;
+        user_id?: string | number | null | undefined;
+        file_type?: string | null | undefined;
+        file_size?: number | null | undefined;
+        height?: string | number | null | undefined;
+        width?: string | number | null | undefined;
+        auto_tag?: boolean | "" | "0" | "1" | null | undefined;
+        category_id?: string | number | null | undefined;
+        is_categorized?: boolean | "0" | "1" | undefined;
+        is_public?: number | boolean | undefined;
+        is_archive?: number | boolean | undefined;
+        is_deleted?: number | boolean | undefined;
+        is_editorial_use?: number | boolean | undefined;
+        is_external_upload?: number | boolean | undefined;
+        thumbnail_file?: string | null | undefined;
+        compress_file?: string | null | undefined;
+        video_preview?: string | null | undefined;
+        watermark_file?: string | null | undefined;
+        watermark_original_file?: string | null | undefined;
+        checksum?: string | null | undefined;
+        file_preview_id?: string | null | undefined;
+        file_preview_status?: "pending" | "started" | "success" | "failure" | undefined;
+        share_id?: (string | number)[] | undefined;
+        acl_permission?: unknown[] | undefined;
+        tags?: {
+            id: string | number;
+            tag_name: string;
+        }[] | undefined;
+        breadcrumb?: {
+            id: string | number;
+            folder_name: string | null;
+            parent_id: string | number | null;
+            instance_visibility?: (string | number)[] | undefined;
+            parent?: unknown;
+        } | null | undefined;
+        file_meta_data?: z.objectInputType<{
+            DateUploaded: z.ZodOptional<z.ZodString>;
+            LastModified: z.ZodOptional<z.ZodString>;
+            Credit: z.ZodOptional<z.ZodString>;
+            Dimensions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough"> | null | undefined;
+        modified_at?: string | null | undefined;
+        created_at?: string | null | undefined;
+        updated_at?: string | null | undefined;
+    };
+}>;
+export type GetAssetDetailsOutput = z.infer<typeof GetAssetDetailsOutputSchema>;
+export declare const GET_ASSET_DETAILS_DESCRIPTION: string;
+/**
+ * Build the handler for the `get_asset_details` tool.
+ *
+ * Wraps `CollageClient.getAssetDetails()`, which calls
+ * `POST /digital-assets/view-detail` with `digital_assets_id` body param.
+ */
+export declare function buildGetAssetDetailsHandler(client: CollageClient): ({ asset_id }: {
+    asset_id: number | string;
+}) => 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;
+        asset: {
+            file_name: string;
+            display_file_name: string;
+            id: string | number;
+            type?: string | null | undefined;
+            description?: string | null | undefined;
+            custom_fields?: unknown[] | null | undefined;
+            version?: number | null | undefined;
+            workspace_id?: string | number | null | undefined;
+            assets_version_id?: string | number | null | undefined;
+            user_id?: string | number | null | undefined;
+            file_type?: string | null | undefined;
+            file_size?: number | null | undefined;
+            height?: string | number | null | undefined;
+            width?: string | number | null | undefined;
+            auto_tag?: boolean | "" | "0" | "1" | null | undefined;
+            category_id?: string | number | null | undefined;
+            is_categorized?: boolean | "0" | "1" | undefined;
+            is_public?: number | boolean | undefined;
+            is_archive?: number | boolean | undefined;
+            is_deleted?: number | boolean | undefined;
+            is_editorial_use?: number | boolean | undefined;
+            is_external_upload?: number | boolean | undefined;
+            thumbnail_file?: string | null | undefined;
+            compress_file?: string | null | undefined;
+            video_preview?: string | null | undefined;
+            watermark_file?: string | null | undefined;
+            watermark_original_file?: string | null | undefined;
+            checksum?: string | null | undefined;
+            file_preview_id?: string | null | undefined;
+            file_preview_status?: "pending" | "started" | "success" | "failure" | undefined;
+            share_id?: (string | number)[] | undefined;
+            acl_permission?: unknown[] | undefined;
+            tags?: {
+                id: string | number;
+                tag_name: string;
+            }[] | undefined;
+            breadcrumb?: {
+                id: string | number;
+                folder_name: string | null;
+                parent_id: string | number | null;
+                instance_visibility?: (string | number)[] | undefined;
+                parent?: unknown;
+            } | null | undefined;
+            file_meta_data?: z.objectOutputType<{
+                DateUploaded: z.ZodOptional<z.ZodString>;
+                LastModified: z.ZodOptional<z.ZodString>;
+                Credit: z.ZodOptional<z.ZodString>;
+                Dimensions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.ZodTypeAny, "passthrough"> | null | undefined;
+            modified_at?: string | null | undefined;
+            created_at?: string | null | undefined;
+            updated_at?: string | null | undefined;
+        };
+    };
+    isError?: undefined;
+}>;
+//# sourceMappingURL=get-asset-details.d.ts.map

package/dist/tools/get-asset-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-asset-details.d.ts","sourceRoot":"","sources":["../../src/tools/get-asset-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,0BAA0B;;CAItC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,6BAA6B,QAKkB,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,IACjD,cAAc;IAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiC1D"}

package/dist/tools/get-asset-details.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { DigitalAssetSchema } from '../types.js';
+export const GetAssetDetailsInputSchema = {
+    asset_id: z
+        .union([z.number().int().positive(), z.string().min(1)])
+        .describe('The numeric Collage asset ID to look up.'),
+};
+export const GetAssetDetailsOutputSchema = z.object({
+    asset: DigitalAssetSchema,
+    request_id: z.string(),
+});
+export const GET_ASSET_DETAILS_DESCRIPTION = 'Retrieve complete metadata for a single Collage asset by its ID. ' +
+    'Returns the file name, type, size, dimensions, tags, folder location ' +
+    '(breadcrumb), formatted upload metadata, and signed thumbnail/compressed ' +
+    'preview URLs valid for 24 hours. Use this after listing collections or ' +
+    'browsing folders to inspect a specific asset. Read-only.';
+/**
+ * Build the handler for the `get_asset_details` tool.
+ *
+ * Wraps `CollageClient.getAssetDetails()`, which calls
+ * `POST /digital-assets/view-detail` with `digital_assets_id` body param.
+ */
+export function buildGetAssetDetailsHandler(client) {
+    return async ({ asset_id }) => {
+        const result = await client.getAssetDetails(asset_id);
+        if (!result.ok) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `get_asset_details failed: ${result.error.code} — ${result.error.message}`,
+                    },
+                ],
+                structuredContent: {
+                    error: result.error,
+                    request_id: result.request_id,
+                },
+            };
+        }
+        const output = {
+            asset: result.data,
+            request_id: result.request_id,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    };
+}
+//# sourceMappingURL=get-asset-details.js.map

package/dist/tools/get-asset-details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-asset-details.js","sourceRoot":"","sources":["../../src/tools/get-asset-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SACvD,QAAQ,CAAC,0CAA0C,CAAC;CACxD,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,KAAK,EAAE,kBAAkB;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,6BAA6B,GACxC,mEAAmE;IACnE,uEAAuE;IACvE,2EAA2E;IAC3E,yEAAyE;IACzE,0DAA0D,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAqB;IAC/D,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAiC,EAAE,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,6BAA6B,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;qBACjF;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,KAAK,EAAE,MAAM,CAAC,IAAI;YAClB,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/get-collection.d.ts

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import type { CollageClient } from '../client.js';
+export declare const GetCollectionInputSchema: {
+    collection_id: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+};
+export declare const GetCollectionOutputSchema: z.ZodObject<{
+    collection: 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;
+    }>;
+    request_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    request_id: string;
+    collection: {
+        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;
+    collection: {
+        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 GetCollectionOutput = z.infer<typeof GetCollectionOutputSchema>;
+export declare const GET_COLLECTION_DESCRIPTION: string;
+/**
+ * Build the handler for the `get_collection` tool. Wraps
+ * `CollageClient.getCollection()` which fetches the full list and filters
+ * by id (the upstream lacks a per-id route).
+ */
+export declare function buildGetCollectionHandler(client: CollageClient): ({ collection_id }: {
+    collection_id: number | string;
+}) => 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;
+        collection: {
+            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=get-collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-collection.d.ts","sourceRoot":"","sources":["../../src/tools/get-collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,wBAAwB;;CAIpC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,0BAA0B,QAIN,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,IAC/C,mBAAmB;IAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCpE"}

package/dist/tools/get-collection.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { CollectionSchema, IdSchema } from '../types.js';
+export const GetCollectionInputSchema = {
+    collection_id: IdSchema.describe('The Collage collection (Collage) id to fetch. Numeric or string.'),
+};
+export const GetCollectionOutputSchema = z.object({
+    collection: CollectionSchema,
+    request_id: z.string(),
+});
+export const GET_COLLECTION_DESCRIPTION = 'Retrieve a single Collage collection (Collage) by its id. Returns the ' +
+    'collection name, description, and the asset ids it contains. Backed by ' +
+    '`collection/get-all` filtered client-side — the upstream does not expose ' +
+    'a per-id endpoint. Read-only.';
+/**
+ * Build the handler for the `get_collection` tool. Wraps
+ * `CollageClient.getCollection()` which fetches the full list and filters
+ * by id (the upstream lacks a per-id route).
+ */
+export function buildGetCollectionHandler(client) {
+    return async ({ collection_id }) => {
+        const result = await client.getCollection(collection_id);
+        if (!result.ok) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `get_collection failed: ${result.error.code} — ${result.error.message}`,
+                    },
+                ],
+                structuredContent: {
+                    error: result.error,
+                    request_id: result.request_id,
+                },
+            };
+        }
+        const output = {
+            collection: result.data,
+            request_id: result.request_id,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    };
+}
+//# sourceMappingURL=get-collection.js.map

package/dist/tools/get-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-collection.js","sourceRoot":"","sources":["../../src/tools/get-collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAC9B,kEAAkE,CACnE;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,0BAA0B,GACrC,wEAAwE;IACxE,yEAAyE;IACzE,2EAA2E;IAC3E,+BAA+B,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAqB;IAC7D,OAAO,KAAK,EAAE,EAAE,aAAa,EAAsC,EAAE,EAAE;QACrE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,0BAA0B,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;qBAC9E;iBACF;gBACD,iBAAiB,EAAE;oBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC9B;aACF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAwB;YAClC,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,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"}