spotted-ts-mcp 0.1.0

package/tools/users/playlists/create-users-playlists.js

@@ -0,0 +1,52 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.tool = exports.metadata = void 0;
+const types_1 = require("spotted-ts-mcp/tools/types");
+exports.metadata = {
+    resource: 'users.playlists',
+    operation: 'write',
+    tags: [],
+    httpMethod: 'post',
+    httpPath: '/users/{user_id}/playlists',
+    operationId: 'create-playlist',
+};
+exports.tool = {
+    name: 'create_users_playlists',
+    description: 'Create a playlist for a Spotify user. (The playlist will be empty until\nyou [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).)\nEach user is generally limited to a maximum of 11000 playlists.\n',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: {
+                type: 'string',
+                title: 'User ID',
+                description: "The user's [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids).\n",
+            },
+            name: {
+                type: 'string',
+                description: 'The name for the new playlist, for example `"Your Coolest Playlist"`. This name does not need to be unique; a user may have several playlists with the same name.\n',
+            },
+            collaborative: {
+                type: 'boolean',
+                description: 'Defaults to `false`. If `true` the playlist will be collaborative. _**Note**: to create a collaborative playlist you must also set `public` to `false`. To create collaborative playlists you must have granted `playlist-modify-private` and `playlist-modify-public` [scopes](/documentation/web-api/concepts/scopes/#list-of-scopes)._\n',
+            },
+            description: {
+                type: 'string',
+                description: 'value for playlist description as displayed in Spotify Clients and in the Web API.\n',
+            },
+            public: {
+                type: 'boolean',
+                description: "Defaults to `true`. The playlist's public/private status (if it should be added to the user's profile or not): `true` the playlist will be public, `false` the playlist will be private. To be able to create private playlists, the user must have granted the `playlist-modify-private` [scope](/documentation/web-api/concepts/scopes/#list-of-scopes). For more about public/private status, see [Working with Playlists](/documentation/web-api/concepts/playlists)\n",
+            },
+        },
+        required: ['user_id', 'name'],
+    },
+    annotations: {},
+};
+const handler = async (client, args) => {
+    const { user_id, ...body } = args;
+    return (0, types_1.asTextContentResult)(await client.users.playlists.create(user_id, body));
+};
+exports.handler = handler;
+exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
+//# sourceMappingURL=create-users-playlists.js.map

package/tools/users/playlists/create-users-playlists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-users-playlists.js","sourceRoot":"","sources":["../../../src/tools/users/playlists/create-users-playlists.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,iBAAiB;IAC3B,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,4BAA4B;IACtC,WAAW,EAAE,iBAAiB;CAC/B,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,yNAAyN;IAC3N,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,mFAAmF;aACjG;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qKAAqK;aACxK;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,6UAA6U;aAChV;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sFAAsF;aACpG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,4cAA4c;aAC/c;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;KAC9B;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACzC,OAAO,IAAA,2BAAmB,EAAC,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;AACjF,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/users/playlists/create-users-playlists.mjs

@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { asTextContentResult } from 'spotted-ts-mcp/tools/types';
+export const metadata = {
+    resource: 'users.playlists',
+    operation: 'write',
+    tags: [],
+    httpMethod: 'post',
+    httpPath: '/users/{user_id}/playlists',
+    operationId: 'create-playlist',
+};
+export const tool = {
+    name: 'create_users_playlists',
+    description: 'Create a playlist for a Spotify user. (The playlist will be empty until\nyou [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).)\nEach user is generally limited to a maximum of 11000 playlists.\n',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: {
+                type: 'string',
+                title: 'User ID',
+                description: "The user's [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids).\n",
+            },
+            name: {
+                type: 'string',
+                description: 'The name for the new playlist, for example `"Your Coolest Playlist"`. This name does not need to be unique; a user may have several playlists with the same name.\n',
+            },
+            collaborative: {
+                type: 'boolean',
+                description: 'Defaults to `false`. If `true` the playlist will be collaborative. _**Note**: to create a collaborative playlist you must also set `public` to `false`. To create collaborative playlists you must have granted `playlist-modify-private` and `playlist-modify-public` [scopes](/documentation/web-api/concepts/scopes/#list-of-scopes)._\n',
+            },
+            description: {
+                type: 'string',
+                description: 'value for playlist description as displayed in Spotify Clients and in the Web API.\n',
+            },
+            public: {
+                type: 'boolean',
+                description: "Defaults to `true`. The playlist's public/private status (if it should be added to the user's profile or not): `true` the playlist will be public, `false` the playlist will be private. To be able to create private playlists, the user must have granted the `playlist-modify-private` [scope](/documentation/web-api/concepts/scopes/#list-of-scopes). For more about public/private status, see [Working with Playlists](/documentation/web-api/concepts/playlists)\n",
+            },
+        },
+        required: ['user_id', 'name'],
+    },
+    annotations: {},
+};
+export const handler = async (client, args) => {
+    const { user_id, ...body } = args;
+    return asTextContentResult(await client.users.playlists.create(user_id, body));
+};
+export default { metadata, tool, handler };
+//# sourceMappingURL=create-users-playlists.mjs.map

package/tools/users/playlists/create-users-playlists.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-users-playlists.mjs","sourceRoot":"","sources":["../../../src/tools/users/playlists/create-users-playlists.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,iBAAiB;IAC3B,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,4BAA4B;IACtC,WAAW,EAAE,iBAAiB;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,yNAAyN;IAC3N,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,mFAAmF;aACjG;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qKAAqK;aACxK;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,6UAA6U;aAChV;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sFAAsF;aACpG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,4cAA4c;aAC/c;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;KAC9B;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACzC,OAAO,mBAAmB,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;AACjF,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/users/playlists/list-users-playlists.d.mts

@@ -0,0 +1,45 @@
+import { Metadata } from 'spotted-ts-mcp/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=list-users-playlists.d.mts.map

package/tools/users/playlists/list-users-playlists.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-users-playlists.d.mts","sourceRoot":"","sources":["../../../src/tools/users/playlists/list-users-playlists.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,OAAO,MAAM,YAAY;AAEhC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAmClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAIvF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAJoC,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAMxF,wBAA2C"}

package/tools/users/playlists/list-users-playlists.d.ts

@@ -0,0 +1,45 @@
+import { Metadata } from 'spotted-ts-mcp/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=list-users-playlists.d.ts.map

package/tools/users/playlists/list-users-playlists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-users-playlists.d.ts","sourceRoot":"","sources":["../../../src/tools/users/playlists/list-users-playlists.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,OAAO,MAAM,YAAY;AAEhC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAmClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAIvF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAJoC,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAMxF,wBAA2C"}

package/tools/users/playlists/list-users-playlists.js

@@ -0,0 +1,55 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.tool = exports.metadata = void 0;
+const filtering_1 = require("spotted-ts-mcp/filtering");
+const types_1 = require("spotted-ts-mcp/tools/types");
+exports.metadata = {
+    resource: 'users.playlists',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/users/{user_id}/playlists',
+    operationId: 'get-list-users-playlists',
+};
+exports.tool = {
+    name: 'list_users_playlists',
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet a list of the playlists owned or followed by a Spotify user.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/paging_playlist_object',\n  $defs: {\n    paging_playlist_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint returning the full result of the request\\n'\n        },\n        items: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/simplified_playlist_object'\n          }\n        },\n        limit: {\n          type: 'integer',\n          description: 'The maximum number of items in the response (as set in the query or by default).\\n'\n        },\n        next: {\n          type: 'string',\n          description: 'URL to the next page of items. ( `null` if none)\\n'\n        },\n        offset: {\n          type: 'integer',\n          description: 'The offset of the items returned (as set in the query or by default)\\n'\n        },\n        previous: {\n          type: 'string',\n          description: 'URL to the previous page of items. ( `null` if none)\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'The total number of items available to return.\\n'\n        }\n      },\n      required: [        'href',\n        'items',\n        'limit',\n        'next',\n        'offset',\n        'previous',\n        'total'\n      ]\n    },\n    simplified_playlist_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the playlist.\\n'\n        },\n        collaborative: {\n          type: 'boolean',\n          description: '`true` if the owner allows other users to modify the playlist.\\n'\n        },\n        description: {\n          type: 'string',\n          description: 'The playlist description. _Only returned for modified, verified playlists, otherwise_ `null`.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint providing full details of the playlist.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'Images for the playlist. The array may be empty or contain up to three images. The images are returned by size in descending order. See [Working with Playlists](/documentation/web-api/concepts/playlists). _**Note**: If returned, the source URL for the image (`url`) is temporary and will expire in less than a day._\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the playlist.\\n'\n        },\n        owner: {\n          allOf: [            {\n              $ref: '#/$defs/playlist_user_object'\n            }\n          ],\n          description: 'The user who owns the playlist\\n'\n        },\n        public: {\n          type: 'boolean',\n          description: 'The playlist\\'s public/private status (if it is added to the user\\'s profile): `true` the playlist is public, `false` the playlist is private, `null` the playlist status is not relevant. For more about public/private status, see [Working with Playlists](/documentation/web-api/concepts/playlists)\\n'\n        },\n        snapshot_id: {\n          type: 'string',\n          description: 'The version identifier for the current playlist. Can be supplied in other requests to target a specific playlist version\\n'\n        },\n        tracks: {\n          $ref: '#/$defs/playlist_tracks_ref_object'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type: \"playlist\"\\n'\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the playlist.\\n'\n        }\n      }\n    },\n    external_url_object: {\n      type: 'object',\n      properties: {\n        spotify: {\n          type: 'string',\n          description: 'The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.\\n'\n        }\n      }\n    },\n    image_object: {\n      type: 'object',\n      properties: {\n        height: {\n          type: 'integer',\n          description: 'The image height in pixels.\\n'\n        },\n        url: {\n          type: 'string',\n          description: 'The source URL of the image.\\n'\n        },\n        width: {\n          type: 'integer',\n          description: 'The image width in pixels.\\n'\n        }\n      },\n      required: [        'height',\n        'url',\n        'width'\n      ]\n    },\n    playlist_user_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids) for this user.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint for this user.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'user'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for this user.\\n'\n        }\n      }\n    },\n    playlist_tracks_ref_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint where full details of the playlist\\'s tracks can be retrieved.\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'Number of tracks in the playlist.\\n'\n        }\n      }\n    }\n  }\n}\n```",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: {
+                type: 'string',
+                title: 'User ID',
+                description: "The user's [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids).\n",
+            },
+            limit: {
+                type: 'integer',
+                title: 'Limit',
+                description: 'The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n',
+            },
+            offset: {
+                type: 'integer',
+                title: 'Offset',
+                description: 'The index of the first playlist to return. Default:\n0 (the first object). Maximum offset: 100.000\\. Use with `limit` to get the\nnext set of playlists.\n',
+            },
+            jq_filter: {
+                type: 'string',
+                title: 'jq Filter',
+                description: 'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+            },
+        },
+        required: ['user_id'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+const handler = async (client, args) => {
+    const { user_id, jq_filter, ...body } = args;
+    const response = await client.users.playlists.list(user_id, body).asResponse();
+    return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await response.json()));
+};
+exports.handler = handler;
+exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
+//# sourceMappingURL=list-users-playlists.js.map

package/tools/users/playlists/list-users-playlists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-users-playlists.js","sourceRoot":"","sources":["../../../src/tools/users/playlists/list-users-playlists.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,iBAAiB;IAC3B,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,4BAA4B;IACtC,WAAW,EAAE,0BAA0B;CACxC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,oiMAAoiM;IACtiM,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,mFAAmF;aACjG;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,gFAAgF;aAC9F;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,6JAA6J;aAChK;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IAC/E,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC;AAJW,QAAA,OAAO,WAIlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/users/playlists/list-users-playlists.mjs

@@ -0,0 +1,51 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { maybeFilter } from 'spotted-ts-mcp/filtering';
+import { asTextContentResult } from 'spotted-ts-mcp/tools/types';
+export const metadata = {
+    resource: 'users.playlists',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/users/{user_id}/playlists',
+    operationId: 'get-list-users-playlists',
+};
+export const tool = {
+    name: 'list_users_playlists',
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet a list of the playlists owned or followed by a Spotify user.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/paging_playlist_object',\n  $defs: {\n    paging_playlist_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint returning the full result of the request\\n'\n        },\n        items: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/simplified_playlist_object'\n          }\n        },\n        limit: {\n          type: 'integer',\n          description: 'The maximum number of items in the response (as set in the query or by default).\\n'\n        },\n        next: {\n          type: 'string',\n          description: 'URL to the next page of items. ( `null` if none)\\n'\n        },\n        offset: {\n          type: 'integer',\n          description: 'The offset of the items returned (as set in the query or by default)\\n'\n        },\n        previous: {\n          type: 'string',\n          description: 'URL to the previous page of items. ( `null` if none)\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'The total number of items available to return.\\n'\n        }\n      },\n      required: [        'href',\n        'items',\n        'limit',\n        'next',\n        'offset',\n        'previous',\n        'total'\n      ]\n    },\n    simplified_playlist_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the playlist.\\n'\n        },\n        collaborative: {\n          type: 'boolean',\n          description: '`true` if the owner allows other users to modify the playlist.\\n'\n        },\n        description: {\n          type: 'string',\n          description: 'The playlist description. _Only returned for modified, verified playlists, otherwise_ `null`.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint providing full details of the playlist.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'Images for the playlist. The array may be empty or contain up to three images. The images are returned by size in descending order. See [Working with Playlists](/documentation/web-api/concepts/playlists). _**Note**: If returned, the source URL for the image (`url`) is temporary and will expire in less than a day._\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the playlist.\\n'\n        },\n        owner: {\n          allOf: [            {\n              $ref: '#/$defs/playlist_user_object'\n            }\n          ],\n          description: 'The user who owns the playlist\\n'\n        },\n        public: {\n          type: 'boolean',\n          description: 'The playlist\\'s public/private status (if it is added to the user\\'s profile): `true` the playlist is public, `false` the playlist is private, `null` the playlist status is not relevant. For more about public/private status, see [Working with Playlists](/documentation/web-api/concepts/playlists)\\n'\n        },\n        snapshot_id: {\n          type: 'string',\n          description: 'The version identifier for the current playlist. Can be supplied in other requests to target a specific playlist version\\n'\n        },\n        tracks: {\n          $ref: '#/$defs/playlist_tracks_ref_object'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type: \"playlist\"\\n'\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the playlist.\\n'\n        }\n      }\n    },\n    external_url_object: {\n      type: 'object',\n      properties: {\n        spotify: {\n          type: 'string',\n          description: 'The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.\\n'\n        }\n      }\n    },\n    image_object: {\n      type: 'object',\n      properties: {\n        height: {\n          type: 'integer',\n          description: 'The image height in pixels.\\n'\n        },\n        url: {\n          type: 'string',\n          description: 'The source URL of the image.\\n'\n        },\n        width: {\n          type: 'integer',\n          description: 'The image width in pixels.\\n'\n        }\n      },\n      required: [        'height',\n        'url',\n        'width'\n      ]\n    },\n    playlist_user_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids) for this user.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint for this user.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'user'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for this user.\\n'\n        }\n      }\n    },\n    playlist_tracks_ref_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint where full details of the playlist\\'s tracks can be retrieved.\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'Number of tracks in the playlist.\\n'\n        }\n      }\n    }\n  }\n}\n```",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: {
+                type: 'string',
+                title: 'User ID',
+                description: "The user's [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids).\n",
+            },
+            limit: {
+                type: 'integer',
+                title: 'Limit',
+                description: 'The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n',
+            },
+            offset: {
+                type: 'integer',
+                title: 'Offset',
+                description: 'The index of the first playlist to return. Default:\n0 (the first object). Maximum offset: 100.000\\. Use with `limit` to get the\nnext set of playlists.\n',
+            },
+            jq_filter: {
+                type: 'string',
+                title: 'jq Filter',
+                description: 'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+            },
+        },
+        required: ['user_id'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+export const handler = async (client, args) => {
+    const { user_id, jq_filter, ...body } = args;
+    const response = await client.users.playlists.list(user_id, body).asResponse();
+    return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
+};
+export default { metadata, tool, handler };
+//# sourceMappingURL=list-users-playlists.mjs.map

package/tools/users/playlists/list-users-playlists.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-users-playlists.mjs","sourceRoot":"","sources":["../../../src/tools/users/playlists/list-users-playlists.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,iBAAiB;IAC3B,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,4BAA4B;IACtC,WAAW,EAAE,0BAA0B;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,oiMAAoiM;IACtiM,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,mFAAmF;aACjG;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,gFAAgF;aAC9F;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,6JAA6J;aAChK;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IAC/E,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/users/retrieve-profile-users.d.mts

@@ -0,0 +1,45 @@
+import { Metadata } from 'spotted-ts-mcp/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=retrieve-profile-users.d.mts.map

package/tools/users/retrieve-profile-users.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-profile-users.d.mts","sourceRoot":"","sources":["../../src/tools/users/retrieve-profile-users.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,OAAO,MAAM,YAAY;AAEhC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAwBlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAGvF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAHoC,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAKxF,wBAA2C"}

package/tools/users/retrieve-profile-users.d.ts

@@ -0,0 +1,45 @@
+import { Metadata } from 'spotted-ts-mcp/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=retrieve-profile-users.d.ts.map

package/tools/users/retrieve-profile-users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-profile-users.d.ts","sourceRoot":"","sources":["../../src/tools/users/retrieve-profile-users.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,OAAO,MAAM,YAAY;AAEhC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAwBlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAGvF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAHoC,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAKxF,wBAA2C"}

package/tools/users/retrieve-profile-users.js

@@ -0,0 +1,44 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.tool = exports.metadata = void 0;
+const filtering_1 = require("spotted-ts-mcp/filtering");
+const types_1 = require("spotted-ts-mcp/tools/types");
+exports.metadata = {
+    resource: 'users',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/users/{user_id}',
+    operationId: 'get-users-profile',
+};
+exports.tool = {
+    name: 'retrieve_profile_users',
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet public profile information about a Spotify user.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/user_retrieve_profile_response',\n  $defs: {\n    user_retrieve_profile_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids) for this user.\\n'\n        },\n        display_name: {\n          type: 'string',\n          description: 'The name displayed on the user\\'s profile. `null` if not available.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        followers: {\n          $ref: '#/$defs/followers_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint for this user.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'The user\\'s profile image.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'user'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for this user.\\n'\n        }\n      }\n    },\n    external_url_object: {\n      type: 'object',\n      properties: {\n        spotify: {\n          type: 'string',\n          description: 'The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.\\n'\n        }\n      }\n    },\n    followers_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'This will always be set to null, as the Web API does not support it at the moment.\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'The total number of followers.\\n'\n        }\n      }\n    },\n    image_object: {\n      type: 'object',\n      properties: {\n        height: {\n          type: 'integer',\n          description: 'The image height in pixels.\\n'\n        },\n        url: {\n          type: 'string',\n          description: 'The source URL of the image.\\n'\n        },\n        width: {\n          type: 'integer',\n          description: 'The image width in pixels.\\n'\n        }\n      },\n      required: [        'height',\n        'url',\n        'width'\n      ]\n    }\n  }\n}\n```",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: {
+                type: 'string',
+                title: 'User ID',
+                description: "The user's [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids).\n",
+            },
+            jq_filter: {
+                type: 'string',
+                title: 'jq Filter',
+                description: 'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+            },
+        },
+        required: ['user_id'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+const handler = async (client, args) => {
+    const { user_id, jq_filter, ...body } = args;
+    return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await client.users.retrieveProfile(user_id)));
+};
+exports.handler = handler;
+exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
+//# sourceMappingURL=retrieve-profile-users.js.map

package/tools/users/retrieve-profile-users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-profile-users.js","sourceRoot":"","sources":["../../src/tools/users/retrieve-profile-users.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,OAAO;IACjB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE,mBAAmB;CACjC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,0oFAA0oF;IAC5oF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,mFAAmF;aACjG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACpD,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/users/retrieve-profile-users.mjs

@@ -0,0 +1,40 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { maybeFilter } from 'spotted-ts-mcp/filtering';
+import { asTextContentResult } from 'spotted-ts-mcp/tools/types';
+export const metadata = {
+    resource: 'users',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/users/{user_id}',
+    operationId: 'get-users-profile',
+};
+export const tool = {
+    name: 'retrieve_profile_users',
+    description: "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet public profile information about a Spotify user.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/user_retrieve_profile_response',\n  $defs: {\n    user_retrieve_profile_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids) for this user.\\n'\n        },\n        display_name: {\n          type: 'string',\n          description: 'The name displayed on the user\\'s profile. `null` if not available.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        followers: {\n          $ref: '#/$defs/followers_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint for this user.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'The user\\'s profile image.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'user'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for this user.\\n'\n        }\n      }\n    },\n    external_url_object: {\n      type: 'object',\n      properties: {\n        spotify: {\n          type: 'string',\n          description: 'The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.\\n'\n        }\n      }\n    },\n    followers_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'This will always be set to null, as the Web API does not support it at the moment.\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'The total number of followers.\\n'\n        }\n      }\n    },\n    image_object: {\n      type: 'object',\n      properties: {\n        height: {\n          type: 'integer',\n          description: 'The image height in pixels.\\n'\n        },\n        url: {\n          type: 'string',\n          description: 'The source URL of the image.\\n'\n        },\n        width: {\n          type: 'integer',\n          description: 'The image width in pixels.\\n'\n        }\n      },\n      required: [        'height',\n        'url',\n        'width'\n      ]\n    }\n  }\n}\n```",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: {
+                type: 'string',
+                title: 'User ID',
+                description: "The user's [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids).\n",
+            },
+            jq_filter: {
+                type: 'string',
+                title: 'jq Filter',
+                description: 'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+            },
+        },
+        required: ['user_id'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+export const handler = async (client, args) => {
+    const { user_id, jq_filter, ...body } = args;
+    return asTextContentResult(await maybeFilter(jq_filter, await client.users.retrieveProfile(user_id)));
+};
+export default { metadata, tool, handler };
+//# sourceMappingURL=retrieve-profile-users.mjs.map

package/tools/users/retrieve-profile-users.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-profile-users.mjs","sourceRoot":"","sources":["../../src/tools/users/retrieve-profile-users.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,OAAO;IACjB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE,mBAAmB;CACjC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,0oFAA0oF;IAC5oF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,mFAAmF;aACjG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACpD,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools.d.mts

@@ -0,0 +1,2 @@
+export * from "./tools/index.mjs";
+//# sourceMappingURL=tools.d.mts.map

package/tools.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.mts","sourceRoot":"","sources":["src/tools.ts"],"names":[],"mappings":""}

package/tools.d.ts

@@ -0,0 +1,2 @@
+export * from "./tools/index.js";
+//# sourceMappingURL=tools.d.ts.map

package/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["src/tools.ts"],"names":[],"mappings":""}

package/tools.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./tools/index.js"), exports);
+//# sourceMappingURL=tools.js.map

package/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["src/tools.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAA8B"}

package/tools.mjs

@@ -0,0 +1,2 @@
+export * from "./tools/index.mjs";
+//# sourceMappingURL=tools.mjs.map

package/tools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.mjs","sourceRoot":"","sources":["src/tools.ts"],"names":[],"mappings":""}