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

package/dist/builtin/subagents/src/runs/inprocess/runtime-support/temp-cleanup.ts

@@ -1,69 +0,0 @@
-/**
- * Startup housekeeping for the subagent runtime temp root.
- *
- * The multi-level route/event pipeline that once wrote into this directory is
- * gone, so nothing creates entries here any more. The scanner stays because
- * users' machines still hold directories written by earlier versions, and
- * nothing else would ever reap them.
- */
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { TEMP_ROOT_DIR } from "../../../shared/types.js";
-
-/**
- * Historical directory name. It must keep matching what earlier versions wrote,
- * or their leftovers become unreachable garbage.
- */
-export const SUBAGENT_RUNTIME_TEMP_DIR = path.join(TEMP_ROOT_DIR, "nested-subagent-events");
-
-/** Whether any entry in the tree rooted at filePath has an mtime at or after cutoff, stopping at the first hit. */
-export function hasEntryNewerThan(filePath: string, cutoff: number): boolean {
-	const stat = fs.statSync(filePath);
-	if (stat.mtimeMs >= cutoff) return true;
-	if (!stat.isDirectory()) return false;
-	return directoryHasEntryNewerThan(filePath, cutoff);
-}
-
-function directoryHasEntryNewerThan(dirPath: string, cutoff: number): boolean {
-	let entries: string[];
-	try {
-		entries = fs.readdirSync(dirPath);
-	} catch {
-		return false;
-	}
-	for (const entry of entries) {
-		const childPath = path.join(dirPath, entry);
-		try {
-			const stat = fs.statSync(childPath);
-			if (stat.mtimeMs >= cutoff) return true;
-			if (stat.isDirectory() && directoryHasEntryNewerThan(childPath, cutoff)) return true;
-		} catch {
-			// Runtime cleanup is best-effort housekeeping.
-		}
-	}
-	return false;
-}
-
-function cleanupOldSubdirectories(root: string, maxAgeDays: number): void {
-	let entries: string[];
-	try {
-		entries = fs.readdirSync(root);
-	} catch (error) {
-		if ((error as NodeJS.ErrnoException).code === "ENOENT") return;
-		throw error;
-	}
-	const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
-	for (const entry of entries) {
-		const entryPath = path.join(root, entry);
-		try {
-			if (!hasEntryNewerThan(entryPath, cutoff)) fs.rmSync(entryPath, { recursive: true, force: true });
-		} catch {
-			// Keep startup resilient if a child process removes or rewrites an entry while scanning.
-		}
-	}
-}
-
-export function cleanupOldSubagentRuntimeDirs(maxAgeDays: number): void {
-	cleanupOldSubdirectories(SUBAGENT_RUNTIME_TEMP_DIR, maxAgeDays);
-}

package/dist/builtin/subagents/src/runs/inprocess.ts

@@ -1 +0,0 @@
-export * from "./inprocess/index.js";

package/dist/builtin/subagents/src/runs/shared/intercom-group.ts

@@ -1,67 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { readRuntimeIntercomGroup } from "@bastani/atomic";
-
-/** Normalize agent-serialized auto-group sentinels without changing real group names. */
-export function normalizeAutoGroupSentinel(group: string | true | undefined): string | true | undefined {
-	if (group === undefined || group === true) return group;
-	const sentinel = group.trim().toLowerCase();
-	return sentinel === "true" || sentinel === "auto" ? true : group;
-}
-
-/** Runtime joins are intentionally inherited before static child policy and stage context. */
-function runtimeIntercomGroup(sessionId: string | undefined): string | undefined {
-	return readRuntimeIntercomGroup(sessionId);
-}
-
-interface OrchestrationCarrier {
-	orchestrationContext?: { intercomGroup?: string } | undefined;
-	subagentPolicy?: { intercomGroup?: string } | undefined;
-	sessionManager?: { getSessionId(): string } | undefined;
-}
-
-/**
- * Read the live joined group before the admitted child or static stage group. The runtime env
- * entry is a deliberate exception to the no-process-env rule for admission capabilities: it
- * carries only the current group so children launched after `join` follow their parent.
- */
-export function inheritedIntercomGroup(ctx: OrchestrationCarrier | undefined): string | undefined {
-	const runtimeGroup = runtimeIntercomGroup(ctx?.sessionManager?.getSessionId());
-	if (runtimeGroup !== undefined) return runtimeGroup;
-	const policyGroup = ctx?.subagentPolicy?.intercomGroup;
-	if (typeof policyGroup === "string" && policyGroup.trim().length > 0) return policyGroup.trim();
-	const group = ctx?.orchestrationContext?.intercomGroup;
-	return typeof group === "string" && group.trim().length > 0 ? group.trim() : undefined;
-}
-
-/**
- * Resolve the intercom group for a spawned subagent child. Explicit task group
- * takes precedence over the inherited current-session group.
- * `true` resolves to `sharedAutoGroup` (a single UUID minted once per parallel
- * set) so every child in the set shares one isolated group. Returns undefined
- * when nothing applies, so the child inherits env/config/default itself.
- */
-export function resolveChildIntercomGroup(
-	explicit: string | true | undefined,
-	inherited: string | undefined,
-	sharedAutoGroup: string | undefined,
-): string | undefined {
-	const normalized = normalizeAutoGroupSentinel(explicit);
-	if (normalized === true) return sharedAutoGroup ?? randomUUID();
-	if (typeof normalized === "string" && normalized.trim().length > 0) return normalized.trim();
-	return inherited;
-}
-
-/**
- * Mint one shared auto-group UUID for a set when the set-level group or any item
- * requested `true`; otherwise undefined. Ensures all `true` items in one parallel
- * set land in the SAME group.
- */
-export function sharedAutoGroupForSet(
-	setGroup: string | true | undefined,
-	items: ReadonlyArray<{ group?: string | true }>,
-): string | undefined {
-	const needsAuto =
-		normalizeAutoGroupSentinel(setGroup) === true ||
-		items.some((item) => normalizeAutoGroupSentinel(item.group) === true);
-	return needsAuto ? randomUUID() : undefined;
-}

package/dist/builtin/subagents/src/runs/shared/long-running-guard.ts

@@ -1,182 +0,0 @@
-import type { ResolvedControlConfig } from "../../shared/types.js";
-import { progressAwareThreshold } from "./progress-trend.js";
-
-interface LongRunningNoticeMetrics {
-	startedAt: number;
-	now: number;
-	turns: number;
-	tokens: number;
-}
-
-type LongRunningTriggerReason = "time_threshold" | "turn_threshold" | "token_threshold";
-
-interface FailedMutatingAttempt {
-	tool: string;
-	path?: string;
-	error: string;
-	ts: number;
-}
-
-interface MutatingFailureState {
-	consecutiveFailures: number;
-	lastFailureAt?: number;
-	recentFailures: FailedMutatingAttempt[];
-	lastMutatingPath?: string;
-	repeatedPathFailures: number;
-}
-
-const MUTATING_BASH_PATTERNS = [
-	/(^|[;&|()\s])rm\s+/,
-	/(^|[;&|()\s])mv\s+/,
-	/(^|[;&|()\s])cp\s+/,
-	/(^|[;&|()\s])mkdir\s+/,
-	/(^|[;&|()\s])touch\s+/,
-	/(^|[;&|()\s])git\s+apply\b/,
-	/(^|[;&|()\s])patch\s+/,
-	/(^|[;&|()\s])sed\s+[^\n;&|]*\s-i\b/,
-	/(^|[;&|()\s])perl\s+[^\n;&|]*\s-pi\b/,
-	/(^|[;&|()]|\n)\s*tee\s+[^|&;]+/,
-	/\b(writeFile|writeFileSync|appendFile|appendFileSync)\b/,
-	/\bwrite_text\s*\(/,
-	/\bopen\s*\([^)]*,\s*["'][wa]/,
-];
-
-const MUTATING_FAILURE_HINTS = [
-	"failed",
-	"error",
-	"no exact match",
-	"did not match",
-	"malformed",
-	"rejected",
-	"unable",
-	"cannot",
-	"could not",
-];
-
-export function resolveCurrentPath(
-	toolName: string | undefined,
-	args: Record<string, unknown> | undefined,
-): string | undefined {
-	if (!toolName || !args) return undefined;
-	const direct = ["path", "file", "filename", "target", "cwd"];
-	for (const key of direct) {
-		const value = args[key];
-		if (typeof value === "string" && value.trim()) return value.trim();
-	}
-	if (toolName === "bash") {
-		const command = typeof args.command === "string" ? args.command : undefined;
-		if (!command) return undefined;
-		const redirect = command.match(/(?:>|>>|tee\s+)(\S+)/);
-		if (redirect?.[1]) return redirect[1];
-	}
-	return undefined;
-}
-
-function hasUnquotedFileRedirection(command: string): boolean {
-	let inSingle = false;
-	let inDouble = false;
-	for (let i = 0; i < command.length; i++) {
-		const char = command[i]!;
-		if (char === "'" && !inDouble) {
-			inSingle = !inSingle;
-			continue;
-		}
-		if (char === '"' && !inSingle) {
-			inDouble = !inDouble;
-			continue;
-		}
-		if (inSingle || inDouble) continue;
-		if (char !== ">") continue;
-		if (command[i - 1] === "-") continue;
-		const isDouble = command[i + 1] === ">";
-		let cursor = i + (isDouble ? 2 : 1);
-		while (cursor < command.length && /\s/.test(command[cursor]!)) cursor++;
-		if (cursor >= command.length) continue;
-		const targetStart = command[cursor]!;
-		if (targetStart === "&" || targetStart === "|" || targetStart === ";") continue;
-		if (targetStart === "(" || targetStart === ")") continue;
-		return true;
-	}
-	return false;
-}
-
-export function isMutatingBashCommand(command: string): boolean {
-	return hasUnquotedFileRedirection(command) || MUTATING_BASH_PATTERNS.some((pattern) => pattern.test(command));
-}
-
-export function isMutatingTool(toolName: string | undefined, args: Record<string, unknown> | undefined): boolean {
-	if (!toolName) return false;
-	if (toolName === "edit" || toolName === "write") return true;
-	if (toolName !== "bash") return false;
-	const command = typeof args?.command === "string" ? args.command : "";
-	if (!command.trim()) return false;
-	return isMutatingBashCommand(command);
-}
-
-export function didMutatingToolFail(text: string): boolean {
-	const lowered = text.toLowerCase();
-	return MUTATING_FAILURE_HINTS.some((hint) => lowered.includes(hint));
-}
-
-export function nextLongRunningTrigger(
-	config: ResolvedControlConfig,
-	metrics: LongRunningNoticeMetrics,
-): LongRunningTriggerReason | undefined {
-	const activeNoticeAfterMs = progressAwareThreshold(config.activeNoticeAfterMs, config.progressScores);
-	if (metrics.now - metrics.startedAt >= activeNoticeAfterMs) return "time_threshold";
-	if (config.activeNoticeAfterTurns !== undefined && metrics.turns >= config.activeNoticeAfterTurns)
-		return "turn_threshold";
-	if (config.activeNoticeAfterTokens !== undefined && metrics.tokens >= config.activeNoticeAfterTokens)
-		return "token_threshold";
-	return undefined;
-}
-
-export function resetMutatingFailureState(state: MutatingFailureState): void {
-	state.consecutiveFailures = 0;
-	state.lastFailureAt = undefined;
-	state.recentFailures = [];
-	state.lastMutatingPath = undefined;
-	state.repeatedPathFailures = 0;
-}
-
-export function createMutatingFailureState(): MutatingFailureState {
-	return {
-		consecutiveFailures: 0,
-		recentFailures: [],
-		repeatedPathFailures: 0,
-	};
-}
-
-export function recordMutatingFailure(
-	state: MutatingFailureState,
-	input: FailedMutatingAttempt,
-	windowMs: number,
-): void {
-	if (state.lastFailureAt === undefined || input.ts - state.lastFailureAt > windowMs) {
-		state.consecutiveFailures = 0;
-		state.recentFailures = [];
-		state.repeatedPathFailures = 0;
-		state.lastMutatingPath = undefined;
-	}
-	state.lastFailureAt = input.ts;
-	state.consecutiveFailures += 1;
-	if (input.path && state.lastMutatingPath === input.path) {
-		state.repeatedPathFailures += 1;
-	} else if (input.path) {
-		state.lastMutatingPath = input.path;
-		state.repeatedPathFailures = 1;
-	}
-	state.recentFailures.push(input);
-	if (state.recentFailures.length > 3) state.recentFailures.shift();
-}
-
-export function shouldEscalateMutatingFailures(state: MutatingFailureState, threshold: number): boolean {
-	return state.consecutiveFailures >= threshold || state.repeatedPathFailures >= threshold;
-}
-
-export function summarizeRecentMutatingFailures(state: MutatingFailureState): string | undefined {
-	if (state.recentFailures.length === 0) return undefined;
-	return state.recentFailures
-		.map((entry) => `${entry.tool}${entry.path ? `(${entry.path})` : ""}: ${entry.error}`)
-		.join(" | ");
-}