@easynet/agent-runtime 1.0.1

package/dist/config.d.ts

@@ -0,0 +1,86 @@
+import type { ConfigApi, BaseAppConfig } from "./context.js";
+/** Resolved skills configuration for an agent. */
+export interface SkillsConfig {
+    path: string;
+    mode?: "prompt" | "subagent";
+    inject_metadata?: boolean;
+    embedding_threshold?: number;
+    keyword_threshold?: number;
+}
+export type AgentProfileConfig = {
+    path?: string;
+    models?: {
+        path?: string;
+    };
+    llm?: {
+        path?: string;
+    };
+    memory?: {
+        path?: string;
+        namespace?: string;
+        top_k?: number;
+        budget_tokens?: number;
+        auto_write?: boolean;
+        auto_write_scope?: "thread" | "cross_thread" | "knowledge" | "auto";
+        auto_write_max_chars?: number;
+        auto_write_user?: boolean;
+        auto_write_assistant?: boolean;
+    };
+    tools?: {
+        path?: string;
+        development?: string;
+        production?: string;
+    };
+    skills?: {
+        path?: string;
+        mode?: "prompt" | "subagent";
+        inject_metadata?: boolean;
+        embedding_threshold?: number;
+        keyword_threshold?: number;
+    };
+    system_prompt?: string;
+    max_steps?: number;
+    print_steps?: boolean;
+    fallback_text?: string;
+    command_window_label?: string;
+    recursion_limit?: number;
+    memories_path?: string;
+};
+export interface AppConfig extends BaseAppConfig {
+    app?: {
+        name?: string;
+        env?: string;
+        memory?: {
+            namespace_mode?: "thread" | "fixed";
+            namespace?: string;
+        };
+        agent?: Record<string, AgentProfileConfig>;
+    };
+}
+export interface AppConfigDefaults {
+    /** Default models config path, e.g. "config/agents/shared/models.yaml" */
+    modelsPath?: string;
+    /** Default memory config path, e.g. "config/agents/shared/memory.yaml" */
+    memoryPath?: string;
+    /** Default tool config path, e.g. "config/agents/shared/tool.yaml" */
+    toolPath?: string;
+    /** Default tool config path for development */
+    toolDevPath?: string;
+    /** Default tool config path for production */
+    toolProdPath?: string;
+}
+export declare function loadAppConfig(configPath?: string): Promise<AppConfig>;
+export declare function getModelsConfigPath(config?: AppConfig, agentName?: string, defaults?: AppConfigDefaults): string;
+export declare function getMemoryConfigPath(config?: AppConfig, agentName?: string, defaults?: AppConfigDefaults): string;
+export declare function getToolConfigPath(config: AppConfig | undefined, agentName: string | undefined, defaults?: AppConfigDefaults): string;
+/**
+ * Create a ConfigApi suitable for `createContextBuilders`.
+ * Apps can supply defaults (e.g. custom tool paths) or use the built-in ones.
+ */
+export declare function createConfigApi(defaults?: AppConfigDefaults): ConfigApi<AppConfig>;
+/**
+ * Resolve the SkillsConfig for a given agent, if configured.
+ * Resolves relative `path` to absolute using APP_ROOT.
+ */
+export declare function getSkillsConfig(config: AppConfig | undefined, agentName?: string): SkillsConfig | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -0,0 +1,84 @@
+/**
+ * Shared app config: YAML loading, path resolution.
+ * Apps supply only their defaults (e.g. tool file paths).
+ */
+import { join } from "node:path";
+import { loadYamlFile } from "@easynet/agent-common";
+const APP_ROOT = process.cwd();
+const DEFAULT_MODELS_PATH = "config/agents/shared/models.yaml";
+const DEFAULT_MEMORY_PATH = "config/agents/shared/memory.yaml";
+const DEFAULT_TOOL_PATH = "config/agents/shared/tool.yaml";
+export async function loadAppConfig(configPath) {
+    const path = configPath ?? join(APP_ROOT, "config", "app.yaml");
+    const loaded = (await loadYamlFile(path)) ?? {};
+    const agents = loaded.app?.agent;
+    if (!agents)
+        return loaded;
+    const mergedAgents = Object.fromEntries(await Promise.all(Object.entries(agents).map(async ([agentName, agentConfig]) => {
+        const filePath = agentConfig?.path;
+        if (!filePath)
+            return [agentName, agentConfig];
+        const resolved = filePath.startsWith("/") ? filePath : join(APP_ROOT, filePath);
+        const loadedAgent = (await loadYamlFile(resolved)) ?? {};
+        return [agentName, { ...loadedAgent, ...agentConfig, path: filePath }];
+    })));
+    return {
+        ...loaded,
+        app: {
+            ...loaded.app,
+            agent: mergedAgents,
+        },
+    };
+}
+export function getModelsConfigPath(config, agentName = "react", defaults) {
+    const agent = config?.app?.agent?.[agentName];
+    const p = agent?.models?.path ?? agent?.llm?.path ?? defaults?.modelsPath ?? DEFAULT_MODELS_PATH;
+    return p.startsWith("/") ? p : join(APP_ROOT, p);
+}
+export function getMemoryConfigPath(config, agentName = "react", defaults) {
+    const p = config?.app?.agent?.[agentName]?.memory?.path ?? defaults?.memoryPath ?? DEFAULT_MEMORY_PATH;
+    return p.startsWith("/") ? p : join(APP_ROOT, p);
+}
+export function getToolConfigPath(config, agentName, defaults) {
+    const name = agentName ?? "react";
+    const envFromProcess = (process.env.APP_ENV ?? process.env.NODE_ENV ?? "").trim().toLowerCase();
+    const envFromConfig = (config?.app?.env ?? "").trim().toLowerCase();
+    const env = envFromProcess || envFromConfig || "development";
+    const isProd = env === "production" || env === "prod";
+    const tools = config?.app?.agent?.[name]?.tools;
+    const fallback = defaults?.toolPath ?? DEFAULT_TOOL_PATH;
+    const p = isProd
+        ? (tools?.production ?? tools?.path ?? defaults?.toolProdPath ?? fallback)
+        : (tools?.development ?? tools?.path ?? defaults?.toolDevPath ?? fallback);
+    return p.startsWith("/") ? p : join(APP_ROOT, p);
+}
+/**
+ * Create a ConfigApi suitable for `createContextBuilders`.
+ * Apps can supply defaults (e.g. custom tool paths) or use the built-in ones.
+ */
+export function createConfigApi(defaults) {
+    return {
+        loadAppConfig,
+        getModelsConfigPath: (config, agentName) => getModelsConfigPath(config, agentName, defaults),
+        getMemoryConfigPath: (config, agentName) => getMemoryConfigPath(config, agentName, defaults),
+        getToolConfigPath: (config, agentName) => getToolConfigPath(config, agentName, defaults),
+    };
+}
+/**
+ * Resolve the SkillsConfig for a given agent, if configured.
+ * Resolves relative `path` to absolute using APP_ROOT.
+ */
+export function getSkillsConfig(config, agentName = "react") {
+    const raw = config?.app?.agent?.[agentName]?.skills;
+    if (!raw?.path)
+        return undefined;
+    const resolved = raw.path.startsWith("/") ? raw.path : join(APP_ROOT, raw.path);
+    return {
+        path: resolved,
+        mode: raw.mode,
+        inject_metadata: raw.inject_metadata,
+        embedding_threshold: raw.embedding_threshold,
+        keyword_threshold: raw.keyword_threshold,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,104 @@
+import { createLangChainToolsAsync as createToolsClient } from "@easynet/agent-tool/api";
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import type { AgentMemoryClient } from "@easynet/agent-memory";
+import { type AgentEventBus } from "@easynet/agent-common";
+import { type SkillSet } from "@easynet/agent-skill";
+import { type AppConfigDefaults } from "./config.js";
+export interface BaseAppConfig {
+    app?: {
+        name?: string;
+        env?: string;
+        memory?: {
+            namespace_mode?: "thread" | "fixed";
+            namespace?: string;
+        };
+        agent?: Record<string, {
+            models?: {
+                path?: string;
+            };
+            llm?: {
+                path?: string;
+            };
+            memory?: {
+                path?: string;
+                namespace?: string;
+                top_k?: number;
+                budget_tokens?: number;
+                auto_write?: boolean;
+                auto_write_scope?: "thread" | "cross_thread" | "knowledge" | "auto";
+                auto_write_max_chars?: number;
+                auto_write_user?: boolean;
+                auto_write_assistant?: boolean;
+            };
+            tools?: {
+                path?: string;
+                development?: string;
+                production?: string;
+            };
+            skills?: {
+                path?: string;
+                mode?: "prompt" | "subagent";
+                inject_metadata?: boolean;
+                embedding_threshold?: number;
+                keyword_threshold?: number;
+            };
+            system_prompt?: string;
+            max_steps?: number;
+            print_steps?: boolean;
+            fallback_text?: string;
+            command_window_label?: string;
+            recursion_limit?: number;
+            memories_path?: string;
+        }>;
+    };
+}
+export type AgentName = string;
+export type BotTool = Awaited<ReturnType<typeof createToolsClient>>[number];
+export interface BotContext<TConfig extends BaseAppConfig = BaseAppConfig, TTool = BotTool> {
+    llm: BaseChatModel;
+    memory: AgentMemoryClient;
+    tools: TTool[];
+    config: TConfig;
+    events: AgentEventBus;
+    skillSet?: SkillSet;
+}
+export interface CreateContextOptions<TTool = BotTool> {
+    configPath?: string;
+    agentName?: AgentName;
+    events?: AgentEventBus;
+    llm?: BaseChatModel;
+    memory?: AgentMemoryClient;
+    tools?: TTool[];
+}
+export interface ConfigApi<TConfig> {
+    loadAppConfig: (configPath?: string) => Promise<TConfig>;
+    getModelsConfigPath: (config: TConfig, agentName?: AgentName) => string;
+    getMemoryConfigPath: (config: TConfig, agentName?: AgentName) => string;
+    getToolConfigPath: (config: TConfig, agentName?: AgentName) => string;
+}
+export declare function createContextBuilders<TConfig extends BaseAppConfig>(params: {
+    configApi: ConfigApi<TConfig>;
+}): {
+    createAgentLlm: (config: TConfig, events: AgentEventBus, agentName?: AgentName) => Promise<BaseChatModel>;
+    createAgentMemory: (config: TConfig, events: AgentEventBus, agentName?: AgentName) => Promise<AgentMemoryClient>;
+    createAgentTools: (config: TConfig, events: AgentEventBus, agentName?: AgentName) => Promise<BotTool[]>;
+    createAgent: (options?: CreateContextOptions<BotTool>) => Promise<BotContext<TConfig, BotTool>>;
+    createBotContext: (configPath?: string, agentName?: AgentName) => Promise<BotContext<TConfig, BotTool>>;
+};
+/**
+ * High-level factory: creates context builders from config defaults.
+ * Apps call this once and destructure the helpers they need.
+ *
+ * ```ts
+ * const { createBotContext, createAgent } = createAppContext();
+ * ```
+ */
+export interface AppContextBuilders {
+    createAgentLlm: (config: BaseAppConfig, events: AgentEventBus, agentName?: AgentName) => Promise<BaseChatModel>;
+    createAgentMemory: (config: BaseAppConfig, events: AgentEventBus, agentName?: AgentName) => Promise<AgentMemoryClient>;
+    createAgentTools: (config: BaseAppConfig, events: AgentEventBus, agentName?: AgentName) => Promise<BotTool[]>;
+    createAgent: (options?: CreateContextOptions<BotTool>) => Promise<BotContext>;
+    createBotContext: (configPath?: string, agentName?: AgentName) => Promise<BotContext>;
+}
+export declare function createAppContext(defaults?: AppConfigDefaults): AppContextBuilders;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

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

package/dist/context.js

@@ -0,0 +1,111 @@
+import { createAgentLlm as createModelLlm, applyToolChoiceAuto, createEmbedFnFromModelsConfig } from "@easynet/agent-model";
+import { createAgentMemory as createMemoryClient } from "@easynet/agent-memory";
+import { createLangChainToolsAsync as createToolsClient } from "@easynet/agent-tool/api";
+import { createAgentEventBus, loadYamlFile, } from "@easynet/agent-common";
+import { createSkills } from "@easynet/agent-skill";
+import { createConfigApi, getSkillsConfig } from "./config.js";
+import { resolve, dirname } from "node:path";
+function publishEvent(events, name, from, to, payload) {
+    events.publish({ name, from, to, payload });
+}
+export function createContextBuilders(params) {
+    const { loadAppConfig, getModelsConfigPath, getMemoryConfigPath, getToolConfigPath, } = params.configApi;
+    async function createAgentLlm(config, events, agentName = "react") {
+        const modelsPath = getModelsConfigPath(config, agentName);
+        publishEvent(events, "llm.init.start", "app", "llm", { configPath: modelsPath });
+        const llm = await createModelLlm({ configPath: modelsPath });
+        applyToolChoiceAuto(llm);
+        publishEvent(events, "llm.init.done", "llm", "app");
+        return llm;
+    }
+    async function createAgentMemory(config, events, agentName = "react") {
+        const memoryPath = getMemoryConfigPath(config, agentName);
+        publishEvent(events, "memory.init.start", "app", "memory", { configPath: memoryPath });
+        const memory = await createMemoryClient({ configPath: memoryPath });
+        publishEvent(events, "memory.init.done", "memory", "app");
+        return memory;
+    }
+    async function createAgentTools(config, events, agentName = "react") {
+        const toolPath = getToolConfigPath(config, agentName);
+        publishEvent(events, "tools.init.start", "app", "tools", { configPath: toolPath });
+        const tools = await createToolsClient({ configFilePath: toolPath });
+        publishEvent(events, "tools.init.done", "tools", "app", { count: tools.length });
+        return tools;
+    }
+    async function createAgent(options = {}) {
+        const config = await loadAppConfig(options.configPath);
+        const agentName = options.agentName ?? "react";
+        const events = options.events ?? createAgentEventBus();
+        publishEvent(events, "agent.context.init.start", "app", "runtime");
+        const [llm, memory, tools] = await Promise.all([
+            options.llm ?? createAgentLlm(config, events, agentName),
+            options.memory ?? createAgentMemory(config, events, agentName),
+            options.tools ?? createAgentTools(config, events, agentName),
+        ]);
+        // Load skills via createSkills (scans directory, builds index)
+        let skillSet;
+        const skillsConfig = getSkillsConfig(config, agentName);
+        if (skillsConfig) {
+            publishEvent(events, "skills.init.start", "app", "skills", { path: skillsConfig.path });
+            // Build embedFn from models.yaml embed section (unified source)
+            let embedFn;
+            try {
+                const modelsPath = getModelsConfigPath(config, agentName);
+                embedFn = createEmbedFnFromModelsConfig(modelsPath);
+            }
+            catch {
+                // Embedding is optional; skill matching falls back to keywords
+            }
+            // Resolve skills directory path (from YAML or direct path)
+            const skillsDir = await resolveSkillsDir(skillsConfig.path);
+            skillSet = await createSkills({ path: skillsDir, embed: embedFn });
+            // Inject skill metadata into system prompt (prompt mode)
+            const mode = skillsConfig.mode ?? "prompt";
+            if (mode === "prompt" && skillsConfig.inject_metadata !== false) {
+                const section = skillSet.promptSection();
+                if (section) {
+                    const agentConfig = config.app?.agent?.[agentName];
+                    if (agentConfig) {
+                        const currentPrompt = agentConfig.system_prompt ?? "";
+                        agentConfig.system_prompt = currentPrompt.trimEnd() + "\n\n" + section;
+                    }
+                }
+            }
+            publishEvent(events, "skills.init.done", "skills", "app", {
+                count: skillSet.list().length,
+                mode,
+            });
+        }
+        publishEvent(events, "agent.context.init.done", "runtime", "app");
+        return { llm, memory, tools, config, events, skillSet };
+    }
+    async function createBotContext(configPath, agentName = "react") {
+        return createAgent({ configPath, agentName });
+    }
+    return {
+        createAgentLlm,
+        createAgentMemory,
+        createAgentTools,
+        createAgent,
+        createBotContext,
+    };
+}
+/**
+ * Resolve skills directory path from either a YAML config file or a direct path.
+ * If the path ends with .yaml/.yml, loads the YAML and extracts the `path:` field.
+ */
+async function resolveSkillsDir(skillsPath) {
+    if (/\.ya?ml$/i.test(skillsPath)) {
+        const raw = await loadYamlFile(skillsPath);
+        if (!raw?.path) {
+            throw new Error(`skills config missing "path" field: ${skillsPath}`);
+        }
+        return resolve(dirname(skillsPath), raw.path);
+    }
+    return skillsPath;
+}
+export function createAppContext(defaults) {
+    const configApi = createConfigApi(defaults);
+    return createContextBuilders({ configApi });
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/deep-agent.d.ts

@@ -0,0 +1,29 @@
+import type { BaseAppConfig, BotContext } from "./context.js";
+export interface DeepAgentRuntime {
+    agent: unknown;
+    run: (userMessage: string) => Promise<{
+        text: string;
+        messages?: unknown;
+    }>;
+}
+export interface DeepAgentOptions {
+    agentName?: string;
+    systemPrompt?: string;
+    recursionLimit?: number;
+    autoWriteMemory?: boolean;
+}
+export declare function createDeepAgent<TConfig extends BaseAppConfig>(ctx: BotContext<TConfig>, options?: DeepAgentOptions): Promise<{
+    agent: {
+        invoke: (input: {
+            messages: Array<{
+                role: "user" | "assistant";
+                content: string;
+            }>;
+        }) => Promise<unknown>;
+    };
+    run(userMessage: string): Promise<{
+        text: string;
+        messages?: unknown;
+    }>;
+}>;
+//# sourceMappingURL=deep-agent.d.ts.map

package/dist/deep-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-agent.d.ts","sourceRoot":"","sources":["../src/deep-agent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAsB,eAAe,CAAC,OAAO,SAAS,aAAa,EACjE,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,EACxB,OAAO,GAAE,gBAAqB;;gBA0BpB,CAAC,KAAK,EAAE;YACd,QAAQ,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAClE,KAAK,OAAO,CAAC,OAAO,CAAC;;qBASC,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;GA6ChF"}

package/dist/deep-agent.js

@@ -0,0 +1,77 @@
+import { createDeepAgent as createDeepAgentRuntime, StateBackend, } from "deepagents";
+import { extractLastMessageText } from "@easynet/agent-common";
+export async function createDeepAgent(ctx, options = {}) {
+    const publish = (name, from, to, payload) => {
+        ctx.events.publish({ name, from, to, payload });
+    };
+    publish("agent.deep.init.start", "app", "deep-agent");
+    const agentName = options.agentName ?? "deep";
+    const configDeep = ctx.config.app?.agent?.[agentName];
+    const promptFromConfig = configDeep?.system_prompt;
+    const systemPrompt = options.systemPrompt ?? promptFromConfig;
+    const recursionLimit = options.recursionLimit ?? configDeep?.recursion_limit;
+    const namespace = configDeep?.memory?.namespace;
+    const autoWriteMemory = options.autoWriteMemory ?? (configDeep?.memory?.auto_write ?? true);
+    const autoWriteScope = configDeep?.memory?.auto_write_scope ?? "thread";
+    const autoWriteMaxChars = configDeep?.memory?.auto_write_max_chars ?? 2400;
+    const autoWriteUser = configDeep?.memory?.auto_write_user ?? true;
+    const autoWriteAssistant = configDeep?.memory?.auto_write_assistant ?? true;
+    const agent = createDeepAgentRuntime({
+        model: ctx.llm,
+        tools: ctx.tools,
+        backend: (config) => new StateBackend(config),
+        systemPrompt,
+    });
+    const conversationHistory = [];
+    const maxHistoryMessages = 24;
+    publish("agent.deep.init.done", "deep-agent", "app");
+    return {
+        agent,
+        async run(userMessage) {
+            publish("agent.deep.run.start", "user", "deep-agent", { userMessage });
+            const runnable = typeof recursionLimit === "number"
+                ? (agent
+                    .withConfig?.({ recursionLimit }) ?? agent)
+                : agent;
+            const result = await runnable.invoke({
+                messages: [...conversationHistory, { role: "user", content: userMessage }],
+            });
+            const messages = result?.messages ?? result;
+            const text = extractLastMessageText(result);
+            conversationHistory.push({ role: "user", content: userMessage });
+            if (text.trim().length > 0) {
+                conversationHistory.push({ role: "assistant", content: text });
+            }
+            if (conversationHistory.length > maxHistoryMessages) {
+                conversationHistory.splice(0, conversationHistory.length - maxHistoryMessages);
+            }
+            if (namespace && autoWriteMemory) {
+                const scope = autoWriteScope === "auto" ? "thread" : autoWriteScope;
+                const writeItems = [];
+                if (autoWriteUser && userMessage.trim().length > 0) {
+                    writeItems.push(`[user]\n${userMessage.trim()}`);
+                }
+                if (autoWriteAssistant && text.trim().length > 0) {
+                    writeItems.push(`[assistant]\n${text.trim()}`);
+                }
+                const content = writeItems.join("\n\n").slice(0, Math.max(0, autoWriteMaxChars));
+                if (content.length > 0) {
+                    try {
+                        publish("agent.deep.memory.write.start", "deep-agent", "memory", { type: scope, auto: true });
+                        await ctx.memory.memorize(namespace, scope, content);
+                        publish("agent.deep.memory.write.done", "memory", "deep-agent", { type: scope, auto: true });
+                    }
+                    catch (err) {
+                        publish("agent.deep.memory.write.error", "memory", "deep-agent", {
+                            auto: true,
+                            error: err instanceof Error ? err.message : String(err),
+                        });
+                    }
+                }
+            }
+            publish("agent.deep.run.done", "deep-agent", "user", { text });
+            return { text, messages };
+        },
+    };
+}
+//# sourceMappingURL=deep-agent.js.map

package/dist/deep-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-agent.js","sourceRoot":"","sources":["../src/deep-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,IAAI,sBAAsB,EACzC,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAe/D,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAwB,EACxB,UAA4B,EAAE;IAE9B,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,EAAU,EAAE,OAAiB,EAAE,EAAE;QAC5E,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF,OAAO,CAAC,uBAAuB,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,gBAAgB,GAAG,UAAU,EAAE,aAAa,CAAC;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,gBAAgB,CAAC;IAC9D,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,UAAU,EAAE,eAAe,CAAC;IAC7E,MAAM,SAAS,GAAG,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC;IAChD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC;IAC5F,MAAM,cAAc,GAAG,UAAU,EAAE,MAAM,EAAE,gBAAgB,IAAI,QAAQ,CAAC;IACxE,MAAM,iBAAiB,GAAG,UAAU,EAAE,MAAM,EAAE,oBAAoB,IAAI,IAAI,CAAC;IAC3E,MAAM,aAAa,GAAG,UAAU,EAAE,MAAM,EAAE,eAAe,IAAI,IAAI,CAAC;IAClE,MAAM,kBAAkB,GAAG,UAAU,EAAE,MAAM,EAAE,oBAAoB,IAAI,IAAI,CAAC;IAG5E,MAAM,KAAK,GAAG,sBAAsB,CAAC;QACnC,KAAK,EAAE,GAAG,CAAC,GAAG;QACd,KAAK,EAAE,GAAG,CAAC,KAAkD;QAC7D,OAAO,EAAE,CAAC,MAAqB,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC;QAC5D,YAAY;KACJ,CAIT,CAAC;IACF,MAAM,mBAAmB,GAA2D,EAAE,CAAC;IACvF,MAAM,kBAAkB,GAAG,EAAE,CAAC;IAE9B,OAAO,CAAC,sBAAsB,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IAErD,OAAO;QACL,KAAK;QACL,KAAK,CAAC,GAAG,CAAC,WAAmB;YAC3B,OAAO,CAAC,sBAAsB,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;YACvE,MAAM,QAAQ,GAAG,OAAO,cAAc,KAAK,QAAQ;gBACjD,CAAC,CAAC,CAAE,KAAmH;qBACpH,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,IAAI,KAAK,CAAC;gBAC7C,CAAC,CAAC,KAAK,CAAC;YACV,MAAM,MAAM,GAAY,MAAM,QAAQ,CAAC,MAAM,CAAC;gBAC5C,QAAQ,EAAE,CAAC,GAAG,mBAAmB,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;aACpF,CAAC,CAAC;YACH,MAAM,QAAQ,GAAI,MAAoD,EAAE,QAAQ,IAAI,MAAM,CAAC;YAC3F,MAAM,IAAI,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;YAC5C,mBAAmB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACjE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,mBAAmB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,mBAAmB,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;gBACpD,mBAAmB,CAAC,MAAM,CAAC,CAAC,EAAE,mBAAmB,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAC;YACjF,CAAC;YACD,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC;gBACpE,MAAM,UAAU,GAAa,EAAE,CAAC;gBAChC,IAAI,aAAa,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnD,UAAU,CAAC,IAAI,CAAC,WAAW,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACnD,CAAC;gBACD,IAAI,kBAAkB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACjD,UAAU,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACjD,CAAC;gBACD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC;gBACjF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,IAAI,CAAC;wBACH,OAAO,CAAC,+BAA+B,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;wBAC9F,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;wBACrD,OAAO,CAAC,8BAA8B,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC/F,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,OAAO,CAAC,+BAA+B,EAAE,QAAQ,EAAE,YAAY,EAAE;4BAC/D,IAAI,EAAE,IAAI;4BACV,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACxD,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,CAAC,qBAAqB,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createContextBuilders, createAppContext, type AppContextBuilders, type BaseAppConfig, type BotContext, type BotTool, type CreateContextOptions, type ConfigApi, } from "./context.js";
+export { createReactAgent, printReactSteps, type ReactAgentOptions, type ReactAgentRuntime, } from "./react-agent.js";
+export { createDeepAgent, type DeepAgentOptions, type DeepAgentRuntime, } from "./deep-agent.js";
+export { createConfigApi, loadAppConfig, getModelsConfigPath, getMemoryConfigPath, getToolConfigPath, type AppConfig, type AppConfigDefaults, type AgentProfileConfig, } from "./config.js";
+export { runAppCli, createStructuredRunEventListener, type AppCliOptions, type AppCliUiOptions, } from "./cli.js";
+export { malformedToolCallMiddleware, type MalformedToolCallMiddlewareConfig, } from "./malformed-tool-call-middleware.js";
+export { createSubAgentRunner, type SubAgentRunner, type SubAgentOptions, type SubAgentResult, } from "./sub-agent.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,oBAAoB,EACzB,KAAK,SAAS,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,gCAAgC,EAChC,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,2BAA2B,EAC3B,KAAK,iCAAiC,GACvC,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { createContextBuilders, createAppContext, } from "./context.js";
+export { createReactAgent, printReactSteps, } from "./react-agent.js";
+export { createDeepAgent, } from "./deep-agent.js";
+export { createConfigApi, loadAppConfig, getModelsConfigPath, getMemoryConfigPath, getToolConfigPath, } from "./config.js";
+export { runAppCli, createStructuredRunEventListener, } from "./cli.js";
+export { malformedToolCallMiddleware, } from "./malformed-tool-call-middleware.js";
+export { createSubAgentRunner, } from "./sub-agent.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GAOjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAChB,eAAe,GAGhB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,GAGhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAIlB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,gCAAgC,GAGjC,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,2BAA2B,GAE5B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,oBAAoB,GAIrB,MAAM,gBAAgB,CAAC"}

package/dist/malformed-tool-call-middleware.d.ts

@@ -0,0 +1,8 @@
+export interface MalformedToolCallMiddlewareConfig {
+    /** Maximum retry attempts after JSON extraction fails. Default: 1 */
+    maxRetries?: number;
+    /** Log recovery attempts to stderr. Default: true */
+    verbose?: boolean;
+}
+export declare function malformedToolCallMiddleware(config?: MalformedToolCallMiddlewareConfig): import("langchain").AgentMiddleware<undefined, undefined, unknown, readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool)[]>;
+//# sourceMappingURL=malformed-tool-call-middleware.d.ts.map

package/dist/malformed-tool-call-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"malformed-tool-call-middleware.d.ts","sourceRoot":"","sources":["../src/malformed-tool-call-middleware.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,iCAAiC;IAChD,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA4HD,wBAAgB,2BAA2B,CACzC,MAAM,CAAC,EAAE,iCAAiC,4KAiG3C"}