@cogitator-ai/types 0.1.0

package/dist/memory.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Memory types for conversation persistence and retrieval
+ */
+import type { Message, ToolCall, ToolResult } from './message';
+export type MemoryType = 'conversation' | 'fact' | 'embedding';
+/**
+ * A thread represents a conversation session
+ */
+export interface Thread {
+    id: string;
+    agentId: string;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * A memory entry - stored message with metadata
+ */
+export interface MemoryEntry {
+    id: string;
+    threadId: string;
+    message: Message;
+    toolCalls?: ToolCall[];
+    toolResults?: ToolResult[];
+    tokenCount: number;
+    createdAt: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A fact is a long-term memory (user preference, learned info)
+ */
+export interface Fact {
+    id: string;
+    agentId: string;
+    content: string;
+    category: string;
+    confidence: number;
+    source: 'user' | 'inferred' | 'system';
+    createdAt: Date;
+    updatedAt: Date;
+    expiresAt?: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * An embedding for semantic search
+ */
+export interface Embedding {
+    id: string;
+    sourceId: string;
+    sourceType: 'message' | 'fact' | 'document';
+    vector: number[];
+    content: string;
+    createdAt: Date;
+    metadata?: Record<string, unknown>;
+}
+export type MemoryResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+export type MemoryProvider = 'memory' | 'redis' | 'postgres';
+export interface MemoryAdapterConfig {
+    provider: MemoryProvider;
+}
+export interface InMemoryAdapterConfig extends MemoryAdapterConfig {
+    provider: 'memory';
+    maxEntries?: number;
+}
+export interface RedisAdapterConfig extends MemoryAdapterConfig {
+    provider: 'redis';
+    /** Redis URL for standalone mode (e.g., redis://localhost:6379) */
+    url?: string;
+    /** Host for standalone mode (alternative to url) */
+    host?: string;
+    /** Port for standalone mode (alternative to url) */
+    port?: number;
+    /** Cluster nodes for Redis Cluster mode */
+    cluster?: {
+        nodes: {
+            host: string;
+            port: number;
+        }[];
+        scaleReads?: 'master' | 'slave' | 'all';
+    };
+    /** Key prefix (default: 'cogitator:' or '{cogitator}:' for cluster) */
+    keyPrefix?: string;
+    /** TTL in seconds (default: 86400 = 24 hours) */
+    ttl?: number;
+    /** Password for authentication */
+    password?: string;
+}
+export interface PostgresAdapterConfig extends MemoryAdapterConfig {
+    provider: 'postgres';
+    connectionString: string;
+    schema?: string;
+    poolSize?: number;
+}
+export interface MemoryQueryOptions {
+    threadId: string;
+    limit?: number;
+    before?: Date;
+    after?: Date;
+    includeToolCalls?: boolean;
+}
+export interface SemanticSearchOptions {
+    query?: string;
+    vector?: number[];
+    limit?: number;
+    threshold?: number;
+    filter?: {
+        sourceType?: Embedding['sourceType'];
+        threadId?: string;
+        agentId?: string;
+    };
+}
+/**
+ * Core memory adapter - all adapters implement this
+ */
+export interface MemoryAdapter {
+    readonly provider: MemoryProvider;
+    createThread(agentId: string, metadata?: Record<string, unknown>): Promise<MemoryResult<Thread>>;
+    getThread(threadId: string): Promise<MemoryResult<Thread | null>>;
+    updateThread(threadId: string, metadata: Record<string, unknown>): Promise<MemoryResult<Thread>>;
+    deleteThread(threadId: string): Promise<MemoryResult<void>>;
+    addEntry(entry: Omit<MemoryEntry, 'id' | 'createdAt'>): Promise<MemoryResult<MemoryEntry>>;
+    getEntries(options: MemoryQueryOptions): Promise<MemoryResult<MemoryEntry[]>>;
+    getEntry(entryId: string): Promise<MemoryResult<MemoryEntry | null>>;
+    deleteEntry(entryId: string): Promise<MemoryResult<void>>;
+    clearThread(threadId: string): Promise<MemoryResult<void>>;
+    connect(): Promise<MemoryResult<void>>;
+    disconnect(): Promise<MemoryResult<void>>;
+}
+/**
+ * Extended adapter for long-term facts (Postgres)
+ */
+export interface FactAdapter {
+    addFact(fact: Omit<Fact, 'id' | 'createdAt' | 'updatedAt'>): Promise<MemoryResult<Fact>>;
+    getFacts(agentId: string, category?: string): Promise<MemoryResult<Fact[]>>;
+    updateFact(factId: string, updates: Partial<Pick<Fact, 'content' | 'category' | 'confidence' | 'metadata' | 'expiresAt'>>): Promise<MemoryResult<Fact>>;
+    deleteFact(factId: string): Promise<MemoryResult<void>>;
+    searchFacts(agentId: string, query: string): Promise<MemoryResult<Fact[]>>;
+}
+/**
+ * Extended adapter for semantic search (pgvector)
+ */
+export interface EmbeddingAdapter {
+    addEmbedding(embedding: Omit<Embedding, 'id' | 'createdAt'>): Promise<MemoryResult<Embedding>>;
+    search(options: SemanticSearchOptions): Promise<MemoryResult<(Embedding & {
+        score: number;
+    })[]>>;
+    deleteEmbedding(embeddingId: string): Promise<MemoryResult<void>>;
+    deleteBySource(sourceId: string): Promise<MemoryResult<void>>;
+}
+export interface EmbeddingService {
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    readonly dimensions: number;
+    readonly model: string;
+}
+export type EmbeddingProvider = 'openai' | 'ollama';
+export interface OpenAIEmbeddingConfig {
+    provider: 'openai';
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+}
+export interface OllamaEmbeddingConfig {
+    provider: 'ollama';
+    model?: string;
+    baseUrl?: string;
+}
+export type EmbeddingServiceConfig = OpenAIEmbeddingConfig | OllamaEmbeddingConfig;
+export type ContextStrategy = 'recent' | 'relevant' | 'hybrid';
+export interface ContextBuilderConfig {
+    maxTokens: number;
+    reserveTokens?: number;
+    strategy: ContextStrategy;
+    includeSystemPrompt?: boolean;
+    includeFacts?: boolean;
+    includeSemanticContext?: boolean;
+}
+export interface BuiltContext {
+    messages: Message[];
+    facts: Fact[];
+    semanticResults: (Embedding & {
+        score: number;
+    })[];
+    tokenCount: number;
+    truncated: boolean;
+    metadata: {
+        originalMessageCount: number;
+        includedMessageCount: number;
+        factsIncluded: number;
+        semanticResultsIncluded: number;
+    };
+}
+export interface MemoryConfig {
+    adapter?: MemoryProvider;
+    inMemory?: Omit<InMemoryAdapterConfig, 'provider'>;
+    redis?: Omit<RedisAdapterConfig, 'provider'>;
+    postgres?: Omit<PostgresAdapterConfig, 'provider'>;
+    embedding?: EmbeddingServiceConfig;
+    contextBuilder?: Partial<ContextBuilderConfig>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

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

package/dist/memory.js

@@ -0,0 +1,5 @@
+/**
+ * Memory types for conversation persistence and retrieval
+ */
+export {};
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/message.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Message types for LLM conversations
+ */
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+export interface Message {
+    role: MessageRole;
+    content: string;
+    name?: string;
+    toolCallId?: string;
+}
+export interface ToolCallMessage extends Message {
+    role: 'assistant';
+    content: string;
+    toolCalls: ToolCall[];
+}
+export interface ToolResultMessage extends Message {
+    role: 'tool';
+    content: string;
+    toolCallId: string;
+    name: string;
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolResult {
+    callId: string;
+    name: string;
+    result: unknown;
+    error?: string;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAkB,SAAQ,OAAO;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/message.js

@@ -0,0 +1,5 @@
+/**
+ * Message types for LLM conversations
+ */
+export {};
+//# sourceMappingURL=message.js.map

package/dist/message.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Runtime types for Cogitator
+ */
+import type { Message, ToolCall, ToolResult } from './message';
+import type { LLMProvider } from './llm';
+import type { MemoryConfig } from './memory';
+import type { SandboxManagerConfig } from './sandbox';
+export interface CogitatorConfig {
+    llm?: {
+        defaultProvider?: LLMProvider;
+        defaultModel?: string;
+        providers?: {
+            ollama?: {
+                baseUrl: string;
+            };
+            openai?: {
+                apiKey: string;
+                baseUrl?: string;
+            };
+            anthropic?: {
+                apiKey: string;
+            };
+            google?: {
+                apiKey: string;
+            };
+            vllm?: {
+                baseUrl: string;
+            };
+        };
+    };
+    limits?: {
+        maxConcurrentRuns?: number;
+        defaultTimeout?: number;
+        maxTokensPerRun?: number;
+    };
+    memory?: MemoryConfig;
+    /** Sandbox configuration for isolated tool execution */
+    sandbox?: SandboxManagerConfig;
+}
+export interface RunOptions {
+    input: string;
+    context?: Record<string, unknown>;
+    threadId?: string;
+    timeout?: number;
+    stream?: boolean;
+    onToken?: (token: string) => void;
+    onToolCall?: (call: ToolCall) => void;
+    onToolResult?: (result: ToolResult) => void;
+    /** Enable/disable memory for this run. Default: true if adapter configured */
+    useMemory?: boolean;
+    /** Load conversation history from memory. Default: true */
+    loadHistory?: boolean;
+    /** Save messages to memory after each turn. Default: true */
+    saveHistory?: boolean;
+    /** Callback when run starts */
+    onRunStart?: (data: {
+        runId: string;
+        agentId: string;
+        input: string;
+        threadId: string;
+    }) => void;
+    /** Callback when run completes */
+    onRunComplete?: (result: RunResult) => void;
+    /** Callback when run fails */
+    onRunError?: (error: Error, runId: string) => void;
+    /** Callback when a span is created */
+    onSpan?: (span: Span) => void;
+}
+export interface RunResult {
+    output: string;
+    structured?: unknown;
+    runId: string;
+    agentId: string;
+    threadId: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+        cost: number;
+        duration: number;
+    };
+    toolCalls: ToolCall[];
+    messages: Message[];
+    trace: {
+        traceId: string;
+        spans: Span[];
+    };
+}
+export interface Span {
+    id: string;
+    traceId: string;
+    parentId?: string;
+    name: string;
+    kind: 'internal' | 'client' | 'server' | 'producer' | 'consumer';
+    status: 'ok' | 'error' | 'unset';
+    startTime: number;
+    endTime: number;
+    duration: number;
+    attributes: Record<string, unknown>;
+    events?: {
+        name: string;
+        timestamp: number;
+        attributes?: Record<string, unknown>;
+    }[];
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE;QACJ,eAAe,CAAC,EAAE,WAAW,CAAC;QAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE;YACV,MAAM,CAAC,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC;YAC7B,MAAM,CAAC,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAC9C,SAAS,CAAC,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC;YAC/B,MAAM,CAAC,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC;YAC5B,IAAI,CAAC,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC;SAC5B,CAAC;KACH,CAAC;IACF,MAAM,CAAC,EAAE;QACP,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,wDAAwD;IACxD,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAE5C,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjG,kCAAkC;IAClC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5C,8BAA8B;IAC9B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,sCAAsC;IACtC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,IAAI,EAAE,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IACjE,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAC;CACtF"}

package/dist/runtime.js

@@ -0,0 +1,5 @@
+/**
+ * Runtime types for Cogitator
+ */
+export {};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/sandbox.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Sandbox types for isolated tool execution
+ */
+export type SandboxType = 'docker' | 'native' | 'wasm';
+export interface SandboxResourceLimits {
+    /** Memory limit (e.g., '256MB', '1GB') */
+    memory?: string;
+    /** CPU shares (0-1024, default: 512) */
+    cpuShares?: number;
+    /** Number of CPUs (e.g., 0.5, 1, 2) */
+    cpus?: number;
+    /** Max PIDs (default: 100) */
+    pidsLimit?: number;
+}
+export interface SandboxNetworkConfig {
+    /** Network mode: 'none' (isolated), 'bridge' (default Docker), 'host' */
+    mode?: 'none' | 'bridge' | 'host';
+    /** Allowed outbound hosts (only when mode is 'bridge') */
+    allowedHosts?: string[];
+    /** DNS servers */
+    dns?: string[];
+}
+export interface SandboxMount {
+    /** Source path on host */
+    source: string;
+    /** Target path in container */
+    target: string;
+    /** Read-only mount */
+    readOnly?: boolean;
+}
+export interface SandboxConfig {
+    type: SandboxType;
+    /** Docker image (for docker type) */
+    image?: string;
+    /** Resource limits */
+    resources?: SandboxResourceLimits;
+    /** Network configuration */
+    network?: SandboxNetworkConfig;
+    /** Volume mounts */
+    mounts?: SandboxMount[];
+    /** Execution timeout in milliseconds */
+    timeout?: number;
+    /** Working directory inside container */
+    workdir?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** User to run as (e.g., 'sandbox', '1000:1000') */
+    user?: string;
+    /** WASM module path or URL (for wasm type) */
+    wasmModule?: string;
+    /** WASM function to call (for wasm type, default: 'run') */
+    wasmFunction?: string;
+    /** Enable WASI (for wasm type, default: false) */
+    wasi?: boolean;
+}
+export interface SandboxExecutionRequest {
+    /** Command to execute */
+    command: string[];
+    /** Stdin input */
+    stdin?: string;
+    /** Working directory */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Execution timeout (overrides config) */
+    timeout?: number;
+}
+export interface SandboxExecutionResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    /** Whether execution was killed due to timeout */
+    timedOut: boolean;
+    /** Execution duration in milliseconds */
+    duration: number;
+}
+export interface SandboxPoolConfig {
+    /** Max containers to keep warm */
+    maxSize?: number;
+    /** Idle timeout before destroying container (ms) */
+    idleTimeoutMs?: number;
+}
+export interface SandboxDockerConfig {
+    /** Docker socket path */
+    socketPath?: string;
+    /** Docker host */
+    host?: string;
+    /** Docker port */
+    port?: number;
+}
+export interface SandboxWasmConfig {
+    /** Path or URL to WASM module */
+    wasmModule?: string;
+    /** WASM memory limit in 64KB pages (default: 256 = 16MB) */
+    memoryPages?: number;
+    /** Function name to call in WASM module (default: 'run') */
+    functionName?: string;
+    /** Enable WASI for filesystem/env access (default: false) */
+    wasi?: boolean;
+    /** Max cached plugins (default: 10) */
+    cacheSize?: number;
+}
+export interface SandboxManagerConfig {
+    /** Default sandbox configuration */
+    defaults?: Partial<SandboxConfig>;
+    /** Container pool settings */
+    pool?: SandboxPoolConfig;
+    /** Docker connection options */
+    docker?: SandboxDockerConfig;
+    /** WASM sandbox options */
+    wasm?: SandboxWasmConfig;
+}
+export type SandboxResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

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

package/dist/sandbox.js

@@ -0,0 +1,5 @@
+/**
+ * Sandbox types for isolated tool execution
+ */
+export {};
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

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