nolo-cli 0.1.31 → 0.1.33

package/spaceReadCommands.ts

@@ -1,323 +0,0 @@
-import { ContentType } from "./app/types";
-import { parseSkillDocProtocol, resolvePageSkillMetadata } from "./ai/skills/skillDocProtocol";
-import { createSpaceKey } from "./create/space/spaceKeys";
-import { getReadableCliDb, type AgentCommandDeps } from "./agentCommandSupport";
-import { readDbRecord } from "./agentRecordHelpers";
-import {
-  parseUserIdFromAuthToken,
-  readOption,
-  resolveAuthToken,
-  resolveServerCandidates,
-  resolveServerUrl,
-} from "./cliEnvHelpers";
-import { readRecordWithCandidates } from "./hybridReadHelpers";
-import { parseSpaceIdFromInput } from "./spaceMutationHelpers";
-
-function readPositionalInput(args: string[]) {
-  for (let index = 0; index < args.length; index += 1) {
-    const value = args[index];
-    if (value === "--content-key") {
-      index += 1;
-      continue;
-    }
-    if (!value.startsWith("-")) return value;
-  }
-  return undefined;
-}
-
-function parseSpaceReadArgs(args: string[]) {
-  const raw = readPositionalInput(args);
-  if (!raw) throw new Error("Usage: nolo space read <spaceId|spaceKey|spaceUrl> [--brief] [--content-key <key>] [--include-record]");
-  const brief = args.includes("--brief");
-  const contentKeyFilter = readOption(args, "--content-key");
-  const includeRecord = args.includes("--include-record") || (!brief && !contentKeyFilter);
-  return {
-    raw,
-    brief,
-    contentKeyFilter,
-    includeRecord,
-  };
-}
-
-function buildContentEntries(space: Record<string, any>) {
-  return Object.entries(space.contents ?? {})
-    .filter(([, value]) => value && typeof value === "object")
-    .map(([entryKey, value]) => ({
-      entryKey,
-      ...(value as Record<string, any>),
-    }))
-    .sort((a, b) => {
-      const pinnedDiff = Number(Boolean(b.pinned)) - Number(Boolean(a.pinned));
-      if (pinnedDiff !== 0) return pinnedDiff;
-      const orderA = typeof a.order === "number" ? a.order : Number.MAX_SAFE_INTEGER;
-      const orderB = typeof b.order === "number" ? b.order : Number.MAX_SAFE_INTEGER;
-      if (orderA !== orderB) return orderA - orderB;
-      return (b.updatedAt ?? 0) - (a.updatedAt ?? 0);
-    });
-}
-
-function buildCategories(space: Record<string, any>) {
-  return Object.entries(space.categories ?? {})
-    .filter(([, value]) => value && typeof value === "object")
-    .map(([categoryId, value]) => ({
-      categoryId,
-      ...(value as Record<string, any>),
-    }))
-    .sort((a, b) => {
-      const orderA = typeof a.order === "number" ? a.order : Number.MAX_SAFE_INTEGER;
-      const orderB = typeof b.order === "number" ? b.order : Number.MAX_SAFE_INTEGER;
-      if (orderA !== orderB) return orderA - orderB;
-      return String(a.name ?? "").localeCompare(String(b.name ?? ""), "zh-Hans");
-    });
-}
-
-export async function runSpaceReadCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  const env = deps.env ?? process.env;
-  const output = deps.output ?? process.stdout;
-  const { raw, brief, contentKeyFilter, includeRecord } = parseSpaceReadArgs(args);
-
-  const authToken = resolveAuthToken(args, env);
-  if (!authToken) {
-    output.write("[nolo] space read requires an auth token. Run `nolo login` or set AUTH_TOKEN.\n");
-    return 1;
-  }
-
-  const userId = parseUserIdFromAuthToken(authToken);
-  if (!userId) {
-    output.write("[nolo] space read could not read userId from AUTH_TOKEN.\n");
-    return 1;
-  }
-
-  const db = deps.db ?? await getReadableCliDb(output);
-  const fetchImpl = deps.fetchImpl ?? fetch;
-  const fallbackFetchImpl = deps.fallbackFetchImpl;
-  const defaultServerUrl = resolveServerUrl(args, env);
-  const serverCandidates = resolveServerCandidates(args, env, defaultServerUrl);
-
-  try {
-    const spaceId = parseSpaceIdFromInput(raw);
-    const spaceKey = createSpaceKey.space(spaceId);
-    const space = await readRecordWithCandidates<Record<string, any>>({
-      db,
-      dbKey: spaceKey,
-      serverCandidates,
-      readRemote: async (serverUrl, dbKey) =>
-        readDbRecord({
-          authToken,
-          dbKey,
-          fallbackFetchImpl,
-          fetchImpl,
-          serverUrl,
-        }),
-    });
-
-    const categories = buildCategories(space);
-    const allContents = buildContentEntries(space);
-    const contents = contentKeyFilter
-      ? allContents.filter((item) => {
-          const contentKey =
-            typeof item.contentKey === "string" && item.contentKey.trim()
-              ? item.contentKey.trim()
-              : item.entryKey;
-          return item.entryKey === contentKeyFilter || contentKey === contentKeyFilter;
-        })
-      : allContents;
-
-    const contentCounts = allContents.reduce<Record<string, number>>((acc, item) => {
-      const type = typeof item.type === "string" ? item.type : "unknown";
-      acc[type] = (acc[type] ?? 0) + 1;
-      return acc;
-    }, {});
-
-    const categoryContentMap = allContents.reduce<Record<string, string[]>>((acc, item) => {
-      const categoryId =
-        typeof item.categoryId === "string" && item.categoryId.trim()
-          ? item.categoryId.trim()
-          : "";
-      if (!categoryId) return acc;
-      if (!acc[categoryId]) acc[categoryId] = [];
-      acc[categoryId].push(
-        typeof item.contentKey === "string" && item.contentKey.trim()
-          ? item.contentKey.trim()
-          : item.entryKey
-      );
-      return acc;
-    }, {});
-
-    const categoriesWithStats = categories.map((category) => ({
-      ...category,
-      itemCount: categoryContentMap[category.categoryId]?.length ?? 0,
-      contentKeys: categoryContentMap[category.categoryId] ?? [],
-    }));
-
-    const uncategorizedContentKeys = contents
-      .filter((item) => !(typeof item.categoryId === "string" && item.categoryId.trim()))
-      .map((item) =>
-        typeof item.contentKey === "string" && item.contentKey.trim()
-          ? item.contentKey.trim()
-          : item.entryKey
-      );
-
-    const resolvedAgents = await Promise.all(
-      contents
-        .filter((item) => item.type === ContentType.AGENT && !brief)
-        .map(async (item) => {
-          const contentKey =
-            typeof item.contentKey === "string" && item.contentKey.trim()
-              ? item.contentKey.trim()
-              : item.entryKey;
-          try {
-            const record = await readRecordWithCandidates<Record<string, any>>({
-              db,
-              dbKey: contentKey,
-              serverCandidates,
-              readRemote: async (serverUrl, dbKey) =>
-                readDbRecord({
-                  authToken,
-                  dbKey,
-                  fallbackFetchImpl,
-                  fetchImpl,
-                  serverUrl,
-                }),
-            });
-            return {
-              contentKey,
-              slotTitle: item.title,
-              categoryId: item.categoryId ?? null,
-              pinned: !!item.pinned,
-              updatedAt: item.updatedAt ?? null,
-              agentId: record?.id ?? null,
-              name: record?.name ?? null,
-              model: record?.model ?? null,
-              provider: record?.provider ?? record?.apiSource ?? null,
-              isPublic: typeof record?.isPublic === "boolean" ? record.isPublic : null,
-              userId: record?.userId ?? null,
-              tools: Array.isArray(record?.tools) ? record.tools : [],
-              customProviderUrl: record?.customProviderUrl ?? null,
-            };
-          } catch (error) {
-            return {
-              contentKey,
-              slotTitle: item.title,
-              categoryId: item.categoryId ?? null,
-              pinned: !!item.pinned,
-              updatedAt: item.updatedAt ?? null,
-              readError: error instanceof Error ? error.message : String(error),
-            };
-          }
-        })
-    );
-
-    const resolvedSkillDocs = (
-      await Promise.all(
-        contents
-          .filter((item) => item.type === ContentType.DOC && !brief)
-          .map(async (item) => {
-            const contentKey =
-              typeof item.contentKey === "string" && item.contentKey.trim()
-                ? item.contentKey.trim()
-                : item.entryKey;
-            try {
-              const record = await readRecordWithCandidates<Record<string, any>>({
-                db,
-                dbKey: contentKey,
-                serverCandidates,
-                readRemote: async (serverUrl, dbKey) =>
-                  readDbRecord({
-                    authToken,
-                    dbKey,
-                    fallbackFetchImpl,
-                    fetchImpl,
-                    serverUrl,
-                  }),
-              });
-              const parsed = parseSkillDocProtocol(
-                typeof record?.content === "string" ? record.content : "",
-                record?.meta,
-                record?.tools
-              );
-              const meta = resolvePageSkillMetadata(record);
-              const skillConfig = meta?.skillConfig;
-              if (!(meta?.kind === "skill" || skillConfig)) {
-                return null;
-              }
-              return {
-                contentKey,
-                slotTitle: item.title,
-                title: record?.title ?? item.title ?? null,
-                categoryId: item.categoryId ?? null,
-                pinned: !!item.pinned,
-                updatedAt: item.updatedAt ?? null,
-                skillId: skillConfig?.id ?? record?.id ?? null,
-                name: skillConfig?.name ?? null,
-                description: skillConfig?.description ?? null,
-                toolNames: skillConfig?.toolNames ?? [],
-                requiredSkills: skillConfig?.requiredSkills ?? [],
-                recommendedSkills: skillConfig?.recommendedSkills ?? [],
-                triggerMode: skillConfig?.triggerMode ?? null,
-                promptPatch: skillConfig?.promptPatch ?? null,
-                bodyPreview:
-                  typeof parsed.content === "string" ? parsed.content.slice(0, 240) : "",
-              };
-            } catch (error) {
-              return {
-                contentKey,
-                slotTitle: item.title,
-                categoryId: item.categoryId ?? null,
-                pinned: !!item.pinned,
-                updatedAt: item.updatedAt ?? null,
-                readError: error instanceof Error ? error.message : String(error),
-              };
-            }
-          })
-      )
-    ).filter(Boolean);
-
-    const result: Record<string, any> = {
-      baseUrl: defaultServerUrl,
-      spaceId,
-      spaceKey,
-      name: space?.name ?? null,
-      description: space?.description ?? null,
-      ownerId: space?.ownerId ?? null,
-      visibility: space?.visibility ?? null,
-      memberCount: Array.isArray(space?.members) ? space.members.length : 0,
-      members: Array.isArray(space?.members) ? space.members : [],
-      categoryCount: categories.length,
-      categories: brief
-        ? categoriesWithStats.map(({ contentKeys, ...category }) => category)
-        : categoriesWithStats,
-      uncategorizedCount: uncategorizedContentKeys.length,
-      ...(brief ? {} : { uncategorizedContentKeys }),
-      contentCount: allContents.length,
-      contentCounts,
-      contents,
-      agents: resolvedAgents,
-      pageCount: allContents.filter((item) => item.type === ContentType.DOC).length,
-      skillDocCount: resolvedSkillDocs.length,
-      skillDocs: resolvedSkillDocs,
-    };
-
-    if (contentKeyFilter) {
-      result.contentKeyFilter = contentKeyFilter;
-      result.matchedCount = contents.length;
-    }
-
-    if (includeRecord) {
-      result.record = space;
-    }
-
-    output.write(`${JSON.stringify(result, null, 2)}\n`);
-    return 0;
-  } catch (error) {
-    output.write(
-      `[nolo] space read failed: ${
-        error instanceof Error ? error.message : String(error)
-      }\n`
-    );
-    return 1;
-  }
-}

package/tableDataOutput.ts

@@ -1,41 +0,0 @@
-export type TableDataOutputMode = "full" | "raw" | "items" | "jsonl";
-
-export function parseTableDataOutputMode(raw?: string): TableDataOutputMode {
-  const value = raw?.trim();
-  if (!value) return "full";
-  if (value === "json") return "raw";
-  if (value === "full" || value === "raw" || value === "items" || value === "jsonl") {
-    return value;
-  }
-  throw new Error(`--output must be one of full, raw, items, json, jsonl; got ${value}`);
-}
-
-function getItems(result: unknown): unknown[] | undefined {
-  if (!result || typeof result !== "object") return undefined;
-  const items = (result as any).items;
-  return Array.isArray(items) ? items : undefined;
-}
-
-export function formatTableDataOutput(input: {
-  envelope: unknown;
-  result: unknown;
-  mode: TableDataOutputMode;
-}): string {
-  if (input.mode === "full") {
-    return JSON.stringify(input.envelope, null, 2);
-  }
-  if (input.mode === "raw") {
-    return JSON.stringify(input.result, null, 2);
-  }
-
-  const items = getItems(input.result);
-  const value = items ?? input.result;
-  if (input.mode === "items") {
-    return JSON.stringify(value, null, 2);
-  }
-  if (!Array.isArray(value)) {
-    return JSON.stringify(value);
-  }
-  return value.map((item) => JSON.stringify(item)).join("\n");
-}
-

package/tableDataSafety.ts

@@ -1,26 +0,0 @@
-export const TABLE_SCHEMA_WRITE_ACTIONS = new Set(["add-column"]);
-
-export function isTableSchemaWriteAction(action: string): boolean {
-  return TABLE_SCHEMA_WRITE_ACTIONS.has(action.trim());
-}
-
-export function tableSchemaWriteSafetyMessage(action: string): string {
-  return [
-    `Action "${action}" mutates table schema metadata and must be serialized per table.`,
-    "Rerun with --schema-write-ok only after confirming no other agent/script is changing the same table schema.",
-    "Server-side schema CAS/locking is not implemented yet; row-level writes do not need this flag.",
-  ].join(" ");
-}
-
-export function assertTableSchemaWriteAllowed(input: {
-  action: string;
-  allowSchemaWrite: boolean;
-}): void {
-  if (!isTableSchemaWriteAction(input.action)) {
-    return;
-  }
-  if (input.allowSchemaWrite) {
-    return;
-  }
-  throw new Error(tableSchemaWriteSafetyMessage(input.action));
-}

package/tableMetaCommands.ts

@@ -1,307 +0,0 @@
-import { ulid } from "ulid";
-import { getReadableCliDb, type AgentCommandDeps } from "./agentCommandSupport";
-import { readDbRecord } from "./agentRecordHelpers";
-import { parseUserIdFromAuthToken, readOption, resolveAuthToken, resolveServerUrl } from "./cliEnvHelpers";
-import {
-  buildTableAttachedSpaceRecord,
-  parseSpaceIdFromInput,
-  readSpaceRecordWithFallback,
-} from "./spaceMutationHelpers";
-import { writeRemoteRecordsThenCache } from "./pageWriteHelpers";
-
-type ColumnType =
-  | "text"
-  | "number"
-  | "boolean"
-  | "date"
-  | "datetime"
-  | "select"
-  | "multi_select";
-
-type ColumnInput = {
-  id?: string;
-  name: string;
-  label?: string;
-  type?: ColumnType;
-  description?: string;
-  required?: boolean;
-  isPrimary?: boolean;
-  options?: string[];
-};
-
-function usage() {
-  return [
-    "Usage:",
-    "  nolo table meta --name <name> [--table <tableId|metaKey>] [--space <spaceId|spaceKey|spaceUrl>] [--category-id <id>] [--description <text>] [--tags <comma-list>] [--columns <json-array>]",
-    "",
-  ].join("\n");
-}
-
-function parseTableArg(raw?: string) {
-  if (!raw?.trim()) return {};
-  const trimmed = raw.trim();
-  if (trimmed.startsWith("meta-")) {
-    const parts = trimmed.split("-");
-    return {
-      tableId: parts.slice(2).join("-"),
-      dbKey: trimmed,
-    };
-  }
-  return { tableId: trimmed };
-}
-
-function parseTags(raw?: string) {
-  if (!raw) return undefined;
-  const tags = raw
-    .split(",")
-    .map((value) => value.trim())
-    .filter(Boolean);
-  return tags.length > 0 ? tags : undefined;
-}
-
-function defaultColumns(): ColumnInput[] {
-  return [
-    {
-      name: "title",
-      label: "标题",
-      type: "text",
-      description: "这一行记录的主题或名称。",
-      isPrimary: true,
-      required: true,
-    },
-    {
-      name: "note",
-      label: "备注",
-      type: "text",
-      description: "对该条目的补充说明。",
-    },
-  ];
-}
-
-function normalizeColumns(rawColumns?: string, existingColumns?: any[]) {
-  if (!rawColumns) {
-    if (Array.isArray(existingColumns) && existingColumns.length > 0) {
-      return existingColumns;
-    }
-    return defaultColumns().map((column) => ({ ...column, id: ulid() }));
-  }
-
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(rawColumns);
-  } catch (error) {
-    throw new Error(
-      `--columns must be a valid JSON array: ${
-        error instanceof Error ? error.message : String(error)
-      }`
-    );
-  }
-
-  if (!Array.isArray(parsed)) {
-    throw new Error("--columns must be a JSON array.");
-  }
-
-  const seen = new Set<string>();
-  const normalized = parsed
-    .map((value) => {
-      if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-      const column = value as ColumnInput;
-      const name = typeof column.name === "string" ? column.name.trim() : "";
-      if (!name || seen.has(name)) return null;
-      seen.add(name);
-
-      const nextColumn: Record<string, unknown> = {
-        id: typeof column.id === "string" && column.id.trim() ? column.id.trim() : ulid(),
-        name,
-      };
-      if (typeof column.label === "string" && column.label.trim()) nextColumn.label = column.label.trim();
-      if (typeof column.type === "string" && column.type.trim()) nextColumn.type = column.type.trim();
-      if (typeof column.description === "string" && column.description.trim()) {
-        nextColumn.description = column.description.trim();
-      }
-      if (typeof column.required === "boolean") nextColumn.required = column.required;
-      if (typeof column.isPrimary === "boolean") nextColumn.isPrimary = column.isPrimary;
-      if (Array.isArray(column.options)) {
-        const options = column.options
-          .map((option) => (typeof option === "string" ? option.trim() : ""))
-          .filter(Boolean);
-        if (options.length > 0) nextColumn.options = options;
-      }
-      return nextColumn;
-    })
-    .filter(Boolean) as Array<Record<string, unknown>>;
-
-  if (normalized.length === 0) {
-    throw new Error("--columns did not contain any valid columns.");
-  }
-  if (!normalized.some((column) => column.isPrimary === true)) {
-    normalized[0].isPrimary = true;
-  }
-  return normalized;
-}
-
-export async function runTableMetaCommand(
-  args: string[],
-  deps: AgentCommandDeps = {}
-) {
-  const env = deps.env ?? process.env;
-  const output = deps.output ?? process.stdout;
-
-  if (args.includes("--help") || args.includes("-h")) {
-    output.write(`${usage()}\n`);
-    return 0;
-  }
-
-  const rawName = readOption(args, "--name");
-  if (!rawName?.trim()) {
-    output.write(`${usage()}\n`);
-    return 1;
-  }
-
-  const authToken = resolveAuthToken(args, env);
-  const userId = parseUserIdFromAuthToken(authToken);
-  if (!authToken || !userId) {
-    output.write("[nolo] table meta requires an auth token with userId. Run `nolo login`.\n");
-    return 1;
-  }
-
-  const name = rawName.trim();
-  const description = readOption(args, "--description")?.trim() || undefined;
-  const tags = parseTags(readOption(args, "--tags"));
-  const serverUrl = resolveServerUrl(args, env);
-  const db = deps.db ?? await getReadableCliDb(output);
-  const fetchImpl = deps.fetchImpl ?? fetch;
-  const fallbackFetchImpl = deps.fallbackFetchImpl;
-
-  try {
-    const parsedTable = parseTableArg(readOption(args, "--table"));
-    const tableId = parsedTable.tableId ?? ulid();
-    const dbKey = parsedTable.dbKey ?? `meta-${userId}-${tableId}`;
-
-    let existingRecord: Record<string, any> | null = null;
-    try {
-      const value = await db.get(dbKey);
-      existingRecord = value && typeof value === "object" ? (value as Record<string, any>) : null;
-    } catch {
-      try {
-        existingRecord = await readDbRecord({
-          authToken,
-          dbKey,
-          fallbackFetchImpl,
-          fetchImpl,
-          serverUrl,
-        });
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        if (parsedTable.dbKey || parsedTable.tableId) {
-          if (!message.includes("404")) {
-            throw error;
-          }
-        }
-      }
-    }
-
-    const columns = normalizeColumns(readOption(args, "--columns"), existingRecord?.columns);
-    const nowIso = new Date().toISOString();
-    const rawSpace = readOption(args, "--space");
-    const spaceId =
-      rawSpace != null
-        ? parseSpaceIdFromInput(rawSpace)
-        : typeof existingRecord?.spaceId === "string" && existingRecord.spaceId
-          ? existingRecord.spaceId
-          : undefined;
-    const explicitCategoryId = readOption(args, "--category-id")?.trim() || undefined;
-    const categoryId =
-      explicitCategoryId ??
-      (typeof existingRecord?.categoryId === "string" && existingRecord.categoryId
-        ? existingRecord.categoryId
-        : undefined);
-
-    let spaceRecord: Record<string, any> | null = null;
-    if (spaceId) {
-      spaceRecord = await readSpaceRecordWithFallback({
-        authToken,
-        db,
-        fallbackFetchImpl,
-        fetchImpl,
-        serverCandidates: [serverUrl],
-        spaceId,
-      });
-      if (categoryId && !spaceRecord?.categories?.[categoryId]) {
-        throw new Error(`space ${spaceId} does not contain category ${categoryId}`);
-      }
-    }
-
-    const nextRecord = {
-      ...(existingRecord ?? {}),
-      dbKey,
-      tenantId: userId,
-      tableId,
-      spaceId: spaceId ?? null,
-      displayName: name,
-      ...(description !== undefined ? { description } : {}),
-      ...(tags !== undefined ? { tags } : existingRecord?.tags ? { tags: existingRecord.tags } : {}),
-      ...(categoryId ? { categoryId } : {}),
-      schemaVersion:
-        typeof existingRecord?.schemaVersion === "number" ? existingRecord.schemaVersion : 1,
-      columns,
-      views: Array.isArray(existingRecord?.views) ? existingRecord.views : [],
-      triggers: Array.isArray(existingRecord?.triggers) ? existingRecord.triggers : [],
-      aiConfig: existingRecord?.aiConfig,
-      createdAt: existingRecord?.createdAt ?? nowIso,
-      updatedAt: nowIso,
-      type: "table",
-    };
-
-    const writeRecords = [{ dbKey, record: nextRecord, serverUrl }];
-
-    if (spaceId && spaceRecord) {
-      const nextSpaceRecord = buildTableAttachedSpaceRecord({
-        categoryId,
-        contentKey: dbKey,
-        existingSpaceRecord: spaceRecord,
-        spaceId,
-        title: name,
-      });
-      writeRecords.push({
-        dbKey: `space-${spaceId}`,
-        record: nextSpaceRecord,
-        serverUrl,
-      });
-    }
-
-    await writeRemoteRecordsThenCache({
-      authToken,
-      db,
-      fallbackFetchImpl,
-      fetchImpl,
-      records: writeRecords,
-      userId,
-    });
-
-    output.write(
-      `${JSON.stringify(
-        {
-          ok: true,
-          action: existingRecord ? "updated" : "created",
-          baseUrl: serverUrl,
-          dbKey,
-          tableId,
-          spaceId: spaceId ?? null,
-          categoryId: categoryId ?? null,
-          table: nextRecord,
-        },
-        null,
-        2
-      )}\n`
-    );
-    return 0;
-  } catch (error) {
-    output.write(
-      `[nolo] table meta failed: ${
-        error instanceof Error ? error.message : String(error)
-      }\n`
-    );
-    return 1;
-  }
-}