@volter/supercode-frontend-vscode 0.1.18 → 0.1.20

package/NOTICE.md

@@ -1,6 +1,10 @@
 # Third-party notice
 
-This optional frontend has **no runtime npm dependency**. It builds against `@types/vscode`
+This optional frontend needs **no runtime npm installation**. Its form-schema validator
+bundles Ajv 8.17.1, ajv-formats 3.0.1 and their dependencies; their license texts ship in
+`dist/request-schema.LICENSE.txt`. esbuild bundles that one module during the build.
+The validator does not fetch external schema references or change answer values.
+It builds against `@types/vscode`
 (Copyright (c) Microsoft Corporation, MIT) as an exact devDependency for types only; `vscode` itself
 is supplied by the editor at runtime and is never bundled or redistributed here.
 

package/dist/extension.js

@@ -1,3 +1,4 @@
+import { adaptRequestSchema, fieldControl, objectValue, requestValidator } from './request-schema.js';
 import { resolveSessionBinding } from './bindings.js';
 import { withTextContext } from './context.js';
 import { randomUUID } from 'node:crypto';
@@ -748,16 +749,25 @@ export async function activate(context) {
             return;
         }
         await controls.refresh();
-        // The host supplies startable agents, including installation/authentication checks.
-        // An absent choice is not permission to guess a harness or start another runtime.
-        const choices = controls.state.harnesses;
+        // Sign-in choices stay visible alongside agents that can be explicitly started.
+        const login = controls.state.setup?.actions.filter(action => action.kind === 'login') ?? [];
+        const choices = [
+            ...login.map(action => ({ label: action.name, id: action.harness, description: 'Sign in…', login: true, autoStart: false })),
+            ...controls.state.harnesses.filter(h => !login.some(action => action.harness === h.id))
+                .map(h => ({ label: h.name, id: h.id, description: h.description, login: false, autoStart: h.autoStart === true })),
+        ];
         if (!choices.length) {
             await revealSetup();
             return;
         }
-        const harness = choices.length === 1 ? choices[0] : await vscode.window.showQuickPick(choices.map(h => ({ label: h.name, id: h.id })), { title: 'New chat · Agent', placeHolder: 'Choose your coding agent. Model and reasoning use its defaults.' });
+        // A sole sign-in option still requires a deliberate click before opening its terminal.
+        const harness = choices.length === 1 && choices[0].autoStart ? choices[0] : await vscode.window.showQuickPick(choices, { title: 'New chat · Agent', placeHolder: 'Choose your coding agent. Model and reasoning use its defaults.' });
         if (!harness)
             return;
+        if (harness.login) {
+            await vscode.commands.executeCommand('supercode.frontend.setup', 'login', harness.id);
+            return;
+        }
         await enqueueSelection({ harness: harness.id, model: '', effort: '' });
     }));
     context.subscriptions.push(vscode.commands.registerCommand('supercode.frontend.configureModel', async (resource, sessionId) => {
@@ -874,9 +884,14 @@ export async function activate(context) {
         // and an elicitation's free-text content).
         const pending = pendingRequestOf(connection);
         if (pending) {
-            const answer = typedAnswer(pending, request.prompt);
-            await connection.session.respond(answer);
-            stream.markdown(`_answered request #${pending.id}: ${opaqueText(answer, 256)}_`);
+            try {
+                const answer = typedAnswer(pending, request.prompt);
+                await connection.session.respond(answer);
+                stream.markdown(`_answered request #${pending.id}: ${opaqueText(answer, 256)}_`);
+            }
+            catch (error) {
+                stream.markdown(`Could not answer request #${pending.id}: ${opaqueText(String(error.message), 512)}`);
+            }
             return {};
         }
         if (request.prompt.trim().length === 0) {
@@ -971,17 +986,13 @@ export async function activate(context) {
             return;
         }
         let response = answer.response;
-        if (answer.promptForContent) {
-            const content = await vscode.window.showInputBox({
-                title: 'Volter Harness runtime request',
-                prompt: 'The runtime asked for a value; a button cannot carry one.',
-                ignoreFocusOut: true,
-            });
-            if (content === undefined)
-                return;
-            response = { ...response, content };
-        }
         try {
+            if (answer.promptForContent) {
+                const content = await requestContent(request);
+                if (content === undefined)
+                    return;
+                response = { ...response, content };
+            }
             await connection.session.respond(response);
             void vscode.window.setStatusBarMessage(`Volter Harness: ${resolutionSentence(response, request, answer.requestId)}`, 4000);
         }
@@ -1495,3 +1506,155 @@ function registerSessions(context, frontends, participant, granted, handler, con
         },
     }, participant, { supportsInterruptions: true }));
 }
+/** Collect each question through the existing Chat answer button, preserving ids and secrets. */
+async function requestContent(request) {
+    const payload = request.payload;
+    if (Array.isArray(payload?.questions)) {
+        const answers = Object.create(null);
+        for (const value of payload.questions) {
+            if (!value || typeof value !== 'object' || Array.isArray(value) || typeof value.id !== 'string')
+                continue;
+            const question = value;
+            const options = Array.isArray(question.options) ? question.options.flatMap(option => {
+                if (!option || typeof option !== 'object' || Array.isArray(option) || typeof option.label !== 'string')
+                    return [];
+                return [{ label: option.label, description: typeof option.description === 'string' ? option.description : undefined, custom: false }];
+            }) : [];
+            let answer;
+            if (options.length) {
+                if (question.isOther === true)
+                    options.push({ label: 'Write an answer…', description: undefined, custom: true });
+                const chosen = await vscode.window.showQuickPick(options, { title: String(question.header ?? 'Codex question'), placeHolder: String(question.question ?? ''), ignoreFocusOut: true });
+                if (!chosen)
+                    return undefined;
+                if (!chosen.custom)
+                    answer = chosen.label;
+            }
+            if (answer === undefined) {
+                answer = await vscode.window.showInputBox({ title: String(question.header ?? 'Codex question'), prompt: String(question.question ?? ''), password: question.isSecret === true, ignoreFocusOut: true });
+            }
+            if (answer === undefined)
+                return undefined;
+            answers[value.id] = answer;
+        }
+        return answers;
+    }
+    const schema = payload?.requested_schema;
+    if (schema === undefined || schema === null) {
+        return vscode.window.showInputBox({ title: 'Runtime request', prompt: 'Enter your answer.', ignoreFocusOut: true });
+    }
+    const showSchema = async () => {
+        const document = await vscode.workspace.openTextDocument({ language: 'json', content: JSON.stringify(schema, null, 2) });
+        await vscode.window.showTextDocument(document, { preview: true, preserveFocus: true });
+    };
+    const adaptedSchema = adaptRequestSchema(schema, payload?.mode);
+    let validate;
+    const structuredFallback = async (initial) => {
+        await showSchema();
+        const typed = await vscode.window.showInputBox({ title: 'Runtime request', prompt: 'Enter an answer matching the displayed JSON schema.', value: initial === undefined ? undefined : JSON.stringify(initial), ignoreFocusOut: true, validateInput: value => {
+                try {
+                    const parsed = JSON.parse(value);
+                    return objectValue(parsed) ? validate(parsed) : 'Enter a JSON object';
+                }
+                catch {
+                    return 'Enter valid JSON';
+                }
+            } });
+        return typed === undefined ? undefined : JSON.parse(typed);
+    };
+    try {
+        validate = requestValidator(adaptedSchema);
+    }
+    catch (error) {
+        // Keep the structured-input path available with the original schema in
+        // view. Never accept an answer whose constraints cannot be validated.
+        const message = `Cannot validate this request schema: ${String(error.message)}`;
+        validate = () => message;
+        return structuredFallback();
+    }
+    const form = objectValue(adaptedSchema);
+    const properties = objectValue(form?.properties);
+    // Cross-field conditions, refs and nested schemas use the complete validated
+    // JSON fallback rather than controls that would erase their semantics.
+    const simpleForm = form?.type === 'object' && properties && Object.keys(form).every(key => ['$schema', 'type', 'title', 'description', 'properties', 'required', 'additionalProperties'].includes(key));
+    if (!simpleForm || !properties)
+        return structuredFallback();
+    const fields = Object.entries(properties).map(([name, spec]) => ({ name, spec: objectValue(spec), control: objectValue(spec) ? fieldControl(objectValue(spec)) : undefined }));
+    if (fields.some(field => !field.spec || !field.control))
+        return structuredFallback();
+    const content = Object.create(null);
+    const required = Array.isArray(form.required) ? form.required : [];
+    for (const { name, spec, control } of fields) {
+        const field = spec;
+        const title = typeof field.title === 'string' ? field.title : name;
+        if (!required.includes(name)) {
+            const choice = await vscode.window.showQuickPick(['Provide a value', 'Omit this field'], { title: `${title} (optional)`, ignoreFocusOut: true });
+            if (!choice)
+                return undefined;
+            if (choice === 'Omit this field')
+                continue;
+        }
+        let validateField;
+        try {
+            validateField = requestValidator(field);
+        }
+        catch {
+            // A field can require the root's dialect or references. The full-form
+            // validator already compiled, so the JSON fallback retains them.
+            return structuredFallback(content);
+        }
+        if (control.kind === 'select') {
+            const select = control;
+            while (true) {
+                const options = select.choices.map(choice => ({ ...choice }));
+                let answer;
+                if (select.multiple) {
+                    const selected = await vscode.window.showQuickPick(options, { title, placeHolder: typeof field.description === 'string' ? field.description : undefined, canPickMany: true, ignoreFocusOut: true });
+                    if (!selected)
+                        return undefined;
+                    answer = selected.map(choice => choice.value);
+                }
+                else {
+                    const selected = await vscode.window.showQuickPick(options, { title, placeHolder: typeof field.description === 'string' ? field.description : undefined, ignoreFocusOut: true });
+                    if (!selected)
+                        return undefined;
+                    answer = selected.value;
+                }
+                const error = validateField(answer);
+                if (error) {
+                    await vscode.window.showWarningMessage(error);
+                    continue;
+                }
+                content[name] = answer;
+                break;
+            }
+        }
+        else {
+            const text = control;
+            const parse = (value) => {
+                if (text.type === 'string')
+                    return value;
+                if (!value.trim() || !Number.isFinite(Number(value)))
+                    throw new Error('Enter a valid number');
+                return Number(value);
+            };
+            const typed = await vscode.window.showInputBox({ title, prompt: typeof field.description === 'string' ? field.description : undefined, ignoreFocusOut: true, validateInput: value => {
+                    try {
+                        return validateField(parse(value));
+                    }
+                    catch (error) {
+                        return error.message;
+                    }
+                } });
+            if (typed === undefined)
+                return undefined;
+            content[name] = parse(typed);
+        }
+    }
+    const error = validate(content);
+    if (error) {
+        await vscode.window.showWarningMessage(error);
+        return structuredFallback(content);
+    }
+    return content;
+}

package/dist/host-controls.d.ts

@@ -9,6 +9,7 @@ export interface ChatChoice {
     id: string;
     name: string;
     description?: string;
+    autoStart?: boolean;
 }
 export interface ChatStarterPrompt {
     label: string;

package/dist/request-schema.LICENSE.txt

@@ -0,0 +1,157 @@
+ajv
+
+The MIT License (MIT)
+
+Copyright (c) 2015-2021 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+
+ajv-formats
+
+MIT License
+
+Copyright (c) 2020 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+fast-deep-equal
+
+MIT License
+
+Copyright (c) 2017 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+fast-uri
+
+Copyright (c) 2011-2021, Gary Court until https://github.com/garycourt/uri-js/commit/a1acf730b4bba3f1097c9f52e7d9d3aba8cdcaae
+Copyright (c) 2021-present The Fastify team <https://github.com/fastify/fastify#team>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * The names of any contributors may not be used to endorse or promote
+      products derived from this software without specific prior written
+      permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+                                  *   *   *
+
+The complete list of contributors can be found at:
+- https://github.com/garycourt/uri-js/graphs/contributors
+
+json-schema-traverse
+
+MIT License
+
+Copyright (c) 2017 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+require-from-string
+
+The MIT License (MIT)
+
+Copyright (c) Vsevolod Strukchinsky <floatdrop@gmail.com> (github.com/floatdrop)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/request-schema.d.ts

@@ -0,0 +1,22 @@
+import type { FrontendRequest, JsonValue } from '../vendor/supercode-frontend/generated.mjs';
+export declare function objectValue(value: JsonValue | undefined): Record<string, JsonValue> | undefined;
+/** Adapt only Codex's typed MCP form schema. Other modes carry arbitrary JSON Schema. */
+export declare function adaptRequestSchema(schema: JsonValue, mode: JsonValue | undefined): JsonValue;
+/** Validate without changing answers, filling defaults, or fetching external refs. */
+export declare function requestValidator(schema: JsonValue): (value: JsonValue) => string | undefined;
+/** Plain-text and single-question responses retain their exact text. */
+export declare function typedRequestContent(request: FrontendRequest, reply: string): JsonValue;
+export interface FieldChoice {
+    label: string;
+    value: JsonValue;
+}
+export type FieldControl = {
+    kind: 'select';
+    choices: FieldChoice[];
+    multiple: boolean;
+} | {
+    kind: 'text';
+    type: 'string' | 'number' | 'integer';
+};
+/** Only known shapes get native controls; everything else keeps its full schema. */
+export declare function fieldControl(field: Record<string, JsonValue>): FieldControl | undefined;