@bastani/atomic 0.9.16-alpha.2 → 0.9.16-alpha.3

package/dist/builtin/subagents/src/runs/foreground/detached-cleanup-barrier.ts

@@ -1,26 +0,0 @@
-/** Defers run-owned resource cleanup until every detached child closes. */
-export function createDetachedCleanupBarrier(onReady: () => void): {
-	readonly recover: (index: number) => void;
-	readonly defer: (indices: readonly number[]) => boolean;
-} {
-	const recovered = new Set<number>();
-	let expected: ReadonlySet<number> | undefined;
-	let cleaned = false;
-	const finishIfReady = () => {
-		if (cleaned || !expected || ![...expected].every((index) => recovered.has(index))) return;
-		cleaned = true;
-		onReady();
-	};
-	return {
-		recover(index) {
-			recovered.add(index);
-			finishIfReady();
-		},
-		defer(indices) {
-			if (indices.length === 0) return false;
-			expected = new Set(indices);
-			finishIfReady();
-			return true;
-		},
-	};
-}

package/dist/builtin/subagents/src/runs/foreground/execution-detach-reservations.ts

@@ -1,58 +0,0 @@
-import type { IntercomDetachRoute } from "./execution-detach-route.js";
-
-interface Reservation {
-	route: IntercomDetachRoute;
-	timer: ReturnType<typeof setTimeout>;
-}
-
-function identity(event: IntercomDetachRoute): string | undefined {
-	if (
-		typeof event.requestId !== "string" ||
-		event.requestId.length === 0 ||
-		typeof event.messageId !== "string" ||
-		event.messageId.length === 0 ||
-		typeof event.senderId !== "string" ||
-		event.senderId.length === 0 ||
-		typeof event.runtimeGeneration !== "number"
-	)
-		return undefined;
-	return `${event.requestId}\0${event.messageId}\0${event.senderId}\0${event.runtimeGeneration}`;
-}
-
-function sameRoute(left: IntercomDetachRoute, right: IntercomDetachRoute): boolean {
-	return (
-		left.requestId === right.requestId &&
-		left.messageId === right.messageId &&
-		left.senderId === right.senderId &&
-		left.runtimeGeneration === right.runtimeGeneration &&
-		left.childIntercomTarget === right.childIntercomTarget
-	);
-}
-
-export class IntercomDetachReservations {
-	private readonly entries = new Map<string, Reservation>();
-
-	reserve(event: IntercomDetachRoute): boolean {
-		const key = identity(event);
-		if (!key || this.entries.has(key)) return false;
-		const timer = setTimeout(() => this.entries.delete(key), 1000);
-		timer.unref?.();
-		this.entries.set(key, { route: event, timer });
-		return true;
-	}
-
-	commit(event: IntercomDetachRoute): boolean {
-		const key = identity(event);
-		if (!key) return false;
-		const reservation = this.entries.get(key);
-		if (!reservation || !sameRoute(event, reservation.route)) return false;
-		clearTimeout(reservation.timer);
-		this.entries.delete(key);
-		return true;
-	}
-
-	clear(): void {
-		for (const reservation of this.entries.values()) clearTimeout(reservation.timer);
-		this.entries.clear();
-	}
-}

package/dist/builtin/subagents/src/runs/foreground/execution-detach-route.ts

@@ -1,19 +0,0 @@
-export interface IntercomDetachRoute {
-	phase?: unknown;
-	requestId?: unknown;
-	messageId?: unknown;
-	senderId?: unknown;
-	childIntercomTarget?: unknown;
-	runtimeGeneration?: unknown;
-}
-
-export function matchesIntercomDetachRoute(
-	event: IntercomDetachRoute,
-	expected: { childIntercomTarget?: string },
-): boolean {
-	return (
-		typeof event.childIntercomTarget === "string" &&
-		event.childIntercomTarget.length > 0 &&
-		event.childIntercomTarget === expected.childIntercomTarget
-	);
-}

package/dist/builtin/subagents/src/runs/foreground/execution-intercom-detach.ts

@@ -1,51 +0,0 @@
-import {
-	INTERCOM_DETACH_REQUEST_EVENT,
-	INTERCOM_DETACH_RESPONSE_EVENT,
-	type RunSyncOptions,
-} from "../../shared/types.js";
-import { IntercomDetachReservations } from "./execution-detach-reservations.js";
-import { type IntercomDetachRoute, matchesIntercomDetachRoute } from "./execution-detach-route.js";
-
-interface ExecutionIntercomDetachState {
-	readonly isUnavailable: () => boolean;
-	readonly isDetached: () => boolean;
-	readonly detach: () => void;
-}
-
-/** Registers exact-owner and foreground-group detach listeners for one live child attempt. */
-export function registerExecutionIntercomDetach(
-	options: RunSyncOptions,
-	state: ExecutionIntercomDetachState,
-): () => void {
-	const reservations = new IntercomDetachReservations();
-	const unsubscribe = options.intercomEvents?.on?.(INTERCOM_DETACH_REQUEST_EVENT, (payload) => {
-		if (!options.allowIntercomDetach || state.isUnavailable()) return;
-		if (!payload || typeof payload !== "object") return;
-		const event = payload as IntercomDetachRoute;
-		if (
-			typeof event.requestId !== "string" ||
-			!matchesIntercomDetachRoute(event, {
-				childIntercomTarget: options.intercomSessionName,
-			})
-		)
-			return;
-		if (event.phase === "probe") {
-			if (state.isDetached() || !reservations.reserve(event)) return;
-			options.intercomEvents?.emit?.(INTERCOM_DETACH_RESPONSE_EVENT, { ...event, accepted: true });
-			return;
-		}
-		if (event.phase !== "commit" || state.isDetached() || !reservations.commit(event)) return;
-		options.onIntercomDetachCommit?.();
-		state.detach();
-		options.intercomEvents?.emit?.(INTERCOM_DETACH_RESPONSE_EVENT, { ...event, accepted: true });
-	});
-	const detachSibling = () => state.detach();
-	options.intercomDetachSignal?.addEventListener("abort", detachSibling, { once: true });
-	if (options.intercomDetachSignal?.aborted) detachSibling();
-
-	return () => {
-		reservations.clear();
-		unsubscribe?.();
-		options.intercomDetachSignal?.removeEventListener("abort", detachSibling);
-	};
-}

package/dist/builtin/subagents/src/runs/foreground/execution-parent-ask-handoff.ts

@@ -1,78 +0,0 @@
-import {
-	PARENT_ASK_HANDOFF_REQUEST_EVENT,
-	type ParentAskHandoffRequest,
-	type RunSyncOptions,
-} from "../../shared/types.js";
-
-interface ExecutionParentAskState {
-	readonly agent: string;
-	readonly isUnavailable: () => boolean;
-}
-
-const PROCESS_PARENT_ASK_CLAIMS = Symbol.for("atomic/subagents/parent-ask-claims@1");
-
-type ProcessParentAskClaimHandler = (payload: unknown) => void;
-
-interface ProcessParentAskClaimRegistry {
-	handlers: Set<ProcessParentAskClaimHandler>;
-}
-
-function processClaimSlots(): typeof globalThis & Record<symbol, ProcessParentAskClaimRegistry | undefined> {
-	return globalThis as typeof globalThis & Record<symbol, ProcessParentAskClaimRegistry | undefined>;
-}
-
-function registerProcessClaimHandler(handler: ProcessParentAskClaimHandler): () => void {
-	const slots = processClaimSlots();
-	const registry = slots[PROCESS_PARENT_ASK_CLAIMS] ?? { handlers: new Set<ProcessParentAskClaimHandler>() };
-	slots[PROCESS_PARENT_ASK_CLAIMS] = registry;
-	registry.handlers.add(handler);
-	return () => {
-		registry.handlers.delete(handler);
-		if (registry.handlers.size === 0 && slots[PROCESS_PARENT_ASK_CLAIMS] === registry) {
-			delete slots[PROCESS_PARENT_ASK_CLAIMS];
-		}
-	};
-}
-
-function isParentAskHandoffRequest(payload: unknown): payload is ParentAskHandoffRequest {
-	if (!payload || typeof payload !== "object" || Array.isArray(payload)) return false;
-	const request = payload as Partial<ParentAskHandoffRequest>;
-	return (
-		typeof request.runId === "string" &&
-		typeof request.index === "number" &&
-		typeof request.agent === "string" &&
-		typeof request.childIntercomTarget === "string" &&
-		typeof request.orchestratorTarget === "string" &&
-		(request.kind === "decision" || request.kind === "interview" || request.kind === "intercom") &&
-		typeof request.question === "string" &&
-		typeof request.claimed === "boolean"
-	);
-}
-
-/** Claim a blocking ask only for the exact live child attempt that issued it. */
-export function registerExecutionParentAskHandoff(options: RunSyncOptions, state: ExecutionParentAskState): () => void {
-	if (!options.onParentAskHandoff) return () => {};
-	const handleRequest = (payload: unknown): void => {
-		if (state.isUnavailable() || !isParentAskHandoffRequest(payload)) return;
-		if (
-			payload.claimed ||
-			payload.runId !== options.runId ||
-			payload.index !== (options.index ?? 0) ||
-			payload.agent !== state.agent ||
-			payload.childIntercomTarget !== options.intercomSessionName ||
-			payload.orchestratorTarget !== options.orchestratorIntercomTarget
-		)
-			return;
-		payload.claimed = true;
-		options.onParentAskHandoff?.(payload);
-	};
-	const eventCleanup = options.intercomEvents?.on(PARENT_ASK_HANDOFF_REQUEST_EVENT, handleRequest) ?? (() => {});
-	const processCleanup = registerProcessClaimHandler(handleRequest);
-	let cleaned = false;
-	return () => {
-		if (cleaned) return;
-		cleaned = true;
-		eventCleanup();
-		processCleanup();
-	};
-}

package/dist/builtin/subagents/src/runs/foreground/execution-run-sync.ts

@@ -1 +0,0 @@
-export { runSingleInProcess, runSync } from "./inprocess-run-sync.js";

package/dist/builtin/subagents/src/runs/foreground/execution-updates.ts

@@ -1,26 +0,0 @@
-import type { AgentToolResult } from "@earendil-works/pi-agent-core";
-import type { Details } from "../../shared/types.js";
-import { isRetryableModelFailure } from "../shared/model-fallback.js";
-
-export type RunSyncUpdate = AgentToolResult<Details>;
-
-function extractUpdateText(update: RunSyncUpdate): string | undefined {
-	const text = update.content
-		.map((item) => (item.type === "text" ? item.text : undefined))
-		.filter((item): item is string => Boolean(item?.trim()))
-		.join("\n");
-	return text || undefined;
-}
-
-function terminalUpdateFailureText(update: RunSyncUpdate): string | undefined {
-	const result = update.details?.results?.[0];
-	if (!result) return undefined;
-	const progress = update.details?.progress?.[0];
-	const status = result.progress?.status ?? progress?.status;
-	if (status !== "failed") return undefined;
-	return result.error ?? result.progress?.error ?? progress?.error ?? extractUpdateText(update);
-}
-
-export function shouldSuppressIntermediateRetryableFailureUpdate(update: RunSyncUpdate): boolean {
-	return isRetryableModelFailure(terminalUpdateFailureText(update));
-}

package/dist/builtin/subagents/src/runs/foreground/execution-utils.ts

@@ -1,61 +0,0 @@
-import type { AgentProgress, SingleResult, Usage } from "../../shared/types.js";
-
-export const artifactOutputByResult = new WeakMap<SingleResult, string>();
-export const modelFailureSignalByResult = new WeakMap<SingleResult, unknown>();
-
-export function emptyUsage(): Usage {
-	return { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: 0 };
-}
-
-export function sumUsage(target: Usage, source: Usage): void {
-	target.input += source.input;
-	target.output += source.output;
-	target.cacheRead += source.cacheRead;
-	target.cacheWrite += source.cacheWrite;
-	target.cost += source.cost;
-	target.turns += source.turns;
-}
-
-export function appendRecentOutput(progress: AgentProgress, lines: string[]): void {
-	if (lines.length === 0) return;
-	progress.recentOutput.push(...lines.filter((line) => line.trim()));
-	if (progress.recentOutput.length > 50) {
-		progress.recentOutput.splice(0, progress.recentOutput.length - 50);
-	}
-}
-
-export function snapshotProgress(progress: AgentProgress): AgentProgress {
-	return {
-		...progress,
-		skills: progress.skills ? [...progress.skills] : undefined,
-		recentTools: progress.recentTools.map((tool) => ({ ...tool })),
-		recentOutput: [...progress.recentOutput],
-	};
-}
-
-export function snapshotResult(result: SingleResult, progress: AgentProgress): SingleResult {
-	return {
-		...result,
-		messages:
-			result.outputMode === "file-only" && result.savedOutputPath
-				? undefined
-				: result.messages
-					? [...result.messages]
-					: undefined,
-		usage: { ...result.usage },
-		skills: result.skills ? [...result.skills] : undefined,
-		attemptedModels: result.attemptedModels ? [...result.attemptedModels] : undefined,
-		modelAttempts: result.modelAttempts
-			? result.modelAttempts.map((attempt) => ({
-					...attempt,
-					usage: attempt.usage ? { ...attempt.usage } : undefined,
-				}))
-			: undefined,
-		controlEvents: result.controlEvents ? result.controlEvents.map((event) => ({ ...event })) : undefined,
-		progress,
-		progressSummary: result.progressSummary ? { ...result.progressSummary } : undefined,
-		artifactPaths: result.artifactPaths ? { ...result.artifactPaths } : undefined,
-		truncation: result.truncation ? { ...result.truncation } : undefined,
-		outputReference: result.outputReference ? { ...result.outputReference } : undefined,
-	};
-}

package/dist/builtin/subagents/src/runs/foreground/execution.ts

@@ -1,6 +0,0 @@
-/**
- * Public foreground subagent execution API.
- */
-
-export { runSync } from "./execution-run-sync.js";
-export { shouldSuppressIntermediateRetryableFailureUpdate } from "./execution-updates.js";