@actiondock/core 2.0.11 → 2.0.12

package/dist/build/templates.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 构建时 Action 导入映射。
+ */
+export interface ActionImport {
+    /** Action 唯一标识符 */
+    id: string;
+    /** Action 源码文件物理路径 */
+    filePath: string;
+}
+/**
+ * 动态生成 Standalone 独立可执行文件的 TypeScript 入口文件源码。
+ *
+ * @param packageId 所属 Package ID
+ * @param version 版本号
+ * @param description 描述
+ * @param actions 待打包 Action 列表
+ * @param configDefs 声明的配置定义字典
+ */
+export declare function generateStandaloneEntrypoint(packageId: string, version: string, description: string | undefined, actions: ActionImport[], configDefs?: Record<string, unknown>): string;

package/dist/catalog/action-index.d.ts

@@ -0,0 +1,9 @@
+import type { CatalogSnapshot, IndexedAction } from "./types";
+export declare class ActionIndex {
+    private actions;
+    constructor(snapshot: CatalogSnapshot);
+    private indexSnapshot;
+    private add;
+    list(packageId?: string): IndexedAction[];
+    find(actionId: string, packageId?: string): IndexedAction[];
+}

package/dist/catalog/action-resolver.d.ts

@@ -0,0 +1,20 @@
+import type { ActionRef, ResolvedActionRef } from "@actiondock/sdk";
+import { ActionIndex } from "./action-index";
+import type { CatalogSnapshot, IndexedAction } from "./types";
+export interface ResolveOptions {
+    currentPackageId?: string;
+}
+export declare class ActionResolver {
+    private snapshot;
+    private index;
+    constructor(snapshot: CatalogSnapshot, index?: ActionIndex);
+    /**
+     * 解析字符串或 ActionRef 为规范化的 ActionRef。
+     * 支持 greet、my-tools/greet、@team/github/issues.list。
+     */
+    static parseRef(refStringOrObj: string | ActionRef): ActionRef;
+    resolve(refStringOrObj: string | ActionRef, options?: ResolveOptions): {
+        resolved: ResolvedActionRef;
+        action: IndexedAction;
+    };
+}

package/dist/catalog/location-registry.d.ts

@@ -0,0 +1,15 @@
+import type { LocationLink, LocationRegistryData } from "./types";
+export declare class LocationRegistry {
+    private customHome?;
+    private filePath;
+    constructor(customHome?: string);
+    getFilePath(): string;
+    load(): LocationRegistryData;
+    save(data: LocationRegistryData): void;
+    addLink(path: string, options?: {
+        type?: "package" | "workspace";
+        depth?: number;
+    }): LocationLink;
+    removeLink(targetPathOrId: string): LocationLink | null;
+    prune(): LocationLink[];
+}

package/dist/catalog/package-catalog.d.ts

@@ -0,0 +1,7 @@
+import { LocationRegistry } from "./location-registry";
+import type { CatalogSnapshot } from "./types";
+export declare class PackageCatalog {
+    private registry;
+    constructor(registry?: LocationRegistry);
+    buildSnapshot(cwd?: string): CatalogSnapshot;
+}

package/dist/catalog/types.d.ts

@@ -0,0 +1,68 @@
+import type { ActionContract } from "@actiondock/sdk";
+import type { ProjectConfig } from "../project/types";
+/**
+ * 注册的位置条目类型。
+ */
+export type LocationType = "package" | "workspace";
+/**
+ * 位置注册表中的单条链接记录。
+ */
+export interface LocationLink {
+    /** 位置类型：单包或工作区 */
+    type: LocationType;
+    /** 目录绝对物理路径 */
+    path: string;
+    /** 注册时间（ISO 8601） */
+    linkedAt: string;
+    /** 扫描最大深度（工作区模式有效，默认 3） */
+    depth?: number;
+}
+/**
+ * 物理位置注册表文件（~/.actiondock/registry.json）格式。
+ */
+export interface LocationRegistryData {
+    schemaVersion: 1;
+    links: LocationLink[];
+}
+/**
+ * 解析后的包实例快照。
+ */
+export interface CatalogPackageEntry {
+    /** 逻辑包标识 */
+    id: string;
+    /** 包物理实例唯一标识 */
+    packageInstanceId: string;
+    /** 项目根目录绝对路径 */
+    projectRoot: string;
+    /** 项目配置 */
+    config: ProjectConfig;
+    /** 是否来自工作区自动发现 */
+    isWorkspaceChild?: boolean;
+}
+/**
+ * 运行时目录与包快照。
+ */
+export interface CatalogSnapshot {
+    /** 快照代次唯一标识 */
+    generationId: string;
+    /** 生成快照时间 */
+    createdAt: string;
+    /** 已发现的包集合（按 packageId 索引） */
+    packages: Map<string, CatalogPackageEntry>;
+}
+/**
+ * 索引中的 Action 描述符。
+ */
+export interface IndexedAction {
+    /** 所属逻辑包 ID */
+    packageId: string;
+    /** 动作 ID */
+    actionId: string;
+    /** 契约元数据 */
+    contract: ActionContract;
+    /** 实现入口相对路径 */
+    entry: string;
+    /** 包根目录绝对路径 */
+    projectRoot: string;
+}
+export type { ModuleLoader } from "../runtime/module-loader";

package/dist/doctor/doctor.d.ts

@@ -0,0 +1,6 @@
+import type { DoctorReport } from "./types";
+export declare function runDoctorChecks(options?: {
+    cwd?: string;
+    packageIdOrPath?: string;
+    customHome?: string;
+}): Promise<DoctorReport>;

package/dist/doctor/types.d.ts

@@ -0,0 +1,23 @@
+export type CheckStatus = "ok" | "warn" | "error";
+export interface DoctorCheckItem {
+    id: string;
+    category: "runtime" | "storage" | "registry" | "project";
+    name: string;
+    status: CheckStatus;
+    message: string;
+    detail?: string;
+    fix?: string;
+}
+export interface DoctorReport {
+    ok: boolean;
+    hasProject: boolean;
+    projectRoot?: string;
+    packageId?: string;
+    summary: {
+        total: number;
+        ok: number;
+        warn: number;
+        error: number;
+    };
+    checks: DoctorCheckItem[];
+}

package/dist/execution/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export { DefaultExecutionService, DefaultExecutionService as ExecutionService, type ExecutionServiceOptions, } from "./service";

package/dist/execution/service.d.ts

@@ -0,0 +1,74 @@
+import type { ActionDefinition, ActionRef, ExecutionEvent, ExecutionResult, JsonValue, Logger, ProcessAPI, RunRecord } from "@actiondock/sdk";
+import type { ProjectConfig } from "../project/types";
+import type { Clock } from "../runtime/clock";
+import { type EventSink } from "../runtime/events";
+import { ActionRunner, type ExecutionHandle } from "../runtime/runner";
+import type { RuntimeStorage } from "../storage/types";
+import type { CancelResult, ExecuteOptions, ExecutionService, ExecutionTicket } from "./types";
+export interface ExecutionServiceOptions {
+    packageId: string;
+    storage: RuntimeStorage;
+    globalStorage?: RuntimeStorage;
+    projectRoot?: string;
+    projectConfig?: ProjectConfig;
+    configOverrides?: Record<string, unknown>;
+    actions?: Map<string, ActionDefinition>;
+    process?: ProcessAPI;
+    clock?: Clock;
+    logger?: Logger;
+    eventSink?: EventSink;
+    maxActiveRuns?: number;
+    maxCallDepth?: number;
+    maxSubRuns?: number;
+    ownerId?: string;
+    actionResolver?: (ref: ActionRef | string) => ActionDefinition | undefined | Promise<ActionDefinition | undefined>;
+    getStorageForPackage?: (packageId: string, projectRoot?: string) => RuntimeStorage;
+    packageContextResolver?: (packageId: string) => Promise<{
+        projectRoot?: string;
+        projectConfig?: ProjectConfig;
+        storage: RuntimeStorage;
+        actions?: Map<string, ActionDefinition>;
+    } | undefined> | {
+        projectRoot?: string;
+        projectConfig?: ProjectConfig;
+        storage: RuntimeStorage;
+        actions?: Map<string, ActionDefinition>;
+    } | undefined;
+    customHome?: string;
+}
+/**
+ * 统一执行协调服务实现。
+ */
+export declare class DefaultExecutionService implements ExecutionService {
+    private packageId;
+    private storage;
+    private projectConfig?;
+    private eventSink;
+    private maxActiveRuns;
+    private ownerId;
+    private _runner;
+    private logger?;
+    private clock?;
+    private actionResolver?;
+    private activeRuns;
+    private isClosing;
+    constructor(options: ExecutionServiceOptions);
+    get runner(): ActionRunner;
+    registerAction(action: ActionDefinition): void;
+    getAction(id: string): ActionDefinition | undefined;
+    listActions(): ActionDefinition[];
+    getActiveHandle(runId: string): ExecutionHandle | undefined;
+    private resolveTargetAction;
+    execute(ref: ActionRef | string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionResult>;
+    start(ref: ActionRef | string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionTicket>;
+    get(runId: string): Promise<RunRecord | undefined>;
+    cancel(runId: string, reason?: string): Promise<CancelResult>;
+    events(runId: string, options?: {
+        after?: number;
+        signal?: AbortSignal;
+    }): AsyncIterable<ExecutionEvent>;
+    close(options?: {
+        graceMs?: number;
+    }): Promise<void>;
+}
+export { DefaultExecutionService as ExecutionService };

package/dist/execution/types.d.ts

@@ -0,0 +1,74 @@
+import type { ActionRef, ExecutionEvent, ExecutionResult, JsonValue, Logger, ProcessAPI, ProgressReporter, RunRecord, RunStatus } from "@actiondock/sdk";
+/**
+ * 执行参数选项。
+ */
+export interface ExecuteOptions {
+    /** 外部取消信号 */
+    signal?: AbortSignal;
+    /** 超时时间（毫秒） */
+    timeoutMs?: number;
+    /** 配置临时覆盖字典 */
+    config?: Record<string, JsonValue>;
+    /** 父运行 ID */
+    parentRunId?: string;
+    /** 根运行 ID */
+    rootRunId?: string;
+    /** 最大调用嵌套深度限制 */
+    maxCallDepth?: number;
+    /** 外部日志注入 */
+    logger?: Logger;
+    /** 外部进度报告器注入 */
+    progress?: ProgressReporter;
+    /** 外部进程执行器注入 */
+    process?: ProcessAPI;
+}
+/**
+ * 异步任务执行票据。
+ */
+export interface ExecutionTicket {
+    /** 运行标识 */
+    runId: string;
+    /** 当前状态 */
+    status: RunStatus;
+    /** 任务终态结果 Promise（用于需要异步等待执行结果的场景） */
+    result?: Promise<ExecutionResult>;
+}
+/**
+ * 取消操作结果枚举。
+ */
+export type CancelResult = {
+    outcome: "requested";
+    runId: string;
+} | {
+    outcome: "already_terminal";
+    runId: string;
+    status: RunStatus;
+} | {
+    outcome: "not_found";
+    runId: string;
+} | {
+    outcome: "not_owner";
+    runId: string;
+};
+/**
+ * 统一执行协调服务接口。
+ */
+export interface ExecutionService {
+    /** 同步执行 Action 并等待终态结果 */
+    execute(ref: ActionRef | string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionResult>;
+    /** 异步启动 Action 并立即返回任务票据 */
+    start(ref: ActionRef | string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionTicket>;
+    /** 根据 ID 获取运行记录 */
+    get(runId: string): Promise<RunRecord | undefined>;
+    /** 取消指定的在运行任务 */
+    cancel(runId: string, reason?: string): Promise<CancelResult>;
+    /** 订阅执行事件流 */
+    events(runId: string, options?: {
+        after?: number;
+        signal?: AbortSignal;
+    }): AsyncIterable<ExecutionEvent>;
+    /** 优雅关闭服务并等待活跃任务收尾 */
+    close(options?: {
+        graceMs?: number;
+    }): Promise<void>;
+}

package/dist/export/templates.d.ts

@@ -0,0 +1,33 @@
+import type { ActionDefinition } from "@actiondock/sdk";
+import type { PlaybookDefinition, ProjectConfig } from "../project/types";
+export declare function generateSourceSkillMd(config: ProjectConfig, actions: ActionDefinition[], playbooks: PlaybookDefinition[]): string;
+export declare function generateStandaloneSkillMd(config: ProjectConfig, actions: ActionDefinition[], playbooks: PlaybookDefinition[], binaryRelPath?: string): string;
+export declare function generateSkillMd(config: ProjectConfig, actions: ActionDefinition[], playbooks: PlaybookDefinition[], optionsOrBinaryPath?: string | {
+    mode?: "source" | "standalone";
+    binaryRelPath?: string;
+}): string;
+export interface CompositeSkillPackageInfo {
+    config: ProjectConfig;
+    actions: Array<{
+        id: string;
+        description?: string;
+    }>;
+    playbooks: Array<{
+        id: string;
+        name?: string;
+        description?: string;
+        filePath: string;
+    }>;
+    packageDir: string;
+}
+/**
+ * 生成多包聚合的复合模式 SKILL.md 文档。
+ */
+export declare function generateCompositeSkillMd(bundleName: string, description: string, packages: CompositeSkillPackageInfo[]): string;
+export interface GenerateSkillJsonOptions {
+    mode?: "source" | "standalone";
+    executable?: string;
+    target?: string;
+    playbooks?: PlaybookDefinition[];
+}
+export declare function generateSkillJson(config: ProjectConfig, actions: ActionDefinition[], binaryNameOrOptions?: string | GenerateSkillJsonOptions, target?: string, playbooksList?: PlaybookDefinition[]): string;

package/dist/filter/intent.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 从对象中提取待过滤字段的提取器函数类型。
+ */
+export type Extractor<T> = (item: T) => unknown;
+/**
+ * 安全地将模式字符串、数组或现有正则编译为不区分大小写的 RegExp 正则表达式。
+ * 若正则语法不合法，自动对特殊字符进行转义并降级为字面量匹配正则，保证零 Crash。
+ *
+ * @param intent 意图关键词、正则或数组
+ */
+export declare function compileIntentRegex(intent?: string | string[] | RegExp | null): RegExp | null;
+/**
+ * 递归检查某个值（包括嵌套的数组或对象结构）是否匹配给定的正则表达式。
+ *
+ * @param value 待检测的任意数据类型
+ * @param regex 正则表达式
+ */
+export declare function matchIntent(value: unknown, regex: RegExp): boolean;
+export interface FilterResult<T> {
+    items: T[];
+    isFallback: boolean;
+    matchedCount: number;
+}
+/**
+ * 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 declare function filterWithFallbackInfo<T>(items: T[], intent?: string | string[] | RegExp | null, extractors?: Extractor<T>[], fallback?: boolean): FilterResult<T>;
+/**
+ * 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 declare function filterByIntent<T>(items: T[], intent?: string | string[] | RegExp | null, extractors?: Extractor<T>[], fallback?: boolean): T[];

package/{src/index.ts → dist/index.d.ts}

@@ -12,5 +12,5 @@ export * from "./schema/validator";
 export * from "./server";
 export * from "./storage";
 export * from "./utils";
+export * from "./version";
 export type { ModuleLoader } from "./runtime";
-