@soleri/core 9.5.0 → 9.6.0

package/dist/adapters/claude-code-adapter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ClaudeCodeRuntimeAdapter — RuntimeAdapter implementation for Claude Code CLI.
+ *
+ * Thin wrapper around a dispatch function (actual child process spawning is #411).
+ * Provides environment detection, session codec, and skill sync.
+ */
+import type { RuntimeAdapter, AdapterExecutionContext, AdapterExecutionResult, AdapterSessionCodec, AdapterEnvironmentTestResult } from './types.js';
+import type { SkillEntry } from '../skills/sync-skills.js';
+/** Dispatch function signature — injected via constructor */
+export type ClaudeCodeDispatchFn = (prompt: string, workspace: string, config?: Record<string, unknown>) => Promise<{
+    exitCode: number;
+    output?: string;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}>;
+export declare class ClaudeCodeRuntimeAdapter implements RuntimeAdapter {
+    readonly type: "claude-code";
+    readonly sessionCodec: AdapterSessionCodec;
+    private readonly dispatch;
+    constructor(dispatch?: ClaudeCodeDispatchFn);
+    execute(ctx: AdapterExecutionContext): Promise<AdapterExecutionResult>;
+    testEnvironment(): Promise<AdapterEnvironmentTestResult>;
+    syncSkills(skills: SkillEntry[]): Promise<void>;
+}
+//# sourceMappingURL=claude-code-adapter.d.ts.map

package/dist/adapters/claude-code-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-code-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EAEtB,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAU3D,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD,CAAC,CAAC;AAqBH,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,YAAY,sBAA0B;IAE/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;gBAEhD,QAAQ,CAAC,EAAE,oBAAoB;IAMrC,OAAO,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAoCtE,eAAe,IAAI,OAAO,CAAC,4BAA4B,CAAC;IA+BxD,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAyBtD"}

package/dist/adapters/claude-code-adapter.js

@@ -0,0 +1,111 @@
+/**
+ * ClaudeCodeRuntimeAdapter — RuntimeAdapter implementation for Claude Code CLI.
+ *
+ * Thin wrapper around a dispatch function (actual child process spawning is #411).
+ * Provides environment detection, session codec, and skill sync.
+ */
+import { execSync } from 'node:child_process';
+import { platform } from 'node:os';
+// ─── Session Codec ───────────────────────────────────────────────────
+const claudeCodeSessionCodec = {
+    serialize(state) {
+        return JSON.stringify(state);
+    },
+    deserialize(serialized) {
+        return JSON.parse(serialized);
+    },
+    getDisplayId(state) {
+        const data = state.data;
+        return data.sessionId ?? 'unknown';
+    },
+};
+// ─── Adapter ─────────────────────────────────────────────────────────
+export class ClaudeCodeRuntimeAdapter {
+    type = 'claude-code';
+    sessionCodec = claudeCodeSessionCodec;
+    dispatch;
+    constructor(dispatch) {
+        this.dispatch = dispatch;
+    }
+    // ── Execute ──────────────────────────────────────────────────────
+    async execute(ctx) {
+        if (!this.dispatch) {
+            return {
+                exitCode: 1,
+                summary: 'No dispatch function configured — cannot execute.',
+            };
+        }
+        ctx.onLog?.(`[claude-code] Executing run ${ctx.runId} in ${ctx.workspace}`);
+        const result = await this.dispatch(ctx.prompt, ctx.workspace, ctx.config);
+        const executionResult = {
+            exitCode: result.exitCode,
+            provider: 'anthropic',
+            summary: result.output,
+        };
+        if (result.usage) {
+            executionResult.usage = {
+                inputTokens: result.usage.inputTokens,
+                outputTokens: result.usage.outputTokens,
+                totalTokens: (result.usage.inputTokens ?? 0) + (result.usage.outputTokens ?? 0),
+            };
+        }
+        // Propagate session state if the incoming context had one
+        if (ctx.session) {
+            executionResult.sessionState = ctx.session;
+        }
+        return executionResult;
+    }
+    // ── Environment Test ─────────────────────────────────────────────
+    async testEnvironment() {
+        try {
+            const cmd = platform() === 'win32' ? 'where claude' : 'which claude';
+            const cliPath = execSync(cmd, { encoding: 'utf-8', timeout: 5_000 }).trim();
+            // Try to get version
+            let version;
+            try {
+                version = execSync('claude --version', {
+                    encoding: 'utf-8',
+                    timeout: 5_000,
+                }).trim();
+            }
+            catch {
+                // Version detection is optional — CLI may not support --version
+            }
+            return {
+                available: true,
+                version,
+                details: { path: cliPath },
+            };
+        }
+        catch (err) {
+            return {
+                available: false,
+                error: err instanceof Error ? err.message : 'Claude CLI not found in PATH',
+            };
+        }
+    }
+    // ── Skill Sync ───────────────────────────────────────────────────
+    async syncSkills(skills) {
+        if (skills.length === 0)
+            return;
+        try {
+            // Dynamic import to avoid hard failure if sync-skills is unavailable
+            const { syncSkillsToClaudeCode } = await import('../skills/sync-skills.js');
+            // syncSkillsToClaudeCode expects directories, but we have individual
+            // SkillEntry items. Extract unique parent directories from source paths.
+            const dirs = [
+                ...new Set(skills.map((s) => {
+                    // sourcePath is typically <dir>/<skill-name>/SKILL.md — go up two levels
+                    const parts = s.sourcePath.split('/');
+                    // Remove filename and skill folder to get the skills root dir
+                    return parts.slice(0, -2).join('/');
+                })),
+            ];
+            syncSkillsToClaudeCode(dirs);
+        }
+        catch {
+            // Graceful degradation — skill sync is optional
+        }
+    }
+}
+//# sourceMappingURL=claude-code-adapter.js.map

package/dist/adapters/claude-code-adapter.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Runtime adapter abstraction — dispatch work to any AI CLI.
+ *
+ * @module adapters
+ */
+export type { RuntimeAdapter, AdapterExecutionContext, AdapterExecutionResult, AdapterTokenUsage, AdapterSessionState, AdapterSessionCodec, AdapterEnvironmentTestResult, } from './types.js';
+export { RuntimeAdapterRegistry } from './registry.js';
+export { ClaudeCodeRuntimeAdapter } from './claude-code-adapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,10 @@
+/**
+ * Runtime adapter abstraction — dispatch work to any AI CLI.
+ *
+ * @module adapters
+ */
+// Registry
+export { RuntimeAdapterRegistry } from './registry.js';
+// Built-in adapters
+export { ClaudeCodeRuntimeAdapter } from './claude-code-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,WAAW;AACX,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,oBAAoB;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/adapters/registry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * RuntimeAdapterRegistry — simple Map-backed registry for runtime adapters.
+ *
+ * Adapters register at engine startup. No dynamic loading.
+ */
+import type { RuntimeAdapter } from './types.js';
+export declare class RuntimeAdapterRegistry {
+    private readonly adapters;
+    private defaultType;
+    /** Register an adapter. Throws if the type is already registered. */
+    register(type: string, adapter: RuntimeAdapter): void;
+    /** Get an adapter by type. Throws if not found. */
+    get(type: string): RuntimeAdapter;
+    /** List all registered adapter type strings. */
+    list(): string[];
+    /** Set the default adapter type. Throws if the type is not registered. */
+    setDefault(type: string): void;
+    /** Get the default adapter. Throws if no default is set. */
+    getDefault(): RuntimeAdapter;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/adapters/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/adapters/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,WAAW,CAAqB;IAExC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAOrD,mDAAmD;IACnD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAWjC,gDAAgD;IAChD,IAAI,IAAI,MAAM,EAAE;IAIhB,0EAA0E;IAC1E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO9B,4DAA4D;IAC5D,UAAU,IAAI,cAAc;CAM7B"}

package/dist/adapters/registry.js

@@ -0,0 +1,44 @@
+/**
+ * RuntimeAdapterRegistry — simple Map-backed registry for runtime adapters.
+ *
+ * Adapters register at engine startup. No dynamic loading.
+ */
+export class RuntimeAdapterRegistry {
+    adapters = new Map();
+    defaultType;
+    /** Register an adapter. Throws if the type is already registered. */
+    register(type, adapter) {
+        if (this.adapters.has(type)) {
+            throw new Error(`RuntimeAdapterRegistry: adapter type "${type}" is already registered.`);
+        }
+        this.adapters.set(type, adapter);
+    }
+    /** Get an adapter by type. Throws if not found. */
+    get(type) {
+        const adapter = this.adapters.get(type);
+        if (!adapter) {
+            const available = this.list().join(', ') || '(none)';
+            throw new Error(`RuntimeAdapterRegistry: unknown adapter type "${type}". Registered: ${available}`);
+        }
+        return adapter;
+    }
+    /** List all registered adapter type strings. */
+    list() {
+        return [...this.adapters.keys()];
+    }
+    /** Set the default adapter type. Throws if the type is not registered. */
+    setDefault(type) {
+        if (!this.adapters.has(type)) {
+            throw new Error(`RuntimeAdapterRegistry: cannot set default to unregistered type "${type}".`);
+        }
+        this.defaultType = type;
+    }
+    /** Get the default adapter. Throws if no default is set. */
+    getDefault() {
+        if (!this.defaultType) {
+            throw new Error('RuntimeAdapterRegistry: no default adapter has been set.');
+        }
+        return this.get(this.defaultType);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/adapters/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/adapters/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,OAAO,sBAAsB;IAChB,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,WAAW,CAAqB;IAExC,qEAAqE;IACrE,QAAQ,CAAC,IAAY,EAAE,OAAuB;QAC5C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,0BAA0B,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,mDAAmD;IACnD,GAAG,CAAC,IAAY;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;YACrD,MAAM,IAAI,KAAK,CACb,iDAAiD,IAAI,kBAAkB,SAAS,EAAE,CACnF,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,gDAAgD;IAChD,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,0EAA0E;IAC1E,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,oEAAoE,IAAI,IAAI,CAAC,CAAC;QAChG,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,4DAA4D;IAC5D,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Runtime adapter abstraction — dispatch work to any AI CLI.
+ *
+ * SEPARATE from enforcement HostAdapter (which translates rules).
+ * This is about executing tasks on different runtimes (Claude Code, Codex, Cursor, etc.)
+ *
+ * Inspired by Paperclip AI's ServerAdapterModule pattern.
+ */
+import type { SkillEntry } from '../skills/sync-skills.js';
+/** Context passed to an adapter when executing a task */
+export interface AdapterExecutionContext {
+    /** Unique run identifier */
+    runId: string;
+    /** The prompt or task description to execute */
+    prompt: string;
+    /** Working directory for execution */
+    workspace: string;
+    /** Session state from previous run (adapter-specific format) */
+    session?: AdapterSessionState;
+    /** Skills to inject into the runtime */
+    skills?: SkillEntry[];
+    /** Adapter-specific configuration overrides */
+    config?: Record<string, unknown>;
+    /** Callback for streaming log output */
+    onLog?: (message: string) => void;
+    /** Callback for metadata events (tokens used, model, etc.) */
+    onMeta?: (meta: Record<string, unknown>) => void;
+}
+/** Opaque session state — each adapter defines its own shape */
+export interface AdapterSessionState {
+    /** Adapter type that created this state */
+    adapterType: string;
+    /** Serialized session data (adapter-specific) */
+    data: Record<string, unknown>;
+}
+/** Result returned after adapter execution */
+export interface AdapterExecutionResult {
+    /** Exit code (0 = success) */
+    exitCode: number;
+    /** Whether execution timed out */
+    timedOut?: boolean;
+    /** Token usage */
+    usage?: AdapterTokenUsage;
+    /** Session state to persist for next run */
+    sessionState?: AdapterSessionState;
+    /** Human-readable summary of what was done */
+    summary?: string;
+    /** Structured result data */
+    resultData?: Record<string, unknown>;
+    /** Provider and model info */
+    provider?: string;
+    model?: string;
+}
+/** Token usage reported by the adapter */
+export interface AdapterTokenUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+/** Per-adapter session serialization — each runtime stores different session data */
+export interface AdapterSessionCodec {
+    /** Serialize session state for persistence */
+    serialize(state: AdapterSessionState): string;
+    /** Deserialize persisted session state */
+    deserialize(serialized: string): AdapterSessionState;
+    /** Get a human-readable display ID for the session */
+    getDisplayId(state: AdapterSessionState): string;
+}
+/** Result of testing whether a runtime is available */
+export interface AdapterEnvironmentTestResult {
+    /** Whether the runtime CLI is available */
+    available: boolean;
+    /** Runtime version (if detected) */
+    version?: string;
+    /** Additional details (path, capabilities, etc.) */
+    details?: Record<string, unknown>;
+    /** Error message if not available */
+    error?: string;
+}
+/** Core adapter interface — implement this for each AI runtime */
+export interface RuntimeAdapter {
+    /** Adapter type identifier (e.g., 'claude-code', 'codex', 'cursor') */
+    readonly type: string;
+    /** Execute a task in this runtime */
+    execute(ctx: AdapterExecutionContext): Promise<AdapterExecutionResult>;
+    /** Test whether this runtime is available in the current environment */
+    testEnvironment(): Promise<AdapterEnvironmentTestResult>;
+    /** Optional: session codec for persisting runtime-specific session state */
+    sessionCodec?: AdapterSessionCodec;
+    /** Optional: sync skills into the runtime's expected format */
+    syncSkills?(skills: SkillEntry[]): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

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

package/dist/adapters/types.js

@@ -0,0 +1,10 @@
+/**
+ * Runtime adapter abstraction — dispatch work to any AI CLI.
+ *
+ * SEPARATE from enforcement HostAdapter (which translates rules).
+ * This is about executing tasks on different runtimes (Claude Code, Codex, Cursor, etc.)
+ *
+ * Inspired by Paperclip AI's ServerAdapterModule pattern.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/brain/brain.d.ts

@@ -18,6 +18,7 @@ export declare class Brain {
     /**
      * Two-pass retrieval — Pass 2: Load.
      * Returns full entries for specific IDs (from a previous scan).
+     * Uses a single WHERE id IN (...) query instead of per-ID lookups.
      */
     loadEntries(ids: string[]): IntelligenceEntry[];
     /** Rough token estimate for an entry (chars / 4). */
@@ -48,7 +49,17 @@ export declare class Brain {
     private generateTags;
     private detectDuplicate;
     private updateVocabularyIncremental;
-    private persistVocabulary;
+    private persistVocabularyPartial;
+    /**
+     * Fast startup path: load vocabulary from the brain_vocabulary table.
+     * If the table is empty (first boot or after corruption), trigger a full rebuild.
+     */
+    private loadVocabularyFromDb;
+    /**
+     * Full persist: DELETE all rows then re-INSERT. Used by rebuildVocabulary() which
+     * replaces the entire vocabulary and needs to remove stale terms.
+     */
+    private persistVocabularyFull;
     private recomputeWeights;
 }
 //# sourceMappingURL=brain.d.ts.map

package/dist/brain/brain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/brain/brain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AASlE,OAAO,KAAK,EAGV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC;AA2BpB,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,OAAO,CAA0C;gBAE7C,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,YAAY;IAO/C,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyDxF;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAe7F;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE;IAS/C,qDAAqD;IACrD,OAAO,CAAC,cAAc;IAStB,gBAAgB,CACd,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG;QAClC,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACxC,WAAW,EAAE,MAAM,CAAC;KACrB,GACA,aAAa;IA6DhB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI;IACtF,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa;IA8DnD,gBAAgB,IAAI,aAAa;IA0C3B,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAOzE,iBAAiB,IAAI,IAAI;IAiEzB,QAAQ,IAAI,UAAU;IAYtB,iBAAiB,IAAI,MAAM;IAIrB,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,GACjB,OAAO,CACR,KAAK,CAAC;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;KAC3C,CAAC,CACH;IA2BD,OAAO,CAAC,UAAU;IA4ClB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,eAAe;IA0CvB,OAAO,CAAC,2BAA2B;IAkBnC,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,gBAAgB;CAoDzB"}
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/brain/brain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAUlE,OAAO,KAAK,EAGV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC;AA2BpB,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,OAAO,CAA0C;gBAE7C,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,YAAY;IAO/C,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA+DxF;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAe7F;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE;IAW/C,qDAAqD;IACrD,OAAO,CAAC,cAAc;IAStB,gBAAgB,CACd,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG;QAClC,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACxC,WAAW,EAAE,MAAM,CAAC;KACrB,GACA,aAAa;IA6DhB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI;IACtF,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa;IA8DnD,gBAAgB,IAAI,aAAa;IA0C3B,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAOzE,iBAAiB,IAAI,IAAI;IAoFzB,QAAQ,IAAI,UAAU;IAYtB,iBAAiB,IAAI,MAAM;IAIrB,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,GACjB,OAAO,CACR,KAAK,CAAC;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;KAC3C,CAAC,CACH;IA2BD,OAAO,CAAC,UAAU;IA4ClB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,eAAe;IA0CvB,OAAO,CAAC,2BAA2B;IAoBnC,OAAO,CAAC,wBAAwB;IAchC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,gBAAgB;CAoDzB"}