wunderland 0.31.0 → 0.32.0

package/README.md

@@ -66,6 +66,7 @@
 - **8 agent presets** -- Pre-configured agent archetypes with recommended extensions, skills, and personalities
 - **Preset-to-extension auto-mapping** -- Presets automatically load recommended tools, voice providers, and skills
 - **Capability discovery** -- 3-tier semantic search across tools, skills, extensions, and channels (~90% token reduction vs static loading)
+- **Adaptive execution runtime** -- Rolling task-outcome KPI telemetry with SQL persistence (`@framers/sql-storage-adapter`) and automatic degraded-mode recovery (`discovered -> all`, configurable fail-open)
 - **Schema-on-demand** -- `--lazy-tools` starts with only meta tools, then dynamically loads extension packs as needed
 - **8 built-in tools** -- SocialPostTool, SerperSearchTool, GiphySearchTool, ImageSearchTool, TextToSpeechTool, NewsSearchTool, RAGTool, MemoryReadTool
 - **Operational safety** -- 6-step LLM guard chain with circuit breakers, cost guards, stuck detection, action dedup, content similarity checks, and audit logging
@@ -145,7 +146,8 @@ const app = await createWunderland({
     tools: ['web-search', 'web-browser', 'giphy'],
     voice: ['voice-synthesis'],
   },
-  // discovery is enabled by default — indexes tools + skills for semantic search
+  // discovery is enabled by default with aggressive recall.
+  // per-turn tool schemas are narrowed to discovered capabilities unless degraded.
 });
 
 const session = app.session();
@@ -220,6 +222,27 @@ console.log('Discovery:', diag.discovery);   // { initialized: true, capabilityC
 
 See `docs/LIBRARY_API.md` for the full API reference (approvals, custom tools, diagnostics, advanced modules).
 
+### Discovery recall + dynamic tool exposure
+
+```ts
+const app = await createWunderland({
+  llm: { providerId: 'openai' },
+  tools: 'curated',
+  discovery: {
+    recallProfile: 'aggressive', // default: aggressive | balanced | precision
+  },
+});
+
+const session = app.session();
+await session.sendText('Investigate recent SQL adapter changes', {
+  toolSelectionMode: 'discovered', // default when discovery has results
+  // toolSelectionMode: 'all',     // optional per-turn override
+});
+```
+
+- `toolSelectionMode` automatically falls back to `all` when discovery has no usable tool hits.
+- Adaptive degraded mode can force `all` tool exposure for recovery.
+
 ### CLI
 
 ```bash

package/dist/api/index.d.ts

@@ -4,6 +4,6 @@
  */
 export { createWunderlandChatRuntime, type WunderlandChatRuntime } from './chat-runtime.js';
 export { createWunderlandServer, type WunderlandServerHandle } from './server.js';
-export type { WunderlandAgentConfig, WunderlandExecutionMode, WunderlandLLMConfig, WunderlandProviderId, WunderlandWorkspace, } from './types.js';
+export type { WunderlandAdaptiveExecutionConfig, WunderlandAgentConfig, WunderlandExecutionMode, WunderlandLLMConfig, WunderlandProviderId, WunderlandTaskOutcomeTelemetryConfig, WunderlandTaskOutcomeTelemetryScope, WunderlandToolFailureMode, WunderlandWorkspace, } from './types.js';
 export { RateLimiter, type RateLimiterConfig, type RateLimitResult } from './rate-limiter.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,2BAA2B,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,2BAA2B,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EACV,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,oCAAoC,EACpC,mCAAmC,EACnC,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,2BAA2B,EAA8B,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAA+B,MAAM,aAAa,CAAC;AASlF,OAAO,EAAE,WAAW,EAAgD,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,2BAA2B,EAA8B,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAA+B,MAAM,aAAa,CAAC;AAalF,OAAO,EAAE,WAAW,EAAgD,MAAM,mBAAmB,CAAC"}

package/dist/api/server.d.ts

@@ -14,7 +14,7 @@
 import { type Server } from 'node:http';
 import { type LLMProviderConfig } from '../runtime/tool-calling.js';
 import { type NormalizedRuntimePolicy } from '../runtime/policy.js';
-import type { WunderlandAgentConfig, WunderlandProviderId, WunderlandWorkspace } from './types.js';
+import type { WunderlandAdaptiveExecutionConfig, WunderlandAgentConfig, WunderlandProviderId, WunderlandTaskOutcomeTelemetryConfig, WunderlandToolFailureMode, WunderlandWorkspace } from './types.js';
 type LoggerLike = {
     debug?: (msg: string, meta?: unknown) => void;
     info?: (msg: string, meta?: unknown) => void;
@@ -75,6 +75,12 @@ export declare function createWunderlandServer(opts?: {
         apiKey: string;
         baseUrl?: string;
     }>;
+    /** Override default tool-call failure behavior for this runtime. */
+    toolFailureMode?: WunderlandToolFailureMode;
+    /** Runtime task-outcome telemetry controls. */
+    taskOutcomeTelemetry?: WunderlandTaskOutcomeTelemetryConfig;
+    /** Runtime adaptive execution controls. */
+    adaptiveExecution?: WunderlandAdaptiveExecutionConfig;
     /** Override HITL secret (otherwise config/env/random). */
     hitlSecret?: string;
     /** Optional OpenAI-compatible fallback provider config. */

package/dist/api/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/api/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAgBtD,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnG,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;AA+bF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,oBAAoB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,uBAAuB,CAAC;IAChC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,KAAK,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;IACjE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,IAAI,CAAC,EAAE;IAClD,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzC,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6FAA6F;IAC7F,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0EAA0E;IAC1E,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,oEAAoE;IACpE,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,oGAAoG;IACpG,GAAG,CAAC,EAAE,OAAO,CAAC;QACZ,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAAC;QAC1C,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAkpClC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/api/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAgBtD,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EACV,iCAAiC,EACjC,qBAAqB,EACrB,oBAAoB,EACpB,oCAAoC,EACpC,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,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;AA+bF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,oBAAoB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,uBAAuB,CAAC;IAChC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,KAAK,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;IACjE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,IAAI,CAAC,EAAE;IAClD,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzC,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6FAA6F;IAC7F,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0EAA0E;IAC1E,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,oEAAoE;IACpE,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,oGAAoG;IACpG,GAAG,CAAC,EAAE,OAAO,CAAC;QACZ,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAAC;QAC1C,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,oEAAoE;IACpE,eAAe,CAAC,EAAE,yBAAyB,CAAC;IAC5C,+CAA+C;IAC/C,oBAAoB,CAAC,EAAE,oCAAoC,CAAC;IAC5D,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,iCAAiC,CAAC;IACtD,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAk1ClC"}

package/dist/api/server.js

@@ -24,6 +24,7 @@ import { createWunderlandSeed, DEFAULT_INFERENCE_HIERARCHY, DEFAULT_SECURITY_PRO
 import { loadDotEnvIntoProcessUpward } from '../cli/config/env-manager.js';
 import { resolveAgentWorkspaceBaseDir, sanitizeAgentWorkspaceId } from '../runtime/workspace.js';
 import { runToolCallingTurn, safeJsonStringify, } from '../runtime/tool-calling.js';
+import { WunderlandAdaptiveExecutionRuntime } from '../runtime/adaptive-execution.js';
 import { createSchemaOnDemandTools } from '../cli/openai/schema-on-demand.js';
 import { startWunderlandOtel, shutdownWunderlandOtel } from '../observability/otel.js';
 import { filterToolMapByPolicy, getPermissionsForSet, normalizeRuntimePolicy, } from '../runtime/policy.js';
@@ -578,6 +579,28 @@ export async function createWunderlandServer(opts) {
                 ? !!process.env['ANTHROPIC_API_KEY']
                 : !!llmApiKey || !!openrouterFallback;
     const openaiFallbackEnabled = providerId === 'openai' && !!openrouterFallback;
+    const telemetryConfig = {
+        ...(cfg.taskOutcomeTelemetry ?? {}),
+        ...(opts?.taskOutcomeTelemetry ?? {}),
+        storage: {
+            ...(cfg.taskOutcomeTelemetry?.storage ?? {}),
+            ...(opts?.taskOutcomeTelemetry?.storage ?? {}),
+        },
+    };
+    const adaptiveConfig = {
+        ...(cfg.adaptiveExecution ?? {}),
+        ...(opts?.adaptiveExecution ?? {}),
+    };
+    const adaptiveRuntime = new WunderlandAdaptiveExecutionRuntime({
+        toolFailureMode: opts?.toolFailureMode ?? cfg.toolFailureMode,
+        taskOutcomeTelemetry: telemetryConfig,
+        adaptiveExecution: adaptiveConfig,
+        logger,
+    });
+    await adaptiveRuntime.initialize();
+    const defaultTenantId = typeof cfg?.organizationId === 'string' && String(cfg.organizationId).trim()
+        ? String(cfg.organizationId).trim()
+        : undefined;
     const preloadedPackages = [];
     let activePacks = [];
     let allTools = [];
@@ -592,6 +615,7 @@ export async function createWunderlandServer(opts) {
             const fromEnv = String(process.env['WUNDERLAND_HITL_SECRET'] || '').trim();
             return fromCfg || fromEnv || randomUUID();
         })();
+    const toolApiSecret = String(process.env['WUNDERLAND_TOOL_API_KEY'] || '').trim();
     const sseClients = new Set();
     async function broadcastHitlUpdate(payload) {
         const data = JSON.stringify(payload);
@@ -1025,13 +1049,31 @@ export async function createWunderlandServer(opts) {
         catch {
             // ignore
         }
+        const tenantId = (typeof message?.organizationId === 'string' && String(message.organizationId).trim())
+            || defaultTenantId;
+        const adaptiveDecision = adaptiveRuntime.resolveTurnDecision({
+            scope: {
+                sessionId: sessionKey,
+                userId: senderId,
+                personaId: seed.seedId,
+                tenantId: tenantId || undefined,
+            },
+        });
         let reply = '';
+        let turnFailed = false;
+        let fallbackTriggered = false;
+        let toolCallCount = 0;
         try {
             if (canUseLLM) {
                 const toolContext = {
                     gmiId: `wunderland-channel-${sessionKey}`,
                     personaId: seed.seedId,
-                    userContext: { userId: senderId, platform, conversationId },
+                    userContext: {
+                        userId: senderId,
+                        platform,
+                        conversationId,
+                        ...(tenantId ? { organizationId: tenantId } : null),
+                    },
                     agentWorkspace: { agentId: workspaceAgentId, baseDir: workspaceBaseDir },
                     permissionSet: policy.permissionSet,
                     securityTier: policy.securityTier,
@@ -1039,6 +1081,13 @@ export async function createWunderlandServer(opts) {
                     toolAccessProfile: policy.toolAccessProfile,
                     interactiveSession: false,
                     turnApprovalMode,
+                    toolFailureMode: adaptiveDecision.toolFailureMode,
+                    adaptiveExecution: {
+                        degraded: adaptiveDecision.degraded,
+                        reason: adaptiveDecision.reason,
+                        actions: adaptiveDecision.actions,
+                        kpi: adaptiveDecision.kpi ?? undefined,
+                    },
                     ...(policy.folderPermissions ? { folderPermissions: policy.folderPermissions } : null),
                     wrapToolOutputs: policy.wrapToolOutputs,
                 };
@@ -1051,6 +1100,10 @@ export async function createWunderlandServer(opts) {
                     toolContext,
                     maxRounds: 8,
                     dangerouslySkipPermissions: autoApproveToolCalls,
+                    toolFailureMode: adaptiveDecision.toolFailureMode,
+                    onToolCall: () => {
+                        toolCallCount += 1;
+                    },
                     askPermission: async (tool, args) => {
                         if (autoApproveToolCalls)
                             return true;
@@ -1110,6 +1163,7 @@ export async function createWunderlandServer(opts) {
                     baseUrl: llmBaseUrl,
                     fallback: providerId === 'openai' ? openrouterFallback : undefined,
                     onFallback: (err, provider) => {
+                        fallbackTriggered = true;
                         logger.warn?.('[wunderland/api] fallback activated', { error: err.message, provider });
                     },
                 });
@@ -1119,7 +1173,30 @@ export async function createWunderlandServer(opts) {
                 messages.push({ role: 'assistant', content: reply });
             }
         }
+        catch (error) {
+            turnFailed = true;
+            throw error;
+        }
         finally {
+            try {
+                await adaptiveRuntime.recordTurnOutcome({
+                    scope: {
+                        sessionId: sessionKey,
+                        userId: senderId,
+                        personaId: seed.seedId,
+                        tenantId: tenantId || undefined,
+                    },
+                    degraded: adaptiveDecision.degraded || fallbackTriggered,
+                    replyText: reply,
+                    didFail: turnFailed,
+                    toolCallCount,
+                });
+            }
+            catch (error) {
+                logger.warn?.('[wunderland/api][channels] failed to record adaptive outcome', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
             try {
                 const adapter = adapterByPlatform.get(platform);
                 if (adapter)
@@ -1163,7 +1240,7 @@ export async function createWunderlandServer(opts) {
         try {
             res.setHeader('Access-Control-Allow-Origin', '*');
             res.setHeader('Access-Control-Allow-Methods', 'GET,POST,OPTIONS');
-            res.setHeader('Access-Control-Allow-Headers', 'Content-Type, X-Wunderland-HITL-Secret');
+            res.setHeader('Access-Control-Allow-Headers', 'Content-Type, X-Wunderland-HITL-Secret, X-Api-Key');
             if (req.method === 'OPTIONS') {
                 res.writeHead(204);
                 res.end();
@@ -1347,115 +1424,230 @@ export async function createWunderlandServer(opts) {
                     sendJson(res, 400, { error: 'Missing "message" in JSON body.' });
                     return;
                 }
-                let reply;
-                if (canUseLLM) {
-                    const sessionId = typeof parsed.sessionId === 'string' && parsed.sessionId.trim() ? parsed.sessionId.trim().slice(0, 128) : 'default';
-                    if (parsed.reset === true) {
-                        sessions.delete(sessionId);
+                let reply = '';
+                let turnFailed = false;
+                let fallbackTriggered = false;
+                let toolCallCount = 0;
+                const sessionId = typeof parsed.sessionId === 'string' && parsed.sessionId.trim() ? parsed.sessionId.trim().slice(0, 128) : 'default';
+                const requestedToolFailureMode = typeof parsed.toolFailureMode === 'string' ? parsed.toolFailureMode : undefined;
+                const tenantId = (typeof parsed.tenantId === 'string' && parsed.tenantId.trim())
+                    || defaultTenantId;
+                const adaptiveDecision = adaptiveRuntime.resolveTurnDecision({
+                    scope: {
+                        sessionId,
+                        userId: sessionId,
+                        personaId: seed.seedId,
+                        tenantId: tenantId || undefined,
+                    },
+                    requestedToolFailureMode,
+                });
+                if (parsed.reset === true) {
+                    sessions.delete(sessionId);
+                }
+                let messages = sessions.get(sessionId);
+                if (!messages) {
+                    messages = [{ role: 'system', content: systemPrompt }];
+                    sessions.set(sessionId, messages);
+                }
+                if (messages.length > 200) {
+                    messages = [messages[0], ...messages.slice(-120)];
+                    sessions.set(sessionId, messages);
+                }
+                messages.push({ role: 'user', content: message });
+                try {
+                    if (canUseLLM) {
+                        const toolContext = {
+                            gmiId: `wunderland-server-${sessionId}`,
+                            personaId: seed.seedId,
+                            userContext: {
+                                userId: sessionId,
+                                ...(tenantId ? { organizationId: tenantId } : null),
+                            },
+                            agentWorkspace: { agentId: workspaceAgentId, baseDir: workspaceBaseDir },
+                            permissionSet: policy.permissionSet,
+                            securityTier: policy.securityTier,
+                            executionMode: policy.executionMode,
+                            toolAccessProfile: policy.toolAccessProfile,
+                            interactiveSession: false,
+                            turnApprovalMode,
+                            toolFailureMode: adaptiveDecision.toolFailureMode,
+                            adaptiveExecution: {
+                                degraded: adaptiveDecision.degraded,
+                                reason: adaptiveDecision.reason,
+                                actions: adaptiveDecision.actions,
+                                kpi: adaptiveDecision.kpi ?? undefined,
+                            },
+                            ...(policy.folderPermissions ? { folderPermissions: policy.folderPermissions } : null),
+                            wrapToolOutputs: policy.wrapToolOutputs,
+                        };
+                        reply = await runToolCallingTurn({
+                            providerId,
+                            apiKey: llmApiKey,
+                            model,
+                            messages,
+                            toolMap,
+                            toolContext,
+                            maxRounds: 8,
+                            dangerouslySkipPermissions: autoApproveToolCalls,
+                            toolFailureMode: adaptiveDecision.toolFailureMode,
+                            onToolCall: () => {
+                                toolCallCount += 1;
+                            },
+                            askPermission: async (tool, args) => {
+                                if (autoApproveToolCalls)
+                                    return true;
+                                const preview = safeJsonStringify(args, 1800);
+                                const effectLabel = tool.hasSideEffects === true ? 'side effects' : 'read-only';
+                                const actionId = `tool-${seedId}-${randomUUID()}`;
+                                const decision = await hitlManager.requestApproval({
+                                    actionId,
+                                    description: `Allow ${tool.name} (${effectLabel})?\\n\\n${preview}`,
+                                    severity: tool.hasSideEffects === true ? 'high' : 'low',
+                                    category: toAgentosApprovalCategory(tool),
+                                    agentId: seed.seedId,
+                                    context: { toolName: tool.name, args, sessionId },
+                                    reversible: tool.hasSideEffects !== true,
+                                    requestedAt: new Date(),
+                                    timeoutMs: 5 * 60_000,
+                                });
+                                return decision.approved === true;
+                            },
+                            askCheckpoint: turnApprovalMode === 'off'
+                                ? undefined
+                                : async ({ round, toolCalls }) => {
+                                    if (autoApproveToolCalls)
+                                        return true;
+                                    const checkpointId = `checkpoint-${seedId}-${sessionId}-${round}-${randomUUID()}`;
+                                    const completedWork = toolCalls.map((c) => {
+                                        const effect = c.hasSideEffects ? 'side effects' : 'read-only';
+                                        const preview = safeJsonStringify(c.args, 800);
+                                        return `${c.toolName} (${effect})\\n${preview}`;
+                                    });
+                                    const timeoutMs = 5 * 60_000;
+                                    const checkpointPromise = hitlManager
+                                        .checkpoint({
+                                        checkpointId,
+                                        workflowId: `chat-${sessionId}`,
+                                        currentPhase: `tool-round-${round}`,
+                                        progress: Math.min(1, (round + 1) / 8),
+                                        completedWork,
+                                        upcomingWork: ['Continue to next LLM round'],
+                                        issues: [],
+                                        notes: 'Continue?',
+                                        checkpointAt: new Date(),
+                                    })
+                                        .catch(() => ({ decision: 'abort' }));
+                                    const timeoutPromise = new Promise((resolve) => setTimeout(() => resolve({ decision: 'abort' }), timeoutMs));
+                                    const decision = (await Promise.race([checkpointPromise, timeoutPromise]));
+                                    if (decision?.decision !== 'continue') {
+                                        try {
+                                            await hitlManager.cancelRequest(checkpointId, 'checkpoint_timeout_or_abort');
+                                        }
+                                        catch {
+                                            // ignore
+                                        }
+                                    }
+                                    return decision?.decision === 'continue';
+                                },
+                            baseUrl: llmBaseUrl,
+                            fallback: providerId === 'openai' ? openrouterFallback : undefined,
+                            onFallback: (err, provider) => {
+                                fallbackTriggered = true;
+                                logger.warn?.('[wunderland/api] fallback activated', { error: err.message, provider });
+                            },
+                        });
+                    }
+                    else {
+                        reply =
+                            'No LLM credentials configured. I can run, but I cannot generate real replies yet.\\n\\n' +
+                                'Set an API key in .env (OPENAI_API_KEY / OPENROUTER_API_KEY / ANTHROPIC_API_KEY) or use Ollama, then retry.\\n\\n' +
+                                `You said: ${message}`;
                     }
-                    let messages = sessions.get(sessionId);
-                    if (!messages) {
-                        messages = [{ role: 'system', content: systemPrompt }];
-                        sessions.set(sessionId, messages);
+                }
+                catch (error) {
+                    turnFailed = true;
+                    throw error;
+                }
+                finally {
+                    try {
+                        await adaptiveRuntime.recordTurnOutcome({
+                            scope: {
+                                sessionId,
+                                userId: sessionId,
+                                personaId: seed.seedId,
+                                tenantId: tenantId || undefined,
+                            },
+                            degraded: adaptiveDecision.degraded || fallbackTriggered,
+                            replyText: reply,
+                            didFail: turnFailed,
+                            toolCallCount,
+                        });
                     }
-                    if (messages.length > 200) {
-                        messages = [messages[0], ...messages.slice(-120)];
-                        sessions.set(sessionId, messages);
+                    catch (error) {
+                        logger.warn?.('[wunderland/api][chat] failed to record adaptive outcome', {
+                            error: error instanceof Error ? error.message : String(error),
+                        });
                     }
-                    messages.push({ role: 'user', content: message });
-                    const toolContext = {
-                        gmiId: `wunderland-server-${sessionId}`,
-                        personaId: seed.seedId,
-                        userContext: { userId: sessionId },
-                        agentWorkspace: { agentId: workspaceAgentId, baseDir: workspaceBaseDir },
+                }
+                sendJson(res, 200, { reply });
+                return;
+            }
+            // ── Tool Execution API ──────────────────────────────────────
+            if (url.pathname === '/api/tools' && req.method === 'GET') {
+                if (toolApiSecret && req.headers['x-api-key'] !== toolApiSecret) {
+                    sendJson(res, 401, { error: 'Unauthorized' });
+                    return;
+                }
+                const tools = Array.from(toolMap.values()).map((t) => ({
+                    name: t.name,
+                    description: t.description,
+                    inputSchema: t.inputSchema,
+                    category: t.category,
+                    hasSideEffects: t.hasSideEffects,
+                }));
+                sendJson(res, 200, { tools });
+                return;
+            }
+            if (url.pathname.startsWith('/api/tools/') && req.method === 'POST') {
+                if (toolApiSecret && req.headers['x-api-key'] !== toolApiSecret) {
+                    sendJson(res, 401, { error: 'Unauthorized' });
+                    return;
+                }
+                const toolName = decodeURIComponent(url.pathname.slice('/api/tools/'.length));
+                const tool = toolMap.get(toolName);
+                if (!tool) {
+                    sendJson(res, 404, { error: `Tool '${toolName}' not found` });
+                    return;
+                }
+                let args = {};
+                try {
+                    const body = await readBody(req);
+                    if (body)
+                        args = JSON.parse(body);
+                }
+                catch {
+                    sendJson(res, 400, { error: 'Invalid JSON body' });
+                    return;
+                }
+                try {
+                    const ctx = {
+                        gmiId: 'tool-api',
+                        personaId: seedId,
                         permissionSet: policy.permissionSet,
                         securityTier: policy.securityTier,
-                        executionMode: policy.executionMode,
+                        executionMode: 'autonomous',
                         toolAccessProfile: policy.toolAccessProfile,
                         interactiveSession: false,
-                        turnApprovalMode,
-                        ...(policy.folderPermissions ? { folderPermissions: policy.folderPermissions } : null),
-                        wrapToolOutputs: policy.wrapToolOutputs,
                     };
-                    reply = await runToolCallingTurn({
-                        providerId,
-                        apiKey: llmApiKey,
-                        model,
-                        messages,
-                        toolMap,
-                        toolContext,
-                        maxRounds: 8,
-                        dangerouslySkipPermissions: autoApproveToolCalls,
-                        askPermission: async (tool, args) => {
-                            if (autoApproveToolCalls)
-                                return true;
-                            const preview = safeJsonStringify(args, 1800);
-                            const effectLabel = tool.hasSideEffects === true ? 'side effects' : 'read-only';
-                            const actionId = `tool-${seedId}-${randomUUID()}`;
-                            const decision = await hitlManager.requestApproval({
-                                actionId,
-                                description: `Allow ${tool.name} (${effectLabel})?\\n\\n${preview}`,
-                                severity: tool.hasSideEffects === true ? 'high' : 'low',
-                                category: toAgentosApprovalCategory(tool),
-                                agentId: seed.seedId,
-                                context: { toolName: tool.name, args, sessionId },
-                                reversible: tool.hasSideEffects !== true,
-                                requestedAt: new Date(),
-                                timeoutMs: 5 * 60_000,
-                            });
-                            return decision.approved === true;
-                        },
-                        askCheckpoint: turnApprovalMode === 'off'
-                            ? undefined
-                            : async ({ round, toolCalls }) => {
-                                if (autoApproveToolCalls)
-                                    return true;
-                                const checkpointId = `checkpoint-${seedId}-${sessionId}-${round}-${randomUUID()}`;
-                                const completedWork = toolCalls.map((c) => {
-                                    const effect = c.hasSideEffects ? 'side effects' : 'read-only';
-                                    const preview = safeJsonStringify(c.args, 800);
-                                    return `${c.toolName} (${effect})\\n${preview}`;
-                                });
-                                const timeoutMs = 5 * 60_000;
-                                const checkpointPromise = hitlManager
-                                    .checkpoint({
-                                    checkpointId,
-                                    workflowId: `chat-${sessionId}`,
-                                    currentPhase: `tool-round-${round}`,
-                                    progress: Math.min(1, (round + 1) / 8),
-                                    completedWork,
-                                    upcomingWork: ['Continue to next LLM round'],
-                                    issues: [],
-                                    notes: 'Continue?',
-                                    checkpointAt: new Date(),
-                                })
-                                    .catch(() => ({ decision: 'abort' }));
-                                const timeoutPromise = new Promise((resolve) => setTimeout(() => resolve({ decision: 'abort' }), timeoutMs));
-                                const decision = (await Promise.race([checkpointPromise, timeoutPromise]));
-                                if (decision?.decision !== 'continue') {
-                                    try {
-                                        await hitlManager.cancelRequest(checkpointId, 'checkpoint_timeout_or_abort');
-                                    }
-                                    catch {
-                                        // ignore
-                                    }
-                                }
-                                return decision?.decision === 'continue';
-                            },
-                        baseUrl: llmBaseUrl,
-                        fallback: providerId === 'openai' ? openrouterFallback : undefined,
-                        onFallback: (err, provider) => {
-                            logger.warn?.('[wunderland/api] fallback activated', { error: err.message, provider });
-                        },
-                    });
+                    const result = await tool.execute(args, ctx);
+                    sendJson(res, result.success ? 200 : 500, result);
                 }
-                else {
-                    reply =
-                        'No LLM credentials configured. I can run, but I cannot generate real replies yet.\\n\\n' +
-                            'Set an API key in .env (OPENAI_API_KEY / OPENROUTER_API_KEY / ANTHROPIC_API_KEY) or use Ollama, then retry.\\n\\n' +
-                            `You said: ${message}`;
+                catch (err) {
+                    sendJson(res, 500, {
+                        success: false,
+                        error: err instanceof Error ? err.message : 'Tool execution failed',
+                    });
                 }
-                sendJson(res, 200, { reply });
                 return;
             }
             for (const handler of loadedHttpHandlers) {
@@ -1496,6 +1688,7 @@ export async function createWunderlandServer(opts) {
         await new Promise((resolve, reject) => {
             server.close((err) => (err ? reject(err) : resolve()));
         });
+        await adaptiveRuntime.close();
         await shutdownWunderlandOtel();
     };
     logger.info?.('[wunderland/api] server started', {