@studiometa/productive-mcp 0.10.0 → 0.10.2

package/dist/handlers/batch.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Batch handler - execute multiple operations in a single call
+ *
+ * Enables AI agents to reduce round-trips by batching multiple
+ * Productive.io operations into one MCP tool call.
+ */
+import type { ProductiveCredentials } from '../auth.js';
+import type { ToolResult } from './types.js';
+/** Maximum number of operations allowed in a single batch */
+export declare const MAX_BATCH_SIZE = 10;
+/**
+ * A single operation within a batch request
+ */
+export interface BatchOperation {
+    resource: string;
+    action: string;
+    [key: string]: unknown;
+}
+/**
+ * Result of a single batch operation
+ */
+export interface BatchOperationResult {
+    resource: string;
+    action: string;
+    index: number;
+    data?: unknown;
+    error?: string;
+}
+/**
+ * Summary of batch execution
+ */
+export interface BatchSummary {
+    total: number;
+    succeeded: number;
+    failed: number;
+}
+/**
+ * Full batch response
+ */
+export interface BatchResponse {
+    _batch: BatchSummary;
+    results: BatchOperationResult[];
+}
+/**
+ * Function signature for executing a single tool operation
+ * Injected for testability - in production this is executeToolWithCredentials
+ */
+export type ExecuteFunction = (name: string, args: Record<string, unknown>, credentials: ProductiveCredentials) => Promise<ToolResult>;
+/**
+ * Handle batch operation - execute multiple operations in parallel
+ *
+ * @param operations - Array of operations to execute
+ * @param credentials - API credentials
+ * @param execute - Function to execute individual operations (injected for testability)
+ * @returns Batch response with summary and individual results
+ */
+export declare function handleBatch(operations: unknown, credentials: ProductiveCredentials, execute: ExecuteFunction): Promise<ToolResult>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/handlers/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/handlers/batch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,6DAA6D;AAC7D,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,qBAAqB,KAC/B,OAAO,CAAC,UAAU,CAAC,CAAC;AAuGzB;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,OAAO,EACnB,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,UAAU,CAAC,CA+BrB"}

package/dist/handlers/deals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deals.d.ts","sourceRoot":"","sources":["../../src/handlers/deals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,eAAO,MAAM,WAAW;;;wFAwBtB,CAAC"}
+{"version":3,"file":"deals.d.ts","sourceRoot":"","sources":["../../src/handlers/deals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C,eAAO,MAAM,WAAW;;;wFAsCtB,CAAC"}

package/dist/handlers/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/handlers/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA2mB7C;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAcvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CAW/C"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/handlers/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgrB7C;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAevD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CAY/C"}

package/dist/handlers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAC;AAuB7D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA2D7C;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,qBAAqB,GACjC,OAAO,CAAC,UAAU,CAAC,CA6IrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAC;AA2B7D,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8D7C;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,qBAAqB,GACjC,OAAO,CAAC,UAAU,CAAC,CAoKrB"}

package/dist/handlers/projects.d.ts

@@ -7,7 +7,7 @@ import type { CommonArgs } from './types.js';
 /**
  * Handle projects resource.
  *
- * Supports: list, get, resolve
+ * Supports: list, get, resolve, context
  */
 export declare const handleProjects: (action: string, args: CommonArgs & {
     query?: string;

package/dist/handlers/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/handlers/projects.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;wFAUzB,CAAC"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/handlers/projects.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ7C;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;wFAwBzB,CAAC"}

package/dist/handlers/schema.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Schema handler - provides compact, machine-readable resource specifications
+ *
+ * More concise than action=help, optimized for LLM consumption when only
+ * field metadata is needed (filters, create fields, includes).
+ */
+import type { ToolResult } from './types.js';
+/**
+ * Field specification for create/update operations
+ */
+export interface ResourceFieldSpec {
+    required: boolean;
+    type: string;
+}
+/**
+ * Compact schema data for a resource
+ */
+export interface ResourceSchemaData {
+    actions: string[];
+    filters: Record<string, string>;
+    create?: Record<string, ResourceFieldSpec>;
+    update?: string[];
+    includes?: string[];
+}
+/**
+ * Handle schema action - returns compact specification for a specific resource
+ */
+export declare function handleSchema(resource: string): ToolResult;
+/**
+ * Get schema overview for all resources
+ */
+export declare function handleSchemaOverview(): ToolResult;
+//# sourceMappingURL=schema.d.ts.map

package/dist/handlers/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/handlers/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AA0MD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAazD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAUjD"}

package/dist/handlers/search.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Cross-resource search handler for MCP.
+ *
+ * Fans out a text query across multiple resource types simultaneously,
+ * returning grouped results in a single tool call.
+ */
+import type { ProductiveCredentials } from '../auth.js';
+import type { ToolResult } from './types.js';
+/**
+ * Resources that support the query filter for text search
+ */
+export declare const SEARCHABLE_RESOURCES: readonly ["projects", "companies", "people", "tasks", "deals"];
+export type SearchableResource = (typeof SEARCHABLE_RESOURCES)[number];
+/**
+ * Type for the execute function injected for delegation
+ */
+export type ExecuteFunction = (name: string, args: Record<string, unknown>, credentials: ProductiveCredentials) => Promise<ToolResult>;
+/**
+ * Handle cross-resource search.
+ *
+ * @param query - Search query text (required)
+ * @param resources - Resource types to search (optional, defaults to DEFAULT_SEARCH_RESOURCES)
+ * @param credentials - Productive API credentials
+ * @param execute - Function to execute tool calls (injected for delegation and testing)
+ * @returns Grouped search results across all requested resources
+ */
+export declare function handleSearch(query: string | undefined, resources: string[] | undefined, credentials: ProductiveCredentials, execute: ExecuteFunction): Promise<ToolResult>;
+//# sourceMappingURL=search.d.ts.map

package/dist/handlers/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/handlers/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C;;GAEG;AACH,eAAO,MAAM,oBAAoB,gEAAiE,CAAC;AACnG,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAOvE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,qBAAqB,KAC/B,OAAO,CAAC,UAAU,CAAC,CAAC;AAUzB;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAC/B,WAAW,EAAE,qBAAqB,EAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,UAAU,CAAC,CAmFrB"}

package/dist/handlers/summaries.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Summaries MCP handler.
+ *
+ * Custom handler for dashboard-style summaries (not using createResourceHandler).
+ * Routes actions to the appropriate summary executor.
+ */
+import type { HandlerContext, ToolResult } from './types.js';
+interface SummaryArgs {
+    project_id?: string;
+}
+/**
+ * Handle summaries resource.
+ *
+ * Supports: my_day, project_health, team_pulse
+ */
+export declare function handleSummaries(action: string, args: SummaryArgs, ctx: HandlerContext): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=summaries.d.ts.map

package/dist/handlers/summaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summaries.d.ts","sourceRoot":"","sources":["../../src/handlers/summaries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO7D,UAAU,WAAW;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,UAAU,CAAC,CA2ErB"}

package/dist/handlers/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/handlers/tasks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,eAAO,MAAM,WAAW;;;wFAsCtB,CAAC"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/handlers/tasks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C,eAAO,MAAM,WAAW;;;wFAsDtB,CAAC"}