igniral-mcp-server 1.0.4

package/dist/index.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+/**
+ * Igniral MCP Server — Entry Point
+ *
+ * A Model Context Protocol server that bridges AI agents (Claude, Cursor, etc.)
+ * with Igniral's backend microservices for dynamic API creation and management.
+ *
+ * Transport: stdio (standard for IDE integrations like Cursor and Claude Desktop)
+ *
+ * Tools exposed:
+ * 1. igniral_generate_schema_from_prompt — Auto-generate a complete app from description
+ * 2. igniral_create_application — Create an empty app shell manually
+ * 3. igniral_create_dynamic_endpoint — Add endpoints to an existing app
+ * 4. igniral_list_applications — List the user's existing applications
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { loadConfig } from "./config.js";
+import { IgniralClient } from "./api/igniral-client.js";
+import { executeGenerateSchema } from "./tools/generate-schema.js";
+import { executeCreateApplication } from "./tools/create-application.js";
+import { executeCreateEndpoint } from "./tools/create-endpoint.js";
+import { executeListApplications } from "./tools/list-applications.js";
+// ─── Bootstrap ──────────────────────────────────────────────────────────
+let config;
+let client;
+try {
+    config = loadConfig();
+    client = new IgniralClient(config);
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\n✖ ${message}\n`);
+    console.error("Tip: Pass credentials via environment variables when configuring your MCP client:");
+    console.error('  "env": { "IGNIRAL_CLIENT_ID": "...", "IGNIRAL_CLIENT_SECRET": "..." }\n');
+    console.error("Get your Agent API Key at: https://igniral.com\n");
+    process.exit(1);
+}
+const server = new McpServer({
+    name: "igniral-mcp-server",
+    version: "1.0.2",
+});
+// ─── Tool 1: Generate Schema from Prompt ────────────────────────────────
+server.tool("igniral_generate_schema_from_prompt", `Generates a complete application from a natural language description. 
+This tool creates the application, ALL endpoints with their JSON schemas, 
+roles, and permissions automatically. 
+
+Use this when the user gives a general or ambiguous instruction like 
+"build me a gym management app" or "create an API for a restaurant".
+
+You do NOT need to call igniral_create_application or 
+igniral_create_dynamic_endpoint after this — everything is created 
+automatically. This may take 30-90 seconds to complete.
+
+Returns the applicationId and a summary of what was created.`, {
+    prompt: z
+        .string()
+        .describe("Natural language description of the application to generate. " +
+        "Be as detailed as possible about what the app should do and " +
+        "what data it should manage. Minimum 10 characters."),
+}, async ({ prompt }) => {
+    const result = await executeGenerateSchema(client, { prompt });
+    return { content: [{ type: "text", text: result }] };
+});
+// ─── Tool 2: Create Application ─────────────────────────────────────────
+server.tool("igniral_create_application", `Creates an empty application shell (without endpoints). 
+Use this when the user wants to manually build an application step by step, 
+providing a specific name, description, and settings.
+
+After creating the application, use igniral_create_dynamic_endpoint to add 
+API endpoints one by one. Returns the applicationId needed for creating endpoints.
+
+Do NOT use this after igniral_generate_schema_from_prompt — that tool 
+already creates the application automatically.`, {
+    name: z.string().describe("Name of the application (e.g., 'GymApp', 'Pet Store API')"),
+    description: z.string().describe("Description of what the application does"),
+    version: z.string().optional().describe("API version (default: 'v1')"),
+    subdomain: z
+        .string()
+        .optional()
+        .describe("Custom subdomain for the API (lowercase, hyphens allowed). " +
+        "If not provided, one is generated automatically."),
+    aiGeneratedContext: z
+        .string()
+        .optional()
+        .describe("AI-generated context/documentation for the application"),
+    isPrivate: z
+        .boolean()
+        .optional()
+        .describe("Whether the app is private (default: true). " +
+        "Private apps require authentication for all endpoints. " +
+        "Public apps can have some endpoints visible without auth."),
+}, async (params) => {
+    const result = await executeCreateApplication(client, params);
+    return { content: [{ type: "text", text: result }] };
+});
+// ─── Tool 3: Create Dynamic Endpoint ────────────────────────────────────
+server.tool("igniral_create_dynamic_endpoint", `Creates a dynamic API endpoint within an existing application. 
+Requires an applicationId from a previous igniral_create_application call. 
+
+Use this iteratively to add all needed endpoints to the application. 
+Each endpoint defines its data schema (JSON Schema format), HTTP methods, 
+visibility (PUBLIC/PRIVATE), and security policy.
+
+Security policies:
+- NONE: Anyone with role permissions sees all data
+- OWNER_ONLY: Users only see data they created (most common for personal data)
+- CLAIM_FILTER: Filter data based on JWT claims (requires securityConfig)`, {
+    applicationId: z.string().describe("ID of the application to add the endpoint to"),
+    endpointPath: z
+        .string()
+        .describe("URL path for the endpoint (e.g., '/products', '/users', '/orders'). " +
+        "Must start with / and use lowercase letters, numbers, and hyphens."),
+    allowedMethods: z
+        .array(z.string())
+        .describe("HTTP methods to enable: ['GET', 'POST', 'PUT', 'DELETE']. " +
+        "Include all methods the endpoint should support."),
+    schemaDefinition: z
+        .record(z.string(), z.unknown())
+        .describe("JSON Schema defining the data structure for this endpoint. " +
+        'Must include "$schema", "type": "object", and "properties". ' +
+        "Each property needs a type (string, number, integer, boolean, array, object)."),
+    type: z
+        .enum(["JSON", "FILE"])
+        .optional()
+        .describe("Endpoint type: 'JSON' for data APIs (default), 'FILE' for file uploads"),
+    visibility: z
+        .enum(["PUBLIC", "PRIVATE"])
+        .optional()
+        .describe("Endpoint visibility: 'PRIVATE' (default, requires auth) or " +
+        "'PUBLIC' (accessible without auth, only for public apps)"),
+    securityPolicy: z
+        .enum(["NONE", "OWNER_ONLY", "CLAIM_FILTER"])
+        .optional()
+        .describe("Data access control: 'NONE' (shared data), " +
+        "'OWNER_ONLY' (users see only their data), " +
+        "'CLAIM_FILTER' (filter by JWT claims, requires securityConfig)"),
+    securityConfig: z
+        .object({
+        claimFilterRules: z.array(z.object({
+            payloadPath: z.string(),
+            claimName: z.string(),
+        })),
+    })
+        .optional()
+        .describe("Required when securityPolicy is 'CLAIM_FILTER'. " +
+        "Defines which JWT claim maps to which data field for filtering."),
+    endpointDocumentation: z
+        .string()
+        .optional()
+        .describe("Human-readable documentation for this endpoint"),
+}, async (params) => {
+    const result = await executeCreateEndpoint(client, params);
+    return { content: [{ type: "text", text: result }] };
+});
+// ─── Tool 4: List Applications ──────────────────────────────────────────
+server.tool("igniral_list_applications", `Lists all applications owned by the current user. 
+Use this to check what applications already exist before creating new ones, 
+or to get the applicationId of an existing application.
+
+Takes no parameters — the user is identified by the configured service token.`, {}, async () => {
+    const result = await executeListApplications(client);
+    return { content: [{ type: "text", text: result }] };
+});
+// ─── Start Server ───────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (not stdout, which is used by MCP protocol)
+    console.error("Igniral MCP Server v1.0.0 started");
+    console.error(`Connected to API: ${config.apiUrl}`);
+    console.error(`Connected to AI API: ${config.aiApiUrl}`);
+    console.error(`Auth server: ${config.authUrl}`);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\n✖ Fatal error: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,2EAA2E;AAE3E,IAAI,MAAqC,CAAC;AAC1C,IAAI,MAAqB,CAAC;AAE1B,IAAI,CAAC;IACH,MAAM,GAAG,UAAU,EAAE,CAAC;IACtB,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,OAAO,OAAO,IAAI,CAAC,CAAC;IAClC,OAAO,CAAC,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACnG,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC3F,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,2EAA2E;AAE3E,MAAM,CAAC,IAAI,CACT,qCAAqC,EACrC;;;;;;;;;;;6DAW2D,EAC3D;IACE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,CACP,+DAA+D;QAC7D,8DAA8D;QAC9D,oDAAoD,CACvD;CACJ,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACnB,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC,CACF,CAAC;AAEF,2EAA2E;AAE3E,MAAM,CAAC,IAAI,CACT,4BAA4B,EAC5B;;;;;;;;+CAQ6C,EAC7C;IACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IACtF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC5E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACtE,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6DAA6D;QAC3D,kDAAkD,CACrD;IACH,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,SAAS,EAAE,CAAC;SACT,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,8CAA8C;QAC5C,yDAAyD;QACzD,2DAA2D,CAC9D;CACJ,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;IACf,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC,CACF,CAAC;AAEF,2EAA2E;AAE3E,MAAM,CAAC,IAAI,CACT,iCAAiC,EACjC;;;;;;;;;;0EAUwE,EACxE;IACE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAClF,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,CACP,sEAAsE;QACpE,oEAAoE,CACvE;IACH,cAAc,EAAE,CAAC;SACd,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CACP,4DAA4D;QAC1D,kDAAkD,CACrD;IACH,gBAAgB,EAAE,CAAC;SAChB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,CACP,6DAA6D;QAC3D,8DAA8D;QAC9D,+EAA+E,CAClF;IACH,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACtB,QAAQ,EAAE;SACV,QAAQ,CAAC,wEAAwE,CAAC;IACrF,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;SAC3B,QAAQ,EAAE;SACV,QAAQ,CACP,6DAA6D;QAC3D,0DAA0D,CAC7D;IACH,cAAc,EAAE,CAAC;SACd,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;SAC5C,QAAQ,EAAE;SACV,QAAQ,CACP,6CAA6C;QAC3C,4CAA4C;QAC5C,gEAAgE,CACnE;IACH,cAAc,EAAE,CAAC;SACd,MAAM,CAAC;QACN,gBAAgB,EAAE,CAAC,CAAC,KAAK,CACvB,CAAC,CAAC,MAAM,CAAC;YACP,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;YACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;SACtB,CAAC,CACH;KACF,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,kDAAkD;QAChD,iEAAiE,CACpE;IACH,qBAAqB,EAAE,CAAC;SACrB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;CAC9D,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;IACf,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,MAAiC,CAAC,CAAC;IACtF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC,CACF,CAAC;AAEF,2EAA2E;AAE3E,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B;;;;8EAI4E,EAC5E,EAAE,EACF,KAAK,IAAI,EAAE;IACT,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC,CACF,CAAC;AAEF,2EAA2E;AAE3E,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,4DAA4D;IAC5D,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACnD,OAAO,CAAC,KAAK,CAAC,qBAAqB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,IAAI,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/create-application.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tool 2: igniral_create_application
+ *
+ * Creates an empty application shell (without endpoints).
+ * Use this when the user wants to manually build an application
+ * step by step, providing specific name, description, and settings.
+ *
+ * After creating the application, use igniral_create_dynamic_endpoint
+ * to add endpoints one by one.
+ */
+import { IgniralClient } from "../api/igniral-client.js";
+/**
+ * Executes the create-application tool.
+ *
+ * @param client  The Igniral API client
+ * @param params  Raw parameters from the AI agent
+ * @returns MCP tool result content
+ */
+export declare function executeCreateApplication(client: IgniralClient, params: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=create-application.d.ts.map

package/dist/tools/create-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-application.d.ts","sourceRoot":"","sources":["../../src/tools/create-application.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAQzD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,CAiCjB"}

package/dist/tools/create-application.js

@@ -0,0 +1,47 @@
+/**
+ * Tool 2: igniral_create_application
+ *
+ * Creates an empty application shell (without endpoints).
+ * Use this when the user wants to manually build an application
+ * step by step, providing specific name, description, and settings.
+ *
+ * After creating the application, use igniral_create_dynamic_endpoint
+ * to add endpoints one by one.
+ */
+import { createApplicationInput } from "../validation/schemas.js";
+import { wrapApplicationCreated } from "../utils/response-wrapper.js";
+import { handleApiError, handleValidationError, } from "../utils/error-handler.js";
+/**
+ * Executes the create-application tool.
+ *
+ * @param client  The Igniral API client
+ * @param params  Raw parameters from the AI agent
+ * @returns MCP tool result content
+ */
+export async function executeCreateApplication(client, params) {
+    // 1. Validate input with Zod
+    const parsed = createApplicationInput.safeParse(params);
+    if (!parsed.success) {
+        return handleValidationError(parsed.error);
+    }
+    const { name, description, version, subdomain, aiGeneratedContext, isPrivate } = parsed.data;
+    // 2. Build request body (matches ApplicationRequest DTO)
+    const body = {
+        name,
+        description,
+        version,
+        isPrivate,
+    };
+    if (subdomain)
+        body.subdomain = subdomain;
+    if (aiGeneratedContext)
+        body.aiGeneratedContext = aiGeneratedContext;
+    // 3. Call the AI-generate endpoint
+    const response = await client.postToApi("/api/igniral-user-application/ai-generate", body);
+    if (!response.ok) {
+        return handleApiError(response, "creating application");
+    }
+    // 4. Wrap response in instructional text
+    return wrapApplicationCreated(response.data);
+}
+//# sourceMappingURL=create-application.js.map

package/dist/tools/create-application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-application.js","sourceRoot":"","sources":["../../src/tools/create-application.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EACL,cAAc,EACd,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAqB,EACrB,MAA+B;IAE/B,6BAA6B;IAC7B,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,SAAS,EAAE,GAC5E,MAAM,CAAC,IAAI,CAAC;IAEd,yDAAyD;IACzD,MAAM,IAAI,GAA4B;QACpC,IAAI;QACJ,WAAW;QACX,OAAO;QACP,SAAS;KACV,CAAC;IAEF,IAAI,SAAS;QAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1C,IAAI,kBAAkB;QAAE,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IAErE,mCAAmC;IACnC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,2CAA2C,EAC3C,IAAI,CACL,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,cAAc,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAC1D,CAAC;IAED,yCAAyC;IACzC,OAAO,sBAAsB,CAAC,QAAQ,CAAC,IAA+B,CAAC,CAAC;AAC1E,CAAC"}

package/dist/tools/create-endpoint.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tool 3: igniral_create_dynamic_endpoint
+ *
+ * Creates a dynamic API endpoint within an existing application.
+ * Requires an applicationId from a previous create_application call.
+ * Use this iteratively to add all needed endpoints to the application.
+ */
+import { IgniralClient } from "../api/igniral-client.js";
+/**
+ * Executes the create-dynamic-endpoint tool.
+ *
+ * @param client  The Igniral API client
+ * @param params  Raw parameters from the AI agent
+ * @returns MCP tool result content
+ */
+export declare function executeCreateEndpoint(client: IgniralClient, params: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=create-endpoint.d.ts.map

package/dist/tools/create-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-endpoint.d.ts","sourceRoot":"","sources":["../../src/tools/create-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAQzD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,CAuCjB"}

package/dist/tools/create-endpoint.js

@@ -0,0 +1,49 @@
+/**
+ * Tool 3: igniral_create_dynamic_endpoint
+ *
+ * Creates a dynamic API endpoint within an existing application.
+ * Requires an applicationId from a previous create_application call.
+ * Use this iteratively to add all needed endpoints to the application.
+ */
+import { createEndpointInput } from "../validation/schemas.js";
+import { wrapEndpointCreated } from "../utils/response-wrapper.js";
+import { handleApiError, handleValidationError, } from "../utils/error-handler.js";
+/**
+ * Executes the create-dynamic-endpoint tool.
+ *
+ * @param client  The Igniral API client
+ * @param params  Raw parameters from the AI agent
+ * @returns MCP tool result content
+ */
+export async function executeCreateEndpoint(client, params) {
+    // 1. Validate input with Zod (includes securityConfig conditional check)
+    const parsed = createEndpointInput.safeParse(params);
+    if (!parsed.success) {
+        return handleValidationError(parsed.error);
+    }
+    const validated = parsed.data;
+    // 2. Build request body (matches DynamicEndpointRequest DTO)
+    const body = {
+        applicationId: validated.applicationId,
+        endpointPath: validated.endpointPath,
+        allowedMethods: validated.allowedMethods,
+        schemaDefinition: validated.schemaDefinition,
+        type: validated.type,
+        visibility: validated.visibility,
+        securityPolicy: validated.securityPolicy,
+    };
+    if (validated.securityConfig) {
+        body.securityConfig = validated.securityConfig;
+    }
+    if (validated.endpointDocumentation) {
+        body.endpointDocumentation = validated.endpointDocumentation;
+    }
+    // 3. Call the AI-generate endpoint
+    const response = await client.postToApi("/api/igniral-user-dynamic-endpoint/ai-generate", body);
+    if (!response.ok) {
+        return handleApiError(response, "creating dynamic endpoint");
+    }
+    // 4. Wrap response in instructional text
+    return wrapEndpointCreated(response.data);
+}
+//# sourceMappingURL=create-endpoint.js.map

package/dist/tools/create-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-endpoint.js","sourceRoot":"","sources":["../../src/tools/create-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EACL,cAAc,EACd,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAqB,EACrB,MAA+B;IAE/B,yEAAyE;IACzE,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC;IAE9B,6DAA6D;IAC7D,MAAM,IAAI,GAA4B;QACpC,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,cAAc,EAAE,SAAS,CAAC,cAAc;QACxC,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;QAC5C,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,cAAc,EAAE,SAAS,CAAC,cAAc;KACzC,CAAC;IAEF,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC,cAAc,CAAC;IACjD,CAAC;IACD,IAAI,SAAS,CAAC,qBAAqB,EAAE,CAAC;QACpC,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC,qBAAqB,CAAC;IAC/D,CAAC;IAED,mCAAmC;IACnC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,gDAAgD,EAChD,IAAI,CACL,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,cAAc,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;IAC/D,CAAC;IAED,yCAAyC;IACzC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,IAA+B,CAAC,CAAC;AACvE,CAAC"}

package/dist/tools/generate-schema.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tool 1: igniral_generate_schema_from_prompt
+ *
+ * Generates a complete application from a natural language description.
+ * This tool creates the application, ALL endpoints with their schemas,
+ * roles, and permissions automatically.
+ *
+ * Internally:
+ * 1. Opens an SSE connection to listen for generation progress
+ * 2. Posts the prompt to the ai-schema-builder (which returns 202 Accepted)
+ * 3. Waits for the SSE "complete" or "error" event
+ * 4. Returns the final result to the agent
+ *
+ * The agent sees this as a synchronous tool call.
+ */
+import { IgniralClient } from "../api/igniral-client.js";
+/**
+ * Executes the generate-schema-from-prompt tool.
+ *
+ * @param client  The Igniral API client
+ * @param params  Raw parameters from the AI agent
+ * @returns MCP tool result content
+ */
+export declare function executeGenerateSchema(client: IgniralClient, params: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=generate-schema.d.ts.map

package/dist/tools/generate-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-schema.d.ts","sourceRoot":"","sources":["../../src/tools/generate-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAoBzD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,CAmDjB"}

package/dist/tools/generate-schema.js

@@ -0,0 +1,142 @@
+/**
+ * Tool 1: igniral_generate_schema_from_prompt
+ *
+ * Generates a complete application from a natural language description.
+ * This tool creates the application, ALL endpoints with their schemas,
+ * roles, and permissions automatically.
+ *
+ * Internally:
+ * 1. Opens an SSE connection to listen for generation progress
+ * 2. Posts the prompt to the ai-schema-builder (which returns 202 Accepted)
+ * 3. Waits for the SSE "complete" or "error" event
+ * 4. Returns the final result to the agent
+ *
+ * The agent sees this as a synchronous tool call.
+ */
+import { EventSource } from "eventsource";
+import { generateSchemaInput } from "../validation/schemas.js";
+import { wrapGenerationComplete } from "../utils/response-wrapper.js";
+import { handleApiError, handleValidationError, } from "../utils/error-handler.js";
+/** SSE timeout: 180 seconds (matches server-side SseEmitter timeout) */
+const SSE_TIMEOUT_MS = 180_000;
+/**
+ * Executes the generate-schema-from-prompt tool.
+ *
+ * @param client  The Igniral API client
+ * @param params  Raw parameters from the AI agent
+ * @returns MCP tool result content
+ */
+export async function executeGenerateSchema(client, params) {
+    // 1. Validate input
+    const parsed = generateSchemaInput.safeParse(params);
+    if (!parsed.success) {
+        return handleValidationError(parsed.error);
+    }
+    const { prompt } = parsed.data;
+    try {
+        const sseHeaders = await client.getSseHeaders();
+        // 2. Open SSE connection FIRST (before triggering generation)
+        const resultPromise = waitForGenerationResult(client, sseHeaders);
+        // 3. Trigger the async generation
+        const triggerResponse = await client.postToAiApi("/api/ai/generate-application", { prompt });
+        // If the trigger itself fails (not 202), report immediately
+        if (!triggerResponse.ok && triggerResponse.status !== 202) {
+            return handleApiError(triggerResponse, "triggering application generation");
+        }
+        // 4. Wait for SSE to deliver the result
+        const result = await resultPromise;
+        if (result.status === "SUCCESS") {
+            return wrapGenerationComplete(result);
+        }
+        else {
+            return [
+                `❌ Application generation failed.`,
+                ``,
+                `Error: ${result.message || "Unknown error during generation"}`,
+                ``,
+                `This may be due to a problem with the AI model or the prompt.`,
+                `Ask the user to try rephrasing their request with more details.`,
+            ].join("\n");
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return [
+            `❌ Error during application generation.`,
+            ``,
+            `Details: ${message}`,
+            ``,
+            `Ask the user to try again later.`,
+        ].join("\n");
+    }
+}
+/**
+ * Opens an SSE connection and returns a promise that resolves
+ * when a "complete" or "error" event is received.
+ *
+ * eventsource v3 follows the browser spec and doesn't support
+ * custom headers directly. We use the `fetch` option to inject
+ * Authorization headers via a custom fetch wrapper.
+ */
+function waitForGenerationResult(client, sseHeaders) {
+    return new Promise((resolve, reject) => {
+        const sseUrl = client.getSseUrl();
+        // Custom fetch that injects auth headers into the SSE connection
+        const fetchWithAuth = (input, init) => {
+            const headers = new Headers(init?.headers);
+            for (const [key, value] of Object.entries(sseHeaders)) {
+                headers.set(key, value);
+            }
+            return fetch(input, { ...init, headers });
+        };
+        const eventSource = new EventSource(sseUrl, {
+            fetch: fetchWithAuth,
+        });
+        // Timeout handler
+        const timeout = setTimeout(() => {
+            eventSource.close();
+            reject(new Error("Generation timed out after 180 seconds. " +
+                "The AI model may be overloaded. Ask the user to try again later."));
+        }, SSE_TIMEOUT_MS);
+        // Listen for completion
+        eventSource.addEventListener("complete", ((event) => {
+            clearTimeout(timeout);
+            eventSource.close();
+            try {
+                const data = JSON.parse(event.data);
+                data.status = data.status || "SUCCESS";
+                resolve(data);
+            }
+            catch {
+                resolve({ status: "SUCCESS", message: event.data });
+            }
+        }));
+        // Listen for named "error" events from the backend (generation failures)
+        eventSource.addEventListener("error", ((event) => {
+            const messageEvent = event;
+            // Only handle named "error" events with data (not SSE connection errors)
+            if (messageEvent.data) {
+                clearTimeout(timeout);
+                eventSource.close();
+                try {
+                    const data = JSON.parse(messageEvent.data);
+                    data.status = "ERROR";
+                    resolve(data);
+                }
+                catch {
+                    resolve({ status: "ERROR", message: messageEvent.data });
+                }
+            }
+        }));
+        // Handle SSE connection-level errors
+        eventSource.onerror = () => {
+            // EventSource auto-reconnects, but if it fails completely:
+            if (eventSource.readyState === EventSource.CLOSED) {
+                clearTimeout(timeout);
+                reject(new Error("SSE connection to Igniral backend failed. " +
+                    "Check that IGNIRAL_AI_API_URL is correct and the server is running."));
+            }
+        };
+    });
+}
+//# sourceMappingURL=generate-schema.js.map

package/dist/tools/generate-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-schema.js","sourceRoot":"","sources":["../../src/tools/generate-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EACL,cAAc,EACd,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,wEAAwE;AACxE,MAAM,cAAc,GAAG,OAAO,CAAC;AAW/B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAqB,EACrB,MAA+B;IAE/B,oBAAoB;IACpB,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAChD,8DAA8D;QAC9D,MAAM,aAAa,GAAG,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAElE,kCAAkC;QAClC,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,WAAW,CAC9C,8BAA8B,EAC9B,EAAE,MAAM,EAAE,CACX,CAAC;QAEF,4DAA4D;QAC5D,IAAI,CAAC,eAAe,CAAC,EAAE,IAAI,eAAe,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC1D,OAAO,cAAc,CAAC,eAAe,EAAE,mCAAmC,CAAC,CAAC;QAC9E,CAAC;QAED,wCAAwC;QACxC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;QAEnC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,kCAAkC;gBAClC,EAAE;gBACF,UAAU,MAAM,CAAC,OAAO,IAAI,iCAAiC,EAAE;gBAC/D,EAAE;gBACF,+DAA+D;gBAC/D,iEAAiE;aAClE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAC3D,OAAO;YACL,wCAAwC;YACxC,EAAE;YACF,YAAY,OAAO,EAAE;YACrB,EAAE;YACF,kCAAkC;SACnC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,uBAAuB,CAC9B,MAAqB,EACrB,UAAkC;IAElC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAElC,iEAAiE;QACjE,MAAM,aAAa,GAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAClD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE;YAC1C,KAAK,EAAE,aAAa;SACrB,CAAC,CAAC;QAEH,kBAAkB;QAClB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,WAAW,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,CACJ,IAAI,KAAK,CACP,0CAA0C;gBACxC,kEAAkE,CACrE,CACF,CAAC;QACJ,CAAC,EAAE,cAAc,CAAC,CAAC;QAEnB,wBAAwB;QACxB,WAAW,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAC,KAAmB,EAAE,EAAE;YAChE,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,WAAW,CAAC,KAAK,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;gBACvD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC;gBACvC,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAkB,CAAC,CAAC;QAErB,yEAAyE;QACzE,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAY,EAAE,EAAE;YACtD,MAAM,YAAY,GAAG,KAAqB,CAAC;YAC3C,yEAAyE;YACzE,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;gBACtB,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,WAAW,CAAC,KAAK,EAAE,CAAC;gBACpB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAoB,CAAC;oBAC9D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;oBACtB,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;QACH,CAAC,CAAkB,CAAC,CAAC;QAErB,qCAAqC;QACrC,WAAW,CAAC,OAAO,GAAG,GAAG,EAAE;YACzB,2DAA2D;YAC3D,IAAI,WAAW,CAAC,UAAU,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;gBAClD,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,MAAM,CACJ,IAAI,KAAK,CACP,4CAA4C;oBAC1C,qEAAqE,CACxE,CACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/list-applications.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tool 4: igniral_list_applications
+ *
+ * Lists all applications owned by the current user.
+ * Use this to check what applications already exist before creating
+ * new ones, or to get the applicationId of an existing application.
+ *
+ * Note: This calls the standard GET endpoint which uses jwt.sub
+ * for user identification. The token must have sub=userId.
+ */
+import { IgniralClient } from "../api/igniral-client.js";
+/**
+ * Executes the list-applications tool.
+ *
+ * @param client The Igniral API client
+ * @returns MCP tool result content
+ */
+export declare function executeListApplications(client: IgniralClient): Promise<string>;
+//# sourceMappingURL=list-applications.d.ts.map

package/dist/tools/list-applications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-applications.d.ts","sourceRoot":"","sources":["../../src/tools/list-applications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAIzD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/tools/list-applications.js

@@ -0,0 +1,27 @@
+/**
+ * Tool 4: igniral_list_applications
+ *
+ * Lists all applications owned by the current user.
+ * Use this to check what applications already exist before creating
+ * new ones, or to get the applicationId of an existing application.
+ *
+ * Note: This calls the standard GET endpoint which uses jwt.sub
+ * for user identification. The token must have sub=userId.
+ */
+import { wrapApplicationList } from "../utils/response-wrapper.js";
+import { handleApiError } from "../utils/error-handler.js";
+/**
+ * Executes the list-applications tool.
+ *
+ * @param client The Igniral API client
+ * @returns MCP tool result content
+ */
+export async function executeListApplications(client) {
+    // Call GET /api/igniral-user-application with pagination defaults
+    const response = await client.getFromApi("/api/igniral-user-application?page=0&size=50&sort=createdAt,desc");
+    if (!response.ok) {
+        return handleApiError(response, "listing applications");
+    }
+    return wrapApplicationList(response.data);
+}
+//# sourceMappingURL=list-applications.js.map

package/dist/tools/list-applications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-applications.js","sourceRoot":"","sources":["../../src/tools/list-applications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAqB;IAErB,kEAAkE;IAClE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CACtC,kEAAkE,CACnE,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,cAAc,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,mBAAmB,CAAC,QAAQ,CAAC,IAA+B,CAAC,CAAC;AACvE,CAAC"}

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Error Handler
+ *
+ * Maps HTTP error responses from Igniral's backend into clear,
+ * actionable messages for the AI agent. Includes instructions on
+ * whether to retry, modify input, or ask the user for help.
+ */
+import { ApiResponse } from "../api/igniral-client.js";
+/**
+ * Translates an API error response into an instructional message
+ * for the AI agent.
+ *
+ * @param response The failed API response
+ * @param context  Description of what was being attempted (e.g., "creating application")
+ * @returns A formatted error message with guidance for the agent
+ */
+export declare function handleApiError(response: ApiResponse, context: string): string;
+/**
+ * Formats a Zod validation error into a helpful message for the agent.
+ */
+export declare function handleValidationError(error: unknown): string;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,GACd,MAAM,CA8FR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAkB5D"}