cognitive-core 0.0.2 → 0.1.0

package/dist/runtime/manager.js

@@ -0,0 +1,416 @@
+import { createTrajectory, createStep, successOutcome, failureOutcome, } from '../types/index.js';
+/**
+ * Default knowledge injector - formats memory for context injection
+ */
+export class DefaultKnowledgeInjector {
+    format(knowledge, _agentType, options) {
+        const format = options?.format ?? 'markdown';
+        if (format === 'json') {
+            return JSON.stringify(knowledge, null, 2);
+        }
+        if (format === 'xml') {
+            return this.formatXml(knowledge);
+        }
+        return this.formatMarkdown(knowledge);
+    }
+    formatMarkdown(knowledge) {
+        const sections = [];
+        if (knowledge.playbooks.length > 0) {
+            sections.push('## Applicable Playbooks\n');
+            for (const { playbook, score, matchType } of knowledge.playbooks) {
+                sections.push(`### ${playbook.name} (${(score * 100).toFixed(0)}% match via ${matchType})`);
+                sections.push(`**Strategy:** ${playbook.guidance.strategy}`);
+                if (playbook.guidance.tactics.length > 0) {
+                    sections.push(`**Tactics:** ${playbook.guidance.tactics.join(', ')}`);
+                }
+                if (playbook.guidance.steps && playbook.guidance.steps.length > 0) {
+                    sections.push('**Steps:**');
+                    playbook.guidance.steps.forEach((step, i) => {
+                        sections.push(`${i + 1}. ${step}`);
+                    });
+                }
+                sections.push(`*Confidence: ${(playbook.confidence * 100).toFixed(0)}%*\n`);
+            }
+        }
+        if (knowledge.experiences.length > 0) {
+            sections.push('## Similar Past Experiences\n');
+            for (const { experience, score } of knowledge.experiences) {
+                sections.push(`### Experience (relevance: ${(score * 100).toFixed(0)}%)`);
+                sections.push(`**Task:** ${experience.taskInput.slice(0, 200)}...`);
+                sections.push(`**Outcome:** ${experience.success ? 'Success' : 'Failed'}`);
+                sections.push(`**Approach:** ${experience.solutionOutput.slice(0, 300)}...`);
+                sections.push('');
+            }
+        }
+        return sections.join('\n');
+    }
+    formatXml(knowledge) {
+        const parts = ['<atlas-knowledge>'];
+        if (knowledge.playbooks.length > 0) {
+            parts.push('  <playbooks>');
+            for (const { playbook, score } of knowledge.playbooks) {
+                parts.push(`    <playbook name="${this.escapeXml(playbook.name)}" relevance="${score.toFixed(2)}">`);
+                parts.push(`      <strategy>${this.escapeXml(playbook.guidance.strategy)}</strategy>`);
+                if (playbook.guidance.steps && playbook.guidance.steps.length > 0) {
+                    parts.push('      <steps>');
+                    playbook.guidance.steps.forEach((step, i) => {
+                        parts.push(`        <step n="${i + 1}">${this.escapeXml(step)}</step>`);
+                    });
+                    parts.push('      </steps>');
+                }
+                parts.push(`      <confidence>${playbook.confidence}</confidence>`);
+                parts.push('    </playbook>');
+            }
+            parts.push('  </playbooks>');
+        }
+        if (knowledge.experiences.length > 0) {
+            parts.push('  <experiences>');
+            for (const { experience, score } of knowledge.experiences) {
+                parts.push(`    <experience relevance="${score.toFixed(2)}">`);
+                parts.push(`      <task>${this.escapeXml(experience.taskInput.slice(0, 200))}</task>`);
+                parts.push(`      <outcome>${experience.success ? 'success' : 'failure'}</outcome>`);
+                parts.push('    </experience>');
+            }
+            parts.push('  </experiences>');
+        }
+        parts.push('</atlas-knowledge>');
+        return parts.join('\n');
+    }
+    escapeXml(str) {
+        return str
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;');
+    }
+}
+/**
+ * Default trajectory extractor - converts agent sessions to trajectories
+ */
+export class DefaultTrajectoryExtractor {
+    extract(session, task) {
+        const steps = [];
+        // Convert tool calls to steps
+        for (const toolCall of session.toolCalls) {
+            steps.push(createStep({
+                thought: this.extractThought(session.messages, toolCall),
+                action: `${toolCall.name}: ${this.summarizeInput(toolCall.input)}`,
+                observation: toolCall.error
+                    ? `Error: ${toolCall.error}`
+                    : this.summarizeOutput(toolCall.output),
+                metadata: {
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    duration: toolCall.endTime
+                        ? toolCall.endTime.getTime() - toolCall.startTime.getTime()
+                        : undefined,
+                },
+            }));
+        }
+        // Determine outcome
+        const outcome = session.state === 'completed'
+            ? successOutcome(session.result)
+            : failureOutcome(session.error ?? 'Session did not complete successfully');
+        return createTrajectory({
+            task,
+            steps,
+            outcome,
+            agentId: `${session.agentType}:${session.id}`,
+            wallTimeSeconds: session.endTime
+                ? (session.endTime.getTime() - session.startTime.getTime()) / 1000
+                : 0,
+            metadata: {
+                sessionId: session.id,
+                agentType: session.agentType,
+                messageCount: session.messages.length,
+                ...session.metadata,
+            },
+        });
+    }
+    extractThought(messages, toolCall) {
+        // Find the assistant message just before this tool call
+        const toolCallTime = toolCall.startTime.getTime();
+        const precedingMessages = messages.filter((m) => m.role === 'assistant' &&
+            m.timestamp.getTime() < toolCallTime &&
+            m.timestamp.getTime() > toolCallTime - 60000 // Within 1 minute
+        );
+        if (precedingMessages.length > 0) {
+            const lastMessage = precedingMessages[precedingMessages.length - 1];
+            // Extract reasoning/thought from the message
+            return lastMessage.content.slice(0, 500);
+        }
+        return undefined;
+    }
+    summarizeInput(input) {
+        if (typeof input === 'string') {
+            return input.slice(0, 100);
+        }
+        if (typeof input === 'object' && input !== null) {
+            const str = JSON.stringify(input);
+            return str.slice(0, 100) + (str.length > 100 ? '...' : '');
+        }
+        return String(input);
+    }
+    summarizeOutput(output) {
+        if (output === undefined)
+            return 'No output';
+        if (typeof output === 'string') {
+            return output.slice(0, 200) + (output.length > 200 ? '...' : '');
+        }
+        if (typeof output === 'object' && output !== null) {
+            const str = JSON.stringify(output);
+            return str.slice(0, 200) + (str.length > 200 ? '...' : '');
+        }
+        return String(output);
+    }
+}
+/**
+ * Agent Manager - orchestrates agent spawning, observation, and learning
+ */
+export class AgentManager {
+    backends = new Map();
+    memory;
+    injector;
+    extractor;
+    observers = [];
+    activeSessions = new Map();
+    constructor(memory, options) {
+        this.memory = memory;
+        this.injector = options?.injector ?? new DefaultKnowledgeInjector();
+        this.extractor = options?.extractor ?? new DefaultTrajectoryExtractor();
+    }
+    /**
+     * Register an agent backend
+     */
+    registerBackend(backend) {
+        this.backends.set(backend.name, backend);
+    }
+    /**
+     * Get a registered backend
+     */
+    getBackend(name) {
+        return this.backends.get(name);
+    }
+    /**
+     * List available backends
+     */
+    listBackends() {
+        return Array.from(this.backends.keys());
+    }
+    /**
+     * Add an observer for agent events
+     */
+    addObserver(callbacks) {
+        this.observers.push(callbacks);
+    }
+    /**
+     * Remove an observer
+     */
+    removeObserver(callbacks) {
+        const index = this.observers.indexOf(callbacks);
+        if (index >= 0) {
+            this.observers.splice(index, 1);
+        }
+    }
+    /**
+     * Spawn an agent to execute a task
+     * This is the main entry point for running agents
+     */
+    async spawn(config) {
+        // Find appropriate backend
+        const backend = this.findBackend(config.agentType);
+        if (!backend) {
+            throw new Error(`No backend found for agent type: ${config.agentType}. ` +
+                `Available backends: ${this.listBackends().join(', ')}`);
+        }
+        // Query memory for relevant knowledge if not provided
+        let knowledge = config.injectedKnowledge;
+        if (!knowledge) {
+            knowledge = await this.memory.queryV2(config.task.description, {
+                domains: config.task.domain ? [config.task.domain] : undefined,
+            });
+        }
+        // Format knowledge for injection
+        const formattedKnowledge = this.injector.format(knowledge, config.agentType);
+        // Use a session holder to allow callbacks to reference the session
+        // before it's assigned (closures capture the holder object, not the value)
+        const sessionHolder = { current: null };
+        // Build full config with knowledge injection
+        const fullConfig = {
+            ...config,
+            systemPromptAdditions: [
+                config.systemPromptAdditions,
+                formattedKnowledge
+                    ? `\n## Atlas Knowledge\n${formattedKnowledge}`
+                    : undefined,
+            ]
+                .filter(Boolean)
+                .join('\n\n'),
+            onMessage: (message) => {
+                config.onMessage?.(message);
+                if (sessionHolder.current) {
+                    this.notifyMessage(sessionHolder.current, message);
+                }
+            },
+            onToolCall: (toolCall) => {
+                config.onToolCall?.(toolCall);
+                if (sessionHolder.current) {
+                    this.notifyToolCall(sessionHolder.current, toolCall);
+                }
+            },
+        };
+        // Spawn the agent
+        const session = await backend.spawn(fullConfig);
+        sessionHolder.current = session;
+        this.activeSessions.set(session.id, session);
+        this.notifySessionStart(session);
+        // Wait for completion and extract trajectory
+        const finalSession = await this.waitForCompletion(backend, session.id);
+        this.activeSessions.delete(session.id);
+        const trajectory = this.extractor.extract(finalSession, config.task);
+        this.notifySessionEnd(finalSession, trajectory);
+        return {
+            session: finalSession,
+            trajectory,
+            success: finalSession.state === 'completed',
+            metrics: {
+                totalTime: finalSession.endTime
+                    ? finalSession.endTime.getTime() - finalSession.startTime.getTime()
+                    : 0,
+                toolCallCount: finalSession.toolCalls.length,
+                messageCount: finalSession.messages.length,
+            },
+        };
+    }
+    /**
+     * Spawn an agent WITHOUT knowledge injection (for baseline/control)
+     */
+    async spawnBaseline(config) {
+        return this.spawn({
+            ...config,
+            injectedKnowledge: {
+                experiences: [],
+                playbooks: [],
+            },
+        });
+    }
+    /**
+     * Run an A/B comparison: with and without knowledge injection
+     */
+    async compareWithKnowledge(config) {
+        // Run baseline first
+        const baseline = await this.spawnBaseline(config);
+        // Run with knowledge
+        const withKnowledge = await this.spawn(config);
+        return {
+            withKnowledge,
+            baseline,
+            improvement: {
+                timeDelta: baseline.metrics.totalTime - withKnowledge.metrics.totalTime,
+                toolCallDelta: baseline.metrics.toolCallCount - withKnowledge.metrics.toolCallCount,
+                successDelta: (withKnowledge.success ? 1 : 0) - (baseline.success ? 1 : 0),
+            },
+        };
+    }
+    /**
+     * Observe an external agent session and learn from it
+     * Use this when you have access to another agent's execution
+     */
+    async observeAndLearn(session, task) {
+        const trajectory = this.extractor.extract(session, task);
+        // Store in memory for learning
+        await this.memory.storeTrajectory(trajectory);
+        return trajectory;
+    }
+    /**
+     * Get active sessions
+     */
+    getActiveSessions() {
+        return Array.from(this.activeSessions.values());
+    }
+    /**
+     * Terminate a session
+     */
+    async terminate(sessionId) {
+        const session = this.activeSessions.get(sessionId);
+        if (!session)
+            return;
+        const backend = this.findBackend(session.agentType);
+        if (backend?.terminate) {
+            await backend.terminate(sessionId);
+        }
+        this.activeSessions.delete(sessionId);
+    }
+    /**
+     * Terminate all active sessions
+     */
+    async terminateAll() {
+        const sessionIds = Array.from(this.activeSessions.keys());
+        await Promise.all(sessionIds.map((id) => this.terminate(id)));
+    }
+    /**
+     * Close the manager and clean up resources
+     * Terminates all active sessions and clears all state
+     */
+    async close() {
+        // Terminate all active sessions
+        await this.terminateAll();
+        // Clear backends
+        this.backends.clear();
+        // Clear observers
+        this.observers = [];
+    }
+    // Private helpers
+    findBackend(agentType) {
+        // First try exact match
+        for (const backend of this.backends.values()) {
+            if (backend.supportedTypes.includes(agentType)) {
+                return backend;
+            }
+        }
+        // Then try by backend name
+        return this.backends.get(agentType);
+    }
+    async waitForCompletion(backend, sessionId) {
+        // Poll for completion
+        while (true) {
+            const session = await backend.getSession(sessionId);
+            if (!session) {
+                throw new Error(`Session ${sessionId} not found`);
+            }
+            if (session.state === 'completed' ||
+                session.state === 'failed') {
+                return session;
+            }
+            // Wait before polling again
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+        }
+    }
+    notifySessionStart(session) {
+        for (const observer of this.observers) {
+            observer.onSessionStart?.(session);
+        }
+    }
+    notifyMessage(session, message) {
+        for (const observer of this.observers) {
+            observer.onMessage?.(session, message);
+        }
+    }
+    notifyToolCall(session, toolCall) {
+        for (const observer of this.observers) {
+            observer.onToolCall?.(session, toolCall);
+        }
+    }
+    notifySessionEnd(session, trajectory) {
+        for (const observer of this.observers) {
+            observer.onSessionEnd?.(session, trajectory);
+        }
+    }
+}
+/**
+ * Create an agent manager
+ */
+export function createAgentManager(memory, options) {
+    return new AgentManager(memory, options);
+}
+//# sourceMappingURL=manager.js.map

package/dist/runtime/manager.js.map

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

package/dist/runtime/types.d.ts

@@ -0,0 +1,138 @@
+import type { Task, Trajectory } from '../types/index.js';
+import type { MemoryQueryResultV2 } from '../memory/system.js';
+/**
+ * Message in an agent conversation
+ */
+export interface AgentMessage {
+    role: 'user' | 'assistant' | 'system' | 'tool_use' | 'tool_result';
+    content: string;
+    toolName?: string;
+    toolInput?: unknown;
+    toolOutput?: unknown;
+    timestamp: Date;
+}
+/**
+ * Tool call made by an agent
+ */
+export interface ToolCall {
+    id: string;
+    name: string;
+    input: unknown;
+    output?: unknown;
+    error?: string;
+    startTime: Date;
+    endTime?: Date;
+}
+/**
+ * Agent execution state
+ */
+export type AgentState = 'idle' | 'running' | 'paused' | 'completed' | 'failed';
+/**
+ * Agent session - represents a running or completed agent execution
+ */
+export interface AgentSession {
+    id: string;
+    agentType: string;
+    task: Task;
+    state: AgentState;
+    messages: AgentMessage[];
+    toolCalls: ToolCall[];
+    startTime: Date;
+    endTime?: Date;
+    result?: unknown;
+    error?: string;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Configuration for spawning an agent
+ */
+export interface AgentSpawnConfig {
+    /** Type of agent to spawn (e.g., 'claude-code', 'custom', etc.) */
+    agentType: string;
+    /** Task for the agent to work on */
+    task: Task;
+    /** Optional knowledge to inject into the agent's context */
+    injectedKnowledge?: MemoryQueryResultV2;
+    /** Custom system prompt additions */
+    systemPromptAdditions?: string;
+    /** Environment variables for the agent */
+    env?: Record<string, string>;
+    /** Working directory */
+    cwd?: string;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Whether to capture detailed tool calls */
+    captureToolCalls?: boolean;
+    /** Callback for real-time observation */
+    onMessage?: (message: AgentMessage) => void;
+    onToolCall?: (toolCall: ToolCall) => void;
+    /** Additional backend-specific options */
+    backendOptions?: Record<string, unknown>;
+}
+/**
+ * Result of agent execution
+ */
+export interface AgentResult {
+    session: AgentSession;
+    trajectory: Trajectory;
+    success: boolean;
+    metrics: {
+        totalTime: number;
+        toolCallCount: number;
+        messageCount: number;
+        tokenEstimate?: number;
+    };
+}
+/**
+ * Agent backend protocol - implement this for different agent systems
+ */
+export interface AgentBackend {
+    /** Unique name for this backend */
+    readonly name: string;
+    /** Supported agent types */
+    readonly supportedTypes: string[];
+    /** Check if backend is available/configured */
+    isAvailable(): Promise<boolean>;
+    /** Spawn and run an agent */
+    spawn(config: AgentSpawnConfig): Promise<AgentSession>;
+    /** Get status of a running session */
+    getSession(sessionId: string): Promise<AgentSession | undefined>;
+    /** Send a message to a running session */
+    sendMessage?(sessionId: string, message: string): Promise<void>;
+    /** Pause a running session */
+    pause?(sessionId: string): Promise<void>;
+    /** Resume a paused session */
+    resume?(sessionId: string): Promise<void>;
+    /** Terminate a session */
+    terminate?(sessionId: string): Promise<void>;
+    /** List active sessions */
+    listSessions?(): Promise<AgentSession[]>;
+}
+/**
+ * Knowledge injector - formats knowledge for injection into agents
+ */
+export interface KnowledgeInjector {
+    /** Format knowledge for a specific agent type */
+    format(knowledge: MemoryQueryResultV2, agentType: string, options?: {
+        maxTokens?: number;
+        format?: 'markdown' | 'json' | 'xml';
+    }): string;
+}
+/**
+ * Trajectory extractor - extracts trajectories from agent sessions
+ */
+export interface TrajectoryExtractor {
+    /** Extract a trajectory from an agent session */
+    extract(session: AgentSession, task: Task): Trajectory;
+}
+/**
+ * Agent observer callbacks
+ */
+export interface AgentObserverCallbacks {
+    onSessionStart?: (session: AgentSession) => void;
+    onMessage?: (session: AgentSession, message: AgentMessage) => void;
+    onToolCall?: (session: AgentSession, toolCall: ToolCall) => void;
+    onSessionEnd?: (session: AgentSession, trajectory: Trajectory) => void;
+    onError?: (session: AgentSession, error: Error) => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,IAAI,EAAE,IAAI,CAAC;IACX,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;IACxC,qCAAqC;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yCAAyC;IACzC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5C,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC1C,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4BAA4B;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAElC,+CAA+C;IAC/C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC,6BAA6B;IAC7B,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEvD,sCAAsC;IACtC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAEjE,0CAA0C;IAC1C,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE,8BAA8B;IAC9B,KAAK,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,8BAA8B;IAC9B,MAAM,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,0BAA0B;IAC1B,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,2BAA2B;IAC3B,YAAY,CAAC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,MAAM,CACJ,SAAS,EAAE,mBAAmB,EAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,KAAK,CAAA;KAAE,GACrE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACnE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACjE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACvE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACzD"}

package/dist/runtime/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runtime/types.js.map

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