octoflow-core 1.0.0

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

@@ -0,0 +1,25 @@
+import type { ToolDeliveryResult } from '../../adapters/agents/tool-delivery.js';
+import { buildBridgeSystemPromptPayload } from '../../capabilities/agent-context/compose.js';
+import type { BridgeSendMessageParams } from '../../domain/bridge-api.js';
+import type { BackendName } from '../../domain/core-client.js';
+import type { ContextState } from '../sessions/context-manager.js';
+import { prepareTaskCapabilities } from './capability-runner.js';
+import type { TaskRunnerOptions } from './task-runner-types.js';
+export interface PreparedBackendRuntime {
+    taskCapabilities: Awaited<ReturnType<typeof prepareTaskCapabilities>>;
+    systemPromptPayload: Awaited<ReturnType<typeof buildBridgeSystemPromptPayload>>;
+}
+export interface PrepareBackendRuntimeArgs {
+    context: ContextState;
+    emitEvent?: TaskRunnerOptions['emitEvent'];
+    nextBackend: BackendName;
+    opts: TaskRunnerOptions;
+    params: BridgeSendMessageParams;
+    taskId: string;
+    toolDelivery?: ToolDeliveryResult;
+}
+export interface PreparedBackendRuntimeResult extends PreparedBackendRuntime {
+    toolDelivery?: ToolDeliveryResult;
+}
+export declare function prepareBackendRuntimeForTask(args: PrepareBackendRuntimeArgs): Promise<PreparedBackendRuntimeResult>;
+//# sourceMappingURL=task-runner-backend-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner-backend-runtime.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/task-runner-backend-runtime.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAC;AAG7F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAO/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAIjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;IACtE,mBAAmB,EAAE,OAAO,CAC1B,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAClD,CAAC;CACH;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC3C,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,uBAAuB,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IAC1E,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAeD,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,4BAA4B,CAAC,CA2LvC"}

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

@@ -0,0 +1,215 @@
+import {
+  findUnsupportedRequestFields,
+  getDefaultCliFeatureMatrix,
+  isCliBackendCoveredByMatrix
+} from "../../adapters/agents/backends/cli-feature-matrix.js";
+import { buildBridgeSystemPromptPayload } from "../../capabilities/agent-context/compose.js";
+import { backendTokenEstimator } from "../../capabilities/context-compaction.js";
+import { isNativeCliRuntimeBackend } from "../../domain/backend-runtime.js";
+import { analyzePromptCachePrefix } from "../../domain/prompt-cache.js";
+import {
+  assertPolicyAllowed,
+  decidePolicy,
+  resolvePolicySubject
+} from "../../policy/index.js";
+import { prepareTaskCapabilities } from "./capability-runner.js";
+import { emitPolicyDecision } from "./policy-events.js";
+import { applyAgentApprovalPolicy } from "./task-runner-approval.js";
+import { prepareToolDeliveryForTask } from "./task-runner-context.js";
+import { BRIDGE_WARNING_CODES } from "./warnings.js";
+function isDefaultBuiltinAction(action) {
+  return action.metadata?.octoflowDefaultBuiltin === true;
+}
+function filterDefaultBuiltinsForBackend(actions, backend) {
+  if (!isNativeCliRuntimeBackend(backend)) return actions;
+  return actions.filter((action) => !isDefaultBuiltinAction(action));
+}
+async function prepareBackendRuntimeForTask(args) {
+  const { context, emitEvent, nextBackend, opts, params, taskId } = args;
+  const cliBridgeOnly = isNativeCliRuntimeBackend(nextBackend);
+  let toolDelivery = args.toolDelivery;
+  await toolDelivery?.cleanupTempConfig?.();
+  toolDelivery = void 0;
+  const subject = resolvePolicySubject(params.subject, opts.policySubject);
+  await assertPolicyAllowed(
+    opts.policy,
+    {
+      action: "backend.use",
+      subject,
+      resource: {
+        kind: "backend",
+        id: nextBackend,
+        backend: nextBackend,
+        tenant: context.tenant
+      },
+      context: {
+        contextId: context.id,
+        taskId,
+        backend: nextBackend,
+        requestedTenant: context.tenant
+      }
+    },
+    emitPolicyDecision(emitEvent)
+  );
+  const passthrough = params.passthrough === true;
+  const taskCapabilities = await prepareTaskCapabilities({
+    actionDefinitions: passthrough || cliBridgeOnly ? [] : opts.actionRegistry?.all() ?? [],
+    backend: nextBackend,
+    bridge: opts.bridge,
+    context,
+    params,
+    taskId,
+    passthrough: passthrough || cliBridgeOnly
+  });
+  if (!cliBridgeOnly) {
+    const policyResults = await Promise.all(
+      taskCapabilities.actions.map(async (action) => {
+        const input = {
+          action: "tool.deliver",
+          subject,
+          resource: {
+            kind: "tool",
+            id: action.name,
+            name: action.name,
+            tags: action.tags,
+            tenant: context.tenant,
+            attributes: { executorType: action.executor.type }
+          },
+          context: {
+            contextId: context.id,
+            taskId,
+            backend: nextBackend,
+            requestedTenant: context.tenant
+          }
+        };
+        const decision = await decidePolicy(opts.policy, input);
+        await emitPolicyDecision(emitEvent)?.({ input, decision });
+        return decision.effect === "allow" ? action : null;
+      })
+    );
+    taskCapabilities.actions = policyResults.filter(
+      (a) => a !== null
+    );
+    taskCapabilities.actions = applyAgentApprovalPolicy(
+      taskCapabilities.actions,
+      opts,
+      params
+    );
+    taskCapabilities.actions = filterDefaultBuiltinsForBackend(
+      taskCapabilities.actions,
+      nextBackend
+    );
+  }
+  if (!context.options.suppressWarnings) {
+    await warnUnsupportedCliFeatures(nextBackend, params, emitEvent);
+  }
+  const autoEnableAgentLoop = !cliBridgeOnly && context.options.agentLoop === void 0 && taskCapabilities.actions.length > 0;
+  const effectiveAgentLoop = autoEnableAgentLoop ? { enabled: true, maxRounds: 10 } : context.options.agentLoop;
+  if (autoEnableAgentLoop) {
+    context.options.agentLoop = effectiveAgentLoop;
+    if (!context.options.suppressWarnings) {
+      await emitEvent?.("bridge:warn", {
+        code: BRIDGE_WARNING_CODES.AGENT_LOOP_AUTO_ENABLED,
+        message: "agentLoop auto-enabled (maxRounds: 10) because actions are registered. Set agentLoop explicitly to suppress this warning."
+      });
+    }
+  }
+  toolDelivery = cliBridgeOnly ? void 0 : await prepareToolDeliveryForTask({
+    actions: taskCapabilities.actions,
+    backend: nextBackend,
+    context,
+    emitEvent,
+    params,
+    taskId
+  });
+  const sectionCapMax = params.maxSectionTokens ?? context.options.maxSectionTokens;
+  const carry = passthrough || cliBridgeOnly ? {} : pickFields(context.options, PASSTHROUGH_DROPPED_FIELDS);
+  const systemPromptPayload = await buildBridgeSystemPromptPayload({
+    actions: taskCapabilities.actions,
+    agentLoop: passthrough || cliBridgeOnly ? void 0 : effectiveAgentLoop,
+    baseSystemPrompt: passthrough ? params.systemPrompt : params.systemPrompt ?? context.options.systemPrompt,
+    cache: context.options.cache,
+    cacheControl: params.cacheControl,
+    context: carry.context,
+    contextMiddleware: carry.contextMiddleware,
+    extraSystemPromptParts: carry.systemPromptParts,
+    guardrails: carry.guardrails,
+    plugins: carry.plugins,
+    skills: carry.actionBundles,
+    tasks: carry.tasks,
+    userSystemPrompt: carry.userSystemPrompt,
+    // Native CLI backends own tool/MCP/skill delivery. API native-tool delivery
+    // also suppresses duplicate prompt schema sections.
+    nativeToolDelivery: cliBridgeOnly || toolDelivery?.strategy === "native" || toolDelivery?.strategy === "mcp",
+    sectionCap: sectionCapMax && sectionCapMax > 0 ? {
+      maxTokens: sectionCapMax,
+      estimator: backendTokenEstimator(nextBackend),
+      onOverflow: (info) => {
+        void emitEvent?.("bridge:warn", {
+          code: BRIDGE_WARNING_CODES.CONTEXT_SECTIONS_OVERFLOW,
+          message: `System-prompt sections totaled ${info.originalTokens} tokens; trimmed to ${info.finalTokens} (cap ${info.cap}). Trimmed sections: ${info.trimmed.map((t) => t.key).join(", ")}.`
+        });
+      }
+    } : void 0,
+    state: taskCapabilities.state,
+    systemPromptSuffix: toolDelivery?.systemPromptSuffix
+  });
+  const cachePrefix = systemPromptPayload.systemPromptParts ? analyzePromptCachePrefix(systemPromptPayload.systemPromptParts) : void 0;
+  if (cachePrefix?.hasUnstableCacheMarks && !context.options.suppressWarnings) {
+    await emitEvent?.("bridge:warn", {
+      code: BRIDGE_WARNING_CODES.CACHE_PREFIX_UNSTABLE,
+      message: "Cache-marked prompt parts appear after unmarked dynamic content; move cacheable system parts before dynamic/compacted context to keep the provider cache prefix stable."
+    });
+  }
+  return { taskCapabilities, systemPromptPayload, toolDelivery };
+}
+const PASSTHROUGH_DROPPED_FIELDS = [
+  "context",
+  "contextMiddleware",
+  "systemPromptParts",
+  "guardrails",
+  "plugins",
+  "actionBundles",
+  "tasks",
+  "userSystemPrompt"
+];
+function pickFields(source, keys) {
+  const out = {};
+  for (const key of keys) {
+    out[key] = source[key];
+  }
+  return out;
+}
+async function warnUnsupportedCliFeatures(backendName, params, emitEvent) {
+  if (!emitEvent || !isCliBackendCoveredByMatrix(backendName)) return;
+  const projected = {
+    prompt: "",
+    readOnly: params.readOnly,
+    appendSystemPrompt: params.appendSystemPrompt,
+    excludeDynamicSystemPromptSections: params.excludeDynamicSystemPromptSections,
+    effort: params.effort,
+    worktree: params.worktree,
+    allowedTools: params.allowedTools,
+    disallowedTools: params.disallowedTools,
+    mcpConfigPath: params.mcpConfigPath,
+    strictMcpConfig: params.strictMcpConfig,
+    outputSchema: params.outputSchema,
+    maxBudgetUsd: params.maxBudgetUsd,
+    cacheControl: params.cacheControl
+  };
+  const dropped = findUnsupportedRequestFields(
+    getDefaultCliFeatureMatrix(),
+    backendName,
+    projected
+  );
+  for (const { field, feature } of dropped) {
+    await emitEvent("bridge:warn", {
+      code: BRIDGE_WARNING_CODES.UNSUPPORTED_FEATURE_FOR_BACKEND,
+      message: `Field "${field}" (feature "${feature}") was set on the request but backend "${backendName}" does not honor it; it will be silently ignored. Run \`octoflow inspect ${backendName} --features\` to see the supported feature set.`
+    });
+  }
+}
+export {
+  prepareBackendRuntimeForTask
+};
+//# sourceMappingURL=task-runner-backend-runtime.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/task-runner-backend-runtime.ts"],
+  "sourcesContent": ["import {\n  findUnsupportedRequestFields,\n  getDefaultCliFeatureMatrix,\n  isCliBackendCoveredByMatrix,\n} from '../../adapters/agents/backends/cli-feature-matrix.js';\nimport type { ToolDeliveryResult } from '../../adapters/agents/tool-delivery.js';\nimport { buildBridgeSystemPromptPayload } from '../../capabilities/agent-context/compose.js';\nimport { backendTokenEstimator } from '../../capabilities/context-compaction.js';\nimport { isNativeCliRuntimeBackend } from '../../domain/backend-runtime.js';\nimport type { BridgeSendMessageParams } from '../../domain/bridge-api.js';\nimport type { BackendRunRequest } from '../../domain/contracts/backends.js';\nimport type { BackendName } from '../../domain/core-client.js';\nimport { analyzePromptCachePrefix } from '../../domain/prompt-cache.js';\nimport {\n  assertPolicyAllowed,\n  decidePolicy,\n  resolvePolicySubject,\n} from '../../policy/index.js';\nimport type { ContextState } from '../sessions/context-manager.js';\nimport { prepareTaskCapabilities } from './capability-runner.js';\nimport { emitPolicyDecision } from './policy-events.js';\nimport { applyAgentApprovalPolicy } from './task-runner-approval.js';\nimport { prepareToolDeliveryForTask } from './task-runner-context.js';\nimport type { TaskRunnerOptions } from './task-runner-types.js';\nimport { BRIDGE_WARNING_CODES } from './warnings.js';\n\nexport interface PreparedBackendRuntime {\n  taskCapabilities: Awaited<ReturnType<typeof prepareTaskCapabilities>>;\n  systemPromptPayload: Awaited<\n    ReturnType<typeof buildBridgeSystemPromptPayload>\n  >;\n}\n\nexport interface PrepareBackendRuntimeArgs {\n  context: ContextState;\n  emitEvent?: TaskRunnerOptions['emitEvent'];\n  nextBackend: BackendName;\n  opts: TaskRunnerOptions;\n  params: BridgeSendMessageParams;\n  taskId: string;\n  toolDelivery?: ToolDeliveryResult;\n}\n\nexport interface PreparedBackendRuntimeResult extends PreparedBackendRuntime {\n  toolDelivery?: ToolDeliveryResult;\n}\n\nfunction isDefaultBuiltinAction(action: {\n  metadata?: Record<string, unknown>;\n}): boolean {\n  return action.metadata?.octoflowDefaultBuiltin === true;\n}\n\nfunction filterDefaultBuiltinsForBackend<\n  T extends { metadata?: Record<string, unknown> },\n>(actions: T[], backend: BackendName): T[] {\n  if (!isNativeCliRuntimeBackend(backend)) return actions;\n  return actions.filter((action) => !isDefaultBuiltinAction(action));\n}\n\nexport async function prepareBackendRuntimeForTask(\n  args: PrepareBackendRuntimeArgs\n): Promise<PreparedBackendRuntimeResult> {\n  const { context, emitEvent, nextBackend, opts, params, taskId } = args;\n  const cliBridgeOnly = isNativeCliRuntimeBackend(nextBackend);\n  let toolDelivery = args.toolDelivery;\n  await toolDelivery?.cleanupTempConfig?.();\n  toolDelivery = undefined;\n\n  const subject = resolvePolicySubject(params.subject, opts.policySubject);\n  await assertPolicyAllowed(\n    opts.policy,\n    {\n      action: 'backend.use',\n      subject,\n      resource: {\n        kind: 'backend',\n        id: nextBackend,\n        backend: nextBackend,\n        tenant: context.tenant,\n      },\n      context: {\n        contextId: context.id,\n        taskId,\n        backend: nextBackend,\n        requestedTenant: context.tenant,\n      },\n    },\n    emitPolicyDecision(emitEvent)\n  );\n\n  const passthrough = params.passthrough === true;\n\n  const taskCapabilities = await prepareTaskCapabilities({\n    actionDefinitions:\n      passthrough || cliBridgeOnly ? [] : (opts.actionRegistry?.all() ?? []),\n    backend: nextBackend,\n    bridge: opts.bridge,\n    context,\n    params,\n    taskId,\n    passthrough: passthrough || cliBridgeOnly,\n  });\n  if (!cliBridgeOnly) {\n    const policyResults = await Promise.all(\n      taskCapabilities.actions.map(async (action) => {\n        const input = {\n          action: 'tool.deliver' as const,\n          subject,\n          resource: {\n            kind: 'tool' as const,\n            id: action.name,\n            name: action.name,\n            tags: action.tags,\n            tenant: context.tenant,\n            attributes: { executorType: action.executor.type },\n          },\n          context: {\n            contextId: context.id,\n            taskId,\n            backend: nextBackend,\n            requestedTenant: context.tenant,\n          },\n        };\n        const decision = await decidePolicy(opts.policy, input);\n        await emitPolicyDecision(emitEvent)?.({ input, decision });\n        return decision.effect === 'allow' ? action : null;\n      })\n    );\n    taskCapabilities.actions = policyResults.filter(\n      (a): a is (typeof taskCapabilities.actions)[number] => a !== null\n    );\n    taskCapabilities.actions = applyAgentApprovalPolicy(\n      taskCapabilities.actions,\n      opts,\n      params\n    );\n    taskCapabilities.actions = filterDefaultBuiltinsForBackend(\n      taskCapabilities.actions,\n      nextBackend\n    );\n  }\n\n  if (!context.options.suppressWarnings) {\n    await warnUnsupportedCliFeatures(nextBackend, params, emitEvent);\n  }\n\n  // Auto-enable agentLoop when actions are registered but no explicit decision\n  // was made. We compute the effective value here instead of mutating\n  // `context.options` in place, so this preparer remains a pure projection\n  // over its inputs.\n  const autoEnableAgentLoop =\n    !cliBridgeOnly &&\n    context.options.agentLoop === undefined &&\n    taskCapabilities.actions.length > 0;\n  const effectiveAgentLoop = autoEnableAgentLoop\n    ? ({ enabled: true, maxRounds: 10 } as const)\n    : context.options.agentLoop;\n  if (autoEnableAgentLoop) {\n    context.options.agentLoop = effectiveAgentLoop;\n    if (!context.options.suppressWarnings) {\n      await emitEvent?.('bridge:warn', {\n        code: BRIDGE_WARNING_CODES.AGENT_LOOP_AUTO_ENABLED,\n        message:\n          'agentLoop auto-enabled (maxRounds: 10) because actions are registered. Set agentLoop explicitly to suppress this warning.',\n      });\n    }\n  }\n\n  toolDelivery = cliBridgeOnly\n    ? undefined\n    : await prepareToolDeliveryForTask({\n        actions: taskCapabilities.actions,\n        backend: nextBackend,\n        context,\n        emitEvent,\n        params,\n        taskId,\n      });\n\n  const sectionCapMax =\n    params.maxSectionTokens ?? context.options.maxSectionTokens;\n  // Passthrough and native CLI sends MUST forward only caller-authored prompt\n  // context. CLI agents own their tools, MCP config, skills, and memory, so the\n  // core bridge stays a routing layer instead of prompt-injecting its harness.\n  // The drop is table-driven (`PASSTHROUGH_DROPPED_FIELDS`) so future context\n  // options auto-honor the invariant \u2014 adding a new field to `BridgeOptions`\n  // only needs the field name appended to the table.\n  const carry =\n    passthrough || cliBridgeOnly\n      ? ({} as Pick<typeof context.options, PassthroughDroppedField>)\n      : pickFields(context.options, PASSTHROUGH_DROPPED_FIELDS);\n  const systemPromptPayload = await buildBridgeSystemPromptPayload({\n    actions: taskCapabilities.actions,\n    agentLoop: passthrough || cliBridgeOnly ? undefined : effectiveAgentLoop,\n    baseSystemPrompt: passthrough\n      ? params.systemPrompt\n      : (params.systemPrompt ?? context.options.systemPrompt),\n    cache: context.options.cache,\n    cacheControl: params.cacheControl,\n    context: carry.context,\n    contextMiddleware: carry.contextMiddleware,\n    extraSystemPromptParts: carry.systemPromptParts,\n    guardrails: carry.guardrails,\n    plugins: carry.plugins,\n    skills: carry.actionBundles,\n    tasks: carry.tasks,\n    userSystemPrompt: carry.userSystemPrompt,\n    // Native CLI backends own tool/MCP/skill delivery. API native-tool delivery\n    // also suppresses duplicate prompt schema sections.\n    nativeToolDelivery:\n      cliBridgeOnly ||\n      toolDelivery?.strategy === 'native' ||\n      toolDelivery?.strategy === 'mcp',\n    sectionCap:\n      sectionCapMax && sectionCapMax > 0\n        ? {\n            maxTokens: sectionCapMax,\n            estimator: backendTokenEstimator(nextBackend),\n            onOverflow: (info) => {\n              void emitEvent?.('bridge:warn', {\n                code: BRIDGE_WARNING_CODES.CONTEXT_SECTIONS_OVERFLOW,\n                message:\n                  `System-prompt sections totaled ${info.originalTokens} tokens; ` +\n                  `trimmed to ${info.finalTokens} (cap ${info.cap}). ` +\n                  `Trimmed sections: ${info.trimmed.map((t) => t.key).join(', ')}.`,\n              });\n            },\n          }\n        : undefined,\n    state: taskCapabilities.state,\n    systemPromptSuffix: toolDelivery?.systemPromptSuffix,\n  });\n  const cachePrefix = systemPromptPayload.systemPromptParts\n    ? analyzePromptCachePrefix(systemPromptPayload.systemPromptParts)\n    : undefined;\n  if (\n    cachePrefix?.hasUnstableCacheMarks &&\n    !context.options.suppressWarnings\n  ) {\n    await emitEvent?.('bridge:warn', {\n      code: BRIDGE_WARNING_CODES.CACHE_PREFIX_UNSTABLE,\n      message:\n        'Cache-marked prompt parts appear after unmarked dynamic content; ' +\n        'move cacheable system parts before dynamic/compacted context to keep the provider cache prefix stable.',\n    });\n  }\n\n  return { taskCapabilities, systemPromptPayload, toolDelivery };\n}\n\n/**\n * Context-option fields that the gateway passthrough invariant must drop on\n * outbound `sendMessage`. Source-of-truth for the property test in\n * `gateway-passthrough-invariant.test.ts`.\n *\n * Adding a new field to `BridgeOptions` that should be suppressed under\n * passthrough? Append its name here and the invariant is preserved\n * automatically \u2014 no further changes to the preparer required.\n */\nconst PASSTHROUGH_DROPPED_FIELDS = [\n  'context',\n  'contextMiddleware',\n  'systemPromptParts',\n  'guardrails',\n  'plugins',\n  'actionBundles',\n  'tasks',\n  'userSystemPrompt',\n] as const;\ntype PassthroughDroppedField = (typeof PASSTHROUGH_DROPPED_FIELDS)[number];\n\nfunction pickFields<T extends object, K extends keyof T>(\n  source: T,\n  keys: readonly K[]\n): Pick<T, K> {\n  const out = {} as Pick<T, K>;\n  for (const key of keys) {\n    out[key] = source[key];\n  }\n  return out;\n}\n\n/**\n * Emits a single `bridge:warn` (`UNSUPPORTED_FEATURE_FOR_BACKEND`) for each\n * caller-supplied feature that the chosen CLI backend will silently drop.\n * No-op for non-CLI backends and for backends not covered by the matrix.\n */\nasync function warnUnsupportedCliFeatures(\n  backendName: string,\n  params: BridgeSendMessageParams,\n  emitEvent: TaskRunnerOptions['emitEvent'] | undefined\n): Promise<void> {\n  if (!emitEvent || !isCliBackendCoveredByMatrix(backendName)) return;\n\n  // Project the params subset relevant to the matrix into a synthetic\n  // BackendRunRequest. Only the fields the matrix consumes need to be set.\n  const projected: BackendRunRequest = {\n    prompt: '',\n    readOnly: params.readOnly,\n    appendSystemPrompt: params.appendSystemPrompt,\n    excludeDynamicSystemPromptSections:\n      params.excludeDynamicSystemPromptSections,\n    effort: params.effort,\n    worktree: params.worktree,\n    allowedTools: params.allowedTools,\n    disallowedTools: params.disallowedTools,\n    mcpConfigPath: params.mcpConfigPath,\n    strictMcpConfig: params.strictMcpConfig,\n    outputSchema: params.outputSchema,\n    maxBudgetUsd: params.maxBudgetUsd,\n    cacheControl: params.cacheControl,\n  };\n\n  const dropped = findUnsupportedRequestFields(\n    getDefaultCliFeatureMatrix(),\n    backendName,\n    projected\n  );\n  for (const { field, feature } of dropped) {\n    await emitEvent('bridge:warn', {\n      code: BRIDGE_WARNING_CODES.UNSUPPORTED_FEATURE_FOR_BACKEND,\n      message:\n        `Field \"${field}\" (feature \"${feature}\") was set on the request but ` +\n        `backend \"${backendName}\" does not honor it; it will be silently ignored. ` +\n        `Run \\`octoflow inspect ${backendName} --features\\` to see the supported feature set.`,\n    });\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,42 @@
+import type { ActionDefinition } from '../../actions/types.js';
+import { type ToolDeliveryResult } from '../../adapters/agents/tool-delivery.js';
+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 } from '../../domain/core-task.js';
+import type { ContextState } from '../sessions/context-manager.js';
+import type { TaskRunnerOptions } from './task-runner-types.js';
+/**
+ * Loads and optionally compacts the conversation history for a task before
+ * the loop starts. Centralises the history-strategy + compaction branch.
+ */
+export declare function prepareConversationHistory(options: {
+    backend: BackendName;
+    context: ContextState;
+    opts: TaskRunnerOptions;
+    params: BridgeSendMessageParams;
+    store: TaskStore;
+    task: {
+        contextId: string;
+        id: string;
+        tenant?: string;
+    };
+    userMessage: Message;
+}): Promise<{
+    conversationHistory: Message[];
+    prompt: string;
+}>;
+/**
+ * Merges explicit tool configs with the registered actions and prepares the
+ * per-backend delivery shape (native / prompt injection / MCP config).
+ * Emits `tool:degraded` / `tool:delivered` / `bridge:warn` events as needed.
+ */
+export declare function prepareToolDeliveryForTask(options: {
+    actions: ActionDefinition[];
+    backend: BackendName;
+    context: ContextState;
+    emitEvent?: TaskRunnerOptions['emitEvent'];
+    params: BridgeSendMessageParams;
+    taskId: string;
+}): Promise<ToolDeliveryResult | undefined>;
+//# sourceMappingURL=task-runner-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner-context.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/task-runner-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIzD,OAAO,KAAK,EAIV,YAAY,EACb,MAAM,gCAAgC,CAAC;AASxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAyEhE;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,uBAAuB,CAAC;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAoI9D;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,EAAE,uBAAuB,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CA8E1C"}

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

@@ -0,0 +1,247 @@
+import {
+  mergeToolConfigs,
+  prepareToolDelivery
+} from "../../adapters/agents/tool-delivery.js";
+import { compactHistoryWithInfo } from "../../capabilities/context-compaction.js";
+import { createMessage, textPart } from "../../utils/messages.js";
+import { transcriptTokens } from "../../utils/tokens.js";
+import { hasBackendSessionPersistence } from "../sessions/context-helpers.js";
+import { isApiBackend } from "../sessions/context-manager.js";
+import { messagePartsToPrompt } from "../sessions/conversation.js";
+import { resolveBackendOverrides } from "./config-bridge-helpers.js";
+import { resolveContextCompactionOptions } from "./context-compaction-resolution.js";
+import {
+  getConversationHistory,
+  resolveHistoryStrategy
+} from "./task-executor.js";
+import { BRIDGE_WARNING_CODES } from "./warnings.js";
+const DEFAULT_CHARS_PER_TOKEN = 4;
+function defaultTokenEstimator(text) {
+  return Math.ceil(text.length / DEFAULT_CHARS_PER_TOKEN);
+}
+function normalizeCompactionTriggers(trigger) {
+  if (trigger == null) return ["budget-exceeded"];
+  return typeof trigger === "string" ? [trigger] : Array.from(trigger);
+}
+function isSummaryEntry(entry) {
+  return entry.role === "assistant" && entry.content.startsWith("[Summary of previous ");
+}
+function isMetadataRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function historySourceFromMetadata(...metadataRecords) {
+  for (const metadata of metadataRecords) {
+    const source = metadata?.source;
+    if (source === "skill" || source === "action" || source === "user") {
+      return source;
+    }
+  }
+  return void 0;
+}
+function isSkillProtectedMetadata(...metadataRecords) {
+  return metadataRecords.some(
+    (metadata) => metadata?.skillProtected === true || metadata?.skill_protected === true
+  );
+}
+function historyEntryFromMessage(message) {
+  const metadata = message.metadata;
+  const nestedMeta = isMetadataRecord(metadata?.meta) ? metadata.meta : void 0;
+  const actionResultMeta = isMetadataRecord(metadata?.actionResultMeta) ? metadata.actionResultMeta : void 0;
+  const source = historySourceFromMetadata(
+    metadata,
+    nestedMeta,
+    actionResultMeta
+  );
+  const skillProtected = isSkillProtectedMetadata(metadata, nestedMeta, actionResultMeta) || source === "skill";
+  return {
+    role: message.role === "agent" ? "assistant" : "user",
+    content: messagePartsToPrompt(message.parts),
+    ...source ? { source } : {},
+    ...skillProtected ? { protected: true } : {}
+  };
+}
+async function prepareConversationHistory(options) {
+  const { backend, context, opts, params, store, task, userMessage } = options;
+  const prompt = messagePartsToPrompt(userMessage.parts);
+  const historyStrategy = resolveHistoryStrategy(
+    params.historyStrategy ?? context.options.historyStrategy,
+    { sessionPersistence: hasBackendSessionPersistence(backend) }
+  );
+  let conversationHistory = params.structuredHistory ? params.structuredHistory : await getConversationHistory(
+    store,
+    task.contextId,
+    task.tenant,
+    userMessage.messageId,
+    historyStrategy
+  );
+  const initialBackendOverrides = resolveBackendOverrides(
+    backend,
+    context.options.backends
+  );
+  const compactionModel = params.model ?? initialBackendOverrides.model ?? context.options.model;
+  const compactionOptions = isApiBackend(backend) ? resolveContextCompactionOptions(backend, context.options, compactionModel) : void 0;
+  if (compactionOptions) {
+    const historyEntries = conversationHistory.map(
+      historyEntryFromMessage
+    );
+    const estimator = compactionOptions.estimator ?? defaultTokenEstimator;
+    const promptTokenCount = estimator(prompt);
+    const preCompactTokenCount = transcriptTokens(historyEntries, estimator);
+    const compactionTriggers = normalizeCompactionTriggers(
+      compactionOptions.trigger
+    );
+    const forceCompaction = compactionTriggers.includes("task:created");
+    const shouldAttemptCompaction = forceCompaction || preCompactTokenCount + promptTokenCount > (compactionOptions.maxTokens ?? 0);
+    if (shouldAttemptCompaction) {
+      const summaryModel = compactionOptions.summaryModel ?? compactionModel ?? "";
+      const summaryClient = compactionOptions.summaryClient ?? compactionOptions.summaryClientFactory?.(summaryModel) ?? opts.summaryClientFactory?.(summaryModel);
+      const compactionStartInfo = {
+        backend,
+        contextId: context.id,
+        messageCount: historyEntries.length,
+        preCompactTokenCount,
+        promptTokenCount,
+        strategy: compactionOptions.strategy ?? "truncate",
+        taskId: task.id,
+        trigger: forceCompaction ? "task:created" : "budget-exceeded"
+      };
+      await compactionOptions.onCompactStart?.(compactionStartInfo);
+      await opts.emitEvent?.("task:compaction:start", compactionStartInfo);
+      let compactedResult;
+      try {
+        compactedResult = await compactHistoryWithInfo(
+          historyEntries,
+          prompt,
+          compactionOptions,
+          summaryClient,
+          true,
+          forceCompaction
+        );
+      } catch (error) {
+        if ((compactionOptions.strategy ?? "truncate") !== "summarize") {
+          throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        if (!context.options.suppressWarnings) {
+          await opts.emitEvent?.("bridge:warn", {
+            code: BRIDGE_WARNING_CODES.CONTEXT_SUMMARY_FAILED,
+            message: "Context summarization failed; falling back to truncate compaction: " + message
+          });
+        }
+        compactedResult = await compactHistoryWithInfo(
+          historyEntries,
+          prompt,
+          { ...compactionOptions, strategy: "truncate" },
+          void 0,
+          true,
+          forceCompaction
+        );
+      }
+      const compacted = compactedResult.history;
+      if (compactedResult.protectedOverflow) {
+        await opts.emitEvent?.(
+          "skill:protection:overflow",
+          compactedResult.protectedOverflow
+        );
+      }
+      const historyChanged = compacted.length !== historyEntries.length || compacted.some(
+        (entry, index) => entry.role !== historyEntries[index]?.role || entry.content !== historyEntries[index]?.content
+      );
+      if (historyChanged) {
+        conversationHistory = compacted.map(
+          (entry) => createMessage({
+            role: entry.role === "assistant" ? "agent" : "user",
+            parts: [textPart(entry.content)],
+            stamp: false
+          })
+        );
+      }
+      const compactionEndInfo = {
+        ...compactionStartInfo,
+        compacted: historyChanged,
+        messagesRemoved: Math.max(0, historyEntries.length - compacted.length),
+        postCompactTokenCount: transcriptTokens(compacted, estimator),
+        summaryGenerated: compacted.some(isSummaryEntry)
+      };
+      await compactionOptions.onCompactEnd?.(compactionEndInfo);
+      await opts.emitEvent?.("task:compaction:end", compactionEndInfo);
+      await opts.emitEvent?.("agent:compaction", compactionEndInfo);
+    }
+  }
+  return { conversationHistory, prompt };
+}
+async function prepareToolDeliveryForTask(options) {
+  const { actions, backend, context, emitEvent, params, taskId } = options;
+  const initialBackendOverrides = resolveBackendOverrides(
+    backend,
+    context.options.backends
+  );
+  let mergedTools = mergeToolConfigs(context.options.bridgeTools, params.tools);
+  const actionToolNames = actions.map((action) => action.name);
+  if (actions.length > 0) {
+    const actionDefs = actions.map((action) => ({
+      name: action.name,
+      description: action.description,
+      parameters: action.parameters
+    }));
+    const existing = mergedTools?.definitions ?? [];
+    const existingNames = new Set(existing.map((d) => d.name));
+    const newDefs = actionDefs.filter((d) => !existingNames.has(d.name));
+    mergedTools = { ...mergedTools, definitions: [...existing, ...newDefs] };
+  }
+  if (actions.length > 0 && !isApiBackend(backend)) {
+    await emitEvent?.("tool:degraded", {
+      taskId,
+      contextId: context.id,
+      backend,
+      reason: "Backend does not support native tool delivery; using prompt injection",
+      tools: actionToolNames
+    });
+  }
+  if (!mergedTools) return void 0;
+  const toolDelivery = await prepareToolDelivery(
+    mergedTools,
+    backend,
+    params.mcpConfigPath ?? initialBackendOverrides.mcpConfigPath ?? context.options.mcpConfigPath
+  );
+  if ((toolDelivery.droppedServerNames?.length ?? 0) > 0) {
+    await emitEvent?.("tool:degraded", {
+      taskId,
+      contextId: context.id,
+      backend,
+      reason: "MCP servers not supported on API backends",
+      tools: toolDelivery.droppedServerNames ?? []
+    });
+    if (!context.options.suppressWarnings) {
+      await emitEvent?.("bridge:warn", {
+        code: BRIDGE_WARNING_CODES.MCP_SERVERS_DROPPED,
+        message: `MCP servers in tools.servers were dropped for API backend "${backend}": ${(toolDelivery.droppedServerNames ?? []).join(", ")}. Use a CLI backend or wait for native MCP support.`
+      });
+    }
+  }
+  if (toolDelivery.toolNames.length > 0 || toolDelivery.mcpConfigPath) {
+    if (toolDelivery.strategy === "prompt-injection") {
+      await emitEvent?.("tool:degraded", {
+        taskId,
+        contextId: context.id,
+        backend,
+        reason: "Backend does not support native tool delivery; using prompt injection",
+        tools: toolDelivery.toolNames
+      });
+    } else {
+      await emitEvent?.("tool:delivered", {
+        taskId,
+        contextId: context.id,
+        backend,
+        strategy: toolDelivery.strategy,
+        toolCount: toolDelivery.toolNames.length
+      });
+    }
+  }
+  return toolDelivery;
+}
+export {
+  prepareConversationHistory,
+  prepareToolDeliveryForTask
+};
+//# sourceMappingURL=task-runner-context.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/task-runner-context.ts"],
+  "sourcesContent": ["import type { ActionDefinition } from '../../actions/types.js';\nimport {\n  mergeToolConfigs,\n  prepareToolDelivery,\n  type ToolDeliveryResult,\n} from '../../adapters/agents/tool-delivery.js';\nimport type { TaskStore } from '../../adapters/data/task-store/index.js';\nimport type {\n  CompactHistoryResult,\n  HistoryEntry,\n} from '../../capabilities/context-compaction.js';\nimport { compactHistoryWithInfo } from '../../capabilities/context-compaction.js';\nimport type { BridgeSendMessageParams } from '../../domain/bridge-api.js';\nimport type { BackendName } from '../../domain/core-client.js';\nimport type { Message } from '../../domain/core-task.js';\nimport { createMessage, textPart } from '../../utils/messages.js';\nimport { transcriptTokens } from '../../utils/tokens.js';\nimport { hasBackendSessionPersistence } from '../sessions/context-helpers.js';\nimport type {\n  ContextCompactionEndInfo,\n  ContextCompactionStartInfo,\n  ContextCompactionTrigger,\n  ContextState,\n} from '../sessions/context-manager.js';\nimport { isApiBackend } from '../sessions/context-manager.js';\nimport { messagePartsToPrompt } from '../sessions/conversation.js';\nimport { resolveBackendOverrides } from './config-bridge-helpers.js';\nimport { resolveContextCompactionOptions } from './context-compaction-resolution.js';\nimport {\n  getConversationHistory,\n  resolveHistoryStrategy,\n} from './task-executor.js';\nimport type { TaskRunnerOptions } from './task-runner-types.js';\nimport { BRIDGE_WARNING_CODES } from './warnings.js';\n\nconst DEFAULT_CHARS_PER_TOKEN = 4;\n\nfunction defaultTokenEstimator(text: string): number {\n  return Math.ceil(text.length / DEFAULT_CHARS_PER_TOKEN);\n}\n\nfunction normalizeCompactionTriggers(\n  trigger?: ContextCompactionTrigger | readonly ContextCompactionTrigger[]\n): ContextCompactionTrigger[] {\n  if (trigger == null) return ['budget-exceeded'];\n  return typeof trigger === 'string' ? [trigger] : Array.from(trigger);\n}\n\nfunction isSummaryEntry(entry: HistoryEntry): boolean {\n  return (\n    entry.role === 'assistant' &&\n    entry.content.startsWith('[Summary of previous ')\n  );\n}\n\nfunction isMetadataRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction historySourceFromMetadata(\n  ...metadataRecords: Array<Record<string, unknown> | undefined>\n): HistoryEntry['source'] | undefined {\n  for (const metadata of metadataRecords) {\n    const source = metadata?.source;\n    if (source === 'skill' || source === 'action' || source === 'user') {\n      return source;\n    }\n  }\n  return undefined;\n}\n\nfunction isSkillProtectedMetadata(\n  ...metadataRecords: Array<Record<string, unknown> | undefined>\n): boolean {\n  return metadataRecords.some(\n    (metadata) =>\n      metadata?.skillProtected === true || metadata?.skill_protected === true\n  );\n}\n\nfunction historyEntryFromMessage(message: Message): HistoryEntry {\n  const metadata = message.metadata;\n  const nestedMeta = isMetadataRecord(metadata?.meta)\n    ? metadata.meta\n    : undefined;\n  const actionResultMeta = isMetadataRecord(metadata?.actionResultMeta)\n    ? metadata.actionResultMeta\n    : undefined;\n  const source = historySourceFromMetadata(\n    metadata,\n    nestedMeta,\n    actionResultMeta\n  );\n  const skillProtected =\n    isSkillProtectedMetadata(metadata, nestedMeta, actionResultMeta) ||\n    source === 'skill';\n\n  return {\n    role: message.role === 'agent' ? ('assistant' as const) : ('user' as const),\n    content: messagePartsToPrompt(message.parts),\n    ...(source ? { source } : {}),\n    ...(skillProtected ? { protected: true } : {}),\n  };\n}\n\n/**\n * Loads and optionally compacts the conversation history for a task before\n * the loop starts. Centralises the history-strategy + compaction branch.\n */\nexport async function prepareConversationHistory(options: {\n  backend: BackendName;\n  context: ContextState;\n  opts: TaskRunnerOptions;\n  params: BridgeSendMessageParams;\n  store: TaskStore;\n  task: { contextId: string; id: string; tenant?: string };\n  userMessage: Message;\n}): Promise<{ conversationHistory: Message[]; prompt: string }> {\n  const { backend, context, opts, params, store, task, userMessage } = options;\n  const prompt = messagePartsToPrompt(userMessage.parts);\n  const historyStrategy = resolveHistoryStrategy(\n    params.historyStrategy ?? context.options.historyStrategy,\n    { sessionPersistence: hasBackendSessionPersistence(backend) }\n  );\n  let conversationHistory = params.structuredHistory\n    ? params.structuredHistory\n    : await getConversationHistory(\n        store,\n        task.contextId,\n        task.tenant,\n        userMessage.messageId,\n        historyStrategy\n      );\n\n  const initialBackendOverrides = resolveBackendOverrides(\n    backend,\n    context.options.backends\n  );\n  const compactionModel =\n    params.model ?? initialBackendOverrides.model ?? context.options.model;\n  const compactionOptions = isApiBackend(backend)\n    ? resolveContextCompactionOptions(backend, context.options, compactionModel)\n    : undefined;\n\n  if (compactionOptions) {\n    const historyEntries: HistoryEntry[] = conversationHistory.map(\n      historyEntryFromMessage\n    );\n    const estimator = compactionOptions.estimator ?? defaultTokenEstimator;\n    const promptTokenCount = estimator(prompt);\n    const preCompactTokenCount = transcriptTokens(historyEntries, estimator);\n    const compactionTriggers = normalizeCompactionTriggers(\n      compactionOptions.trigger\n    );\n    const forceCompaction = compactionTriggers.includes('task:created');\n    const shouldAttemptCompaction =\n      forceCompaction ||\n      preCompactTokenCount + promptTokenCount >\n        (compactionOptions.maxTokens ?? 0);\n    if (shouldAttemptCompaction) {\n      const summaryModel =\n        compactionOptions.summaryModel ?? compactionModel ?? '';\n      const summaryClient =\n        compactionOptions.summaryClient ??\n        compactionOptions.summaryClientFactory?.(summaryModel) ??\n        opts.summaryClientFactory?.(summaryModel);\n      const compactionStartInfo: ContextCompactionStartInfo = {\n        backend,\n        contextId: context.id,\n        messageCount: historyEntries.length,\n        preCompactTokenCount,\n        promptTokenCount,\n        strategy: compactionOptions.strategy ?? 'truncate',\n        taskId: task.id,\n        trigger: forceCompaction ? 'task:created' : 'budget-exceeded',\n      };\n      await compactionOptions.onCompactStart?.(compactionStartInfo);\n      await opts.emitEvent?.('task:compaction:start', compactionStartInfo);\n\n      let compactedResult: CompactHistoryResult;\n      try {\n        compactedResult = await compactHistoryWithInfo(\n          historyEntries,\n          prompt,\n          compactionOptions,\n          summaryClient,\n          true,\n          forceCompaction\n        );\n      } catch (error) {\n        if ((compactionOptions.strategy ?? 'truncate') !== 'summarize') {\n          throw error;\n        }\n        const message = error instanceof Error ? error.message : String(error);\n        if (!context.options.suppressWarnings) {\n          await opts.emitEvent?.('bridge:warn', {\n            code: BRIDGE_WARNING_CODES.CONTEXT_SUMMARY_FAILED,\n            message:\n              'Context summarization failed; falling back to truncate compaction: ' +\n              message,\n          });\n        }\n        compactedResult = await compactHistoryWithInfo(\n          historyEntries,\n          prompt,\n          { ...compactionOptions, strategy: 'truncate' },\n          undefined,\n          true,\n          forceCompaction\n        );\n      }\n      const compacted = compactedResult.history;\n      if (compactedResult.protectedOverflow) {\n        await opts.emitEvent?.(\n          'skill:protection:overflow',\n          compactedResult.protectedOverflow\n        );\n      }\n      const historyChanged =\n        compacted.length !== historyEntries.length ||\n        compacted.some(\n          (entry, index) =>\n            entry.role !== historyEntries[index]?.role ||\n            entry.content !== historyEntries[index]?.content\n        );\n      if (historyChanged) {\n        conversationHistory = compacted.map((entry) =>\n          createMessage({\n            role: entry.role === 'assistant' ? 'agent' : 'user',\n            parts: [textPart(entry.content)],\n            stamp: false,\n          })\n        );\n      }\n\n      const compactionEndInfo: ContextCompactionEndInfo = {\n        ...compactionStartInfo,\n        compacted: historyChanged,\n        messagesRemoved: Math.max(0, historyEntries.length - compacted.length),\n        postCompactTokenCount: transcriptTokens(compacted, estimator),\n        summaryGenerated: compacted.some(isSummaryEntry),\n      };\n      await compactionOptions.onCompactEnd?.(compactionEndInfo);\n      await opts.emitEvent?.('task:compaction:end', compactionEndInfo);\n      await opts.emitEvent?.('agent:compaction', compactionEndInfo);\n    }\n  }\n\n  return { conversationHistory, prompt };\n}\n\n/**\n * Merges explicit tool configs with the registered actions and prepares the\n * per-backend delivery shape (native / prompt injection / MCP config).\n * Emits `tool:degraded` / `tool:delivered` / `bridge:warn` events as needed.\n */\nexport async function prepareToolDeliveryForTask(options: {\n  actions: ActionDefinition[];\n  backend: BackendName;\n  context: ContextState;\n  emitEvent?: TaskRunnerOptions['emitEvent'];\n  params: BridgeSendMessageParams;\n  taskId: string;\n}): Promise<ToolDeliveryResult | undefined> {\n  const { actions, backend, context, emitEvent, params, taskId } = options;\n  const initialBackendOverrides = resolveBackendOverrides(\n    backend,\n    context.options.backends\n  );\n  let mergedTools = mergeToolConfigs(context.options.bridgeTools, params.tools);\n  const actionToolNames = actions.map((action) => action.name);\n  // Merge remaining action definitions into tool config so they reach the LLM:\n  // API backends receive native schemas; CLI backends receive explicit/custom\n  // actions via prompt injection. Default built-ins are filtered before this\n  // point for CLI backends so native CLI tools stay authoritative.\n  if (actions.length > 0) {\n    const actionDefs = actions.map((action) => ({\n      name: action.name,\n      description: action.description,\n      parameters: action.parameters,\n    }));\n    const existing = mergedTools?.definitions ?? [];\n    const existingNames = new Set(existing.map((d) => d.name));\n    const newDefs = actionDefs.filter((d) => !existingNames.has(d.name));\n    mergedTools = { ...mergedTools, definitions: [...existing, ...newDefs] };\n  }\n  if (actions.length > 0 && !isApiBackend(backend)) {\n    await emitEvent?.('tool:degraded', {\n      taskId,\n      contextId: context.id,\n      backend,\n      reason:\n        'Backend does not support native tool delivery; using prompt injection',\n      tools: actionToolNames,\n    });\n  }\n  if (!mergedTools) return undefined;\n\n  const toolDelivery = await prepareToolDelivery(\n    mergedTools,\n    backend,\n    params.mcpConfigPath ??\n      initialBackendOverrides.mcpConfigPath ??\n      context.options.mcpConfigPath\n  );\n  if ((toolDelivery.droppedServerNames?.length ?? 0) > 0) {\n    await emitEvent?.('tool:degraded', {\n      taskId,\n      contextId: context.id,\n      backend,\n      reason: 'MCP servers not supported on API backends',\n      tools: toolDelivery.droppedServerNames ?? [],\n    });\n    if (!context.options.suppressWarnings) {\n      await emitEvent?.('bridge:warn', {\n        code: BRIDGE_WARNING_CODES.MCP_SERVERS_DROPPED,\n        message: `MCP servers in tools.servers were dropped for API backend \"${backend}\": ${(toolDelivery.droppedServerNames ?? []).join(', ')}. Use a CLI backend or wait for native MCP support.`,\n      });\n    }\n  }\n  if (toolDelivery.toolNames.length > 0 || toolDelivery.mcpConfigPath) {\n    if (toolDelivery.strategy === 'prompt-injection') {\n      await emitEvent?.('tool:degraded', {\n        taskId,\n        contextId: context.id,\n        backend,\n        reason:\n          'Backend does not support native tool delivery; using prompt injection',\n        tools: toolDelivery.toolNames,\n      });\n    } else {\n      await emitEvent?.('tool:delivered', {\n        taskId,\n        contextId: context.id,\n        backend,\n        strategy: toolDelivery.strategy,\n        toolCount: toolDelivery.toolNames.length,\n      });\n    }\n  }\n  return toolDelivery;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,23 @@
+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 } from '../../domain/core-task.js';
+import type { ContextState, SessionLike } from '../sessions/context-manager.js';
+import { type TaskExecutorDeps } from './task-executor.js';
+import type { TaskRunnerOptions } from './task-runner-types.js';
+interface ExecuteQueuedTaskParams {
+    context: ContextState;
+    taskId: string;
+    userMessage: Message;
+    params: BridgeSendMessageParams;
+    backend: BackendName;
+    store: TaskStore;
+    getSessionFn: (context: ContextState) => Promise<SessionLike>;
+    opts: TaskRunnerOptions;
+    deps: TaskExecutorDeps;
+    emitEvent?: TaskRunnerOptions['emitEvent'];
+    waitForApproval: (approvalId: string) => Promise<boolean>;
+}
+export declare function executeQueuedTask({ context, taskId, userMessage, params, backend: initialBackend, store, getSessionFn, opts, deps, emitEvent, waitForApproval, }: ExecuteQueuedTaskParams): Promise<void>;
+export {};
+//# sourceMappingURL=task-runner-execution.d.ts.map