@volter/supercode-frontend-vscode 0.1.11

package/media/anthropic.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-1 3.5 26 18" fill="#d97757"><path fill-rule="evenodd" d="M20.998 10.949H24v3.102h-3v3.028h-1.487V20H18v-2.921h-1.487V20H15v-2.921H9V20H7.488v-2.921H6V20H4.487v-2.921H3V14.05H0V10.95h3V5h17.998v5.949zM6 10.949h1.488V8.102H6v2.847zm10.51 0H18V8.102h-1.49v2.847z"/></svg>

package/media/google.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#8b8df8"><path fill-rule="evenodd" d="M12 24C12 17.373 6.627 12 0 12 6.627 12 12 6.627 12 0c0 6.627 5.373 12 12 12-6.627 0-12 5.373-12 12z"/></svg>

package/media/openai.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-1 -1 26 26" fill="#aaaaaa"><path fill-rule="evenodd" d="M8.086.457a6.105 6.105 0 013.046-.415c1.333.153 2.521.72 3.564 1.7a.117.117 0 00.107.029c1.408-.346 2.762-.224 4.061.366l.063.03.154.076c1.357.703 2.33 1.77 2.918 3.198.278.679.418 1.388.421 2.126a5.655 5.655 0 01-.18 1.631.167.167 0 00.04.155 5.982 5.982 0 011.578 2.891c.385 1.901-.01 3.615-1.183 5.14l-.182.22a6.063 6.063 0 01-2.934 1.851.162.162 0 00-.108.102c-.255.736-.511 1.364-.987 1.992-1.199 1.582-2.962 2.462-4.948 2.451-1.583-.008-2.986-.587-4.21-1.736a.145.145 0 00-.14-.032c-.518.167-1.04.191-1.604.185a5.924 5.924 0 01-2.595-.622 6.058 6.058 0 01-2.146-1.781c-.203-.269-.404-.522-.551-.821a7.74 7.74 0 01-.495-1.283 6.11 6.11 0 01-.017-3.064.166.166 0 00.008-.074.115.115 0 00-.037-.064 5.958 5.958 0 01-1.38-2.202 5.196 5.196 0 01-.333-1.589 6.915 6.915 0 01.188-2.132c.45-1.484 1.309-2.648 2.577-3.493.282-.188.55-.334.802-.438.286-.12.573-.22.861-.304a.129.129 0 00.087-.087A6.016 6.016 0 015.635 2.31C6.315 1.464 7.132.846 8.086.457zm-.804 7.85a.848.848 0 00-1.473.842l1.694 2.965-1.688 2.848a.849.849 0 001.46.864l1.94-3.272a.849.849 0 00.007-.854l-1.94-3.393zm5.446 6.24a.849.849 0 000 1.695h4.848a.849.849 0 000-1.696h-4.848z"/></svg>

package/package.json

@@ -0,0 +1,200 @@
+{
+  "name": "@volter/supercode-frontend-vscode",
+  "displayName": "Volter Harness",
+  "version": "0.1.11",
+  "type": "module",
+  "description": "VS Code chat-view frontend for an existing Volter Harness SDK runtime",
+  "publisher": "volter-ai-dev",
+  "icon": "media/icon.png",
+  "main": "./dist/extension.js",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.js"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "vendor/supercode-frontend",
+    "scripts/pack-extension.mjs",
+    "README.md",
+    "NOTICE.md",
+    "media"
+  ],
+  "scripts": {
+    "build": "node scripts/sync-sdk.mjs && node scripts/fetch-icon.mjs && tsc -p tsconfig.build.json",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "typecheck": "tsc -p test/tsconfig.json --noEmit",
+    "extension": "npm run build && node scripts/pack-extension.mjs",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=20",
+    "vscode": "^1.138.0"
+  },
+  "categories": [
+    "Chat",
+    "Other"
+  ],
+  "extensionKind": [
+    "workspace",
+    "ui"
+  ],
+  "activationEvents": [
+    "onStartupFinished"
+  ],
+  "enabledApiProposals": [
+    "defaultChatParticipant",
+    "chatParticipantPrivate",
+    "chatParticipantAdditions",
+    "chatSessionsProvider",
+    "chatProvider"
+  ],
+  "contributes": {
+    "chatParticipants": [
+      {
+        "id": "supercode.chat",
+        "name": "supercode",
+        "fullName": "Assistant",
+        "description": "Ask a question or describe a task",
+        "when": "!supercodeChatDefaultParticipant",
+        "sampleRequest": "list the files here"
+      },
+      {
+        "id": "supercode.chat.default",
+        "name": "supercode",
+        "fullName": "Assistant",
+        "description": "Ask a question or describe a task",
+        "isDefault": true,
+        "when": "supercodeChatDefaultParticipant",
+        "sampleRequest": "list the files here",
+        "locations": [
+          "panel"
+        ],
+        "modes": [
+          "agent",
+          "ask"
+        ]
+      }
+    ],
+    "chatSessions": [
+      {
+        "type": "supercode",
+        "name": "supercode-runtime",
+        "displayName": "Harness",
+        "description": "Conversations with your AI assistant",
+        "icon": "$(server-process)",
+        "welcomeTitle": "Chat",
+        "welcomeMessage": "Ask a question or continue a saved conversation.",
+        "inputPlaceholder": "Ask a question or describe a task",
+        "order": 1,
+        "capabilities": {
+          "supportsFileAttachments": true,
+          "supportsToolAttachments": false,
+          "supportsImageAttachments": false
+        },
+        "canDelegate": false,
+        "supportsAutoModel": false,
+        "requiresCustomModels": true
+      }
+    ],
+    "chatViewsWelcome": [
+      {
+        "icon": "$(server-process)",
+        "title": "Volter Harness",
+        "content": "Volter Harness is not attached to a runtime.\n[Set runtime token](command:supercode.frontend.setToken)\n[Attach](command:supercode.frontend.connect)",
+        "when": "!supercodeAttached"
+      }
+    ],
+    "commands": [
+      {
+        "command": "supercode.frontend.setToken",
+        "title": "Set Runtime Token",
+        "category": "Volter Harness"
+      },
+      {
+        "command": "supercode.frontend.connect",
+        "title": "Attach to Runtime",
+        "category": "Volter Harness"
+      },
+      {
+        "command": "supercode.frontend.disconnect",
+        "title": "Detach from Runtime",
+        "category": "Volter Harness"
+      },
+      {
+        "command": "supercode.frontend.status",
+        "title": "Show Runtime Status",
+        "category": "Volter Harness"
+      },
+      {
+        "command": "supercode.frontend.newSession",
+        "title": "New Volter Harness Runtime Session",
+        "category": "Volter Harness",
+        "icon": "$(server-process)"
+      },
+      {
+        "command": "supercode.frontend.respond",
+        "title": "Answer Runtime Request",
+        "category": "Volter Harness",
+        "enablement": "false"
+      },
+      {
+        "command": "supercode.frontend.configure",
+        "title": "New Chat: Choose Harness, Model and Reasoning",
+        "category": "Chat",
+        "icon": "$(add)"
+      }
+    ],
+    "configuration": {
+      "title": "Volter Harness",
+      "properties": {
+        "supercode.frontend.baseUrl": {
+          "type": "string",
+          "default": "",
+          "description": "Base URL of an already-running Volter Harness SDK runtime (`supercode serve` prints it). The runtime credential is NEVER a setting \u2014 run `Volter Harness: Set Runtime Token`, which stores it in SecretStorage."
+        },
+        "supercode.frontend.permissions": {
+          "type": "array",
+          "default": [
+            "observe"
+          ],
+          "items": {
+            "type": "string",
+            "enum": [
+              "observe",
+              "interact",
+              "approve",
+              "terminate"
+            ]
+          },
+          "description": "Permissions to request when attaching. `observe` is always included; every control is still rendered only when the runtime's own descriptor advertises the matching action."
+        }
+      }
+    },
+    "menus": {
+      "chatSessions/newSession": [
+        {
+          "command": "supercode.frontend.newSession",
+          "when": "chatSessionType == supercode"
+        }
+      ]
+    },
+    "languageModelChatProviders": [
+      {
+        "vendor": "supercode-runtime",
+        "displayName": "Runtime models"
+      }
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "22.10.0",
+    "@types/vscode": "1.138.0",
+    "typescript": "5.6.3"
+  },
+  "supercodeFrontendContract": {
+    "name": "@volter/supercode-frontend",
+    "version": "0.2.4",
+    "mode": "generated-artifact"
+  },
+  "license": "MIT OR Apache-2.0"
+}

package/scripts/pack-extension.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+// Emit the VS Code extension folder for this npm package.
+//
+// One `package.json` cannot be both: npm wants the scoped
+// `@volter/supercode-frontend-vscode`, while VS Code builds an extension
+// id as `${publisher}.${name}` and a scope would put an `@` and a `/` in it.
+// So the npm manifest is the source of truth and this writes the extension's
+// manifest beside the same built files, with the plain name that resolves to
+// `volter-ai-dev.supercode-frontend-vscode`. `--vsix` then runs the stock
+// packer over that folder; the folder itself is what `--extensions-dir` wants.
+//
+//   node scripts/pack-extension.mjs [--out <dir>] [--no-proposals] [--vsix]
+//
+// `--no-proposals` drops `enabledApiProposals`, which is exactly the manifest a
+// host that grants nothing leaves behind (the workbench nulls the list it did
+// not allow). It is how the stable-parts-only degrade is exercised.
+import {cp, mkdir, readFile, rm, writeFile} from 'node:fs/promises';
+import {existsSync} from 'node:fs';
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
+import {spawnSync} from 'node:child_process';
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const args = process.argv.slice(2);
+const outIndex = args.indexOf('--out');
+const out = path.resolve(root, outIndex >= 0 ? args[outIndex + 1] : '.extension');
+const withoutProposals = args.includes('--no-proposals');
+
+const manifest = JSON.parse(await readFile(path.join(root, 'package.json'), 'utf8'));
+const extensionName = manifest.name.replace(/^@[^/]+\//, '');
+
+const extensionManifest = {
+  ...manifest,
+  name: extensionName,
+  scripts: undefined,
+  devDependencies: undefined,
+  files: undefined,
+  supercodeFrontendContract: manifest.supercodeFrontendContract,
+};
+if (withoutProposals) delete extensionManifest.enabledApiProposals;
+for (const key of Object.keys(extensionManifest)) {
+  if (extensionManifest[key] === undefined) delete extensionManifest[key];
+}
+
+// media/icon.png is fetched by the build (scripts/fetch-icon.mjs), which `extension` runs first.
+
+await rm(out, {recursive: true, force: true});
+await mkdir(out, {recursive: true});
+await writeFile(path.join(out, 'package.json'), `${JSON.stringify(extensionManifest, null, 2)}\n`);
+for (const entry of ['dist', 'vendor', 'media', 'README.md', 'NOTICE.md']) {
+  const source = path.join(root, entry);
+  if (existsSync(source)) await cp(source, path.join(out, entry), {recursive: true});
+}
+
+if (args.includes('--vsix')) {
+  const result = spawnSync('npx', ['--yes', '@vscode/vsce', 'package', '--no-dependencies', '--allow-missing-repository'], {
+    cwd: out,
+    stdio: 'inherit',
+  });
+  if (result.status !== 0) process.exit(result.status ?? 1);
+}
+
+process.stdout.write(`${path.relative(root, out)}${withoutProposals ? ' (no proposals requested)' : ''}\n`);

package/vendor/supercode-frontend/README.md

@@ -0,0 +1,22 @@
+# `@volter/supercode-frontend`
+
+This package is the generated, presentation-free attachment facade for one
+already-running Volter Harness SDK runtime. It describes and attaches to canonical
+history, consumes cursor-safe sequenced events, and sends semantic SDK actions.
+It does not import sessions, select providers/models/reduction policies, start
+agents, or own persistence.
+
+The checked-in `contract.json` is the self-contained versioned
+language-neutral IDL: it defines every wire object, tagged union, request,
+event, action, result, error, and opaque-extension boundary without referring
+to Rust or TypeScript types. Run `npm run check` to prove the typed Rust and
+TypeScript clients are byte-identical to generator output. The HTTP client
+opens SSE before taking its attachment snapshot, closing the history/live
+race; HTTP uses bearer authentication plus an opaque client id and permission
+narrowing. Dropping or detaching this client never closes the runtime;
+`close()` is a separate terminate-authorized action.
+
+`FrontendWebSocketClient.connect()` requires a header-capable socket factory
+and passes the bearer token only in `Authorization`. It deliberately has no
+query-token fallback: browser clients that cannot set upgrade headers use the
+HTTP/SSE binding until a separately approved credential bootstrap exists.

package/vendor/supercode-frontend/client.d.mts

@@ -0,0 +1,106 @@
+import type {
+  FrontendAttachSnapshot,
+  FrontendEvent,
+  FrontendOperationInvocation,
+  FrontendOperationResult,
+  FrontendResponse,
+  FrontendRuntimeDescriptor,
+  RuntimeLeaseSnapshot,
+} from './generated.mjs';
+import { GeneratedFrontendClient } from './generated-client.mjs';
+
+export * from './generated.mjs';
+export { GeneratedFrontendClient } from './generated-client.mjs';
+export const FRONTEND_SCHEMA: 'supercode.frontend.contract.v2';
+export const FRONTEND_METHODS: Readonly<Record<import('./generated.mjs').FrontendMethodId, import('./generated.mjs').FrontendWireMethod>>;
+export const FRONTEND_EVENT_METHOD: 'frontend.v2.event';
+
+export interface FrontendClientOptions {
+  baseUrl: string;
+  token: string;
+  clientId?: string;
+  permissions?: Array<'observe' | 'interact' | 'approve' | 'terminate'>;
+  fetch?: typeof globalThis.fetch;
+}
+export interface RequestOptions { signal?: AbortSignal; }
+
+export class FrontendClientError extends Error {
+  code: number | null;
+  operation: string | null;
+  permission: string | null;
+  holder: string | null;
+  expiresAtMs: number | null;
+  extensions: Record<string, unknown>;
+}
+
+export class FrontendClient extends GeneratedFrontendClient<RequestOptions> {
+  constructor(options: FrontendClientOptions);
+  readonly clientId: string;
+  readonly lastSequence: number;
+  headers(): Record<string, string>;
+  rpc(method: import('./generated.mjs').FrontendWireMethod, params?: Record<string, unknown>, options?: RequestOptions): Promise<unknown>;
+  describe(options?: RequestOptions): Promise<FrontendRuntimeDescriptor>;
+  attach(limit?: number, options?: RequestOptions & {afterSequence?: number}): Promise<FrontendAttachSnapshot>;
+  sendInput(prompt: string, options?: RequestOptions): Promise<{accepted:boolean}>;
+  submit(prompt: string, options?: RequestOptions): Promise<{reply:string}>;
+  interrupt(options?: RequestOptions): Promise<{interrupted:boolean}>;
+  steer(prompt: string, options?: RequestOptions): Promise<{queued:boolean}>;
+  respond(response: FrontendResponse, options?: RequestOptions): Promise<{accepted:boolean}>;
+  invoke(operation: FrontendOperationInvocation, options?: RequestOptions): Promise<FrontendOperationResult>;
+  lease(options?: RequestOptions): Promise<RuntimeLeaseSnapshot>;
+  takeControl(options?: RequestOptions): Promise<RuntimeLeaseSnapshot>;
+  heartbeat(options?: RequestOptions): Promise<RuntimeLeaseSnapshot>;
+  startEvents(options?: {afterSequence?:number;signal?:AbortSignal}): Promise<void>;
+  stopEvents(): void;
+  detach(options?: RequestOptions): Promise<RuntimeLeaseSnapshot>;
+  close(options?: RequestOptions): Promise<{closed:boolean}>;
+  on(event: 'event', listener: (event: FrontendEvent) => void): this;
+  on(event: 'disconnect', listener: () => void): this;
+  off(event: 'event', listener: (event: FrontendEvent) => void): this;
+  off(event: 'disconnect', listener: () => void): this;
+  once(event: 'event', listener: (event: FrontendEvent) => void): this;
+  once(event: 'disconnect', listener: () => void): this;
+}
+
+export interface FrontendWebSocketLike {
+  send(data: string): void;
+  close(): void;
+  addEventListener(event: 'message', listener: (event: {data:string|ArrayBuffer|ArrayBufferView}) => void): void;
+  addEventListener(event: 'close'|'error', listener: () => void): void;
+}
+export interface FrontendWebSocketConnectOptions {
+  url: string;
+  token: string;
+  clientId?: string;
+  permissions?: Array<'observe'|'interact'|'approve'|'terminate'>;
+  webSocketFactory(options:{url:string;headers:Record<string,string>}): FrontendWebSocketLike | Promise<FrontendWebSocketLike>;
+}
+export class FrontendWebSocketClient extends GeneratedFrontendClient<Record<string, never>> {
+  constructor(socket:FrontendWebSocketLike);
+  static connect(options:FrontendWebSocketConnectOptions):Promise<FrontendWebSocketClient>;
+  readonly lastSequence:number;
+  rpc(method:import('./generated.mjs').FrontendWireMethod,params?:Record<string,unknown>):Promise<unknown>;
+  describe():Promise<FrontendRuntimeDescriptor>;
+  attach(limit?:number,options?:{afterSequence?:number}):Promise<FrontendAttachSnapshot>;
+  sendInput(prompt:string):Promise<{accepted:boolean}>;
+  submit(prompt:string):Promise<{reply:string}>;
+  interrupt():Promise<{interrupted:boolean}>;
+  steer(prompt:string):Promise<{queued:boolean}>;
+  respond(response:FrontendResponse):Promise<{accepted:boolean}>;
+  invoke(operation:FrontendOperationInvocation):Promise<FrontendOperationResult>;
+  lease():Promise<RuntimeLeaseSnapshot>;
+  takeControl():Promise<RuntimeLeaseSnapshot>;
+  heartbeat():Promise<RuntimeLeaseSnapshot>;
+  detach():Promise<RuntimeLeaseSnapshot>;
+  close():Promise<{closed:boolean}>;
+  closeTransport():void;
+  on(event:'event',listener:(event:FrontendEvent)=>void):this;
+  on(event:'disconnect',listener:()=>void):this;
+  on(event:'protocolError',listener:(error:Error)=>void):this;
+  off(event:'event',listener:(event:FrontendEvent)=>void):this;
+  off(event:'disconnect',listener:()=>void):this;
+  off(event:'protocolError',listener:(error:Error)=>void):this;
+  once(event:'event',listener:(event:FrontendEvent)=>void):this;
+  once(event:'disconnect',listener:()=>void):this;
+  once(event:'protocolError',listener:(error:Error)=>void):this;
+}