import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";

export type ContextMode = "fresh" | "branch";
export type WorkspaceMode = "shared" | "worktree";

export interface SpawnTeammateOptions {
	name: string;
	mode?: ContextMode;
	workspaceMode?: WorkspaceMode;
	planRequired?: boolean;
	/**
	 * Optional model override for the spawned teammate.
	 *
	 * Supported forms:
	 * - "<provider>/<modelId>"  (e.g. "openai-codex/gpt-5.1-codex-mini")
	 * - "<modelId>"             (provider inherited from leader when available)
	 */
	model?: string;
	/** Optional thinking level override for the spawned teammate. */
	thinking?: ThinkingLevel;
}

export type SpawnTeammateResult =
	| {
			ok: true;
			name: string;
			mode: ContextMode;
			workspaceMode: WorkspaceMode;
			childCwd?: string;
			note?: string;
			/** The resolved model string (provider/modelId or modelId), if any. */
			model?: string;
			/** The effective thinking level for this teammate. */
			thinking?: ThinkingLevel;
			warnings: string[];
	  }
	| { ok: false; error: string };

export type SpawnTeammateFn = (ctx: ExtensionContext, opts: SpawnTeammateOptions) => Promise<SpawnTeammateResult>;