pi-studio-opencode 0.1.0

package/ARCHITECTURE.md

@@ -0,0 +1,122 @@
+# Architecture
+
+## Current goal
+
+`pi-studio-opencode` is the first standalone host implementation of **π Studio** outside the original Pi extension.
+
+Near-term priority is to ship a genuinely usable opencode-facing Studio and learn from real users before locking in a long-term shared package structure.
+
+## Design philosophy
+
+Keep **Studio behavior** as host-neutral as practical, and keep **host integration** as a thin adapter layer.
+
+In other words:
+
+- shared Studio layers should define what Studio means
+  - run / queue steering / stop semantics
+  - response history and provenance
+  - follow-latest and selection behavior
+  - preview and math behavior
+  - editor and file-workflow behavior where practical
+- host adapters should define how those semantics are delivered
+  - session transport
+  - backend queue / stop wiring
+  - host-specific metadata
+  - host-specific editor integration
+
+This repo should avoid drifting into “an opencode app with Studio-like UI”. It should instead remain “a Studio implementation whose first standalone host is opencode”.
+
+## Relationship to `pi-studio`
+
+For now, this repo stays **separate** from `pi-studio`.
+
+That separation is intentional:
+
+- `pi-studio` remains the stable shipped Pi extension
+- `pi-studio-opencode` can evolve faster
+- we should not force an early merge or premature extraction just for architectural neatness
+
+`pi-studio` may still be used as a behavioral reference when validating parity, but standalone work should happen here.
+
+## Current no-port opencode bridge
+
+The current no-port `/studio` path is acceptable as a **real adapter layer**, but it should be understood as a mix of clean architecture and temporary opencode-specific workarounds.
+
+### Reasonably clean parts
+
+- the plugin owns the launch flow for `/studio`
+- the browser UI still talks to a local Studio HTTP server, not directly to opencode internals
+- Studio behavior remains behind the normal host abstraction (`StudioHost`)
+- the plugin-backed host uses `ctx.client` for imperative session operations
+  - create / reuse session
+  - prompt
+  - abort
+  - fetch messages
+- `startPrototypeServer(...)` can now accept an injected host factory, so the browser surface is not tightly coupled to one transport
+
+### Current workaround parts
+
+- command launch still relies on `command.execute.before` interception and a sentinel throw to cancel normal command execution after Studio has been opened
+- live updates in plain no-port TUI mode rely on plugin event forwarding plus message reconciliation, because browser-side SSE against opencode is not currently reliable there
+- response/user-message binding is therefore adapter logic rather than a single upstream canonical subscription API
+- plugin-load failures currently degrade badly: `/studio` falls back to a normal prompt template, which is confusing and should eventually be guarded more explicitly
+
+### Practical interpretation
+
+This is acceptable for now because it avoids much worse options such as TUI scraping, sqlite mutation, or shell-driven key simulation.
+
+But it should still be treated as:
+
+- a good current integration path
+- not yet proof that upstream opencode APIs are the final ideal surface for Studio
+- something we should simplify if opencode later provides a cleaner command-handled or event-subscription path
+
+## Recommended evolution
+
+### Phase A — ship and learn
+
+- make `pi-studio-opencode` useful enough for opencode users to try
+- release preliminary versions early
+- learn what is genuinely shared and what is still host-specific in disguise
+
+### Phase B — extract only the stable shared layers
+
+Once the boundaries are clearer from real use, extract the pieces that have actually stabilized, for example:
+
+- shared Studio state / provenance logic
+- shared preview / math pipeline
+- shared browser UI behavior
+- shared host type contracts
+
+Do **not** force a giant “core” extraction before that boundary is obvious.
+
+### Phase C — test a new Pi-facing layer on top of the shared layers
+
+A key validation step should be to build a **new Pi layer** on top of the extracted shared Studio layers.
+
+That is the real test of whether the architecture is working.
+
+The point is not just to share code abstractly. The point is to stop manually porting fixes between Pi and opencode and to stop keeping both interfaces in sync by hand.
+
+If the shared layers are good enough, then the eventual end state could be:
+
+- `pi-studio-opencode` = thin opencode-facing layer + shared Studio dependencies
+- `pi-studio` = thin Pi-facing layer + shared Studio dependencies
+
+## Non-goals for now
+
+- no premature repo merge with `pi-studio`
+- no forced monorepo yet
+- no promise that the final extracted package is exactly called `studio-core`
+- no rewriting the existing `pi-studio` extension before the shared path proves itself
+
+## Practical rule of thumb
+
+When adding or changing behavior here, ask:
+
+1. Is this genuinely **Studio behavior**?
+   - keep it host-neutral if possible.
+2. Is this specifically **how opencode works**?
+   - keep it in the opencode adapter layer.
+
+That discipline matters more right now than the exact future package layout.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oliver Maclaren
+
+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/README.md

@@ -0,0 +1,108 @@
+# pi-studio-opencode
+
+OpenCode plug-in adaptation of the [pi](https://pi.dev/) extension [`pi-studio`](https://github.com/omaclaren/pi-studio).
+
+It provides a local browser-based Studio workspace for [OpenCode](https://opencode.ai/), with an editor on the left and response/preview on the right.
+
+If you use pi itself, use the original [`pi-studio`](https://github.com/omaclaren/pi-studio). This repo is for OpenCode.
+
+## Status
+
+Usable and actively improving.
+
+The main goal is a good OpenCode version of Studio rather than full feature parity with `pi-studio`.
+
+## Features
+
+- Launch Studio from an active OpenCode session with `/studio`
+- Attach Studio to the same session you are already using
+- Two-pane editor + response/preview workspace
+- Run, queue steering, stop, and browse response history
+- Raw response, rendered response preview, and editor preview
+- Load and save local files
+- Markdown / QMD / LaTeX preview with practical support for:
+  - math fallback
+  - Quarto-style callouts
+  - preview page-break markers
+  - local PDF figure preview via `pdf.js`
+- PDF export of the right-pane preview via `pandoc` + `xelatex`
+- Theme-aware Studio UI based on the active OpenCode theme
+- Footer/status info, pane focus controls, and response highlighting inspired by `pi-studio`
+
+## Install
+
+Recommended installation:
+
+```bash
+bunx pi-studio-opencode@latest install
+```
+
+That updates your OpenCode config to add:
+
+- the `pi-studio-opencode@latest` plugin entry
+- the `/studio` command entry
+
+For a project-local install instead of a user-wide one:
+
+```bash
+bunx pi-studio-opencode@latest install --project
+```
+
+Then restart OpenCode and run:
+
+```text
+/studio
+```
+
+## Manual config
+
+If you prefer to edit config yourself, add this to either:
+
+- `.opencode/opencode.jsonc`
+- `~/.config/opencode/opencode.json`
+- `~/.config/opencode/opencode.jsonc`
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["pi-studio-opencode@latest"],
+  "command": {
+    "studio": {
+      "template": "Open π Studio for this active opencode session.",
+      "description": "Open π Studio attached to the current opencode session"
+    }
+  }
+}
+```
+
+## Notes
+
+- `/studio` opens a browser-based Studio linked to the current OpenCode session.
+- If `/studio` gets sent to the model as ordinary text, the plug-in probably did not load. Rebuild or reinstall the package, then fully restart OpenCode.
+- If you use `--no-open`, open the full tokenized URL shown by Studio, not just the bare port root.
+- `--base-url`, `--session`, and `--directory` are taken from the active OpenCode session during `/studio`.
+- The Studio UI is external to OpenCode; it is not an embedded pane.
+- Preview and PDF quality depend on local tooling:
+  - `pandoc` for preview/PDF workflows
+  - `xelatex` for PDF export
+
+## Standalone launcher
+
+You can also launch the browser surface directly:
+
+```bash
+pi-studio-opencode --directory "/path/to/project"
+```
+
+or:
+
+```bash
+npx pi-studio-opencode --directory "/path/to/project"
+```
+
+To attach manually to an existing OpenCode server/session:
+
+```bash
+pi-studio-opencode --base-url "http://127.0.0.1:4096" --session "<session-id>" --directory "/path/to/project"
+```
+

package/dist/demo-host-pi.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/demo-host-pi.js

@@ -0,0 +1,71 @@
+import { setTimeout as sleep } from "node:timers/promises";
+import { createPiStudioHost } from "./host-pi.js";
+import { MockPiSession } from "./mock-pi-session.js";
+import { describeStudioHostCapabilities } from "./studio-host-types.js";
+const RUN_PROMPT = [
+    "Please reply in one short paragraph.",
+    "Say INITIAL_RUN_OK exactly once.",
+].join("\n");
+const STEER_1 = [
+    "Queued steering:",
+    "append QUEUE_ONE_OK as a new final sentence.",
+].join("\n");
+const STEER_2 = [
+    "Queued steering 2:",
+    "append QUEUE_TWO_OK as a new final sentence.",
+].join("\n");
+const ABORT_PROMPT = [
+    "Write 120 numbered bullet points about event streams.",
+    "Do not summarize.",
+].join("\n");
+function formatState(state) {
+    return [
+        `backend=${state.backend}`,
+        `runState=${state.runState}`,
+        `activeChain=${state.activeChainIndex ?? "-"}`,
+        `activePrompt=${state.activePromptId ? state.activePromptId.slice(0, 16) : "-"}`,
+        `queue=${state.queueLength}`,
+        `history=${state.historyCount}`,
+        `status=${state.lastBackendStatus ?? "-"}`,
+    ].join(" ");
+}
+async function main() {
+    const session = new MockPiSession();
+    const host = await createPiStudioHost({
+        session,
+        eventLogger: (line) => console.log(line),
+    });
+    console.log(`host capabilities: ${describeStudioHostCapabilities(host.getCapabilities())}`);
+    const unsubscribe = host.subscribe((state) => {
+        console.log(`[state] ${formatState(state)}`);
+    });
+    try {
+        console.log("\n--- pi sketch: native steer semantics ---\n");
+        await host.startRun(RUN_PROMPT);
+        await sleep(50);
+        await host.queueSteer(STEER_1);
+        await sleep(50);
+        await host.queueSteer(STEER_2);
+        await host.waitUntilIdle();
+        console.log("History after steering chain:");
+        for (const item of host.getHistory()) {
+            console.log(`- chain=${item.chainIndex} mode=${item.promptMode} steeringCount=${item.promptSteeringCount} response=${(item.responseText ?? "").replace(/\s+/g, " ")}`);
+        }
+        console.log("\n--- pi sketch: abort ---\n");
+        await host.startRun(ABORT_PROMPT);
+        await sleep(50);
+        await host.stop();
+        await host.waitUntilIdle();
+        console.log("Final history:\n");
+        console.log(JSON.stringify(host.getHistory(), null, 2));
+    }
+    finally {
+        unsubscribe();
+        await host.close();
+    }
+}
+void main().catch((error) => {
+    console.error(error instanceof Error ? error.stack ?? error.message : error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=demo-host-pi.js.map

package/dist/demo-host-pi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-host-pi.js","sourceRoot":"","sources":["../src/demo-host-pi.ts"],"names":[],"mappings":"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"}

package/dist/demo-host.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/demo-host.js

@@ -0,0 +1,154 @@
+import { setTimeout as sleep } from "node:timers/promises";
+import { createOpencodeStudioHost } from "./host-opencode.js";
+import { describeStudioHostCapabilities } from "./studio-host-types.js";
+const RUN_PROMPT = [
+    "Respond with exactly this plain text and nothing else:",
+    "INITIAL_RUN_OK",
+].join("\n");
+const STEER_1 = [
+    "Respond with exactly this plain text and nothing else:",
+    "INITIAL_RUN_OK QUEUE_ONE_OK",
+].join("\n");
+const STEER_2 = [
+    "Respond with exactly this plain text and nothing else:",
+    "INITIAL_RUN_OK QUEUE_ONE_OK QUEUE_TWO_OK",
+].join("\n");
+const ABORT_PROMPT = [
+    "Write 120 numbered bullet points about event streams.",
+    "Do not summarize.",
+].join("\n");
+function parseArgs(argv) {
+    const options = {
+        directory: process.cwd(),
+        queueDelayMs: 700,
+        secondQueueDelayMs: 500,
+        abortDelayMs: 500,
+        abortTest: true,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        if (arg === "--directory" && next) {
+            options.directory = next;
+            i += 1;
+            continue;
+        }
+        if (arg === "--base-url" && next) {
+            options.baseUrl = next;
+            i += 1;
+            continue;
+        }
+        if (arg === "--session" && next) {
+            options.sessionId = next;
+            i += 1;
+            continue;
+        }
+        if (arg === "--title" && next) {
+            options.title = next;
+            i += 1;
+            continue;
+        }
+        if (arg === "--queue-delay-ms" && next) {
+            options.queueDelayMs = Number.parseInt(next, 10);
+            i += 1;
+            continue;
+        }
+        if (arg === "--second-queue-delay-ms" && next) {
+            options.secondQueueDelayMs = Number.parseInt(next, 10);
+            i += 1;
+            continue;
+        }
+        if (arg === "--abort-delay-ms" && next) {
+            options.abortDelayMs = Number.parseInt(next, 10);
+            i += 1;
+            continue;
+        }
+        if (arg === "--no-abort-test") {
+            options.abortTest = false;
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            printUsageAndExit();
+        }
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+    return options;
+}
+function printUsageAndExit() {
+    console.log(`Usage: npm run host-demo -- [options]
+
+Options:
+  --directory <path>            Project directory / working directory
+  --base-url <url>              Use an existing opencode server
+  --session <id>                Reuse an existing session
+  --title <title>               Title for a newly created session
+  --queue-delay-ms <n>          Delay before queueing the first steer (default: 700)
+  --second-queue-delay-ms <n>   Delay before queueing the second steer (default: 500)
+  --abort-delay-ms <n>          Delay before stop() in the abort demo (default: 500)
+  --no-abort-test               Skip the abort scenario
+`);
+    process.exit(0);
+}
+function formatState(state) {
+    return [
+        `runState=${state.runState}`,
+        `activeChain=${state.activeChainIndex ?? "-"}`,
+        `activePrompt=${state.activePromptId ? state.activePromptId.slice(0, 16) : "-"}`,
+        `queue=${state.queueLength}`,
+        `history=${state.historyCount}`,
+        `backend=${state.lastBackendStatus ?? "-"}`,
+    ].join(" ");
+}
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    const host = await createOpencodeStudioHost({
+        directory: options.directory,
+        baseUrl: options.baseUrl,
+        sessionId: options.sessionId,
+        title: options.title,
+        eventLogger: (line) => console.log(line),
+    });
+    console.log(`host capabilities: ${describeStudioHostCapabilities(host.getCapabilities())}`);
+    const unsubscribe = host.subscribe((state) => {
+        console.log(`[state] ${formatState(state)}`);
+    });
+    try {
+        console.log("\n--- scenario 1: run + locally queued steers ---\n");
+        await host.startRun(RUN_PROMPT);
+        await sleep(options.queueDelayMs);
+        await host.queueSteer(STEER_1);
+        await sleep(options.secondQueueDelayMs);
+        await host.queueSteer(STEER_2);
+        await host.waitUntilIdle();
+        console.log("History after scenario 1:");
+        for (const item of host.getHistory()) {
+            console.log(`- chain=${item.chainIndex} mode=${item.promptMode} steeringCount=${item.promptSteeringCount} queuedWhileBusy=${item.queuedWhileBusy}`);
+            console.log(`  response=${(item.responseText ?? "").replace(/\s+/g, " ").slice(0, 140)}`);
+            if (item.responseError) {
+                console.log(`  error=${item.responseError}`);
+            }
+        }
+        if (options.abortTest) {
+            console.log("\n--- scenario 2: abort current run ---\n");
+            await host.startRun(ABORT_PROMPT);
+            await sleep(options.abortDelayMs);
+            await host.stop();
+            await host.waitUntilIdle();
+            const last = host.getHistory().at(-1);
+            if (last) {
+                console.log(`Abort result: responseId=${last.responseMessageId ?? "(missing)"} error=${last.responseError ?? "(none)"}`);
+            }
+        }
+        console.log("\nFinal history:\n");
+        console.log(JSON.stringify(host.getHistory(), null, 2));
+    }
+    finally {
+        unsubscribe();
+        await host.close();
+    }
+}
+void main().catch((error) => {
+    console.error(error instanceof Error ? error.stack ?? error.message : error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=demo-host.js.map

package/dist/demo-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-host.js","sourceRoot":"","sources":["../src/demo-host.ts"],"names":[],"mappings":"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"}

package/dist/host-opencode-plugin.d.ts

@@ -0,0 +1,52 @@
+import type { Event, OpencodeClient } from "@opencode-ai/sdk";
+import { type OpencodeStudioHostTelemetryEvent } from "./host-opencode.js";
+import type { StudioHost, StudioHostCapabilities, StudioHostHistoryItem, StudioHostListener, StudioHostState } from "./studio-host-types.js";
+export type PluginBackedOpencodeStudioHostOptions = {
+    client: OpencodeClient;
+    directory: string;
+    sessionId?: string;
+    title?: string;
+    eventLogger?: (line: string) => void;
+    telemetryListener?: (event: OpencodeStudioHostTelemetryEvent) => void;
+};
+export declare class PluginBackedOpencodeStudioHost implements StudioHost {
+    private readonly options;
+    private readonly listeners;
+    private readonly baselineMessageIds;
+    private readonly matchedUserIds;
+    private readonly matchedAssistantIds;
+    private readonly partTypesById;
+    private readonly messageRolesById;
+    private readonly core;
+    private readonly client;
+    private session;
+    private handlingIdle;
+    private closed;
+    static create(options: PluginBackedOpencodeStudioHostOptions): Promise<PluginBackedOpencodeStudioHost>;
+    private constructor();
+    getState(): StudioHostState;
+    getCapabilities(): StudioHostCapabilities;
+    getHistory(): StudioHostHistoryItem[];
+    subscribe(listener: StudioHostListener): () => void;
+    startRun(prompt: string): Promise<void>;
+    queueSteer(prompt: string): Promise<void>;
+    stop(): Promise<void>;
+    waitUntilIdle(timeoutMs?: number): Promise<void>;
+    close(): Promise<void>;
+    ingestEvent(event: Event): Promise<void>;
+    private initialize;
+    private createOrReuseSession;
+    private emitModelTelemetryForMessage;
+    private handleEvent;
+    private handleSessionIdle;
+    private dispatchSubmission;
+    private finalizeActiveSubmission;
+    private bindSubmissionToMessages;
+    private reconcileObservedExternalResponses;
+    private fetchSessionMessages;
+    private emitState;
+    private emitTelemetry;
+    private fail;
+    private assertReady;
+}
+export declare function createPluginBackedOpencodeStudioHost(options: PluginBackedOpencodeStudioHostOptions): Promise<PluginBackedOpencodeStudioHost>;