pi-studio-opencode 0.1.0

package/dist/host-pi.d.ts

@@ -0,0 +1,45 @@
+import type { StudioHost, StudioHostCapabilities, StudioHostListener, StudioHostState } from "./studio-host-types.js";
+export type PiSessionEventLike = {
+    type: string;
+    message?: unknown;
+};
+export type PiSessionLike = {
+    sessionId: string;
+    sessionFile?: string;
+    isStreaming: boolean;
+    prompt(text: string, options?: {
+        streamingBehavior?: "steer" | "followUp";
+    }): Promise<void>;
+    steer(text: string): Promise<void>;
+    abort(): Promise<void>;
+    subscribe(listener: (event: PiSessionEventLike) => void): () => void;
+    dispose?(): void;
+};
+export type PiStudioHostOptions = {
+    session: PiSessionLike;
+    eventLogger?: (line: string) => void;
+};
+export declare class PiStudioHost implements StudioHost {
+    private readonly options;
+    private readonly session;
+    private readonly listeners;
+    private readonly core;
+    private unsubscribeSession;
+    private closed;
+    static create(options: PiStudioHostOptions): Promise<PiStudioHost>;
+    private constructor();
+    getState(): StudioHostState;
+    getCapabilities(): StudioHostCapabilities;
+    getHistory(): import("./studio-host-types.js").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>;
+    private initialize;
+    private handleEvent;
+    private emitState;
+    private assertReady;
+}
+export declare function createPiStudioHost(options: PiStudioHostOptions): Promise<StudioHost>;

package/dist/host-pi.js

@@ -0,0 +1,258 @@
+import { setTimeout as sleep } from "node:timers/promises";
+import { StudioCore } from "./studio-core.js";
+const PI_HOST_CAPABILITIES = {
+    steeringMode: "native-steer",
+    stopSupported: true,
+};
+function normalizePromptText(text) {
+    if (typeof text !== "string")
+        return null;
+    const trimmed = text.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function extractMessageId(message) {
+    const msg = message;
+    return typeof msg?.id === "string" ? msg.id : null;
+}
+function extractStopReason(message) {
+    const msg = message;
+    return typeof msg?.stopReason === "string" ? msg.stopReason : null;
+}
+function extractAssistantText(message) {
+    const msg = message;
+    if (!msg || msg.role !== "assistant")
+        return null;
+    if (typeof msg.content === "string") {
+        return normalizePromptText(msg.content);
+    }
+    if (!Array.isArray(msg.content))
+        return null;
+    const blocks = [];
+    for (const part of msg.content) {
+        if (!part || typeof part !== "object")
+            continue;
+        const partType = typeof part.type === "string" ? part.type : "";
+        if (typeof part.text === "string") {
+            if (!partType || partType === "text" || partType === "output_text") {
+                blocks.push(part.text);
+            }
+            continue;
+        }
+        if (part.text && typeof part.text === "object" && typeof part.text.value === "string") {
+            if (!partType || partType === "text" || partType === "output_text") {
+                blocks.push(part.text.value);
+            }
+        }
+    }
+    return normalizePromptText(blocks.join("\n\n"));
+}
+function extractUserText(message) {
+    const msg = message;
+    if (!msg || msg.role !== "user")
+        return null;
+    if (typeof msg.content === "string") {
+        return normalizePromptText(msg.content);
+    }
+    if (!Array.isArray(msg.content))
+        return null;
+    const blocks = [];
+    for (const part of msg.content) {
+        if (!part || typeof part !== "object")
+            continue;
+        const partType = typeof part.type === "string" ? part.type : "";
+        if (typeof part.text === "string") {
+            if (!partType || partType === "text" || partType === "input_text") {
+                blocks.push(part.text);
+            }
+            continue;
+        }
+        if (part.text && typeof part.text === "object" && typeof part.text.value === "string") {
+            if (!partType || partType === "text" || partType === "input_text") {
+                blocks.push(part.text.value);
+            }
+        }
+    }
+    return normalizePromptText(blocks.join("\n\n"));
+}
+function extractAssistantError(message) {
+    const msg = message;
+    if (typeof msg?.error === "string" && msg.error.trim()) {
+        return msg.error;
+    }
+    if (msg?.error && typeof msg.error === "object") {
+        const name = typeof msg.error.name === "string" ? msg.error.name : "AssistantError";
+        const messageText = typeof msg.error.message === "string" ? msg.error.message : "unknown error";
+        return `${name}: ${messageText}`;
+    }
+    if (msg?.stopReason === "aborted") {
+        return "Aborted";
+    }
+    return undefined;
+}
+function summarizeEvent(event) {
+    if (event.type === "message_end") {
+        const role = typeof event.message?.role === "string"
+            ? event.message.role
+            : "?";
+        return `${event.type} role=${role}`;
+    }
+    return event.type;
+}
+export class PiStudioHost {
+    options;
+    session;
+    listeners = new Set();
+    core;
+    unsubscribeSession = null;
+    closed = false;
+    static async create(options) {
+        const host = new PiStudioHost(options);
+        host.initialize();
+        return host;
+    }
+    constructor(options) {
+        this.options = options;
+        this.session = options.session;
+        this.core = new StudioCore({
+            backend: "pi",
+            sessionId: options.session.sessionId,
+            sessionTitle: options.session.sessionFile ?? null,
+        });
+        this.core.noteBackendStatus(options.session.isStreaming ? "streaming" : "idle");
+    }
+    getState() {
+        return this.core.getState();
+    }
+    getCapabilities() {
+        return { ...PI_HOST_CAPABILITIES };
+    }
+    getHistory() {
+        return this.core.getHistory();
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.getState());
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    async startRun(prompt) {
+        this.assertReady();
+        const submission = this.core.startRun(prompt);
+        this.emitState();
+        await this.session.prompt(submission.promptText);
+    }
+    async queueSteer(prompt) {
+        this.assertReady();
+        this.core.queueSteer(prompt);
+        this.emitState();
+        if (this.session.isStreaming) {
+            await this.session.steer(prompt);
+            return;
+        }
+        const activated = this.core.activateNextQueuedSteer();
+        if (!activated)
+            return;
+        this.emitState();
+        await this.session.prompt(activated.promptText);
+    }
+    async stop() {
+        this.assertReady();
+        if (this.core.getState().runState !== "running")
+            return;
+        this.core.markStopRequested({ clearQueuedSteers: true, backendStatus: "aborting" });
+        this.emitState();
+        await this.session.abort();
+    }
+    async waitUntilIdle(timeoutMs = 60_000) {
+        const started = Date.now();
+        while (Date.now() - started < timeoutMs) {
+            const state = this.core.getState();
+            if (state.runState === "idle" && !this.core.hasActiveChain() && !state.activePromptId && state.queueLength === 0) {
+                return;
+            }
+            await sleep(100);
+        }
+        throw new Error("Timed out waiting for pi host to become idle.");
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.unsubscribeSession?.();
+        this.unsubscribeSession = null;
+        if (this.session.dispose) {
+            this.session.dispose();
+        }
+        this.core.markClosed();
+        this.emitState();
+    }
+    initialize() {
+        this.unsubscribeSession = this.session.subscribe((event) => {
+            this.options.eventLogger?.(`[event] ${summarizeEvent(event)}`);
+            this.handleEvent(event);
+        });
+    }
+    handleEvent(event) {
+        if (this.closed)
+            return;
+        if (event.type === "agent_start") {
+            this.core.noteBackendStatus("streaming");
+            this.emitState();
+            return;
+        }
+        if (event.type === "agent_end") {
+            this.core.noteBackendIdle();
+            this.emitState();
+            return;
+        }
+        if (event.type !== "message_end")
+            return;
+        const userText = extractUserText(event.message);
+        if (userText) {
+            this.core.noteUserMessage({
+                text: userText,
+                messageId: extractMessageId(event.message),
+            });
+            this.emitState();
+            return;
+        }
+        const role = typeof event.message?.role === "string"
+            ? event.message.role
+            : null;
+        if (role !== "assistant")
+            return;
+        if (extractStopReason(event.message) === "toolUse")
+            return;
+        const assistantText = extractAssistantText(event.message);
+        const assistantError = extractAssistantError(event.message);
+        if (!assistantText && !assistantError)
+            return;
+        this.core.completeActiveResponse({
+            responseMessageId: extractMessageId(event.message),
+            responseText: assistantText ?? "",
+            responseError: assistantError,
+            completedAt: Date.now(),
+        });
+        this.emitState();
+    }
+    emitState() {
+        const snapshot = this.getState();
+        for (const listener of this.listeners) {
+            listener(snapshot);
+        }
+    }
+    assertReady() {
+        const state = this.core.getState();
+        if (this.closed || state.runState === "closed") {
+            throw new Error("Host is closed.");
+        }
+        if (state.runState === "error") {
+            throw new Error(state.lastError ?? "Host is in an error state.");
+        }
+    }
+}
+export async function createPiStudioHost(options) {
+    return PiStudioHost.create(options);
+}
+//# sourceMappingURL=host-pi.js.map

package/dist/host-pi.js.map

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

package/dist/install-config.d.ts

@@ -0,0 +1,36 @@
+export declare const OPENCODE_CONFIG_SCHEMA = "https://opencode.ai/config.json";
+export declare const DEFAULT_STUDIO_COMMAND_NAME = "studio";
+export declare const DEFAULT_STUDIO_COMMAND_TEMPLATE = "Open \u03C0 Studio for this active opencode session.";
+export declare const DEFAULT_STUDIO_COMMAND_DESCRIPTION = "Open \u03C0 Studio attached to the current opencode session";
+export type OpencodeCommandEntry = {
+    template: string;
+    description?: string;
+    agent?: string;
+    model?: string;
+    subtask?: boolean;
+    [key: string]: unknown;
+};
+export type OpencodeConfigFile = {
+    $schema?: string;
+    plugin?: string[];
+    command?: Record<string, OpencodeCommandEntry>;
+    [key: string]: unknown;
+};
+export type MergePiStudioOpencodeConfigResult = {
+    config: OpencodeConfigFile;
+    changed: boolean;
+    addedPlugin: boolean;
+    addedCommand: boolean;
+    setSchema: boolean;
+    existingPluginSpec: string | null;
+};
+export declare function stripJsonComments(input: string): string;
+export declare function parseOpencodeConfigText(text: string): OpencodeConfigFile;
+export declare function buildStudioCommandEntry(): OpencodeCommandEntry;
+export declare function normalizePluginIdentity(spec: string): string;
+export declare function formatOpencodeConfig(config: OpencodeConfigFile): string;
+export declare function mergePiStudioOpencodeIntoConfig(config: OpencodeConfigFile, options?: {
+    pluginSpec?: string;
+    packageName?: string;
+    commandName?: string;
+}): MergePiStudioOpencodeConfigResult;

package/dist/install-config.js

@@ -0,0 +1,136 @@
+import { basename } from "node:path";
+import { fileURLToPath } from "node:url";
+export const OPENCODE_CONFIG_SCHEMA = "https://opencode.ai/config.json";
+export const DEFAULT_STUDIO_COMMAND_NAME = "studio";
+export const DEFAULT_STUDIO_COMMAND_TEMPLATE = "Open π Studio for this active opencode session.";
+export const DEFAULT_STUDIO_COMMAND_DESCRIPTION = "Open π Studio attached to the current opencode session";
+export function stripJsonComments(input) {
+    let out = "";
+    let quote = null;
+    let escaping = false;
+    let inLineComment = false;
+    let inBlockComment = false;
+    for (let i = 0; i < input.length; i += 1) {
+        const ch = input[i];
+        const next = input[i + 1] ?? "";
+        if (inLineComment) {
+            if (ch === "\n") {
+                inLineComment = false;
+                out += ch;
+            }
+            continue;
+        }
+        if (inBlockComment) {
+            if (ch === "*" && next === "/") {
+                inBlockComment = false;
+                i += 1;
+            }
+            continue;
+        }
+        if (quote) {
+            out += ch;
+            if (escaping) {
+                escaping = false;
+            }
+            else if (ch === "\\") {
+                escaping = true;
+            }
+            else if (ch === quote) {
+                quote = null;
+            }
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            out += ch;
+            continue;
+        }
+        if (ch === "/" && next === "/") {
+            inLineComment = true;
+            i += 1;
+            continue;
+        }
+        if (ch === "/" && next === "*") {
+            inBlockComment = true;
+            i += 1;
+            continue;
+        }
+        out += ch;
+    }
+    return out;
+}
+export function parseOpencodeConfigText(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return {};
+    const parsed = JSON.parse(stripJsonComments(text));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("OpenCode config must be a JSON object.");
+    }
+    return parsed;
+}
+export function buildStudioCommandEntry() {
+    return {
+        template: DEFAULT_STUDIO_COMMAND_TEMPLATE,
+        description: DEFAULT_STUDIO_COMMAND_DESCRIPTION,
+    };
+}
+function isLikelyPathSpec(spec) {
+    return spec.startsWith("file://")
+        || spec.startsWith("/")
+        || spec.startsWith("./")
+        || spec.startsWith("../")
+        || spec.startsWith("~/")
+        || /^[A-Za-z]:[\\/]/.test(spec);
+}
+function normalizePackageSpec(spec) {
+    const trimmed = spec.trim();
+    const lastAtIndex = trimmed.lastIndexOf("@");
+    return lastAtIndex > 0 ? trimmed.slice(0, lastAtIndex) : trimmed;
+}
+export function normalizePluginIdentity(spec) {
+    const trimmed = spec.trim();
+    if (!trimmed)
+        return "";
+    if (isLikelyPathSpec(trimmed)) {
+        const pathValue = trimmed.startsWith("file://") ? fileURLToPath(trimmed) : trimmed;
+        return basename(pathValue.replace(/[\\/]+$/, "")).toLowerCase();
+    }
+    return normalizePackageSpec(trimmed).toLowerCase();
+}
+export function formatOpencodeConfig(config) {
+    return `${JSON.stringify(config, null, 2)}\n`;
+}
+export function mergePiStudioOpencodeIntoConfig(config, options) {
+    const pluginSpec = options?.pluginSpec?.trim() || "pi-studio-opencode@latest";
+    const packageName = options?.packageName?.trim() || "pi-studio-opencode";
+    const commandName = options?.commandName?.trim() || DEFAULT_STUDIO_COMMAND_NAME;
+    const packageIdentity = normalizePluginIdentity(packageName);
+    const existingPlugins = Array.isArray(config.plugin) ? [...config.plugin] : [];
+    const existingPluginSpec = existingPlugins.find((entry) => normalizePluginIdentity(entry) === packageIdentity) ?? null;
+    const addedPlugin = !existingPluginSpec;
+    const plugin = addedPlugin ? [...existingPlugins, pluginSpec] : existingPlugins;
+    const existingCommands = config.command && typeof config.command === "object" && !Array.isArray(config.command)
+        ? { ...config.command }
+        : {};
+    const addedCommand = !existingCommands[commandName];
+    if (addedCommand) {
+        existingCommands[commandName] = buildStudioCommandEntry();
+    }
+    const setSchema = !config.$schema;
+    const nextConfig = {
+        ...config,
+        ...(setSchema ? { $schema: OPENCODE_CONFIG_SCHEMA } : {}),
+        plugin,
+        command: existingCommands,
+    };
+    return {
+        config: nextConfig,
+        changed: addedPlugin || addedCommand || setSchema,
+        addedPlugin,
+        addedCommand,
+        setSchema,
+        existingPluginSpec,
+    };
+}
+//# sourceMappingURL=install-config.js.map

package/dist/install-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-config.js","sourceRoot":"","sources":["../src/install-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,iCAAiC,CAAC;AACxE,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC;AACpD,MAAM,CAAC,MAAM,+BAA+B,GAAG,iDAAiD,CAAC;AACjG,MAAM,CAAC,MAAM,kCAAkC,GAAG,wDAAwD,CAAC;AA2B3G,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAqB,IAAI,CAAC;IACnC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAEhC,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,aAAa,GAAG,KAAK,CAAC;gBACtB,GAAG,IAAI,EAAE,CAAC;YACZ,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBAC/B,cAAc,GAAG,KAAK,CAAC;gBACvB,CAAC,IAAI,CAAC,CAAC;YACT,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,GAAG,IAAI,EAAE,CAAC;YACV,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;iBAAM,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACvB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;iBAAM,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;gBACxB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC7B,KAAK,GAAG,EAAE,CAAC;YACX,GAAG,IAAI,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAC/B,aAAa,GAAG,IAAI,CAAC;YACrB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAC/B,cAAc,GAAG,IAAI,CAAC;YACtB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QAED,GAAG,IAAI,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAY,CAAC;IAC9D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,MAA4B,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE,+BAA+B;QACzC,WAAW,EAAE,kCAAkC;KAChD,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;WAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;WACpB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;WACrB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;WACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;WACrB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACnF,OAAO,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAClE,CAAC;IAED,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAA0B;IAC7D,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,MAA0B,EAC1B,OAIC;IAED,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,2BAA2B,CAAC;IAC9E,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,oBAAoB,CAAC;IACzE,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,2BAA2B,CAAC;IAChF,MAAM,eAAe,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAE7D,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,MAAM,kBAAkB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC,KAAK,eAAe,CAAC,IAAI,IAAI,CAAC;IACvH,MAAM,WAAW,GAAG,CAAC,kBAAkB,CAAC;IACxC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;IAEhF,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7G,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE;QACvB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,YAAY,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,YAAY,EAAE,CAAC;QACjB,gBAAgB,CAAC,WAAW,CAAC,GAAG,uBAAuB,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;IAElC,MAAM,UAAU,GAAuB;QACrC,GAAG,MAAM;QACT,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,MAAM;QACN,OAAO,EAAE,gBAAgB;KAC1B,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,WAAW,IAAI,YAAY,IAAI,SAAS;QACjD,WAAW;QACX,YAAY;QACZ,SAAS;QACT,kBAAkB;KACnB,CAAC;AACJ,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,16 @@
+import { type MergePiStudioOpencodeConfigResult } from "./install-config.js";
+type InstallOptions = {
+    configPath?: string;
+    projectDir?: string;
+    pluginSpec: string;
+    packageName: string;
+    commandName: string;
+};
+export type InstallConfigResult = MergePiStudioOpencodeConfigResult & {
+    configPath: string;
+    scope: "user" | "project" | "explicit";
+};
+export declare function installPiStudioOpencode(options: InstallOptions): Promise<InstallConfigResult>;
+export declare function parseInstallArgs(argv: string[]): InstallOptions;
+export declare function runInstallCli(argv: string[]): Promise<void>;
+export {};