/**
 * Coder mode (#356): `--settings` flag parsing and the exec-engine-side
 * status/startup-watchdog handling. Kept out of commands/agent-exec.ts and
 * orgrt/agent-exec.ts (both shared with #355/#357 — see
 * /var/tmp/coder/common.md) so those files only gain a call site each.
 */
import type { SettingSource } from './agent-runner-claude-settings.js';
export type { SettingSource };
/** Parse `--settings none|<csv of user,project,local>` (default: `none`). */
export declare function parseSettingsFlag(raw: unknown): {
    sources: SettingSource[];
} | {
    error: string;
};
/**
 * Bridges ClaudeAgentRunner's `status` AgentMessage (emitted only when
 * `settingSources` is non-empty — see agent-runner-claude.ts) onto the
 * protocol's `status` NDJSON event, and races it against a startup watchdog:
 * loading the user's own settings/MCP servers re-triggers the historical
 * hang this feature investigated (#356) — if `phase:"ready"` never arrives
 * within `timeoutMs`, `terminate` fires and a `runner-error` is emitted
 * instead of hanging until `--timeout`. Disabled (`enabled: false`) is a
 * no-op so runtimes other than `claude`, or `--settings none`, are
 * unaffected: only ClaudeAgentRunner reports `phase:"ready"`, so the
 * watchdog cannot apply to a runtime that never would (those get
 * `runtimeStartupNotices` below instead).
 */
export interface ExecStatusHandler {
    onMessage(m: {
        type: string;
        phase?: string;
        mcp_servers?: unknown;
    }): void;
    dispose(): void;
}
export declare function createExecStatusHandler(opts: {
    enabled: boolean;
    timeoutMs: number;
    emit: (ev: Record<string, unknown>) => void;
    terminate: (code: 'runner-error', exitCode: number) => void;
}): ExecStatusHandler;
/**
 * `status` notices a non-claude turn gets right after `start` (rev 19):
 * what `--settings` makes the CLI load, and an `--effort` the runtime does
 * not honor. `phase:"notice"` + `message`; claude's own
 * `initializing`/`ready` pair is unchanged and never produced here.
 */
export declare function runtimeStartupNotices(opts: {
    runtime: string;
    settings?: readonly string[];
    effort?: string;
    effortSupported: boolean;
}): Array<Record<string, unknown>>;
//# sourceMappingURL=agent-exec-settings.d.ts.map