@vibesdotdev/forge 0.0.0-stage → 1.0.0-rc.5

package/dist/tools/lib/transport.js

@@ -0,0 +1,259 @@
+/** Forge transport uses the handed acting-user bearer or the bounded PR automation grant. */
+import * as z from "zod/v4";
+import { CapabilityError } from "@vibesdotdev/kernel";
+import { serviceOrigin } from "@vibesdotdev/infra-core/service";
+import { resolveCallerBearer } from "@vibesdotdev/auth/caller-bearer";
+import { readExecutionBindings, readTrustedRunContext, resolveToolCallerBearer, } from '@vibesdotdev/tools/agents/trusted-context';
+import { buildRequest, forgeHostFetch, forgeResponseFailure, parseResponse, withQuery, ForgeJwtMintError, ForgeOriginUnavailableError, ForgeNotSignedInError, } from "../../request.js";
+export { buildRequest, forgeResponseFailure, parseResponse, withQuery, ForgeJwtMintError, ForgeOriginUnavailableError, ForgeNotSignedInError, };
+/**
+ * The declared `infra/service` `id`'s origin of `kind` in the handed runtime's
+ * configured service environment, trailing slash stripped (rc04 §2.4). An
+ * undeclared service fails `NOT_FOUND` `service-undeclared`.
+ */
+async function declaredOrigin(runtime, id, kind) {
+    return (await serviceOrigin(runtime, id, kind)).replace(/\/$/, "");
+}
+/** The internal service key the PR-automation adapter authenticates with. */
+const INTERNAL_SERVICE_TOKEN_KEY = "VIBES_INTERNAL_SERVICE_TOKEN";
+/**
+ * The platform internal service credential from the handed runtime's declared
+ * secrets store (rc05: `resolveCredential` is the only credential API). An
+ * unset credential is `UNAVAILABLE` `credential-not-set`; any other failure
+ * is the resolution's own typed error.
+ */
+async function resolveInternalServiceToken(runtime) {
+    const resolution = await runtime.resolveCredential({ source: "secret", key: INTERNAL_SERVICE_TOKEN_KEY });
+    if (!resolution.ok)
+        throw resolution.error;
+    const token = resolution.value.trim();
+    if (!token) {
+        throw new CapabilityError("The platform internal service credential is empty.", "UNAVAILABLE", {
+            reason: "credential-not-set",
+            details: { key: INTERNAL_SERVICE_TOKEN_KEY },
+        });
+    }
+    return token;
+}
+export function looksLikeJwt(token) {
+    return token.split(".").length === 3 && token.length > 20;
+}
+/**
+ * Resolve the outbound bearer for a forge-tools call: an explicit override,
+ * else the caller's bearer from auth's `resolveCallerBearer` on the runtime the
+ * caller was handed. An anonymous caller is `ForgeNotSignedInError`; a
+ * signed-out interactive host is auth's `AUTH_REQUIRED` `not-signed-in`.
+ */
+export async function resolveOutboundToken(runtime, override) {
+    if (override && override.length > 0)
+        return override;
+    const bearer = await resolveCallerBearer(runtime);
+    if (!bearer)
+        throw new ForgeNotSignedInError();
+    return bearer;
+}
+/** A bare bearer a test seam hands a tool implementation in place of its scope. */
+const BearerSchema = z.string();
+function isBearer(token) {
+    return BearerSchema.safeParse(token).success;
+}
+/** The scope a tool implementation runs with: the handed scope, a bare bearer's scope, or none. */
+export function toolScope(token) {
+    if (token === undefined)
+        return {};
+    if (!isBearer(token))
+        return token;
+    return token ? { token } : {};
+}
+/** The tool-call metadata a durable Chat automation names itself by; any other shape names nothing. */
+const AutomationMetadataSchema = z.object({
+    agentId: z.string().trim().optional().catch(undefined),
+    sessionId: z.string().trim().optional().catch(undefined),
+});
+/** The global config's active org; any other key or shape is no active org. */
+const ActiveOrgConfigSchema = z.object({ activeOrgId: z.string().min(1).optional().catch(undefined) });
+/** The run-bound app bearer the trusted run context carries (never a browser cookie). */
+export function readContextBearer(ctx) {
+    const value = ctx ? readTrustedRunContext(ctx).jwt : undefined;
+    const bearer = value?.trim();
+    return bearer ? bearer : undefined;
+}
+export async function resolveRepoScopedToolToken(runtime, ctx) {
+    return resolveContextOutboundToken(ctx, { runtime });
+}
+/** Durable Chat identity selects a service call, never a persisted user bearer. */
+export async function resolveRepoScopedToolScope(runtime, ctx) {
+    const pullRequest = readExecutionBindings(ctx)?.pullRequest;
+    if (runtime.scope.hardware === 'cloud' && pullRequest && (await resolveToolCallerBearer(runtime, ctx)).bearer === null) {
+        const trusted = readTrustedRunContext(ctx);
+        const userId = trusted.actorUserId;
+        const metadata = AutomationMetadataSchema.safeParse(ctx.metadata ?? {});
+        const agentId = metadata.success ? (metadata.data.agentId ?? '') : '';
+        const sessionId = metadata.success ? (metadata.data.sessionId ?? '') : '';
+        if (!userId || !agentId || !sessionId)
+            throw new ForgeNotSignedInError();
+        const organizationId = trusted.organizationId ?? trusted.orgId;
+        const automation = {
+            userId,
+            agentId,
+            sessionId,
+            pullRequest,
+        };
+        if (organizationId)
+            automation.organizationId = organizationId;
+        return { automation, runtime };
+    }
+    return { token: await resolveRepoScopedToolToken(runtime, ctx), runtime };
+}
+/**
+ * The caller's bearer: auth's caller bearer for the active request, else the
+ * run-bound bearer (`resolveToolCallerBearer`). Without a runtime only the
+ * run-bound bearer is available. With none the call is `ForgeNotSignedInError`,
+ * never a host credential.
+ */
+export async function resolveContextOutboundToken(ctx, options = {}) {
+    if (options.runtime) {
+        const caller = await resolveToolCallerBearer(options.runtime, ctx);
+        if (caller.bearer !== null)
+            return caller.bearer;
+        throw new ForgeNotSignedInError();
+    }
+    const bearer = readContextBearer(ctx);
+    if (bearer)
+        return bearer;
+    throw new ForgeNotSignedInError();
+}
+/**
+ * The active org from the global config of `runtime`'s host. Only a host that
+ * publishes path roots has a global config: a filesystem-less host (or a call
+ * handed no runtime) has no active org. A present config that cannot be read
+ * propagates instead of silently dropping the header.
+ */
+async function activeOrgFromGlobalConfig(runtime) {
+    if (!runtime?.hasKind("paths/roots"))
+        return null;
+    const { loadConfigForScope } = await import("@vibesdotdev/config/services/config");
+    const config = ActiveOrgConfigSchema.safeParse(await loadConfigForScope("global", runtime));
+    return config.success ? (config.data.activeOrgId ?? null) : null;
+}
+/**
+ * Resolve the platform origin (an explicit `origin`, else the declared
+ * `platform` service on the handed runtime: its internal origin for PR
+ * automation, its primary origin otherwise), the outbound bearer, build the
+ * request, execute it through the injectable `fetchImpl`, and normalise the
+ * response — the forge-tools analogue of forge-cli's `sendForgeRequest`. The
+ * bearer is the explicit `token`, else `resolveCallerBearer(runtime)` for the
+ * handed `runtime`; with neither the call is `ForgeNotSignedInError`. PR
+ * automation presents the internal service credential from the runtime.
+ */
+export async function sendForgeToolRequest(spec, options = {}) {
+    const runtime = options.runtime;
+    const origin = options.origin ??
+        (runtime
+            ? await declaredOrigin(runtime, "platform", options.automation ? "internal" : "primary")
+            : undefined);
+    if (!origin)
+        throw new ForgeOriginUnavailableError();
+    if (options.automation) {
+        const { automation } = options;
+        if (!runtime) {
+            throw new CapabilityError("PR automation needs the runtime it was handed for its service credential.", "INVALID_INPUT", {
+                reason: "runtime-missing",
+            });
+        }
+        const prefix = `/api/repositories/${encodeURIComponent(automation.pullRequest.repositoryId)}`;
+        const number = automation.pullRequest.pullRequestNumber;
+        const allowed = spec.method === 'GET'
+            ? [`${prefix}/issues/${number}`, `${prefix}/pulls/${number}/files`, `${prefix}/pulls/${number}/mergeability`]
+            : spec.method === 'POST' ? [`${prefix}/issues/${number}/comments`, `${prefix}/pulls/${number}/merge`] : [];
+        if (!allowed.includes(spec.path)) {
+            throw new CapabilityError("PR automation cannot access another target or operation.", "PERMISSION_DENIED", {
+                reason: "automation-target-denied",
+                details: { method: spec.method },
+            });
+        }
+        const serviceToken = await resolveInternalServiceToken(runtime);
+        const headers = {
+            authorization: `Bearer ${serviceToken}`,
+            'content-type': 'application/json', accept: 'application/json',
+            'x-vibes-user-id': automation.userId,
+        };
+        const automationHeaders = automation.organizationId
+            ? { ...headers, 'x-vibes-organization-id': automation.organizationId }
+            : headers;
+        const response = await (options.fetchImpl ?? forgeHostFetch)(`${origin}/api/internal/forge/pull-request-tools`, {
+            method: 'POST', headers: automationHeaders, credentials: 'omit',
+            body: JSON.stringify({ agentId: automation.agentId, sessionId: automation.sessionId, pullRequest: automation.pullRequest, request: spec })
+        });
+        return parseResponse(response.status, response.ok, await response.text(), [serviceToken]);
+    }
+    if (!options.token && !runtime)
+        throw new ForgeNotSignedInError();
+    const token = options.token || (await resolveOutboundToken(runtime));
+    const { url, init } = buildRequest(spec, origin, token);
+    // Attach the active org header when the handed runtime's host has a global
+    // config (matching forge-cli behavior).
+    const activeOrgId = await activeOrgFromGlobalConfig(options.runtime);
+    if (activeOrgId &&
+        !spec.path.startsWith("/api/git-auth/") &&
+        !spec.path.startsWith("/api/ssh-keys/")) {
+        init.headers["x-vibes-active-org"] = activeOrgId;
+    }
+    const fetchImpl = options.fetchImpl ?? forgeHostFetch;
+    // No retry with another credential: the caller's bearer is the only one,
+    // and the device-session store re-mints it near expiry itself.
+    const res = await fetchImpl(url, init);
+    const text = await res.text();
+    return parseResponse(res.status, res.ok, text, [token]);
+}
+export function formatForgeToolError(toolId, status, message) {
+    if (status === 401) {
+        return (`${toolId} failed (401): ${message}. ` +
+            `Remediation: run 'vibes auth login' to authenticate with Forge.`);
+    }
+    return `${toolId} failed (${status}): ${message}`;
+}
+/**
+ * A failed forge response as the tool's typed failure: the response's own
+ * typed failure, named for `toolId`, with a sign-in hint on `AUTH_REQUIRED`.
+ * Its message is value-free; the server's text stays in the redacted cause.
+ */
+export function forgeToolFailure(toolId, res) {
+    const failure = forgeResponseFailure(res);
+    return new CapabilityError(`${toolId} failed: ${failure.message}`, failure.code, {
+        reason: failure.reason,
+        retryable: failure.retryable,
+        recoveryHint: failure.code === "AUTH_REQUIRED"
+            ? "Run 'vibes auth login' to authenticate with Forge."
+            : failure.recoveryHint,
+        details: { ...failure.details, tool: toolId },
+        cause: failure,
+    });
+}
+/** A forge success body: a JSON object or array, the shapes an envelope comes in. */
+const ForgeToolEnvelopeSchema = z.union([z.looseObject({}), z.array(z.unknown())]);
+/**
+ * The parsed body of a successful forge response, asserted to actually BE one.
+ *
+ * Every tool impl reached straight through the response (`res.data.result`).
+ * When the platform answered 2xx without the expected envelope, `res.data` was
+ * `undefined` and that expression either threw a bare TypeError or — worse —
+ * evaluated to `undefined`, which the MCP layer then rejected against the tool's
+ * output schema as `Invalid output from '<tool>'`. That message names the
+ * symptom and hides the cause; it cost real diagnosis time on
+ * forge-pr-merge-status while the git host was pack-busy (#296).
+ *
+ * `parseResponse` now reclassifies an unparseable 2xx as a failure, so this
+ * guard covers the remaining case: a well-formed JSON body that is not the
+ * envelope the tool expects. Failing here names the tool and the status, which
+ * is what a caller needs.
+ */
+export function requireForgeToolData(res, toolId) {
+    if (!res.ok)
+        throw forgeToolFailure(toolId, res);
+    if (!ForgeToolEnvelopeSchema.safeParse(res.data).success) {
+        throw new CapabilityError(`${toolId} received a success without a JSON object body: the platform answered but did not return the expected envelope.`, "UNAVAILABLE", { reason: "forge-tool-envelope-missing", details: { tool: toolId, status: res.status } });
+    }
+    return res.data;
+}
+//# sourceMappingURL=transport.js.map

package/dist/tools/lib/transport.js.map

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

package/dist/tools/tools/forge-issue-close.descriptor.d.ts

@@ -0,0 +1,118 @@
+/**
+ * forge-issue-close descriptor. Safe to import anywhere (no impl).
+ */
+declare const _default: {
+    readonly kind: "tools/tool";
+    readonly id: "forge-issue-close";
+    readonly name: "forge-issue-close";
+    readonly description: "Close an issue on a git repository.";
+    readonly mcpDescription: "Close a non-PR issue by setting its tracking status to done or cancelled.";
+    readonly hardware: readonly ["consumer", "cloud"];
+    readonly purpose: ["direct", "worker", "mcp", "agent"];
+    readonly category: "forge";
+    readonly subcategory: "issues";
+    readonly safety: "write";
+    readonly tags: readonly ["forge", "git", "issue", "close"];
+    readonly schemas: {
+        readonly input: import("zod").ZodObject<{
+            repo: import("zod").ZodString;
+            issueNumber: import("zod").ZodNumber;
+            status: import("zod").ZodDefault<import("zod").ZodEnum<{
+                done: "done";
+                cancelled: "cancelled";
+            }>>;
+        }, import("zod/v4/core").$strip>;
+        readonly output: import("zod").ZodObject<{
+            item: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                projectId: import("zod").ZodOptional<import("zod").ZodString>;
+                repositoryId: import("zod").ZodOptional<import("zod").ZodString>;
+                issueNumber: import("zod").ZodOptional<import("zod").ZodNumber>;
+                type: import("zod").ZodEnum<{
+                    task: "task";
+                    bug: "bug";
+                    research: "research";
+                    ops: "ops";
+                    doc: "doc";
+                    pr: "pr";
+                }>;
+                title: import("zod").ZodString;
+                description: import("zod").ZodOptional<import("zod").ZodString>;
+                status: import("zod").ZodEnum<{
+                    done: "done";
+                    blocked: "blocked";
+                    draft: "draft";
+                    backlog: "backlog";
+                    planned: "planned";
+                    in_progress: "in_progress";
+                    in_review: "in_review";
+                    cancelled: "cancelled";
+                }>;
+                priority: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    urgent: "urgent";
+                }>>;
+                effortId: import("zod").ZodOptional<import("zod").ZodUUID>;
+                milestoneId: import("zod").ZodOptional<import("zod").ZodUUID>;
+                ownerParticipantId: import("zod").ZodOptional<import("zod").ZodString>;
+                assignedParticipantId: import("zod").ZodOptional<import("zod").ZodString>;
+                tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                links: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                    kind: import("zod").ZodString;
+                    id: import("zod").ZodString;
+                    source: import("zod").ZodString;
+                    role: import("zod").ZodDefault<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>>;
+                pr: import("zod").ZodOptional<import("zod").ZodObject<{
+                    sourceRef: import("zod").ZodString;
+                    targetRef: import("zod").ZodString;
+                    mergeBase: import("zod").ZodOptional<import("zod").ZodString>;
+                    headSha: import("zod").ZodOptional<import("zod").ZodString>;
+                    mergeCommitSha: import("zod").ZodOptional<import("zod").ZodString>;
+                    state: import("zod").ZodEnum<{
+                        open: "open";
+                        draft: "draft";
+                        merged: "merged";
+                        closed: "closed";
+                    }>;
+                    ciStatus: import("zod").ZodOptional<import("zod").ZodEnum<{
+                        success: "success";
+                        error: "error";
+                        pending: "pending";
+                        failure: "failure";
+                    }>>;
+                    stack: import("zod").ZodOptional<import("zod").ZodObject<{
+                        id: import("zod").ZodUUID;
+                        stackNumber: import("zod").ZodNumber;
+                        position: import("zod").ZodNumber;
+                        size: import("zod").ZodNumber;
+                        trunkRef: import("zod").ZodString;
+                        state: import("zod").ZodEnum<{
+                            active: "active";
+                            merged: "merged";
+                            merging: "merging";
+                            dissolved: "dissolved";
+                        }>;
+                        health: import("zod").ZodEnum<{
+                            clean: "clean";
+                            "restack-required": "restack-required";
+                            conflicted: "conflicted";
+                        }>;
+                        landingPolicy: import("zod").ZodEnum<{
+                            "batch-allowed": "batch-allowed";
+                            "one-layer-at-a-time": "one-layer-at-a-time";
+                        }>;
+                        revision: import("zod").ZodNumber;
+                    }, import("zod/v4/core").$strip>>;
+                }, import("zod/v4/core").$loose>>;
+                metadata: import("zod").ZodOptional<import("zod").ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, import("zod/v4/core").$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+                createdAt: import("zod").ZodOptional<import("zod").ZodString>;
+                updatedAt: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$loose>;
+        }, import("zod/v4/core").$strip>;
+    };
+};
+export default _default;
+//# sourceMappingURL=forge-issue-close.descriptor.d.ts.map

package/dist/tools/tools/forge-issue-close.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-issue-close.descriptor.d.ts","sourceRoot":"","sources":["../../../src/tools/tools/forge-issue-close.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKH,wBAgBG"}

package/dist/tools/tools/forge-issue-close.descriptor.js

@@ -0,0 +1,23 @@
+/**
+ * forge-issue-close descriptor. Safe to import anywhere (no impl).
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel/factory';
+import { IssueCloseInputSchema, IssueCloseOutputSchema } from "./schemas.js";
+export default createRuntimeAsset({
+    kind: 'tools/tool',
+    id: 'forge-issue-close',
+    name: 'forge-issue-close',
+    description: 'Close an issue on a git repository.',
+    mcpDescription: 'Close a non-PR issue by setting its tracking status to done or cancelled.',
+    hardware: ['consumer', 'cloud'],
+    purpose: ['direct', 'worker', 'mcp', 'agent'],
+    category: 'forge',
+    subcategory: 'issues',
+    safety: 'write',
+    tags: ['forge', 'git', 'issue', 'close'],
+    schemas: {
+        input: IssueCloseInputSchema,
+        output: IssueCloseOutputSchema
+    }
+});
+//# sourceMappingURL=forge-issue-close.descriptor.js.map

package/dist/tools/tools/forge-issue-close.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-issue-close.descriptor.js","sourceRoot":"","sources":["../../../src/tools/tools/forge-issue-close.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE7E,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,qCAAqC;IAClD,cAAc,EAAE,2EAA2E;IAC3F,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC;IAC7C,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,QAAQ;IACrB,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC;IACxC,OAAO,EAAE;QACR,KAAK,EAAE,qBAAqB;QAC5B,MAAM,EAAE,sBAAsB;KAC9B;CACD,CAAC,CAAC"}

package/dist/tools/tools/forge-issue-close.impl.d.ts

@@ -0,0 +1,13 @@
+/**
+ * forge-issue-close implementation (lazy-loaded; the unit under test).
+ */
+import type { VibesRuntime, ToolCallContext } from '@vibesdotdev/kernel';
+import { type IssueCloseInput, type IssueCloseOutput } from './schemas.ts';
+import { type TrackingMutationDeps } from './forge-tracking-mutations.ts';
+export type IssueCloseDeps = TrackingMutationDeps;
+export declare function executeIssueClose(input: IssueCloseInput, deps?: IssueCloseDeps, token?: string, runtime?: VibesRuntime): Promise<IssueCloseOutput>;
+declare const _default: {
+    execute(input: IssueCloseInput, runtime: VibesRuntime, ctx: ToolCallContext): Promise<IssueCloseOutput>;
+};
+export default _default;
+//# sourceMappingURL=forge-issue-close.impl.d.ts.map

package/dist/tools/tools/forge-issue-close.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-issue-close.impl.d.ts","sourceRoot":"","sources":["../../../src/tools/tools/forge-issue-close.impl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAKN,KAAK,oBAAoB,EACzB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAElD,wBAAsB,iBAAiB,CACtC,KAAK,EAAE,eAAe,EACtB,IAAI,GAAE,cAA4C,EAClD,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;;mBAIQ,eAAe,WACb,YAAY,OAChB,eAAe,GAClB,OAAO,CAAC,gBAAgB,CAAC;;AAL7B,wBASE"}

package/dist/tools/tools/forge-issue-close.impl.js

@@ -0,0 +1,20 @@
+/**
+ * forge-issue-close implementation (lazy-loaded; the unit under test).
+ */
+import { IssueCloseInputSchema } from "./schemas.js";
+import { resolveRepoScopedToolToken } from "../lib/transport.js";
+import { assertIssueItem, defaultTrackingMutationDeps, patchTrackingItem, readTrackingItem } from "./forge-tracking-mutations.js";
+export async function executeIssueClose(input, deps = defaultTrackingMutationDeps, token, runtime) {
+    const parsed = IssueCloseInputSchema.parse(input);
+    const { repoId, item } = await readTrackingItem('forge-issue-close', parsed.repo, parsed.issueNumber, deps, token, runtime);
+    assertIssueItem('forge-issue-close', parsed.issueNumber, item);
+    const updated = await patchTrackingItem('forge-issue-close', repoId, parsed.issueNumber, { status: parsed.status }, deps, token, runtime);
+    return { item: updated };
+}
+export default {
+    async execute(input, runtime, ctx) {
+        const token = await resolveRepoScopedToolToken(runtime, ctx);
+        return executeIssueClose(input, defaultTrackingMutationDeps, token, runtime);
+    }
+};
+//# sourceMappingURL=forge-issue-close.impl.js.map

package/dist/tools/tools/forge-issue-close.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-issue-close.impl.js","sourceRoot":"","sources":["../../../src/tools/tools/forge-issue-close.impl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACN,qBAAqB,EAGrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACN,eAAe,EACf,2BAA2B,EAC3B,iBAAiB,EACjB,gBAAgB,EAEhB,MAAM,+BAA+B,CAAC;AAIvC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,KAAsB,EACtB,OAAuB,2BAA2B,EAClD,KAAc,EACd,OAAsB;IAEtB,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,gBAAgB,CAC9C,mBAAmB,EACnB,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,WAAW,EAClB,IAAI,EACJ,KAAK,EACL,OAAO,CACP,CAAC;IACF,eAAe,CAAC,mBAAmB,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACtC,mBAAmB,EACnB,MAAM,EACN,MAAM,CAAC,WAAW,EAClB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EACzB,IAAI,EACJ,KAAK,EACL,OAAO,CACP,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC1B,CAAC;AAED,eAAe;IACd,KAAK,CAAC,OAAO,CACZ,KAAsB,EACtB,OAAqB,EACrB,GAAoB;QAEpB,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7D,OAAO,iBAAiB,CAAC,KAAK,EAAE,2BAA2B,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;CACD,CAAC"}

package/dist/tools/tools/forge-issue-comment.descriptor.d.ts

@@ -0,0 +1,56 @@
+/**
+ * forge-issue-comment descriptor. Safe to import anywhere (no impl).
+ */
+declare const _default: {
+    readonly kind: "tools/tool";
+    readonly id: "forge-issue-comment";
+    readonly name: "forge-issue-comment";
+    readonly description: "Comment on an issue or PR.";
+    readonly mcpDescription: "Add a comment to an issue or pull request (by #number) on a git repo.";
+    readonly hardware: readonly ["consumer", "cloud"];
+    readonly purpose: ["direct", "worker", "mcp", "agent"];
+    readonly category: "forge";
+    readonly subcategory: "issues";
+    readonly safety: "write";
+    readonly requiresApproval: true;
+    readonly tags: readonly ["forge", "git", "issue", "comment"];
+    readonly schemas: {
+        readonly input: import("zod").ZodObject<{
+            repo: import("zod").ZodString;
+            issueNumber: import("zod").ZodNumber;
+            body: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>;
+        readonly output: import("zod").ZodObject<{
+            comment: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                projectId: import("zod").ZodOptional<import("zod").ZodString>;
+                itemId: import("zod").ZodOptional<import("zod").ZodString>;
+                authorParticipantId: import("zod").ZodOptional<import("zod").ZodString>;
+                body: import("zod").ZodString;
+                source: import("zod").ZodEnum<{
+                    human: "human";
+                    agent: "agent";
+                    system: "system";
+                }>;
+                sourceSessionId: import("zod").ZodOptional<import("zod").ZodString>;
+                ephemeral: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                reviewPath: import("zod").ZodOptional<import("zod").ZodString>;
+                reviewLine: import("zod").ZodOptional<import("zod").ZodNumber>;
+                reviewSide: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    old: "old";
+                    new: "new";
+                }>>;
+                reviewCommitSha: import("zod").ZodOptional<import("zod").ZodString>;
+                reviewState: import("zod").ZodOptional<import("zod").ZodEnum<{
+                    approved: "approved";
+                    "changes-requested": "changes-requested";
+                    commented: "commented";
+                }>>;
+                createdAt: import("zod").ZodOptional<import("zod").ZodString>;
+                updatedAt: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$loose>;
+        }, import("zod/v4/core").$strip>;
+    };
+};
+export default _default;
+//# sourceMappingURL=forge-issue-comment.descriptor.d.ts.map

package/dist/tools/tools/forge-issue-comment.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-issue-comment.descriptor.d.ts","sourceRoot":"","sources":["../../../src/tools/tools/forge-issue-comment.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKH,wBAiBG"}

package/dist/tools/tools/forge-issue-comment.descriptor.js

@@ -0,0 +1,24 @@
+/**
+ * forge-issue-comment descriptor. Safe to import anywhere (no impl).
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel/factory';
+import { IssueCommentInputSchema, IssueCommentOutputSchema } from "./schemas.js";
+export default createRuntimeAsset({
+    kind: 'tools/tool',
+    id: 'forge-issue-comment',
+    name: 'forge-issue-comment',
+    description: 'Comment on an issue or PR.',
+    mcpDescription: 'Add a comment to an issue or pull request (by #number) on a git repo.',
+    hardware: ['consumer', 'cloud'],
+    purpose: ['direct', 'worker', 'mcp', 'agent'],
+    category: 'forge',
+    subcategory: 'issues',
+    safety: 'write',
+    requiresApproval: true,
+    tags: ['forge', 'git', 'issue', 'comment'],
+    schemas: {
+        input: IssueCommentInputSchema,
+        output: IssueCommentOutputSchema
+    }
+});
+//# sourceMappingURL=forge-issue-comment.descriptor.js.map

package/dist/tools/tools/forge-issue-comment.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-issue-comment.descriptor.js","sourceRoot":"","sources":["../../../src/tools/tools/forge-issue-comment.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAEjF,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,4BAA4B;IACzC,cAAc,EAAE,uEAAuE;IACvF,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC;IAC7C,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,QAAQ;IACrB,MAAM,EAAE,OAAO;IACf,gBAAgB,EAAE,IAAI;IACtB,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC;IAC1C,OAAO,EAAE;QACR,KAAK,EAAE,uBAAuB;QAC9B,MAAM,EAAE,wBAAwB;KAChC;CACD,CAAC,CAAC"}

package/dist/tools/tools/forge-issue-comment.impl.d.ts

@@ -0,0 +1,14 @@
+/**
+ * forge-issue-comment implementation (lazy-loaded; the unit under test).
+ *
+ * Resolves repo ref → UUID, then POST to the issue/PR comments route. The
+ * route scopes by repo + issueNumber and derives author from the acting
+ * identity; we send only the body.
+ */
+import type { VibesRuntime, ToolCallContext } from '@vibesdotdev/kernel';
+import { type IssueCommentInput, type IssueCommentOutput } from './schemas.ts';
+declare const _default: {
+    execute(input: IssueCommentInput, runtime: VibesRuntime, ctx: ToolCallContext): Promise<IssueCommentOutput>;
+};
+export default _default;
+//# sourceMappingURL=forge-issue-comment.impl.d.ts.map

package/dist/tools/tools/forge-issue-comment.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-issue-comment.impl.d.ts","sourceRoot":"","sources":["../../../src/tools/tools/forge-issue-comment.impl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAEN,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,MAAM,cAAc,CAAC;;mBAOb,iBAAiB,WACf,YAAY,OAChB,eAAe,GAClB,OAAO,CAAC,kBAAkB,CAAC;;AAL/B,wBAiBE"}

package/dist/tools/tools/forge-issue-comment.impl.js

@@ -0,0 +1,26 @@
+/**
+ * forge-issue-comment implementation (lazy-loaded; the unit under test).
+ *
+ * Resolves repo ref → UUID, then POST to the issue/PR comments route. The
+ * route scopes by repo + issueNumber and derives author from the acting
+ * identity; we send only the body.
+ */
+import { IssueCommentInputSchema } from "./schemas.js";
+import { buildIssueCommentRequest } from "../lib/requests.js";
+import { resolveRepoScopedToolToken, sendForgeToolRequest, requireForgeToolData, forgeToolFailure } from "../lib/transport.js";
+import { resolveRepositoryIdScoped } from "../lib/repo-context.js";
+export default {
+    async execute(input, runtime, ctx) {
+        const parsed = IssueCommentInputSchema.parse(input);
+        const token = await resolveRepoScopedToolToken(runtime, ctx);
+        const scope = token ? { token, runtime } : {};
+        const repoId = await resolveRepositoryIdScoped(parsed.repo, scope);
+        const spec = buildIssueCommentRequest(repoId, parsed);
+        const res = await sendForgeToolRequest(spec, scope);
+        if (!res.ok) {
+            throw forgeToolFailure('forge-issue-comment', res);
+        }
+        return { comment: requireForgeToolData(res, 'forge-issue-comment').result };
+    }
+};
+//# sourceMappingURL=forge-issue-comment.impl.js.map

package/dist/tools/tools/forge-issue-comment.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-issue-comment.impl.js","sourceRoot":"","sources":["../../../src/tools/tools/forge-issue-comment.impl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACN,uBAAuB,EAGvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC/H,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,eAAe;IACd,KAAK,CAAC,OAAO,CACZ,KAAwB,EACxB,OAAqB,EACrB,GAAoB;QAEpB,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAA4C,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/F,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,gBAAgB,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,oBAAoB,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7E,CAAC;CACD,CAAC"}