@actiondock/core 2.10.0 → 2.11.0

package/dist/process/quotas.js

@@ -0,0 +1,29 @@
+import { QUOTA_EXCEEDED, ProcessError } from "../errors.js";
+export class ProcessQuotaTracker {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    checkSpawnQuotas(_scope, requestedBufferBytes) {
+        let hostActive = 0;
+        for (const p of this.ctx.processes.values()) {
+            if (p.info.state === "starting" ||
+                p.info.state === "running" ||
+                p.info.state === "stopping") {
+                hostActive += 1;
+            }
+        }
+        if (hostActive >= this.ctx.quotas.maxActiveProcessesPerHost) {
+            throw new ProcessError(QUOTA_EXCEEDED, "Host active process quota exceeded", {
+                limit: this.ctx.quotas.maxActiveProcessesPerHost,
+            });
+        }
+        const perProcBuf = requestedBufferBytes ?? this.ctx.defaultLimits.outputBufferBytes;
+        if (perProcBuf > this.ctx.quotas.maxOutputBufferBytesPerProcess) {
+            throw new ProcessError(QUOTA_EXCEEDED, "Output buffer per process quota exceeded", {
+                requested: perProcBuf,
+                limit: this.ctx.quotas.maxOutputBufferBytesPerProcess,
+            });
+        }
+    }
+}

package/dist/process/run-executor.js

@@ -26,7 +26,6 @@ export class RunExecutor {
                 mode: "pipe",
             },
         };
-        const runProcessId = `run-${crypto.randomUUID()}`;
         const chunks = [];
         let totalBytes = 0;
         let truncated = false;

package/dist/process/terminal-output-cache.d.ts

@@ -1,57 +1,39 @@
 import type { ProcessOutputLog } from "./output-log.js";
 /**
- * 已淘汰输出日志的墓碑信息。
+ * 终态输出日志保留缓存配置选项。
  */
-export interface EvictedOutputTombstone {
-    tailCursor: string;
-    earliestCursor: string;
-    evictedAt: number;
+export interface TerminalOutputCacheOptions {
+    /** 保留时长（毫秒） */
+    retentionMs?: number;
+    /** 宿主输出缓冲区字节总配额 */
+    maxHostBufferBytes?: number;
+    /** 保留日志最大条目数，默认 512 */
+    maxEntries?: number;
 }
 /**
  * 终态输出日志保留缓存。
  *
- * 独立持有已驱逐进程的输出日志缓存与墓碑登记：内存输出无法从持久层恢复，
- * 保留缓存支撑后续游标读取；TTL 过期转墓碑与 LRU 淘汰均保持同步原子。
+ * 维护已退出进程的输出日志，提供基于最大条目数与宿主缓冲总量的有界内存缓存。
  */
 export declare class TerminalOutputCache {
     /** 保留日志最大条目数上限（默认） */
     static readonly DEFAULT_MAX_ENTRIES = 512;
-    /** 墓碑最大登记条数上限（默认） */
-    static readonly DEFAULT_MAX_TOMBSTONES = 2048;
     private readonly entries;
-    private readonly tombstones;
     private readonly retentionMs;
     private readonly maxHostBufferBytes;
     private readonly maxEntries;
-    private readonly maxTombstones;
-    constructor(options: {
-        /** 保留时长（毫秒） */
-        retentionMs: number;
-        /** 宿主输出缓冲区字节总配额 */
-        maxHostBufferBytes: number;
-        /** 保留日志最大条目数，默认 512 */
-        maxEntries?: number;
-        /** 墓碑最大登记条数，默认 2048 */
-        maxTombstones?: number;
-    });
+    private totalBytes;
+    constructor(options?: TerminalOutputCacheOptions);
     /**
-     * 记录已淘汰输出日志的墓碑信息（超出容量时淘汰最旧登记，防止内存无限积压）。
-     */
-    private recordTombstone;
-    /**
-     * 清理已过期的终态输出日志条目并转为墓碑。
+     * 清理已过期的终态输出日志条目。
      */
     private cleanExpired;
     /**
-     * 获取指定进程的墓碑登记信息。
-     */
-    getTombstone(processId: string): EvictedOutputTombstone | undefined;
-    /**
-     * 统计终态保留日志当前在内存中实际占用的输出缓冲字节总数（附带过期清理）。
+     * 统计终态保留日志当前在内存中实际占用的输出缓冲字节总数。
      */
     retainedBytes(): number;
     /**
-     * 将终态输出日志存入保留缓存，并根据宿主配额执行 LRU 与 TTL 淘汰。
+     * 将终态输出日志存入保留缓存，并根据容量上限淘汰旧条目。
      */
     retain(processId: string, log: ProcessOutputLog): void;
     /**
@@ -59,8 +41,12 @@ export declare class TerminalOutputCache {
      */
     get(processId: string): ProcessOutputLog | undefined;
     /**
-     * 按 LRU 顺序逐条淘汰最旧保留日志并转为墓碑，直至剩余保留字节数不超过给定的可容纳上限。
-     * 返回被淘汰条目释放的字节总数，供宿主输出缓冲预算扣减复用。
+     * 按 LRU 顺序逐条淘汰最旧保留日志，直至剩余保留字节数不超过给定的可容纳上限。
+     * 返回被淘汰条目释放的字节总数。
      */
     evictLRUUntil(fits: number): number;
+    /**
+     * 清空所有缓存。
+     */
+    clear(): void;
 }

package/dist/process/terminal-output-cache.js

@@ -1,97 +1,72 @@
 /**
  * 终态输出日志保留缓存。
  *
- * 独立持有已驱逐进程的输出日志缓存与墓碑登记：内存输出无法从持久层恢复，
- * 保留缓存支撑后续游标读取；TTL 过期转墓碑与 LRU 淘汰均保持同步原子。
+ * 维护已退出进程的输出日志，提供基于最大条目数与宿主缓冲总量的有界内存缓存。
  */
 export class TerminalOutputCache {
     /** 保留日志最大条目数上限（默认） */
     static DEFAULT_MAX_ENTRIES = 512;
-    /** 墓碑最大登记条数上限（默认） */
-    static DEFAULT_MAX_TOMBSTONES = 2048;
     entries = new Map();
-    tombstones = new Map();
     retentionMs;
     maxHostBufferBytes;
     maxEntries;
-    maxTombstones;
-    constructor(options) {
-        this.retentionMs = options.retentionMs;
-        this.maxHostBufferBytes = options.maxHostBufferBytes;
+    totalBytes = 0;
+    constructor(options = {}) {
+        this.retentionMs = options.retentionMs ?? 5 * 60 * 1000;
+        this.maxHostBufferBytes = options.maxHostBufferBytes ?? 64 * 1024 * 1024;
         this.maxEntries = options.maxEntries ?? TerminalOutputCache.DEFAULT_MAX_ENTRIES;
-        this.maxTombstones = options.maxTombstones ?? TerminalOutputCache.DEFAULT_MAX_TOMBSTONES;
     }
     /**
-     * 记录已淘汰输出日志的墓碑信息（超出容量时淘汰最旧登记，防止内存无限积压）。
-     */
-    recordTombstone(processId, tombstone) {
-        if (this.tombstones.size >= this.maxTombstones) {
-            const oldestKey = this.tombstones.keys().next().value;
-            if (oldestKey) {
-                this.tombstones.delete(oldestKey);
-            }
-        }
-        this.tombstones.set(processId, tombstone);
-    }
-    /**
-     * 清理已过期的终态输出日志条目并转为墓碑。
+     * 清理已过期的终态输出日志条目。
      */
     cleanExpired() {
+        if (this.retentionMs <= 0)
+            return;
         const now = Date.now();
         for (const [id, entry] of this.entries.entries()) {
-            if (now - entry.evictedAt > this.retentionMs) {
-                this.recordTombstone(id, {
-                    tailCursor: entry.log.tailCursor,
-                    earliestCursor: entry.log.earliestCursor,
-                    evictedAt: now,
-                });
+            if (now - entry.retainedAt > this.retentionMs) {
+                this.totalBytes -= entry.log.currentBytes;
                 this.entries.delete(id);
             }
         }
+        if (this.totalBytes < 0) {
+            this.totalBytes = 0;
+        }
     }
     /**
-     * 获取指定进程的墓碑登记信息。
-     */
-    getTombstone(processId) {
-        return this.tombstones.get(processId);
-    }
-    /**
-     * 统计终态保留日志当前在内存中实际占用的输出缓冲字节总数（附带过期清理）。
+     * 统计终态保留日志当前在内存中实际占用的输出缓冲字节总数。
      */
     retainedBytes() {
         this.cleanExpired();
-        let bytes = 0;
-        for (const entry of this.entries.values()) {
-            bytes += entry.log.currentBytes;
-        }
-        return bytes;
+        return this.totalBytes;
     }
     /**
-     * 将终态输出日志存入保留缓存，并根据宿主配额执行 LRU 与 TTL 淘汰。
+     * 将终态输出日志存入保留缓存，并根据容量上限淘汰旧条目。
      */
     retain(processId, log) {
         this.cleanExpired();
-        // 若新加入条目会导致总输出配额超限或数量超限，按 LRU 顺序淘汰最旧条目
-        while ((this.retainedBytes() + log.currentBytes > this.maxHostBufferBytes ||
-            this.entries.size >= this.maxEntries) &&
-            this.entries.size > 0) {
+        const existing = this.entries.get(processId);
+        if (existing) {
+            this.totalBytes -= existing.log.currentBytes;
+            this.entries.delete(processId);
+        }
+        while (this.entries.size > 0 &&
+            (this.entries.size >= this.maxEntries ||
+                this.totalBytes + log.currentBytes > this.maxHostBufferBytes)) {
             const oldestKey = this.entries.keys().next().value;
             if (!oldestKey)
                 break;
-            const oldestEntry = this.entries.get(oldestKey);
-            if (oldestEntry) {
-                this.recordTombstone(oldestKey, {
-                    tailCursor: oldestEntry.log.tailCursor,
-                    earliestCursor: oldestEntry.log.earliestCursor,
-                    evictedAt: Date.now(),
-                });
+            const oldest = this.entries.get(oldestKey);
+            if (oldest) {
+                this.totalBytes -= oldest.log.currentBytes;
             }
             this.entries.delete(oldestKey);
         }
         this.entries.set(processId, {
             log,
-            evictedAt: Date.now(),
+            retainedAt: Date.now(),
         });
+        this.totalBytes += log.currentBytes;
     }
     /**
      * 获取终态保留日志（附带过期清理与 LRU 触达更新）。
@@ -101,32 +76,36 @@ export class TerminalOutputCache {
         const entry = this.entries.get(processId);
         if (!entry)
             return undefined;
-        // 触达刷新 LRU 顺序
         this.entries.delete(processId);
         this.entries.set(processId, entry);
         return entry.log;
     }
     /**
-     * 按 LRU 顺序逐条淘汰最旧保留日志并转为墓碑，直至剩余保留字节数不超过给定的可容纳上限。
-     * 返回被淘汰条目释放的字节总数，供宿主输出缓冲预算扣减复用。
+     * 按 LRU 顺序逐条淘汰最旧保留日志，直至剩余保留字节数不超过给定的可容纳上限。
+     * 返回被淘汰条目释放的字节总数。
      */
     evictLRUUntil(fits) {
+        this.cleanExpired();
         let evictedBytes = 0;
-        while (this.entries.size > 0 && this.retainedBytes() > fits) {
+        while (this.entries.size > 0 && this.totalBytes > fits) {
             const oldestKey = this.entries.keys().next().value;
             if (!oldestKey)
                 break;
             const oldest = this.entries.get(oldestKey);
             if (oldest) {
-                this.recordTombstone(oldestKey, {
-                    tailCursor: oldest.log.tailCursor,
-                    earliestCursor: oldest.log.earliestCursor,
-                    evictedAt: Date.now(),
-                });
-                evictedBytes += oldest.log.currentBytes;
+                const bytes = oldest.log.currentBytes;
+                this.totalBytes -= bytes;
+                evictedBytes += bytes;
             }
             this.entries.delete(oldestKey);
         }
         return evictedBytes;
     }
+    /**
+     * 清空所有缓存。
+     */
+    clear() {
+        this.entries.clear();
+        this.totalBytes = 0;
+    }
 }

package/dist/profile/index.d.ts

@@ -1,4 +1,3 @@
 export * from "./types.js";
 export * from "./manager.js";
-export * from "./client.js";
-export { toSnakeUpperCase, resolveEnvValue } from "../runtime/env.js";
+export * from "../client/index.js";

package/dist/profile/index.js

@@ -1,4 +1,3 @@
 export * from "./types.js";
 export * from "./manager.js";
-export * from "./client.js";
-export { toSnakeUpperCase, resolveEnvValue } from "../runtime/env.js";
+export * from "../client/index.js";

package/dist/profile/manager.d.ts

@@ -1,12 +1,10 @@
 import type { ProfileEntry, ProfilesConfig, ResolvedTarget, TokenResolutionSource } from "./types.js";
+import { normalizeServerUrl } from "../client/index.js";
+export { normalizeServerUrl };
 /**
  * 默认初始 Profiles 配置（预设 local 本地环境）。
  */
 export declare const DEFAULT_PROFILES_CONFIG: ProfilesConfig;
-/**
- * 格式化并规范化 Server URL 地址（若未指定协议，本地回环地址默认使用 http://，非本地回环地址默认使用 https://，并移除末尾斜杠）。
- */
-export declare function normalizeServerUrl(url: string): string;
 /**
  * 获取 profiles.json 配置文件的物理绝对路径（~/.actiondock/profiles.json）。
  */

package/dist/profile/manager.js

@@ -1,9 +1,10 @@
 import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { toSnakeUpperCase } from "../runtime/env.js";
-import { isLoopbackHost } from "../utils/net.js";
 import { getActionDockHome } from "../utils/index.js";
-import { ActionDockError, INVALID_ARGUMENT } from "../errors.js";
+import { ActionDockError, INVALID_ARGUMENT, PROFILE_NOT_FOUND } from "../errors.js";
+import { normalizeServerUrl } from "../client/index.js";
+export { normalizeServerUrl };
 const PROFILE_NAME_REGEX = /^[a-zA-Z0-9_\-\.]+$/;
 /**
  * 默认初始 Profiles 配置（预设 local 本地环境）。
@@ -17,37 +18,6 @@ export const DEFAULT_PROFILES_CONFIG = {
         },
     },
 };
-/**
- * 格式化并规范化 Server URL 地址（若未指定协议，本地回环地址默认使用 http://，非本地回环地址默认使用 https://，并移除末尾斜杠）。
- */
-export function normalizeServerUrl(url) {
-    let cleaned = url.trim().replace(/\/+$/, "");
-    if (!cleaned || cleaned === "local") {
-        return cleaned;
-    }
-    if (!/^https?:\/\//i.test(cleaned)) {
-        let hostname = cleaned;
-        const slashIdx = hostname.indexOf("/");
-        if (slashIdx !== -1) {
-            hostname = hostname.slice(0, slashIdx);
-        }
-        if (hostname.startsWith("[")) {
-            const endBracket = hostname.indexOf("]");
-            if (endBracket !== -1) {
-                hostname = hostname.slice(1, endBracket);
-            }
-        }
-        else {
-            const colonIdx = hostname.indexOf(":");
-            if (colonIdx !== -1) {
-                hostname = hostname.slice(0, colonIdx);
-            }
-        }
-        const isLoopback = isLoopbackHost(hostname);
-        cleaned = `${isLoopback ? "http" : "https"}://${cleaned}`;
-    }
-    return cleaned;
-}
 /**
  * 获取 profiles.json 配置文件的物理绝对路径（~/.actiondock/profiles.json）。
  */
@@ -141,10 +111,10 @@ export function saveProfiles(data, customHome) {
 export function addProfile(name, entry, customHome) {
     const trimmedName = name.trim();
     if (!trimmedName) {
-        throw new Error("Profile name cannot be empty");
+        throw new ActionDockError(INVALID_ARGUMENT, "Profile name cannot be empty");
     }
     if (!PROFILE_NAME_REGEX.test(trimmedName)) {
-        throw new Error(`Invalid profile name '${trimmedName}'. Profile names may only contain letters, numbers, hyphens, underscores, and dots.`);
+        throw new ActionDockError(INVALID_ARGUMENT, `Invalid profile name '${trimmedName}'. Profile names may only contain letters, numbers, hyphens, underscores, and dots.`);
     }
     const profilesConfig = loadProfiles(customHome);
     const normalizedServer = normalizeServerUrl(entry.serverUrl);
@@ -160,12 +130,12 @@ export function addProfile(name, entry, customHome) {
 export function updateProfile(name, entry, customHome) {
     const trimmedName = name.trim();
     if (!trimmedName) {
-        throw new Error("Profile name cannot be empty");
+        throw new ActionDockError(INVALID_ARGUMENT, "Profile name cannot be empty");
     }
     const profilesConfig = loadProfiles(customHome);
     const existing = profilesConfig.profiles[trimmedName];
     if (!existing) {
-        throw new Error(`Profile '${trimmedName}' not found. Configure it with 'ad profile add ${trimmedName} --server <url>'`);
+        throw new ActionDockError(PROFILE_NOT_FOUND, `Profile '${trimmedName}' not found. Configure it with 'ad profile add ${trimmedName} --server <url>'`);
     }
     const serverUrl = entry.serverUrl ? normalizeServerUrl(entry.serverUrl) : existing.serverUrl;
     profilesConfig.profiles[trimmedName] = {
@@ -194,7 +164,7 @@ export function useProfile(name, customHome) {
     const trimmedName = name.trim();
     const profilesConfig = loadProfiles(customHome);
     if (trimmedName !== "local" && !profilesConfig.profiles[trimmedName]) {
-        throw new Error(`Profile '${trimmedName}' not found. Use 'ad profile list' to see available profiles or 'ad profile add' to register one.`);
+        throw new ActionDockError(PROFILE_NOT_FOUND, `Profile '${trimmedName}' not found. Use 'ad profile list' to see available profiles or 'ad profile add' to register one.`);
     }
     profilesConfig.currentProfile = trimmedName;
     saveProfiles(profilesConfig, customHome);
@@ -298,7 +268,7 @@ export function resolveTarget(options, customHome) {
         }
         const found = profilesConfig.profiles[pName];
         if (!found) {
-            throw new Error(`Profile '${pName}' not found. Configure it with 'ad profile add ${pName} --server <url>'`);
+            throw new ActionDockError(PROFILE_NOT_FOUND, `Profile '${pName}' not found. Configure it with 'ad profile add ${pName} --server <url>'`);
         }
         const resolvedToken = resolveProfileToken(pName, found, options.token);
         const effectiveInsecure = options.insecure !== undefined
@@ -335,7 +305,7 @@ export function resolveTarget(options, customHome) {
         }
         const found = profilesConfig.profiles[pName];
         if (!found) {
-            throw new Error(`Profile '${pName}' (from ACTIONDOCK_PROFILE) not found. Configure it with 'ad profile add ${pName} --server <url>'`);
+            throw new ActionDockError(PROFILE_NOT_FOUND, `Profile '${pName}' (from ACTIONDOCK_PROFILE) not found. Configure it with 'ad profile add ${pName} --server <url>'`);
         }
         const resolvedToken = resolveProfileToken(pName, found, options?.token);
         const effectiveInsecure = options?.insecure !== undefined

package/dist/profile/types.d.ts

@@ -1,3 +1,4 @@
+export type { RemoteHealthResult } from "../client/index.js";
 /**
  * 单个远端配置环境（Profile）实体定义。
  */
@@ -48,20 +49,3 @@ export interface ResolvedTarget {
     /** 是否允许向非回环地址发送明文 HTTP 请求 */
     allowInsecureHttp?: boolean;
 }
-/**
- * 远端服务器健康探测与时延检测结果。
- */
-export interface RemoteHealthResult {
-    /** 服务端是否连通且鉴权成功 */
-    ok: boolean;
-    /** 服务端状态标识（如 "ok"） */
-    status?: string;
-    /** 远端 ActionDock 版本号 */
-    version?: string;
-    /** 远端服务运行时间（秒） */
-    uptime?: number;
-    /** 网络往返延迟（毫秒） */
-    latencyMs: number;
-    /** 探测失败时的错误信息 */
-    error?: string;
-}

package/dist/project/digest.d.ts

@@ -1,6 +1,10 @@
 /**
  * 解析 JSON 文本并在检测到重复键时抛出错误。
- * 遵循 RFC 8785 清单校验规范：解析阶段必须率先拦截并拒绝重复键。
+ * 遵循 RFC 8785 清单校验规范:解析阶段必须率先拦截并拒绝重复键。
+ *
+ * 实现策略:JSON.parse 主解析 + 轻量键名扫描器做重复键检测。
+ * 扫描器以状态机遍历原始文本,仅在对象键位置(冒号前的字符串字面量)记录键名,
+ * 同一对象层级内出现重复键名即抛错;字符串内部与转义字符不参与键名提取。
  */
 export declare function parseJsonWithoutDuplicates<T = unknown>(jsonText: string): T;
 /**