nolo-cli 0.8.0-alpha.6 → 0.8.0-alpha.7

package/chunk-TDIQFT2F.js

@@ -0,0 +1,301 @@
+import {
+  getCredentialsDir
+} from "./chunk-JZPBVBIY.js";
+import {
+  asNonEmptyStringArray
+} from "./chunk-PN7AFLOK.js";
+import {
+  asTrimmedString
+} from "./chunk-3EUW3WEO.js";
+import {
+  asOptionalPositiveFiniteNumber
+} from "./chunk-U6VC4MU4.js";
+import {
+  isRecord
+} from "./chunk-KUG52IAP.js";
+
+// packages/agent-runtime/fileCredentialBroker.ts
+import {
+  chmodSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  unlinkSync,
+  writeFileSync
+} from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+// packages/agent-runtime/credentialBroker.ts
+function assertCredentialRef(ref) {
+  const trimmed = asTrimmedString(ref);
+  if (!trimmed) {
+    throw new Error("invalid_ref");
+  }
+  if (trimmed.includes("..") || trimmed.includes("/") || trimmed.includes("\\")) {
+    throw new Error("invalid_ref");
+  }
+  return trimmed;
+}
+
+// packages/agent-runtime/fileCredentialBroker.ts
+function getApiKeyCredentialsDir(homeDir = homedir()) {
+  return join(getCredentialsDir(homeDir), "keys");
+}
+function credentialRefToFileName(ref) {
+  const safe = assertCredentialRef(ref).replace(/[^a-zA-Z0-9._-]+/g, "_");
+  if (!safe || safe === "." || safe === "..") {
+    throw new Error(`Credential ref is not filesystem-safe: ${ref}`);
+  }
+  return `${safe}.json`;
+}
+function getApiKeyCredentialPath(ref, homeDir = homedir()) {
+  return join(getApiKeyCredentialsDir(homeDir), credentialRefToFileName(ref));
+}
+function ensurePrivateDir(dir) {
+  mkdirSync(dir, { recursive: true, mode: 448 });
+  try {
+    chmodSync(dir, 448);
+  } catch {
+  }
+}
+function writePrivateFile(path, body) {
+  writeFileSync(path, body, { encoding: "utf8", mode: 384 });
+  try {
+    chmodSync(path, 384);
+  } catch {
+  }
+}
+function readApiKeyCredential(ref, homeDir = homedir()) {
+  const path = getApiKeyCredentialPath(ref, homeDir);
+  if (!existsSync(path)) return null;
+  try {
+    const raw = readFileSync(path, "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed?.secret !== "string" || !parsed.secret) return null;
+    return parsed.secret;
+  } catch {
+    return null;
+  }
+}
+function writeApiKeyCredential(ref, secret, homeDir = homedir(), now = Date.now()) {
+  const trimmedSecret = secret.trim();
+  if (!trimmedSecret) {
+    throw new Error("Cannot store an empty credential secret.");
+  }
+  assertCredentialRef(ref);
+  const dir = getApiKeyCredentialsDir(homeDir);
+  ensurePrivateDir(dir);
+  const path = getApiKeyCredentialPath(ref, homeDir);
+  const payload = {
+    secret: trimmedSecret,
+    updatedAt: now
+  };
+  writePrivateFile(path, `${JSON.stringify(payload, null, 2)}
+`);
+}
+function removeApiKeyCredential(ref, homeDir = homedir()) {
+  assertCredentialRef(ref);
+  const path = getApiKeyCredentialPath(ref, homeDir);
+  if (!existsSync(path)) return;
+  unlinkSync(path);
+}
+function hasApiKeyCredential(ref, homeDir = homedir()) {
+  return readApiKeyCredential(ref, homeDir) !== null;
+}
+function createFileCredentialBroker(options = {}) {
+  const homeDir = options.homeDir ?? homedir();
+  const now = options.now ?? Date.now;
+  return {
+    get(ref) {
+      return readApiKeyCredential(ref, homeDir);
+    },
+    put(ref, secret) {
+      writeApiKeyCredential(ref, secret, homeDir, now());
+    },
+    delete(ref) {
+      removeApiKeyCredential(ref, homeDir);
+    },
+    has(ref) {
+      return hasApiKeyCredential(ref, homeDir);
+    }
+  };
+}
+
+// packages/agent-runtime/migrateAgentSecrets.ts
+function buildAgentApiKeyCredentialRef(agentKey) {
+  const key = asTrimmedString(agentKey);
+  if (!key) throw new Error("agentKey is required to build a credential ref.");
+  return `api-key:${key}`;
+}
+function readRawApiKey(agent) {
+  return asTrimmedString(agent.apiKey);
+}
+function resolveTargetRef(agent) {
+  const fromCredential = asTrimmedString(agent.credentialRef);
+  if (fromCredential) return fromCredential;
+  const fromApiKeyRef = asTrimmedString(agent.apiKeyRef);
+  if (fromApiKeyRef.startsWith("api-key:")) return fromApiKeyRef;
+  return buildAgentApiKeyCredentialRef(agent.key);
+}
+async function brokerHas(broker, ref) {
+  return Boolean(await broker.has(ref));
+}
+async function brokerPut(broker, ref, secret) {
+  await broker.put(ref, secret);
+}
+async function migrateAgentSecrets(args) {
+  const { agent, broker } = args;
+  const raw = readRawApiKey(agent);
+  const migration = asTrimmedString(agent.credentialMigration);
+  if (migration === "done" && !raw) {
+    const ref = typeof agent.credentialRef === "string" && agent.credentialRef.trim() || (typeof agent.apiKeyRef === "string" && agent.apiKeyRef.startsWith("api-key:") ? agent.apiKeyRef.trim() : "") || void 0;
+    return {
+      updates: {},
+      status: "already-done",
+      ...ref ? { credentialRef: ref } : {},
+      phase: "complete"
+    };
+  }
+  if (!raw && migration !== "pending") {
+    return { updates: {}, status: "noop", phase: "none" };
+  }
+  const targetRef = resolveTargetRef(agent);
+  if (raw) {
+    await brokerPut(broker, targetRef, raw);
+    const stored2 = await brokerHas(broker, targetRef);
+    if (!stored2) {
+      return {
+        updates: {
+          credentialRef: targetRef,
+          credentialMigration: "pending"
+        },
+        status: "resumed-pending",
+        credentialRef: targetRef,
+        phase: "put"
+      };
+    }
+    return {
+      updates: {
+        apiKey: null,
+        credentialRef: targetRef,
+        // Keep apiKeyRef for resolution if not already an OAuth provider name.
+        // Prefer explicit credentialRef; set apiKeyRef only when empty so OAuth agents stay intact.
+        ...!(typeof agent.apiKeyRef === "string" && agent.apiKeyRef.trim()) ? { apiKeyRef: targetRef } : {},
+        credentialMigration: "done"
+      },
+      status: migration === "pending" ? "resumed-pending" : "migrated",
+      credentialRef: targetRef,
+      phase: "strip"
+    };
+  }
+  const stored = await brokerHas(broker, targetRef);
+  if (stored) {
+    return {
+      updates: {
+        credentialRef: targetRef,
+        credentialMigration: "done",
+        ...!(typeof agent.apiKeyRef === "string" && agent.apiKeyRef.trim()) ? { apiKeyRef: targetRef } : {}
+      },
+      status: "resumed-pending",
+      credentialRef: targetRef,
+      phase: "complete"
+    };
+  }
+  return {
+    updates: {
+      credentialRef: targetRef,
+      credentialMigration: "pending"
+    },
+    status: "awaiting-secret",
+    credentialRef: targetRef,
+    phase: "put"
+  };
+}
+function applyAgentSecretMigrationUpdates(record, updates) {
+  const next = { ...record };
+  if ("apiKey" in updates) {
+    if (updates.apiKey === null || updates.apiKey === "") {
+      delete next.apiKey;
+    } else if (typeof updates.apiKey === "string") {
+      next.apiKey = updates.apiKey;
+    }
+  }
+  if (updates.apiKeyRef !== void 0) next.apiKeyRef = updates.apiKeyRef;
+  if (updates.credentialRef !== void 0) next.credentialRef = updates.credentialRef;
+  if (updates.credentialMigration !== void 0) {
+    next.credentialMigration = updates.credentialMigration;
+  }
+  return next;
+}
+
+// packages/agent-runtime/runtimeToolPolicy.ts
+function unique(values) {
+  return [...new Set(values)];
+}
+function normalizeAgentRuntimeToolPolicy(value) {
+  if (!isRecord(value)) return void 0;
+  return {
+    version: 1,
+    ...asNonEmptyStringArray(value.agentTools).length ? { agentTools: unique(asNonEmptyStringArray(value.agentTools)) } : {},
+    ...asNonEmptyStringArray(value.runtimeTools).length ? { runtimeTools: unique(asNonEmptyStringArray(value.runtimeTools)) } : {},
+    ...isRecord(value.workspace) ? { workspace: { ...value.workspace } } : {},
+    ...isRecord(value.shell) ? { shell: { ...value.shell } } : {},
+    ...isRecord(value.isolation) ? { isolation: { ...value.isolation } } : {},
+    ...isRecord(value.git) ? { git: { ...value.git } } : {},
+    ...isRecord(value.budget) ? { budget: { ...value.budget } } : {},
+    ...isRecord(value.audit) ? { audit: { ...value.audit } } : {}
+  };
+}
+function runtimeBindingRecord(runtimeBinding) {
+  return isRecord(runtimeBinding) ? runtimeBinding : void 0;
+}
+function runtimeToolNamesFromPolicy(policy) {
+  return asNonEmptyStringArray(policy?.runtimeTools);
+}
+function readPositiveNumber(value) {
+  return asOptionalPositiveFiniteNumber(Number(value));
+}
+function resolveRequestedRuntimeToolNames(args) {
+  const runtimeBinding = runtimeBindingRecord(args.agentConfig.runtimeBinding);
+  const bindingPolicy = normalizeAgentRuntimeToolPolicy(
+    runtimeBinding?.runtimeToolPolicy
+  );
+  const bindingSnapshotPolicy = normalizeAgentRuntimeToolPolicy(
+    runtimeBinding?.runtimeToolPolicySnapshot
+  );
+  return unique([
+    ...asNonEmptyStringArray(args.agentConfig.toolNames),
+    ...runtimeToolNamesFromPolicy(
+      normalizeAgentRuntimeToolPolicy(args.agentConfig.runtimeToolPolicy)
+    ),
+    ...runtimeToolNamesFromPolicy(bindingPolicy),
+    ...runtimeToolNamesFromPolicy(bindingSnapshotPolicy)
+  ]);
+}
+function resolveCurrentRunRuntimeToolPolicy(agentConfig) {
+  const runtimeBinding = runtimeBindingRecord(agentConfig?.runtimeBinding);
+  return normalizeAgentRuntimeToolPolicy(
+    runtimeBinding?.runtimeToolPolicySnapshot ?? agentConfig?.runtimeToolPolicy ?? runtimeBinding?.runtimeToolPolicy
+  );
+}
+function resolveLocalRuntimeEnvFromPolicy(runtimeEnv, policy) {
+  return { ...runtimeEnv };
+}
+function resolveLocalWorkspaceExecutorOptionsFromPolicy(policy) {
+  const maxOutputBytes = readPositiveNumber(policy?.shell?.maxOutputBytes);
+  return {
+    ...maxOutputBytes ? { commandOutputLimit: Math.floor(maxOutputBytes) } : {}
+  };
+}
+
+export {
+  createFileCredentialBroker,
+  migrateAgentSecrets,
+  applyAgentSecretMigrationUpdates,
+  normalizeAgentRuntimeToolPolicy,
+  resolveRequestedRuntimeToolNames,
+  resolveCurrentRunRuntimeToolPolicy,
+  resolveLocalRuntimeEnvFromPolicy,
+  resolveLocalWorkspaceExecutorOptionsFromPolicy
+};

package/chunk-TILFE6LV.js

@@ -0,0 +1,381 @@
+import {
+  asOptionalFiniteNumber
+} from "./chunk-WWC7I6TA.js";
+import {
+  asTrimmedString
+} from "./chunk-3EUW3WEO.js";
+import {
+  asOptionalTrimmedString
+} from "./chunk-G3SUCT4W.js";
+import {
+  isRecord
+} from "./chunk-KUG52IAP.js";
+
+// packages/agent-runtime/agentRecordConfig.ts
+function stringField(record, key) {
+  const value = record[key];
+  return typeof value === "string" ? value : void 0;
+}
+function numberField(record, key) {
+  return asOptionalFiniteNumber(record[key]);
+}
+function objectField(record, key) {
+  const value = record[key];
+  return isRecord(value) ? value : void 0;
+}
+function appendUniqueStrings(values, next) {
+  if (!Array.isArray(next)) return values;
+  const seen = new Set(values);
+  for (const value of next) {
+    const toolName = typeof value === "string" ? value : isRecord(value) && typeof value.name === "string" ? value.name : isRecord(value) && isRecord(value.function) && typeof value.function.name === "string" ? value.function.name : "";
+    if (toolName && !seen.has(toolName)) {
+      seen.add(toolName);
+      values.push(toolName);
+    }
+  }
+  return values;
+}
+function resolveAgentRuntimeToolNames(record) {
+  const tools = appendUniqueStrings(
+    appendUniqueStrings([], record.toolNames),
+    record.tools
+  );
+  return tools.length > 0 ? tools : void 0;
+}
+function resolveAgentRuntimeConfigFromRecord(key, record) {
+  const name = stringField(record, "name");
+  const prompt = stringField(record, "prompt");
+  const model = stringField(record, "model");
+  const apiSource = stringField(record, "apiSource");
+  const cliProvider = stringField(record, "cliProvider");
+  const customProviderUrl = stringField(record, "customProviderUrl");
+  const apiKey = stringField(record, "apiKey");
+  const apiKeyHeader = stringField(record, "apiKeyHeader");
+  const apiKeyFromAgentKey = stringField(record, "apiKeyFromAgentKey");
+  const apiKeyRef = stringField(record, "apiKeyRef");
+  const credentialRef = stringField(record, "credentialRef");
+  const credentialSynced = record.credentialSynced === true;
+  const useServerProxy = record.useServerProxy === true;
+  const provider = stringField(record, "provider") ?? stringField(record, "apiSource");
+  const toolNames = resolveAgentRuntimeToolNames(record);
+  const temperature = numberField(record, "temperature");
+  const topP = numberField(record, "top_p");
+  const frequencyPenalty = numberField(record, "frequency_penalty");
+  const presencePenalty = numberField(record, "presence_penalty");
+  const maxTokens = numberField(record, "max_tokens");
+  const reasoningEffort = stringField(record, "reasoning_effort") || stringField(record, "reasoningEffort");
+  const runtimeBinding = objectField(record, "runtimeBinding");
+  const runtimeToolPolicy = objectField(record, "runtimeToolPolicy") ?? objectField(runtimeBinding ?? {}, "runtimeToolPolicy");
+  const delegation = objectField(record, "delegation");
+  return {
+    key,
+    ...name ? { name } : {},
+    ...prompt ? { prompt } : {},
+    ...model ? { model } : {},
+    ...provider ? { provider } : {},
+    ...apiSource ? { apiSource } : {},
+    ...cliProvider ? { cliProvider } : {},
+    ...customProviderUrl ? { customProviderUrl } : {},
+    ...apiKey ? { apiKey } : {},
+    ...apiKeyHeader ? { apiKeyHeader } : {},
+    ...apiKeyFromAgentKey ? { apiKeyFromAgentKey } : {},
+    ...apiKeyRef ? { apiKeyRef } : {},
+    ...credentialRef ? { credentialRef } : {},
+    ...credentialSynced ? { credentialSynced } : {},
+    ...useServerProxy ? { useServerProxy } : {},
+    ...toolNames ? { toolNames } : {},
+    ...temperature !== void 0 ? { temperature } : {},
+    ...topP !== void 0 ? { top_p: topP } : {},
+    ...frequencyPenalty !== void 0 ? { frequency_penalty: frequencyPenalty } : {},
+    ...presencePenalty !== void 0 ? { presence_penalty: presencePenalty } : {},
+    ...maxTokens !== void 0 ? { max_tokens: maxTokens } : {},
+    ...reasoningEffort ? { reasoning_effort: reasoningEffort } : {},
+    ...runtimeBinding ? { runtimeBinding } : {},
+    ...runtimeToolPolicy ? { runtimeToolPolicy } : {},
+    ...delegation ? { delegation } : {},
+    rawRecord: record
+  };
+}
+
+// packages/agent-runtime/desktopRequestSnapshot.ts
+var DESKTOP_AGENT_CONFIG_SNAPSHOT_STRING_FIELDS = [
+  "name",
+  "prompt",
+  "provider",
+  "model",
+  "apiSource",
+  "cliProvider",
+  "customProviderUrl",
+  "credentialRef",
+  "apiKeyRef",
+  "apiKeyHeader",
+  "reasoning_effort",
+  "reasoningEffort"
+];
+var DESKTOP_AGENT_CONFIG_SNAPSHOT_NUMBER_FIELDS = [
+  "temperature",
+  "top_p",
+  "frequency_penalty",
+  "presence_penalty",
+  "max_tokens"
+];
+var DESKTOP_AGENT_CONFIG_SNAPSHOT_OBJECT_FIELDS = [
+  "runtimeBinding",
+  "runtimeToolPolicy",
+  "delegation"
+];
+var DESKTOP_AGENT_CONFIG_SNAPSHOT_FORBIDDEN_KEYS = [
+  "apiKey",
+  "apiKeyFromAgentKey",
+  "token",
+  "secret",
+  "password",
+  "accessToken",
+  "refreshToken",
+  "authorization",
+  "authToken",
+  "AUTH_TOKEN",
+  "AUTH",
+  "clientSecret",
+  "privateKey",
+  "bearer"
+];
+var DESKTOP_TOOL_CALL_ARGUMENTS_MAX_CHARS = 8192;
+var REDACTED_SECRET_PLACEHOLDER = "[redacted]";
+var FORBIDDEN_KEY_SET = new Set(
+  DESKTOP_AGENT_CONFIG_SNAPSHOT_FORBIDDEN_KEYS.map((k) => k.toLowerCase())
+);
+function isForbiddenKey(key) {
+  return FORBIDDEN_KEY_SET.has(key.toLowerCase());
+}
+function isDesktopSnapshotSensitivePropertyName(key) {
+  return isForbiddenKey(key);
+}
+function redactSensitiveJsonTree(value, depth = 0) {
+  if (depth > 6) return null;
+  if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => redactSensitiveJsonTree(item, depth + 1));
+  }
+  if (typeof value !== "object") return null;
+  const out = {};
+  for (const [key, child] of Object.entries(value)) {
+    if (isDesktopSnapshotSensitivePropertyName(key)) {
+      out[key] = REDACTED_SECRET_PLACEHOLDER;
+      continue;
+    }
+    out[key] = redactSensitiveJsonTree(child, depth + 1);
+  }
+  return out;
+}
+function sanitizeToolCallArguments(raw, maxChars = DESKTOP_TOOL_CALL_ARGUMENTS_MAX_CHARS) {
+  const source = typeof raw === "string" ? raw : raw == null ? "{}" : String(raw);
+  let candidate = source;
+  try {
+    const parsed = JSON.parse(source);
+    if (parsed && typeof parsed === "object") {
+      candidate = JSON.stringify(redactSensitiveJsonTree(parsed));
+    }
+  } catch {
+  }
+  if (candidate.length <= maxChars) return candidate;
+  return candidate.slice(0, maxChars);
+}
+function stringField2(record, key) {
+  return asOptionalTrimmedString(record[key]);
+}
+function numberField2(record, key) {
+  return asOptionalFiniteNumber(record[key]);
+}
+function uniqueToolNames(values) {
+  if (!Array.isArray(values)) return void 0;
+  const names = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    const name = asTrimmedString(value) || asTrimmedString(value?.name) || asTrimmedString(
+      value?.function?.name
+    );
+    if (!name || seen.has(name)) continue;
+    seen.add(name);
+    names.push(name);
+  }
+  return names.length > 0 ? names : void 0;
+}
+function sanitizePlainObject(value, depth = 0) {
+  if (!isRecord(value)) return void 0;
+  if (depth > 4) return void 0;
+  const out = {};
+  for (const [key, child] of Object.entries(value)) {
+    if (isForbiddenKey(key)) continue;
+    if (child === null) {
+      out[key] = null;
+      continue;
+    }
+    if (typeof child === "string" || typeof child === "number" || typeof child === "boolean") {
+      out[key] = child;
+      continue;
+    }
+    if (Array.isArray(child)) {
+      const items = child.map((item) => {
+        if (item === null || typeof item === "string" || typeof item === "number" || typeof item === "boolean") {
+          return item;
+        }
+        if (isRecord(item)) {
+          return sanitizePlainObject(item, depth + 1);
+        }
+        return void 0;
+      }).filter((item) => item !== void 0);
+      out[key] = items;
+      continue;
+    }
+    if (typeof child === "object") {
+      const nested = sanitizePlainObject(child, depth + 1);
+      if (nested) out[key] = nested;
+    }
+  }
+  return out;
+}
+function pickAllowlistedAgentConfigFields(source, dbKey) {
+  const snapshot = { dbKey };
+  for (const key of DESKTOP_AGENT_CONFIG_SNAPSHOT_STRING_FIELDS) {
+    if (key === "reasoningEffort") continue;
+    const value = stringField2(source, key);
+    if (value !== void 0) {
+      snapshot[key] = value;
+    }
+  }
+  const reasoningEffort = stringField2(source, "reasoning_effort") || stringField2(source, "reasoningEffort");
+  if (reasoningEffort) snapshot.reasoning_effort = reasoningEffort;
+  for (const key of DESKTOP_AGENT_CONFIG_SNAPSHOT_NUMBER_FIELDS) {
+    const value = numberField2(source, key);
+    if (value !== void 0) {
+      snapshot[key] = value;
+    }
+  }
+  if (source.useServerProxy === true) {
+    snapshot.useServerProxy = true;
+  } else if (source.useServerProxy === false) {
+    snapshot.useServerProxy = false;
+  }
+  const tools = uniqueToolNames(source.tools) ?? uniqueToolNames(source.toolNames);
+  if (tools) snapshot.tools = tools;
+  for (const key of DESKTOP_AGENT_CONFIG_SNAPSHOT_OBJECT_FIELDS) {
+    const value = sanitizePlainObject(source[key]);
+    if (value) {
+      snapshot[key] = value;
+    }
+  }
+  return snapshot;
+}
+function buildDesktopAgentRuntimeAgentConfigSnapshot(source, agentRef) {
+  if (!isRecord(source)) return null;
+  const ref = asTrimmedString(agentRef);
+  if (!ref) return null;
+  const claimed = stringField2(source, "dbKey") || stringField2(source, "key");
+  if (claimed && claimed !== ref) return null;
+  const dbKey = claimed || ref;
+  return pickAllowlistedAgentConfigFields(source, dbKey);
+}
+function sanitizeMessageContent(content) {
+  if (content === null || content === void 0) return null;
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return null;
+  const parts = [];
+  for (const part of content) {
+    if (!part || typeof part !== "object") continue;
+    const record = part;
+    if (record.type === "text" && typeof record.text === "string") {
+      parts.push({ type: "text", text: record.text });
+    }
+  }
+  return parts.length > 0 ? parts : null;
+}
+function sanitizeToolCalls(value) {
+  if (!Array.isArray(value)) return void 0;
+  const calls = [];
+  for (const item of value) {
+    if (!item || typeof item !== "object") continue;
+    const record = item;
+    const id = asTrimmedString(record.id);
+    const fn = record.function && typeof record.function === "object" ? record.function : null;
+    const name = asTrimmedString(fn?.name);
+    const rawArgs = typeof fn?.arguments === "string" ? fn.arguments : "{}";
+    if (!id || !name) continue;
+    calls.push({
+      id,
+      type: "function",
+      function: { name, arguments: sanitizeToolCallArguments(rawArgs) }
+    });
+  }
+  return calls.length > 0 ? calls : void 0;
+}
+function sanitizeChatMessage(value) {
+  if (!isRecord(value)) return null;
+  const role = value.role;
+  if (role !== "system" && role !== "user" && role !== "assistant" && role !== "tool") {
+    return null;
+  }
+  const content = sanitizeMessageContent(value.content);
+  const message = {
+    role,
+    content
+  };
+  const toolCallId = asOptionalTrimmedString(value.tool_call_id) ?? asOptionalTrimmedString(value.toolCallId);
+  if (toolCallId) message.tool_call_id = toolCallId;
+  const toolCalls = sanitizeToolCalls(value.tool_calls);
+  if (toolCalls) message.tool_calls = toolCalls;
+  if (typeof value.reasoning_content === "string" && value.reasoning_content) {
+    message.reasoning_content = value.reasoning_content;
+  }
+  return message;
+}
+function buildDesktopAgentRuntimeDialogHistorySnapshot(args) {
+  const dialogId = asTrimmedString(args.dialogId);
+  if (!dialogId) return null;
+  if (!Array.isArray(args.messages)) return null;
+  let messages = args.messages.map((item) => sanitizeChatMessage(item)).filter((item) => item !== null);
+  messages = messages.filter((msg) => {
+    const raw = msg;
+    return raw.isStreaming !== true;
+  });
+  const inputText = normalizeContentToText(args.currentInput);
+  if (inputText && messages.length > 0) {
+    const last = messages[messages.length - 1];
+    if (last.role === "user" && normalizeContentToText(last.content) === inputText) {
+      messages = messages.slice(0, -1);
+    }
+  }
+  return { dialogId, messages };
+}
+function normalizeContentToText(content) {
+  if (typeof content === "string") return content.trim();
+  if (!Array.isArray(content)) return "";
+  return content.flatMap((part) => part?.type === "text" && part.text ? [part.text] : []).join("\n").trim();
+}
+function assertDesktopAgentRuntimeTurnBodyHasNoRawSecrets(body) {
+  if (!body || typeof body !== "object") return;
+  const json = JSON.stringify(body);
+  const walk = (value, path) => {
+    if (!value || typeof value !== "object") return;
+    if (Array.isArray(value)) {
+      value.forEach((item, index) => walk(item, `${path}[${index}]`));
+      return;
+    }
+    for (const [key, child] of Object.entries(value)) {
+      if (isForbiddenKey(key)) {
+        throw new Error(`Forbidden secret field in request body at ${path}.${key}`);
+      }
+      walk(child, path ? `${path}.${key}` : key);
+    }
+  };
+  walk(body, "");
+}
+
+export {
+  resolveAgentRuntimeConfigFromRecord,
+  buildDesktopAgentRuntimeAgentConfigSnapshot,
+  buildDesktopAgentRuntimeDialogHistorySnapshot,
+  assertDesktopAgentRuntimeTurnBodyHasNoRawSecrets
+};