devsmind-mcp 2.4.0 → 3.0.0

package/dist/cli/llm-client.js

@@ -0,0 +1,322 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveLlmCredentials = resolveLlmCredentials;
+exports.sendPrompt = sendPrompt;
+exports.sendPromptWithRetry = sendPromptWithRetry;
+exports.buildGeminiContents = buildGeminiContents;
+exports.buildGeminiTools = buildGeminiTools;
+exports.parseGeminiParts = parseGeminiParts;
+exports.buildOllamaMessages = buildOllamaMessages;
+exports.buildOllamaTools = buildOllamaTools;
+exports.parseOllamaMessage = parseOllamaMessage;
+exports.sendConversationTurn = sendConversationTurn;
+exports.sendConversationTurnWithRetry = sendConversationTurnWithRetry;
+const fs = __importStar(require("fs"));
+const crypto = __importStar(require("crypto"));
+const runner_1 = require("./runner");
+const json_1 = require("../utils/json");
+/**
+ * Resolves credentials for a provider from an explicit `--key`/`--url` or the environment,
+ * mirroring the precedence `runBackgroundIndexing`/`runBackgroundReindexing` already use —
+ * but THROWS instead of calling `process.exit`, so a library caller (like `devsmind describe`)
+ * can catch it and decide how to report the failure itself, rather than the process dying
+ * inside a function with no return value.
+ */
+function resolveLlmCredentials(opts) {
+    if (opts.provider === 'gemini') {
+        const model = opts.model || 'gemini-2.0-flash';
+        const apiKey = opts.key || process.env.GEMINI_API_KEY || '';
+        if (!apiKey)
+            throw new Error('Gemini API key is required. Pass --key or set GEMINI_API_KEY environment variable.');
+        return { provider: 'gemini', model, apiKey };
+    }
+    if (opts.provider === 'vertex') {
+        const model = opts.model || 'gemini-1.5-flash';
+        const inputKey = opts.key || process.env.GOOGLE_APPLICATION_CREDENTIALS || process.env.VERTEX_API_KEY || process.env.GEMINI_API_KEY || '';
+        if (!inputKey) {
+            throw new Error('Vertex AI requires a Service Account JSON path or Bearer Token. Pass --key or set GOOGLE_APPLICATION_CREDENTIALS / VERTEX_API_KEY environment variable.');
+        }
+        let vertexSaData = null;
+        try {
+            if (inputKey.trim().startsWith('{')) {
+                vertexSaData = JSON.parse(inputKey);
+            }
+            else if (fs.existsSync(inputKey)) {
+                vertexSaData = JSON.parse(fs.readFileSync(inputKey, 'utf-8'));
+            }
+        }
+        catch {
+            // Treat as a raw token below.
+        }
+        const vertexProjectId = vertexSaData?.project_id || process.env.GCP_PROJECT_ID || process.env.VERTEX_PROJECT_ID || '';
+        const vertexLocation = process.env.GCP_LOCATION || process.env.VERTEX_LOCATION || 'us-central1';
+        if (!vertexSaData && !inputKey.startsWith('ya29.')) {
+            throw new Error('Vertex key must be a valid Service Account JSON file path, inline JSON, or raw OAuth access token starting with "ya29."');
+        }
+        if (!vertexProjectId) {
+            throw new Error('Vertex Project ID could not be determined. Please set GCP_PROJECT_ID environment variable or specify it in your service account JSON.');
+        }
+        return {
+            provider: 'vertex',
+            model,
+            vertexSaData: vertexSaData || undefined,
+            vertexToken: vertexSaData ? undefined : inputKey,
+            vertexProjectId,
+            vertexLocation
+        };
+    }
+    // ollama
+    return { provider: 'ollama', model: opts.model || 'qwen2.5-coder', url: opts.url || 'http://localhost:11434' };
+}
+/** One prompt round-trip to whichever provider `creds` resolved to. Every provider is asked
+ * for a raw JSON response (no markdown fences) — callers parse with `safeJsonParse`, which
+ * already tolerates a fenced or slightly truncated response if a provider ignores that ask. */
+async function sendPrompt(creds, systemPrompt, userPrompt) {
+    if (creds.provider === 'gemini') {
+        const url = `https://generativelanguage.googleapis.com/v1beta/models/${creds.model}:generateContent?key=${creds.apiKey}`;
+        const payload = {
+            contents: [{ parts: [{ text: userPrompt }] }],
+            systemInstruction: { parts: [{ text: systemPrompt }] },
+            generationConfig: { responseMimeType: 'application/json' }
+        };
+        const responseText = await (0, runner_1.makeHttpRequest)(url, 'POST', { 'Content-Type': 'application/json' }, JSON.stringify(payload));
+        const parsed = (0, json_1.safeJsonParse)(responseText, {});
+        return parsed.candidates?.[0]?.content?.parts?.[0]?.text || '';
+    }
+    if (creds.provider === 'vertex') {
+        const token = creds.vertexToken || await (0, runner_1.getVertexTokenCached)(creds.vertexSaData);
+        const url = `https://${creds.vertexLocation}-aiplatform.googleapis.com/v1/projects/${creds.vertexProjectId}/locations/${creds.vertexLocation}/publishers/google/models/${creds.model}:generateContent`;
+        const payload = {
+            contents: [{ role: 'user', parts: [{ text: userPrompt }] }],
+            systemInstruction: { parts: [{ text: systemPrompt }] },
+            generationConfig: { responseMimeType: 'application/json' }
+        };
+        const responseText = await (0, runner_1.makeHttpRequest)(url, 'POST', { 'Content-Type': 'application/json', 'Authorization': `Bearer ${token}` }, JSON.stringify(payload));
+        const parsed = (0, json_1.safeJsonParse)(responseText, {});
+        return parsed.candidates?.[0]?.content?.parts?.[0]?.text || '';
+    }
+    // ollama
+    const endpoint = `${(creds.url || 'http://localhost:11434').replace(/\/$/, '')}/api/chat`;
+    const payload = {
+        model: creds.model,
+        messages: [
+            { role: 'system', content: systemPrompt },
+            { role: 'user', content: userPrompt }
+        ],
+        stream: false,
+        format: 'json'
+    };
+    const responseText = await (0, runner_1.makeHttpRequest)(endpoint, 'POST', { 'Content-Type': 'application/json' }, JSON.stringify(payload));
+    const parsed = (0, json_1.safeJsonParse)(responseText, {});
+    return parsed.message?.content || '';
+}
+/**
+ * `sendPrompt` with a small, independent retry — deliberately NOT the 5-attempt/`ProgressDisplay`
+ * -coupled retry loop `extractNodesFromCode` uses; this caller has no TTY progress bar to update,
+ * so it just logs via `onRetry` and backs off (longer on a 429, since that means "slow down",
+ * shorter on anything else — a transient network blip is usually gone in a couple seconds).
+ */
+async function sendPromptWithRetry(creds, systemPrompt, userPrompt, opts = {}) {
+    const maxAttempts = opts.retries ?? 3;
+    let backoffMs = 5000;
+    let lastErr = null;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await sendPrompt(creds, systemPrompt, userPrompt);
+        }
+        catch (err) {
+            lastErr = err;
+            const isRateLimited = (lastErr.message || '').includes('429');
+            if (attempt < maxAttempts) {
+                opts.onRetry?.(`attempt ${attempt}/${maxAttempts} failed (${lastErr.message}) — retrying in ${isRateLimited ? backoffMs / 1000 : 2}s`);
+                await (0, runner_1.sleep)(isRateLimited ? backoffMs : 2000);
+                if (isRateLimited)
+                    backoffMs *= 2;
+            }
+        }
+    }
+    throw lastErr || new Error('sendPrompt failed after retries');
+}
+// ── Gemini / Vertex (same Generative Language API request/response shape) ──────
+/** Builds the `contents` array for a Gemini/Vertex tool-calling request. Exported so the
+ * translation logic (the actual risk area) is unit-testable without a live call. */
+function buildGeminiContents(messages) {
+    return messages.map(m => {
+        if (m.role === 'user')
+            return { role: 'user', parts: [{ text: m.content }] };
+        if (m.role === 'assistant') {
+            const parts = [];
+            if (m.content)
+                parts.push({ text: m.content });
+            for (const tc of m.toolCalls)
+                parts.push({ functionCall: { name: tc.name, args: tc.args } });
+            return { role: 'model', parts };
+        }
+        // Tool result. Gemini's function-response part carries no call id — it matches the most
+        // recent pending call BY NAME, which is why only one call for a given name should ever be
+        // outstanding at once (the curation loop below satisfies this: it always awaits ALL of a
+        // turn's tool calls before sending the next).
+        let response;
+        try {
+            response = JSON.parse(m.content);
+        }
+        catch {
+            response = { result: m.content };
+        }
+        return { role: 'user', parts: [{ functionResponse: { name: m.toolName, response } }] };
+    });
+}
+/** Builds the `tools` field shared by Gemini and Vertex. */
+function buildGeminiTools(tools) {
+    return [{ functionDeclarations: tools.map(t => ({ name: t.name, description: t.description, parameters: t.parameters })) }];
+}
+/** Parses a Gemini/Vertex `candidates[0].content.parts` array into the provider-agnostic turn
+ * result. A part is either `{text}` or `{functionCall:{name,args}}` — Gemini assigns no id of
+ * its own, so one is minted here purely as a local correlation key for the tool-result message. */
+function parseGeminiParts(parts) {
+    let text = null;
+    const toolCalls = [];
+    for (const p of parts || []) {
+        if (p.text)
+            text = (text ?? '') + p.text;
+        if (p.functionCall)
+            toolCalls.push({ id: crypto.randomUUID(), name: p.functionCall.name, args: p.functionCall.args ?? {} });
+    }
+    return { text, toolCalls };
+}
+async function sendGeminiTurn(model, apiKey, systemPrompt, messages, tools) {
+    const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${apiKey}`;
+    const payload = {
+        contents: buildGeminiContents(messages),
+        systemInstruction: { parts: [{ text: systemPrompt }] },
+        tools: buildGeminiTools(tools)
+    };
+    const responseText = await (0, runner_1.makeHttpRequest)(url, 'POST', { 'Content-Type': 'application/json' }, JSON.stringify(payload));
+    const parsed = (0, json_1.safeJsonParse)(responseText, {});
+    return parseGeminiParts(parsed.candidates?.[0]?.content?.parts || []);
+}
+async function sendVertexTurn(model, token, projectId, location, systemPrompt, messages, tools) {
+    const url = `https://${location}-aiplatform.googleapis.com/v1/projects/${projectId}/locations/${location}/publishers/google/models/${model}:generateContent`;
+    const payload = {
+        contents: buildGeminiContents(messages),
+        systemInstruction: { parts: [{ text: systemPrompt }] },
+        tools: buildGeminiTools(tools)
+    };
+    const responseText = await (0, runner_1.makeHttpRequest)(url, 'POST', { 'Content-Type': 'application/json', 'Authorization': `Bearer ${token}` }, JSON.stringify(payload));
+    const parsed = (0, json_1.safeJsonParse)(responseText, {});
+    return parseGeminiParts(parsed.candidates?.[0]?.content?.parts || []);
+}
+// ── Ollama (OpenAI-style `tools`/`tool_calls`) ──────────────────────────────
+/** Builds the `messages` array for an Ollama tool-calling chat request. */
+function buildOllamaMessages(systemPrompt, messages) {
+    const out = [{ role: 'system', content: systemPrompt }];
+    for (const m of messages) {
+        if (m.role === 'user') {
+            out.push({ role: 'user', content: m.content });
+        }
+        else if (m.role === 'assistant') {
+            out.push({
+                role: 'assistant',
+                content: m.content || '',
+                tool_calls: m.toolCalls.map(tc => ({ function: { name: tc.name, arguments: tc.args } }))
+            });
+        }
+        else {
+            // Ollama's tool-result message has no call-id field to correlate against (same
+            // one-outstanding-call-per-name constraint as Gemini above) — `tool_name` is what ties it
+            // back to the request.
+            out.push({ role: 'tool', tool_name: m.toolName, content: m.content });
+        }
+    }
+    return out;
+}
+/** Builds the OpenAI-style `tools` field Ollama expects. */
+function buildOllamaTools(tools) {
+    return tools.map(t => ({ type: 'function', function: { name: t.name, description: t.description, parameters: t.parameters } }));
+}
+/** Parses an Ollama chat response's `message` into the provider-agnostic turn result. */
+function parseOllamaMessage(message) {
+    const toolCalls = (message.tool_calls || [])
+        .filter(tc => tc.function?.name)
+        .map(tc => ({ id: crypto.randomUUID(), name: tc.function.name, args: tc.function.arguments ?? {} }));
+    return { text: message.content || null, toolCalls };
+}
+async function sendOllamaTurn(url, model, systemPrompt, messages, tools) {
+    const endpoint = `${url.replace(/\/$/, '')}/api/chat`;
+    const payload = {
+        model,
+        messages: buildOllamaMessages(systemPrompt, messages),
+        tools: buildOllamaTools(tools),
+        stream: false
+    };
+    const responseText = await (0, runner_1.makeHttpRequest)(endpoint, 'POST', { 'Content-Type': 'application/json' }, JSON.stringify(payload));
+    const parsed = (0, json_1.safeJsonParse)(responseText, {});
+    return parseOllamaMessage(parsed.message || {});
+}
+/** One turn of a tool-calling conversation with whichever provider `creds` resolved to. */
+async function sendConversationTurn(creds, systemPrompt, messages, tools) {
+    if (creds.provider === 'gemini') {
+        return sendGeminiTurn(creds.model, creds.apiKey, systemPrompt, messages, tools);
+    }
+    if (creds.provider === 'vertex') {
+        const token = creds.vertexToken || await (0, runner_1.getVertexTokenCached)(creds.vertexSaData);
+        return sendVertexTurn(creds.model, token, creds.vertexProjectId, creds.vertexLocation, systemPrompt, messages, tools);
+    }
+    return sendOllamaTurn(creds.url || 'http://localhost:11434', creds.model, systemPrompt, messages, tools);
+}
+/** `sendConversationTurn` with the same retry/backoff shape as `sendPromptWithRetry`. */
+async function sendConversationTurnWithRetry(creds, systemPrompt, messages, tools, opts = {}) {
+    const maxAttempts = opts.retries ?? 3;
+    let backoffMs = 5000;
+    let lastErr = null;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await sendConversationTurn(creds, systemPrompt, messages, tools);
+        }
+        catch (err) {
+            lastErr = err;
+            const isRateLimited = (lastErr.message || '').includes('429');
+            if (attempt < maxAttempts) {
+                opts.onRetry?.(`attempt ${attempt}/${maxAttempts} failed (${lastErr.message}) — retrying in ${isRateLimited ? backoffMs / 1000 : 2}s`);
+                await (0, runner_1.sleep)(isRateLimited ? backoffMs : 2000);
+                if (isRateLimited)
+                    backoffMs *= 2;
+            }
+        }
+    }
+    throw lastErr || new Error('sendConversationTurn failed after retries');
+}
+//# sourceMappingURL=llm-client.js.map

package/dist/cli/llm-client.js.map

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

package/dist/cli/rule.d.ts

@@ -1,16 +1,36 @@
 import { DevMindConfig } from '../utils/config';
+import { WorkflowStyle } from './integrations/prompt';
 /**
  * Build the ready-to-paste DevsMind workspace rule from a project's config.
  * Pure string builder — no I/O — so it can be printed or written to a file.
+ *
+ * `workflowStyle` picks which of two rules gets built:
+ * - `'automatic'` (default): the AI stages, commits, and tracks every edit without being asked —
+ *   the original, still-recommended default for a team's shared graph.
+ * - `'manual'`: the AI uses DevsMind's search/read tools freely (that part is never optional —
+ *   it's why the tool exists) but never stages or commits on its own initiative; the developer
+ *   stays the one deciding what reaches the graph and when. `session_id` (on writes) and `message`
+ *   are still mechanically required by the protocol either way — that's not something a rule can
+ *   opt out of, only WHEN commit_changes gets called is a style choice.
  */
-export declare function buildRule(config: DevMindConfig, devmindDir: string): string;
+export declare function buildRule(config: DevMindConfig, devmindDir: string, workflowStyle?: WorkflowStyle): string;
+/**
+ * A short block meant to be pasted at the START of a fresh AI chat — deliberately separate from
+ * the persistent rule file above. The rule file only helps once the agent actually reads it, and
+ * a long session can lose track of something it read once at the very beginning; this is the
+ * human's manual lever to make a brand-new conversation commit to the rule from its first move,
+ * rather than drifting into using DevsMind slowly (or not at all) over the first few turns.
+ */
+export declare function buildKickoffPrompt(workflowStyle?: WorkflowStyle): string;
 /**
  * `devsmind rule` — print the workspace rule and, interactively, help place it
  * in the chosen tool's native rules file (manual snippet or automatic write).
  * Falls back to plain printing when piped/non-TTY or when `--print` is passed,
- * preserving `devsmind rule > file` usage.
+ * preserving `devsmind rule > file` usage. `--manual` picks the manual workflow
+ * style non-interactively (the fallback path has no prompt to ask with).
  */
 export declare function handleRule(opts: {
     path?: string;
     print?: boolean;
+    manual?: boolean;
 }): Promise<void>;