nolo-cli 0.1.19 → 0.1.20

package/ai/tools/listFilesTool.ts

@@ -1,6 +1,6 @@
 // 文件路径: packages/ai/tools/listFilesTool.ts
 
-import { getToolBaseUrl } from "./toolApiClient";
+import { buildToolRequestHeaders, getToolBaseUrl } from "./toolApiClient";
 
 // ---- Types ----
 
@@ -44,7 +44,7 @@ export const listFilesFunctionSchema = {
 export async function listFilesFunc(
     args: ListFilesArgs,
     thunkApi: any,
-    context?: { signal?: AbortSignal }
+    context?: { signal?: AbortSignal; agentKey?: string }
 ): Promise<{ rawData: any; displayData?: string }> {
     try {
         const baseUrl = getToolBaseUrl(thunkApi);
@@ -52,7 +52,10 @@ export async function listFilesFunc(
 
         const response = await fetch(apiUrl, {
             method: "POST",
-            headers: { "Content-Type": "application/json" },
+            headers: buildToolRequestHeaders(thunkApi, {
+                withAuth: true,
+                agentKey: context?.agentKey,
+            }),
             signal: context?.signal,
             body: JSON.stringify(args),
         });

package/ai/tools/localFilesTool.ts

@@ -0,0 +1,200 @@
+import { getToolBaseUrl } from "./toolApiClient";
+
+export type LocalFileOperation = {
+  kind: "mkdir" | "move" | "rename" | "writeText" | "deleteToTrash";
+  sourceRelativePath?: string;
+  destinationRelativePath?: string;
+  content?: string;
+  reason: string;
+  conflictPolicy: "skip" | "overwrite" | "rename";
+};
+
+type ToolResult = {
+  rawData: any;
+  displayData?: string;
+};
+
+type LocalFilesDeps = {
+  getBaseUrl?: (thunkApi: any) => string;
+  fetchImpl?: typeof fetch;
+};
+
+export const listLocalFilesFunctionSchema = {
+  name: "listLocalFiles",
+  description: "列出 Windows 桌面客户端中用户已授权本地文件夹内的文件和目录。只能访问已授权根目录内的相对路径。",
+  parameters: {
+    type: "object",
+    properties: {
+      rootId: { type: "string", description: "已授权的本地文件夹 ID。" },
+      relativePath: { type: "string", description: "相对已授权根目录的路径，例如 . 或 Documents。" },
+    },
+    required: ["rootId"],
+  },
+};
+
+export const readLocalFileFunctionSchema = {
+  name: "readLocalFile",
+  description: "读取 Windows 桌面客户端中用户已授权本地文件夹内的文本文件。路径必须是授权根目录内的相对路径。",
+  parameters: {
+    type: "object",
+    properties: {
+      rootId: { type: "string", description: "已授权的本地文件夹 ID。" },
+      relativePath: { type: "string", description: "相对已授权根目录的文本文件路径。" },
+    },
+    required: ["rootId", "relativePath"],
+  },
+};
+
+export const proposeLocalFileChangesFunctionSchema = {
+  name: "proposeLocalFileChanges",
+  description: "为用户已授权的本地文件夹创建整理计划。该工具只创建待确认计划，不会直接修改本地文件。",
+  parameters: {
+    type: "object",
+    properties: {
+      rootId: { type: "string", description: "已授权的本地文件夹 ID。" },
+      summary: { type: "string", description: "本次整理计划摘要。" },
+      operations: {
+        type: "array",
+        description: "待执行的文件操作列表。",
+        items: {
+          type: "object",
+          properties: {
+            kind: { type: "string", enum: ["mkdir", "move", "rename", "writeText", "deleteToTrash"] },
+            sourceRelativePath: { type: "string" },
+            destinationRelativePath: { type: "string" },
+            content: { type: "string" },
+            reason: { type: "string" },
+            conflictPolicy: { type: "string", enum: ["skip", "overwrite", "rename"] },
+          },
+          required: ["kind", "reason", "conflictPolicy"],
+        },
+      },
+      riskLevel: { type: "string", enum: ["low", "medium", "high"] },
+    },
+    required: ["rootId", "summary", "operations"],
+  },
+};
+
+export const executeApprovedLocalFileChangesFunctionSchema = {
+  name: "executeApprovedLocalFileChanges",
+  description: "执行用户已经确认的本地文件整理计划。必须传入 proposeLocalFileChanges 返回的 planId。",
+  parameters: {
+    type: "object",
+    properties: {
+      planId: { type: "string", description: "已确认计划的 ID。" },
+    },
+    required: ["planId"],
+  },
+};
+
+export const undoLocalFileChangeBatchFunctionSchema = {
+  name: "undoLocalFileChangeBatch",
+  description: "撤销一个本地文件整理批次中可撤销的移动或重命名操作。",
+  parameters: {
+    type: "object",
+    properties: {
+      batchId: { type: "string", description: "执行历史批次 ID。" },
+    },
+    required: ["batchId"],
+  },
+};
+
+export function createLocalFilesToolHandlers(deps: LocalFilesDeps = {}) {
+  const post = async (thunkApi: any, path: string, body: object, signal?: AbortSignal) => {
+    const baseUrl = (deps.getBaseUrl ?? getToolBaseUrl)(thunkApi).replace(/\/+$/, "");
+    const response = await (deps.fetchImpl ?? fetch)(`${baseUrl}${path}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      signal,
+      body: JSON.stringify(body),
+    });
+    const text = await response.text();
+    const data = text ? JSON.parse(text) : {};
+    if (!response.ok || data?.ok === false || data?.error) {
+      throw new Error(data?.error || `desktop files bridge failed: ${response.status}`);
+    }
+    return data;
+  };
+
+  return {
+    async list(args: { rootId: string; relativePath?: string }, thunkApi: any, context?: { signal?: AbortSignal }): Promise<ToolResult> {
+      requireString(args.rootId, "rootId");
+      const data = await post(thunkApi, "/api/desktop/files/list", {
+        rootId: args.rootId,
+        relativePath: args.relativePath || ".",
+      }, context?.signal);
+      return {
+        rawData: data,
+        displayData: `已列出本地文件: ${args.relativePath || "."}`,
+      };
+    },
+
+    async read(args: { rootId: string; relativePath: string }, thunkApi: any, context?: { signal?: AbortSignal }): Promise<ToolResult> {
+      requireString(args.rootId, "rootId");
+      requireString(args.relativePath, "relativePath");
+      const data = await post(thunkApi, "/api/desktop/files/read", args, context?.signal);
+      return {
+        rawData: data,
+        displayData: `已读取本地文件: ${args.relativePath}`,
+      };
+    },
+
+    async propose(args: { rootId: string; summary: string; operations: LocalFileOperation[]; riskLevel?: "low" | "medium" | "high" }, thunkApi: any, context?: { signal?: AbortSignal }): Promise<ToolResult> {
+      requireString(args.rootId, "rootId");
+      requireString(args.summary, "summary");
+      if (!Array.isArray(args.operations) || args.operations.length === 0) {
+        throw new Error("operations 不能为空。");
+      }
+      const data = await post(thunkApi, "/api/desktop/files/plan", args, context?.signal);
+      return {
+        rawData: data,
+        displayData: `已创建本地文件整理计划，等待确认: ${args.summary}`,
+      };
+    },
+
+    async proposePreview(args: { rootId: string; summary: string; operations: LocalFileOperation[] }): Promise<ToolResult> {
+      return {
+        rawData: {
+          previewOnly: true,
+          rootId: args.rootId,
+          summary: args.summary,
+          operations: args.operations,
+        },
+        displayData: `待确认本地文件整理计划: ${args.summary}（${args.operations?.length ?? 0} 项）`,
+      };
+    },
+
+    async execute(args: { planId: string }, thunkApi: any, context?: { signal?: AbortSignal }): Promise<ToolResult> {
+      requireString(args.planId, "planId");
+      const data = await post(thunkApi, "/api/desktop/files/execute", args, context?.signal);
+      return {
+        rawData: data,
+        displayData: `已执行本地文件整理计划: ${args.planId}`,
+      };
+    },
+
+    async undo(args: { batchId: string }, thunkApi: any, context?: { signal?: AbortSignal }): Promise<ToolResult> {
+      requireString(args.batchId, "batchId");
+      const data = await post(thunkApi, "/api/desktop/files/undo", args, context?.signal);
+      return {
+        rawData: data,
+        displayData: `已撤销本地文件整理批次: ${args.batchId}`,
+      };
+    },
+  };
+}
+
+function requireString(value: unknown, name: string) {
+  if (typeof value !== "string" || !value.trim()) {
+    throw new Error(`${name} 必须是非空字符串。`);
+  }
+}
+
+const defaultHandlers = createLocalFilesToolHandlers();
+
+export const listLocalFilesFunc = defaultHandlers.list;
+export const readLocalFileFunc = defaultHandlers.read;
+export const proposeLocalFileChangesFunc = defaultHandlers.propose;
+export const proposeLocalFileChangesPreviewFunc = defaultHandlers.proposePreview;
+export const executeApprovedLocalFileChangesFunc = defaultHandlers.execute;
+export const undoLocalFileChangeBatchFunc = defaultHandlers.undo;

package/ai/tools/readFileTool.ts

@@ -1,6 +1,6 @@
 // 文件路径: packages/ai/tools/readFileTool.ts
 
-import { getToolBaseUrl } from "./toolApiClient";
+import { buildToolRequestHeaders, getToolBaseUrl } from "./toolApiClient";
 
 // ---- Types ----
 
@@ -106,7 +106,7 @@ export async function readFilePreviewFunc(
 export async function readFileFunc(
     args: ReadFileArgs,
     thunkApi: any,
-    context?: { parentMessageId?: string; signal?: AbortSignal }
+    context?: { parentMessageId?: string; signal?: AbortSignal; agentKey?: string }
 ): Promise<{ rawData: any; displayData?: string }> {
     const { filePath, startLine, endLine } = args;
 
@@ -125,7 +125,10 @@ export async function readFileFunc(
 
         const response = await fetch(apiUrl, {
             method: "POST",
-            headers: { "Content-Type": "application/json" },
+            headers: buildToolRequestHeaders(thunkApi, {
+                withAuth: true,
+                agentKey: context?.agentKey,
+            }),
             signal: context?.signal,
             body: JSON.stringify({ filePath, startLine, endLine }),
         });

package/ai/tools/searchRepoTool.ts

@@ -1,6 +1,6 @@
 // 文件路径: packages/ai/tools/searchRepoTool.ts
 
-import { getToolBaseUrl } from "./toolApiClient";
+import { buildToolRequestHeaders, getToolBaseUrl } from "./toolApiClient";
 
 // ---- Types ----
 
@@ -76,7 +76,7 @@ function buildSearchRepoDisplayData(
 export async function searchRepoFunc(
     args: SearchRepoArgs,
     thunkApi: any,
-    context?: { signal?: AbortSignal }
+    context?: { signal?: AbortSignal; agentKey?: string }
 ): Promise<{ rawData: any; displayData?: string }> {
     const { query, pathScope, maxResults, contextLines } = args;
 
@@ -86,7 +86,10 @@ export async function searchRepoFunc(
 
         const response = await fetch(apiUrl, {
             method: "POST",
-            headers: { "Content-Type": "application/json" },
+            headers: buildToolRequestHeaders(thunkApi, {
+                withAuth: true,
+                agentKey: context?.agentKey,
+            }),
             signal: context?.signal,
             body: JSON.stringify({ query, pathScope, maxResults, contextLines }),
         });

package/ai/tools/table/rowTools.ts

@@ -47,6 +47,10 @@ export const queryTableRowsFunctionSchema = {
       },
       limit: { type: "number", description: "最多返回多少行，默认 20，最大 200。" },
       offset: { type: "number", description: "从第几行开始返回，默认 0。" },
+      includeBaseFields: {
+        type: "boolean",
+        description: "配合 columns 使用。设为 false 时不额外返回 dbKey/rowId/tenantId/tableId/createdAt/updatedAt，适合任务表概览。",
+      },
       sortBy: { type: "string", description: "排序字段，默认 updatedAt。" },
       sortOrder: {
         type: "string",
@@ -69,11 +73,12 @@ export async function queryTableRowsFunc(args: any, thunkApi: any) {
   const columns = Array.isArray(args?.columns)
     ? args.columns.filter((value: unknown): value is string => typeof value === "string" && value.trim().length > 0)
     : undefined;
+  const includeBaseFields = args?.includeBaseFields !== false;
 
   const filtered = applyRowFilters(rows, filters);
   const sorted = sortRows(filtered, sortBy, sortOrder);
   const page = sorted.slice(offset, offset + limit);
-  const items = columns ? page.map((row) => pickRowColumns(row, columns)) : page;
+  const items = columns ? page.map((row) => pickRowColumns(row, columns, { includeBaseFields })) : page;
 
   return {
     rawData: {

package/ai/tools/taobaoTmallProductScraperTool.ts

@@ -0,0 +1,49 @@
+import { callApifyActor } from "./apifyActorClient";
+
+export const taobaoTmallProductScraperFunctionSchema = {
+  name: "taobaoTmallProductScraper",
+  description:
+    "使用 Apify Taobao/Tmall Product Scraper 获取淘宝/天猫商品真实详情，返回标题、价格、SKU、库存、图片、店铺、属性和规格参数。适合用户提供淘宝/天猫链接或商品 ID 后做真实参数对比。",
+  parameters: {
+    type: "object",
+    properties: {
+      itemId: {
+        type: "string",
+        description:
+          "淘宝/天猫数字商品 ID。可从链接中的 id 参数提取，例如 https://item.taobao.com/item.htm?id=744983869996。",
+      },
+      detailDepth: {
+        type: "string",
+        enum: ["lite", "standard", "full"],
+        description:
+          "详情深度。full 会尽量返回优惠后价格、属性、规格、SKU 和促销信息；默认 full。",
+        default: "full",
+      },
+    },
+    required: ["itemId"],
+  },
+};
+
+export async function taobaoTmallProductScraperFunc(
+  args: {
+    itemId: string;
+    detailDepth?: "lite" | "standard" | "full";
+  },
+  thunkApi: any
+) {
+  const itemId = String(args.itemId ?? "").trim();
+  if (!/^\d{6,}$/.test(itemId)) {
+    throw new Error("淘宝/天猫商品详情抓取失败：itemId 必须是有效的数字商品 ID。");
+  }
+
+  return callApifyActor(thunkApi, {
+    actorId: "sian.agency~taobao-tmall-product-scraper",
+    input: {
+      operation: "productDetail",
+      itemId,
+      detailDepth: args.detailDepth ?? "full",
+    },
+    resultType: "datasetItems",
+    displayName: "Taobao/Tmall Product Scraper",
+  });
+}

package/ai/tools/toolApiClient.ts

@@ -72,6 +72,8 @@ export const getToolRequestContext = (thunkApi: any): ToolRequestContext => {
 export interface CallToolApiOptions {
     /** 是否在请求头中附带 Authorization token，默认 false */
     withAuth?: boolean;
+    /** 生产受控 devtool 路由需要知道是哪一个 agent 在调用。 */
+    agentKey?: string | null;
 }
 
 const maybeAttachDialogId = (thunkApi: any, body: object): object => {
@@ -103,6 +105,22 @@ export class ToolApiError extends Error {
     }
 }
 
+export const buildToolRequestHeaders = (
+    thunkApi: any,
+    options: CallToolApiOptions = {}
+): Record<string, string> => {
+    const { withAuth = false, agentKey } = options;
+    const { token } = getRequestConfig(thunkApi);
+    const headers: Record<string, string> = { "Content-Type": "application/json" };
+    if (withAuth && token) {
+        headers["Authorization"] = `Bearer ${token}`;
+    }
+    if (agentKey && typeof agentKey === "string" && agentKey.trim()) {
+        headers["X-Nolo-Agent-Key"] = agentKey.trim();
+    }
+    return headers;
+};
+
 const buildResponsePreview = (text: string): string =>
     text
         .replace(/\s+/g, " ")
@@ -132,14 +150,10 @@ export async function callToolApi<T = any>(
     body: object,
     options: CallToolApiOptions = {}
 ): Promise<T> {
-    const { withAuth = false } = options;
-    const { currentServer, token } = getRequestConfig(thunkApi);
+    const { currentServer } = getRequestConfig(thunkApi);
 
     const url = `${currentServer}${path}`;
-    const headers: Record<string, string> = { "Content-Type": "application/json" };
-    if (withAuth && token) {
-        headers["Authorization"] = `Bearer ${token}`;
-    }
+    const headers = buildToolRequestHeaders(thunkApi, options);
 
     const response = await fetch(url, {
         method: "POST",

package/ai/tools/wereadGatewayTool.ts

@@ -0,0 +1,152 @@
+import { callToolApi } from "./toolApiClient";
+
+export const WEREAD_DEFAULT_SKILL_VERSION = "1.0.3";
+export const WEREAD_GATEWAY_URL = "https://i.weread.qq.com/api/agent/gateway";
+
+export interface WereadGatewayArgs {
+  api_name?: string;
+  skill_version?: string;
+  params?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+
+export interface WereadGatewayRunOptions {
+  apiKey: string;
+  fetchImpl?: typeof fetch;
+}
+
+export const wereadGatewayFunctionSchema = {
+  name: "wereadGateway",
+  description:
+    "调用微信读书 Agent API Gateway。用于搜索书籍、查看书架、阅读统计、笔记划线、书评和推荐。业务参数必须平铺在请求体顶层。",
+  parameters: {
+    type: "object",
+    properties: {
+      api_name: {
+        type: "string",
+        description: "微信读书接口名，例如 /store/search、/shelf/sync、/user/notebooks。",
+      },
+      skill_version: {
+        type: "string",
+        description: "微信读书 skill 版本；未传时使用当前内置版本。",
+      },
+      params: {
+        type: "object",
+        description: "业务参数对象。工具会自动把字段平铺到请求体顶层，不会以 params 包裹转发。",
+        additionalProperties: true,
+      },
+    },
+    required: ["api_name"],
+  } as const,
+};
+
+const RESERVED_ARG_KEYS = new Set(["api_name", "skill_version", "params"]);
+
+function normalizeApiName(value: unknown): string {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function normalizeSkillVersion(value: unknown): string {
+  return typeof value === "string" && value.trim()
+    ? value.trim()
+    : WEREAD_DEFAULT_SKILL_VERSION;
+}
+
+function normalizeParams(value: unknown): Record<string, unknown> {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  return value as Record<string, unknown>;
+}
+
+export function buildWereadGatewayRequestBody(args: WereadGatewayArgs): Record<string, unknown> {
+  const apiName = normalizeApiName(args.api_name);
+  if (!apiName) {
+    throw new Error("wereadGateway 需要 api_name。");
+  }
+
+  const flattened: Record<string, unknown> = {
+    ...normalizeParams(args.params),
+  };
+  for (const [key, value] of Object.entries(args)) {
+    if (!RESERVED_ARG_KEYS.has(key)) {
+      flattened[key] = value;
+    }
+  }
+
+  return {
+    api_name: apiName,
+    ...flattened,
+    skill_version: normalizeSkillVersion(args.skill_version),
+  };
+}
+
+function extractUpgradeMessage(data: unknown): string | null {
+  const upgradeInfo = (data as any)?.upgrade_info;
+  return typeof upgradeInfo?.message === "string" && upgradeInfo.message.trim()
+    ? upgradeInfo.message.trim()
+    : null;
+}
+
+function extractErrcode(data: unknown): number {
+  const raw = (data as any)?.errcode;
+  return typeof raw === "number" && Number.isFinite(raw) ? raw : 0;
+}
+
+function extractErrorMessage(data: unknown): string {
+  const record = data as any;
+  return (
+    (typeof record?.errmsg === "string" && record.errmsg.trim()) ||
+    (typeof record?.message === "string" && record.message.trim()) ||
+    "微信读书接口返回错误"
+  );
+}
+
+export async function runWereadGatewayRequest(
+  args: WereadGatewayArgs,
+  options: WereadGatewayRunOptions
+): Promise<{ rawData: unknown; displayData: string }> {
+  const apiKey = options.apiKey.trim();
+  if (!apiKey) {
+    throw new Error("缺少 WEREAD_API_KEY。请先在设置 -> 密钥中保存 WEREAD_API_KEY。");
+  }
+
+  const body = buildWereadGatewayRequestBody(args);
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const response = await fetchImpl(WEREAD_GATEWAY_URL, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify(body),
+  });
+
+  const data = await response.json().catch(async () => ({
+    errmsg: await response.text().catch(() => ""),
+  }));
+  if (!response.ok) {
+    throw new Error(`微信读书接口请求失败：HTTP ${response.status}`);
+  }
+
+  const upgradeMessage = extractUpgradeMessage(data);
+  if (upgradeMessage) {
+    throw new Error(`微信读书 Skill 需要升级：${upgradeMessage}`);
+  }
+
+  const errcode = extractErrcode(data);
+  if (errcode !== 0) {
+    throw new Error(`微信读书接口返回错误 ${errcode}：${extractErrorMessage(data)}`);
+  }
+
+  const apiName = String(body.api_name);
+  return {
+    rawData: data,
+    displayData: `微信读书接口 ${apiName} 调用成功。\n\n${JSON.stringify(data, null, 2)}`,
+  };
+}
+
+export async function wereadGatewayFunc(
+  args: WereadGatewayArgs,
+  thunkApi: any
+): Promise<{ rawData: unknown; displayData: string }> {
+  return callToolApi(thunkApi, "/api/weread/gateway", args, { withAuth: true });
+}

package/ai/tools/writeFileTool.ts

@@ -1,7 +1,7 @@
 // 文件路径: packages/ai/tools/writeFileTool.ts
 
 import { bumpDevReloadSuppressIfSelfEditing } from "./devReloadUtils";
-import { getToolBaseUrl } from "./toolApiClient";
+import { buildToolRequestHeaders, getToolBaseUrl } from "./toolApiClient";
 
 // ---- Types ----
 
@@ -107,7 +107,7 @@ export async function writeFilePreviewFunc(
 export async function writeFileFunc(
     args: WriteFileArgs,
     thunkApi: any,
-    context?: { parentMessageId?: string; signal?: AbortSignal }
+    context?: { parentMessageId?: string; signal?: AbortSignal; agentKey?: string }
 ): Promise<{ rawData: any; displayData?: string }> {
     const { filePath, content, overwrite } = args;
 
@@ -132,7 +132,10 @@ export async function writeFileFunc(
 
         const response = await fetch(apiUrl, {
             method: "POST",
-            headers: { "Content-Type": "application/json" },
+            headers: buildToolRequestHeaders(thunkApi, {
+                withAuth: true,
+                agentKey: context?.agentKey,
+            }),
             signal: context?.signal,
             body: JSON.stringify({ filePath, content, overwrite }),
         });

package/client/agentConfigResolver.test.ts

@@ -0,0 +1,70 @@
+import { describe, expect, test } from "bun:test";
+
+import { resolveAgentRuntimeConfigFromRecord } from "./agentConfigResolver";
+
+describe("agent config resolver", () => {
+  test("keeps complete runtime-relevant agent config while normalizing tools", () => {
+    const rawRecord = {
+      dbKey: "agent-user-1-frontend",
+      key: "agent-user-1-frontend",
+      name: "Frontend implementer",
+      prompt: "Fix UI carefully.",
+      model: "gpt-5.4",
+      provider: "openai",
+      apiSource: "platform",
+      cliProvider: "codex",
+      customProviderUrl: "https://provider.example/v1",
+      toolNames: ["legacyTool", "readFile"],
+      tools: ["readFile", "applyEdit"],
+      runtimeBinding: { machineId: "machine-1", localWorkspaceMode: "task-worktree" },
+      delegation: { target: "local" },
+      temperature: 0.2,
+      top_p: 0.9,
+      max_tokens: 4096,
+      reasoning_effort: "medium",
+    };
+
+    expect(resolveAgentRuntimeConfigFromRecord("agent-user-1-frontend", rawRecord)).toEqual({
+      key: "agent-user-1-frontend",
+      name: "Frontend implementer",
+      prompt: "Fix UI carefully.",
+      model: "gpt-5.4",
+      provider: "openai",
+      apiSource: "platform",
+      cliProvider: "codex",
+      customProviderUrl: "https://provider.example/v1",
+      toolNames: ["legacyTool", "readFile", "applyEdit"],
+      runtimeBinding: { machineId: "machine-1", localWorkspaceMode: "task-worktree" },
+      localWorkspaceMode: "task-worktree",
+      delegation: { target: "local" },
+      temperature: 0.2,
+      top_p: 0.9,
+      max_tokens: 4096,
+      reasoning_effort: "medium",
+      rawRecord,
+    });
+  });
+
+  test("falls back provider to apiSource and tools to tools", () => {
+    expect(resolveAgentRuntimeConfigFromRecord("agent-user-1-cli", {
+      apiSource: "cli",
+      tools: ["execShell"],
+    })).toMatchObject({
+      key: "agent-user-1-cli",
+      provider: "cli",
+      apiSource: "cli",
+      toolNames: ["execShell"],
+    });
+  });
+
+  test("returns a minimal config for sparse records", () => {
+    expect(resolveAgentRuntimeConfigFromRecord("agent-user-1-empty", {
+      dbKey: "agent-user-1-empty",
+    })).toEqual({
+      key: "agent-user-1-empty",
+      rawRecord: {
+        dbKey: "agent-user-1-empty",
+      },
+    });
+  });
+});

package/client/agentConfigResolver.ts

@@ -0,0 +1 @@
+export { resolveAgentRuntimeConfigFromRecord } from "../agentRuntimeLocal";