nolo-cli 0.1.41 → 0.1.43

package/docPageHelpers.ts

@@ -0,0 +1,80 @@
+import { readFileSync } from "node:fs";
+import { ulid } from "ulid";
+
+function getCliArg(args: string[], flag: string): string | undefined {
+  const idx = args.indexOf(flag);
+  return idx !== -1 ? args[idx + 1] : undefined;
+}
+
+export function readBodyArg(args: string[], fallback = "") {
+  const bodyFile = getCliArg(args, "--body-file");
+  if (bodyFile !== undefined) {
+    return readFileSync(bodyFile, "utf8");
+  }
+  return getCliArg(args, "--body") ?? fallback;
+}
+
+function textToSlate(text: string) {
+  return text.split("\n").map((line) => ({
+    type: "paragraph",
+    children: [{ text: line }],
+  }));
+}
+
+export function createPageId() {
+  return ulid();
+}
+
+export function buildPageKey(userId: string, pageId: string) {
+  return `page-${userId}-${pageId}`;
+}
+
+export function buildPageRecord(args: {
+  dbKey: string;
+  pageId: string;
+  title: string;
+  spaceId: string | null;
+  content: string;
+  existing?: Record<string, any> | null;
+  meta?: Record<string, any> | null;
+  slateData?: Record<string, any>[] | null;
+}) {
+  const { dbKey, pageId, title, spaceId, content, existing, meta, slateData } = args;
+  const now = Date.now();
+  const createdAt = typeof existing?.createdAt === "number" ? existing.createdAt : now;
+  const created =
+    typeof existing?.created === "string" ? existing.created : new Date(createdAt).toISOString();
+
+  const nextRecord: Record<string, any> = {
+    ...(existing ?? {}),
+    id: existing?.id ?? pageId,
+    dbKey,
+    type: "page",
+    title,
+    spaceId,
+    content,
+    updatedAt: now,
+    createdAt,
+    created,
+  };
+
+  if (meta !== undefined) {
+    if (meta === null) {
+      delete nextRecord.meta;
+    } else {
+      nextRecord.meta = meta;
+    }
+  }
+
+  if (slateData !== undefined) {
+    if (slateData === null) {
+      delete nextRecord.slateData;
+    } else {
+      nextRecord.slateData = slateData;
+    }
+  } else if (!existing?.slateData) {
+    nextRecord.slateData = textToSlate(content);
+  }
+
+  return nextRecord;
+}

package/docSkillHelpers.ts

@@ -0,0 +1,67 @@
+import {
+  buildSkillDocMarkdown,
+  type SkillDocConfig,
+} from "./ai/skills/skillDocProtocol";
+import { buildPageKey, buildPageRecord } from "./docPageHelpers";
+
+function normalizeSkillSeed(input: string) {
+  return input
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9\u4e00-\u9fa5]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+function deterministicId(prefix: string, seed: string): string {
+  let h = 0x811c9dc5;
+  for (let i = 0; i < seed.length; i++) {
+    h ^= seed.charCodeAt(i);
+    h = (h * 0x01000193) >>> 0;
+  }
+  const suffix = h.toString(36).toUpperCase().padStart(14, "0");
+  return (prefix + suffix).slice(0, 26);
+}
+
+export function buildSkillDocId(input: string) {
+  return deterministicId("01SK", normalizeSkillSeed(input) || input);
+}
+
+export function buildSkillPageKey(userId: string, skillId: string) {
+  return buildPageKey(userId, skillId);
+}
+
+export function buildSkillPageRecord(args: {
+  dbKey: string;
+  skillId: string;
+  title: string;
+  spaceId: string | null;
+  body: string;
+  skillConfig: SkillDocConfig;
+  existing?: Record<string, any> | null;
+}) {
+  const { dbKey, skillId, title, spaceId, body, skillConfig, existing } = args;
+  return {
+    ...buildPageRecord({
+      dbKey,
+      pageId: skillId,
+      title,
+      spaceId,
+      content: buildSkillDocMarkdown({
+        body,
+        skillConfig,
+      }),
+      existing,
+      meta: {
+        ...(existing?.meta ?? {}),
+        kind: "skill",
+        skillConfig,
+      },
+      slateData: null,
+    }),
+  };
+}
+
+export function parseJsonArg<T>(raw: string | undefined, fallback: T): T {
+  if (raw === undefined) return fallback;
+  return JSON.parse(raw) as T;
+}

package/docSpaceHelpers.ts

@@ -0,0 +1,46 @@
+import { createSpaceKey } from "./create/space/spaceKeys";
+import { readDbRecord, writeAgentRecord } from "./agentRecordHelpers";
+
+export async function ensurePageAttachedToSpace(params: {
+  baseUrl: string;
+  userId: string;
+  authToken: string;
+  spaceId: string;
+  contentKey: string;
+  title: string;
+  skillSummary?: Record<string, any> | null;
+}) {
+  const { baseUrl, userId, authToken, spaceId, contentKey, title, skillSummary } = params;
+  const spaceKey = createSpaceKey.space(spaceId);
+  const spaceRecord = await readDbRecord({
+    dbKey: spaceKey,
+    authToken,
+    fetchImpl: fetch,
+    serverUrl: baseUrl,
+  });
+  const now = Date.now();
+
+  await writeAgentRecord({
+    agentKey: spaceKey,
+    authToken,
+    fetchImpl: fetch,
+    serverUrl: baseUrl,
+    userId,
+    record: {
+      ...spaceRecord,
+      contents: {
+        ...(spaceRecord.contents ?? {}),
+        [contentKey]: {
+          ...(spaceRecord.contents?.[contentKey] ?? {}),
+          title,
+          type: "page",
+          contentKey,
+          ...(skillSummary !== undefined ? { skillSummary } : {}),
+          updatedAt: now,
+          createdAt: spaceRecord.contents?.[contentKey]?.createdAt ?? now,
+        },
+      },
+      updatedAt: now,
+    },
+  });
+}

package/integrations/google/models.ts

@@ -67,14 +67,14 @@ const createGoogleImageModel = ({
 export const googleModels: Model[] = [
   {
     name: DEFAULT_GOOGLE_LIVE_AUDIO_MODEL,
-    displayName: "Gemini 2.5 Flash Native Audio Preview",
+    displayName: "Gemini 3.1 Flash Live",
     provider: "google",
     description:
-      "Native audio Live API model for low-latency real-time voice conversations.",
+      "Gemini Live API model for low-latency real-time voice conversations.",
     hasVision: true,
     hasAudio: true,
-    contextWindow: 128000,
-    maxOutputTokens: 8192,
+    contextWindow: 1048576,
+    maxOutputTokens: 65500,
     supportsTool: true,
     price: {
       input: 0.5 * 7,

package/integrations/openai/generateOpenAIRequestBody.ts

@@ -102,9 +102,6 @@ const shouldDisableKimiThinking = (
   if (agentConfig.enableThinking !== false) return false;
   if (providerName === "deepinfra") return isDeepInfraKimiModel(resolvedModel);
   if (providerName === "fireworks") return isFireworksKimiModel(resolvedModel);
-  if (providerName === "openrouter") {
-    return resolvedModel.toLowerCase() === "moonshotai/kimi-k2.6";
-  }
   return false;
 };
 

package/integrations/xhs-reader/types.ts

@@ -17,6 +17,7 @@ export type XhsReadFailure = {
   ok: false;
   code: XhsFailureCode;
   message: string;
+  diagnostic?: XhsCollectorDiagnostic;
   fetchedAt: string;
 };
 
@@ -41,6 +42,8 @@ export type XhsCollectorDiagnostic = {
   finalUrl?: string;
   /** Whether a login wall / prompt was detected on the page. */
   loginDetected?: boolean;
+  /** Whether a visible login prompt close button was clicked before declaring the page blocked. */
+  loginPromptDismissed?: boolean;
   /** Whether a captcha / verification wall was detected. */
   captchaDetected?: boolean;
   /** Whether __INITIAL_STATE__ was present and non-empty. */
@@ -53,6 +56,12 @@ export type XhsCollectorDiagnostic = {
   firstApiResponseStatus?: number;
   /** Whether the page URL after navigation looks like a redirect to login. */
   redirectedToLogin?: boolean;
+  /** Length of visible body text sampled for diagnostics. */
+  bodyTextLength?: number;
+  /** Number of visible login close/dismiss candidates found on the page. */
+  visibleCloseCandidateCount?: number;
+  /** Number of visible XHS note links found on the page. */
+  visibleNoteLinkCount?: number;
 };
 
 // --- Profile ---
@@ -80,6 +89,7 @@ export type XhsNoteSummary = {
   likedCount?: number;
   // kept from initial state / user_posted page
   xsecToken?: string; // internal use only - must not appear in public exports
+  xsecSource?: string; // internal navigation hint only - must not appear in public exports
 };
 
 // --- Note Detail ---
@@ -154,10 +164,19 @@ export type XhsProfileAnalysis = {
 // --- Collection Status (assisted mode) ---
 
 export type XhsCollectionMode = "conservative" | "assisted";
-export type XhsAssistedAction = "snapshot" | "read_more_notes" | "read_comments";
+export type XhsAssistedAction =
+  | "snapshot"
+  | "read_more_notes"
+  | "read_visible_details"
+  | "discover_indexed_notes";
 
 export type XhsNextSuggestedAction = {
-  action: "read_more_notes" | "read_comments" | "save_to_table" | "manual_login";
+  action:
+    | "read_more_notes"
+    | "read_visible_details"
+    | "discover_indexed_notes"
+    | "save_to_table"
+    | "stop_anonymous_unavailable";
   label: string;
   reason: string;
 };
@@ -184,6 +203,12 @@ export type XhsProfileCollection = {
   noteDetails: XhsNoteDetail[];
   commentsByNote: Record<string, XhsComment[]>;
   analysis: XhsProfileAnalysis;
+  indexedDiscovery?: {
+    source: "external_index";
+    requestedNoteUrls: string[];
+    acceptedNoteUrls: string[];
+    verifiedNoteUrls: string[];
+  };
   /** Present only when the collector detected an issue. Never contains secrets. */
   diagnostic?: XhsCollectorDiagnostic;
   /** Collection status for assisted automation mode. */
@@ -195,12 +220,16 @@ export type XhsProfileCollection = {
 export type XhsParsedProfileUrl = {
   userId: string;
   canonicalUrl: string;
+  navigationUrl: string;
+  xsecToken?: string; // preserved internally only
+  xsecSource?: string; // preserved internally only
 };
 
 export type XhsParsedNoteUrl = {
   noteId: string;
   canonicalUrl: string;
   xsecToken?: string; // preserved internally only
+  xsecSource?: string; // preserved internally only
 };
 
 // --- Redaction ---
@@ -211,7 +240,7 @@ export type XhsConnectorOptions = {
   enrichDetails?: boolean; // default false
   includeComments?: boolean; // default false
   maxCommentPagesPerNote?: number; // default 1
-  headless?: boolean; // default true
+  headless?: boolean; // default false
   cookieDir?: string;
   fetchImpl?: typeof fetch;
   /** Assisted mode: "conservative" (default) or "assisted" */
@@ -220,17 +249,21 @@ export type XhsConnectorOptions = {
   assistedAction?: XhsAssistedAction;
   /** Max assisted steps (1..3), bounds scroll/comment pages */
   maxAssistedSteps?: number;
+  /** Public note URLs discovered from an external search index. */
+  indexedNoteUrls?: string[];
 };
 
 // Helper to create failure
 export function createXhsFailure(args: {
   code: XhsFailureCode;
   message: string;
+  diagnostic?: XhsCollectorDiagnostic;
 }): XhsReadFailure {
   return {
     ok: false,
     code: args.code,
     message: args.message,
+    ...(args.diagnostic ? { diagnostic: args.diagnostic } : {}),
     fetchedAt: new Date().toISOString(),
   };
 }

package/integrations/xhs-reader/url.ts

@@ -9,6 +9,7 @@ const NOTE_RE =
 /**
  * Parse a XHS profile URL and return userId + canonical URL.
  * Accepts full URLs and path-only forms.
+ * The xsecToken query param is preserved in the result for internal navigation only.
  */
 export function parseXhsProfileUrl(input: string): XhsParsedProfileUrl {
   const match = input.match(PROFILE_RE);
@@ -16,9 +17,28 @@ export function parseXhsProfileUrl(input: string): XhsParsedProfileUrl {
     throw new Error(`Invalid XHS profile URL: ${input}`);
   }
   const userId = match[1];
+  const canonicalUrl = `https://www.xiaohongshu.com/user/profile/${userId}`;
+
+  let xsecToken: string | undefined;
+  let xsecSource: string | undefined;
+  try {
+    const urlObj = new URL(input.startsWith("http") ? input : `https://www.xiaohongshu.com${input}`);
+    xsecToken = urlObj.searchParams.get("xsec_token") ?? undefined;
+    xsecSource = urlObj.searchParams.get("xsec_source") ?? undefined;
+  } catch {
+    // The regex validation above already accepted path-like input; keep canonical navigation.
+  }
+
+  const navigationUrl = new URL(canonicalUrl);
+  if (xsecToken) navigationUrl.searchParams.set("xsec_token", xsecToken);
+  if (xsecSource) navigationUrl.searchParams.set("xsec_source", xsecSource);
+
   return {
     userId,
-    canonicalUrl: `https://www.xiaohongshu.com/user/profile/${userId}`,
+    canonicalUrl,
+    navigationUrl: navigationUrl.toString(),
+    xsecToken,
+    xsecSource,
   };
 }
 
@@ -35,9 +55,11 @@ export function parseXhsNoteUrl(input: string): XhsParsedNoteUrl {
 
   // Extract xsec_token if present (internal use only)
   let xsecToken: string | undefined;
+  let xsecSource: string | undefined;
   try {
     const urlObj = new URL(input.startsWith("http") ? input : `https://www.xiaohongshu.com${input}`);
     xsecToken = urlObj.searchParams.get("xsec_token") ?? undefined;
+    xsecSource = urlObj.searchParams.get("xsec_source") ?? undefined;
   } catch {
     // ignore parse errors
   }
@@ -46,6 +68,7 @@ export function parseXhsNoteUrl(input: string): XhsParsedNoteUrl {
     noteId,
     canonicalUrl: `https://www.xiaohongshu.com/explore/${noteId}`,
     xsecToken,
+    xsecSource,
   };
 }
 

package/internalCommandEntries.ts

@@ -1,6 +1,8 @@
 import { getAgentInternalCommandEntries } from "./agentInternalCommandEntries";
 import { getDialogInternalCommandEntries } from "./dialogInternalCommandEntries";
+import { getDocInternalCommandEntries } from "./docInternalCommandEntries";
 import type { CommandEntry } from "./cliCommandTypes";
+import { getMemoryInternalCommandEntries } from "./memoryInternalCommandEntries";
 import { getSystemInternalCommandEntries } from "./systemInternalCommandEntries";
 import { getWorkflowInternalCommandEntries } from "./workflowInternalCommandEntries";
 
@@ -8,6 +10,8 @@ export function getInternalCommandEntries(renderHelpText: () => string): Command
   return [
     ...getAgentInternalCommandEntries(),
     ...getDialogInternalCommandEntries(),
+    ...getDocInternalCommandEntries(),
+    ...getMemoryInternalCommandEntries(),
     ...getWorkflowInternalCommandEntries(),
     ...getSystemInternalCommandEntries(renderHelpText),
   ];

package/machineCommands.ts

@@ -132,50 +132,34 @@ function detectLaunchableMachineInfo() {
   return detectMachineInfo({ probeLaunchable: true });
 }
 
-function inferTaskRunRole(agentKey: string, agentConfig: any) {
-  const haystack = [
-    agentKey,
-    agentConfig?.name,
-    agentConfig?.prompt,
-  ].filter(Boolean).join("\n").toLowerCase();
-  if (haystack.includes("frontend") || haystack.includes("前端")) return "frontend";
-  if (haystack.includes("fullstack") || haystack.includes("全栈")) return "fullstack";
-  if (haystack.includes("review") || haystack.includes("审查")) return "reviewer";
-  if (haystack.includes("project-manager") || haystack.includes("项目经理")) return "pm";
-  return "codex";
+function findTaskRowSubjectRef(runtimeContext: any) {
+  const subjectRefs = Array.isArray(runtimeContext?.subjectRefs) ? runtimeContext.subjectRefs : [];
+  for (const ref of subjectRefs) {
+    if (!ref || typeof ref !== "object" || Array.isArray(ref)) continue;
+    if (ref.kind !== "table-row") continue;
+    const id = typeof ref.id === "string" ? ref.id.trim() : "";
+    if (id) return id;
+  }
+  return "";
 }
 
-function buildTaskRunBridgePrompt(args: {
+function buildTaskEvidencePrompt(args: {
   agentKey: string;
   agentConfig: any;
   runtimeContext: any;
 }) {
-  const taskRun = args.runtimeContext?.taskRun;
-  const rowDbKey = typeof taskRun?.rowDbKey === "string" ? taskRun.rowDbKey.trim() : "";
+  const rowDbKey = findTaskRowSubjectRef(args.runtimeContext);
   if (!rowDbKey) return "";
-  const workItemId = typeof taskRun?.workItemId === "string" ? taskRun.workItemId.trim() : "";
-  const role = inferTaskRunRole(args.agentKey, args.agentConfig);
   return [
-    "--- Nolo task-run tool bridge ---",
+    "--- Nolo task evidence context ---",
     "This CLI runtime does not receive server-side function tools directly.",
-    "Use the local task-run bridge command for durable task state writes. Do not edit meta.taskRun with table or database commands.",
+    "Use the task row subjectRef and linked dialog/activity evidence as the durable task context.",
     "Run commands from the repository root. The runner already provides server URL and auth in the environment.",
     "Release boundary: after review passes, AI/reviewer/Codex may advance alpha for verification. Do not merge, push, or release main/release unless the human owner explicitly authorizes it in the current task context.",
-    "Cost boundary: read taskRun.control from context. Prefer low-cost/free-window models for routine work, and reserve Codex for supervision, quality gates, complex unblocking, and main/release decisions.",
-    "Handoff context: start from read-context, then inspect existing refs such as workItems.dialogIds, workItems.outcome, review.dialogId, activityRefs, agentRuns.dialogId/resultSummary, and artifactRefs. Use dialog read/search for exact evidence; do not infer completion from handoff text alone.",
-    `Read context: bun packages/cli/index.ts task-run read-context --row-dbkey ${JSON.stringify(rowDbKey)}`,
-    ...(workItemId
-      ? [
-          `Claim work item: bun packages/cli/index.ts task-run claim-work-item --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --agent-key ${JSON.stringify(args.agentKey)} --role ${role}`,
-          `Set blocker: bun packages/cli/index.ts task-run set-blocker --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --layer tool --code <CODE> --message <MESSAGE>`,
-          `Clear resolved blocker: bun packages/cli/index.ts task-run clear-blocker --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --blocker-id <BLOCKER_ID>`,
-          `Submit outcome: bun packages/cli/index.ts task-run submit-outcome --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --summary <SUMMARY>`,
-          `Request review: bun packages/cli/index.ts task-run request-review --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --reviewer-agent-key <AGENT_KEY> --message <MESSAGE>`,
-          `Record review: bun packages/cli/index.ts task-run record-review --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --review-status <passed|needs_changes|blocked> --reviewer-agent-key ${JSON.stringify(args.agentKey)} --findings <FINDINGS>`,
-          `Close work item: bun packages/cli/index.ts task-run close-work-item --row-dbkey ${JSON.stringify(rowDbKey)} --work-item-id ${JSON.stringify(workItemId)} --summary <SUMMARY>`,
-        ]
-      : []),
-    "If a bridge command fails, report the exact command and error.",
+    "Handoff context: inspect activityRefs/latestActivityRef, dialog checkpoints, artifacts, commits, and test evidence. Use dialog read/search for exact evidence; do not infer completion from handoff text alone.",
+    `Read task row: bun packages/cli/index.ts table query --table meta-0e95801d90-NOLOTASKBOARD --row ${JSON.stringify(rowDbKey)} --include-activity --output json`,
+    "Then read linked activity dialog ids with: bun packages/cli/index.ts dialog read <dialogId>",
+    "Report progress, blockers, worktree, branch, commit/diff, tests, and unverified items in the dialog.",
   ].join("\n");
 }
 
@@ -186,7 +170,7 @@ function buildConnectorCliPrompt(agentConfig: any, userInput: string, bridgeArgs
   const policy = permissionPolicy ?? resolveMachineRunPermissionPolicy(agentConfig);
   return [
     typeof agentConfig?.prompt === "string" ? agentConfig.prompt.trim() : "",
-    bridgeArgs ? buildTaskRunBridgePrompt({
+    bridgeArgs ? buildTaskEvidencePrompt({
       agentKey: bridgeArgs.agentKey,
       agentConfig,
       runtimeContext: bridgeArgs.runtimeContext,