@hoplogic/hopjit 0.1.0

package/dist/dispatcher.d.ts

@@ -0,0 +1,92 @@
+import type { ExecutionEngine } from './engine.js';
+import type { ExecutableStepType, OutputDecl } from './ast-types.js';
+import type { StepReady, ExecutionPaused } from './cli-types.js';
+import type { HostConfig } from './provider-types.js';
+/** StepDispatcher 构造配置（tool 迭代上限、全局 token 预算、单步超时等成本护栏参数）。见 [[step-dispatcher#^anc-exec-cost-guardrails]] */
+export interface DispatcherConfig {
+    maxToolIterations?: number;
+    tokenBudget?: number;
+    timeoutSeconds?: number;
+}
+/** runSpec/resume 的返回结果：终态（completed/failed）或暂停信号（paused 携带 ExecutionPaused）。见 [[step-dispatcher#^anc-struct-step-dispatcher]] */
+export interface RunResult {
+    status: 'completed' | 'failed' | 'paused';
+    outputs?: Record<string, unknown>;
+    failure?: {
+        step_id: string;
+        reason: string;
+    };
+    pause?: ExecutionPaused;
+    cumulative_tokens?: number;
+}
+/** 独立模式的驱动适配层：跑调度循环（init→next→execute→done）并直调 Anthropic API 完成单步推理与工具调用。见 [[step-dispatcher#^anc-struct-step-dispatcher]] */
+export declare class StepDispatcher {
+    private engine;
+    private hostConfig;
+    private clients;
+    private defaultClient;
+    private toolProvider;
+    private cumulativeTokens;
+    private replanAttempts;
+    private maxToolIterations;
+    private tokenBudget;
+    private timeoutSeconds;
+    private pendingPause;
+    constructor(engine: ExecutionEngine, hostConfig: HostConfig, config?: DispatcherConfig);
+    runSpec(): Promise<RunResult>;
+    /**
+     * 同实例恢复：注入 caller 对 confirm 暂停步骤的决策，继续执行循环。 // @a: anc-exec-resume-semantics
+     * confirm 是唯一的暂停点（鉴权/决策环节）：answer 作为步骤输出注入 → completeStep（audit hitl_decision）。
+     * commit 不暂停（授权在前序完成），故 resume 不处理 commit。
+     */
+    resume(stepId: string, answer: Record<string, unknown>): Promise<RunResult>;
+    resumeSpec(): Promise<RunResult>;
+    getCumulativeTokens(): number;
+    private executionLoop;
+    private handleStepReady;
+    private injectKnowledge;
+    private handleAdaptive;
+    private executeStepWithTimeout;
+    private executeStep;
+    private executeReasonOrCheck;
+    private executeActWithTools;
+    private executeConfirm;
+    private executeCommit;
+    private executeActBody;
+    private buildApiRequest;
+    private buildSystemPrompt;
+    private buildMessages;
+    formatInputs(inputs: Record<string, unknown>): string;
+    formatOutputSchema(schema: OutputDecl[]): string;
+    private selectTemperature;
+    private callLlmWithRetry;
+    private getMaxRetries;
+    private isRateLimited;
+    private isServerError;
+    private isTimeout;
+    private isNetworkError;
+    private isAuthFailure;
+    private isContextOverflow;
+    private checkBudget;
+    private checkNoneInputs;
+    private parseStepOutput;
+    private extractTextContent;
+    private findStepNode;
+    private resolveCredential;
+    resolveModel(stepType: ExecutableStepType, step?: StepReady): {
+        service_id: string;
+        model: string;
+    };
+    private parseModelRef;
+    private findStepInSpec;
+    /** 解析 API 输出 token 上限：env → resource_limits → 缺省。单点定义（原两处逐字复制）。
+     * 通用 env `HOPJIT_MAX_OUTPUT_TOKENS` 优先；`CLAUDE_CODE_MAX_OUTPUT_TOKENS` 保留作兼容（CC 宿主已设的不破坏）。 */
+    private resolveMaxOutputTokens;
+    /** replan 失败收尾：attempts+1 写回，达上限则 failStep。error 分支与 catch 分支共用。 */
+    private recordReplanFailure;
+    /** 步骤完成时把工具调用日志写入 HopLog（非空才写）。executeActWithTools / executeActBody 共用。 */
+    private flushToolLog;
+    private getClientForService;
+    private hasLackOfInfo;
+    private sleep;
+}