@interf/compiler 0.9.1 → 0.9.4

package/dist/index.js

@@ -1,13 +1,15 @@
 export * as compiler from "./packages/compiler/index.js";
-export * as workflowPackage from "./packages/workflow-package/index.js";
-export * as workflowAuthoring from "./packages/workflow-authoring/index.js";
+export * as contracts from "./packages/contracts/index.js";
+export * as methods from "./packages/methods/index.js";
+export * as methodPackage from "./packages/method-package/index.js";
+export * as methodAuthoring from "./packages/method-authoring/index.js";
 export * as execution from "./packages/execution/index.js";
 export * as localService from "./packages/local-service/index.js";
 export * as projectModel from "./packages/project-model/index.js";
 export * as agents from "./packages/agents/index.js";
 export * as testing from "./packages/testing/index.js";
 export { createCompiled, } from "./packages/project-model/interf.js";
-export { compileCompiled, runCompiledSummarize, runCompiledCompile, } from "./packages/compiler/workflows.js";
+export { compileCompiled, runCompiledSummarize, runCompiledCompile, } from "./packages/compiler/method-runs.js";
 export { createRawTestTarget, createCompiledTestTarget, listTestSpecs, loadTestSpec, loadTestSpecFromFile, writeTestSpec, listTestTargets, runTargetTests, runTargetTestsWithJudge, runTargetTestsAuto, saveTargetTestRun, } from "./packages/testing/test.js";
 export { computeCompiledHealth, } from "./packages/compiler/state.js";
 export { SOURCE_FOLDER_CONFIG_FILE, SOURCE_FOLDER_CONFIG_PATH, loadSourceFolderConfig, resolveSourceFolderConfigPath, sourceFolderConfigPath, buildTestSpecFromSourceFolderConfig, } from "./packages/project-model/source-config.js";

package/dist/packages/agents/index.d.ts

@@ -15,4 +15,4 @@ export * as schema from "./lib/schema.js";
 export * as userConfig from "./lib/user-config.js";
 export * as compiledBootstrap from "./lib/compiled-bootstrap.js";
 export type { Agent, } from "./lib/types.js";
-export type { WorkflowExecutionProfile, WorkflowExecutor, WorkflowExecutorKind, } from "./lib/executors.js";
+export type { MethodExecutionProfile, MethodExecutor, MethodExecutorKind, } from "./lib/executors.js";

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

@@ -1,4 +1,4 @@
-import type { WorkflowExecutionProfile } from "./executors.js";
+import type { MethodExecutionProfile } from "./executors.js";
 import type { Agent } from "./types.js";
 export declare function buildAgentEnv(agent: Agent, baseEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
-export declare function buildAgentArgs(agent: Agent, prompt: string, executionProfile?: WorkflowExecutionProfile): string[];
+export declare function buildAgentArgs(agent: Agent, prompt: string, executionProfile?: MethodExecutionProfile): string[];

package/dist/packages/agents/lib/compiled-bootstrap.js

@@ -1,5 +1,6 @@
 import { basename } from "node:path";
 import { readInterfConfig } from "../../project-model/interf-detect.js";
+import { resolveMethodId } from "../../methods/method-resolution.js";
 import { projectCompiledQueryShell, renderClaudeBootstrap } from "./shells.js";
 export { renderClaudeBootstrap };
 export function refreshCompiledBootstrapGuidance(dirPath) {
@@ -7,12 +8,12 @@ export function refreshCompiledBootstrapGuidance(dirPath) {
     if (!config)
         return false;
     const compiledName = config.name ?? basename(dirPath);
-    const workflowId = config.workflow ?? "interf";
-    const workflowOriginSelected = config.workflow_origin?.selected ?? workflowId;
-    const workflowLocalDraft = config.workflow_origin?.local_draft === true;
+    const methodId = resolveMethodId(config);
+    const methodOriginSelected = config.method_origin?.selected ?? methodId;
+    const methodLocalDraft = config.method_origin?.local_draft === true;
     const about = typeof config.about === "string" && config.about.length > 0 ? config.about : undefined;
-    return projectCompiledQueryShell(dirPath, compiledName, workflowId, about, {
-        workflowOriginSelected,
-        workflowLocalDraft,
+    return projectCompiledQueryShell(dirPath, compiledName, methodId, about, {
+        methodOriginSelected,
+        methodLocalDraft,
     });
 }

package/dist/packages/agents/lib/execution-profile.d.ts

@@ -1,6 +1,6 @@
 import type { Argv } from "yargs";
 import type { Agent } from "./types.js";
-import type { WorkflowExecutionProfile } from "./executors.js";
+import type { MethodExecutionProfile } from "./executors.js";
 type AgentLike = Pick<Agent, "name"> | string | null | undefined;
 export declare function addExecutionProfileOptions<T extends Argv>(yargs: T): T;
 type ExecutionProfileArgSource = Record<string, unknown> & {
@@ -10,8 +10,8 @@ type ExecutionProfileArgSource = Record<string, unknown> & {
     timeoutMs?: unknown;
     "timeout-ms"?: unknown;
 };
-export declare function executionProfileFromArgv(argv: ExecutionProfileArgSource): WorkflowExecutionProfile;
-export declare function applyInternalAcceptanceExecutionProfileDefaults(agent: AgentLike, overrides?: WorkflowExecutionProfile): WorkflowExecutionProfile;
-export declare function hasWorkflowExecutionProfile(profile: WorkflowExecutionProfile | null | undefined): boolean;
-export declare function formatWorkflowExecutionProfile(profile: WorkflowExecutionProfile | null | undefined): string | null;
+export declare function executionProfileFromArgv(argv: ExecutionProfileArgSource): MethodExecutionProfile;
+export declare function applyInternalAcceptanceExecutionProfileDefaults(agent: AgentLike, overrides?: MethodExecutionProfile): MethodExecutionProfile;
+export declare function hasMethodExecutionProfile(profile: MethodExecutionProfile | null | undefined): boolean;
+export declare function formatMethodExecutionProfile(profile: MethodExecutionProfile | null | undefined): string | null;
 export {};

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

@@ -1,11 +1,12 @@
+const INTERNAL_ACCEPTANCE_TIMEOUT_MS = 480000;
 const INTERNAL_ACCEPTANCE_DEFAULTS = {
     "claude-code": {
         model: "claude-sonnet-4-6",
         effort: "low",
     },
     codex: {
-        model: "gpt-5.4-mini",
-        effort: "low",
+        model: "gpt-5.3-codex",
+        effort: "high",
     },
 };
 function readAgentName(agent) {
@@ -63,17 +64,17 @@ export function applyInternalAcceptanceExecutionProfileDefaults(agent, overrides
         model: overrides.model ?? defaults?.model ?? null,
         profile,
         effort: explicitEffort ?? (profile ? null : defaults?.effort ?? null),
-        timeoutMs: overrides.timeoutMs ?? null,
+        timeoutMs: overrides.timeoutMs ?? (defaults ? INTERNAL_ACCEPTANCE_TIMEOUT_MS : null),
     };
 }
-export function hasWorkflowExecutionProfile(profile) {
+export function hasMethodExecutionProfile(profile) {
     return Boolean(profile?.model ||
         profile?.profile ||
         profile?.effort ||
         profile?.timeoutMs);
 }
-export function formatWorkflowExecutionProfile(profile) {
-    if (!hasWorkflowExecutionProfile(profile))
+export function formatMethodExecutionProfile(profile) {
+    if (!hasMethodExecutionProfile(profile))
         return null;
     return JSON.stringify({
         ...(profile?.model ? { model: profile.model } : {}),

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

@@ -1,33 +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/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/shells.d.ts

@@ -1,63 +1,64 @@
-import type { RuntimeContractType, WorkflowImprovementContext } from "../../compiler/lib/schema.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 WorkflowZoneId } from "../../workflow-package/context-interface.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 declare function createWorkflowAuthoringShell(options: {
-    workflowPath: string;
-    workflowId: string;
+export declare function createMethodAuthoringShell(options: {
+    methodPath: string;
+    methodId: string;
     label: string;
-    referenceWorkflowId?: string | null;
-    datasetPath: string;
+    referenceMethodId?: string | null;
+    sourceFolderPath: string;
     taskPrompt: string;
     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;