nolo-cli 0.1.41 → 0.1.43

package/qoderUsageProbe.ts

@@ -0,0 +1,252 @@
+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;
+}

package/render/contentIcon/types.ts

@@ -0,0 +1,167 @@
+export type ContentIcon =
+  | { kind: "emoji"; value: string }
+  | {
+      kind: "lucide";
+      value:
+        | "file-text"
+        | "table"
+        | "layout-grid"
+        | "star"
+        | "book"
+        | "image"
+        | "folder"
+        | "folder-kanban"
+        | "kanban"
+        | "layers"
+        | "notebook"
+        | "clipboard-list"
+        | "briefcase"
+        | "calendar"
+        | "clock"
+        | "list-todo"
+        | "chart-bar"
+        | "chart-line"
+        | "database"
+        | "code"
+        | "file-code"
+        | "terminal"
+        | "settings"
+        | "wrench"
+        | "pen-tool"
+        | "palette"
+        | "sparkles"
+        | "brain"
+        | "bot"
+        | "message-square"
+        | "users"
+        | "globe"
+        | "link"
+        | "bookmark"
+        | "heart"
+        | "flag"
+        | "zap"
+        | "lightbulb"
+        | "search"
+        | "map"
+        | "shopping-bag"
+        | "music"
+        | "video"
+        | "blocks"
+        | "flower"
+        | "flower-2"
+        | "leaf"
+        | "sprout"
+        | "tree-pine"
+        | "trees"
+        | "clover"
+        | "vegan"
+        | "bean"
+        | "wheat"
+        | "apple"
+        | "sun"
+        | "cloud-sun"
+        | "cloud-rain"
+        | "droplets"
+        | "mountain"
+        | "earth"
+        | "shell"
+        | "archive"
+        | "award"
+        | "badge-check"
+        | "bell"
+        | "box"
+        | "boxes"
+        | "cake"
+        | "camera"
+        | "circle-dollar-sign"
+        | "circle-help"
+        | "coffee"
+        | "compass"
+        | "cpu"
+        | "crown"
+        | "diamond"
+        | "dumbbell"
+        | "file-archive"
+        | "file-image"
+        | "file-spreadsheet"
+        | "file-type"
+        | "flask-conical"
+        | "gamepad-2"
+        | "gift"
+        | "graduation-cap"
+        | "hammer"
+        | "handshake"
+        | "headphones"
+        | "house"
+        | "key"
+        | "languages"
+        | "laptop"
+        | "library"
+        | "mail"
+        | "megaphone"
+        | "mic"
+        | "monitor"
+        | "moon"
+        | "newspaper"
+        | "package"
+        | "paperclip"
+        | "plane"
+        | "puzzle"
+        | "route"
+        | "shield"
+        | "smile"
+        | "tags"
+        | "target"
+        | "telescope"
+        | "ticket"
+        | "trophy"
+        | "wallet"
+        | "workflow"
+        | "alarm-clock"
+        | "atom"
+        | "banknote"
+        | "battery-charging"
+        | "bluetooth"
+        | "bug"
+        | "car"
+        | "circle-user"
+        | "cloud"
+        | "command"
+        | "construction"
+        | "contact"
+        | "copy"
+        | "download"
+        | "eraser"
+        | "film"
+        | "fingerprint"
+        | "flame"
+        | "gem"
+        | "hard-drive"
+        | "hospital"
+        | "map-pin"
+        | "medal"
+        | "mouse-pointer-2"
+        | "network"
+        | "paintbrush"
+        | "pencil"
+        | "printer"
+        | "qr-code"
+        | "radar"
+        | "receipt"
+        | "recycle"
+        | "scan-line"
+        | "school"
+        | "server"
+        | "ship"
+        | "siren"
+        | "sliders-horizontal"
+        | "smartphone"
+        | "snowflake"
+        | "store"
+        | "sunrise"
+        | "sunset"
+        | "timer"
+        | "truck"
+        | "umbrella"
+        | "wifi";
+    };

package/render/page/docSlice.ts

@@ -14,6 +14,7 @@ import type { EditorContent } from "../../create/editor/utils/slateUtils";
 import { DataType } from "../../create/types";
 import { PageData } from "./types";
 import type { PageSkillMetadata } from "../../ai/skills/skillDocProtocol";
+import type { ContentIcon } from "../contentIcon/types";
 
 // —— State 接口 ——
 export interface DocState {
@@ -22,6 +23,7 @@ export interface DocState {
   title: string | null;
   dbSpaceId: string | null;
   tags: string[] | null;
+  icon: ContentIcon | null;
   isReadOnly: boolean;
   isLoading: boolean;
   isInitialized: boolean;
@@ -32,6 +34,7 @@ export interface DocState {
   lastSavedAt: string | null;
   lastSavedSlateData: EditorContent | null;
   lastSavedTitle: string | null;
+  lastSavedIcon: ContentIcon | null;
   justSaved: boolean;
   tools: string[] | null;
   meta: PageSkillMetadata | null;
@@ -56,6 +59,7 @@ const initialState: DocState = {
   title: null,
   dbSpaceId: null,
   tags: null,
+  icon: null,
   isReadOnly: true,
   isLoading: false,
   isInitialized: false,
@@ -66,6 +70,7 @@ const initialState: DocState = {
   lastSavedAt: null,
   lastSavedSlateData: null,
   lastSavedTitle: null,
+  lastSavedIcon: null,
   justSaved: false,
   tools: null,
   meta: null,
@@ -173,6 +178,8 @@ export const docSlice = createSliceWithThunks({
           state.lastSavedTitle = action.payload.title || null;
           state.dbSpaceId = action.payload.spaceId || null;
           state.tags = action.payload.tags || null;
+          state.icon = action.payload.icon || null;
+          state.lastSavedIcon = action.payload.icon || null;
           state.isReadOnly = action.payload.isReadOnly;
           state.pageKey = action.payload.dbKey;
           state.id = action.payload.id;
@@ -209,11 +216,18 @@ export const docSlice = createSliceWithThunks({
       }
     }),
 
+    updateIcon: create.reducer((state, action: PayloadAction<ContentIcon | null>) => {
+      if (state.isInitialized && !state.isReadOnly) {
+        state.icon = action.payload;
+        state.justSaved = false;
+      }
+    }),
+
     saveDoc: create.asyncThunk(
       async (arg: SaveDocArgs, { dispatch, getState, rejectWithValue }) => {
         const requestedPageKey = arg.pageKey;
         const state = (getState() as any).doc;
-        const { pageKey, slateData, dbSpaceId, meta } = state;
+        const { pageKey, slateData, dbSpaceId, meta, icon } = state;
 
         if (!pageKey || pageKey !== requestedPageKey) {
           return rejectWithValue("内容已切换，取消保存");
@@ -253,6 +267,7 @@ export const docSlice = createSliceWithThunks({
                 title,
                 tools,
                 content,
+                icon: icon ?? null,
                 ...(meta ? { meta } : {}),
               },
             })
@@ -299,6 +314,7 @@ export const docSlice = createSliceWithThunks({
           state.content = action.payload.content;
           state.lastSavedSlateData = action.payload.savedContent;
           state.lastSavedTitle = action.payload.title;
+          state.lastSavedIcon = state.icon;
           state.justSaved = true;
         },
         rejected: (state, action) => {
@@ -345,6 +361,8 @@ export const docSlice = createSliceWithThunks({
       state.type = action.payload.type || DataType.DOC;
       state.lastSavedSlateData = action.payload.slateData;
       state.tags = action.payload.tags || null;
+      state.icon = action.payload.icon || null;
+      state.lastSavedIcon = action.payload.icon || null;
       state.dbSpaceId = action.payload.spaceId;
       state.content = action.payload.content || null;
       state.meta = action.payload.meta || null;
@@ -357,6 +375,7 @@ export const {
   initDoc,
   updateSlate,
   updateTitle,
+  updateIcon,
   saveDoc,
   resetJustSavedStatus,
   setDocFocusContext,
@@ -422,14 +441,17 @@ export const selectHasPendingChanges = createSelector(
     (state: any) => state.doc.lastSavedSlateData,
     selectDocTitle,
     (state: any) => state.doc.lastSavedTitle,
+    (state: any) => state.doc.icon,
+    (state: any) => state.doc.lastSavedIcon,
     selectIsReadOnly,
     selectDocIsInitialized,
   ],
-  (slateData, lastSavedSlateData, title, lastSavedTitle, isReadOnly, isInitialized) => {
+  (slateData, lastSavedSlateData, title, lastSavedTitle, icon, lastSavedIcon, isReadOnly, isInitialized) => {
     if (!isInitialized || isReadOnly) return false;
     return (
       hasSlateContentChanged(slateData, lastSavedSlateData) ||
-      (title || "") !== (lastSavedTitle || "")
+      (title || "") !== (lastSavedTitle || "") ||
+      JSON.stringify(icon ?? null) !== JSON.stringify(lastSavedIcon ?? null)
     );
   }
 );
@@ -454,6 +476,11 @@ export const selectDocTags = createSelector(
   (doc) => doc.tags
 );
 
+export const selectDocIcon = createSelector(
+  [selectDocState],
+  (doc) => doc.icon
+);
+
 export const selectDocFocusContext = createSelector(
   [selectDocState],
   (doc) => doc.focusContext

package/render/page/types.ts

@@ -1,5 +1,6 @@
 import { DataType } from "../../create/types"; // 确认路径
 import type { PageSkillMetadata } from "../../ai/skills/skillDocProtocol";
+import type { ContentIcon } from "../contentIcon/types";
 
 export interface PageData {
   id: string; // 通常与 pageKey 中的 id 部分相同
@@ -10,6 +11,7 @@ export interface PageData {
   slateData?: any | null; // 文档真源
   spaceId: string | null; // 页面所属的 spaceId, null 表示不在任何空间
   tags?: string[]; // 页面的标签
+  icon?: ContentIcon | null;
   created: string; // ISO 格式创建时间
   updated_at?: string; // ISO 格式更新时间 (可选)
   tools?: string[]; // 关联的工具列表

package/render/table/createTableAction.ts

@@ -37,6 +37,7 @@ import type {
 export interface CreateTableArgs {
   spaceId?: string;
   title?: string;
+  purpose?: string;
   description?: string;
   tags?: string[];
   categoryId?: string;
@@ -145,6 +146,7 @@ export const createTableAction = async (
   {
     spaceId: customSpaceId,
     title: customTitle,
+    purpose: customPurpose,
     description: customDescription,
     tags: customTags,
     categoryId,
@@ -177,6 +179,7 @@ export const createTableAction = async (
   });
   const title = customTitle?.trim() || defaultTitle;
 
+  const purpose = customPurpose?.trim() || undefined;
   const description = customDescription?.trim() || undefined;
   const tags =
     Array.isArray(customTags) && customTags.length
@@ -195,6 +198,7 @@ export const createTableAction = async (
     tableId,
     spaceId: spaceId ?? null,
     displayName: title,
+    purpose,
     description,
     tags,
     schemaVersion: 1,

package/render/table/tableSlice.ts

@@ -27,6 +27,7 @@ import type { CreateTableArgs } from "./createTableAction";
 import { createTableAction } from "./createTableAction";
 import { deleteTableAction, type DeleteTableArgs } from "./deleteTableAction";
 import type { TableMeta, TableColumn } from "./types";
+import type { ContentIcon } from "../contentIcon/types";
 
 /* --------------------------------------------------------------------------
  * Slice 状态
@@ -130,6 +131,12 @@ interface RenameTableArgs {
   newName: string; // 新的显示名称 displayName
 }
 
+interface UpdateTableIconArgs {
+  tenantId: string;
+  tableId: string;
+  icon: ContentIcon | null;
+}
+
 interface LoadTableRowsArgs {
   tenantId: string;
   tableId: string;
@@ -979,6 +986,59 @@ export const tableSlice = createSliceWithThunks({
       }
     ),
 
+    updateTableIcon: create.asyncThunk(
+      async (
+        args: UpdateTableIconArgs,
+        { dispatch, getState, rejectWithValue }
+      ) => {
+        const { tenantId, tableId, icon } = args;
+        const state = (getState() as RootState).table;
+        const meta = state.currentTable;
+
+        if (!meta || meta.tenantId !== tenantId || meta.tableId !== tableId) {
+          return rejectWithValue("当前没有加载对应的表定义");
+        }
+
+        const nowIso = formatISO(new Date());
+
+        try {
+          await dispatch(
+            patch({
+              dbKey: meta.dbKey,
+              changes: {
+                icon: icon ?? null,
+                updatedAt: nowIso,
+              },
+            })
+          ).unwrap();
+
+          const nextMeta: TableMeta = {
+            ...meta,
+            icon: icon ?? null,
+            updatedAt: nowIso,
+          };
+
+          return nextMeta;
+        } catch (e: any) {
+          return rejectWithValue(e.message || "更新表格图标失败");
+        }
+      },
+      {
+        pending: (state) => {
+          state.error = null;
+        },
+        fulfilled: (state, action: PayloadAction<TableMeta>) => {
+          state.currentTable = action.payload;
+        },
+        rejected: (state, action) => {
+          state.error =
+            (action.payload as string) ||
+            action.error.message ||
+            "更新表格图标时发生未知错误";
+        },
+      }
+    ),
+
     /* --------------------------------------
      * 4.4 更新单元格：updateCell
      * ------------------------------------*/
@@ -1085,6 +1145,7 @@ export const {
   renameColumn,
   renameColumnLabel,
   renameTable,
+  updateTableIcon,
   resetTable,
   loadTableRows,
   updateCell,