@actiondock/core 2.0.11 → 2.2.0

package/dist/filter/intent.js

@@ -0,0 +1,123 @@
+/**
+ * 安全地将模式字符串、数组或现有正则编译为不区分大小写的 RegExp 正则表达式。
+ * 若正则语法不合法，自动对特殊字符进行转义并降级为字面量匹配正则，保证零 Crash。
+ *
+ * @param intent 意图关键词、正则或数组
+ */
+export function compileIntentRegex(intent) {
+    if (!intent)
+        return null;
+    if (intent instanceof RegExp)
+        return intent;
+    let patternStr;
+    if (Array.isArray(intent)) {
+        const valid = intent.map((s) => s.trim()).filter(Boolean);
+        if (valid.length === 0)
+            return null;
+        patternStr = valid.join("|");
+    }
+    else {
+        patternStr = intent.trim();
+        if (!patternStr)
+            return null;
+    }
+    try {
+        return new RegExp(patternStr, "i");
+    }
+    catch {
+        const escaped = patternStr.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        return new RegExp(escaped, "i");
+    }
+}
+/**
+ * 递归检查某个值（包括嵌套的数组或对象结构）是否匹配给定的正则表达式。
+ *
+ * @param value 待检测的任意数据类型
+ * @param regex 正则表达式
+ */
+export function matchIntent(value, regex) {
+    if (value === undefined || value === null)
+        return false;
+    if (typeof value === "string") {
+        return regex.test(value);
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return regex.test(String(value));
+    }
+    if (Array.isArray(value)) {
+        for (const elem of value) {
+            if (matchIntent(elem, regex))
+                return true;
+        }
+        return false;
+    }
+    if (typeof value === "object") {
+        try {
+            return regex.test(JSON.stringify(value));
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+/**
+ * Filters a collection of items based on an intent pattern across specified extractor functions.
+ * Returns detailed result including whether a fallback was triggered when 0 items matched.
+ */
+export function filterWithFallbackInfo(items, intent, extractors, fallback = true) {
+    if (!intent) {
+        return {
+            items,
+            isFallback: false,
+            matchedCount: items.length,
+        };
+    }
+    const regex = compileIntentRegex(intent);
+    if (!regex) {
+        return {
+            items,
+            isFallback: false,
+            matchedCount: items.length,
+        };
+    }
+    const defaultExtractors = [
+        (item) => typeof item === "string"
+            ? item
+            : item?.id || item?.name || item?.key || String(item),
+    ];
+    const effectiveExtractors = extractors && extractors.length > 0 ? extractors : defaultExtractors;
+    const matched = items.filter((item) => {
+        for (const extractor of effectiveExtractors) {
+            try {
+                const val = extractor(item);
+                if (matchIntent(val, regex)) {
+                    return true;
+                }
+            }
+            catch {
+                // Ignore extraction error
+            }
+        }
+        return false;
+    });
+    if (matched.length === 0 && fallback) {
+        return {
+            items,
+            isFallback: true,
+            matchedCount: 0,
+        };
+    }
+    return {
+        items: matched,
+        isFallback: false,
+        matchedCount: matched.length,
+    };
+}
+/**
+ * Filters a collection of items based on an intent pattern across specified extractor functions.
+ * When fallback is enabled (default), returns the full list if no items match the intent.
+ */
+export function filterByIntent(items, intent, extractors, fallback = true) {
+    return filterWithFallbackInfo(items, intent, extractors, fallback).items;
+}

package/dist/host/host.d.ts

@@ -0,0 +1,55 @@
+import type { ActionRef, ExecutionEvent, ExecutionResult, JsonValue, RunRecord } from "@actiondock/sdk";
+import type { ActionDockApp, ActionSpec, ActionSummary, ListActionsOptions, PackageInfo, PlaybookSpec, PlaybookSummary } from "../app/types.js";
+import type { CancelResult, ExecuteOptions, ExecutionTicket } from "../execution/types.js";
+import type { ActionDockHost, ActionDockHostOptions } from "./types.js";
+/**
+ * ActionDock 统一多包宿主容器默认实现。
+ * 负责聚合与调度多个 ActionDockApp 实例，提供跨包引用路由、依赖声明校验与资源配额控制。
+ */
+export declare class DefaultActionDockHost implements ActionDockHost {
+    readonly hostSessionId: string;
+    private apps;
+    private readonly internallyCreatedApps;
+    private activeSubRunsPerRoot;
+    private hostPublicPackageIds;
+    private resolver?;
+    private maxCallDepth;
+    private maxSubRuns;
+    private eventSink;
+    private isClosed;
+    private dataDirLock?;
+    private failedLinkedPackages;
+    constructor(options?: ActionDockHostOptions);
+    private resolvePackageContext;
+    private bindApp;
+    getApp(packageId: string): ActionDockApp | undefined;
+    listApps(): ActionDockApp[];
+    private registerAppInternal;
+    registerApp(app: ActionDockApp): void;
+    info(): Promise<PackageInfo[]>;
+    listActions(options?: ListActionsOptions): Promise<ActionSummary[]>;
+    describeAction(ref: ActionRef | string): Promise<ActionSpec>;
+    listPlaybooks(): Promise<PlaybookSummary[]>;
+    describePlaybook(id: string): Promise<PlaybookSpec>;
+    runAction(ref: ActionRef | string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionResult>;
+    startAction(ref: ActionRef | string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionTicket>;
+    getRun(runId: string): Promise<RunRecord | undefined>;
+    cancelRun(runId: string, reason?: string): Promise<CancelResult>;
+    events(runId: string, options?: {
+        after?: number | string;
+        signal?: AbortSignal;
+        maxQueueSize?: number;
+    }): AsyncIterable<ExecutionEvent>;
+    /**
+     * 优雅关闭宿主容器。
+     * 仅对内部创建的 App 实例执行 close 并安全释放底层资源；
+     * 外部传入借用的 App 实例生命周期完全由调用方负责管理，Host 关闭时仅解绑引用并清理自身内部实例。
+     */
+    close(options?: {
+        graceMs?: number;
+    }): Promise<void>;
+}
+/**
+ * 工厂函数：创建并初始化 ActionDockHost 宿主容器。
+ */
+export declare function createActionDockHost(options?: ActionDockHostOptions): Promise<ActionDockHost>;