@venizia/ignis-docs 0.0.1-1 → 0.0.1-10

package/dist/mcp-server/index.js.map

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

package/{mcp-server/dist → dist/mcp-server}/tools/base.tool.d.ts

@@ -1,13 +1,9 @@
-import { createTool } from "@mastra/core/tools";
-import type { z } from "zod";
+import { createTool } from '@mastra/core/tools';
+import type { z } from 'zod';
 /**
  * The tool type returned by createTool.
  */
 export type TMastraTool = ReturnType<typeof createTool>;
-/**
- * Re-export createTool for use in subclasses.
- */
-export { createTool };
 /**
  * Abstract base class for all MCP documentation tools.
  *
@@ -27,11 +23,11 @@ export { createTool };
  *   readonly inputSchema = InputSchema;
  *   readonly outputSchema = OutputSchema;
  *
- *   async execute(input: z.infer<typeof InputSchema>) {
+ *   async execute(opts: z.infer<typeof InputSchema>) {
  *     return { result: 'done' };
  *   }
  *
- *   toMastraTool() {
+ *   getTool() {
  *     return createTool({
  *       id: this.id,
  *       description: this.description,
@@ -43,7 +39,7 @@ export { createTool };
  * }
  * ```
  */
-export declare abstract class BaseTool<TInputSchema extends z.ZodType = z.ZodType, TOutputSchema extends z.ZodType = z.ZodType> {
+export declare abstract class BaseTool<TInputSchema extends z.ZodType, TOutputSchema extends z.ZodType> {
     /**
      * Unique identifier for the tool.
      * Used by MCP clients to invoke the tool.
@@ -70,10 +66,10 @@ export declare abstract class BaseTool<TInputSchema extends z.ZodType = z.ZodTyp
     /**
      * Executes the tool's main logic.
      *
-     * @param input - Validated input matching inputSchema
+     * @param opts - Validated options object matching inputSchema
      * @returns Promise resolving to output matching outputSchema
      */
-    abstract execute(input: z.infer<TInputSchema>): Promise<z.infer<TOutputSchema>>;
+    abstract execute(opts: z.infer<TInputSchema>): Promise<z.infer<TOutputSchema>>;
     /**
      * Converts this tool instance to a Mastra-compatible tool object.
      * Must be implemented by each subclass to ensure proper type inference.
@@ -82,7 +78,7 @@ export declare abstract class BaseTool<TInputSchema extends z.ZodType = z.ZodTyp
      *
      * @example
      * ```typescript
-     * toMastraTool() {
+     * getTool() {
      *   return createTool({
      *     id: this.id,
      *     description: this.description,

package/dist/mcp-server/tools/base.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.tool.d.ts","sourceRoot":"","sources":["../../../mcp-server/tools/base.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAMxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,8BAAsB,QAAQ,CAAC,YAAY,SAAS,CAAC,CAAC,OAAO,EAAE,aAAa,SAAS,CAAC,CAAC,OAAO;IAC5F;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IAE9C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAE9E;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,OAAO,IAAI,WAAW;CAChC"}

package/{mcp-server/dist → dist/mcp-server}/tools/base.tool.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseTool = exports.createTool = void 0;
-const tools_1 = require("@mastra/core/tools");
-Object.defineProperty(exports, "createTool", { enumerable: true, get: function () { return tools_1.createTool; } });
+exports.BaseTool = void 0;
 // ============================================================================
 // BASE TOOL CLASS
 // ============================================================================
@@ -25,11 +23,11 @@ Object.defineProperty(exports, "createTool", { enumerable: true, get: function (
  *   readonly inputSchema = InputSchema;
  *   readonly outputSchema = OutputSchema;
  *
- *   async execute(input: z.infer<typeof InputSchema>) {
+ *   async execute(opts: z.infer<typeof InputSchema>) {
  *     return { result: 'done' };
  *   }
  *
- *   toMastraTool() {
+ *   getTool() {
  *     return createTool({
  *       id: this.id,
  *       description: this.description,

package/dist/mcp-server/tools/base.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.tool.js","sourceRoot":"","sources":["../../../mcp-server/tools/base.tool.ts"],"names":[],"mappings":";;;AAYA,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAsB,QAAQ;CAwD7B;AAxDD,4BAwDC"}

package/{mcp-server/dist/tools/get-doc-content.tool.d.ts → dist/mcp-server/tools/docs/get-document-content.tool.d.ts}

@@ -1,30 +1,26 @@
-import { z } from "zod";
-import { BaseTool, type TMastraTool } from "./base.tool";
+import { z } from 'zod';
+import { BaseTool, TMastraTool } from '../base.tool';
 declare const InputSchema: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;
-declare const OutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+declare const OutputSchema: z.ZodObject<{
     id: z.ZodString;
-    content: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    id: z.ZodString;
-    error: z.ZodString;
-}, z.core.$strip>]>;
+    content: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare class GetDocContentTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
-    readonly id = "getDocContent";
+    readonly id = "getDocumentContent";
     readonly description = "\nRetrieves the complete markdown content of a specific Ignis Framework documentation file.\n\nPURPOSE:\nUse this tool to fetch the full text of a documentation page when you need detailed information\nbeyond what search snippets provide. This is your primary tool for reading documentation content.\n\nWHEN TO USE:\n- After searchDocs returns relevant results and you need full content\n- When user asks for detailed explanation of a specific topic\n- To read code examples, API references, or configuration guides\n- When you need to quote or reference specific documentation sections\n\nWHEN NOT TO USE:\n- Don't use this for discovery - use searchDocs or listDocs first\n- Don't fetch multiple documents blindly - review search results first\n\nDOCUMENT ID FORMAT:\nThe 'id' parameter is the relative file path from the wiki root:\n- \"get-started/quickstart.md\" - Quickstart guide\n- \"references/components/http-server.md\" - HTTP Server component reference\n- \"get-started/core-concepts/dependency-injection.md\" - DI concepts\n\nHOW TO GET VALID IDs:\n1. Use searchDocs to find documents by keyword\n2. Use listDocs to browse all available documents\n3. Use listCategories + listDocs(category) for structured browsing\n\nOUTPUT:\nReturns full markdown content suitable for:\n- Answering user questions with accurate information\n- Extracting code examples\n- Understanding API usage patterns\n- Providing step-by-step guidance\n";
     readonly inputSchema: z.ZodObject<{
         id: z.ZodString;
     }, z.core.$strip>;
-    readonly outputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    readonly outputSchema: z.ZodObject<{
         id: z.ZodString;
-        content: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        id: z.ZodString;
-        error: z.ZodString;
-    }, z.core.$strip>]>;
-    execute(input: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+        content: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    execute(opts: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
     getTool(): TMastraTool;
 }
 export {};
-//# sourceMappingURL=get-doc-content.tool.d.ts.map
+//# sourceMappingURL=get-document-content.tool.d.ts.map

package/dist/mcp-server/tools/docs/get-document-content.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document-content.tool.d.ts","sourceRoot":"","sources":["../../../../mcp-server/tools/docs/get-document-content.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAqFrD,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;iBAOhB,CAAC;AAMH,qBAAa,iBAAkB,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IACtF,QAAQ,CAAC,EAAE,wBAAwB;IACnC,QAAQ,CAAC,WAAW,o6CAAoB;IACxC,QAAQ,CAAC,WAAW;;sBAAe;IACnC,QAAQ,CAAC,YAAY;;;;sBAAgB;IAE/B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IAUvF,OAAO,IAAI,WAAW;CASvB"}

package/{mcp-server/dist/tools/get-doc-content.tool.js → dist/mcp-server/tools/docs/get-document-content.tool.js}

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetDocContentTool = void 0;
+const tools_1 = require("@mastra/core/tools");
 const zod_1 = require("zod");
-const helpers_1 = require("../helpers");
-const base_tool_1 = require("./base.tool");
+const base_tool_1 = require("../base.tool");
+const helpers_1 = require("../../../mcp-server/helpers");
 // ----------------------------------------------------------------------------
 // DESCRIPTIONS
 // ----------------------------------------------------------------------------
@@ -81,47 +82,44 @@ TYPICAL STRUCTURE:
 // ----------------------------------------------------------------------------
 // SCHEMAS
 // ----------------------------------------------------------------------------
-const SuccessSchema = zod_1.z.object({
-    id: zod_1.z.string().describe("The document ID that was requested."),
-    content: zod_1.z.string().describe(CONTENT_DESCRIPTION),
-});
-const ErrorSchema = zod_1.z.object({
-    id: zod_1.z.string().describe("The document ID that was requested but not found."),
-    error: zod_1.z.string().describe("Error message. Verify the ID using listDocs or searchDocs."),
-});
 const InputSchema = zod_1.z.object({
     id: zod_1.z.string().min(1).describe(ID_DESCRIPTION),
 });
-const OutputSchema = zod_1.z
-    .union([SuccessSchema, ErrorSchema])
-    .describe("Document content on success, or error object if not found.");
+const OutputSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('The document ID that was requested.'),
+    content: zod_1.z.string().optional().describe(CONTENT_DESCRIPTION),
+    error: zod_1.z
+        .string()
+        .optional()
+        .describe('Error message if document not found. Verify the ID using listDocs or searchDocs.'),
+});
 // ----------------------------------------------------------------------------
 // TOOL CLASS
 // ----------------------------------------------------------------------------
 class GetDocContentTool extends base_tool_1.BaseTool {
     constructor() {
         super(...arguments);
-        this.id = "getDocContent";
+        this.id = 'getDocumentContent';
         this.description = TOOL_DESCRIPTION;
         this.inputSchema = InputSchema;
         this.outputSchema = OutputSchema;
     }
-    async execute(input) {
-        const content = await helpers_1.DocsHelper.getDocContent({ id: input.id });
+    async execute(opts) {
+        const content = await helpers_1.DocsHelper.getDocumentContent({ id: opts.id });
         if (!content) {
-            return { error: "Document not found", id: input.id };
+            return { error: 'Document not found', id: opts.id };
         }
-        return { content, id: input.id };
+        return { content, id: opts.id };
     }
     getTool() {
-        return (0, base_tool_1.createTool)({
+        return (0, tools_1.createTool)({
             id: this.id,
             description: this.description,
-            inputSchema: InputSchema,
-            outputSchema: OutputSchema,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
             execute: async ({ context }) => this.execute(context),
         });
     }
 }
 exports.GetDocContentTool = GetDocContentTool;
-//# sourceMappingURL=get-doc-content.tool.js.map
+//# sourceMappingURL=get-document-content.tool.js.map

package/dist/mcp-server/tools/docs/get-document-content.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document-content.tool.js","sourceRoot":"","sources":["../../../../mcp-server/tools/docs/get-document-content.tool.ts"],"names":[],"mappings":";;;AAAA,8CAAgD;AAChD,6BAAwB;AACxB,4CAAqD;AACrD,kDAAkD;AAElD,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCxB,CAAC;AAEF,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;CAmBtB,CAAC;AAEF,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;CAe3B,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;CAC/C,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC9D,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC5D,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kFAAkF,CAAC;CAChG,CAAC,CAAC;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,iBAAkB,SAAQ,oBAAiD;IAAxF;;QACW,OAAE,GAAG,oBAAoB,CAAC;QAC1B,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,gBAAW,GAAG,WAAW,CAAC;QAC1B,iBAAY,GAAG,YAAY,CAAC;IAqBvC,CAAC;IAnBC,KAAK,CAAC,OAAO,CAAC,IAAiC;QAC7C,MAAM,OAAO,GAAG,MAAM,oBAAU,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAErE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QACtD,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAClC,CAAC;IAED,OAAO;QACL,OAAO,IAAA,kBAAU,EAAC;YAChB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF;AAzBD,8CAyBC"}

package/{mcp-server/dist/tools/get-doc-metadata.tool.d.ts → dist/mcp-server/tools/docs/get-document-metadata.tool.d.ts}

@@ -1,40 +1,36 @@
-import { z } from "zod";
-import { BaseTool, type TMastraTool } from "./base.tool";
+import { z } from 'zod';
+import { BaseTool, TMastraTool } from '../base.tool';
 declare const InputSchema: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;
-declare const OutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+declare const OutputSchema: z.ZodObject<{
     id: z.ZodString;
-    title: z.ZodString;
-    category: z.ZodString;
-    wordCount: z.ZodNumber;
-    charCount: z.ZodNumber;
-    lastModified: z.ZodOptional<z.ZodDate>;
+    title: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    wordCount: z.ZodOptional<z.ZodNumber>;
+    charCount: z.ZodOptional<z.ZodNumber>;
+    lastModified: z.ZodOptional<z.ZodString>;
     size: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, z.ZodObject<{
-    id: z.ZodString;
-    error: z.ZodString;
-}, z.core.$strip>]>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare class GetDocMetadataTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
-    readonly id = "getDocMetadata";
+    readonly id = "getDocumentMetadata";
     readonly description = "\nRetrieves statistical metadata about a specific Ignis Framework documentation file\nwithout fetching its full content.\n\nPURPOSE:\nUse this tool to get information ABOUT a document (size, word count, last modified)\nwithout retrieving the actual content. Useful for assessing documents before reading them fully.\n\nWHEN TO USE:\n- To check document length before fetching full content\n- To estimate reading time or complexity\n- To verify a document exists and get basic info\n- To check when documentation was last updated\n- When you need document stats for comparison or reporting\n\nWHEN NOT TO USE:\n- When you need the actual document content (use getDocContent instead)\n- For searching documents (use searchDocs instead)\n- For listing multiple documents (use listDocs instead)\n\nMETADATA FIELDS EXPLAINED:\n- wordCount: Total words in content body (excludes frontmatter)\n  - Quick read: < 500 words\n  - Medium: 500-1500 words\n  - Long/detailed: > 1500 words\n\n- charCount: Total characters (useful for token estimation)\n  - Rough token estimate: charCount / 4 for English text\n\n- lastModified: File modification timestamp\n  - Recent = actively maintained documentation\n  - Old = may need verification for accuracy\n\n- size: Raw file size in bytes (includes frontmatter YAML)\n\nUSE CASES:\n1. \"Is this document long?\" \u2192 Check wordCount\n2. \"Will this fit in context?\" \u2192 Check charCount, estimate tokens\n3. \"Is this documentation current?\" \u2192 Check lastModified\n4. \"Which document is more detailed?\" \u2192 Compare wordCounts\n";
     readonly inputSchema: z.ZodObject<{
         id: z.ZodString;
     }, z.core.$strip>;
-    readonly outputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    readonly outputSchema: z.ZodObject<{
         id: z.ZodString;
-        title: z.ZodString;
-        category: z.ZodString;
-        wordCount: z.ZodNumber;
-        charCount: z.ZodNumber;
-        lastModified: z.ZodOptional<z.ZodDate>;
+        title: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        wordCount: z.ZodOptional<z.ZodNumber>;
+        charCount: z.ZodOptional<z.ZodNumber>;
+        lastModified: z.ZodOptional<z.ZodString>;
         size: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>, z.ZodObject<{
-        id: z.ZodString;
-        error: z.ZodString;
-    }, z.core.$strip>]>;
-    execute(input: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    execute(opts: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
     getTool(): TMastraTool;
 }
 export {};
-//# sourceMappingURL=get-doc-metadata.tool.d.ts.map
+//# sourceMappingURL=get-document-metadata.tool.d.ts.map

package/dist/mcp-server/tools/docs/get-document-metadata.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document-metadata.tool.d.ts","sourceRoot":"","sources":["../../../../mcp-server/tools/docs/get-document-metadata.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAyErD,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;iBAmBhB,CAAC;AAMH,qBAAa,kBAAmB,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IACvF,QAAQ,CAAC,EAAE,yBAAyB;IACpC,QAAQ,CAAC,WAAW,6iDAAoB;IACxC,QAAQ,CAAC,WAAW;;sBAAe;IACnC,QAAQ,CAAC,YAAY;;;;;;;;;sBAAgB;IAE/B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IAavF,OAAO,IAAI,WAAW;CASvB"}

package/{mcp-server/dist/tools/get-doc-metadata.tool.js → dist/mcp-server/tools/docs/get-document-metadata.tool.js}

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetDocMetadataTool = void 0;
+const tools_1 = require("@mastra/core/tools");
 const zod_1 = require("zod");
-const helpers_1 = require("../helpers");
-const base_tool_1 = require("./base.tool");
+const base_tool_1 = require("../base.tool");
+const helpers_1 = require("../../../mcp-server/helpers");
 // ----------------------------------------------------------------------------
 // DESCRIPTIONS
 // ----------------------------------------------------------------------------
@@ -70,52 +71,59 @@ IMPORTANT:
 // ----------------------------------------------------------------------------
 // SCHEMAS
 // ----------------------------------------------------------------------------
-const SuccessSchema = zod_1.z.object({
-    id: zod_1.z.string().describe("The document ID that was requested."),
-    title: zod_1.z.string().describe("Document title from frontmatter or filename."),
-    category: zod_1.z.string().describe('Document category (e.g., "Getting Started", "References").'),
-    wordCount: zod_1.z.number().int().describe("Total words. Useful for reading time estimation."),
-    charCount: zod_1.z.number().int().describe("Total characters. Useful for token estimation."),
-    lastModified: zod_1.z.date().optional().describe("Last modified timestamp. May be undefined."),
-    size: zod_1.z.number().int().optional().describe("File size in bytes. May be undefined."),
-});
-const ErrorSchema = zod_1.z.object({
-    id: zod_1.z.string().describe("The document ID that was requested but not found."),
-    error: zod_1.z.string().describe("Error message indicating the document was not found."),
-});
 const InputSchema = zod_1.z.object({
     id: zod_1.z.string().min(1).describe(ID_DESCRIPTION),
 });
-const OutputSchema = zod_1.z
-    .union([SuccessSchema, ErrorSchema])
-    .describe("Document metadata on success, or error object if not found.");
+const OutputSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('The document ID that was requested.'),
+    title: zod_1.z.string().optional().describe('Document title from frontmatter or filename.'),
+    category: zod_1.z
+        .string()
+        .optional()
+        .describe('Document category (e.g., "Getting Started", "References").'),
+    wordCount: zod_1.z
+        .number()
+        .int()
+        .optional()
+        .describe('Total words. Useful for reading time estimation.'),
+    charCount: zod_1.z.number().int().optional().describe('Total characters. Useful for token estimation.'),
+    lastModified: zod_1.z
+        .string()
+        .optional()
+        .describe('Last modified timestamp (ISO string). May be undefined.'),
+    size: zod_1.z.number().int().optional().describe('File size in bytes. May be undefined.'),
+    error: zod_1.z.string().optional().describe('Error message if document not found.'),
+});
 // ----------------------------------------------------------------------------
 // TOOL CLASS
 // ----------------------------------------------------------------------------
 class GetDocMetadataTool extends base_tool_1.BaseTool {
     constructor() {
         super(...arguments);
-        this.id = "getDocMetadata";
+        this.id = 'getDocumentMetadata';
         this.description = TOOL_DESCRIPTION;
         this.inputSchema = InputSchema;
         this.outputSchema = OutputSchema;
     }
-    async execute(input) {
-        const metadata = await helpers_1.DocsHelper.getDocMetadata({ id: input.id });
+    async execute(opts) {
+        const metadata = await helpers_1.DocsHelper.getDocumentMetadata({ id: opts.id });
         if (!metadata) {
-            return { error: "Document not found", id: input.id };
+            return { error: 'Document not found', id: opts.id };
         }
-        return metadata;
+        return {
+            ...metadata,
+            lastModified: metadata.lastModified?.toISOString(),
+        };
     }
     getTool() {
-        return (0, base_tool_1.createTool)({
+        return (0, tools_1.createTool)({
             id: this.id,
             description: this.description,
-            inputSchema: InputSchema,
-            outputSchema: OutputSchema,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
             execute: async ({ context }) => this.execute(context),
         });
     }
 }
 exports.GetDocMetadataTool = GetDocMetadataTool;
-//# sourceMappingURL=get-doc-metadata.tool.js.map
+//# sourceMappingURL=get-document-metadata.tool.js.map

package/dist/mcp-server/tools/docs/get-document-metadata.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document-metadata.tool.js","sourceRoot":"","sources":["../../../../mcp-server/tools/docs/get-document-metadata.tool.ts"],"names":[],"mappings":";;;AAAA,8CAAgD;AAChD,6BAAwB;AACxB,4CAAqD;AACrD,kDAAkD;AAElD,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCxB,CAAC;AAEF,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;CAkBtB,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;CAC/C,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC9D,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACrF,QAAQ,EAAE,OAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;IACzE,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IACjG,YAAY,EAAE,OAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACnF,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CAC9E,CAAC,CAAC;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,kBAAmB,SAAQ,oBAAiD;IAAzF;;QACW,OAAE,GAAG,qBAAqB,CAAC;QAC3B,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,gBAAW,GAAG,WAAW,CAAC;QAC1B,iBAAY,GAAG,YAAY,CAAC;IAwBvC,CAAC;IAtBC,KAAK,CAAC,OAAO,CAAC,IAAiC;QAC7C,MAAM,QAAQ,GAAG,MAAM,oBAAU,CAAC,mBAAmB,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAEvE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QACtD,CAAC;QAED,OAAO;YACL,GAAG,QAAQ;YACX,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE;SACnD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,IAAA,kBAAU,EAAC;YAChB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF;AA5BD,gDA4BC"}

package/dist/mcp-server/tools/docs/get-package-overview.tool.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { BaseTool, TMastraTool } from '../base.tool';
+declare const InputSchema: z.ZodObject<{
+    packageName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    packages: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        npmName: z.ZodString;
+        description: z.ZodString;
+        directories: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            purpose: z.ZodString;
+        }, z.core.$strip>>;
+        content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare class GetPackageOverviewTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
+    readonly id = "getPackageOverview";
+    readonly description = "\nReturns an overview of Ignis packages from the source details documentation.\n\nPURPOSE:\nProvides AI agents with comprehensive understanding of the Ignis monorepo structure,\npackage purposes, main exports, and directory layouts. This is essential for helping\nusers understand which package to use for specific features.\n\nWHEN TO USE:\n- When user asks \"what packages does Ignis have?\"\n- When user needs to understand project structure\n- When user asks which package provides a specific feature\n- Before helping user implement a feature (to know where code should go)\n- When user asks about imports or package dependencies\n\nWHEN NOT TO USE:\n- For specific API documentation (use getDocContent with references/ docs)\n- For code examples (use searchCode or getDocContent)\n- For troubleshooting (use searchDocs)\n\nOUTPUT:\nReturns package name, description, main directories, and key components.\nThe content comes from wiki/references/src-details/ documentation.\n";
+    readonly inputSchema: z.ZodObject<{
+        packageName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        packages: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            npmName: z.ZodString;
+            description: z.ZodString;
+            directories: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                purpose: z.ZodString;
+            }, z.core.$strip>>;
+            content: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    /**
+     * Extracts package description from first paragraph after title
+     */
+    private extractDescription;
+    /**
+     * Extracts directory table from markdown content
+     */
+    private extractDirectories;
+    execute(opts: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+    getTool(): TMastraTool;
+}
+export {};
+//# sourceMappingURL=get-package-overview.tool.d.ts.map

package/dist/mcp-server/tools/docs/get-package-overview.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-package-overview.tool.d.ts","sourceRoot":"","sources":["../../../../mcp-server/tools/docs/get-package-overview.tool.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAgErD,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;iBAGhB,CAAC;AAmBH,qBAAa,sBAAuB,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IAC3F,QAAQ,CAAC,EAAE,wBAAwB;IACnC,QAAQ,CAAC,WAAW,09BAAoB;IACxC,QAAQ,CAAC,WAAW;;sBAAe;IACnC,QAAQ,CAAC,YAAY;;;;;;;;;;;;sBAAgB;IAErC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0CpB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IAuDvF,OAAO,IAAI,WAAW;CASvB"}