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

package/dist/builtin/subagents/src/shared/settings.ts

@@ -1,118 +0,0 @@
-/** Shared behavior, progress, and task instruction helpers. */
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-import type { AgentConfig } from "../agents/agents.js";
-import type { OutputMode } from "./types.js";
-
-const INITIAL_PROGRESS_CONTENT = "# Progress\n\n## Status\nIn Progress\n\n## Tasks\n\n## Files Changed\n\n## Notes\n";
-
-export interface ResolvedStepBehavior {
-	output: string | false;
-	outputMode: OutputMode;
-	reads: string[] | false;
-	progress: boolean;
-	skills: string[] | false;
-	model?: string;
-}
-
-export interface StepOverrides {
-	output?: string | false;
-	outputMode?: OutputMode;
-	reads?: string[] | false;
-	progress?: boolean;
-	skills?: string[] | false;
-	model?: string;
-}
-
-function normalizeOutputOverride(output: string | false | undefined): string | false | undefined {
-	return output === "false" ? false : output;
-}
-
-export function resolveStepBehavior(agentConfig: AgentConfig, stepOverrides: StepOverrides): ResolvedStepBehavior {
-	const stepOutput = normalizeOutputOverride(stepOverrides.output);
-	const output = stepOutput !== undefined ? stepOutput : (normalizeOutputOverride(agentConfig.output) ?? false);
-	const reads = stepOverrides.reads !== undefined ? stepOverrides.reads : (agentConfig.defaultReads ?? false);
-	const progress =
-		stepOverrides.progress !== undefined ? stepOverrides.progress : (agentConfig.defaultProgress ?? false);
-
-	let skills: string[] | false;
-	if (stepOverrides.skills === false) skills = false;
-	else if (stepOverrides.skills !== undefined) skills = [...stepOverrides.skills];
-	else skills = agentConfig.skills ? [...agentConfig.skills] : [];
-
-	const outputMode = stepOverrides.outputMode ?? "inline";
-	const model = stepOverrides.model ?? agentConfig.model;
-	return { output, outputMode, reads, progress, skills, model };
-}
-
-export function taskDisallowsFileUpdates(task: string | undefined): boolean {
-	if (!task) return false;
-	return (
-		/\breview[- ]only\b/i.test(task) ||
-		/\bread[- ]only\s+(?:review|audit|inspection|pass)\b/i.test(task) ||
-		/\b(?:no|without)\s+(?:file\s+)?edits?\b/i.test(task) ||
-		/\b(?:do not|don't|must not)\s+(?:edit|modify|write|touch)\b/i.test(task) ||
-		/\bleave\s+files?\s+unchanged\b/i.test(task)
-	);
-}
-
-export function suppressProgressForReadOnlyTask(
-	behavior: ResolvedStepBehavior,
-	task: string | undefined,
-): ResolvedStepBehavior {
-	return behavior.progress && taskDisallowsFileUpdates(task) ? { ...behavior, progress: false } : behavior;
-}
-
-export function resolveSingleProgress(
-	agentConfig: AgentConfig,
-	override: boolean | undefined,
-	task: string | undefined,
-): boolean {
-	const behavior = resolveStepBehavior(agentConfig, { progress: override });
-	return override !== undefined ? behavior.progress : suppressProgressForReadOnlyTask(behavior, task).progress;
-}
-
-export function buildReadInstruction(reads: string[] | false | undefined, cwd: string): string {
-	if (!reads || reads.length === 0) return "";
-	const files = reads.map((file) => path.resolve(cwd, file));
-	return `[Read from: ${files.join(", ")}]`;
-}
-
-export function writeInitialProgressFile(progressDir: string): void {
-	fs.mkdirSync(progressDir, { recursive: true });
-	fs.writeFileSync(path.join(progressDir, "progress.md"), INITIAL_PROGRESS_CONTENT);
-}
-
-export function injectSingleProgressInstruction(task: string, progressDir: string): string {
-	return `${task}\n\n---\nCreate and maintain progress at: ${path.join(progressDir, "progress.md")}`;
-}
-
-export function buildTaskInstructions(
-	behavior: ResolvedStepBehavior,
-	cwd: string,
-	isFirstProgressAgent: boolean,
-): { prefix: string; suffix: string } {
-	const prefixParts: string[] = [];
-	const suffixParts: string[] = [];
-	const readInstruction = buildReadInstruction(behavior.reads, cwd);
-	if (readInstruction) prefixParts.push(readInstruction);
-
-	if (behavior.output) {
-		const outputPath = path.isAbsolute(behavior.output) ? behavior.output : path.join(cwd, behavior.output);
-		prefixParts.push(`[Write to: ${outputPath}]`);
-	}
-
-	if (behavior.progress) {
-		const progressPath = path.join(cwd, "progress.md");
-		if (isFirstProgressAgent) suffixParts.push(`Create and maintain progress at: ${progressPath}`);
-		else suffixParts.push(`Update progress at: ${progressPath}`);
-	}
-
-	const prefix = prefixParts.length > 0 ? `${prefixParts.join("\n")}\n\n` : "";
-	const suffix = suffixParts.length > 0 ? `\n\n---\n${suffixParts.join("\n")}` : "";
-	return { prefix, suffix };
-}
-
-export type { ParallelTaskResult } from "../runs/shared/parallel-utils.js";
-export { aggregateParallelOutputs } from "../runs/shared/parallel-utils.js";

package/dist/builtin/subagents/src/shared/status-format.ts

@@ -1,50 +0,0 @@
-import type { ActivityState } from "./types.js";
-
-type StepStatus = "pending" | "running" | "complete" | "completed" | "failed" | "interrupted";
-type StepStatusLike = { status: StepStatus };
-
-function formatActivityAge(ms: number): string {
-	if (ms < 1000) return "now";
-	if (ms < 60000) return `${Math.floor(ms / 1000)}s`;
-	return `${Math.floor(ms / 60000)}m`;
-}
-
-export function formatActivityLabel(
-	lastActivityAt: number | undefined,
-	activityState?: ActivityState,
-	now = Date.now(),
-): string | undefined {
-	if (lastActivityAt === undefined) {
-		if (activityState === "needs_attention") return "needs attention";
-		if (activityState === "active_long_running") return "active but long-running";
-		return undefined;
-	}
-	const age = formatActivityAge(Math.max(0, now - lastActivityAt));
-	if (activityState === "needs_attention") return `no activity for ${age}`;
-	if (activityState === "active_long_running") return `active but long-running · last activity ${age} ago`;
-	return age === "now" ? "active now" : `active ${age} ago`;
-}
-
-function isCompletedStepStatus(status: StepStatus): boolean {
-	return status === "complete" || status === "completed";
-}
-
-export function formatAgentRunningLabel(count: number): string {
-	return count === 1 ? "1 agent running" : `${count} agents running`;
-}
-
-export function formatParallelOutcome(
-	steps: StepStatusLike[],
-	total: number,
-	options: { showRunning?: boolean } = {},
-): string {
-	const running = steps.filter((step) => step.status === "running").length;
-	const done = steps.filter((step) => isCompletedStepStatus(step.status)).length;
-	const failed = steps.filter((step) => step.status === "failed").length;
-	const interrupted = steps.filter((step) => step.status === "interrupted").length;
-	const parts = [`${done}/${total} done`];
-	if (options.showRunning !== false && running > 0) parts.unshift(formatAgentRunningLabel(running));
-	if (failed > 0) parts.push(`${failed} failed`);
-	if (interrupted > 0) parts.push(`${interrupted} interrupted`);
-	return parts.join(" · ");
-}

package/dist/builtin/subagents/src/shared/types-config.ts

@@ -1,206 +0,0 @@
-/**
- * Configuration, execution option, display, and event bus types.
- */
-
-import type { AgentSessionEvent, SessionWorkflowMetadata } from "@bastani/atomic";
-import type { AgentToolResult } from "@earendil-works/pi-agent-core";
-import type { CandidateModelResolver } from "./model-resolution.js";
-import type {
-	ArtifactConfig,
-	ControlConfig,
-	ControlEvent,
-	Details,
-	MaxOutputConfig,
-	OutputMode,
-	ResolvedControlConfig,
-	SingleResult,
-} from "./types-results.js";
-
-// ============================================================================
-// Display
-// ============================================================================
-
-export type DisplayItem =
-	| { type: "text"; text: string }
-	| { type: "tool"; name: string; args: Record<string, unknown> };
-
-// ============================================================================
-// Error Handling
-// ============================================================================
-
-export interface ErrorInfo {
-	hasError: boolean;
-	exitCode?: number;
-	errorType?: string;
-	details?: string;
-}
-
-export interface IntercomEventBus {
-	on(channel: string, handler: (data: unknown) => void): () => void;
-	emit(channel: string, data: unknown): void;
-}
-
-export const INTERCOM_DETACH_REQUEST_EVENT = "pi-intercom:detach-request";
-export const PARENT_ASK_HANDOFF_REQUEST_EVENT = "subagent:parent-ask-handoff-request";
-export const SUBAGENT_COMPLETE_EVENT = "subagent:complete";
-export const INTERCOM_DETACH_RESPONSE_EVENT = "pi-intercom:detach-response";
-export const SUBAGENT_CONTROL_EVENT = "subagent:control-event";
-export const SUBAGENT_CONTROL_INTERCOM_EVENT = "subagent:control-intercom";
-export const SUBAGENT_RESULT_INTERCOM_EVENT = "subagent:result-intercom";
-export const SUBAGENT_TERMINAL_ORDERING_BARRIER_EVENT = "subagent:terminal-ordering-barrier";
-export const SUBAGENT_RESULT_INTERCOM_DELIVERY_EVENT = "subagent:result-intercom-delivery";
-
-export type ParentAskKind = "decision" | "interview" | "intercom";
-
-export interface ParentAskInterviewQuestion extends Record<string, unknown> {
-	id: string;
-	type: "single" | "multi" | "text" | "image" | "info";
-	question: string;
-	options?: unknown[];
-}
-
-export interface ParentAskInterviewRequest extends Record<string, unknown> {
-	title?: string;
-	description?: string;
-	questions: ParentAskInterviewQuestion[];
-}
-
-export interface ParentAskAttachment {
-	type: "file" | "snippet" | "context";
-	name: string;
-	content: string;
-	language?: string;
-}
-
-export interface ParentAskHandoffRequest {
-	runId: string;
-	index: number;
-	agent: string;
-	childIntercomTarget: string;
-	orchestratorTarget: string;
-	kind: ParentAskKind;
-	question: string;
-	attachments?: ParentAskAttachment[];
-	interview?: ParentAskInterviewRequest;
-	resolvedTargetId?: string;
-	/** Original delegated task supplied by the parent model for a fresh-child handoff. */
-	taskContext?: string;
-	claimed: boolean;
-}
-
-// ============================================================================
-// Execution Options
-// ============================================================================
-
-export interface RunSyncOptions {
-	cwd?: string;
-	signal?: AbortSignal;
-	interruptSignal?: AbortSignal;
-	allowIntercomDetach?: boolean;
-	intercomEvents?: IntercomEventBus;
-	onDetachedExit?: (result: SingleResult) => void;
-	/** Shared foreground-group signal used to release sibling supervision after one exact child commits Intercom detach. */
-	intercomDetachSignal?: AbortSignal;
-	/** Releases every active foreground sibling only after this exact child accepts a detach commit. */
-	onIntercomDetachCommit?: () => void;
-	/** Claims a blocking ask from this exact child and ends it with a fresh-child handoff. */
-	onParentAskHandoff?: (request: ParentAskHandoffRequest) => void;
-	onUpdate?: (r: AgentToolResult<Details>) => void;
-	onControlEvent?: (event: ControlEvent) => void;
-	controlConfig?: ResolvedControlConfig;
-	intercomSessionName?: string;
-	orchestratorIntercomTarget?: string;
-	/** Typed supervisor capability issued for this child; never read from environment. */
-	supervisorAuthorization?: {
-		capability: string;
-		supervisorSessionId: string;
-		childName: string;
-	};
-	/** Resolved intercom home group for the spawned child (explicit subagent group or inherited stage group). */
-	intercomGroup?: string;
-	maxOutput?: MaxOutputConfig;
-	artifactsDir?: string;
-	artifactConfig?: ArtifactConfig;
-	runId: string;
-	index?: number;
-	sessionDir?: string;
-	sessionFile?: string;
-	share?: boolean;
-	outputPath?: string;
-	outputMode?: OutputMode;
-	/** Current session depth passed to the in-process admission door. */
-	parentDepth?: number;
-	workflowStageSubagentGuard?: boolean;
-	workflowSessionMetadata?: SessionWorkflowMetadata;
-	/** Override the agent's default model (format: "provider/id" or just "id") */
-	modelOverride?: string;
-	/** Registry models available for heuristic bare-model resolution */
-	availableModels?: Array<{ provider: string; id: string; fullId: string }>;
-	/** Providers known to the registry before auth filtering */
-	knownModelProviders?: string[];
-	/**
-	 * Resolve the selected `provider/model[:thinking]` candidate to a concrete
-	 * registry model. Without it the child session receives no model and a
-	 * fork-context child silently runs on the model restored from the parent's
-	 * session file.
-	 */
-	resolveCandidateModel?: CandidateModelResolver;
-	/** Current parent-session provider to prefer for ambiguous bare model ids */
-	preferredModelProvider?: string;
-	/** Current parent-session model to try after configured fallback models */
-	currentModel?: string;
-	/**
-	 * Current parent-session thinking level. Inherited by a child that pins no
-	 * model of its own — no frontmatter `model`, no `fallbackModels`, and no
-	 * per-call override — matching upstream pi #7897: a subagent dispatched
-	 * without a model runs on the dispatching session's model and thinking
-	 * level. An agent whose fallback chain selects its own first candidate
-	 * runs on that model, not the parent's, and keeps its own thinking
-	 * configuration.
-	 */
-	currentThinkingLevel?: string;
-	/** Skills to inject (overrides agent default if provided) */
-	skills?: string[];
-	/** Test-only in-process session stub configuration; production runs create a real AgentSession. */
-	testSession?:
-		| false
-		| {
-				output?: string;
-				promptLogPath?: string;
-				/** Hold a test prompt open until the caller releases the supplied promise. */
-				promptGate?: Promise<void>;
-				/** Match AgentSession.abort() settling an active prompt without throwing. */
-				abortResolvesPrompt?: boolean;
-				/** Emit a fallback event for tests that exercise live model metadata. */
-				fallbackModel?: string;
-				/** Emit the effective thinking level applied to the fallback candidate. */
-				fallbackThinkingLevel?: string;
-				/** Test-only session model exposed through the AgentSession accessors. */
-				sessionModel?: string;
-				/** Test-only effective thinking level exposed through the AgentSession accessors. */
-				sessionThinkingLevel?: string;
-				/** Test-only session events emitted in order after the initial agent_start event. */
-				events?: readonly AgentSessionEvent[];
-		  };
-}
-
-export type IntercomBridgeMode = "off" | "fork-only" | "always";
-
-export interface IntercomBridgeConfig {
-	mode?: IntercomBridgeMode;
-	instructionFile?: string;
-}
-
-interface TopLevelParallelConfig {
-	maxTasks?: number;
-	concurrency?: number;
-}
-
-export interface ExtensionConfig {
-	defaultSessionDir?: string;
-	control?: ControlConfig;
-	parallel?: TopLevelParallelConfig;
-	worktreeSetupHook?: string;
-	worktreeSetupHookTimeoutMs?: number;
-	intercomBridge?: IntercomBridgeConfig;
-}

package/dist/builtin/subagents/src/shared/types-depth.ts

@@ -1,46 +0,0 @@
-/**
- * Delegation boundary helpers.
- *
- * Delegation is exactly one level deep and is not configurable: a top-level
- * session (main chat or a workflow stage) may call the `subagent` tool, and the
- * children it admits may not.
- */
-
-import type { ExtensionContext, SessionWorkflowMetadata } from "@bastani/atomic";
-
-// Depth is admission state carried in the typed child policy, not process environment.
-
-export function isWorkflowStageOrchestrationContext(ctx: Pick<ExtensionContext, "orchestrationContext">): boolean {
-	return ctx.orchestrationContext?.kind === "workflow-stage";
-}
-
-export function workflowSessionMetadataFromContext(
-	ctx: Pick<ExtensionContext, "orchestrationContext">,
-): SessionWorkflowMetadata | undefined {
-	const orchestration = ctx.orchestrationContext;
-	if (orchestration?.kind !== "workflow-stage") return undefined;
-	return {
-		runId: orchestration.workflowRunId,
-		stageId: orchestration.workflowStageId,
-		stageName: orchestration.workflowStageName,
-	};
-}
-
-/** Read the admitted depth carried by an in-process child session. */
-export function getCurrentSubagentDepth(ctx: Pick<ExtensionContext, "subagentPolicy">): number {
-	const depth = ctx.subagentPolicy?.depth;
-	return typeof depth === "number" && Number.isInteger(depth) && depth >= 0 ? depth : 0;
-}
-
-/**
- * True when this session was itself admitted as a subagent child. Such a session
- * may never delegate further, regardless of any other capability it carries.
- */
-export function isSubagentChildSession(ctx: Pick<ExtensionContext, "subagentPolicy">): boolean {
-	return getCurrentSubagentDepth(ctx) >= 1;
-}
-
-export const SUBAGENT_CHILD_DELEGATION_BLOCKED_MESSAGE =
-	"Subagent delegation is not available inside a subagent. " +
-	"Only a top-level session (main chat or a workflow stage) can call the subagent tool. " +
-	"Complete your assigned task directly.";

package/dist/builtin/subagents/src/shared/types-foreground-state.ts

@@ -1,48 +0,0 @@
-/**
- * Foreground run and extension state public types.
- *
- * Delegation is one level deep, so a parent tracks only its own direct children.
- * The multi-level run address, route, and recursive summary types this file once
- * carried are gone with the pipeline that produced them.
- */
-
-import type { ExtensionContext } from "@bastani/atomic";
-import type { ParentAskHandoffRequest } from "./types-config.js";
-
-export interface ForegroundParentAskHandoff {
-	askingChildIndex: number;
-	releasedChildIndices: number[];
-	unlaunchedChildIndices: number[];
-	request: ParentAskHandoffRequest;
-}
-
-import type { ActivityState, SubagentRunMode } from "./types-results.js";
-
-export interface SubagentState {
-	baseCwd: string;
-	currentSessionId: string | null;
-	subagentInProgress?: boolean;
-	foregroundControls: Map<
-		string,
-		{
-			runId: string;
-			mode: SubagentRunMode;
-			startedAt: number;
-			updatedAt: number;
-			currentAgent?: string;
-			currentIndex?: number;
-			currentActivityState?: ActivityState;
-			lastActivityAt?: number;
-			currentTool?: string;
-			currentToolStartedAt?: number;
-			currentPath?: string;
-			turnCount?: number;
-			tokens?: number;
-			toolCount?: number;
-			interrupt?: () => boolean;
-		}
-	>;
-	lastForegroundControlId: string | null;
-	pendingForegroundControlNotices?: Map<string, ReturnType<typeof setTimeout>>;
-	lastUiContext: ExtensionContext | null;
-}

package/dist/builtin/subagents/src/shared/types-output.ts

@@ -1,63 +0,0 @@
-/**
- * Output truncation helpers.
- */
-
-import type { MaxOutputConfig } from "./types-results.js";
-
-interface TruncationResult {
-	text: string;
-	truncated: boolean;
-	originalBytes?: number;
-	originalLines?: number;
-	artifactPath?: string;
-}
-
-function formatBytes(bytes: number): string {
-	if (bytes < 1024) return `${bytes}B`;
-	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
-	return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
-}
-
-export function truncateOutput(
-	output: string,
-	config: Required<MaxOutputConfig>,
-	artifactPath?: string,
-): TruncationResult {
-	const lines = output.split("\n");
-	const bytes = Buffer.byteLength(output, "utf-8");
-
-	if (bytes <= config.bytes && lines.length <= config.lines) {
-		return { text: output, truncated: false };
-	}
-
-	let truncatedLines = lines;
-	if (lines.length > config.lines) {
-		truncatedLines = lines.slice(0, config.lines);
-	}
-
-	let result = truncatedLines.join("\n");
-	if (Buffer.byteLength(result, "utf-8") > config.bytes) {
-		let low = 0;
-		let high = result.length;
-		while (low < high) {
-			const mid = Math.floor((low + high + 1) / 2);
-			if (Buffer.byteLength(result.slice(0, mid), "utf-8") <= config.bytes) {
-				low = mid;
-			} else {
-				high = mid - 1;
-			}
-		}
-		result = result.slice(0, low);
-	}
-
-	const keptLines = result.split("\n").length;
-	const marker = `[TRUNCATED: showing first ${keptLines} of ${lines.length} lines, ${formatBytes(Buffer.byteLength(result))} of ${formatBytes(bytes)}${artifactPath ? ` - full output at ${artifactPath}` : ""}]\n`;
-
-	return {
-		text: marker + result,
-		truncated: true,
-		originalBytes: bytes,
-		originalLines: lines.length,
-		artifactPath,
-	};
-}