@volter/supercode-frontend-vscode 0.1.17 → 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/README.md

@@ -102,11 +102,25 @@ and returns its new scoped connection. The host owns validation, process lifetim
 persistence, and failure handling. Prompts and approvals still use the generated frontend client.
 The contract is in `src/host-controls.ts`.
 
-With that host, **Chat: New Chat: Choose Harness, Model and Reasoning** chooses
-configuration before opening a separate conversation. A conversation's harness, model and
-reasoning settings remain fixed: this integration does not advertise hot swapping. Native
-Chat displays its selected model and provider icon inside the composer and its supported
-approval policy below it. The response author identifies the harness.
+With that host, **New Session** / **Chat: New Chat: Choose Agent** asks only
+which startable agent to use. It refreshes the host's available choices first;
+with one agent it opens immediately, and with none it returns to setup. Model
+and reasoning are sent as empty values, leaving both at the harness's own defaults,
+even if the previous conversation used explicit settings. Cancelling the agent
+picker creates nothing.
+
+The composer's native **Model settings** control offers **Choose model and reasoning
+for a new chat…** for Claude Code and Codex. This optional path retains the model
+list, exact model ID entry and reasoning choices. Only completing the choices
+starts a separate conversation; cancelling either leaves the current one intact.
+A conversation's harness, model and reasoning remain fixed: this integration does
+not advertise hot swapping. The built-in model picker still displays the selected
+model and provider icon; nondelegating session providers cannot add its Manage
+Models action, so configuration uses the native session-options command door.
+The response author identifies the harness. Other harnesses keep their own defaults.
+
+This simplified creation flow is source-only pending frontend compilation and a
+live check of zero/one picker, cancellation, defaults and explicit configuration.
 
 The host publishes durable conversation IDs and their exact harness history identities.
 `POST /open` resumes only the requested saved conversation; `POST /remember` binds its

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';
@@ -451,7 +452,7 @@ export async function activate(context) {
                         statusIcon: new vscode.ThemeIcon(provider === 'anthropic' ? 'claude' : provider === 'openai' ? 'openai' : provider === 'google' ? 'google-gemini' : 'sparkle'),
                         maxInputTokens: 0, maxOutputTokens: 0, capabilities: {},
                         targetChatSessionType: SESSION_SCHEME, isUserSelectable: true, isDefault: model.id === selection.model,
-                        tooltip: `${model.name} via ${harnessDisplayName(selection.harness)}${selection.effort ? ` · ${selection.effort} reasoning` : ''}. Model is fixed for this conversation. Use New Chat to choose another model.`,
+                        tooltip: `${model.name} via ${harnessDisplayName(selection.harness)}${selection.effort ? ` · ${selection.effort} reasoning` : ''}. Model is fixed for this conversation. Use Model settings to choose model and reasoning for a new conversation.`,
                     };
                 });
             },
@@ -671,6 +672,16 @@ export async function activate(context) {
             const permissionItems = [{ id: 'ask', name: canApprove ? 'Ask for approval' : 'Harness permissions', description: canApprove ? 'Show each approval requested by the harness.' : 'Approval controls are unavailable for this harness.' },
                 ...((canApprove || (!active && resource && currentOptions(resource).permissions === 'autoApprove')) ? [{ id: 'autoApprove', name: 'Auto approve', description: 'Allow tool approval requests for this chat. Harness sandbox rules still apply.' }] : [])];
             const groups = [{ id: 'permissions', name: 'Permissions', kind: 'permissions', items: permissionItems, selected: permissionItems.find(i => i.id === (resource ? currentOptions(resource).permissions : 'ask')) }];
+            const selected = controls?.state.sessions.find(session => session.id === id);
+            if (selected && ['claude-code', 'codex'].includes(selected.selection.harness)) {
+                // Native session-option commands remain reachable for nondelegating providers,
+                // whose built-in model picker deliberately omits Manage Models. Do not advertise
+                // hot swapping: the command opens a separate conversation after both choices.
+                // A locked selected item hides the entire native dropdown, including commands.
+                const item = { id: 'settings', name: 'Model settings' };
+                groups.push({ id: 'modelSettings', name: 'Model', items: [item], selected: item,
+                    commands: [{ command: 'supercode.frontend.configureModel', title: 'Choose model and reasoning for a new chat…', arguments: [selected.id] }] });
+            }
             return groups;
         },
         setPermission: (resource, value) => {
@@ -685,7 +696,7 @@ export async function activate(context) {
         create: async (inputState) => {
             if (!controls)
                 throw new Error('The host does not expose conversation creation.');
-            await enqueueSelection({ ...controls.state.selection }, false);
+            await enqueueSelection({ harness: controls.state.selection.harness, model: '', effort: '' }, false);
             const connection = frontends.get(controls.state.activeSession);
             savePermission(connection.id, turnPermission(inputState.groups.find(group => group.id === 'permissions')?.selected?.id));
             return connection;
@@ -737,15 +748,43 @@ export async function activate(context) {
             void vscode.window.showInformationMessage('This host does not expose chat configuration.');
             return;
         }
-        const selection = { ...controls.state.selection };
-        const harness = await vscode.window.showQuickPick(controls.state.harnesses.map(h => ({ label: h.name, id: h.id })), { title: 'New chat · Harness', placeHolder: 'Choose the harness for a new conversation. Existing chats keep their harness and history.' });
+        await controls.refresh();
+        // 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;
+        }
+        // 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.id !== selection.harness) {
-            selection.harness = harness.id;
-            selection.model = '';
-            selection.effort = '';
+        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) => {
+        if (!controls || focusedAttached)
+            throw new Error('Model settings require a host-managed conversation.');
+        await controls.refresh();
+        // The native session-options picker prepends its exact resource to command arguments.
+        const bound = resource ? boundId(resource) : undefined;
+        if (resource && (!bound || (sessionId && bound !== sessionId)))
+            throw new Error('Model settings have no matching conversation binding.');
+        const id = bound ?? controls.state.activeSession;
+        const selected = controls.state.sessions.find(session => session.id === id);
+        if (!selected || selected.id !== controls.state.activeSession)
+            throw new Error('Open this conversation before choosing model settings.');
+        const selection = { ...selected.selection };
+        if (!['claude-code', 'codex'].includes(selection.harness))
+            throw new Error('This harness uses its own model defaults; configuration is not advertised.');
         if (['claude-code', 'codex'].includes(selection.harness)) {
             const choices = controls.state.modelsByHarness?.[selection.harness] ?? [{ id: '', name: 'Harness default' }];
             const picked = await vscode.window.showQuickPick([...choices.map(model => ({ label: model.name, id: model.id })), { label: 'Enter an exact model ID…', id: '__custom__' }], { title: 'New chat · Model', placeHolder: 'Model availability depends on your harness account.' });
@@ -845,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) {
@@ -942,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);
         }
@@ -1466,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;
@@ -46,6 +47,7 @@ export interface HostState {
     sessions: ManagedChatSession[];
     selection: ChatSelection;
     connection?: Record<string, string>;
+    /** Agents the host can start now (installation, authentication and capability checked). */
     harnesses: ChatChoice[];
     models: ChatChoice[];
     modelsByHarness?: Record<string, ChatChoice[]>;

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;