wunderland 0.54.0 → 0.55.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Manic Agency LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -26,7 +26,7 @@
   <a href="https://rabbithole.inc">Rabbit Hole</a> &middot;
   <a href="https://github.com/jddunn/wunderland">GitHub</a> &middot;
   <a href="https://discord.gg/KxF9b6HY6h">Discord</a> &middot;
-  <a href="https://t.me/rabbitholewld">Telegram</a>
+  <a href="https://t.me/rabbitholewun">Telegram</a>
 </p>
 
 ---
@@ -76,6 +76,7 @@
 - **Folder-level permissions** -- Fine-grained access control per folder with glob pattern support
 - **Tool registry** -- Loads curated AgentOS tools via `@framers/agentos-extensions-registry`
 - **Memory hooks** -- Optional `memory_read` tool with pluggable storage (SQL, vector, graph)
+- **Cognitive mechanisms** -- 8 optional neuroscience-grounded memory mechanisms (reconsolidation, RIF, involuntary recall, FOK, temporal gist, schema encoding, source confidence decay, emotion regulation) with HEXACO personality modulation. Enabled via `memory.cognitiveMechanisms` in agent config.
 - **Immutability** -- Seal agent configuration after setup; rotate operational secrets without changing the sealed spec
 - **Streamlined library API** -- `createWunderland()` + sessions from the root import, plus `app.runGraph(...)` / `app.streamGraph(...)` for orchestrated execution
 - **RAG memory** -- Multimodal retrieval-augmented generation with vector, graph, and hybrid search
@@ -662,8 +663,8 @@ The platform treasury reinvests at least **30%** of its funds back into platform
 | Rabbit Hole | [rabbithole.inc](https://rabbithole.inc) |
 | GitHub | [jddunn/wunderland](https://github.com/jddunn/wunderland) |
 | Discord | [discord.gg/KxF9b6HY6h](https://discord.gg/KxF9b6HY6h) |
-| Telegram | [@rabbitholewld](https://t.me/rabbitholewld) |
-| X/Twitter | [@rabbitholewld](https://x.com/rabbitholewld) |
+| Telegram | [@rabbitholewun](https://t.me/rabbitholewun) |
+| X/Twitter | [@rabbitholewun](https://x.com/rabbitholewun) |
 
 ---
 

package/dist/advanced/index.d.ts

@@ -27,7 +27,8 @@ export * from '../workflows/index.js';
 export * from '../voice/call-client.js';
 export * from '../structured/index.js';
 export * from '../knowledge/index.js';
-export * from '../planning/index.js';
+export { PlanningEngine } from '../planning/index.js';
+export type { IPlanningEngine, ExecutionPlan, PlanStep, PlanStepResult, PlanStepStatus, PlanAction, PlanActionType, PlanningOptions, PlanningContext, PlanningStrategy, TaskDecomposition, SubTask, ExecutionFeedback, AutonomousLoopOptions, LoopProgress, PlanValidationResult, ExecutionState, ExecutionSummary, PlanMetadata, } from '../planning/index.js';
 export * from '../evaluation/index.js';
 export * from '../provenance/index.js';
 export * from '../marketplace/index.js';

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

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

package/dist/advanced/index.js

@@ -42,7 +42,7 @@ export * from '../structured/index.js';
 // Knowledge graph exports
 export * from '../knowledge/index.js';
 // Planning engine exports
-export * from '../planning/index.js';
+export { PlanningEngine } from '../planning/index.js';
 // Evaluation exports
 export * from '../evaluation/index.js';
 // Provenance & audit trail exports

package/dist/advanced/index.js.map

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

package/dist/api/chat-runtime.d.ts

@@ -9,8 +9,12 @@
  *
  * It intentionally does NOT start an HTTP server. Use `wunderland start` when you
  * want the full server + HITL UI + channel runtime.
+ *
+ * Internally delegates to {@link AgentBootstrap.create} for the 14-step
+ * initialization sequence, then wraps the bootstrapped agent in the
+ * session-based {@link WunderlandChatRuntime} API.
  */
-import { type NormalizedRuntimePolicy } from '../runtime/policy.js';
+import type { NormalizedRuntimePolicy } from '../runtime/policy.js';
 import { type ToolInstance } from '../runtime/tool-calling.js';
 import type { WunderlandAgentConfig, WunderlandLLMConfig, WunderlandWorkspace } from './types.js';
 import { AgentMemory } from '@framers/agentos';
@@ -33,6 +37,13 @@ export type WunderlandChatRuntime = {
         onToolCall?: (tool: ToolInstance, args: Record<string, unknown>) => void;
     }) => Promise<string>;
 };
+/**
+ * Create a high-level in-process chat runtime.
+ *
+ * Delegates the 14-step agent initialization to {@link AgentBootstrap.create},
+ * then wraps the result in a session-based API with `getMessages()` and
+ * `runTurn()`.
+ */
 export declare function createWunderlandChatRuntime(opts: {
     agentConfig?: WunderlandAgentConfig;
     llm: WunderlandLLMConfig;

package/dist/api/chat-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-runtime.d.ts","sourceRoot":"","sources":["../../src/api/chat-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAyBnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAIvE,KAAK,UAAU,GAAG;IAChB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,mEAAmE;IACnE,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,+DAA+D;IAC/D,OAAO,EAAE,CACP,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAC1E,KACE,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB,CAAC;AAkWF,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,GAAG,uBAAuB,CAAC;IAC/C;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxF,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAmOjC"}
+{"version":3,"file":"chat-runtime.d.ts","sourceRoot":"","sources":["../../src/api/chat-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAEnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAIvE,KAAK,UAAU,GAAG;IAChB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,mEAAmE;IACnE,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,+DAA+D;IAC/D,OAAO,EAAE,CACP,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAC1E,KACE,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB,CAAC;AAyBF;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,GAAG,uBAAuB,CAAC;IAC/C;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxF,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyFjC"}

package/dist/api/chat-runtime.js

@@ -9,28 +9,20 @@
  *
  * It intentionally does NOT start an HTTP server. Use `wunderland start` when you
  * want the full server + HITL UI + channel runtime.
+ *
+ * Internally delegates to {@link AgentBootstrap.create} for the 14-step
+ * initialization sequence, then wraps the bootstrapped agent in the
+ * session-based {@link WunderlandChatRuntime} API.
  */
-import { filterToolMapByPolicy, getPermissionsForSet, normalizeRuntimePolicy, } from '../runtime/policy.js';
-import { resolveDefaultSkillsDirs } from '../skills/index.js';
-import { createEnvSecretResolver } from '../cli/security/env-secrets.js';
-import { createSchemaOnDemandTools } from '../cli/openai/schema-on-demand.js';
 import { runToolCallingTurn } from '../runtime/tool-calling.js';
-import { resolveStrictToolNames } from '../runtime/tool-function-names.js';
-import { resolveAgentWorkspaceBaseDir, sanitizeAgentWorkspaceId } from '../runtime/workspace.js';
-import { resolveAgentDisplayName } from '../runtime/agent-identity.js';
-import { buildAgenticSystemPrompt } from '../runtime/system-prompt-builder.js';
 import { buildOllamaRuntimeOptions } from '../runtime/ollama-options.js';
-import { createWunderlandSeed, DEFAULT_INFERENCE_HIERARCHY, DEFAULT_SECURITY_PROFILE, DEFAULT_STEP_UP_AUTH_CONFIG, } from '../core/index.js';
-import { resolveSkillContext } from '../core/resolve-skill-context.js';
-import { buildDiscoveryOptionsFromAgentConfig, resolveEffectiveAgentConfig, } from '../config/effective-agent-config.js';
-import { resolveExtensionsByNames } from '../core/PresetExtensionResolver.js';
-import { WunderlandDiscoveryManager } from '../discovery/index.js';
-import { createConfiguredRagTools } from '../rag/runtime-tools.js';
-import { mergeExtensionOverrides } from '../cli/extensions/settings.js';
-import { createSpeechExtensionEnvOverrides, getDefaultVoiceExtensions, } from '../voice/speech-catalog.js';
 import { AgentMemory } from '@framers/agentos';
-import { createMemorySystem } from '../memory/index.js';
 import { injectMemoryContext } from '../memory/index.js';
+import { AgentBootstrap } from '../bootstrap/index.js';
+/**
+ * Resolve an {@link AgentMemory} or {@link ICognitiveMemoryManager} input
+ * into a canonical {@link AgentMemory} instance (or undefined).
+ */
 function resolveAgentMemory(input) {
     if (!input)
         return undefined;
@@ -44,417 +36,32 @@ function resolveAgentMemory(input) {
     }
     return AgentMemory.wrap(input);
 }
-function consoleLogger() {
-    return {
-        debug: (msg, meta) => console.debug(msg, meta ?? ''),
-        info: (msg, meta) => console.log(msg, meta ?? ''),
-        warn: (msg, meta) => console.warn(msg, meta ?? ''),
-        error: (msg, meta) => console.error(msg, meta ?? ''),
-    };
-}
-function toToolInstance(tool) {
-    return {
-        name: tool.name,
-        description: tool.description,
-        inputSchema: tool.inputSchema,
-        hasSideEffects: tool.hasSideEffects === true,
-        category: typeof tool.category === 'string' && tool.category.trim() ? tool.category : 'productivity',
-        requiredCapabilities: tool.requiredCapabilities,
-        execute: tool.execute,
-    };
-}
-function inferTurnApprovalMode(cfg) {
-    const raw = cfg?.hitl && typeof cfg.hitl === 'object' && !Array.isArray(cfg.hitl)
-        ? cfg.hitl.turnApprovalMode ?? cfg.hitl.turnApproval
-        : undefined;
-    const v = typeof raw === 'string' ? raw.trim().toLowerCase() : '';
-    if (v === 'after-each-turn')
-        return 'after-each-turn';
-    if (v === 'after-each-round')
-        return 'after-each-round';
-    return 'off';
-}
-function finiteNumber(value, fallback) {
-    return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
-}
-function buildSeedFromAgentConfig(cfg, workspaceSeedId) {
-    const seedId = typeof cfg.seedId === 'string' && cfg.seedId.trim() ? cfg.seedId.trim() : workspaceSeedId;
-    const displayName = resolveAgentDisplayName({
-        displayName: cfg.displayName,
-        agentName: cfg.agentName,
-        seedId,
-        fallback: seedId,
-    });
-    const bio = typeof cfg.bio === 'string' && cfg.bio.trim() ? cfg.bio.trim() : 'Autonomous Wunderbot';
-    const p = cfg.personality || {};
-    return createWunderlandSeed({
-        seedId,
-        name: displayName,
-        description: bio,
-        hexacoTraits: {
-            honesty_humility: finiteNumber(p.honesty, 0.8),
-            emotionality: finiteNumber(p.emotionality, 0.5),
-            extraversion: finiteNumber(p.extraversion, 0.6),
-            agreeableness: finiteNumber(p.agreeableness, 0.7),
-            conscientiousness: finiteNumber(p.conscientiousness, 0.8),
-            openness: finiteNumber(p.openness, 0.7),
-        },
-        baseSystemPrompt: typeof cfg.systemPrompt === 'string' ? cfg.systemPrompt : undefined,
-        securityProfile: DEFAULT_SECURITY_PROFILE,
-        inferenceHierarchy: DEFAULT_INFERENCE_HIERARCHY,
-        stepUpAuthConfig: DEFAULT_STEP_UP_AUTH_CONFIG,
-    });
-}
-async function loadToolMapFromAgentConfig(opts) {
-    const { agentConfig: cfg, policy, workspace, workingDirectory, dangerouslySkipCommandSafety, logger } = opts;
-    const permissions = getPermissionsForSet(policy.permissionSet);
-    const lazyTools = cfg?.lazyTools === true;
-    const toolMap = new Map();
-    const preloadedPackages = [];
-    let schemaOnDemandSecrets;
-    let schemaOnDemandGetSecret;
-    let schemaOnDemandOptions;
-    if (!lazyTools) {
-        const extensionsFromConfig = cfg.extensions;
-        let toolExtensions = [];
-        let voiceExtensions = [];
-        let productivityExtensions = [];
-        if (extensionsFromConfig) {
-            toolExtensions = extensionsFromConfig.tools || [];
-            voiceExtensions = extensionsFromConfig.voice || [];
-            productivityExtensions = extensionsFromConfig.productivity || [];
-        }
-        else {
-            toolExtensions = ['cli-executor', 'web-search', 'web-browser', 'giphy', 'image-search', 'news-search'];
-            voiceExtensions = getDefaultVoiceExtensions();
-            productivityExtensions = [];
-        }
-        // Auto-include GitHub extension when a PAT is available
-        if (!toolExtensions.includes('github')) {
-            const ghToken = (process.env['GITHUB_TOKEN'] || process.env['GH_TOKEN'] || '').trim();
-            if (ghToken)
-                toolExtensions.push('github');
-        }
-        // Auto-include Telegram extension when a bot token is available
-        if (!toolExtensions.includes('telegram') && process.env['TELEGRAM_BOT_TOKEN']) {
-            const tgToken = process.env['TELEGRAM_BOT_TOKEN'].trim();
-            if (/^\d+:[A-Za-z0-9_-]{35,}$/.test(tgToken))
-                toolExtensions.push('telegram');
-        }
-        try {
-            const configOverrides = cfg?.extensionOverrides && typeof cfg.extensionOverrides === 'object' && !Array.isArray(cfg.extensionOverrides)
-                ? cfg.extensionOverrides
-                : {};
-            // Build filesystem roots: agent workspace + user's home directory + cwd.
-            const homeDir = (await import('node:os')).homedir();
-            const agentWorkspaceId = sanitizeAgentWorkspaceId(workspace.agentId);
-            const workspaceDir = (await import('node:path')).resolve(workspace.baseDir, agentWorkspaceId);
-            const cwd = process.cwd();
-            const readRoots = [workspaceDir, homeDir, cwd, '/tmp'];
-            const writeRoots = [workspaceDir, homeDir, cwd, '/tmp'];
-            const runtimeOverrides = {
-                'cli-executor': {
-                    options: {
-                        workingDirectory: cwd,
-                        filesystem: {
-                            allowRead: permissions.filesystem.read,
-                            allowWrite: permissions.filesystem.write,
-                            readRoots: permissions.filesystem.read ? readRoots : undefined,
-                            writeRoots: permissions.filesystem.write ? writeRoots : undefined,
-                        },
-                        agentWorkspace: {
-                            agentId: agentWorkspaceId,
-                            baseDir: workspace.baseDir,
-                            createIfMissing: true,
-                            subdirs: ['assets', 'exports', 'tmp'],
-                        },
-                        dangerouslySkipSecurityChecks: dangerouslySkipCommandSafety,
-                    },
-                },
-                'web-search': {
-                    options: {
-                        serperApiKey: process.env['SERPER_API_KEY'],
-                        serpApiKey: process.env['SERPAPI_API_KEY'],
-                        braveApiKey: process.env['BRAVE_API_KEY'],
-                    },
-                },
-                'web-browser': {
-                    options: {
-                        headless: true,
-                        executablePath: process.env['PUPPETEER_EXECUTABLE_PATH'] ||
-                            process.env['CHROME_EXECUTABLE_PATH'] ||
-                            process.env['CHROME_PATH'],
-                    },
-                },
-                giphy: { options: { giphyApiKey: process.env['GIPHY_API_KEY'] } },
-                'image-search': {
-                    options: {
-                        pexelsApiKey: process.env['PEXELS_API_KEY'],
-                        unsplashApiKey: process.env['UNSPLASH_ACCESS_KEY'],
-                        pixabayApiKey: process.env['PIXABAY_API_KEY'],
-                    },
-                },
-                ...createSpeechExtensionEnvOverrides(),
-                'news-search': { options: { newsApiKey: process.env['NEWSAPI_API_KEY'] } },
-                // Telegram: send-only mode in server context to avoid 409 Conflict polling errors
-                'telegram': { options: { sendOnly: true } },
-                'channel-telegram': { options: { sendOnly: true } },
-            };
-            function mergeOverride(base, extra) {
-                const out = { ...(base || {}), ...(extra || {}) };
-                if ((base && base.options) || (extra && extra.options)) {
-                    out.options = { ...(base?.options || {}), ...(extra?.options || {}) };
-                }
-                return out;
-            }
-            const mergedOverrides = mergeExtensionOverrides(configOverrides, {});
-            for (const [name, override] of Object.entries(runtimeOverrides)) {
-                mergedOverrides[name] = mergeOverride(mergedOverrides[name], override);
-            }
-            const cfgSecrets = cfg?.secrets && typeof cfg.secrets === 'object' && !Array.isArray(cfg.secrets)
-                ? cfg.secrets
-                : undefined;
-            const getSecret = createEnvSecretResolver({ configSecrets: cfgSecrets });
-            const secrets = new Proxy({}, {
-                get: (_target, prop) => (typeof prop === 'string' ? getSecret(prop) : undefined),
-            });
-            schemaOnDemandSecrets = cfgSecrets;
-            schemaOnDemandGetSecret = getSecret;
-            schemaOnDemandOptions = Object.fromEntries(Object.entries(mergedOverrides).map(([name, value]) => [
-                name,
-                value && typeof value === 'object' && !Array.isArray(value)
-                    ? value
-                    : {},
-            ]));
-            const channelsFromConfig = Array.isArray(cfg?.channels)
-                ? cfg.channels
-                : Array.isArray(cfg?.suggestedChannels)
-                    ? cfg.suggestedChannels
-                    : [];
-            const channelsToLoad = Array.from(new Set(channelsFromConfig.map((v) => String(v ?? '').trim()).filter((v) => v.length > 0)));
-            const CLI_REQUIRED_CHANNELS = new Set(['signal', 'zalouser']);
-            const allowedChannels = permissions.network.externalApis === true
-                ? channelsToLoad.filter((platform) => !CLI_REQUIRED_CHANNELS.has(platform) || permissions.system.cliExecution === true)
-                : [];
-            const resolved = await resolveExtensionsByNames(toolExtensions, voiceExtensions, productivityExtensions, mergedOverrides, { secrets: secrets, channels: allowedChannels.length > 0 ? allowedChannels : 'none' });
-            const packs = [];
-            for (const packEntry of resolved.manifest.packs) {
-                try {
-                    if (packEntry?.enabled === false)
-                        continue;
-                    if (typeof packEntry?.factory === 'function') {
-                        const pack = await packEntry.factory();
-                        if (pack) {
-                            packs.push(pack);
-                            if (typeof pack?.name === 'string')
-                                preloadedPackages.push(pack.name);
-                        }
-                        continue;
-                    }
-                    let packageName;
-                    if ('package' in packEntry)
-                        packageName = packEntry.package;
-                    else if ('module' in packEntry)
-                        packageName = packEntry.module;
-                    if (!packageName)
-                        continue;
-                    const extModule = await import(packageName);
-                    const factory = extModule.createExtensionPack ?? extModule.default?.createExtensionPack ?? extModule.default;
-                    if (typeof factory !== 'function')
-                        continue;
-                    const options = packEntry.options || {};
-                    const pack = await factory({ options, logger: console, getSecret });
-                    packs.push(pack);
-                    if (typeof pack?.name === 'string')
-                        preloadedPackages.push(pack.name);
-                }
-                catch (err) {
-                    logger.warn?.('[wunderland/api] Failed to load extension pack', {
-                        error: err instanceof Error ? err.message : String(err),
-                    });
-                }
-            }
-            await Promise.all(packs
-                .map((p) => typeof p?.onActivate === 'function' ? p.onActivate({ logger: console, getSecret }) : null)
-                .filter(Boolean));
-            const tools = packs
-                .flatMap((p) => (p?.descriptors || []).filter((d) => d?.kind === 'tool').map((d) => d.payload))
-                .filter(Boolean);
-            for (const tool of tools) {
-                if (!tool?.name)
-                    continue;
-                toolMap.set(tool.name, tool);
-            }
-        }
-        catch (err) {
-            logger.warn?.('[wunderland/api] Extension loading failed (continuing with meta tools only)', {
-                error: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-    // Schema-on-demand meta tools are always present (even in lazy-tools mode).
-    for (const metaTool of createSchemaOnDemandTools({
-        toolMap,
-        runtimeDefaults: {
-            workingDirectory,
-            headlessBrowser: true,
-            dangerouslySkipCommandSafety,
-            agentWorkspace: { agentId: sanitizeAgentWorkspaceId(workspace.agentId), baseDir: workspace.baseDir },
-        },
-        initialEnabledPackages: preloadedPackages,
-        secrets: schemaOnDemandSecrets,
-        getSecret: schemaOnDemandGetSecret,
-        defaultExtensionOptions: schemaOnDemandOptions,
-        allowPackages: true,
-        logger: console,
-        onToolsChanged: opts.onSchemaToolsChanged,
-    })) {
-        toolMap.set(metaTool.name, metaTool);
-    }
-    for (const ragTool of createConfiguredRagTools(cfg)) {
-        if (!ragTool?.name)
-            continue;
-        toolMap.set(ragTool.name, toToolInstance(ragTool));
-    }
-    // Enforce policy (tool access profile + permission set).
-    const filtered = filterToolMapByPolicy({ toolMap, toolAccessProfile: policy.toolAccessProfile, permissions });
-    return { toolMap: filtered.toolMap, preloadedPackages };
-}
+/**
+ * Create a high-level in-process chat runtime.
+ *
+ * Delegates the 14-step agent initialization to {@link AgentBootstrap.create},
+ * then wraps the result in a session-based API with `getMessages()` and
+ * `runTurn()`.
+ */
 export async function createWunderlandChatRuntime(opts) {
     const memory = resolveAgentMemory(opts.memory);
-    const baseLogger = consoleLogger();
-    const logger = {
-        debug: opts.logger?.debug ?? baseLogger.debug,
-        info: opts.logger?.info ?? baseLogger.info,
-        warn: opts.logger?.warn ?? baseLogger.warn,
-        error: opts.logger?.error ?? baseLogger.error,
-    };
     const workingDirectory = opts.workingDirectory ?? process.cwd();
-    const { agentConfig } = await resolveEffectiveAgentConfig({
+    // ── Delegate bootstrap to shared AgentBootstrap ───────────────────────
+    const agent = await AgentBootstrap.create({
         agentConfig: opts.agentConfig ?? {},
+        providerId: opts.llm.providerId,
+        apiKey: opts.llm.apiKey,
+        baseUrl: opts.llm.baseUrl,
+        mode: 'library',
+        autoApproveToolCalls: opts.autoApproveToolCalls,
+        workspaceId: opts.workspace?.agentId,
+        workspaceBaseDir: opts.workspace?.baseDir,
         workingDirectory,
-        logger,
-    });
-    const policy = normalizeRuntimePolicy(agentConfig);
-    const turnApprovalMode = inferTurnApprovalMode(agentConfig);
-    const strictToolNames = resolveStrictToolNames(agentConfig?.toolCalling?.strictToolNames);
-    const seedIdForWorkspace = typeof agentConfig.seedId === 'string' && agentConfig.seedId.trim()
-        ? agentConfig.seedId.trim()
-        : `seed_${Date.now()}`;
-    const workspace = {
-        agentId: sanitizeAgentWorkspaceId(opts.workspace?.agentId ?? seedIdForWorkspace),
-        baseDir: opts.workspace?.baseDir ?? resolveAgentWorkspaceBaseDir(),
-    };
-    const seed = buildSeedFromAgentConfig(agentConfig, seedIdForWorkspace);
-    const activePersonaId = typeof agentConfig.selectedPersonaId === 'string' && agentConfig.selectedPersonaId.trim()
-        ? agentConfig.selectedPersonaId.trim()
-        : seed.seedId;
-    const dangerouslySkipCommandSafety = false;
-    // ── Content Security Pipeline (optional) ──────────────────────────────────
-    // Initializes the WunderlandSecurityPipeline singleton for content-level
-    // guardrails. Fail-safe: if creation fails, the runtime continues without them.
-    try {
-        const { initializeSecurityPipeline } = await import('../runtime/tool-helpers.js');
-        await initializeSecurityPipeline({
-            securityTier: policy.securityTier,
-            guardrailPackOverrides: policy.guardrailPackOverrides,
-            disableGuardrailPacks: policy.disableGuardrailPacks,
-            enableOnlyPacks: policy.enableOnlyGuardrailPacks,
-            seedId: seedIdForWorkspace,
-        });
-    }
-    catch {
-        // Non-fatal — content guardrails not available.
-        logger.warn?.('[wunderland/api] Security pipeline initialization failed (continuing without content guardrails)');
-    }
-    let discoveryManager = null;
-    let liveToolMap = null;
-    const { toolMap } = await loadToolMapFromAgentConfig({
-        agentConfig,
-        policy,
-        workspace,
-        workingDirectory,
-        dangerouslySkipCommandSafety,
-        logger,
-        onSchemaToolsChanged: () => {
-            if (!discoveryManager || !liveToolMap)
-                return;
-            discoveryManager.reindex?.({ toolMap: liveToolMap }).catch(() => { });
-        },
+        logger: opts.logger,
     });
-    liveToolMap = toolMap;
-    // ── Memory Retrieval System ───────────────────────────────────────────
-    let memorySystem = null;
-    if (agentConfig.memory?.enabled !== false) {
-        try {
-            const { AgentStorageManager, resolveAgentStorageConfig } = await import('../storage/index.js');
-            const storageConfig = resolveAgentStorageConfig(seedIdForWorkspace, agentConfig.storage);
-            const storageMgr = new AgentStorageManager(storageConfig);
-            await storageMgr.initialize();
-            memorySystem = await createMemorySystem({
-                vectorStore: storageMgr.getVectorStore(),
-                traits: (agentConfig.personality ?? {}),
-                llm: { providerId: opts.llm.providerId, apiKey: opts.llm.apiKey, baseUrl: opts.llm.baseUrl },
-                ollama: agentConfig.ollama,
-                retrievalBudgetTokens: agentConfig.memory?.retrievalBudgetTokens ?? 4000,
-                agentId: seedIdForWorkspace,
-            });
-        }
-        catch (err) {
-            logger.warn?.('[wunderland/api] Memory system init failed (continuing without retrieval)', {
-                error: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-    let skillsPrompt = '';
-    const resolvedSkills = await resolveSkillContext({
-        filesystemDirs: resolveDefaultSkillsDirs({ cwd: workingDirectory }),
-        curatedSkills: Array.isArray(agentConfig.skills) && agentConfig.skills.length > 0
-            ? agentConfig.skills
-            : undefined,
-        platform: process.platform,
-        logger,
-        warningPrefix: '[wunderland/api]',
-    });
-    skillsPrompt = resolvedSkills.skillsPrompt;
-    const skillEntries = resolvedSkills.skillEntries;
-    discoveryManager = new WunderlandDiscoveryManager(buildDiscoveryOptionsFromAgentConfig(agentConfig));
-    try {
-        await discoveryManager.initialize({
-            toolMap,
-            skillEntries: skillEntries.length > 0 ? skillEntries : undefined,
-            llmConfig: { providerId: opts.llm.providerId, apiKey: opts.llm.apiKey, baseUrl: opts.llm.baseUrl },
-        });
-        const metaTool = discoveryManager.getMetaTool();
-        if (metaTool) {
-            toolMap.set(metaTool.name, toToolInstance(metaTool));
-        }
-    }
-    catch (error) {
-        logger.warn?.('[wunderland/api] Discovery initialization failed (continuing without)', {
-            error: error instanceof Error ? error.message : String(error),
-        });
-    }
+    const { policy, toolMap, toolContext, systemPrompt, agentConfig, strictToolNames } = agent;
     const sessions = new Map();
     const autoApprove = opts.autoApproveToolCalls === true || policy.executionMode === 'autonomous';
-    // Detect authenticated integrations
-    const authenticatedIntegrations = [];
-    if (toolMap.has('github_search') || toolMap.has('github_issue_list') || process.env['GITHUB_TOKEN'] || process.env['GH_TOKEN']) {
-        authenticatedIntegrations.push('github');
-    }
-    if (toolMap.has('telegram_send_message') || process.env['TELEGRAM_BOT_TOKEN']) {
-        authenticatedIntegrations.push('telegram');
-    }
-    const systemPrompt = buildAgenticSystemPrompt({
-        seed,
-        policy,
-        mode: 'library',
-        lazyTools: agentConfig.lazyTools === true,
-        autoApproveToolCalls: autoApprove,
-        skillsPrompt: skillsPrompt || undefined,
-        turnApprovalMode,
-        authenticatedIntegrations: authenticatedIntegrations.length > 0 ? authenticatedIntegrations : undefined,
-    });
     if (!autoApprove && typeof opts.askPermission !== 'function') {
         throw new Error('createWunderlandChatRuntime: askPermission is required unless autoApproveToolCalls=true or executionMode="autonomous".');
     }
@@ -463,20 +70,6 @@ export async function createWunderlandChatRuntime(opts) {
             return true;
         return opts.askPermission(tool, args);
     };
-    const toolContext = {
-        agentId: workspace.agentId,
-        personaId: activePersonaId,
-        securityTier: policy.securityTier,
-        permissionSet: policy.permissionSet,
-        toolAccessProfile: policy.toolAccessProfile,
-        executionMode: policy.executionMode,
-        wrapToolOutputs: policy.wrapToolOutputs,
-        strictToolNames,
-        ...(policy.folderPermissions ? { folderPermissions: policy.folderPermissions } : null),
-        turnApprovalMode,
-        agentWorkspace: { agentId: workspace.agentId, baseDir: workspace.baseDir },
-        workingDirectory,
-    };
     return {
         policy,
         toolMap,
@@ -498,8 +91,8 @@ export async function createWunderlandChatRuntime(opts) {
                 memory.observe('user', userContent).catch(() => { });
             }
             // Retrieve and inject memory context
-            if (memorySystem) {
-                await injectMemoryContext(history, memorySystem, userContent).catch(() => { });
+            if (agent.memorySystem) {
+                await injectMemoryContext(history, agent.memorySystem, userContent).catch(() => { });
             }
             const reply = await runToolCallingTurn({
                 providerId: opts.llm.providerId,