@studiometa/productive-mcp 0.10.2 → 0.10.3

package/dist/schema.d.ts

@@ -27,7 +27,9 @@ export declare const ResourceSchema: z.ZodEnum<{
     attachments: "attachments";
     discussions: "discussions";
     pages: "pages";
+    activities: "activities";
     batch: "batch";
+    workflows: "workflows";
     reports: "reports";
     summaries: "summaries";
     search: "search";
@@ -49,6 +51,9 @@ export declare const ActionSchema: z.ZodEnum<{
     reopen: "reopen";
     run: "run";
     me: "me";
+    complete_task: "complete_task";
+    log_day: "log_day";
+    weekly_standup: "weekly_standup";
     help: "help";
     schema: "schema";
     my_day: "my_day";
@@ -171,7 +176,9 @@ export declare const ProductiveToolInputSchema: z.ZodObject<{
         attachments: "attachments";
         discussions: "discussions";
         pages: "pages";
+        activities: "activities";
         batch: "batch";
+        workflows: "workflows";
         reports: "reports";
         summaries: "summaries";
         search: "search";
@@ -189,6 +196,9 @@ export declare const ProductiveToolInputSchema: z.ZodObject<{
         reopen: "reopen";
         run: "run";
         me: "me";
+        complete_task: "complete_task";
+        log_day: "log_day";
+        weekly_standup: "weekly_standup";
         help: "help";
         schema: "schema";
         my_day: "my_day";

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,CAAC,EAAoB,KAAK,kBAAkB,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAGlF,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAMhF;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAAoB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;EAAkB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAAuB,CAAC;AAMrD;;GAEG;AACH,eAAO,MAAM,OAAO,aAIgC,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,aAKvB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,aAKxB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,aAGqD,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,WAAW,aAG+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,cAAc,aAGuD,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,WAAW,aAG+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,SAAS,aAIuC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAKiE,CAAC;AAE/F;;GAEG;AACH,eAAO,MAAM,SAAS,2BAKiC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,YAAY,2BAMsC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,YAAY,6BAKtB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,UAAU,aAMpB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,wCAKxB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,YAAY,6BAKtB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,YAAY,yBAItB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,SAAS,aAAkD,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,UAAU,aAIqB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,SAAS,aAGgB,CAAC;AAMvC;;GAEG;AACH,eAAO,MAAM,YAAY,uDAGsB,CAAC;AAMhD;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqFpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAErE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAAC,mBAAmB,CAAC,CAE7F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAOnF"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,CAAC,EAAoB,KAAK,kBAAkB,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAGlF,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAMhF;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;EAAoB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAAkB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAAuB,CAAC;AAMrD;;GAEG;AACH,eAAO,MAAM,OAAO,aAIgC,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,aAKvB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,aAKxB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,aAGqD,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,WAAW,aAG+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,cAAc,aAGuD,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,WAAW,aAG+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,SAAS,aAIuC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAKiE,CAAC;AAE/F;;GAEG;AACH,eAAO,MAAM,SAAS,2BAKiC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,YAAY,2BAMsC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,YAAY,6BAKtB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,UAAU,aAMpB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,cAAc,wCAKxB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,YAAY,6BAKtB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,YAAY,yBAItB,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,SAAS,aAAkD,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,UAAU,aAIqB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,SAAS,aAGgB,CAAC;AAMvC;;GAEG;AACH,eAAO,MAAM,YAAY,uDAGsB,CAAC;AAMhD;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqFpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAErE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAAC,mBAAmB,CAAC,CAE7F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAOnF"}

package/dist/server.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { t as VERSION } from "./version-Bl0krPVf.js";
-import "./handlers-B8GRTaDu.js";
+import { t as VERSION } from "./version-BRTaTnUG.js";
+import "./handlers-CaOBYauF.js";
 import { createHttpApp } from "./http.js";
 import { toNodeListener } from "h3";
 import { createServer } from "node:http";

package/dist/stdio.js

@@ -1,4 +1,4 @@
-import { t as executeToolWithCredentials } from "./handlers-B8GRTaDu.js";
+import { t as executeToolWithCredentials } from "./handlers-CaOBYauF.js";
 import "./handlers.js";
 import { STDIO_ONLY_TOOLS, TOOLS } from "./tools.js";
 import { getConfig, setConfig } from "@studiometa/productive-api";

package/dist/suggestions.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Proactive suggestion generators for MCP responses.
+ *
+ * Data-aware warnings and recommendations computed from response data.
+ * Different from `_hints` (which show related resources/actions):
+ * - `_hints` tell the agent *what to fetch next*
+ * - `_suggestions` tell the agent *what to pay attention to*
+ *
+ * Key design constraints:
+ * - No extra API calls — compute only from data already in the response.
+ * - Return `string[]` (human-readable messages).
+ * - Emoji prefixes: ⚠️ warnings, ℹ️ info, 📊 stats, ⏱️ timers.
+ */
+import type { JsonApiResource } from '@studiometa/productive-api';
+import type { MyDaySummaryResult } from '@studiometa/productive-core';
+/**
+ * Get suggestions for tasks.list response.
+ *
+ * - Warns about overdue tasks (due_date < today and not closed)
+ * - Informs about unassigned tasks
+ */
+export declare function getTaskListSuggestions(tasks: JsonApiResource[]): string[];
+/**
+ * Get suggestions for tasks.get response.
+ *
+ * - Warns if the single task is overdue (and by how many days)
+ * - Informs if no time has been logged (only when time_entries are included)
+ */
+export declare function getTaskGetSuggestions(task: JsonApiResource, included?: JsonApiResource[]): string[];
+/**
+ * Get suggestions for time.list response.
+ *
+ * - Shows total hours logged across all entries in the response.
+ * - If filtered by today, shows hours vs 8h target.
+ */
+export declare function getTimeListSuggestions(entries: JsonApiResource[], filter?: Record<string, string>): string[];
+/**
+ * Get suggestions for summaries.my_day response.
+ *
+ * - Warns if no time has been logged today.
+ * - Warns if a timer has been running for more than 2 hours.
+ */
+export declare function getMyDaySuggestions(data: MyDaySummaryResult): string[];
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAStE;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAqCzE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,EACrB,QAAQ,CAAC,EAAE,eAAe,EAAE,GAC3B,MAAM,EAAE,CAkCV;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EAAE,EAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,EAAE,CAwBV;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAoBtE"}

package/dist/{version-Bl0krPVf.js → version-BRTaTnUG.js}

@@ -23,7 +23,7 @@ function loadInstructions() {
 	}
 }
 const INSTRUCTIONS = loadInstructions();
-const VERSION = "0.10.2";
+const VERSION = "0.10.3";
 export { INSTRUCTIONS as n, VERSION as t };
 
-//# sourceMappingURL=version-Bl0krPVf.js.map
+//# sourceMappingURL=version-BRTaTnUG.js.map

package/dist/{version-Bl0krPVf.js.map → version-BRTaTnUG.js.map}

@@ -1 +1 @@
-{"version":3,"file":"version-Bl0krPVf.js","names":[],"sources":["../src/instructions.ts","../src/version.ts"],"sourcesContent":["/**\n * MCP Server Instructions\n *\n * These instructions are sent to Claude Desktop during initialization\n * and used as context/hints for the LLM. This ensures the AI agent\n * knows how to properly use the Productive.io MCP server.\n *\n * The content is derived from skills/SKILL.md (without YAML frontmatter).\n */\n\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/**\n * Load instructions from SKILL.md file\n * Removes YAML frontmatter (content between --- markers)\n */\nfunction loadInstructions(): string {\n  try {\n    // In dist/, go up to package root, then to skills/\n    const skillPath = join(__dirname, '..', 'skills', 'SKILL.md');\n    const content = readFileSync(skillPath, 'utf-8');\n\n    // Remove YAML frontmatter (between --- markers at start of file)\n    const withoutFrontmatter = content.replace(/^---\\n[\\s\\S]*?\\n---\\n+/, '');\n\n    return withoutFrontmatter.trim();\n  } catch {\n    // Fallback if file not found (shouldn't happen in production)\n    return 'Productive.io MCP Server - Use the productive tool with resource and action parameters.';\n  }\n}\n\nexport const INSTRUCTIONS = loadInstructions();\n","/**\n * Package version - injected from package.json at build time\n */\ndeclare const __VERSION__: string;\nexport const VERSION = __VERSION__;\n"],"mappings":";;;;;;;;;;;;AAcA,IAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;;;;;AAMzD,SAAS,mBAA2B;AAClC,KAAI;AAQF,SALgB,aADE,KAAK,WAAW,MAAM,UAAU,WAAW,EACrB,QAAQ,CAGb,QAAQ,0BAA0B,GAAG,CAE9C,MAAM;SAC1B;AAEN,SAAO;;;AAIX,MAAa,eAAe,kBAAkB;AChC9C,MAAa,UAAA"}
+{"version":3,"file":"version-BRTaTnUG.js","names":[],"sources":["../src/instructions.ts","../src/version.ts"],"sourcesContent":["/**\n * MCP Server Instructions\n *\n * These instructions are sent to Claude Desktop during initialization\n * and used as context/hints for the LLM. This ensures the AI agent\n * knows how to properly use the Productive.io MCP server.\n *\n * The content is derived from skills/SKILL.md (without YAML frontmatter).\n */\n\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/**\n * Load instructions from SKILL.md file\n * Removes YAML frontmatter (content between --- markers)\n */\nfunction loadInstructions(): string {\n  try {\n    // In dist/, go up to package root, then to skills/\n    const skillPath = join(__dirname, '..', 'skills', 'SKILL.md');\n    const content = readFileSync(skillPath, 'utf-8');\n\n    // Remove YAML frontmatter (between --- markers at start of file)\n    const withoutFrontmatter = content.replace(/^---\\n[\\s\\S]*?\\n---\\n+/, '');\n\n    return withoutFrontmatter.trim();\n  } catch {\n    // Fallback if file not found (shouldn't happen in production)\n    return 'Productive.io MCP Server - Use the productive tool with resource and action parameters.';\n  }\n}\n\nexport const INSTRUCTIONS = loadInstructions();\n","/**\n * Package version - injected from package.json at build time\n */\ndeclare const __VERSION__: string;\nexport const VERSION = __VERSION__;\n"],"mappings":";;;;;;;;;;;;AAcA,IAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;;;;;AAMzD,SAAS,mBAA2B;AAClC,KAAI;AAQF,SALgB,aADE,KAAK,WAAW,MAAM,UAAU,WAAW,EACrB,QAAQ,CAGb,QAAQ,0BAA0B,GAAG,CAE9C,MAAM;SAC1B;AAEN,SAAO;;;AAIX,MAAa,eAAe,kBAAkB;AChC9C,MAAa,UAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studiometa/productive-mcp",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "MCP server for Productive.io API - Model Context Protocol integration for Claude Desktop",
   "keywords": [
     "ai",
@@ -87,8 +87,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@studiometa/productive-api": "0.10.2",
-    "@studiometa/productive-core": "0.10.2",
+    "@studiometa/productive-api": "0.10.3",
+    "@studiometa/productive-core": "0.10.3",
     "h3": "^1.15.1",
     "zod": "4.3.6"
   },

package/skills/SKILL.md

@@ -36,7 +36,9 @@ productive(resource, action, [parameters...])
 | `bookings`    | `list`, `get`, `create`, `update`, `help`                                | Resource scheduling                                      |
 | `pages`       | `list`, `get`, `create`, `update`, `delete`, `help`                      | Wiki/docs pages                                          |
 | `discussions` | `list`, `get`, `create`, `update`, `delete`, `resolve`, `reopen`, `help` | Discussions on pages                                     |
+| `activities`  | `list`, `help`                                                           | Activity feed (audit log of create/update/delete events) |
 | `reports`     | `get`, `help`                                                            | Generate reports                                         |
+| `workflows`   | `complete_task`, `log_day`, `weekly_standup`, `help`                     | Compound workflows chaining multiple operations          |
 
 ### Getting Help
 
@@ -252,6 +254,13 @@ Response:
 ### Services
 
 ```json
+// List services for a deal (budget line items) — prefer this over project_id when you have a deal
+{
+  "resource": "services",
+  "action": "list",
+  "filter": { "deal_id": "12345" }
+}
+
 // List services for a project
 {
   "resource": "services",
@@ -372,6 +381,78 @@ Response:
 { "resource": "discussions", "action": "reopen", "id": "67890" }
 ```
 
+### Workflows
+
+Compound workflows that chain multiple operations into a single tool call.
+
+```json
+// Complete a task (marks closed, posts comment, stops timers)
+{
+  "resource": "workflows",
+  "action": "complete_task",
+  "task_id": "12345",
+  "comment": "All done! Tests passing.",
+  "stop_timer": true
+}
+
+// Complete a task without stopping timers
+{
+  "resource": "workflows",
+  "action": "complete_task",
+  "task_id": "12345",
+  "stop_timer": false
+}
+
+// Log a full day across multiple services (time in minutes)
+{
+  "resource": "workflows",
+  "action": "log_day",
+  "date": "2024-01-16",
+  "entries": [
+    { "project_id": "100", "service_id": "111", "duration_minutes": 240, "note": "Frontend development" },
+    { "project_id": "100", "service_id": "222", "duration_minutes": 120, "note": "Code review" },
+    { "project_id": "200", "service_id": "333", "duration_minutes": 60, "note": "Client meeting" }
+  ]
+}
+
+// Get weekly standup (this week)
+{ "resource": "workflows", "action": "weekly_standup" }
+
+// Get standup for a specific week (provide the Monday date)
+{
+  "resource": "workflows",
+  "action": "weekly_standup",
+  "week_start": "2024-01-15"
+}
+
+// Get standup for a specific person
+{
+  "resource": "workflows",
+  "action": "weekly_standup",
+  "person_id": "12345"
+}
+```
+
+#### complete_task returns
+
+- `task` — Updated task info (id, title, closed status)
+- `comment_posted` — Whether the comment was successfully posted
+- `comment_id` — ID of the created comment (if posted)
+- `timers_stopped` — Number of timers that were stopped
+- `errors` — Array of sub-step errors (partial results still returned)
+
+#### log_day returns
+
+- `entries` — Per-entry results with `success`, `time_entry` (on success), or `error` (on failure)
+- `succeeded` / `failed` — Counts of successful and failed entries
+- `total_minutes_logged` — Sum of minutes for successful entries
+
+#### weekly_standup returns
+
+- `completed_tasks` — Tasks closed this week with project names
+- `time_logged` — Total minutes and breakdown by project (sorted by most time first)
+- `upcoming_deadlines` — Open tasks due in the next 7 days with `days_until_due`
+
 ## Filters Reference
 
 ### Time Entries
@@ -510,6 +591,28 @@ Force full details on list:
 
 When fetching a single resource with `action: "get"`, the response includes a `_hints` field with suggestions for related resources and common actions. This helps discover how to fetch additional context.
 
+## Proactive Suggestions
+
+Certain responses include a `_suggestions` field with data-aware warnings and recommendations. Unlike `_hints` (which point to related resources), `_suggestions` draw attention to things that need action based on the data returned.
+
+| Resource    | Action   | Suggestions generated                                |
+| ----------- | -------- | ---------------------------------------------------- |
+| `tasks`     | `list`   | ⚠️ overdue tasks count, ℹ️ unassigned tasks count    |
+| `tasks`     | `get`    | ⚠️ task is N days overdue, ℹ️ no time entries        |
+| `time`      | `list`   | 📊 total hours logged (or X/8h if filtered by today) |
+| `summaries` | `my_day` | ⚠️ no time logged today, ⏱️ timer running too long   |
+
+Example:
+
+```json
+{
+  "data": [{ "id": "1", "title": "Fix bug", "due_date": "2024-01-01" }],
+  "_suggestions": ["⚠️ 1 task(s) are overdue", "ℹ️ 1 task(s) have no assignee"]
+}
+```
+
+Suggestions are suppressed when `no_hints: true` is set.
+
 Example response for a task:
 
 ```json
@@ -688,3 +791,4 @@ Key points:
 4. **Use `query`** for text search - behavior varies by resource but may include related fields (e.g., tasks query may match project names)
 5. **Check `people.me`** first to get the current user's ID for filters
 6. **Follow `_hints`** - When getting a resource, check the `_hints` field for suggestions on fetching related context
+7. **Act on `_suggestions`** - When present, `_suggestions` highlight data issues (overdue tasks, no time logged, etc.) that may need attention or should be surfaced to the user