@actiondock/core 2.0.11 → 2.2.0

package/dist/execution/types.d.ts

@@ -0,0 +1,131 @@
+import type { ActionDefinition, ActionRef, ExecutionEvent, ExecutionResult, JsonValue, Logger, ProcessAPI, ProgressReporter, RunRecord, RunStatus } from "@actiondock/sdk";
+import type { ProjectConfig } from "../project/types.js";
+import type { ActionRunner, ExecutionHandle } from "../runtime/runner.js";
+import type { Clock } from "../runtime/clock.js";
+import type { EventSink } from "../runtime/events.js";
+import type { RuntimeStorage } from "../storage/types.js";
+import type { RuntimePlatform } from "../platform/types.js";
+/**
+ * 执行参数选项。
+ */
+export interface ExecuteOptions {
+    /** 外部取消信号 */
+    signal?: AbortSignal;
+    /** 超时时间（毫秒） */
+    timeoutMs?: number;
+    /** 配置临时覆盖字典 */
+    config?: Record<string, JsonValue>;
+    /** 幂等请求去重标识 */
+    requestId?: string;
+    /** 父运行 ID */
+    parentRunId?: string;
+    /** 根运行 ID */
+    rootRunId?: string;
+    /** 最大调用嵌套深度限制 */
+    maxCallDepth?: number;
+    /** 外部日志注入 */
+    logger?: Logger;
+    /** 外部进度报告器注入 */
+    progress?: ProgressReporter;
+    /** 外部进程执行器注入 */
+    process?: ProcessAPI;
+    /** 可选的底层运行平台契约 */
+    platform?: RuntimePlatform;
+    /** 执行宿主会话标识 */
+    hostSessionId?: string;
+}
+/**
+ * 统一执行协调服务配置选项。
+ */
+export interface ExecutionServiceOptions {
+    packageId: string;
+    hostSessionId?: 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;
+    platform?: RuntimePlatform;
+}
+/**
+ * 异步任务执行票据。
+ */
+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 执行引擎（用于跨包上下文注入与动态解析委托） */
+    readonly runner: ActionRunner;
+    /** 同步执行 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 | string;
+        signal?: AbortSignal;
+        maxQueueSize?: number;
+    }): AsyncIterable<ExecutionEvent>;
+    /** 获取指定运行的活动执行句柄（无活跃执行时返回 undefined） */
+    getActiveHandle(runId: string): ExecutionHandle | undefined;
+    /** 注册单个 Action 至执行引擎 */
+    registerAction(id: string, action: ActionDefinition): void;
+    /** 按 ID 检索已注册的 Action 定义 */
+    getAction(id: string): ActionDefinition | undefined;
+    /** 优雅关闭服务并等待活跃任务收尾 */
+    close(options?: {
+        graceMs?: number;
+    }): Promise<void>;
+}

package/dist/execution/types.js

@@ -0,0 +1 @@
+export {};

package/dist/export/index.d.ts

@@ -0,0 +1 @@
+export * from "./templates.js";

package/dist/export/index.js

@@ -0,0 +1 @@
+export * from "./templates.js";

package/dist/export/templates.d.ts

@@ -0,0 +1,71 @@
+import type { ActionSpec } from "../app/types.js";
+import type { PlaybookDefinition, ProjectConfig } from "../project/types.js";
+export type SkillActionItem = ActionSpec | {
+    id: string;
+    description?: string;
+    inputSchema?: any;
+    outputSchema?: any;
+    annotations?: any;
+};
+export declare function generateSourceSkillMd(config: ProjectConfig, actions: SkillActionItem[], playbooks: PlaybookDefinition[]): string;
+export declare function generateStandaloneSkillMd(config: ProjectConfig, actions: SkillActionItem[], playbooks: PlaybookDefinition[], binaryRelPath?: string): string;
+export declare function generateSkillMd(config: ProjectConfig, actions: SkillActionItem[], 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.custom.md）的槽位，
+ * 决定自定义段落插入到官方模板生成结果中的位置。
+ */
+export type CompositeCustomSlot = "intro" | "after-init" | "after-describe" | "after-actions" | "after-playbooks" | "after-invoke" | "append";
+export declare const COMPOSITE_CUSTOM_SLOTS: readonly CompositeCustomSlot[];
+/** 工作区内约定俗成的复合技能自定义说明书文件名。 */
+export declare const COMPOSITE_CUSTOM_DECLARATION_FILE = "SKILL.custom.md";
+export interface CompositeCustomSection {
+    slot: CompositeCustomSlot;
+    content: string;
+}
+export interface CompositeCustomDeclaration {
+    /** 自定义说明书 frontmatter 中声明的 description 覆盖值 */
+    description?: string;
+    sections: CompositeCustomSection[];
+}
+/**
+ * 解析自定义说明书正文：以 `<!-- actiondock:slot <name> -->` 标记行分段。
+ * 首个标记之前的内容归入 `append` 槽位；未知槽位名直接抛错，避免拼写错误被静默吞掉。
+ */
+export declare function parseCustomSections(source: string): CompositeCustomSection[];
+/**
+ * 解析复合技能自定义说明书文件：支持 YAML frontmatter 中的 `description` 覆盖，
+ * 正文按槽位标记解析为自定义段落。
+ */
+export declare function parseCustomSkillDeclaration(source: string): CompositeCustomDeclaration;
+/**
+ * 生成多包聚合的复合模式 SKILL.md 文档。
+ */
+export declare function generateCompositeSkillMd(bundleName: string, description: string, packages: CompositeSkillPackageInfo[], options?: {
+    customSections?: CompositeCustomSection[];
+    /** 规程链接的子包目录前缀：导出布局为 "packages"（默认）；就地生成时传 "." 使用工作区实际目录 */
+    packagesBaseDir?: string;
+}): string;
+export interface GenerateSkillJsonOptions {
+    mode?: "source" | "standalone";
+    executable?: string;
+    target?: string;
+    playbooks?: PlaybookDefinition[];
+}
+export declare function generateSkillJson(config: ProjectConfig, actions: SkillActionItem[], binaryNameOrOptions?: string | GenerateSkillJsonOptions, target?: string, playbooksList?: PlaybookDefinition[]): string;