pi-subagents 0.69.0 → 0.70.0

package/src/shared/launch-contract.ts

@@ -1,198 +0,0 @@
-import { createHash } from "node:crypto";
-import * as fs from "node:fs";
-import type { AgentConfig } from "../agents/agents.ts";
-import type { PiLaunchToolPlan } from "../runs/shared/child-tool-plan.ts";
-import type { ExtensionBindings } from "../runs/shared/extension-bindings.ts";
-
-export const AGENT_DEFINITION_PROJECTION_VERSION = 2 as const;
-// v2: the Intercom bridge prompt and tools are part of the binding on every
-// path, and the bridge text no longer names the parent session.
-export const LAUNCH_BINDING_PROJECTION_VERSION = 2 as const;
-
-function stableJson(value: unknown): string {
-	if (Array.isArray(value)) return `[${value.map(stableJson).join(",")}]`;
-	if (value && typeof value === "object") {
-		return `{${Object.entries(value as Record<string, unknown>)
-			.filter(([, entry]) => entry !== undefined)
-			.sort(([a], [b]) => a.localeCompare(b))
-			.map(([key, entry]) => `${JSON.stringify(key)}:${stableJson(entry)}`)
-			.join(",")}}`;
-	}
-	return JSON.stringify(value);
-}
-
-export function stableJsonDigest(value: unknown): string {
-	return createHash("sha256").update(stableJson(value)).digest("hex");
-}
-
-function fileDigest(filePath: string): string | undefined {
-	try {
-		return createHash("sha256").update(fs.readFileSync(filePath)).digest("hex");
-	} catch {
-		return undefined;
-	}
-}
-
-/** Public-safe, deterministic evidence for the parsed launch-affecting agent definition. */
-export function projectAgentDefinition(agent: AgentConfig): Record<string, unknown> {
-	return {
-		version: AGENT_DEFINITION_PROJECTION_VERSION,
-		name: agent.name,
-		localName: agent.localName,
-		packageName: agent.packageName,
-		filePath: agent.filePath,
-		fileContentDigest: fileDigest(agent.filePath),
-		runner: agent.runner,
-		systemPrompt: agent.systemPrompt,
-		systemPromptMode: agent.systemPromptMode,
-		inheritProjectContext: agent.inheritProjectContext,
-		inheritGlobalContext: agent.inheritGlobalContext,
-		inheritSkills: agent.inheritSkills,
-		model: agent.model,
-		modelProvider: agent.modelProvider,
-		fast: agent.fast,
-		thinking: agent.thinking,
-		tools: agent.tools,
-		excludeTools: agent.excludeTools,
-		allowNestedSubagents: agent.allowNestedSubagents,
-		mcpDirectTools: agent.mcpDirectTools,
-		extensions: agent.extensions,
-		subagentOnlyExtensions: agent.subagentOnlyExtensions,
-		mutationTools: agent.mutationTools,
-		skills: agent.skills,
-		skillPath: agent.skillPath,
-		output: agent.output,
-		outputSchema: agent.outputSchema,
-		defaultReads: agent.defaultReads,
-		defaultProgress: agent.defaultProgress,
-		defaultContext: agent.defaultContext,
-		defaultAsync: agent.defaultAsync,
-		defaultTimeoutMs: agent.defaultTimeoutMs,
-		defaultAcceptance: agent.defaultAcceptance,
-		acceptanceRole: agent.acceptanceRole,
-		interactive: agent.interactive,
-		maxSubagentDepth: agent.maxSubagentDepth,
-		completionGuard: agent.completionGuard,
-		toolBudget: agent.toolBudget,
-		memory: agent.memory,
-	};
-}
-
-/** Digest of the parsed definition; a runtime overlay that already captured it wins over re-hashing the overlaid copy. */
-export function agentDefinitionDigest(agent: AgentConfig): string {
-	return agent.definitionDigest ?? stableJsonDigest(projectAgentDefinition(agent));
-}
-
-export interface LaunchBindingInput {
-	definitionDigest: string;
-	/** Caller task; runtime acceptance/output task annotations are explicitly outside the preflight-known subset. */
-	task?: string;
-	model?: string;
-	fast?: boolean;
-	thinking?: string;
-	systemPrompt?: string | null;
-	systemPromptMode?: AgentConfig["systemPromptMode"];
-	inheritProjectContext: boolean;
-	inheritGlobalContext: boolean;
-	inheritSkills: boolean;
-	skills?: string[];
-	tools?: string[];
-	excludeTools?: string[];
-	extensions?: string[];
-	subagentOnlyExtensions?: string[];
-	mcpDirectTools?: string[];
-	outputPath?: string;
-	outputMode?: string;
-	structuredOutputSchema?: unknown;
-	extensionBindings?: ExtensionBindings;
-}
-
-/** Canonical projection of the resolved inputs handed to the child. */
-export function projectLaunchBinding(input: LaunchBindingInput): Record<string, unknown> {
-	return {
-		version: LAUNCH_BINDING_PROJECTION_VERSION,
-		definitionDigest: input.definitionDigest,
-		taskDigest: input.task === undefined ? undefined : stableJsonDigest(input.task),
-		model: input.model,
-		fast: input.fast,
-		thinking: input.thinking,
-		systemPromptDigest: input.systemPrompt === undefined || input.systemPrompt === null ? undefined : stableJsonDigest(input.systemPrompt),
-		systemPromptMode: input.systemPromptMode,
-		inheritProjectContext: input.inheritProjectContext,
-		inheritGlobalContext: input.inheritGlobalContext,
-		inheritSkills: input.inheritSkills,
-		skills: input.skills,
-		tools: input.tools,
-		excludeTools: input.excludeTools,
-		extensions: input.extensions,
-		subagentOnlyExtensions: input.subagentOnlyExtensions,
-		mcpDirectTools: input.mcpDirectTools,
-		outputPath: input.outputPath,
-		outputMode: input.outputMode,
-		structuredOutputSchema: input.structuredOutputSchema,
-		extensionBindings: input.extensionBindings,
-	};
-}
-
-export function launchBindingDigest(input: LaunchBindingInput): string {
-	return stableJsonDigest(projectLaunchBinding(input));
-}
-
-type LaunchBindingPromptMode = Pick<LaunchBindingInput, "systemPromptMode" | "inheritProjectContext" | "inheritGlobalContext" | "inheritSkills">;
-
-/**
- * Who the child is: the launched agent, or the identity a persisted step
- * already captured when a runner recomputes the binding per model attempt.
- */
-export type LaunchBindingIdentity =
-	| { agent: AgentConfig }
-	| ({ definitionDigest: string } & LaunchBindingPromptMode);
-
-export type LaunchBindingSource = LaunchBindingIdentity
-	& Pick<LaunchBindingInput, "fast" | "thinking" | "skills" | "outputPath" | "outputMode" | "structuredOutputSchema" | "extensionBindings">
-	& {
-		task: string;
-		model?: string;
-		/** Effective child system prompt before runtime acceptance prose. */
-		systemPrompt: string;
-		toolPlan: Pick<PiLaunchToolPlan, "effectiveToolAllowlist" | "excludeTools" | "extensionArgs" | "effectiveMcpTools">;
-	};
-
-export interface LaunchBinding {
-	definitionDigest: string;
-	launchContractDigest: string;
-}
-
-/**
- * Assemble launch identity from resolved preflight or execution inputs.
- * The stable projection omits undefined optional fields.
- */
-export function resolveLaunchBinding(source: LaunchBindingSource): LaunchBinding {
-	const identity = "agent" in source ? {
-		definitionDigest: agentDefinitionDigest(source.agent),
-		systemPromptMode: source.agent.systemPromptMode,
-		inheritProjectContext: source.agent.inheritProjectContext,
-		inheritGlobalContext: source.agent.inheritGlobalContext,
-		inheritSkills: source.agent.inheritSkills,
-	} : source;
-	return {
-		definitionDigest: identity.definitionDigest,
-		launchContractDigest: launchBindingDigest({
-			...identity,
-			task: source.task,
-			model: source.model,
-			fast: source.fast,
-			thinking: source.thinking || undefined,
-			systemPrompt: source.systemPrompt,
-			skills: source.skills,
-			tools: source.toolPlan.effectiveToolAllowlist,
-			excludeTools: source.toolPlan.excludeTools.length > 0 ? source.toolPlan.excludeTools : undefined,
-			extensions: source.toolPlan.extensionArgs,
-			mcpDirectTools: source.toolPlan.effectiveMcpTools,
-			outputPath: source.outputPath || undefined,
-			outputMode: source.outputMode,
-			structuredOutputSchema: source.structuredOutputSchema,
-			extensionBindings: source.extensionBindings || undefined,
-		}),
-	};
-}

package/src/shared/model-info.ts

@@ -1,101 +0,0 @@
-import type { ModelCost } from "@earendil-works/pi-ai";
-
-export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"] as const;
-export type ThinkingLevel = typeof THINKING_LEVELS[number];
-export type ThinkingLevelMap = Partial<Record<ThinkingLevel, string | null>>;
-
-export interface ModelInfo {
-	provider: string;
-	id: string;
-	fullId: string;
-	api?: string;
-	reasoning?: boolean;
-	thinkingLevelMap?: ThinkingLevelMap;
-	/** Context window in tokens, when the host model registry reports one. */
-	contextWindow?: number;
-	/** Maximum output tokens, when the host model registry reports one. */
-	maxTokens?: number;
-	/** Input modalities reported by the registry, e.g. ["text", "image"]. */
-	input?: string[];
-	/** Per-token pricing from the registry (USD per 1M tokens). */
-	cost?: ModelCost;
-}
-
-interface RegistryModelLike {
-	provider: string;
-	id: string;
-	api?: string;
-	reasoning?: boolean;
-	thinkingLevelMap?: ThinkingLevelMap;
-	contextWindow?: number;
-	maxTokens?: number;
-	input?: string[];
-	cost?: ModelCost;
-}
-
-export function toModelInfo(model: RegistryModelLike): ModelInfo {
-	return {
-		provider: model.provider,
-		id: model.id,
-		fullId: `${model.provider}/${model.id}`,
-		api: model.api,
-		reasoning: model.reasoning,
-		thinkingLevelMap: model.thinkingLevelMap,
-		...(typeof model.contextWindow === "number" && Number.isFinite(model.contextWindow) && model.contextWindow > 0 ? { contextWindow: model.contextWindow } : {}),
-		...(typeof model.maxTokens === "number" && Number.isFinite(model.maxTokens) && model.maxTokens > 0 ? { maxTokens: model.maxTokens } : {}),
-		...(Array.isArray(model.input) && model.input.length > 0 ? { input: [...model.input] } : {}),
-		...(model.cost && Number.isFinite(model.cost.input) && Number.isFinite(model.cost.output)
-			? { cost: { ...model.cost, ...(model.cost.tiers ? { tiers: model.cost.tiers.map((tier) => ({ ...tier })) } : {}) } }
-			: {}),
-	};
-}
-
-/** Resolve the effective thinking level from a model string (which may contain a known suffix like `:high`)
- * and an explicit thinking config value. Returns `undefined` when no thinking is applicable
- * (e.g. no model was specified, or the model has no suffix and no config was provided). */
-export function resolveEffectiveThinking(model: string | undefined, configThinking: string | false | undefined): string | undefined {
-	if (!model) return undefined;
-	const { thinkingSuffix } = splitKnownThinkingSuffix(model);
-	if (thinkingSuffix) return thinkingSuffix.slice(1);
-	return THINKING_LEVELS.find((level) => level === configThinking);
-}
-
-export function splitKnownThinkingSuffix(model: string): { baseModel: string; thinkingSuffix: string } {
-	const colonIdx = model.lastIndexOf(":");
-	if (colonIdx === -1) return { baseModel: model, thinkingSuffix: "" };
-	const suffix = THINKING_LEVELS.find((level) => level === model.substring(colonIdx + 1));
-	if (!suffix) return { baseModel: model, thinkingSuffix: "" };
-	return {
-		baseModel: model.substring(0, colonIdx),
-		thinkingSuffix: `:${suffix}`,
-	};
-}
-
-export function findModelInfo(model: string | undefined, availableModels: ModelInfo[] | undefined, preferredProvider?: string): ModelInfo | undefined {
-	if (!model || !availableModels || availableModels.length === 0) return undefined;
-	const { baseModel } = splitKnownThinkingSuffix(model);
-	const exact = availableModels.find((entry) => entry.fullId === baseModel);
-	if (exact) return exact;
-
-	const matches = availableModels.filter((entry) => entry.id === baseModel);
-	if (preferredProvider) {
-		const preferred = matches.find((entry) => entry.provider === preferredProvider);
-		if (preferred) return preferred;
-	}
-	return matches.length === 1 ? matches[0] : undefined;
-}
-
-export function getSupportedThinkingLevels(model: ModelInfo | undefined): ThinkingLevel[] {
-	if (!model) return THINKING_LEVELS.filter((level) => level !== "max");
-	if (model.reasoning === false) return ["off"];
-
-	if (!model.thinkingLevelMap) return THINKING_LEVELS.filter((level) => level !== "max");
-
-	const levels = THINKING_LEVELS.filter((level) => {
-		const mapped = model.thinkingLevelMap?.[level];
-		if (mapped === null) return false;
-		if (level === "xhigh" || level === "max") return mapped !== undefined;
-		return true;
-	});
-	return levels;
-}

package/src/shared/model-response-aliases.ts

@@ -1,13 +0,0 @@
-export function validateModelResponseAliases(value: unknown, label = "config.modelResponseAliases"): void {
-	if (value === undefined) return;
-	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${label} must be a JSON object`);
-	for (const [candidate, aliases] of Object.entries(value)) {
-		const slash = candidate.indexOf("/");
-		if (slash <= 0 || !candidate.slice(0, slash).trim() || !candidate.slice(slash + 1).trim()) {
-			throw new Error(`${label} key ${JSON.stringify(candidate)} must be a non-empty provider/model ID`);
-		}
-		if (!Array.isArray(aliases) || aliases.some((alias) => typeof alias !== "string" || !alias.trim())) {
-			throw new Error(`${label}[${JSON.stringify(candidate)}] must be an array of non-empty response ID strings`);
-		}
-	}
-}

package/src/shared/node-executable.ts

@@ -1,21 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-function isNodeExecutableName(execPath: string): boolean {
-	const basename = path.basename(execPath).toLowerCase();
-	return basename === "node" || basename === "node.exe" || basename === "nodejs" || basename === "nodejs.exe";
-}
-
-function canUseNodeExecutable(execPath: string): boolean {
-	try {
-		fs.accessSync(execPath, process.platform === "win32" ? fs.constants.F_OK : fs.constants.X_OK);
-		return true;
-	} catch {
-		return false;
-	}
-}
-
-export function resolveNodeExecutable(execPath = process.execPath): string {
-	if (isNodeExecutableName(execPath) && canUseNodeExecutable(execPath)) return execPath;
-	return process.platform === "win32" ? "node.exe" : "node";
-}

package/src/shared/opencode-session-headers.ts

@@ -1,30 +0,0 @@
-import type { Api, Model, ProviderHeaders } from "@earendil-works/pi-ai";
-
-const OPENCODE_HOST = "opencode.ai";
-
-function matchesOpenCodeHost(baseUrl: string): boolean {
-	try {
-		return new URL(baseUrl).hostname === OPENCODE_HOST;
-	} catch {
-		return false;
-	}
-}
-
-/**
- * OpenCode session-routing headers for internal subagent model calls.
- *
- * Pi's own session path emits these from coding-agent's provider-attribution
- * merge, but subagent-internal calls (watchdog review, permission arbiter,
- * task-mutation arbiter, prompt audit) stream through bare Agents that bypass
- * that path. Without them OpenCode falls back to client-IP affinity and loses
- * prompt-cache routing (see pi issue #4847). Returns undefined for every other
- * provider so non-OpenCode requests stay byte-identical.
- */
-export function opencodeSessionHeaders(
-	model: Pick<Model<Api>, "provider" | "baseUrl">,
-	sessionId: string | undefined,
-): ProviderHeaders | undefined {
-	if (!sessionId) return undefined;
-	if (model.provider !== "opencode" && model.provider !== "opencode-go" && !matchesOpenCodeHost(model.baseUrl)) return undefined;
-	return { "x-opencode-session": sessionId, "x-opencode-client": "pi" };
-}

package/src/shared/prompt-resources.ts

@@ -1,11 +0,0 @@
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import { getAgentDir, getProjectConfigDir } from "./utils.ts";
-
-export function getPromptDirectories(cwd: string) {
-	return {
-		package: path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "prompts"),
-		user: path.join(getAgentDir(), "prompts"),
-		project: path.join(getProjectConfigDir(cwd), "prompts"),
-	};
-}