octoflow-core 1.0.0

package/dist/runtime/sessions/conversation.js

@@ -0,0 +1,104 @@
+const HISTORY_HEADER = [
+  "[Conversation History]",
+  "Continue the same conversation using this transcript as prior context.",
+  "Do not restate the transcript unless the user asks for it."
+].join("\n");
+const USER_HEADER = "\n\n[New User Message]\n";
+class ConversationSession {
+  constructor(mode, runner, options = {}) {
+    this.mode = mode;
+    this.runner = runner;
+    this.structuredHistoryNative = Boolean(options.structuredHistoryNative);
+  }
+  mode;
+  runner;
+  established = false;
+  structuredHistoryNative;
+  async send(prompt, opts = {}) {
+    const {
+      conversationHistory,
+      goal,
+      injectGoalContext,
+      project,
+      ...runOptions
+    } = opts;
+    if (injectGoalContext && (goal || project)) {
+      const goalBlock = buildGoalContextBlock(goal, project);
+      if (goalBlock) prompt = `${goalBlock}
+
+${prompt}`;
+    }
+    const history = conversationHistory ?? [];
+    const transcript = normalizeConversationHistory(history);
+    const shouldReplay = this.mode === "always-replay" ? transcript.length > 0 : !this.established && transcript.length > 0;
+    const structuredHistory = shouldReplay ? transcript.map((t) => ({ role: t.role, content: t.text })) : [];
+    const needsTextReplay = shouldReplay && !this.structuredHistoryNative;
+    const result = await this.runner(
+      needsTextReplay ? buildConversationReplayPrompt(transcript, prompt) : prompt,
+      {
+        ...runOptions,
+        ...shouldReplay ? { structuredHistory } : {}
+      }
+    );
+    if (this.mode === "seed-once") {
+      this.established = true;
+    }
+    return result;
+  }
+}
+function messagePartsToPrompt(parts) {
+  if (!parts || parts.length === 0) return "";
+  return parts.map((part) => {
+    if (part.kind === "text") return part.text;
+    if (part.kind === "data") return JSON.stringify(part.data);
+    if (part.kind === "tool_call") {
+      const input = typeof part.input === "string" ? part.input : JSON.stringify(part.input ?? {});
+      return `[tool_call:${part.name}(${input})]`;
+    }
+    if (part.kind === "tool_result") {
+      const output = typeof part.output === "string" ? part.output : JSON.stringify(part.output);
+      return `[tool_result:${output}]`;
+    }
+    const label = part.file.name ?? part.file.uri ?? "attachment";
+    return `[file:${label}]`;
+  }).join("\n");
+}
+function buildConversationReplayPrompt(history, prompt) {
+  const transcript = history.map(
+    (turn) => `${turn.role === "assistant" ? "Assistant" : "User"}:
+${turn.text}`
+  ).join("\n\n");
+  return `${HISTORY_HEADER}
+
+${transcript}${USER_HEADER}${prompt}`;
+}
+function normalizeConversationHistory(history) {
+  return history.map((message) => ({
+    role: message.role === "agent" ? "assistant" : "user",
+    text: messagePartsToPrompt(message.parts).trim()
+  })).filter((turn) => turn.text.length > 0);
+}
+function buildGoalContextBlock(goal, project) {
+  const parts = [];
+  if (project) {
+    parts.push(
+      `[Project: ${project.name}${project.description ? ` \u2014 ${project.description}` : ""}]`
+    );
+  }
+  if (goal) {
+    const chain = [];
+    let current = goal;
+    while (current) {
+      chain.unshift(current.description);
+      current = current.parent;
+    }
+    parts.push(`[Goal: ${chain.join(" > ")}]`);
+  }
+  return parts.join("\n");
+}
+export {
+  ConversationSession,
+  buildGoalContextBlock,
+  messagePartsToPrompt
+};
+//# sourceMappingURL=conversation.js.map

package/dist/runtime/sessions/conversation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/sessions/conversation.ts"],
+  "sourcesContent": ["import type { BackendRunOptions } from '../../adapters/agents/internal-run-options.js';\nimport type { AgentEvent, RunResult } from '../../domain/core-client.js';\nimport type {\n  GoalRef,\n  Message,\n  Part,\n  ProjectRef,\n} from '../../domain/core-task.js';\n\nexport interface ConversationSendOptions extends BackendRunOptions {\n  conversationHistory?: Message[];\n  goal?: GoalRef;\n  injectGoalContext?: boolean;\n  onEvent?: (event: AgentEvent) => void | Promise<void>;\n  project?: ProjectRef;\n}\n\ntype ConversationMode = 'always-replay' | 'seed-once';\ntype StructuredHistoryEntry = { role: 'user' | 'assistant'; content: string };\ntype SessionRunner = (\n  prompt: string,\n  opts?: Omit<ConversationSendOptions, 'conversationHistory'> & {\n    structuredHistory?: StructuredHistoryEntry[];\n  }\n) => Promise<RunResult>;\n\n/**\n * Options for a ConversationSession. `structuredHistoryNative` signals that\n * the underlying backend consumes a native `messages[]` array, so\n * the text-stuffed replay prompt is redundant and should be dropped \u2014 this\n * kills the double-send waste for Anthropic/OpenAI/Ollama/Vercel.\n */\ninterface ConversationSessionOptions {\n  structuredHistoryNative?: boolean;\n}\n\ninterface SessionTurn {\n  role: 'assistant' | 'user';\n  text: string;\n}\n\nconst HISTORY_HEADER = [\n  '[Conversation History]',\n  'Continue the same conversation using this transcript as prior context.',\n  'Do not restate the transcript unless the user asks for it.',\n].join('\\n');\nconst USER_HEADER = '\\n\\n[New User Message]\\n';\n\nexport class ConversationSession {\n  private established = false;\n  private readonly structuredHistoryNative: boolean;\n\n  constructor(\n    private readonly mode: ConversationMode,\n    private readonly runner: SessionRunner,\n    options: ConversationSessionOptions = {}\n  ) {\n    this.structuredHistoryNative = Boolean(options.structuredHistoryNative);\n  }\n\n  async send(\n    prompt: string,\n    opts: ConversationSendOptions = {}\n  ): Promise<RunResult> {\n    const {\n      conversationHistory,\n      goal,\n      injectGoalContext,\n      project,\n      ...runOptions\n    } = opts;\n\n    if (injectGoalContext && (goal || project)) {\n      const goalBlock = buildGoalContextBlock(goal, project);\n      if (goalBlock) prompt = `${goalBlock}\\n\\n${prompt}`;\n    }\n\n    const history = conversationHistory ?? [];\n    const transcript = normalizeConversationHistory(history);\n    const shouldReplay =\n      this.mode === 'always-replay'\n        ? transcript.length > 0\n        : !this.established && transcript.length > 0;\n\n    const structuredHistory: StructuredHistoryEntry[] = shouldReplay\n      ? transcript.map((t) => ({ role: t.role, content: t.text }))\n      : [];\n\n    // when the backend consumes native structured messages, skip the\n    // text-stuffed replay prompt \u2014 it would double-bill every turn.\n    const needsTextReplay = shouldReplay && !this.structuredHistoryNative;\n\n    const result = await this.runner(\n      needsTextReplay\n        ? buildConversationReplayPrompt(transcript, prompt)\n        : prompt,\n      {\n        ...runOptions,\n        ...(shouldReplay ? { structuredHistory } : {}),\n      }\n    );\n\n    if (this.mode === 'seed-once') {\n      this.established = true;\n    }\n\n    return result;\n  }\n}\n\nexport function messagePartsToPrompt(parts: Part[] | undefined): string {\n  if (!parts || parts.length === 0) return '';\n  return parts\n    .map((part) => {\n      if (part.kind === 'text') return part.text;\n      if (part.kind === 'data') return JSON.stringify(part.data);\n      if (part.kind === 'tool_call') {\n        const input =\n          typeof part.input === 'string'\n            ? part.input\n            : JSON.stringify(part.input ?? {});\n        return `[tool_call:${part.name}(${input})]`;\n      }\n      if (part.kind === 'tool_result') {\n        const output =\n          typeof part.output === 'string'\n            ? part.output\n            : JSON.stringify(part.output);\n        return `[tool_result:${output}]`;\n      }\n      const label = part.file.name ?? part.file.uri ?? 'attachment';\n      return `[file:${label}]`;\n    })\n    .join('\\n');\n}\n\nfunction buildConversationReplayPrompt(\n  history: SessionTurn[],\n  prompt: string\n): string {\n  const transcript = history\n    .map(\n      (turn) =>\n        `${turn.role === 'assistant' ? 'Assistant' : 'User'}:\\n${turn.text}`\n    )\n    .join('\\n\\n');\n\n  return `${HISTORY_HEADER}\\n\\n${transcript}${USER_HEADER}${prompt}`;\n}\n\nfunction normalizeConversationHistory(history: Message[]): SessionTurn[] {\n  return history\n    .map((message) => ({\n      role:\n        message.role === 'agent' ? ('assistant' as const) : ('user' as const),\n      text: messagePartsToPrompt(message.parts).trim(),\n    }))\n    .filter((turn) => turn.text.length > 0);\n}\n\nexport function buildGoalContextBlock(\n  goal?: GoalRef,\n  project?: ProjectRef\n): string {\n  const parts: string[] = [];\n  if (project) {\n    parts.push(\n      `[Project: ${project.name}${project.description ? ` \u2014 ${project.description}` : ''}]`\n    );\n  }\n  if (goal) {\n    const chain: string[] = [];\n    let current: GoalRef | undefined = goal;\n    while (current) {\n      chain.unshift(current.description);\n      current = current.parent;\n    }\n    parts.push(`[Goal: ${chain.join(' > ')}]`);\n  }\n  return parts.join('\\n');\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/sessions/local-context-types.d.ts

@@ -0,0 +1,35 @@
+export type LocalContextVendorId = 'claude-code' | 'claude-desktop' | 'cursor' | 'vscode' | 'copilot' | 'codex' | 'gemini' | 'windsurf' | 'zed' | 'opencode' | 'continue' | 'goose' | 'amp' | 'crush' | 'roo-code' | 'kilo-code' | 'junie' | 'cline' | 'qwen-code' | 'trae' | 'octoflow';
+export interface LocalContextOptions {
+    vendors?: LocalContextVendorId[];
+    excludeVendors?: LocalContextVendorId[];
+    scopes?: Array<'project' | 'user'>;
+    cwd?: string;
+    mergePriority?: 'explicit-first' | 'local-first';
+    /** Auto-discover MCP servers. Default true. */
+    mcp?: boolean;
+    /** Auto-discover skills. Default true. */
+    skills?: boolean;
+    /**
+     * Skip vendors whose harness is currently wrapping the bridge process.
+     * - false  : no harness filtering (default)
+     * - 'auto' : detect via process.env using verified markers only
+     * - true   : alias for 'auto'
+     * - string[] : explicit vendor list (unlocks unverified markers)
+     */
+    ignoreHarness?: boolean | 'auto' | LocalContextVendorId[];
+    /** Per-kind override when a harness match fires. Default both true. */
+    ignoreHarnessKinds?: {
+        mcp?: boolean;
+        skills?: boolean;
+    };
+    /** Injection point: replace the scoped TOML parser with a full one. */
+    tomlParser?: (raw: string) => Record<string, unknown>;
+    /** Injection point: replace the scoped YAML parser with a full one. */
+    yamlParser?: (raw: string) => unknown;
+    /** Injection point: replace the scoped frontmatter parser with a full one. */
+    frontmatterParser?: (raw: string) => {
+        data: Record<string, unknown>;
+        body: string;
+    };
+}
+//# sourceMappingURL=local-context-types.d.ts.map

package/dist/runtime/sessions/local-context-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-context-types.d.ts","sourceRoot":"","sources":["../../../src/runtime/sessions/local-context-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,aAAa,GACb,gBAAgB,GAChB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,UAAU,GACV,KAAK,GACL,UAAU,GACV,UAAU,GACV,OAAO,GACP,KAAK,GACL,OAAO,GACP,UAAU,GACV,WAAW,GACX,OAAO,GACP,OAAO,GACP,WAAW,GACX,MAAM,GACN,UAAU,CAAC;AAEf,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAAC;IACjD,+CAA+C;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,oBAAoB,EAAE,CAAC;IAC1D,uEAAuE;IACvE,kBAAkB,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzD,uEAAuE;IACvE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,uEAAuE;IACvE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}

package/dist/runtime/sessions/local-context-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=local-context-types.js.map

package/dist/runtime/sessions/local-context-types.js.map

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

package/dist/runtime/sessions/resolver.d.ts

@@ -0,0 +1,24 @@
+import type { BackendName } from '../../domain/core-client.js';
+import type { ContextState, SessionLike } from './context-types.js';
+/**
+ * Resolve a session for a context, caching the promise so concurrent callers
+ * share a single in-flight resolution. On failure the cached promise is cleared
+ * so the next caller gets a fresh attempt.
+ */
+export declare function resolveSession(context: ContextState): Promise<SessionLike>;
+/**
+ * Attempt to switch a context to a different backend by exclusion list.
+ * Returns the new backend + session, or null if no alternative is available.
+ */
+export declare function switchBackend(context: ContextState, excludedBackends: BackendName[], getSession: (ctx: ContextState) => Promise<SessionLike>): Promise<{
+    backend: BackendName;
+    session: SessionLike;
+} | null>;
+/**
+ * Attempt to switch a context to a specific target backend.
+ */
+export declare function switchToBackend(context: ContextState, targetBackend: BackendName, getSession: (ctx: ContextState) => Promise<SessionLike>): Promise<{
+    backend: BackendName;
+    session: SessionLike;
+} | null>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/runtime/sessions/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/runtime/sessions/resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,WAAW,EAIZ,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAqEpE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAU1E;AA0CD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,gBAAgB,EAAE,WAAW,EAAE,EAC/B,UAAU,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,GACtD,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAAC,CAyBhE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,WAAW,EAC1B,UAAU,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,GACtD,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAAC,CAGhE"}

package/dist/runtime/sessions/resolver.js

@@ -0,0 +1,104 @@
+import { selectBackendClient } from "../../adapters/agents/selection.js";
+import { isApiBackend } from "./context-helpers.js";
+import { ConversationSession } from "./conversation.js";
+function backendConsumesStructuredHistory(backend) {
+  return backend === "anthropic-api" || backend === "openai-api" || backend === "ollama" || backend === "custom-api" || backend.startsWith("vercel-ai:");
+}
+function buildSession(backend, client, context) {
+  const defaultOptions = {
+    model: context.options.model,
+    maxOutputTokens: context.options.maxOutputTokens,
+    systemPrompt: context.options.systemPrompt,
+    cwd: context.policy.workspace,
+    profile: context.policy.profile,
+    approvalMode: context.policy.approvalMode,
+    timeoutMs: context.options.timeoutMs,
+    mcpConfigPath: context.options.mcpConfigPath,
+    retries: context.options.retries,
+    resumeFrom: context.cliSessionId
+  };
+  if (requiresPromptReplay(backend)) {
+    return new ConversationSession(
+      "always-replay",
+      (prompt, opts) => {
+        if (opts?.onEvent) {
+          return client.stream(prompt, opts.onEvent, opts);
+        }
+        return client.run(prompt, opts);
+      },
+      { structuredHistoryNative: backendConsumesStructuredHistory(backend) }
+    );
+  }
+  const session = client.session(defaultOptions);
+  return new ConversationSession(
+    "seed-once",
+    (prompt, opts) => session.send(prompt, opts),
+    { structuredHistoryNative: backendConsumesStructuredHistory(backend) }
+  );
+}
+function resolveSession(context) {
+  if (!context.sessionPromise) {
+    context.sessionPromise = context.selectionPromise.then(({ backend, client }) => buildSession(backend, client, context)).catch((err) => {
+      context.sessionPromise = void 0;
+      throw err;
+    });
+  }
+  return context.sessionPromise;
+}
+async function _doSwitchBackend(context, nextPriority, getSession) {
+  const previousSelectionPromise = context.selectionPromise;
+  const previousSessionPromise = context.sessionPromise;
+  const previousCliSessionId = context.cliSessionId;
+  const nextSelectionPromise = selectBackendClient({
+    ...context.options,
+    cwd: context.policy.workspace,
+    profile: context.policy.profile,
+    approvalMode: context.policy.approvalMode,
+    priority: nextPriority
+  });
+  try {
+    const selection = await nextSelectionPromise;
+    context.selectionPromise = Promise.resolve(selection);
+    context.sessionPromise = void 0;
+    context.cliSessionId = void 0;
+    const session = await getSession(context);
+    return { backend: selection.backend, session };
+  } catch {
+    context.selectionPromise = previousSelectionPromise;
+    context.sessionPromise = previousSessionPromise;
+    context.cliSessionId = previousCliSessionId;
+    return null;
+  }
+}
+async function switchBackend(context, excludedBackends, getSession) {
+  const currentSelection = await context.selectionPromise.catch(() => null);
+  if (currentSelection?.providerFallbackIndex != null && context.options.providerFallbacks && currentSelection.providerFallbackIndex + 1 < context.options.providerFallbacks.length) {
+    const previousStartIndex = context.options.providerFallbackStartIndex;
+    context.options.providerFallbackStartIndex = currentSelection.providerFallbackIndex + 1;
+    const sameBackendResult = await _doSwitchBackend(
+      context,
+      context.options.priority,
+      getSession
+    );
+    if (sameBackendResult) return sameBackendResult;
+    context.options.providerFallbackStartIndex = previousStartIndex;
+  }
+  const nextPriority = context.options.priority.filter(
+    (b) => !excludedBackends.includes(b)
+  );
+  if (nextPriority.length === 0) return null;
+  return _doSwitchBackend(context, nextPriority, getSession);
+}
+async function switchToBackend(context, targetBackend, getSession) {
+  if (!context.options.priority.includes(targetBackend)) return null;
+  return _doSwitchBackend(context, [targetBackend], getSession);
+}
+function requiresPromptReplay(backend) {
+  return isApiBackend(backend);
+}
+export {
+  resolveSession,
+  switchBackend,
+  switchToBackend
+};
+//# sourceMappingURL=resolver.js.map

package/dist/runtime/sessions/resolver.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/sessions/resolver.ts"],
+  "sourcesContent": ["import { selectBackendClient } from '../../adapters/agents/selection.js';\nimport type {\n  AgentEvent,\n  BackendName,\n  Client,\n  RunOptions,\n  RunResult,\n} from '../../domain/core-client.js';\nimport { isApiBackend } from './context-helpers.js';\nimport type { ContextState, SessionLike } from './context-types.js';\nimport { ConversationSession } from './conversation.js';\n\n/**\n * Backends that consume native structured `messages[]` arrays.\n * When selected, the conversation session drops the text-stuffed replay\n * prompt and forwards only the structured history.\n */\nfunction backendConsumesStructuredHistory(backend: BackendName): boolean {\n  return (\n    backend === 'anthropic-api' ||\n    backend === 'openai-api' ||\n    backend === 'ollama' ||\n    backend === 'custom-api' ||\n    backend.startsWith('vercel-ai:')\n  );\n}\n\n/**\n * Build a `SessionLike` from a backend selection result. This is the core\n * factory that `ContextManager.getSession()` delegates to.\n */\nfunction buildSession(\n  backend: BackendName,\n  client: Client,\n  context: ContextState\n): SessionLike {\n  const defaultOptions = {\n    model: context.options.model,\n    maxOutputTokens: context.options.maxOutputTokens,\n    systemPrompt: context.options.systemPrompt,\n    cwd: context.policy.workspace,\n    profile: context.policy.profile,\n    approvalMode: context.policy.approvalMode,\n    timeoutMs: context.options.timeoutMs,\n    mcpConfigPath: context.options.mcpConfigPath,\n    retries: context.options.retries,\n    resumeFrom: context.cliSessionId,\n  };\n\n  if (requiresPromptReplay(backend)) {\n    return new ConversationSession(\n      'always-replay',\n      (prompt, opts) => {\n        if (opts?.onEvent) {\n          return client.stream(prompt, opts.onEvent, opts);\n        }\n        return client.run(prompt, opts);\n      },\n      { structuredHistoryNative: backendConsumesStructuredHistory(backend) }\n    );\n  }\n\n  const session = client.session(defaultOptions) as {\n    send(\n      prompt: string,\n      opts?: RunOptions & {\n        onEvent?: (event: AgentEvent) => void | Promise<void>;\n      }\n    ): Promise<RunResult>;\n  };\n\n  return new ConversationSession(\n    'seed-once',\n    (prompt, opts) => session.send(prompt, opts),\n    { structuredHistoryNative: backendConsumesStructuredHistory(backend) }\n  );\n}\n\n/**\n * Resolve a session for a context, caching the promise so concurrent callers\n * share a single in-flight resolution. On failure the cached promise is cleared\n * so the next caller gets a fresh attempt.\n */\nexport function resolveSession(context: ContextState): Promise<SessionLike> {\n  if (!context.sessionPromise) {\n    context.sessionPromise = context.selectionPromise\n      .then(({ backend, client }) => buildSession(backend, client, context))\n      .catch((err: unknown) => {\n        context.sessionPromise = undefined;\n        throw err;\n      });\n  }\n  return context.sessionPromise;\n}\n\n/**\n * Core transition logic shared by `switchBackend` and `switchToBackend`.\n *\n * Saves the three mutable context fields that identify a backend selection,\n * attempts a new selection with `nextPriority`, builds a fresh session, and\n * returns the result.  On any failure the saved state is atomically restored\n * so the context is left in its original working condition.\n */\nasync function _doSwitchBackend(\n  context: ContextState,\n  nextPriority: BackendName[],\n  getSession: (ctx: ContextState) => Promise<SessionLike>\n): Promise<{ backend: BackendName; session: SessionLike } | null> {\n  const previousSelectionPromise = context.selectionPromise;\n  const previousSessionPromise = context.sessionPromise;\n  const previousCliSessionId = context.cliSessionId;\n\n  const nextSelectionPromise = selectBackendClient({\n    ...context.options,\n    cwd: context.policy.workspace,\n    profile: context.policy.profile,\n    approvalMode: context.policy.approvalMode,\n    priority: nextPriority,\n  });\n\n  try {\n    const selection = await nextSelectionPromise;\n    context.selectionPromise = Promise.resolve(selection);\n    context.sessionPromise = undefined;\n    context.cliSessionId = undefined;\n    const session = await getSession(context);\n    return { backend: selection.backend, session };\n  } catch {\n    context.selectionPromise = previousSelectionPromise;\n    context.sessionPromise = previousSessionPromise;\n    context.cliSessionId = previousCliSessionId;\n    return null;\n  }\n}\n\n/**\n * Attempt to switch a context to a different backend by exclusion list.\n * Returns the new backend + session, or null if no alternative is available.\n */\nexport async function switchBackend(\n  context: ContextState,\n  excludedBackends: BackendName[],\n  getSession: (ctx: ContextState) => Promise<SessionLike>\n): Promise<{ backend: BackendName; session: SessionLike } | null> {\n  const currentSelection = await context.selectionPromise.catch(() => null);\n  if (\n    currentSelection?.providerFallbackIndex != null &&\n    context.options.providerFallbacks &&\n    currentSelection.providerFallbackIndex + 1 <\n      context.options.providerFallbacks.length\n  ) {\n    const previousStartIndex = context.options.providerFallbackStartIndex;\n    context.options.providerFallbackStartIndex =\n      currentSelection.providerFallbackIndex + 1;\n    const sameBackendResult = await _doSwitchBackend(\n      context,\n      context.options.priority,\n      getSession\n    );\n    if (sameBackendResult) return sameBackendResult;\n    context.options.providerFallbackStartIndex = previousStartIndex;\n  }\n\n  const nextPriority = context.options.priority.filter(\n    (b) => !excludedBackends.includes(b)\n  );\n  if (nextPriority.length === 0) return null;\n  return _doSwitchBackend(context, nextPriority, getSession);\n}\n\n/**\n * Attempt to switch a context to a specific target backend.\n */\nexport async function switchToBackend(\n  context: ContextState,\n  targetBackend: BackendName,\n  getSession: (ctx: ContextState) => Promise<SessionLike>\n): Promise<{ backend: BackendName; session: SessionLike } | null> {\n  if (!context.options.priority.includes(targetBackend)) return null;\n  return _doSwitchBackend(context, [targetBackend], getSession);\n}\n\nfunction requiresPromptReplay(backend: BackendName): boolean {\n  return isApiBackend(backend);\n}\n"],
+  "mappings": "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",
+  "names": []
+}