@actiondock/core 2.5.0 → 2.6.0

package/dist/target/sse-parser.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 手写 SSE（Server-Sent Events）流解析器。
+ *
+ * 职责单一：将远端字节流增量解析为 SSE 消息，完整承载协议细节：
+ * - 跨 chunk 行分隔符缓冲（行尾 \r 需暂存等待下个 chunk 判定是否为 \r\n）
+ * - 兼容 \n、\r 与 \r\n 三种行分隔符
+ * - 冒号字段解析（冒号后单空格剔除，其余空格原样保留）
+ * - 注释行（冒号开头）忽略与未知字段忽略
+ * - 多行 data 按换行拼接合并
+ * - 含空字符的非法事件标识忽略
+ * - 流结束时未以空行收尾的剩余事件兜底分发
+ *
+ * 本模块为纯流转换函数，不感知 HTTP 传输、候选路由与 ActionDock 事件语义，
+ * 可独立单测；底层流在提前退出（break/异常/中止）时防御性取消，避免连接泄漏。
+ */
+/**
+ * SSE 消息解析结果。
+ */
+export interface SseMessage {
+    /** 事件类型（未声明时缺省 message） */
+    event: string;
+    /** 事件标识（含空字符的非法标识会被忽略，保持 undefined） */
+    id?: string;
+    /** 多行 data 按换行拼接后的完整数据载荷 */
+    data: string;
+}
+/**
+ * 将 SSE 字节流增量解析为 SSE 消息。
+ *
+ * @param body 远端响应字节流
+ * @param options.signal 外部取消信号：中止后立即停止读取，不进行剩余事件兜底分发
+ */
+export declare function parseSseMessages(body: ReadableStream<Uint8Array>, options?: {
+    signal?: AbortSignal;
+}): AsyncGenerator<SseMessage>;

package/dist/target/sse-parser.js

@@ -0,0 +1,163 @@
+/**
+ * 手写 SSE（Server-Sent Events）流解析器。
+ *
+ * 职责单一：将远端字节流增量解析为 SSE 消息，完整承载协议细节：
+ * - 跨 chunk 行分隔符缓冲（行尾 \r 需暂存等待下个 chunk 判定是否为 \r\n）
+ * - 兼容 \n、\r 与 \r\n 三种行分隔符
+ * - 冒号字段解析（冒号后单空格剔除，其余空格原样保留）
+ * - 注释行（冒号开头）忽略与未知字段忽略
+ * - 多行 data 按换行拼接合并
+ * - 含空字符的非法事件标识忽略
+ * - 流结束时未以空行收尾的剩余事件兜底分发
+ *
+ * 本模块为纯流转换函数，不感知 HTTP 传输、候选路由与 ActionDock 事件语义，
+ * 可独立单测；底层流在提前退出（break/异常/中止）时防御性取消，避免连接泄漏。
+ */
+/**
+ * 将 SSE 字节流增量解析为 SSE 消息。
+ *
+ * @param body 远端响应字节流
+ * @param options.signal 外部取消信号：中止后立即停止读取，不进行剩余事件兜底分发
+ */
+export async function* parseSseMessages(body, options) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let eventType = "message";
+    let eventId;
+    let dataLines = [];
+    function dispatchCurrentEvent() {
+        if (dataLines.length === 0) {
+            eventType = "message";
+            eventId = undefined;
+            dataLines = [];
+            return undefined;
+        }
+        const dataStr = dataLines.join("\n");
+        const currentType = eventType;
+        const currentId = eventId;
+        eventType = "message";
+        eventId = undefined;
+        dataLines = [];
+        if (!dataStr) {
+            return undefined;
+        }
+        return {
+            event: currentType,
+            id: currentId,
+            data: dataStr,
+        };
+    }
+    function processLine(line) {
+        // 遇到空行分发事件
+        if (line === "") {
+            return dispatchCurrentEvent();
+        }
+        // 以冒号开头的为注释忽略
+        if (line.startsWith(":")) {
+            return undefined;
+        }
+        let field = line;
+        let value = "";
+        const colonIdx = line.indexOf(":");
+        if (colonIdx !== -1) {
+            field = line.slice(0, colonIdx);
+            const rawVal = line.slice(colonIdx + 1);
+            value = rawVal.startsWith(" ") ? rawVal.slice(1) : rawVal;
+        }
+        if (field === "event") {
+            eventType = value;
+        }
+        else if (field === "data") {
+            dataLines.push(value);
+        }
+        else if (field === "id") {
+            if (!value.includes("\0")) {
+                eventId = value;
+            }
+        }
+        return undefined;
+    }
+    try {
+        while (true) {
+            if (options?.signal?.aborted)
+                break;
+            const { done, value } = await reader.read();
+            if (value) {
+                buffer += decoder.decode(value, { stream: !done });
+            }
+            else if (done) {
+                buffer += decoder.decode();
+            }
+            let pos = 0;
+            while (pos < buffer.length) {
+                const cr = buffer.indexOf("\r", pos);
+                const lf = buffer.indexOf("\n", pos);
+                let nextSepPos = -1;
+                let sepLen = 0;
+                if (cr !== -1 && (lf === -1 || cr < lf)) {
+                    if (cr === buffer.length - 1) {
+                        if (!done) {
+                            // 遇到未完结的 \r 暂存等待下个 chunk
+                            break;
+                        }
+                        else {
+                            nextSepPos = cr;
+                            sepLen = 1;
+                        }
+                    }
+                    else {
+                        if (buffer[cr + 1] === "\n") {
+                            nextSepPos = cr;
+                            sepLen = 2;
+                        }
+                        else {
+                            nextSepPos = cr;
+                            sepLen = 1;
+                        }
+                    }
+                }
+                else if (lf !== -1 && (cr === -1 || lf < cr)) {
+                    nextSepPos = lf;
+                    sepLen = 1;
+                }
+                else {
+                    break;
+                }
+                const line = buffer.slice(pos, nextSepPos);
+                pos = nextSepPos + sepLen;
+                const evt = processLine(line);
+                if (evt)
+                    yield evt;
+            }
+            buffer = buffer.slice(pos);
+            if (done) {
+                if (buffer.length > 0) {
+                    const line = buffer;
+                    buffer = "";
+                    const evt = processLine(line);
+                    if (evt)
+                        yield evt;
+                }
+                // 流读取完成时若有剩余待分发事件则进行分发
+                const remainingEvt = dispatchCurrentEvent();
+                if (remainingEvt)
+                    yield remainingEvt;
+                break;
+            }
+        }
+    }
+    finally {
+        // 防御性取消底层流：仅 releaseLock 会让连接保持挂起，造成连接泄漏
+        try {
+            await reader.cancel();
+        }
+        catch {
+            // 流已自然结束或已被取消时忽略次级异常
+        }
+        try {
+            reader.releaseLock();
+        }
+        catch { }
+    }
+}

package/dist/target/target.js

@@ -29,6 +29,8 @@ export async function createActionDockTarget(options = {}) {
     const host = await createActionDockHost({
         scanLinkedPackages: localOpts.scanLinkedPackages ?? true,
         ...localOpts,
+        // CLI 查询命令缺省旁观打开；显式声明 recoverOrphans 的执行命令透传持有者语义
+        recoverOrphans: localOpts.recoverOrphans === true,
         ...(localOpts.hostOptions || {}),
     });
     return new LocalActionDockTarget(host);

package/dist/target/types.d.ts

@@ -202,6 +202,12 @@ export interface LocalTargetOptions {
     scanLinkedPackages?: boolean;
     /** 运行时平台适配 */
     platform?: RuntimePlatform;
+    /**
+     * 是否以数据目录持有者身份打开本地存储：true 时 App 存储在打开阶段收割
+     * 遗留非终态运行记录。默认 false（旁观查询语义），供 CLI 查询命令与
+     * 运行中的 serve 进程并发访问同一库文件。
+     */
+    recoverOrphans?: boolean;
 }
 /**
  * 远程 Target 初始化选项。

package/dist/utils/index.d.ts

@@ -1,3 +1,4 @@
+export { isLoopbackHost } from "./net.js";
 /**
  * 跨运行时安全查找可执行文件绝对物理路径。
  *

package/dist/utils/index.js

@@ -1,6 +1,7 @@
 import { existsSync, realpathSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, delimiter, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+export { isLoopbackHost } from "./net.js";
 /**
  * 跨运行时安全查找可执行文件绝对物理路径。
  *

package/dist/utils/net.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 检查指定的主机地址是否为本地回环接口（Loopback Host）。
+ * 支持 127.0.0.1, localhost, ::1 等形式。
+ *
+ * 本函数为跨域通用谓词单一事实源：客户端域（profile）与服务端域（server）
+ * 共同引用，故置于 utils 通用层；server/security.ts 保留 re-export 兼容旧引用路径。
+ *
+ * @param host 主机名或 IP 字符串
+ */
+export declare function isLoopbackHost(host: string): boolean;

package/dist/utils/net.js

@@ -0,0 +1,16 @@
+/**
+ * 检查指定的主机地址是否为本地回环接口（Loopback Host）。
+ * 支持 127.0.0.1, localhost, ::1 等形式。
+ *
+ * 本函数为跨域通用谓词单一事实源：客户端域（profile）与服务端域（server）
+ * 共同引用，故置于 utils 通用层；server/security.ts 保留 re-export 兼容旧引用路径。
+ *
+ * @param host 主机名或 IP 字符串
+ */
+export function isLoopbackHost(host) {
+    const trimmed = host.trim().toLowerCase().replace(/^\[|\]$/g, "");
+    return (trimmed === "127.0.0.1" ||
+        trimmed === "::1" ||
+        trimmed === "localhost" ||
+        trimmed === "0:0:0:0:0:0:0:1");
+}

package/dist/version.d.ts

@@ -1,4 +1,4 @@
 /**
  * ActionDock 核心版本号单一事实源。
  */
-export declare const ACTIONDOCK_VERSION = "2.5.0";
+export declare const ACTIONDOCK_VERSION = "2.6.0";

package/dist/version.js

@@ -1,4 +1,4 @@
 /**
  * ActionDock 核心版本号单一事实源。
  */
-export const ACTIONDOCK_VERSION = "2.5.0";
+export const ACTIONDOCK_VERSION = "2.6.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/core",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "ActionDock Core Engine - Project loader, runtime execution, SQLite storage, standalone builder, and skill exporter",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,7 +29,7 @@
     "test": "node ../../scripts/run-tests.ts"
   },
   "dependencies": {
-    "@actiondock/sdk": "^2.5.0",
+    "@actiondock/sdk": "^2.6.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1"
   },