@volter/supercode-frontend-vscode 0.1.34 → 0.1.35

package/README.md

@@ -24,6 +24,25 @@ Gallery detection reads the host's `product.json` through `vscode.workspace.fs`
 at `vscode.env.appRoot`; hosts without an inspectable gallery configuration hide
 the choice. Neither the extension nor its credentials are bundled or copied.
 
+The welcome's primary action uses `supercode.frontend.beginChatGPTSignIn`:
+it starts one retained install/sidebar operation and returns a copied receipt
+with its id, timestamps and current phase. This is a launch receipt, not proof
+that installation, sidebar presentation or authentication succeeded. A second
+begin while that operation is running returns the same id and starts no extra
+installation. `supercode.frontend.chatGPTSignInStatus` reads its current phase
+locally without waiting for host readiness or installation; pass the operation
+id to receive only that operation (a mismatched id returns null).
+Phases name the selected work before its awaited command: `checking-gallery`,
+`installing-extension`, `opening-sidebar`, then `completed` or `failed`.
+Completed means the official command sequence fulfilled, not signed in. Failures
+remain in operation status and the existing native error notification/output.
+Only the current or most recent operation is retained, for this extension-window
+lifetime; reload does not restore or automatically retry it. Runtime status
+inspection also includes this snapshot as `chatGPTSignIn`.
+The existing `supercode.frontend.signInWithChatGPT` still awaits the same work
+with its existing error-notification/fulfillment behavior, and the agent picker
+continues to use it. Ordinary relay budgets and draft guards are unchanged.
+
 The optional host-controls state can include `setup: { ready, actions, reason,
 cwd }`. Each action supplies `kind` (`login` or `install`), `harness`, `name` and
 the exact `command` revalidated before execution. On a signed-out first open,

package/dist/chat-setup.d.ts

@@ -2,12 +2,22 @@
 import * as vscode from 'vscode';
 import type { ChatSetupState } from './host-controls.js';
 export declare const CHATGPT_SIGN_IN = "supercode.frontend.signInWithChatGPT";
+export declare const CHATGPT_SIGN_IN_BEGIN = "supercode.frontend.beginChatGPTSignIn";
+export declare const CHATGPT_SIGN_IN_STATUS = "supercode.frontend.chatGPTSignInStatus";
+export type ChatGPTSignInWorkPhase = 'checking-gallery' | 'installing-extension' | 'opening-sidebar';
+export interface ChatGPTSignInOperation {
+    readonly id: string;
+    readonly phase: ChatGPTSignInWorkPhase | 'completed' | 'failed';
+    readonly startedAt: number;
+    readonly updatedAt: number;
+    readonly finishedAt?: number;
+}
 /** The install command also exists in gallery-less Code-OSS. Fail closed when
  * the host's product configuration cannot be inspected through the VS Code API. */
 export declare function chatGPTAvailable(): Promise<boolean>;
 /** Only called by an explicit click. The gallery and extension own installation
  * and authentication; there is no terminal or provider credential handling here. */
-export declare function signInWithChatGPT(): Promise<void>;
+export declare function signInWithChatGPT(report?: (phase: ChatGPTSignInWorkPhase) => void): Promise<void>;
 /** Empty-chat welcome content, rendered by Code-OSS's ChatViewWelcomePart.
  * Only the official extension gets the primary button; native local sign-in
  * actions remain ordinary links. Commands and host diagnostic paths stay out

package/dist/chat-setup.js

@@ -1,6 +1,8 @@
 /** Native Chat presentation; the host supplies inventory and terminal actions. */
 import * as vscode from 'vscode';
 export const CHATGPT_SIGN_IN = 'supercode.frontend.signInWithChatGPT';
+export const CHATGPT_SIGN_IN_BEGIN = 'supercode.frontend.beginChatGPTSignIn';
+export const CHATGPT_SIGN_IN_STATUS = 'supercode.frontend.chatGPTSignInStatus';
 const CODEX_EXTENSION = 'openai.chatgpt';
 const INSTALL_EXTENSION = 'workbench.extensions.installExtension';
 /** The install command also exists in gallery-less Code-OSS. Fail closed when
@@ -20,16 +22,19 @@ export async function chatGPTAvailable() {
 }
 /** Only called by an explicit click. The gallery and extension own installation
  * and authentication; there is no terminal or provider credential handling here. */
-export async function signInWithChatGPT() {
+export async function signInWithChatGPT(report) {
+    report?.('checking-gallery');
     if (!await chatGPTAvailable())
         throw new Error('This host does not provide an extension gallery.');
     if (!vscode.extensions.getExtension(CODEX_EXTENSION)) {
         // enable makes the workbench await the running extension registry, not
         // just the installed inventory, before we dispatch the contributed command.
+        report?.('installing-extension');
         await vscode.commands.executeCommand(INSTALL_EXTENSION, CODEX_EXTENSION, { enable: true });
     }
     // openai.chatgpt contributes this command, not a public sign-in command.
     // Revealing its sidebar presents its own Sign in with ChatGPT when signed out.
+    report?.('opening-sidebar');
     await vscode.commands.executeCommand('chatgpt.openSidebar');
 }
 /** Empty-chat welcome content, rendered by Code-OSS's ChatViewWelcomePart.
@@ -38,9 +43,9 @@ export async function signInWithChatGPT() {
  * of the welcome, and the host still revalidates every action on click. */
 export function setupWelcome(setup, chatGPT = false) {
     const welcome = new vscode.MarkdownString();
-    welcome.isTrusted = { enabledCommands: [CHATGPT_SIGN_IN, 'supercode.frontend.setup', 'supercode.frontend.refreshSetup'] };
+    welcome.isTrusted = { enabledCommands: [CHATGPT_SIGN_IN_BEGIN, 'supercode.frontend.setup', 'supercode.frontend.refreshSetup'] };
     if (chatGPT) {
-        welcome.appendMarkdown(`[Sign in with ChatGPT](command:${CHATGPT_SIGN_IN})\n\n`);
+        welcome.appendMarkdown(`[Sign in with ChatGPT](command:${CHATGPT_SIGN_IN_BEGIN})\n\n`);
         welcome.appendMarkdown('Use the official Codex extension.');
         welcome.appendMarkdown('\n\n');
     }

package/dist/extension.js

@@ -2,7 +2,7 @@ import { resolveSessionBinding } from './bindings.js';
 import { withTextContext } from './context.js';
 import { randomUUID } from 'node:crypto';
 import { ChatHostControls, runtimeIdentity, harnessDisplayName, turnPermission } from './host-controls.js';
-import { CHATGPT_SIGN_IN, chatGPTAvailable, setupWelcome, signInWithChatGPT } from './chat-setup.js';
+import { CHATGPT_SIGN_IN, CHATGPT_SIGN_IN_BEGIN, CHATGPT_SIGN_IN_STATUS, chatGPTAvailable, setupWelcome, signInWithChatGPT } from './chat-setup.js';
 import * as vscode from 'vscode';
 import { createFrontendClient } from './client.js';
 import { readCredentialFile } from './credential.js';
@@ -324,13 +324,36 @@ export async function activate(context) {
     const controls = await ChatHostControls.fromEnvironment();
     const offerChatGPT = await chatGPTAvailable();
     let signingInWithChatGPT;
-    context.subscriptions.push(vscode.commands.registerCommand(CHATGPT_SIGN_IN, () => {
-        signingInWithChatGPT ??= signInWithChatGPT().catch(error => {
+    let chatGPTSignInOperation;
+    const signInSnapshot = () => chatGPTSignInOperation ? { ...chatGPTSignInOperation } : null;
+    const startChatGPTSignIn = () => {
+        if (signingInWithChatGPT)
+            return signingInWithChatGPT;
+        const startedAt = Date.now();
+        const operation = { id: randomUUID(), startedAt };
+        const update = (phase) => {
+            const updatedAt = Date.now();
+            chatGPTSignInOperation = { ...operation, phase, updatedAt,
+                ...(phase === 'completed' || phase === 'failed' ? { finishedAt: updatedAt } : {}) };
+        };
+        signingInWithChatGPT = signInWithChatGPT(phase => update(phase)).then(() => {
+            // Fulfilled install/sidebar commands do not establish authentication.
+            update('completed');
+        }).catch(error => {
+            update('failed');
             log.error(`Could not open ChatGPT sign-in: ${String(error)}`);
             void vscode.window.showErrorMessage(`Could not open ChatGPT sign-in: ${error instanceof Error ? error.message : String(error)}`);
         }).finally(() => { signingInWithChatGPT = undefined; });
         return signingInWithChatGPT;
-    }));
+    };
+    context.subscriptions.push(
+    // Preserve the completion-awaiting command used by the agent picker.
+    vscode.commands.registerCommand(CHATGPT_SIGN_IN, startChatGPTSignIn), 
+    // A click starts one retained task. Its receipt is not install/login success.
+    vscode.commands.registerCommand(CHATGPT_SIGN_IN_BEGIN, () => {
+        void startChatGPTSignIn();
+        return signInSnapshot();
+    }), vscode.commands.registerCommand(CHATGPT_SIGN_IN_STATUS, (operationId) => operationId === undefined || operationId === chatGPTSignInOperation?.id ? signInSnapshot() : null));
     const controlsChanged = new vscode.EventEmitter();
     context.subscriptions.push(controlsChanged);
     let permission = 'ask';
@@ -1160,6 +1183,7 @@ export async function activate(context) {
             await controls.refresh();
         if (inspect === true)
             return {
+                chatGPTSignIn: signInSnapshot(),
                 connections: frontends.all.map(c => ({ ...frontends.info(c), permissions: [...c.session.permissions],
                     pendingRequests: [...c.session.pendingRequests.values()] })),
                 selection: controls?.state.selection, activeSession: controls?.state.activeSession,

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { createFrontendClient, type FrontendPermission, type VscodeFrontendConnection } from './client.js';
 export { readCredentialFile } from './credential.js';
+export type { ChatGPTSignInWorkPhase, ChatGPTSignInOperation } from './chat-setup.js';
 export { grantedProposals, PROPOSAL_EFFECTS, REQUESTED_PROPOSALS, type ProposalName, } from './proposals.js';
 export { EventSequenceGapError, LEASE_ERROR_NAMES, RequestNotPendingError, TURN_TERMINAL_KINDS, VscodeFrontendSession, type VscodeFrontendActions, type VscodeRuntimeClient, } from './session.js';
 export { HISTORY_MARKER_PROMPT, VSCODE_CHAT_LIMITS, acceptedDecisions, diffPaths, fence, opaqueText, projectEvent, projectPendingRequests, projectHistory, projectReplayTurns, requestAnswers, requestNeedsTypedReply, requestSubject, requestSummary, resolutionSentence, resolveParts, toolSubject, typedAnswer, type ChatAnswer, type ChatPart, type ProjectedPart, type ProjectedTurn, type ProjectionContext, } from './view.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/supercode-frontend-vscode",
   "displayName": "Volter Harness",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "type": "module",
   "description": "VS Code chat-view frontend for an existing Volter Harness SDK runtime",
   "publisher": "volter-ai-dev",