@xcompiler/cli 0.2.2 → 0.2.4

package/dist/plugins/index.d.ts

@@ -46,11 +46,12 @@ declare class AuditLogger {
     llmResponse(role: string, model: string, content: string, meta?: Record<string, unknown>): Promise<void>;
     llmError(role: string, model: string, err: unknown): Promise<void>;
     /**
-     * 记录一轮 Executor 思考：thoughts 文本、计划调用的 actions、是否完成。
-     * 写入 jsonl + markdown 折叠块，交付时可作为"AI 思考过程完整记录"。
+     * 记录一轮 Executor 执行摘要：简短 intent、issue 处理方案、计划调用的 actions、是否完成。
+     * 写入 jsonl + markdown 折叠块，交付时可追溯每轮决策和动作。
      */
     executorTurn(stepId: string, role: string, round: number, payload: {
         thoughts?: string;
+        issueResolutionPlan?: string;
         actions?: unknown[];
         done?: boolean;
         raw?: string;
@@ -92,6 +93,12 @@ interface ChatOptions {
      * 空输出、model token loop 等“表面成功但语义不可用”场景。
      */
     validate?: (text: string) => void;
+    /**
+     * Whether a provider response should increase its dynamic score.
+     * Step/workflow executors should disable this and score quality through
+     * their own validation instead of treating "returned text" as task success.
+     */
+    scoreSuccess?: boolean;
     /**
      * 调用者可传入回调，与 LLM 输出一同拿到实际产出该响应的 provider 名。
      * 主要用于追溯：在 FallbackClient 中服务于响应的是链中某一个后选 provider，
@@ -126,11 +133,23 @@ interface ExecResult {
     stderr: string;
     timedOut: boolean;
     durationMs: number;
+    timeoutReason?: string;
+}
+interface ExecProgressWatch {
+    /** Host-side paths whose recursive size indicates install progress. */
+    paths: string[];
+    /** Kill the child only after this much time without size growth. */
+    idleTimeoutMs: number;
+    /** Poll interval for recursive size checks. */
+    checkIntervalMs?: number;
+    /** Human-readable label used in timeout diagnostics. */
+    label?: string;
 }
 interface ExecExtra {
     cwd?: string;
     env?: Record<string, string>;
     timeoutMs?: number;
+    progressWatch?: ExecProgressWatch;
 }
 /** 沙盒统一接口。任意 phase / tool 都通过此接口与运行时交互。 */
 interface Sandbox {
@@ -152,7 +171,7 @@ interface Sandbox {
     /**
      * 运行工程入口程序。
      *  - Python：`python <args>`（自动选用 venv 内解释器）。
-     *  - TypeScript：`npx tsx <args>`。
+     *  - TypeScript：默认 `npx tsx <entry>`；当 args 以 `npm`/`npx`/`node`/`tsx`/`tsc` 开头时执行对应项目命令。
      */
     runProgram(args: string[], extra?: ExecExtra): Promise<ExecResult>;
     /**
@@ -238,6 +257,7 @@ declare const PlanSchema: z.ZodPipe<z.ZodObject<{
         refactor: "refactor";
         self: "self";
     }>>;
+    phaseId: z.ZodDefault<z.ZodString>;
     projectType: z.ZodDefault<z.ZodEnum<{
         application: "application";
         library: "library";
@@ -331,6 +351,7 @@ declare const PlanSchema: z.ZodPipe<z.ZodObject<{
     version: "1";
     language: "python" | "typescript";
     intent: "greenfield" | "feature" | "refactor" | "self";
+    phaseId: string;
     projectType: "application" | "library" | "mixed";
     requirementDigest: string;
     globalPrompt: string;
@@ -387,6 +408,7 @@ declare const PlanSchema: z.ZodPipe<z.ZodObject<{
     version: "1";
     language: "python" | "typescript";
     intent: "greenfield" | "feature" | "refactor" | "self";
+    phaseId: string;
     projectType: "application" | "library" | "mixed";
     requirementDigest: string;
     globalPrompt: string;
@@ -489,6 +511,8 @@ interface ToolContext {
     language?: Language;
     /** 当前 Step 的 write_file / append_file 单次 content 字节预算。 */
     writeChunkBytes?: number;
+    /** run_tests 未提供有效过滤参数时使用的当前阶段默认测试范围。 */
+    defaultTestArgs?: string[];
     /** Optional protocol/UI permission hook for sensitive tool operations. */
     requestPermission?: ToolPermissionRequester;
     /** Optional protocol/UI event hook for tool calls and file changes. */
@@ -597,6 +621,8 @@ interface HookContextMap {
     'compile.finish': {
         plan: Plan;
         planPath: string;
+        phasePlanPath?: string;
+        currentPlanPath?: string;
     };
     'run.before': {
         plan: Plan;
@@ -803,7 +829,7 @@ declare function checkPluginCompatibility(manifest: XCompilerPluginManifest, run
  */
 declare function loadPluginSources(options: PluginLoadOptions): Promise<XCompilerPlugin[]>;
 
-declare const XCOMPILER_VERSION = "0.2.2";
+declare const XCOMPILER_VERSION = "0.2.4";
 declare const XCOMPILER_PLUGIN_API_VERSION = 1;
 
 export { type EngineRunSummary, type HookContextMap, type HookHandler, type HookName, type HookRegistrationOptions, type PluginApi, type PluginCompatibilityCode, type PluginCompatibilityReport, type PluginExtensionTarget, PluginHost, type PluginHostOptions, type PluginLoadOptions, type PluginRuntimeVersion, type PluginSource, type Skill, type StepAttemptOutcome, type Tool, type ToolContext, type ToolResult, XCOMPILER_PLUGIN_API_VERSION, XCOMPILER_VERSION, type XCompilerPlugin, type XCompilerPluginManifest, checkPluginCompatibility, loadPluginSources };