agentic-engineering-harness 0.8.9 → 0.8.10

package/dist/releases/release-1790907037815-15519-ba555be5/utils/process.js

@@ -1,293 +0,0 @@
-import { spawn } from "node:child_process";
-import fs from "node:fs/promises";
-import path from "node:path";
-const toolchainPathCache = new Map();
-export function clearToolchainEnvCache() { toolchainPathCache.clear(); }
-/** Execute one program with literal argv boundaries and no shell parsing. */
-export async function runExecutable(executable, args, options) {
-    return runChild(executable, [...args], false, options);
-}
-/** Execute an explicit shell program. Use only when shell syntax is required. */
-export async function runShell(command, options) {
-    return runChild(command, [], true, options);
-}
-async function runChild(command, args, shell, options) {
-    const started = Date.now();
-    const inherited = { ...process.env, ...(options.env ?? {}) };
-    // Controller identity is authoritative only inside the controller/AEH
-    // process itself. Never leak it into arbitrary shell commands such as
-    // npm test, whose explicit repository root must remain authoritative.
-    // The managed-agent envelope is authoritative only inside the process that
-    // owns it. Repository commands and tools must not inherit it: otherwise a
-    // bounded child can be mistaken for an AEH participant and re-enter the
-    // controller, or observe another operation's routing state.
-    for (const name of [
-        "AEH_OPERATION_ID", "AEH_OPERATION_KIND", "AEH_CONTROL_ROOT", "AEH_OPERATION_STATE_REDIRECT", "AEH_OPERATION_WORKSPACE_ID",
-        "AEH_MANAGED_AGENT", "AEH_LOGICAL_AGENT", "AEH_AGENT_ROLE", "AEH_PARENT_OPERATION_ID", "AEH_PARENT_OPERATION_KIND", "AEH_AGENT_PHASE",
-        "AEH_INTERACTIVE_LEAD", "AEH_ORCHESTRATION_ALLOWED", "AEH_ALLOW_NESTED_OPERATION", "AEH_OPERATION_SUPERVISOR", "AEH_PARENT_AGENT_ID",
-        "AEH_SUPERVISOR_GENERATION", "AEH_CONTEXT_OPERATION_ID", "AEH_CONTEXT_PHASE", "AEH_CONTEXT_ROOT", "AEH_ENTRY_FILE"
-    ])
-        delete inherited[name];
-    if (options.toolchain !== false) {
-        const prefix = await toolchainPathPrefix(options.cwd);
-        if (prefix)
-            inherited.PATH = `${prefix}${path.delimiter}${inherited.PATH ?? ""}`;
-    }
-    return await new Promise((resolve, reject) => {
-        const child = spawn(command, args, {
-            cwd: options.cwd,
-            shell,
-            env: inherited,
-            detached: process.platform !== "win32",
-            stdio: [options.stdin === undefined ? "ignore" : "pipe", "pipe", "pipe"]
-        });
-        let stdout = "";
-        let stderr = "";
-        child.stdout?.on("data", (chunk) => { stdout += chunk.toString(); });
-        child.stderr?.on("data", (chunk) => { stderr += chunk.toString(); });
-        if (options.stdin !== undefined) {
-            child.stdin?.on("error", (error) => { if (error.code !== "EPIPE")
-                reject(error); });
-            child.stdin?.end(options.stdin);
-        }
-        let settled = false;
-        let timer;
-        let killTimer;
-        let forceSettleTimer;
-        let terminated = false;
-        let timedOut = false;
-        let exited = false;
-        let exitCode = null;
-        let exitSignal = null;
-        let unregister = async () => undefined;
-        const registered = registerManagedProcessHandle(child.pid);
-        void registered.then((cleanup) => {
-            unregister = cleanup;
-            if (settled)
-                void unregister();
-        });
-        const kill = (signal) => {
-            try {
-                if (process.platform !== "win32" && child.pid)
-                    process.kill(-child.pid, signal);
-                else
-                    child.kill(signal);
-            }
-            catch { /* process already exited */ }
-        };
-        const terminate = () => {
-            if (terminated)
-                return;
-            terminated = true;
-            kill("SIGTERM");
-            killTimer = setTimeout(() => kill("SIGKILL"), 250);
-            killTimer.unref();
-            forceSettleTimer = setTimeout(() => finish(exitCode ?? 124, exitSignal ?? "SIGKILL", true), 1_000);
-            forceSettleTimer.unref();
-        };
-        if (options.timeoutMs)
-            timer = setTimeout(() => { timedOut = true; terminate(); }, options.timeoutMs);
-        const onAbort = () => terminate();
-        if (options.signal?.aborted)
-            onAbort();
-        else
-            options.signal?.addEventListener("abort", onAbort, { once: true });
-        child.on("error", (error) => {
-            if (settled)
-                return;
-            settled = true;
-            if (timer)
-                clearTimeout(timer);
-            if (killTimer)
-                clearTimeout(killTimer);
-            if (forceSettleTimer)
-                clearTimeout(forceSettleTimer);
-            options.signal?.removeEventListener("abort", onAbort);
-            void unregister().finally(() => reject(error));
-        });
-        child.on("exit", (code, signal) => {
-            exited = true;
-            exitCode = code;
-            exitSignal = signal;
-            if (!settled && !forceSettleTimer) {
-                forceSettleTimer = setTimeout(() => finish(code ?? 1, signal, false), 1_000);
-                forceSettleTimer.unref();
-            }
-        });
-        child.on("close", (code) => {
-            finish(code ?? exitCode ?? 1, exitSignal, false);
-        });
-        function finish(code, signal, forced) {
-            if (settled)
-                return;
-            settled = true;
-            if (timer)
-                clearTimeout(timer);
-            if (killTimer)
-                clearTimeout(killTimer);
-            if (forceSettleTimer)
-                clearTimeout(forceSettleTimer);
-            options.signal?.removeEventListener("abort", onAbort);
-            if (forced || !exited) {
-                child.stdout?.destroy();
-                child.stderr?.destroy();
-                child.stdin?.destroy();
-            }
-            void unregister().finally(() => resolve({
-                exitCode: code,
-                stdout,
-                stderr,
-                durationMs: Date.now() - started,
-                timedOut
-            }));
-        }
-    });
-}
-export async function listManagedProcessHandles(root, operationId) {
-    const directory = managedProcessDirectory(root, operationId);
-    let entries;
-    try {
-        entries = await fs.readdir(directory);
-    }
-    catch {
-        return [];
-    }
-    const handles = [];
-    for (const entry of entries) {
-        if (!entry.endsWith(".json"))
-            continue;
-        try {
-            const value = JSON.parse(await fs.readFile(path.join(directory, entry), "utf8"));
-            if (Number.isInteger(value.pid) && Number(value.pid) > 0) {
-                handles.push({ pid: Number(value.pid), processGroupId: Number.isInteger(value.processGroupId) && Number(value.processGroupId) > 0 ? Number(value.processGroupId) : Number(value.pid) });
-            }
-        }
-        catch { /* stale or partially-written handle */ }
-    }
-    return handles;
-}
-export async function clearManagedProcessHandles(root, operationId) {
-    await fs.rm(managedProcessDirectory(root, operationId), { recursive: true, force: true }).catch(() => undefined);
-}
-export async function terminateManagedProcessGroup(pid, graceMs = 250) {
-    if (!Number.isInteger(pid) || pid <= 0 || pid === process.pid)
-        return;
-    const signal = (value) => {
-        try {
-            if (process.platform !== "win32") {
-                try {
-                    process.kill(-pid, value);
-                }
-                catch {
-                    process.kill(pid, value);
-                }
-            }
-            else
-                process.kill(pid, value);
-        }
-        catch { /* process already exited */ }
-    };
-    signal("SIGTERM");
-    await new Promise((resolve) => setTimeout(resolve, graceMs));
-    signal("SIGKILL");
-}
-export async function registerManagedProcessHandle(pid) {
-    const operationId = process.env.AEH_OPERATION_ID?.trim();
-    const controlRoot = process.env.AEH_CONTROL_ROOT?.trim();
-    if (!pid || !operationId || !controlRoot || process.env.AEH_OPERATION_STATE_REDIRECT !== "1")
-        return async () => undefined;
-    const directory = managedProcessDirectory(controlRoot, operationId);
-    const file = path.join(directory, `${pid}.json`);
-    try {
-        await fs.mkdir(directory, { recursive: true });
-        await fs.writeFile(file, `${JSON.stringify({ pid, processGroupId: pid, startedAt: new Date().toISOString() })}\n`, { flag: "wx" });
-        return async () => { await fs.rm(file, { force: true }).catch(() => undefined); };
-    }
-    catch {
-        return async () => undefined;
-    }
-}
-function managedProcessDirectory(root, operationId) {
-    const safeOperationId = operationId.replace(/[^A-Za-z0-9._-]/g, "_");
-    return path.resolve(root, ".harness", "operations", `${safeOperationId}.processes`);
-}
-export async function commandExists(command, cwd) {
-    return (await resolveExecutable(command, cwd)) !== undefined;
-}
-export async function resolveExecutable(command, cwd) {
-    if (!command.trim())
-        return undefined;
-    const directPath = path.isAbsolute(command) || command.includes(path.sep) || (path.sep === "/" && command.includes("\\"));
-    const prefix = await toolchainPathPrefix(cwd);
-    const searchPath = [prefix, process.env.PATH].filter(Boolean).join(path.delimiter);
-    const directories = directPath ? [path.dirname(path.resolve(cwd, command))] : searchPath.split(path.delimiter).filter(Boolean);
-    const baseName = directPath ? path.basename(command) : command;
-    const extensions = process.platform === "win32"
-        ? ["", ...(process.env.PATHEXT ?? ".EXE;.CMD;.BAT").split(";").filter(Boolean)]
-        : [""];
-    for (const directory of directories) {
-        for (const extension of extensions) {
-            const candidate = path.join(directory, baseName + extension);
-            try {
-                await fs.access(candidate, process.platform === "win32" ? undefined : fs.constants.X_OK);
-                return candidate;
-            }
-            catch { /* try the next executable path */ }
-        }
-    }
-    return undefined;
-}
-async function toolchainPathPrefix(cwd) {
-    const key = path.resolve(cwd);
-    if (toolchainPathCache.has(key))
-        return toolchainPathCache.get(key);
-    const roots = await candidateRoots(key);
-    for (const root of roots) {
-        try {
-            const state = JSON.parse(await fs.readFile(path.join(root, ".harness", "toolchain.state.json"), "utf8"));
-            const valid = [];
-            for (const item of state.binPaths ?? []) {
-                try {
-                    await fs.access(item);
-                    valid.push(item);
-                }
-                catch { /* stale machine-local path */ }
-            }
-            const prefix = valid.length ? valid.join(path.delimiter) : undefined;
-            toolchainPathCache.set(key, prefix);
-            return prefix;
-        }
-        catch { /* try another root */ }
-    }
-    toolchainPathCache.set(key, undefined);
-    return undefined;
-}
-async function candidateRoots(start) {
-    const roots = [];
-    let current = start;
-    while (true) {
-        roots.push(current);
-        const gitFile = path.join(current, ".git");
-        try {
-            const stat = await fs.stat(gitFile);
-            if (stat.isFile()) {
-                const value = await fs.readFile(gitFile, "utf8");
-                const gitDir = value.match(/^gitdir:\s*(.+)\s*$/m)?.[1];
-                if (gitDir) {
-                    const absolute = path.resolve(current, gitDir);
-                    const marker = `${path.sep}.git${path.sep}worktrees${path.sep}`;
-                    const index = absolute.indexOf(marker);
-                    if (index >= 0)
-                        roots.push(absolute.slice(0, index));
-                }
-            }
-        }
-        catch { /* not a worktree root */ }
-        const parent = path.dirname(current);
-        if (parent === current)
-            break;
-        current = parent;
-    }
-    return [...new Set(roots)];
-}
-//# sourceMappingURL=process.js.map

package/dist/releases/release-1790907037815-15519-ba555be5/utils/process.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"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"}

package/dist/releases/release-1790907037815-15519-ba555be5/workers/agentPrompt.d.ts

@@ -1,107 +0,0 @@
-import type { AgentExecutionSelection } from "../agents/types.js";
-import type { HarnessProjectConfig, TaskContract, WorkerSession } from "../core/types.js";
-import { loadOperation } from "../operations/state.js";
-import { type StructuredResultProvenanceV1 } from "./resultGateway.js";
-import { type EffectiveContextCapabilities } from "../context/transport.js";
-import type { ContextFragment } from "../context/types.js";
-import { type DirectWorkerHome } from "./directProcess.js";
-import { type ExecutionAuthorityV1 } from "../security/executionLease.js";
-import { type ExecutionBindingV2, type ExecutionBlueprintV2, type RoleInvocationPolicyV1, type SkillManifestV1 } from "../architecture/executionIdentity.js";
-export interface AgentPromptOptions {
-    outputContract?: string;
-    resumeSessionId?: string;
-    /**
-     * Explicit continuation of an already-bound participant generation on its exact durable session.
-     * A continuation turn may deliver a new event prompt/context to the same session; all other
-     * binding identity (operation, candidate, execution revision, blueprint, policy, controller
-     * epoch, participant generation, runtime session) must still match exactly. Used by the
-     * persistent Operation Supervisor for per-event semantic turns (initialization, consolidation,
-     * watchdog coordination) where the session binding is generation-scoped and each turn is
-     * activated as its own structured-result turn. Never set by participant launch paths.
-     */
-    continueBoundSession?: boolean;
-    /** Actual runtime session observed or reserved before dispatching this turn. */
-    executionSessionId?: string;
-    /** Shared isolated home that owns a prepared direct-runtime session. */
-    directWorkerHome?: DirectWorkerHome;
-    /** Idle Paseo provider session materialized before its first semantic turn. */
-    materializedPaseoSession?: WorkerSession;
-    phase?: string;
-    operationKind?: string;
-    parentAgentId?: string;
-    supervisorAgent?: boolean;
-    contextCapabilities?: EffectiveContextCapabilities;
-    participantId?: string;
-    capabilityAuthority?: ExecutionAuthorityV1;
-    requireExecutionAuthority?: boolean;
-    executionBlueprintDigest?: string;
-    resolvedOperationPolicyDigest?: string;
-    executionBinding?: ExecutionBindingV2;
-    executionBlueprint?: ExecutionBlueprintV2;
-    roleInvocationPolicy?: RoleInvocationPolicyV1;
-    skillManifest?: SkillManifestV1;
-    contextManifest?: Readonly<Record<string, unknown>>;
-    contextManifestDigest?: string;
-    promptManifestDigest?: string;
-    preparedPrompt?: string;
-    structuredResultProvenance?: StructuredResultProvenanceV1;
-}
-export interface CapturedContractValidation {
-    ok: boolean;
-    failure?: string;
-}
-export declare function executeAgentPrompt(root: string, config: HarnessProjectConfig, contract: TaskContract, selection: AgentExecutionSelection, prompt: string, options?: AgentPromptOptions): Promise<WorkerSession>;
-export declare function materializeAgentPrompt(root: string, config: HarnessProjectConfig, contract: TaskContract, selection: AgentExecutionSelection, options?: AgentPromptOptions): Promise<WorkerSession | undefined>;
-export declare function prepareAgentExecutionBinding(root: string, config: HarnessProjectConfig, contract: TaskContract, selection: AgentExecutionSelection, prompt: string, options: AgentPromptOptions): Promise<{
-    binding: ExecutionBindingV2;
-    authority: ExecutionAuthorityV1;
-    prompt: string;
-    contextManifest: Readonly<Record<string, unknown>>;
-    executionBlueprint: ExecutionBlueprintV2;
-    roleInvocationPolicy: RoleInvocationPolicyV1;
-    skillManifest: SkillManifestV1;
-}>;
-export interface PreparedAgentExecutionIdentity {
-    authority: ExecutionAuthorityV1;
-    prompt: string;
-    contextManifest: Readonly<Record<string, unknown>>;
-    contextManifestDigest: string;
-    promptManifestDigest: string;
-    executionBlueprint: ExecutionBlueprintV2;
-    roleInvocationPolicy: RoleInvocationPolicyV1;
-    skillManifest: SkillManifestV1;
-}
-/** Compile all controller-owned identity needed for a remote worker before it acquires its actual runtime session. */
-export declare function prepareAgentExecutionIdentity(root: string, config: HarnessProjectConfig, contract: TaskContract, selection: AgentExecutionSelection, prompt: string, options: AgentPromptOptions): Promise<PreparedAgentExecutionIdentity>;
-export declare function dispatchMaterializedAgentPrompt(root: string, config: HarnessProjectConfig, contract: TaskContract, selection: AgentExecutionSelection, materialized: WorkerSession | undefined, prompt: string, options?: AgentPromptOptions): Promise<WorkerSession>;
-export declare function resumeAgentPrompt(root: string, config: HarnessProjectConfig, contract: TaskContract, selection: AgentExecutionSelection, previous: WorkerSession, prompt: string, options?: Omit<AgentPromptOptions, "resumeSessionId">): Promise<WorkerSession>;
-export declare function validateCapturedAgentContract(contractName: string, stdout: string, stderr?: string): CapturedContractValidation;
-export declare function buildAgentContextFragments(root: string, config: HarnessProjectConfig, contract: TaskContract, selection: AgentExecutionSelection, prompt: string, options?: AgentPromptOptions): Promise<{
-    fragments: ContextFragment[];
-    capabilities: {
-        authorizedRetrieval: boolean;
-        semanticRetrieval: boolean;
-    };
-}>;
-export declare function buildEffectivePrompt(root: string, config: HarnessProjectConfig, contract: TaskContract, selection: AgentExecutionSelection, prompt: string, options?: AgentPromptOptions): Promise<string>;
-export declare function buildEffectivePromptIdentity(root: string, config: HarnessProjectConfig, contract: TaskContract, selection: AgentExecutionSelection, prompt: string, options?: AgentPromptOptions): Promise<{
-    prompt: string;
-    contextManifest: Readonly<Record<string, unknown>>;
-    contextManifestDigest: string;
-    promptManifestDigest: string;
-}>;
-/**
- * The durable operation state root that owns transcripts, accepted structured results, and
- * receipts. Isolated candidate-mutation runs execute in a disposable worktree but must still
- * persist and resolve operation artifacts under the operation's control root.
- */
-export declare function operationArtifactRoot(root: string): string;
-/**
- * Reserve the provider's durable session before freezing ExecutionBinding.
- * OpenCode and Codex have idle-session APIs. Paseo uses the separate managed
- * idle-agent materialization path before binding and first-turn dispatch.
- * Podman prepares the same OpenCode home that is mounted into the hardened
- * execution container.
- */
-export declare function prepareRuntimeSession(root: string, config: HarnessProjectConfig, selection: AgentExecutionSelection, options: AgentPromptOptions, authority: ExecutionAuthorityV1 | undefined, transport: string, onHome?: (home: DirectWorkerHome) => void): Promise<string>;
-export declare function assertResultProvenanceMatchesExecution(provenance: StructuredResultProvenanceV1, operation: Awaited<ReturnType<typeof loadOperation>> | undefined, contract: TaskContract, selection: AgentExecutionSelection, options: AgentPromptOptions, continuation?: boolean): void;