@standardbeagle/dart-query 0.3.2

package/dist/tools/info.js

@@ -0,0 +1,474 @@
+const TOOL_GROUPS = {
+    discovery: {
+        count: 1,
+        purpose: 'Progressive capability discovery',
+        tools: [
+            {
+                name: 'info',
+                description: 'Progressive discovery of dart-query capabilities - start here',
+            },
+        ],
+    },
+    config: {
+        count: 1,
+        purpose: 'Workspace configuration',
+        tools: [
+            {
+                name: 'get_config',
+                description: 'Get workspace configuration: assignees, dartboards, statuses, tags, priorities, sizes',
+            },
+        ],
+    },
+    'task-crud': {
+        count: 5,
+        purpose: 'Single task operations',
+        tools: [
+            {
+                name: 'create_task',
+                description: 'Create a new task with title, description, status, priority, size, dates, dartboard, assignees, tags, and relationships (parent, blockers, related)',
+            },
+            {
+                name: 'get_task',
+                description: 'Retrieve an existing task by its dart_id with full details and relationship information',
+            },
+            {
+                name: 'update_task',
+                description: "Update an existing task's properties (status, title, description, priority, assignees, relationships, etc.)",
+            },
+            {
+                name: 'delete_task',
+                description: 'Move a task to trash (recoverable from Dart web UI)',
+            },
+            {
+                name: 'add_task_comment',
+                description: 'Add a comment to an existing task',
+            },
+        ],
+    },
+    'task-query': {
+        count: 2,
+        purpose: 'Search and filter tasks',
+        tools: [
+            {
+                name: 'list_tasks',
+                description: 'List tasks with optional filtering by assignee, status, dartboard, priority, due date, relationships, and more',
+            },
+            {
+                name: 'search_tasks',
+                description: 'Full-text search across task titles and descriptions with relevance ranking',
+            },
+        ],
+    },
+    'task-batch': {
+        count: 3,
+        purpose: 'Bulk operations on multiple tasks',
+        tools: [
+            {
+                name: 'batch_update_tasks',
+                description: 'Update multiple tasks matching a DartQL selector expression (SQL-like WHERE syntax)',
+            },
+            {
+                name: 'batch_delete_tasks',
+                description: 'Delete multiple tasks matching a DartQL selector expression (moves to trash, recoverable)',
+            },
+            {
+                name: 'get_batch_status',
+                description: 'Get status of a long-running batch operation by batch_operation_id',
+            },
+        ],
+    },
+    'doc-crud': {
+        count: 5,
+        purpose: 'Document management',
+        tools: [
+            {
+                name: 'list_docs',
+                description: 'List docs with optional filtering by folder, title, text content',
+            },
+            {
+                name: 'create_doc',
+                description: 'Create a new doc with title, text content (markdown), and folder',
+            },
+            {
+                name: 'get_doc',
+                description: 'Retrieve an existing doc by its doc_id with full text content',
+            },
+            {
+                name: 'update_doc',
+                description: "Update an existing doc's title or text content",
+            },
+            {
+                name: 'delete_doc',
+                description: 'Move a doc to trash (recoverable)',
+            },
+        ],
+    },
+    import: {
+        count: 1,
+        purpose: 'CSV bulk import',
+        tools: [
+            {
+                name: 'import_tasks_csv',
+                description: 'Bulk-create tasks from CSV data (inline text or file path) with validation and error recovery',
+            },
+        ],
+    },
+};
+function renderOverview() {
+    return `Dart Query MCP - Task Management with Batch Operations
+
+Tool Groups
+-----------
+Group       | Count | Purpose
+----------- | ----- | -------
+discovery   | 1     | Progressive capability discovery
+config      | 1     | Workspace configuration
+task-crud   | 5     | Single task operations
+task-query  | 2     | Search and filter tasks
+task-batch  | 3     | Bulk operations on multiple tasks
+doc-crud    | 5     | Document management
+import      | 1     | CSV bulk import
+
+Quick Start:    info(level='group', target='task-crud')
+Batch Ops:      info(level='group', target='task-batch')
+DartQL Help:    info(level='tool', target='batch_update_tasks')
+Relationships:  info(level='tool', target='relationships')`;
+}
+function renderGroup(target) {
+    const group = TOOL_GROUPS[target];
+    if (!group) {
+        const validGroups = Object.keys(TOOL_GROUPS).join(', ');
+        return `Error: Unknown group "${target}". Valid groups: ${validGroups}`;
+    }
+    let output = `Tool Group: ${target}\n`;
+    output += `Purpose: ${group.purpose}\n`;
+    output += `Tools (${group.count}):\n\n`;
+    group.tools.forEach((tool) => {
+        output += `• ${tool.name}\n  ${tool.description}\n\n`;
+    });
+    output += `\nNext Steps:\n`;
+    output += `- info(level='tool', target='${group.tools[0].name}') - Full documentation\n`;
+    output += `- info(level='overview') - Return to overview`;
+    return output;
+}
+function renderTool(target) {
+    const toolDocs = {
+        info: `Tool: info
+Description: Progressive discovery of dart-query capabilities - start here
+
+Input Schema:
+  level?: 'overview' | 'group' | 'tool' (default: 'overview')
+    Detail level for information display
+
+  target?: string
+    Group name (when level='group') or tool name (when level='tool')
+
+Output Schema:
+  level: string (echoed back)
+  content: string (formatted documentation)
+  next_steps: string[] (suggested follow-up queries)
+
+Examples:
+  info()
+    → Shows overview table of all tool groups
+
+  info(level='group', target='task-batch')
+    → Shows batch operation tools
+
+  info(level='tool', target='batch_update_tasks')
+    → Shows full schema and DartQL syntax guide
+
+Token Budget: ~150 tokens (overview), ~200 tokens (group), ~500 tokens (tool)
+Performance: Instant (no API calls required)`,
+        get_config: `Tool: get_config
+Description: Get workspace configuration: assignees, dartboards, statuses, tags, priorities, sizes
+
+Input Schema:
+  cache_bust?: boolean (default: false)
+    Force refresh cached config (default: 5-minute cache)
+
+  include?: Array<'assignees' | 'dartboards' | 'statuses' | 'tags' | 'priorities' | 'sizes' | 'folders'>
+    Limit response to specific config sections (default: all)
+
+Output Schema:
+  assignees: Array<{dart_id, name, email, role}>
+  dartboards: Array<{dart_id, name, description}>
+  statuses: Array<{dart_id, name, color, order}>
+  tags: Array<{dart_id, name, color}>
+  priorities: Array<{value: 1-5, label}>
+  sizes: Array<{value: 1-5, label}>
+  folders: Array<{dart_id, name, space_id}>
+  cached_at: iso8601 timestamp
+  cache_ttl_seconds: integer
+
+Use Cases:
+  - Get valid dartboard_ids before creating tasks
+  - Validate assignee emails before CSV import
+  - Resolve status names to dart_ids
+
+Examples:
+  get_config()
+    → Full workspace configuration (cached for 5 minutes)
+
+  get_config(include=['dartboards', 'assignees'])
+    → Only dartboards and assignees (token-efficient)
+
+  get_config(cache_bust=true)
+    → Force refresh cached config
+
+Token Budget: ~400 tokens
+Performance: Fast (cached) / Medium (API call)`,
+        batch_update_tasks: `Tool: batch_update_tasks
+Description: Update multiple tasks matching a DartQL selector expression (SQL-like WHERE syntax)
+
+Input Schema:
+  selector: string (required)
+    DartQL WHERE clause (e.g., "status = 'Todo' AND priority >= 3")
+
+  updates: object (required)
+    Fields to update on all matching tasks
+    Properties: status, priority, size, assignees, tags, due_at, start_at
+
+  dry_run?: boolean (default: false)
+    Preview matching tasks without updating (RECOMMENDED for first run)
+
+  concurrency?: integer (default: 5)
+    Max concurrent API calls (1-20)
+
+Output Schema:
+  batch_operation_id: string
+  selector_matched: integer (total tasks matching selector)
+  dry_run: boolean
+  preview_tasks?: Array<{dart_id, title, current_values}> (if dry_run=true)
+  successful_updates: integer
+  failed_updates: integer
+  successful_dart_ids: string[]
+  failed_items: Array<{dart_id, error, reason}>
+  execution_time_ms: integer
+
+DartQL Syntax Guide:
+  Operators: =, !=, >, >=, <, <=, IN, NOT IN, LIKE, CONTAINS
+  Logical: AND, OR, NOT
+  Grouping: Use parentheses for precedence
+
+  Examples:
+    "status = 'Todo'"
+    "priority >= 3 AND assignee = 'duid_user1'"
+    "tags CONTAINS 'urgent' AND due_at < '2026-02-01'"
+    "(status = 'Todo' OR status = 'In Progress') AND NOT (priority = 1)"
+
+Workflow:
+  1. batch_update_tasks(selector="...", updates={...}, dry_run=true)
+     → Preview matching tasks
+
+  2. Review preview, confirm selector is correct
+
+  3. batch_update_tasks(selector="...", updates={...}, dry_run=false)
+     → Execute update
+
+Token Budget: ~400 tokens
+Performance: Slow (depends on match count)`,
+        import_tasks_csv: `Tool: import_tasks_csv
+Description: Bulk-create tasks from CSV data with validation and error recovery
+
+Input Schema:
+  csv_data?: string
+    Inline CSV content (first row must be headers)
+
+  csv_file_path?: string
+    Path to CSV file (alternative to csv_data)
+
+  dartboard: string (required)
+    Default dartboard dart_id (can be overridden per-row via 'dartboard' column)
+
+  column_mapping?: object
+    Custom column name mappings (e.g., {'Task Name': 'title', 'Assigned To': 'assignee'})
+
+  validate_only?: boolean (default: false)
+    Validate and preview without creating tasks (RECOMMENDED for first run)
+
+  continue_on_error?: boolean (default: true)
+    Continue processing if individual rows fail
+
+  concurrency?: integer (default: 5)
+    Max concurrent task creation calls
+
+CSV Format Guide:
+  Required Columns:
+    title - Task title (required)
+
+  Optional Columns:
+    description, status, priority, size, assignee, dartboard, tags, due_date, start_date, parent_task
+
+  Flexible Column Names (case-insensitive):
+    'Title' = 'title' = 'Task Name'
+    'Assigned To' = 'assignee' = 'Owner'
+    'Tags' = 'labels' (comma-separated)
+
+CSV Example:
+  title,description,assignee,priority,tags,due_date
+  "Fix login bug","Users can't login",engineer@company.com,5,"bug,urgent",2026-02-01
+  "Update docs","API documentation",writer@company.com,2,documentation,2026-02-15
+
+Workflow:
+  1. get_config() → Get dartboard_ids for reference resolution
+
+  2. import_tasks_csv(csv_file_path='tasks.csv', dartboard='duid_board1', validate_only=true)
+     → Validation errors, preview
+
+  3. Fix CSV errors if any
+
+  4. import_tasks_csv(csv_file_path='tasks.csv', dartboard='duid_board1', validate_only=false)
+     → Execute import
+
+Token Budget: ~500 tokens
+Performance: Slow (depends on row count)`,
+        relationships: `Topic: Task Relationships
+Description: Dart supports six relationship types to model task dependencies and connections
+
+Relationship Types:
+  parent_task / subtask_ids
+    Hierarchical parent-child relationships for breaking work into subtasks.
+    A task can have one parent and multiple subtasks.
+
+  blocker_ids / blocking_ids
+    Dependency relationships where one task blocks another.
+    blocker_ids: Tasks that must complete before this task can start.
+    blocking_ids: Tasks that this task is blocking.
+
+  duplicate_ids
+    Links tasks that represent the same work (usually to consolidate).
+    Bidirectional - marking A as duplicate of B links both.
+
+  related_ids
+    General-purpose links between related tasks.
+    Use for reference without implying dependency or hierarchy.
+
+Creating Tasks with Relationships:
+  create_task(
+    title="Implement login",
+    subtask_ids=["duid_task2", "duid_task3"],
+    blocker_ids=["duid_task1"]
+  )
+
+Updating Relationships:
+  update_task(
+    dart_id="duid_task1",
+    subtask_ids=["duid_new1", "duid_new2"],  // Replaces existing
+    related_ids=[]  // Clears all related tasks
+  )
+  Note: Relationship updates use full replacement, not append.
+
+Querying Relationships:
+  get_task(dart_id="duid_task1", expand_relationships=true)
+    → Includes relationship_counts and expanded relationship details
+
+  list_tasks(has_subtasks=true)
+    → Filter to parent tasks only
+
+  list_tasks(has_blockers=true)
+    → Find blocked tasks
+
+  list_tasks(blocked_by="duid_task1")
+    → Find all tasks blocked by a specific task
+
+Relationship Filters (list_tasks):
+  has_parent: boolean        - Tasks with a parent task
+  has_subtasks: boolean      - Tasks with subtasks
+  has_blockers: boolean      - Tasks blocked by other tasks
+  is_blocking: boolean       - Tasks blocking other tasks
+  blocked_by: string         - Tasks blocked by specific task
+  blocking: string           - Tasks that block specific task
+
+DartQL Relationship Queries:
+  "subtask_ids IS NOT NULL"        - Parent tasks
+  "blocker_ids CONTAINS 'duid_x'"  - Tasks blocked by duid_x
+  "related_ids IS NULL"            - Tasks with no relations
+
+CSV Import:
+  Relationship columns accept comma-separated dart_ids:
+    subtask_ids,blocker_ids
+    "duid_a,duid_b","duid_c"
+
+Best Practices:
+  - Use expand_relationships=true sparingly (adds API calls)
+  - Clear relationships with empty array [], not null
+  - Validate dart_ids exist before creating relationships
+  - Use has_blockers filter to find blocked work
+
+Token Budget: ~600 tokens
+Performance: Varies by operation`,
+    };
+    const doc = toolDocs[target];
+    if (!doc) {
+        const availableTools = Object.keys(toolDocs).join(', ');
+        return `Error: No documentation for tool "${target}".
+
+Available tools with full documentation: ${availableTools}
+
+For other tools, use: info(level='group', target='...')`;
+    }
+    return doc + "\n\nNext Steps:\n- info(level='overview') - Return to overview";
+}
+function generateNextSteps(level, target) {
+    if (level === 'overview') {
+        return [
+            "info(level='group', target='task-batch') - Learn batch operations",
+            "get_config() - Get workspace configuration before creating tasks",
+            "info(level='group', target='task-crud') - Learn single task operations",
+        ];
+    }
+    if (level === 'group' && target) {
+        const group = TOOL_GROUPS[target];
+        if (group && group.tools.length > 0) {
+            return [
+                `info(level='tool', target='${group.tools[0].name}') - Full documentation for ${group.tools[0].name}`,
+                "info(level='overview') - Return to overview",
+            ];
+        }
+    }
+    if (level === 'tool') {
+        return [
+            "info(level='overview') - Return to overview",
+            "get_config() - Get workspace configuration",
+        ];
+    }
+    return [
+        "info() - Show overview",
+    ];
+}
+export async function handleInfo(input) {
+    const safeInput = input || {};
+    const level = safeInput.level || 'overview';
+    const target = safeInput.target;
+    let content;
+    switch (level) {
+        case 'overview':
+            content = renderOverview();
+            break;
+        case 'group':
+            if (!target) {
+                content = 'Error: target parameter required when level=group\n\n' + renderOverview();
+            }
+            else {
+                content = renderGroup(target);
+            }
+            break;
+        case 'tool':
+            if (!target) {
+                content = 'Error: target parameter required when level=tool\n\n' + renderOverview();
+            }
+            else {
+                content = renderTool(target);
+            }
+            break;
+        default:
+            content = `Error: Invalid level "${level}". Valid levels: overview, group, tool\n\n` + renderOverview();
+    }
+    return {
+        level,
+        content,
+        next_steps: generateNextSteps(level, target),
+    };
+}
+//# sourceMappingURL=info.js.map

package/dist/tools/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../src/tools/info.ts"],"names":[],"mappings":"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"}

package/dist/tools/list_comments.d.ts

@@ -0,0 +1,3 @@
+import { ListCommentsInput, ListCommentsOutput } from '../types/index.js';
+export declare function handleListComments(input: ListCommentsInput): Promise<ListCommentsOutput>;
+//# sourceMappingURL=list_comments.d.ts.map

package/dist/tools/list_comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_comments.d.ts","sourceRoot":"","sources":["../../src/tools/list_comments.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAInB,MAAM,mBAAmB,CAAC;AAQ3B,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0D9F"}

package/dist/tools/list_comments.js

@@ -0,0 +1,46 @@
+import { DartClient } from '../api/dartClient.js';
+import { DartAPIError, ValidationError, } from '../types/index.js';
+export async function handleListComments(input) {
+    const DART_TOKEN = process.env.DART_TOKEN;
+    if (!DART_TOKEN) {
+        throw new DartAPIError('DART_TOKEN environment variable is required. Get your token from: https://app.dartai.com/?settings=account', 401);
+    }
+    if (!input || typeof input !== 'object') {
+        throw new ValidationError('Input must be an object', 'input');
+    }
+    if (!input.task_id || typeof input.task_id !== 'string' || input.task_id.trim() === '') {
+        throw new ValidationError('task_id is required and must be a non-empty string', 'task_id');
+    }
+    const limit = input.limit ?? 50;
+    if (typeof limit !== 'number' || limit < 1 || limit > 100) {
+        throw new ValidationError('limit must be a number between 1 and 100', 'limit');
+    }
+    const offset = input.offset ?? 0;
+    if (typeof offset !== 'number' || offset < 0) {
+        throw new ValidationError('offset must be a non-negative number', 'offset');
+    }
+    const client = new DartClient({ token: DART_TOKEN });
+    const result = await client.listComments({
+        task_id: input.task_id.trim(),
+        limit,
+        offset,
+    });
+    const returnedCount = result.comments.length;
+    const hasMore = (offset + returnedCount) < result.total;
+    const comments = result.comments.map(c => ({
+        comment_id: c.comment_id,
+        text: c.text,
+        author: c.author,
+        created_at: c.created_at,
+        parent_id: c.parent_id,
+    }));
+    return {
+        comments,
+        total_count: result.total,
+        returned_count: returnedCount,
+        has_more: hasMore,
+        next_offset: hasMore ? offset + returnedCount : null,
+        task_id: input.task_id.trim(),
+    };
+}
+//# sourceMappingURL=list_comments.js.map

package/dist/tools/list_comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_comments.js","sourceRoot":"","sources":["../../src/tools/list_comments.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAIL,YAAY,EACZ,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAQ3B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAwB;IAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAE1C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,YAAY,CACpB,4GAA4G,EAC5G,GAAG,CACJ,CAAC;IACJ,CAAC;IAGD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,eAAe,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvF,MAAM,IAAI,eAAe,CAAC,oDAAoD,EAAE,SAAS,CAAC,CAAC;IAC7F,CAAC;IAGD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAC1D,MAAM,IAAI,eAAe,CAAC,0CAA0C,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IACjC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,eAAe,CAAC,sCAAsC,EAAE,QAAQ,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;QACvC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;QAC7B,KAAK;QACL,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC7C,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,aAAa,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IAGxD,MAAM,QAAQ,GAAkB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,SAAS,EAAE,CAAC,CAAC,SAAS;KACvB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,QAAQ;QACR,WAAW,EAAE,MAAM,CAAC,KAAK;QACzB,cAAc,EAAE,aAAa;QAC7B,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI;QACpD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;KAC9B,CAAC;AACJ,CAAC"}

package/dist/tools/list_docs.d.ts

@@ -0,0 +1,3 @@
+import { ListDocsInput, ListDocsOutput } from '../types/index.js';
+export declare function handleListDocs(input?: ListDocsInput): Promise<ListDocsOutput>;
+//# sourceMappingURL=list_docs.d.ts.map

package/dist/tools/list_docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_docs.d.ts","sourceRoot":"","sources":["../../src/tools/list_docs.ts"],"names":[],"mappings":"AASA,OAAO,EACL,aAAa,EACb,cAAc,EAMf,MAAM,mBAAmB,CAAC;AAgB3B,wBAAsB,cAAc,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAkLnF"}

package/dist/tools/list_docs.js

@@ -0,0 +1,101 @@
+import { DartClient } from '../api/dartClient.js';
+import { handleGetConfig } from './get_config.js';
+import { DartAPIError, ValidationError, findFolder, getFolderNames, } from '../types/index.js';
+export async function handleListDocs(input) {
+    const DART_TOKEN = process.env.DART_TOKEN;
+    if (!DART_TOKEN) {
+        throw new DartAPIError('DART_TOKEN environment variable is required. Get your token from: https://app.dartai.com/?settings=account', 401);
+    }
+    const safeInput = input || {};
+    let limit = safeInput.limit !== undefined ? safeInput.limit : 50;
+    if (typeof limit !== 'number' || limit < 1 || limit > 500) {
+        throw new ValidationError(`limit must be a number between 1 and 500 (received: ${limit})`, 'limit');
+    }
+    let offset = safeInput.offset !== undefined ? safeInput.offset : 0;
+    if (typeof offset !== 'number' || offset < 0) {
+        throw new ValidationError(`offset must be a non-negative number (received: ${offset})`, 'offset');
+    }
+    let resolvedFolder;
+    if (safeInput.folder) {
+        let config;
+        try {
+            config = await handleGetConfig({ cache_bust: false });
+        }
+        catch (error) {
+            if (error instanceof DartAPIError) {
+                throw new DartAPIError(`Failed to retrieve workspace config for folder validation: ${error.message}`, error.statusCode, error.response);
+            }
+            throw error;
+        }
+        if (!config.folders || config.folders.length === 0) {
+            throw new ValidationError('No folders found in workspace configuration. Create a folder first in Dart AI.', 'folder');
+        }
+        const folder = findFolder(config.folders, safeInput.folder);
+        if (!folder) {
+            const folderNames = getFolderNames(config.folders);
+            const availableFolders = folderNames.join(', ');
+            throw new ValidationError(`Invalid folder: "${safeInput.folder}" not found in workspace. Available folders: ${availableFolders}`, 'folder', folderNames);
+        }
+        resolvedFolder = folder.dart_id;
+    }
+    const client = new DartClient({ token: DART_TOKEN });
+    const apiInput = {
+        limit,
+        offset,
+    };
+    if (resolvedFolder) {
+        apiInput.folder = resolvedFolder;
+    }
+    if (safeInput.title_contains !== undefined) {
+        if (typeof safeInput.title_contains !== 'string') {
+            throw new ValidationError('title_contains must be a string', 'title_contains');
+        }
+        if (safeInput.title_contains.trim() !== '') {
+            apiInput.title_contains = safeInput.title_contains;
+        }
+    }
+    if (safeInput.text_contains !== undefined) {
+        if (typeof safeInput.text_contains !== 'string') {
+            throw new ValidationError('text_contains must be a string', 'text_contains');
+        }
+        if (safeInput.text_contains.trim() !== '') {
+            apiInput.text_contains = safeInput.text_contains;
+        }
+    }
+    let apiResponse;
+    try {
+        apiResponse = await client.listDocs(apiInput);
+    }
+    catch (error) {
+        if (error instanceof DartAPIError) {
+            throw new DartAPIError(`Failed to list documents: ${error.message}`, error.statusCode, error.response);
+        }
+        throw error;
+    }
+    const returnedCount = apiResponse.docs.length;
+    const totalCount = apiResponse.total;
+    const hasMore = (offset + returnedCount) < totalCount;
+    const nextOffset = hasMore ? offset + returnedCount : null;
+    const filtersApplied = {
+        limit,
+        offset,
+    };
+    if (resolvedFolder) {
+        filtersApplied.folder = resolvedFolder;
+    }
+    if (safeInput.title_contains) {
+        filtersApplied.title_contains = safeInput.title_contains;
+    }
+    if (safeInput.text_contains) {
+        filtersApplied.text_contains = safeInput.text_contains;
+    }
+    return {
+        docs: apiResponse.docs,
+        total_count: totalCount,
+        returned_count: returnedCount,
+        has_more: hasMore,
+        next_offset: nextOffset,
+        filters_applied: filtersApplied,
+    };
+}
+//# sourceMappingURL=list_docs.js.map

package/dist/tools/list_docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_docs.js","sourceRoot":"","sources":["../../src/tools/list_docs.ts"],"names":[],"mappings":"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"}

package/dist/tools/list_tasks.d.ts

@@ -0,0 +1,3 @@
+import { ListTasksInput, ListTasksOutput } from '../types/index.js';
+export declare function handleListTasks(input: ListTasksInput): Promise<ListTasksOutput>;
+//# sourceMappingURL=list_tasks.d.ts.map

package/dist/tools/list_tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_tasks.d.ts","sourceRoot":"","sources":["../../src/tools/list_tasks.ts"],"names":[],"mappings":"AASA,OAAO,EACL,cAAc,EACd,eAAe,EAUhB,MAAM,mBAAmB,CAAC;AAiB3B,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAuFrF"}