@maniclang/workbench 0.1.11

package/dist/server/engineInstall.js

@@ -0,0 +1,228 @@
+import { spawn } from "node:child_process";
+import { createWriteStream } from "node:fs";
+import { chmod, mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { homedir, platform, tmpdir } from "node:os";
+import { join } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
+import { defaultBinaryPath, discoverInstalledManic } from "./enginePaths.js";
+const INSTALL_SH = "https://raw.githubusercontent.com/maniclang-x/manic/main/install.sh";
+const INSTALL_PS1 = "https://raw.githubusercontent.com/maniclang-x/manic/main/install.ps1";
+const DOCS_URL = "https://github.com/maniclang-x/manic/blob/main/INSTALL.md";
+const RELEASES_URL = "https://github.com/maniclang-x/manic/releases";
+let installInFlight = null;
+export async function getEngineInstallPlan(channel) {
+    const host = hostPlatform();
+    const arch = process.arch;
+    const brew = host === "darwin" ? await commandExists("brew") : false;
+    const methods = [];
+    if (host === "darwin" || host === "linux") {
+        methods.push({
+            id: "script",
+            label: "Official installer",
+            description: `Download and run install.sh for the ${channel} channel into ~/.local.`,
+            available: true,
+            detail: null,
+        });
+    }
+    if (host === "win32") {
+        methods.push({
+            id: "script",
+            label: "Official installer",
+            description: `Download and run install.ps1 for the ${channel} channel into %LOCALAPPDATA%\\Manic.`,
+            available: true,
+            detail: null,
+        });
+    }
+    if (host === "darwin") {
+        methods.push({
+            id: "brew",
+            label: "Homebrew cask",
+            description: "Install maniclang-x/tap/manic (Apple Silicon; includes ffmpeg).",
+            available: brew,
+            detail: brew ? null : "Homebrew was not found on PATH.",
+        });
+    }
+    if (host === "unsupported") {
+        methods.push({
+            id: "script",
+            label: "Official installer",
+            description: "This platform is not supported by the Workbench installer yet.",
+            available: false,
+            detail: `Unsupported platform: ${platform()}`,
+        });
+    }
+    const discoveredBinary = await discoverInstalledManic();
+    return {
+        platform: host,
+        arch,
+        methods,
+        channel,
+        docsUrl: DOCS_URL,
+        releasesUrl: RELEASES_URL,
+        manualCommand: manualCommand(host, channel),
+        defaultBinaryHint: defaultBinaryPath(),
+        discoveredBinary,
+    };
+}
+export async function installManicEngine(options) {
+    if (installInFlight)
+        throw new Error("A Manic install is already running.");
+    installInFlight = runInstall(options).finally(() => { installInFlight = null; });
+    return installInFlight;
+}
+async function runInstall(options) {
+    const channel = options.channel === "stable" ? "stable" : "latest";
+    let log = "";
+    try {
+        if (options.method === "brew") {
+            log = await runBrewInstall();
+        }
+        else if (options.method === "script") {
+            log = await runOfficialScript(channel);
+        }
+        else {
+            throw new Error("Choose a supported Manic install method.");
+        }
+        const binaryPath = await discoverInstalledManic();
+        const ok = Boolean(binaryPath);
+        return {
+            ok,
+            method: options.method,
+            channel,
+            log: appendHint(log, binaryPath, ok),
+            binaryPath,
+            suggestedEnginePath: !options.currentEnginePath?.trim() && binaryPath ? binaryPath : null,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const binaryPath = await discoverInstalledManic();
+        return {
+            ok: false,
+            method: options.method,
+            channel,
+            log: `${log}${log ? "\n" : ""}${message}`.trim(),
+            binaryPath,
+            suggestedEnginePath: null,
+        };
+    }
+}
+async function runOfficialScript(channel) {
+    const host = hostPlatform();
+    if (host === "unsupported")
+        throw new Error("This operating system is not supported by the Manic installer yet.");
+    const directory = await mkdtemp(join(tmpdir(), "manic-workbench-install-"));
+    try {
+        if (host === "win32") {
+            const scriptPath = join(directory, "install.ps1");
+            await downloadToFile(INSTALL_PS1, scriptPath);
+            return await runCommand("powershell.exe", ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", scriptPath], { MANIC_CHANNEL: channel }, 10 * 60_000);
+        }
+        const scriptPath = join(directory, "install.sh");
+        await downloadToFile(INSTALL_SH, scriptPath);
+        await chmod(scriptPath, 0o700);
+        const prefix = join(homedir(), ".local");
+        await mkdir(join(prefix, "bin"), { recursive: true, mode: 0o755 });
+        return await runCommand("/bin/sh", [scriptPath], { MANIC_CHANNEL: channel, MANIC_INSTALL_DIR: prefix }, 10 * 60_000);
+    }
+    finally {
+        await rm(directory, { recursive: true, force: true });
+    }
+}
+async function runBrewInstall() {
+    if (hostPlatform() !== "darwin")
+        throw new Error("Homebrew installation is only available on macOS.");
+    if (!(await commandExists("brew")))
+        throw new Error("Homebrew was not found. Install Homebrew or use the official installer.");
+    return runCommand("brew", ["install", "--cask", "maniclang-x/tap/manic"], {}, 15 * 60_000);
+}
+function manualCommand(host, channel) {
+    if (host === "win32") {
+        return channel === "stable"
+            ? `$env:MANIC_CHANNEL='stable'; irm ${INSTALL_PS1} | iex`
+            : `irm ${INSTALL_PS1} | iex`;
+    }
+    if (host === "darwin" || host === "linux") {
+        return channel === "stable"
+            ? `curl -fsSL ${INSTALL_SH} | MANIC_CHANNEL=stable sh`
+            : `curl -fsSL ${INSTALL_SH} | sh`;
+    }
+    return `See ${DOCS_URL}`;
+}
+function hostPlatform() {
+    const value = platform();
+    if (value === "darwin" || value === "linux" || value === "win32")
+        return value;
+    return "unsupported";
+}
+async function downloadToFile(url, destination) {
+    const response = await fetch(url, { redirect: "follow" });
+    if (!response.ok || !response.body) {
+        throw new Error(`Unable to download the Manic installer (${response.status}).`);
+    }
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("text/html")) {
+        throw new Error("The Manic installer download returned HTML instead of a script.");
+    }
+    await pipeline(Readable.fromWeb(response.body), createWriteStream(destination));
+    const text = await readFile(destination, "utf8");
+    if (text.length < 40 || text.includes("<!DOCTYPE html>")) {
+        throw new Error("The Manic installer script looks invalid.");
+    }
+    // Touch mtime so local antivirus scanners see a complete file.
+    await writeFile(destination, text, { encoding: "utf8" });
+}
+function runCommand(command, arguments_, env, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, arguments_, {
+            shell: false,
+            windowsHide: true,
+            env: { ...process.env, ...env },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let output = "";
+        const collect = (chunk) => {
+            output = `${output}${chunk.toString()}`.slice(-200_000);
+        };
+        const timer = setTimeout(() => {
+            child.kill();
+            reject(new Error(`Manic install timed out after ${Math.round(timeoutMs / 1000)} seconds.`));
+        }, timeoutMs);
+        child.stdout?.on("data", collect);
+        child.stderr?.on("data", collect);
+        child.once("error", (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+        child.once("close", (code) => {
+            clearTimeout(timer);
+            const log = output.trim() || `(no installer output; exit ${code ?? "unknown"})`;
+            if (code === 0)
+                resolve(log);
+            else
+                reject(new Error(`${log}\nInstaller exited with status ${code ?? "unknown"}.`));
+        });
+    });
+}
+async function commandExists(command) {
+    try {
+        await runCommand(platform() === "win32" ? "where.exe" : "/usr/bin/which", [command], {}, 5_000);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function appendHint(log, binaryPath, ok) {
+    const lines = [log];
+    if (binaryPath)
+        lines.push(`Detected Manic at ${binaryPath}.`);
+    if (!ok) {
+        lines.push("Install finished, but Workbench still cannot run Manic. Open a new terminal or set the executable path explicitly.");
+        if (platform() !== "win32")
+            lines.push(`If needed: export PATH="$HOME/.local/bin:$PATH"`);
+    }
+    return lines.filter(Boolean).join("\n");
+}
+//# sourceMappingURL=engineInstall.js.map

package/dist/server/engineInstall.js.map

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

package/dist/server/enginePaths.d.ts

@@ -0,0 +1,3 @@
+export declare function discoverInstalledManic(): Promise<string | null>;
+export declare function candidateManicPaths(): string[];
+export declare function defaultBinaryPath(): string;

package/dist/server/enginePaths.js

@@ -0,0 +1,76 @@
+import { access } from "node:fs/promises";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+export async function discoverInstalledManic() {
+    for (const candidate of candidateManicPaths()) {
+        if (await isExecutable(candidate))
+            return candidate;
+    }
+    return whichCommand("manic");
+}
+export function candidateManicPaths() {
+    const home = homedir();
+    if (platform() === "win32") {
+        const local = process.env.LOCALAPPDATA ?? join(home, "AppData", "Local");
+        return [
+            join(local, "Manic", "bin", "manic.exe"),
+            join(local, "Manic", "bin", "manic"),
+        ];
+    }
+    return [
+        join(home, ".local", "bin", "manic"),
+        "/opt/homebrew/bin/manic",
+        "/usr/local/bin/manic",
+    ];
+}
+export function defaultBinaryPath() {
+    if (platform() === "win32") {
+        const local = process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local");
+        return join(local, "Manic", "bin", "manic.exe");
+    }
+    return join(homedir(), ".local", "bin", "manic");
+}
+async function whichCommand(command) {
+    try {
+        const result = await runCapture(platform() === "win32" ? "where.exe" : "/usr/bin/which", [command], 5_000);
+        const first = result.split(/\r?\n/u).map((line) => line.trim()).find(Boolean);
+        return first || null;
+    }
+    catch {
+        return null;
+    }
+}
+function runCapture(command, arguments_, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, arguments_, { shell: false, windowsHide: true, stdio: ["ignore", "pipe", "pipe"] });
+        let output = "";
+        const timer = setTimeout(() => {
+            child.kill();
+            reject(new Error("which timed out"));
+        }, timeoutMs);
+        child.stdout.on("data", (chunk) => { output += chunk.toString("utf8"); });
+        child.stderr.on("data", () => undefined);
+        child.once("error", (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+        child.once("close", (code) => {
+            clearTimeout(timer);
+            if (code === 0)
+                resolve(output.trim());
+            else
+                reject(new Error("not found"));
+        });
+    });
+}
+async function isExecutable(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=enginePaths.js.map

package/dist/server/enginePaths.js.map

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

package/dist/server/folderPicker.d.ts

@@ -0,0 +1 @@
+export declare function pickFolder(currentFolder: string): Promise<string | null>;

package/dist/server/folderPicker.js

@@ -0,0 +1,54 @@
+import { spawn } from "node:child_process";
+import { platform } from "node:os";
+export async function pickFolder(currentFolder) {
+    if (platform() === "darwin") {
+        const script = [
+            "set chosenFolder to choose folder with prompt \"Open a Manic project\" default location POSIX file " + appleScriptString(currentFolder),
+            "return POSIX path of chosenFolder",
+        ].join("\n");
+        return runPicker("osascript", ["-e", script]);
+    }
+    if (platform() === "win32") {
+        const script = [
+            "Add-Type -AssemblyName System.Windows.Forms",
+            "$dialog = New-Object System.Windows.Forms.FolderBrowserDialog",
+            `$dialog.SelectedPath = '${currentFolder.replaceAll("'", "''")}'`,
+            "$dialog.Description = 'Open a Manic project'",
+            "if ($dialog.ShowDialog() -eq 'OK') { $dialog.SelectedPath }",
+        ].join("; ");
+        return runPicker("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script]);
+    }
+    const zenity = await runPicker("zenity", ["--file-selection", "--directory", "--title=Open a Manic project", `--filename=${currentFolder}/`], true);
+    if (zenity !== null)
+        return zenity;
+    return runPicker("kdialog", ["--getexistingdirectory", currentFolder, "--title", "Open a Manic project"], true);
+}
+function appleScriptString(value) {
+    return `\"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}\"`;
+}
+function runPicker(command, arguments_, missingIsCancel = false) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, arguments_, { shell: false, stdio: ["ignore", "pipe", "pipe"] });
+        let output = "";
+        let errorOutput = "";
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => { output += chunk; });
+        child.stderr.on("data", (chunk) => { errorOutput += chunk; });
+        child.once("error", (error) => {
+            if (missingIsCancel && error.code === "ENOENT")
+                resolve(null);
+            else
+                reject(error);
+        });
+        child.once("close", (code) => {
+            if (code === 0)
+                resolve(output.trim() || null);
+            else if (code === 1)
+                resolve(null);
+            else
+                reject(new Error(errorOutput.trim() || `${command} exited with status ${code}.`));
+        });
+    });
+}
+//# sourceMappingURL=folderPicker.js.map

package/dist/server/folderPicker.js.map

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

package/dist/server/manicAgent.d.ts

@@ -0,0 +1,75 @@
+import type { WorkbenchSettings } from "./settings.js";
+import type { ManicPrompt } from "./promptStore.js";
+import { type EngineCheckResult } from "./engineCheck.js";
+import type { AgentEvent, AgentProposal, AgentRunInput, AgentRunStatus, ModelProvider, ModelRequest, ModelResult } from "./agentProtocol.js";
+export type { AgentEvent, AgentImage, AgentIntent, AgentProposal, AgentRunInput, AgentRunStatus, AgentState, AgentThread, AgentUsage, Candidate, ModelProvider, ModelRequest, ModelResult, ThreadTarget, ThreadTurn, } from "./agentProtocol.js";
+export { AGENT_PROTOCOL_VERSION, CANDIDATE_SCHEMA } from "./agentProtocol.js";
+export interface AgentRunResult {
+    id: string;
+    status: Exclude<AgentRunStatus, "running">;
+    message: string;
+    proposal: AgentProposal | null;
+    baseContent: string;
+    validation: EngineCheckResult & {
+        attempts: number;
+    };
+    events: AgentEvent[];
+    prompt: Pick<ManicPrompt, "version" | "source" | "fetchedAt">;
+    usage: {
+        inputTokens: number | null;
+        outputTokens: number | null;
+        totalTokens: number | null;
+    };
+}
+export type AiReasoningEffort = "none" | "low" | "medium" | "high" | "xhigh";
+export type EngineChecker = (workspace: string, file: string, settings: WorkbenchSettings, engineOverride?: string, signal?: AbortSignal) => Promise<EngineCheckResult>;
+export declare class OpenAiProvider implements ModelProvider {
+    private readonly apiKey;
+    private readonly model;
+    private readonly reasoning;
+    private readonly fetcher;
+    constructor(apiKey: string, model: string, reasoning?: AiReasoningEffort, fetcher?: typeof fetch);
+    generate(request: ModelRequest, signal?: AbortSignal): Promise<ModelResult>;
+}
+/**
+ * Talks to any OpenAI-compatible Chat Completions endpoint — Ollama, LM Studio,
+ * vLLM, llama.cpp server, or a remote proxy. Unlike the official OpenAI
+ * Responses API, `${baseUrl}/chat/completions` is the compatibility surface
+ * every local runtime implements. The API key is optional because most local
+ * servers accept unauthenticated requests.
+ */
+export declare class OpenAiCompatibleProvider implements ModelProvider {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly model;
+    private readonly fetcher;
+    constructor(baseUrl: string, apiKey: string, model: string, fetcher?: typeof fetch);
+    generate(request: ModelRequest, signal?: AbortSignal): Promise<ModelResult>;
+}
+export declare class AnthropicProvider implements ModelProvider {
+    private readonly apiKey;
+    private readonly model;
+    private readonly reasoning;
+    private readonly fetcher;
+    constructor(apiKey: string, model: string, reasoning?: AiReasoningEffort, fetcher?: typeof fetch);
+    generate(request: ModelRequest, signal?: AbortSignal): Promise<ModelResult>;
+}
+export declare function runManicAgent(options: {
+    workspace: string;
+    settings: WorkbenchSettings;
+    engineOverride?: string;
+    prompt: ManicPrompt;
+    provider: ModelProvider;
+    input: AgentRunInput;
+    /** Compressed authorship-thread history; omit for single-shot runs. */
+    conversation?: string;
+    signal?: AbortSignal;
+    maxRepairAttempts?: number;
+    onEvent?: (event: AgentEvent) => void;
+    check?: EngineChecker;
+    /** Deterministic local auto-correct tried before a model repair round. */
+    autofix?: (content: string, signal?: AbortSignal) => Promise<{
+        code: string;
+        fixed: number;
+    } | null>;
+}): Promise<AgentRunResult>;