octoflow-core 1.0.0

package/dist/runtime/bridge/task-runner-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner-execution.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/task-runner-execution.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAEV,WAAW,EAEZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAYhF,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA+IhE,UAAU,uBAAuB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,uBAAuB,CAAC;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9D,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,CAAC,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC3C,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED,wBAAsB,iBAAiB,CAAC,EACtC,OAAO,EACP,MAAM,EACN,WAAW,EACX,MAAM,EACN,OAAO,EAAE,cAAc,EACvB,KAAK,EACL,YAAY,EACZ,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,eAAe,GAChB,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAySzC"}

package/dist/runtime/bridge/task-runner-execution.js

@@ -0,0 +1,384 @@
+import {
+  maybeWarnApprovalCallbackGap,
+  maybeWarnPermissionPostureGap
+} from "../../adapters/agents/selection-checks.js";
+import { isNativeCliRuntimeBackend } from "../../domain/backend-runtime.js";
+import { toErrorInfo } from "../../utils/operation-info.js";
+import { nowIso } from "../../utils/time.js";
+import { createMetadata } from "../sessions/context-manager.js";
+import {
+  buildLoopContinuationPrompt,
+  buildLoopHistoryEntries,
+  executeBridgeActionCalls,
+  extractExecutableActionCalls,
+  shouldRunBridgeActionLoop
+} from "./capability-runner.js";
+import { resolveBackendOverrides } from "./config-bridge-helpers.js";
+import { resolvePermissionConfig } from "./permission-resolver.js";
+import {
+  failTask,
+  finalizeTask,
+  handleAgentEvent,
+  recoverFromError
+} from "./task-executor.js";
+import {
+  buildActionApprovalCallback,
+  gateTaskOnApproval
+} from "./task-runner-approval.js";
+import { prepareBackendRuntimeForTask } from "./task-runner-backend-runtime.js";
+import { prepareConversationHistory } from "./task-runner-context.js";
+import { BRIDGE_WARNING_CODES } from "./warnings.js";
+function buildSendOptions(p) {
+  const backendOverrides = resolveBackendOverrides(
+    p.backend,
+    p.context.options.backends
+  );
+  const cliBridgeOnly = isNativeCliRuntimeBackend(p.backend);
+  const effectiveModel = p.params.model ?? backendOverrides.model ?? p.context.options.model;
+  return {
+    approvalMode: p.params.approvalMode ?? p.context.policy.approvalMode,
+    isOrchestration: p.actionRound > 0,
+    model: effectiveModel,
+    maxOutputTokens: p.params.maxOutputTokens ?? p.context.options.maxOutputTokens,
+    systemPrompt: p.systemPromptPayload.systemPrompt,
+    ...p.systemPromptPayload.systemPromptParts ? { systemPromptParts: p.systemPromptPayload.systemPromptParts } : {},
+    cache: p.context.options.cache,
+    cacheControl: p.params.cacheControl,
+    cwd: p.context.policy.workspace,
+    profile: p.context.policy.profile,
+    signal: p.controller.signal,
+    timeoutMs: p.params.timeoutMs ?? p.context.options.timeoutMs,
+    worktree: p.params.worktree ?? p.context.options.worktree,
+    mcpConfigPath: cliBridgeOnly ? void 0 : p.toolDelivery?.mcpConfigPath ?? p.params.mcpConfigPath ?? backendOverrides.mcpConfigPath ?? p.context.options.mcpConfigPath,
+    tools: cliBridgeOnly ? void 0 : p.toolDelivery?.tools,
+    retries: 0,
+    parts: p.userMessage.parts,
+    conversationHistory: p.conversationHistory,
+    onEvent: p.onStreamedEvent
+  };
+}
+async function executeActionRound(p) {
+  if (p.toolCalls.length === 0) return null;
+  if (p.actionRound >= p.maxActionRounds) {
+    throw new Error(
+      `Bridge action loop exceeded maxRounds (${p.maxActionRounds})`
+    );
+  }
+  const requestApproval = buildActionApprovalCallback({
+    approvalStore: p.opts.approvalStore,
+    context: p.context,
+    onApprovalRequired: p.opts.approval?.onApprovalRequired,
+    params: p.params,
+    permission: p.resolvedPermission,
+    policy: p.opts.policy,
+    policySubject: p.opts.policySubject,
+    taskId: p.taskId,
+    toolApprovalDecisions: p.toolApprovalDecisions,
+    waitForApproval: p.waitForApproval,
+    emitEvent: p.emitEvent
+  });
+  const actionOutputs = await executeBridgeActionCalls({
+    actionPolicy: p.opts.actionPolicy,
+    actions: p.actions,
+    backend: p.backend,
+    bridge: p.opts.bridge,
+    calls: p.toolCalls,
+    contextId: p.context.id,
+    emitEvent: p.emitEvent,
+    middleware: p.opts.capabilityMiddleware,
+    // Surface the resolved permission (bridge-level OR per-send) so the gate
+    // trigger in capability-action-call sees it for every action.
+    params: p.resolvedPermission ? { ...p.params, permission: p.resolvedPermission } : p.params,
+    parallelActions: p.parallelActions,
+    policy: p.opts.policy,
+    policySubject: p.opts.policySubject,
+    requestApproval,
+    taskId: p.taskId,
+    tenant: p.context.tenant
+  });
+  return {
+    conversationHistory: [
+      ...p.conversationHistory,
+      ...buildLoopHistoryEntries(p.result, actionOutputs)
+    ],
+    prompt: buildLoopContinuationPrompt(actionOutputs),
+    actionRound: p.actionRound + 1
+  };
+}
+async function executeQueuedTask({
+  context,
+  taskId,
+  userMessage,
+  params,
+  backend: initialBackend,
+  store,
+  getSessionFn,
+  opts,
+  deps,
+  emitEvent,
+  waitForApproval
+}) {
+  let backend = initialBackend;
+  let toolDelivery;
+  try {
+    const task = await store.getTask(taskId);
+    if (!task || task.status.state === "canceled") return;
+    const resolvedPermission = resolvePermissionConfig(
+      opts.permission,
+      params.permission
+    );
+    const mayProceed = await gateTaskOnApproval({
+      backend,
+      context,
+      opts,
+      params,
+      permission: resolvedPermission,
+      store,
+      taskId,
+      waitForApproval
+    });
+    if (!mayProceed) return;
+    if (params.onToolApproval && !context.options.suppressWarnings) {
+      const warning = maybeWarnApprovalCallbackGap(
+        opts.bridge ?? context,
+        {
+          firstPriority: backend,
+          approvalMode: params.approvalMode ?? context.policy.approvalMode,
+          hasCallback: true
+        }
+      );
+      if (warning) {
+        await emitEvent?.("bridge:warn", {
+          code: BRIDGE_WARNING_CODES.APPROVAL_CALLBACK_WILL_NOT_FIRE,
+          message: warning
+        });
+      }
+    }
+    if (resolvedPermission && !context.options.suppressWarnings) {
+      const warning = maybeWarnPermissionPostureGap(
+        opts.bridge ?? context,
+        {
+          firstPriority: backend,
+          permission: resolvedPermission
+        }
+      );
+      if (warning) {
+        await emitEvent?.("bridge:warn", {
+          code: BRIDGE_WARNING_CODES.PERMISSION_PRESET_WILL_NOT_FIRE,
+          message: warning
+        });
+      }
+    }
+    let session = await getSessionFn(context);
+    const historyBundle = await prepareConversationHistory({
+      backend,
+      context,
+      opts,
+      params,
+      store,
+      task,
+      userMessage
+    });
+    let conversationHistory = historyBundle.conversationHistory;
+    let prompt = historyBundle.prompt;
+    const maxRetries = params.retries ?? context.options.retries;
+    let attempt = 0;
+    const attemptedBackends = [backend];
+    const maxActionRounds = typeof context.options.agentLoop === "object" ? context.options.agentLoop.maxRounds ?? 10 : 10;
+    const parallelActions = typeof context.options.agentLoop === "object" ? context.options.agentLoop.parallelActions ?? false : false;
+    let actionRound = 0;
+    const prepareBackendRuntime = async (nextBackend) => {
+      const prepared = await prepareBackendRuntimeForTask({
+        context,
+        emitEvent,
+        nextBackend,
+        opts,
+        params,
+        taskId,
+        toolDelivery
+      });
+      toolDelivery = prepared.toolDelivery;
+      return {
+        taskCapabilities: prepared.taskCapabilities,
+        systemPromptPayload: prepared.systemPromptPayload
+      };
+    };
+    let backendRuntime = await prepareBackendRuntime(backend);
+    await emitEvent?.("task:created", {
+      taskId,
+      contextId: context.id,
+      backend,
+      message: prompt
+    });
+    while (true) {
+      const current = await store.getTask(taskId);
+      if (!current || current.status.state === "canceled") return;
+      await store.updateStatus({
+        taskId,
+        status: { state: "working", timestamp: nowIso() },
+        metadata: createMetadata(context, backend)
+      });
+      await emitEvent?.("task:working", {
+        taskId,
+        contextId: context.id,
+        backend
+      });
+      try {
+        const controller = new AbortController();
+        deps.abortControllers.set(taskId, controller);
+        if (params.signal) {
+          if (params.signal.aborted) {
+            controller.abort();
+          } else {
+            params.signal.addEventListener("abort", () => controller.abort(), {
+              once: true
+            });
+          }
+        }
+        const toolApprovalDecisions = /* @__PURE__ */ new Map();
+        let streamedToolEventCount = 0;
+        const result = await session.send(
+          prompt,
+          buildSendOptions({
+            actionRound,
+            backend,
+            context,
+            controller,
+            conversationHistory,
+            params,
+            toolDelivery,
+            userMessage,
+            systemPromptPayload: backendRuntime.systemPromptPayload,
+            taskId,
+            onStreamedEvent: async (event) => {
+              if (event.type === "tool" && params.onToolApproval) {
+                const toolCallId = `event_call_${streamedToolEventCount++}`;
+                const approved = await params.onToolApproval({
+                  name: event.name ?? "",
+                  args: event.args ?? {},
+                  taskId,
+                  contextId: context.id
+                });
+                toolApprovalDecisions.set(toolCallId, approved);
+                if (!approved) return;
+              }
+              await handleAgentEvent(deps, context, taskId, event, backend);
+            }
+          })
+        );
+        if (deps.abortControllers.get(taskId) === controller) {
+          deps.abortControllers.delete(taskId);
+        }
+        const afterRun = await store.getTask(taskId);
+        if (!afterRun || afterRun.status.state === "canceled") return;
+        if (afterRun.status.state === "input-required" || afterRun.status.state === "auth-required") {
+          return;
+        }
+        if (result.exitCode === 0) {
+          if (shouldRunBridgeActionLoop(
+            backendRuntime.taskCapabilities.actions,
+            context.options.agentLoop
+          )) {
+            const toolCalls = extractExecutableActionCalls(
+              result,
+              backendRuntime.taskCapabilities.actions
+            );
+            const roundResult = await executeActionRound({
+              actionRound,
+              maxActionRounds,
+              actions: backendRuntime.taskCapabilities.actions,
+              toolCalls,
+              result,
+              conversationHistory,
+              opts,
+              context,
+              backend,
+              params,
+              resolvedPermission,
+              taskId,
+              toolApprovalDecisions,
+              waitForApproval,
+              emitEvent,
+              parallelActions
+            });
+            if (roundResult) {
+              conversationHistory = roundResult.conversationHistory;
+              prompt = roundResult.prompt;
+              actionRound = roundResult.actionRound;
+              continue;
+            }
+          }
+          await finalizeTask(
+            deps,
+            context,
+            taskId,
+            result,
+            backend,
+            params.historyLength,
+            {
+              partsCached: backendRuntime.systemPromptPayload.partsCached
+            }
+          );
+          return;
+        }
+        const error = new Error(
+          result.text || `Backend exited with code ${result.exitCode}`
+        );
+        const recovery = await recoverFromError(
+          deps,
+          context,
+          taskId,
+          error,
+          backend,
+          attempt,
+          maxRetries,
+          attemptedBackends,
+          params
+        );
+        if (!recovery) return;
+        if (recovery.kind === "fallback") {
+          backend = recovery.backend;
+          session = recovery.session;
+          attemptedBackends.push(recovery.backend);
+          backendRuntime = await prepareBackendRuntime(backend);
+        } else {
+          attempt += 1;
+        }
+      } catch (error) {
+        deps.abortControllers.delete(taskId);
+        const afterCatch = await store.getTask(taskId);
+        if (!afterCatch || afterCatch.status.state === "canceled") return;
+        const recovery = await recoverFromError(
+          deps,
+          context,
+          taskId,
+          error,
+          backend,
+          attempt,
+          maxRetries,
+          attemptedBackends,
+          params
+        );
+        if (!recovery) return;
+        if (recovery.kind === "fallback") {
+          backend = recovery.backend;
+          session = recovery.session;
+          attemptedBackends.push(recovery.backend);
+          backendRuntime = await prepareBackendRuntime(backend);
+        } else {
+          attempt += 1;
+        }
+      }
+    }
+  } catch (setupError) {
+    const errorInfo = toErrorInfo("run", backend, setupError);
+    await params.onError?.(errorInfo);
+    await failTask(deps, context, taskId, setupError, backend, errorInfo);
+  } finally {
+    await toolDelivery?.cleanupTempConfig?.();
+  }
+}
+export {
+  executeQueuedTask
+};
+//# sourceMappingURL=task-runner-execution.js.map

package/dist/runtime/bridge/task-runner-execution.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/task-runner-execution.ts"],
+  "sourcesContent": ["import type { ActionDefinition } from '../../actions/types.js';\nimport {\n  maybeWarnApprovalCallbackGap,\n  maybeWarnPermissionPostureGap,\n} from '../../adapters/agents/selection-checks.js';\nimport type { ToolDeliveryResult } from '../../adapters/agents/tool-delivery.js';\nimport type { TaskStore } from '../../adapters/data/task-store/index.js';\nimport type { CapabilityToolCall } from '../../capabilities/types.js';\nimport { isNativeCliRuntimeBackend } from '../../domain/backend-runtime.js';\nimport type { BridgeSendMessageParams } from '../../domain/bridge-api.js';\nimport type {\n  AgentEvent,\n  BackendName,\n  RunResult,\n} from '../../domain/core-client.js';\nimport type { Message } from '../../domain/core-task.js';\nimport { toErrorInfo } from '../../utils/operation-info.js';\nimport { nowIso } from '../../utils/time.js';\nimport type { ContextState, SessionLike } from '../sessions/context-manager.js';\nimport { createMetadata } from '../sessions/context-manager.js';\nimport type { ConversationSendOptions } from '../sessions/conversation.js';\nimport {\n  buildLoopContinuationPrompt,\n  buildLoopHistoryEntries,\n  executeBridgeActionCalls,\n  extractExecutableActionCalls,\n  shouldRunBridgeActionLoop,\n} from './capability-runner.js';\nimport { resolveBackendOverrides } from './config-bridge-helpers.js';\nimport { resolvePermissionConfig } from './permission-resolver.js';\nimport {\n  failTask,\n  finalizeTask,\n  handleAgentEvent,\n  recoverFromError,\n  type TaskExecutorDeps,\n} from './task-executor.js';\nimport {\n  buildActionApprovalCallback,\n  gateTaskOnApproval,\n} from './task-runner-approval.js';\nimport type { PreparedBackendRuntime } from './task-runner-backend-runtime.js';\nimport { prepareBackendRuntimeForTask } from './task-runner-backend-runtime.js';\nimport { prepareConversationHistory } from './task-runner-context.js';\nimport type { TaskRunnerOptions } from './task-runner-types.js';\nimport { BRIDGE_WARNING_CODES } from './warnings.js';\n\n// ---------------------------------------------------------------------------\n// Private helpers extracted from executeQueuedTask to keep that function lean.\n// ---------------------------------------------------------------------------\n\ninterface BuildSendOptionsParams {\n  actionRound: number;\n  backend: BackendName;\n  context: ContextState;\n  controller: AbortController;\n  conversationHistory: Message[];\n  params: BridgeSendMessageParams;\n  toolDelivery: ToolDeliveryResult | undefined;\n  userMessage: Message;\n  systemPromptPayload: PreparedBackendRuntime['systemPromptPayload'];\n  taskId: string;\n  onStreamedEvent: (event: AgentEvent) => Promise<void>;\n}\n\nfunction buildSendOptions(p: BuildSendOptionsParams): ConversationSendOptions {\n  const backendOverrides = resolveBackendOverrides(\n    p.backend,\n    p.context.options.backends\n  );\n  const cliBridgeOnly = isNativeCliRuntimeBackend(p.backend);\n  const effectiveModel =\n    p.params.model ?? backendOverrides.model ?? p.context.options.model;\n  return {\n    approvalMode: p.params.approvalMode ?? p.context.policy.approvalMode,\n    isOrchestration: p.actionRound > 0,\n    model: effectiveModel,\n    maxOutputTokens:\n      p.params.maxOutputTokens ?? p.context.options.maxOutputTokens,\n    systemPrompt: p.systemPromptPayload.systemPrompt,\n    ...(p.systemPromptPayload.systemPromptParts\n      ? { systemPromptParts: p.systemPromptPayload.systemPromptParts }\n      : {}),\n    cache: p.context.options.cache,\n    cacheControl: p.params.cacheControl,\n    cwd: p.context.policy.workspace,\n    profile: p.context.policy.profile,\n    signal: p.controller.signal,\n    timeoutMs: p.params.timeoutMs ?? p.context.options.timeoutMs,\n    worktree: p.params.worktree ?? p.context.options.worktree,\n    mcpConfigPath: cliBridgeOnly\n      ? undefined\n      : (p.toolDelivery?.mcpConfigPath ??\n        p.params.mcpConfigPath ??\n        backendOverrides.mcpConfigPath ??\n        p.context.options.mcpConfigPath),\n    tools: cliBridgeOnly ? undefined : p.toolDelivery?.tools,\n    retries: 0,\n    parts: p.userMessage.parts,\n    conversationHistory: p.conversationHistory,\n    onEvent: p.onStreamedEvent,\n  };\n}\n\ninterface ExecuteActionRoundParams {\n  actionRound: number;\n  maxActionRounds: number;\n  actions: ActionDefinition[];\n  toolCalls: CapabilityToolCall[];\n  result: RunResult;\n  conversationHistory: Message[];\n  opts: TaskRunnerOptions;\n  context: ContextState;\n  backend: BackendName;\n  params: BridgeSendMessageParams;\n  resolvedPermission: ReturnType<typeof resolvePermissionConfig>;\n  taskId: string;\n  toolApprovalDecisions: Map<string, boolean>;\n  waitForApproval: (approvalId: string) => Promise<boolean>;\n  emitEvent: TaskRunnerOptions['emitEvent'];\n  parallelActions: boolean;\n}\n\n/**\n * Runs one bridge-action-loop round. Returns the updated conversation state\n * so the outer loop can `continue`, or `null` when no tool calls were found\n * and the task should be finalised instead.\n */\nasync function executeActionRound(p: ExecuteActionRoundParams): Promise<{\n  conversationHistory: Message[];\n  prompt: string;\n  actionRound: number;\n} | null> {\n  if (p.toolCalls.length === 0) return null;\n\n  if (p.actionRound >= p.maxActionRounds) {\n    throw new Error(\n      `Bridge action loop exceeded maxRounds (${p.maxActionRounds})`\n    );\n  }\n\n  const requestApproval = buildActionApprovalCallback({\n    approvalStore: p.opts.approvalStore,\n    context: p.context,\n    onApprovalRequired: p.opts.approval?.onApprovalRequired,\n    params: p.params,\n    permission: p.resolvedPermission,\n    policy: p.opts.policy,\n    policySubject: p.opts.policySubject,\n    taskId: p.taskId,\n    toolApprovalDecisions: p.toolApprovalDecisions,\n    waitForApproval: p.waitForApproval,\n    emitEvent: p.emitEvent,\n  });\n\n  const actionOutputs = await executeBridgeActionCalls({\n    actionPolicy: p.opts.actionPolicy,\n    actions: p.actions,\n    backend: p.backend,\n    bridge: p.opts.bridge,\n    calls: p.toolCalls,\n    contextId: p.context.id,\n    emitEvent: p.emitEvent,\n    middleware: p.opts.capabilityMiddleware,\n    // Surface the resolved permission (bridge-level OR per-send) so the gate\n    // trigger in capability-action-call sees it for every action.\n    params: p.resolvedPermission\n      ? { ...p.params, permission: p.resolvedPermission }\n      : p.params,\n    parallelActions: p.parallelActions,\n    policy: p.opts.policy,\n    policySubject: p.opts.policySubject,\n    requestApproval,\n    taskId: p.taskId,\n    tenant: p.context.tenant,\n  });\n\n  return {\n    conversationHistory: [\n      ...p.conversationHistory,\n      ...buildLoopHistoryEntries(p.result, actionOutputs),\n    ],\n    prompt: buildLoopContinuationPrompt(actionOutputs),\n    actionRound: p.actionRound + 1,\n  };\n}\n\ninterface ExecuteQueuedTaskParams {\n  context: ContextState;\n  taskId: string;\n  userMessage: Message;\n  params: BridgeSendMessageParams;\n  backend: BackendName;\n  store: TaskStore;\n  getSessionFn: (context: ContextState) => Promise<SessionLike>;\n  opts: TaskRunnerOptions;\n  deps: TaskExecutorDeps;\n  emitEvent?: TaskRunnerOptions['emitEvent'];\n  waitForApproval: (approvalId: string) => Promise<boolean>;\n}\n\nexport async function executeQueuedTask({\n  context,\n  taskId,\n  userMessage,\n  params,\n  backend: initialBackend,\n  store,\n  getSessionFn,\n  opts,\n  deps,\n  emitEvent,\n  waitForApproval,\n}: ExecuteQueuedTaskParams): Promise<void> {\n  let backend = initialBackend;\n  let toolDelivery: ToolDeliveryResult | undefined;\n\n  try {\n    const task = await store.getTask(taskId);\n    if (!task || task.status.state === 'canceled') return;\n\n    const resolvedPermission = resolvePermissionConfig(\n      opts.permission,\n      params.permission\n    );\n\n    const mayProceed = await gateTaskOnApproval({\n      backend,\n      context,\n      opts,\n      params,\n      permission: resolvedPermission,\n      store,\n      taskId,\n      waitForApproval,\n    });\n    if (!mayProceed) return;\n\n    if (params.onToolApproval && !context.options.suppressWarnings) {\n      const warning = maybeWarnApprovalCallbackGap(\n        (opts.bridge as object) ?? context,\n        {\n          firstPriority: backend,\n          approvalMode: params.approvalMode ?? context.policy.approvalMode,\n          hasCallback: true,\n        }\n      );\n      if (warning) {\n        await emitEvent?.('bridge:warn', {\n          code: BRIDGE_WARNING_CODES.APPROVAL_CALLBACK_WILL_NOT_FIRE,\n          message: warning,\n        });\n      }\n    }\n\n    if (resolvedPermission && !context.options.suppressWarnings) {\n      const warning = maybeWarnPermissionPostureGap(\n        (opts.bridge as object) ?? context,\n        {\n          firstPriority: backend,\n          permission: resolvedPermission,\n        }\n      );\n      if (warning) {\n        await emitEvent?.('bridge:warn', {\n          code: BRIDGE_WARNING_CODES.PERMISSION_PRESET_WILL_NOT_FIRE,\n          message: warning,\n        });\n      }\n    }\n\n    let session = await getSessionFn(context);\n    const historyBundle = await prepareConversationHistory({\n      backend,\n      context,\n      opts,\n      params,\n      store,\n      task,\n      userMessage,\n    });\n    let conversationHistory = historyBundle.conversationHistory;\n    let prompt = historyBundle.prompt;\n\n    const maxRetries = params.retries ?? context.options.retries;\n    let attempt = 0;\n    const attemptedBackends: BackendName[] = [backend];\n    const maxActionRounds =\n      typeof context.options.agentLoop === 'object'\n        ? (context.options.agentLoop.maxRounds ?? 10)\n        : 10;\n    const parallelActions =\n      typeof context.options.agentLoop === 'object'\n        ? (context.options.agentLoop.parallelActions ?? false)\n        : false;\n    let actionRound = 0;\n    const prepareBackendRuntime = async (nextBackend: BackendName) => {\n      const prepared = await prepareBackendRuntimeForTask({\n        context,\n        emitEvent,\n        nextBackend,\n        opts,\n        params,\n        taskId,\n        toolDelivery,\n      });\n      toolDelivery = prepared.toolDelivery;\n      return {\n        taskCapabilities: prepared.taskCapabilities,\n        systemPromptPayload: prepared.systemPromptPayload,\n      };\n    };\n\n    let backendRuntime = await prepareBackendRuntime(backend);\n\n    await emitEvent?.('task:created', {\n      taskId,\n      contextId: context.id,\n      backend,\n      message: prompt,\n    });\n\n    while (true) {\n      const current = await store.getTask(taskId);\n      if (!current || current.status.state === 'canceled') return;\n\n      await store.updateStatus({\n        taskId,\n        status: { state: 'working', timestamp: nowIso() },\n        metadata: createMetadata(context, backend),\n      });\n      await emitEvent?.('task:working', {\n        taskId,\n        contextId: context.id,\n        backend,\n      });\n\n      try {\n        const controller = new AbortController();\n        deps.abortControllers.set(taskId, controller);\n\n        // Wire the caller-provided signal so aborting it also aborts the\n        // internal controller (and therefore the underlying CLI process).\n        if (params.signal) {\n          if (params.signal.aborted) {\n            controller.abort();\n          } else {\n            params.signal.addEventListener('abort', () => controller.abort(), {\n              once: true,\n            });\n          }\n        }\n\n        const toolApprovalDecisions = new Map<string, boolean>();\n        let streamedToolEventCount = 0;\n\n        const result = await session.send(\n          prompt,\n          buildSendOptions({\n            actionRound,\n            backend,\n            context,\n            controller,\n            conversationHistory,\n            params,\n            toolDelivery,\n            userMessage,\n            systemPromptPayload: backendRuntime.systemPromptPayload,\n            taskId,\n            onStreamedEvent: async (event: AgentEvent) => {\n              if (event.type === 'tool' && params.onToolApproval) {\n                const toolCallId = `event_call_${streamedToolEventCount++}`;\n                const approved = await params.onToolApproval({\n                  name: event.name ?? '',\n                  args: event.args ?? {},\n                  taskId,\n                  contextId: context.id,\n                });\n                toolApprovalDecisions.set(toolCallId, approved);\n                if (!approved) return;\n              }\n              await handleAgentEvent(deps, context, taskId, event, backend);\n            },\n          })\n        );\n\n        if (deps.abortControllers.get(taskId) === controller) {\n          deps.abortControllers.delete(taskId);\n        }\n\n        const afterRun = await store.getTask(taskId);\n        if (!afterRun || afterRun.status.state === 'canceled') return;\n        if (\n          afterRun.status.state === 'input-required' ||\n          afterRun.status.state === 'auth-required'\n        ) {\n          return;\n        }\n\n        if (result.exitCode === 0) {\n          if (\n            shouldRunBridgeActionLoop(\n              backendRuntime.taskCapabilities.actions,\n              context.options.agentLoop\n            )\n          ) {\n            const toolCalls = extractExecutableActionCalls(\n              result,\n              backendRuntime.taskCapabilities.actions\n            );\n            const roundResult = await executeActionRound({\n              actionRound,\n              maxActionRounds,\n              actions: backendRuntime.taskCapabilities.actions,\n              toolCalls,\n              result,\n              conversationHistory,\n              opts,\n              context,\n              backend,\n              params,\n              resolvedPermission,\n              taskId,\n              toolApprovalDecisions,\n              waitForApproval,\n              emitEvent,\n              parallelActions,\n            });\n            if (roundResult) {\n              conversationHistory = roundResult.conversationHistory;\n              prompt = roundResult.prompt;\n              actionRound = roundResult.actionRound;\n              continue;\n            }\n          }\n\n          await finalizeTask(\n            deps,\n            context,\n            taskId,\n            result,\n            backend,\n            params.historyLength,\n            {\n              partsCached: backendRuntime.systemPromptPayload.partsCached,\n            }\n          );\n          return;\n        }\n\n        const error = new Error(\n          result.text || `Backend exited with code ${result.exitCode}`\n        );\n        const recovery = await recoverFromError(\n          deps,\n          context,\n          taskId,\n          error,\n          backend,\n          attempt,\n          maxRetries,\n          attemptedBackends,\n          params\n        );\n        if (!recovery) return;\n        if (recovery.kind === 'fallback') {\n          backend = recovery.backend;\n          session = recovery.session;\n          attemptedBackends.push(recovery.backend);\n          backendRuntime = await prepareBackendRuntime(backend);\n        } else {\n          attempt += 1;\n        }\n      } catch (error) {\n        deps.abortControllers.delete(taskId);\n        const afterCatch = await store.getTask(taskId);\n        if (!afterCatch || afterCatch.status.state === 'canceled') return;\n\n        const recovery = await recoverFromError(\n          deps,\n          context,\n          taskId,\n          error,\n          backend,\n          attempt,\n          maxRetries,\n          attemptedBackends,\n          params\n        );\n        if (!recovery) return;\n        if (recovery.kind === 'fallback') {\n          backend = recovery.backend;\n          session = recovery.session;\n          attemptedBackends.push(recovery.backend);\n          backendRuntime = await prepareBackendRuntime(backend);\n        } else {\n          attempt += 1;\n        }\n      }\n    }\n  } catch (setupError) {\n    // Any throw that escapes the while-loop's own try/catch (most commonly: setup\n    // code before the loop) leaves the task stuck in 'submitted'. Catch it here\n    // and drive the task to 'failed' so callers and subscribers never see a zombie.\n    const errorInfo = toErrorInfo('run', backend, setupError);\n    await params.onError?.(errorInfo);\n    await failTask(deps, context, taskId, setupError, backend, errorInfo);\n  } finally {\n    await toolDelivery?.cleanupTempConfig?.();\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/task-runner-types.d.ts

@@ -0,0 +1,45 @@
+import type { ActionRegistry } from '../../actions/registry.js';
+import type { ActionPolicy } from '../../actions/types.js';
+import type { AgentRegistry } from '../../adapters/agents/registry/loader.js';
+import type { ApprovalStore } from '../../adapters/data/approval-store/types.js';
+import type { CostAccumulator } from '../../adapters/data/budget/cost-accumulator.js';
+import type { CapabilityMiddleware } from '../../capabilities/types.js';
+import type { BackendName } from '../../domain/core-client.js';
+import type { PermissionConfig } from '../../domain/permission.js';
+import type { BridgePolicy, PolicySubject } from '../../policy/index.js';
+import type { CircuitBreakerRegistry } from '../../resilience/circuit-breaker.js';
+import type { ContextState, SessionLike } from '../sessions/context-manager.js';
+import type { BridgeEventMap } from './events.js';
+export interface ApprovalGateOptions {
+    requiresApproval?: string[];
+    approvalTimeoutMs?: number;
+    onApprovalRequired?: (taskId: string, toolName: string) => void | Promise<void>;
+}
+export interface TaskRunnerOptions {
+    allowCrossFamilySwitch?: boolean;
+    approvalStore?: ApprovalStore;
+    circuitBreaker?: CircuitBreakerRegistry;
+    costAccumulator?: CostAccumulator;
+    maxQueueDepth?: number;
+    maxSwitchesPerContext?: number;
+    mobilityEnabled?: boolean;
+    approval?: ApprovalGateOptions;
+    /** Bridge-level default permission preset. See `BridgeOptions.permission`. */
+    permission?: PermissionConfig;
+    onContextDrained?: (contextId: string, tenant?: string) => void;
+    onSessionResolved?: (context: ContextState, backend: BackendName, cliSessionId: string) => Promise<void>;
+    summaryClientFactory?: (model: string) => (systemPrompt: string, userMessage: string) => Promise<string>;
+    switchBackend?: (context: ContextState, excludedBackends: BackendName[]) => Promise<{
+        backend: BackendName;
+        session: SessionLike;
+    } | null>;
+    emitEvent?: <K extends keyof BridgeEventMap>(event: K, data: BridgeEventMap[K]) => Promise<void>;
+    actionRegistry?: ActionRegistry;
+    actionPolicy?: ActionPolicy;
+    agentRegistry?: AgentRegistry;
+    capabilityMiddleware?: CapabilityMiddleware[];
+    bridge?: unknown;
+    policy?: BridgePolicy;
+    policySubject?: PolicySubject;
+}
+//# sourceMappingURL=task-runner-types.d.ts.map

package/dist/runtime/bridge/task-runner-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner-types.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/task-runner-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,CACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,KACb,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,iBAAiB,CAAC,EAAE,CAClB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,oBAAoB,CAAC,EAAE,CACrB,KAAK,EAAE,MAAM,KACV,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,aAAa,CAAC,EAAE,CACd,OAAO,EAAE,YAAY,EACrB,gBAAgB,EAAE,WAAW,EAAE,KAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACpE,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EACzC,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,oBAAoB,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B"}

package/dist/runtime/bridge/task-runner-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=task-runner-types.js.map

package/dist/runtime/bridge/task-runner-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/bridge/task-runner.d.ts

@@ -0,0 +1,33 @@
+import type { TaskStore } from '../../adapters/data/task-store/index.js';
+import type { BridgeSendMessageParams } from '../../domain/bridge-api.js';
+import type { BackendName } from '../../domain/core-client.js';
+import type { Message, Task, TaskState } from '../../domain/core-task.js';
+import type { ContextState, SessionLike } from '../sessions/context-manager.js';
+import type { TaskRunnerOptions } from './task-runner-types.js';
+export { applyHistoryStrategy } from './task-executor.js';
+export type { ApprovalGateOptions, TaskRunnerOptions, } from './task-runner-types.js';
+export declare function isTaskSettled(state: TaskState): boolean;
+export declare class TaskRunner {
+    private readonly abortControllers;
+    private readonly onContextDrained?;
+    private readonly pendingApprovals;
+    private readonly tasksByContext;
+    private readonly opts;
+    private readonly store;
+    private readonly getSessionFn;
+    private readonly deps;
+    private readonly emitEvent?;
+    constructor(store: TaskStore, getSession: (context: ContextState) => Promise<SessionLike>, opts?: TaskRunnerOptions);
+    private ensureCanEnqueue;
+    assertCanEnqueue(context: ContextState): void;
+    enqueue(context: ContextState, taskId: string, userMessage: Message, params: BridgeSendMessageParams, backend: BackendName): void;
+    cancel(taskId: string, task: Task, context?: ContextState): Promise<void>;
+    abort(taskId: string): void;
+    abortAll(): void;
+    resolveApproval(approvalId: string, approved: boolean): void;
+    waitForApproval(approvalId: string): Promise<boolean>;
+    getTasksForContext(contextId: string): Set<string>;
+    abortContext(contextId: string): void;
+    waitForSettlement(taskId: string, timeoutMs?: number): Promise<void>;
+}
+//# sourceMappingURL=task-runner.d.ts.map

package/dist/runtime/bridge/task-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/task-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAS1E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAIhF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EACV,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAQvD;AAkBD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;IACvE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAGxB;IACV,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAM7B;IACJ,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;IACjE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAEH;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAiC;gBAG1D,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,EAC3D,IAAI,GAAE,iBAAsB;IAqB9B,OAAO,CAAC,gBAAgB;IAqBxB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAI7C,OAAO,CACL,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,WAAW,GACnB,IAAI;IAwCD,MAAM,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC;IAmChB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK3B,QAAQ,IAAI,IAAI;IAOhB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAQ5D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcrD,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIlD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ/B,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA6D3E"}