@cogitator-ai/core 0.9.0 → 0.11.0

package/dist/agent.d.ts

@@ -1,15 +1,65 @@
+import type { Agent as IAgent, AgentConfig, Tool } from '@cogitator-ai/types';
 /**
- * Agent class implementation
+ * AI agent that can execute tasks using LLM and tools.
+ *
+ * @example
+ * ```ts
+ * import { Agent, tool } from '@cogitator-ai/core';
+ * import { z } from 'zod';
+ *
+ * const searchTool = tool({
+ *   name: 'search',
+ *   description: 'Search the web',
+ *   parameters: z.object({ query: z.string() }),
+ *   execute: async ({ query }) => ({ results: [] }),
+ * });
+ *
+ * const agent = new Agent({
+ *   name: 'researcher',
+ *   model: 'anthropic/claude-sonnet-4-20250514',
+ *   instructions: 'You are a research assistant.',
+ *   tools: [searchTool],
+ * });
+ * ```
  */
-import type { Agent as IAgent, AgentConfig, Tool } from '@cogitator-ai/types';
 export declare class Agent implements IAgent {
+    /** Unique identifier for this agent instance */
     readonly id: string;
+    /** Human-readable name of the agent */
     readonly name: string;
+    /** Full configuration including model, instructions, tools, and parameters */
     readonly config: AgentConfig;
+    /**
+     * Create a new Agent instance.
+     *
+     * @param config - Agent configuration
+     * @param config.name - Human-readable name for the agent
+     * @param config.model - LLM model identifier (e.g., 'anthropic/claude-sonnet-4-20250514')
+     * @param config.instructions - System prompt defining agent behavior
+     * @param config.tools - Array of tools the agent can use
+     * @param config.temperature - Sampling temperature (default: 0.7)
+     * @param config.maxIterations - Maximum tool call iterations (default: 10)
+     * @param config.timeout - Run timeout in milliseconds (default: 120000)
+     */
     constructor(config: AgentConfig);
+    /** LLM model identifier */
     get model(): string;
+    /** System prompt defining agent behavior */
     get instructions(): string;
+    /** Tools available to this agent */
     get tools(): Tool[];
+    /**
+     * Create a copy of this agent with configuration overrides.
+     *
+     * @param overrides - Configuration values to override
+     * @returns New Agent instance with merged configuration
+     *
+     * @example
+     * ```ts
+     * const creativeAgent = agent.clone({ temperature: 0.9 });
+     * const fastAgent = agent.clone({ model: 'anthropic/claude-haiku' });
+     * ```
+     */
     clone(overrides: Partial<AgentConfig>): Agent;
 }
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,IAAI,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAG9E,qBAAa,KAAM,YAAW,MAAM;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;gBAEjB,MAAM,EAAE,WAAW;IAW/B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAED,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,KAAK;CAM9C"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,IAAI,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAG9E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,KAAM,YAAW,MAAM;IAClC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;;;;;;;;OAWG;gBACS,MAAM,EAAE,WAAW;IAW/B,2BAA2B;IAC3B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,4CAA4C;IAC5C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,oCAAoC;IACpC,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,KAAK;CAM9C"}

package/dist/agent.js

@@ -1,11 +1,46 @@
+import { nanoid } from 'nanoid';
 /**
- * Agent class implementation
+ * AI agent that can execute tasks using LLM and tools.
+ *
+ * @example
+ * ```ts
+ * import { Agent, tool } from '@cogitator-ai/core';
+ * import { z } from 'zod';
+ *
+ * const searchTool = tool({
+ *   name: 'search',
+ *   description: 'Search the web',
+ *   parameters: z.object({ query: z.string() }),
+ *   execute: async ({ query }) => ({ results: [] }),
+ * });
+ *
+ * const agent = new Agent({
+ *   name: 'researcher',
+ *   model: 'anthropic/claude-sonnet-4-20250514',
+ *   instructions: 'You are a research assistant.',
+ *   tools: [searchTool],
+ * });
+ * ```
  */
-import { nanoid } from 'nanoid';
 export class Agent {
+    /** Unique identifier for this agent instance */
     id;
+    /** Human-readable name of the agent */
     name;
+    /** Full configuration including model, instructions, tools, and parameters */
     config;
+    /**
+     * Create a new Agent instance.
+     *
+     * @param config - Agent configuration
+     * @param config.name - Human-readable name for the agent
+     * @param config.model - LLM model identifier (e.g., 'anthropic/claude-sonnet-4-20250514')
+     * @param config.instructions - System prompt defining agent behavior
+     * @param config.tools - Array of tools the agent can use
+     * @param config.temperature - Sampling temperature (default: 0.7)
+     * @param config.maxIterations - Maximum tool call iterations (default: 10)
+     * @param config.timeout - Run timeout in milliseconds (default: 120000)
+     */
     constructor(config) {
         this.id = config.id ?? `agent_${nanoid(12)}`;
         this.name = config.name;
@@ -16,15 +51,30 @@ export class Agent {
             ...config,
         };
     }
+    /** LLM model identifier */
     get model() {
         return this.config.model;
     }
+    /** System prompt defining agent behavior */
     get instructions() {
         return this.config.instructions;
     }
+    /** Tools available to this agent */
     get tools() {
         return this.config.tools ?? [];
     }
+    /**
+     * Create a copy of this agent with configuration overrides.
+     *
+     * @param overrides - Configuration values to override
+     * @returns New Agent instance with merged configuration
+     *
+     * @example
+     * ```ts
+     * const creativeAgent = agent.clone({ temperature: 0.9 });
+     * const fastAgent = agent.clone({ model: 'anthropic/claude-haiku' });
+     * ```
+     */
     clone(overrides) {
         return new Agent({
             ...this.config,

package/dist/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,OAAO,KAAK;IACP,EAAE,CAAS;IACX,IAAI,CAAS;IACb,MAAM,CAAc;IAE7B,YAAY,MAAmB;QAC7B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG;YACZ,WAAW,EAAE,GAAG;YAChB,aAAa,EAAE,EAAE;YACjB,OAAO,EAAE,OAAO;YAChB,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;IAClC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,SAA+B;QACnC,OAAO,IAAI,KAAK,CAAC;YACf,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,SAAS;SACb,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,KAAK;IAChB,gDAAgD;IACvC,EAAE,CAAS;IACpB,uCAAuC;IAC9B,IAAI,CAAS;IACtB,8EAA8E;IACrE,MAAM,CAAc;IAE7B;;;;;;;;;;;OAWG;IACH,YAAY,MAAmB;QAC7B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG;YACZ,WAAW,EAAE,GAAG;YAChB,aAAa,EAAE,EAAE;YACjB,OAAO,EAAE,OAAO;YAChB,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,4CAA4C;IAC5C,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;IAClC,CAAC;IAED,oCAAoC;IACpC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAA+B;QACnC,OAAO,IAAI,KAAK,CAAC;YACf,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,SAAS;SACb,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/cogitator/index.d.ts

@@ -0,0 +1,6 @@
+export { createSpan, getTextContent } from './span-factory';
+export { type SandboxManager, type InitializerState, initializeMemory, initializeSandbox, initializeReflection, initializeGuardrails, initializeCostRouting, cleanupState, } from './initializers';
+export { buildInitialMessages, saveEntry, enrichMessagesWithInsights, addContextToMessages, } from './message-builder';
+export { executeTool, createToolMessage } from './tool-executor';
+export { streamChat, type StreamChatResult } from './streaming';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cogitator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/cogitator/index.js

@@ -0,0 +1,6 @@
+export { createSpan, getTextContent } from './span-factory';
+export { initializeMemory, initializeSandbox, initializeReflection, initializeGuardrails, initializeCostRouting, cleanupState, } from './initializers';
+export { buildInitialMessages, saveEntry, enrichMessagesWithInsights, addContextToMessages, } from './message-builder';
+export { executeTool, createToolMessage } from './tool-executor';
+export { streamChat } from './streaming';
+//# sourceMappingURL=index.js.map

package/dist/cogitator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cogitator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAGL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAyB,MAAM,aAAa,CAAC"}

package/dist/cogitator/initializers.d.ts

@@ -0,0 +1,54 @@
+import type { CogitatorConfig, LLMBackend, MemoryAdapter, InsightStore } from '@cogitator-ai/types';
+import { ContextBuilder } from '@cogitator-ai/memory';
+import { ReflectionEngine } from '../reflection/index';
+import { ConstitutionalAI } from '../constitutional/index';
+import { CostAwareRouter } from '../cost-routing/index';
+import type { Agent } from '../agent';
+export type SandboxManager = {
+    initialize(): Promise<void>;
+    execute(request: {
+        command: string[];
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }, config: {
+        type: string;
+        image?: string;
+        resources?: unknown;
+        network?: unknown;
+        timeout?: number;
+    }): Promise<{
+        success: boolean;
+        data?: {
+            stdout: string;
+            stderr: string;
+            exitCode: number;
+            timedOut: boolean;
+            duration: number;
+        };
+        error?: string;
+    }>;
+    isDockerAvailable(): Promise<boolean>;
+    shutdown(): Promise<void>;
+};
+export interface InitializerState {
+    memoryAdapter?: MemoryAdapter;
+    contextBuilder?: ContextBuilder;
+    memoryInitialized: boolean;
+    sandboxManager?: SandboxManager;
+    sandboxInitialized: boolean;
+    reflectionEngine?: ReflectionEngine;
+    insightStore?: InsightStore;
+    reflectionInitialized: boolean;
+    constitutionalAI?: ConstitutionalAI;
+    guardrailsInitialized: boolean;
+    costRouter?: CostAwareRouter;
+    costRoutingInitialized: boolean;
+}
+export declare function initializeMemory(config: CogitatorConfig, state: InitializerState): Promise<void>;
+export declare function initializeSandbox(config: CogitatorConfig, state: InitializerState): Promise<void>;
+export declare function initializeReflection(config: CogitatorConfig, state: InitializerState, agent: Agent, getBackend: (model: string) => LLMBackend): Promise<void>;
+export declare function initializeGuardrails(config: CogitatorConfig, state: InitializerState, agent: Agent, getBackend: (model: string) => LLMBackend): void;
+export declare function initializeCostRouting(config: CogitatorConfig, state: InitializerState): void;
+export declare function cleanupState(state: InitializerState): Promise<void>;
+//# sourceMappingURL=initializers.d.ts.map

package/dist/cogitator/initializers.d.ts.map

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

package/dist/cogitator/initializers.js

@@ -0,0 +1,126 @@
+import { InMemoryAdapter, RedisAdapter, PostgresAdapter, ContextBuilder, } from '@cogitator-ai/memory';
+import { getLogger } from '../logger';
+import { ReflectionEngine, InMemoryInsightStore } from '../reflection/index';
+import { ConstitutionalAI } from '../constitutional/index';
+import { CostAwareRouter } from '../cost-routing/index';
+export async function initializeMemory(config, state) {
+    if (state.memoryInitialized || !config.memory?.adapter)
+        return;
+    const provider = config.memory.adapter;
+    let adapter;
+    if (provider === 'memory') {
+        adapter = new InMemoryAdapter({
+            provider: 'memory',
+            ...config.memory.inMemory,
+        });
+    }
+    else if (provider === 'redis') {
+        const url = config.memory.redis?.url;
+        if (!url) {
+            getLogger().warn('Redis adapter requires url in config');
+            return;
+        }
+        adapter = new RedisAdapter({
+            provider: 'redis',
+            url,
+            ...config.memory.redis,
+        });
+    }
+    else if (provider === 'postgres') {
+        const connectionString = config.memory.postgres?.connectionString;
+        if (!connectionString) {
+            getLogger().warn('Postgres adapter requires connectionString in config');
+            return;
+        }
+        adapter = new PostgresAdapter({
+            provider: 'postgres',
+            connectionString,
+            ...config.memory.postgres,
+        });
+    }
+    else {
+        getLogger().warn(`Unknown memory provider: ${provider}`);
+        return;
+    }
+    const result = await adapter.connect();
+    if (!result.success) {
+        getLogger().warn('Memory adapter connection failed', { error: result.error });
+        return;
+    }
+    state.memoryAdapter = adapter;
+    if (config.memory.contextBuilder) {
+        const deps = {
+            memoryAdapter: state.memoryAdapter,
+        };
+        const contextConfig = {
+            maxTokens: config.memory.contextBuilder.maxTokens ?? 4000,
+            strategy: config.memory.contextBuilder.strategy ?? 'recent',
+            ...config.memory.contextBuilder,
+        };
+        state.contextBuilder = new ContextBuilder(contextConfig, deps);
+    }
+    state.memoryInitialized = true;
+}
+export async function initializeSandbox(config, state) {
+    if (state.sandboxInitialized)
+        return;
+    try {
+        const { SandboxManager } = await import('@cogitator-ai/sandbox');
+        state.sandboxManager = new SandboxManager(config.sandbox);
+        await state.sandboxManager.initialize();
+        state.sandboxInitialized = true;
+    }
+    catch {
+        state.sandboxInitialized = true;
+    }
+}
+export async function initializeReflection(config, state, agent, getBackend) {
+    if (state.reflectionInitialized || !config.reflection?.enabled)
+        return;
+    const backend = getBackend(config.reflection.reflectionModel ?? agent.model);
+    state.insightStore = new InMemoryInsightStore();
+    state.reflectionEngine = new ReflectionEngine({
+        llm: backend,
+        insightStore: state.insightStore,
+        config: config.reflection,
+    });
+    state.reflectionInitialized = true;
+}
+export function initializeGuardrails(config, state, agent, getBackend) {
+    if (state.guardrailsInitialized || !config.guardrails?.enabled)
+        return;
+    const backend = getBackend(config.guardrails.model ?? agent.model);
+    state.constitutionalAI = new ConstitutionalAI({
+        llm: backend,
+        constitution: config.guardrails.constitution,
+        config: config.guardrails,
+    });
+    state.guardrailsInitialized = true;
+}
+export function initializeCostRouting(config, state) {
+    if (state.costRoutingInitialized || !config.costRouting?.enabled)
+        return;
+    state.costRouter = new CostAwareRouter({ config: config.costRouting });
+    state.costRoutingInitialized = true;
+}
+export async function cleanupState(state) {
+    if (state.memoryAdapter) {
+        await state.memoryAdapter.disconnect();
+        state.memoryAdapter = undefined;
+        state.contextBuilder = undefined;
+        state.memoryInitialized = false;
+    }
+    if (state.sandboxManager) {
+        await state.sandboxManager.shutdown();
+        state.sandboxManager = undefined;
+        state.sandboxInitialized = false;
+    }
+    state.reflectionEngine = undefined;
+    state.insightStore = undefined;
+    state.reflectionInitialized = false;
+    state.constitutionalAI = undefined;
+    state.guardrailsInitialized = false;
+    state.costRouter = undefined;
+    state.costRoutingInitialized = false;
+}
+//# sourceMappingURL=initializers.js.map

package/dist/cogitator/initializers.js.map

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

package/dist/cogitator/message-builder.d.ts

@@ -0,0 +1,10 @@
+import type { Message, RunOptions, MemoryAdapter, ToolCall, ToolResult } from '@cogitator-ai/types';
+import { ContextBuilder } from '@cogitator-ai/memory';
+import type { Agent } from '../agent';
+import type { ReflectionEngine } from '../reflection/index';
+import type { AgentContext } from '@cogitator-ai/types';
+export declare function buildInitialMessages(agent: Agent, options: RunOptions, threadId: string, memoryAdapter: MemoryAdapter | undefined, contextBuilder: ContextBuilder | undefined): Promise<Message[]>;
+export declare function saveEntry(threadId: string, agentId: string, message: Message, memoryAdapter: MemoryAdapter | undefined, toolCalls?: ToolCall[], toolResults?: ToolResult[], onError?: (error: Error, operation: 'save' | 'load') => void): Promise<void>;
+export declare function enrichMessagesWithInsights(messages: Message[], reflectionEngine: ReflectionEngine, agentContext: AgentContext): Promise<void>;
+export declare function addContextToMessages(messages: Message[], context: Record<string, unknown>): void;
+//# sourceMappingURL=message-builder.d.ts.map

package/dist/cogitator/message-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-builder.d.ts","sourceRoot":"","sources":["../../src/cogitator/message-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,cAAc,EAAsB,MAAM,sBAAsB,CAAC;AAE1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,cAAc,EAAE,cAAc,GAAG,SAAS,GACzC,OAAO,CAAC,OAAO,EAAE,CAAC,CAoCpB;AAED,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,SAAS,CAAC,EAAE,QAAQ,EAAE,EACtB,WAAW,CAAC,EAAE,UAAU,EAAE,EAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,GAC3D,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,OAAO,EAAE,EACnB,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAOhG"}

package/dist/cogitator/message-builder.js

@@ -0,0 +1,72 @@
+import { countMessageTokens } from '@cogitator-ai/memory';
+import { getLogger } from '../logger';
+export async function buildInitialMessages(agent, options, threadId, memoryAdapter, contextBuilder) {
+    if (!memoryAdapter || options.useMemory === false) {
+        return [
+            { role: 'system', content: agent.instructions },
+            { role: 'user', content: options.input },
+        ];
+    }
+    const threadResult = await memoryAdapter.getThread(threadId);
+    if (!threadResult.success || !threadResult.data) {
+        await memoryAdapter.createThread(agent.id, { agentId: agent.id }, threadId);
+    }
+    if (contextBuilder && options.loadHistory !== false) {
+        const ctx = await contextBuilder.build({
+            threadId,
+            agentId: agent.id,
+            systemPrompt: agent.instructions,
+        });
+        return [...ctx.messages, { role: 'user', content: options.input }];
+    }
+    if (options.loadHistory !== false) {
+        const entries = await memoryAdapter.getEntries({ threadId, limit: 20 });
+        const messages = [{ role: 'system', content: agent.instructions }];
+        if (entries.success) {
+            messages.push(...entries.data.map((e) => e.message));
+        }
+        messages.push({ role: 'user', content: options.input });
+        return messages;
+    }
+    return [
+        { role: 'system', content: agent.instructions },
+        { role: 'user', content: options.input },
+    ];
+}
+export async function saveEntry(threadId, agentId, message, memoryAdapter, toolCalls, toolResults, onError) {
+    if (!memoryAdapter)
+        return;
+    try {
+        const threadResult = await memoryAdapter.getThread(threadId);
+        if (!threadResult.success || !threadResult.data) {
+            await memoryAdapter.createThread(agentId, { agentId }, threadId);
+        }
+        await memoryAdapter.addEntry({
+            threadId,
+            message,
+            toolCalls,
+            toolResults,
+            tokenCount: countMessageTokens(message),
+        });
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        getLogger().warn('Failed to save memory entry', { error: error.message });
+        onError?.(error, 'save');
+    }
+}
+export async function enrichMessagesWithInsights(messages, reflectionEngine, agentContext) {
+    const insights = await reflectionEngine.getRelevantInsights(agentContext);
+    if (insights.length > 0 && messages.length > 0 && messages[0].role === 'system') {
+        messages[0].content += `\n\nPast learnings that may help:\n${insights.map((i) => `- ${i.content}`).join('\n')}`;
+    }
+}
+export function addContextToMessages(messages, context) {
+    if (messages.length > 0 && messages[0].role === 'system') {
+        const contextStr = Object.entries(context)
+            .map(([k, v]) => `${k}: ${JSON.stringify(v)}`)
+            .join('\n');
+        messages[0].content += `\n\nContext:\n${contextStr}`;
+    }
+}
+//# sourceMappingURL=message-builder.js.map

package/dist/cogitator/message-builder.js.map

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

package/dist/cogitator/span-factory.d.ts

@@ -0,0 +1,4 @@
+import type { Span, MessageContent } from '@cogitator-ai/types';
+export declare function createSpan(name: string, traceId: string, parentId: string | undefined, startTime: number, endTime: number, attributes: Record<string, unknown>, status?: 'ok' | 'error' | 'unset', kind?: Span['kind'], onSpan?: (span: Span) => void): Span;
+export declare function getTextContent(content: MessageContent): string;
+//# sourceMappingURL=span-factory.d.ts.map

package/dist/cogitator/span-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-factory.d.ts","sourceRoot":"","sources":["../../src/cogitator/span-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhE,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,GAAE,IAAI,GAAG,OAAO,GAAG,OAAc,EACvC,IAAI,GAAE,IAAI,CAAC,MAAM,CAAc,EAC/B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAC5B,IAAI,CAeN;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAQ9D"}

package/dist/cogitator/span-factory.js

@@ -0,0 +1,27 @@
+import { nanoid } from 'nanoid';
+export function createSpan(name, traceId, parentId, startTime, endTime, attributes, status = 'ok', kind = 'internal', onSpan) {
+    const span = {
+        id: `span_${nanoid(12)}`,
+        traceId,
+        parentId,
+        name,
+        kind,
+        status,
+        startTime,
+        endTime,
+        duration: endTime - startTime,
+        attributes,
+    };
+    onSpan?.(span);
+    return span;
+}
+export function getTextContent(content) {
+    if (typeof content === 'string') {
+        return content;
+    }
+    return content
+        .filter((part) => part.type === 'text')
+        .map((part) => part.text)
+        .join(' ');
+}
+//# sourceMappingURL=span-factory.js.map

package/dist/cogitator/span-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-factory.js","sourceRoot":"","sources":["../../src/cogitator/span-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,OAAe,EACf,QAA4B,EAC5B,SAAiB,EACjB,OAAe,EACf,UAAmC,EACnC,SAAmC,IAAI,EACvC,OAAqB,UAAU,EAC/B,MAA6B;IAE7B,MAAM,IAAI,GAAS;QACjB,EAAE,EAAE,QAAQ,MAAM,CAAC,EAAE,CAAC,EAAE;QACxB,OAAO;QACP,QAAQ;QACR,IAAI;QACJ,IAAI;QACJ,MAAM;QACN,SAAS;QACT,OAAO;QACP,QAAQ,EAAE,OAAO,GAAG,SAAS;QAC7B,UAAU;KACX,CAAC;IACF,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IACf,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,IAAI,EAA0C,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SAC9E,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/cogitator/streaming.d.ts

@@ -0,0 +1,16 @@
+import type { LLMBackend, Message, ToolCall } from '@cogitator-ai/types';
+import { ToolRegistry } from '../registry';
+import type { Agent } from '../agent';
+export interface StreamChatResult {
+    id: string;
+    content: string;
+    toolCalls?: ToolCall[];
+    finishReason: 'stop' | 'tool_calls' | 'length' | 'error';
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+}
+export declare function streamChat(backend: LLMBackend, model: string, messages: Message[], registry: ToolRegistry, agent: Agent, onToken: (token: string) => void): Promise<StreamChatResult>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/cogitator/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/cogitator/streaming.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzD,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAoD3B"}

package/dist/cogitator/streaming.js

@@ -0,0 +1,52 @@
+import { nanoid } from 'nanoid';
+import { countMessagesTokens } from '@cogitator-ai/memory';
+export async function streamChat(backend, model, messages, registry, agent, onToken) {
+    let content = '';
+    let toolCalls;
+    let finishReason = 'stop';
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let hasUsageFromStream = false;
+    const stream = backend.chatStream({
+        model,
+        messages,
+        tools: registry.getSchemas(),
+        temperature: agent.config.temperature,
+        topP: agent.config.topP,
+        maxTokens: agent.config.maxTokens,
+        stop: agent.config.stopSequences,
+    });
+    for await (const chunk of stream) {
+        if (chunk.delta.content) {
+            content += chunk.delta.content;
+            onToken(chunk.delta.content);
+        }
+        if (chunk.delta.toolCalls) {
+            toolCalls = chunk.delta.toolCalls;
+        }
+        if (chunk.finishReason) {
+            finishReason = chunk.finishReason;
+        }
+        if (chunk.usage) {
+            inputTokens = chunk.usage.inputTokens;
+            outputTokens = chunk.usage.outputTokens;
+            hasUsageFromStream = true;
+        }
+    }
+    if (!hasUsageFromStream) {
+        inputTokens = countMessagesTokens(messages);
+        outputTokens = Math.ceil(content.length / 4);
+    }
+    return {
+        id: `stream_${nanoid(8)}`,
+        content,
+        toolCalls,
+        finishReason,
+        usage: {
+            inputTokens,
+            outputTokens,
+            totalTokens: inputTokens + outputTokens,
+        },
+    };
+}
+//# sourceMappingURL=streaming.js.map

package/dist/cogitator/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/cogitator/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAgB3D,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAmB,EACnB,KAAa,EACb,QAAmB,EACnB,QAAsB,EACtB,KAAY,EACZ,OAAgC;IAEhC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,SAAiC,CAAC;IACtC,IAAI,YAAY,GAA+C,MAAM,CAAC;IACtE,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAE/B,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;QAChC,KAAK;QACL,QAAQ;QACR,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE;QAC5B,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW;QACrC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;QACvB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;QACjC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,aAAa;KACjC,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAC1B,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,SAAuB,CAAC;QAClD,CAAC;QACD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;QACpC,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC;YACtC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC;YACxC,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC5C,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,EAAE,EAAE,UAAU,MAAM,CAAC,CAAC,CAAC,EAAE;QACzB,OAAO;QACP,SAAS;QACT,YAAY;QACZ,KAAK,EAAE;YACL,WAAW;YACX,YAAY;YACZ,WAAW,EAAE,WAAW,GAAG,YAAY;SACxC;KACF,CAAC;AACJ,CAAC"}

package/dist/cogitator/tool-executor.d.ts

@@ -0,0 +1,7 @@
+import type { ToolCall, ToolResult, Message } from '@cogitator-ai/types';
+import { ToolRegistry } from '../registry';
+import type { SandboxManager } from './initializers';
+import type { ConstitutionalAI } from '../constitutional/index';
+export declare function executeTool(registry: ToolRegistry, toolCall: ToolCall, runId: string, agentId: string, sandboxManager: SandboxManager | undefined, constitutionalAI: ConstitutionalAI | undefined, filterToolCalls: boolean, initializeSandbox: () => Promise<void>, signal?: AbortSignal): Promise<ToolResult>;
+export declare function createToolMessage(toolCall: ToolCall, result: ToolResult): Message;
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/cogitator/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/cogitator/tool-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,UAAU,EAAe,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,cAAc,GAAG,SAAS,EAC1C,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,EAC9C,eAAe,EAAE,OAAO,EACxB,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACtC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAgErB;AA2FD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAOjF"}