@sleep2agi/agent-network 2.3.0-preview.16 → 2.3.0-preview.161

package/dist/src/inbox-drain.d.ts

@@ -0,0 +1,20 @@
+export interface InboxPage<T> {
+    ok?: boolean;
+    messages?: T[];
+}
+export interface DrainOptions<T extends {
+    id: string;
+}> {
+    fetchPage: (limit: number) => Promise<InboxPage<T> | undefined | null>;
+    handle: (msg: T) => Promise<void>;
+    pageSize?: number;
+    maxPages?: number;
+}
+export interface DrainResult {
+    delivered: number;
+    pages: number;
+    stoppedBy: "empty" | "short-page" | "max-pages" | "no-progress" | "fetch-error";
+}
+export declare function drainInbox<T extends {
+    id: string;
+}>(opts: DrainOptions<T>): Promise<DrainResult>;

package/dist/src/local-process-state.d.ts

@@ -0,0 +1,12 @@
+export type LocalProcessState = {
+    kind: "alive";
+    pid: number;
+} | {
+    kind: "stale";
+    pid: number;
+} | {
+    kind: "none";
+};
+export declare function describeLocalProcess(state: LocalProcessState): string;
+/** doctor 印完节点清单后的那一句:说清这一列量的是本机,不是 hub。 */
+export declare const LOCAL_VS_HUB_NOTE: string;

package/dist/src/locale-diagnostic.d.ts

@@ -0,0 +1,12 @@
+export interface LocaleDiagnostic {
+    effectiveVariable: "LC_ALL" | "LC_CTYPE" | "LANG" | null;
+    effectiveValue: string | null;
+    shouldWarn: boolean;
+}
+/**
+ * Resolve the locale with the same precedence used by POSIX libc. Windows
+ * does not use these variables as its process Unicode boundary, so prescribing
+ * a POSIX locale there would be misleading.
+ */
+export declare function diagnoseLocale(env: Readonly<Record<string, string | undefined>>, platform: string): LocaleDiagnostic;
+export declare function formatLocaleSource(diagnostic: LocaleDiagnostic): string;

package/dist/src/login-client-label.d.ts

@@ -0,0 +1,6 @@
+export declare const CLIENT_LABEL_MAX = 64;
+export declare function anetClientLabel(env: {
+    version?: string | null;
+    host?: string | null;
+    command: string;
+}): string;

package/dist/src/ls-columns.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 一列该多宽:装得下表头,也装得下这一列里最长的那个值。
+ *
+ * 🔴 两处用它的地方来源不同,但问题一样:
+ *  - `anet node ls` 的 RUNTIME 列:值域来自 `SUPPORTED_RUNTIME_NAMES`(唯一真源);
+ *  - `anet status` / `anet tasks` 的 STATUS 列:值域散在 server/ 里(另一个包),
+ *    CLI 没法 import —— 但**要打印的那些行就在手上**,直接从数据算。
+ *
+ * 两种情况都不该写死一个数:写死的那个,下一次加 runtime / 加状态时就漂了。
+ */
+export declare function columnWidth(values: readonly unknown[], header: string): number;
+/** RUNTIME 列的专用入口 —— 保留原名,调用点不用改。 */
+export declare function runtimeColumnWidth(names: readonly string[], header?: string): number;
+export declare function lsHeaderRow(runtimeWidth: number): string;
+export declare function lsSeparatorRow(runtimeWidth: number): string;

package/dist/src/mock-llm.d.ts

@@ -0,0 +1,12 @@
+export declare const MOCK_LLM_FALLBACK = "(mock LLM: no rule matched)";
+export type MockLlmRule = Readonly<{
+    in_substring: string;
+    out: string;
+}>;
+export type MockLlmResolution = Readonly<{
+    reply: string;
+    matched: boolean;
+    ruleIndex: number | null;
+}>;
+export declare function loadMockLlmRules(path: string): readonly MockLlmRule[];
+export declare function resolveMockLlmReply(rules: readonly MockLlmRule[], prompt: string, warn?: (message: string) => void): MockLlmResolution;

package/dist/src/node-activity-log.d.ts

@@ -0,0 +1,4 @@
+export interface ActivityLogSink {
+    append(line: string): void;
+}
+export declare function createActivityLogSink(baseDir: string, alias: string, now?: () => Date): ActivityLogSink;

package/dist/src/node-clone.d.ts

@@ -0,0 +1,134 @@
+export interface CloneArgs {
+    source: string;
+    target: string;
+    /** Raw --workdir as typed (resolved later against cwd). */
+    workdir?: string;
+    model?: string;
+    start: boolean;
+}
+export type CloneArgsResult = {
+    ok: true;
+    args: CloneArgs;
+} | {
+    ok: false;
+    error: string;
+} | {
+    ok: false;
+    help: true;
+};
+export declare const NODE_CLONE_USAGE = "anet node clone <source> <new-name> [--workdir <dir>] [--model <id>] [--start]\nanet node create <new-name> --from <source> [--workdir <dir>] [--model <id>] [--start]\n\n  Make a new node with the same settings as <source>, under a NEW identity.\n  The clone is registered with the Hub as its own node (new node_id + token);\n  it never shares the source's identity, session, login or logs.\n\n  Copied:      runtime, model, tools, permission flags, prompts, non-secret env,\n               rules file / skills / .mcp.json (with --workdir)\n  Regenerated: node_id, token, session id, co-presence sockets\n  Not copied:  token, sessions/threads, logs, inbox, channel bot credentials,\n               codex auth.json, secret env values (key names are kept)\n\n  --workdir <dir>  Put the clone in another project directory (created if\n                   missing; path must be ASCII). Default: the source's project\n                   directory (the current one), sharing its rules file/skills.\n  --model <id>     Use a different model than the source.\n  --start          Start the clone right after creating it.\n\n  Never copy a node directory with cp -r: the copy keeps the same node_id and\n  token, so the Hub delivers every task to both processes and it runs twice.";
+/**
+ * Parse the tokens after the verb.
+ *   mode "clone":       [<source>, <new>, ...flags]
+ *   mode "create-from": [<new>, ...flags]  with a required --from <source>
+ */
+export declare function parseCloneArgs(tokens: readonly string[], mode: "clone" | "create-from"): CloneArgsResult;
+/** Project rule: node working directories are ASCII (aliases may be Chinese, directories not). */
+export declare function isAsciiPath(p: string): boolean;
+export interface RefusalInput {
+    sourceId: string;
+    sourceProfile: Record<string, any>;
+    target: string;
+    sourceNodeDir: string;
+    targetNodeDir: string;
+    /** Present only when --workdir was given; absolute. */
+    explicitWorkdir?: string;
+}
+/** Every reason to stop before touching the Hub or the disk. null = go. */
+export declare function cloneRefusal(i: RefusalInput): string | null;
+export interface LedgerItem {
+    item: string;
+    note?: string;
+}
+export interface CloneLedger {
+    copied: LedgerItem[];
+    regenerated: LedgerItem[];
+    skipped: LedgerItem[];
+    /** env keys whose value is a secret: the clone references `ref`, which the user must set. */
+    secrets: {
+        key: string;
+        ref: string;
+    }[];
+}
+export declare function emptyLedger(): CloneLedger;
+export interface PlanInput {
+    sourceProfile: Record<string, any>;
+    target: string;
+    newNodeId: string;
+    /** Absolute project directory the clone will live in. */
+    targetWorkdir: string;
+    modelOverride?: string;
+    /** New claude-code-cli session id. */
+    newSession: () => string;
+    /** grok co-presence socket fields for the new node id (grokBuildCliCreationFields). */
+    grokFields?: (nodeId: string) => Record<string, unknown>;
+}
+/** Build the clone's profile (no token yet) and the ledger of what happened to each field. */
+export declare function planCloneProfile(p: PlanInput, ledger?: CloneLedger): {
+    profile: Record<string, any>;
+    ledger: CloneLedger;
+};
+/** Files a codex-home may carry to the clone. Never auth.json, never .anet-copresence.env. */
+export declare const CODEX_HOME_COPY: readonly ["config.toml", "AGENTS.md", "version.json"];
+export declare const CODEX_HOME_COPY_DIRS: readonly ["skills"];
+/** Workdir-level settings copied only when the clone gets its own --workdir. */
+export declare const WORKDIR_COPY_FILES: readonly ["CLAUDE.md", "AGENTS.md"];
+export declare const WORKDIR_COPY_DIRS: readonly [".claude/skills", ".agents/skills", ".grok/skills", ".opencode/skill", ".opencode/skills"];
+/** Recursive copy that never follows symlinks and never copies credential-looking files. Returns files copied. */
+export declare function copyTreeSafe(from: string, to: string, skipped: LedgerItem[], label: string): number;
+/** Strip values from env/headers of every MCP server; drop the commhub entry (regenerated at start). */
+export declare function sanitizeMcpJson(raw: string): {
+    text: string;
+    blanked: string[];
+};
+export interface CopyFilesInput {
+    sourceNodeDir: string;
+    targetNodeDir: string;
+    sourceWorkdir: string;
+    targetWorkdir: string;
+}
+/** Copy the whitelisted on-disk settings. The target node dir must already exist. */
+export declare function copyCloneFiles(i: CopyFilesInput, ledger: CloneLedger): void;
+export interface RunCloneInput {
+    sourceId: string;
+    /** Raw source config.json (as stored, before normalisation). */
+    sourceProfile: Record<string, any>;
+    target: string;
+    sourceNodeDir: string;
+    sourceWorkdir: string;
+    targetWorkdir: string;
+    /** True when the user passed --workdir. */
+    explicitWorkdir: boolean;
+    modelOverride?: string;
+    newNodeId: () => string;
+    newSession: () => string;
+    grokFields?: (nodeId: string) => Record<string, unknown>;
+    /** Hub registration — returns the new node's ntok_. Same endpoint `anet node create` uses. */
+    register: (profile: Record<string, any>) => Promise<string>;
+    /** Write config.json into targetNodeDir (the CLI passes its create writer). */
+    persist: (profile: Record<string, any>, targetNodeDir: string) => void;
+}
+export type RunCloneResult = {
+    ok: true;
+    profile: Record<string, any>;
+    ledger: CloneLedger;
+    targetNodeDir: string;
+} | {
+    ok: false;
+    stage: "refused" | "register" | "write";
+    error: string;
+};
+export declare function runNodeClone(i: RunCloneInput): Promise<RunCloneResult>;
+/** Test/default writer: the same config.json whitelist `anet node create` persists, mode 0600. */
+export declare function defaultClonePersist(profile: Record<string, any>, targetNodeDir: string): void;
+/** The summary table printed after a clone. Never prints a token or a secret value. */
+export declare function formatCloneSummary(r: {
+    source: string;
+    target: string;
+    profile: Record<string, any>;
+    ledger: CloneLedger;
+    targetNodeDir: string;
+    sourceNodeId?: string;
+}): string;
+/** realpath that tolerates a missing path (resolves the nearest existing parent). */
+export declare function realpathLoose(p: string): string;

package/dist/src/node-delete-hub.d.ts

@@ -0,0 +1,42 @@
+export type HubRemoval = 
+/** The Hub had a row with exactly this node_id and deleted it. */
+{
+    kind: "removed";
+    nodeId: string;
+}
+/** No row with this node_id. `otherRows` share the alias but belong to other nodes — untouched. */
+ | {
+    kind: "absent";
+    nodeId: string;
+    otherRows: string[];
+}
+/** Nothing to do on a Hub: no Hub configured, or a legacy config without node_id. */
+ | {
+    kind: "skipped";
+    reason: "no-hub" | "no-node-id";
+}
+/** Unreachable / HTTP error / not logged in. Local deletion still happens; caller exits non-zero. */
+ | {
+    kind: "failed";
+    nodeId: string;
+    reason: string;
+};
+export type HubRemovalInput = {
+    hub?: string;
+    token?: string;
+    nodeId?: string;
+    alias?: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+};
+export declare function removeNodeFromHub(input: HubRemovalInput): Promise<HubRemoval>;
+/** The exact command that retries only the Hub half once the local files are gone. */
+export declare function hubRetryCommand(nodeId: string, hub?: string): string;
+/** Lines to print for a removal result. `warn` lines go to stderr. */
+export declare function describeHubRemoval(r: HubRemoval, ctx: {
+    displayName: string;
+    hub?: string;
+}): {
+    info: string[];
+    warn: string[];
+};

package/dist/src/node-files.d.ts

@@ -0,0 +1,62 @@
+export declare const NODE_FILE_READ_MAX_BYTES: number;
+export declare const NODE_FILES_LIST_MAX = 1000;
+export declare const NODE_FILE_PATH_MAX = 1024;
+/** 回给 hub 的 JSON 最长这么多字符(hub 端 ack 上限相同)。 */
+export declare const NODE_FILES_RESULT_MAX_CHARS: number;
+export type NodeFileType = "dir" | "file" | "symlink" | "other";
+export type HiddenReason = "secret" | "skipped";
+export interface NodeFileEntry {
+    name: string;
+    type: NodeFileType;
+    /** 普通文件的字节数;凭据文件不给。 */
+    size?: number;
+    /** 毫秒时间戳。 */
+    mtime?: number;
+    hidden_reason?: HiddenReason;
+    /** 目录(或指向目录的软链接)不允许进入。 */
+    no_descend?: boolean;
+    /** 软链接:指向工作目录内的什么;指向外面或断链为 null(不透露目标)。 */
+    link_type?: "dir" | "file" | null;
+}
+export interface NodeFilesListResult {
+    path: string;
+    entries: NodeFileEntry[];
+    truncated: boolean;
+    total: number;
+}
+export type NodeFileReadKind = "text" | "binary" | "too_large" | "secret";
+export interface NodeFileReadResult {
+    path: string;
+    name: string;
+    kind: NodeFileReadKind;
+    size?: number;
+    mtime?: number;
+    content?: string;
+    hidden_reason?: HiddenReason;
+}
+/**
+ * 纯函数:一个路径是否属于凭据。
+ *   relPosix —— 相对工作目录(请求的路径,或 realpath 之后相对工作目录的路径)。
+ *   rootAbs  —— 工作目录自身的绝对路径(posix);只作为「祖先目录」参与判定:工作目录本身
+ *               就在 .claude/ .codex/ 之类里面时,里面的一切都算凭据;在 .anet/ 里面时
+ *               config.json* 算凭据。工作目录自己的名字不参与文件名规则。
+ * 任一祖先段(含末段)是凭据目录 → secret;末段按文件名规则判。大小写不敏感(macOS 默认不分大小写)。
+ */
+export declare function secretReasonFor(relPosix: string, rootAbs?: string): "secret" | null;
+/** 纯函数:这个目录能不能进入。凭据目录 → secret;node_modules → skipped;路径上任一段命中同样不行。 */
+export declare function noDescendReasonFor(relPosix: string, rootAbs?: string): HiddenReason | null;
+/** 客户端给的路径 → 规范化相对路径("" = 根)。不合法抛错,错误信息不回显输入。 */
+export declare function normalizeNodeRelPath(raw: unknown): string;
+export interface ResolvedNodePath {
+    rootReal: string;
+    real: string;
+    /** realpath 之后相对根的路径(posix)。 */
+    relReal: string;
+}
+/**
+ * 解析并收在工作目录里:realpath(根) + realpath(根/rel),后者必须在前者之内。
+ * 不存在抛 `not found`;逃出去抛 `outside the work dir`。
+ */
+export declare function resolveInsideWorkDir(workDir: string, rel: string): Promise<ResolvedNodePath>;
+export declare function listNodeFiles(workDir: string, rawPath: unknown): Promise<NodeFilesListResult>;
+export declare function readNodeFile(workDir: string, rawPath: unknown): Promise<NodeFileReadResult>;

package/dist/src/node-locate.d.ts

@@ -0,0 +1,60 @@
+export declare const CHILD_WORKDIRS_FILE = "child-workdirs.json";
+export declare function childWorkdirsPath(root: string): string;
+/** Same reader as agent-node's readChildWorkdirs: only absolute string values count. */
+export declare function readChildWorkdirs(root: string): Record<string, string>;
+/**
+ * Record that `alias`, created from `root`, lives in `workdir`.
+ * Not recorded when `workdir` is `root` itself, or when `aliasTakenHere` — the
+ * host daemon resolves a registered alias to the registered workdir, so an
+ * entry for a name that also exists in `root` would hide the local node from it.
+ */
+export declare function recordChildWorkdir(root: string, alias: string, workdir: string, aliasTakenHere: boolean): boolean;
+/** `<root>/.anet/nodes/<id>` → `<root>`; anything else → null. */
+export declare function rootOfNodeDir(nodeDir: string): string | null;
+/** `node_dir` of every record in the codex login index directory. */
+export declare function codexIndexNodeDirs(indexDir: string): string[];
+/** Every other .anet root the indexes point at, canonical, deduplicated, existing, excluding `cwdRoot`. */
+export declare function otherNodeRoots(cwdRoot: string, codexIndexDir: string): string[];
+export interface NodeMatch {
+    /** Canonical .anet root (the directory to `cd` into). */
+    root: string;
+    /** Directory name under .anet/nodes/. */
+    id: string;
+    nodeId?: string;
+    /** How the ref matched: the directory name, the node_id, or a name/alias field. */
+    how: "dir" | "node_id" | "name";
+}
+export interface ProfileLike {
+    node_id?: string;
+    node_name?: string;
+    name?: string;
+    alias?: string;
+}
+/** All nodes in one root that `ref` names, one entry per node with its strongest match. */
+export declare function matchNodesInRoot(root: string, ref: string, profiles: Array<{
+    id: string;
+    profile: ProfileLike | null;
+}>): NodeMatch[];
+export type DeleteTarget = {
+    kind: "here";
+    match: NodeMatch;
+} | {
+    kind: "elsewhere";
+    match: NodeMatch;
+} | {
+    kind: "ambiguous";
+    matches: NodeMatch[];
+} | {
+    kind: "none";
+};
+/**
+ * Which node `anet node delete <ref>` means.
+ *  - a directory named `ref` in the current root wins outright (the long-standing
+ *    behaviour: the node you are standing next to);
+ *  - otherwise an exact node_id match, if exactly one node has it;
+ *  - otherwise every match across all roots: one ⇒ that node, several ⇒ ambiguous.
+ */
+export declare function decideDeleteTarget(cwdRoot: string, matches: NodeMatch[]): DeleteTarget;
+export declare function deleteCommandFor(m: NodeMatch, force: boolean, quote: (s: string) => string): string;
+export declare function formatDeleteElsewhere(ref: string, m: NodeMatch, force: boolean, quote: (s: string) => string): string[];
+export declare function formatDeleteAmbiguous(ref: string, matches: NodeMatch[], quote: (s: string) => string): string[];

package/dist/src/node-ls-all.d.ts

@@ -0,0 +1,80 @@
+import { type SessionClass } from "./session-status-class";
+export declare const UNKNOWN_HOST = "(unknown host)";
+export type NodeLsAllArgs = {
+    all: boolean;
+    json: boolean;
+    network: string | null;
+    error: string | null;
+};
+/** `--all`, `--json`, `--network <id|name>` (also `--network=<v>`). */
+export declare function parseNodeLsAllArgs(argv: string[]): NodeLsAllArgs;
+export type HubNetwork = {
+    network_id: string;
+    network_name?: string | null;
+    member_role?: string | null;
+};
+export type NetworkPick = {
+    ok: true;
+    network: HubNetwork;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Same matching as `anet network use <name>` (exact id or exact name), plus a unique id prefix
+ * because `anet network ls` prints 12-character id prefixes. Ambiguity is refused, never guessed.
+ */
+export declare function pickNetwork(networks: HubNetwork[], ref: string | null, currentId: string | null | undefined): NetworkPick;
+export type DaemonState = "online" | "offline" | "none-visible" | "unknown";
+export type MachineNode = {
+    alias: string;
+    node_id: string | null;
+    runtime: string | null;
+    status: string | null;
+    status_class: SessionClass;
+    last_seen_at: string | null;
+    model: string | null;
+};
+export type MachineDaemon = {
+    alias: string;
+    online: boolean;
+    last_seen_at: string | null;
+};
+export type MachineGroup = {
+    hostname: string | null;
+    /** online = at least one daemon on this host is online (remote management possible). */
+    daemon: DaemonState;
+    daemons: MachineDaemon[];
+    nodes: MachineNode[];
+};
+/**
+ * @param daemons the Hub's daemon list, or null when it could not be read (state "unknown").
+ *                An empty array means "the Hub showed you none" (state "none-visible").
+ */
+export declare function groupNodesByMachine(sessions: any[], daemons: any[] | null): MachineGroup[];
+/** Compact English age for a table cell. Unparseable → "?", future → "in Ns (clock skew?)". */
+export declare function shortAgo(raw: string | null, nowMs: number): string;
+export type FormatOpts = {
+    network: HubNetwork;
+    nowMs: number;
+    /** why the daemon list could not be read (daemons === null) */
+    daemonsError?: string | null;
+};
+export declare function formatMachineGroups(groups: MachineGroup[], opts: FormatOpts): string[];
+export declare function machineGroupsJson(groups: MachineGroup[], opts: {
+    network: HubNetwork;
+    daemonsError?: string | null;
+}): {
+    machines: {
+        hostname: string | null;
+        daemon: DaemonState;
+        daemons: MachineDaemon[];
+        nodes: MachineNode[];
+    }[];
+    daemons_error?: string | undefined;
+    network: {
+        network_id: string;
+        network_name: string | null;
+    };
+    daemons_readable: boolean;
+};

package/dist/src/node-menu.d.ts

@@ -0,0 +1,40 @@
+import { type CodexMenuNode, type CodexNodeRow, type CollectEnv, type MenuIO, type PlannedCommand, type Runner } from "./codex-menu";
+import { type RuntimeName } from "./normalize-runtime";
+export interface NodeRow {
+    id: string;
+    alias: string;
+    runtime: RuntimeName;
+    /** "running" | "stopped" (codex co-presence may say "partial 1/3"). */
+    state: string;
+    running: boolean;
+    model: string;
+    modelIsDefault: boolean;
+    /** Shared human + agent TUI (grok-build-cli / opencode-cli co-presence, codex-app-server). */
+    copresence: boolean;
+    /** The runtime has a TUI to enter (claude-code-cli, or any co-presence node). */
+    hasTui: boolean;
+    /** Set for codex-sdk / codex-app-server: these go to the #532 codex actions. */
+    codex: CodexNodeRow | null;
+}
+export declare function collectNodeRows(nodes: CodexMenuNode[], env: CollectEnv): NodeRow[];
+export declare function renderNodeTable(rows: NodeRow[], cwd: string): string;
+export declare const NODE_CHEAT_SHEET: string;
+export type NodeAction = "start" | "stop" | "restart" | "attach" | "log" | "model" | "delete";
+export declare function nodeActions(row: NodeRow): {
+    key: NodeAction;
+    label: string;
+}[];
+export declare function planNodeAction(row: NodeRow, action: NodeAction, input?: {
+    model?: string;
+}): PlannedCommand;
+/** Returns the process exit code. Runs at most one command. */
+export declare function nodeMenu(rows: NodeRow[], io: MenuIO, run: Runner, ctx: {
+    cwd: string;
+}): Promise<number>;
+/** Entry from cli.ts (bare `anet node`). Returns the exit code. */
+export declare function runNodeMenu(nodes: CodexMenuNode[], opts: {
+    nodesDir: string;
+    home: string;
+    cwd?: string;
+    usageLine?: string;
+}): Promise<number>;

package/dist/src/node-not-found.d.ts

@@ -0,0 +1 @@
+export declare function nodeNotFoundMessage(ref: string, knownNames: string[], suggestion: string | null): string;