@doist/todoist-ai 8.12.3 → 9.0.0

package/README.md

@@ -1,219 +1,24 @@
-# Todoist AI and MCP SDK
+# @doist/todoist-ai
 
-Library for connecting AI agents to Todoist. Includes tools that can be integrated into LLMs,
-enabling them to access and modify a Todoist account on the user's behalf.
+> **This package has been renamed to [`@doist/todoist-mcp`](https://npmjs.com/package/@doist/todoist-mcp).**
 
-These tools can be used both through an MCP server, or imported directly in other projects to
-integrate them to your own AI conversational interfaces.
-
-## Using tools
-
-### 1. Add this repository as a dependency
-
-```sh
-npm install @doist/todoist-ai
-```
-
-### 2. Import the tools and plug them to an AI
-
-Here's an example using [Vercel's AI SDK](https://ai-sdk.dev/docs/ai-sdk-core/generating-text#streamtext).
-
-```js
-import { findTasksByDate, addTasks } from '@doist/todoist-ai'
-import { TodoistApi } from '@doist/todoist-sdk'
-import { streamText } from 'ai'
-
-// Create Todoist API client
-const client = new TodoistApi(process.env.TODOIST_API_KEY)
-
-// Helper to wrap tools with the client
-function wrapTool(tool, todoistClient) {
-    return {
-        ...tool,
-        execute(args) {
-            return tool.execute(args, todoistClient)
-        },
-    }
-}
-
-const result = streamText({
-    model: yourModel,
-    system: 'You are a helpful Todoist assistant',
-    tools: {
-        findTasksByDate: wrapTool(findTasksByDate, client),
-        addTasks: wrapTool(addTasks, client),
-    },
-})
-```
-
-## Using as an MCP server
-
-### Quick Start
-
-You can run the MCP server directly with npx:
-
-```bash
-npx @doist/todoist-ai
-```
-
-### Setup Guide
-
-The Todoist AI MCP server is available as a streamable HTTP service for easy integration with various AI clients:
-
-**Primary URL (Streamable HTTP):** `https://ai.todoist.net/mcp`
-
-#### Claude Desktop
-
-1. Open Settings → Connectors → Add custom connector
-2. Enter `https://ai.todoist.net/mcp` and complete OAuth authentication
-
-#### Cursor
-
-Create a configuration file:
-
-- **Global:** `~/.cursor/mcp.json`
-- **Project-specific:** `.cursor/mcp.json`
-
-```json
-{
-    "mcpServers": {
-        "todoist": {
-            "command": "npx",
-            "args": ["-y", "mcp-remote", "https://ai.todoist.net/mcp"]
-        }
-    }
-}
-```
-
-Then enable the server in Cursor settings if prompted.
-
-#### Claude Code (CLI)
-
-The fastest setup is the official Todoist plugin, which wires up the MCP server for you:
-
-```bash
-/plugin marketplace add doist/todoist-ai
-/plugin install todoist@doist
-```
-
-OAuth runs in your browser the first time you use a Todoist tool. See [Anthropic's plugin docs](https://code.claude.com/docs/en/plugins-reference) for more.
-
-If you'd rather configure the MCP server manually, run:
+Please update your dependency:
 
 ```bash
-claude mcp add --transport http todoist https://ai.todoist.net/mcp
+npm install @doist/todoist-mcp
 ```
 
-Then launch `claude`, execute `/mcp`, and select the `todoist` MCP server to authenticate.
+And update your imports:
 
-#### Visual Studio Code
-
-1. Open Command Palette → MCP: Add Server
-2. Select HTTP transport and use:
-
-```json
-{
-    "servers": {
-        "todoist": {
-            "type": "http",
-            "url": "https://ai.todoist.net/mcp"
-        }
-    }
-}
+```ts
+import { getMcpServer } from '@doist/todoist-mcp'
 ```
 
-#### Other MCP Clients
+The CLI entrypoints have been renamed too:
 
 ```bash
-npx -y mcp-remote https://ai.todoist.net/mcp
+npx @doist/todoist-mcp           # was: npx @doist/todoist-ai
+npx -p @doist/todoist-mcp todoist-mcp-http
 ```
 
-For more details on setting up and using the MCP server, including creating custom servers, see [docs/mcp-server.md](docs/mcp-server.md).
-
-## Features
-
-A key feature of this project is that tools can be reused, and are not written specifically for use in an MCP server. They can be hooked up as tools to other conversational AI interfaces (e.g. Vercel's AI SDK).
-
-This project is in its early stages. Expect more and/or better tools soon.
-
-Nevertheless, our goal is to provide a small set of tools that enable complete workflows, rather than just atomic actions, striking a balance between flexibility and efficiency for LLMs.
-
-For our design philosophy, guidelines, and development patterns, see [docs/tool-design.md](docs/tool-design.md).
-
-### Available Tools
-
-For a complete list of available tools, see the [src/tools](src/tools) directory.
-
-#### OpenAI MCP Compatibility
-
-This server includes `search` and `fetch` tools that follow the [OpenAI MCP specification](https://platform.openai.com/docs/mcp), enabling seamless integration with OpenAI's MCP protocol. These tools return JSON-encoded results optimized for OpenAI's requirements while maintaining compatibility with the broader MCP ecosystem.
-
-## Dependencies
-
-- MCP server using the official [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk?tab=readme-ov-file#installation)
-- Todoist Typescript API client [@doist/todoist-sdk](https://github.com/Doist/todoist-sdk)
-
-## MCP Server Setup
-
-See [docs/mcp-server.md](docs/mcp-server.md) for full instructions on setting up the MCP server.
-
-## Local Development Setup
-
-See [docs/dev-setup.md](docs/dev-setup.md) for full setup instructions and [CONTRIBUTING.md](CONTRIBUTING.md) for contributor workflows and quality checks.
-
-### MCP Apps
-
-This project includes support for **MCP Apps** – interactive UI widgets rendered inline in AI chat interfaces. Widgets provide rich visual representations of tool outputs (e.g., task lists) instead of plain text.
-
-See [docs/mcp-apps.md](docs/mcp-apps.md) for the widget architecture, build pipeline, and development workflow.
-
-### Quick Start
-
-After cloning and setting up the repository:
-
-- `npm start` - Build and run the MCP inspector for testing
-- `npm run dev` - Development mode with auto-rebuild and restart
-- `npm run tool:list` - List available tools for direct execution
-- `npm run tool -- <tool-name> '<json-args>'` - Run a tool directly without MCP
-
-When using `npm run tool`, include `--` before tool arguments so npm forwards them to `scripts/run-tool.ts`.
-
-Example check before write operations:
-`npm run tool -- user-info '{}'`
-This confirms which Todoist account the current `TODOIST_API_KEY` is connected to.
-
-`run-tool` uses `TODOIST_API_KEY` from your `.env` file (created from `.env.example` by `npm run setup`). Use a test account or a temporary project when running write operations to avoid modifying real data.
-
-## Contributing
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for:
-
-- Development workflow
-- Running tools directly with `scripts/run-tool.ts`
-- Testing and quality checks
-- Commit conventions
-
-## Releasing
-
-This project uses [release-please](https://github.com/googleapis/release-please) to automate version management and package publishing.
-
-### How it works
-
-1. Make your changes using [Conventional Commits](https://www.conventionalcommits.org/):
-    - `feat:` for new features (minor version bump)
-    - `fix:` for bug fixes (patch version bump)
-    - `feat!:` or `fix!:` for breaking changes (major version bump)
-    - `docs:` for documentation changes
-    - `chore:` for maintenance tasks
-    - `ci:` for CI changes
-
-2. When commits are pushed to `main`:
-    - Release-please automatically creates/updates a release PR
-    - The PR includes version bump and changelog updates
-    - Review the PR and merge when ready
-
-3. After merging the release PR:
-    - A new GitHub release is automatically created
-    - A new tag is created
-    - The `publish` workflow is triggered
-    - The package is published to npm
+This package continues to work as a thin shim that re-exports `@doist/todoist-mcp` and forwards the legacy CLI bins (`todoist-ai`, `todoist-ai-http`) to the new package, but it will not receive new features.

package/bin/_launcher.js

@@ -0,0 +1,16 @@
+import { createRequire } from 'node:module'
+import { dirname, resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+const require = createRequire(import.meta.url)
+
+export async function runBin(binName) {
+    const pkgJsonPath = require.resolve('@doist/todoist-mcp/package.json')
+    const pkg = require(pkgJsonPath)
+    const binEntry = pkg.bin?.[binName]
+    if (!binEntry) {
+        throw new Error(`@doist/todoist-mcp does not declare a "${binName}" bin`)
+    }
+    const entryPath = resolve(dirname(pkgJsonPath), binEntry)
+    await import(pathToFileURL(entryPath).href)
+}

package/bin/todoist-ai-http.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runBin } from './_launcher.js'
+
+await runBin('todoist-mcp-http')

package/bin/todoist-ai.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runBin } from './_launcher.js'
+
+await runBin('todoist-mcp')

package/index.d.ts

@@ -0,0 +1 @@
+export * from '@doist/todoist-mcp'

package/index.mjs

@@ -0,0 +1 @@
+export * from '@doist/todoist-mcp'

package/package.json

@@ -1,123 +1,35 @@
 {
     "name": "@doist/todoist-ai",
-    "version": "8.12.3",
+    "version": "9.0.0",
+    "description": "DEPRECATED: renamed to @doist/todoist-mcp. Install @doist/todoist-mcp instead.",
     "type": "module",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "mcpName": "net.todoist/mcp",
+    "main": "./index.mjs",
+    "types": "./index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./index.d.ts",
+            "import": "./index.mjs"
+        }
+    },
     "bin": {
-        "todoist-ai": "dist/main.js",
-        "todoist-ai-http": "dist/main-http.js"
+        "todoist-ai": "./bin/todoist-ai.js",
+        "todoist-ai-http": "./bin/todoist-ai-http.js"
     },
     "files": [
-        "dist",
-        "!dist/dev",
-        "scripts",
-        "package.json",
-        "LICENSE",
+        "index.mjs",
+        "index.d.ts",
+        "bin",
         "README.md"
     ],
     "license": "MIT",
-    "description": "A collection of tools for Todoist using AI",
+    "dependencies": {
+        "@doist/todoist-mcp": "^9.0.0"
+    },
     "repository": {
         "type": "git",
-        "url": "https://github.com/Doist/todoist-ai"
+        "url": "https://github.com/Doist/todoist-mcp"
     },
-    "keywords": [
-        "todoist",
-        "ai",
-        "tools"
-    ],
     "publishConfig": {
-        "access": "public",
-        "provenance": true
-    },
-    "scripts": {
-        "test": "vitest run",
-        "test:watch": "vitest",
-        "test:coverage": "vitest run --coverage",
-        "build": "npm run build:lib && npm run build:apps",
-        "build:lib": "vite build",
-        "build:apps": "vite build --config src/mcp-apps/vite.config.ts",
-        "postbuild": "chmod +x dist/main.js && chmod +x dist/main-http.js",
-        "start": "npm run build && npx @modelcontextprotocol/inspector node dist/main.js",
-        "dev": "concurrently \"npm run build:lib -- --watch\" \"npm run build:apps -- --watch\" \"npx @modelcontextprotocol/inspector npx nodemon --quiet --watch dist --ext js,html --exec node dist/main.js\"",
-        "dev:http": "concurrently \"npm run build:lib -- --watch\" \"npm run build:apps -- --watch\" \"npx nodemon --quiet --watch dist --ext js,html --exec node dist/main-http.js\"",
-        "start:http": "npm run build && node dist/main-http.js",
-        "dev:apps": "vite build --watch --config src/mcp-apps/vite.config.ts",
-        "dev:widget": "npm run dev:apps",
-        "setup": "cp .env.example .env && npm install && npm run build",
-        "tool": "tsx scripts/run-tool.ts",
-        "tool:list": "tsx scripts/run-tool.ts --list",
-        "test:executable": "npm run build && node scripts/test-executable.cjs",
-        "type-check": "npx tsc --noEmit",
-        "format:check": "oxlint src scripts && oxfmt --check",
-        "format:fix": "oxlint src scripts --fix && oxfmt",
-        "lint:schemas": "npm run build && npx tsx scripts/validate-schemas.ts",
-        "check": "oxlint src scripts && oxfmt --check && npm run lint:schemas",
-        "prepublishOnly": "npm run build && npm test",
-        "prepare": "husky"
-    },
-    "dependencies": {
-        "@doist/todoist-sdk": "10.1.5",
-        "@modelcontextprotocol/ext-apps": "1.2.2",
-        "date-fns": "4.1.0",
-        "dompurify": "3.3.3",
-        "dotenv": "17.3.1",
-        "express": "5.2.1",
-        "zod": "4.3.6"
-    },
-    "peerDependencies": {
-        "@modelcontextprotocol/sdk": "^1.25.0"
-    },
-    "devDependencies": {
-        "@modelcontextprotocol/inspector": "0.21.2",
-        "@semantic-release/changelog": "6.0.3",
-        "@semantic-release/exec": "7.1.0",
-        "@semantic-release/git": "10.0.1",
-        "@types/dompurify": "3.2.0",
-        "@types/express": "5.0.6",
-        "@types/morgan": "1.9.10",
-        "@types/node": "22.19.17",
-        "@types/react": "19.2.14",
-        "@types/react-dom": "19.2.3",
-        "@vitejs/plugin-react": "5.2.0",
-        "concurrently": "9.2.1",
-        "conventional-changelog-conventionalcommits": "9.3.1",
-        "husky": "9.1.7",
-        "lint-staged": "16.4.0",
-        "morgan": "1.10.1",
-        "nodemon": "3.1.14",
-        "oxfmt": "0.48.0",
-        "oxlint": "1.58.0",
-        "react": "19.2.5",
-        "react-dom": "19.2.5",
-        "rimraf": "6.1.3",
-        "semantic-release": "25.0.3",
-        "snarkdown": "2.0.0",
-        "tsx": "4.21.0",
-        "typescript": "6.0.3",
-        "vite": "7.3.2",
-        "vite-plugin-dts": "4.5.4",
-        "vite-plugin-singlefile": "2.3.3",
-        "vitest": "4.1.5"
-    },
-    "lint-staged": {
-        "*.{ts,tsx,js,jsx}": [
-            "oxlint --fix",
-            "oxfmt --no-error-on-unmatched-pattern"
-        ],
-        "*.{md,yml,yaml,css,json}": [
-            "oxfmt --no-error-on-unmatched-pattern"
-        ],
-        "src/tools/*.ts": [
-            "npm run lint:schemas"
-        ],
-        "src/index.ts": [
-            "npm run lint:schemas"
-        ],
-        "scripts/validate-schemas.ts": [
-            "npm run lint:schemas"
-        ]
+        "access": "public"
     }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Doist
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/filter-helpers.d.ts

@@ -1,51 +0,0 @@
-import { TodoistApi } from '@doist/todoist-sdk';
-export declare const RESPONSIBLE_USER_FILTERING: readonly ["assigned", "unassignedOrMe", "all"];
-export type ResponsibleUserFiltering = (typeof RESPONSIBLE_USER_FILTERING)[number];
-/**
- * Resolves a responsible user name/email to user ID and email.
- * @param client - Todoist API client
- * @param responsibleUser - User identifier (can be user ID, name, or email)
- * @returns Object with userId and email, or undefined if not provided
- * @throws Error if user cannot be found
- */
-export declare function resolveResponsibleUser(client: TodoistApi, responsibleUser: string | undefined): Promise<{
-    userId: string;
-    email: string;
-} | undefined>;
-/**
- * Appends a filter component to a query string with proper ' & ' separator.
- * @param query - The existing query string
- * @param filterComponent - The filter component to append
- * @returns The updated query string
- */
-export declare function appendToQuery(query: string, filterComponent: string): string;
-/**
- * Builds a query filter string for responsible user filtering that can be appended to a Todoist filter query.
- * @param resolvedAssigneeId - The resolved assignee ID (if provided)
- * @param assigneeEmail - The assignee email (if provided)
- * @param responsibleUserFiltering - The filtering mode ('assigned', 'unassignedOrMe', 'all')
- * @returns Query filter string (e.g., "assigned to: email@example.com" or "!assigned to: others")
- */
-export declare function buildResponsibleUserQueryFilter({ resolvedAssigneeId, assigneeEmail, responsibleUserFiltering, }: {
-    resolvedAssigneeId: string | undefined;
-    assigneeEmail: string | undefined;
-    responsibleUserFiltering?: ResponsibleUserFiltering;
-}): string;
-/**
- * Filters tasks based on responsible user logic:
- * - If resolvedAssigneeId is provided: returns only tasks assigned to that user
- * - If no resolvedAssigneeId: returns only unassigned tasks or tasks assigned to current user
- * @param tasks - Array of tasks to filter (must have responsibleUid property)
- * @param resolvedAssigneeId - The resolved assignee ID to filter by (optional)
- * @param currentUserId - The current authenticated user's ID
- * @returns Filtered array of tasks
- */
-export declare function filterTasksByResponsibleUser<T extends {
-    responsibleUid?: string;
-}>({ tasks, resolvedAssigneeId, currentUserId, responsibleUserFiltering, }: {
-    tasks: T[];
-    resolvedAssigneeId: string | undefined;
-    currentUserId: string;
-    responsibleUserFiltering?: ResponsibleUserFiltering;
-}): T[];
-//# sourceMappingURL=filter-helpers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"filter-helpers.d.ts","sourceRoot":"","sources":["../src/filter-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAGpD,eAAO,MAAM,0BAA0B,gDAAiD,CAAA;AACxF,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAA;AAElF;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CACxC,MAAM,EAAE,UAAU,EAClB,eAAe,EAAE,MAAM,GAAG,SAAS,GACpC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAaxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAQ5E;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,EAC5C,kBAAkB,EAClB,aAAa,EACb,wBAA2C,GAC9C,EAAE;IACC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;CACtD,GAAG,MAAM,CAmBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAChF,KAAK,EACL,kBAAkB,EAClB,aAAa,EACb,wBAA2C,GAC9C,EAAE;IACC,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,aAAa,EAAE,MAAM,CAAA;IACrB,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;CACtD,GAAG,CAAC,EAAE,CAWN"}