@maniclang/workbench 0.1.11

package/dist/server/agentRuns.js

@@ -0,0 +1,138 @@
+import { runManicAgent, } from "./manicAgent.js";
+export class AgentRunManager {
+    runs = new Map();
+    start(options) {
+        if ([...this.runs.values()].some((run) => run.status === "running")) {
+            throw new Error("Finish or cancel the current AI run before starting another one.");
+        }
+        const controller = new AbortController();
+        const placeholderId = `agent_pending_${Date.now()}`;
+        const record = {
+            id: placeholderId,
+            status: "running",
+            message: "Starting Manic AI…",
+            proposal: null,
+            baseContent: "",
+            validation: { ok: false, exitCode: null, output: "The run has not finished checking yet.", attempts: 0 },
+            events: [],
+            prompt: {
+                version: options.prompt.version,
+                source: options.prompt.source,
+                fetchedAt: options.prompt.fetchedAt,
+            },
+            usage: { inputTokens: null, outputTokens: null, totalTokens: null },
+            startedAt: Date.now(),
+            finishedAt: null,
+            controller,
+        };
+        const onEvent = (event) => {
+            record.events = [...record.events, event];
+            if (event.state === "fetching_context" || event.state === "generating" || event.state === "checking" || event.state === "repairing") {
+                record.message = event.message;
+            }
+        };
+        // Kick off asynchronously; HTTP returns the live view immediately.
+        void runManicAgent({
+            workspace: options.workspace,
+            settings: options.settings,
+            engineOverride: options.engineOverride,
+            prompt: options.prompt,
+            provider: options.provider,
+            input: options.input,
+            conversation: options.conversation,
+            signal: controller.signal,
+            check: options.check,
+            autofix: options.autofix,
+            maxRepairAttempts: options.maxRepairAttempts,
+            onEvent,
+        }).then(async (result) => {
+            await notifyFinished(options.onFinished, result);
+            this.applyResult(record, result);
+        }).catch(async (error) => {
+            const message = error instanceof Error ? error.message : "The Manic AI run failed.";
+            const failure = {
+                id: record.id,
+                status: "failed",
+                message,
+                proposal: null,
+                baseContent: "",
+                validation: { ok: false, exitCode: null, output: message, attempts: 0 },
+                events: [...record.events, { state: "failed", message, at: Date.now() }],
+                prompt: {
+                    version: options.prompt.version,
+                    source: options.prompt.source,
+                    fetchedAt: options.prompt.fetchedAt,
+                },
+                usage: record.usage,
+            };
+            await notifyFinished(options.onFinished, failure);
+            record.status = "failed";
+            record.message = message;
+            record.finishedAt = Date.now();
+            record.events = failure.events;
+        });
+        // Replace placeholder id once the agent assigns a stable id via first event path.
+        // Until then keep the temporary id for polling; swap when result arrives.
+        this.runs.set(record.id, record);
+        // Bridge: watch for id from result through a microtask after start — also expose alias.
+        // We patch id when applyResult runs. For immediate polls, temporary id works.
+        return publicRun(record);
+    }
+    get(id) {
+        const run = this.runs.get(id) ?? [...this.runs.values()].find((item) => item.id === id) ?? null;
+        return run ? publicRun(run) : null;
+    }
+    cancel(id) {
+        const run = this.runs.get(id) ?? [...this.runs.values()].find((item) => item.id === id);
+        if (!run)
+            throw new Error("That AI run was not found.");
+        if (run.status === "running") {
+            run.message = "Cancelling…";
+            run.controller.abort();
+        }
+        return publicRun(run);
+    }
+    applyResult(record, result) {
+        const previousId = record.id;
+        record.id = result.id;
+        record.status = result.status;
+        record.message = result.message;
+        record.proposal = result.proposal;
+        record.baseContent = result.baseContent;
+        record.validation = result.validation;
+        record.events = result.events;
+        record.prompt = result.prompt;
+        record.usage = result.usage;
+        record.finishedAt = Date.now();
+        if (previousId !== result.id) {
+            this.runs.delete(previousId);
+            this.runs.set(result.id, record);
+            // Keep temporary id aliased until clients finish polling.
+            this.runs.set(previousId, record);
+        }
+    }
+}
+async function notifyFinished(onFinished, result) {
+    try {
+        await onFinished?.(result);
+    }
+    catch (error) {
+        console.error("Agent run completion hook failed:", error);
+    }
+}
+function publicRun(run) {
+    return {
+        id: run.id,
+        status: run.status,
+        message: run.message,
+        proposal: run.proposal,
+        baseContent: run.baseContent,
+        validation: run.validation,
+        events: run.events,
+        prompt: run.prompt,
+        usage: run.usage,
+        startedAt: run.startedAt,
+        finishedAt: run.finishedAt,
+    };
+}
+//# sourceMappingURL=agentRuns.js.map

package/dist/server/agentRuns.js.map

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

package/dist/server/agentThreads.d.ts

@@ -0,0 +1,20 @@
+import { type AgentThread, type ThreadTarget, type ThreadTurn } from "./agentProtocol.js";
+export declare class ThreadNotFoundError extends Error {
+}
+export declare function createThread(workspace: string, target: ThreadTarget): Promise<AgentThread>;
+export declare function getThread(workspace: string, threadId: string): Promise<AgentThread>;
+export declare function listThreads(workspace: string): Promise<AgentThread[]>;
+export declare function removeThread(workspace: string, threadId: string): Promise<void>;
+export declare function appendTurn(workspace: string, threadId: string, turn: ThreadTurn): Promise<AgentThread>;
+/**
+ * Records that a turn's proposal was saved to disk. From this point the
+ * written revision is the thread's baseline; a draft-bound thread rebinds to
+ * the created file so the next turn refines it instead of creating again.
+ */
+export declare function recordApply(workspace: string, threadId: string, runId: string, path: string, revision: string): Promise<AgentThread>;
+/**
+ * Builds the compressed steering context for the next turn. Pure function so
+ * the policy is directly testable. `currentRevision` is the revision of the
+ * target document as it exists on disk right now (null for unborn drafts).
+ */
+export declare function buildConversation(thread: AgentThread, currentRevision: string | null): string;

package/dist/server/agentThreads.js

@@ -0,0 +1,205 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, readdir, rename, unlink, writeFile } from "node:fs/promises";
+import { extname, join } from "node:path";
+import { AGENT_PROTOCOL_VERSION, } from "./agentProtocol.js";
+/**
+ * Authorship-thread persistence. A thread is one JSON sidecar file under the
+ * workspace, following the render-job pattern: no database, atomic writes,
+ * and the file is a record — the on-disk `.manic` document stays the ground
+ * truth for every turn.
+ *
+ * The directory name must keep the `.manic-workbench-` prefix so the
+ * workspace file walk ignores it.
+ */
+const THREADS_DIRECTORY = ".manic-workbench-threads";
+const THREAD_ID_PATTERN = /^thread_[a-f0-9]{32}$/u;
+export class ThreadNotFoundError extends Error {
+}
+export async function createThread(workspace, target) {
+    validateTarget(target);
+    const now = Date.now();
+    const thread = {
+        protocolVersion: AGENT_PROTOCOL_VERSION,
+        threadId: `thread_${randomUUID().replaceAll("-", "")}`,
+        target,
+        turns: [],
+        lastAppliedRevision: null,
+        createdAt: now,
+        updatedAt: now,
+    };
+    await persist(workspace, thread);
+    return thread;
+}
+export async function getThread(workspace, threadId) {
+    const raw = await readFile(threadFile(workspace, threadId), "utf8").catch(() => null);
+    if (raw === null)
+        throw new ThreadNotFoundError("That authorship thread was not found.");
+    const thread = parseThread(raw);
+    if (!thread || thread.threadId !== threadId)
+        throw new ThreadNotFoundError("That authorship thread is not readable.");
+    return thread;
+}
+export async function listThreads(workspace) {
+    const entries = await readdir(join(workspace, THREADS_DIRECTORY)).catch(() => []);
+    const threads = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".json") || !THREAD_ID_PATTERN.test(entry.slice(0, -".json".length)))
+            continue;
+        const raw = await readFile(join(workspace, THREADS_DIRECTORY, entry), "utf8").catch(() => null);
+        const thread = raw === null ? null : parseThread(raw);
+        if (thread)
+            threads.push(thread);
+    }
+    return threads.sort((left, right) => right.updatedAt - left.updatedAt);
+}
+export async function removeThread(workspace, threadId) {
+    await getThread(workspace, threadId);
+    await unlink(threadFile(workspace, threadId));
+}
+export async function appendTurn(workspace, threadId, turn) {
+    const thread = await getThread(workspace, threadId);
+    thread.turns.push(validateTurn(turn));
+    thread.updatedAt = Date.now();
+    await persist(workspace, thread);
+    return thread;
+}
+/**
+ * Records that a turn's proposal was saved to disk. From this point the
+ * written revision is the thread's baseline; a draft-bound thread rebinds to
+ * the created file so the next turn refines it instead of creating again.
+ */
+export async function recordApply(workspace, threadId, runId, path, revision) {
+    const thread = await getThread(workspace, threadId);
+    const turn = thread.turns.find((item) => item.runId === runId);
+    if (!turn)
+        throw new Error("That run is not a turn in this thread.");
+    if (turn.status !== "ready")
+        throw new Error("Only a Manic-validated turn can be applied.");
+    turn.appliedRevision = revision;
+    thread.lastAppliedRevision = revision;
+    thread.target = { kind: "file", path };
+    thread.updatedAt = Date.now();
+    await persist(workspace, thread);
+    return thread;
+}
+const RECENT_TURNS = 3;
+const RECENT_MESSAGE_LIMIT = 2_000;
+const SUMMARY_LIMIT = 1_000;
+const OLDER_LINE_LIMIT = 200;
+const CONVERSATION_LIMIT = 12_000;
+/**
+ * Builds the compressed steering context for the next turn. Pure function so
+ * the policy is directly testable. `currentRevision` is the revision of the
+ * target document as it exists on disk right now (null for unborn drafts).
+ */
+export function buildConversation(thread, currentRevision) {
+    const sections = [];
+    if (thread.lastAppliedRevision !== null
+        && currentRevision !== null
+        && currentRevision !== thread.lastAppliedRevision) {
+        sections.push("Note: the document was edited outside this conversation after the last applied proposal. "
+            + "The current document source is authoritative; earlier statements in this conversation may no longer describe it.");
+    }
+    const older = thread.turns.slice(0, -RECENT_TURNS);
+    if (older.length) {
+        sections.push([
+            "Earlier turns (summarized):",
+            ...older.map((turn) => `- [${turn.status}] "${truncate(turn.userMessage, OLDER_LINE_LIMIT)}" → ${truncate(turn.proposalSummary, OLDER_LINE_LIMIT)}`),
+        ].join("\n"));
+    }
+    for (const turn of thread.turns.slice(-RECENT_TURNS)) {
+        sections.push(`User: ${truncate(turn.userMessage, RECENT_MESSAGE_LIMIT)}\nAgent (${turn.status}${turn.appliedRevision ? ", applied" : ", not applied"}): ${truncate(turn.proposalSummary, SUMMARY_LIMIT)}`);
+    }
+    return truncate(sections.join("\n\n"), CONVERSATION_LIMIT);
+}
+function truncate(value, limit) {
+    const flat = value.replaceAll(/\s+/gu, " ").trim();
+    return flat.length <= limit ? flat : `${flat.slice(0, limit - 1)}…`;
+}
+async function persist(workspace, thread) {
+    const directory = join(workspace, THREADS_DIRECTORY);
+    await mkdir(directory, { mode: 0o700, recursive: true });
+    const file = threadFile(workspace, thread.threadId);
+    const temporary = join(directory, `.${thread.threadId}-${randomUUID()}.tmp`);
+    try {
+        await writeFile(temporary, `${JSON.stringify(thread, null, 2)}\n`, { encoding: "utf8", flag: "wx", mode: 0o600 });
+        await rename(temporary, file);
+    }
+    catch (error) {
+        await unlink(temporary).catch(() => undefined);
+        throw error;
+    }
+}
+function threadFile(workspace, threadId) {
+    if (!THREAD_ID_PATTERN.test(threadId))
+        throw new ThreadNotFoundError("That authorship thread was not found.");
+    return join(workspace, THREADS_DIRECTORY, `${threadId}.json`);
+}
+function validateTarget(target) {
+    if (target.kind === "file")
+        validateRelativeManicPath(target.path);
+    else if (target.kind === "draft")
+        validateRelativeManicPath(target.draftName);
+    else
+        throw new Error("A thread target must be an existing file or a named draft.");
+}
+function validateRelativeManicPath(path) {
+    if (typeof path !== "string"
+        || !path
+        || path.includes("\0")
+        || path.startsWith("/")
+        || path.replaceAll("\\", "/").split("/").some((part) => !part || part === "." || part === "..")
+        || extname(path).toLowerCase() !== ".manic") {
+        throw new Error("Thread targets must be relative .manic files inside the selected project.");
+    }
+}
+function validateTurn(turn) {
+    if (!turn || typeof turn.runId !== "string" || !turn.runId)
+        throw new Error("A thread turn requires its run id.");
+    if (typeof turn.userMessage !== "string" || typeof turn.proposalSummary !== "string")
+        throw new Error("A thread turn requires the user message and proposal summary.");
+    if (!["ready", "failed", "cancelled"].includes(turn.status))
+        throw new Error("A thread turn requires a finished run status.");
+    return {
+        runId: turn.runId,
+        userMessage: turn.userMessage,
+        proposalSummary: turn.proposalSummary,
+        status: turn.status,
+        appliedRevision: turn.appliedRevision ?? null,
+        at: typeof turn.at === "number" ? turn.at : Date.now(),
+    };
+}
+function parseThread(raw) {
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!value || typeof value !== "object")
+        return null;
+    const thread = value;
+    if (typeof thread.threadId !== "string" || !THREAD_ID_PATTERN.test(thread.threadId))
+        return null;
+    if (typeof thread.protocolVersion !== "number" || thread.protocolVersion > AGENT_PROTOCOL_VERSION)
+        return null;
+    if (!thread.target || typeof thread.target !== "object" || !Array.isArray(thread.turns))
+        return null;
+    try {
+        validateTarget(thread.target);
+    }
+    catch {
+        return null;
+    }
+    return {
+        protocolVersion: thread.protocolVersion,
+        threadId: thread.threadId,
+        target: thread.target,
+        turns: thread.turns.map((turn) => validateTurn(turn)),
+        lastAppliedRevision: typeof thread.lastAppliedRevision === "string" ? thread.lastAppliedRevision : null,
+        createdAt: typeof thread.createdAt === "number" ? thread.createdAt : Date.now(),
+        updatedAt: typeof thread.updatedAt === "number" ? thread.updatedAt : Date.now(),
+    };
+}
+//# sourceMappingURL=agentThreads.js.map

package/dist/server/agentThreads.js.map

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

package/dist/server/aiSecrets.d.ts

@@ -0,0 +1,21 @@
+export type AiSecretSource = "environment" | "session" | "none";
+export interface AiSecretEntryStatus {
+    key: string;
+    configured: boolean;
+    source: AiSecretSource;
+}
+export interface AiSecretStatus {
+    entries: AiSecretEntryStatus[];
+}
+export interface AiSecretStore {
+    status(): AiSecretStatus;
+    get(key: string): string;
+    set(key: string, value: string): void;
+    clear(key: string): void;
+    /** Convenience for the OpenAI adapter. */
+    openAiKey(): string;
+    anthropicKey(): string;
+}
+export declare const KNOWN_AI_SECRET_KEYS: readonly ["OPENAI_API_KEY", "ANTHROPIC_API_KEY"];
+export declare function createAiSecretStore(environment?: NodeJS.ProcessEnv): AiSecretStore;
+export declare function normalizeSecretName(value: string): string;

package/dist/server/aiSecrets.js

@@ -0,0 +1,68 @@
+export const KNOWN_AI_SECRET_KEYS = ["OPENAI_API_KEY", "ANTHROPIC_API_KEY"];
+const ENVIRONMENT_ALIASES = {
+    OPENAI_API_KEY: ["OPENAI_API_KEY"],
+    ANTHROPIC_API_KEY: ["ANTHROPIC_API_KEY"],
+};
+export function createAiSecretStore(environment = process.env) {
+    const environmentKeys = new Map();
+    for (const [canonical, aliases] of Object.entries(ENVIRONMENT_ALIASES)) {
+        for (const alias of aliases) {
+            const value = normalizedKey(environment[alias] ?? "", { allowEmpty: true });
+            if (value) {
+                environmentKeys.set(canonical, value);
+                break;
+            }
+        }
+    }
+    const sessionKeys = new Map();
+    return {
+        status() {
+            const keys = new Set([...KNOWN_AI_SECRET_KEYS, ...sessionKeys.keys(), ...environmentKeys.keys()]);
+            return {
+                entries: [...keys].sort().map((key) => {
+                    if (sessionKeys.has(key))
+                        return { key, configured: true, source: "session" };
+                    if (environmentKeys.has(key))
+                        return { key, configured: true, source: "environment" };
+                    return { key, configured: false, source: "none" };
+                }),
+            };
+        },
+        get(key) {
+            const normalized = normalizeSecretName(key);
+            return sessionKeys.get(normalized) ?? environmentKeys.get(normalized) ?? "";
+        },
+        set(key, value) {
+            const normalized = normalizeSecretName(key);
+            sessionKeys.set(normalized, normalizedKey(value));
+        },
+        clear(key) {
+            sessionKeys.delete(normalizeSecretName(key));
+        },
+        openAiKey() { return this.get("OPENAI_API_KEY"); },
+        anthropicKey() { return this.get("ANTHROPIC_API_KEY"); },
+    };
+}
+export function normalizeSecretName(value) {
+    const key = value.trim().toUpperCase();
+    if (!key)
+        throw new Error("Secret key is required.");
+    if (key.length > 64)
+        throw new Error("Secret key is too long.");
+    if (!/^[A-Z][A-Z0-9_]*$/u.test(key)) {
+        throw new Error("Secret keys must look like ENV_NAMES, for example OPENAI_API_KEY.");
+    }
+    return key;
+}
+function normalizedKey(value, options) {
+    const key = value.trim();
+    if (!key) {
+        if (options?.allowEmpty)
+            return "";
+        throw new Error("Enter a valid API key.");
+    }
+    if (key.length < 12 || key.length > 512 || /\s/u.test(key))
+        throw new Error("Enter a valid API key.");
+    return key;
+}
+//# sourceMappingURL=aiSecrets.js.map

package/dist/server/aiSecrets.js.map

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

package/dist/server/app.d.ts

@@ -0,0 +1,34 @@
+import { Hono } from "hono";
+import type { ManicAssetKind } from "@maniclang/scene";
+import type { Diagnostics } from "./diagnostics.js";
+import { type SettingsStore, type WorkbenchSettings } from "./settings.js";
+import { type AiSecretStore } from "./aiSecrets.js";
+import { type CandidateFixer } from "./candidateFix.js";
+import { type EngineChecker, type ModelProvider } from "./manicAgent.js";
+import { type PromptStore } from "./promptStore.js";
+import { type SmartDrawEngineRunner } from "./smartDraw.js";
+export interface WorkbenchContext {
+    token: string;
+    workspace: string;
+    clientRoot: string;
+    version: string;
+    settingsStore: SettingsStore;
+    diagnostics(settings: WorkbenchSettings): Promise<Diagnostics>;
+    pickWorkspace?(currentWorkspace: string): Promise<string | null>;
+    engineOverride?: string;
+    aiSecrets?: AiSecretStore;
+    promptStore?: PromptStore;
+    /** Test seam for preview, manual, and agent-run validation; defaults to the installed engine. */
+    engineCheck?: EngineChecker;
+    /** Test seam for engine-owned Smart Draw inspection and manifest authoring. */
+    smartDrawRunner?: SmartDrawEngineRunner;
+    /** Host boundary for a checked native preview; defaults to RenderJobManager launching Manic. */
+    launchPreview?(workspace: string, file: string, settings: WorkbenchSettings): Promise<void>;
+    /** Test seam for the local candidate autofix; defaults to engine `manic fix` with WASM fallback. */
+    candidateAutofix?: CandidateFixer;
+    openAiProvider?(apiKey: string, model: string, reasoning: WorkbenchSettings["ai"]["reasoning"]): ModelProvider;
+    openAiCompatibleProvider?(baseUrl: string, apiKey: string, model: string): ModelProvider;
+    anthropicProvider?(apiKey: string, model: string, reasoning: WorkbenchSettings["ai"]["reasoning"]): ModelProvider;
+}
+export declare function createApp(context: WorkbenchContext): Hono;
+export declare function parseAssetKind(value: string | undefined): ManicAssetKind | "all";