@interf/compiler 0.7.3 → 0.9.3

package/dist/packages/agents/lib/execution.js

@@ -18,6 +18,7 @@ export function spawnAgent(agent, dirPath, prompt, options = {}) {
         const launchLine = `Launching ${agent.displayName}...`;
         console.log(chalk.dim(`  ${launchLine}`));
         appendAgentStatusLog(options.statusLogPath, launchLine);
+        options.onStatus?.(launchLine);
         const proc = spawn(agent.command, args, {
             cwd: dirPath,
             env: buildAgentEnv(agent),
@@ -95,6 +96,7 @@ export function spawnAgent(agent, dirPath, prompt, options = {}) {
                     : `${agent.displayName} started, but has not emitted visible progress yet... (${seconds}s)`;
             console.log(chalk.dim(`  ${label}`));
             appendAgentStatusLog(options.statusLogPath, label);
+            options.onStatus?.(label);
         }, 5000);
         const forwardSignal = () => {
             requestProcessStop("SIGINT");
@@ -173,14 +175,14 @@ export function spawnAgent(agent, dirPath, prompt, options = {}) {
                         lastToolActivity = toolActivity;
                     }
                     failureStatus ||= extractAgentFailureStatus(event);
-                    if (displayAgentEvent(event, options.statusLogPath, lastVisibleText)) {
+                    if (displayAgentEvent(event, options.statusLogPath, lastVisibleText, options.onStatus)) {
                         sawVisibleEvent = true;
                         lastVisibleOutputAt = Date.now();
                     }
                     maybeInterruptAfterTerminalStatus();
                 }
                 catch {
-                    if (emitVisibleAgentText(line, options.statusLogPath, lastVisibleText)) {
+                    if (emitVisibleAgentText(line, options.statusLogPath, lastVisibleText, options.onStatus)) {
                         sawVisibleEvent = true;
                         lastVisibleOutputAt = Date.now();
                     }

package/dist/packages/agents/lib/executors.d.ts

@@ -1,32 +1,33 @@
-import type { RuntimeExecutorInfo } from "../../compiler/lib/schema.js";
+import type { RuntimeExecutorInfo } from "../../contracts/lib/schema.js";
 import type { Agent } from "./types.js";
-export type WorkflowExecutorKind = "local-agent" | "connected-provider" | "managed";
-export interface WorkflowExecutionProfile {
+export type MethodExecutorKind = "local-agent" | "connected-provider" | "managed";
+export interface MethodExecutionProfile {
     model?: string | null;
     effort?: string | null;
     profile?: string | null;
     timeoutMs?: number | null;
 }
-export interface WorkflowExecuteOptions {
+export interface MethodExecuteOptions {
     eventLogPath?: string | null;
     statusLogPath?: string | null;
     completionCheck?: (() => boolean) | null;
+    onStatus?: (line: string) => void;
 }
-export interface WorkflowExecutor {
-    kind: WorkflowExecutorKind;
+export interface MethodExecutor {
+    kind: MethodExecutorKind;
     name: string;
     displayName: string;
     command?: string | null;
-    executionProfile?: WorkflowExecutionProfile;
-    execute(rootPath: string, prompt: string, options?: WorkflowExecuteOptions): Promise<number>;
+    executionProfile?: MethodExecutionProfile;
+    execute(rootPath: string, prompt: string, options?: MethodExecuteOptions): Promise<number>;
 }
-export type { RuntimeExecutorInfo } from "../../compiler/lib/schema.js";
-export declare function buildRuntimeExecutorInfo(executor: WorkflowExecutor): RuntimeExecutorInfo;
-export declare function createLocalAgentExecutor(agent: Agent, executionProfile?: WorkflowExecutionProfile): WorkflowExecutor;
+export type { RuntimeExecutorInfo } from "../../contracts/lib/schema.js";
+export declare function buildRuntimeExecutorInfo(executor: MethodExecutor): RuntimeExecutorInfo;
+export declare function createLocalAgentExecutor(agent: Agent, executionProfile?: MethodExecutionProfile): MethodExecutor;
 export declare function resolveLocalExecutor(options?: {
     preflight?: boolean;
-    executionProfile?: WorkflowExecutionProfile;
+    executionProfile?: MethodExecutionProfile;
 }): {
-    executor: WorkflowExecutor | null;
+    executor: MethodExecutor | null;
     error?: string;
 };

package/dist/packages/agents/lib/executors.js

@@ -26,6 +26,7 @@ export function createLocalAgentExecutor(agent, executionProfile = {}) {
                 statusLogPath: options?.statusLogPath,
                 executionProfile,
                 completionCheck: options?.completionCheck,
+                onStatus: options?.onStatus,
             });
         },
     };

package/dist/packages/agents/lib/preflight.d.ts

@@ -4,4 +4,5 @@ export declare function runAgentPreflight(agent: Agent, options?: AgentPreflight
 export declare function ensureAgentAutomatedRunReady(agent: Agent, options?: {
     force?: boolean;
     runPreflight?: typeof runAgentPreflight;
+    preflightRetryDelayMs?: number;
 }): AgentAutomationReadiness;

package/dist/packages/agents/lib/preflight.js

@@ -23,6 +23,7 @@ export function runAgentPreflight(agent, options = {}) {
             cwd: dirPath,
             encoding: "utf8",
             env: buildAgentEnv(agent),
+            input: "",
             timeout: timeoutMs,
         });
         const stdout = typeof result.stdout === "string" ? result.stdout.trim() : "";
@@ -56,16 +57,24 @@ export function ensureAgentAutomatedRunReady(agent, options = {}) {
         return { ok: true };
     }
     const runPreflight = options.runPreflight ?? runAgentPreflight;
-    const result = runPreflight(agent);
-    if (!result.ok) {
-        const details = [result.error, result.stderr].filter(Boolean).join(" ");
-        return {
-            ok: false,
-            error: `${agent.displayName} failed Interf executor preflight. Run \`interf doctor --live\` for details.${details ? ` ${details}` : ""}`,
-        };
+    const retryDelayMs = options.preflightRetryDelayMs ?? 1000;
+    let result = null;
+    for (let attempt = 1; attempt <= 3; attempt += 1) {
+        result = runPreflight(agent);
+        if (result.ok) {
+            successfulPreflightAgents.add(agent.name);
+            return { ok: true };
+        }
+        if (!isTransientCodexPreflightFailure(agent, result) || attempt === 3) {
+            break;
+        }
+        sleepSync(retryDelayMs * attempt);
     }
-    successfulPreflightAgents.add(agent.name);
-    return { ok: true };
+    const details = result ? [result.error, result.stderr].filter(Boolean).join(" ") : "";
+    return {
+        ok: false,
+        error: `${agent.displayName} failed Interf executor preflight. Run \`interf doctor --live\` for details.${details ? ` ${details}` : ""}`,
+    };
 }
 function sanitizeAgentStderr(stderr) {
     return stderr
@@ -75,3 +84,17 @@ function sanitizeAgentStderr(stderr) {
         .join("\n")
         .trim();
 }
+function isTransientCodexPreflightFailure(agent, result) {
+    if (agent.name !== "codex")
+        return false;
+    const text = `${result.error ?? ""}\n${result.stderr ?? ""}`;
+    if (/usage limit/i.test(text))
+        return false;
+    return /failed to record rollout items/i.test(text) ||
+        /thread\s+[0-9a-f-]+\s+not found/i.test(text);
+}
+function sleepSync(ms) {
+    if (ms <= 0)
+        return;
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}

package/dist/packages/agents/lib/render.d.ts

@@ -3,6 +3,6 @@ export interface VisibleTextState {
     terminated?: boolean;
     terminalStatus?: string | null;
 }
-export declare function emitVisibleAgentText(text: string, statusLogPath: string | null | undefined, lastVisibleText?: VisibleTextState): boolean;
-export declare function displayAgentEvent(event: Record<string, unknown>, statusLogPath: string | null | undefined, lastVisibleText: VisibleTextState): boolean;
+export declare function emitVisibleAgentText(text: string, statusLogPath: string | null | undefined, lastVisibleText?: VisibleTextState, onStatus?: (line: string) => void): boolean;
+export declare function displayAgentEvent(event: Record<string, unknown>, statusLogPath: string | null | undefined, lastVisibleText: VisibleTextState, onStatus?: (line: string) => void): boolean;
 export declare function summarizeAgentToolActivity(event: Record<string, unknown>): string | null;

package/dist/packages/agents/lib/render.js

@@ -2,7 +2,7 @@ import { basename } from "node:path";
 import chalk from "chalk";
 import { SHOW_AGENT_TOOL_EVENTS, VISIBLE_STATUS_PREFIXES, } from "./constants.js";
 import { appendAgentStatusLog } from "./logs.js";
-export function emitVisibleAgentText(text, statusLogPath, lastVisibleText) {
+export function emitVisibleAgentText(text, statusLogPath, lastVisibleText, onStatus) {
     if (lastVisibleText?.terminated) {
         return false;
     }
@@ -17,6 +17,7 @@ export function emitVisibleAgentText(text, statusLogPath, lastVisibleText) {
         }
         console.log(chalk.dim(`  ${line}`));
         appendAgentStatusLog(statusLogPath, line);
+        onStatus?.(line);
         if (lastVisibleText) {
             lastVisibleText.current = line;
             if (isTerminalVisibleStatus(line)) {
@@ -28,7 +29,7 @@ export function emitVisibleAgentText(text, statusLogPath, lastVisibleText) {
     }
     return displayed;
 }
-export function displayAgentEvent(event, statusLogPath, lastVisibleText) {
+export function displayAgentEvent(event, statusLogPath, lastVisibleText, onStatus) {
     const type = event.type;
     let displayed = false;
     if (type === "tool_use" && SHOW_AGENT_TOOL_EVENTS) {
@@ -50,7 +51,7 @@ export function displayAgentEvent(event, statusLogPath, lastVisibleText) {
             for (const block of content) {
                 if (block.type === "text" && block.text) {
                     const text = block.text.trim();
-                    displayed = emitVisibleAgentText(text, statusLogPath, lastVisibleText) || displayed;
+                    displayed = emitVisibleAgentText(text, statusLogPath, lastVisibleText, onStatus) || displayed;
                 }
                 if (block.type === "tool_use" && SHOW_AGENT_TOOL_EVENTS) {
                     const name = block.name;
@@ -70,7 +71,7 @@ export function displayAgentEvent(event, statusLogPath, lastVisibleText) {
     if (type === "item.started" || type === "item.completed") {
         const item = event.item;
         if (item) {
-            displayed = displayItemEvent(type, item, statusLogPath, lastVisibleText) || displayed;
+            displayed = displayItemEvent(type, item, statusLogPath, lastVisibleText, onStatus) || displayed;
         }
     }
     if (type === "result") {
@@ -79,7 +80,7 @@ export function displayAgentEvent(event, statusLogPath, lastVisibleText) {
         if (result && subtype !== "tool_result") {
             const lines = result.split("\n");
             for (const line of lines) {
-                displayed = emitVisibleAgentText(line, statusLogPath, lastVisibleText) || displayed;
+                displayed = emitVisibleAgentText(line, statusLogPath, lastVisibleText, onStatus) || displayed;
             }
         }
     }
@@ -90,7 +91,7 @@ export function displayAgentEvent(event, statusLogPath, lastVisibleText) {
         pickString(event.summary);
     if (message && type !== "assistant" && type !== "result") {
         const text = message.trim();
-        displayed = emitVisibleAgentText(text, statusLogPath, lastVisibleText) || displayed;
+        displayed = emitVisibleAgentText(text, statusLogPath, lastVisibleText, onStatus) || displayed;
     }
     return displayed;
 }
@@ -129,16 +130,16 @@ function pickString(value) {
     }
     return null;
 }
-function displayItemEvent(type, item, statusLogPath, lastVisibleText) {
+function displayItemEvent(type, item, statusLogPath, lastVisibleText, onStatus) {
     const itemType = item.type;
     if (itemType === "agent_message") {
         const text = item.text?.trim();
-        return text ? emitVisibleAgentText(text, statusLogPath, lastVisibleText) : false;
+        return text ? emitVisibleAgentText(text, statusLogPath, lastVisibleText, onStatus) : false;
     }
     if (itemType === "command_execution" && type === "item.completed") {
         const output = item.aggregated_output?.trim();
         if (output) {
-            return emitVisibleAgentText(output, statusLogPath, lastVisibleText);
+            return emitVisibleAgentText(output, statusLogPath, lastVisibleText, onStatus);
         }
     }
     if (!SHOW_AGENT_TOOL_EVENTS) {

package/dist/packages/agents/lib/shells.d.ts

@@ -1,71 +1,64 @@
-import type { RuntimeContractType, WorkflowImprovementContext } from "../../compiler/lib/schema.js";
-import type { SourceTruthCheck } from "../../project-model/lib/schema.js";
-import { type ContextInterfaceZoneId as WorkflowZoneId } from "../../workflow-package/context-interface.js";
+import type { MethodImprovementContext } from "../../compiler/lib/schema.js";
+import type { RuntimeContractType } from "../../contracts/lib/schema.js";
+import type { SourceReadinessCheck } from "../../project-model/lib/schema.js";
+import { type ContextInterfaceZoneId as MethodZoneId } from "../../method-package/context-interface.js";
 export interface NativeStageDefinition {
     id: string;
     label: string;
     description: string;
     contractType: RuntimeContractType;
     skillDir: string;
-    reads: WorkflowZoneId[];
-    writes: WorkflowZoneId[];
+    reads: MethodZoneId[];
+    writes: MethodZoneId[];
 }
 export declare function writeNativeAgentSurface(rootPath: string, agentsContent: string, skillName: string, skillContent: string): boolean;
-export declare function renderCompiledAgents(compiledPath: string, name: string, workflowId: string, about?: string, options?: {
-    workflowOriginSelected?: string | null;
-    workflowLocalDraft?: boolean;
+export declare function renderCompiledAgents(compiledPath: string, name: string, methodId: string, about?: string, options?: {
+    methodOriginSelected?: string | null;
+    methodLocalDraft?: boolean;
 }): string;
 export declare function renderCompiledQuerySkill(): string;
 export declare function syncStageExecutionShellWrites(compiledPath: string, shellRoot: string, stage: NativeStageDefinition, writeArtifacts?: readonly string[]): void;
 export declare function renderClaudeBootstrap(content: string): string;
-export interface WorkflowAuthoringPreviewInfo {
-    compiledPath: string;
-    compileResult: {
-        ok: boolean;
-        failedStage: string | null;
-    };
-}
-export declare function createWorkflowAuthoringShell(options: {
-    workflowPath: string;
-    workflowId: string;
+export declare function createMethodAuthoringShell(options: {
+    methodPath: string;
+    methodId: string;
     label: string;
-    baseWorkflowId: string;
-    datasetPath: string;
+    referenceMethodId?: string | null;
+    sourceFolderPath: string;
     taskPrompt: string;
-    checks: SourceTruthCheck[];
-    preview?: WorkflowAuthoringPreviewInfo | null;
+    checks: SourceReadinessCheck[];
 }): {
     rootPath: string;
-    workflowBeforePath: string;
-    workflowAfterPath: string;
+    methodBeforePath: string;
+    methodAfterPath: string;
     promptLogPath: string;
     eventLogPath: string;
     statusLogPath: string;
 };
 export declare function pruneStageExecutionShells(compiledPath: string): void;
-export declare function projectCompiledQueryShell(compiledPath: string, compiledName: string, workflowId: string, about?: string, options?: {
-    workflowOriginSelected?: string | null;
-    workflowLocalDraft?: boolean;
+export declare function projectCompiledQueryShell(compiledPath: string, compiledName: string, methodId: string, about?: string, options?: {
+    methodOriginSelected?: string | null;
+    methodLocalDraft?: boolean;
 }): boolean;
 export declare function projectRawTestQueryShell(rootPath: string): boolean;
-export declare function createStageExecutionShell(compiledPath: string, compiledName: string, workflowId: string, stage: NativeStageDefinition, writeArtifacts?: readonly string[]): {
+export declare function createStageExecutionShell(compiledPath: string, compiledName: string, methodId: string, stage: NativeStageDefinition, writeArtifacts?: readonly string[]): {
     rootPath: string;
 };
 export declare function freezeStageExecutionShell(rootPath: string): string | null;
-export declare function createWorkflowImprovementShell(options: {
+export declare function createMethodImprovementShell(options: {
     compiledPath: string;
     compiledName: string;
-    workflowId: string;
+    methodId: string;
     runId: string;
     loopIndex: number;
-    context: WorkflowImprovementContext;
+    context: MethodImprovementContext;
 }): {
     rootPath: string;
     loopRootPath: string;
-    workflowBeforePath: string;
-    workflowAfterPath: string;
+    methodBeforePath: string;
+    methodAfterPath: string;
     promptLogPath: string;
     eventLogPath: string;
     statusLogPath: string;
 };
-export declare function freezeWorkflowImprovementShell(rootPath: string): string | null;
+export declare function freezeMethodImprovementShell(rootPath: string): string | null;