import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
/**
 * Send a kickoff message into the agent loop with `deliverAs: "steer"`.
 *
 * Callers MUST NEVER raw-call `pi.sendUserMessage` from inside a command
 * handler. The `deliverAs: "steer"` option is required because the handler
 * is itself a turn — without it pi rejects the message as "Agent is already
 * processing" (BUG-017 / BUG-023).
 *
 * Kickoff text MUST be LLM workflow prose, never a slash-command string:
 * pi's `sendUserMessage` routes through `prompt(text, {
 * expandPromptTemplates: false })`, which skips extension-command dispatch
 * entirely — a steered "/forge:..." string lands as literal prose the model
 * cannot execute (pi also forbids queueing extension commands:
 * steer()/followUp() throw "cannot be queued"). To trigger another command's
 * behaviour, call its exported run* function in-process instead (e.g.
 * `runEnhance`).
 */
export declare function sendKickoff(pi: ExtensionAPI, text: string): void;