@userreason/cli 0.2.0 → 0.2.1

package/dist/setup.d.ts

@@ -55,7 +55,14 @@ export declare function resumeBrowserSetup(origin: string, setupId: string, dire
             source_review: boolean;
             sample_read: boolean;
         } & {
+            onboarding_v2?: boolean | undefined;
             project_name?: string | undefined;
+            launcher?: ({
+                wizard_version: string;
+                api_origin: string;
+            } & {
+                registry?: string | undefined;
+            }) | undefined;
             terminal?: ({
                 platform: string;
                 app: string;
@@ -128,7 +135,18 @@ export declare function resumeBrowserSetup(origin: string, setupId: string, dire
             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;
+        } & {
+            analysis_id?: string | undefined;
+            analysis_started_at?: string | undefined;
+            analysis_completed_at?: string | undefined;
+            deadline_at?: string | undefined;
+            timings?: ({} & {
+                extraction_ms?: number | undefined;
+                consolidation_ms?: number | undefined;
+                authoring_ms?: number | undefined;
+                total_ms?: number | undefined;
+            }) | undefined;
+        }) | null | undefined;
         recommendation_digest?: string | null | undefined;
         selected_candidates?: string[] | undefined;
     };
@@ -145,6 +163,8 @@ export declare class BrowserSetupClient {
         project_fingerprint: string;
         expires_at: string;
     };
+    /** Share the same saved capability while binding requests to one run's lifetime. */
+    withSignal(signal: AbortSignal): BrowserSetupClient;
     private call;
     private scoped;
     private view;
@@ -169,7 +189,14 @@ export declare class BrowserSetupClient {
             source_review: boolean;
             sample_read: boolean;
         } & {
+            onboarding_v2?: boolean | undefined;
             project_name?: string | undefined;
+            launcher?: ({
+                wizard_version: string;
+                api_origin: string;
+            } & {
+                registry?: string | undefined;
+            }) | undefined;
             terminal?: ({
                 platform: string;
                 app: string;
@@ -242,7 +269,18 @@ export declare class BrowserSetupClient {
             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;
+        } & {
+            analysis_id?: string | undefined;
+            analysis_started_at?: string | undefined;
+            analysis_completed_at?: string | undefined;
+            deadline_at?: string | undefined;
+            timings?: ({} & {
+                extraction_ms?: number | undefined;
+                consolidation_ms?: number | undefined;
+                authoring_ms?: number | undefined;
+                total_ms?: number | undefined;
+            }) | undefined;
+        }) | null | undefined;
         recommendation_digest?: string | null | undefined;
         selected_candidates?: string[] | undefined;
     }>;
@@ -279,7 +317,14 @@ export declare class BrowserSetupClient {
                 source_review: boolean;
                 sample_read: boolean;
             } & {
+                onboarding_v2?: boolean | undefined;
                 project_name?: string | undefined;
+                launcher?: ({
+                    wizard_version: string;
+                    api_origin: string;
+                } & {
+                    registry?: string | undefined;
+                }) | undefined;
                 terminal?: ({
                     platform: string;
                     app: string;
@@ -352,7 +397,18 @@ export declare class BrowserSetupClient {
                 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;
+            } & {
+                analysis_id?: string | undefined;
+                analysis_started_at?: string | undefined;
+                analysis_completed_at?: string | undefined;
+                deadline_at?: string | undefined;
+                timings?: ({} & {
+                    extraction_ms?: number | undefined;
+                    consolidation_ms?: number | undefined;
+                    authoring_ms?: number | undefined;
+                    total_ms?: number | undefined;
+                }) | undefined;
+            }) | null | undefined;
             recommendation_digest?: string | null | undefined;
             selected_candidates?: string[] | undefined;
         };
@@ -419,7 +475,14 @@ export declare class BrowserSetupClient {
             source_review: boolean;
             sample_read: boolean;
         } & {
+            onboarding_v2?: boolean | undefined;
             project_name?: string | undefined;
+            launcher?: ({
+                wizard_version: string;
+                api_origin: string;
+            } & {
+                registry?: string | undefined;
+            }) | undefined;
             terminal?: ({
                 platform: string;
                 app: string;
@@ -492,7 +555,18 @@ export declare class BrowserSetupClient {
             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;
+        } & {
+            analysis_id?: string | undefined;
+            analysis_started_at?: string | undefined;
+            analysis_completed_at?: string | undefined;
+            deadline_at?: string | undefined;
+            timings?: ({} & {
+                extraction_ms?: number | undefined;
+                consolidation_ms?: number | undefined;
+                authoring_ms?: number | undefined;
+                total_ms?: number | undefined;
+            }) | undefined;
+        }) | null | undefined;
         recommendation_digest?: string | null | undefined;
         selected_candidates?: string[] | undefined;
     }>;
@@ -517,7 +591,14 @@ export declare class BrowserSetupClient {
             source_review: boolean;
             sample_read: boolean;
         } & {
+            onboarding_v2?: boolean | undefined;
             project_name?: string | undefined;
+            launcher?: ({
+                wizard_version: string;
+                api_origin: string;
+            } & {
+                registry?: string | undefined;
+            }) | undefined;
             terminal?: ({
                 platform: string;
                 app: string;
@@ -590,7 +671,18 @@ export declare class BrowserSetupClient {
             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;
+        } & {
+            analysis_id?: string | undefined;
+            analysis_started_at?: string | undefined;
+            analysis_completed_at?: string | undefined;
+            deadline_at?: string | undefined;
+            timings?: ({} & {
+                extraction_ms?: number | undefined;
+                consolidation_ms?: number | undefined;
+                authoring_ms?: number | undefined;
+                total_ms?: number | undefined;
+            }) | undefined;
+        }) | null | undefined;
         recommendation_digest?: string | null | undefined;
         selected_candidates?: string[] | undefined;
     }>;
@@ -615,7 +707,14 @@ export declare class BrowserSetupClient {
             source_review: boolean;
             sample_read: boolean;
         } & {
+            onboarding_v2?: boolean | undefined;
             project_name?: string | undefined;
+            launcher?: ({
+                wizard_version: string;
+                api_origin: string;
+            } & {
+                registry?: string | undefined;
+            }) | undefined;
             terminal?: ({
                 platform: string;
                 app: string;
@@ -688,7 +787,18 @@ export declare class BrowserSetupClient {
             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;
+        } & {
+            analysis_id?: string | undefined;
+            analysis_started_at?: string | undefined;
+            analysis_completed_at?: string | undefined;
+            deadline_at?: string | undefined;
+            timings?: ({} & {
+                extraction_ms?: number | undefined;
+                consolidation_ms?: number | undefined;
+                authoring_ms?: number | undefined;
+                total_ms?: number | undefined;
+            }) | undefined;
+        }) | null | undefined;
         recommendation_digest?: string | null | undefined;
         selected_candidates?: string[] | undefined;
     }>;
@@ -738,7 +848,14 @@ export declare class BrowserSetupClient {
                 source_review: boolean;
                 sample_read: boolean;
             } & {
+                onboarding_v2?: boolean | undefined;
                 project_name?: string | undefined;
+                launcher?: ({
+                    wizard_version: string;
+                    api_origin: string;
+                } & {
+                    registry?: string | undefined;
+                }) | undefined;
                 terminal?: ({
                     platform: string;
                     app: string;
@@ -811,7 +928,18 @@ export declare class BrowserSetupClient {
                 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;
+            } & {
+                analysis_id?: string | undefined;
+                analysis_started_at?: string | undefined;
+                analysis_completed_at?: string | undefined;
+                deadline_at?: string | undefined;
+                timings?: ({} & {
+                    extraction_ms?: number | undefined;
+                    consolidation_ms?: number | undefined;
+                    authoring_ms?: number | undefined;
+                    total_ms?: number | undefined;
+                }) | undefined;
+            }) | null | undefined;
             recommendation_digest?: string | null | undefined;
             selected_candidates?: string[] | undefined;
         };
@@ -837,7 +965,14 @@ export declare class BrowserSetupClient {
             source_review: boolean;
             sample_read: boolean;
         } & {
+            onboarding_v2?: boolean | undefined;
             project_name?: string | undefined;
+            launcher?: ({
+                wizard_version: string;
+                api_origin: string;
+            } & {
+                registry?: string | undefined;
+            }) | undefined;
             terminal?: ({
                 platform: string;
                 app: string;
@@ -910,7 +1045,18 @@ export declare class BrowserSetupClient {
             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;
+        } & {
+            analysis_id?: string | undefined;
+            analysis_started_at?: string | undefined;
+            analysis_completed_at?: string | undefined;
+            deadline_at?: string | undefined;
+            timings?: ({} & {
+                extraction_ms?: number | undefined;
+                consolidation_ms?: number | undefined;
+                authoring_ms?: number | undefined;
+                total_ms?: number | undefined;
+            }) | undefined;
+        }) | null | undefined;
         recommendation_digest?: string | null | undefined;
         selected_candidates?: string[] | undefined;
     }>;
@@ -935,7 +1081,14 @@ export declare class BrowserSetupClient {
             source_review: boolean;
             sample_read: boolean;
         } & {
+            onboarding_v2?: boolean | undefined;
             project_name?: string | undefined;
+            launcher?: ({
+                wizard_version: string;
+                api_origin: string;
+            } & {
+                registry?: string | undefined;
+            }) | undefined;
             terminal?: ({
                 platform: string;
                 app: string;
@@ -1008,7 +1161,18 @@ export declare class BrowserSetupClient {
             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;
+        } & {
+            analysis_id?: string | undefined;
+            analysis_started_at?: string | undefined;
+            analysis_completed_at?: string | undefined;
+            deadline_at?: string | undefined;
+            timings?: ({} & {
+                extraction_ms?: number | undefined;
+                consolidation_ms?: number | undefined;
+                authoring_ms?: number | undefined;
+                total_ms?: number | undefined;
+            }) | undefined;
+        }) | null | undefined;
         recommendation_digest?: string | null | undefined;
         selected_candidates?: string[] | undefined;
     }>;
@@ -1033,7 +1197,14 @@ export declare class BrowserSetupClient {
             source_review: boolean;
             sample_read: boolean;
         } & {
+            onboarding_v2?: boolean | undefined;
             project_name?: string | undefined;
+            launcher?: ({
+                wizard_version: string;
+                api_origin: string;
+            } & {
+                registry?: string | undefined;
+            }) | undefined;
             terminal?: ({
                 platform: string;
                 app: string;
@@ -1106,7 +1277,18 @@ export declare class BrowserSetupClient {
             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;
+        } & {
+            analysis_id?: string | undefined;
+            analysis_started_at?: string | undefined;
+            analysis_completed_at?: string | undefined;
+            deadline_at?: string | undefined;
+            timings?: ({} & {
+                extraction_ms?: number | undefined;
+                consolidation_ms?: number | undefined;
+                authoring_ms?: number | undefined;
+                total_ms?: number | undefined;
+            }) | undefined;
+        }) | null | undefined;
         recommendation_digest?: string | null | undefined;
         selected_candidates?: string[] | undefined;
     }>;
@@ -1131,7 +1313,14 @@ export declare class BrowserSetupClient {
             source_review: boolean;
             sample_read: boolean;
         } & {
+            onboarding_v2?: boolean | undefined;
             project_name?: string | undefined;
+            launcher?: ({
+                wizard_version: string;
+                api_origin: string;
+            } & {
+                registry?: string | undefined;
+            }) | undefined;
             terminal?: ({
                 platform: string;
                 app: string;
@@ -1204,7 +1393,18 @@ export declare class BrowserSetupClient {
             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;
+        } & {
+            analysis_id?: string | undefined;
+            analysis_started_at?: string | undefined;
+            analysis_completed_at?: string | undefined;
+            deadline_at?: string | undefined;
+            timings?: ({} & {
+                extraction_ms?: number | undefined;
+                consolidation_ms?: number | undefined;
+                authoring_ms?: number | undefined;
+                total_ms?: number | undefined;
+            }) | undefined;
+        }) | null | undefined;
         recommendation_digest?: string | null | undefined;
         selected_candidates?: string[] | undefined;
     }>;

package/dist/setup.js

@@ -67,7 +67,7 @@ async function request(origin, operation, body, token, options, retries = 0) {
     if (!['discovery', 'start', 'exchange', 'poll', 'plan', 'claim', 'start-command', 'report', 'heartbeat', 'reconcile', 'sample-read', 'source-info', 'source-plan', 'source-upload'].includes(operation))
         throw new SetupError('invalid_setup_operation', 'Unsupported setup operation.');
     const encoded = body === undefined ? undefined : JSON.stringify(body);
-    if (encoded && Buffer.byteLength(encoded) > 65_536)
+    if (encoded && Buffer.byteLength(encoded) > (operation === 'source-upload' ? 300000 : 65_536))
         throw new SetupError('setup_request_too_large', 'Setup request exceeds 64 KiB.');
     const url = `${apiUrl(origin)}${operation === 'discovery' ? '/onboarding/v1/auth-config?setup=1' : `/onboarding/v1/setup/${operation}`}`;
     // Preference reads are optional and bounded. Any read failure suppresses
@@ -81,7 +81,7 @@ async function request(origin, operation, body, token, options, retries = 0) {
                 method: encoded === undefined ? 'GET' : 'POST', redirect: 'error',
                 headers: { Accept: 'application/json', ...(encoded === undefined ? {} : { 'Content-Type': 'application/json' }), ...(token ? { Authorization: `Bearer ${token}` } : {}), ...(measurementDisabled ? { 'x-ur-measurement-disabled': '1' } : {}) },
                 ...(encoded === undefined ? {} : { body: encoded }),
-                signal: AbortSignal.any([AbortSignal.timeout(operation === 'source-upload' ? 50_000 : 10_000), ...(options.signal ? [options.signal] : [])]),
+                signal: AbortSignal.any([AbortSignal.timeout(operation === 'source-upload' ? 250_000 : 10_000), ...(options.signal ? [options.signal] : [])]),
             });
         }
         catch (error) {
@@ -181,7 +181,9 @@ async function finishBrowserSetup(pending, options) {
                 throw new SetupError('invalid_setup_response', 'The approved setup response does not match this project or active session.');
             const connected = { schema_version: 1, state: 'connected', setup_id: pending.setup_id, api_url: pending.api_url, project_fingerprint: pending.project_fingerprint, created_at: new Date(now()).toISOString(), expires_at: result.expires_at, access_token: result.access_token };
             await saveSetupSession(connected);
-            return { client: new BrowserSetupClient(connected, options), session: result.session };
+            const client = new BrowserSetupClient(connected, options);
+            const session = await client.heartbeat({ schema_version: 1, setup_id: connected.setup_id, executor_generation: result.session.executor_generation, operation_id: null, lease_generation: null });
+            return { client, session };
         }
         options.onProgress?.('waiting');
         await delay(Math.max(0, Math.min(2_000, deadline - now())), options);
@@ -193,7 +195,9 @@ export async function resumeBrowserSetup(origin, setupId, directory, options = {
     if (saved.state === 'pending')
         return finishBrowserSetup(saved, options);
     const client = new BrowserSetupClient(saved, options);
-    return { client, session: await client.poll() };
+    const current = await client.poll();
+    const session = terminal.has(current.phase) ? current : await client.heartbeat({ schema_version: 1, setup_id: saved.setup_id, executor_generation: current.executor_generation, operation_id: null, lease_generation: null });
+    return { client, session };
 }
 export class BrowserSetupClient {
     #stored;
@@ -207,6 +211,8 @@ export class BrowserSetupClient {
     }
     /** Nonsecret identity for the local executor journal; never exposes the bearer. */
     get identity() { const { setup_id, api_url, project_fingerprint, expires_at } = this.#stored; return { setup_id, api_url, project_fingerprint, expires_at }; }
+    /** Share the same saved capability while binding requests to one run's lifetime. */
+    withSignal(signal) { return new BrowserSetupClient(this.#stored, { ...this.#options, signal: AbortSignal.any([signal, ...(this.#options.signal ? [this.#options.signal] : [])]) }); }
     async call(operation, body, retries = 0) {
         if (Date.parse(this.#stored.expires_at) <= (this.#options.now ?? Date.now)())
             throw new SetupError('setup_expired', 'Setup access expired. Start a new setup; it cannot be refreshed into ordinary CLI access.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@userreason/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Authenticated UserReason onboarding and management CLI",
   "type": "module",
   "license": "UNLICENSED",