@wascartech/devbot 0.0.0-stage → 2.1.1

package/dist/mcp/tools/_helpers.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { getProject, listTokens } from "../../token-store.js";
+import { listAccessTargets, isAccessAllowed } from "../../access-grant-store.js";
+// Helpers shared by MCP tools. Kept tiny: one success helper, one error helper,
+// and the cross-project scope resolver that every cross-project-capable tool
+// uses before touching GitLab.
+// Shared `project` argument for cross-project-capable tools. Absent = the run's
+// own project; a number = a project id; a string = a path_with_namespace (or a
+// numeric string id). Tools spread this into their inputSchema.
+export const projectArg = z
+    .union([z.number().int().positive(), z.string().min(1).max(255)])
+    .optional()
+    .describe("Target project: a numeric project id or a path_with_namespace. Omit for the current project. " +
+    "Only the current project and projects it has been granted access to are readable.");
+export function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+export function errorResult(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+// Normalize a thrown driver error into a tool error result. An operation the
+// active forge does not support (e.g. GitHub wikis, non-code search scopes)
+// reads as "not supported on this platform" rather than an opaque failure.
+export function toolError(tool, e) {
+    if (e instanceof Error && e.name === "UnsupportedError") {
+        return errorResult(`${tool} failed: not supported on this platform (${e.message}).`);
+    }
+    return errorResult(`${tool} failed: ${e instanceof Error ? e.message : String(e)}`);
+}
+// Resolve an optional client-supplied `project` selector into a project the
+// caller is allowed to read. Scope enforcement lives here, not in GitLab:
+//   - absent            -> the run's own project (always allowed)
+//   - number            -> target id
+//   - string            -> an enrolled project's path_with_namespace
+// Allowed iff it is the run's own project, or a live directed grant
+// (source -> target) exists and the target is still enrolled. The grant is
+// read on every call, so a revoked grant stops working immediately, even
+// mid-session. An unauthorized/unresolvable target returns an error result —
+// the caller must never fall through to a GitLab request.
+export function resolveTargetProject(ctx, selector) {
+    if (selector === undefined || selector === null || selector === "") {
+        const own = getProject(ctx.projectId);
+        if (!own)
+            return { ok: false, message: `Project ${ctx.projectId} is no longer enrolled.` };
+        return { ok: true, target: { projectId: own.projectId, projectPath: own.projectPath } };
+    }
+    let targetId;
+    if (typeof selector === "number") {
+        targetId = selector;
+    }
+    else if (typeof selector === "string") {
+        if (/^\d+$/.test(selector)) {
+            targetId = Number(selector);
+        }
+        else {
+            const p = listTokens().find((t) => t.projectPath === selector);
+            if (!p)
+                return { ok: false, message: `No enrolled project matches '${selector}'.` };
+            targetId = p.projectId;
+        }
+    }
+    else {
+        return { ok: false, message: "`project` must be a project id or path_with_namespace." };
+    }
+    const target = getProject(targetId);
+    if (!target)
+        return { ok: false, message: `Project ${targetId} is not enrolled.` };
+    if (!isAccessAllowed(ctx.projectId, targetId)) {
+        return {
+            ok: false,
+            message: `Access denied: project ${ctx.projectId} has not been granted access to ` +
+                `${target.projectPath} (${targetId}). Ask an admin to grant it in the Access panel.`,
+        };
+    }
+    return { ok: true, target: { projectId: target.projectId, projectPath: target.projectPath } };
+}
+// Own project + granted targets (resolved, enrolled only). Used by the
+// list_accessible_projects tool and by peer-sync to pre-seed the git exclude.
+export function listAccessibleProjects(ctx) {
+    const own = getProject(ctx.projectId);
+    const out = own ? [{ projectId: own.projectId, projectPath: own.projectPath }] : [];
+    for (const t of listAccessTargets(ctx.projectId)) {
+        if (t.projectId !== ctx.projectId)
+            out.push(t);
+    }
+    return out;
+}
+//# sourceMappingURL=_helpers.js.map

package/dist/mcp/tools/_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.js","sourceRoot":"","sources":["../../../src/mcp/tools/_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEjF,gFAAgF;AAChF,6EAA6E;AAC7E,+BAA+B;AAE/B,gFAAgF;AAChF,+EAA+E;AAC/E,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;KAChE,QAAQ,EAAE;KACV,QAAQ,CACP,+FAA+F;IAC7F,mFAAmF,CACtF,CAAC;AAEJ,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAAe;IAEf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,CAAU;IAChD,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACxD,OAAO,WAAW,CAAC,GAAG,IAAI,4CAA4C,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,IAAI,YAAY,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACtF,CAAC;AASD,4EAA4E;AAC5E,0EAA0E;AAC1E,kEAAkE;AAClE,qCAAqC;AACrC,qEAAqE;AACrE,oEAAoE;AACpE,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,0DAA0D;AAC1D,MAAM,UAAU,oBAAoB,CAAC,GAAe,EAAE,QAAkB;IACtE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QACnE,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,SAAS,yBAAyB,EAAE,CAAC;QAC3F,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;IAC1F,CAAC;IAED,IAAI,QAAgB,CAAC;IACrB,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,QAAQ,GAAG,QAAQ,CAAC;IACtB,CAAC;SAAM,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC;YAC/D,IAAI,CAAC,CAAC;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,gCAAgC,QAAQ,IAAI,EAAE,CAAC;YACpF,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC;QACzB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,wDAAwD,EAAE,CAAC;IAC1F,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,QAAQ,mBAAmB,EAAE,CAAC;IACnF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EACL,0BAA0B,GAAG,CAAC,SAAS,kCAAkC;gBACzE,GAAG,MAAM,CAAC,WAAW,KAAK,QAAQ,kDAAkD;SACvF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;AAChG,CAAC;AAED,uEAAuE;AACvE,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB,CAAC,GAAe;IACpD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,GAAG,GAAqB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtG,KAAK,MAAM,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/mcp/tools/attachments.js

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import { getPlatform } from "../../platform/index.js";
+import { config } from "../../config.js";
+import { runtime } from "../../runtime-state.js";
+import { OUT_DIR, INCOMING_DIR, readFileFromVolume, writeFileToVolume, ExistsError } from "../volume-files.js";
+import { resolveBuilderImage } from "../../settings-store.js";
+import { safeDownloadFilename } from "../../attachments.js";
+import { log } from "../../logger.js";
+import { textResult, errorResult, toolError } from "./_helpers.js";
+// Download a work-item attachment from the forge into the git-excluded staging
+// dir so the agent can handle it with its own tools (including OCR). The
+// reference must match exactly one discovered attachment; the agent passes the
+// markdown link or bare URL as it appears in the note.
+export const downloadWorkItemAttachment = {
+    name: "download_work_item_attachment",
+    description: "Download an attachment from this work item's description or discussion into the workspace so you can read it. " +
+        "Pass the attachment's Markdown link or URL exactly as it appears. The file is saved under " +
+        `\`${INCOMING_DIR}/\` (git-excluded) and the tool returns its local path. ` +
+        "Image/PDF OCR is available on the saved file (`tesseract`, `pdftotext`, `pdftoppm` are installed).",
+    inputSchema: {
+        reference: z
+            .string()
+            .min(1)
+            .describe("The attachment reference exactly as it appears in the work item or a comment (e.g. `![shot](/uploads/abc/shot.png)`)."),
+    },
+    async handler(ctx, args) {
+        const reference = String(args.reference ?? "");
+        let ref;
+        try {
+            const matches = getPlatform().attachments.findRefs(reference);
+            if (matches.length === 0) {
+                return errorResult(`download_work_item_attachment: no attachment matched \`${reference}\`. Pass the link exactly as it appears in the work item.`);
+            }
+            if (matches.length > 1) {
+                return errorResult(`download_work_item_attachment: \`${reference}\` matched ${matches.length} attachments; pass a single attachment link.`);
+            }
+            ref = matches[0];
+            const bytes = await getPlatform().attachments.download(ctx.projectId, ref);
+            const filename = safeDownloadFilename(ref.filename);
+            // Avoid clobbering a prior download of the same reference.
+            let relPath = `${INCOMING_DIR}/${filename}`;
+            for (let attempt = 1;; attempt++) {
+                try {
+                    await writeFileToVolume(ctx.workItemId, relPath, bytes.bytes, resolveBuilderImage(ctx.projectId) || config.BUILDER_IMAGE);
+                    break;
+                }
+                catch (e) {
+                    if (!(e instanceof ExistsError) || attempt >= 100)
+                        throw e;
+                    const dot = filename.lastIndexOf(".");
+                    const base = dot > 0 ? filename.slice(0, dot) : filename;
+                    const ext = dot > 0 ? filename.slice(dot) : "";
+                    relPath = `${INCOMING_DIR}/${base}-${attempt}${ext}`;
+                }
+            }
+            log.info("attachment downloaded", { workItemId: ctx.workItemId, filename, bytes: bytes.bytes.byteLength });
+            return textResult(JSON.stringify({
+                reference,
+                filename,
+                path: `/workspace/${relPath}`,
+                bytes: bytes.bytes.byteLength,
+                contentType: bytes.contentType,
+            }, null, 2));
+        }
+        catch (e) {
+            return toolError("download_work_item_attachment", e);
+        }
+    },
+};
+// Upload a file from the run volume to the work item as an attachment and post
+// it as a comment (with an optional caption). Files must live under /workspace;
+// agent-produced throwaway output should go in .devbot-out/, which is
+// git-excluded so it can never be committed. Forges without an upload API
+// (GitHub) return "not supported on this platform" via toolError.
+export const uploadWorkItemAttachment = {
+    name: "upload_work_item_attachment",
+    description: "Upload a file from the workspace to this work item as an attachment and post it as a comment. " +
+        `Use this to share screenshots, test logs, or command output with the user. Files must be inside /workspace; ` +
+        `write scratch output to the ${OUT_DIR}/ directory (git-excluded, never committed). ` +
+        "`path` is relative to /workspace (or absolute under it); `caption` is optional Markdown posted above the attachment.",
+    inputSchema: {
+        path: z
+            .string()
+            .min(1)
+            .describe(`File to upload, relative to /workspace (e.g. "${OUT_DIR}/shot.png") or absolute under /workspace.`),
+        caption: z.string().max(2000).optional().describe("Optional Markdown caption posted above the attachment."),
+    },
+    async handler(ctx, args) {
+        const path = String(args.path ?? "");
+        const caption = typeof args.caption === "string" ? args.caption.trim() : "";
+        let uploaded;
+        try {
+            const file = await readFileFromVolume(ctx.workItemId, path, runtime().attachmentMaxBytes, resolveBuilderImage(ctx.projectId) || config.BUILDER_IMAGE);
+            uploaded = await getPlatform().attachments.upload(ctx.projectId, ctx.workItemNumber, {
+                filename: file.filename,
+                bytes: file.bytes,
+                contentType: file.contentType,
+            });
+        }
+        catch (e) {
+            return toolError("upload_work_item_attachment", e);
+        }
+        // The bytes are already on the forge at this point. If posting the comment
+        // fails, return the markdown so the agent can still include it in its final
+        // reply rather than orphaning the upload silently.
+        const body = caption ? `${caption}\n\n${uploaded.markdown}` : uploaded.markdown;
+        try {
+            await getPlatform().workItems.postComment(ctx.projectId, ctx.workItemNumber, body);
+        }
+        catch (e) {
+            return errorResult(`upload_work_item_attachment: file uploaded but posting the comment failed ` +
+                `(${e instanceof Error ? e.message : String(e)}). Include this Markdown in your reply: ${uploaded.markdown}`);
+        }
+        return textResult(JSON.stringify({ filename: uploaded.filename, markdown: uploaded.markdown, url: uploaded.url }, null, 2));
+    },
+};
+//# sourceMappingURL=attachments.js.map

package/dist/mcp/tools/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../../src/mcp/tools/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEnE,+EAA+E;AAC/E,yEAAyE;AACzE,+EAA+E;AAC/E,uDAAuD;AACvD,MAAM,CAAC,MAAM,0BAA0B,GAAS;IAC9C,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,gHAAgH;QAChH,4FAA4F;QAC5F,KAAK,YAAY,0DAA0D;QAC3E,oGAAoG;IACtG,WAAW,EAAE;QACX,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,uHAAuH,CAAC;KACrI;IACD,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI;QACrB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,GAAG,CAAC;QACR,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,WAAW,CAChB,0DAA0D,SAAS,2DAA2D,CAC/H,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,WAAW,CAChB,oCAAoC,SAAS,cAAc,OAAO,CAAC,MAAM,8CAA8C,CACxH,CAAC;YACJ,CAAC;YACD,GAAG,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,WAAW,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC3E,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACpD,2DAA2D;YAC3D,IAAI,OAAO,GAAG,GAAG,YAAY,IAAI,QAAQ,EAAE,CAAC;YAC5C,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,MAAM,iBAAiB,CACrB,GAAG,CAAC,UAAU,EACd,OAAO,EACP,KAAK,CAAC,KAAK,EACX,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,aAAa,CAC3D,CAAC;oBACF,MAAM;gBACR,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,IAAI,CAAC,CAAC,CAAC,YAAY,WAAW,CAAC,IAAI,OAAO,IAAI,GAAG;wBAAE,MAAM,CAAC,CAAC;oBAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;oBACtC,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;oBACzD,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/C,OAAO,GAAG,GAAG,YAAY,IAAI,IAAI,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;gBACvD,CAAC;YACH,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YAC3G,OAAO,UAAU,CACf,IAAI,CAAC,SAAS,CACZ;gBACE,SAAS;gBACT,QAAQ;gBACR,IAAI,EAAE,cAAc,OAAO,EAAE;gBAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;gBAC7B,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,gFAAgF;AAChF,sEAAsE;AACtE,0EAA0E;AAC1E,kEAAkE;AAClE,MAAM,CAAC,MAAM,wBAAwB,GAAS;IAC5C,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,gGAAgG;QAChG,8GAA8G;QAC9G,+BAA+B,OAAO,+CAA+C;QACrF,sHAAsH;IACxH,WAAW,EAAE;QACX,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,iDAAiD,OAAO,2CAA2C,CAAC;QAChH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;KAC5G;IACD,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,kBAAkB,CACnC,GAAG,CAAC,UAAU,EACd,IAAI,EACJ,OAAO,EAAE,CAAC,kBAAkB,EAC5B,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,aAAa,CAC3D,CAAC;YACF,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,cAAc,EAAE;gBACnF,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,2EAA2E;QAC3E,4EAA4E;QAC5E,mDAAmD;QACnD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAChF,IAAI,CAAC;YACH,MAAM,WAAW,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACrF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,WAAW,CAChB,4EAA4E;gBAC1E,IAAI,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,2CAA2C,QAAQ,CAAC,QAAQ,EAAE,CAC/G,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CACf,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CACzG,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/cicd.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import { getPlatform } from "../../platform/index.js";
+import { textResult, errorResult, toolError, resolveTargetProject, projectArg } from "./_helpers.js";
+const MAX_LOG_BYTES = 200_000;
+// CI/CD. On every forge these map to the normalized PipelineRun/Job shapes:
+// GitLab pipelines/jobs/trace, ForgeJo/Gitea and GitHub Actions runs/jobs/logs.
+// `scope` is GitLab-only; the other drivers throw UnsupportedError, rendered by
+// toolError as "not supported on this platform". `username` maps to the forge's
+// actor filter (GitLab `username`, Gitea/GitHub `actor`).
+export const listPipelines = {
+    name: "list_pipelines",
+    description: "List a project's CI/CD runs (GitLab pipelines / ForgeJo-Gitea-GitHub Actions workflow runs). Filter by ref, status, or username (the run's actor). `scope` is GitLab-only. Defaults to the current project; pass `project` for an authorized other project.",
+    inputSchema: {
+        ref: z.string().optional().describe("Branch or tag to filter runs."),
+        status: z.string().optional().describe("Run status filter."),
+        scope: z.string().optional().describe("Run scope filter (GitLab only)."),
+        username: z.string().optional().describe("Only runs triggered by this username."),
+        page: z.number().int().positive().optional().describe("1-based page number (100 per page)."),
+        project: projectArg,
+    },
+    async handler(ctx, args) {
+        const t = resolveTargetProject(ctx, args.project);
+        if (!t.ok)
+            return errorResult(t.message);
+        try {
+            const p = await getPlatform().ci.listPipelines(t.target.projectId, {
+                ...(args.ref ? { ref: args.ref } : {}),
+                ...(args.status ? { status: args.status } : {}),
+                ...(args.scope ? { scope: args.scope } : {}),
+                ...(args.username ? { username: args.username } : {}),
+                ...(args.page ? { page: args.page } : {}),
+            });
+            return textResult(JSON.stringify(p, null, 2));
+        }
+        catch (e) {
+            return toolError("list_pipelines", e);
+        }
+    },
+};
+export const getPipeline = {
+    name: "get_pipeline",
+    description: "Fetch a single CI/CD run by id. Defaults to the current project; pass `project` for an authorized other project.",
+    inputSchema: {
+        pipeline_id: z.number().int().positive().describe("Pipeline/run id."),
+        project: projectArg,
+    },
+    async handler(ctx, args) {
+        const t = resolveTargetProject(ctx, args.project);
+        if (!t.ok)
+            return errorResult(t.message);
+        try {
+            const p = await getPlatform().ci.getPipeline(t.target.projectId, args.pipeline_id);
+            return textResult(JSON.stringify(p, null, 2));
+        }
+        catch (e) {
+            return toolError("get_pipeline", e);
+        }
+    },
+};
+export const listPipelineJobs = {
+    name: "list_pipeline_jobs",
+    description: "List the jobs of a CI/CD run. `scope` (e.g. failed) is GitLab-only. Defaults to the current project; pass `project` for an authorized other project.",
+    inputSchema: {
+        pipeline_id: z.number().int().positive().describe("Pipeline/run id."),
+        scope: z.string().optional().describe("Job status scope filter (GitLab only)."),
+        page: z.number().int().positive().optional().describe("1-based page number (100 per page)."),
+        project: projectArg,
+    },
+    async handler(ctx, args) {
+        const t = resolveTargetProject(ctx, args.project);
+        if (!t.ok)
+            return errorResult(t.message);
+        try {
+            const jobs = await getPlatform().ci.listPipelineJobs(t.target.projectId, args.pipeline_id, {
+                ...(args.scope ? { scope: args.scope } : {}),
+                ...(args.page ? { page: args.page } : {}),
+            });
+            return textResult(JSON.stringify(jobs, null, 2));
+        }
+        catch (e) {
+            return toolError("list_pipeline_jobs", e);
+        }
+    },
+};
+export const getJobLog = {
+    name: "get_job_log",
+    description: "Fetch a job's raw trace/log text. When the log exceeds the 200 KB read cap the tail is kept and the omitted head is marked. Defaults to the current project; pass `project` for an authorized other project.",
+    inputSchema: {
+        job_id: z.number().int().positive().describe("Job id."),
+        project: projectArg,
+    },
+    async handler(ctx, args) {
+        const t = resolveTargetProject(ctx, args.project);
+        if (!t.ok)
+            return errorResult(t.message);
+        try {
+            const f = await getPlatform().ci.getJobLog(t.target.projectId, args.job_id, MAX_LOG_BYTES);
+            return textResult(f.content);
+        }
+        catch (e) {
+            return toolError("get_job_log", e);
+        }
+    },
+};
+//# sourceMappingURL=cicd.js.map

package/dist/mcp/tools/cicd.js.map

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

package/dist/mcp/tools/discovery.js

@@ -0,0 +1,34 @@
+import { getPlatform } from "../../platform/index.js";
+import { textResult, errorResult, resolveTargetProject, listAccessibleProjects as listAccessible, projectArg } from "./_helpers.js";
+// List the projects this run can read: its own project plus every project it
+// has been granted access to. Resolved entirely from DevBot's enrollment +
+// grant tables — never lists all managed projects, and never calls the forge.
+export const listAccessibleProjects = {
+    name: "list_accessible_projects",
+    description: "List the projects this run can read. Always includes the current project; includes other projects only when an admin has granted access. Returns projectId and path. Use a returned `project` selector with the other tools.",
+    inputSchema: {},
+    async handler(ctx) {
+        return textResult(JSON.stringify(listAccessible(ctx), null, 2));
+    },
+};
+// Fetch project metadata.
+export const getProject = {
+    name: "get_project",
+    description: "Fetch metadata for a project: id, path, web URL, HTTPS clone URL, and default branch. Defaults to the current project; pass `project` for an authorized other project.",
+    inputSchema: {
+        project: projectArg,
+    },
+    async handler(ctx, args) {
+        const t = resolveTargetProject(ctx, args.project);
+        if (!t.ok)
+            return errorResult(t.message);
+        try {
+            const p = await getPlatform().repository.getRepo(t.target.projectId);
+            return textResult(JSON.stringify(p, null, 2));
+        }
+        catch (e) {
+            return errorResult(`get_project failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    },
+};
+//# sourceMappingURL=discovery.js.map

package/dist/mcp/tools/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/mcp/tools/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,sBAAsB,IAAI,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpI,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,sBAAsB,GAAS;IAC1C,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,8NAA8N;IAChO,WAAW,EAAE,EAAE;IACf,KAAK,CAAC,OAAO,CAAC,GAAG;QACf,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;CACF,CAAC;AAEF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,wKAAwK;IAC1K,WAAW,EAAE;QACX,OAAO,EAAE,UAAU;KACpB;IACD,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI;QACrB,MAAM,CAAC,GAAG,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACrE,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,WAAW,CAAC,uBAAuB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/mcp/tools/issues.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { getPlatform } from "../../platform/index.js";
+import { textResult, errorResult, resolveTargetProject, projectArg } from "./_helpers.js";
+// List issues in the current project (or a granted target). The target is
+// resolved from the token's project + the live directed-grant set; the forge
+// call only happens after the scope check passes.
+export const listIssues = {
+    name: "list_issues",
+    description: "List issues in the current project. Returns id, number, title, state, web_url, labels, assignees. Filter by state or search by title/description. Pass `project` to read an authorized other project.",
+    inputSchema: {
+        state: z.enum(["open", "closed", "all"]).optional().describe("Issue state filter. Defaults to all."),
+        search: z.string().optional().describe("Search term matched against issue title and description."),
+        labels: z.string().optional().describe("Comma-separated label names; issues must have all of them."),
+        page: z.number().int().positive().optional().describe("1-based page number (100 per page)."),
+        project: projectArg,
+    },
+    async handler(ctx, args) {
+        const t = resolveTargetProject(ctx, args.project);
+        if (!t.ok)
+            return errorResult(t.message);
+        try {
+            const issues = await getPlatform().workItems.listWorkItems(t.target.projectId, {
+                ...(args.state ? { state: args.state } : {}),
+                ...(args.search ? { search: args.search } : {}),
+                ...(args.labels ? { labels: args.labels } : {}),
+                ...(args.page ? { page: args.page } : {}),
+            });
+            return textResult(JSON.stringify(issues, null, 2));
+        }
+        catch (e) {
+            return errorResult(`list_issues failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    },
+};
+// Fetch a single issue by number (the project-internal number, not the global id).
+export const getIssue = {
+    name: "get_issue",
+    description: "Fetch a single issue by its project-internal number. Returns full issue metadata: title, description, state, labels, assignees, milestone, references. Pass `project` to read an authorized other project.",
+    inputSchema: {
+        number: z.number().int().positive().describe("The issue's project-internal number (the number shown in the issue URL)."),
+        project: projectArg,
+    },
+    async handler(ctx, args) {
+        const t = resolveTargetProject(ctx, args.project);
+        if (!t.ok)
+            return errorResult(t.message);
+        try {
+            const issue = await getPlatform().workItems.getWorkItemSummary(t.target.projectId, args.number);
+            return textResult(JSON.stringify(issue, null, 2));
+        }
+        catch (e) {
+            return errorResult(`get_issue failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    },
+};
+//# sourceMappingURL=issues.js.map

package/dist/mcp/tools/issues.js.map

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

package/dist/mcp/tools/merge_requests.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { getPlatform } from "../../platform/index.js";
+import { textResult, errorResult, resolveTargetProject, projectArg } from "./_helpers.js";
+export const listMergeRequests = {
+    name: "list_merge_requests",
+    description: "List merge/pull requests in the current project. Returns id, number, title, state, source/target branch, web_url. Filter by state or search. Pass `project` to read an authorized other project.",
+    inputSchema: {
+        state: z
+            .enum(["open", "closed", "merged", "all"])
+            .optional()
+            .describe("Merge/pull request state filter. Defaults to all."),
+        search: z.string().optional().describe("Search term matched against MR title and description."),
+        source_branch: z.string().optional().describe("Filter by source branch name."),
+        page: z.number().int().positive().optional().describe("1-based page number (100 per page)."),
+        project: projectArg,
+    },
+    async handler(ctx, args) {
+        const t = resolveTargetProject(ctx, args.project);
+        if (!t.ok)
+            return errorResult(t.message);
+        try {
+            const mrs = await getPlatform().changeRequests.list(t.target.projectId, {
+                ...(args.state ? { state: args.state } : {}),
+                ...(args.search ? { search: args.search } : {}),
+                ...(args.source_branch ? { sourceBranch: args.source_branch } : {}),
+                ...(args.page ? { page: args.page } : {}),
+            });
+            return textResult(JSON.stringify(mrs, null, 2));
+        }
+        catch (e) {
+            return errorResult(`list_merge_requests failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    },
+};
+// Fetch review discussions for a single CR by number. Target resolved from the
+// token + live grants.
+export const getMergeRequestDiscussions = {
+    name: "get_merge_request_discussions",
+    description: "Fetch discussions for a merge/pull request by its project-internal number. Returns review comments (with file/line position when anchored), general threads, and system notes. Each note carries author and body. Use this to get review context. Pass `project` to read an authorized other project.",
+    inputSchema: {
+        number: z.number().int().positive().describe("The merge/pull request's project-internal number (the number shown in its URL)."),
+        diff_only: z
+            .boolean()
+            .optional()
+            .describe("If true, keep only discussions containing at least one anchored (diff) note. Defaults to false (all discussions)."),
+        page: z.number().int().positive().optional().describe("1-based page number (100 per page)."),
+        project: projectArg,
+    },
+    async handler(ctx, args) {
+        const t = resolveTargetProject(ctx, args.project);
+        if (!t.ok)
+            return errorResult(t.message);
+        try {
+            const discussions = await getPlatform().changeRequests.listReviewDiscussions(t.target.projectId, args.number, {
+                ...(args.page ? { page: args.page } : {}),
+            });
+            const filtered = args.diff_only
+                ? discussions.filter((d) => d.notes.some((n) => n.position))
+                : discussions;
+            return textResult(JSON.stringify(filtered, null, 2));
+        }
+        catch (e) {
+            return errorResult(`get_merge_request_discussions failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    },
+};
+//# sourceMappingURL=merge_requests.js.map

package/dist/mcp/tools/merge_requests.js.map

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