mapples 0.2.0-beta.0 → 0.2.0-beta.10

package/dist/services/agentInstall.d.ts

@@ -0,0 +1,80 @@
+export declare const SUPPORTED_AGENTS: readonly ["claude", "cursor", "codex"];
+export type AgentName = (typeof SUPPORTED_AGENTS)[number];
+/** The `agent` a lease is started with, per installed agent (Creator labels sessions by it). */
+export declare const SESSION_AGENTS: readonly ["claude-code", "cursor", "codex"];
+export type SessionAgent = (typeof SESSION_AGENTS)[number];
+export interface AgentProfile {
+    name: AgentName;
+    /** Shown in Creator (session label, commit summaries) and in the printed next steps. */
+    label: string;
+    sessionAgent: SessionAgent;
+    skillsDir: string;
+    conventionsPath: string;
+    /** How the user runs the design skill in this agent. */
+    designCommand: string;
+    instructions: {
+        file: string;
+        template: string;
+        /** The line that makes the agent read the conventions; appended to an existing file once. */
+        pointer: string;
+    };
+    mcp: {
+        file: string;
+        template: string;
+        /** Present in the file once the Mapples server is configured. */
+        marker: string;
+    };
+    /** Prompt/stop hooks that hold the lease while the agent works on a request. */
+    hooks: {
+        file: string;
+        template: string;
+        marker: string;
+    };
+    /** The shell line that starts the agent with the key in its environment (MCP reads it). */
+    restart: string;
+}
+export declare const AGENT_PROFILES: Record<AgentName, AgentProfile>;
+/** Validates the `--agent` option; undefined when not given. */
+export declare function parseAgentName(value: unknown): AgentName | undefined;
+/** Validates `agent start --agent`; the session agent recorded for Creator. */
+export declare function parseSessionAgent(value: unknown): SessionAgent;
+/** The default session label for a session agent. */
+export declare function sessionAgentLabel(agent: SessionAgent): string;
+/** The marker every generated Markdown file carries (line 1, or right after its frontmatter). */
+export declare const GENERATED_HEADER: RegExp;
+/**
+ * Whether the CLI generated this file: the header opens the file, or — for
+ * skills, whose YAML frontmatter must be the first thing the agent reads —
+ * it is the first line after the frontmatter block.
+ */
+export declare function isGeneratedFile(content: string): boolean;
+export interface InstallOptions {
+    apiUrl: string;
+    force?: boolean;
+    routesDir?: string;
+    pagesDir?: string;
+    componentsDir?: string;
+}
+export interface InstallOutcome {
+    file: string;
+    action: 'created' | 'updated' | 'unchanged' | 'skipped' | 'appended' | 'deprecated';
+    detail?: string;
+}
+export interface InstallResult {
+    agent: AgentName;
+    outcomes: InstallOutcome[];
+    /** The MCP entry the user has to merge by hand when the agent's MCP config already existed. */
+    mcpSnippet: string | null;
+    /** The lease hooks the user has to merge by hand when the agent's hook file already existed. */
+    hooksSnippet: string | null;
+}
+export declare function agentTemplatesDir(): string;
+/** The agent's MCP config for this API, as the installer writes it. */
+export declare function mcpConfigFor(agent: AgentName, apiUrl: string): string;
+export declare function installAgentIntegration(root: string, agent: AgentName, options: InstallOptions): InstallResult;
+/** The lines printed after create/init/install with `--agent <name>`. */
+export declare function agentNextSteps(agent: AgentName, appDir: string | null): string[];
+/** The line that introduces a printed MCP snippet. */
+export declare function mcpSnippetHeading(agent: AgentName): string;
+/** The line that introduces a printed hooks snippet. */
+export declare function hooksSnippetHeading(agent: AgentName): string;

package/dist/services/agentInstall.js

@@ -0,0 +1,309 @@
+// `--agent <name>` / `mapples agent install`: puts the agent bundle
+// (templates/agent) into an app — project-local skills, the conventions
+// file, a pointer in the agent's instructions file, and the read-only MCP
+// entry — in the places each agent reads them:
+//
+//   claude  .claude/skills, .claude/mapples.md, CLAUDE.md, .mcp.json
+//   cursor  .cursor/skills, .cursor/mapples.md, AGENTS.md, .cursor/mcp.json
+//   codex   .agents/skills, .agents/mapples.md, AGENTS.md, .codex/config.toml
+//
+// Files the CLI generated are refreshed in place (recognised by their
+// GENERATED header); a file the user edited is never overwritten — it is
+// skipped, or with --force deprecated (`_depr_<ts>_…old`) and regenerated.
+// An instructions file or MCP config the user already has is never rewritten:
+// the pointer line is appended once, the MCP entry is printed for them to add.
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { deprecateFile } from '../merge/deprecate.js';
+import { AGENT_STATE_GITIGNORE } from '../project/agentState.js';
+import { DEFAULT_COMPONENTS_DIR, DEFAULT_PAGES_DIR, DEFAULT_ROUTES_DIR, } from '../project/config.js';
+import { ensureGitignored } from '../project/secret.js';
+import { cliVersion } from '../version.js';
+import { templatesDir } from './scaffold.js';
+export const SUPPORTED_AGENTS = ['claude', 'cursor', 'codex'];
+/** `--agent` spellings that name the same agent (ChatGPT's coding agent is Codex). */
+const AGENT_ALIASES = { chatgpt: 'codex' };
+/** The `agent` a lease is started with, per installed agent (Creator labels sessions by it). */
+export const SESSION_AGENTS = ['claude-code', 'cursor', 'codex'];
+export const AGENT_PROFILES = {
+    claude: {
+        name: 'claude',
+        label: 'Claude Code',
+        sessionAgent: 'claude-code',
+        skillsDir: '.claude/skills',
+        conventionsPath: '.claude/mapples.md',
+        designCommand: '/mapples-design',
+        instructions: {
+            file: 'CLAUDE.md',
+            template: 'claude/CLAUDE.md',
+            pointer: '@.claude/mapples.md',
+        },
+        mcp: { file: '.mcp.json', template: 'claude/mcp.json', marker: '"mapples"' },
+        hooks: {
+            file: '.claude/settings.json',
+            template: 'claude/settings.json',
+            marker: 'agent hook prompt',
+        },
+        restart: 'MAPPLES_SECRET=$(cat .mapples/secret) claude',
+    },
+    cursor: {
+        name: 'cursor',
+        label: 'Cursor',
+        sessionAgent: 'cursor',
+        skillsDir: '.cursor/skills',
+        conventionsPath: '.cursor/mapples.md',
+        designCommand: '/mapples-design',
+        instructions: {
+            file: 'AGENTS.md',
+            template: 'agents-md/AGENTS.md',
+            pointer: '- Cursor: read `.cursor/mapples.md`.',
+        },
+        mcp: { file: '.cursor/mcp.json', template: 'cursor/mcp.json', marker: '"mapples"' },
+        hooks: {
+            file: '.cursor/hooks.json',
+            template: 'cursor/hooks.json',
+            marker: 'agent hook prompt',
+        },
+        restart: 'MAPPLES_SECRET=$(cat .mapples/secret) cursor .',
+    },
+    codex: {
+        name: 'codex',
+        label: 'Codex',
+        sessionAgent: 'codex',
+        skillsDir: '.agents/skills',
+        conventionsPath: '.agents/mapples.md',
+        designCommand: '$mapples-design',
+        instructions: {
+            file: 'AGENTS.md',
+            template: 'agents-md/AGENTS.md',
+            pointer: '- Codex: read `.agents/mapples.md`.',
+        },
+        mcp: {
+            file: '.codex/config.toml',
+            template: 'codex/config.toml',
+            marker: '[mcp_servers.mapples]',
+        },
+        hooks: { file: '.codex/hooks.json', template: 'codex/hooks.json', marker: 'agent hook prompt' },
+        restart: 'MAPPLES_SECRET=$(cat .mapples/secret) codex',
+    },
+};
+/** The agent a `--agent` spelling names (aliases resolved), or null. */
+function agentNameOf(value) {
+    if (typeof value !== 'string')
+        return null;
+    const name = value.toLowerCase();
+    if (SUPPORTED_AGENTS.includes(name))
+        return name;
+    return AGENT_ALIASES[name] ?? null;
+}
+/** Validates the `--agent` option; undefined when not given. */
+export function parseAgentName(value) {
+    if (value === undefined)
+        return undefined;
+    const name = agentNameOf(value);
+    if (name)
+        return name;
+    throw new Error(`unknown --agent "${String(value)}" — supported: ${SUPPORTED_AGENTS.join(', ')} (chatgpt = codex)`);
+}
+/** Validates `agent start --agent`; the session agent recorded for Creator. */
+export function parseSessionAgent(value) {
+    if (value === undefined)
+        return 'claude-code';
+    if (typeof value === 'string' && SESSION_AGENTS.includes(value)) {
+        return value;
+    }
+    const installed = agentNameOf(value);
+    if (installed)
+        return AGENT_PROFILES[installed].sessionAgent;
+    throw new Error(`unknown session agent "${String(value)}" — supported: ${SESSION_AGENTS.join(', ')}`);
+}
+/** The default session label for a session agent. */
+export function sessionAgentLabel(agent) {
+    return Object.values(AGENT_PROFILES).find((p) => p.sessionAgent === agent).label;
+}
+/** The marker every generated Markdown file carries (line 1, or right after its frontmatter). */
+export const GENERATED_HEADER = /^<!--\s*GENERATED by Mapples\b/;
+/**
+ * Whether the CLI generated this file: the header opens the file, or — for
+ * skills, whose YAML frontmatter must be the first thing the agent reads —
+ * it is the first line after the frontmatter block.
+ */
+export function isGeneratedFile(content) {
+    const lines = content.split('\n');
+    if (GENERATED_HEADER.test(lines[0] ?? ''))
+        return true;
+    if (lines[0]?.trim() !== '---')
+        return false;
+    const close = lines.findIndex((line, i) => i > 0 && line.trim() === '---');
+    if (close < 0)
+        return false;
+    const afterFrontmatter = lines.slice(close + 1).find((line) => line.trim() !== '');
+    return GENERATED_HEADER.test(afterFrontmatter ?? '');
+}
+export function agentTemplatesDir() {
+    return join(templatesDir(), 'agent');
+}
+function substitute(content, profile, opts) {
+    return content
+        .replaceAll('__CLI_VERSION__', cliVersion())
+        .replaceAll('__API_URL__', opts.apiUrl.replace(/\/+$/, ''))
+        .replaceAll('__ROUTES_DIR__', opts.routesDir)
+        .replaceAll('__PAGES_DIR__', opts.pagesDir)
+        .replaceAll('__COMPONENTS_DIR__', opts.componentsDir)
+        .replaceAll('__SKILLS_DIR__', profile.skillsDir)
+        .replaceAll('__CONVENTIONS_PATH__', profile.conventionsPath)
+        .replaceAll('__DESIGN_COMMAND__', profile.designCommand)
+        .replaceAll('__AGENT_LABEL__', profile.label)
+        .replaceAll('__AGENT_ID__', profile.sessionAgent)
+        .replaceAll('__AGENT_FLAG__', profile.name)
+        .replaceAll('__AGENT_RESTART__', profile.restart)
+        .replaceAll('__AGENTS_MD_POINTER__', profile.instructions.pointer);
+}
+function resolveOptions(options) {
+    return {
+        apiUrl: options.apiUrl,
+        force: options.force === true,
+        routesDir: options.routesDir ?? DEFAULT_ROUTES_DIR,
+        pagesDir: options.pagesDir ?? DEFAULT_PAGES_DIR,
+        componentsDir: options.componentsDir ?? DEFAULT_COMPONENTS_DIR,
+    };
+}
+/** The agent's MCP config for this API, as the installer writes it. */
+export function mcpConfigFor(agent, apiUrl) {
+    const profile = AGENT_PROFILES[agent];
+    return substitute(readFileSync(join(agentTemplatesDir(), profile.mcp.template), 'utf8'), profile, resolveOptions({ apiUrl }));
+}
+/** Write a generated file, honouring the header handshake. */
+function placeGenerated(root, rel, content, force, outcomes) {
+    const abs = join(root, rel);
+    if (existsSync(abs)) {
+        const current = readFileSync(abs, 'utf8');
+        if (current === content) {
+            outcomes.push({ file: rel, action: 'unchanged' });
+            return;
+        }
+        if (!isGeneratedFile(current)) {
+            if (!force) {
+                outcomes.push({
+                    file: rel,
+                    action: 'skipped',
+                    detail: 'edited by you — kept (re-run with --force to regenerate)',
+                });
+                return;
+            }
+            const kept = deprecateFile(abs);
+            outcomes.push({
+                file: rel,
+                action: 'deprecated',
+                detail: `your version is kept at ${kept.slice(root.length + 1)}`,
+            });
+            writeFileSync(abs, content);
+            return;
+        }
+        writeFileSync(abs, content);
+        outcomes.push({ file: rel, action: 'updated' });
+        return;
+    }
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, content);
+    outcomes.push({ file: rel, action: 'created' });
+}
+/**
+ * A config file the agent reads whole (MCP servers, hooks): created when
+ * absent, left alone when it already carries our entry, and otherwise never
+ * rewritten — the snippet comes back for the user to merge.
+ */
+function placeConfigOnce(root, target, content, outcomes, what) {
+    const abs = join(root, target.file);
+    if (!existsSync(abs)) {
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, content);
+        outcomes.push({ file: target.file, action: 'created' });
+        return null;
+    }
+    if (readFileSync(abs, 'utf8').includes(target.marker)) {
+        outcomes.push({ file: target.file, action: 'unchanged' });
+        return null;
+    }
+    outcomes.push({
+        file: target.file,
+        action: 'skipped',
+        detail: `exists — add ${what} yourself (snippet printed below)`,
+    });
+    return content;
+}
+function walk(dir, rel = '') {
+    const out = [];
+    for (const entry of readdirSync(join(dir, rel), { withFileTypes: true })) {
+        const relPath = rel ? join(rel, entry.name) : entry.name;
+        if (entry.isDirectory())
+            out.push(...walk(dir, relPath));
+        else
+            out.push(relPath);
+    }
+    return out.sort();
+}
+export function installAgentIntegration(root, agent, options) {
+    const profile = AGENT_PROFILES[agent];
+    const opts = resolveOptions(options);
+    const src = agentTemplatesDir();
+    const outcomes = [];
+    const read = (rel) => substitute(readFileSync(join(src, rel), 'utf8'), profile, opts);
+    // Skills: templates/agent/skills/** -> <skillsDir>/**
+    for (const rel of walk(join(src, 'skills'))) {
+        placeGenerated(root, join(profile.skillsDir, rel), read(join('skills', rel)), opts.force, outcomes);
+    }
+    // Conventions: templates/agent/mapples.md -> <conventionsPath>
+    placeGenerated(root, profile.conventionsPath, read('mapples.md'), opts.force, outcomes);
+    // Instructions file: created from the template when absent; otherwise only
+    // the pointer line is appended — the user's instructions are theirs.
+    const instructions = join(root, profile.instructions.file);
+    const pointer = profile.instructions.pointer;
+    if (!existsSync(instructions)) {
+        writeFileSync(instructions, read(profile.instructions.template));
+        outcomes.push({ file: profile.instructions.file, action: 'created' });
+    }
+    else {
+        const current = readFileSync(instructions, 'utf8');
+        if (current.split('\n').some((line) => line.trim() === pointer)) {
+            outcomes.push({ file: profile.instructions.file, action: 'unchanged' });
+        }
+        else {
+            writeFileSync(instructions, current + (current.endsWith('\n') || current === '' ? '' : '\n') + `\n${pointer}\n`);
+            outcomes.push({ file: profile.instructions.file, action: 'appended', detail: pointer });
+        }
+    }
+    // MCP config and lease hooks: written once; an existing file is never
+    // touched (the user may have other servers or hooks there) — the snippet
+    // is returned for them to merge.
+    const mcpSnippet = placeConfigOnce(root, profile.mcp, read(profile.mcp.template), outcomes, 'the "mapples" server');
+    const hooksSnippet = placeConfigOnce(root, profile.hooks, read(profile.hooks.template), outcomes, 'the Mapples lease hooks');
+    if (ensureGitignored(root, [AGENT_STATE_GITIGNORE])) {
+        outcomes.push({ file: '.gitignore', action: 'appended', detail: AGENT_STATE_GITIGNORE });
+    }
+    return { agent, outcomes, mcpSnippet, hooksSnippet };
+}
+/** The lines printed after create/init/install with `--agent <name>`. */
+export function agentNextSteps(agent, appDir) {
+    const profile = AGENT_PROFILES[agent];
+    const cd = appDir ? `cd ${appDir} && ` : '';
+    const where = {
+        claude: 'then type',
+        cursor: 'then in Agent chat type',
+        codex: 'trust the project when Codex asks and approve its hooks with /hooks (they load from .codex/), then type',
+    };
+    return [
+        `${profile.label} is set up. Start it with the project key in the environment:`,
+        `  ${cd}${profile.restart}`,
+        `${where[agent]}  ${profile.designCommand}  and describe your app.`,
+    ];
+}
+/** The line that introduces a printed MCP snippet. */
+export function mcpSnippetHeading(agent) {
+    return `Add this to your ${AGENT_PROFILES[agent].mcp.file}:`;
+}
+/** The line that introduces a printed hooks snippet. */
+export function hooksSnippetHeading(agent) {
+    return `Add these hooks to your ${AGENT_PROFILES[agent].hooks.file} (they show the agent as working in Creator):`;
+}
+//# sourceMappingURL=agentInstall.js.map

package/dist/services/agentInstall.js.map

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

package/dist/services/agentLease.d.ts

@@ -0,0 +1,2 @@
+import type { SyncReport } from '../ui/report.js';
+export declare function touchAgentLease(root: string, report: SyncReport, opts?: Record<string, unknown>): Promise<'touched' | 'none' | 'missed'>;

package/dist/services/agentLease.js

@@ -0,0 +1,32 @@
+// Belt and braces for the agent lease: every `mapples sync` / `mapples adopt`
+// run inside an agent session heartbeats the lease before and after its
+// work, so a long push cannot let the 90 s lease lapse even if the daemon
+// died. Never fatal — a sync must not fail because a keep-alive did not
+// land — but every miss is written into the report.
+import { AgentSessionError } from '../api/agent.js';
+import { isNetworkError } from '../api/client.js';
+import { readAgentState } from '../project/agentState.js';
+import { agentClientForApp } from './clientFactory.js';
+export async function touchAgentLease(root, report, opts = {}) {
+    const state = readAgentState(root);
+    if (!state)
+        return 'none';
+    try {
+        await agentClientForApp(root, opts).heartbeat(state.uuid);
+        return 'touched';
+    }
+    catch (err) {
+        if (err instanceof AgentSessionError) {
+            report.notes.push(err.code === 'SESSION_GONE'
+                ? `agent session ${state.uuid} is no longer active (${err.message}) — run \`mapples agent stop\``
+                : `agent session heartbeat refused (${err.code}: ${err.message})`);
+            return 'missed';
+        }
+        if (isNetworkError(err)) {
+            report.notes.push(`agent session heartbeat did not reach ${state.apiUrl} (network error)`);
+            return 'missed';
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=agentLease.js.map

package/dist/services/agentLease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentLease.js","sourceRoot":"","sources":["../../src/services/agentLease.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wEAAwE;AACxE,0EAA0E;AAC1E,wEAAwE;AACxE,oDAAoD;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,MAAkB,EAClB,OAAgC,EAAE;IAElC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,iBAAiB,EAAE,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,IAAI,CACf,GAAG,CAAC,IAAI,KAAK,cAAc;gBACzB,CAAC,CAAC,iBAAiB,KAAK,CAAC,IAAI,yBAAyB,GAAG,CAAC,OAAO,gCAAgC;gBACjG,CAAC,CAAC,oCAAoC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,GAAG,CACpE,CAAC;YACF,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,yCAAyC,KAAK,CAAC,MAAM,kBAAkB,CAAC,CAAC;YAC3F,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/services/clientFactory.d.ts

@@ -1,2 +1,4 @@
+import { AgentSessionClient } from '../api/agent.js';
 import { JpatchClient } from '../api/client.js';
 export declare function clientForApp(root: string, opts: Record<string, unknown>): JpatchClient;
+export declare function agentClientForApp(root: string, opts: Record<string, unknown>): AgentSessionClient;

package/dist/services/clientFactory.js

@@ -1,18 +1,35 @@
-// Builds the JPATCH client for commands running inside a linked app: config
+// Builds the API clients for commands running inside a linked app: config
 // gives the project id, .mapples/secret (or MAPPLES_SECRET) authenticates, and
 // the internal --denv flag can point a single run at another stage.
+import { AgentSessionClient } from '../api/agent.js';
 import { JpatchClient } from '../api/client.js';
+import { agentCommitSummary, readAgentState } from '../project/agentState.js';
 import { readConfig } from '../project/config.js';
-import { resolveApiUrl } from '../project/env.js';
+import { assetUrlFor, resolveApiUrl } from '../project/env.js';
 import { readSecret } from '../project/secret.js';
 import { cliOrigin } from '../version.js';
 export function clientForApp(root, opts) {
     const config = readConfig(root);
+    const baseUrl = resolveApiUrl({ denv: opts.denv, configuredUrl: config.apiUrl });
+    // While an agent session holds the project, its commits are attributed to
+    // the agent's current step in Creator's history (RFC-0001 §5.1 meta.summary).
+    const agent = readAgentState(root);
     return new JpatchClient({
-        baseUrl: resolveApiUrl({ denv: opts.denv, configuredUrl: config.apiUrl }),
+        baseUrl,
+        assetsBaseUrl: assetUrlFor(baseUrl),
         projectId: config.projectId,
         token: readSecret(root),
         origin: cliOrigin(),
+        ...(agent ? { summary: agentCommitSummary(agent) } : {}),
+    });
+}
+export function agentClientForApp(root, opts) {
+    const config = readConfig(root);
+    const baseUrl = resolveApiUrl({ denv: opts.denv, configuredUrl: config.apiUrl });
+    return new AgentSessionClient({
+        baseUrl,
+        projectId: config.projectId,
+        token: readSecret(root),
     });
 }
 //# sourceMappingURL=clientFactory.js.map

package/dist/services/clientFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"clientFactory.js","sourceRoot":"","sources":["../../src/services/clientFactory.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,+EAA+E;AAC/E,oEAAoE;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAA6B;IACtE,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,IAAI,YAAY,CAAC;QACtB,OAAO,EAAE,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACzE,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC;QACvB,MAAM,EAAE,SAAS,EAAE;KACpB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"clientFactory.js","sourceRoot":"","sources":["../../src/services/clientFactory.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,+EAA+E;AAC/E,oEAAoE;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAA6B;IACtE,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,0EAA0E;IAC1E,8EAA8E;IAC9E,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,YAAY,CAAC;QACtB,OAAO;QACP,aAAa,EAAE,WAAW,CAAC,OAAO,CAAC;QACnC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC;QACvB,MAAM,EAAE,SAAS,EAAE;QACnB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAA6B;IAC3E,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,OAAO,IAAI,kBAAkB,CAAC;QAC5B,OAAO;QACP,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC;KACxB,CAAC,CAAC;AACL,CAAC"}