ai-prompt-guide-mcp 1.0.0

package/dist/tools/schemas/task-schemas.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Schema definitions for task tool - Bulk operations only
+ */
+/**
+ * Individual task operation within the operations array
+ */
+export interface TaskOperationSchema {
+    operation: 'create' | 'edit' | 'list';
+    title?: string;
+    content?: string;
+    task?: string;
+    status?: string;
+}
+/**
+ * Main input schema for bulk task operations
+ */
+export interface TaskInputSchema {
+    type: 'object';
+    properties: {
+        document: {
+            type: 'string';
+            description: 'Document path (e.g., "/specs/search-api.md"). ALWAYS required - provides default context for all operations. Individual task fields can override with full path "/other.md#slug" for multi-document operations.';
+        };
+        operations: {
+            type: 'array';
+            description: 'Array of task operations to perform';
+            items: {
+                type: 'object';
+                properties: {
+                    operation: {
+                        type: 'string';
+                        enum: ['create', 'edit', 'list'];
+                        description: 'Task operation type';
+                    };
+                    title: {
+                        type: 'string';
+                        description: 'Task title (required for create)';
+                    };
+                    content: {
+                        type: 'string';
+                        description: 'Task content with optional @references and workflow metadata (Workflow: workflow_name, Main-Workflow: workflow_name). Use the get_workflow tool to discover available workflow names.';
+                    };
+                    task: {
+                        type: 'string';
+                        description: 'Task slug or full path with override support. THREE FORMATS: 1) "slug" - uses document parameter as context, 2) "#slug" - uses document parameter as context (with # prefix), 3) "/other.md#slug" - overrides document parameter for this operation. Example multi-document: document="/project/main.md" with task="/project/sub.md#task-1" creates task in sub.md instead. Required for edit operation.';
+                    };
+                    status: {
+                        type: 'string';
+                        enum: ['pending', 'in_progress', 'completed', 'blocked'];
+                        description: 'Filter by status for list operation';
+                    };
+                };
+                required: ['operation'];
+            };
+        };
+    };
+    required: ['document', 'operations'];
+    additionalProperties: false;
+}
+/**
+ * Schema constants for task tool
+ */
+export declare const TASK_CONSTANTS: {
+    readonly OPERATIONS: {
+        readonly CREATE: "create";
+        readonly EDIT: "edit";
+        readonly LIST: "list";
+    };
+    readonly STATUSES: {
+        readonly PENDING: "pending";
+        readonly IN_PROGRESS: "in_progress";
+        readonly COMPLETED: "completed";
+        readonly BLOCKED: "blocked";
+    };
+    readonly MAX_TITLE_LENGTH: 200;
+    readonly MAX_CONTENT_LENGTH: 2000;
+    readonly MAX_NOTE_LENGTH: 1000;
+};
+/**
+ * Helper functions for task validation
+ */
+export declare function isValidTaskOperation(operation: string): boolean;
+export declare function isValidTaskStatus(status: string): boolean;
+/**
+ * Get the input schema for task tool (bulk operations only)
+ */
+export declare function getTaskSchema(): TaskInputSchema;
+//# sourceMappingURL=task-schemas.d.ts.map

package/dist/tools/schemas/task-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/task-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,iNAAiN,CAAC;SAChO,CAAC;QACF,UAAU,EAAE;YACV,IAAI,EAAE,OAAO,CAAC;YACd,WAAW,EAAE,qCAAqC,CAAC;YACnD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ,CAAC;gBACf,UAAU,EAAE;oBACV,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ,CAAC;wBACf,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;wBACjC,WAAW,EAAE,qBAAqB,CAAC;qBACpC,CAAC;oBACF,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ,CAAC;wBACf,WAAW,EAAE,kCAAkC,CAAC;qBACjD,CAAC;oBACF,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ,CAAC;wBACf,WAAW,EAAE,uLAAuL,CAAC;qBACtM,CAAC;oBACF,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ,CAAC;wBACf,WAAW,EAAE,0YAA0Y,CAAC;qBACzZ,CAAC;oBACF,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ,CAAC;wBACf,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;wBACzD,WAAW,EAAE,qCAAqC,CAAC;qBACpD,CAAC;iBACH,CAAC;gBACF,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC;aACzB,CAAC;SACH,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACrC,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;CAejB,CAAC;AAEX;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,eAAe,CA4C/C"}

package/dist/tools/schemas/task-schemas.js

@@ -0,0 +1,80 @@
+/**
+ * Schema definitions for task tool - Bulk operations only
+ */
+/**
+ * Schema constants for task tool
+ */
+export const TASK_CONSTANTS = {
+    OPERATIONS: {
+        CREATE: 'create',
+        EDIT: 'edit',
+        LIST: 'list',
+    },
+    STATUSES: {
+        PENDING: 'pending',
+        IN_PROGRESS: 'in_progress',
+        COMPLETED: 'completed',
+        BLOCKED: 'blocked',
+    },
+    MAX_TITLE_LENGTH: 200,
+    MAX_CONTENT_LENGTH: 2000,
+    MAX_NOTE_LENGTH: 1000,
+};
+/**
+ * Helper functions for task validation
+ */
+export function isValidTaskOperation(operation) {
+    return Object.values(TASK_CONSTANTS.OPERATIONS).includes(operation);
+}
+export function isValidTaskStatus(status) {
+    return Object.values(TASK_CONSTANTS.STATUSES).includes(status);
+}
+/**
+ * Get the input schema for task tool (bulk operations only)
+ */
+export function getTaskSchema() {
+    return {
+        type: 'object',
+        properties: {
+            document: {
+                type: 'string',
+                description: 'Document path (e.g., "/specs/search-api.md"). ALWAYS required - provides default context for all operations. Individual task fields can override with full path "/other.md#slug" for multi-document operations.',
+            },
+            operations: {
+                type: 'array',
+                description: 'Array of task operations to perform',
+                items: {
+                    type: 'object',
+                    properties: {
+                        operation: {
+                            type: 'string',
+                            enum: ['create', 'edit', 'list'],
+                            description: 'Task operation type'
+                        },
+                        title: {
+                            type: 'string',
+                            description: 'Task title (required for create)'
+                        },
+                        content: {
+                            type: 'string',
+                            description: 'Task content with optional @references and workflow metadata (Workflow: workflow_name, Main-Workflow: workflow_name). Use the get_workflow tool to discover available workflow names.'
+                        },
+                        task: {
+                            type: 'string',
+                            description: 'Task slug or full path with override support. THREE FORMATS: 1) "slug" - uses document parameter as context, 2) "#slug" - uses document parameter as context (with # prefix), 3) "/other.md#slug" - overrides document parameter for this operation. Example multi-document: document="/project/main.md" with task="/project/sub.md#task-1" creates task in sub.md instead. Required for edit operation.'
+                        },
+                        status: {
+                            type: 'string',
+                            enum: ['pending', 'in_progress', 'completed', 'blocked'],
+                            description: 'Filter by status for list operation'
+                        }
+                    },
+                    required: ['operation']
+                }
+            }
+        },
+        required: ['document', 'operations'],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=task-schemas.js.map

package/dist/tools/schemas/task-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/task-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4DH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE;QACV,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;KACb;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,aAAa;QAC1B,SAAS,EAAE,WAAW;QACtB,OAAO,EAAE,SAAS;KACnB;IACD,gBAAgB,EAAE,GAAG;IACrB,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,IAAI;CACb,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,SAAuC,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAA6D,CAAC,CAAC;AACxH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iNAAiN;aAC/N;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,qCAAqC;gBAClD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,SAAS,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;4BAChC,WAAW,EAAE,qBAAqB;yBACnC;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,kCAAkC;yBAChD;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,uLAAuL;yBACrM;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,0YAA0Y;yBACxZ;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC;4BACxD,WAAW,EAAE,qCAAqC;yBACnD;qBACF;oBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;iBACxB;aACF;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;QACpC,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tools/schemas/view-coordinator-task-schemas.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Schema definitions for view_coordinator_task tool
+ * Dedicated tool for viewing coordinator tasks from /coordinator/active.md
+ */
+export interface ViewCoordinatorTaskInputSchema {
+    type: 'object';
+    properties: {
+        slug?: {
+            type: 'string';
+            description: string;
+        };
+    };
+    required: never[];
+    additionalProperties: false;
+}
+/**
+ * Schema constants for view_coordinator_task tool
+ */
+export declare const VIEW_COORDINATOR_TASK_CONSTANTS: {
+    readonly MAX_TASKS: 10;
+    readonly COORDINATOR_PATH: "/coordinator/active.md";
+};
+/**
+ * Get the input schema for view_coordinator_task tool
+ */
+export declare function getViewCoordinatorTaskSchema(): ViewCoordinatorTaskInputSchema;
+//# sourceMappingURL=view-coordinator-task-schemas.d.ts.map

package/dist/tools/schemas/view-coordinator-task-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-coordinator-task-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/view-coordinator-task-schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;CAGlC,CAAC;AAEX;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,8BAA8B,CA8B7E"}

package/dist/tools/schemas/view-coordinator-task-schemas.js

@@ -0,0 +1,46 @@
+/**
+ * Schema definitions for view_coordinator_task tool
+ * Dedicated tool for viewing coordinator tasks from /coordinator/active.md
+ */
+/**
+ * Schema constants for view_coordinator_task tool
+ */
+export const VIEW_COORDINATOR_TASK_CONSTANTS = {
+    MAX_TASKS: 10, // Limit for multiple task viewing
+    COORDINATOR_PATH: '/coordinator/active.md' // Fixed path for coordinator tasks
+};
+/**
+ * Get the input schema for view_coordinator_task tool
+ */
+export function getViewCoordinatorTaskSchema() {
+    return {
+        type: 'object',
+        properties: {
+            slug: {
+                type: 'string',
+                description: `Optional task slug(s) to view. Controls output mode:
+
+TWO MODES:
+1. Overview (no slug): Returns list of ALL coordinator tasks
+   → Shows: slug, title, status, has_workflow
+   → Use for browsing available coordinator tasks
+
+2. Detail (with slug): Returns FULL task content for specified task(s)
+   → Shows: complete task content with references and metadata
+   → Supports multiple tasks: "phase-1,phase-2,phase-3"
+   → Use for viewing specific task details
+
+Examples:
+- Overview: {} → All coordinator tasks (minimal data)
+- Single task: { slug: "phase-1" } → Full content for phase-1
+- Multiple tasks: { slug: "phase-1,phase-2" } → Full content for both tasks
+
+NOTE: This tool ONLY works with coordinator tasks from /coordinator/active.md.
+For subagent tasks in /docs/ namespace, use view_subagent_task instead.`,
+            },
+        },
+        required: [],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=view-coordinator-task-schemas.js.map

package/dist/tools/schemas/view-coordinator-task-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-coordinator-task-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/view-coordinator-task-schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,SAAS,EAAE,EAAE,EAAG,kCAAkC;IAClD,gBAAgB,EAAE,wBAAwB,CAAE,mCAAmC;CACvE,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;;;;;;;;;;;;;;;;;;wEAkBmD;aACjE;SACF;QACD,QAAQ,EAAE,EAAE;QACZ,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tools/schemas/view-document-schemas.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Schema definitions for view_document tool
+ *
+ * This module defines the input validation schema for the view_document MCP tool,
+ * including parameter definitions, validation rules, and usage examples.
+ * The tool supports both single and multiple document viewing with optional
+ * linked document context loading.
+ */
+/**
+ * Input schema interface for view_document tool
+ *
+ * Defines the structure and validation rules for view_document tool parameters.
+ * Supports flexible document viewing with context loading from linked documents
+ * using the @ reference syntax.
+ *
+ * @example Basic document viewing
+ * ```typescript
+ * const basicInput = {
+ *   document: '/docs/api/authentication.md'
+ * };
+ * ```
+ *
+ * @example Multiple document viewing
+ * ```typescript
+ * const multiInput = {
+ *   document: ['/docs/api/auth.md', '/docs/api/users.md', '/docs/api/tokens.md']
+ * };
+ * ```
+ *
+ * @example Section-specific viewing
+ * ```typescript
+ * const sectionInput = {
+ *   document: '/docs/api/authentication.md',
+ *   section: 'jwt-tokens'  // or '#jwt-tokens'
+ * };
+ * ```
+ *
+ * @example Linked context loading
+ * ```typescript
+ * const linkedInput = {
+ *   document: '/docs/api/overview.md',
+ *   include_linked: true,
+ *   link_depth: 3  // Load links up to 3 levels deep
+ * };
+ * ```
+ *
+ * @example Hierarchical section addressing
+ * ```typescript
+ * const hierarchicalInput = {
+ *   document: '/docs/specs/api-design.md',
+ *   section: 'authentication/oauth/flows',
+ *   include_linked: true
+ * };
+ * ```
+ */
+export interface ViewDocumentInputSchema {
+    /** Schema type, always 'object' for MCP tools */
+    type: 'object';
+    /** Parameter definitions with validation and examples */
+    properties: {
+        /**
+         * Document path(s) to view
+         *
+         * Supports single document path as string or multiple documents as array.
+         * Paths should be absolute from document root and include .md extension.
+         *
+         * @example Single document
+         * "/docs/specs/authentication.md"
+         *
+         * @example Multiple documents
+         * ["/docs/specs/auth.md", "/docs/specs/users.md"]
+         *
+         * @example Namespace paths
+         * "/docs/api/specs/oauth-flows.md"
+         */
+        document: {
+            type: 'string' | 'array';
+            description: 'Document path(s) to view (e.g., "/docs/specs/auth-api.md" or ["/docs/specs/auth-api.md", "/docs/specs/user-api.md"] for multiple)';
+        };
+        /**
+         * Enable linked document context loading
+         *
+         * When true, automatically loads content from documents referenced
+         * using @ syntax (@/path/to/doc.md#section). Provides comprehensive
+         * context for understanding document relationships.
+         *
+         * @example Link syntax patterns
+         * "See @/docs/api/auth.md#tokens for details"
+         * "References: @/docs/specs/oauth.md and @/docs/guides/setup.md#config"
+         *
+         * @default false
+         */
+        include_linked: {
+            type: 'boolean';
+            description: 'Whether to load context from linked documents referenced via @ syntax';
+            default: false;
+        };
+        /**
+         * Maximum depth for recursive link loading
+         *
+         * Controls how many levels deep to follow @ references when
+         * include_linked is true. Higher values provide more context
+         * but increase processing time and response size.
+         *
+         * @example Depth behaviors
+         * - Depth 1: Load direct @ references only
+         * - Depth 2: Load references and their references
+         * - Depth 3+: Continue recursively up to limit
+         *
+         * @minimum 1
+         * @maximum 6
+         * @default 2
+         */
+        link_depth: {
+            type: 'number';
+            description: 'Maximum depth for recursive context loading from linked documents (1-6)';
+            minimum: 1;
+            maximum: 6;
+            default: 2;
+        };
+    };
+    /** Required parameters - only document path is mandatory */
+    required: ['document'];
+    /** Prevent additional properties for strict validation */
+    additionalProperties: false;
+}
+/**
+ * Schema constants for view_document tool
+ */
+export declare const VIEW_DOCUMENT_CONSTANTS: {
+    readonly LINK_DEPTH: {
+        readonly MIN: 1;
+        readonly MAX: 6;
+        readonly DEFAULT: 2;
+    };
+    readonly DEFAULTS: {
+        readonly INCLUDE_LINKED: false;
+    };
+    readonly MAX_DOCUMENTS: 5;
+};
+/**
+ * Helper functions for document parsing
+ */
+export declare function parseDocuments(document: string | string[]): string[];
+export declare function normalizePath(path: string): string;
+export declare function validateDocumentCount(documents: string[]): boolean;
+export declare function isValidLinkDepth(depth: number): boolean;
+/**
+ * Get the input schema for view_document tool
+ */
+export declare function getViewDocumentSchema(): ViewDocumentInputSchema;
+//# sourceMappingURL=view-document-schemas.d.ts.map

package/dist/tools/schemas/view-document-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-document-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/view-document-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,WAAW,uBAAuB;IACtC,iDAAiD;IACjD,IAAI,EAAE,QAAQ,CAAC;IAEf,yDAAyD;IACzD,UAAU,EAAE;QACV;;;;;;;;;;;;;;WAcG;QACH,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;YACzB,WAAW,EAAE,mIAAmI,CAAC;SAClJ,CAAC;QAEF;;;;;;;;;;;;WAYG;QACH,cAAc,EAAE;YACd,IAAI,EAAE,SAAS,CAAC;YAChB,WAAW,EAAE,uEAAuE,CAAC;YACrF,OAAO,EAAE,KAAK,CAAC;SAChB,CAAC;QAEF;;;;;;;;;;;;;;;WAeG;QACH,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,yEAAyE,CAAC;YACvF,OAAO,EAAE,CAAC,CAAC;YACX,OAAO,EAAE,CAAC,CAAC;YACX,OAAO,EAAE,CAAC,CAAC;SACZ,CAAC;KACH,CAAC;IAEF,4DAA4D;IAC5D,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC;IAEvB,0DAA0D;IAC1D,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;CAU1B,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAKpE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAElE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,uBAAuB,CAwB/D"}

package/dist/tools/schemas/view-document-schemas.js

@@ -0,0 +1,70 @@
+/**
+ * Schema definitions for view_document tool
+ *
+ * This module defines the input validation schema for the view_document MCP tool,
+ * including parameter definitions, validation rules, and usage examples.
+ * The tool supports both single and multiple document viewing with optional
+ * linked document context loading.
+ */
+/**
+ * Schema constants for view_document tool
+ */
+export const VIEW_DOCUMENT_CONSTANTS = {
+    LINK_DEPTH: {
+        MIN: 1,
+        MAX: 6,
+        DEFAULT: 2,
+    },
+    DEFAULTS: {
+        INCLUDE_LINKED: false,
+    },
+    MAX_DOCUMENTS: 5, // Limit for multiple document viewing
+};
+/**
+ * Helper functions for document parsing
+ */
+export function parseDocuments(document) {
+    if (Array.isArray(document)) {
+        return document.map(normalizePath);
+    }
+    return [normalizePath(document)];
+}
+export function normalizePath(path) {
+    return path.startsWith('/') ? path : `/${path}`;
+}
+export function validateDocumentCount(documents) {
+    return documents.length > 0 && documents.length <= VIEW_DOCUMENT_CONSTANTS.MAX_DOCUMENTS;
+}
+export function isValidLinkDepth(depth) {
+    return depth >= VIEW_DOCUMENT_CONSTANTS.LINK_DEPTH.MIN &&
+        depth <= VIEW_DOCUMENT_CONSTANTS.LINK_DEPTH.MAX;
+}
+/**
+ * Get the input schema for view_document tool
+ */
+export function getViewDocumentSchema() {
+    return {
+        type: 'object',
+        properties: {
+            document: {
+                type: 'string',
+                description: 'Document path(s) to view (e.g., "/docs/specs/auth-api.md" or ["/docs/specs/auth-api.md", "/docs/specs/user-api.md"] for multiple)',
+            },
+            include_linked: {
+                type: 'boolean',
+                description: 'Whether to load context from linked documents referenced via @ syntax',
+                default: VIEW_DOCUMENT_CONSTANTS.DEFAULTS.INCLUDE_LINKED,
+            },
+            link_depth: {
+                type: 'number',
+                description: 'Maximum depth for recursive context loading from linked documents (1-6)',
+                minimum: VIEW_DOCUMENT_CONSTANTS.LINK_DEPTH.MIN,
+                maximum: VIEW_DOCUMENT_CONSTANTS.LINK_DEPTH.MAX,
+                default: VIEW_DOCUMENT_CONSTANTS.LINK_DEPTH.DEFAULT,
+            },
+        },
+        required: ['document'],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=view-document-schemas.js.map

package/dist/tools/schemas/view-document-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-document-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/view-document-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8HH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,UAAU,EAAE;QACV,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,OAAO,EAAE,CAAC;KACX;IACD,QAAQ,EAAE;QACR,cAAc,EAAE,KAAK;KACtB;IACD,aAAa,EAAE,CAAC,EAAG,sCAAsC;CACjD,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAA2B;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,SAAmB;IACvD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,IAAI,uBAAuB,CAAC,aAAa,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK,IAAI,uBAAuB,CAAC,UAAU,CAAC,GAAG;QAC/C,KAAK,IAAI,uBAAuB,CAAC,UAAU,CAAC,GAAG,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mIAAmI;aACjJ;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,uEAAuE;gBACpF,OAAO,EAAE,uBAAuB,CAAC,QAAQ,CAAC,cAAc;aACzD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yEAAyE;gBACtF,OAAO,EAAE,uBAAuB,CAAC,UAAU,CAAC,GAAG;gBAC/C,OAAO,EAAE,uBAAuB,CAAC,UAAU,CAAC,GAAG;gBAC/C,OAAO,EAAE,uBAAuB,CAAC,UAAU,CAAC,OAAO;aACpD;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tools/schemas/view-section-schemas.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Schema definitions for view_section tool
+ */
+export interface ViewSectionInputSchema {
+    type: 'object';
+    properties: {
+        document: {
+            type: 'string';
+            description: string;
+        };
+    };
+    required: ['document'];
+    additionalProperties: false;
+}
+/**
+ * Schema constants for view_section tool
+ */
+export declare const VIEW_SECTION_CONSTANTS: {
+    readonly MAX_SECTIONS: 10;
+};
+/**
+ * Helper functions for section validation
+ */
+export declare function normalizeSection(section: string): string;
+export declare function parseSections(section: string | string[]): string[];
+export declare function validateSectionCount(sections: string[]): boolean;
+/**
+ * Get the input schema for view_section tool
+ */
+export declare function getViewSectionSchema(): ViewSectionInputSchema;
+//# sourceMappingURL=view-section-schemas.d.ts.map

package/dist/tools/schemas/view-section-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-section-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/view-section-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC;IACvB,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;;CAEzB,CAAC;AAEX;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAKlE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,sBAAsB,CA2B7D"}

package/dist/tools/schemas/view-section-schemas.js

@@ -0,0 +1,56 @@
+/**
+ * Schema definitions for view_section tool
+ */
+/**
+ * Schema constants for view_section tool
+ */
+export const VIEW_SECTION_CONSTANTS = {
+    MAX_SECTIONS: 10, // Limit for multiple section viewing
+};
+/**
+ * Helper functions for section validation
+ */
+export function normalizeSection(section) {
+    return section.startsWith('#') ? section : `#${section}`;
+}
+export function parseSections(section) {
+    if (Array.isArray(section)) {
+        return section.map(normalizeSection);
+    }
+    return [normalizeSection(section)];
+}
+export function validateSectionCount(sections) {
+    return sections.length > 0 && sections.length <= VIEW_SECTION_CONSTANTS.MAX_SECTIONS;
+}
+/**
+ * Get the input schema for view_section tool
+ */
+export function getViewSectionSchema() {
+    return {
+        type: 'object',
+        properties: {
+            document: {
+                type: 'string',
+                description: `Document path with optional section slug(s).
+
+TWO MODES:
+1. Overview: "/docs/api/auth.md"
+   → Returns list of ALL sections with slug, title, and depth (no content)
+   → Use for browsing document structure
+
+2. Detail: "/docs/api/auth.md#endpoints"
+   → Returns FULL section content for the specified section
+   → Supports multiple sections: "/docs/api/auth.md#endpoints,authentication,errors"
+   → Use for viewing specific section details
+
+Examples:
+- Overview: "/docs/api/auth.md" → All sections (titles only)
+- Single detail: "/docs/api/auth.md#endpoints" → Full section content
+- Multiple detail: "/docs/api/auth.md#endpoints,auth" → Multiple full contents`,
+            },
+        },
+        required: ['document'],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=view-section-schemas.js.map

package/dist/tools/schemas/view-section-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-section-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/view-section-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,EAAE,EAAG,qCAAqC;CAChD,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA0B;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAkB;IACrD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,IAAI,sBAAsB,CAAC,YAAY,CAAC;AACvF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;;;;;;;;;;;;;;;+EAe0D;aACxE;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tools/schemas/view-subagent-task-schemas.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Schema definitions for view_subagent_task tool
+ */
+export interface ViewSubagentTaskInputSchema {
+    type: 'object';
+    properties: {
+        document: {
+            type: 'string';
+            description: string;
+        };
+    };
+    required: ['document'];
+    additionalProperties: false;
+}
+/**
+ * Schema constants for view_subagent_task tool
+ */
+export declare const VIEW_SUBAGENT_TASK_CONSTANTS: {
+    readonly MAX_TASKS: 10;
+};
+/**
+ * Helper functions for task validation
+ */
+export declare function normalizeTask(task: string): string;
+export declare function parseTasks(task: string | string[]): string[];
+export declare function validateTaskCount(tasks: string[]): boolean;
+/**
+ * Get the input schema for view_subagent_task tool
+ */
+export declare function getViewSubagentTaskSchema(): ViewSubagentTaskInputSchema;
+//# sourceMappingURL=view-subagent-task-schemas.d.ts.map

package/dist/tools/schemas/view-subagent-task-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-subagent-task-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/view-subagent-task-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC;IACvB,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AAEX;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAK5D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,2BAA2B,CAoCvE"}