nolo-cli 0.1.44 → 0.1.46

package/offlineMarxistsAgentCommand.ts

@@ -1,316 +0,0 @@
-import { DEFAULT_NOLO_SERVER_URL } from "./defaultServer";
-
-type EnvLike = Record<string, string | undefined>;
-
-type OutputLike = {
-  write(chunk: string): unknown;
-};
-
-type SetupOfflineMarxistsAgentDeps = {
-  env?: EnvLike;
-  output?: OutputLike;
-  fetchImpl?: typeof fetch;
-  now?: () => number;
-};
-
-type ParsedArgs = {
-  serverUrl: string;
-  authToken: string;
-  userId: string;
-  sourceAgentKey: string;
-  targetAgentId: string;
-  targetAgentKey: string;
-  spaceId: string;
-  name: string;
-  publicAgent: boolean;
-  json: boolean;
-};
-
-const DEFAULT_USER_ID = "b2e06f801f";
-const DEFAULT_SPACE_ID = "01KKY77TT0DA9NY7TNW3R7255N";
-const DEFAULT_SOURCE_AGENT_ID = "01MIMO25MONTH0000000NEW001";
-const DEFAULT_TARGET_AGENT_ID = "01OFFMARXBOOK000000010AHL1";
-const DEFAULT_AGENT_NAME = "离线马克思主义文库书籍转换助手";
-const TOOL_NAME = "convertMarxistsBookToOfflineHtml";
-const AGENT_TOOLS = [TOOL_NAME];
-
-function readFlagValue(args: string[], flag: string) {
-  const index = args.indexOf(flag);
-  return index >= 0 ? args[index + 1] : undefined;
-}
-
-function parseUserIdFromToken(token: string) {
-  const payload = token.split(".")[1];
-  if (!payload) return undefined;
-  try {
-    const normalized = payload.replace(/-/g, "+").replace(/_/g, "/");
-    const padded = normalized + "=".repeat((4 - (normalized.length % 4)) % 4);
-    const parsed = JSON.parse(Buffer.from(padded, "base64").toString("utf8"));
-    return typeof parsed?.userId === "string" && parsed.userId.trim()
-      ? parsed.userId.trim()
-      : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-function normalizeBaseUrl(value: string) {
-  return value.trim().replace(/\/+$/, "");
-}
-
-function parseArgs(args: string[], env: EnvLike): ParsedArgs | null {
-  if (args.includes("--help") || args.includes("-h")) return null;
-  const serverUrl = normalizeBaseUrl(
-    readFlagValue(args, "--server") ??
-      readFlagValue(args, "--server-url") ??
-      env.NOLO_SERVER ??
-      env.BASE_URL ??
-      DEFAULT_NOLO_SERVER_URL
-  );
-  const authToken = readFlagValue(args, "--token") ?? env.AUTH_TOKEN ?? env.NOLO_AUTH_TOKEN ?? "";
-  const userId =
-    readFlagValue(args, "--user-id") ??
-    env.NOLO_USER_ID ??
-    parseUserIdFromToken(authToken) ??
-    DEFAULT_USER_ID;
-  const sourceAgentKey =
-    readFlagValue(args, "--source-agent") ??
-    env.NOLO_MIMO_SOURCE_AGENT_KEY ??
-    `agent-${userId}-${DEFAULT_SOURCE_AGENT_ID}`;
-  const targetAgentId =
-    readFlagValue(args, "--target-agent-id") ??
-    env.NOLO_OFFLINE_MARXISTS_AGENT_ID ??
-    DEFAULT_TARGET_AGENT_ID;
-  const targetAgentKey =
-    readFlagValue(args, "--target-agent") ??
-    env.NOLO_OFFLINE_MARXISTS_AGENT_KEY ??
-    `agent-${userId}-${targetAgentId}`;
-  const spaceId =
-    readFlagValue(args, "--space") ??
-    env.NOLO_OFFLINE_MARXISTS_SPACE_ID ??
-    DEFAULT_SPACE_ID;
-
-  if (!authToken.trim()) return null;
-  return {
-    serverUrl,
-    authToken,
-    userId,
-    sourceAgentKey,
-    targetAgentId,
-    targetAgentKey,
-    spaceId,
-    name: readFlagValue(args, "--name") ?? DEFAULT_AGENT_NAME,
-    publicAgent: args.includes("--public"),
-    json: args.includes("--json"),
-  };
-}
-
-async function readDbRecord(args: {
-  fetchImpl: typeof fetch;
-  serverUrl: string;
-  authToken: string;
-  dbKey: string;
-}) {
-  const res = await args.fetchImpl(
-    `${args.serverUrl}/api/v1/db/read/${encodeURIComponent(args.dbKey)}`,
-    { headers: { Authorization: `Bearer ${args.authToken}` } }
-  );
-  const data = await res.json().catch(() => ({}));
-  if (!res.ok) {
-    throw new Error(`read ${args.dbKey} failed (${res.status}): ${JSON.stringify(data)}`);
-  }
-  return (data as any)?.data ?? data;
-}
-
-async function writeDbRecord(args: {
-  fetchImpl: typeof fetch;
-  serverUrl: string;
-  authToken: string;
-  userId: string;
-  dbKey: string;
-  data: Record<string, any>;
-}) {
-  const res = await args.fetchImpl(`${args.serverUrl}/api/v1/db/write/`, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${args.authToken}`,
-    },
-    body: JSON.stringify({
-      customKey: args.dbKey,
-      userId: args.userId,
-      data: { ...args.data, dbKey: args.dbKey },
-    }),
-  });
-  const data = await res.json().catch(() => ({}));
-  if (!res.ok) {
-    throw new Error(`write ${args.dbKey} failed (${res.status}): ${JSON.stringify(data)}`);
-  }
-}
-
-function buildTargetAgent(args: {
-  parsed: ParsedArgs;
-  source: Record<string, any>;
-  now: number;
-}) {
-  const { parsed, source, now } = args;
-  if (!source.apiKey) {
-    throw new Error(`source agent ${parsed.sourceAgentKey} has no apiKey`);
-  }
-  if (!source.customProviderUrl) {
-    throw new Error(`source agent ${parsed.sourceAgentKey} has no customProviderUrl`);
-  }
-  return {
-    id: parsed.targetAgentId,
-    type: "agent",
-    name: parsed.name,
-    description:
-      "把 Marxists.org 中文旧式书籍页面转换为可离线打开的单文件 HTML，保留原 CSS、表格排版和背景纹理。",
-    prompt:
-      "你是离线书籍转换助手。用户给出 Marxists.org 中文书籍页面或要求保存离线书籍时，只能调用 convertMarxistsBookToOfflineHtml，不要使用普通网页抓取流程。最终回答必须逐字给出 rawData.fileUrl、rawData.pageCount、rawData.hasNetworkUrls、rawData.byteLength。",
-    isPublic: parsed.publicAgent,
-    model: source.model ?? "mimo-v2.5-pro",
-    provider: source.provider ?? "custom",
-    apiSource: source.apiSource ?? "custom",
-    apiKey: source.apiKey,
-    customProviderUrl: source.customProviderUrl,
-    apiKeyHeader: source.apiKeyHeader ?? "api-key",
-    tools: AGENT_TOOLS,
-    temperature: source.temperature ?? 0.2,
-    maxTokens: source.maxTokens ?? 4096,
-    category: "document-tools",
-    tags: ["offline-book", "marxists", "mimo"],
-    userId: parsed.userId,
-    createdAt: source.createdAt ?? now,
-    updatedAt: now,
-  };
-}
-
-async function attachAgentToSpace(args: {
-  fetchImpl: typeof fetch;
-  parsed: ParsedArgs;
-  contentKey: string;
-  title: string;
-  now: number;
-}) {
-  const spaceKey = `space-${args.parsed.spaceId}`;
-  const space = await readDbRecord({
-    fetchImpl: args.fetchImpl,
-    serverUrl: args.parsed.serverUrl,
-    authToken: args.parsed.authToken,
-    dbKey: spaceKey,
-  });
-  await writeDbRecord({
-    fetchImpl: args.fetchImpl,
-    serverUrl: args.parsed.serverUrl,
-    authToken: args.parsed.authToken,
-    userId: args.parsed.userId,
-    dbKey: spaceKey,
-    data: {
-      ...space,
-      contents: {
-        ...(space.contents ?? {}),
-        [args.contentKey]: {
-          ...(space.contents?.[args.contentKey] ?? {}),
-          title: args.title,
-          type: "agent",
-          contentKey: args.contentKey,
-          createdAt: space.contents?.[args.contentKey]?.createdAt ?? args.now,
-          updatedAt: args.now,
-        },
-      },
-      updatedAt: args.now,
-    },
-  });
-}
-
-function writeUsage(output: OutputLike) {
-  output.write(
-    "Usage: nolo agent setup-offline-marxists [--server https://nolo.chat] [--source-agent <key>] [--space <spaceId>] [--target-agent-id <id>] [--json]\n" +
-      "Requires AUTH_TOKEN from `nolo login` or --token.\n"
-  );
-}
-
-export async function runSetupOfflineMarxistsAgentCommand(
-  args: string[],
-  deps: SetupOfflineMarxistsAgentDeps = {}
-) {
-  const env = deps.env ?? process.env;
-  const output = deps.output ?? process.stdout;
-  const parsed = parseArgs(args, env);
-  if (!parsed) {
-    writeUsage(output);
-    return 1;
-  }
-  const fetchImpl = deps.fetchImpl ?? fetch;
-  const now = deps.now?.() ?? Date.now();
-
-  try {
-    const source = await readDbRecord({
-      fetchImpl,
-      serverUrl: parsed.serverUrl,
-      authToken: parsed.authToken,
-      dbKey: parsed.sourceAgentKey,
-    });
-    const target = buildTargetAgent({ parsed, source, now });
-    await writeDbRecord({
-      fetchImpl,
-      serverUrl: parsed.serverUrl,
-      authToken: parsed.authToken,
-      userId: parsed.userId,
-      dbKey: parsed.targetAgentKey,
-      data: target,
-    });
-    const publicKey = `agent-pub-${parsed.targetAgentId}`;
-    if (parsed.publicAgent) {
-      await writeDbRecord({
-        fetchImpl,
-        serverUrl: parsed.serverUrl,
-        authToken: parsed.authToken,
-        userId: parsed.userId,
-        dbKey: publicKey,
-        data: target,
-      });
-    }
-    await attachAgentToSpace({
-      fetchImpl,
-      parsed,
-      contentKey: parsed.publicAgent ? publicKey : parsed.targetAgentKey,
-      title: parsed.name,
-      now,
-    });
-
-    const result = {
-      serverUrl: parsed.serverUrl,
-      sourceAgentKey: parsed.sourceAgentKey,
-      agentKey: parsed.targetAgentKey,
-      agentUrl: `${parsed.serverUrl}/${parsed.targetAgentKey}`,
-      publicKey: parsed.publicAgent ? publicKey : null,
-      spaceId: parsed.spaceId,
-      model: target.model,
-      provider: target.provider,
-      customProviderUrl: target.customProviderUrl,
-      tools: target.tools,
-    };
-    if (parsed.json) {
-      output.write(`${JSON.stringify(result, null, 2)}\n`);
-    } else {
-      output.write(
-        [
-          `created/updated: ${result.agentKey}`,
-          `url: ${result.agentUrl}`,
-          `space: ${result.spaceId}`,
-          `model: ${result.model}`,
-          `tools: ${result.tools.join(", ")}`,
-          "",
-        ].join("\n")
-      );
-    }
-    return 0;
-  } catch (error) {
-    output.write(
-      `setup-offline-marxists failed: ${error instanceof Error ? error.message : String(error)}\n`
-    );
-    return 1;
-  }
-}

package/qoderUsageProbe.ts

@@ -1,252 +0,0 @@
-import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-
-export type QoderQuotaUsage = {
-  userId: string | null;
-  userType: string | null;
-  expiresAt: string | null;
-  expiresAtMs: number | null;
-  isQuotaExceeded: boolean | null;
-  totalUsagePercentage: number | null;
-  quota: {
-    total: number | null;
-    used: number | null;
-    remaining: number | null;
-    percentage: number | null;
-    unit: string | null;
-  };
-  source: "qoder-cli-log";
-  logPath?: string;
-  capturedAt?: string;
-  capturedAtMs?: number | null;
-};
-
-export type QoderUsageFreshness = "fresh" | "stale" | "uncertain";
-
-export type QoderUsageProbeResult = {
-  ok: boolean;
-  provider: "qoder";
-  usage?: (QoderQuotaUsage & { logPath: string });
-  limitations?: string[];
-  freshness?: QoderUsageFreshness;
-  ageSeconds?: number | null;
-  staleThresholdSeconds?: number;
-  scannedLogCount?: number;
-  reason?: string;
-  error?: string;
-};
-
-const QUOTA_RESPONSE_MARKER = "/api/v2/quota/usage response:";
-
-const asFiniteNumber = (value: unknown): number | null =>
-  typeof value === "number" && Number.isFinite(value) ? value : null;
-
-const asString = (value: unknown): string | null =>
-  typeof value === "string" && value.trim() ? value.trim() : null;
-
-const asBoolean = (value: unknown): boolean | null =>
-  typeof value === "boolean" ? value : null;
-
-function normalizeQuotaPayload(payload: any): QoderQuotaUsage | null {
-  if (!payload || typeof payload !== "object") return null;
-  const quota = payload.userQuota && typeof payload.userQuota === "object"
-    ? payload.userQuota
-    : {};
-  const expiresAtMs = asFiniteNumber(payload.expiresAt);
-  return {
-    userId: asString(payload.userId),
-    userType: asString(payload.userType),
-    expiresAt: expiresAtMs != null ? new Date(expiresAtMs).toISOString() : null,
-    expiresAtMs,
-    isQuotaExceeded: asBoolean(payload.isQuotaExceeded),
-    totalUsagePercentage: asFiniteNumber(payload.totalUsagePercentage),
-    quota: {
-      total: asFiniteNumber(quota.total),
-      used: asFiniteNumber(quota.used),
-      remaining: asFiniteNumber(quota.remaining),
-      percentage: asFiniteNumber(quota.percentage),
-      unit: asString(quota.unit),
-    },
-    source: "qoder-cli-log",
-  };
-}
-
-function isRealQuotaResponseLine(line: string): boolean {
-  const markerIndex = line.indexOf(QUOTA_RESPONSE_MARKER);
-  if (markerIndex < 0) return false;
-  const before = line.slice(0, markerIndex);
-  if (!before.includes("[qoderApi]")) return false;
-  const jsonStart = markerIndex + QUOTA_RESPONSE_MARKER.length;
-  const after = line.slice(jsonStart).trimStart();
-  return after.startsWith("{");
-}
-
-export function parseQoderQuotaUsageFromText(text: string): QoderQuotaUsage | null {
-  let latest: QoderQuotaUsage | null = null;
-  for (const line of text.split(/\r?\n/)) {
-    if (!isRealQuotaResponseLine(line)) continue;
-    const markerIndex = line.indexOf(QUOTA_RESPONSE_MARKER);
-    const jsonText = line.slice(markerIndex + QUOTA_RESPONSE_MARKER.length).trim();
-    try {
-      const parsed = normalizeQuotaPayload(JSON.parse(jsonText));
-      if (parsed) latest = parsed;
-    } catch {
-      // Ignore malformed historical log lines.
-    }
-  }
-  return latest;
-}
-
-export function extractLeadingIsoTimestamp(dirName: string): string | null {
-  const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2})-(\d{2})-(\d{2})(?:-(\d{3}))?([+-])(\d{2})-(\d{2})/.exec(dirName);
-  if (!match) return null;
-  const [, Y, M, D, h, m, s, ms, sign, offH, offM] = match;
-  const local = Date.UTC(Number(Y), Number(M) - 1, Number(D), Number(h), Number(m), Number(s), Number(ms ?? 0));
-  const offsetMs = (Number(offH) * 60 + Number(offM)) * 60_000;
-  const utcMs = sign === "+" ? local - offsetMs : local + offsetMs;
-  if (!Number.isFinite(utcMs)) return null;
-  return new Date(utcMs).toISOString();
-}
-
-type RunLogEntry = {
-  logPath: string;
-  capturedAtMs: number | null;
-  capturedAt: string | null;
-  dirName: string;
-};
-
-function listQoderRunLogs(qoderHome: string): RunLogEntry[] {
-  const runsDir = join(qoderHome, "logs", "runs");
-  if (!existsSync(runsDir)) return [];
-  const entries: RunLogEntry[] = [];
-  for (const entry of readdirSync(runsDir, { withFileTypes: true })) {
-    if (!entry.isDirectory()) continue;
-    const logPath = join(runsDir, entry.name, "qodercli.log");
-    if (!existsSync(logPath)) continue;
-    const capturedAt = extractLeadingIsoTimestamp(entry.name);
-    const capturedAtMs = capturedAt ? Date.parse(capturedAt) : null;
-    entries.push({
-      logPath,
-      capturedAtMs,
-      capturedAt,
-      dirName: entry.name,
-    });
-  }
-  entries.sort((a, b) => {
-    const aMs = a.capturedAtMs ?? statSync(a.logPath).mtimeMs;
-    const bMs = b.capturedAtMs ?? statSync(b.logPath).mtimeMs;
-    return bMs - aMs;
-  });
-  return entries;
-}
-
-export function findLatestQoderQuotaUsage(options: {
-  qoderHome?: string;
-  now?: number;
-} = {}): (QoderQuotaUsage & { logPath: string; capturedAtMs: number | null; capturedAt: string | null }) | null {
-  const qoderHome = options.qoderHome || join(homedir(), ".qoder");
-  for (const run of listQoderRunLogs(qoderHome)) {
-    const parsed = parseQoderQuotaUsageFromText(readFileSync(run.logPath, "utf8"));
-    if (!parsed) continue;
-    return {
-      ...parsed,
-      logPath: run.logPath,
-      capturedAt: run.capturedAt,
-      capturedAtMs: run.capturedAtMs,
-    };
-  }
-  return null;
-}
-
-const DEFAULT_STALE_THRESHOLD_SECONDS = 6 * 60 * 60;
-
-export function classifyQoderUsageFreshness(
-  usage: { capturedAtMs: number | null } | null,
-  options: { now?: number; staleThresholdSeconds?: number } = {},
-): QoderUsageFreshness {
-  if (!usage || usage.capturedAtMs == null) return "uncertain";
-  const now = options.now ?? Date.now();
-  const threshold = (options.staleThresholdSeconds ?? DEFAULT_STALE_THRESHOLD_SECONDS) * 1000;
-  const age = now - usage.capturedAtMs;
-  if (!Number.isFinite(age) || age < 0) return "uncertain";
-  return age > threshold ? "stale" : "fresh";
-}
-
-function readOption(args: string[], flag: string) {
-  const index = args.indexOf(flag);
-  return index >= 0 ? args[index + 1] : undefined;
-}
-
-export async function runQoderUsageCommand(
-  args: string[],
-  deps: {
-    env?: Record<string, string | undefined>;
-    output?: { write(chunk: string): unknown };
-    now?: () => number;
-  } = {},
-) {
-  const output = deps.output ?? process.stdout;
-  const agent = args[0]?.trim();
-  if (!agent || agent === "--help" || agent === "-h") {
-    output.write("Usage: nolo agent usage qoder [--qoder-home <path>] [--stale-threshold-seconds <n>]\n");
-    return agent ? 0 : 1;
-  }
-  if (agent.toLowerCase() !== "qoder") {
-    output.write(`[nolo] agent usage currently supports qoder only, received ${agent}.\n`);
-    return 1;
-  }
-  const qoderHome =
-    readOption(args, "--qoder-home") ||
-    deps.env?.QODER_HOME ||
-    join(homedir(), ".qoder");
-  const now = deps.now ? deps.now() : Date.now();
-  const thresholdArg = readOption(args, "--stale-threshold-seconds");
-  const staleThresholdSeconds = thresholdArg ? Number(thresholdArg) : DEFAULT_STALE_THRESHOLD_SECONDS;
-  const usage = findLatestQoderQuotaUsage({ qoderHome, now });
-  const freshness = classifyQoderUsageFreshness(usage, { now, staleThresholdSeconds });
-  const ageSeconds = usage?.capturedAtMs != null ? Math.max(0, Math.floor((now - usage.capturedAtMs) / 1000)) : null;
-
-  if (!usage) {
-    const result: QoderUsageProbeResult = {
-      ok: false,
-      provider: "qoder",
-      freshness,
-      ageSeconds,
-      staleThresholdSeconds,
-      limitations: [
-        "This probe only reads Qoder package Credits from local quota logs.",
-        "It does not currently read the Qwen3.7-Max daily free request quota; check Qoder's Usage Overview or CLI /usage for that counter.",
-      ],
-      error:
-        "No Qoder quota usage log found. Open `qoder`, run `/usage`, then retry this command.",
-      reason:
-        "Probe could not locate any real [qoderApi] quota response line in local run logs.",
-    };
-    output.write(JSON.stringify(result, null, 2));
-    output.write("\n");
-    return 1;
-  }
-
-  const result: QoderUsageProbeResult = {
-    ok: true,
-    provider: "qoder",
-    usage,
-    limitations: [
-      "This is package Credits usage only, parsed from Qoder's /api/v2/quota/usage log.",
-      "Qwen3.7-Max daily free requests are a separate counter and are not exposed in this probe's current log source.",
-    ],
-    freshness,
-    ageSeconds,
-    staleThresholdSeconds,
-  };
-  if (freshness !== "fresh") {
-    result.reason =
-      freshness === "stale"
-        ? `Latest local quota log is ${ageSeconds}s old (threshold ${staleThresholdSeconds}s); UI or server may show a different value.`
-        : "Latest local quota log has no reliable capture timestamp; treat numbers as uncertain.";
-  }
-  output.write(JSON.stringify(result, null, 2));
-  output.write("\n");
-  return freshness === "fresh" ? 0 : 2;
-}