nolo-cli 0.8.0 → 0.9.0

package/chunk-CPB2YM4D.js

@@ -0,0 +1,171 @@
+import {
+  i18n_default,
+  toolRegistry
+} from "./chunk-MKMWT7SA.js";
+import {
+  canonicalizeToolNames
+} from "./chunk-AUQ747NZ.js";
+import {
+  asTrimmedLowercaseString
+} from "./chunk-QSJ3HFEF.js";
+import {
+  isRecord
+} from "./chunk-KUG52IAP.js";
+
+// packages/ai/tools/toolSchemaCompatibility.ts
+var COMPOSITION_KEYS = ["anyOf", "oneOf", "allOf"];
+var LIMITED_JSON_SCHEMA_PROVIDERS = /* @__PURE__ */ new Set([
+  "fireworks"
+]);
+var sanitizeSchemaNode = (value) => {
+  if (Array.isArray(value)) {
+    return value.map((item) => sanitizeSchemaNode(item));
+  }
+  if (!isRecord(value)) {
+    return value;
+  }
+  const next = {};
+  for (const [key, child] of Object.entries(value)) {
+    if (COMPOSITION_KEYS.includes(key)) {
+      continue;
+    }
+    next[key] = sanitizeSchemaNode(child);
+  }
+  return next;
+};
+var shouldSanitizeProviderSchema = (provider) => LIMITED_JSON_SCHEMA_PROVIDERS.has(asTrimmedLowercaseString(provider));
+var sanitizeToolForProvider = (tool, provider) => {
+  if (!shouldSanitizeProviderSchema(provider)) {
+    return tool;
+  }
+  const parameters = tool?.function?.parameters;
+  if (!isRecord(parameters)) {
+    return tool;
+  }
+  return {
+    ...tool,
+    function: {
+      ...tool.function,
+      parameters: sanitizeSchemaNode(parameters)
+    }
+  };
+};
+
+// packages/ai/tools/prepareTools.ts
+var translatedFunctionCache = /* @__PURE__ */ new Map();
+var prepareToolsResultCache = /* @__PURE__ */ new Map();
+var PREPARE_TOOLS_CACHE_LIMIT = 128;
+function getTranslation(keys, defaultVal) {
+  for (const key of keys) {
+    if (i18n_default.exists(key)) {
+      return i18n_default.t(key);
+    }
+    const aiKey = key.startsWith("ai:") ? key : `ai:${key}`;
+    if (i18n_default.exists(aiKey)) {
+      return i18n_default.t(aiKey);
+    }
+  }
+  return defaultVal;
+}
+function translateSchema(schema) {
+  if (!schema || typeof schema !== "object") return schema;
+  const nextSchema = JSON.parse(JSON.stringify(schema));
+  const toolName = nextSchema.name;
+  if (!toolName) return nextSchema;
+  const walk = (node, path) => {
+    if (!node || typeof node !== "object") return;
+    if (typeof node.description === "string") {
+      const keysToTry = [
+        `${path}.description`,
+        `${path}.desc`,
+        path,
+        node.description
+      ];
+      node.description = getTranslation(keysToTry, node.description);
+    }
+    if (node.parameters && typeof node.parameters === "object") {
+      walk(node.parameters, path);
+    }
+    if (node.properties && typeof node.properties === "object") {
+      for (const [key, child] of Object.entries(node.properties)) {
+        const nextPath = path.endsWith(".params") ? `${path}.${key}` : `${path}.params.${key}`;
+        walk(child, nextPath);
+      }
+    }
+    if (node.items && typeof node.items === "object") {
+      walk(node.items, path);
+    }
+    const compositions = ["anyOf", "oneOf", "allOf"];
+    for (const comp of compositions) {
+      if (Array.isArray(node[comp])) {
+        node[comp].forEach((child, idx) => {
+          const suffix = child.type === "string" ? "stringDesc" : child.type === "object" ? "objectDesc" : `${idx}`;
+          walk(child, `${path}.${suffix}`);
+        });
+      }
+    }
+  };
+  walk(nextSchema, `tools.${toolName}`);
+  return nextSchema;
+}
+function currentI18nLanguage() {
+  return typeof i18n_default.language === "string" ? i18n_default.language : "";
+}
+function translateSchemaCached(schema) {
+  if (!schema || typeof schema !== "object") return schema;
+  const toolName = typeof schema.name === "string" ? schema.name : "";
+  if (!toolName) return translateSchema(schema);
+  const cacheKey = `${currentI18nLanguage()}\0${toolName}`;
+  const hit = translatedFunctionCache.get(cacheKey);
+  if (hit) return hit;
+  const translated = translateSchema(schema);
+  translatedFunctionCache.set(cacheKey, translated);
+  return translated;
+}
+function buildPrepareToolsCacheKey(toolNames, disabledToolNames, provider) {
+  return [
+    currentI18nLanguage(),
+    provider ?? "",
+    disabledToolNames.join(""),
+    toolNames.join("")
+  ].join("\0");
+}
+function rememberPrepareToolsResult(key, value) {
+  if (prepareToolsResultCache.size >= PREPARE_TOOLS_CACHE_LIMIT) {
+    const oldest = prepareToolsResultCache.keys().next().value;
+    if (oldest !== void 0) {
+      prepareToolsResultCache.delete(oldest);
+    }
+  }
+  prepareToolsResultCache.set(key, value);
+}
+var prepareTools = (toolNames, options) => {
+  const disabledList = canonicalizeToolNames(options?.disabledToolNames ?? []);
+  const disabledToolNames = new Set(disabledList);
+  const canonicalNames = canonicalizeToolNames(toolNames).filter(
+    (toolName) => !disabledToolNames.has(toolName)
+  );
+  const cacheKey = buildPrepareToolsCacheKey(
+    canonicalNames,
+    disabledList,
+    options?.provider
+  );
+  const cached = prepareToolsResultCache.get(cacheKey);
+  if (cached) {
+    return cached.slice();
+  }
+  const prepared = canonicalNames.map((toolName) => {
+    const regTool = toolRegistry[toolName];
+    if (!regTool) return regTool;
+    return {
+      ...regTool,
+      function: translateSchemaCached(regTool.function)
+    };
+  }).map((tool) => sanitizeToolForProvider(tool, options?.provider)).filter(Boolean);
+  rememberPrepareToolsResult(cacheKey, prepared);
+  return prepared.slice();
+};
+
+export {
+  prepareTools
+};

package/chunk-CWMSB67P.js

@@ -0,0 +1,34 @@
+// packages/ai/llm/imagePricing.ts
+var DEFAULT_IMAGE_SIZE = "1K";
+var DEFAULT_IMAGE_QUALITY = "medium";
+var hasEstimateForSize = (tokenEstimates, size) => typeof tokenEstimates[size] !== "undefined";
+var resolveTokenEstimate = (estimate, requestedQuality) => {
+  if (typeof estimate === "number") return estimate;
+  if (!estimate) return void 0;
+  const quality = requestedQuality && typeof estimate[requestedQuality] === "number" ? requestedQuality : DEFAULT_IMAGE_QUALITY;
+  return estimate[quality];
+};
+var getApproxPricePerImage = (model, requestedSize, requestedQuality) => {
+  if (!model) return void 0;
+  if (typeof model.pricePerImage === "number") {
+    return model.pricePerImage;
+  }
+  if (typeof model.imageTokenPricePerMillion !== "number") {
+    return void 0;
+  }
+  const tokenEstimates = model.imageOutputTokenEstimateBySize;
+  if (!tokenEstimates) return void 0;
+  const resolvedSize = requestedSize && hasEstimateForSize(tokenEstimates, requestedSize) ? requestedSize : DEFAULT_IMAGE_SIZE;
+  const outputTokens = resolveTokenEstimate(
+    tokenEstimates[resolvedSize],
+    requestedQuality
+  );
+  if (typeof outputTokens !== "number") {
+    return void 0;
+  }
+  return model.imageTokenPricePerMillion * outputTokens / 1e6;
+};
+
+export {
+  getApproxPricePerImage
+};

package/chunk-DCOA4QSN.js

@@ -0,0 +1,105 @@
+import {
+  OLLAMA_CLOUD_KIMI_K26_MODEL,
+  OLLAMA_CLOUD_KIMI_K27_CODE_MODEL,
+  OLLAMA_CLOUD_KIMI_K3_MODEL,
+  cloudflareModels,
+  deepSeekModels,
+  deepinfraModels,
+  fireworksModels,
+  gmiModels,
+  googleModels,
+  openAIModels,
+  openrouterModels,
+  xaiModels,
+  zaiModels
+} from "./chunk-IWX4UW2E.js";
+
+// packages/ai/llm/ollamaCloud.ts
+var OLLAMA_CLOUD_KIMI_PRICE = {
+  input: 0.27,
+  output: 5.7
+};
+var OLLAMA_CLOUD_GLM_PRICE = {
+  input: 1.14,
+  output: 7.1
+};
+var OLLAMA_CLOUD_GLM_52_MODEL = "glm-5.2";
+var OLLAMA_CLOUD_DEEPSEEK_FLASH_MODEL = "deepseek-v4-flash";
+var OLLAMA_CLOUD_DEEPSEEK_FLASH_PRICE = {
+  input: 0.11,
+  output: 0.63
+};
+var OLLAMA_CLOUD_KIMI_K3_PRICE = {
+  input: 2.4,
+  output: 12
+};
+var ollamaCloudModels = [
+  {
+    name: OLLAMA_CLOUD_KIMI_K3_MODEL,
+    displayName: "Kimi K3",
+    hasVision: true,
+    price: { ...OLLAMA_CLOUD_KIMI_K3_PRICE },
+    maxOutputTokens: 262144,
+    contextWindow: 1e6,
+    supportsTool: true,
+    supportsReasoningEffort: true
+  },
+  {
+    name: OLLAMA_CLOUD_KIMI_K26_MODEL,
+    displayName: "Kimi K2.6",
+    hasVision: true,
+    price: { ...OLLAMA_CLOUD_KIMI_PRICE },
+    maxOutputTokens: 262144,
+    contextWindow: 262144,
+    supportsTool: true
+  },
+  {
+    name: OLLAMA_CLOUD_KIMI_K27_CODE_MODEL,
+    displayName: "Kimi K2.7 Coding",
+    hasVision: true,
+    price: { ...OLLAMA_CLOUD_KIMI_PRICE },
+    maxOutputTokens: 262144,
+    contextWindow: 256e3,
+    supportsTool: true
+  },
+  {
+    name: OLLAMA_CLOUD_GLM_52_MODEL,
+    displayName: "GLM 5.2",
+    hasVision: false,
+    price: { ...OLLAMA_CLOUD_GLM_PRICE },
+    maxOutputTokens: 131072,
+    contextWindow: 1e6,
+    supportsTool: true,
+    supportsReasoningEffort: true
+  },
+  {
+    name: OLLAMA_CLOUD_DEEPSEEK_FLASH_MODEL,
+    displayName: "DeepSeek V4 Flash",
+    hasVision: false,
+    price: { ...OLLAMA_CLOUD_DEEPSEEK_FLASH_PRICE },
+    maxOutputTokens: 384e3,
+    contextWindow: 1e6,
+    supportsTool: true,
+    supportsReasoningEffort: true
+  }
+];
+
+// packages/ai/llm/models.ts
+var withProvider = (provider) => (models) => models.map((model) => ({ ...model, provider }));
+var ALL_MODELS = [
+  ...withProvider("nolo")(ollamaCloudModels),
+  ...withProvider("google")(googleModels),
+  ...withProvider("openai")(openAIModels),
+  ...withProvider("openrouter")(openrouterModels),
+  ...withProvider("xai")(xaiModels),
+  ...withProvider("deepseek")(deepSeekModels),
+  ...withProvider("deepinfra")(deepinfraModels),
+  ...withProvider("fireworks")(fireworksModels),
+  ...withProvider("cloudflare")(cloudflareModels),
+  ...withProvider("gmi")(gmiModels),
+  ...withProvider("zai")(zaiModels)
+];
+
+export {
+  ALL_MODELS
+};

package/chunk-DFFIZ25G.js

@@ -0,0 +1,30 @@
+// packages/core/prefix.ts
+var extractKeyPart = (key, index) => {
+  const parts = key.split("-");
+  if (index < 2) {
+    return parts[index];
+  }
+  return parts.slice(index).join("-");
+};
+var extractUserId = (key) => {
+  const parts = key.split("-");
+  if (parts.length === 2) {
+    return parts[0];
+  }
+  if (parts[0] === "user" && parts[1] === "pref" && parts.length >= 3) {
+    return parts[2];
+  }
+  return extractKeyPart(key, 1);
+};
+var extractCustomId = (key) => {
+  if (key.startsWith("dialog-") && !key.includes("-msg-")) {
+    const lastDash = key.lastIndexOf("-");
+    return lastDash >= 0 ? key.slice(lastDash + 1) : key;
+  }
+  return extractKeyPart(key, 2);
+};
+
+export {
+  extractUserId,
+  extractCustomId
+};

package/chunk-DWLEOOGR.js

@@ -0,0 +1,8 @@
+// packages/core/compactWhitespace.ts
+function compactWhitespace(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+
+export {
+  compactWhitespace
+};

package/chunk-DZ3XJVET.js

@@ -0,0 +1,231 @@
+import {
+  LOCAL_CODEX_AGENT_KEY,
+  isLocalCliAgentKey,
+  resolveCliAgentKeyInput
+} from "./chunk-VHBWHNVT.js";
+import {
+  DEFAULT_NOLO_SERVER_URL
+} from "./chunk-OLZBQWZU.js";
+import {
+  asTrimmedLowercaseString
+} from "./chunk-QSJ3HFEF.js";
+import {
+  normalizeServerOrigin
+} from "./chunk-CF7PE763.js";
+
+// packages/cli/agentRunArgs.ts
+import { readFileSync } from "node:fs";
+function readFlagValue(args, flag) {
+  const index = args.indexOf(flag);
+  if (index < 0) return void 0;
+  return args[index + 1];
+}
+function readRepeatedFlagValues(args, flag) {
+  const values = [];
+  for (let index = 0; index < args.length; index += 1) {
+    if (args[index] === flag && args[index + 1]) {
+      values.push(args[index + 1]);
+      index += 1;
+    }
+  }
+  return values;
+}
+function runtimeModeFromArgs(args) {
+  if (args.includes("--local")) return "local";
+  if (args.includes("--server")) return "server";
+  if (args.includes("--auto")) return "auto";
+  return void 0;
+}
+function isFullstackCodingAgentRef(raw, resolved) {
+  const normalized = asTrimmedLowercaseString(raw);
+  return normalized === "fullstack" || normalized === "full-stack" || normalized === "nolo-fullstack" || normalized === "\u5168\u6808" || normalized === "nolo \u5168\u6808\u5DE5\u7A0B\u5E08" || resolved === "fullstack";
+}
+function parsePositiveInteger(value) {
+  if (!value) return void 0;
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || parsed <= 0) return void 0;
+  return Math.floor(parsed);
+}
+function parseSubjectRef(raw) {
+  const value = raw.trim();
+  if (!value) return null;
+  const firstColon = value.indexOf(":");
+  if (firstColon <= 0 || firstColon === value.length - 1) return null;
+  const kind = value.slice(0, firstColon).trim();
+  const rest = value.slice(firstColon + 1).trim();
+  const lastColon = rest.lastIndexOf(":");
+  const id = lastColon > 0 ? rest.slice(0, lastColon).trim() : rest;
+  const role = lastColon > 0 ? rest.slice(lastColon + 1).trim() : "";
+  if (!kind || !id) return null;
+  return { kind, id, ...role ? { role } : {} };
+}
+var VALUELESS_FLAGS = {
+  "--local": true,
+  "--server": true,
+  "--auto": true,
+  "--dangerously-allow-shell": true,
+  "--trace-tools": true,
+  "--bg": true,
+  "--no-stream": true,
+  "--debug": true,
+  "--ephemeral": true,
+  "--memory-only": true
+};
+function isValuelessFlag(arg) {
+  return Object.prototype.hasOwnProperty.call(VALUELESS_FLAGS, arg);
+}
+function positionalArgs(args) {
+  const values = [];
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (isValuelessFlag(arg)) continue;
+    if (arg.startsWith("--")) {
+      index += 1;
+      continue;
+    }
+    values.push(arg);
+  }
+  return values;
+}
+function resolveRawAgentInput(args, commandPath) {
+  const positional = positionalArgs(args);
+  const isNoLogin = (commandPath?.join(" ") === "run" || commandPath?.join(" ") === "chat") && !readFlagValue(args, "--agent");
+  return readFlagValue(args, "--agent") ?? (isNoLogin ? LOCAL_CODEX_AGENT_KEY : positional[0]);
+}
+function parseDialogReference(rawInput) {
+  const normalized = rawInput.trim();
+  if (normalized.startsWith("dialog-")) {
+    const parts = normalized.split("-");
+    return {
+      dialogKey: normalized,
+      dialogId: parts.at(-1) ?? normalized
+    };
+  }
+  const dialogMatch = normalized.match(/dialog-([a-zA-Z0-9]+)-([a-zA-Z0-9]+)/);
+  if (dialogMatch) {
+    return {
+      dialogKey: `dialog-${dialogMatch[1]}-${dialogMatch[2]}`,
+      dialogId: dialogMatch[2]
+    };
+  }
+  return {
+    dialogId: normalized
+  };
+}
+function resolveServerUrl(env) {
+  return normalizeServerOrigin(
+    env.NOLO_SERVER || env.BASE_URL || DEFAULT_NOLO_SERVER_URL
+  );
+}
+function buildLocalRunEnv(args) {
+  void args.allowShell;
+  return {
+    ...args.env
+  };
+}
+function writeUsage(output, commandPath) {
+  const commandName = commandPath?.join(" ");
+  if (commandName === "run") {
+    output.write(
+      "Usage: nolo run <message> [--cwd <path>] [--timeout-ms <n>] [--events jsonl]\n       nolo run --msg <message> [--cwd <path>] [--image <url-or-path>] [--timeout-ms <n>]\nRuns local Codex in the current workspace; no Nolo login required.\n"
+    );
+    return;
+  }
+  if (commandName === "chat") {
+    output.write(
+      "Usage: nolo chat <message> [--cwd <path>] [--events jsonl]\n       nolo chat --agent <agent> (--msg <message>|--msg-file <path>) [--local|--server|--auto]\nWithout --agent, this uses local Codex in the current workspace; no Nolo login required.\n"
+    );
+    return;
+  }
+  output.write(
+    "Usage: nolo agent run <agent> <message> [--local|--server|--auto] [--ephemeral|--memory-only] [--continue <dialogId>] [--cwd <path>]\n       nolo agent run --agent <agent> (--msg <message>|--msg-file <path>) [--image <url-or-path>] [--space <spaceId>] [--category <name>] [--inherit-from-dialog <dialog>] [--parent-dialog <dialog>] [--subject-dialog <dialog>] [--subject-ref <kind:id[:role]>] [--task-row-dbkey <key>] [--allowed-child-agent <agent>] [--fallback-agent <agent>] (suggestions for agent to decide on quota) [--allowed-tool <tool>] [--blocked-tool <tool>] [--bg] [--timeout-ms <n>] [--events jsonl] [--no-stream] [--skill <dbKey-or-md-path>]\n"
+  );
+}
+function parseAgentRunArgs(args, options = {}) {
+  const positional = positionalArgs(args);
+  const isNoLoginRunShorthand = (options.commandPath?.join(" ") === "run" || options.commandPath?.join(" ") === "chat") && !readFlagValue(args, "--agent");
+  const rawAgentKey = readFlagValue(args, "--agent") ?? (isNoLoginRunShorthand ? LOCAL_CODEX_AGENT_KEY : positional[0]);
+  const agentKey = rawAgentKey ? resolveCliAgentKeyInput(rawAgentKey) : void 0;
+  const explicitMsg = readFlagValue(args, "--msg");
+  const msgFile = readFlagValue(args, "--msg-file");
+  const fileMessage = msgFile ? (options.readTextFile ?? ((path) => readFileSync(path, "utf8")))(msgFile) : void 0;
+  const rawMessage = explicitMsg ?? fileMessage ?? positional.slice(isNoLoginRunShorthand ? 0 : 1).join(" ");
+  if (!agentKey || !rawMessage.trim()) return null;
+  const message = rawMessage.trim();
+  const runtimeMode = runtimeModeFromArgs(args);
+  const continueDialogId = readFlagValue(args, "--continue") ?? readFlagValue(args, "--dialog");
+  const spaceId = readFlagValue(args, "--space");
+  const category = readFlagValue(args, "--category");
+  const inheritedFromDialog = readFlagValue(args, "--inherit-from-dialog");
+  const subjectDialog = readFlagValue(args, "--subject-dialog") ?? readFlagValue(args, "--reference-dialog");
+  const subjectDialogKey = subjectDialog?.trim();
+  const subjectRefs = readRepeatedFlagValues(args, "--subject-ref").map(parseSubjectRef).filter((ref) => Boolean(ref));
+  const allowedChildAgentKeys = readRepeatedFlagValues(args, "--allowed-child-agent").map((value) => resolveCliAgentKeyInput(value.trim())).filter(Boolean);
+  const fallbackAgentKeys = readRepeatedFlagValues(args, "--fallback-agent").map((value) => resolveCliAgentKeyInput(value.trim())).filter(Boolean);
+  const allowedToolNames = readRepeatedFlagValues(args, "--allowed-tool").map((value) => value.trim()).filter(Boolean);
+  const cwd = readFlagValue(args, "--cwd");
+  const timeoutMs = parsePositiveInteger(readFlagValue(args, "--timeout-ms"));
+  const rawEventsMode = readFlagValue(args, "--events");
+  const eventsMode = rawEventsMode === "jsonl" ? "jsonl" : void 0;
+  const inheritedRef = inheritedFromDialog ? parseDialogReference(inheritedFromDialog) : void 0;
+  const explicitLocalCliAgentDefault = isLocalCliAgentKey(agentKey) && runtimeMode !== "server";
+  const explicitParentDialog = readFlagValue(args, "--parent-dialog");
+  const parentDialogRef = explicitParentDialog ? parseDialogReference(explicitParentDialog) : void 0;
+  const blockedToolNames = readRepeatedFlagValues(args, "--blocked-tool").map((value) => value.trim()).filter(Boolean);
+  const imageUrls = [
+    ...readRepeatedFlagValues(args, "--image"),
+    ...readRepeatedFlagValues(args, "--image-url")
+  ];
+  const fullstackLocalWorkspaceDefault = isFullstackCodingAgentRef(rawAgentKey, agentKey) && runtimeMode !== "server";
+  const ephemeral = args.includes("--ephemeral") || args.includes("--memory-only");
+  const workflowRef = readFlagValue(args, "--workflow");
+  const skillRefs = readRepeatedFlagValues(args, "--skill").map((v) => v.trim()).filter(Boolean);
+  const taskRowDbKey = readFlagValue(args, "--task-row-dbkey");
+  const artifactIds = readFlagValue(args, "--artifact-ids")?.split(",").map((item) => item.trim()).filter(Boolean);
+  return {
+    agentKey,
+    message,
+    imageUrls,
+    allowShell: args.includes("--dangerously-allow-shell") || fullstackLocalWorkspaceDefault || explicitLocalCliAgentDefault,
+    traceTools: args.includes("--trace-tools"),
+    ephemeral,
+    ...eventsMode ? { eventsMode } : {},
+    injectFeatureWorktreeInstruction: fullstackLocalWorkspaceDefault,
+    ...workflowRef ? { workflowRef } : {},
+    ...skillRefs.length ? { skillRefs } : {},
+    ...taskRowDbKey ? {
+      taskEvidence: {
+        rowDbKey: taskRowDbKey,
+        ...artifactIds?.length ? { artifactIds } : {}
+      }
+    } : {},
+    ...runtimeMode ? { runtimeMode } : fullstackLocalWorkspaceDefault || explicitLocalCliAgentDefault || args.includes("--dangerously-allow-shell") ? { runtimeMode: "local" } : {},
+    background: args.includes("--bg"),
+    noStream: args.includes("--no-stream"),
+    ...continueDialogId ? { continueDialogId } : {},
+    ...!continueDialogId && spaceId ? { spaceId } : {},
+    ...category ? { category } : {},
+    ...inheritedRef?.dialogKey ? { inheritedFromDialogKey: inheritedRef.dialogKey } : {},
+    ...parentDialogRef?.dialogId || inheritedRef?.dialogId ? { parentDialogId: parentDialogRef?.dialogId ?? inheritedRef?.dialogId } : {},
+    ...parentDialogRef?.dialogId ? { parentWakeOnTerminal: true } : {},
+    ...subjectDialogKey ? { subjectDialogKey } : {},
+    ...subjectRefs.length ? { subjectRefs } : {},
+    ...allowedChildAgentKeys.length ? { allowedChildAgentKeys } : {},
+    ...fallbackAgentKeys.length ? { fallbackAgentKeys } : {},
+    ...allowedToolNames.length ? { allowedToolNames } : {},
+    ...cwd ? { cwd } : {},
+    ...blockedToolNames.length ? { blockedToolNames } : {},
+    ...typeof timeoutMs === "number" ? { timeoutMs } : {}
+  };
+}
+
+export {
+  readFlagValue,
+  isFullstackCodingAgentRef,
+  positionalArgs,
+  resolveRawAgentInput,
+  resolveServerUrl,
+  buildLocalRunEnv,
+  writeUsage,
+  parseAgentRunArgs
+};