@ai-setting/roy-agent-core 1.7.51 → 1.7.53

package/dist/env/prompt/prompt-component.d.ts

@@ -0,0 +1,194 @@
+/**
+ * @fileoverview PromptComponent
+ *
+ * 管理提示词存储、加载和渲染
+ * - 内置 prompts 在构建时嵌入到 bundle 中（通过 prompts-index.ts）
+ * - 外部 prompts 通过配置从指定路径加载
+ *
+ * 配置通过 ConfigComponent 实时获取，支持配置热更新
+ */
+import { BaseComponent, type ComponentConfig } from "../component";
+import { type PromptConfig, type PromptPath, type PromptEntry, type PromptHookContext } from "./types";
+import type { ConfigComponent } from "../../config/config-component";
+import { PromptStore } from "./prompt-store";
+/**
+ * PromptComponent 配置选项（通过 options 传递）
+ *
+ * 配置加载顺序（优先级从低到高）：
+ * 1. File - 配置文件（通过 configPath 指定）
+ * 2. Env - 环境变量（通过 envPrefix 配置前缀）
+ * 3. Object - 直接传入的配置对象（最高优先级）
+ */
+export interface PromptComponentOptions {
+    /** ConfigComponent 实例（必填） */
+    configComponent: ConfigComponent;
+    /** 配置文件相对路径（可选，基于 XDG_DATA_HOME） */
+    configPath?: string;
+    /** 环境变量前缀（可选，默认 "PROMPT"） */
+    envPrefix?: string;
+    /** 默认 prompt 名称 */
+    defaultName?: string;
+    /** 外部 prompt 路径列表 */
+    promptPaths?: PromptPath[];
+    /** 变量前缀（默认 "{{"） */
+    variablePrefix?: string;
+    /** 变量后缀（默认 "}}"） */
+    variableSuffix?: string;
+    /** 直接传入的配置对象（可选，优先级最高） */
+    config?: Partial<PromptConfig>;
+}
+/**
+ * PromptComponent
+ *
+ * 管理提示词存储、加载和渲染
+ * 配置通过 ConfigComponent 实时获取，支持配置热更新
+ */
+export declare class PromptComponent extends BaseComponent {
+    readonly name = "prompt";
+    readonly version = "1.0.0";
+    private prompts;
+    private config?;
+    private configComponent?;
+    private renderer;
+    private promptStore?;
+    /** 配置变更 watcher 清理函数 */
+    private configWatcher?;
+    constructor();
+    /**
+     * 初始化组件
+     *
+     * 配置加载优先级（从高到低）：
+     * 1. Object - 直接传入的 config 对象
+     * 2. Env - 环境变量（通过 envPrefix 配置前缀）
+     * 3. File - 配置文件（通过 configPath 指定）
+     */
+    init(config: ComponentConfig): Promise<void>;
+    /**
+     * 注册配置到 ConfigComponent
+     *
+     * 配置加载顺序（优先级从低到高）：
+     * 1. Env - 环境变量（通过 load 加载 + 直接读取）
+     * 2. Defaults - 默认值（在环境变量检查之后设置）
+     * 3. Config Object - 直接配置对象（最高优先级）
+     */
+    private registerConfig;
+    /**
+     * 将配置对象展平为点号路径
+     */
+    private flattenConfig;
+    /**
+     * 注册配置热更新监听
+     */
+    private registerConfigWatcher;
+    /**
+     * 处理配置变更
+     */
+    private onConfigChange;
+    private initRenderer;
+    onStart(): Promise<void>;
+    onStop(): Promise<void>;
+    private getPromptConfig;
+    /**
+     * 添加 prompt
+     */
+    add(name: string, content: string, source?: PromptEntry["source"]): void;
+    /**
+     * 获取 prompt 原始内容
+     */
+    get(name: string): string | undefined;
+    /**
+     * 获取 prompt 条目
+     */
+    getEntry(name: string): PromptEntry | undefined;
+    /**
+     * 检查 prompt 是否存在
+     */
+    has(name: string): boolean;
+    /**
+     * 删除 prompt
+     */
+    delete(name: string): boolean;
+    /**
+     * 列出所有 prompt 名称
+     */
+    list(): string[];
+    /**
+     * 列出所有 prompt 条目（含来源）
+     */
+    listEntries(): PromptEntry[];
+    getPromptStore(): PromptStore;
+    getPromptConfigDir(): string;
+    /**
+     * 保存 prompt 到磁盘并注册到内存（跨进程持久化）
+     */
+    savePrompt(name: string, content: string): Promise<string>;
+    /**
+     * 从磁盘删除 prompt 文件，并从内存移除
+     */
+    deletePromptFile(name: string): Promise<boolean>;
+    /**
+     * 获取数量
+     */
+    size(): number;
+    /**
+     * 获取并渲染 prompt
+     *
+     * @param context 可选：渲染上下文。`agentType` 会透传到 `PromptHookContext`，
+     *                供 `prompt.after-render` hook 判断是否注入 user-facing 内容
+     *                （只有 `agentType === "primary"` 才注入 Commands Arsenal）。
+     */
+    getPrompt(name: string, variables?: Record<string, string>, context?: Partial<PromptHookContext>): Promise<string>;
+    /**
+     * 渲染内容（异步方法）
+     */
+    render(content: string, variables?: Record<string, string>, context?: Partial<PromptHookContext>): Promise<string>;
+    /**
+     * 提取内容中的变量
+     */
+    extractVariables(content: string): string[];
+    /**
+     * 加载所有 prompts（内置 + 外部）
+     */
+    private initPromptStore;
+    private loadPrompts;
+    /**
+     * 从 XDG prompts 目录加载用户持久化 prompt
+     */
+    private loadUserPrompts;
+    /**
+     * 加载内置 prompts
+     *
+     * 使用嵌入的 prompts（在构建时打包到 bundle 中）
+     */
+    private loadBuiltInPrompts;
+    /**
+     * 加载外部 prompts
+     */
+    private loadExternalPrompts;
+    /**
+     * 从文件加载单个 prompt
+     */
+    loadFromFile(filePath: string, name?: string): Promise<boolean>;
+    /**
+     * 从目录加载多个 prompt
+     */
+    loadFromDirectory(directory: string, extension?: string, recursive?: boolean): Promise<number>;
+    private findFiles;
+    /**
+     * 注册 Prompt Hook（公开便捷方法，供外部调用）
+     *
+     * 现在使用全局 hookManager，允许外部通过 globalHookManager 注册
+     */
+    registerPromptHook(hookPoint: string, name: string, fn: (ctx: {
+        data: PromptHookContext;
+        phase: "before" | "after";
+    }) => void | Promise<void>, priority?: number): void;
+    /**
+     * 取消注册 Prompt Hook
+     */
+    unregisterPromptHook(hookPoint: string, name: string): boolean;
+    /**
+     * 获取 Prompt Hook 点列表
+     */
+    getHookPoints(): string[];
+}

package/dist/env/prompt/prompt-config-registration.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Prompt Component 配置注册
+ *
+ * 使用 ConfigComponent.registerComponent() 机制统一管理配置
+ */
+import type { ComponentRegistration } from "../../config/config-component";
+/**
+ * Prompt Component 默认配置值
+ *
+ * 注意：键使用完整格式（带 "prompt." 前缀），在 registerConfig 中手动设置
+ */
+export declare const PROMPT_DEFAULTS: Record<string, unknown>;
+/**
+ * Prompt Component 配置注册常量
+ *
+ * 定义了所有 Prompt 相关的配置项和来源
+ */
+export declare const PROMPT_CONFIG_REGISTRATION: ComponentRegistration;

package/dist/env/prompt/prompt-store.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview PromptStore - 用户 prompt 文件持久化
+ *
+ * 默认目录：~/.local/share/roy-agent/prompts/
+ * 文件命名：{name}.md，支持嵌套路径（如 subagent/explore.md）
+ */
+export interface StoredPrompt {
+    name: string;
+    content: string;
+    filePath: string;
+}
+export declare class PromptStore {
+    private configDir;
+    constructor(options?: {
+        baseDir?: string;
+        configDir?: string;
+    });
+    getConfigDir(): string;
+    configDirExists(): boolean;
+    getPromptFilePath(name: string): string;
+    savePrompt(name: string, content: string): Promise<string>;
+    deletePrompt(name: string): Promise<boolean>;
+    loadAll(): Promise<StoredPrompt[]>;
+    private collectPrompts;
+    private ensureConfigDir;
+}