brass-runtime 1.12.0 → 1.13.2

package/dist/agent/index.d.ts

@@ -0,0 +1,688 @@
+import { A as Async, a3 as Runtime, S as Scope } from '../effect-ISvXPLgc.js';
+
+type AgentMode = "read-only" | "propose" | "write" | "autonomous";
+type AgentPackageManager = "npm" | "pnpm" | "yarn" | "bun";
+type AgentPackageManagerConfig = AgentPackageManager | "auto";
+type AgentResponseLanguage = "auto" | "match-user" | "en" | "es" | "pt" | "fr" | "de" | "it" | "custom";
+type AgentLanguageConfig = {
+    /** Natural language used for LLM-facing responses. Default: auto, which matches the user goal when possible. */
+    readonly response?: AgentResponseLanguage;
+    /** Human-readable language name used when response is custom, e.g. "Argentinian Spanish". */
+    readonly custom?: string;
+};
+type AgentContextConfig = {
+    /** Enable or disable context discovery before the first LLM planning call. Default: true. */
+    readonly enabled?: boolean;
+    /** Maximum searchText actions to run before planning. Default: 3. */
+    readonly maxSearchQueries?: number;
+    /** Maximum distinct files to read from direct error paths and search results. Default: 4. */
+    readonly maxFiles?: number;
+    /** Maximum matches to consider from search results when selecting files. Default: 40. */
+    readonly maxSearchResults?: number;
+    /** Ripgrep globs used for context searches. */
+    readonly globs?: readonly string[];
+    /** Glob-like paths excluded from context reads/searches, e.g. secrets/** or *.pem. */
+    readonly excludeGlobs?: readonly string[];
+};
+type AgentRedactionConfig = {
+    /** Redact likely secrets before prompts/protocol summaries. Default: true. */
+    readonly enabled?: boolean;
+    /** Extra regular-expression source strings to redact. Invalid patterns are ignored. */
+    readonly additionalPatterns?: readonly string[];
+};
+type AgentPatchQualityConfig = {
+    /** Enable repair attempts after generated patches fail to apply or fail validation. Default: true. */
+    readonly enabled?: boolean;
+    /** Number of llm.patch repair calls after the initial generated patch. Default: 1. */
+    readonly maxRepairAttempts?: number;
+};
+type AgentRollbackConfig = {
+    /** Enable automatic rollback safety for generated patches. Default: true. */
+    readonly enabled?: boolean;
+    /** Roll back generated patches when final validation still fails and no repair remains. Default: true. */
+    readonly onFinalValidationFailure?: boolean;
+    /** Roll back only the latest patch or the full generated patch stack. Default: all. */
+    readonly strategy?: "last" | "all";
+    /** Maximum automatic rollback actions in one run. Default: 8. */
+    readonly maxRollbackDepth?: number;
+    /** Re-run validation after automatic rollback completes. Default: true. */
+    readonly runValidationAfterRollback?: boolean;
+    /** Allow automatic rollback for exact supplied patches. Default: false. */
+    readonly allowForSuppliedPatches?: boolean;
+};
+type AgentProjectConfig = {
+    /** Force a package manager or let the agent infer it from package.json and lockfiles. */
+    readonly packageManager?: AgentPackageManagerConfig;
+    /** Exact validation commands to run. When present, discovery from package.json is skipped. */
+    readonly validationCommands?: readonly string[];
+    /** Ordered script names to consider as the primary test command. */
+    readonly testScriptNames?: readonly string[];
+    /** Include a typecheck/check script even when the goal does not mention it. */
+    readonly includeTypecheck?: boolean;
+    /** Include a lint script even when the goal does not mention it. */
+    readonly includeLint?: boolean;
+    /** Bound the amount of validation work discovered automatically. Default: 2. */
+    readonly maxValidationCommands?: number;
+};
+type AgentGoal = {
+    readonly id: string;
+    readonly cwd: string;
+    readonly text: string;
+    readonly mode: AgentMode;
+    readonly project?: AgentProjectConfig;
+    readonly context?: AgentContextConfig;
+    readonly patchQuality?: AgentPatchQualityConfig;
+    readonly rollback?: AgentRollbackConfig;
+    readonly redaction?: AgentRedactionConfig;
+    readonly language?: AgentLanguageConfig;
+    /** Optional precomputed unified diff. Used by trusted clients after a patch preview approval. */
+    readonly initialPatch?: string;
+    /** How to materialize initialPatch in write/autonomous mode. Default: apply. */
+    readonly initialPatchMode?: "apply" | "rollback";
+};
+type AgentPhase = "boot" | "discovering" | "planning" | "validating" | "proposing" | "done" | "failed";
+type AgentState = {
+    readonly goal: AgentGoal;
+    readonly phase: AgentPhase;
+    readonly observations: readonly Observation[];
+    readonly errors: readonly AgentError[];
+    readonly steps: number;
+};
+type AgentEvent = {
+    readonly type: "agent.run.started";
+    readonly goal: AgentGoal;
+    readonly at: number;
+} | {
+    readonly type: "agent.action.started";
+    readonly action: AgentAction;
+    readonly step: number;
+    readonly phase: AgentPhase;
+    readonly at: number;
+} | {
+    readonly type: "agent.action.completed";
+    readonly action: AgentAction;
+    readonly observation: Observation;
+    readonly step: number;
+    readonly phase: AgentPhase;
+    readonly durationMs: number;
+    readonly at: number;
+} | {
+    readonly type: "agent.action.failed";
+    readonly action: AgentAction;
+    readonly error: AgentError;
+    readonly step: number;
+    readonly phase: AgentPhase;
+    readonly durationMs: number;
+    readonly at: number;
+} | {
+    readonly type: "agent.observation.recorded";
+    readonly observation: Observation;
+    readonly step: number;
+    readonly phase: AgentPhase;
+    readonly at: number;
+} | {
+    readonly type: "agent.tool.timeout";
+    readonly action: AgentAction;
+    readonly step: number;
+    readonly phase: AgentPhase;
+    readonly timeoutMs: number;
+    readonly at: number;
+} | {
+    readonly type: "agent.permission.denied";
+    readonly action: AgentAction;
+    readonly step: number;
+    readonly phase: AgentPhase;
+    readonly reason: string;
+    readonly at: number;
+} | {
+    readonly type: "agent.approval.requested";
+    readonly action: AgentAction;
+    readonly step: number;
+    readonly phase: AgentPhase;
+    readonly reason: string;
+    readonly risk: ApprovalRisk;
+    readonly defaultAnswer: ApprovalDefaultAnswer;
+    readonly at: number;
+} | {
+    readonly type: "agent.approval.resolved";
+    readonly action: AgentAction;
+    readonly step: number;
+    readonly phase: AgentPhase;
+    readonly approved: boolean;
+    readonly reason?: string;
+    readonly at: number;
+} | {
+    readonly type: "agent.patch.applied";
+    readonly step: number;
+    readonly phase: AgentPhase;
+    readonly changedFiles: readonly string[];
+    readonly automaticRollbackEligible?: boolean;
+    readonly at: number;
+} | {
+    readonly type: "agent.patch.rolledBack";
+    readonly step: number;
+    readonly phase: AgentPhase;
+    readonly changedFiles: readonly string[];
+    readonly automatic?: boolean;
+    readonly reason?: string;
+    readonly at: number;
+} | {
+    readonly type: "agent.run.completed";
+    readonly goal: AgentGoal;
+    readonly status: "done" | "failed";
+    readonly phase: AgentPhase;
+    readonly steps: number;
+    readonly durationMs: number;
+    readonly at: number;
+};
+type AgentEventSink = {
+    readonly emit: (event: AgentEvent) => void;
+};
+type LLMPurpose = "plan" | "patch" | "explain";
+type AgentAction = {
+    readonly type: "fs.readFile";
+    readonly path: string;
+} | {
+    readonly type: "fs.exists";
+    readonly path: string;
+} | {
+    readonly type: "fs.searchText";
+    readonly query: string;
+    readonly globs?: readonly string[];
+} | {
+    readonly type: "shell.exec";
+    readonly command: readonly string[];
+    readonly cwd?: string;
+} | {
+    readonly type: "llm.complete";
+    readonly purpose: LLMPurpose;
+    readonly prompt: string;
+} | {
+    readonly type: "patch.propose";
+    readonly patch: string;
+} | {
+    readonly type: "patch.apply";
+    readonly patch: string;
+} | {
+    readonly type: "patch.rollback";
+    readonly patch: string;
+    readonly automatic?: boolean;
+    readonly reason?: string;
+} | {
+    readonly type: "agent.finish";
+    readonly summary: string;
+} | {
+    readonly type: "agent.fail";
+    readonly reason: string;
+};
+type AgentActionType = AgentAction["type"];
+type AgentToolPolicyOverride = {
+    readonly timeoutMs?: number;
+    readonly retries?: number;
+};
+type AgentToolPolicyConfig = Partial<Record<AgentActionType, AgentToolPolicyOverride>>;
+type Observation = {
+    readonly type: "fs.fileRead";
+    readonly path: string;
+    readonly content: string;
+} | {
+    readonly type: "fs.exists";
+    readonly path: string;
+    readonly exists: boolean;
+} | {
+    readonly type: "fs.searchResult";
+    readonly query: string;
+    readonly matches: readonly SearchMatch[];
+} | {
+    readonly type: "shell.result";
+    readonly command: readonly string[];
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+} | {
+    readonly type: "llm.response";
+    readonly purpose: LLMPurpose;
+    readonly content: string;
+} | {
+    readonly type: "patch.proposed";
+    readonly patch: string;
+} | {
+    readonly type: "patch.applied";
+    readonly changedFiles: readonly string[];
+    readonly patch?: string;
+} | {
+    readonly type: "patch.rolledBack";
+    readonly changedFiles: readonly string[];
+    readonly patch?: string;
+    readonly automatic?: boolean;
+    readonly reason?: string;
+} | {
+    readonly type: "agent.done";
+    readonly summary: string;
+} | {
+    readonly type: "agent.error";
+    readonly error: AgentError;
+};
+type SearchMatch = {
+    readonly path: string;
+    readonly line: number;
+    readonly text: string;
+};
+type ExecResult = {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+};
+type LLMRequest = {
+    readonly purpose: LLMPurpose;
+    readonly prompt: string;
+};
+type LLMResponse = {
+    readonly content: string;
+};
+type AgentError = {
+    readonly _tag: "FsError";
+    readonly operation: string;
+    readonly cause: unknown;
+} | {
+    readonly _tag: "ShellError";
+    readonly operation: string;
+    readonly command?: readonly string[];
+    readonly cause: unknown;
+} | {
+    readonly _tag: "LLMError";
+    readonly cause: unknown;
+} | {
+    readonly _tag: "PatchError";
+    readonly operation: string;
+    readonly cause: unknown;
+    readonly patch?: string;
+} | {
+    readonly _tag: "PermissionDenied";
+    readonly action: AgentAction;
+    readonly reason: string;
+} | {
+    readonly _tag: "ApprovalRejected";
+    readonly action: AgentAction;
+    readonly reason: string;
+} | {
+    readonly _tag: "ToolTimeout";
+    readonly timeoutMs: number;
+} | {
+    readonly _tag: "AgentLoopError";
+    readonly message: string;
+} | {
+    readonly _tag: "PathOutsideWorkspace";
+    readonly path: string;
+    readonly cwd: string;
+};
+type FileSystem = {
+    readonly readFile: (path: string) => Async<unknown, AgentError, string>;
+    readonly exists: (path: string) => Async<unknown, AgentError, boolean>;
+    readonly searchText: (cwd: string, query: string, options?: {
+        readonly globs?: readonly string[];
+    }) => Async<unknown, AgentError, readonly SearchMatch[]>;
+};
+type Shell = {
+    readonly exec: (command: readonly string[], options: {
+        readonly cwd: string;
+        readonly stdin?: string;
+    }) => Async<unknown, AgentError, ExecResult>;
+};
+type LLM = {
+    readonly complete: (request: LLMRequest) => Async<unknown, AgentError, LLMResponse>;
+};
+type PatchApplyResult = {
+    readonly changedFiles: readonly string[];
+};
+type PatchService = {
+    readonly apply: (cwd: string, patch: string) => Async<unknown, AgentError, PatchApplyResult>;
+    /** Reverse-apply a unified diff, usually for manual rollback of an approved patch. */
+    readonly rollback: (cwd: string, patch: string) => Async<unknown, AgentError, PatchApplyResult>;
+};
+type ApprovalRisk = "low" | "medium" | "high";
+type ApprovalDefaultAnswer = "approve" | "reject";
+type ApprovalRequest = {
+    readonly action: AgentAction;
+    readonly state: AgentState;
+    readonly reason: string;
+    readonly risk: ApprovalRisk;
+    readonly defaultAnswer: ApprovalDefaultAnswer;
+};
+type ApprovalResponse = {
+    readonly type: "approved";
+} | {
+    readonly type: "rejected";
+    readonly reason?: string;
+};
+type ApprovalService = {
+    readonly request: (request: ApprovalRequest) => Async<AgentEnv, AgentError, ApprovalResponse>;
+};
+type PermissionDecision = {
+    readonly type: "allow";
+} | {
+    readonly type: "deny";
+    readonly reason: string;
+} | {
+    readonly type: "ask";
+    readonly reason: string;
+    readonly risk: ApprovalRisk;
+    readonly defaultAnswer?: ApprovalDefaultAnswer;
+};
+type PermissionService = {
+    readonly check: (action: AgentAction, state: AgentState) => Async<AgentEnv, AgentError, PermissionDecision>;
+};
+type AgentEnv = {
+    readonly fs: FileSystem;
+    readonly shell: Shell;
+    readonly llm: LLM;
+    readonly patch: PatchService;
+    readonly permissions: PermissionService;
+    readonly approvals?: ApprovalService;
+    readonly events?: AgentEventSink;
+    readonly toolPolicies?: AgentToolPolicyConfig;
+};
+
+declare const initialAgentState: (goal: AgentGoal) => AgentState;
+
+declare const reduceAgentState: (state: AgentState, observation: Observation) => AgentState;
+declare const isTerminal: (state: AgentState) => boolean;
+
+declare const decideNextAction: (state: AgentState) => Async<AgentEnv, AgentError, AgentAction>;
+
+declare const runAgent: (runtime: Runtime<AgentEnv>, goal: AgentGoal) => Async<AgentEnv, AgentError, AgentState>;
+
+declare const nowMillis: () => Async<unknown, never, number>;
+declare const emitAgentEvent: (event: AgentEvent) => Async<AgentEnv, never, void>;
+declare const emitAgentEvents: (events: readonly AgentEvent[]) => Async<AgentEnv, never, void>;
+declare const summarizeAgentAction: (action: AgentAction) => string;
+declare const summarizeAgentObservation: (observation: Observation) => string;
+declare const observationStatus: (observation: Observation) => "ok" | "warn" | "fail";
+declare const errorEventFor: (action: AgentAction, state: AgentState, error: AgentError, at: number) => AgentEvent | undefined;
+declare const observationEventFor: (state: AgentState, observation: Observation, at: number) => AgentEvent | undefined;
+declare const runStatusFor: (phase: AgentPhase) => "done" | "failed";
+
+type AgentPreset = "fix-tests" | "inspect" | "typecheck" | "lint";
+type AgentBatchGoal = string | {
+    readonly goal?: string;
+    readonly preset?: AgentPreset;
+    readonly mode?: AgentMode;
+    readonly cwd?: string;
+    readonly patchFile?: string;
+    readonly patchFileMode?: "apply" | "rollback";
+    readonly saveRunDir?: string;
+};
+type AgentBatchConfig = {
+    /** Goals to execute sequentially when no --batch-file is provided. */
+    readonly goals?: readonly AgentBatchGoal[];
+    /** Stop after the first failed run. Default: true in --ci mode, false otherwise. */
+    readonly stopOnFailure?: boolean;
+};
+declare const isAgentPreset: (value: string) => value is AgentPreset;
+declare const goalForAgentPreset: (preset: AgentPreset) => string;
+
+type AgentConfigApprovalMode = "auto" | "interactive" | "approve" | "deny";
+type AgentConfigLLMProvider = "fake" | "google" | "gemini" | "openai" | "openai-compatible";
+type AgentLLMConfig = {
+    readonly provider?: AgentConfigLLMProvider;
+    readonly model?: string;
+    readonly endpoint?: string;
+    readonly baseUrl?: string;
+    readonly apiVersion?: string;
+    readonly apiKeyEnv?: string;
+    readonly systemInstruction?: string;
+    readonly temperature?: number;
+    readonly topP?: number;
+    readonly topK?: number;
+    readonly maxOutputTokens?: number;
+    readonly fakeResponse?: string;
+};
+type ShellAskRule = string | {
+    readonly pattern: string;
+    readonly reason?: string;
+    readonly risk?: ApprovalRisk;
+    readonly defaultAnswer?: ApprovalDefaultAnswer;
+};
+type ShellPermissionConfig = {
+    /**
+     * When true or omitted, the built-in safe read/validation commands remain
+     * allowed. Set to false for a strict allowlist defined only by this file.
+     */
+    readonly inheritDefaults?: boolean;
+    readonly allow?: readonly string[];
+    readonly ask?: readonly ShellAskRule[];
+    readonly deny?: readonly string[];
+};
+type PatchApplyPermissionConfig = "allow" | "ask" | "deny" | {
+    readonly decision?: "allow" | "ask" | "deny";
+    readonly reason?: string;
+    readonly risk?: ApprovalRisk;
+    readonly defaultAnswer?: ApprovalDefaultAnswer;
+};
+type AgentPermissionConfig = {
+    readonly shell?: ShellPermissionConfig;
+    readonly patchApply?: PatchApplyPermissionConfig;
+};
+type AgentConfig = {
+    readonly mode?: AgentMode;
+    readonly approval?: AgentConfigApprovalMode;
+    readonly llm?: AgentLLMConfig;
+    readonly project?: AgentProjectConfig;
+    readonly context?: AgentContextConfig;
+    readonly patchQuality?: AgentPatchQualityConfig;
+    readonly rollback?: AgentRollbackConfig;
+    readonly redaction?: AgentRedactionConfig;
+    readonly language?: AgentLanguageConfig;
+    readonly permissions?: AgentPermissionConfig;
+    readonly tools?: AgentToolPolicyConfig;
+    readonly batch?: AgentBatchConfig;
+};
+type LoadedAgentConfig = {
+    readonly path?: string;
+    readonly config: AgentConfig;
+};
+declare const isAgentConfigMode: (value: string) => value is AgentMode;
+declare const isAgentConfigApprovalMode: (value: string) => value is AgentConfigApprovalMode;
+declare const isAgentConfigLLMProvider: (value: string) => value is AgentConfigLLMProvider;
+declare const AGENT_CONFIG_FILE_NAMES: readonly [".brass-agent.json", "brass-agent.config.json"];
+
+type ProjectCommand = readonly string[];
+type ProjectCommandDiscovery = {
+    readonly packageManager: AgentPackageManager;
+    readonly validationCommands: readonly ProjectCommand[];
+    readonly source: "config" | "package-json" | "fallback";
+    readonly notes: readonly string[];
+    readonly profileSummary?: string;
+};
+declare const PROJECT_LOCKFILE_PROBES: readonly ["pnpm-lock.yaml", "yarn.lock", "bun.lockb", "bun.lock", "package-lock.json", "npm-shrinkwrap.json"];
+declare const parseProjectPackageJson: (state: AgentState) => Record<string, unknown> | undefined;
+declare const nextProjectProbeAction: (state: AgentState) => AgentAction | undefined;
+declare const discoverPackageManager: (state: AgentState) => AgentPackageManager;
+declare const splitCommand: (value: string) => readonly string[];
+declare const commandForScript: (packageManager: AgentPackageManager, scriptName: string) => ProjectCommand;
+declare const discoverValidationCommands: (state: AgentState) => ProjectCommandDiscovery;
+declare const nextUnrunValidationCommand: (commands: readonly ProjectCommand[], observations: readonly Observation[]) => ProjectCommand | undefined;
+declare const describeCommandDiscovery: (discovery: ProjectCommandDiscovery) => string;
+
+type AgentProjectStack = "node" | "rust" | "tauri" | "desktop" | "bridge" | "monorepo";
+type AgentWorkspaceStyle = "single-package" | "monorepo" | "mixed" | "unknown";
+type AgentProjectProfile = {
+    readonly kind: "unknown" | "node" | "rust" | "tauri" | "mixed";
+    readonly packageManager: AgentPackageManager;
+    readonly stacks: readonly AgentProjectStack[];
+    readonly workspaceStyle: AgentWorkspaceStyle;
+    readonly markers: readonly string[];
+    readonly scripts: readonly string[];
+    readonly candidateValidationScripts: readonly string[];
+    readonly candidateValidationCommands: readonly string[];
+    readonly notes: readonly string[];
+};
+declare const PROJECT_PROFILE_PROBES: readonly ["Cargo.toml", "Cargo.lock", "src-tauri/tauri.conf.json", "src-tauri/Cargo.toml", "apps/desktop/package.json", "apps/desktop/src-tauri/tauri.conf.json", "apps/desktop/src-tauri/Cargo.toml", "bridges/whatsmeow-bridge/Cargo.toml", "bridges/whatsmeow-bridge/package.json", "apps", "packages", "bridges", "turbo.json", "nx.json", "pnpm-workspace.yaml"];
+declare const projectProfileProbePending: (state: AgentState) => string | undefined;
+declare const discoverProjectProfile: (state: AgentState, packageManager: AgentPackageManager) => AgentProjectProfile;
+declare const describeProjectProfile: (profile: AgentProjectProfile) => string;
+
+type ContextDiscoverySummary = {
+    readonly enabled: boolean;
+    readonly searchedQueries: readonly string[];
+    readonly pendingQueries: readonly string[];
+    readonly discoveredPaths: readonly string[];
+    readonly readPaths: readonly string[];
+    readonly remainingFileBudget: number;
+};
+declare const extractLikelyFilePaths: (state: AgentState) => readonly string[];
+declare const deriveContextSearchQueries: (state: AgentState) => readonly string[];
+declare const describeContextDiscovery: (state: AgentState) => string;
+declare const summarizeContextDiscovery: (state: AgentState) => ContextDiscoverySummary;
+declare const nextContextDiscoveryAction: (state: AgentState) => AgentAction | undefined;
+
+type PatchQualitySummary = {
+    readonly enabled: boolean;
+    readonly maxRepairAttempts: number;
+    readonly repairAttemptsUsed: number;
+    readonly repairsRemaining: number;
+    readonly exactSuppliedPatch: boolean;
+};
+declare const patchRepairAttemptsUsed: (state: AgentState) => number;
+declare const patchQualitySummary: (state: AgentState) => PatchQualitySummary;
+declare const canRequestPatchRepair: (state: AgentState) => boolean;
+type PatchValidationStatus = {
+    readonly type: "not-run";
+} | {
+    readonly type: "pending";
+    readonly completed: number;
+    readonly total: number;
+} | {
+    readonly type: "passed" | "failed";
+    readonly results: readonly Extract<Observation, {
+        type: "shell.result";
+    }>[];
+};
+declare const patchValidationStatus: (commands: readonly ProjectCommand[], observationsAfterPatch: readonly Observation[]) => PatchValidationStatus;
+declare const describePatchQuality: (state: AgentState) => string;
+
+type AgentRollbackStrategy = "last" | "all";
+type RollbackSafetySummary = {
+    readonly enabled: boolean;
+    readonly onFinalValidationFailure: boolean;
+    readonly strategy: AgentRollbackStrategy;
+    readonly maxRollbackDepth: number;
+    readonly runValidationAfterRollback: boolean;
+    readonly allowForSuppliedPatches: boolean;
+    readonly rollbackCount: number;
+    readonly appliedStackDepth: number;
+    readonly exactSuppliedPatch: boolean;
+};
+type AppliedPatchEntry = {
+    readonly index: number;
+    readonly patch: string;
+    readonly changedFiles: readonly string[];
+};
+declare const rollbackSafetySummary: (state: AgentState) => RollbackSafetySummary;
+declare const unappliedPatchStack: (state: AgentState) => readonly AppliedPatchEntry[];
+declare const latestUnappliedPatch: (state: AgentState) => AppliedPatchEntry | undefined;
+declare const canAutoRollback: (state: AgentState) => boolean;
+declare const shouldContinueRollbackStack: (state: AgentState) => boolean;
+type WorkspaceValidationStatus = {
+    readonly type: "not-run";
+} | {
+    readonly type: "pending";
+    readonly completed: number;
+    readonly total: number;
+} | {
+    readonly type: "passed" | "failed";
+    readonly results: readonly Extract<Observation, {
+        type: "shell.result";
+    }>[];
+};
+declare const workspaceValidationStatus: (commands: readonly ProjectCommand[], observationsAfterWorkspaceChange: readonly Observation[]) => WorkspaceValidationStatus;
+declare const describeRollbackSafety: (state: AgentState) => string;
+
+declare const isRedactionEnabled: (config: AgentRedactionConfig | undefined) => boolean;
+declare const redactText: (value: string, config?: AgentRedactionConfig) => string;
+
+declare const inferUserLanguage: (text: string) => string | undefined;
+declare const responseLanguageName: (goal: AgentGoal) => string | undefined;
+declare const describeLanguagePolicy: (goal: AgentGoal) => string;
+declare const spanishLike: (goal: AgentGoal) => boolean;
+
+declare const makeConfiguredPermissions: (config?: AgentPermissionConfig) => PermissionService;
+declare const defaultPermissions: PermissionService;
+
+declare const autoApproveApprovals: ApprovalService;
+declare const makeAutoDenyApprovals: (reason?: string) => ApprovalService;
+
+declare const invokeAction: (action: AgentAction, state: AgentState, scope: Scope<AgentEnv>) => Async<AgentEnv, AgentError, Observation>;
+
+declare const retry: <R, E, A>(make: () => Async<R, E, A>, options: {
+    readonly times: number;
+    readonly while: (error: E) => boolean;
+}) => Async<R, E, A>;
+
+declare const sleep: (ms: number) => Async<unknown, never, void>;
+declare const timeout: <R, E, A>(effect: Async<R, E, A>, ms: number, scope: Scope<R>) => Async<R, E | AgentError, A>;
+
+declare const extractUnifiedDiff: (content: string) => string | undefined;
+declare const extractPatchPaths: (patch: string) => readonly string[];
+
+declare const NodeShell: Shell;
+
+declare const makeNodeFileSystem: (shell: Shell) => FileSystem;
+
+declare const makeNodePatchService: (shell: Shell) => PatchService;
+
+declare const loadNodeAgentConfig: (options: {
+    readonly cwd: string;
+    readonly configPath?: string;
+    readonly noConfig?: boolean;
+}) => Promise<LoadedAgentConfig>;
+
+declare const makeOpenAICompatibleLLM: (config: {
+    readonly endpoint: string;
+    readonly apiKey: string;
+    readonly model: string;
+}) => LLM;
+
+type GoogleGenerativeAIConfig = {
+    /** API key for the Gemini API / Generative Language API. */
+    readonly apiKey: string;
+    /** Model id, with or without the `models/` prefix. Example: `gemini-2.5-flash`. */
+    readonly model?: string;
+    /** API version segment. Defaults to `v1beta` for broad Gemini feature coverage. */
+    readonly apiVersion?: "v1" | "v1beta" | string;
+    /** Base URL for the Generative Language API. Useful for tests/proxies. */
+    readonly baseUrl?: string;
+    /** Full generateContent endpoint override. If provided, baseUrl/apiVersion/model are ignored. */
+    readonly endpoint?: string;
+    /** Optional developer instruction. Gemini currently supports text system instructions. */
+    readonly systemInstruction?: string;
+    /** Optional generation config passthroughs. */
+    readonly temperature?: number;
+    readonly topP?: number;
+    readonly topK?: number;
+    readonly maxOutputTokens?: number;
+    readonly stopSequences?: readonly string[];
+    readonly responseMimeType?: string;
+    /** Escape hatch for newer Gemini generationConfig fields without changing this adapter. */
+    readonly extraGenerationConfig?: Record<string, unknown>;
+};
+declare const makeGoogleGenerativeAILLM: (config: GoogleGenerativeAIConfig) => LLM;
+
+type FakeLLMOptions = {
+    readonly content?: string | ((request: LLMRequest) => string);
+};
+declare const makeFakeLLM: (options?: FakeLLMOptions) => LLM;
+
+type AgentWorkspaceDiscoveryResult = {
+    readonly inputCwd: string;
+    readonly cwd: string;
+    readonly marker?: string;
+    readonly markerPath?: string;
+    readonly changed: boolean;
+    readonly disabled?: boolean;
+};
+declare const discoverNodeWorkspaceRoot: (cwd: string, options?: {
+    readonly enabled?: boolean;
+}) => AgentWorkspaceDiscoveryResult;
+
+export { AGENT_CONFIG_FILE_NAMES, type AgentAction, type AgentActionType, type AgentBatchConfig, type AgentBatchGoal, type AgentConfig, type AgentConfigApprovalMode, type AgentConfigLLMProvider, type AgentContextConfig, type AgentEnv, type AgentError, type AgentEvent, type AgentEventSink, type AgentGoal, type AgentLLMConfig, type AgentLanguageConfig, type AgentMode, type AgentPackageManager, type AgentPackageManagerConfig, type AgentPatchQualityConfig, type AgentPermissionConfig, type AgentPhase, type AgentPreset, type AgentProjectConfig, type AgentProjectProfile, type AgentProjectStack, type AgentRedactionConfig, type AgentResponseLanguage, type AgentRollbackConfig, type AgentRollbackStrategy, type AgentState, type AgentToolPolicyConfig, type AgentToolPolicyOverride, type AgentWorkspaceDiscoveryResult, type AgentWorkspaceStyle, type AppliedPatchEntry, type ApprovalDefaultAnswer, type ApprovalRequest, type ApprovalResponse, type ApprovalRisk, type ApprovalService, type ContextDiscoverySummary, type ExecResult, type FakeLLMOptions, type FileSystem, type GoogleGenerativeAIConfig, type LLM, type LLMPurpose, type LLMRequest, type LLMResponse, type LoadedAgentConfig, NodeShell, type Observation, PROJECT_LOCKFILE_PROBES, PROJECT_PROFILE_PROBES, type PatchApplyPermissionConfig, type PatchApplyResult, type PatchQualitySummary, type PatchService, type PatchValidationStatus, type PermissionDecision, type PermissionService, type ProjectCommand, type ProjectCommandDiscovery, type RollbackSafetySummary, type SearchMatch, type Shell, type ShellAskRule, type ShellPermissionConfig, type WorkspaceValidationStatus, autoApproveApprovals, canAutoRollback, canRequestPatchRepair, commandForScript, decideNextAction, defaultPermissions, deriveContextSearchQueries, describeCommandDiscovery, describeContextDiscovery, describeLanguagePolicy, describePatchQuality, describeProjectProfile, describeRollbackSafety, discoverNodeWorkspaceRoot, discoverPackageManager, discoverProjectProfile, discoverValidationCommands, emitAgentEvent, emitAgentEvents, errorEventFor, extractLikelyFilePaths, extractPatchPaths, extractUnifiedDiff, goalForAgentPreset, inferUserLanguage, initialAgentState, invokeAction, isAgentConfigApprovalMode, isAgentConfigLLMProvider, isAgentConfigMode, isAgentPreset, isRedactionEnabled, isTerminal, latestUnappliedPatch, loadNodeAgentConfig, makeAutoDenyApprovals, makeConfiguredPermissions, makeFakeLLM, makeGoogleGenerativeAILLM, makeNodeFileSystem, makeNodePatchService, makeOpenAICompatibleLLM, nextContextDiscoveryAction, nextProjectProbeAction, nextUnrunValidationCommand, nowMillis, observationEventFor, observationStatus, parseProjectPackageJson, patchQualitySummary, patchRepairAttemptsUsed, patchValidationStatus, projectProfileProbePending, redactText, reduceAgentState, responseLanguageName, retry, rollbackSafetySummary, runAgent, runStatusFor, shouldContinueRollbackStack, sleep, spanishLike, splitCommand, summarizeAgentAction, summarizeAgentObservation, summarizeContextDiscovery, timeout, unappliedPatchStack, workspaceValidationStatus };