@bastani/atomic 0.8.28-alpha.1 → 0.8.28-alpha.2

package/dist/core/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport {\n  Agent,\n  type AgentMessage,\n  type ThinkingLevel,\n} from \"@earendil-works/pi-agent-core\";\nimport {\n  clampThinkingLevel,\n  type Api,\n  type Message,\n  type Model,\n  streamSimple,\n} from \"@earendil-works/pi-ai\";\nimport { APP_NAME, getAgentDir } from \"../config.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { AgentSession } from \"./agent-session.ts\";\nimport { formatNoModelsAvailableMessage } from \"./auth-guidance.ts\";\nimport { AuthStorage } from \"./auth-storage.ts\";\nimport {\n  shouldApplyCodexFastMode,\n  streamWithCodexFastMode,\n  withCodexFastModePayload,\n  withCodexFastModeStreamOptions,\n} from \"./codex-fast-mode.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type {\n  ExtensionRunner,\n  LoadExtensionsResult,\n  OrchestrationContext,\n  SessionStartEvent,\n  ToolDefinition,\n} from \"./extensions/index.ts\";\nimport { convertToLlm } from \"./messages.ts\";\nimport { ModelRegistry } from \"./model-registry.ts\";\nimport { findInitialModel } from \"./model-resolver.ts\";\nimport type { ResourceLoader } from \"./resource-loader.ts\";\nimport { DefaultResourceLoader } from \"./resource-loader.ts\";\nimport { getDefaultSessionDir, SessionManager } from \"./session-manager.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\nimport { isInstallTelemetryEnabled } from \"./telemetry.ts\";\nimport { time } from \"./timings.ts\";\nimport {\n  createBashTool,\n  createCodingTools,\n  createEditTool,\n  createFindTool,\n  createGrepTool,\n  createLsTool,\n  createReadOnlyTools,\n  createReadTool,\n  createWriteTool,\n  defaultToolNames,\n  withFileMutationQueue,\n} from \"./tools/index.ts\";\n\nexport interface CreateAgentSessionOptions {\n  /** Working directory for project-local discovery. Default: process.cwd() */\n  cwd?: string;\n  /** Global config directory. Default: ~/.atomic/agent */\n  agentDir?: string;\n\n  /** Auth storage for credentials. Default: AuthStorage.create(agentDir/auth.json) */\n  authStorage?: AuthStorage;\n  /** Model registry. Default: ModelRegistry.create(authStorage, agentDir/models.json) */\n  modelRegistry?: ModelRegistry;\n\n  /** Model to use. Default: from settings, else first available */\n  model?: Model<Api>;\n  /** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */\n  thinkingLevel?: ThinkingLevel;\n  /** Models available for cycling (Ctrl+P in interactive mode) */\n  scopedModels?: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>;\n\n  /**\n   * Optional default tool suppression mode when no explicit allowlist is provided.\n   *\n   * - \"all\": start with no tools enabled\n   * - \"builtin\": disable the default built-in tools (read, bash, edit, write,\n   *   ask_user_question, todo) but keep extension/custom tools enabled\n   */\n  noTools?: \"all\" | \"builtin\";\n  /**\n   * Optional allowlist of tool names.\n   *\n   * When omitted, pi enables the default built-in tools (read, bash, edit, write,\n   * ask_user_question, todo) and leaves extension/custom tools enabled unless\n   * `noTools` changes that default.\n   * When provided, only the listed tool names are enabled, minus any names in\n   * `excludedTools`.\n   */\n  tools?: string[];\n  /**\n   * Optional blocklist of tool names.\n   *\n   * Matching built-in, extension, and SDK custom tools are omitted from the\n   * final session tool registry and active tool set. Unknown names are ignored.\n   */\n  excludedTools?: string[];\n  /** Custom tools to register (in addition to built-in tools). */\n  customTools?: ToolDefinition[];\n\n  /** Resource loader. When omitted, DefaultResourceLoader is used. */\n  resourceLoader?: ResourceLoader;\n\n  /** Session manager. Default: SessionManager.create(cwd) */\n  sessionManager?: SessionManager;\n\n  /** Settings manager. Default: SettingsManager.create(cwd, agentDir) */\n  settingsManager?: SettingsManager;\n  /** Session start event metadata for extension runtime startup. */\n  sessionStartEvent?: SessionStartEvent;\n  /** Session-scoped orchestration policy exposed to extension/tool handlers. */\n  orchestrationContext?: OrchestrationContext;\n}\n\n/** Result from createAgentSession */\nexport interface CreateAgentSessionResult {\n  /** The created session */\n  session: AgentSession;\n  /** Extensions result (for UI context setup in interactive mode) */\n  extensionsResult: LoadExtensionsResult;\n  /** Warning if session was restored with a different model than saved */\n  modelFallbackMessage?: string;\n}\n\n// Re-exports\n\nexport * from \"./agent-session-runtime.ts\";\nexport type {\n  ExtensionAPI,\n  ExtensionCommandContext,\n  ExtensionContext,\n  ExtensionFactory,\n  SlashCommandInfo,\n  SlashCommandSource,\n  ToolDefinition,\n} from \"./extensions/index.ts\";\nexport type { PromptTemplate } from \"./prompt-templates.ts\";\nexport type { Skill } from \"./skills.ts\";\nexport type { Tool } from \"./tools/index.ts\";\n\nexport {\n  withFileMutationQueue,\n  // Tool factories (for custom cwd)\n  createCodingTools,\n  createReadOnlyTools,\n  createReadTool,\n  createBashTool,\n  createEditTool,\n  createWriteTool,\n  createGrepTool,\n  createFindTool,\n  createLsTool,\n};\n\n// Helper Functions\n\nfunction getDefaultAgentDir(): string {\n  return getAgentDir();\n}\n\nfunction isHostOrSubdomain(rawUrl: string, host: string): boolean {\n  try {\n    const { hostname } = new URL(rawUrl);\n    return hostname === host || hostname.endsWith(`.${host}`);\n  } catch {\n    return false;\n  }\n}\n\nfunction getAttributionHeaders(\n  model: Model<Api>,\n  settingsManager: SettingsManager,\n  sessionId?: string,\n): Record<string, string> | undefined {\n  if (\n    sessionId &&\n    (model.provider === \"opencode\" || model.provider === \"opencode-go\" || isHostOrSubdomain(model.baseUrl, \"opencode.ai\"))\n  ) {\n    return { \"x-opencode-session\": sessionId, \"x-opencode-client\": APP_NAME };\n  }\n\n  if (!isInstallTelemetryEnabled(settingsManager)) {\n    return undefined;\n  }\n\n  if (\n    model.provider === \"openrouter\" ||\n    isHostOrSubdomain(model.baseUrl, \"openrouter.ai\")\n  ) {\n    return {\n      \"HTTP-Referer\": \"https://pi.dev\",\n      \"X-OpenRouter-Title\": \"pi\",\n      \"X-OpenRouter-Categories\": \"cli-agent\",\n    };\n  }\n\n  if (\n    model.provider === \"cloudflare-workers-ai\" ||\n    model.provider === \"cloudflare-ai-gateway\" ||\n    isHostOrSubdomain(model.baseUrl, \"api.cloudflare.com\") ||\n    isHostOrSubdomain(model.baseUrl, \"gateway.ai.cloudflare.com\")\n  ) {\n    return {\n      \"User-Agent\": APP_NAME,\n    };\n  }\n\n  return undefined;\n}\n\n/**\n * Create an AgentSession with the specified options.\n *\n * @example\n * ```typescript\n * // Minimal - uses defaults\n * const { session } = await createAgentSession();\n *\n * // With explicit model\n * import { getModel } from '@earendil-works/pi-ai';\n * const { session } = await createAgentSession({\n *   model: getModel('anthropic', 'claude-opus-4-5'),\n *   thinkingLevel: 'high',\n * });\n *\n * // Continue previous session\n * const { session, modelFallbackMessage } = await createAgentSession({\n *   continueSession: true,\n * });\n *\n * // Full control\n * const loader = new DefaultResourceLoader({\n *   cwd: process.cwd(),\n *   agentDir: getAgentDir(),\n *   settingsManager: SettingsManager.create(),\n * });\n * await loader.reload();\n * const { session } = await createAgentSession({\n *   model: myModel,\n *   tools: [\"read\", \"bash\"],\n *   resourceLoader: loader,\n *   sessionManager: SessionManager.inMemory(),\n * });\n * ```\n */\nexport async function createAgentSession(\n  options: CreateAgentSessionOptions = {},\n): Promise<CreateAgentSessionResult> {\n  const cwd = resolvePath(options.cwd ?? options.sessionManager?.getCwd() ?? process.cwd());\n  const agentDir = options.agentDir ? resolvePath(options.agentDir) : getDefaultAgentDir();\n  let resourceLoader = options.resourceLoader;\n\n  // Use provided or create AuthStorage and ModelRegistry\n  const authPath = options.agentDir ? join(agentDir, \"auth.json\") : undefined;\n  const modelsPath = options.agentDir\n    ? join(agentDir, \"models.json\")\n    : undefined;\n  const authStorage = options.authStorage ?? AuthStorage.create(authPath);\n  const modelRegistry =\n    options.modelRegistry ?? ModelRegistry.create(authStorage, modelsPath);\n\n  const settingsManager =\n    options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n  const sessionManager =\n    options.sessionManager ??\n    SessionManager.create(cwd, getDefaultSessionDir(cwd, agentDir));\n\n  if (!resourceLoader) {\n    resourceLoader = new DefaultResourceLoader({\n      cwd,\n      agentDir,\n      settingsManager,\n    });\n    await resourceLoader.reload();\n    time(\"resourceLoader.reload\");\n  }\n\n  // Check if session has existing data to restore\n  const existingSession = sessionManager.buildSessionContext();\n  const hasExistingSession = existingSession.messages.length > 0;\n  const hasThinkingEntry = sessionManager\n    .getBranch()\n    .some((entry) => entry.type === \"thinking_level_change\");\n\n  let model = options.model;\n  let modelFallbackMessage: string | undefined;\n\n  // If session has data, try to restore model from it\n  if (!model && hasExistingSession && existingSession.model) {\n    const restoredModel = modelRegistry.find(\n      existingSession.model.provider,\n      existingSession.model.modelId,\n    );\n    if (restoredModel && modelRegistry.hasConfiguredAuth(restoredModel)) {\n      model = restoredModel;\n    }\n    if (!model) {\n      modelFallbackMessage = `Could not restore model ${existingSession.model.provider}/${existingSession.model.modelId}`;\n    }\n  }\n\n  // If still no model, use findInitialModel (checks settings default, then provider defaults)\n  if (!model) {\n    const result = await findInitialModel({\n      scopedModels: [],\n      isContinuing: hasExistingSession,\n      defaultProvider: settingsManager.getDefaultProvider(),\n      defaultModelId: settingsManager.getDefaultModel(),\n      defaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),\n      modelRegistry,\n    });\n    model = result.model;\n    if (!model) {\n      modelFallbackMessage = formatNoModelsAvailableMessage();\n    } else if (modelFallbackMessage) {\n      modelFallbackMessage += `. Using ${model.provider}/${model.id}`;\n    }\n  }\n\n  let thinkingLevel = options.thinkingLevel;\n\n  // If session has data, restore thinking level from it\n  if (thinkingLevel === undefined && hasExistingSession) {\n    thinkingLevel = hasThinkingEntry\n      ? (existingSession.thinkingLevel as ThinkingLevel)\n      : (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);\n  }\n\n  // Fall back to settings default\n  if (thinkingLevel === undefined) {\n    thinkingLevel =\n      settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n  }\n\n  // Clamp to model capabilities\n  if (!model) {\n    thinkingLevel = \"off\";\n  } else {\n    thinkingLevel = clampThinkingLevel(model, thinkingLevel) as ThinkingLevel;\n  }\n\n  const allowedToolNames =\n    options.tools ?? (options.noTools === \"all\" ? [] : undefined);\n  const initialActiveToolNames: string[] = options.tools\n    ? [...options.tools]\n    : options.noTools\n      ? []\n      : [...defaultToolNames];\n\n  let agent: Agent;\n\n  // Create convertToLlm wrapper that filters images if blockImages is enabled (defense-in-depth)\n  const convertToLlmWithBlockImages = (messages: AgentMessage[]): Message[] => {\n    const converted = convertToLlm(messages);\n    // Check setting dynamically so mid-session changes take effect\n    if (!settingsManager.getBlockImages()) {\n      return converted;\n    }\n    // Filter out ImageContent from all messages, replacing with text placeholder\n    return converted.map((msg) => {\n      if (msg.role === \"user\" || msg.role === \"toolResult\") {\n        const content = msg.content;\n        if (Array.isArray(content)) {\n          const hasImages = content.some((c) => c.type === \"image\");\n          if (hasImages) {\n            const filteredContent = content\n              .map((c) =>\n                c.type === \"image\"\n                  ? {\n                      type: \"text\" as const,\n                      text: \"Image reading is disabled.\",\n                    }\n                  : c,\n              )\n              .filter(\n                (c, i, arr) =>\n                  // Dedupe consecutive \"Image reading is disabled.\" texts\n                  !(\n                    c.type === \"text\" &&\n                    c.text === \"Image reading is disabled.\" &&\n                    i > 0 &&\n                    arr[i - 1].type === \"text\" &&\n                    (arr[i - 1] as { type: \"text\"; text: string }).text ===\n                      \"Image reading is disabled.\"\n                  ),\n              );\n            return { ...msg, content: filteredContent };\n          }\n        }\n      }\n      return msg;\n    });\n  };\n\n  const extensionRunnerRef: { current?: ExtensionRunner } = {};\n  const isCodexFastModeEnabled = (requestModel: Model<Api>): boolean =>\n    shouldApplyCodexFastMode(\n      requestModel,\n      settingsManager.getCodexFastModeSettings(),\n      options.orchestrationContext,\n    );\n\n  agent = new Agent({\n    initialState: {\n      systemPrompt: \"\",\n      model,\n      thinkingLevel,\n      tools: [],\n    },\n    convertToLlm: convertToLlmWithBlockImages,\n    streamFn: async (model, context, streamOptions) => {\n      const auth = await modelRegistry.getApiKeyAndHeaders(model);\n      if (!auth.ok) {\n        throw new Error(auth.error);\n      }\n      const providerRetrySettings = settingsManager.getProviderRetrySettings();\n      const attributionHeaders = getAttributionHeaders(model, settingsManager, streamOptions?.sessionId);\n      const fastModeEnabled = isCodexFastModeEnabled(model);\n      const codexFastModeStreamOptions = withCodexFastModeStreamOptions(\n        {\n          ...streamOptions,\n          apiKey: auth.apiKey,\n          timeoutMs: streamOptions?.timeoutMs ?? providerRetrySettings.timeoutMs,\n          maxRetries: streamOptions?.maxRetries ?? providerRetrySettings.maxRetries,\n          maxRetryDelayMs:\n            streamOptions?.maxRetryDelayMs ?? providerRetrySettings.maxRetryDelayMs,\n          headers:\n            attributionHeaders || auth.headers || streamOptions?.headers\n              ? { ...attributionHeaders, ...auth.headers, ...streamOptions?.headers }\n              : undefined,\n        },\n        fastModeEnabled,\n      );\n      if (modelRegistry.hasRegisteredStreamSimpleForApi(model.api)) {\n        return streamSimple(model, context, codexFastModeStreamOptions);\n      }\n      return streamWithCodexFastMode(model, context, codexFastModeStreamOptions);\n    },\n    onPayload: async (payload, model) => {\n      const fastModeEnabled = isCodexFastModeEnabled(model);\n      const guardedPayload = withCodexFastModePayload(payload, fastModeEnabled);\n      const runner = extensionRunnerRef.current;\n      if (!runner?.hasHandlers(\"before_provider_request\")) {\n        return guardedPayload;\n      }\n      return runner.emitBeforeProviderRequest(guardedPayload);\n    },\n    onResponse: async (response, _model) => {\n      const runner = extensionRunnerRef.current;\n      if (!runner?.hasHandlers(\"after_provider_response\")) {\n        return;\n      }\n      await runner.emit({\n        type: \"after_provider_response\",\n        status: response.status,\n        headers: response.headers,\n      });\n    },\n    sessionId: sessionManager.getSessionId(),\n    transformContext: async (messages) => {\n      const runner = extensionRunnerRef.current;\n      if (!runner) return messages;\n      return runner.emitContext(messages);\n    },\n    steeringMode: settingsManager.getSteeringMode(),\n    followUpMode: settingsManager.getFollowUpMode(),\n    transport: settingsManager.getTransport(),\n    thinkingBudgets: settingsManager.getThinkingBudgets(),\n    maxRetryDelayMs: settingsManager.getProviderRetrySettings().maxRetryDelayMs,\n  });\n\n  // Restore messages if session has existing data\n  if (hasExistingSession) {\n    agent.state.messages = existingSession.messages;\n    if (!hasThinkingEntry) {\n      sessionManager.appendThinkingLevelChange(thinkingLevel);\n    }\n  } else {\n    // Save initial model and thinking level for new sessions so they can be restored on resume\n    if (model) {\n      sessionManager.appendModelChange(model.provider, model.id);\n    }\n    sessionManager.appendThinkingLevelChange(thinkingLevel);\n  }\n\n  const session = new AgentSession({\n    agent,\n    sessionManager,\n    settingsManager,\n    cwd,\n    scopedModels: options.scopedModels,\n    resourceLoader,\n    customTools: options.customTools,\n    modelRegistry,\n    initialActiveToolNames,\n    allowedToolNames,\n    excludedToolNames: options.excludedTools,\n    extensionRunnerRef,\n    sessionStartEvent: options.sessionStartEvent,\n    orchestrationContext: options.orchestrationContext,\n  });\n  const extensionsResult = resourceLoader.getExtensions();\n\n  return {\n    session,\n    extensionsResult,\n    modelFallbackMessage,\n  };\n}\n"]}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport {\n  Agent,\n  type AgentMessage,\n  type ThinkingLevel,\n} from \"@earendil-works/pi-agent-core\";\nimport {\n  clampThinkingLevel,\n  type Api,\n  type Message,\n  type Model,\n  streamSimple,\n} from \"@earendil-works/pi-ai\";\nimport { getAgentDir } from \"../config.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { AgentSession } from \"./agent-session.ts\";\nimport { formatNoModelsAvailableMessage } from \"./auth-guidance.ts\";\nimport { AuthStorage } from \"./auth-storage.ts\";\nimport {\n  shouldApplyCodexFastMode,\n  streamWithCodexFastMode,\n  withCodexFastModePayload,\n  withCodexFastModeStreamOptions,\n} from \"./codex-fast-mode.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type {\n  ExtensionRunner,\n  LoadExtensionsResult,\n  OrchestrationContext,\n  SessionStartEvent,\n  ToolDefinition,\n} from \"./extensions/index.ts\";\nimport { convertToLlm } from \"./messages.ts\";\nimport { ModelRegistry } from \"./model-registry.ts\";\nimport { findInitialModel } from \"./model-resolver.ts\";\nimport type { ResourceLoader } from \"./resource-loader.ts\";\nimport { DefaultResourceLoader } from \"./resource-loader.ts\";\nimport { getDefaultSessionDir, SessionManager } from \"./session-manager.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\nimport { mergeProviderAttributionHeaders } from \"./provider-attribution.ts\";\nimport { time } from \"./timings.ts\";\nimport {\n  createBashTool,\n  createCodingTools,\n  createEditTool,\n  createFindTool,\n  createGrepTool,\n  createLsTool,\n  createReadOnlyTools,\n  createReadTool,\n  createWriteTool,\n  defaultToolNames,\n  withFileMutationQueue,\n} from \"./tools/index.ts\";\n\nexport interface CreateAgentSessionOptions {\n  /** Working directory for project-local discovery. Default: process.cwd() */\n  cwd?: string;\n  /** Global config directory. Default: ~/.atomic/agent */\n  agentDir?: string;\n\n  /** Auth storage for credentials. Default: AuthStorage.create(agentDir/auth.json) */\n  authStorage?: AuthStorage;\n  /** Model registry. Default: ModelRegistry.create(authStorage, agentDir/models.json) */\n  modelRegistry?: ModelRegistry;\n\n  /** Model to use. Default: from settings, else first available */\n  model?: Model<Api>;\n  /** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */\n  thinkingLevel?: ThinkingLevel;\n  /** Models available for cycling (Ctrl+P in interactive mode) */\n  scopedModels?: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>;\n\n  /**\n   * Optional default tool suppression mode when no explicit allowlist is provided.\n   *\n   * - \"all\": start with no tools enabled\n   * - \"builtin\": disable the default built-in tools (read, bash, edit, write,\n   *   ask_user_question, todo) but keep extension/custom tools enabled\n   */\n  noTools?: \"all\" | \"builtin\";\n  /**\n   * Optional allowlist of tool names.\n   *\n   * When omitted, pi enables the default built-in tools (read, bash, edit, write,\n   * ask_user_question, todo) and leaves extension/custom tools enabled unless\n   * `noTools` changes that default.\n   * When provided, only the listed tool names are enabled, minus any names in\n   * `excludedTools`.\n   */\n  tools?: string[];\n  /**\n   * Optional blocklist of tool names.\n   *\n   * Matching built-in, extension, and SDK custom tools are omitted from the\n   * final session tool registry and active tool set. Unknown names are ignored.\n   */\n  excludedTools?: string[];\n  /** Custom tools to register (in addition to built-in tools). */\n  customTools?: ToolDefinition[];\n\n  /** Resource loader. When omitted, DefaultResourceLoader is used. */\n  resourceLoader?: ResourceLoader;\n\n  /** Session manager. Default: SessionManager.create(cwd) */\n  sessionManager?: SessionManager;\n\n  /** Settings manager. Default: SettingsManager.create(cwd, agentDir) */\n  settingsManager?: SettingsManager;\n  /** Session start event metadata for extension runtime startup. */\n  sessionStartEvent?: SessionStartEvent;\n  /** Session-scoped orchestration policy exposed to extension/tool handlers. */\n  orchestrationContext?: OrchestrationContext;\n}\n\n/** Result from createAgentSession */\nexport interface CreateAgentSessionResult {\n  /** The created session */\n  session: AgentSession;\n  /** Extensions result (for UI context setup in interactive mode) */\n  extensionsResult: LoadExtensionsResult;\n  /** Warning if session was restored with a different model than saved */\n  modelFallbackMessage?: string;\n}\n\n// Re-exports\n\nexport * from \"./agent-session-runtime.ts\";\nexport type {\n  ExtensionAPI,\n  ExtensionCommandContext,\n  ExtensionContext,\n  ExtensionFactory,\n  SlashCommandInfo,\n  SlashCommandSource,\n  ToolDefinition,\n} from \"./extensions/index.ts\";\nexport type { PromptTemplate } from \"./prompt-templates.ts\";\nexport type { Skill } from \"./skills.ts\";\nexport type { Tool } from \"./tools/index.ts\";\n\nexport {\n  withFileMutationQueue,\n  // Tool factories (for custom cwd)\n  createCodingTools,\n  createReadOnlyTools,\n  createReadTool,\n  createBashTool,\n  createEditTool,\n  createWriteTool,\n  createGrepTool,\n  createFindTool,\n  createLsTool,\n};\n\n// Helper Functions\n\nfunction getDefaultAgentDir(): string {\n  return getAgentDir();\n}\n\n/**\n * Create an AgentSession with the specified options.\n *\n * @example\n * ```typescript\n * // Minimal - uses defaults\n * const { session } = await createAgentSession();\n *\n * // With explicit model\n * import { getModel } from '@earendil-works/pi-ai';\n * const { session } = await createAgentSession({\n *   model: getModel('anthropic', 'claude-opus-4-5'),\n *   thinkingLevel: 'high',\n * });\n *\n * // Continue previous session\n * const { session, modelFallbackMessage } = await createAgentSession({\n *   continueSession: true,\n * });\n *\n * // Full control\n * const loader = new DefaultResourceLoader({\n *   cwd: process.cwd(),\n *   agentDir: getAgentDir(),\n *   settingsManager: SettingsManager.create(),\n * });\n * await loader.reload();\n * const { session } = await createAgentSession({\n *   model: myModel,\n *   tools: [\"read\", \"bash\"],\n *   resourceLoader: loader,\n *   sessionManager: SessionManager.inMemory(),\n * });\n * ```\n */\nexport async function createAgentSession(\n  options: CreateAgentSessionOptions = {},\n): Promise<CreateAgentSessionResult> {\n  const cwd = resolvePath(options.cwd ?? options.sessionManager?.getCwd() ?? process.cwd());\n  const agentDir = options.agentDir ? resolvePath(options.agentDir) : getDefaultAgentDir();\n  let resourceLoader = options.resourceLoader;\n\n  // Use provided or create AuthStorage and ModelRegistry\n  const authPath = options.agentDir ? join(agentDir, \"auth.json\") : undefined;\n  const modelsPath = options.agentDir\n    ? join(agentDir, \"models.json\")\n    : undefined;\n  const authStorage = options.authStorage ?? AuthStorage.create(authPath);\n  const modelRegistry =\n    options.modelRegistry ?? ModelRegistry.create(authStorage, modelsPath);\n\n  const settingsManager =\n    options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n  const sessionManager =\n    options.sessionManager ??\n    SessionManager.create(cwd, getDefaultSessionDir(cwd, agentDir));\n\n  if (!resourceLoader) {\n    resourceLoader = new DefaultResourceLoader({\n      cwd,\n      agentDir,\n      settingsManager,\n    });\n    await resourceLoader.reload();\n    time(\"resourceLoader.reload\");\n  }\n\n  // Check if session has existing data to restore\n  const existingSession = sessionManager.buildSessionContext();\n  const hasExistingSession = existingSession.messages.length > 0;\n  const hasThinkingEntry = sessionManager\n    .getBranch()\n    .some((entry) => entry.type === \"thinking_level_change\");\n\n  let model = options.model;\n  let modelFallbackMessage: string | undefined;\n\n  // If session has data, try to restore model from it\n  if (!model && hasExistingSession && existingSession.model) {\n    const restoredModel = modelRegistry.find(\n      existingSession.model.provider,\n      existingSession.model.modelId,\n    );\n    if (restoredModel && modelRegistry.hasConfiguredAuth(restoredModel)) {\n      model = restoredModel;\n    }\n    if (!model) {\n      modelFallbackMessage = `Could not restore model ${existingSession.model.provider}/${existingSession.model.modelId}`;\n    }\n  }\n\n  // If still no model, use findInitialModel (checks settings default, then provider defaults)\n  if (!model) {\n    const result = await findInitialModel({\n      scopedModels: [],\n      isContinuing: hasExistingSession,\n      defaultProvider: settingsManager.getDefaultProvider(),\n      defaultModelId: settingsManager.getDefaultModel(),\n      defaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),\n      modelRegistry,\n    });\n    model = result.model;\n    if (!model) {\n      modelFallbackMessage = formatNoModelsAvailableMessage();\n    } else if (modelFallbackMessage) {\n      modelFallbackMessage += `. Using ${model.provider}/${model.id}`;\n    }\n  }\n\n  let thinkingLevel = options.thinkingLevel;\n\n  // If session has data, restore thinking level from it\n  if (thinkingLevel === undefined && hasExistingSession) {\n    thinkingLevel = hasThinkingEntry\n      ? (existingSession.thinkingLevel as ThinkingLevel)\n      : (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);\n  }\n\n  // Fall back to settings default\n  if (thinkingLevel === undefined) {\n    thinkingLevel =\n      settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n  }\n\n  // Clamp to model capabilities\n  if (!model) {\n    thinkingLevel = \"off\";\n  } else {\n    thinkingLevel = clampThinkingLevel(model, thinkingLevel) as ThinkingLevel;\n  }\n\n  const allowedToolNames =\n    options.tools ?? (options.noTools === \"all\" ? [] : undefined);\n  const initialActiveToolNames: string[] = options.tools\n    ? [...options.tools]\n    : options.noTools\n      ? []\n      : [...defaultToolNames];\n\n  let agent: Agent;\n\n  // Create convertToLlm wrapper that filters images if blockImages is enabled (defense-in-depth)\n  const convertToLlmWithBlockImages = (messages: AgentMessage[]): Message[] => {\n    const converted = convertToLlm(messages);\n    // Check setting dynamically so mid-session changes take effect\n    if (!settingsManager.getBlockImages()) {\n      return converted;\n    }\n    // Filter out ImageContent from all messages, replacing with text placeholder\n    return converted.map((msg) => {\n      if (msg.role === \"user\" || msg.role === \"toolResult\") {\n        const content = msg.content;\n        if (Array.isArray(content)) {\n          const hasImages = content.some((c) => c.type === \"image\");\n          if (hasImages) {\n            const filteredContent = content\n              .map((c) =>\n                c.type === \"image\"\n                  ? {\n                      type: \"text\" as const,\n                      text: \"Image reading is disabled.\",\n                    }\n                  : c,\n              )\n              .filter(\n                (c, i, arr) =>\n                  // Dedupe consecutive \"Image reading is disabled.\" texts\n                  !(\n                    c.type === \"text\" &&\n                    c.text === \"Image reading is disabled.\" &&\n                    i > 0 &&\n                    arr[i - 1].type === \"text\" &&\n                    (arr[i - 1] as { type: \"text\"; text: string }).text ===\n                      \"Image reading is disabled.\"\n                  ),\n              );\n            return { ...msg, content: filteredContent };\n          }\n        }\n      }\n      return msg;\n    });\n  };\n\n  const extensionRunnerRef: { current?: ExtensionRunner } = {};\n  const isCodexFastModeEnabled = (requestModel: Model<Api>): boolean =>\n    shouldApplyCodexFastMode(\n      requestModel,\n      settingsManager.getCodexFastModeSettings(),\n      options.orchestrationContext,\n    );\n\n  agent = new Agent({\n    initialState: {\n      systemPrompt: \"\",\n      model,\n      thinkingLevel,\n      tools: [],\n    },\n    convertToLlm: convertToLlmWithBlockImages,\n    streamFn: async (model, context, streamOptions) => {\n      const auth = await modelRegistry.getApiKeyAndHeaders(model);\n      if (!auth.ok) {\n        throw new Error(auth.error);\n      }\n      const providerRetrySettings = settingsManager.getProviderRetrySettings();\n      const httpIdleTimeoutMs = settingsManager.getHttpIdleTimeoutMs();\n      // SDKs treat timeout=0 as 0ms (immediate timeout), not \"no timeout\".\n      // Use max int32 to effectively disable the timeout.\n      const effectiveTimeoutMs = httpIdleTimeoutMs === 0 ? 2147483647 : httpIdleTimeoutMs;\n      const timeoutMs = streamOptions?.timeoutMs ?? providerRetrySettings.timeoutMs ?? effectiveTimeoutMs;\n      const websocketConnectTimeoutMs =\n        streamOptions?.websocketConnectTimeoutMs ?? settingsManager.getWebSocketConnectTimeoutMs();\n      const attributionHeaders = mergeProviderAttributionHeaders(\n        model,\n        settingsManager,\n        streamOptions?.sessionId,\n        auth.headers,\n        streamOptions?.headers,\n      );\n      const fastModeEnabled = isCodexFastModeEnabled(model);\n      const codexFastModeStreamOptions = withCodexFastModeStreamOptions(\n        {\n          ...streamOptions,\n          apiKey: auth.apiKey,\n          timeoutMs,\n          websocketConnectTimeoutMs,\n          maxRetries: streamOptions?.maxRetries ?? providerRetrySettings.maxRetries,\n          maxRetryDelayMs:\n            streamOptions?.maxRetryDelayMs ?? providerRetrySettings.maxRetryDelayMs,\n          headers: attributionHeaders,\n        },\n        fastModeEnabled,\n      );\n      if (modelRegistry.hasRegisteredStreamSimpleForApi(model.api)) {\n        return streamSimple(model, context, codexFastModeStreamOptions);\n      }\n      return streamWithCodexFastMode(model, context, codexFastModeStreamOptions);\n    },\n    onPayload: async (payload, model) => {\n      const fastModeEnabled = isCodexFastModeEnabled(model);\n      const guardedPayload = withCodexFastModePayload(payload, fastModeEnabled);\n      const runner = extensionRunnerRef.current;\n      if (!runner?.hasHandlers(\"before_provider_request\")) {\n        return guardedPayload;\n      }\n      return runner.emitBeforeProviderRequest(guardedPayload);\n    },\n    onResponse: async (response, _model) => {\n      const runner = extensionRunnerRef.current;\n      if (!runner?.hasHandlers(\"after_provider_response\")) {\n        return;\n      }\n      await runner.emit({\n        type: \"after_provider_response\",\n        status: response.status,\n        headers: response.headers,\n      });\n    },\n    sessionId: sessionManager.getSessionId(),\n    transformContext: async (messages) => {\n      const runner = extensionRunnerRef.current;\n      if (!runner) return messages;\n      return runner.emitContext(messages);\n    },\n    steeringMode: settingsManager.getSteeringMode(),\n    followUpMode: settingsManager.getFollowUpMode(),\n    transport: settingsManager.getTransport(),\n    thinkingBudgets: settingsManager.getThinkingBudgets(),\n    maxRetryDelayMs: settingsManager.getProviderRetrySettings().maxRetryDelayMs,\n  });\n\n  // Restore messages if session has existing data\n  if (hasExistingSession) {\n    agent.state.messages = existingSession.messages;\n    if (!hasThinkingEntry) {\n      sessionManager.appendThinkingLevelChange(thinkingLevel);\n    }\n  } else {\n    // Save initial model and thinking level for new sessions so they can be restored on resume\n    if (model) {\n      sessionManager.appendModelChange(model.provider, model.id);\n    }\n    sessionManager.appendThinkingLevelChange(thinkingLevel);\n  }\n\n  const session = new AgentSession({\n    agent,\n    sessionManager,\n    settingsManager,\n    cwd,\n    scopedModels: options.scopedModels,\n    resourceLoader,\n    customTools: options.customTools,\n    modelRegistry,\n    initialActiveToolNames,\n    allowedToolNames,\n    excludedToolNames: options.excludedTools,\n    extensionRunnerRef,\n    sessionStartEvent: options.sessionStartEvent,\n    orchestrationContext: options.orchestrationContext,\n  });\n  const extensionsResult = resourceLoader.getExtensions();\n\n  return {\n    session,\n    extensionsResult,\n    modelFallbackMessage,\n  };\n}\n"]}

package/dist/core/sdk.js

@@ -1,7 +1,7 @@
 import { join } from "node:path";
 import { Agent, } from "@earendil-works/pi-agent-core";
 import { clampThinkingLevel, streamSimple, } from "@earendil-works/pi-ai";
-import { APP_NAME, getAgentDir } from "../config.js";
+import { getAgentDir } from "../config.js";
 import { resolvePath } from "../utils/paths.js";
 import { AgentSession } from "./agent-session.js";
 import { formatNoModelsAvailableMessage } from "./auth-guidance.js";
@@ -14,7 +14,7 @@ import { findInitialModel } from "./model-resolver.js";
 import { DefaultResourceLoader } from "./resource-loader.js";
 import { getDefaultSessionDir, SessionManager } from "./session-manager.js";
 import { SettingsManager } from "./settings-manager.js";
-import { isInstallTelemetryEnabled } from "./telemetry.js";
+import { mergeProviderAttributionHeaders } from "./provider-attribution.js";
 import { time } from "./timings.js";
 import { createBashTool, createCodingTools, createEditTool, createFindTool, createGrepTool, createLsTool, createReadOnlyTools, createReadTool, createWriteTool, defaultToolNames, withFileMutationQueue, } from "./tools/index.js";
 // Re-exports
@@ -26,41 +26,6 @@ createCodingTools, createReadOnlyTools, createReadTool, createBashTool, createEd
 function getDefaultAgentDir() {
     return getAgentDir();
 }
-function isHostOrSubdomain(rawUrl, host) {
-    try {
-        const { hostname } = new URL(rawUrl);
-        return hostname === host || hostname.endsWith(`.${host}`);
-    }
-    catch {
-        return false;
-    }
-}
-function getAttributionHeaders(model, settingsManager, sessionId) {
-    if (sessionId &&
-        (model.provider === "opencode" || model.provider === "opencode-go" || isHostOrSubdomain(model.baseUrl, "opencode.ai"))) {
-        return { "x-opencode-session": sessionId, "x-opencode-client": APP_NAME };
-    }
-    if (!isInstallTelemetryEnabled(settingsManager)) {
-        return undefined;
-    }
-    if (model.provider === "openrouter" ||
-        isHostOrSubdomain(model.baseUrl, "openrouter.ai")) {
-        return {
-            "HTTP-Referer": "https://pi.dev",
-            "X-OpenRouter-Title": "pi",
-            "X-OpenRouter-Categories": "cli-agent",
-        };
-    }
-    if (model.provider === "cloudflare-workers-ai" ||
-        model.provider === "cloudflare-ai-gateway" ||
-        isHostOrSubdomain(model.baseUrl, "api.cloudflare.com") ||
-        isHostOrSubdomain(model.baseUrl, "gateway.ai.cloudflare.com")) {
-        return {
-            "User-Agent": APP_NAME,
-        };
-    }
-    return undefined;
-}
 /**
  * Create an AgentSession with the specified options.
  *
@@ -233,17 +198,22 @@ export async function createAgentSession(options = {}) {
                 throw new Error(auth.error);
             }
             const providerRetrySettings = settingsManager.getProviderRetrySettings();
-            const attributionHeaders = getAttributionHeaders(model, settingsManager, streamOptions?.sessionId);
+            const httpIdleTimeoutMs = settingsManager.getHttpIdleTimeoutMs();
+            // SDKs treat timeout=0 as 0ms (immediate timeout), not "no timeout".
+            // Use max int32 to effectively disable the timeout.
+            const effectiveTimeoutMs = httpIdleTimeoutMs === 0 ? 2147483647 : httpIdleTimeoutMs;
+            const timeoutMs = streamOptions?.timeoutMs ?? providerRetrySettings.timeoutMs ?? effectiveTimeoutMs;
+            const websocketConnectTimeoutMs = streamOptions?.websocketConnectTimeoutMs ?? settingsManager.getWebSocketConnectTimeoutMs();
+            const attributionHeaders = mergeProviderAttributionHeaders(model, settingsManager, streamOptions?.sessionId, auth.headers, streamOptions?.headers);
             const fastModeEnabled = isCodexFastModeEnabled(model);
             const codexFastModeStreamOptions = withCodexFastModeStreamOptions({
                 ...streamOptions,
                 apiKey: auth.apiKey,
-                timeoutMs: streamOptions?.timeoutMs ?? providerRetrySettings.timeoutMs,
+                timeoutMs,
+                websocketConnectTimeoutMs,
                 maxRetries: streamOptions?.maxRetries ?? providerRetrySettings.maxRetries,
                 maxRetryDelayMs: streamOptions?.maxRetryDelayMs ?? providerRetrySettings.maxRetryDelayMs,
-                headers: attributionHeaders || auth.headers || streamOptions?.headers
-                    ? { ...attributionHeaders, ...auth.headers, ...streamOptions?.headers }
-                    : undefined,
+                headers: attributionHeaders,
             }, fastModeEnabled);
             if (modelRegistry.hasRegisteredStreamSimpleForApi(model.api)) {
                 return streamSimple(model, context, codexFastModeStreamOptions);

package/dist/core/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,KAAK,GAGN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAIlB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAQvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAwE1B,aAAa;AAEb,cAAc,4BAA4B,CAAC;AAc3C,OAAO,EACL,qBAAqB;AACrB,kCAAkC;AAClC,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,GACb,CAAC;AAEF,mBAAmB;AAEnB,SAAS,kBAAkB;IACzB,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc,EAAE,IAAY;IACrD,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAiB,EACjB,eAAgC,EAChC,SAAkB;IAElB,IACE,SAAS;QACT,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,KAAK,aAAa,IAAI,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,EACtH,CAAC;QACD,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC,yBAAyB,CAAC,eAAe,CAAC,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IACE,KAAK,CAAC,QAAQ,KAAK,YAAY;QAC/B,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,EACjD,CAAC;QACD,OAAO;YACL,cAAc,EAAE,gBAAgB;YAChC,oBAAoB,EAAE,IAAI;YAC1B,yBAAyB,EAAE,WAAW;SACvC,CAAC;IACJ,CAAC;IAED,IACE,KAAK,CAAC,QAAQ,KAAK,uBAAuB;QAC1C,KAAK,CAAC,QAAQ,KAAK,uBAAuB;QAC1C,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC;QACtD,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,2BAA2B,CAAC,EAC7D,CAAC;QACD,OAAO;YACL,YAAY,EAAE,QAAQ;SACvB,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAO,GAA8B,EAAE;IAEvC,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACzF,IAAI,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAE5C,uDAAuD;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ;QACjC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC;QAC/B,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxE,MAAM,aAAa,GACjB,OAAO,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAEzE,MAAM,eAAe,GACnB,OAAO,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnE,MAAM,cAAc,GAClB,OAAO,CAAC,cAAc;QACtB,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,IAAI,qBAAqB,CAAC;YACzC,GAAG;YACH,QAAQ;YACR,eAAe;SAChB,CAAC,CAAC;QACH,MAAM,cAAc,CAAC,MAAM,EAAE,CAAC;QAC9B,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAChC,CAAC;IAED,gDAAgD;IAChD,MAAM,eAAe,GAAG,cAAc,CAAC,mBAAmB,EAAE,CAAC;IAC7D,MAAM,kBAAkB,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/D,MAAM,gBAAgB,GAAG,cAAc;SACpC,SAAS,EAAE;SACX,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,uBAAuB,CAAC,CAAC;IAE3D,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC1B,IAAI,oBAAwC,CAAC;IAE7C,oDAAoD;IACpD,IAAI,CAAC,KAAK,IAAI,kBAAkB,IAAI,eAAe,CAAC,KAAK,EAAE,CAAC;QAC1D,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,CACtC,eAAe,CAAC,KAAK,CAAC,QAAQ,EAC9B,eAAe,CAAC,KAAK,CAAC,OAAO,CAC9B,CAAC;QACF,IAAI,aAAa,IAAI,aAAa,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,CAAC;YACpE,KAAK,GAAG,aAAa,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,oBAAoB,GAAG,2BAA2B,eAAe,CAAC,KAAK,CAAC,QAAQ,IAAI,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACtH,CAAC;IACH,CAAC;IAED,4FAA4F;IAC5F,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,YAAY,EAAE,EAAE;YAChB,YAAY,EAAE,kBAAkB;YAChC,eAAe,EAAE,eAAe,CAAC,kBAAkB,EAAE;YACrD,cAAc,EAAE,eAAe,CAAC,eAAe,EAAE;YACjD,oBAAoB,EAAE,eAAe,CAAC,uBAAuB,EAAE;YAC/D,aAAa;SACd,CAAC,CAAC;QACH,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,oBAAoB,GAAG,8BAA8B,EAAE,CAAC;QAC1D,CAAC;aAAM,IAAI,oBAAoB,EAAE,CAAC;YAChC,oBAAoB,IAAI,WAAW,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IAED,IAAI,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAE1C,sDAAsD;IACtD,IAAI,aAAa,KAAK,SAAS,IAAI,kBAAkB,EAAE,CAAC;QACtD,aAAa,GAAG,gBAAgB;YAC9B,CAAC,CAAE,eAAe,CAAC,aAA+B;YAClD,CAAC,CAAC,CAAC,eAAe,CAAC,uBAAuB,EAAE,IAAI,sBAAsB,CAAC,CAAC;IAC5E,CAAC;IAED,gCAAgC;IAChC,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,aAAa;YACX,eAAe,CAAC,uBAAuB,EAAE,IAAI,sBAAsB,CAAC;IACxE,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,aAAa,GAAG,KAAK,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAkB,CAAC;IAC5E,CAAC;IAED,MAAM,gBAAgB,GACpB,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChE,MAAM,sBAAsB,GAAa,OAAO,CAAC,KAAK;QACpD,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC,OAAO,CAAC,OAAO;YACf,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC;IAE5B,IAAI,KAAY,CAAC;IAEjB,+FAA+F;IAC/F,MAAM,2BAA2B,GAAG,CAAC,QAAwB,EAAa,EAAE;QAC1E,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACzC,+DAA+D;QAC/D,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,EAAE,CAAC;YACtC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,6EAA6E;QAC7E,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACrD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;gBAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;oBAC1D,IAAI,SAAS,EAAE,CAAC;wBACd,MAAM,eAAe,GAAG,OAAO;6BAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,CAAC,CAAC,IAAI,KAAK,OAAO;4BAChB,CAAC,CAAC;gCACE,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE,4BAA4B;6BACnC;4BACH,CAAC,CAAC,CAAC,CACN;6BACA,MAAM,CACL,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE;wBACZ,wDAAwD;wBACxD,CAAC,CACC,CAAC,CAAC,IAAI,KAAK,MAAM;4BACjB,CAAC,CAAC,IAAI,KAAK,4BAA4B;4BACvC,CAAC,GAAG,CAAC;4BACL,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM;4BACzB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAoC,CAAC,IAAI;gCACjD,4BAA4B,CAC/B,CACJ,CAAC;wBACJ,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;oBAC9C,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,kBAAkB,GAAkC,EAAE,CAAC;IAC7D,MAAM,sBAAsB,GAAG,CAAC,YAAwB,EAAW,EAAE,CACnE,wBAAwB,CACtB,YAAY,EACZ,eAAe,CAAC,wBAAwB,EAAE,EAC1C,OAAO,CAAC,oBAAoB,CAC7B,CAAC;IAEJ,KAAK,GAAG,IAAI,KAAK,CAAC;QAChB,YAAY,EAAE;YACZ,YAAY,EAAE,EAAE;YAChB,KAAK;YACL,aAAa;YACb,KAAK,EAAE,EAAE;SACV;QACD,YAAY,EAAE,2BAA2B;QACzC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE;YAChD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;YACD,MAAM,qBAAqB,GAAG,eAAe,CAAC,wBAAwB,EAAE,CAAC;YACzE,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;YACnG,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,0BAA0B,GAAG,8BAA8B,CAC/D;gBACE,GAAG,aAAa;gBAChB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,aAAa,EAAE,SAAS,IAAI,qBAAqB,CAAC,SAAS;gBACtE,UAAU,EAAE,aAAa,EAAE,UAAU,IAAI,qBAAqB,CAAC,UAAU;gBACzE,eAAe,EACb,aAAa,EAAE,eAAe,IAAI,qBAAqB,CAAC,eAAe;gBACzE,OAAO,EACL,kBAAkB,IAAI,IAAI,CAAC,OAAO,IAAI,aAAa,EAAE,OAAO;oBAC1D,CAAC,CAAC,EAAE,GAAG,kBAAkB,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,aAAa,EAAE,OAAO,EAAE;oBACvE,CAAC,CAAC,SAAS;aAChB,EACD,eAAe,CAChB,CAAC;YACF,IAAI,aAAa,CAAC,+BAA+B,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7D,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,0BAA0B,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,0BAA0B,CAAC,CAAC;QAC7E,CAAC;QACD,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAClC,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,cAAc,GAAG,wBAAwB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YAC1E,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC;YAC1C,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,yBAAyB,CAAC,EAAE,CAAC;gBACpD,OAAO,cAAc,CAAC;YACxB,CAAC;YACD,OAAO,MAAM,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAAC;QAC1D,CAAC;QACD,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC;YAC1C,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,yBAAyB,CAAC,EAAE,CAAC;gBACpD,OAAO;YACT,CAAC;YACD,MAAM,MAAM,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,yBAAyB;gBAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;aAC1B,CAAC,CAAC;QACL,CAAC;QACD,SAAS,EAAE,cAAc,CAAC,YAAY,EAAE;QACxC,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC;YAC1C,IAAI,CAAC,MAAM;gBAAE,OAAO,QAAQ,CAAC;YAC7B,OAAO,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QACD,YAAY,EAAE,eAAe,CAAC,eAAe,EAAE;QAC/C,YAAY,EAAE,eAAe,CAAC,eAAe,EAAE;QAC/C,SAAS,EAAE,eAAe,CAAC,YAAY,EAAE;QACzC,eAAe,EAAE,eAAe,CAAC,kBAAkB,EAAE;QACrD,eAAe,EAAE,eAAe,CAAC,wBAAwB,EAAE,CAAC,eAAe;KAC5E,CAAC,CAAC;IAEH,gDAAgD;IAChD,IAAI,kBAAkB,EAAE,CAAC;QACvB,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC;QAChD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,cAAc,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,2FAA2F;QAC3F,IAAI,KAAK,EAAE,CAAC;YACV,cAAc,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,cAAc,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC;QAC/B,KAAK;QACL,cAAc;QACd,eAAe;QACf,GAAG;QACH,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,cAAc;QACd,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,aAAa;QACb,sBAAsB;QACtB,gBAAgB;QAChB,iBAAiB,EAAE,OAAO,CAAC,aAAa;QACxC,kBAAkB;QAClB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;KACnD,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,cAAc,CAAC,aAAa,EAAE,CAAC;IAExD,OAAO;QACL,OAAO;QACP,gBAAgB;QAChB,oBAAoB;KACrB,CAAC;AACJ,CAAC","sourcesContent":["import { join } from \"node:path\";\nimport {\n  Agent,\n  type AgentMessage,\n  type ThinkingLevel,\n} from \"@earendil-works/pi-agent-core\";\nimport {\n  clampThinkingLevel,\n  type Api,\n  type Message,\n  type Model,\n  streamSimple,\n} from \"@earendil-works/pi-ai\";\nimport { APP_NAME, getAgentDir } from \"../config.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { AgentSession } from \"./agent-session.ts\";\nimport { formatNoModelsAvailableMessage } from \"./auth-guidance.ts\";\nimport { AuthStorage } from \"./auth-storage.ts\";\nimport {\n  shouldApplyCodexFastMode,\n  streamWithCodexFastMode,\n  withCodexFastModePayload,\n  withCodexFastModeStreamOptions,\n} from \"./codex-fast-mode.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type {\n  ExtensionRunner,\n  LoadExtensionsResult,\n  OrchestrationContext,\n  SessionStartEvent,\n  ToolDefinition,\n} from \"./extensions/index.ts\";\nimport { convertToLlm } from \"./messages.ts\";\nimport { ModelRegistry } from \"./model-registry.ts\";\nimport { findInitialModel } from \"./model-resolver.ts\";\nimport type { ResourceLoader } from \"./resource-loader.ts\";\nimport { DefaultResourceLoader } from \"./resource-loader.ts\";\nimport { getDefaultSessionDir, SessionManager } from \"./session-manager.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\nimport { isInstallTelemetryEnabled } from \"./telemetry.ts\";\nimport { time } from \"./timings.ts\";\nimport {\n  createBashTool,\n  createCodingTools,\n  createEditTool,\n  createFindTool,\n  createGrepTool,\n  createLsTool,\n  createReadOnlyTools,\n  createReadTool,\n  createWriteTool,\n  defaultToolNames,\n  withFileMutationQueue,\n} from \"./tools/index.ts\";\n\nexport interface CreateAgentSessionOptions {\n  /** Working directory for project-local discovery. Default: process.cwd() */\n  cwd?: string;\n  /** Global config directory. Default: ~/.atomic/agent */\n  agentDir?: string;\n\n  /** Auth storage for credentials. Default: AuthStorage.create(agentDir/auth.json) */\n  authStorage?: AuthStorage;\n  /** Model registry. Default: ModelRegistry.create(authStorage, agentDir/models.json) */\n  modelRegistry?: ModelRegistry;\n\n  /** Model to use. Default: from settings, else first available */\n  model?: Model<Api>;\n  /** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */\n  thinkingLevel?: ThinkingLevel;\n  /** Models available for cycling (Ctrl+P in interactive mode) */\n  scopedModels?: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>;\n\n  /**\n   * Optional default tool suppression mode when no explicit allowlist is provided.\n   *\n   * - \"all\": start with no tools enabled\n   * - \"builtin\": disable the default built-in tools (read, bash, edit, write,\n   *   ask_user_question, todo) but keep extension/custom tools enabled\n   */\n  noTools?: \"all\" | \"builtin\";\n  /**\n   * Optional allowlist of tool names.\n   *\n   * When omitted, pi enables the default built-in tools (read, bash, edit, write,\n   * ask_user_question, todo) and leaves extension/custom tools enabled unless\n   * `noTools` changes that default.\n   * When provided, only the listed tool names are enabled, minus any names in\n   * `excludedTools`.\n   */\n  tools?: string[];\n  /**\n   * Optional blocklist of tool names.\n   *\n   * Matching built-in, extension, and SDK custom tools are omitted from the\n   * final session tool registry and active tool set. Unknown names are ignored.\n   */\n  excludedTools?: string[];\n  /** Custom tools to register (in addition to built-in tools). */\n  customTools?: ToolDefinition[];\n\n  /** Resource loader. When omitted, DefaultResourceLoader is used. */\n  resourceLoader?: ResourceLoader;\n\n  /** Session manager. Default: SessionManager.create(cwd) */\n  sessionManager?: SessionManager;\n\n  /** Settings manager. Default: SettingsManager.create(cwd, agentDir) */\n  settingsManager?: SettingsManager;\n  /** Session start event metadata for extension runtime startup. */\n  sessionStartEvent?: SessionStartEvent;\n  /** Session-scoped orchestration policy exposed to extension/tool handlers. */\n  orchestrationContext?: OrchestrationContext;\n}\n\n/** Result from createAgentSession */\nexport interface CreateAgentSessionResult {\n  /** The created session */\n  session: AgentSession;\n  /** Extensions result (for UI context setup in interactive mode) */\n  extensionsResult: LoadExtensionsResult;\n  /** Warning if session was restored with a different model than saved */\n  modelFallbackMessage?: string;\n}\n\n// Re-exports\n\nexport * from \"./agent-session-runtime.ts\";\nexport type {\n  ExtensionAPI,\n  ExtensionCommandContext,\n  ExtensionContext,\n  ExtensionFactory,\n  SlashCommandInfo,\n  SlashCommandSource,\n  ToolDefinition,\n} from \"./extensions/index.ts\";\nexport type { PromptTemplate } from \"./prompt-templates.ts\";\nexport type { Skill } from \"./skills.ts\";\nexport type { Tool } from \"./tools/index.ts\";\n\nexport {\n  withFileMutationQueue,\n  // Tool factories (for custom cwd)\n  createCodingTools,\n  createReadOnlyTools,\n  createReadTool,\n  createBashTool,\n  createEditTool,\n  createWriteTool,\n  createGrepTool,\n  createFindTool,\n  createLsTool,\n};\n\n// Helper Functions\n\nfunction getDefaultAgentDir(): string {\n  return getAgentDir();\n}\n\nfunction isHostOrSubdomain(rawUrl: string, host: string): boolean {\n  try {\n    const { hostname } = new URL(rawUrl);\n    return hostname === host || hostname.endsWith(`.${host}`);\n  } catch {\n    return false;\n  }\n}\n\nfunction getAttributionHeaders(\n  model: Model<Api>,\n  settingsManager: SettingsManager,\n  sessionId?: string,\n): Record<string, string> | undefined {\n  if (\n    sessionId &&\n    (model.provider === \"opencode\" || model.provider === \"opencode-go\" || isHostOrSubdomain(model.baseUrl, \"opencode.ai\"))\n  ) {\n    return { \"x-opencode-session\": sessionId, \"x-opencode-client\": APP_NAME };\n  }\n\n  if (!isInstallTelemetryEnabled(settingsManager)) {\n    return undefined;\n  }\n\n  if (\n    model.provider === \"openrouter\" ||\n    isHostOrSubdomain(model.baseUrl, \"openrouter.ai\")\n  ) {\n    return {\n      \"HTTP-Referer\": \"https://pi.dev\",\n      \"X-OpenRouter-Title\": \"pi\",\n      \"X-OpenRouter-Categories\": \"cli-agent\",\n    };\n  }\n\n  if (\n    model.provider === \"cloudflare-workers-ai\" ||\n    model.provider === \"cloudflare-ai-gateway\" ||\n    isHostOrSubdomain(model.baseUrl, \"api.cloudflare.com\") ||\n    isHostOrSubdomain(model.baseUrl, \"gateway.ai.cloudflare.com\")\n  ) {\n    return {\n      \"User-Agent\": APP_NAME,\n    };\n  }\n\n  return undefined;\n}\n\n/**\n * Create an AgentSession with the specified options.\n *\n * @example\n * ```typescript\n * // Minimal - uses defaults\n * const { session } = await createAgentSession();\n *\n * // With explicit model\n * import { getModel } from '@earendil-works/pi-ai';\n * const { session } = await createAgentSession({\n *   model: getModel('anthropic', 'claude-opus-4-5'),\n *   thinkingLevel: 'high',\n * });\n *\n * // Continue previous session\n * const { session, modelFallbackMessage } = await createAgentSession({\n *   continueSession: true,\n * });\n *\n * // Full control\n * const loader = new DefaultResourceLoader({\n *   cwd: process.cwd(),\n *   agentDir: getAgentDir(),\n *   settingsManager: SettingsManager.create(),\n * });\n * await loader.reload();\n * const { session } = await createAgentSession({\n *   model: myModel,\n *   tools: [\"read\", \"bash\"],\n *   resourceLoader: loader,\n *   sessionManager: SessionManager.inMemory(),\n * });\n * ```\n */\nexport async function createAgentSession(\n  options: CreateAgentSessionOptions = {},\n): Promise<CreateAgentSessionResult> {\n  const cwd = resolvePath(options.cwd ?? options.sessionManager?.getCwd() ?? process.cwd());\n  const agentDir = options.agentDir ? resolvePath(options.agentDir) : getDefaultAgentDir();\n  let resourceLoader = options.resourceLoader;\n\n  // Use provided or create AuthStorage and ModelRegistry\n  const authPath = options.agentDir ? join(agentDir, \"auth.json\") : undefined;\n  const modelsPath = options.agentDir\n    ? join(agentDir, \"models.json\")\n    : undefined;\n  const authStorage = options.authStorage ?? AuthStorage.create(authPath);\n  const modelRegistry =\n    options.modelRegistry ?? ModelRegistry.create(authStorage, modelsPath);\n\n  const settingsManager =\n    options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n  const sessionManager =\n    options.sessionManager ??\n    SessionManager.create(cwd, getDefaultSessionDir(cwd, agentDir));\n\n  if (!resourceLoader) {\n    resourceLoader = new DefaultResourceLoader({\n      cwd,\n      agentDir,\n      settingsManager,\n    });\n    await resourceLoader.reload();\n    time(\"resourceLoader.reload\");\n  }\n\n  // Check if session has existing data to restore\n  const existingSession = sessionManager.buildSessionContext();\n  const hasExistingSession = existingSession.messages.length > 0;\n  const hasThinkingEntry = sessionManager\n    .getBranch()\n    .some((entry) => entry.type === \"thinking_level_change\");\n\n  let model = options.model;\n  let modelFallbackMessage: string | undefined;\n\n  // If session has data, try to restore model from it\n  if (!model && hasExistingSession && existingSession.model) {\n    const restoredModel = modelRegistry.find(\n      existingSession.model.provider,\n      existingSession.model.modelId,\n    );\n    if (restoredModel && modelRegistry.hasConfiguredAuth(restoredModel)) {\n      model = restoredModel;\n    }\n    if (!model) {\n      modelFallbackMessage = `Could not restore model ${existingSession.model.provider}/${existingSession.model.modelId}`;\n    }\n  }\n\n  // If still no model, use findInitialModel (checks settings default, then provider defaults)\n  if (!model) {\n    const result = await findInitialModel({\n      scopedModels: [],\n      isContinuing: hasExistingSession,\n      defaultProvider: settingsManager.getDefaultProvider(),\n      defaultModelId: settingsManager.getDefaultModel(),\n      defaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),\n      modelRegistry,\n    });\n    model = result.model;\n    if (!model) {\n      modelFallbackMessage = formatNoModelsAvailableMessage();\n    } else if (modelFallbackMessage) {\n      modelFallbackMessage += `. Using ${model.provider}/${model.id}`;\n    }\n  }\n\n  let thinkingLevel = options.thinkingLevel;\n\n  // If session has data, restore thinking level from it\n  if (thinkingLevel === undefined && hasExistingSession) {\n    thinkingLevel = hasThinkingEntry\n      ? (existingSession.thinkingLevel as ThinkingLevel)\n      : (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);\n  }\n\n  // Fall back to settings default\n  if (thinkingLevel === undefined) {\n    thinkingLevel =\n      settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n  }\n\n  // Clamp to model capabilities\n  if (!model) {\n    thinkingLevel = \"off\";\n  } else {\n    thinkingLevel = clampThinkingLevel(model, thinkingLevel) as ThinkingLevel;\n  }\n\n  const allowedToolNames =\n    options.tools ?? (options.noTools === \"all\" ? [] : undefined);\n  const initialActiveToolNames: string[] = options.tools\n    ? [...options.tools]\n    : options.noTools\n      ? []\n      : [...defaultToolNames];\n\n  let agent: Agent;\n\n  // Create convertToLlm wrapper that filters images if blockImages is enabled (defense-in-depth)\n  const convertToLlmWithBlockImages = (messages: AgentMessage[]): Message[] => {\n    const converted = convertToLlm(messages);\n    // Check setting dynamically so mid-session changes take effect\n    if (!settingsManager.getBlockImages()) {\n      return converted;\n    }\n    // Filter out ImageContent from all messages, replacing with text placeholder\n    return converted.map((msg) => {\n      if (msg.role === \"user\" || msg.role === \"toolResult\") {\n        const content = msg.content;\n        if (Array.isArray(content)) {\n          const hasImages = content.some((c) => c.type === \"image\");\n          if (hasImages) {\n            const filteredContent = content\n              .map((c) =>\n                c.type === \"image\"\n                  ? {\n                      type: \"text\" as const,\n                      text: \"Image reading is disabled.\",\n                    }\n                  : c,\n              )\n              .filter(\n                (c, i, arr) =>\n                  // Dedupe consecutive \"Image reading is disabled.\" texts\n                  !(\n                    c.type === \"text\" &&\n                    c.text === \"Image reading is disabled.\" &&\n                    i > 0 &&\n                    arr[i - 1].type === \"text\" &&\n                    (arr[i - 1] as { type: \"text\"; text: string }).text ===\n                      \"Image reading is disabled.\"\n                  ),\n              );\n            return { ...msg, content: filteredContent };\n          }\n        }\n      }\n      return msg;\n    });\n  };\n\n  const extensionRunnerRef: { current?: ExtensionRunner } = {};\n  const isCodexFastModeEnabled = (requestModel: Model<Api>): boolean =>\n    shouldApplyCodexFastMode(\n      requestModel,\n      settingsManager.getCodexFastModeSettings(),\n      options.orchestrationContext,\n    );\n\n  agent = new Agent({\n    initialState: {\n      systemPrompt: \"\",\n      model,\n      thinkingLevel,\n      tools: [],\n    },\n    convertToLlm: convertToLlmWithBlockImages,\n    streamFn: async (model, context, streamOptions) => {\n      const auth = await modelRegistry.getApiKeyAndHeaders(model);\n      if (!auth.ok) {\n        throw new Error(auth.error);\n      }\n      const providerRetrySettings = settingsManager.getProviderRetrySettings();\n      const attributionHeaders = getAttributionHeaders(model, settingsManager, streamOptions?.sessionId);\n      const fastModeEnabled = isCodexFastModeEnabled(model);\n      const codexFastModeStreamOptions = withCodexFastModeStreamOptions(\n        {\n          ...streamOptions,\n          apiKey: auth.apiKey,\n          timeoutMs: streamOptions?.timeoutMs ?? providerRetrySettings.timeoutMs,\n          maxRetries: streamOptions?.maxRetries ?? providerRetrySettings.maxRetries,\n          maxRetryDelayMs:\n            streamOptions?.maxRetryDelayMs ?? providerRetrySettings.maxRetryDelayMs,\n          headers:\n            attributionHeaders || auth.headers || streamOptions?.headers\n              ? { ...attributionHeaders, ...auth.headers, ...streamOptions?.headers }\n              : undefined,\n        },\n        fastModeEnabled,\n      );\n      if (modelRegistry.hasRegisteredStreamSimpleForApi(model.api)) {\n        return streamSimple(model, context, codexFastModeStreamOptions);\n      }\n      return streamWithCodexFastMode(model, context, codexFastModeStreamOptions);\n    },\n    onPayload: async (payload, model) => {\n      const fastModeEnabled = isCodexFastModeEnabled(model);\n      const guardedPayload = withCodexFastModePayload(payload, fastModeEnabled);\n      const runner = extensionRunnerRef.current;\n      if (!runner?.hasHandlers(\"before_provider_request\")) {\n        return guardedPayload;\n      }\n      return runner.emitBeforeProviderRequest(guardedPayload);\n    },\n    onResponse: async (response, _model) => {\n      const runner = extensionRunnerRef.current;\n      if (!runner?.hasHandlers(\"after_provider_response\")) {\n        return;\n      }\n      await runner.emit({\n        type: \"after_provider_response\",\n        status: response.status,\n        headers: response.headers,\n      });\n    },\n    sessionId: sessionManager.getSessionId(),\n    transformContext: async (messages) => {\n      const runner = extensionRunnerRef.current;\n      if (!runner) return messages;\n      return runner.emitContext(messages);\n    },\n    steeringMode: settingsManager.getSteeringMode(),\n    followUpMode: settingsManager.getFollowUpMode(),\n    transport: settingsManager.getTransport(),\n    thinkingBudgets: settingsManager.getThinkingBudgets(),\n    maxRetryDelayMs: settingsManager.getProviderRetrySettings().maxRetryDelayMs,\n  });\n\n  // Restore messages if session has existing data\n  if (hasExistingSession) {\n    agent.state.messages = existingSession.messages;\n    if (!hasThinkingEntry) {\n      sessionManager.appendThinkingLevelChange(thinkingLevel);\n    }\n  } else {\n    // Save initial model and thinking level for new sessions so they can be restored on resume\n    if (model) {\n      sessionManager.appendModelChange(model.provider, model.id);\n    }\n    sessionManager.appendThinkingLevelChange(thinkingLevel);\n  }\n\n  const session = new AgentSession({\n    agent,\n    sessionManager,\n    settingsManager,\n    cwd,\n    scopedModels: options.scopedModels,\n    resourceLoader,\n    customTools: options.customTools,\n    modelRegistry,\n    initialActiveToolNames,\n    allowedToolNames,\n    excludedToolNames: options.excludedTools,\n    extensionRunnerRef,\n    sessionStartEvent: options.sessionStartEvent,\n    orchestrationContext: options.orchestrationContext,\n  });\n  const extensionsResult = resourceLoader.getExtensions();\n\n  return {\n    session,\n    extensionsResult,\n    modelFallbackMessage,\n  };\n}\n"]}
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport {\n  Agent,\n  type AgentMessage,\n  type ThinkingLevel,\n} from \"@earendil-works/pi-agent-core\";\nimport {\n  clampThinkingLevel,\n  type Api,\n  type Message,\n  type Model,\n  streamSimple,\n} from \"@earendil-works/pi-ai\";\nimport { getAgentDir } from \"../config.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { AgentSession } from \"./agent-session.ts\";\nimport { formatNoModelsAvailableMessage } from \"./auth-guidance.ts\";\nimport { AuthStorage } from \"./auth-storage.ts\";\nimport {\n  shouldApplyCodexFastMode,\n  streamWithCodexFastMode,\n  withCodexFastModePayload,\n  withCodexFastModeStreamOptions,\n} from \"./codex-fast-mode.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type {\n  ExtensionRunner,\n  LoadExtensionsResult,\n  OrchestrationContext,\n  SessionStartEvent,\n  ToolDefinition,\n} from \"./extensions/index.ts\";\nimport { convertToLlm } from \"./messages.ts\";\nimport { ModelRegistry } from \"./model-registry.ts\";\nimport { findInitialModel } from \"./model-resolver.ts\";\nimport type { ResourceLoader } from \"./resource-loader.ts\";\nimport { DefaultResourceLoader } from \"./resource-loader.ts\";\nimport { getDefaultSessionDir, SessionManager } from \"./session-manager.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\nimport { mergeProviderAttributionHeaders } from \"./provider-attribution.ts\";\nimport { time } from \"./timings.ts\";\nimport {\n  createBashTool,\n  createCodingTools,\n  createEditTool,\n  createFindTool,\n  createGrepTool,\n  createLsTool,\n  createReadOnlyTools,\n  createReadTool,\n  createWriteTool,\n  defaultToolNames,\n  withFileMutationQueue,\n} from \"./tools/index.ts\";\n\nexport interface CreateAgentSessionOptions {\n  /** Working directory for project-local discovery. Default: process.cwd() */\n  cwd?: string;\n  /** Global config directory. Default: ~/.atomic/agent */\n  agentDir?: string;\n\n  /** Auth storage for credentials. Default: AuthStorage.create(agentDir/auth.json) */\n  authStorage?: AuthStorage;\n  /** Model registry. Default: ModelRegistry.create(authStorage, agentDir/models.json) */\n  modelRegistry?: ModelRegistry;\n\n  /** Model to use. Default: from settings, else first available */\n  model?: Model<Api>;\n  /** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */\n  thinkingLevel?: ThinkingLevel;\n  /** Models available for cycling (Ctrl+P in interactive mode) */\n  scopedModels?: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>;\n\n  /**\n   * Optional default tool suppression mode when no explicit allowlist is provided.\n   *\n   * - \"all\": start with no tools enabled\n   * - \"builtin\": disable the default built-in tools (read, bash, edit, write,\n   *   ask_user_question, todo) but keep extension/custom tools enabled\n   */\n  noTools?: \"all\" | \"builtin\";\n  /**\n   * Optional allowlist of tool names.\n   *\n   * When omitted, pi enables the default built-in tools (read, bash, edit, write,\n   * ask_user_question, todo) and leaves extension/custom tools enabled unless\n   * `noTools` changes that default.\n   * When provided, only the listed tool names are enabled, minus any names in\n   * `excludedTools`.\n   */\n  tools?: string[];\n  /**\n   * Optional blocklist of tool names.\n   *\n   * Matching built-in, extension, and SDK custom tools are omitted from the\n   * final session tool registry and active tool set. Unknown names are ignored.\n   */\n  excludedTools?: string[];\n  /** Custom tools to register (in addition to built-in tools). */\n  customTools?: ToolDefinition[];\n\n  /** Resource loader. When omitted, DefaultResourceLoader is used. */\n  resourceLoader?: ResourceLoader;\n\n  /** Session manager. Default: SessionManager.create(cwd) */\n  sessionManager?: SessionManager;\n\n  /** Settings manager. Default: SettingsManager.create(cwd, agentDir) */\n  settingsManager?: SettingsManager;\n  /** Session start event metadata for extension runtime startup. */\n  sessionStartEvent?: SessionStartEvent;\n  /** Session-scoped orchestration policy exposed to extension/tool handlers. */\n  orchestrationContext?: OrchestrationContext;\n}\n\n/** Result from createAgentSession */\nexport interface CreateAgentSessionResult {\n  /** The created session */\n  session: AgentSession;\n  /** Extensions result (for UI context setup in interactive mode) */\n  extensionsResult: LoadExtensionsResult;\n  /** Warning if session was restored with a different model than saved */\n  modelFallbackMessage?: string;\n}\n\n// Re-exports\n\nexport * from \"./agent-session-runtime.ts\";\nexport type {\n  ExtensionAPI,\n  ExtensionCommandContext,\n  ExtensionContext,\n  ExtensionFactory,\n  SlashCommandInfo,\n  SlashCommandSource,\n  ToolDefinition,\n} from \"./extensions/index.ts\";\nexport type { PromptTemplate } from \"./prompt-templates.ts\";\nexport type { Skill } from \"./skills.ts\";\nexport type { Tool } from \"./tools/index.ts\";\n\nexport {\n  withFileMutationQueue,\n  // Tool factories (for custom cwd)\n  createCodingTools,\n  createReadOnlyTools,\n  createReadTool,\n  createBashTool,\n  createEditTool,\n  createWriteTool,\n  createGrepTool,\n  createFindTool,\n  createLsTool,\n};\n\n// Helper Functions\n\nfunction getDefaultAgentDir(): string {\n  return getAgentDir();\n}\n\n/**\n * Create an AgentSession with the specified options.\n *\n * @example\n * ```typescript\n * // Minimal - uses defaults\n * const { session } = await createAgentSession();\n *\n * // With explicit model\n * import { getModel } from '@earendil-works/pi-ai';\n * const { session } = await createAgentSession({\n *   model: getModel('anthropic', 'claude-opus-4-5'),\n *   thinkingLevel: 'high',\n * });\n *\n * // Continue previous session\n * const { session, modelFallbackMessage } = await createAgentSession({\n *   continueSession: true,\n * });\n *\n * // Full control\n * const loader = new DefaultResourceLoader({\n *   cwd: process.cwd(),\n *   agentDir: getAgentDir(),\n *   settingsManager: SettingsManager.create(),\n * });\n * await loader.reload();\n * const { session } = await createAgentSession({\n *   model: myModel,\n *   tools: [\"read\", \"bash\"],\n *   resourceLoader: loader,\n *   sessionManager: SessionManager.inMemory(),\n * });\n * ```\n */\nexport async function createAgentSession(\n  options: CreateAgentSessionOptions = {},\n): Promise<CreateAgentSessionResult> {\n  const cwd = resolvePath(options.cwd ?? options.sessionManager?.getCwd() ?? process.cwd());\n  const agentDir = options.agentDir ? resolvePath(options.agentDir) : getDefaultAgentDir();\n  let resourceLoader = options.resourceLoader;\n\n  // Use provided or create AuthStorage and ModelRegistry\n  const authPath = options.agentDir ? join(agentDir, \"auth.json\") : undefined;\n  const modelsPath = options.agentDir\n    ? join(agentDir, \"models.json\")\n    : undefined;\n  const authStorage = options.authStorage ?? AuthStorage.create(authPath);\n  const modelRegistry =\n    options.modelRegistry ?? ModelRegistry.create(authStorage, modelsPath);\n\n  const settingsManager =\n    options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n  const sessionManager =\n    options.sessionManager ??\n    SessionManager.create(cwd, getDefaultSessionDir(cwd, agentDir));\n\n  if (!resourceLoader) {\n    resourceLoader = new DefaultResourceLoader({\n      cwd,\n      agentDir,\n      settingsManager,\n    });\n    await resourceLoader.reload();\n    time(\"resourceLoader.reload\");\n  }\n\n  // Check if session has existing data to restore\n  const existingSession = sessionManager.buildSessionContext();\n  const hasExistingSession = existingSession.messages.length > 0;\n  const hasThinkingEntry = sessionManager\n    .getBranch()\n    .some((entry) => entry.type === \"thinking_level_change\");\n\n  let model = options.model;\n  let modelFallbackMessage: string | undefined;\n\n  // If session has data, try to restore model from it\n  if (!model && hasExistingSession && existingSession.model) {\n    const restoredModel = modelRegistry.find(\n      existingSession.model.provider,\n      existingSession.model.modelId,\n    );\n    if (restoredModel && modelRegistry.hasConfiguredAuth(restoredModel)) {\n      model = restoredModel;\n    }\n    if (!model) {\n      modelFallbackMessage = `Could not restore model ${existingSession.model.provider}/${existingSession.model.modelId}`;\n    }\n  }\n\n  // If still no model, use findInitialModel (checks settings default, then provider defaults)\n  if (!model) {\n    const result = await findInitialModel({\n      scopedModels: [],\n      isContinuing: hasExistingSession,\n      defaultProvider: settingsManager.getDefaultProvider(),\n      defaultModelId: settingsManager.getDefaultModel(),\n      defaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),\n      modelRegistry,\n    });\n    model = result.model;\n    if (!model) {\n      modelFallbackMessage = formatNoModelsAvailableMessage();\n    } else if (modelFallbackMessage) {\n      modelFallbackMessage += `. Using ${model.provider}/${model.id}`;\n    }\n  }\n\n  let thinkingLevel = options.thinkingLevel;\n\n  // If session has data, restore thinking level from it\n  if (thinkingLevel === undefined && hasExistingSession) {\n    thinkingLevel = hasThinkingEntry\n      ? (existingSession.thinkingLevel as ThinkingLevel)\n      : (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);\n  }\n\n  // Fall back to settings default\n  if (thinkingLevel === undefined) {\n    thinkingLevel =\n      settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n  }\n\n  // Clamp to model capabilities\n  if (!model) {\n    thinkingLevel = \"off\";\n  } else {\n    thinkingLevel = clampThinkingLevel(model, thinkingLevel) as ThinkingLevel;\n  }\n\n  const allowedToolNames =\n    options.tools ?? (options.noTools === \"all\" ? [] : undefined);\n  const initialActiveToolNames: string[] = options.tools\n    ? [...options.tools]\n    : options.noTools\n      ? []\n      : [...defaultToolNames];\n\n  let agent: Agent;\n\n  // Create convertToLlm wrapper that filters images if blockImages is enabled (defense-in-depth)\n  const convertToLlmWithBlockImages = (messages: AgentMessage[]): Message[] => {\n    const converted = convertToLlm(messages);\n    // Check setting dynamically so mid-session changes take effect\n    if (!settingsManager.getBlockImages()) {\n      return converted;\n    }\n    // Filter out ImageContent from all messages, replacing with text placeholder\n    return converted.map((msg) => {\n      if (msg.role === \"user\" || msg.role === \"toolResult\") {\n        const content = msg.content;\n        if (Array.isArray(content)) {\n          const hasImages = content.some((c) => c.type === \"image\");\n          if (hasImages) {\n            const filteredContent = content\n              .map((c) =>\n                c.type === \"image\"\n                  ? {\n                      type: \"text\" as const,\n                      text: \"Image reading is disabled.\",\n                    }\n                  : c,\n              )\n              .filter(\n                (c, i, arr) =>\n                  // Dedupe consecutive \"Image reading is disabled.\" texts\n                  !(\n                    c.type === \"text\" &&\n                    c.text === \"Image reading is disabled.\" &&\n                    i > 0 &&\n                    arr[i - 1].type === \"text\" &&\n                    (arr[i - 1] as { type: \"text\"; text: string }).text ===\n                      \"Image reading is disabled.\"\n                  ),\n              );\n            return { ...msg, content: filteredContent };\n          }\n        }\n      }\n      return msg;\n    });\n  };\n\n  const extensionRunnerRef: { current?: ExtensionRunner } = {};\n  const isCodexFastModeEnabled = (requestModel: Model<Api>): boolean =>\n    shouldApplyCodexFastMode(\n      requestModel,\n      settingsManager.getCodexFastModeSettings(),\n      options.orchestrationContext,\n    );\n\n  agent = new Agent({\n    initialState: {\n      systemPrompt: \"\",\n      model,\n      thinkingLevel,\n      tools: [],\n    },\n    convertToLlm: convertToLlmWithBlockImages,\n    streamFn: async (model, context, streamOptions) => {\n      const auth = await modelRegistry.getApiKeyAndHeaders(model);\n      if (!auth.ok) {\n        throw new Error(auth.error);\n      }\n      const providerRetrySettings = settingsManager.getProviderRetrySettings();\n      const httpIdleTimeoutMs = settingsManager.getHttpIdleTimeoutMs();\n      // SDKs treat timeout=0 as 0ms (immediate timeout), not \"no timeout\".\n      // Use max int32 to effectively disable the timeout.\n      const effectiveTimeoutMs = httpIdleTimeoutMs === 0 ? 2147483647 : httpIdleTimeoutMs;\n      const timeoutMs = streamOptions?.timeoutMs ?? providerRetrySettings.timeoutMs ?? effectiveTimeoutMs;\n      const websocketConnectTimeoutMs =\n        streamOptions?.websocketConnectTimeoutMs ?? settingsManager.getWebSocketConnectTimeoutMs();\n      const attributionHeaders = mergeProviderAttributionHeaders(\n        model,\n        settingsManager,\n        streamOptions?.sessionId,\n        auth.headers,\n        streamOptions?.headers,\n      );\n      const fastModeEnabled = isCodexFastModeEnabled(model);\n      const codexFastModeStreamOptions = withCodexFastModeStreamOptions(\n        {\n          ...streamOptions,\n          apiKey: auth.apiKey,\n          timeoutMs,\n          websocketConnectTimeoutMs,\n          maxRetries: streamOptions?.maxRetries ?? providerRetrySettings.maxRetries,\n          maxRetryDelayMs:\n            streamOptions?.maxRetryDelayMs ?? providerRetrySettings.maxRetryDelayMs,\n          headers: attributionHeaders,\n        },\n        fastModeEnabled,\n      );\n      if (modelRegistry.hasRegisteredStreamSimpleForApi(model.api)) {\n        return streamSimple(model, context, codexFastModeStreamOptions);\n      }\n      return streamWithCodexFastMode(model, context, codexFastModeStreamOptions);\n    },\n    onPayload: async (payload, model) => {\n      const fastModeEnabled = isCodexFastModeEnabled(model);\n      const guardedPayload = withCodexFastModePayload(payload, fastModeEnabled);\n      const runner = extensionRunnerRef.current;\n      if (!runner?.hasHandlers(\"before_provider_request\")) {\n        return guardedPayload;\n      }\n      return runner.emitBeforeProviderRequest(guardedPayload);\n    },\n    onResponse: async (response, _model) => {\n      const runner = extensionRunnerRef.current;\n      if (!runner?.hasHandlers(\"after_provider_response\")) {\n        return;\n      }\n      await runner.emit({\n        type: \"after_provider_response\",\n        status: response.status,\n        headers: response.headers,\n      });\n    },\n    sessionId: sessionManager.getSessionId(),\n    transformContext: async (messages) => {\n      const runner = extensionRunnerRef.current;\n      if (!runner) return messages;\n      return runner.emitContext(messages);\n    },\n    steeringMode: settingsManager.getSteeringMode(),\n    followUpMode: settingsManager.getFollowUpMode(),\n    transport: settingsManager.getTransport(),\n    thinkingBudgets: settingsManager.getThinkingBudgets(),\n    maxRetryDelayMs: settingsManager.getProviderRetrySettings().maxRetryDelayMs,\n  });\n\n  // Restore messages if session has existing data\n  if (hasExistingSession) {\n    agent.state.messages = existingSession.messages;\n    if (!hasThinkingEntry) {\n      sessionManager.appendThinkingLevelChange(thinkingLevel);\n    }\n  } else {\n    // Save initial model and thinking level for new sessions so they can be restored on resume\n    if (model) {\n      sessionManager.appendModelChange(model.provider, model.id);\n    }\n    sessionManager.appendThinkingLevelChange(thinkingLevel);\n  }\n\n  const session = new AgentSession({\n    agent,\n    sessionManager,\n    settingsManager,\n    cwd,\n    scopedModels: options.scopedModels,\n    resourceLoader,\n    customTools: options.customTools,\n    modelRegistry,\n    initialActiveToolNames,\n    allowedToolNames,\n    excludedToolNames: options.excludedTools,\n    extensionRunnerRef,\n    sessionStartEvent: options.sessionStartEvent,\n    orchestrationContext: options.orchestrationContext,\n  });\n  const extensionsResult = resourceLoader.getExtensions();\n\n  return {\n    session,\n    extensionsResult,\n    modelFallbackMessage,\n  };\n}\n"]}

package/dist/core/session-manager.d.ts

@@ -159,6 +159,7 @@ export interface SessionInfo {
     allMessagesText: string;
 }
 export type ReadonlySessionManager = Pick<SessionManager, "getCwd" | "getSessionDir" | "getSessionId" | "getSessionFile" | "getLeafId" | "getLeafEntry" | "getEntry" | "getLabel" | "getBranch" | "getHeader" | "getEntries" | "getTree" | "getSessionName">;
+export declare function assertValidSessionId(id: string): void;
 /** Exported for testing */
 export declare function migrateSessionEntries(entries: FileEntry[]): void;
 /** Exported for compaction.test.ts */
@@ -181,15 +182,11 @@ export declare function buildContextDeletionFilteredPath(path: SessionEntry[], f
  * Applies context-deletion filtering and includes branch summaries along the path.
  */
 export declare function buildSessionContext(entries: SessionEntry[], leafId?: string | null, byId?: Map<string, SessionEntry>): SessionContext;
-/**
- * Compute the default session directory for a cwd.
- * Encodes cwd into a safe directory name under ~/.atomic/agent/sessions/.
- */
 export declare function getDefaultSessionDir(cwd: string, agentDir?: string): string;
 /** Exported for testing */
 export declare function loadEntriesFromFile(filePath: string): FileEntry[];
 /** Exported for testing */
-export declare function findMostRecentSession(sessionDir: string): string | null;
+export declare function findMostRecentSession(sessionDir: string, cwd?: string): string | null;
 export type SessionListProgress = (loaded: number, total: number) => void;
 /**
  * Manages conversation sessions as append-only trees stored in JSONL files.
@@ -223,6 +220,7 @@ export declare class SessionManager {
     isPersisted(): boolean;
     getCwd(): string;
     getSessionDir(): string;
+    usesDefaultSessionDir(): boolean;
     getSessionId(): string;
     getSessionFile(): string | undefined;
     _persist(entry: SessionEntry): void;
@@ -332,7 +330,7 @@ export declare class SessionManager {
      * @param cwd Working directory (stored in session header)
      * @param sessionDir Optional session directory. If omitted, uses default (~/.atomic/agent/sessions/<encoded-cwd>/).
      */
-    static create(cwd: string, sessionDir?: string): SessionManager;
+    static create(cwd: string, sessionDir?: string, options?: NewSessionOptions): SessionManager;
     /**
      * Open a specific session file.
      * @param path Path to session file
@@ -355,7 +353,7 @@ export declare class SessionManager {
      * @param targetCwd Target working directory (where the new session will be stored)
      * @param sessionDir Optional session directory. If omitted, uses default for targetCwd.
      */
-    static forkFrom(sourcePath: string, targetCwd: string, sessionDir?: string): SessionManager;
+    static forkFrom(sourcePath: string, targetCwd: string, sessionDir?: string, options?: NewSessionOptions): SessionManager;
     /**
      * List all sessions for a directory.
      * @param cwd Working directory (used to compute default session directory)
@@ -368,5 +366,6 @@ export declare class SessionManager {
      * @param onProgress Optional callback for progress updates (loaded, total)
      */
     static listAll(onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+    static listAll(sessionDir?: string, onProgress?: SessionListProgress): Promise<SessionInfo[]>;
 }
 //# sourceMappingURL=session-manager.d.ts.map