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

package/chunk-CM54RSSA.js

@@ -0,0 +1,206 @@
+// packages/agent-runtime/modelLayerOverride.ts
+var MODEL_LAYER_KEYS = [
+  "provider",
+  "model",
+  "apiSource",
+  "cliProvider",
+  "useServerProxy",
+  "apiKey",
+  "apiKeyRef",
+  "apiKeyHeader",
+  "customProviderUrl",
+  "credentialRef",
+  "credentialSynced",
+  "temperature",
+  "top_p",
+  "frequency_penalty",
+  "presence_penalty",
+  "max_tokens",
+  "reasoning_effort",
+  "enableThinking",
+  "thinkingBudget"
+];
+function mergeReferences(base, extra) {
+  const safeBase = Array.isArray(base) ? base : [];
+  const safeExtra = Array.isArray(extra) ? extra : [];
+  const seen = /* @__PURE__ */ new Set();
+  const merged = [];
+  for (const item of [...safeBase, ...safeExtra]) {
+    const key = item?.dbKey;
+    if (key && seen.has(key)) continue;
+    if (key) seen.add(key);
+    if (item) merged.push(item);
+  }
+  return merged;
+}
+var asNonEmptyString = (value) => typeof value === "string" && value.trim().length > 0;
+function buildModelLayerOverride(agent) {
+  if (!agent || !asNonEmptyString(agent.provider) || !asNonEmptyString(agent.model)) {
+    return null;
+  }
+  const override = {
+    provider: agent.provider,
+    model: agent.model
+  };
+  for (const key of MODEL_LAYER_KEYS) {
+    if (key === "provider" || key === "model") continue;
+    const value = agent[key];
+    if (value !== void 0) {
+      override[key] = value;
+    }
+  }
+  if (Array.isArray(agent.references) && agent.references.length > 0) {
+    override.references = agent.references;
+  }
+  return override;
+}
+function applyModelLayerOverride(base, override) {
+  const next = { ...base };
+  for (const key of MODEL_LAYER_KEYS) {
+    delete next[key];
+  }
+  for (const key of MODEL_LAYER_KEYS) {
+    const value = override[key];
+    if (value !== void 0) {
+      next[key] = value;
+    }
+  }
+  const merged = mergeReferences(
+    base.references,
+    override.references
+  );
+  if (merged.length > 0) {
+    next.references = merged;
+  } else {
+    delete next.references;
+  }
+  return next;
+}
+
+// packages/agent-runtime/turnContext.ts
+var DEFAULT_RECENT_CONTENT_LIMIT = 10;
+var asTrimmed = (value) => typeof value === "string" ? value.trim() : "";
+var asFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : 0;
+var spaceRecordKey = (spaceId) => spaceId.startsWith("space-") ? spaceId : `space-${spaceId}`;
+var makeLayer = (id, content, cacheScope = "turn") => ({ id, owner: "runtime", cacheScope, content });
+var renderSpaceStructure = (spaceRecord, recentLimit) => {
+  const categories = spaceRecord.categories ?? {};
+  const validCategories = Object.entries(categories).filter((entry) => entry[1] !== null).sort(
+    (a, b) => asFiniteNumber(a[1].order) - asFiniteNumber(b[1].order)
+  );
+  const categoryNameById = /* @__PURE__ */ new Map();
+  let struct = "Directory Structure (Categories):\n";
+  if (validCategories.length === 0) struct += "(No categories defined)\n";
+  validCategories.forEach(([id, category]) => {
+    const name = asTrimmed(category.name) || id;
+    categoryNameById.set(id, name);
+    struct += `- ${name} (ID: ${id})
+`;
+  });
+  const contents = spaceRecord.contents ?? {};
+  const recentContents = recentLimit > 0 ? Object.values(contents).filter((content) => content !== null).sort(
+    (a, b) => asFiniteNumber(b.updatedAt) - asFiniteNumber(a.updatedAt)
+  ).slice(0, recentLimit) : [];
+  if (recentContents.length > 0) {
+    struct += `
+Recent Contents (Top ${recentLimit}):
+`;
+    recentContents.forEach((content) => {
+      const categoryId = asTrimmed(content.categoryId);
+      const categoryName = categoryId ? categoryNameById.get(categoryId) || "Unknown" : "Uncategorized";
+      struct += `- [${asTrimmed(content.type) || "content"}] ${asTrimmed(content.title)} (Category: ${categoryName}, dbKey: ${asTrimmed(content.contentKey)})
+`;
+    });
+  }
+  return struct;
+};
+var buildSpaceContextLayer = async (args) => {
+  const spaceId = asTrimmed(args.spaceId);
+  if (!spaceId) return null;
+  const recentLimit = args.recentContentLimit ?? DEFAULT_RECENT_CONTENT_LIMIT;
+  let spaceRecord = null;
+  let readError = null;
+  try {
+    spaceRecord = await args.source.readRecord(spaceRecordKey(spaceId));
+  } catch (error) {
+    readError = error instanceof Error ? error.message : String(error);
+  }
+  if (!spaceRecord) {
+    return makeLayer(
+      "space-context",
+      [
+        "--- \u5F53\u524D\u7A7A\u95F4\uFF08Space\uFF09---",
+        `\u672C\u5BF9\u8BDD\u8BB0\u5F55\u58F0\u660E\u5C5E\u4E8E Space ${spaceId}\uFF0C\u4F46\u5F53\u524D\u65E0\u6CD5\u8BFB\u53D6\u8BE5 Space \u7684\u6570\u636E${readError ? `\uFF08${readError}\uFF09` : "\uFF08\u8BB0\u5F55\u4E0D\u5B58\u5728\u6216\u4E0D\u53EF\u8FBE\uFF09"}\u3002`,
+        "\u5982\u88AB\u95EE\u53CA\uFF0C\u8BF7\u5982\u5B9E\u8BF4\u660E\u300C\u5BF9\u8BDD\u5C5E\u4E8E\u8BE5 Space \u4F46\u6682\u65F6\u8BFB\u4E0D\u5230\u7A7A\u95F4\u8BE6\u60C5\u300D\uFF0C\u4E0D\u8981\u58F0\u79F0\u5BF9\u8BDD\u4E0D\u5C5E\u4E8E\u4EFB\u4F55\u7A7A\u95F4\u3002"
+      ].join("\n")
+    );
+  }
+  const name = asTrimmed(spaceRecord.name);
+  const description = asTrimmed(spaceRecord.description);
+  const structure = renderSpaceStructure(spaceRecord, recentLimit);
+  return makeLayer(
+    "space-context",
+    [
+      "--- \u5F53\u524D\u7A7A\u95F4\uFF08Space\uFF09---",
+      "\u672C\u5BF9\u8BDD\u5C5E\u4E8E\u4EE5\u4E0B Space\uFF1A",
+      `Space Title: ${name || spaceId}`,
+      `Space ID: ${spaceId}`,
+      `Description: ${description || "N/A"}`,
+      "",
+      structure.trimEnd()
+    ].join("\n")
+  );
+};
+var buildSkillDiscoveryLayer = (skills, boundFolder) => {
+  if (skills.length === 0) return null;
+  const lines = [
+    "--- \u53EF\u7528\u6280\u80FD\uFF08Skills\uFF09---",
+    `\u5DE5\u4F5C\u533A ${boundFolder} \u4E2D\u53D1\u73B0\u4E86 ${skills.length} \u4E2A\u6280\u80FD\uFF08SKILL.md\uFF09\uFF1A`,
+    "\u6A21\u578B\u53EF\u6309\u9700\u7528 readFile \u8BFB\u53D6\u4EE5\u4E0B\u6587\u4EF6\u83B7\u53D6\u8BE6\u7EC6\u6307\u4EE4\uFF1A",
+    "",
+    ...skills.map(
+      (s) => `- ${s.name}: ${s.description}
+  path: ${s.relativePath}`
+    )
+  ];
+  return makeLayer("skill-discovery", lines.join("\n"));
+};
+var buildLinkedSpacesSection = async (args) => {
+  const ids = (args.linkedSpaceIds ?? []).filter(
+    (id) => typeof id === "string" && id.trim() !== ""
+  );
+  if (ids.length === 0) return null;
+  const lines = [];
+  for (const rawId of ids) {
+    const spaceId = asTrimmed(rawId);
+    let spaceData = null;
+    try {
+      spaceData = await args.source.readRecord(spaceRecordKey(spaceId));
+    } catch {
+      spaceData = null;
+    }
+    if (spaceData) {
+      const name = asTrimmed(spaceData.name) || spaceId;
+      const desc = asTrimmed(spaceData.description);
+      lines.push(`- ${name} (ID: ${spaceId})${desc ? `: ${desc}` : ""}`);
+    } else {
+      lines.push(`- [\u65E0\u6CD5\u8BBF\u95EE] ${spaceId}`);
+    }
+  }
+  if (lines.length === 0) return null;
+  return [
+    "--- \u5173\u8054\u7A7A\u95F4 (Linked Spaces) ---",
+    "\u4EE5\u4E0B\u662F Agent \u53EF\u8BBF\u95EE\u7684\u5176\u4ED6\u5DE5\u4F5C\u7A7A\u95F4\uFF08\u7C97\u7565\u4E0A\u4E0B\u6587\uFF09\uFF1A",
+    lines.join("\n"),
+    "",
+    "\u63D0\u793A\uFF1A\u5982\u9700\u67E5\u8BE2\u8FD9\u4E9B\u7A7A\u95F4\u7684\u8BE6\u7EC6\u5185\u5BB9\uFF0C\u53EF\u4F7F\u7528 read \u5DE5\u5177\u914D\u5408\u5BF9\u5E94\u7684 dbKey\u3002"
+  ].join("\n");
+};
+
+export {
+  buildModelLayerOverride,
+  applyModelLayerOverride,
+  buildSpaceContextLayer,
+  buildSkillDiscoveryLayer,
+  buildLinkedSpacesSection
+};

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-DA2OEKS6.js

@@ -0,0 +1,27 @@
+// packages/agent-runtime/staleReplayGuard.ts
+var wrapHistoricalSummaryWithReplayGuard = (summary) => {
+  const trimmed = summary.trim();
+  if (!trimmed) return "";
+  return [
+    "\u3010\u5386\u53F2\u53C2\u8003\uFF0C\u975E\u6D3B\u6307\u4EE4\u3011",
+    "\u4EE5\u4E0B\u662F\u5148\u524D\u5BF9\u8BDD\u7684\u51BB\u7ED3\u6458\u8981\uFF0C\u4E0D\u662F\u5F53\u524D\u4F1A\u8BDD\u7684\u6D3B\u6307\u4EE4\u3002",
+    "\u5176\u4E2D\u7684\u4EFB\u52A1\u63CF\u8FF0\u3001skill \u8C03\u7528\u3001ARGUMENTS \u8F7D\u8377\u9ED8\u8BA4\u5DF2\u8FC7\u671F\uFF08STALE-BY-DEFAULT\uFF09\uFF0C",
+    "\u5728\u6CA1\u6709\u5F53\u524D\u4F1A\u8BDD\u663E\u5F0F\u7528\u6237\u8BF7\u6C42\u65F6\u4E0D\u5F97\u91CD\u65B0\u6267\u884C\uFF1B\u6267\u884C\u524D\u5148\u5BF9\u7167\u5B9E\u9645\u5DE5\u4F5C\u72B6\u6001\u786E\u8BA4\u3002",
+    "",
+    "--- \u5386\u53F2\u6458\u8981\u5F00\u59CB ---",
+    trimmed,
+    "--- \u5386\u53F2\u6458\u8981\u7ED3\u675F ---"
+  ].join("\n");
+};
+
+// packages/agent-runtime/memoryUseGuidance.ts
+var MEMORY_USE_GUIDANCE = `--- \u8BB0\u5FC6\u4F7F\u7528\u65B9\u5F0F ---
+- \u8BB0\u5FC6\u662F\u4E2A\u6027\u5316\u589E\u5F3A\u5C42\uFF1B\u5F53\u524D\u8F93\u5165/\u5BF9\u8BDD/\u7CFB\u7EDF\u89C4\u5219/Agent prompt/skill/\u7528\u6237\u5168\u5C40\u504F\u597D\u90FD\u4F18\u5148\u4E8E\u5B83\u3002\u5F53\u524D\u8F93\u5165\u7ED9\u51FA\u65B0\u8BED\u8A00\u3001\u6280\u672F\u6808\u3001\u6570\u503C\u3001\u7EA6\u675F\u6216\u660E\u786E\u8986\u76D6\u65E7\u504F\u597D\u65F6\uFF0C\u91C7\u7528\u5F53\u524D\u8F93\u5165\uFF0C\u4E0D\u8981\u628A\u65E7\u8BB0\u5FC6\u5F53\u66F4\u9AD8\u771F\u503C\u3002
+- \u8BB0\u5FC6\u542B\u7528\u6237\u8EAB\u4EFD/\u79F0\u547C/\u5173\u7CFB/\u957F\u671F\u504F\u597D/\u9879\u76EE\u80CC\u666F\u65F6\uFF0C\u76F8\u5173\u5904\u81EA\u7136\u4F53\u73B0\uFF08\u5F00\u573A\u79F0\u547C\u3001\u4E0A\u4E0B\u6587\u786E\u8BA4\u3001\u56DE\u7B54\u7ED3\u6784\u3001\u53D6\u820D\u6807\u51C6\uFF09\uFF0C\u4E0D\u8981\u6BCF\u53E5\u673A\u68B0\u79F0\u547C\u7528\u6237\u3002
+- \u201C\u4E0A\u6B21/\u7EE7\u7EED/\u8FD9\u4E2A\u9879\u76EE\u201D\u7B49\u6307\u4EE3\u4F18\u5148\u6309\u5F53\u524D dialog/space/project/agent/sourceDialog \u7B49 KV \u8DEF\u5F84\u548C\u65F6\u95F4\u7EBF\u5B9A\u4F4D\uFF0C\u4E0D\u8981\u53EA\u6309\u8BED\u4E49\u76F8\u4F3C\u5EA6\u635E\u4E00\u6761\u3002
+- \u63A8\u65AD\u578B\u8BB0\u5FC6\u53EA\u7528\u4E8E\u628A\u63E1\u8BED\u6C14\u3001\u72B6\u6001\u548C\u672A\u5B8C\u6210\u4E8B\u9879\uFF0C\u4E0D\u8981\u8BF4\u6210\u201C\u4F60\u660E\u786E\u544A\u8BC9\u8FC7\u6211\u201D\u6216\u5F53\u6210\u7528\u6237\u5DF2\u6388\u6743\u4FDD\u5B58\u7684\u4E8B\u5B9E\u3002\u51B2\u7A81\u6216\u573A\u666F\u4E0D\u660E\u65F6\u8BF4\u660E\u4F9D\u636E\u6216\u7B80\u77ED\u786E\u8BA4\uFF0C\u4E0D\u8981\u786C\u5957\u3002`;
+
+export {
+  wrapHistoricalSummaryWithReplayGuard,
+  MEMORY_USE_GUIDANCE
+};

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
+};