@actiondock/core 2.0.12 → 2.2.0

package/dist/execution/types.d.ts

@@ -1,4 +1,10 @@
-import type { ActionRef, ExecutionEvent, ExecutionResult, JsonValue, Logger, ProcessAPI, ProgressReporter, RunRecord, RunStatus } from "@actiondock/sdk";
+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";
 /**
  * 执行参数选项。
  */
@@ -9,6 +15,8 @@ export interface ExecuteOptions {
     timeoutMs?: number;
     /** 配置临时覆盖字典 */
     config?: Record<string, JsonValue>;
+    /** 幂等请求去重标识 */
+    requestId?: string;
     /** 父运行 ID */
     parentRunId?: string;
     /** 根运行 ID */
@@ -21,6 +29,46 @@ export interface ExecuteOptions {
     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;
 }
 /**
  * 异步任务执行票据。
@@ -54,6 +102,8 @@ export type CancelResult = {
  * 统一执行协调服务接口。
  */
 export interface ExecutionService {
+    /** 底层 Action 执行引擎（用于跨包上下文注入与动态解析委托） */
+    readonly runner: ActionRunner;
     /** 同步执行 Action 并等待终态结果 */
     execute(ref: ActionRef | string, input: JsonValue, options?: ExecuteOptions): Promise<ExecutionResult>;
     /** 异步启动 Action 并立即返回任务票据 */
@@ -64,9 +114,16 @@ export interface ExecutionService {
     cancel(runId: string, reason?: string): Promise<CancelResult>;
     /** 订阅执行事件流 */
     events(runId: string, options?: {
-        after?: number;
+        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;

package/dist/execution/types.js

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

package/dist/export/index.d.ts

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

package/dist/export/index.js

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

package/dist/export/templates.d.ts

@@ -1,8 +1,15 @@
-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 | {
+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;
@@ -20,14 +27,45 @@ export interface CompositeSkillPackageInfo {
     }>;
     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[]): string;
+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: ActionDefinition[], binaryNameOrOptions?: string | GenerateSkillJsonOptions, target?: string, playbooksList?: PlaybookDefinition[]): string;
+export declare function generateSkillJson(config: ProjectConfig, actions: SkillActionItem[], binaryNameOrOptions?: string | GenerateSkillJsonOptions, target?: string, playbooksList?: PlaybookDefinition[]): string;