@todoist/mcp 0.0.1 → 15.0.0

package/dist/mcp-helpers.d.ts

@@ -0,0 +1,62 @@
+import { TodoistApi } from '@doist/todoist-sdk';
+import { McpServer } from '@modelcontextprotocol/server';
+import { AnyTodoistTool } from './todoist-tool.js';
+/**
+ * Supported feature names that modify tool behavior.
+ *
+ * Currently supported:
+ * - `'strip_emails'`: Strips email addresses from collaborator tool outputs
+ *   (affects: find-project-collaborators, find-completed-tasks). Useful for
+ *   clients like ChatGPT that should not have access to user emails.
+ */
+declare const FEATURE_NAMES: {
+    /**
+     * Strips email addresses from tool outputs that expose user data.
+     * Affects: find-project-collaborators, find-completed-tasks
+     */
+    readonly STRIP_EMAILS: "strip_emails";
+};
+/**
+ * Valid feature name values.
+ * @see FEATURE_NAMES for available options with documentation.
+ */
+type FeatureName = (typeof FEATURE_NAMES)[keyof typeof FEATURE_NAMES];
+/**
+ * A feature that modifies tool behavior.
+ */
+type Feature = {
+    /**
+     * The feature name. Use {@link FEATURE_NAMES} for available options with intellisense.
+     */
+    name: FeatureName;
+};
+/**
+ * Array of features to enable when creating the MCP server.
+ */
+type Features = Feature[];
+/**
+ * Recursively strips email fields from an object structure.
+ * Used to remove sensitive email data from tool outputs for certain clients.
+ */
+declare function stripEmailsFromObject<T>(obj: T): T;
+/**
+ * Strips email patterns from text content.
+ * Replaces email addresses with [email hidden] placeholder.
+ */
+declare function stripEmailsFromText(text: string): string;
+/**
+ * Register Todoist tools in an MCP server.
+ *
+ * Schema caching, annotations, MCP Apps `_meta`, result shaping and turning a thrown error into
+ * an error result come from `@todoist/mcp-core`. What is Todoist's own is wired in here: the API
+ * client, retries, usage tracking, `strip_emails`, and the API error formatting. One registrar
+ * serves every tool, since none of that depends on the tool.
+ */
+declare function registerTools({ tools, server, client, features, }: {
+    tools: readonly AnyTodoistTool[];
+    server: McpServer;
+    client: TodoistApi;
+    features?: Features;
+}): void;
+export { FEATURE_NAMES, type Feature, type FeatureName, type Features, registerTools, stripEmailsFromObject, stripEmailsFromText, };
+//# sourceMappingURL=mcp-helpers.d.ts.map

package/dist/mcp-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-helpers.d.ts","sourceRoot":"","sources":["../src/mcp-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAMvD;;;;;;;GAOG;AACH,QAAA,MAAM,aAAa;IACf;;;OAGG;;CAEG,CAAA;AAEV;;;GAGG;AACH,KAAK,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAA;AAErE;;GAEG;AACH,KAAK,OAAO,GAAG;IACX;;OAEG;IACH,IAAI,EAAE,WAAW,CAAA;CACpB,CAAA;AAED;;GAEG;AACH,KAAK,QAAQ,GAAG,OAAO,EAAE,CAAA;AA4CzB;;;GAGG;AACH,iBAAS,qBAAqB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAsB3C;AAED;;;GAGG;AACH,iBAAS,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQjD;AAMD;;;;;;;GAOG;AACH,iBAAS,aAAa,CAAC,EACnB,KAAK,EACL,MAAM,EACN,MAAM,EACN,QAAa,GAChB,EAAE;IACC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;IAChC,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACtB,QA8BA;AAED,OAAO,EACH,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,aAAa,EACb,qBAAqB,EACrB,mBAAmB,GACtB,CAAA"}