nolo-cli 0.1.26 → 0.1.29

package/app/types/appSummary.ts

@@ -0,0 +1,114 @@
+import { deriveAppIdFromRouteKey, isAppRouteKey, resolveAppRouteKey } from "../utils/appKeys";
+
+export type AppVisibility = "private" | "unlisted" | "public";
+export type AppDeployMode = "platform";
+
+export interface CustomDomain {
+  hostname: string;
+  url: string;
+  mode: "platform_a" | string;
+  pendingDns?: boolean;
+  dnsRecordType?: "A" | string;
+  aRecords?: string[];
+  verifiedAt?: string;
+}
+
+export interface AppSummary {
+  name: string;
+  url: string | null;
+  appId?: string;
+  appKey?: string;
+  serverOrigin?: string;
+  spaceId?: string | null;
+  customUrl?: string;
+  modifiedOn?: string;
+  visibility?: AppVisibility;
+  deployMode?: AppDeployMode;
+}
+
+export interface AppSummaryRecord {
+  appId?: string;
+  appKey?: string;
+  dbKey?: string;
+  userId?: string;
+  name?: string;
+  customUrl?: string | null;
+  visibility?: AppVisibility;
+  deployMode?: AppDeployMode;
+  spaceId?: string | null;
+  updatedAt?: string | number;
+  createdAt?: string | number;
+  serverOrigin?: string;
+}
+
+const toTimestamp = (value: unknown): number => {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string") {
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+  }
+  return 0;
+};
+
+const toIsoString = (value: unknown): string | undefined => {
+  const timestamp = toTimestamp(value);
+  return timestamp > 0 ? new Date(timestamp).toISOString() : undefined;
+};
+
+const buildAppUrl = (serverOrigin: string | undefined, appId?: string): string | null => {
+  if (!serverOrigin || !appId) return null;
+  return `${serverOrigin.replace(/\/+$/, "")}/apps/${appId}/`;
+};
+
+export function toAppSummary(
+  record: Partial<AppSummaryRecord> | null | undefined,
+  fallbackServerOrigin: string
+): AppSummary | null {
+  if (!record || typeof record !== "object") return null;
+
+  const recordDbKey =
+    typeof record.dbKey === "string" && record.dbKey.trim().length > 0
+      ? record.dbKey
+      : undefined;
+  const explicitAppId =
+    typeof record.appId === "string" && record.appId.trim().length > 0
+      ? record.appId
+      : undefined;
+  const appKey = resolveAppRouteKey(
+    typeof record.appKey === "string"
+      ? record.appKey
+      : isAppRouteKey(recordDbKey)
+        ? recordDbKey
+        : undefined,
+    explicitAppId
+  );
+  if (!appKey) return null;
+  const appId = explicitAppId ?? deriveAppIdFromRouteKey(appKey, record.userId);
+
+  const name =
+    typeof record.name === "string" && record.name.trim().length > 0
+      ? record.name
+      : appId ?? appKey;
+
+  return {
+    name,
+    url: buildAppUrl(record.serverOrigin ?? fallbackServerOrigin, appId),
+    appId,
+    appKey,
+    serverOrigin:
+      typeof record.serverOrigin === "string" && record.serverOrigin.trim().length > 0
+        ? record.serverOrigin
+        : fallbackServerOrigin,
+    spaceId:
+      typeof record.spaceId === "string" && record.spaceId.trim().length > 0
+        ? record.spaceId
+        : null,
+    customUrl:
+      typeof record.customUrl === "string" && record.customUrl.trim().length > 0
+        ? record.customUrl
+        : undefined,
+    modifiedOn: toIsoString(record.updatedAt ?? record.createdAt),
+    visibility: record.visibility ?? "private",
+    deployMode: record.deployMode ?? "platform",
+  };
+}

package/app/types.ts

@@ -0,0 +1,358 @@
+// packages/app/types.ts
+import type { UiOption, OpenAIImageContent } from "../chat/messages/types";
+import { DataType } from "../create/types";
+import type {
+  AgentBasePolicy,
+  DialogPolicyState,
+} from "../ai/policy/types";
+
+export type ULID = string;
+
+export type DialogRuntimeController =
+  | "request"
+  | "scheduler"
+  | "server-supervisor"
+  | "external-supervisor";
+
+export type DialogRuntimeProfile = "autonomous";
+
+export interface DialogRuntimeBinding {
+  version: 1;
+  /** 当前 product runtime 的 tenant 边界；本地模型 watchdog 不属于这里。 */
+  tenantUserId?: string | null;
+  agentKey: string;
+  /** 当前长期 runtime 的 durable anchor；现阶段直接复用 dialog。 */
+  runtimeAnchorDialogId: string;
+  controller: DialogRuntimeController;
+  triggerType?: "user" | "api" | "localhost" | "scheduled_run";
+  executionMode?: "foreground" | "background";
+  runtimeProfile?: DialogRuntimeProfile;
+  spaceId?: string;
+  category?: string;
+  /** Effective runtime/tool policy snapshot for this dialog run. */
+  runtimeToolPolicySnapshot?: Record<string, unknown>;
+  /** Workspace lease/session used by machine or workspace-backed tools. */
+  workspaceLease?: Record<string, unknown>;
+}
+
+export interface AgentRuntimeBinding {
+  machineId?: string | null;
+  ownerUserId?: string | null;
+  requiredCapabilities?: string[] | null;
+  runtimeToolPolicy?: Record<string, unknown> | null;
+}
+
+export interface DialogGoalState {
+  objective: string;
+  status: "active" | "complete";
+  tokenBudget?: number;
+  createdAt: number;
+  completedAt?: number;
+}
+
+export interface DialogSubjectRef {
+  kind: "table-row" | "page" | "dialog" | "asset" | "external" | string;
+  id: string;
+  role?: "subject" | "parent" | "work-item" | "artifact" | string;
+}
+
+export interface DialogConfig {
+  id: string; // 对话的唯一标识符/路径
+  type: DataType.DIALOG; // 数据类型标记
+  title: string; // 对话标题
+  cybots: string[]; // 兼容字段：当前对话参与的 agent ID 列表
+  primaryAgentKey?: string;
+  taskLabel?: string;
+  tags?: string[];
+  createdAt: string; // 创建时间戳
+  updatedAt: string; // 最后更新时间戳
+  dbKey?: string;
+  spaceId?: string;
+  category?: string;
+
+  // --- 上下文压缩 ---
+  summary?: string; // 对话摘要（单层覆盖式）
+  summarizedBeforeId?: string; // 摘要覆盖到哪条消息 ID
+  proactiveSummary?: string; // 主动工作摘要（不裁剪原始消息，供被动压缩消费）
+  proactiveSummaryBeforeId?: string; // 主动工作摘要覆盖到哪条消息 ID
+  compressionCount?: number; // 压缩次数（用于极端情况提示）
+  referenceKeys?: string[]; // 消息中引用过的 pageKey/dialogKey（替代 historyKeys 扫描）
+  inheritedFromDialogKey?: string; // 若从旧对话开启，记录来源对话 key 以便刷新后仍可提示
+  inheritedFromDialogTitle?: string; // 来源对话标题快照，用于 UI 提示
+  summaryPending?: boolean; // 摘要任务是否挂起（因快速切换等原因）
+  inputTokens?: number;
+  outputTokens?: number;
+  maxTokens?: number; // 此对话最大回复 token 数，覆盖 agent 默认值
+
+  // --- 执行模式（API/后台/定时场景扩展，前台对话不填） ---
+  /** 谁触发的：user=用户前台输入 api=外部API调用 localhost=本机调用 scheduled_run=定时任务运行 */
+  triggerType?: "user" | "api" | "localhost" | "scheduled_run";
+  /** foreground=用户等结果(流式) background=后台静默执行 */
+  executionMode?: "foreground" | "background";
+  /** 仅 background/scheduled 场景有意义 */
+  status?: "pending" | "running" | "done" | "failed" | "cancelled";
+  scheduledAt?: number;    // 定时任务预定执行时间戳
+  startedAt?: number;
+  finishedAt?: number;
+  durationMs?: number;
+  toolCallCount?: number;
+  totalCost?: number;
+  cliSessionId?: string;
+  /** multi-agent: 当前 dialog 由哪个父 dialog 发起 */
+  parentDialogId?: string;
+  /** multi-agent: 这棵 dialog 执行树的根 dialog，便于查询 fanout */
+  rootDialogId?: string;
+  /** 当前 dialog 关联的业务对象；保持行业中立，不只服务任务表 */
+  subjectRefs?: DialogSubjectRef[];
+  /** 定时任务运行产生的对话归属的任务 key */
+  parentTaskKey?: string;
+  /** 定时任务去重 key */
+  idempotencyKey?: string;
+  /** cron 表达式，用于重复执行，如 "0 2 * * *" */
+  schedule?: string;
+  /** 定时任务执行的指令（不同于对话内容，是固定的任务描述） */
+  taskPrompt?: string;
+  policyState?: DialogPolicyState;
+  runtimeBinding?: DialogRuntimeBinding;
+  goal?: DialogGoalState;
+}
+
+export interface ScheduledTaskConfig {
+  id: string;
+  dbKey: string;
+  type: DataType.TASK;
+  title: string;
+  agentKey: string;
+  cybots: string[];
+  createdBy: string;
+  createdAt: string;
+  updatedAt: string;
+  spaceId?: string;
+  status: "active" | "paused" | "cancelled";
+  runStatus?: "idle" | "running" | "done" | "failed";
+  schedule: string;
+  taskPrompt: string;
+  nextRunAt: number;
+  lastRunAt?: number;
+  lastRunDialogKey?: string;
+  lastRunError?: string;
+  runDialogKeys?: string[];
+}
+export type ReferenceItem = {
+  dbKey: string;
+  title: string;
+  type: "knowledge" | "instruction";
+};
+
+
+export interface AgentGreetingMenuItem extends UiOption {
+  /** 以后如果想在 UI 上做分组，可以用 group；现在先不实现 UI */
+  group?: string;
+}
+
+
+/**
+ * Agent 的富 greeting：
+ * - text: 打招呼文案（markdown）
+ * - menu: 初始菜单项（会显示成第一条消息下方的按钮）
+ */
+export interface AgentGreetingConfig {
+  text?: string;
+  menu?: AgentGreetingMenuItem[];
+}
+
+
+
+export type PublicImageAgentMode = "generate" | "edit" | "continuous";
+
+export interface Agent {
+  /**
+   * Image workflow mode for this agent.
+   * - generate: text-to-image
+   * - edit: image editing
+   * - continuous: multi-step/interactive image workflows
+   */
+  imageWorkflow?: PublicImageAgentMode;
+  // --- 你已有的所有字段 ---
+  provider: string;
+  model: string;
+  imageModel?: string;
+  /** 执行来源：platform=平台API  custom=自定义API/本地  cli=命令行工具 */
+  apiSource?: "platform" | "custom" | "cli";
+  /** cli 时指定使用哪个 CLI 工具。CLI 可复用 prompt/model/最近文本历史，但不走本地 tool 协议。 */
+  cliProvider?: "copilot" | "gemini" | "codex" | "claude" | "agy";
+  prompt?: string;
+  name?: string;
+  [key: string]: any;
+  tools?: string[];
+  userId: string;
+  useServerProxy: boolean;
+  apiKey?: string;
+  apiKeyFromAgentKey?: string;
+  customProviderUrl?: string;
+  temperature?: number;
+  top_p?: number;
+  frequency_penalty?: number;
+  presence_penalty?: number;
+  max_tokens?: number;
+  reasoning_effort?: string;
+  enableThinking?: boolean;
+  thinkingBudget?: number;
+  updatedAt: string;
+  createdAt: number;
+  categoryId?: string;
+  spaceId?: string;
+  references?: ReferenceItem[];
+  tags?: string[];
+  tokenCount?: number;
+  messageCount?: number;
+  dialogCount?: number;
+  outputPrice?: number;
+  inputPrice?: number;
+  introduction?: string;
+  cover?: string;
+  greeting?: string | AgentGreetingConfig; // ✅ 这里改成联合类型
+  isPublic: boolean;
+  endpointKey?: string;
+
+
+  imageConfig?: {
+    enabled?: boolean;
+    aspectRatio?:
+    | "1:1"
+    | "2:3"
+    | "3:2"
+    | "3:4"
+    | "4:3"
+    | "4:5"
+    | "5:4"
+    | "9:16"
+    | "16:9"
+    | "21:9";
+    imageSize?: "1K" | "2K" | "4K";
+    forceModalities?: Array<"text" | "image">;
+  };
+
+  whitelist?: string[];
+
+  // Cross-Space Context: 关联的其他 Space ID 列表
+  // Agent 可以访问这些 Space 的内容作为粗略上下文
+  linkedSpaces?: string[];
+  basePolicy?: AgentBasePolicy;
+  runtimeBinding?: AgentRuntimeBinding | null;
+}
+
+
+
+// --- 内容相关 (核心修改处) ---
+
+export interface SpaceContent {
+  title: string;
+  type: ContentType;
+  contentKey: string; // 唯一标识符 (通常是 dbKey)
+  fileCategory?: FileCategory;
+  mimeType?: string;
+  fileSize?: number;
+  originalName?: string;
+
+  // --- 修改: categoryId 变为可选 ---
+  categoryId?: string; // 属性不存在或值为 undefined 代表未分类
+
+  pinned: boolean;
+  createdAt: number; // 时间戳 (number)
+  updatedAt: number; // 时间戳 (number)
+  order?: number; // 分类内排序
+  tags?: string[]; // 保留 tags 字段
+  triggerType?: string;
+  skillSummary?: {
+    isSkill: true;
+    skillId?: string;
+    name?: string;
+    description?: string;
+    toolNames?: string[];
+    triggerMode?: "explicit" | "required" | "recommended";
+  } | null;
+} // --- 主数据结构 (SpaceData 保持不变) ---
+
+export interface SpaceData {
+  id: ULID;
+  name: string;
+  description: string;
+  ownerId: string;
+  visibility: SpaceVisibility;
+  members: string[]; // userId 列表
+  categories: Categories;
+  contents: Contents;
+  createdAt: number;
+  updatedAt: number;
+}
+export enum ContentType {
+  DIALOG = "dialog",
+  DOC = "page",
+  FILE = "file",
+  IMAGE = "image",
+  AGENT = "agent",
+  APP = "app",
+  TASK = "task",
+} // --- 枚举 (保持不变) ---
+export type FileCategory =
+  | "image"
+  | "document"
+  | "video"
+  | "audio"
+  | "other";
+export enum SpaceVisibility {
+  PRIVATE = "private",
+  PUBLIC = "public",
+}
+export enum MemberRole {
+  OWNER = "owner",
+  ADMIN = "admin",
+  MEMBER = "member",
+  GUEST = "guest",
+}
+export type Categories = Record<string, Category | null>; // --- 分类相关 (Category, Categories 保持不变) ---
+export interface Category {
+  name: string;
+  order: number;
+  updatedAt: number;
+} // --- 成员相关 (SpaceMember, SpaceMemberWithSpaceInfo 保持不变) ---
+
+export interface SpaceMember {
+  role: MemberRole;
+  joinedAt: number;
+  updatedAt?: number;
+  userId: string;
+  spaceId: string;
+} // Contents 类型保持不变 (Record<string, SpaceContent | null>)
+export type Contents = Record<string, SpaceContent | null>;
+export interface SpaceMemberWithSpaceInfo {
+  role: MemberRole;
+  joinedAt: number;
+  memberUpdatedAt?: number;
+  spaceId: string;
+  spaceName: string;
+  ownerId: string;
+  visibility: SpaceVisibility;
+  spaceCreatedAt: number;
+  spaceUpdatedAt: number;
+  type?: DataType;
+}
+
+type MessageContentPartText = { type: "text"; text: string };
+type MessageContentPartImageUrl = OpenAIImageContent;
+
+type MessageContentPart = MessageContentPartText | MessageContentPartImageUrl;
+
+export interface Message {
+  id?: string;
+  role: "user" | "assistant" | "system" | "tool" | "developer";
+  content: string | MessageContentPart[];
+  name?: string;
+  tool_calls?: any;
+  tool_call_id?: string;
+  userId?: string;
+}
+
+// Share types re-exported from share/types
+export type { ShareType, SharedObject, ShareMeta, ShareSummary } from "../share/types";

package/app/utils/appDeploySource.ts

@@ -0,0 +1,50 @@
+export type AppDeployFramework = "worker" | "react-spa";
+
+export type AppSourceFileLike = {
+  name?: string | null;
+  code?: string | null;
+};
+
+const REACT_IMPORT_RE =
+  /from\s+["']react["']|from\s+["']react-dom\/client["']|react-icons\/lu|createRoot\s*\(/;
+
+const JSX_COMPONENT_RE =
+  /(?:return|=>)\s*\(?\s*<\s*[A-Za-z][A-Za-z0-9]*/;
+
+const REACT_FILE_RE = /\.(tsx|jsx)$/i;
+
+export function sourceLooksLikeReactModule(code?: string | null): boolean {
+  if (typeof code !== "string" || !code.trim()) return false;
+  return REACT_IMPORT_RE.test(code) || JSX_COMPONENT_RE.test(code);
+}
+
+export function filesLookLikeReactApp(
+  files?: AppSourceFileLike[] | null
+): boolean {
+  if (!Array.isArray(files) || files.length === 0) return false;
+  return files.some(
+    (file) =>
+      (typeof file?.name === "string" && REACT_FILE_RE.test(file.name)) ||
+      sourceLooksLikeReactModule(file?.code)
+  );
+}
+
+export function inferAppDeployFramework(params: {
+  framework?: string | null;
+  code?: string | null;
+  files?: AppSourceFileLike[] | null;
+}): AppDeployFramework | undefined {
+  if (params.framework === "worker" || params.framework === "react-spa") {
+    return params.framework;
+  }
+
+  if (Array.isArray(params.files) && params.files.length > 0) {
+    return filesLookLikeReactApp(params.files) ? "react-spa" : "worker";
+  }
+
+  if (typeof params.code === "string" && params.code.trim()) {
+    return sourceLooksLikeReactModule(params.code) ? "react-spa" : "worker";
+  }
+
+  return undefined;
+}

package/app/utils/appKeys.ts

@@ -0,0 +1,55 @@
+export const APP_ROUTE_KEY_PREFIX = "app-";
+
+const normalizeSegment = (value?: string | null): string | null => {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  return trimmed ? trimmed : null;
+};
+
+export const buildUserAppKey = (userId: string, appId: string): string =>
+  `${APP_ROUTE_KEY_PREFIX}${userId}-${appId}`;
+
+export const buildOwnerScopedAppKey = (params: {
+  userId: string;
+  appId: string;
+  spaceId?: string | null;
+}): string => buildUserAppKey(params.userId, params.appId);
+
+export const buildLegacyAppRouteKey = (appId: string): string =>
+  `${APP_ROUTE_KEY_PREFIX}${appId}`;
+
+export const isAppRouteKey = (value?: string | null): value is string =>
+  typeof value === "string" && value.startsWith(APP_ROUTE_KEY_PREFIX);
+
+export const resolveAppRouteKey = (
+  appKey?: string | null,
+  appId?: string | null
+): string | null => {
+  const normalizedAppKey = normalizeSegment(appKey);
+  if (normalizedAppKey) return normalizedAppKey;
+  const normalizedAppId = normalizeSegment(appId);
+  if (!normalizedAppId) return null;
+  return isAppRouteKey(normalizedAppId)
+    ? normalizedAppId
+    : buildLegacyAppRouteKey(normalizedAppId);
+};
+
+export const deriveAppIdFromRouteKey = (
+  appKey?: string | null,
+  userId?: string | null
+): string | undefined => {
+  const normalizedAppKey = normalizeSegment(appKey);
+  if (!normalizedAppKey || !isAppRouteKey(normalizedAppKey)) return undefined;
+
+  const normalizedUserId = normalizeSegment(userId);
+  if (normalizedUserId) {
+    const scopedPrefix = `${APP_ROUTE_KEY_PREFIX}${normalizedUserId}-`;
+    if (normalizedAppKey.startsWith(scopedPrefix)) {
+      const appId = normalizedAppKey.slice(scopedPrefix.length).trim();
+      return appId || undefined;
+    }
+  }
+
+  const legacyAppId = normalizedAppKey.slice(APP_ROUTE_KEY_PREFIX.length).trim();
+  return legacyAppId || undefined;
+};

package/app/utils/appRuntimeUrl.ts

@@ -0,0 +1,51 @@
+const normalizeAbsoluteUrl = (value?: string | null): string | undefined => {
+  if (typeof value !== "string") return undefined;
+  const trimmed = value.trim();
+  if (!trimmed) return undefined;
+  return trimmed;
+};
+
+const normalizeOrigin = (value?: string | null): string | undefined => {
+  const normalized = normalizeAbsoluteUrl(value);
+  if (!normalized || !/^https?:\/\//.test(normalized)) return undefined;
+  return normalized.replace(/\/+$/, "");
+};
+
+export const buildAppRuntimeUrl = (
+  appId?: string | null,
+  origin?: string | null
+): string | undefined => {
+  const normalizedAppId = normalizeAbsoluteUrl(appId);
+  const normalizedOrigin = normalizeOrigin(origin);
+  if (!normalizedAppId || !normalizedOrigin) return undefined;
+  return `${normalizedOrigin}/apps/${normalizedAppId}/`;
+};
+
+export const getCurrentAppRuntimeOrigin = (): string | undefined => {
+  if (
+    typeof window !== "undefined" &&
+    typeof window.location?.origin === "string"
+  ) {
+    return normalizeOrigin(window.location.origin);
+  }
+  return undefined;
+};
+
+export const resolvePreferredAppRuntimeUrl = (params: {
+  appId?: string | null;
+  customUrl?: string | null;
+  url?: string | null;
+  currentOrigin?: string | null;
+}): string => {
+  const customUrl = normalizeAbsoluteUrl(params.customUrl);
+  const remoteUrl = normalizeAbsoluteUrl(params.url);
+  if (customUrl && customUrl !== remoteUrl) return customUrl;
+
+  const platformUrl = buildAppRuntimeUrl(
+    params.appId,
+    params.currentOrigin ?? getCurrentAppRuntimeOrigin()
+  );
+  if (platformUrl) return platformUrl;
+
+  return remoteUrl ?? "";
+};

package/app/utils/async.ts

@@ -0,0 +1,28 @@
+// 文件路径: app/utils/async.ts
+
+/*
+ * ==================================================================
+ *  /app/utils/async.ts
+ * ==================================================================
+ */
+
+const isAbortError = (err: unknown, signal?: AbortSignal) =>
+  (err as any)?.name === "AbortError" ||
+  (typeof signal !== "undefined" && !!signal?.aborted);
+
+/**
+ * 吞掉非 abort 错误，保留 AbortError。
+ */
+export function swallowNonAbortError<T>(
+  promise: Promise<T>,
+  fallback: T,
+  signal?: AbortSignal
+): Promise<T> {
+  return promise.catch((err) => {
+    if (isAbortError(err, signal)) {
+      throw err;
+    }
+    console.error("Non-abort error in async op:", err);
+    return fallback;
+  });
+}

package/app/utils/asyncMapStatus.ts

@@ -0,0 +1,31 @@
+// 文件路径: app/utils/asyncMapStatus.ts
+import type { Dispatch, SetStateAction } from "react";
+
+export interface BaseAsyncStatus {
+    processing: boolean;
+    error?: string;
+}
+
+export async function withMapItemProcessing<K, S extends BaseAsyncStatus>(
+    key: K,
+    setMap: Dispatch<SetStateAction<Map<K, S>>>,
+    task: () => Promise<void>
+) {
+    setMap((prev) => {
+        const next = new Map(prev);
+        const prevStatus = next.get(key) || ({ processing: false } as S);
+        next.set(key, { ...prevStatus, processing: true, error: undefined });
+        return next;
+    });
+
+    try {
+        await task();
+    } finally {
+        setMap((prev) => {
+            const next = new Map(prev);
+            const prevStatus = next.get(key) || ({ processing: false } as S);
+            next.set(key, { ...prevStatus, processing: false });
+            return next;
+        });
+    }
+}