nolo-cli 0.1.23 → 0.1.29

package/commandRegistry.ts

@@ -1,66 +1,16 @@
-export type CommandEntry = {
-  path: string[];
-  script: string;
-  description: string;
-  fixedArgs?: string[];
-};
+export type { CliPackageInfo, CliRuntimeContext, CommandEntry } from "./cliCommandTypes";
+export {
+  createCliRuntimeContext,
+  looksLikeDaemonShortcut,
+  runResolvedCommand,
+} from "./cliCommandDispatch";
+import type { CommandEntry } from "./cliCommandTypes";
+import { getInternalCommandEntries } from "./internalCommandEntries";
+import { getScriptCommandEntries } from "./scriptCommandEntries";
 
 export const COMMANDS: CommandEntry[] = [
-  { path: ["chat"], script: "", description: "Chat with an agent" },
-
-  { path: ["doc", "create"], script: "createDoc.ts", description: "Create a normal doc" },
-  { path: ["doc", "read"], script: "readDoc.ts", description: "Read a normal doc" },
-  { path: ["doc", "update"], script: "updateDoc.ts", description: "Update a normal doc" },
-  { path: ["doc", "delete"], script: "deleteDoc.ts", description: "Delete a normal doc" },
-
-  { path: ["skill-doc", "create"], script: "createSkillDoc.ts", description: "Create a skill doc" },
-  { path: ["skill-doc", "read"], script: "readSkillDoc.ts", description: "Read a skill doc" },
-  { path: ["skill-doc", "update"], script: "updateSkillDoc.ts", description: "Update a skill doc" },
-  { path: ["skill-doc", "delete"], script: "deleteSkillDoc.ts", description: "Delete a skill doc" },
-  { path: ["skill", "create-doc"], script: "createSkillDoc.ts", description: "Create a skill-backed doc" },
-
-  { path: ["dialog", "read"], script: "readDialog.ts", description: "Read a dialog" },
-  { path: ["dialog", "status"], script: "dialogStatus.ts", description: "Read compact dialog status" },
-  { path: ["space", "list"], script: "listSpaces.ts", description: "List joined spaces" },
-  { path: ["space", "read"], script: "readSpace.ts", description: "Read a space" },
-  { path: ["space", "delete"], script: "deleteSpaces.ts", description: "Delete spaces by safe filters" },
-  { path: ["space", "category"], script: "upsertSpaceCategory.ts", description: "Create or update a space category" },
-  { path: ["space", "content-category"], script: "setSpaceContentCategory.ts", description: "Move content into a space category" },
-
-  { path: ["table", "query"], script: "tableData.ts", fixedArgs: ["--action", "query"], description: "Query table rows" },
-  { path: ["table", "add-column"], script: "tableData.ts", fixedArgs: ["--action", "add-column"], description: "Add one table column" },
-  { path: ["table", "add-row"], script: "tableData.ts", fixedArgs: ["--action", "add-row"], description: "Add one table row" },
-  { path: ["table", "add-rows"], script: "tableData.ts", fixedArgs: ["--action", "add-rows"], description: "Add table rows" },
-  { path: ["table", "update-row"], script: "tableData.ts", fixedArgs: ["--action", "update-row"], description: "Update one table row" },
-  { path: ["table", "update-rows"], script: "tableData.ts", fixedArgs: ["--action", "update-rows"], description: "Update table rows" },
-  { path: ["table", "delete-row"], script: "tableData.ts", fixedArgs: ["--action", "delete-row"], description: "Delete one table row" },
-  { path: ["table", "delete-rows"], script: "tableData.ts", fixedArgs: ["--action", "delete-rows"], description: "Delete table rows" },
-  { path: ["table", "data"], script: "tableData.ts", description: "Low-level table row script bridge" },
-  { path: ["table", "meta"], script: "upsertTableMeta.ts", description: "Create or update table metadata" },
-  { path: ["task-run"], script: "", description: "Update durable task-run state through the runner bridge" },
-
-  { path: ["agent", "list"], script: "listMyAgents.ts", description: "List owned agents" },
-  { path: ["agent", "pull"], script: "", description: "Cache an agent for local runs" },
-  { path: ["agent", "read"], script: "", description: "Read a single agent" },
-  { path: ["agent", "run"], script: "", description: "Run an agent" },
-  { path: ["agent", "update"], script: "updateAgent.ts", description: "Update agent fields" },
-  { path: ["agent", "bind-current"], script: "", description: "Bind an agent to this machine" },
-  { path: ["agent", "smoke-current"], script: "", description: "Smoke test a bound agent through this machine" },
-  { path: ["agent", "runtime-doctor"], script: "", description: "Diagnose current machine runtime compatibility" },
-  { path: ["agent", "unpublish"], script: "unpublishAgent.ts", description: "Remove an agent's public record" },
-  { path: ["agent", "chat"], script: "", description: "Chat with an agent" },
-  { path: ["agent", "dialogs"], script: "queryAgentDialogs.ts", description: "Inspect recent dialogs for an agent" },
-  { path: ["agent", "doctor"], script: "doctorAgentWorkspace.ts", description: "Audit agent workspace health" },
-  { path: ["agent", "create-custom"], script: "createCustomCodingAgent.ts", description: "Create a custom coding agent" },
-  { path: ["agent", "create-space"], script: "createSpaceAgents.ts", description: "Create or attach shared-space agents" },
-  { path: ["agent", "setup-demo"], script: "setupDemoAgent.ts", description: "Bootstrap demo publisher agents" },
-  { path: ["agent", "supervise"], script: "runAutonomousAgent.ts", description: "Run an agent in autonomous cycles" },
-
-  { path: ["doctor", "runtime"], script: "", description: "Diagnose local-first agent runtime selection" },
-
-  { path: ["llama"], script: "llamaServerSupervisor.ts", description: "Manage the llama.cpp runtime" },
-  { path: ["model-runtime"], script: "localModelRuntimeSupervisor.ts", description: "Manage local model runtime processes" },
-  { path: ["dev"], script: "devControl.ts", description: "Manage the local dev environment" },
+  ...getInternalCommandEntries(renderHelpText),
+  ...getScriptCommandEntries(),
 ];
 
 export const GROUP_ORDER = [
@@ -105,8 +55,8 @@ export function renderHelpText() {
     "  nolo doctor",
     "  nolo doctor runtime",
     "  nolo update",
-    '  nolo doc create --title "Trip Notes" --body "hello" --sync local,us --dry-run',
-    '  nolo skill-doc create --title "Agent Query Skill" --description "Inspect recent agent dialogs" --sync local,main,us',
+    '  nolo doc create --title "Trip Notes" --body "hello" --space 01SPACEID --dry-run',
+    '  nolo skill-doc create --title "Agent Query Skill" --description "Inspect recent agent dialogs" --space 01SPACEID',
     "  nolo agent list --json",
     "  nolo space list --json",
     "  nolo agent pull agent-pub-01APPBUILDER00000001YAII3I",

package/connector-experimental/capabilities.ts

@@ -29,6 +29,7 @@ const COMMAND_CAPABILITIES: Array<[probes: CommandProbe[], capability: string]>
   ],
   [[{ command: "gemini", args: ["--version"] }], "gemini-cli"],
   [[{ command: "kimi", args: ["--version"] }], "kimi-cli"],
+  [[{ command: "agy", args: ["--help"] }], "agy-cli"],
 ];
 
 function defaultCommandExists(command: string) {

package/connector-experimental/daemonLauncher.ts

@@ -0,0 +1,189 @@
+import { spawn } from "node:child_process";
+import { existsSync, mkdirSync, openSync, readFileSync, realpathSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+
+export type ConnectorDaemonEnv = Record<string, string | undefined>;
+
+export type ConnectorDaemonOutput = {
+  write(chunk: string): void;
+};
+
+type PackageJson = {
+  name?: string;
+  workspaces?: string[] | { packages?: string[] };
+};
+
+const CONNECTOR_RUNTIME_WORKSPACE_PACKAGES = new Set([
+  "connector-experimental",
+  "ai",
+]);
+
+function readJsonFile<T>(path: string): T | null {
+  try {
+    return JSON.parse(readFileSync(path, "utf8")) as T;
+  } catch {
+    return null;
+  }
+}
+
+function getWorkspacePatterns(packageJson: PackageJson) {
+  if (Array.isArray(packageJson.workspaces)) return packageJson.workspaces;
+  return packageJson.workspaces?.packages ?? [];
+}
+
+function normalizePath(path: string) {
+  const resolved = resolve(path);
+  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+
+function isInsideOrSame(path: string, parent: string) {
+  const relativePath = relative(parent, path);
+  return relativePath === "" || (!relativePath.startsWith("..") && !isAbsolute(relativePath));
+}
+
+function findWorkspaceRoot(startPath: string) {
+  let current = resolve(startPath);
+  while (true) {
+    const packageJsonPath = join(current, "package.json");
+    if (existsSync(packageJsonPath)) {
+      const packageJson = readJsonFile<PackageJson>(packageJsonPath);
+      if (packageJson && getWorkspacePatterns(packageJson).length > 0) {
+        return current;
+      }
+    }
+    const parent = dirname(current);
+    if (parent === current) return null;
+    current = parent;
+  }
+}
+
+export function validateConnectorWorkspaceLinks(cwd: string) {
+  const repoRoot = findWorkspaceRoot(cwd);
+  if (!repoRoot) return [];
+
+  const rootPackageJson = readJsonFile<PackageJson>(join(repoRoot, "package.json"));
+  if (!rootPackageJson) return [];
+
+  const normalizedRepoRoot = normalizePath(realpathSync(repoRoot));
+  const errors: string[] = [];
+
+  for (const pattern of getWorkspacePatterns(rootPackageJson)) {
+    if (!pattern.endsWith("/*")) continue;
+    const workspaceParent = join(repoRoot, pattern.slice(0, -2));
+    if (!existsSync(workspaceParent)) continue;
+
+    for (const entry of Array.from(new Bun.Glob("*/package.json").scanSync({ cwd: workspaceParent }))) {
+      const packageDir = join(workspaceParent, dirname(entry));
+      const packageJson = readJsonFile<PackageJson>(join(workspaceParent, entry));
+      if (!packageJson?.name || !CONNECTOR_RUNTIME_WORKSPACE_PACKAGES.has(packageJson.name)) {
+        continue;
+      }
+
+      const linkPath = join(repoRoot, "node_modules", ...packageJson.name.split("/"));
+      if (!existsSync(linkPath)) {
+        errors.push(`${linkPath} is missing. Run bun install in ${repoRoot}.`);
+        continue;
+      }
+
+      const actualPath = normalizePath(realpathSync(linkPath));
+      const expectedPath = normalizePath(realpathSync(packageDir));
+      if (!isInsideOrSame(actualPath, normalizedRepoRoot)) {
+        errors.push(
+          `${linkPath} points outside this checkout: ${actualPath}. Run bun install in ${repoRoot}.`,
+        );
+        continue;
+      }
+      if (actualPath !== expectedPath) {
+        errors.push(
+          `${linkPath} points at ${actualPath}, expected ${expectedPath}. Run bun install in ${repoRoot}.`,
+        );
+      }
+    }
+  }
+
+  return errors;
+}
+
+export async function checkConnectorWorkspaceLinks(
+  cwd: string,
+  output: ConnectorDaemonOutput,
+  validateWorkspaceLinks: (cwd: string) => string[] | Promise<string[]>,
+) {
+  const errors = await validateWorkspaceLinks(cwd);
+  if (errors.length === 0) return true;
+  output.write(
+    [
+      "[nolo] Connector workspace package links are unsafe.",
+      "The connector would import workspace packages from a different checkout, so machine capabilities and runtime behavior may be stale.",
+      ...errors,
+      "",
+    ].join("\n"),
+  );
+  return false;
+}
+
+export function resolveDaemonLogPath(env: ConnectorDaemonEnv) {
+  return env.NOLO_CONNECT_LOG || join(homedir(), ".nolo", "logs", "connector.log");
+}
+
+export function buildDaemonCommand(cliEntrypointPath: string | undefined, fallbackEntrypointPath = import.meta.path) {
+  return [process.execPath, cliEntrypointPath || fallbackEntrypointPath, "connect", "--ws"];
+}
+
+export function defaultSpawnDaemon(args: {
+  cmd: string[];
+  cwd: string;
+  env: ConnectorDaemonEnv;
+  logPath: string;
+}) {
+  mkdirSync(dirname(args.logPath), { recursive: true });
+  const out = openSync(args.logPath, "a");
+  const env = Object.fromEntries(
+    Object.entries(args.env).filter((entry): entry is [string, string] => typeof entry[1] === "string")
+  );
+  const proc = spawn(args.cmd[0], args.cmd.slice(1), {
+    cwd: args.cwd,
+    env,
+    detached: true,
+    stdio: ["ignore", out, out],
+  });
+  proc.unref();
+  return { pid: proc.pid };
+}
+
+export type ConnectorDaemonDeps = {
+  env?: ConnectorDaemonEnv;
+  output?: ConnectorDaemonOutput;
+  cliEntrypointPath?: string;
+  cwd?: string;
+  fallbackEntrypointPath?: string;
+  validateWorkspaceLinks?: (cwd: string) => string[] | Promise<string[]>;
+  spawnDaemon?: (args: {
+    cmd: string[];
+    cwd: string;
+    env: ConnectorDaemonEnv;
+    logPath: string;
+  }) => { pid?: number };
+};
+
+export async function runConnectorDaemon(deps: ConnectorDaemonDeps = {}) {
+  const env = deps.env ?? process.env;
+  const output = deps.output ?? process.stdout;
+  const cwd = deps.cwd ?? process.cwd();
+  const validateWorkspaceLinks = deps.validateWorkspaceLinks ?? validateConnectorWorkspaceLinks;
+
+  if (!(await checkConnectorWorkspaceLinks(cwd, output, validateWorkspaceLinks))) {
+    return 1;
+  }
+
+  const logPath = resolveDaemonLogPath(env);
+  const result = (deps.spawnDaemon ?? defaultSpawnDaemon)({
+    cmd: buildDaemonCommand(deps.cliEntrypointPath, deps.fallbackEntrypointPath),
+    cwd,
+    env,
+    logPath,
+  });
+  output.write(`Connector daemon started${result.pid ? ` pid=${result.pid}` : ""}. Log: ${logPath}\n`);
+  return 0;
+}

package/core/builtinAgents.ts

@@ -0,0 +1,58 @@
+export const BUILTIN_NOLO_AGENT_KEY = "agent-pub-01NOLOAPPBLD000000019KCKT0";
+export const BUILTIN_APP_BUILDER_AGENT_KEY =
+  "agent-pub-01APPBUILDER00000001YAII3I";
+export const BUILTIN_ECOMMERCE_AGENT_KEY =
+  "agent-pub-01ECOMMERCEAG00000001PYQ2J";
+export const BUILTIN_AGENT_CREATOR_AGENT_KEY =
+  "agent-pub-01NOLOAGENTCRT000000000001";
+export const BUILTIN_AGENT_CREATOR_AGENT_ID = "01NOLOAGENTCRT000000000001";
+
+export const BUILTIN_AGENT_CREATOR_PROMPT = [
+  "你是 Nolo 的 AI 创建助手，只负责通过对话帮助用户创建或调整一个新的 Agent。",
+  "先理解用户想让这个 AI 服务谁、完成什么任务、使用什么语气、需要哪些能力、是否需要知识引用，以及是否适合公开。",
+  "当信息足够形成初版配置时，先调用 prepareAgentDraft，生成可预览草稿；信息不足时每次只问一个关键问题。",
+  "prepareAgentDraft 只生成草稿，不代表已经创建真实 Agent。",
+  "草稿展示后，等待用户明确确认，例如“确认创建”“就按这个创建”“创建这个 AI”。",
+  "只有得到明确确认后，才调用 createAgent 创建真实 Agent。",
+  "用户只是讨论、补充、修改或说“先看看”时，不要调用 createAgent。",
+  "默认模型使用 provider=fireworks, model=accounts/fireworks/models/kimi-latest；除非用户明确要求且平台已知支持，不要选择 Claude/Anthropic 等当前 runtime 不支持的 provider。",
+  "公开状态保持保守：你可以建议公开，但只有用户明确要求公开发布时，createAgent 的 isPublic 才能为 true。",
+  "如果用户想手动微调模型、工具、知识引用或发布状态，可以引导用户进入 /create/agent 高级编辑页。",
+].join("\n");
+
+export const buildBuiltinAgentCreatorRecord = () => {
+  const timestamp = Date.now();
+  return {
+    type: "agent",
+    dbKey: BUILTIN_AGENT_CREATOR_AGENT_KEY,
+    id: BUILTIN_AGENT_CREATOR_AGENT_ID,
+    isPublic: true,
+    userId: "builtin",
+    createdAt: timestamp,
+    updatedAt: timestamp,
+    name: "AI 创建助手",
+    introduction:
+      "通过对话帮你整理专属 AI 的用途、能力、Prompt、知识引用和发布建议，并在确认后创建。",
+    greeting:
+      "告诉我你想创建一个什么样的 AI：它要帮谁、完成什么、需要哪些能力或资料？",
+    provider: "fireworks",
+    model: "accounts/fireworks/models/kimi-latest",
+    useServerProxy: true,
+    apiSource: "platform",
+    runtimeServerBase: "https://nolo.chat",
+    inputPrice: 7.6,
+    outputPrice: 32,
+    hasVision: false,
+    references: [],
+    tags: ["AI 创建", "Agent 创建", "配置助手"],
+    tools: ["prepareAgentDraft", "createAgent"],
+    prompt: BUILTIN_AGENT_CREATOR_PROMPT,
+  };
+};
+
+export const BUILTIN_PLATFORM_AGENT_KEYS = [
+  BUILTIN_NOLO_AGENT_KEY,
+  BUILTIN_APP_BUILDER_AGENT_KEY,
+  BUILTIN_ECOMMERCE_AGENT_KEY,
+  BUILTIN_AGENT_CREATOR_AGENT_KEY,
+] as const;

package/core/coin.ts

@@ -0,0 +1,42 @@
+import * as nacl from "tweetnacl";
+import { Level } from "level";
+
+interface Coin {
+  coinId: string;
+  value: number;
+}
+
+interface CoinData {
+  value: number;
+  signature: string;
+}
+
+export async function createCoin(
+  value: number,
+  privateKey: Uint8Array,
+  db: Level
+): Promise<Coin> {
+  // 签名
+  const message = new Uint8Array(Buffer.from(value.toString()));
+  const signature = nacl.sign.detached(message, privateKey);
+
+  // 组合数据
+  const data: CoinData = {
+    value: value,
+    signature: Buffer.from(signature).toString("hex"),
+  };
+
+  // 生成coinId
+  const coinHash = nacl.hash(
+    Uint8Array.from(Buffer.from(JSON.stringify(data)))
+  );
+  const coinId = "coin" + Buffer.from(coinHash).toString("hex");
+
+  // 存储
+  await db.put(coinId, JSON.stringify(data));
+
+  return {
+    coinId,
+    value,
+  };
+}

package/core/config.ts

@@ -0,0 +1,15 @@
+const providerName = "nolotus";
+
+const slogonforYou =
+  "The goodness or badness of this world concerns every individual.";
+
+// be cart  CryptoJS.PBKDF2  keySize: 256 / AUTH_VERSION[1].keylen,
+// even keylen same ,maybe error rn with web version
+export const AUTH_VERSION = {
+  "1": {
+    iterations: 10000,
+    salt: providerName + slogonforYou,
+    keylen: 32,
+  },
+};
+export const SALT = AUTH_VERSION[1].salt;

package/core/crypto.ts

@@ -0,0 +1,51 @@
+import nacl from "tweetnacl";
+import { Base64 } from "js-base64";
+
+export const signMessage = (
+  message: string,
+  secretKeyBase64: string
+): string => {
+  const messageUint8 = new TextEncoder().encode(message);
+  const signedMessage = nacl.sign(
+    messageUint8,
+    Base64.toUint8Array(secretKeyBase64)
+  );
+  return Base64.fromUint8Array(signedMessage);
+};
+
+export const verifySignedMessage = (
+  signedMessageBase64: string,
+  publicKeyBase64: string
+): string => {
+  const message = nacl.sign.open(
+    Base64.toUint8Array(signedMessageBase64),
+    Base64.toUint8Array(publicKeyBase64)
+  );
+
+  if (!message) throw new Error("Decoding failed");
+  return new TextDecoder().decode(message);
+};
+
+export const detachedSign = (message: string, secretKeyBase64: string) => {
+  const signature = nacl.sign.detached(
+    new TextEncoder().encode(message),
+    Base64.toUint8Array(secretKeyBase64)
+  );
+  return Base64.fromUint8Array(signature, true);
+};
+
+export const verifyDetachedSignature = (
+  message: string,
+  signatureBase64: string,
+  publicKeyBase64: string
+): boolean => {
+  try {
+    return nacl.sign.detached.verify(
+      new TextEncoder().encode(message),
+      Base64.toUint8Array(signatureBase64),
+      Base64.toUint8Array(publicKeyBase64)
+    );
+  } catch {
+    return false;
+  }
+};

package/core/events/types.ts

@@ -0,0 +1,145 @@
+// 文件: core/events/types.ts
+
+export type ULID = string;
+
+/* --------------------------------------------------------------------------
+ * 1. 领域事件（DomainEvent）
+ * ------------------------------------------------------------------------*/
+
+/**
+ * 事件作用的实体类型：
+ * - table   ：表（行增删改等）
+ * - page    ：页面 / 文档
+ * - dialog  ：对话
+ * - agent   ：Agent / Cybot
+ * - space   ：空间（Space）
+ * - system  ：系统级事件（定时任务、后台任务等）
+ */
+export type EventEntityType =
+    | "table"
+    | "page"
+    | "dialog"
+    | "agent"
+    | "space"
+    | "system";
+
+/**
+ * 事件上下文：可选的元信息，便于追踪谁触发了事件、从哪里来的
+ */
+export interface DomainEventContext {
+    userId?: string;
+    agentKey?: string;      // 触发事件的 Agent / Cybot key（dbKey 或逻辑 ID）
+    requestId?: string;     // 本次请求的追踪 ID
+    [key: string]: any;
+}
+
+/**
+ * 领域事件：
+ * - 描述系统中「某件事」发生的事实
+ * - Trigger / Job 都基于事件运作
+ */
+export interface DomainEvent {
+    id: ULID;               // eventId
+    tenantId: string;
+    entityType: EventEntityType;
+    entityKey: string;      // 具体实体的 dbKey，如 meta-dbKey / page-dbKey / dialog-dbKey / "system"
+
+    /** 事件类型，如 "row_created" / "row_updated" / "page_created" / "cron_tick" 等 */
+    eventType: string;
+
+    occurredAt: string;     // ISO 时间戳
+
+    /** 事件前后的快照（可选），便于触发器判断条件和 Job 路由 */
+    before?: any;
+    after?: any;
+
+    /** 额外上下文（触发人/触发 Agent/RequestId 等） */
+    context?: DomainEventContext;
+}
+
+/* --------------------------------------------------------------------------
+ * 2. 通用 Trigger 定义
+ * ------------------------------------------------------------------------*/
+
+/**
+ * Trigger 作用域类型：
+ * - table   ：某张表（一个 TableMeta）
+ * - page    ：某个 Page
+ * - dialog  ：某个 Dialog
+ * - space   ：某个 Space
+ * - global  ：全局范围（不限定具体实体）
+ */
+export type TriggerScopeType = "table" | "page" | "dialog" | "space" | "global";
+
+/**
+ * Trigger 动作类型：
+ * - agent   ：调用 Agent / Cybot 做后处理
+ * - webhook ：调用外部 HTTP 接口
+ * - custom  ：预留，将来可以挂自定义 Runner
+ */
+export type TriggerActionType = "agent" | "webhook" | "custom";
+
+/**
+ * 通用 Trigger 定义：
+ * - Trigger 是“静态规则”：什么事件 + 什么作用域 + 条件 → 触发什么动作
+ * - BaseTrigger 不关心具体实体类型，scopeType + scopeKey 描述范围
+ */
+export interface BaseTrigger {
+    id: ULID;
+    name: string;
+    description?: string;
+    enabled: boolean;
+
+    /** 作用域类型 + 范围 */
+    scopeType: TriggerScopeType;
+    scopeKey: string; // 对应实体 dbKey 或 "global"
+
+    /** 关心的事件类型，如 "row_created" / "page_created" / "cron_tick" 等 */
+    eventType: string;
+
+    /** 条件（可选）：例如根据列值/字段值过滤。结构后续可以演进为 DSL。 */
+    condition?: any;
+
+    /** 动作定义 */
+    actionType: TriggerActionType;
+    actionConfig?: any;
+}
+
+/* --------------------------------------------------------------------------
+ * 3. Job（工作单）
+ * ------------------------------------------------------------------------*/
+
+/**
+ * Job 状态
+ */
+export type JobStatus = "pending" | "running" | "succeeded" | "failed";
+
+/**
+ * Job：
+ * - 由 Trigger + DomainEvent 实例化出的“工作单”
+ * - 可以被 Job Runner / Agent Runner 消费执行
+ */
+export interface Job {
+    id: ULID;
+    tenantId: string;
+
+    /** 源 Trigger / 触发规则 */
+    triggerId: ULID;
+
+    /** 源事件快照 */
+    event: DomainEvent;
+
+    /** 执行动作（由 Trigger 决定） */
+    actionType: TriggerActionType;
+    actionConfig?: any;
+
+    status: JobStatus;
+    attempts: number;
+    maxAttempts: number;
+
+    createdAt: string;
+    updatedAt: string;
+
+    result?: any;
+    error?: string;
+}

package/core/generateKeyPairFromSeedV1.ts

@@ -0,0 +1,15 @@
+// keypair.ts
+import nacl from "tweetnacl";
+import { Base64 } from "js-base64";
+
+export const generateKeyPairFromSeedV1 = (seedData: string) => {
+  const seed = new TextEncoder().encode(seedData);
+  const hashSeed = nacl.hash(seed);
+  const seed32 = hashSeed.slice(0, 32);
+  const keyPair = nacl.sign.keyPair.fromSeed(seed32);
+
+  return {
+    publicKey: Base64.fromUint8Array(keyPair.publicKey, true),
+    secretKey: Base64.fromUint8Array(keyPair.secretKey, true),
+  };
+};

package/core/generateMainKey.ts

@@ -0,0 +1,22 @@
+import nacl from "tweetnacl";
+
+export const generateUserIdV1 = (
+  publicKey: string,
+  username: string,
+  language: string,
+  extra: string = ""
+) => {
+  const text = publicKey + username + language + extra;
+  const encodedText = new TextEncoder().encode(text);
+  const hash = nacl.hash(encodedText);
+
+  // 方案1：使用Array.from和map
+  const hexString = Array.from(hash)
+    .map((b) => b.toString(16).padStart(2, "0"))
+    .join("");
+
+  // 方案2：更简洁的写法，用Uint8Array直接转
+  // const hexString = [...hash].map(x => x.toString(16).padStart(2,'0')).join('');
+
+  return hexString.slice(0, 10);
+};