@userreason/cli 0.1.1 → 0.2.0

package/dist/setup.d.ts

@@ -0,0 +1,1223 @@
+import { SetupError, type StoredSetup } from './setup-store.js';
+import { parseSetupStartResult, type SetupCapabilities, type SetupSessionView } from './setup-wire.js';
+export interface SetupTransportOptions {
+    fetcher?: typeof fetch;
+    signal?: AbortSignal;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+    onProgress?: (state: 'waiting' | 'retrying') => void;
+    /** Suppress optional server-side setup milestones as well as local measurement. */
+    measurementDisabled?: boolean;
+}
+export declare class BrowserSetupUnavailable extends SetupError {
+    constructor();
+}
+export declare function discoverBrowserSetup(origin: string, options?: SetupTransportOptions): Promise<{
+    schema_version: 1;
+    browser_setup: {
+        versions: 1[];
+        enabled: boolean;
+        source_analysis: boolean;
+        draft_creation: boolean;
+        sample_read: boolean;
+    } & {};
+} & {}>;
+export declare function validateSetupBrowserUrl(value: ReturnType<typeof parseSetupStartResult>, expectedOrigin: string, challenge: string, now: number): string;
+/** The handshake never installs packages, edits source or grants management access. */
+export declare function connectBrowserSetup(origin: string, input: {
+    directory: string;
+    capabilities: SetupCapabilities;
+    browserOrigin?: string;
+}, onBrowser: (url: string, code: string) => Promise<void>, options?: SetupTransportOptions): Promise<{
+    client: BrowserSetupClient;
+    session: SetupSessionView;
+}>;
+export declare function resumeBrowserSetup(origin: string, setupId: string, directory: string, options?: SetupTransportOptions): Promise<{
+    client: BrowserSetupClient;
+    session: {
+        phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+        revision: string;
+        workspace_id: string | null;
+        site_id: string | null;
+        project_fingerprint: string;
+        choices: {
+            install_sdk: boolean;
+            install_skill: boolean;
+            footer_badge: boolean;
+        } & {};
+        capabilities: {
+            framework: string;
+            package_manager: string;
+            install_packages: boolean;
+            initialize_sdk: boolean;
+            install_skill: boolean;
+            insert_footer: boolean;
+            source_review: boolean;
+            sample_read: boolean;
+        } & {
+            project_name?: string | undefined;
+            terminal?: ({
+                platform: string;
+                app: string;
+            } & {}) | undefined;
+        };
+        local_plan: ({
+            project_fingerprint: string;
+            choices_digest: string;
+            effects: import("./setup-wire.js").SetupEffect[];
+        } & {
+            manual_steps?: ({
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                code: string;
+            } & {})[] | undefined;
+        }) | null;
+        plan_digest: string | null;
+        commands: ({
+            operation_id: string;
+            sequence: number;
+            kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+            expected_revision: string;
+            input: import("./setup-wire.js").SetupEffect;
+            input_digest: string;
+            approval_digest: string;
+            status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+            executor_generation: number | null;
+            lease_generation: number;
+            lease_expires_at: string | null;
+            result: ({
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+            } & {
+                verified?: boolean | undefined;
+            }) | null;
+            result_digest: string | null;
+            created_at: string;
+            started_at: string | null;
+            finished_at: string | null;
+            updated_at: string;
+        } & {})[];
+        executor_generation: number;
+        connection: string;
+        heartbeat_at: string | null;
+        sample: {
+            status: string;
+            first_received_at: string | null;
+            latest_received_at: string | null;
+            latest_request_id: string | null;
+        } & {};
+        draft_outcomes: ({
+            candidate_id: string;
+            status: string;
+            prompt_id: string;
+            request_id: string;
+            revision: string | null;
+            code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+        } & {})[];
+        bound_at: string;
+        last_activity_at: string;
+        idle_expires_at: string;
+        absolute_expires_at: string;
+        terminal_at: string | null;
+        schema_version: 1;
+        setup_id: string;
+    } & {
+        source?: ({
+            preparation_id: string;
+            status: string;
+            packet_digest: string;
+            provider_fingerprint: string;
+            authorized_at: string | null;
+            expires_at: string;
+            error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+        } & {}) | null | undefined;
+        recommendation_digest?: string | null | undefined;
+        selected_candidates?: string[] | undefined;
+    };
+}>;
+export declare class BrowserSetupClient {
+    #private;
+    constructor(stored: Extract<StoredSetup, {
+        state: 'connected';
+    }>, options?: SetupTransportOptions);
+    /** Nonsecret identity for the local executor journal; never exposes the bearer. */
+    get identity(): {
+        setup_id: string;
+        api_url: string;
+        project_fingerprint: string;
+        expires_at: string;
+    };
+    private call;
+    private scoped;
+    private view;
+    poll(): Promise<{
+        phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+        revision: string;
+        workspace_id: string | null;
+        site_id: string | null;
+        project_fingerprint: string;
+        choices: {
+            install_sdk: boolean;
+            install_skill: boolean;
+            footer_badge: boolean;
+        } & {};
+        capabilities: {
+            framework: string;
+            package_manager: string;
+            install_packages: boolean;
+            initialize_sdk: boolean;
+            install_skill: boolean;
+            insert_footer: boolean;
+            source_review: boolean;
+            sample_read: boolean;
+        } & {
+            project_name?: string | undefined;
+            terminal?: ({
+                platform: string;
+                app: string;
+            } & {}) | undefined;
+        };
+        local_plan: ({
+            project_fingerprint: string;
+            choices_digest: string;
+            effects: import("./setup-wire.js").SetupEffect[];
+        } & {
+            manual_steps?: ({
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                code: string;
+            } & {})[] | undefined;
+        }) | null;
+        plan_digest: string | null;
+        commands: ({
+            operation_id: string;
+            sequence: number;
+            kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+            expected_revision: string;
+            input: import("./setup-wire.js").SetupEffect;
+            input_digest: string;
+            approval_digest: string;
+            status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+            executor_generation: number | null;
+            lease_generation: number;
+            lease_expires_at: string | null;
+            result: ({
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+            } & {
+                verified?: boolean | undefined;
+            }) | null;
+            result_digest: string | null;
+            created_at: string;
+            started_at: string | null;
+            finished_at: string | null;
+            updated_at: string;
+        } & {})[];
+        executor_generation: number;
+        connection: string;
+        heartbeat_at: string | null;
+        sample: {
+            status: string;
+            first_received_at: string | null;
+            latest_received_at: string | null;
+            latest_request_id: string | null;
+        } & {};
+        draft_outcomes: ({
+            candidate_id: string;
+            status: string;
+            prompt_id: string;
+            request_id: string;
+            revision: string | null;
+            code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+        } & {})[];
+        bound_at: string;
+        last_activity_at: string;
+        idle_expires_at: string;
+        absolute_expires_at: string;
+        terminal_at: string | null;
+        schema_version: 1;
+        setup_id: string;
+    } & {
+        source?: ({
+            preparation_id: string;
+            status: string;
+            packet_digest: string;
+            provider_fingerprint: string;
+            authorized_at: string | null;
+            expires_at: string;
+            error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+        } & {}) | null | undefined;
+        recommendation_digest?: string | null | undefined;
+        selected_candidates?: string[] | undefined;
+    }>;
+    discovery(): Promise<{
+        schema_version: 1;
+        browser_setup: {
+            versions: 1[];
+            enabled: boolean;
+            source_analysis: boolean;
+            draft_creation: boolean;
+            sample_read: boolean;
+        } & {};
+    } & {}>;
+    sourceInfo(): Promise<{
+        schema_version: 1;
+        session: {
+            phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+            revision: string;
+            workspace_id: string | null;
+            site_id: string | null;
+            project_fingerprint: string;
+            choices: {
+                install_sdk: boolean;
+                install_skill: boolean;
+                footer_badge: boolean;
+            } & {};
+            capabilities: {
+                framework: string;
+                package_manager: string;
+                install_packages: boolean;
+                initialize_sdk: boolean;
+                install_skill: boolean;
+                insert_footer: boolean;
+                source_review: boolean;
+                sample_read: boolean;
+            } & {
+                project_name?: string | undefined;
+                terminal?: ({
+                    platform: string;
+                    app: string;
+                } & {}) | undefined;
+            };
+            local_plan: ({
+                project_fingerprint: string;
+                choices_digest: string;
+                effects: import("./setup-wire.js").SetupEffect[];
+            } & {
+                manual_steps?: ({
+                    kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                    code: string;
+                } & {})[] | undefined;
+            }) | null;
+            plan_digest: string | null;
+            commands: ({
+                operation_id: string;
+                sequence: number;
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                expected_revision: string;
+                input: import("./setup-wire.js").SetupEffect;
+                input_digest: string;
+                approval_digest: string;
+                status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+                executor_generation: number | null;
+                lease_generation: number;
+                lease_expires_at: string | null;
+                result: ({
+                    code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+                } & {
+                    verified?: boolean | undefined;
+                }) | null;
+                result_digest: string | null;
+                created_at: string;
+                started_at: string | null;
+                finished_at: string | null;
+                updated_at: string;
+            } & {})[];
+            executor_generation: number;
+            connection: string;
+            heartbeat_at: string | null;
+            sample: {
+                status: string;
+                first_received_at: string | null;
+                latest_received_at: string | null;
+                latest_request_id: string | null;
+            } & {};
+            draft_outcomes: ({
+                candidate_id: string;
+                status: string;
+                prompt_id: string;
+                request_id: string;
+                revision: string | null;
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+            } & {})[];
+            bound_at: string;
+            last_activity_at: string;
+            idle_expires_at: string;
+            absolute_expires_at: string;
+            terminal_at: string | null;
+            schema_version: 1;
+            setup_id: string;
+        } & {
+            source?: ({
+                preparation_id: string;
+                status: string;
+                packet_digest: string;
+                provider_fingerprint: string;
+                authorized_at: string | null;
+                expires_at: string;
+                error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+            } & {}) | null | undefined;
+            recommendation_digest?: string | null | undefined;
+            selected_candidates?: string[] | undefined;
+        };
+        preparation: ({
+            preparation_id: string;
+            manifest: {
+                packet_digest: string;
+                snapshot_id: string;
+                files: ({
+                    path: string;
+                    file_hash: string;
+                    excerpt_hash: string;
+                    bytes: number;
+                    start_line: number;
+                    end_line: number;
+                } & {})[];
+                omitted_files: number;
+                truncated: boolean;
+                git_included: false;
+            } & {};
+            packages: ({
+                name: string;
+                version: string;
+            } & {})[];
+            configuration: {
+                configuration_fingerprint: string;
+                providers: ({
+                    role: string;
+                    destination: string;
+                    model: string;
+                    prices: {
+                        input_microUSD_per_million: string;
+                        output_microUSD_per_million: string;
+                    } & {};
+                } & {})[];
+                policy: string;
+                retention: "private-plan-7-days;source-not-stored;store-false";
+                limits: {
+                    input_tokens: number;
+                    output_tokens: number;
+                    deadline_ms: number;
+                } & {};
+            } & {};
+        } & {}) | null;
+    } & {}>;
+    sourcePlan(input: unknown): Promise<{
+        phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+        revision: string;
+        workspace_id: string | null;
+        site_id: string | null;
+        project_fingerprint: string;
+        choices: {
+            install_sdk: boolean;
+            install_skill: boolean;
+            footer_badge: boolean;
+        } & {};
+        capabilities: {
+            framework: string;
+            package_manager: string;
+            install_packages: boolean;
+            initialize_sdk: boolean;
+            install_skill: boolean;
+            insert_footer: boolean;
+            source_review: boolean;
+            sample_read: boolean;
+        } & {
+            project_name?: string | undefined;
+            terminal?: ({
+                platform: string;
+                app: string;
+            } & {}) | undefined;
+        };
+        local_plan: ({
+            project_fingerprint: string;
+            choices_digest: string;
+            effects: import("./setup-wire.js").SetupEffect[];
+        } & {
+            manual_steps?: ({
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                code: string;
+            } & {})[] | undefined;
+        }) | null;
+        plan_digest: string | null;
+        commands: ({
+            operation_id: string;
+            sequence: number;
+            kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+            expected_revision: string;
+            input: import("./setup-wire.js").SetupEffect;
+            input_digest: string;
+            approval_digest: string;
+            status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+            executor_generation: number | null;
+            lease_generation: number;
+            lease_expires_at: string | null;
+            result: ({
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+            } & {
+                verified?: boolean | undefined;
+            }) | null;
+            result_digest: string | null;
+            created_at: string;
+            started_at: string | null;
+            finished_at: string | null;
+            updated_at: string;
+        } & {})[];
+        executor_generation: number;
+        connection: string;
+        heartbeat_at: string | null;
+        sample: {
+            status: string;
+            first_received_at: string | null;
+            latest_received_at: string | null;
+            latest_request_id: string | null;
+        } & {};
+        draft_outcomes: ({
+            candidate_id: string;
+            status: string;
+            prompt_id: string;
+            request_id: string;
+            revision: string | null;
+            code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+        } & {})[];
+        bound_at: string;
+        last_activity_at: string;
+        idle_expires_at: string;
+        absolute_expires_at: string;
+        terminal_at: string | null;
+        schema_version: 1;
+        setup_id: string;
+    } & {
+        source?: ({
+            preparation_id: string;
+            status: string;
+            packet_digest: string;
+            provider_fingerprint: string;
+            authorized_at: string | null;
+            expires_at: string;
+            error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+        } & {}) | null | undefined;
+        recommendation_digest?: string | null | undefined;
+        selected_candidates?: string[] | undefined;
+    }>;
+    sourceUpload(input: unknown): Promise<{
+        phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+        revision: string;
+        workspace_id: string | null;
+        site_id: string | null;
+        project_fingerprint: string;
+        choices: {
+            install_sdk: boolean;
+            install_skill: boolean;
+            footer_badge: boolean;
+        } & {};
+        capabilities: {
+            framework: string;
+            package_manager: string;
+            install_packages: boolean;
+            initialize_sdk: boolean;
+            install_skill: boolean;
+            insert_footer: boolean;
+            source_review: boolean;
+            sample_read: boolean;
+        } & {
+            project_name?: string | undefined;
+            terminal?: ({
+                platform: string;
+                app: string;
+            } & {}) | undefined;
+        };
+        local_plan: ({
+            project_fingerprint: string;
+            choices_digest: string;
+            effects: import("./setup-wire.js").SetupEffect[];
+        } & {
+            manual_steps?: ({
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                code: string;
+            } & {})[] | undefined;
+        }) | null;
+        plan_digest: string | null;
+        commands: ({
+            operation_id: string;
+            sequence: number;
+            kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+            expected_revision: string;
+            input: import("./setup-wire.js").SetupEffect;
+            input_digest: string;
+            approval_digest: string;
+            status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+            executor_generation: number | null;
+            lease_generation: number;
+            lease_expires_at: string | null;
+            result: ({
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+            } & {
+                verified?: boolean | undefined;
+            }) | null;
+            result_digest: string | null;
+            created_at: string;
+            started_at: string | null;
+            finished_at: string | null;
+            updated_at: string;
+        } & {})[];
+        executor_generation: number;
+        connection: string;
+        heartbeat_at: string | null;
+        sample: {
+            status: string;
+            first_received_at: string | null;
+            latest_received_at: string | null;
+            latest_request_id: string | null;
+        } & {};
+        draft_outcomes: ({
+            candidate_id: string;
+            status: string;
+            prompt_id: string;
+            request_id: string;
+            revision: string | null;
+            code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+        } & {})[];
+        bound_at: string;
+        last_activity_at: string;
+        idle_expires_at: string;
+        absolute_expires_at: string;
+        terminal_at: string | null;
+        schema_version: 1;
+        setup_id: string;
+    } & {
+        source?: ({
+            preparation_id: string;
+            status: string;
+            packet_digest: string;
+            provider_fingerprint: string;
+            authorized_at: string | null;
+            expires_at: string;
+            error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+        } & {}) | null | undefined;
+        recommendation_digest?: string | null | undefined;
+        selected_candidates?: string[] | undefined;
+    }>;
+    plan(input: unknown): Promise<{
+        phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+        revision: string;
+        workspace_id: string | null;
+        site_id: string | null;
+        project_fingerprint: string;
+        choices: {
+            install_sdk: boolean;
+            install_skill: boolean;
+            footer_badge: boolean;
+        } & {};
+        capabilities: {
+            framework: string;
+            package_manager: string;
+            install_packages: boolean;
+            initialize_sdk: boolean;
+            install_skill: boolean;
+            insert_footer: boolean;
+            source_review: boolean;
+            sample_read: boolean;
+        } & {
+            project_name?: string | undefined;
+            terminal?: ({
+                platform: string;
+                app: string;
+            } & {}) | undefined;
+        };
+        local_plan: ({
+            project_fingerprint: string;
+            choices_digest: string;
+            effects: import("./setup-wire.js").SetupEffect[];
+        } & {
+            manual_steps?: ({
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                code: string;
+            } & {})[] | undefined;
+        }) | null;
+        plan_digest: string | null;
+        commands: ({
+            operation_id: string;
+            sequence: number;
+            kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+            expected_revision: string;
+            input: import("./setup-wire.js").SetupEffect;
+            input_digest: string;
+            approval_digest: string;
+            status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+            executor_generation: number | null;
+            lease_generation: number;
+            lease_expires_at: string | null;
+            result: ({
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+            } & {
+                verified?: boolean | undefined;
+            }) | null;
+            result_digest: string | null;
+            created_at: string;
+            started_at: string | null;
+            finished_at: string | null;
+            updated_at: string;
+        } & {})[];
+        executor_generation: number;
+        connection: string;
+        heartbeat_at: string | null;
+        sample: {
+            status: string;
+            first_received_at: string | null;
+            latest_received_at: string | null;
+            latest_request_id: string | null;
+        } & {};
+        draft_outcomes: ({
+            candidate_id: string;
+            status: string;
+            prompt_id: string;
+            request_id: string;
+            revision: string | null;
+            code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+        } & {})[];
+        bound_at: string;
+        last_activity_at: string;
+        idle_expires_at: string;
+        absolute_expires_at: string;
+        terminal_at: string | null;
+        schema_version: 1;
+        setup_id: string;
+    } & {
+        source?: ({
+            preparation_id: string;
+            status: string;
+            packet_digest: string;
+            provider_fingerprint: string;
+            authorized_at: string | null;
+            expires_at: string;
+            error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+        } & {}) | null | undefined;
+        recommendation_digest?: string | null | undefined;
+        selected_candidates?: string[] | undefined;
+    }>;
+    claim(input: unknown): Promise<{
+        schema_version: 1;
+        command: ({
+            operation_id: string;
+            sequence: number;
+            kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+            expected_revision: string;
+            input: import("./setup-wire.js").SetupEffect;
+            input_digest: string;
+            approval_digest: string;
+            status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+            executor_generation: number | null;
+            lease_generation: number;
+            lease_expires_at: string | null;
+            result: ({
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+            } & {
+                verified?: boolean | undefined;
+            }) | null;
+            result_digest: string | null;
+            created_at: string;
+            started_at: string | null;
+            finished_at: string | null;
+            updated_at: string;
+        } & {}) | null;
+        session: {
+            phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+            revision: string;
+            workspace_id: string | null;
+            site_id: string | null;
+            project_fingerprint: string;
+            choices: {
+                install_sdk: boolean;
+                install_skill: boolean;
+                footer_badge: boolean;
+            } & {};
+            capabilities: {
+                framework: string;
+                package_manager: string;
+                install_packages: boolean;
+                initialize_sdk: boolean;
+                install_skill: boolean;
+                insert_footer: boolean;
+                source_review: boolean;
+                sample_read: boolean;
+            } & {
+                project_name?: string | undefined;
+                terminal?: ({
+                    platform: string;
+                    app: string;
+                } & {}) | undefined;
+            };
+            local_plan: ({
+                project_fingerprint: string;
+                choices_digest: string;
+                effects: import("./setup-wire.js").SetupEffect[];
+            } & {
+                manual_steps?: ({
+                    kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                    code: string;
+                } & {})[] | undefined;
+            }) | null;
+            plan_digest: string | null;
+            commands: ({
+                operation_id: string;
+                sequence: number;
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                expected_revision: string;
+                input: import("./setup-wire.js").SetupEffect;
+                input_digest: string;
+                approval_digest: string;
+                status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+                executor_generation: number | null;
+                lease_generation: number;
+                lease_expires_at: string | null;
+                result: ({
+                    code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+                } & {
+                    verified?: boolean | undefined;
+                }) | null;
+                result_digest: string | null;
+                created_at: string;
+                started_at: string | null;
+                finished_at: string | null;
+                updated_at: string;
+            } & {})[];
+            executor_generation: number;
+            connection: string;
+            heartbeat_at: string | null;
+            sample: {
+                status: string;
+                first_received_at: string | null;
+                latest_received_at: string | null;
+                latest_request_id: string | null;
+            } & {};
+            draft_outcomes: ({
+                candidate_id: string;
+                status: string;
+                prompt_id: string;
+                request_id: string;
+                revision: string | null;
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+            } & {})[];
+            bound_at: string;
+            last_activity_at: string;
+            idle_expires_at: string;
+            absolute_expires_at: string;
+            terminal_at: string | null;
+            schema_version: 1;
+            setup_id: string;
+        } & {
+            source?: ({
+                preparation_id: string;
+                status: string;
+                packet_digest: string;
+                provider_fingerprint: string;
+                authorized_at: string | null;
+                expires_at: string;
+                error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+            } & {}) | null | undefined;
+            recommendation_digest?: string | null | undefined;
+            selected_candidates?: string[] | undefined;
+        };
+    } & {}>;
+    startCommand(input: unknown): Promise<{
+        phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+        revision: string;
+        workspace_id: string | null;
+        site_id: string | null;
+        project_fingerprint: string;
+        choices: {
+            install_sdk: boolean;
+            install_skill: boolean;
+            footer_badge: boolean;
+        } & {};
+        capabilities: {
+            framework: string;
+            package_manager: string;
+            install_packages: boolean;
+            initialize_sdk: boolean;
+            install_skill: boolean;
+            insert_footer: boolean;
+            source_review: boolean;
+            sample_read: boolean;
+        } & {
+            project_name?: string | undefined;
+            terminal?: ({
+                platform: string;
+                app: string;
+            } & {}) | undefined;
+        };
+        local_plan: ({
+            project_fingerprint: string;
+            choices_digest: string;
+            effects: import("./setup-wire.js").SetupEffect[];
+        } & {
+            manual_steps?: ({
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                code: string;
+            } & {})[] | undefined;
+        }) | null;
+        plan_digest: string | null;
+        commands: ({
+            operation_id: string;
+            sequence: number;
+            kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+            expected_revision: string;
+            input: import("./setup-wire.js").SetupEffect;
+            input_digest: string;
+            approval_digest: string;
+            status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+            executor_generation: number | null;
+            lease_generation: number;
+            lease_expires_at: string | null;
+            result: ({
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+            } & {
+                verified?: boolean | undefined;
+            }) | null;
+            result_digest: string | null;
+            created_at: string;
+            started_at: string | null;
+            finished_at: string | null;
+            updated_at: string;
+        } & {})[];
+        executor_generation: number;
+        connection: string;
+        heartbeat_at: string | null;
+        sample: {
+            status: string;
+            first_received_at: string | null;
+            latest_received_at: string | null;
+            latest_request_id: string | null;
+        } & {};
+        draft_outcomes: ({
+            candidate_id: string;
+            status: string;
+            prompt_id: string;
+            request_id: string;
+            revision: string | null;
+            code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+        } & {})[];
+        bound_at: string;
+        last_activity_at: string;
+        idle_expires_at: string;
+        absolute_expires_at: string;
+        terminal_at: string | null;
+        schema_version: 1;
+        setup_id: string;
+    } & {
+        source?: ({
+            preparation_id: string;
+            status: string;
+            packet_digest: string;
+            provider_fingerprint: string;
+            authorized_at: string | null;
+            expires_at: string;
+            error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+        } & {}) | null | undefined;
+        recommendation_digest?: string | null | undefined;
+        selected_candidates?: string[] | undefined;
+    }>;
+    report(input: unknown): Promise<{
+        phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+        revision: string;
+        workspace_id: string | null;
+        site_id: string | null;
+        project_fingerprint: string;
+        choices: {
+            install_sdk: boolean;
+            install_skill: boolean;
+            footer_badge: boolean;
+        } & {};
+        capabilities: {
+            framework: string;
+            package_manager: string;
+            install_packages: boolean;
+            initialize_sdk: boolean;
+            install_skill: boolean;
+            insert_footer: boolean;
+            source_review: boolean;
+            sample_read: boolean;
+        } & {
+            project_name?: string | undefined;
+            terminal?: ({
+                platform: string;
+                app: string;
+            } & {}) | undefined;
+        };
+        local_plan: ({
+            project_fingerprint: string;
+            choices_digest: string;
+            effects: import("./setup-wire.js").SetupEffect[];
+        } & {
+            manual_steps?: ({
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                code: string;
+            } & {})[] | undefined;
+        }) | null;
+        plan_digest: string | null;
+        commands: ({
+            operation_id: string;
+            sequence: number;
+            kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+            expected_revision: string;
+            input: import("./setup-wire.js").SetupEffect;
+            input_digest: string;
+            approval_digest: string;
+            status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+            executor_generation: number | null;
+            lease_generation: number;
+            lease_expires_at: string | null;
+            result: ({
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+            } & {
+                verified?: boolean | undefined;
+            }) | null;
+            result_digest: string | null;
+            created_at: string;
+            started_at: string | null;
+            finished_at: string | null;
+            updated_at: string;
+        } & {})[];
+        executor_generation: number;
+        connection: string;
+        heartbeat_at: string | null;
+        sample: {
+            status: string;
+            first_received_at: string | null;
+            latest_received_at: string | null;
+            latest_request_id: string | null;
+        } & {};
+        draft_outcomes: ({
+            candidate_id: string;
+            status: string;
+            prompt_id: string;
+            request_id: string;
+            revision: string | null;
+            code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+        } & {})[];
+        bound_at: string;
+        last_activity_at: string;
+        idle_expires_at: string;
+        absolute_expires_at: string;
+        terminal_at: string | null;
+        schema_version: 1;
+        setup_id: string;
+    } & {
+        source?: ({
+            preparation_id: string;
+            status: string;
+            packet_digest: string;
+            provider_fingerprint: string;
+            authorized_at: string | null;
+            expires_at: string;
+            error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+        } & {}) | null | undefined;
+        recommendation_digest?: string | null | undefined;
+        selected_candidates?: string[] | undefined;
+    }>;
+    heartbeat(input: unknown): Promise<{
+        phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+        revision: string;
+        workspace_id: string | null;
+        site_id: string | null;
+        project_fingerprint: string;
+        choices: {
+            install_sdk: boolean;
+            install_skill: boolean;
+            footer_badge: boolean;
+        } & {};
+        capabilities: {
+            framework: string;
+            package_manager: string;
+            install_packages: boolean;
+            initialize_sdk: boolean;
+            install_skill: boolean;
+            insert_footer: boolean;
+            source_review: boolean;
+            sample_read: boolean;
+        } & {
+            project_name?: string | undefined;
+            terminal?: ({
+                platform: string;
+                app: string;
+            } & {}) | undefined;
+        };
+        local_plan: ({
+            project_fingerprint: string;
+            choices_digest: string;
+            effects: import("./setup-wire.js").SetupEffect[];
+        } & {
+            manual_steps?: ({
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                code: string;
+            } & {})[] | undefined;
+        }) | null;
+        plan_digest: string | null;
+        commands: ({
+            operation_id: string;
+            sequence: number;
+            kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+            expected_revision: string;
+            input: import("./setup-wire.js").SetupEffect;
+            input_digest: string;
+            approval_digest: string;
+            status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+            executor_generation: number | null;
+            lease_generation: number;
+            lease_expires_at: string | null;
+            result: ({
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+            } & {
+                verified?: boolean | undefined;
+            }) | null;
+            result_digest: string | null;
+            created_at: string;
+            started_at: string | null;
+            finished_at: string | null;
+            updated_at: string;
+        } & {})[];
+        executor_generation: number;
+        connection: string;
+        heartbeat_at: string | null;
+        sample: {
+            status: string;
+            first_received_at: string | null;
+            latest_received_at: string | null;
+            latest_request_id: string | null;
+        } & {};
+        draft_outcomes: ({
+            candidate_id: string;
+            status: string;
+            prompt_id: string;
+            request_id: string;
+            revision: string | null;
+            code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+        } & {})[];
+        bound_at: string;
+        last_activity_at: string;
+        idle_expires_at: string;
+        absolute_expires_at: string;
+        terminal_at: string | null;
+        schema_version: 1;
+        setup_id: string;
+    } & {
+        source?: ({
+            preparation_id: string;
+            status: string;
+            packet_digest: string;
+            provider_fingerprint: string;
+            authorized_at: string | null;
+            expires_at: string;
+            error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+        } & {}) | null | undefined;
+        recommendation_digest?: string | null | undefined;
+        selected_candidates?: string[] | undefined;
+    }>;
+    reconcile(input: unknown): Promise<{
+        phase: "expired" | "cancelled" | "analyzing" | "configuring" | "awaiting_local_approval" | "applying" | "ready_for_recommendations" | "selecting_drafts" | "creating_drafts" | "agent_test" | "complete";
+        revision: string;
+        workspace_id: string | null;
+        site_id: string | null;
+        project_fingerprint: string;
+        choices: {
+            install_sdk: boolean;
+            install_skill: boolean;
+            footer_badge: boolean;
+        } & {};
+        capabilities: {
+            framework: string;
+            package_manager: string;
+            install_packages: boolean;
+            initialize_sdk: boolean;
+            install_skill: boolean;
+            insert_footer: boolean;
+            source_review: boolean;
+            sample_read: boolean;
+        } & {
+            project_name?: string | undefined;
+            terminal?: ({
+                platform: string;
+                app: string;
+            } & {}) | undefined;
+        };
+        local_plan: ({
+            project_fingerprint: string;
+            choices_digest: string;
+            effects: import("./setup-wire.js").SetupEffect[];
+        } & {
+            manual_steps?: ({
+                kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+                code: string;
+            } & {})[] | undefined;
+        }) | null;
+        plan_digest: string | null;
+        commands: ({
+            operation_id: string;
+            sequence: number;
+            kind: "install_packages" | "initialize_sdk" | "install_skill" | "insert_footer";
+            expected_revision: string;
+            input: import("./setup-wire.js").SetupEffect;
+            input_digest: string;
+            approval_digest: string;
+            status: "approved" | "manual" | "cancelled" | "failed" | "outcome_unknown" | "prepared" | "leased" | "running" | "succeeded";
+            executor_generation: number | null;
+            lease_generation: number;
+            lease_expires_at: string | null;
+            result: ({
+                code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown";
+            } & {
+                verified?: boolean | undefined;
+            }) | null;
+            result_digest: string | null;
+            created_at: string;
+            started_at: string | null;
+            finished_at: string | null;
+            updated_at: string;
+        } & {})[];
+        executor_generation: number;
+        connection: string;
+        heartbeat_at: string | null;
+        sample: {
+            status: string;
+            first_received_at: string | null;
+            latest_received_at: string | null;
+            latest_request_id: string | null;
+        } & {};
+        draft_outcomes: ({
+            candidate_id: string;
+            status: string;
+            prompt_id: string;
+            request_id: string;
+            revision: string | null;
+            code: "cancelled" | "skipped" | "already_present" | "unsupported" | "operation_failed" | "verified" | "review_required" | "dependency_failed" | "outcome_unknown" | null;
+        } & {})[];
+        bound_at: string;
+        last_activity_at: string;
+        idle_expires_at: string;
+        absolute_expires_at: string;
+        terminal_at: string | null;
+        schema_version: 1;
+        setup_id: string;
+    } & {
+        source?: ({
+            preparation_id: string;
+            status: string;
+            packet_digest: string;
+            provider_fingerprint: string;
+            authorized_at: string | null;
+            expires_at: string;
+            error_code: "operation_failed" | "planning_unavailable" | "planning_paused" | "planning_daily_budget" | "planning_allowance_exhausted" | "planning_provider_unavailable" | "planning_policy_changed" | "planning_consent_expired" | "planning_input_budget" | "planning_invalid_output" | "planning_timeout" | "source_changed" | "source_unavailable" | "recommendations_no_source" | null;
+        } & {}) | null | undefined;
+        recommendation_digest?: string | null | undefined;
+        selected_candidates?: string[] | undefined;
+    }>;
+    sample(requestId?: string): Promise<{
+        sample: true;
+        dataset_version: "setup-sample-v1";
+        received_at: string;
+        answers: ({
+            id: string;
+            question: string;
+            answer: string;
+        } & {})[];
+        schema_version: 1;
+        setup_id: string;
+    } & {}>;
+}