/** * agency-orchestrator — 公开 API * * 使用方式: * import { run, validate, plan } from 'agency-orchestrator'; */ export { parseWorkflow, validateWorkflow } from './core/parser.js'; export { buildDAG, formatDAG } from './core/dag.js'; export { executeDAG } from './core/executor.js'; export { evaluateCondition } from './core/condition.js'; export { renderTemplate, extractVariables } from './core/template.js'; export { loadAgent, listAgents } from './agents/loader.js'; export { ClaudeConnector } from './connectors/claude.js'; export { OllamaConnector } from './connectors/ollama.js'; export { OpenAICompatibleConnector } from './connectors/openai-compatible.js'; export { createConnector } from './connectors/factory.js'; export { saveResults, loadPreviousContext, findLatestOutput, computeResumeSkipIds } from './output/reporter.js'; export { composeWorkflow, buildRoleCatalog, extractYamlFromResponse } from './cli/compose.js'; import { type CompareVerdict } from './core/compare.js'; export { buildBaselineTask, runBaseline, finalOutput, compareOutputs, aggregateVerdict } from './core/compare.js'; export type { CompareVerdict } from './core/compare.js'; export type { WorkflowDefinition, StepDefinition, LLMConfig, LLMConnector, LLMResult, AgentDefinition, WorkflowResult, StepResult, DAGNode, } from './types.js'; import type { InputDefinition } from './types.js'; /** * 计算真正缺失的必填输入:required 且未提供且**无默认值**。 * 有 default 的 required 输入不算缺失(默认值会填上),否则像 story-creation 这类带 * default 的旗舰模板 `ao run xxx.yaml` 开箱即跑会被误判为缺参。纯函数,便于测试。 */ export declare function findMissingInputs(inputs: InputDefinition[] | undefined, provided: { has(name: string): boolean; }): InputDefinition[]; /** * 弱模型档位提示:质量评测(EVAL_FINDINGS.md)显示多智能体的增益依赖模型能力—— * 本地小模型上交接链会放大漂移、产出可能不如单次。仅对 ollama(最常见的弱档来源)给一行 * 软提示,不阻断;返回 null 表示无需提示。设 AO_NO_MODEL_HINT=1 可关闭。 */ export declare function modelCapabilityHint(provider: string): string | null; /** * 一行运行工作流(高级 API) */ export declare function run(workflowPath: string, inputs: Record, options?: { outputDir?: string; quiet?: boolean; /** --watch 模式:终端实时进度 UI */ watch?: boolean; /** resume 目录:从上次运行的输出中加载已完成步骤 */ resumeDir?: string; /** 从指定步骤开始重新执行(跳过之前的步骤) */ fromStep?: string; /** * 对话式返工:对 fromStep 步骤注入修改意见,让该专家带着"上一版产出 + 你的意见" * 在原稿基础上修改重做。需配合 resumeDir + fromStep 使用。 */ feedback?: string; /** 覆盖 LLM 配置(例如来自 ao demo) */ llmOverride?: Partial; }): Promise; /** * 多智能体工作流 vs 单次基线对比(产品化 eval 的核心假设验证)。 * 跑完整工作流拿最终成品 + 跑"一句话直接要成品"的单次基线 + 双向盲评, * 返回两份产出与可信的胜负结论。供 `ao run --compare`、网页 Studio、eval 复用。 * * 公平性:多智能体与基线默认用同一生成模型(genOverride 或工作流自身 llm); * 评审用更强的 judgeLlm(不传则退回生成模型)。详见 EVAL_FINDINGS.md。 */ export declare function compareWorkflowVsBaseline(workflowPath: string, inputs: Record, options?: { outputDir?: string; quiet?: boolean; /** 生成模型(多智能体与基线都用它,保证公平);不传用工作流自身 llm */ genOverride?: Partial; /** 评审模型(建议强模型);不传退回生成模型 */ judgeLlm?: import('./types.js').LLMConfig; }): Promise<{ multiOutput: string; baselineOutput: string; verdict: CompareVerdict | null; result: import('./types.js').WorkflowResult; }>; /** * 自动查找 agents 目录 * 优先级:YAML 中指定的路径 → 相对于 workflow 文件 → 常见位置 */ /** * 在常见位置查找角色库目录;找到返回绝对路径,找不到返回 null(不抛错)。 * 供 validate/plan 等只读路径做"best-effort role 校验"复用。 */ export declare function findAgentsDir(agentsDir: string, workflowPath: string): string | null;