@maestro-ai/mcp-server 2.6.1 → 5.0.0

package/dist/content/.version.json

@@ -0,0 +1,16 @@
+{
+  "version": "5.0.0",
+  "hash": "auto-generated",
+  "injected_at": "2026-02-06T00:00:00.000Z",
+  "source": "builtin",
+  "content_version": "1.0",
+  "compatibility": {
+    "min_server_version": "5.0.0",
+    "max_server_version": "5.x"
+  },
+  "checksums": {
+    "skills_count": 0,
+    "templates_count": 0,
+    "rules_count": 0
+  }
+}

package/dist/data/project-templates.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Templates de Projeto — Projetos pré-configurados para onboarding rápido
+ *
+ * Cada template contém discovery pré-preenchido, tipo/complexidade inferidos,
+ * e stack sugerida. Permite criar projeto com 1-2 interações.
+ */
+export interface ProjectTemplate {
+    id: string;
+    name: string;
+    description: string;
+    emoji: string;
+    tipo_artefato: 'poc' | 'script' | 'internal' | 'product';
+    nivel_complexidade: 'simples' | 'medio' | 'complexo';
+    discovery_preenchido: {
+        problema: string;
+        publico_alvo: string;
+        funcionalidades_principais: string[];
+        plataformas: string[];
+        stack_sugerida: {
+            frontend?: string;
+            backend?: string;
+            database?: string;
+            infra?: string;
+        };
+    };
+    perguntas_essenciais: string[];
+}
+export declare const PROJECT_TEMPLATES: ProjectTemplate[];
+/**
+ * Busca template por ID
+ */
+export declare function getTemplate(id: string): ProjectTemplate | null;
+/**
+ * Lista templates disponíveis formatado
+ */
+export declare function listTemplatesFormatted(): string;
+//# sourceMappingURL=project-templates.d.ts.map

package/dist/data/project-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-templates.d.ts","sourceRoot":"","sources":["../../src/data/project-templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACzD,kBAAkB,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACrD,oBAAoB,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,0BAA0B,EAAE,MAAM,EAAE,CAAC;QACrC,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,cAAc,EAAE;YACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,KAAK,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACL,CAAC;IACF,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,eAAO,MAAM,iBAAiB,EAAE,eAAe,EA4L9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAE9D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAI/C"}

package/dist/data/project-templates.js

@@ -0,0 +1,208 @@
+/**
+ * Templates de Projeto — Projetos pré-configurados para onboarding rápido
+ *
+ * Cada template contém discovery pré-preenchido, tipo/complexidade inferidos,
+ * e stack sugerida. Permite criar projeto com 1-2 interações.
+ */
+export const PROJECT_TEMPLATES = [
+    {
+        id: "saas-b2b",
+        name: "SaaS B2B",
+        description: "Aplicação SaaS multi-tenant para empresas com autenticação, dashboard e billing",
+        emoji: "🏢",
+        tipo_artefato: "product",
+        nivel_complexidade: "complexo",
+        discovery_preenchido: {
+            problema: "Empresas precisam de uma solução digital para gerenciar [processo]",
+            publico_alvo: "Empresas de médio porte, gestores e equipes operacionais",
+            funcionalidades_principais: [
+                "Autenticação multi-tenant (SSO opcional)",
+                "Dashboard com métricas e KPIs",
+                "Gestão de usuários e permissões (RBAC)",
+                "Planos e billing (Stripe/similar)",
+                "API RESTful para integrações",
+                "Notificações (email + in-app)",
+            ],
+            plataformas: ["Web (responsivo)"],
+            stack_sugerida: {
+                frontend: "Next.js + TailwindCSS + shadcn/ui",
+                backend: "Node.js + Express/Fastify",
+                database: "PostgreSQL + Redis",
+                infra: "Docker + AWS/Vercel",
+            },
+        },
+        perguntas_essenciais: [
+            "Qual processo específico o SaaS vai resolver?",
+            "Qual será o modelo de pricing (freemium, por seat, por uso)?",
+            "Precisa de integrações com sistemas externos?",
+        ],
+    },
+    {
+        id: "ecommerce",
+        name: "E-commerce",
+        description: "Loja virtual com catálogo, carrinho, checkout e gestão de pedidos",
+        emoji: "🛒",
+        tipo_artefato: "product",
+        nivel_complexidade: "complexo",
+        discovery_preenchido: {
+            problema: "Vender [produtos/serviços] online com experiência de compra fluida",
+            publico_alvo: "Consumidores finais (B2C) interessados em [nicho]",
+            funcionalidades_principais: [
+                "Catálogo de produtos com busca e filtros",
+                "Carrinho de compras persistente",
+                "Checkout com múltiplos métodos de pagamento",
+                "Gestão de pedidos e status",
+                "Sistema de avaliações",
+                "Painel administrativo",
+            ],
+            plataformas: ["Web (responsivo)", "PWA"],
+            stack_sugerida: {
+                frontend: "Next.js + TailwindCSS",
+                backend: "Node.js + API REST",
+                database: "PostgreSQL",
+                infra: "Vercel + Stripe",
+            },
+        },
+        perguntas_essenciais: [
+            "Que tipo de produtos serão vendidos?",
+            "Qual gateway de pagamento (Stripe, PagSeguro, etc.)?",
+            "Precisa de gestão de estoque?",
+        ],
+    },
+    {
+        id: "api-microservices",
+        name: "API / Microserviços",
+        description: "API RESTful ou sistema de microserviços com documentação e testes",
+        emoji: "🔌",
+        tipo_artefato: "product",
+        nivel_complexidade: "medio",
+        discovery_preenchido: {
+            problema: "Expor dados/funcionalidades como API para consumo por [clientes/apps]",
+            publico_alvo: "Desenvolvedores e sistemas que consomem a API",
+            funcionalidades_principais: [
+                "API RESTful com versionamento",
+                "Autenticação (JWT/OAuth2)",
+                "Rate limiting e throttling",
+                "Documentação OpenAPI/Swagger",
+                "Testes automatizados (unit + integration)",
+                "Logging e monitoramento",
+            ],
+            plataformas: ["API Server"],
+            stack_sugerida: {
+                backend: "Node.js + Fastify (ou Express)",
+                database: "PostgreSQL + Redis (cache)",
+                infra: "Docker + CI/CD",
+            },
+        },
+        perguntas_essenciais: [
+            "Quais recursos/entidades a API vai expor?",
+            "Qual volume esperado de requisições?",
+            "Precisa de comunicação assíncrona (filas, eventos)?",
+        ],
+    },
+    {
+        id: "mobile-app",
+        name: "App Mobile",
+        description: "Aplicativo mobile cross-platform com backend e push notifications",
+        emoji: "📱",
+        tipo_artefato: "product",
+        nivel_complexidade: "complexo",
+        discovery_preenchido: {
+            problema: "Usuários precisam de [funcionalidade] acessível pelo celular",
+            publico_alvo: "Usuários mobile (iOS e Android)",
+            funcionalidades_principais: [
+                "Telas principais com navegação fluida",
+                "Autenticação (social login + email)",
+                "Push notifications",
+                "Sincronização offline-first",
+                "Integração com API backend",
+                "Deep linking",
+            ],
+            plataformas: ["iOS", "Android"],
+            stack_sugerida: {
+                frontend: "React Native + Expo",
+                backend: "Node.js + API REST",
+                database: "PostgreSQL + SQLite (local)",
+                infra: "AWS/Firebase",
+            },
+        },
+        perguntas_essenciais: [
+            "Qual a funcionalidade principal do app?",
+            "Precisa funcionar offline?",
+            "Quais integrações nativas (câmera, GPS, etc.)?",
+        ],
+    },
+    {
+        id: "landing-page",
+        name: "Landing Page",
+        description: "Página de captura ou institucional com formulário e analytics",
+        emoji: "🌐",
+        tipo_artefato: "poc",
+        nivel_complexidade: "simples",
+        discovery_preenchido: {
+            problema: "Apresentar [produto/serviço] e capturar leads/conversões",
+            publico_alvo: "Visitantes interessados em [oferta]",
+            funcionalidades_principais: [
+                "Hero section com CTA principal",
+                "Seções de benefícios/features",
+                "Social proof (depoimentos, logos)",
+                "Formulário de captura",
+                "Analytics e tracking",
+                "SEO otimizado",
+            ],
+            plataformas: ["Web"],
+            stack_sugerida: {
+                frontend: "Next.js + TailwindCSS",
+                infra: "Vercel",
+            },
+        },
+        perguntas_essenciais: [
+            "Qual é a oferta/produto principal?",
+            "Qual a ação desejada do visitante (cadastro, compra, contato)?",
+        ],
+    },
+    {
+        id: "dashboard",
+        name: "Dashboard / Admin Panel",
+        description: "Painel administrativo com gráficos, tabelas e gestão de dados",
+        emoji: "📊",
+        tipo_artefato: "internal",
+        nivel_complexidade: "medio",
+        discovery_preenchido: {
+            problema: "Equipe precisa visualizar e gerenciar [dados/processos] de forma centralizada",
+            publico_alvo: "Equipe interna (gestores, analistas, operadores)",
+            funcionalidades_principais: [
+                "Dashboard com gráficos e KPIs",
+                "Tabelas com busca, filtro e paginação",
+                "CRUD de entidades principais",
+                "Controle de acesso (RBAC)",
+                "Exportação de dados (CSV, PDF)",
+                "Auditoria de ações",
+            ],
+            plataformas: ["Web"],
+            stack_sugerida: {
+                frontend: "Next.js + shadcn/ui + Recharts",
+                backend: "Node.js + Prisma",
+                database: "PostgreSQL",
+            },
+        },
+        perguntas_essenciais: [
+            "Quais dados/métricas precisam ser visualizados?",
+            "Quantos tipos de usuário com permissões diferentes?",
+            "Precisa integrar com sistemas existentes?",
+        ],
+    },
+];
+/**
+ * Busca template por ID
+ */
+export function getTemplate(id) {
+    return PROJECT_TEMPLATES.find(t => t.id === id) || null;
+}
+/**
+ * Lista templates disponíveis formatado
+ */
+export function listTemplatesFormatted() {
+    return PROJECT_TEMPLATES.map(t => `- **${t.emoji} ${t.name}** (\`${t.id}\`) — ${t.description} [${t.nivel_complexidade}]`).join("\n");
+}
+//# sourceMappingURL=project-templates.js.map

package/dist/data/project-templates.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Error Handling Estruturado do Maestro
+ *
+ * Hierarquia de erros com códigos, recovery actions e contexto.
+ * Quando um erro tem `recovery`, a IA sabe exatamente como corrigi-lo.
+ */
+import type { NextAction } from "../types/response.js";
+/**
+ * Erro base do Maestro com código e recovery action
+ */
+export declare class MaestroError extends Error {
+    readonly code: string;
+    readonly recovery?: NextAction;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code: string, options?: {
+        recovery?: NextAction;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+}
+/**
+ * Erro de validação de input
+ */
+export declare class ValidationError extends MaestroError {
+    constructor(message: string, options?: {
+        field?: string;
+        expected?: string;
+        received?: string;
+        recovery?: NextAction;
+    });
+}
+/**
+ * Erro de estado inválido
+ */
+export declare class StateError extends MaestroError {
+    constructor(message: string, options?: {
+        currentState?: string;
+        expectedState?: string;
+        recovery?: NextAction;
+    });
+}
+/**
+ * Erro de fluxo (transição inválida, fase não encontrada, etc.)
+ */
+export declare class FlowError extends MaestroError {
+    constructor(message: string, options?: {
+        currentPhase?: string;
+        targetPhase?: string;
+        recovery?: NextAction;
+    });
+}
+/**
+ * Erro de persistência (falha ao ler/escrever arquivos)
+ */
+export declare class PersistenceError extends MaestroError {
+    constructor(message: string, options?: {
+        path?: string;
+        operation?: "read" | "write";
+        recovery?: NextAction;
+        cause?: Error;
+    });
+}
+/**
+ * Erro de tool não encontrada
+ */
+export declare class ToolNotFoundError extends MaestroError {
+    constructor(toolName: string);
+}
+/**
+ * Formata um MaestroError para resposta de tool
+ */
+export declare function formatMaestroError(error: MaestroError): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: boolean;
+    next_action?: NextAction;
+};
+/**
+ * Wraps uma função de tool com error handling automático
+ */
+export declare function withErrorHandling<T extends Record<string, unknown>>(toolName: string, handler: (args: T) => Promise<any>): (args: T) => Promise<any>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAG9C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,UAAU,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,KAAK,CAAC;KACjB;CASR;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBAEzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,UAAU,CAAC;KACzB;CAYR;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY;gBAEpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,UAAU,CAAC;KACzB;CAWR;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;gBAEnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;KACzB;CAWR;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBAE1C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,QAAQ,CAAC,EAAE,UAAU,CAAC;QACtB,KAAK,CAAC,EAAE,KAAK,CAAC;KACjB;CAYR;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;gBACnC,QAAQ,EAAE,MAAM;CAY/B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG;IACrD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC5B,CA4BA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GACnC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CA0B3B"}

package/dist/errors/index.js

@@ -0,0 +1,158 @@
+/**
+ * Error Handling Estruturado do Maestro
+ *
+ * Hierarquia de erros com códigos, recovery actions e contexto.
+ * Quando um erro tem `recovery`, a IA sabe exatamente como corrigi-lo.
+ */
+/**
+ * Erro base do Maestro com código e recovery action
+ */
+export class MaestroError extends Error {
+    code;
+    recovery;
+    details;
+    constructor(message, code, options) {
+        super(message);
+        this.name = "MaestroError";
+        this.code = code;
+        this.recovery = options?.recovery;
+        this.details = options?.details;
+        if (options?.cause)
+            this.cause = options.cause;
+    }
+}
+/**
+ * Erro de validação de input
+ */
+export class ValidationError extends MaestroError {
+    constructor(message, options) {
+        super(message, "VALIDATION_ERROR", {
+            recovery: options?.recovery,
+            details: {
+                field: options?.field,
+                expected: options?.expected,
+                received: options?.received,
+            },
+        });
+        this.name = "ValidationError";
+    }
+}
+/**
+ * Erro de estado inválido
+ */
+export class StateError extends MaestroError {
+    constructor(message, options) {
+        super(message, "STATE_ERROR", {
+            recovery: options?.recovery,
+            details: {
+                currentState: options?.currentState,
+                expectedState: options?.expectedState,
+            },
+        });
+        this.name = "StateError";
+    }
+}
+/**
+ * Erro de fluxo (transição inválida, fase não encontrada, etc.)
+ */
+export class FlowError extends MaestroError {
+    constructor(message, options) {
+        super(message, "FLOW_ERROR", {
+            recovery: options?.recovery,
+            details: {
+                currentPhase: options?.currentPhase,
+                targetPhase: options?.targetPhase,
+            },
+        });
+        this.name = "FlowError";
+    }
+}
+/**
+ * Erro de persistência (falha ao ler/escrever arquivos)
+ */
+export class PersistenceError extends MaestroError {
+    constructor(message, options) {
+        super(message, "PERSISTENCE_ERROR", {
+            recovery: options?.recovery,
+            details: {
+                path: options?.path,
+                operation: options?.operation,
+            },
+            cause: options?.cause,
+        });
+        this.name = "PersistenceError";
+    }
+}
+/**
+ * Erro de tool não encontrada
+ */
+export class ToolNotFoundError extends MaestroError {
+    constructor(toolName) {
+        super(`Tool não encontrada: ${toolName}`, "TOOL_NOT_FOUND", {
+            recovery: {
+                tool: "maestro",
+                description: "Use o entry point inteligente para encontrar a tool correta",
+                args_template: { diretorio: "{{diretorio}}" },
+                requires_user_input: false,
+            },
+            details: { toolName },
+        });
+        this.name = "ToolNotFoundError";
+    }
+}
+/**
+ * Formata um MaestroError para resposta de tool
+ */
+export function formatMaestroError(error) {
+    let text = `# ❌ ${error.name}: ${error.message}\n\n`;
+    text += `**Código:** \`${error.code}\`\n\n`;
+    if (error.details) {
+        text += "**Detalhes:**\n";
+        for (const [key, value] of Object.entries(error.details)) {
+            if (value !== undefined) {
+                text += `- **${key}:** ${value}\n`;
+            }
+        }
+        text += "\n";
+    }
+    if (error.recovery) {
+        text += `## 🔄 Ação de Recuperação\n\n`;
+        text += `**Tool:** \`${error.recovery.tool}\`\n`;
+        text += `**Descrição:** ${error.recovery.description}\n`;
+        if (error.recovery.user_prompt) {
+            text += `\n> ${error.recovery.user_prompt}\n`;
+        }
+    }
+    return {
+        content: [{ type: "text", text }],
+        isError: true,
+        next_action: error.recovery,
+    };
+}
+/**
+ * Wraps uma função de tool com error handling automático
+ */
+export function withErrorHandling(toolName, handler) {
+    return async (args) => {
+        try {
+            return await handler(args);
+        }
+        catch (error) {
+            if (error instanceof MaestroError) {
+                return formatMaestroError(error);
+            }
+            // Erro genérico — wrappa em MaestroError
+            const maestroErr = new MaestroError(`Erro inesperado em ${toolName}: ${String(error)}`, "UNEXPECTED_ERROR", {
+                recovery: {
+                    tool: "status",
+                    description: "Verificar status do projeto após erro",
+                    args_template: { estado_json: "{{estado_json}}", diretorio: "{{diretorio}}" },
+                    requires_user_input: false,
+                },
+                cause: error instanceof Error ? error : undefined,
+            });
+            return formatMaestroError(maestroErr);
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACnB,IAAI,CAAS;IACb,QAAQ,CAAc;IACtB,OAAO,CAA2B;IAElD,YACI,OAAe,EACf,IAAY,EACZ,OAIC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QAChC,IAAI,OAAO,EAAE,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACnD,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC7C,YACI,OAAe,EACf,OAKC;QAED,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE;YAC/B,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,OAAO,EAAE;gBACL,KAAK,EAAE,OAAO,EAAE,KAAK;gBACrB,QAAQ,EAAE,OAAO,EAAE,QAAQ;gBAC3B,QAAQ,EAAE,OAAO,EAAE,QAAQ;aAC9B;SACJ,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,YAAY;IACxC,YACI,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE;YAC1B,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,OAAO,EAAE;gBACL,YAAY,EAAE,OAAO,EAAE,YAAY;gBACnC,aAAa,EAAE,OAAO,EAAE,aAAa;aACxC;SACJ,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7B,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,YAAY;IACvC,YACI,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE;YACzB,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,OAAO,EAAE;gBACL,YAAY,EAAE,OAAO,EAAE,YAAY;gBACnC,WAAW,EAAE,OAAO,EAAE,WAAW;aACpC;SACJ,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC5B,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAC9C,YACI,OAAe,EACf,OAKC;QAED,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE;YAChC,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,OAAO,EAAE;gBACL,IAAI,EAAE,OAAO,EAAE,IAAI;gBACnB,SAAS,EAAE,OAAO,EAAE,SAAS;aAChC;YACD,KAAK,EAAE,OAAO,EAAE,KAAK;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IAC/C,YAAY,QAAgB;QACxB,KAAK,CAAC,wBAAwB,QAAQ,EAAE,EAAE,gBAAgB,EAAE;YACxD,QAAQ,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,6DAA6D;gBAC1E,aAAa,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE;gBAC7C,mBAAmB,EAAE,KAAK;aAC7B;YACD,OAAO,EAAE,EAAE,QAAQ,EAAE;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACpC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IAKlD,IAAI,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,MAAM,CAAC;IACrD,IAAI,IAAI,iBAAiB,KAAK,CAAC,IAAI,QAAQ,CAAC;IAE5C,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,IAAI,iBAAiB,CAAC;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACtB,IAAI,IAAI,OAAO,GAAG,OAAO,KAAK,IAAI,CAAC;YACvC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjB,IAAI,IAAI,+BAA+B,CAAC;QACxC,IAAI,IAAI,eAAe,KAAK,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC;QACjD,IAAI,IAAI,kBAAkB,KAAK,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC;QACzD,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC7B,IAAI,IAAI,OAAO,KAAK,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC;QAClD,CAAC;IACL,CAAC;IAED,OAAO;QACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,KAAK,CAAC,QAAQ;KAC9B,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC7B,QAAgB,EAChB,OAAkC;IAElC,OAAO,KAAK,EAAE,IAAO,EAAE,EAAE;QACrB,IAAI,CAAC;YACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBAChC,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,yCAAyC;YACzC,MAAM,UAAU,GAAG,IAAI,YAAY,CAC/B,sBAAsB,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,EAClD,kBAAkB,EAClB;gBACI,QAAQ,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uCAAuC;oBACpD,aAAa,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE;oBAC7E,mBAAmB,EAAE,KAAK;iBAC7B;gBACD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACpD,CACJ,CAAC;YACF,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/dist/flows/onboarding-orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-orchestrator.d.ts","sourceRoot":"","sources":["../../src/flows/onboarding-orchestrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,mBAAmB,CAAC;AAmBnE,UAAU,0BAA0B;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC;AA6ED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC,CA8DlG;AAwRD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;CAsBxC,CAAC"}
+{"version":3,"file":"onboarding-orchestrator.d.ts","sourceRoot":"","sources":["../../src/flows/onboarding-orchestrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,mBAAmB,CAAC;AAuBnE,UAAU,0BAA0B;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC;AA+BD;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC,CA8DlG;AA0WD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;CAsBxC,CAAC"}