@downcity/agent 1.1.238 → 1.1.259

package/src/executor/tools/file/ReadImageToolBridge.ts

@@ -0,0 +1,79 @@
+/**
+ * read 图片结果与模型 UserMessage 的桥接。
+ *
+ * 关键点（中文）
+ * - Shell read 只负责把图片读取为 data URL。
+ * - Agent 在当前 turn 的下一 step 注入临时 user file part，不写入长期历史。
+ * - 注入后从普通 tool result 移除 data URL，避免图片同时作为 JSON 内容传给模型。
+ */
+
+import path from "node:path";
+import { generateId } from "@/utils/Id.js";
+import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
+
+/** 把普通对象归一为可检查的记录。 */
+function to_record(value: unknown): Record<string, unknown> | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value as Record<string, unknown>;
+}
+
+/**
+ * 在 read 返回图片时注入下一 step，并返回不含 data URL 的 tool result。
+ */
+export function inject_read_image_user_message(params: {
+  /** 当前工具名称。 */
+  tool_name: string;
+  /** 工具原始执行结果。 */
+  output: unknown;
+  /** 当前 Session turn 的显式运行上下文。 */
+  run_context: SessionRunContext;
+}): unknown {
+  if (params.tool_name !== "read") return params.output;
+  const output = to_record(params.output);
+  if (!output || output.success !== true || output.type !== "image") {
+    return params.output;
+  }
+  const data_url = String(output.data_url || "").trim();
+  const media_type = String(output.mime_type || "").trim();
+  const file_path = String(output.file_path || "").trim();
+  if (!data_url.startsWith("data:image/") || !media_type.startsWith("image/")) {
+    return params.output;
+  }
+
+  params.run_context.injectedUserMessages.push({
+    id: `read-image:${generateId()}`,
+    role: "user",
+    metadata: {
+      v: 1,
+      ts: Date.now(),
+      sessionId: params.run_context.sessionId,
+      ...(params.run_context.turnId
+        ? { turnId: params.run_context.turnId }
+        : {}),
+      source: "ingress",
+      kind: "normal",
+      extra: {
+        internal: "read_image",
+        file_path,
+      },
+    },
+    parts: [
+      {
+        type: "text",
+        text: `Image read from ${file_path || "project file"}.`,
+      },
+      {
+        type: "file",
+        mediaType: media_type,
+        url: data_url,
+        ...(file_path ? { filename: path.basename(file_path) } : {}),
+      },
+    ],
+  });
+
+  const { data_url: _data_url, ...result } = output;
+  return {
+    ...result,
+    image_attached: true,
+  };
+}

package/src/executor/tools/plugin/PluginToolBridge.ts

@@ -25,10 +25,6 @@ import {
   materializeAssistantFileParts,
   resolveAgentFilePath,
 } from "@executor/messages/AssistantFileResource.js";
-import {
-  enqueueAssistantFileParts,
-  getSessionRunContext,
-} from "@executor/SessionRunScope.js";
 
 /**
  * 判断值是否为普通对象。
@@ -138,13 +134,15 @@ export async function invokePluginCallTool(
   }
 
   try {
-    const plugins = getSessionRunContext()?.agentPlugins || params.plugins;
+    const run_context = params.run_context;
+    const plugins = run_context.agentPlugins || params.plugins;
     const result = await plugins.runAction({
       plugin,
       action,
       payload,
+      run_context,
     });
-    const project_root = resolve_project_root(getSessionRunContext()?.projectRoot);
+    const project_root = resolve_project_root(run_context.projectRoot);
     const raw_file_parts = result.success
       ? extract_assistant_file_parts(result.data)
       : [];
@@ -157,7 +155,7 @@ export async function invokePluginCallTool(
         : [];
     const files = summarize_materialized_files(file_parts, project_root);
     if (file_parts.length > 0) {
-      enqueueAssistantFileParts(file_parts);
+      run_context.pendingAssistantFileParts.push(...file_parts);
     }
     const data = summarize_action_data(result.data);
     return {
@@ -192,7 +190,7 @@ export async function invokePluginReadTool(
 ): Promise<PluginReadToolResult> {
   const input: PluginReadInput = params.input;
   try {
-    const plugins = getSessionRunContext()?.agentPlugins || params.plugins;
+    const plugins = params.run_context.agentPlugins || params.plugins;
     const data = plugins.read({
       plugin: typeof input.plugin === "string" ? input.plugin : undefined,
       action: typeof input.action === "string" ? input.action : undefined,

package/src/executor/tools/plugin/PluginToolDefinition.ts

@@ -7,7 +7,7 @@
  * - 插件业务输出若包含 UIMessage file parts，会由 bridge 并入最终 assistant 消息。
  */
 
-import { tool } from "ai";
+import { tool, type ToolExecutionOptions } from "ai";
 import type {
   PluginCallInput,
   PluginReadInput,
@@ -24,6 +24,24 @@ import {
   plugin_call_input_schema,
   plugin_read_input_schema,
 } from "./PluginToolSchemas.js";
+import type { SessionToolExecutionContext } from "@/types/executor/SessionToolExecutionContext.js";
+import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
+
+/**
+ * 要求当前 plugin tool 具有 Executor 显式绑定的 Session 上下文。
+ */
+function require_run_context(
+  options: ToolExecutionOptions,
+): SessionRunContext {
+  const execution_context = options.experimental_context as
+    | Partial<SessionToolExecutionContext>
+    | undefined;
+  const run_context = execution_context?.session_run_context;
+  if (!run_context) {
+    throw new Error("plugin tool requires an explicit session run context");
+  }
+  return run_context;
+}
 
 /**
  * 创建 `plugin_call`：调用当前 Agent 已注册 plugin action。
@@ -33,9 +51,10 @@ export function createPluginCallTool(options: CreatePluginToolsOptions) {
     description:
       "Call a registered agent plugin action. Use plugin_read first when you need the action list, input schema, or examples. Generated files may be attached to the final assistant message automatically.",
     inputSchema: plugin_call_input_schema,
-    execute: async (input) =>
+    execute: async (input, execution_options) =>
       await invokePluginCallTool({
         plugins: options.plugins,
+        run_context: require_run_context(execution_options),
         input: input as PluginCallInput,
       }),
   });
@@ -49,9 +68,10 @@ export function createPluginReadTool(options: CreatePluginToolsOptions) {
     description:
       "Read registered agent plugin metadata, including action names, descriptions, input schemas, and examples. Use this before plugin_call when the payload shape is unclear.",
     inputSchema: plugin_read_input_schema,
-    execute: async (input) =>
+    execute: async (input, execution_options) =>
       await invokePluginReadTool({
         plugins: options.plugins,
+        run_context: require_run_context(execution_options),
         input: input as PluginReadInput,
       }),
   });

package/src/executor/types/SessionHistoryMeta.ts

@@ -23,8 +23,6 @@ export type SessionHistoryMetaV1 = {
   title?: string;
   /** 当前 session 绑定模型的可读标签。 */
   modelLabel?: string;
-  /** 当前 session 绑定模型的稳定 ID，用于进程重启后恢复模型实例。 */
-  modelId?: string;
   /** 当前 session 已持久化记录数量，用于列表查询避免扫描完整历史。 */
   messageCount?: number;
   /** 当前 session 最后一条记录的用户可见摘要，用于列表预览。 */

package/src/index.ts

@@ -8,16 +8,16 @@
  */
 
 // Agent 入口
-export { Agent } from "./agent/local/Agent.js";
-export { RemoteAgent } from "./agent/remote/RemoteAgent.js";
+export { Agent } from "./agent/Agent.js";
+export { RemoteAgent } from "./remote/RemoteAgent.js";
 export { Session } from "./session/Session.js";
 export type { SessionOptions } from "./types/session/SessionOptions.js";
 export {
   inferAgentModelLabel,
   normalizeAgentModel,
   read_agent_model_context_window,
-} from "./model/CityModelAdapter.js";
-export type { AgentModel } from "./model/CityModelAdapter.js";
+} from "./agent/AgentModel.js";
+export type { AgentModel } from "./agent/AgentModel.js";
 export type {
   AgentArchiveSessionInput,
   AgentArchiveSessionsInput,
@@ -63,7 +63,6 @@ export type {
   SessionDeltaMutation,
   SessionMessageMutation,
   SessionMutation,
-  SessionMutationReply,
   SessionMutationSubscriber,
   SessionMutationUnsubscribe,
   SessionPartMutation,
@@ -107,14 +106,9 @@ export type {
   AgentSessionTurnHandle,
   AgentSessionTurnResult,
 } from "./types/sdk/AgentSessionTurn.js";
-export { AgentContext } from "./types/runtime/agent/AgentContext.js";
-export type {
-  AgentContextOptions,
-  InvokePluginPort,
-  SessionCollectionPort,
-  SessionPort,
-  StructuredConfig,
-} from "./types/runtime/agent/AgentContext.js";
+export { AgentContext } from "./agent/AgentContext.js";
+export type { SessionPort } from "./types/session/SessionPort.js";
+export type { StructuredConfig } from "./types/plugin/PluginConfig.js";
 
 // Plugin 作者 API
 export { BasePlugin } from "./plugin/core/BasePlugin.js";
@@ -129,39 +123,40 @@ export type {
 
 // Session 与即时执行集成
 export { Executor } from "./executor/Executor.js";
-export {
-  drainDeferredPersistedUserMessages,
-  drainInjectedUserMessages,
-  getSessionRunContext,
-  getSessionRunScope,
-  withSessionRunScope,
-} from "./executor/SessionRunScope.js";
-export { JsonlSessionHistoryComposer } from "./executor/composer/history/jsonl/JsonlSessionHistoryComposer.js";
-export { LocalSessionContextComposer } from "./executor/composer/context/LocalSessionContextComposer.js";
-export { JsonlSessionHistoryStore } from "./executor/store/history/jsonl/JsonlSessionHistoryStore.js";
-export { JsonlSessionCompactionComposer } from "./executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
-export type {
-  SessionCompactionComposer,
+export { DefaultSessionComposer } from "./session/DefaultSessionComposer.js";
+export { SessionMessages } from "./session/SessionMessages.js";
+export { JsonlSessionMessageStore } from "./session/messages/JsonlSessionMessageStore.js";
+export type {
+  AppendCompletedAssistantMessageInput,
+  AppendExternalSessionAssistantMessageInput,
+  AppendExternalSessionUserMessageInput,
+  AppendSessionErrorMessageInput,
+  AppendSessionPromptMessageInput,
+  AppendSessionUserMessageInput,
+  OpenSessionActionMessageInput,
+  OpenSessionAssistantMessageInput,
+  SessionMessagesOptions,
+} from "./types/session/SessionMessages.js";
+export type {
+  SessionComposer,
   SessionCompactionInput,
-} from "./executor/composer/compaction/SessionCompactionComposer.js";
-export type {
-  SessionContextComposer,
-  SessionContextComposeResult,
-} from "./executor/composer/context/SessionContextComposer.js";
-export type {
-  SessionHistoryComposer,
-  SessionHistoryPrepareInput,
-} from "./executor/composer/history/SessionHistoryComposer.js";
-export type { SessionSystemComposer } from "./executor/composer/system/SessionSystemComposer.js";
+  SessionCompactionPlan,
+  SessionComposeIdentity,
+  SessionComposeInput,
+  SessionComposeState,
+  SessionComposeTurn,
+  SessionStepInput,
+} from "./types/session/SessionComposer.js";
 export { DefaultSessionSystemComposer } from "./executor/composer/system/default/DefaultSessionSystemComposer.js";
 export { resolveSessionSystemMessages } from "./executor/composer/system/default/SystemDomain.js";
-export type { SessionHistoryStore } from "./executor/store/history/SessionHistoryStore.js";
 export type { SessionExecutor } from "./executor/types/SessionExecutor.js";
 export type {
   SessionAssistantStepCallback,
   SessionRunResult,
 } from "./executor/types/SessionRun.js";
 export type { SessionRunContext } from "./types/executor/SessionRunContext.js";
+export type { SessionToolExecutionContext } from "./types/executor/SessionToolExecutionContext.js";
+export type { PluginRunContext } from "./types/plugin/PluginRunContext.js";
 export type {
   SessionActionRecordV1,
   SessionMessageRecordV1,
@@ -174,11 +169,6 @@ export {
   is_session_message_record,
 } from "./executor/types/SessionRecords.js";
 export type { SessionSystemMessage } from "./executor/types/SessionPrompts.js";
-export type {
-  SessionComposerFactoryContext,
-  SessionComposerInput,
-  SessionComposerOptions,
-} from "./types/session/SessionComposerOptions.js";
 export { transformPromptsIntoSystemMessages } from "./executor/composer/system/default/PromptRenderer.js";
 // 通用 plugin 宿主工具
 export {
@@ -233,17 +223,14 @@ export {
   load_project_dotenv,
   resolve_agent_env,
 } from "./config/AgentEnv.js";
-export {
-  getDowncityChatHistoryPath,
-  getDowncitySessionMessagesPath,
-} from "./config/Paths.js";
+export { getDowncitySessionMessagesPath } from "./config/Paths.js";
 export {
   getPlatformStoreDbPath,
   getPlatformStoreKeyPath,
 } from "./config/PlatformPaths.js";
 export {
   ensureRuntimeProjectReady,
-} from "./agent/local/ProjectSetup.js";
+} from "./config/ProjectSetup.js";
 export { assertProjectExecutionTarget } from "./config/ExecutionBinding.js";
 
 // 日志
@@ -254,12 +241,6 @@ export {
   resolveRuntimeTimezone,
 } from "./utils/Time.js";
 
-// 宿主端口类型
-export type {
-  AgentPathRuntime,
-  AgentPluginConfigRuntime,
-} from "./types/agent/AgentRuntimeAssembly.js";
-
 // 项目协议类型
 export type {
   AgentProjectChannel,

package/src/plugin/core/ActionScheduleExecutor.ts

@@ -7,7 +7,7 @@
  * - 到期后重新走 `runPluginCommand`，复用 plugin action 的统一执行规则。
  */
 
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContext.js";
 import type { ActionScheduleStore } from "@/plugin/core/ActionScheduleStore.js";
 import { runPluginCommand } from "@/plugin/core/PluginActionRunner.js";
 

package/src/plugin/core/ActionScheduleRuntime.ts

@@ -7,7 +7,7 @@
  * - 普通 plugin 先启动，ActionSchedule 再开始轮询，避免到期 action 执行到未启动的 plugin。
  */
 
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContext.js";
 import { runDueActionScheduleJobs } from "@/plugin/core/ActionScheduleExecutor.js";
 import { ActionScheduleStore } from "@/plugin/core/ActionScheduleStore.js";
 

package/src/plugin/core/BasePlugin.ts

@@ -7,7 +7,7 @@
  * - Agent 注册 plugin 时自动启动 lifecycle；卸载时自动停止 lifecycle。
  */
 
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContext.js";
 import type { Plugin } from "@/types/plugin/PluginDefinition.js";
 import type { PluginActions } from "@/types/plugin/PluginAction.js";
 import type { PluginCommandContext, PluginLifecycle } from "@/types/plugin/PluginCommand.js";
@@ -22,7 +22,8 @@ import type {
   PluginSetupDefinition,
   PluginUsageDefinition,
 } from "@/types/plugin/PluginSetup.js";
-import type { StructuredConfig } from "@/types/runtime/agent/AgentContext.js";
+import type { StructuredConfig } from "@/types/plugin/PluginConfig.js";
+import type { PluginRunContext } from "@/types/plugin/PluginRunContext.js";
 
 /**
  * BasePlugin 抽象基类。
@@ -91,6 +92,9 @@ export abstract class BasePlugin implements Plugin {
   /**
    * Plugin system 文本提供器。
    */
-  system?(context: AgentContext): Promise<string> | string;
+  system?(
+    context: AgentContext,
+    run_context?: PluginRunContext,
+  ): Promise<string> | string;
 
 }

package/src/plugin/core/HookRegistry.ts

@@ -13,10 +13,7 @@ import type {
   PluginPipelineHook,
   PluginResolveHook,
 } from "@/types/plugin/PluginRuntime.js";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
-
-type ContextResolver = () => AgentContext;
-type PluginEnabledChecker = (pluginName: string, context: AgentContext) => boolean;
+import type { AgentContext } from "@/agent/AgentContext.js";
 
 type PipelineRecord = {
   pluginName: string;
@@ -42,8 +39,8 @@ type ResolveRecord = {
  * HookRegistry：plugin 点注册与执行实现。
  */
 export class HookRegistry {
-  private readonly contextResolver: ContextResolver;
-  private readonly pluginEnabledChecker: PluginEnabledChecker;
+  private readonly get_context: () => AgentContext;
+  private readonly is_plugin_ready: (plugin_name: string) => boolean;
 
   private readonly pipelineHooks = new Map<string, PipelineRecord[]>();
 
@@ -54,11 +51,11 @@ export class HookRegistry {
   private readonly resolveHooks = new Map<string, ResolveRecord>();
 
   constructor(params: {
-    contextResolver: ContextResolver;
-    pluginEnabledChecker: PluginEnabledChecker;
+    get_context: () => AgentContext;
+    is_plugin_ready: (plugin_name: string) => boolean;
   }) {
-    this.contextResolver = params.contextResolver;
-    this.pluginEnabledChecker = params.pluginEnabledChecker;
+    this.get_context = params.get_context;
+    this.is_plugin_ready = params.is_plugin_ready;
   }
 
   /**
@@ -208,10 +205,10 @@ export class HookRegistry {
     const bucket = this.pipelineHooks.get(key) || [];
     if (bucket.length === 0) return value;
 
-    const context = this.contextResolver();
+    const context = this.get_context();
     let current = value as JsonValue;
     for (const item of bucket) {
-      if (!this.pluginEnabledChecker(item.pluginName, context)) continue;
+      if (!this.is_plugin_ready(item.pluginName)) continue;
       current = await item.handler({
         context,
         value: current,
@@ -230,9 +227,9 @@ export class HookRegistry {
     const bucket = this.guardHooks.get(key) || [];
     if (bucket.length === 0) return;
 
-    const context = this.contextResolver();
+    const context = this.get_context();
     for (const item of bucket) {
-      if (!this.pluginEnabledChecker(item.pluginName, context)) continue;
+      if (!this.is_plugin_ready(item.pluginName)) continue;
       await item.handler({
         context,
         value: value as JsonValue,
@@ -250,9 +247,9 @@ export class HookRegistry {
     const bucket = this.effectHooks.get(key) || [];
     if (bucket.length === 0) return;
 
-    const context = this.contextResolver();
+    const context = this.get_context();
     for (const item of bucket) {
-      if (!this.pluginEnabledChecker(item.pluginName, context)) continue;
+      if (!this.is_plugin_ready(item.pluginName)) continue;
       await item.handler({
         context,
         value: value as JsonValue,
@@ -276,8 +273,8 @@ export class HookRegistry {
     if (!record) {
       throw new Error(`No plugin resolver registered for point: ${key}`);
     }
-    const context = this.contextResolver();
-    if (!this.pluginEnabledChecker(record.pluginName, context)) {
+    const context = this.get_context();
+    if (!this.is_plugin_ready(record.pluginName)) {
       throw new Error(`No active plugin resolver registered for point: ${key}`);
     }
 

package/src/plugin/core/PluginActionFactory.ts

@@ -8,7 +8,7 @@
  */
 
 import type { z } from "zod";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContext.js";
 import type { JsonValue } from "@/types/common/Json.js";
 import type {
   PluginAction,
@@ -35,7 +35,8 @@ import type {
   PluginUsageDefinition,
 } from "@/types/plugin/PluginSetup.js";
 import type { PluginHttpDefinition } from "@/types/plugin/PluginHttp.js";
-import type { StructuredConfig } from "@/types/runtime/agent/AgentContext.js";
+import type { StructuredConfig } from "@/types/plugin/PluginConfig.js";
+import type { PluginRunContext } from "@/types/plugin/PluginRunContext.js";
 
 /**
  * 从 Zod schema 推导 JSON 输入类型。
@@ -64,6 +65,8 @@ export interface CreatePluginActionOptions<
   execute: (params: {
     /** 当前执行上下文。 */
     context: AgentContext;
+    /** 当前 action 的显式 Session run 上下文。 */
+    run_context?: PluginRunContext;
     /** 已通过 schema 校验后的输入。 */
     input: P;
     /** 当前插件名称。 */
@@ -96,7 +99,10 @@ export interface CreatePluginOptions<TActions extends PluginActions> {
   /** Plugin resolve 集合。 */
   resolves?: PluginResolves;
   /** Plugin system 文本构建器。 */
-  system?: (context: AgentContext) => string | Promise<string>;
+  system?: (
+    context: AgentContext,
+    run_context?: PluginRunContext,
+  ) => string | Promise<string>;
   /** Plugin 生命周期定义。 */
   lifecycle?: PluginLifecycle;
   /** Plugin 可用性检查。 */

package/src/plugin/core/PluginActionRunner.ts

@@ -7,7 +7,7 @@
  * - 延迟调度仍复用本模块，保证 schedule 到点后走统一 action 规则。
  */
 
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContext.js";
 import type { PluginAction, PluginActionResult } from "@/types/plugin/PluginAction.js";
 import type { PluginCommandResult } from "@/types/plugin/PluginCommand.js";
 import type { PluginSnapshot } from "@/types/plugin/PluginState.js";

package/src/plugin/core/PluginCatalog.ts

@@ -9,7 +9,7 @@
 
 import type { Plugin } from "@/types/plugin/PluginDefinition.js";
 import type { PluginAvailability, PluginView } from "@/types/plugin/PluginRuntime.js";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContext.js";
 
 /**
  * 判断 plugin 是否声明了运行时生命周期。

package/src/plugin/core/PluginHttpRoutes.ts

@@ -8,7 +8,7 @@
 
 import type { Hono } from "hono";
 import type { Plugin } from "@/types/plugin/PluginDefinition.js";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
+import type { AgentContext } from "@/agent/AgentContext.js";
 import type { AuthRoutePolicy } from "@/types/runtime/auth/AuthRoute.js";
 
 function dedupeAuthPolicies(policies: AuthRoutePolicy[]): AuthRoutePolicy[] {

package/src/plugin/core/PluginLocalExecution.ts

@@ -11,24 +11,18 @@ import path from "node:path";
 import { getLogger } from "@/utils/logger/Logger.js";
 import { resolve_agent_env } from "@/config/AgentEnv.js";
 import { findPluginByName } from "@/plugin/core/PluginCatalog.js";
-import {
-  createAgentPathRuntime,
-  createAgentPluginConfigRuntime,
-} from "@/agent/local/AgentRuntimeAssembly.js";
-import { createFallbackSdkConfig } from "@/agent/local/AgentInstructions.js";
 import type { JsonValue } from "@/types/common/Json.js";
 import type { Plugin } from "@/types/plugin/PluginDefinition.js";
 import type { PluginActionResult } from "@/types/plugin/PluginAction.js";
 import type { PluginCommandContext } from "@/types/plugin/PluginCommand.js";
 import type { PluginAvailability } from "@/types/plugin/PluginRuntime.js";
-import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
-import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
+import type { AgentContext } from "@/agent/AgentContext.js";
 
 type LocalPluginCommandContextInput = {
   /** 当前项目根目录。 */
   projectRoot: string;
-  /** 宿主显式传入的 agent 配置。 */
-  config?: DowncityConfig;
+  /** 当前 Agent 稳定标识。 */
+  agent_id?: string;
 };
 
 /**
@@ -40,24 +34,17 @@ export function createLocalPluginCommandContext(
   const projectRoot = typeof input === "string" ? input : input.projectRoot;
   const rootPath = path.resolve(String(projectRoot || "").trim() || ".");
   const env = resolve_agent_env(rootPath);
-  const config = typeof input === "string" || !input.config
-    ? createFallbackSdkConfig(path.basename(rootPath) || "agent")
-    : input.config;
-  const agent_id = String(config.id || "").trim() || path.basename(rootPath) || "agent";
+  const agent_id = String(
+    typeof input === "string" ? "" : input.agent_id || "",
+  ).trim() || path.basename(rootPath) || "agent";
 
   const logger = getLogger(rootPath);
 
   return {
-    cwd: rootPath,
+    agent_id,
     rootPath,
     logger,
-    config,
     env,
-    paths: createAgentPathRuntime(
-      rootPath,
-      agent_id,
-    ),
-    pluginConfig: createAgentPluginConfigRuntime(rootPath),
   };
 }
 
@@ -68,7 +55,7 @@ export async function getLocalPluginAvailability(params: {
   plugins: Iterable<Plugin>;
   projectRoot: string;
   pluginName: string;
-  config?: DowncityConfig;
+  agent_id?: string;
 }): Promise<PluginAvailability> {
   const plugin = findPluginByName(params.plugins, params.pluginName);
   if (!plugin) {
@@ -81,7 +68,7 @@ export async function getLocalPluginAvailability(params: {
 
   const context = createLocalPluginCommandContext({
     projectRoot: params.projectRoot,
-    config: params.config,
+    agent_id: params.agent_id,
   });
   if (plugin.availability) {
     return await plugin.availability(context);
@@ -103,7 +90,7 @@ export async function runLocalPluginAction(params: {
   pluginName: string;
   actionName: string;
   payload?: JsonValue;
-  config?: DowncityConfig;
+  agent_id?: string;
 }): Promise<PluginActionResult<JsonValue>> {
   const plugin = findPluginByName(params.plugins, params.pluginName);
   if (!plugin) {
@@ -134,7 +121,7 @@ export async function runLocalPluginAction(params: {
 
   const context = createLocalPluginCommandContext({
     projectRoot: params.projectRoot,
-    config: params.config,
+    agent_id: params.agent_id,
   });
 
   try {