agentic-engineering-harness 0.8.9 → 0.8.11

package/dist/releases/release-1791006063459-16409-661eedf2/paseo/deterministicSession.js

@@ -0,0 +1,145 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { evaluateFinalQualityGate } from "../agents/qualityConvergence.js";
+import { executeOperation, startDetachedOperation } from "../operations/controller.js";
+import { loadOperation } from "../operations/state.js";
+import { notifyOperationCompletion } from "../operations/completion.js";
+import { runExternalToolValidator } from "../validators/external.js";
+import { startPaseoHarness } from "./start.js";
+import { loadResolvedAgentTopology } from "../agents/config.js";
+import { intentDecisionFromHeuristic } from "../audit/intent.js";
+import { assertIntentDecisionForRoute, parseIntentDecision } from "../audit/intentDecision.js";
+import { answerInformationalRequest } from "../informational/answer.js";
+const SESSION_FILE = ".harness/paseo/deterministic-session.json";
+/**
+ * A deterministic Paseo SDK boundary for black-box and packaged journeys.
+ * The normal start path remains unchanged; this boundary replaces only the
+ * external daemon/model conversation with a file-backed fake SDK session.
+ */
+export async function startDeterministicPaseoHarness(root, config, options = {}) {
+    const result = await startPaseoHarness(root, config, options, {
+        run: async (command) => command.includes("daemon status")
+            ? { exitCode: 0, stdout: JSON.stringify({ localDaemon: "running", connectedDaemon: "not_probed" }), stderr: "", durationMs: 1 }
+            : { exitCode: 1, stdout: "", stderr: "deterministic fake Paseo command boundary", durationMs: 1 },
+        commandExists: async () => true,
+        setupToolchain: async () => ({ profile: "deterministic" }),
+        loadTopology: loadResolvedAgentTopology,
+        detectCapabilities: async () => ({ version: "deterministic", background: true, quiet: true, json: true, outputSchema: true, daemonJson: true, nativeToolsRecommended: true }),
+        launchAgent: async (_projectRoot, launchOptions) => ({ id: `deterministic-lead-${launchOptions.labels?.["aeh.generation"] ?? "1"}`, exitCode: 0, stdout: "", stderr: "", status: "idle", transport: "sdk" }),
+        probeAgent: async () => true
+    });
+    const sessionFile = path.resolve(root, SESSION_FILE);
+    const previous = await readSession(sessionFile);
+    const session = result.session === "reused" && previous ? { ...previous, agentId: result.agentId } : { version: 1, agentId: result.agentId, turns: [] };
+    await writeSession(sessionFile, session);
+    return { ...result, transport: "sdk" };
+}
+export async function runDeterministicPaseoTurn(root, config, prompt, scriptedDecision) {
+    const normalizedPrompt = prompt.trim();
+    if (!normalizedPrompt)
+        throw new Error("aeh paseo turn requires a non-empty simulated user prompt.");
+    const sessionFile = path.resolve(root, SESSION_FILE);
+    const session = await readSession(sessionFile);
+    if (!session)
+        throw new Error(`No deterministic Paseo lead session exists at ${sessionFile}. Run aeh start --deterministic first.`);
+    const userTurnId = `${session.agentId}:turn-${session.turns.filter((turn) => turn.role === "user").length + 1}`;
+    // Deterministic journeys must normally receive a scripted lead decision. The
+    // lexical fallback is retained only for old compatibility callers and is
+    // explicitly marked non-authoritative in the resulting durable decision.
+    const semanticDecision = parseIntentDecision(scriptedDecision ?? intentDecisionFromHeuristic(config, { request: normalizedPrompt }, userTurnId));
+    const decision = semanticDecision.userTurnId ? semanticDecision : parseIntentDecision({ ...semanticDecision, userTurnId });
+    session.turns.push({ id: userTurnId, prompt: normalizedPrompt, role: "user", content: normalizedPrompt, decision, at: new Date().toISOString() });
+    await writeSession(sessionFile, session);
+    if (decision.intent === "informational") {
+        assertIntentDecisionForRoute(decision, "informational");
+        const answer = await answerInformationalRequest(root, config, normalizedPrompt);
+        session.turns.push({ prompt: normalizedPrompt, role: "system", content: answer.human, at: new Date().toISOString() });
+        await writeSession(sessionFile, session);
+        return {
+            version: 1,
+            intent: "informational",
+            session: { agentId: session.agentId, state: "idle", turnCount: session.turns.filter((turn) => turn.role === "user").length },
+            userTurn: { id: userTurnId, prompt: normalizedPrompt, accepted: true },
+            decision,
+            validation: { status: "NOT_APPLICABLE", checks: [] },
+            completion: { status: "NOT_APPLICABLE", agentId: session.agentId, attempts: 0 },
+            lead: { wakeReceived: false, message: answer.human },
+            supervisorSpawned: false,
+            answer,
+            human: answer.human
+        };
+    }
+    if (decision.intent !== "audit")
+        throw new Error(`DETERMINISTIC_SEMANTIC_ROUTE_UNSUPPORTED: ${decision.intent}`);
+    assertIntentDecisionForRoute(decision, "audit");
+    const operation = await startDetachedOperation(root, "audit", { request: normalizedPrompt, risk: "low", intentDecision: decision }, {
+        nodeExecutable: process.execPath,
+        entryFile: process.argv[1] ?? "aeh",
+        completionAgentId: session.agentId,
+        completionSource: "deterministic-paseo-sdk",
+        initiator: { kind: "LEAD", agentId: session.agentId, userTurnId, requestEventId: `${session.agentId}:deterministic-turn:${userTurnId}` },
+        spawnProcess: (() => ({ pid: process.pid, unref: () => undefined }))
+    });
+    let wakeMessage = "";
+    const terminal = await executeOperation(root, operation.id, {
+        run: async () => ({ exitCode: 1, stdout: "", stderr: "deterministic fake Paseo workspace boundary", durationMs: 1 }),
+        runAudit: deterministicAudit,
+        startWatchdog: () => () => undefined,
+        notifyCompletion: async (operationRoot, completed) => {
+            const delivered = await notifyOperationCompletion(operationRoot, completed, {
+                retryDelaysMs: [0],
+                sleep: async () => undefined,
+                trace: async () => undefined,
+                dispatch: async (_dispatchRoot, agentId, message) => { wakeMessage = message; return { id: agentId, exitCode: 0, stdout: "accepted", stderr: "", status: "working", transport: "sdk" }; }
+            });
+            if (!delivered || delivered.status !== "SENT")
+                throw new Error("deterministic lead completion callback was not delivered");
+        }
+    });
+    const current = await loadOperation(root, terminal.id);
+    const completion = JSON.parse(await fs.readFile(path.resolve(root, ".harness/operations", `${terminal.id}.completion.json`), "utf8"));
+    session.turns.push({ prompt: normalizedPrompt, role: "system", content: wakeMessage, at: new Date().toISOString() });
+    await writeSession(sessionFile, session);
+    const checks = Array.isArray(current.result?.validationChecks) ? current.result.validationChecks : [{ id: "deterministic-validation", status: current.status === "SUCCEEDED" ? "PASS" : "FAIL", message: current.status === "SUCCEEDED" ? "deterministic validation passed" : current.error ?? "operation failed" }];
+    const validationStatus = checks.some((check) => check.status === "FAIL") ? "FAIL" : "PASS";
+    const result = {
+        version: 1,
+        intent: "audit",
+        session: { agentId: session.agentId, state: wakeMessage ? "received-completion" : "idle", turnCount: session.turns.filter((turn) => turn.role === "user").length },
+        userTurn: { id: userTurnId, prompt: normalizedPrompt, accepted: true },
+        decision,
+        operation: { id: current.id, kind: "audit", status: current.status, phase: current.phase, revision: current.revision, result: current.result },
+        validation: { status: validationStatus, checks },
+        completion,
+        lead: { wakeReceived: Boolean(wakeMessage), message: wakeMessage },
+        supervisorSpawned: false,
+        human: `DETERMINISTIC PASEO: user turn accepted; operation ${current.id} ${current.status}; validation ${validationStatus}; completion ${completion.status}; lead ${wakeMessage ? "received terminal wake" : "not woken"}.`
+    };
+    return result;
+}
+async function deterministicAudit(root, config, input) {
+    const contract = { version: 1, task: { id: input.auditId ?? "DETERMINISTIC-AUDIT", title: input.request } };
+    const command = `${JSON.stringify(process.execPath)} -e ${JSON.stringify("process.stdout.write('{}')")}`;
+    const check = await runExternalToolValidator({ root, config, contract, spec: { id: "deterministic-validation", adapter: "command", command, required: true }, baseRef: config.validation?.baseRef ?? "HEAD", changedFiles: [] });
+    const validationChecks = [{ ...check, failureClass: check.status === "PASS" ? "NONE" : "TOOL_FAILURE" }];
+    const qualityGate = evaluateFinalQualityGate([], config);
+    const now = new Date().toISOString();
+    const report = {
+        version: 1, auditId: input.auditId ?? "DETERMINISTIC-AUDIT", intent: "audit", intentDecision: input.intentDecision, request: input.request, status: check.status === "PASS" ? "CLEAN" : "DEGRADED", startedAt: now, finishedAt: now,
+        repository: { root, baseRef: config.validation?.baseRef ?? "HEAD", dirtyPaths: [] }, reviewers: ["deterministic-reviewer"], validationChecks, findings: [], counts: qualityGate.counts, debtPoints: qualityGate.debtPoints, debtScore: qualityGate.debtScore, qualityGate, productionSafe: check.status === "PASS", sessions: [{ id: "deterministic-reviewer", provider: "fake-paseo-sdk", model: "deterministic", logicalAgent: "reviewer", runtime: "fake", transport: "sdk", status: "completed", exitCode: 0, stdout: "{}", stderr: "" }], restoredPaths: []
+    };
+    const file = path.resolve(root, ".harness", "audits", `${report.auditId}.json`);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await fs.writeFile(file, `${JSON.stringify(report, null, 2)}\n`);
+    return report;
+}
+async function readSession(file) {
+    try {
+        return JSON.parse(await fs.readFile(file, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeSession(file, session) { await fs.mkdir(path.dirname(file), { recursive: true }); await fs.writeFile(file, `${JSON.stringify(session, null, 2)}\n`); }
+//# sourceMappingURL=deterministicSession.js.map

package/dist/releases/release-1791006063459-16409-661eedf2/paseo/deterministicSession.js.map

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

package/dist/releases/release-1791006063459-16409-661eedf2/paseo/launchSpec.d.ts

@@ -0,0 +1,58 @@
+import { type OpenCodeAgentBindingSource } from "../agents/permissions.js";
+import type { AgentExecutionSelection } from "../agents/types.js";
+import type { HarnessProjectConfig, TaskContract } from "../core/types.js";
+import type { PaseoSdkMcpStdioServer, PaseoSdkToolPolicy } from "./sdk.js";
+import { type EffectiveContextCapabilities } from "../context/transport.js";
+import type { CapabilityLeaseV1 } from "../security/authorityV2.js";
+import { type ExecutionBindingV3, type ParticipantScratchLeaseV1 } from "../architecture/executionIdentity.js";
+export interface PaseoLaunchSpecOptions {
+    selection?: AgentExecutionSelection;
+    logicalAgent?: string;
+    provider?: string;
+    model?: string;
+    titlePrefix?: string;
+    phase?: string;
+    kind?: string;
+    parentAgentId?: string;
+    supervisorAgent?: boolean;
+    contextCapabilities?: EffectiveContextCapabilities;
+    providerTurnDeadlineMs?: number;
+    supervisorSessionId?: string;
+    participantId?: string;
+    candidateDigest?: string;
+    capabilityLeases?: CapabilityLeaseV1[];
+    executionBinding?: ExecutionBindingV3;
+    scratchLease?: ParticipantScratchLeaseV1;
+    executionBlueprintDigest?: string;
+    roleInvocationPolicyDigest?: string;
+    skillManifestDigest?: string;
+    contextManifestDigest?: string;
+    promptManifestDigest?: string;
+}
+export interface PaseoAgentLaunchSpec {
+    cwd: string;
+    title: string;
+    provider: string;
+    model?: string;
+    modeId?: string;
+    modeSource?: OpenCodeAgentBindingSource;
+    thinkingOptionId?: string;
+    env?: Record<string, string>;
+    nativeAgentId?: string;
+    workspaceId?: string;
+    parentAgentId?: string;
+    /** Paseo parent handle; omitted for isolated launches so the provider cannot relocate the cwd. */
+    paseoParentAgentId?: string;
+    supervisorGeneration?: number;
+    labels: Record<string, string>;
+    timeoutSeconds: number;
+    operationId: string;
+    operationKind: string;
+    phase: string;
+    mcpServers?: Record<string, PaseoSdkMcpStdioServer>;
+    toolPolicy?: PaseoSdkToolPolicy;
+    providerOptions?: Record<string, unknown>;
+    featureValues?: Record<string, unknown>;
+}
+export declare function compilePaseoAgentLaunchSpec(root: string, config: HarnessProjectConfig, contract: TaskContract, options?: PaseoLaunchSpecOptions): Promise<PaseoAgentLaunchSpec>;
+export declare function inferAgentPhase(selection: AgentExecutionSelection | undefined, logicalAgent: string): string;

package/dist/releases/release-1791006063459-16409-661eedf2/paseo/launchSpec.js

@@ -0,0 +1,280 @@
+import { compileOpenCodeRuntimeProjection } from "../agents/permissions.js";
+import { worktreeGitRoots } from "../core/git.js";
+import { deliveryWorkspaceId } from "../delivery/handoff.js";
+import { buildManagedAgentEnvironment } from "../operations/executionContext.js";
+import { activeOperationSupervisor, currentOperationContext, loadOperation } from "../operations/state.js";
+import { staticContextCapabilities } from "../context/transport.js";
+import { managedSerenaPool } from "../runtime/serenaPool.js";
+import { SERENA_VERSION } from "../context/repository/serena.js";
+import { createHash } from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { assertExecutionBindingV3, assertParticipantScratchLeaseV1 } from "../architecture/executionIdentity.js";
+export async function compilePaseoAgentLaunchSpec(root, config, contract, options = {}) {
+    const selection = options.selection;
+    const worker = config.orchestration?.worker;
+    const logicalAgent = options.logicalAgent ?? selection?.logicalAgent ?? "worker";
+    const provider = options.provider ?? selection?.paseoProvider ?? worker?.provider ?? "opencode";
+    const model = options.model ?? (selection ? selection.runtimeAdapter === "codex" ? selection.modelName : selection.modelId : worker?.model);
+    const operation = currentOperationContext();
+    const operationId = operation.id ?? contract.task.id;
+    const operationKind = operation.kind ?? options.kind ?? inferOperationKind(contract);
+    const phase = options.phase ?? inferAgentPhase(selection, logicalAgent);
+    const deliveryId = await deliveryWorkspaceId(root, config, contract.task.id);
+    const title = `${options.titlePrefix ?? worker?.titlePrefix ?? "aeh"}-${contract.task.id}-${logicalAgent}`;
+    const controlRoot = process.env.AEH_CONTROL_ROOT?.trim() || root;
+    const durable = operation.id ? await loadOperation(controlRoot, operation.id).catch(() => undefined) : undefined;
+    // A session may only claim an operation workspace when a durable operation positively proves
+    // the launch root is its workspace root. Isolated candidate-mutation launches run in a
+    // disposable worktree and must not bind the provider session to the operation workspace, and an
+    // unloadable operation must never be treated as proof of a matching workspace.
+    const durableWorkspaceRoot = durable?.workspaceRoot ? await canonicalRootOrResolved(durable.workspaceRoot) : undefined;
+    const launchRoot = durableWorkspaceRoot ? await canonicalRootOrResolved(root) : undefined;
+    const withinOperationWorkspace = durableWorkspaceRoot !== undefined && launchRoot === durableWorkspaceRoot;
+    const workspaceId = withinOperationWorkspace ? (deliveryId ?? operation.workspaceId) : undefined;
+    const activeSupervisor = durable ? activeOperationSupervisor(durable) : undefined;
+    const supervisorAgent = options.supervisorAgent === true || logicalAgent === "operation-supervisor";
+    const parentAgentId = options.parentAgentId ?? (supervisorAgent ? durable?.lead?.agentId : activeSupervisor?.agentId);
+    const supervisorGeneration = supervisorAgent ? undefined : activeSupervisor?.generation;
+    // Paseo child agents inherit the parent agent's workspace AND run in the parent's cwd. An isolated
+    // launch (task worktree outside the durable operation workspace) must never carry the Paseo parent
+    // handle, or the provider silently executes the isolated turn inside the operation candidate
+    // workspace (AEH-V2-0117). Correlation stays in `aeh.parent-agent`; only the Paseo parent is dropped.
+    const isolatedLaunch = durableWorkspaceRoot !== undefined && launchRoot !== undefined && launchRoot !== durableWorkspaceRoot;
+    const paseoParentAgentId = isolatedLaunch ? undefined : parentAgentId;
+    const contextCapabilities = options.contextCapabilities ?? (selection ? staticContextCapabilities(config, selection) : undefined);
+    const scratchLease = options.scratchLease ?? options.executionBinding?.scratchLease;
+    if (scratchLease) {
+        assertParticipantScratchLeaseV1(scratchLease);
+        if (!selection || scratchLease.operationId !== operationId || scratchLease.participantId !== options.participantId || scratchLease.candidateDigest !== candidateDigestFrom(options) || (selection.permissions.write !== "allow" && selection.permissions.shell !== "allow") || options.capabilityLeases && scratchLease.capabilityLeases.some((lease) => !options.capabilityLeases.some((candidate) => candidate.leaseId === lease.leaseId)))
+            throw new Error("PASEO_SCRATCH_AUTHORITY_MISMATCH: exact scratch lease is outside the frozen participant operation or capability envelope.");
+        if (options.executionBinding && options.executionBinding.scratchLease?.digest !== scratchLease.digest)
+            throw new Error("PASEO_SCRATCH_BINDING_MISMATCH: launch scratch differs from the frozen ExecutionBinding.");
+    }
+    else if (options.executionBinding?.scratchLease) {
+        throw new Error("PASEO_SCRATCH_BINDING_MISMATCH: a binding with scratch authority requires the same launch resource.");
+    }
+    // Provider sessions may be relocated by Paseo to the registered workspace root while the frozen
+    // participant was launched against an isolated task worktree (AEH-V2-0116). The provider must be
+    // able to reach exactly the roots the participant is authorized to use: the launch root and the
+    // git metadata directories of that worktree. Nothing else is projected.
+    const authorizedRoots = selection ? [...new Set([root, ...(await gitRootsOrEmpty(root)), ...(scratchLease ? [scratchLease.path] : [])])].sort() : undefined;
+    // The control root holds the operation's durable state (contract/seal copies, findings, reports,
+    // operation record). Read-only participants (Reviewer/Planner/Explorer) verify their evidence
+    // against those files, and Paseo may have relocated the provider project root, so those reads are
+    // otherwise gated behind `external_directory`. Only roles with denied write authority receive the
+    // control root as an external read scope; mutating participants keep exactly their frozen launch
+    // root plus git metadata so no provider write can reach the durable control plane (AEH-V2-0119).
+    const externalRoots = selection && selection.permissions?.write === "deny" && controlRoot && controlRoot !== root
+        ? [...new Set([...(authorizedRoots ?? []), path.resolve(controlRoot)])].sort()
+        : authorizedRoots;
+    const openCode = selection?.runtimeAdapter === "opencode" && provider === "opencode" ? compileOpenCodeRuntimeProjection(selection, config, contextCapabilities, externalRoots, root, `${operationId}:${logicalAgent}`) : undefined;
+    const providerOptions = selection && provider === "codex" ? codexProviderOptions(selection, authorizedRoots) : undefined;
+    const explicitOpenCodeMode = openCode && !openCode.binding.managed ? openCode.binding.agentId : undefined;
+    const executionEnv = buildManagedAgentEnvironment({ logicalAgent, role: selection?.role ?? "worker", operationId, operationKind, phase, interactiveLead: false, orchestrationAllowed: false });
+    const mcpEntry = process.env.AEH_ENTRY_FILE?.trim() || process.argv[1];
+    const mcpServers = contextMcpServers(root, config, selection, logicalAgent, operationId, phase, contextCapabilities, options.participantId, controlRoot) ?? {};
+    const preapprovedTools = [];
+    if (mcpServers["aeh-context"])
+        preapprovedTools.push({ kind: "mcp", server: "aeh-context", tool: "aeh_context_retrieve" });
+    if (supervisorAgent && options.supervisorSessionId && mcpEntry) {
+        mcpServers["aeh-supervisor"] = {
+            type: "stdio",
+            command: process.execPath,
+            args: [mcpEntry, "operation", "supervisor-mcp"],
+            env: { AEH_CONTROL_ROOT: controlRoot, AEH_OPERATION_ID: operationId, AEH_OPERATION_SUPERVISOR: "1", AEH_SUPERVISOR_SESSION_ID: options.supervisorSessionId },
+            alwaysLoad: true
+        };
+        preapprovedTools.push({ kind: "mcp", server: "aeh-supervisor", tool: "aeh_supervisor_recovery_decide" });
+    }
+    const toolPolicy = preapprovedTools.length ? { preapproved: preapprovedTools } : undefined;
+    // Paseo provider sessions stop on their own tool-approval prompt even when the AEH projection has
+    // already decided the exact tool surface; a stalled session returns no structured result and used
+    // to be reported as a successful empty turn (AEH-V2-0110). Auto-accept is enabled only when the
+    // deterministic projection contains no operator-declared `ask`, so it can never auto-approve a
+    // decision the operator reserved for a human.
+    const permissionDecisions = selection ? Object.values(selection.permissions ?? {}) : [];
+    const featureValues = selection && permissionDecisions.length > 0 && permissionDecisions.every((decision) => decision !== "ask")
+        ? { auto_accept: true }
+        : undefined;
+    if (parentAgentId)
+        executionEnv.AEH_PARENT_AGENT_ID = parentAgentId;
+    if (supervisorGeneration !== undefined)
+        executionEnv.AEH_SUPERVISOR_GENERATION = String(supervisorGeneration);
+    if (supervisorAgent)
+        executionEnv.AEH_OPERATION_SUPERVISOR = "1";
+    if (options.participantId)
+        executionEnv.AEH_PARTICIPANT_ID = options.participantId;
+    const candidateDigest = options.candidateDigest ?? options.capabilityLeases?.[0]?.candidate.identityDigest;
+    if (candidateDigest)
+        executionEnv.AEH_CANDIDATE_DIGEST = candidateDigest;
+    if (options.capabilityLeases?.length)
+        executionEnv.AEH_CAPABILITY_LEASES = JSON.stringify(options.capabilityLeases);
+    if (scratchLease) {
+        executionEnv.TMPDIR = scratchLease.path;
+        executionEnv.TEMP = scratchLease.path;
+        executionEnv.TMP = scratchLease.path;
+        executionEnv.AEH_SCRATCH_RESOURCE = scratchLease.resourceId;
+        executionEnv.AEH_SCRATCH_DIGEST = scratchLease.digest;
+    }
+    if (options.executionBinding) {
+        assertExecutionBindingV3(options.executionBinding);
+        if (options.executionBinding.operationId !== operationId || options.executionBinding.participantId !== options.participantId || options.executionBinding.candidateDigest !== candidateDigest || options.executionBinding.runtime.runtimeId !== selection?.runtimeName || options.executionBinding.runtime.modelId !== selection?.modelId)
+            throw new Error("EXECUTION_BINDING_MISMATCH: Paseo launch spec does not match the frozen participant binding.");
+        executionEnv.AEH_EXECUTION_BINDING = JSON.stringify(options.executionBinding);
+        executionEnv.AEH_CONTEXT_MANIFEST_DIGEST = options.executionBinding.contextManifestDigest;
+        executionEnv.AEH_PROMPT_MANIFEST_DIGEST = options.executionBinding.promptManifestDigest;
+        executionEnv.AEH_SKILL_MANIFEST_DIGEST = options.executionBinding.skillManifestDigest;
+    }
+    executionEnv.AEH_CONTROL_ROOT = controlRoot;
+    const labels = {
+        "aeh.project": config.project.name,
+        "aeh.kind": supervisorAgent ? "supervisor" : "worker",
+        "aeh.task": contract.task.id,
+        "aeh.role": logicalAgent,
+        "aeh.operation": operationId,
+        "aeh.operation.kind": operationKind,
+        "aeh.operation.phase": phase,
+        "aeh.provider": provider
+    };
+    if (workspaceId)
+        labels["aeh.workspace.id"] = workspaceId;
+    if (selection?.profile)
+        labels["aeh.profile"] = selection.profile;
+    if (selection?.outputContract)
+        labels["aeh.output.contract"] = selection.outputContract;
+    if (durable)
+        labels["aeh.operation.revision"] = String(durable.revision);
+    if (parentAgentId)
+        labels["aeh.parent-agent"] = parentAgentId;
+    if (supervisorGeneration !== undefined)
+        labels["aeh.supervisor.generation"] = String(supervisorGeneration);
+    if (supervisorAgent)
+        labels["aeh.supervisor"] = "true";
+    if (options.participantId)
+        labels["aeh.participant"] = options.participantId;
+    if (candidateDigest)
+        labels["aeh.candidate"] = candidateDigest;
+    if (options.executionBlueprintDigest)
+        labels["aeh.execution.blueprint.digest"] = options.executionBlueprintDigest;
+    if (options.roleInvocationPolicyDigest)
+        labels["aeh.role.invocation.policy.digest"] = options.roleInvocationPolicyDigest;
+    if (options.skillManifestDigest)
+        labels["aeh.skill.manifest.digest"] = options.skillManifestDigest;
+    if (options.contextManifestDigest)
+        labels["aeh.context.manifest.digest"] = options.contextManifestDigest;
+    if (options.promptManifestDigest)
+        labels["aeh.prompt.manifest.digest"] = options.promptManifestDigest;
+    if (scratchLease)
+        labels["aeh.scratch.digest"] = scratchLease.digest;
+    if (options.executionBinding) {
+        labels["aeh.execution.binding"] = JSON.stringify(options.executionBinding);
+        labels["aeh.execution.binding.digest"] = options.executionBinding.digest;
+        labels["aeh.execution.binding.phase"] = "BOUND";
+        labels["aeh.context.manifest.digest"] = options.executionBinding.contextManifestDigest;
+        labels["aeh.prompt.manifest.digest"] = options.executionBinding.promptManifestDigest;
+        labels["aeh.skill.manifest.digest"] = options.executionBinding.skillManifestDigest;
+    }
+    if (openCode) {
+        labels["aeh.native-agent"] = openCode.binding.agentId;
+        labels["aeh.native-agent.source"] = openCode.binding.source;
+    }
+    if (workspaceId && workspaceId === operation.workspaceId && !deliveryId)
+        labels["aeh.workspace.kind"] = "orchestration";
+    if (workspaceId && deliveryId)
+        labels["aeh.workspace.kind"] = "delivery";
+    return {
+        cwd: root,
+        title,
+        provider,
+        model,
+        modeId: explicitOpenCodeMode,
+        modeSource: explicitOpenCodeMode ? openCode?.binding.source : undefined,
+        thinkingOptionId: selection?.runtimeCapabilities?.variantSelection === false ? undefined : selection?.variant,
+        env: { ...(openCode?.env ?? {}), ...executionEnv },
+        nativeAgentId: openCode?.binding.agentId,
+        workspaceId,
+        parentAgentId,
+        paseoParentAgentId,
+        supervisorGeneration,
+        labels,
+        timeoutSeconds: Math.max(1, Math.ceil((options.providerTurnDeadlineMs ?? durable?.resolvedOperationPolicy?.executionLiveness.providerTurnDeadlineMs ?? config.orchestration?.operations?.liveness?.providerTurnDeadlineMs ?? 30 * 60_000) / 1000)),
+        ...(Object.keys(mcpServers).length ? { mcpServers } : {}),
+        ...(toolPolicy ? { toolPolicy } : {}),
+        ...(providerOptions ? { providerOptions } : {}),
+        ...(featureValues ? { featureValues } : {}),
+        operationId,
+        operationKind,
+        phase
+    };
+}
+function candidateDigestFrom(options) {
+    return options.executionBinding?.candidateDigest ?? options.candidateDigest ?? options.capabilityLeases?.[0]?.candidate.identityDigest;
+}
+function contextMcpServers(root, config, selection, logicalAgent, operationId, phase, capabilities, participantId, controlRoot = root) {
+    if (!config.context || !selection)
+        return undefined;
+    const servers = {};
+    const entry = process.env.AEH_ENTRY_FILE?.trim() || process.argv[1];
+    if (entry && capabilities?.mcpServers.context && participantId)
+        servers["aeh-context"] = { type: "stdio", command: process.execPath, args: [entry, "context", "mcp"], env: { AEH_CONTEXT_ROOT: root, AEH_CONTEXT_CONTROL_ROOT: controlRoot, AEH_CONTEXT_OPERATION_ID: operationId, AEH_CONTEXT_PARTICIPANT_ID: participantId, AEH_LOGICAL_AGENT: logicalAgent, AEH_CONTEXT_PHASE: phase }, alwaysLoad: true };
+    if (capabilities?.mcpServers.serena) {
+        const canEdit = selection?.permissions.write === "allow" && (selection.role === "Implementer" || selection.role === "Repairer");
+        const projectId = `project:${createHash("sha256").update(root).digest("hex").slice(0, 24)}`;
+        const workspaceId = process.env.AEH_OPERATION_WORKSPACE_ID?.trim() || operationId;
+        const session = managedSerenaPool.acquire({ projectId, canonicalRoot: root, workspaceId, serenaVersion: SERENA_VERSION, ownerId: `${operationId}:${logicalAgent}`, access: canEdit ? "write" : "read", editingEnabled: canEdit });
+        const pooled = session.mcpServer;
+        servers.serena = { type: "stdio", command: pooled.command?.[0] ?? process.execPath, args: pooled.command?.slice(1), env: pooled.environment, alwaysLoad: true, toolPolicy: session.editingEnabled ? { allow: ["*"], deny: [] } : { allow: session.allowedTools, deny: session.deniedTools } };
+    }
+    return Object.keys(servers).length ? servers : undefined;
+}
+export function inferAgentPhase(selection, logicalAgent) {
+    const role = selection?.role ?? "";
+    const name = logicalAgent.toLowerCase();
+    if (role === "Operation Supervisor" || name.includes("operation-supervisor"))
+        return "supervision";
+    if (role === "Planner")
+        return "planning";
+    if (role === "Reviewer")
+        return "review";
+    if (role === "Repairer")
+        return "diagnosis";
+    if (role === "Spec Manager")
+        return "spec-authoring";
+    if (role === "Implementer")
+        return "implementation";
+    return "work";
+}
+function inferOperationKind(contract) {
+    const intent = contract.routing?.intent?.trim();
+    if (intent === "audit")
+        return "audit";
+    if (intent)
+        return intent;
+    return contract.routing?.route === "DIRECT" ? "direct" : contract.routing?.route === "DELEGATED" ? "delegated" : contract.routing?.route === "FORMAL_SDD" ? "formal-sdd" : "run";
+}
+async function gitRootsOrEmpty(root) {
+    return worktreeGitRoots(root).catch(() => []);
+}
+/**
+ * Map the compiled permission ceiling to the Codex provider's deterministic sandbox.
+ * `approval_policy: never` means the provider never stops on a human approval prompt;
+ * operations outside the projected sandbox fail closed instead of being approved. The
+ * sandbox mode follows the same read/write/shell/network authority as the tool ceiling.
+ */
+function codexProviderOptions(selection, authorizedRoots) {
+    const p = selection.permissions ?? {};
+    const mutating = p.write === "allow" || p.shell === "allow" || p.gitWrite === "allow";
+    return {
+        approval_policy: "never",
+        sandbox_mode: mutating ? "workspace-write" : "read-only",
+        ...(mutating && authorizedRoots?.length
+            ? { sandbox_workspace_write: { writable_roots: authorizedRoots, network_access: p.network === "allow", exclude_slash_tmp: true } }
+            : {})
+    };
+}
+async function canonicalRootOrResolved(value) {
+    const resolved = path.resolve(value);
+    return fs.realpath(resolved).catch(() => resolved);
+}
+//# sourceMappingURL=launchSpec.js.map

package/dist/releases/release-1791006063459-16409-661eedf2/paseo/launchSpec.js.map

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

package/dist/releases/release-1791006063459-16409-661eedf2/paseo/native.d.ts

@@ -0,0 +1,78 @@
+import { type PaseoSdkPermissionStop } from "./sdk.js";
+import { type PaseoTimelineEventEnvelopeV1 } from "../telemetry/paseoTimeline.js";
+import type { ProviderTelemetryEvidenceV2 } from "../telemetry/efficiency.js";
+export interface PaseoNativeUsage {
+    inputTokens?: number;
+    cachedInputTokens?: number;
+    outputTokens?: number;
+    totalCostUsd?: number;
+    contextWindowMaxTokens?: number;
+    contextWindowUsedTokens?: number;
+}
+export interface PaseoNativeAgentSnapshot {
+    id: string;
+    status?: string;
+    workspaceId?: string;
+    /** Paseo's host-owned timestamp for the most recent inbound user turn. */
+    lastUserMessageAt?: string;
+    labels?: Record<string, string>;
+    lastUsage?: PaseoNativeUsage;
+    raw: Record<string, unknown>;
+}
+export interface PaseoContextUsageSnapshot {
+    used?: number;
+    limit?: number;
+    ratio?: number;
+    source: "paseo-agent-snapshot";
+    availability: "available" | "no-usage-yet" | "provider-usage-unavailable";
+}
+export interface PaseoProviderPreflightResult {
+    ok: boolean;
+    provider: string;
+    model?: string;
+    providerStatus?: string;
+    availableModels?: string[];
+    source: "paseo-provider-snapshot" | "paseo-provider-models" | "paseo-provider-diagnostic" | "paseo-provider-unchecked";
+    message: string;
+}
+export interface PaseoNativeWaitResult {
+    id: string;
+    workspaceId?: string;
+    status?: string;
+    lastMessage?: string;
+    error?: string;
+    permission?: PaseoSdkPermissionStop;
+    efficiencyTelemetry?: ProviderTelemetryEvidenceV2;
+    source: "paseo-agent-subscription";
+    updatesObserved: number;
+}
+export interface PaseoTurnBaseline {
+    lastAssistantMessage?: string;
+    lastUserMessageAt?: string;
+}
+export interface NativeAgentHandle {
+    readonly id: string;
+    latest?(): Record<string, unknown> | null;
+    refetch?(requestId?: string): Promise<{
+        agent: Record<string, unknown>;
+        project?: unknown;
+    } | null>;
+    refresh?(requestId?: string): Promise<{
+        agent: Record<string, unknown>;
+        project?: unknown;
+    } | null>;
+    subscribe?(handler: (update: unknown) => void): () => void;
+    timeline?: {
+        refetch(options?: Record<string, unknown>): Promise<unknown>;
+        subscribe?(handler: (event: unknown) => void): (() => void) & {
+            ready?: Promise<void>;
+        };
+    };
+}
+export declare function inspectPaseoNativeAgent(root: string, agentId: string): Promise<PaseoNativeAgentSnapshot | undefined>;
+export declare function normalizePaseoNativeAgent(raw: Record<string, unknown>): PaseoNativeAgentSnapshot;
+export declare function contextUsageFromPaseoSnapshot(snapshot: PaseoNativeAgentSnapshot): PaseoContextUsageSnapshot;
+export declare function capturePaseoAgentTurnBaseline(root: string, agentId: string): Promise<PaseoTurnBaseline>;
+export declare function preflightPaseoProviderModel(root: string, providerValue: string, modelValue?: string, cwd?: string): Promise<PaseoProviderPreflightResult>;
+export declare function waitForPaseoAgentNative(root: string, agentId: string, timeoutMs?: number, baseline?: PaseoTurnBaseline): Promise<PaseoNativeWaitResult>;
+export declare function waitForPaseoAgentHandle(handle: NativeAgentHandle, timeoutMs?: number, baseline?: PaseoTurnBaseline, pollIntervalMs?: number, captureEfficiencyTelemetry?: boolean, onTimelineActivity?: (sessionId: string, envelope: PaseoTimelineEventEnvelopeV1) => Promise<void>): Promise<PaseoNativeWaitResult>;