@actiondock/core 2.6.0 → 2.8.0

package/dist/catalog/action-index.js

@@ -1,95 +0,0 @@
-import { existsSync, readdirSync } from "node:fs";
-import { join } from "node:path";
-import { loadManifest } from "../project/manifest.js";
-export class ActionIndex {
-    actions = new Map(); // actionId -> IndexedAction[]
-    constructor(snapshot) {
-        this.indexSnapshot(snapshot);
-    }
-    indexSnapshot(snapshot) {
-        for (const [packageId, pkg] of snapshot.packages) {
-            let manifest = null;
-            try {
-                manifest = loadManifest(pkg.projectRoot);
-            }
-            catch (err) {
-                // 清单损坏时跳过索引但输出告警含路径，回退扫描 actions 目录
-                console.warn(`[Catalog] Failed to load manifest for package '${packageId}' at '${pkg.projectRoot}': ${err?.message || String(err)}`);
-            }
-            if (manifest && manifest.actions) {
-                for (const [actionId, item] of Object.entries(manifest.actions)) {
-                    const indexed = {
-                        packageId,
-                        actionId,
-                        contract: {
-                            id: actionId,
-                            description: item.description,
-                            inputSchema: item.inputSchema,
-                            outputSchema: item.outputSchema,
-                            uses: item.uses,
-                            tags: item.tags,
-                            annotations: item.annotations,
-                        },
-                        entry: item.entry,
-                        projectRoot: pkg.projectRoot,
-                    };
-                    this.add(indexed);
-                }
-            }
-            else {
-                // 向后兼容回退：若未提供清单，扫描 actions 目录生成基础索引
-                const actionsDir = join(pkg.projectRoot, pkg.config.actionsDir || "actions");
-                if (existsSync(actionsDir)) {
-                    try {
-                        const files = readdirSync(actionsDir);
-                        for (const file of files) {
-                            if (file.endsWith(".ts") || file.endsWith(".js")) {
-                                const actionId = file.replace(/\.(ts|js)$/, "");
-                                const indexed = {
-                                    packageId,
-                                    actionId,
-                                    contract: {
-                                        id: actionId,
-                                    },
-                                    entry: join(pkg.config.actionsDir || "actions", file),
-                                    projectRoot: pkg.projectRoot,
-                                };
-                                this.add(indexed);
-                            }
-                        }
-                    }
-                    catch (err) {
-                        // 目录扫描失败时输出告警含路径，不再无声吞没
-                        console.warn(`[Catalog] Failed to scan actions directory for package '${packageId}' at '${actionsDir}': ${err?.message || String(err)}`);
-                    }
-                }
-            }
-        }
-    }
-    add(action) {
-        let list = this.actions.get(action.actionId);
-        if (!list) {
-            list = [];
-            this.actions.set(action.actionId, list);
-        }
-        list.push(action);
-    }
-    list(packageId) {
-        const all = [];
-        for (const [_, list] of this.actions) {
-            for (const action of list) {
-                if (!packageId || action.packageId === packageId) {
-                    all.push(action);
-                }
-            }
-        }
-        return all;
-    }
-    find(actionId, packageId) {
-        const matches = this.actions.get(actionId) || [];
-        if (packageId) {
-            return matches.filter((a) => a.packageId === packageId);
-        }
-        return matches;
-    }
-}

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

@@ -1,20 +0,0 @@
-import type { ActionRef, ResolvedActionRef } from "@actiondock/sdk";
-import { ActionIndex } from "./action-index.js";
-import type { CatalogSnapshot, IndexedAction } from "./types.js";
-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/action-resolver.js

@@ -1,95 +0,0 @@
-import { ActionIndex } from "./action-index.js";
-export class ActionResolver {
-    snapshot;
-    index;
-    constructor(snapshot, index) {
-        this.snapshot = snapshot;
-        this.index = index || new ActionIndex(snapshot);
-    }
-    /**
-     * 解析字符串或 ActionRef 为规范化的 ActionRef。
-     * 支持 greet、my-tools/greet、@team/github/issues.list。
-     */
-    static parseRef(refStringOrObj) {
-        if (typeof refStringOrObj === "object") {
-            return refStringOrObj;
-        }
-        const str = refStringOrObj.trim();
-        if (str.includes("/")) {
-            const lastSlashIndex = str.lastIndexOf("/");
-            const packageId = str.slice(0, lastSlashIndex);
-            const actionId = str.slice(lastSlashIndex + 1);
-            if (actionId.includes(":") || actionId.includes("/") || actionId.includes("..")) {
-                throw new Error(`Invalid action identifier: '${actionId}'`);
-            }
-            return { packageId, actionId };
-        }
-        // 处理旧语法 package:action 的兼容提醒
-        if (str.includes(":")) {
-            const parts = str.split(":");
-            throw new Error(`Legacy syntax '${str}' is deprecated. Please use '${parts.join("/")}' instead.`);
-        }
-        return { actionId: str };
-    }
-    resolve(refStringOrObj, options = {}) {
-        const ref = ActionResolver.parseRef(refStringOrObj);
-        // 1. 若指定了 packageId，直接精确匹配
-        if (ref.packageId) {
-            const matches = this.index.find(ref.actionId, ref.packageId);
-            if (matches.length === 0) {
-                throw new Error(`ACTION_NOT_FOUND: Action '${ref.actionId}' not found in package '${ref.packageId}'`);
-            }
-            const matched = matches[0];
-            const pkg = this.snapshot.packages.get(matched.packageId);
-            return {
-                resolved: {
-                    packageId: matched.packageId,
-                    packageInstanceId: pkg?.packageInstanceId || matched.packageId,
-                    actionId: matched.actionId,
-                    generationId: this.snapshot.generationId,
-                },
-                action: matched,
-            };
-        }
-        // 2. 未指定 packageId：优先查找当前调用者包
-        if (options.currentPackageId) {
-            const inCurrent = this.index.find(ref.actionId, options.currentPackageId);
-            if (inCurrent.length > 0) {
-                const matched = inCurrent[0];
-                const pkg = this.snapshot.packages.get(matched.packageId);
-                return {
-                    resolved: {
-                        packageId: matched.packageId,
-                        packageInstanceId: pkg?.packageInstanceId || matched.packageId,
-                        actionId: matched.actionId,
-                        generationId: this.snapshot.generationId,
-                    },
-                    action: matched,
-                };
-            }
-        }
-        // 3. 全局唯一匹配检查
-        const allMatches = this.index.find(ref.actionId);
-        if (allMatches.length === 0) {
-            throw new Error(`ACTION_NOT_FOUND: Action '${ref.actionId}' not found in any linked package`);
-        }
-        if (allMatches.length > 1) {
-            const candidates = allMatches.map((m) => `${m.packageId}/${m.actionId}`).join(", ");
-            const err = new Error(`INVALID_ACTION_REF: Action '${ref.actionId}' is ambiguous and provided by multiple packages: ${candidates}. Please specify the package name. (AMBIGUOUS_ACTION_REF)`);
-            err.code = "INVALID_ACTION_REF";
-            err.details = { alias: "AMBIGUOUS_ACTION_REF" };
-            throw err;
-        }
-        const matched = allMatches[0];
-        const pkg = this.snapshot.packages.get(matched.packageId);
-        return {
-            resolved: {
-                packageId: matched.packageId,
-                packageInstanceId: pkg?.packageInstanceId || matched.packageId,
-                actionId: matched.actionId,
-                generationId: this.snapshot.generationId,
-            },
-            action: matched,
-        };
-    }
-}

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

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

package/dist/catalog/location-registry.js

@@ -1,138 +0,0 @@
-import { existsSync } from "node:fs";
-import { resolve } from "node:path";
-import { getRegistryFilePath, linkPackage, loadRegistry, loadRegistryAsync, pruneRegistry, unlinkPackage, } from "../registry/registry.js";
-import { withRegistryLock } from "../registry/lock.js";
-import { writeRegistryLocked } from "../registry/registry.js";
-import { loadProjectConfig } from "../project/loader.js";
-import { ACTIONDOCK_VERSION } from "../version.js";
-export class LocationRegistry {
-    customHome;
-    filePath;
-    constructor(customHome) {
-        this.customHome = customHome;
-        this.filePath = getRegistryFilePath(customHome);
-    }
-    getFilePath() {
-        return this.filePath;
-    }
-    load() {
-        const reg = loadRegistry(this.customHome);
-        const links = [];
-        if (reg.workspaces) {
-            for (const [wsPath, ws] of Object.entries(reg.workspaces)) {
-                links.push({
-                    type: "workspace",
-                    path: resolve(ws.path || wsPath),
-                    linkedAt: ws.linkedAt || new Date().toISOString(),
-                    depth: 3,
-                });
-            }
-        }
-        if (reg.packages) {
-            for (const pkg of Object.values(reg.packages)) {
-                if (!pkg.workspaceRoot && pkg.path) {
-                    links.push({
-                        type: "package",
-                        path: resolve(pkg.path),
-                        linkedAt: pkg.linkedAt || new Date().toISOString(),
-                    });
-                }
-            }
-        }
-        return { schemaVersion: 1, links };
-    }
-    async save(data) {
-        // 读改写整体收敛在注册表锁内完成，写入直接走锁内原子落盘，
-        // 避免嵌套调用 saveRegistry 造成的同路径锁重入死等
-        await withRegistryLock(this.filePath, async () => {
-            const current = await loadRegistryAsync(this.customHome);
-            const newPackages = {};
-            const newWorkspaces = {};
-            for (const link of data.links) {
-                const absPath = resolve(link.path);
-                if (link.type === "workspace") {
-                    newWorkspaces[absPath] = {
-                        path: absPath,
-                        linkedAt: link.linkedAt || new Date().toISOString(),
-                    };
-                }
-                else {
-                    const existing = Object.values(current.packages || {}).find((p) => resolve(p.path) === absPath);
-                    if (existing) {
-                        newPackages[existing.id] = existing;
-                    }
-                    else if (existsSync(absPath)) {
-                        try {
-                            const config = loadProjectConfig(absPath);
-                            newPackages[config.id] = {
-                                id: config.id,
-                                name: config.name || config.id,
-                                version: config.version || "0.0.0",
-                                path: absPath,
-                                linkedAt: link.linkedAt || new Date().toISOString(),
-                            };
-                        }
-                        catch {
-                            // 项目损坏或配置非法：跳过该链接条目，避免保存整体失败
-                        }
-                    }
-                }
-            }
-            await writeRegistryLocked({
-                version: ACTIONDOCK_VERSION,
-                packages: newPackages,
-                workspaces: newWorkspaces,
-            }, this.customHome);
-        });
-    }
-    async addLink(path, options = {}) {
-        const type = options.type || "package";
-        if (type === "workspace") {
-            const res = await linkPackage(path, this.customHome, { recursive: true });
-            return {
-                type: "workspace",
-                path: resolve(path),
-                linkedAt: res.linkedAt,
-                depth: options.depth ?? 3,
-            };
-        }
-        else {
-            const res = await linkPackage(path, this.customHome, { recursive: false });
-            return {
-                type: "package",
-                path: resolve(path),
-                linkedAt: res.linkedAt,
-            };
-        }
-    }
-    async removeLink(targetPathOrId) {
-        const unres = await unlinkPackage(targetPathOrId, this.customHome);
-        if (!unres || (!unres.removedPackage && !unres.packagesCount)) {
-            return null;
-        }
-        return {
-            type: unres.type,
-            path: unres.path,
-            linkedAt: new Date().toISOString(),
-        };
-    }
-    async prune() {
-        const pruneRes = await pruneRegistry(this.customHome);
-        const removed = [];
-        for (const pkg of pruneRes.prunedPackages) {
-            removed.push({
-                type: "package",
-                path: pkg.path,
-                linkedAt: pkg.linkedAt,
-            });
-        }
-        for (const ws of pruneRes.prunedWorkspaces) {
-            removed.push({
-                type: "workspace",
-                path: ws.path,
-                linkedAt: ws.linkedAt,
-            });
-        }
-        return removed;
-    }
-}

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

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

package/dist/catalog/package-catalog.js

@@ -1,77 +0,0 @@
-import { existsSync, realpathSync } from "node:fs";
-import { randomUUID } from "node:crypto";
-import { resolve } from "node:path";
-import { findProjectRoot, loadProjectConfig } from "../project/loader.js";
-import { discoverProjects } from "../registry/registry.js";
-import { LocationRegistry } from "./location-registry.js";
-export class PackageCatalog {
-    registry;
-    constructor(registry) {
-        this.registry = registry || new LocationRegistry();
-    }
-    buildSnapshot(cwd = process.cwd()) {
-        const packages = new Map();
-        const seenRealPaths = new Map(); // realPath -> packageId
-        const seenPackageIds = new Map(); // packageId -> realPath
-        const registerPackage = (root, isChild = false) => {
-            const abs = resolve(root);
-            if (!existsSync(abs))
-                return;
-            const real = realpathSync(abs);
-            if (seenRealPaths.has(real)) {
-                return; // 符号链接归一化去重
-            }
-            try {
-                const config = loadProjectConfig(abs);
-                if (seenPackageIds.has(config.id)) {
-                    const existingPath = seenPackageIds.get(config.id);
-                    if (existingPath !== real) {
-                        throw new Error(`PACKAGE_ID_CONFLICT: Package ID '${config.id}' is declared by multiple directories: '${existingPath}' and '${real}'`);
-                    }
-                }
-                const entry = {
-                    id: config.id,
-                    packageInstanceId: `${config.id}:${real}`,
-                    projectRoot: abs,
-                    config,
-                    isWorkspaceChild: isChild,
-                };
-                packages.set(config.id, entry);
-                seenRealPaths.set(real, config.id);
-                seenPackageIds.set(config.id, real);
-            }
-            catch (e) {
-                if (e.message?.startsWith("PACKAGE_ID_CONFLICT")) {
-                    throw e;
-                }
-                // 无效项目跳过注册但输出告警含路径，杜绝无声丢弃
-                console.warn(`[Catalog] Skipping invalid package at '${abs}': ${e?.message || String(e)}`);
-            }
-        };
-        // 优先包含当前工作目录所在项目
-        const currentRoot = findProjectRoot(cwd);
-        if (currentRoot) {
-            registerPackage(currentRoot);
-        }
-        // 扫描注册表中的位置
-        const regData = this.registry.load();
-        for (const link of regData.links) {
-            if (!existsSync(link.path))
-                continue;
-            if (link.type === "package") {
-                registerPackage(link.path);
-            }
-            else if (link.type === "workspace") {
-                const subprojects = discoverProjects(link.path, link.depth ?? 3);
-                for (const sub of subprojects) {
-                    registerPackage(sub, true);
-                }
-            }
-        }
-        return {
-            generationId: randomUUID(),
-            createdAt: new Date().toISOString(),
-            packages,
-        };
-    }
-}

package/dist/catalog/types.d.ts

@@ -1,68 +0,0 @@
-import type { ActionContract } from "@actiondock/sdk";
-import type { ProjectConfig } from "../project/types.js";
-/**
- * 注册的位置条目类型。
- */
-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.js";

package/dist/catalog/types.js

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

package/dist/export/index.d.ts

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

package/dist/export/index.js

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

package/dist/export/templates.d.ts

@@ -1,71 +0,0 @@
-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;