@webpresso/agent-kit 3.1.30 → 3.2.0

package/dist/esm/cli/commands/init/scaffolders/grok-mcp/index.js

@@ -0,0 +1,73 @@
+/**
+ * `grok-mcp` scaffolder preset.
+ *
+ * Grok Build reads persistent MCP servers from a project-local
+ * `.grok/config.toml`. A project entry *replaces the user entry whole, by
+ * name*, so the managed `[mcp_servers.webpresso]` block owns the webpresso
+ * alias for the repo. The schema mirrors Codex TOML (command/args/env inline
+ * table); we reuse Codex's deterministic per-server upsert so unrelated
+ * `[mcp_servers.*]`, `[plugins]`, and `[permission]` sections are preserved.
+ *
+ * The launcher is resolved to an absolute `bin/wp` path at scaffold time via
+ * the shared {@link resolveWebpressoMcpEntry}; startup only spawns a verified
+ * binary. Env is projected from the one canonical {@link WEBPRESSO_MCP_SPEC}.
+ */
+import { join } from "node:path";
+import { updateScaffolderTextFile } from "#cli/commands/init/scaffolders/file-transaction.js";
+import { agentKitMcpLaunchCommand, resolveWebpressoMcpEntry, WEBPRESSO_MCP_SPEC, } from "#cli/commands/init/mcp-spec.js";
+import { commandMcpHeader, hasAmbiguousMcpServerDottedDefinition, hasManagedMcpServerTableConflict, upsertMcpServerBlock, } from "#cli/commands/init/scaffolders/codex-mcp/index.js";
+export const GROK_CONFIG_RELATIVE_PATH = ".grok/config.toml";
+function tomlString(value) {
+    return JSON.stringify(value);
+}
+function tomlStringArray(values) {
+    return `[${values.map(tomlString).join(", ")}]`;
+}
+function tomlEnvInlineTable(env) {
+    const pairs = Object.entries(env).map(([key, value]) => `${key} = ${tomlString(value)}`);
+    return pairs.length > 0 ? `{ ${pairs.join(", ")} }` : "{}";
+}
+/** Render the managed `[mcp_servers.webpresso]` TOML block for Grok. */
+export function grokWebpressoMcpBlock(entryPath) {
+    const launch = agentKitMcpLaunchCommand(entryPath);
+    const lines = [
+        commandMcpHeader(WEBPRESSO_MCP_SPEC.name),
+        `command = ${tomlString(launch.command)}`,
+        `args = ${tomlStringArray(launch.args)}`,
+        `env = ${tomlEnvInlineTable(WEBPRESSO_MCP_SPEC.env)}`,
+        "enabled = true",
+    ];
+    return `${lines.join("\n")}\n`;
+}
+export function upsertGrokWebpressoMcp(raw, entryPath) {
+    return upsertMcpServerBlock(raw, WEBPRESSO_MCP_SPEC.name, grokWebpressoMcpBlock(entryPath));
+}
+export function ensureGrokWebpressoMcp(input) {
+    const configPath = input.configPath ?? join(input.repoRoot, ".grok", "config.toml");
+    if (input.options.dryRun) {
+        return { kind: "grok-webpresso-mcp-skipped-dry-run", path: configPath };
+    }
+    const resolution = input.entryPath === undefined ? resolveWebpressoMcpEntry(input.probe) : undefined;
+    const entryPath = input.entryPath ?? resolution?.entryPath;
+    if (!entryPath) {
+        const checked = resolution?.checked ?? [];
+        return { kind: "grok-webpresso-mcp-not-installed", path: configPath, checked };
+    }
+    let ambiguous = false;
+    const outcome = updateScaffolderTextFile(configPath, (existing) => {
+        if (hasAmbiguousMcpServerDottedDefinition(existing, WEBPRESSO_MCP_SPEC.name) ||
+            hasManagedMcpServerTableConflict(existing, WEBPRESSO_MCP_SPEC.name)) {
+            ambiguous = true;
+            return existing;
+        }
+        return upsertGrokWebpressoMcp(existing, entryPath);
+    });
+    if (ambiguous) {
+        return { kind: "grok-webpresso-mcp-ambiguous", path: configPath, entryPath };
+    }
+    return {
+        kind: outcome === "written" ? "grok-webpresso-mcp-written" : "grok-webpresso-mcp-unchanged",
+        path: configPath,
+        entryPath,
+    };
+}

package/dist/esm/cli/commands/init/scaffolders/opencode-plugin/index.d.ts

@@ -1,11 +1,29 @@
 import type { MergeOptions } from "#cli/commands/init/merge";
+import { type WebpressoInstallProbe } from "#cli/commands/init/mcp-spec.js";
 export declare const STALE_OPENCODE_HOOK_PLUGIN_RELATIVE_PATH: string;
 export declare const OPENCODE_PLUGIN_SUPPORT_LEVEL = "native-npm";
 export declare const OPENCODE_PLUGIN_PACKAGE = "@webpresso/opencode-plugin";
+export declare const OPENCODE_MCP_SERVER_NAME: "webpresso";
+/**
+ * The canonical OpenCode `mcp.webpresso` entry. OpenCode's local-server shape
+ * folds the launcher and its args into a single `command` array, keys env
+ * under `environment`, and gates activation with `enabled`. Projected from the
+ * one canonical {@link WEBPRESSO_MCP_SPEC}.
+ */
+export declare function opencodeWebpressoMcpEntry(entryPath: string): {
+    type: "local";
+    command: string[];
+    enabled: true;
+    environment: Record<string, string>;
+};
 export interface EnsureOpenCodeWebpressoPluginInput {
     readonly repoRoot: string;
     readonly options: MergeOptions;
     readonly configPath?: string;
+    /** Test seam — override the resolved MCP entry path. */
+    readonly entryPath?: string;
+    /** Test seam — override the install-discovery probe. */
+    readonly probe?: WebpressoInstallProbe;
 }
 export type EnsureOpenCodeWebpressoPluginResult = {
     kind: "opencode-webpresso-plugin-written";
@@ -13,12 +31,15 @@ export type EnsureOpenCodeWebpressoPluginResult = {
     pluginPackage: string;
     removed: readonly string[];
     preserved: readonly string[];
+    /** Absolute wp launcher wired into `mcp.webpresso`, or null when unresolved. */
+    mcpEntryPath: string | null;
 } | {
     kind: "opencode-webpresso-plugin-unchanged";
     path: string;
     pluginPackage: string;
     removed: readonly string[];
     preserved: readonly string[];
+    mcpEntryPath: string | null;
 } | {
     kind: "opencode-webpresso-plugin-skipped-dry-run";
     path: string;