nolo-cli 0.8.0-alpha.2 → 0.8.0-alpha.21

package/dialogSlice-3M7KX2TX.js

@@ -0,0 +1,148 @@
+import {
+  abortAllMessages,
+  addDialogAgent,
+  clearDialogState,
+  createAgentAutomation,
+  createDialog,
+  createPageAndAddReference,
+  deleteDialog,
+  handleSendMessage,
+  initDialog,
+  removeDialogAgent,
+  selectCurrentDialogAgentIds,
+  selectCurrentDialogConfig,
+  selectCurrentDialogTokens,
+  selectCurrentPrimaryAgentId,
+  selectDialogConfigByKey,
+  selectTotalDialogTokens,
+  setDialogExtraReferences,
+  setPrimaryDialogAgent,
+  updateDialogTitle,
+  updateTokens
+} from "./chunk-2ECQG4YX.js";
+import "./chunk-4ZDM73SD.js";
+import "./chunk-MRC4Q34M.js";
+import "./chunk-MTU75CZ2.js";
+import "./chunk-CWMSB67P.js";
+import "./chunk-VUW5FBDB.js";
+import "./chunk-5EFXE3O7.js";
+import "./chunk-Z4NR32XR.js";
+import "./chunk-M76ECQRD.js";
+import "./chunk-SOTZ6RDN.js";
+import "./chunk-I6XMPTMR.js";
+import "./chunk-UAD2WT54.js";
+import "./chunk-DCOA4QSN.js";
+import "./chunk-5MMAK75Q.js";
+import "./chunk-BBYVOSU2.js";
+import "./chunk-5CS33IBL.js";
+import "./chunk-JZPBVBIY.js";
+import "./chunk-IWX4UW2E.js";
+import "./chunk-DFFIZ25G.js";
+import {
+  GLOBAL_DIALOG_RUNTIME_KEY,
+  addActiveController,
+  addPendingFile,
+  clearActiveControllers,
+  clearDialogRuntimeState,
+  clearPendingAttachments,
+  clearPendingUserInputQueue,
+  dequeueUserInput,
+  enqueueUserInput,
+  removeActiveController,
+  removePendingFile,
+  selectActiveControllers,
+  selectConfigError,
+  selectCurrentDialogKey,
+  selectDialogRuntimeByKey,
+  selectDialogRuntimeTokens,
+  selectLoopStopReason,
+  selectPendingFiles,
+  selectPendingRawData,
+  selectPendingRawDataByPageKey,
+  selectPendingUserInputQueue,
+  setLoopStopReason,
+  tokenUsageLiveUpdate,
+  useActiveControllers,
+  useCurrentDialogKey,
+  useDialogConfigError,
+  useDialogRuntimeTokens,
+  useLoopStopReason,
+  usePendingFiles,
+  usePendingUserInputQueue
+} from "./chunk-3ASDTTEI.js";
+import "./chunk-DWLEOOGR.js";
+import "./chunk-HNMXYYJR.js";
+import "./chunk-VX3SXJ3N.js";
+import "./chunk-Y5GCAMGP.js";
+import "./chunk-URUUZLPA.js";
+import "./chunk-AZPCASRE.js";
+import "./chunk-7U44LYTR.js";
+import "./chunk-KX6YBIHG.js";
+import "./chunk-O4BU24WZ.js";
+import "./chunk-I42VC5KR.js";
+import "./chunk-WWC7I6TA.js";
+import "./chunk-QSJ3HFEF.js";
+import "./chunk-DSZUWUYB.js";
+import "./chunk-UTLZINAP.js";
+import "./chunk-OOSFSFMA.js";
+import "./chunk-GBRG75BQ.js";
+import "./chunk-4SN6J65J.js";
+import "./chunk-LCBAMY2M.js";
+import "./chunk-3EUW3WEO.js";
+import "./chunk-U6VC4MU4.js";
+import "./chunk-CF7PE763.js";
+import "./chunk-G3SUCT4W.js";
+import "./chunk-KUG52IAP.js";
+import "./chunk-4VNS5WPM.js";
+export {
+  GLOBAL_DIALOG_RUNTIME_KEY,
+  abortAllMessages,
+  addActiveController,
+  addDialogAgent,
+  addPendingFile,
+  clearActiveControllers,
+  clearDialogRuntimeState,
+  clearDialogState,
+  clearPendingAttachments,
+  clearPendingUserInputQueue,
+  createAgentAutomation,
+  createDialog,
+  createPageAndAddReference,
+  deleteDialog,
+  dequeueUserInput,
+  enqueueUserInput,
+  handleSendMessage,
+  initDialog,
+  removeActiveController,
+  removeDialogAgent,
+  removePendingFile,
+  selectActiveControllers,
+  selectConfigError,
+  selectCurrentDialogAgentIds,
+  selectCurrentDialogConfig,
+  selectCurrentDialogKey,
+  selectCurrentDialogTokens,
+  selectCurrentPrimaryAgentId,
+  selectDialogConfigByKey,
+  selectDialogRuntimeByKey,
+  selectDialogRuntimeTokens,
+  selectLoopStopReason,
+  selectPendingFiles,
+  selectPendingRawData,
+  selectPendingRawDataByPageKey,
+  selectPendingUserInputQueue,
+  selectTotalDialogTokens,
+  setDialogExtraReferences,
+  setLoopStopReason,
+  setPrimaryDialogAgent,
+  tokenUsageLiveUpdate,
+  updateDialogTitle,
+  updateTokens,
+  useActiveControllers,
+  useCurrentDialogKey,
+  useDialogConfigError,
+  useDialogRuntimeTokens,
+  useLoopStopReason,
+  usePendingFiles,
+  usePendingUserInputQueue
+};

package/docCreateCommands-SIL3NPGT.js

@@ -0,0 +1,220 @@
+import {
+  findPotentialSecrets,
+  formatSecretFindings
+} from "./chunk-S7Z2HMCN.js";
+import {
+  buildPageKey,
+  buildPageRecord,
+  buildSkillDocId,
+  buildSkillPageKey,
+  buildSkillPageRecord,
+  buildSkillSummaryForRecord,
+  createPageId,
+  hasFlag,
+  hasHelpArg,
+  parseJsonArg,
+  readBodyArg,
+  readTitle,
+  requireTokenUser,
+  resolveDocKind,
+  resolveWriteTargets,
+  writePageRecord
+} from "./chunk-7KCUSYT2.js";
+import "./chunk-SDJDLO5W.js";
+import "./chunk-N54XAP77.js";
+import "./chunk-VHBWHNVT.js";
+import "./chunk-VF4K2QE6.js";
+import "./chunk-VC6OZXO5.js";
+import "./chunk-UAD2WT54.js";
+import "./chunk-IDZTNRP2.js";
+import {
+  readOption
+} from "./chunk-ISNCLGUZ.js";
+import "./chunk-OLZBQWZU.js";
+import "./chunk-WZSRQNQG.js";
+import "./chunk-O2ZNTTET.js";
+import "./chunk-5KLGBAAR.js";
+import "./chunk-ZNFJWEN4.js";
+import "./chunk-TILFE6LV.js";
+import "./chunk-4QEWT7KD.js";
+import "./chunk-OPZYGHUC.js";
+import "./chunk-AGFH73SK.js";
+import "./chunk-JRKKFRAV.js";
+import "./chunk-P3PKED2I.js";
+import "./chunk-5MMAK75Q.js";
+import "./chunk-BBYVOSU2.js";
+import "./chunk-5CS33IBL.js";
+import "./chunk-JZPBVBIY.js";
+import "./chunk-IWX4UW2E.js";
+import "./chunk-DWLEOOGR.js";
+import "./chunk-HNMXYYJR.js";
+import "./chunk-KX6YBIHG.js";
+import "./chunk-O4BU24WZ.js";
+import "./chunk-I42VC5KR.js";
+import "./chunk-WWC7I6TA.js";
+import "./chunk-QSJ3HFEF.js";
+import "./chunk-4SN6J65J.js";
+import "./chunk-LCBAMY2M.js";
+import "./chunk-3EUW3WEO.js";
+import "./chunk-U6VC4MU4.js";
+import "./chunk-CF7PE763.js";
+import "./chunk-G3SUCT4W.js";
+import "./chunk-KUG52IAP.js";
+import "./chunk-4VNS5WPM.js";
+
+// packages/cli/docCreateCommands.ts
+function printDocCreateUsage(output) {
+  output.write(`Usage:
+  nolo doc create --title <title> [--body ... | --body-file path] [--id ...] [--space ...]
+
+Options:
+  --description <text>      Optional page description stored in meta.
+  --sync local,main,us      Choose write targets. Values may also be full URLs.
+  --local-only              Write only to the local server target.
+  --no-local                Exclude local targets when --sync includes them.
+  --dry-run                 Build and validate without writing.
+  --json                    Print machine-readable JSON.
+  --allow-secrets           Allow bodies that look like credentials.
+  --server <url>            Default write target when --sync is omitted.
+  --token <jwt>             Auth token. Required for writes.
+`);
+}
+function printSkillDocCreateUsage(output) {
+  output.write(`Usage:
+  nolo skill-doc create --title <title> --description <text> [--body ... | --body-file path]
+  nolo skill create-doc --title <title> --description <text> [--body ... | --body-file path]
+
+Options:
+  --tools '["readDoc"]'                 Tool names this skill expects.
+  --required-skills '["skill-a"]'       Required skill references.
+  --recommended-skills '["skill-b"]'    Recommended skill references.
+  --preferred-agents '["agent-key"]'    Preferred agent keys.
+  --trigger-mode explicit|required|recommended
+  --budget-tier low|medium|high
+  --prompt-patch <text>
+  --page | --kind page                  Create a normal page instead of a skill-backed page.
+  --sync local,main,us                  Choose write targets. Values may also be full URLs.
+  --dry-run                             Build and validate without writing.
+  --json                                Print machine-readable JSON.
+  --token <jwt>                         Auth token. Required for writes.
+`);
+}
+async function runCreateCommand(args, deps, options) {
+  if (hasHelpArg(args)) {
+    options.usage(process.stdout);
+    return 0;
+  }
+  const title = readTitle(args);
+  const description = readOption(args, "--description") ?? "";
+  const docKind = resolveDocKind(args, options.defaultKind);
+  const shouldDryRun = hasFlag(args, "--dry-run");
+  const shouldOutputJson = hasFlag(args, "--json");
+  const allowSecrets = hasFlag(args, "--allow-secrets");
+  const spaceId = readOption(args, "--space") ?? null;
+  if (!title || docKind === "skill" && !description) {
+    options.usage(process.stderr);
+    return 1;
+  }
+  const body = readBodyArg(args, "");
+  const secretFindings = findPotentialSecrets(body);
+  if (secretFindings.length && !allowSecrets) {
+    throw new Error(
+      [
+        "Document body appears to contain credentials or secrets. Pass --allow-secrets to write it anyway.",
+        formatSecretFindings(secretFindings)
+      ].join("\n")
+    );
+  }
+  const { authToken, userId } = requireTokenUser(args, deps.env, shouldDryRun);
+  const targets = resolveWriteTargets(args, deps.env);
+  if (!targets.length) {
+    throw new Error("No write targets resolved. Check --sync / --local-only / --no-local.");
+  }
+  const explicitId = readOption(args, "--id");
+  const docId = explicitId ?? (docKind === "skill" ? buildSkillDocId(title) : createPageId());
+  const dbKey = docKind === "skill" ? buildSkillPageKey(userId, docId) : buildPageKey(userId, docId);
+  const record = docKind === "skill" ? buildSkillPageRecord({
+    dbKey,
+    skillId: docId,
+    title,
+    spaceId,
+    body,
+    skillConfig: {
+      version: "0.1",
+      kind: "skill",
+      id: docId,
+      name: title,
+      description,
+      ...parseJsonArg(readOption(args, "--tools"), []).length ? { toolNames: parseJsonArg(readOption(args, "--tools"), []) } : {},
+      ...parseJsonArg(readOption(args, "--required-skills"), []).length ? { requiredSkills: parseJsonArg(readOption(args, "--required-skills"), []) } : {},
+      ...parseJsonArg(readOption(args, "--recommended-skills"), []).length ? { recommendedSkills: parseJsonArg(readOption(args, "--recommended-skills"), []) } : {},
+      ...parseJsonArg(readOption(args, "--preferred-agents"), []).length ? { preferredAgents: parseJsonArg(readOption(args, "--preferred-agents"), []) } : {},
+      ...readOption(args, "--trigger-mode") ? { triggerMode: readOption(args, "--trigger-mode") } : {},
+      ...readOption(args, "--budget-tier") ? { budgetTier: readOption(args, "--budget-tier") } : {},
+      ...readOption(args, "--prompt-patch") ? { promptPatch: readOption(args, "--prompt-patch") } : {}
+    }
+  }) : buildPageRecord({
+    dbKey,
+    pageId: docId,
+    title,
+    spaceId,
+    content: body,
+    meta: description ? { description } : void 0
+  });
+  const skillSummary = buildSkillSummaryForRecord(record);
+  const summary = {
+    dryRun: shouldDryRun,
+    kind: docKind,
+    title,
+    dbKey,
+    id: docId,
+    userId,
+    spaceId,
+    syncTargets: targets,
+    writtenTargets: [],
+    secretFindingCount: secretFindings.length,
+    secretFindings
+  };
+  if (!shouldDryRun) {
+    for (const serverUrl of targets) {
+      await writePageRecord({
+        authToken,
+        dbKey,
+        record,
+        serverUrl,
+        spaceId,
+        title,
+        userId,
+        skillSummary
+      });
+      summary.writtenTargets.push(serverUrl);
+    }
+  }
+  if (shouldOutputJson) {
+    process.stdout.write(`${JSON.stringify(summary, null, 2)}
+`);
+  } else if (shouldDryRun) {
+    process.stdout.write(`dry-run ok: ${dbKey}
+`);
+  } else {
+    process.stdout.write(`created ${docKind}: ${dbKey}
+`);
+  }
+  return 0;
+}
+async function runDocCreateCommand(args, deps) {
+  return runCreateCommand(args, deps, {
+    defaultKind: "page",
+    usage: printDocCreateUsage
+  });
+}
+async function runSkillDocCreateCommand(args, deps) {
+  return runCreateCommand(args, deps, {
+    defaultKind: "skill",
+    usage: printSkillDocCreateUsage
+  });
+}
+export {
+  runDocCreateCommand,
+  runSkillDocCreateCommand
+};

package/docDeleteCommands-7IOMLUS4.js

@@ -0,0 +1,181 @@
+import {
+  buildPageKey,
+  buildSkillPageKey,
+  hasFlag,
+  hasHelpArg,
+  readPageRecord,
+  removePageFromSpace,
+  requireTokenUser,
+  resolveDocKind,
+  resolveWriteTargets
+} from "./chunk-7KCUSYT2.js";
+import {
+  deleteDbRecordOnServers
+} from "./chunk-RL776AGR.js";
+import "./chunk-SDJDLO5W.js";
+import "./chunk-N54XAP77.js";
+import "./chunk-VHBWHNVT.js";
+import "./chunk-KQHGZWSV.js";
+import "./chunk-VF4K2QE6.js";
+import "./chunk-VC6OZXO5.js";
+import "./chunk-UAD2WT54.js";
+import "./chunk-IDZTNRP2.js";
+import {
+  readOption
+} from "./chunk-ISNCLGUZ.js";
+import "./chunk-OLZBQWZU.js";
+import "./chunk-WZSRQNQG.js";
+import "./chunk-O2ZNTTET.js";
+import "./chunk-5KLGBAAR.js";
+import "./chunk-ZNFJWEN4.js";
+import "./chunk-TILFE6LV.js";
+import "./chunk-4QEWT7KD.js";
+import "./chunk-OPZYGHUC.js";
+import "./chunk-AGFH73SK.js";
+import "./chunk-JRKKFRAV.js";
+import "./chunk-P3PKED2I.js";
+import "./chunk-5MMAK75Q.js";
+import "./chunk-BBYVOSU2.js";
+import "./chunk-5CS33IBL.js";
+import "./chunk-JZPBVBIY.js";
+import "./chunk-IWX4UW2E.js";
+import "./chunk-DWLEOOGR.js";
+import "./chunk-HNMXYYJR.js";
+import "./chunk-KX6YBIHG.js";
+import "./chunk-O4BU24WZ.js";
+import "./chunk-I42VC5KR.js";
+import "./chunk-WWC7I6TA.js";
+import "./chunk-QSJ3HFEF.js";
+import "./chunk-GBRG75BQ.js";
+import "./chunk-4SN6J65J.js";
+import "./chunk-LCBAMY2M.js";
+import "./chunk-3EUW3WEO.js";
+import "./chunk-U6VC4MU4.js";
+import "./chunk-CF7PE763.js";
+import "./chunk-G3SUCT4W.js";
+import "./chunk-KUG52IAP.js";
+import "./chunk-4VNS5WPM.js";
+
+// packages/cli/docDeleteCommands.ts
+function printDocDeleteUsage(output) {
+  output.write(`Usage:
+  nolo doc delete (--id <pageId> | --key <pageKey>)
+
+Options:
+  --id <pageId>             Page id (without user prefix).
+  --key <pageKey>           Full dbKey, e.g. page-<userId>-<pageId>.
+  --sync local,main,us      Choose delete targets. Values may also be full URLs.
+  --local-only              Delete only on the local server target.
+  --no-local                Exclude local targets when --sync includes them.
+  --dry-run                 Show what would be deleted without deleting.
+  --json                    Print machine-readable JSON.
+  --server <url>            Default target when --sync is omitted.
+  --token <jwt>             Auth token. Required for deletes.
+`);
+}
+function printSkillDocDeleteUsage(output) {
+  output.write(`Usage:
+  nolo skill-doc delete (--id <skillId> | --key <pageKey>)
+
+Options:
+  --id <skillId>            Skill id (without user prefix).
+  --key <pageKey>           Full dbKey, e.g. page-<userId>-<skillId>.
+  --sync local,main,us      Choose delete targets. Values may also be full URLs.
+  --local-only              Delete only on the local server target.
+  --no-local                Exclude local targets when --sync includes them.
+  --dry-run                 Show what would be deleted without deleting.
+  --json                    Print machine-readable JSON.
+  --token <jwt>             Auth token. Required for deletes.
+`);
+}
+async function runDeleteCommand(args, deps, options) {
+  if (hasHelpArg(args)) {
+    options.usage(process.stdout);
+    return 0;
+  }
+  const explicitId = readOption(args, "--id");
+  const explicitKey = readOption(args, "--key");
+  if (!explicitId && !explicitKey) {
+    options.usage(process.stderr);
+    return 1;
+  }
+  const docKind = resolveDocKind(args, options.defaultKind);
+  const shouldDryRun = hasFlag(args, "--dry-run");
+  const shouldOutputJson = hasFlag(args, "--json");
+  const { authToken, userId } = requireTokenUser(args, deps.env, shouldDryRun);
+  const targets = resolveWriteTargets(args, deps.env);
+  if (!targets.length) {
+    throw new Error("No delete targets resolved. Check --sync / --local-only / --no-local.");
+  }
+  const dbKey = explicitKey ?? (docKind === "skill" ? buildSkillPageKey(userId, explicitId) : buildPageKey(userId, explicitId));
+  const existing = await readPageRecord({ authToken, dbKey, serverUrl: targets[0] });
+  if (docKind === "page" && existing?.meta?.kind === "skill") {
+    throw new Error(`Target page is a skill doc. Use nolo skill-doc delete --key ${dbKey}`);
+  }
+  if (docKind === "skill" && existing?.meta?.kind !== "skill") {
+    throw new Error(`Target page is not a skill doc. Use nolo doc delete --key ${dbKey}`);
+  }
+  const spaceId = typeof existing?.spaceId === "string" ? existing.spaceId : null;
+  const summary = {
+    dryRun: shouldDryRun,
+    kind: docKind,
+    dbKey,
+    userId,
+    spaceId,
+    syncTargets: targets,
+    deletedTargets: []
+  };
+  if (!shouldDryRun) {
+    if (spaceId) {
+      for (const serverUrl of targets) {
+        await removePageFromSpace({
+          baseUrl: serverUrl,
+          userId,
+          authToken,
+          spaceId,
+          contentKey: dbKey
+        }).catch(() => null);
+      }
+    }
+    const results = await deleteDbRecordOnServers({
+      authToken,
+      dbKey,
+      fetchImpl: fetch,
+      serverUrls: targets
+    });
+    const failed = results.filter((result) => !result.ok);
+    if (failed.length) {
+      throw new Error(
+        `delete ${dbKey} failed on ${failed.map((result) => `${result.serverUrl}: ${result.error}`).join("; ")}`
+      );
+    }
+    summary.deletedTargets.push(...results.map((result) => result.serverUrl));
+  }
+  if (shouldOutputJson) {
+    process.stdout.write(`${JSON.stringify(summary, null, 2)}
+`);
+  } else if (shouldDryRun) {
+    process.stdout.write(`dry-run ok: ${dbKey}
+`);
+  } else {
+    process.stdout.write(`deleted ${docKind}: ${dbKey}
+`);
+  }
+  return 0;
+}
+async function runDocDeleteCommand(args, deps) {
+  return runDeleteCommand(args, deps, {
+    defaultKind: "page",
+    usage: printDocDeleteUsage
+  });
+}
+async function runSkillDocDeleteCommand(args, deps) {
+  return runDeleteCommand(args, deps, {
+    defaultKind: "skill",
+    usage: printSkillDocDeleteUsage
+  });
+}
+export {
+  runDocDeleteCommand,
+  runSkillDocDeleteCommand
+};

package/docReadCommands-FNFXUA5L.js

@@ -0,0 +1,134 @@
+import {
+  buildPageKey,
+  buildSkillPageKey,
+  hasFlag,
+  hasHelpArg,
+  readPageRecord,
+  requireTokenUser,
+  resolveDocKind,
+  resolveWriteTargets
+} from "./chunk-7KCUSYT2.js";
+import "./chunk-SDJDLO5W.js";
+import "./chunk-N54XAP77.js";
+import "./chunk-VHBWHNVT.js";
+import "./chunk-VF4K2QE6.js";
+import "./chunk-VC6OZXO5.js";
+import "./chunk-UAD2WT54.js";
+import "./chunk-IDZTNRP2.js";
+import {
+  readOption
+} from "./chunk-ISNCLGUZ.js";
+import "./chunk-OLZBQWZU.js";
+import "./chunk-WZSRQNQG.js";
+import "./chunk-O2ZNTTET.js";
+import "./chunk-5KLGBAAR.js";
+import "./chunk-ZNFJWEN4.js";
+import "./chunk-TILFE6LV.js";
+import "./chunk-4QEWT7KD.js";
+import "./chunk-OPZYGHUC.js";
+import "./chunk-AGFH73SK.js";
+import "./chunk-JRKKFRAV.js";
+import "./chunk-P3PKED2I.js";
+import "./chunk-5MMAK75Q.js";
+import "./chunk-BBYVOSU2.js";
+import "./chunk-5CS33IBL.js";
+import "./chunk-JZPBVBIY.js";
+import "./chunk-IWX4UW2E.js";
+import "./chunk-DWLEOOGR.js";
+import "./chunk-HNMXYYJR.js";
+import "./chunk-KX6YBIHG.js";
+import "./chunk-O4BU24WZ.js";
+import "./chunk-I42VC5KR.js";
+import "./chunk-WWC7I6TA.js";
+import "./chunk-QSJ3HFEF.js";
+import "./chunk-4SN6J65J.js";
+import "./chunk-LCBAMY2M.js";
+import "./chunk-3EUW3WEO.js";
+import "./chunk-U6VC4MU4.js";
+import "./chunk-CF7PE763.js";
+import "./chunk-G3SUCT4W.js";
+import "./chunk-KUG52IAP.js";
+import "./chunk-4VNS5WPM.js";
+
+// packages/cli/docReadCommands.ts
+function printDocReadUsage(output) {
+  output.write(`Usage:
+  nolo doc read (--id <pageId> | --key <pageKey>)
+
+Options:
+  --id <pageId>             Page id (without user prefix).
+  --key <pageKey>           Full dbKey, e.g. page-<userId>-<pageId>.
+  --server <url>            Server to read from.
+  --token <jwt>             Auth token. Required for reads.
+`);
+}
+function printSkillDocReadUsage(output) {
+  output.write(`Usage:
+  nolo skill-doc read (--id <skillId> | --key <pageKey>)
+
+Options:
+  --id <skillId>            Skill id (without user prefix).
+  --key <pageKey>           Full dbKey, e.g. page-<userId>-<skillId>.
+  --server <url>            Server to read from.
+  --token <jwt>             Auth token. Required for reads.
+`);
+}
+async function runReadCommand(args, deps, options) {
+  if (hasHelpArg(args)) {
+    options.usage(process.stdout);
+    return 0;
+  }
+  const explicitId = readOption(args, "--id");
+  const explicitKey = readOption(args, "--key");
+  if (!explicitId && !explicitKey) {
+    options.usage(process.stderr);
+    return 1;
+  }
+  const docKind = resolveDocKind(args, options.defaultKind);
+  const shouldOutputJson = hasFlag(args, "--json");
+  const { authToken, userId } = requireTokenUser(args, deps.env, false);
+  const targets = resolveWriteTargets(args, deps.env);
+  if (!targets.length) {
+    throw new Error("No read targets resolved. Check --server.");
+  }
+  const dbKey = explicitKey ?? (docKind === "skill" ? buildSkillPageKey(userId, explicitId) : buildPageKey(userId, explicitId));
+  let record = null;
+  for (const serverUrl of targets) {
+    try {
+      record = await readPageRecord({ authToken, dbKey, serverUrl });
+      if (record) break;
+    } catch {
+    }
+  }
+  if (!record) {
+    throw new Error(`doc not found: ${dbKey}`);
+  }
+  if (shouldOutputJson) {
+    process.stdout.write(`${JSON.stringify({ dbKey, record }, null, 2)}
+`);
+  } else {
+    process.stdout.write(`read ${docKind}: ${dbKey}
+`);
+    process.stdout.write(`title: ${record.title ?? "(none)"}
+`);
+    process.stdout.write(`spaceId: ${record.spaceId ?? "(none)"}
+`);
+  }
+  return 0;
+}
+async function runDocReadCommand(args, deps) {
+  return runReadCommand(args, deps, {
+    defaultKind: "page",
+    usage: printDocReadUsage
+  });
+}
+async function runSkillDocReadCommand(args, deps) {
+  return runReadCommand(args, deps, {
+    defaultKind: "skill",
+    usage: printSkillDocReadUsage
+  });
+}
+export {
+  runDocReadCommand,
+  runSkillDocReadCommand
+};