@nodetool-ai/cli 0.7.0-rc.23 → 0.8.1

package/dist/app-debug/app-target.js

@@ -0,0 +1,120 @@
+/**
+ * Resolves an app debug target into an application document plus the graphs it
+ * runs.
+ *
+ * An app can be named three ways, and all three end up in the same shape:
+ *
+ * - an **application id** — the canonical form, read from the applications
+ *   table through an injected loader (no server involved) and resolved by
+ *   `applicationTarget`, which the server surface calls too;
+ * - an **ApplicationBundle JSON file** — an app together with the full graphs
+ *   of every workflow it binds, where operations reference bundle-local keys;
+ * - a **workflow id or workflow JSON/DSL file** — the legacy form, where the
+ *   document sits on `workflow.app_doc` and is lifted by `liftLegacyAppDoc`.
+ *
+ * The harness downstream sees one shape regardless: a raw document (for the
+ * bundle's `app.json` and persist-downgrade warnings), the parsed document, a
+ * host graph, and the graphs the target itself carries keyed by whatever id
+ * the operations reference.
+ */
+import { liftLegacyAppDoc, parseApplicationBundle } from "@nodetool-ai/app-runtime";
+import { looksLikeFile, normalizeGraph, readFileTarget } from "../debug/target.js";
+// The resolved shape is the simulator's input, and so is the resolution of an
+// application row — both live with the simulator so the CLI and the server
+// surfaces cannot drift.
+import { applicationTarget, bundleTarget } from "@nodetool-ai/execution/app-debug";
+import { isRecord, isString } from "../predicates.js";
+const EMPTY_GRAPH = { nodes: [], edges: [] };
+const targetInfo = (ref, source, workflowId, graph) => ({
+    ref,
+    source,
+    workflowId,
+    nodeCount: graph.nodes.length,
+    edgeCount: graph.edges.length
+});
+/** A bundle file carries `app` and `workflows`; a workflow file carries neither. */
+const looksLikeBundle = (raw) => isRecord(raw) && isRecord(raw.app) && Array.isArray(raw.workflows);
+const graphOf = (value) => {
+    if (!isRecord(value))
+        return null;
+    const { nodes, edges } = value;
+    if (!Array.isArray(nodes) || !Array.isArray(edges))
+        return null;
+    return normalizeGraph({ nodes, edges });
+};
+/** Resolve an ApplicationBundle JSON file. */
+function resolveBundle(ref, raw) {
+    const bundle = parseApplicationBundle(raw);
+    const rawApp = isRecord(raw) ? raw.app : null;
+    if (!bundle) {
+        return {
+            info: targetInfo(ref, "bundle", null, EMPTY_GRAPH),
+            graph: EMPTY_GRAPH,
+            fileParams: {},
+            appDoc: rawApp,
+            document: null,
+            issue: `${ref} is not a valid application bundle (no parsable \`app\` document).`,
+            graphs: new Map(),
+            operationsReferenceKeys: true,
+            appName: null
+        };
+    }
+    // The bundle → target mapping lives with the simulator, so the file path
+    // here and the build harness's in-memory path cannot drift.
+    return bundleTarget(bundle, ref, rawApp);
+}
+/** Resolve a workflow target — id, JSON file, or DSL file — via its `app_doc`. */
+function resolveWorkflow(ref, raw, source) {
+    const record = isRecord(raw) ? raw : {};
+    const workflowId = (isString(record.workflow_id) ? record.workflow_id : null) ??
+        (isString(record.id) ? record.id : null);
+    const rawGraph = graphOf(record.graph) ?? graphOf(record);
+    if (!rawGraph)
+        throw new Error("Invalid workflow: missing nodes or edges");
+    const appDoc = record.app_doc ?? null;
+    const document = liftLegacyAppDoc({ id: workflowId ?? "", app_doc: appDoc });
+    const graphs = new Map();
+    if (workflowId)
+        graphs.set(workflowId, rawGraph);
+    const issue = document
+        ? null
+        : appDoc == null
+            ? "Workflow has no app_doc — build the app in the App Builder first."
+            : "app_doc is not a valid application document (no `ui`/`data`).";
+    return {
+        info: targetInfo(ref, source, workflowId, rawGraph),
+        graph: rawGraph,
+        fileParams: isRecord(record.params) ? { ...record.params } : {},
+        appDoc,
+        document,
+        issue,
+        graphs,
+        operationsReferenceKeys: false,
+        appName: null
+    };
+}
+/**
+ * Resolve an app debug target: an application id, an ApplicationBundle JSON
+ * file, or a workflow id / workflow file carrying a legacy `app_doc`.
+ */
+export async function resolveAppTarget(ref, deps) {
+    if (looksLikeFile(ref)) {
+        const { raw, source } = await readFileTarget(ref);
+        return looksLikeBundle(raw)
+            ? resolveBundle(ref, raw)
+            : resolveWorkflow(ref, raw, source);
+    }
+    if (deps.loadApplication) {
+        const application = await deps.loadApplication(ref);
+        if (application)
+            return applicationTarget(ref, application, deps.loadFromDb);
+    }
+    const workflow = await deps.loadFromDb(ref);
+    if (!workflow) {
+        throw new Error(deps.loadApplication
+            ? `No application or workflow found: ${ref}`
+            : `Workflow not found: ${ref}`);
+    }
+    return resolveWorkflow(ref, { ...workflow, id: ref }, "id");
+}
+//# sourceMappingURL=app-target.js.map

package/dist/app-debug/app-target.js.map

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

package/dist/app-debug/harness.d.ts

@@ -0,0 +1,27 @@
+import { type AppDebugOptions, type AppDebugReport, type JsScriptOperationLoader, type JsScriptOperationRunner } from "@nodetool-ai/execution/app-debug";
+import { type AppTargetDeps } from "./app-target.js";
+import type { DebugGraph } from "../debug/types.js";
+import type { ServerRunInput, ServerRunOutcome } from "../debug/server-runner.js";
+export { defaultInteractions } from "@nodetool-ai/execution/app-debug";
+export interface AppDebugDeps {
+    /** Load a workflow by DB id, including its legacy `app_doc`. */
+    loadFromDb: (id: string) => Promise<{
+        graph: DebugGraph;
+        app_doc?: unknown;
+    } | null>;
+    /**
+     * Load an application by DB id. Without it a bare id is only ever read as a
+     * workflow, which is what a caller with no database wants.
+     */
+    loadApplication?: AppTargetDeps["loadApplication"];
+    /** Progress/log sink. */
+    onLog?: (line: string) => void;
+    /** Injected for tests; defaults to the kernel server runner. */
+    runOnServer?: (input: ServerRunInput) => Promise<ServerRunOutcome>;
+    /** Injected for tests; defaults to the sandbox script runner. */
+    runScript?: JsScriptOperationRunner;
+    /** Resolve a pinned script version an operation targets but the target lacks. */
+    loadScript?: JsScriptOperationLoader;
+}
+export declare function runAppDebug(ref: string, options: AppDebugOptions, deps: AppDebugDeps): Promise<AppDebugReport>;
+//# sourceMappingURL=harness.d.ts.map

package/dist/app-debug/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/app-debug/harness.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAKvE,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,UAAU,EAAE,CACV,EAAE,EAAE,MAAM,KACP,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC9D;;;OAGG;IACH,eAAe,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACnD,yBAAyB;IACzB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gEAAgE;IAChE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnE,iEAAiE;IACjE,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,iFAAiF;IACjF,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC;AAYD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CAmGzB"}

package/dist/app-debug/harness.js

@@ -0,0 +1,93 @@
+/**
+ * The app-builder debug harness: the CLI host around the shared simulator.
+ *
+ * Resolves the target (application id, `ApplicationBundle` file, or workflow
+ * carrying a legacy `app_doc`), runs `simulateApp` from
+ * `@nodetool-ai/execution` — which owns every simulation rule — and writes the
+ * self-contained bundle: the graph, the app document, each run's raw message
+ * stream, and the report in both JSON and Markdown. The `AppDebugReport` comes
+ * back so an agent can iterate without re-reading the bundle.
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { renderAppReportMarkdown, simulateApp } from "@nodetool-ai/execution/app-debug";
+import { resolveAppTarget } from "./app-target.js";
+import { formatRunJson } from "../run-json.js";
+export { defaultInteractions } from "@nodetool-ai/execution/app-debug";
+/** The local single-user id every direct-DB CLI command runs as. */
+const LOCAL_USER_ID = "1";
+function defaultOutDir(ref) {
+    const slug = ref
+        .replace(/[^a-zA-Z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40) || "workflow";
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    return resolve(`nodetool-debug/app-${slug}-${stamp}`);
+}
+export async function runAppDebug(ref, options, deps) {
+    const targetDeps = {
+        loadFromDb: deps.loadFromDb
+    };
+    if (deps.loadApplication) {
+        targetDeps.loadApplication = deps.loadApplication;
+    }
+    const resolved = await resolveAppTarget(ref, targetDeps);
+    const outDir = options.outDir ? resolve(options.outDir) : defaultOutDir(ref);
+    await mkdir(join(outDir, "server"), { recursive: true });
+    await writeFile(join(outDir, "workflow.json"), JSON.stringify(resolved.graph, null, 2), "utf8");
+    if (resolved.appDoc != null) {
+        await writeFile(join(outDir, "app.json"), JSON.stringify(resolved.appDoc, null, 2), "utf8");
+    }
+    // Loaded on first run, not up front: a `--no-run` check must not pull in the
+    // node registries the server runner boots.
+    const runOnServer = deps.runOnServer ??
+        (async (input) => (await import("../debug/server-runner.js")).runOnServer(input));
+    // Both load lazily for the same reason `runOnServer` does: a `--no-run`
+    // check must not pull in the sandbox or the database.
+    const runScript = deps.runScript ??
+        (async (input) => {
+            const { createJsScriptAppRunner } = await import("@nodetool-ai/agents");
+            const { getSecret } = await import("@nodetool-ai/models");
+            return createJsScriptAppRunner(LOCAL_USER_ID, {
+                secretResolver: getSecret
+            })(input);
+        });
+    const loadScript = deps.loadScript ??
+        (async (scriptId, scriptVersion) => {
+            const { createJsScriptResolver } = await import("@nodetool-ai/models");
+            const resolved = await createJsScriptResolver().resolve({
+                id: scriptId,
+                version: scriptVersion
+            });
+            return resolved
+                ? { name: resolved.name, document: resolved.document }
+                : null;
+        });
+    const simulateDeps = {
+        loadFromDb: deps.loadFromDb,
+        runOnServer,
+        runScript,
+        loadScript,
+        onRunMessages: async (runIndex, messages) => {
+            const messagesFile = `server/run-${runIndex + 1}.messages.jsonl`;
+            const lines = [];
+            for (const [messageIndex, message] of messages.entries()) {
+                const { json } = await formatRunJson(message, {
+                    outputDir: join(outDir, "server", `run-${runIndex + 1}-payloads`, `message-${messageIndex + 1}`)
+                });
+                lines.push(JSON.stringify(JSON.parse(json)));
+            }
+            await writeFile(join(outDir, messagesFile), `${lines.join("\n")}\n`, "utf8");
+            return messagesFile;
+        }
+    };
+    if (deps.onLog) {
+        simulateDeps.onLog = deps.onLog;
+    }
+    const report = await simulateApp(resolved, options, simulateDeps);
+    report.bundleDir = outDir;
+    await writeFile(join(outDir, "report.json"), JSON.stringify(report, null, 2), "utf8");
+    await writeFile(join(outDir, "report.md"), renderAppReportMarkdown(report), "utf8");
+    return report;
+}
+//# sourceMappingURL=harness.js.map

package/dist/app-debug/harness.js.map

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

package/dist/app-debug/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The CLI's app-debug surface: target resolution plus the bundle-writing
+ * harness, over the simulator in `@nodetool-ai/execution/app-debug`. The
+ * simulator's exports are re-exported here so importers keep one entry point.
+ */
+export { runAppDebug, defaultInteractions } from "./harness.js";
+export type { AppDebugDeps } from "./harness.js";
+export { resolveAppTarget } from "./app-target.js";
+export type { AppApplicationRecord, AppTargetDeps, AppWorkflowRecord } from "./app-target.js";
+export { bindingScopeFor, documentOperations, effectiveTimeoutMs, extractAppIO, HeadlessAppRuntime, InMemoryResourceProvider, operationSpec, parseAppDocument, parseAppSpec, renderAppReportMarkdown, seedResourceHint, simulateApp, validateApp } from "@nodetool-ai/execution/app-debug";
+export type * from "@nodetool-ai/execution/app-debug";
+//# sourceMappingURL=index.d.ts.map

package/dist/app-debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app-debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACZ,MAAM,kCAAkC,CAAC;AAC1C,mBAAmB,kCAAkC,CAAC"}

package/dist/app-debug/index.js

@@ -0,0 +1,9 @@
+/**
+ * The CLI's app-debug surface: target resolution plus the bundle-writing
+ * harness, over the simulator in `@nodetool-ai/execution/app-debug`. The
+ * simulator's exports are re-exported here so importers keep one entry point.
+ */
+export { runAppDebug, defaultInteractions } from "./harness.js";
+export { resolveAppTarget } from "./app-target.js";
+export { bindingScopeFor, documentOperations, effectiveTimeoutMs, extractAppIO, HeadlessAppRuntime, InMemoryResourceProvider, operationSpec, parseAppDocument, parseAppSpec, renderAppReportMarkdown, seedResourceHint, simulateApp, validateApp } from "@nodetool-ai/execution/app-debug";
+//# sourceMappingURL=index.js.map

package/dist/app-debug/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app-debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACZ,MAAM,kCAAkC,CAAC"}

package/dist/app.d.ts

@@ -1,50 +1,40 @@
-/**
- * NodeTool Chat CLI — Ink-based terminal UI.
- *
- * Layout:
- *   ╭─ nodetool ─────────────────── provider · model ─╮
- *   │                                                  │
- *   │  You: message                                    │
- *   │                                                  │
- *   │  response with markdown                          │
- *   │                                                  │
- *   │  ◆ tool_name result preview                      │
- *   │                                                  │
- *   ├──────────────────────────────────────────────────┤
- *   │ › input                                          │
- *   ╰──────────────────────────────────────────────────╯
- */
-export interface ChatMessage {
-    id: string;
-    role: "user" | "assistant" | "tool" | "system";
-    content: string;
-    toolName?: string;
-    toolArgs?: Record<string, unknown>;
-    rendered?: string;
+import React from "react";
+import type { EventEmitter } from "node:events";
+import { type PermissionMode } from "@nodetool-ai/agents";
+import { ChatSessionStore } from "./chat-sessions.js";
+export type { ChatMessage } from "./terminal-screen.js";
+export interface AppProps {
+    readonly mouseEvents?: EventEmitter;
+    readonly initialProvider: string;
+    readonly initialModel: string;
+    /** `--tools`: narrows the belt to these names. Unset offers the full belt. */
+    readonly enabledTools?: string[];
+    readonly workspaceDir: string;
+    readonly wsUrl?: string;
+    readonly registry?: import("@nodetool-ai/node-sdk").NodeRegistry;
+    readonly agentProviders?: Record<string, import("@nodetool-ai/runtime").BaseProvider>;
+    readonly costCap?: string;
+    readonly timeout?: string;
+    readonly permissionMode?: PermissionMode;
+    readonly enableReadOnlySearch?: boolean;
+    readonly resume?: string | boolean;
+    readonly sessionStore?: ChatSessionStore;
 }
-interface AppProps {
-    initialProvider: string;
-    initialModel: string;
-    initialAgentMode: boolean;
-    /** Initial agent planner type ("graph" or "multi"). Default "graph". */
-    initialAgentPlanner?: "multi" | "graph";
-    enabledTools: string[];
-    workspaceDir: string;
-    wsUrl?: string;
-    /**
-     * Pre-built tools appended to the tool list returned from buildTools().
-     * Used by --sandbox to inject the 37 sandbox-tools adapter instances.
-     */
-    extraTools?: import("@nodetool-ai/agents").Tool[];
-    /**
-     * NodeRegistry for graph-native agent mode. When supplied, agent mode
-     * uses MultiModeAgent + GraphPlanner so the agent builds workflows with
-     * the curated `nodetool.*` core nodes plus a `find_model` tool.
-     */
-    registry?: import("@nodetool-ai/node-sdk").NodeRegistry;
-    /** Configured BaseProvider instances by id for `find_model`. */
-    agentProviders?: Record<string, import("@nodetool-ai/runtime").BaseProvider>;
-}
-export declare function App({ initialProvider, initialModel, initialAgentMode, initialAgentPlanner, enabledTools, workspaceDir, wsUrl, extraTools, registry, agentProviders, }: AppProps): import("react/jsx-runtime").JSX.Element;
-export {};
+export declare const CHAT_COMMANDS: {
+    readonly "/help": "Commands and keyboard shortcuts";
+    readonly "/new": "Start a new conversation";
+    readonly "/clear": "Clear the screen, keep conversation context";
+    readonly "/compact": "Summarize retained context";
+    readonly "/model": "Choose a model";
+    readonly "/agent": "Inspect sub-agent threads: /agent [id|main]";
+    readonly "/mode": "Permissions: default, auto, plan";
+    readonly "/sessions": "Browse saved conversations";
+    readonly "/resume": "Resume a session: /resume <id>";
+    readonly "/export": "Save transcript: /export <path.md>";
+    readonly "/tools": "Show available tools";
+    readonly "/details": "Toggle tool arguments, code and diffs";
+    readonly "/exit": "Save and quit";
+    readonly "/quit": "Save and quit";
+};
+export declare function App({ initialProvider, initialModel, enabledTools, workspaceDir, wsUrl, registry, agentProviders, costCap, timeout, permissionMode, enableReadOnlySearch, resume, sessionStore, mouseEvents }: AppProps): React.ReactElement;
 //# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAqCH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,QAAQ;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,mBAAmB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,qBAAqB,EAAE,IAAI,EAAE,CAAC;IAClD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,uBAAuB,EAAE,YAAY,CAAC;IACxD,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CACrB,MAAM,EACN,OAAO,sBAAsB,EAAE,YAAY,CAC5C,CAAC;CACH;AA0ID,wBAAgB,GAAG,CAAC,EAClB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAA6B,EAC7B,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,UAAU,EACV,QAAQ,EACR,cAAc,GACf,EAAE,QAAQ,2CAkwBV"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAahD,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAsC7B,OAAO,EACL,gBAAgB,EAIjB,MAAM,oBAAoB,CAAC;AAI5B,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,uBAAuB,EAAE,YAAY,CAAC;IACjE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAC9B,MAAM,EACN,OAAO,sBAAsB,EAAE,YAAY,CAC5C,CAAC;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC;CAC1C;AAED,eAAO,MAAM,aAAa;aACxB,OAAO,EAAE,iCAAiC;aAC1C,MAAM,EAAE,0BAA0B;aAClC,QAAQ,EAAE,6CAA6C;aACvD,UAAU,EAAE,4BAA4B;aACxC,QAAQ,EAAE,gBAAgB;aAC1B,QAAQ,EAAE,6CAA6C;aACvD,OAAO,EAAE,kCAAkC;aAC3C,WAAW,EAAE,4BAA4B;aACzC,SAAS,EAAE,gCAAgC;aAC3C,SAAS,EAAE,oCAAoC;aAC/C,QAAQ,EAAE,sBAAsB;aAChC,UAAU,EAAE,uCAAuC;aACnD,OAAO,EAAE,eAAe;aACxB,OAAO,EAAE,eAAe;CAChB,CAAC;AA0DX,wBAAgB,GAAG,CAAC,EAClB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,cAAc,EACd,OAAO,EACP,OAAO,EACP,cAA0B,EAC1B,oBAA2B,EAC3B,MAAM,EACN,YAAY,EACZ,WAAW,EACZ,EAAE,QAAQ,GAAG,KAAK,CAAC,YAAY,CAgxC/B"}