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

package/dist/tools/tools/forge-pr-stack.shared.impl.js

@@ -0,0 +1,26 @@
+import { ForgePrStackCreateInputSchema, ForgePrStackDissolveInputSchema, ForgePrStackGetInputSchema, ForgePrStackListInputSchema, ForgePrStackMergeInputSchema, ForgePrStackRestackInputSchema, ForgePrStackUpdateInputSchema, ForgePrStackMutationOutputSchema, ForgePrStackListOutputSchema, ForgePrStackGetOutputSchema, ForgePrStackOperationOutputSchema } from "./schemas.js";
+import { buildPrStackCreateRequest, buildPrStackDissolveRequest, buildPrStackGetRequest, buildPrStackListRequest, buildPrStackMergeRequest, buildPrStackRestackRequest, buildPrStackUpdateRequest } from "../lib/requests.js";
+import { resolveRepositoryIdScoped } from "../lib/repo-context.js";
+import { resolveRepoScopedToolToken, sendForgeToolRequest, forgeToolFailure } from "../lib/transport.js";
+const defaultDeps = { resolveRepositoryIdScoped, sendForgeToolRequest };
+async function executeStackRequest(name, input, inputSchema, outputSchema, build, deps, token, runtime) {
+    const parsed = inputSchema.parse(input);
+    const scope = token ? { token, runtime } : {};
+    const repoId = await deps.resolveRepositoryIdScoped(parsed.repo, scope);
+    const response = await deps.sendForgeToolRequest(build(repoId, parsed), scope);
+    if (!response.ok)
+        throw forgeToolFailure(name, response);
+    return outputSchema.parse(response.data);
+}
+export const executePrStackList = (input, deps = defaultDeps, token, runtime) => executeStackRequest('forge-pr-stack-list', input, ForgePrStackListInputSchema, ForgePrStackListOutputSchema, buildPrStackListRequest, deps, token, runtime);
+export const executePrStackGet = (input, deps = defaultDeps, token, runtime) => executeStackRequest('forge-pr-stack-get', input, ForgePrStackGetInputSchema, ForgePrStackGetOutputSchema, buildPrStackGetRequest, deps, token, runtime);
+export const executePrStackCreate = (input, deps = defaultDeps, token, runtime) => executeStackRequest('forge-pr-stack-create', input, ForgePrStackCreateInputSchema, ForgePrStackMutationOutputSchema, buildPrStackCreateRequest, deps, token, runtime);
+export const executePrStackUpdate = (input, deps = defaultDeps, token, runtime) => executeStackRequest('forge-pr-stack-update', input, ForgePrStackUpdateInputSchema, ForgePrStackMutationOutputSchema, buildPrStackUpdateRequest, deps, token, runtime);
+export const executePrStackDissolve = (input, deps = defaultDeps, token, runtime) => executeStackRequest('forge-pr-stack-dissolve', input, ForgePrStackDissolveInputSchema, ForgePrStackMutationOutputSchema, buildPrStackDissolveRequest, deps, token, runtime);
+export const executePrStackRestack = (input, deps = defaultDeps, token, runtime) => executeStackRequest('forge-pr-stack-restack', input, ForgePrStackRestackInputSchema, ForgePrStackOperationOutputSchema, buildPrStackRestackRequest, deps, token, runtime);
+export const executePrStackMerge = (input, deps = defaultDeps, token, runtime) => executeStackRequest('forge-pr-stack-merge', input, ForgePrStackMergeInputSchema, ForgePrStackOperationOutputSchema, buildPrStackMergeRequest, deps, token, runtime);
+export async function executeWithCaller(input, runtime, ctx, execute) {
+    const token = await resolveRepoScopedToolToken(runtime, ctx);
+    return execute(input, defaultDeps, token, runtime);
+}
+//# sourceMappingURL=forge-pr-stack.shared.impl.js.map

package/dist/tools/tools/forge-pr-stack.shared.impl.js.map

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

package/dist/tools/tools/forge-pr-update.descriptor.d.ts

@@ -0,0 +1,135 @@
+/**
+ * forge-pr-update descriptor. Safe to import anywhere (no impl).
+ */
+declare const _default: {
+    readonly kind: "tools/tool";
+    readonly id: "forge-pr-update";
+    readonly name: "forge-pr-update";
+    readonly description: "Update a pull request on a git repository.";
+    readonly mcpDescription: "Update a pull request title, body, tracking status, or base branch.";
+    readonly hardware: readonly ["consumer", "cloud"];
+    readonly purpose: ["direct", "worker", "mcp", "agent"];
+    readonly category: "forge";
+    readonly subcategory: "pull-requests";
+    readonly safety: "write";
+    readonly tags: readonly ["forge", "git", "pr", "pull-request", "update"];
+    readonly schemas: {
+        readonly input: import("zod").ZodObject<{
+            repo: import("zod").ZodString;
+            issueNumber: import("zod").ZodNumber;
+            title: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            status: import("zod").ZodOptional<import("zod").ZodEnum<{
+                done: "done";
+                blocked: "blocked";
+                draft: "draft";
+                backlog: "backlog";
+                planned: "planned";
+                in_progress: "in_progress";
+                in_review: "in_review";
+                cancelled: "cancelled";
+            }>>;
+            effortId: import("zod").ZodOptional<import("zod").ZodUUID>;
+            milestoneId: import("zod").ZodOptional<import("zod").ZodUUID>;
+            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>>>;
+            targetRef: import("zod").ZodOptional<import("zod").ZodString>;
+        }, 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-pr-update.descriptor.d.ts.map

package/dist/tools/tools/forge-pr-update.descriptor.d.ts.map

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

package/dist/tools/tools/forge-pr-update.descriptor.js

@@ -0,0 +1,23 @@
+/**
+ * forge-pr-update descriptor. Safe to import anywhere (no impl).
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel/factory';
+import { PrUpdateInputSchema, PrUpdateOutputSchema } from "./schemas.js";
+export default createRuntimeAsset({
+    kind: 'tools/tool',
+    id: 'forge-pr-update',
+    name: 'forge-pr-update',
+    description: 'Update a pull request on a git repository.',
+    mcpDescription: 'Update a pull request title, body, tracking status, or base branch.',
+    hardware: ['consumer', 'cloud'],
+    purpose: ['direct', 'worker', 'mcp', 'agent'],
+    category: 'forge',
+    subcategory: 'pull-requests',
+    safety: 'write',
+    tags: ['forge', 'git', 'pr', 'pull-request', 'update'],
+    schemas: {
+        input: PrUpdateInputSchema,
+        output: PrUpdateOutputSchema
+    }
+});
+//# sourceMappingURL=forge-pr-update.descriptor.js.map

package/dist/tools/tools/forge-pr-update.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-pr-update.descriptor.js","sourceRoot":"","sources":["../../../src/tools/tools/forge-pr-update.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzE,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,4CAA4C;IACzD,cAAc,EAAE,qEAAqE;IACrF,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,eAAe;IAC5B,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC;IACtD,OAAO,EAAE;QACR,KAAK,EAAE,mBAAmB;QAC1B,MAAM,EAAE,oBAAoB;KAC5B;CACD,CAAC,CAAC"}

package/dist/tools/tools/forge-pr-update.impl.d.ts

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

package/dist/tools/tools/forge-pr-update.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-pr-update.impl.d.ts","sourceRoot":"","sources":["../../../src/tools/tools/forge-pr-update.impl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAG5F,OAAO,EAKN,KAAK,oBAAoB,EACzB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAEhD,wBAAsB,eAAe,CACpC,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,YAA0C,EAChD,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,cAAc,CAAC,CAsBzB;;mBAIQ,aAAa,WACX,YAAY,OAChB,eAAe,GAClB,OAAO,CAAC,cAAc,CAAC;;AAL3B,wBASE"}

package/dist/tools/tools/forge-pr-update.impl.js

@@ -0,0 +1,22 @@
+/**
+ * forge-pr-update implementation (lazy-loaded; the unit under test).
+ */
+import { PrUpdateInputSchema } from "./schemas.js";
+import { buildPrUpdatePatchBody } from "../lib/requests.js";
+import { resolveRepoScopedToolToken } from "../lib/transport.js";
+import { assertPrItem, defaultTrackingMutationDeps, patchTrackingItem, readTrackingItem } from "./forge-tracking-mutations.js";
+export async function executePrUpdate(input, deps = defaultTrackingMutationDeps, token, runtime) {
+    const parsed = PrUpdateInputSchema.parse(input);
+    const { repoId, item } = await readTrackingItem('forge-pr-update', parsed.repo, parsed.issueNumber, deps, token, runtime);
+    assertPrItem('forge-pr-update', parsed.issueNumber, item);
+    const pr = parsed.targetRef ? { ...item.pr, targetRef: parsed.targetRef } : undefined;
+    const updated = await patchTrackingItem('forge-pr-update', repoId, parsed.issueNumber, buildPrUpdatePatchBody(parsed, pr), deps, token, runtime);
+    return { item: updated };
+}
+export default {
+    async execute(input, runtime, ctx) {
+        const token = await resolveRepoScopedToolToken(runtime, ctx);
+        return executePrUpdate(input, defaultTrackingMutationDeps, token, runtime);
+    }
+};
+//# sourceMappingURL=forge-pr-update.impl.js.map

package/dist/tools/tools/forge-pr-update.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-pr-update.impl.js","sourceRoot":"","sources":["../../../src/tools/tools/forge-pr-update.impl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,mBAAmB,EAA2C,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACN,YAAY,EACZ,2BAA2B,EAC3B,iBAAiB,EACjB,gBAAgB,EAEhB,MAAM,+BAA+B,CAAC;AAIvC,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,KAAoB,EACpB,OAAqB,2BAA2B,EAChD,KAAc,EACd,OAAsB;IAEtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,gBAAgB,CAC9C,iBAAiB,EACjB,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,WAAW,EAClB,IAAI,EACJ,KAAK,EACL,OAAO,CACP,CAAC;IACF,YAAY,CAAC,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACtC,iBAAiB,EACjB,MAAM,EACN,MAAM,CAAC,WAAW,EAClB,sBAAsB,CAAC,MAAM,EAAE,EAAE,CAAC,EAClC,IAAI,EACJ,KAAK,EACL,OAAO,CACP,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC1B,CAAC;AAED,eAAe;IACd,KAAK,CAAC,OAAO,CACZ,KAAoB,EACpB,OAAqB,EACrB,GAAoB;QAEpB,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7D,OAAO,eAAe,CAAC,KAAK,EAAE,2BAA2B,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;CACD,CAAC"}

package/dist/tools/tools/forge-read-file.descriptor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * forge-read-file descriptor. Safe to import anywhere (no impl).
+ *
+ * The ONE tool that reads from the git host (browse/blob) rather than
+ * platform-web — read-only, token-scoped (a short-lived repo:read deploy
+ * token minted through the platform tokens route for the acting caller).
+ */
+declare const _default: {
+    readonly kind: "tools/tool";
+    readonly id: "forge-read-file";
+    readonly name: "forge-read-file";
+    readonly description: "Read a file from a git repository at a given ref.";
+    readonly mcpDescription: "Read a file from a git repository at a branch, tag, or commit sha.";
+    readonly hardware: readonly ["consumer", "cloud"];
+    readonly purpose: ["direct", "worker", "mcp", "agent"];
+    readonly category: "forge";
+    readonly subcategory: "files";
+    readonly safety: "read";
+    readonly requiresApproval: false;
+    readonly tags: readonly ["forge", "git", "file", "blob", "read"];
+    readonly schemas: {
+        readonly input: import("zod").ZodObject<{
+            repo: import("zod").ZodString;
+            path: import("zod").ZodString;
+            ref: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        readonly output: import("zod").ZodObject<{
+            path: import("zod").ZodString;
+            ref: import("zod").ZodString;
+            binary: import("zod").ZodBoolean;
+            size: import("zod").ZodNumber;
+            content: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+    };
+};
+export default _default;
+//# sourceMappingURL=forge-read-file.descriptor.d.ts.map

package/dist/tools/tools/forge-read-file.descriptor.d.ts.map

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

package/dist/tools/tools/forge-read-file.descriptor.js

@@ -0,0 +1,28 @@
+/**
+ * forge-read-file descriptor. Safe to import anywhere (no impl).
+ *
+ * The ONE tool that reads from the git host (browse/blob) rather than
+ * platform-web — read-only, token-scoped (a short-lived repo:read deploy
+ * token minted through the platform tokens route for the acting caller).
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel/factory';
+import { ReadFileInputSchema, ReadFileOutputSchema } from "./schemas.js";
+export default createRuntimeAsset({
+    kind: 'tools/tool',
+    id: 'forge-read-file',
+    name: 'forge-read-file',
+    description: 'Read a file from a git repository at a given ref.',
+    mcpDescription: 'Read a file from a git repository at a branch, tag, or commit sha.',
+    hardware: ['consumer', 'cloud'],
+    purpose: ['direct', 'worker', 'mcp', 'agent'],
+    category: 'forge',
+    subcategory: 'files',
+    safety: 'read',
+    requiresApproval: false,
+    tags: ['forge', 'git', 'file', 'blob', 'read'],
+    schemas: {
+        input: ReadFileInputSchema,
+        output: ReadFileOutputSchema
+    }
+});
+//# sourceMappingURL=forge-read-file.descriptor.js.map

package/dist/tools/tools/forge-read-file.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-read-file.descriptor.js","sourceRoot":"","sources":["../../../src/tools/tools/forge-read-file.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzE,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,mDAAmD;IAChE,cAAc,EAAE,oEAAoE;IACpF,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,OAAO;IACpB,MAAM,EAAE,MAAM;IACd,gBAAgB,EAAE,KAAK;IACvB,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC9C,OAAO,EAAE;QACR,KAAK,EAAE,mBAAmB;QAC1B,MAAM,EAAE,oBAAoB;KAC5B;CACD,CAAC,CAAC"}

package/dist/tools/tools/forge-read-file.impl.d.ts

@@ -0,0 +1,32 @@
+/**
+ * forge-read-file implementation (lazy-loaded; the unit under test).
+ *
+ * Provider-neutral repository read flow:
+ *   1. resolve the persisted repository record through the caller-scoped
+ *      platform API (RBAC + 404-IDOR apply to the acting user);
+ *   2. resolve its registered `git/repository` provider from the supplied
+ *      runtime;
+ *   3. mint a short-lived repo:read deploy token through the platform tokens
+ *      route (so private repos resolve);
+ *   4. invoke the provider's optional neutral `readFile` capability.
+ *
+ * Stays strictly read-only + token-scoped. A missing blob (host 404) surfaces
+ * as a clear error rather than a faked empty read.
+ */
+import { type VibesRuntime, type ToolCallContext } from '@vibesdotdev/kernel';
+import { resolveRepositoryProvider } from '@vibesdotdev/git-operations/repository';
+import { type ReadFileInput, type ReadFileOutput } from './schemas.ts';
+import { resolveRepoHostContext, mintReadToken } from '../lib/repo-context.ts';
+export interface ForgeReadFileDependencies {
+    resolveRepositoryProvider: typeof resolveRepositoryProvider;
+    resolveRepoHostContext: typeof resolveRepoHostContext;
+    mintReadToken: typeof mintReadToken;
+}
+export declare function executeForgeReadFile(input: ReadFileInput, runtime: VibesRuntime, options?: {
+    token?: string;
+}, dependencies?: ForgeReadFileDependencies): Promise<ReadFileOutput>;
+declare const _default: {
+    execute(input: ReadFileInput, runtime: VibesRuntime, ctx: ToolCallContext): Promise<ReadFileOutput>;
+};
+export default _default;
+//# sourceMappingURL=forge-read-file.impl.d.ts.map

package/dist/tools/tools/forge-read-file.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-read-file.impl.d.ts","sourceRoot":"","sources":["../../../src/tools/tools/forge-read-file.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG/E,MAAM,WAAW,yBAAyB;IACzC,yBAAyB,EAAE,OAAO,yBAAyB,CAAC;IAC5D,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,aAAa,EAAE,OAAO,aAAa,CAAC;CACpC;AAQD,wBAAsB,oBAAoB,CACzC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EAChC,YAAY,GAAE,yBAA+C,GAC3D,OAAO,CAAC,cAAc,CAAC,CAqCzB;;mBAIQ,aAAa,WACX,YAAY,OAChB,eAAe,GAClB,OAAO,CAAC,cAAc,CAAC;;AAL3B,wBASE"}

package/dist/tools/tools/forge-read-file.impl.js

@@ -0,0 +1,69 @@
+/**
+ * forge-read-file implementation (lazy-loaded; the unit under test).
+ *
+ * Provider-neutral repository read flow:
+ *   1. resolve the persisted repository record through the caller-scoped
+ *      platform API (RBAC + 404-IDOR apply to the acting user);
+ *   2. resolve its registered `git/repository` provider from the supplied
+ *      runtime;
+ *   3. mint a short-lived repo:read deploy token through the platform tokens
+ *      route (so private repos resolve);
+ *   4. invoke the provider's optional neutral `readFile` capability.
+ *
+ * Stays strictly read-only + token-scoped. A missing blob (host 404) surfaces
+ * as a clear error rather than a faked empty read.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { resolveRepositoryProvider } from '@vibesdotdev/git-operations/repository';
+import { ReadFileInputSchema } from "./schemas.js";
+import { resolveRepoHostContext, mintReadToken } from "../lib/repo-context.js";
+import { resolveRepoScopedToolToken } from "../lib/transport.js";
+const defaultDependencies = {
+    resolveRepositoryProvider,
+    resolveRepoHostContext,
+    mintReadToken
+};
+export async function executeForgeReadFile(input, runtime, options = {}, dependencies = defaultDependencies) {
+    const parsed = ReadFileInputSchema.parse(input);
+    const scope = options.token ? { token: options.token, runtime } : {};
+    const context = await dependencies.resolveRepoHostContext(parsed.repo, scope);
+    const repository = context.repository;
+    const provider = await dependencies.resolveRepositoryProvider(runtime, repository.provider);
+    if (!provider.readFile) {
+        throw new CapabilityError('forge-read-file: the repository provider does not support file reads.', 'UNAVAILABLE', {
+            reason: 'provider-read-unsupported',
+            retryable: false,
+            details: { provider: repository.provider }
+        });
+    }
+    const readToken = await dependencies.mintReadToken(context.id, scope);
+    const ref = parsed.ref ?? repository.defaultBranch;
+    const blob = await provider.readFile({
+        repository,
+        ref,
+        path: parsed.path,
+        credential: { username: 'vibes-deploy', token: readToken }
+    });
+    if (!blob) {
+        throw new CapabilityError('forge-read-file: the file was not found at that ref.', 'NOT_FOUND', {
+            reason: 'file-not-found',
+            details: { path: parsed.path.slice(0, 500), ref: ref.slice(0, 200), repositoryId: context.id }
+        });
+    }
+    const output = {
+        path: blob.path,
+        ref,
+        binary: blob.binary,
+        size: blob.size
+    };
+    if (blob.content !== undefined)
+        output.content = blob.content;
+    return output;
+}
+export default {
+    async execute(input, runtime, ctx) {
+        const token = await resolveRepoScopedToolToken(runtime, ctx);
+        return executeForgeReadFile(input, runtime, token ? { token } : {});
+    }
+};
+//# sourceMappingURL=forge-read-file.impl.js.map

package/dist/tools/tools/forge-read-file.impl.js.map

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

package/dist/tools/tools/forge-tracking-mutations.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared issue/PR mutation helpers for forge tools.
+ *
+ * These helpers keep every mutating issue/PR tool on the same safety rail:
+ * resolve repo under the acting caller, read the current item, assert the
+ * expected item type, then PATCH through the platform route that owns RBAC and
+ * persistence.
+ */
+import type { IssueGetOutput } from './schemas.ts';
+import { type TrackingItemPatchBody } from '../lib/requests.ts';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { resolveRepositoryIdScoped } from '../lib/repo-context.ts';
+import { sendForgeToolRequest } from '../lib/transport.ts';
+export type TrackingToolItem = IssueGetOutput['item'];
+export type TrackingToolPr = NonNullable<TrackingToolItem['pr']>;
+export interface TrackingMutationDeps {
+    resolveRepositoryIdScoped: typeof resolveRepositoryIdScoped;
+    sendForgeToolRequest: typeof sendForgeToolRequest;
+}
+export declare const defaultTrackingMutationDeps: TrackingMutationDeps;
+export declare function readTrackingItem(toolId: string, repo: string, issueNumber: number, deps: TrackingMutationDeps, token?: string, runtime?: VibesRuntime): Promise<{
+    repoId: string;
+    item: TrackingToolItem;
+}>;
+export declare function patchTrackingItem(toolId: string, repoId: string, issueNumber: number, body: TrackingItemPatchBody, deps: TrackingMutationDeps, token?: string, runtime?: VibesRuntime): Promise<TrackingToolItem>;
+export declare function assertIssueItem(toolId: string, issueNumber: number, item: TrackingToolItem): void;
+export declare function assertPrItem(toolId: string, issueNumber: number, item: TrackingToolItem): asserts item is TrackingToolItem & {
+    type: 'pr';
+    pr: TrackingToolPr;
+};
+//# sourceMappingURL=forge-tracking-mutations.d.ts.map

package/dist/tools/tools/forge-tracking-mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-tracking-mutations.d.ts","sourceRoot":"","sources":["../../../src/tools/tools/forge-tracking-mutations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAGN,KAAK,qBAAqB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAoB,MAAM,qBAAqB,CAAC;AAE7E,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACpC,yBAAyB,EAAE,OAAO,yBAAyB,CAAC;IAC5D,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;CAClD;AAED,eAAO,MAAM,2BAA2B,EAAE,oBAGzC,CAAC;AAEF,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,oBAAoB,EAC1B,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAWrD;AAED,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE,oBAAoB,EAC1B,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAU3B;AAED,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,gBAAgB,GACpB,IAAI,CAON;AAED,wBAAgB,YAAY,CAC3B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,gBAAgB,GACpB,OAAO,CAAC,IAAI,IAAI,gBAAgB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,cAAc,CAAA;CAAE,CAcvE"}

package/dist/tools/tools/forge-tracking-mutations.js

@@ -0,0 +1,57 @@
+/**
+ * Shared issue/PR mutation helpers for forge tools.
+ *
+ * These helpers keep every mutating issue/PR tool on the same safety rail:
+ * resolve repo under the acting caller, read the current item, assert the
+ * expected item type, then PATCH through the platform route that owns RBAC and
+ * persistence.
+ */
+import { buildIssueGetRequest, buildIssuePatchRequest } from "../lib/requests.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { resolveRepositoryIdScoped } from "../lib/repo-context.js";
+import { sendForgeToolRequest, forgeToolFailure } from "../lib/transport.js";
+export const defaultTrackingMutationDeps = {
+    resolveRepositoryIdScoped,
+    sendForgeToolRequest
+};
+export async function readTrackingItem(toolId, repo, issueNumber, deps, token, runtime) {
+    const scope = token ? { token, runtime } : {};
+    const repoId = await deps.resolveRepositoryIdScoped(repo, scope);
+    const res = await deps.sendForgeToolRequest(buildIssueGetRequest(repoId, { repo, issueNumber }), scope);
+    if (!res.ok) {
+        throw forgeToolFailure(toolId, res);
+    }
+    return { repoId, item: res.data.result };
+}
+export async function patchTrackingItem(toolId, repoId, issueNumber, body, deps, token, runtime) {
+    const scope = token ? { token, runtime } : {};
+    const res = await deps.sendForgeToolRequest(buildIssuePatchRequest(repoId, issueNumber, body), scope);
+    if (!res.ok) {
+        throw forgeToolFailure(toolId, res);
+    }
+    return res.data.result;
+}
+export function assertIssueItem(toolId, issueNumber, item) {
+    if (item.type === 'pr') {
+        throw new CapabilityError(`${toolId} expected an issue, but the item is a pull request.`, 'INVALID_INPUT', {
+            reason: 'issue-required',
+            details: { tool: toolId, issueNumber }
+        });
+    }
+}
+export function assertPrItem(toolId, issueNumber, item) {
+    if (item.type !== 'pr') {
+        throw new CapabilityError(`${toolId} expected a pull request, but the item is an issue.`, 'INVALID_INPUT', {
+            reason: 'pull-request-required',
+            details: { tool: toolId, issueNumber }
+        });
+    }
+    if (!item.pr) {
+        throw new CapabilityError(`${toolId} expected pull-request metadata on the item.`, 'UNAVAILABLE', {
+            reason: 'pull-request-metadata-missing',
+            retryable: false,
+            details: { tool: toolId, issueNumber }
+        });
+    }
+}
+//# sourceMappingURL=forge-tracking-mutations.js.map

package/dist/tools/tools/forge-tracking-mutations.js.map

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

package/dist/tools/tools/schemas.d.ts

@@ -0,0 +1,27 @@
+/**
+ * forge-tools input/output schemas (zod/v4).
+ *
+ * Inputs mirror the platform forge API contracts forge-cli already maps — the
+ * tools never re-derive server-owned fields (projectId / repositoryId /
+ * ownerParticipantId / itemId / authorParticipantId are stripped, the route
+ * derives them from the acting identity + path scope). A `repo` ref accepts
+ * `<owner>/<name>` | `<name>` | UUID exactly like forge-cli's repo-ref.
+ */
+import * as z from 'zod/v4';
+export { IssueCloseInputSchema, IssueCloseOutputSchema, IssueCommentInputSchema, IssueCommentOutputSchema, IssueCommentsListInputSchema, IssueCommentsListOutputSchema, IssueCreateInputSchema, IssueCreateOutputSchema, IssueGetInputSchema, IssueGetOutputSchema, IssueListInputSchema, IssueListOutputSchema, IssueReopenInputSchema, IssueReopenOutputSchema, IssueSearchInputSchema, IssueSearchOutputSchema, IssueUpdateInputSchema, IssueUpdateOutputSchema, ListReposInputSchema, ListReposOutputSchema, PrCloseInputSchema, PrCloseOutputSchema, PrCreateFromBranchInputSchema, PrCreateFromBranchOutputSchema, PrCreateInputSchema, PrCreateOutputSchema, PrFilesInputSchema, PrFilesOutputSchema, PrGetInputSchema, PrGetOutputSchema, PrListInputSchema, PrListOutputSchema, PrMergeInputSchema, PrMergeOutputSchema, PrMergeStatusInputSchema, PrMergeStatusOutputSchema, PrReopenInputSchema, PrReopenOutputSchema, PrReviewCommentInputSchema, PrReviewCommentOutputSchema, PrSearchInputSchema, PrSearchOutputSchema, PrUpdateInputSchema, PrUpdateOutputSchema, ForgePrStackCreateInputSchema, ForgePrStackDissolveInputSchema, ForgePrStackGetInputSchema, ForgePrStackListInputSchema, ForgePrStackMergeInputSchema, ForgePrStackRestackInputSchema, ForgePrStackUpdateInputSchema, ForgePrStackMutationOutputSchema, ForgePrStackListOutputSchema, ForgePrStackGetOutputSchema, ForgePrStackOperationOutputSchema } from '../../schemas.ts';
+export type { IssueCloseInput, IssueCloseOutput, IssueCommentInput, IssueCommentOutput, IssueCommentsListInput, IssueCommentsListOutput, IssueCreateInput, IssueCreateOutput, IssueGetInput, IssueGetOutput, IssueListInput, IssueListOutput, IssueReopenInput, IssueReopenOutput, IssueSearchInput, IssueSearchOutput, IssueUpdateInput, IssueUpdateOutput, ListReposInput, ListReposOutput, PrCloseInput, PrCloseOutput, PrCreateFromBranchInput, PrCreateFromBranchOutput, PrCreateInput, PrCreateOutput, PrFilesInput, PrFilesOutput, PrGetInput, PrGetOutput, PrListInput, PrListOutput, PrMergeInput, PrMergeOutput, PrMergeStatusInput, PrMergeStatusOutput, PrReopenInput, PrReopenOutput, PrReviewCommentInput, PrReviewCommentOutput, PrSearchInput, PrSearchOutput, PrUpdateInput, PrUpdateOutput, ForgePrStackCreateInput, ForgePrStackDissolveInput, ForgePrStackGetInput, ForgePrStackListInput, ForgePrStackMergeInput, ForgePrStackRestackInput, ForgePrStackUpdateInput, ForgePrStackMutationOutput, ForgePrStackListOutput, ForgePrStackGetOutput, ForgePrStackOperationOutput } from '../../schemas.ts';
+export declare const ReadFileInputSchema: z.ZodObject<{
+    repo: z.ZodString;
+    path: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ReadFileOutputSchema: z.ZodObject<{
+    path: z.ZodString;
+    ref: z.ZodString;
+    binary: z.ZodBoolean;
+    size: z.ZodNumber;
+    content: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ReadFileInput = z.infer<typeof ReadFileInputSchema>;
+export type ReadFileOutput = z.infer<typeof ReadFileOutputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/tools/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/tools/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EACN,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,6BAA6B,EAC7B,+BAA+B,EAC/B,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,8BAA8B,EAC9B,6BAA6B,EAC7B,gCAAgC,EAChC,4BAA4B,EAC5B,2BAA2B,EAC3B,iCAAiC,EACjC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,mBAAmB;;;;iBAO9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;iBAM/B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/tools/tools/schemas.js

@@ -0,0 +1,29 @@
+/**
+ * forge-tools input/output schemas (zod/v4).
+ *
+ * Inputs mirror the platform forge API contracts forge-cli already maps — the
+ * tools never re-derive server-owned fields (projectId / repositoryId /
+ * ownerParticipantId / itemId / authorParticipantId are stripped, the route
+ * derives them from the acting identity + path scope). A `repo` ref accepts
+ * `<owner>/<name>` | `<name>` | UUID exactly like forge-cli's repo-ref.
+ */
+import { RepoRefSchema } from "../../schemas/wire-contracts.js";
+import * as z from 'zod/v4';
+export { IssueCloseInputSchema, IssueCloseOutputSchema, IssueCommentInputSchema, IssueCommentOutputSchema, IssueCommentsListInputSchema, IssueCommentsListOutputSchema, IssueCreateInputSchema, IssueCreateOutputSchema, IssueGetInputSchema, IssueGetOutputSchema, IssueListInputSchema, IssueListOutputSchema, IssueReopenInputSchema, IssueReopenOutputSchema, IssueSearchInputSchema, IssueSearchOutputSchema, IssueUpdateInputSchema, IssueUpdateOutputSchema, ListReposInputSchema, ListReposOutputSchema, PrCloseInputSchema, PrCloseOutputSchema, PrCreateFromBranchInputSchema, PrCreateFromBranchOutputSchema, PrCreateInputSchema, PrCreateOutputSchema, PrFilesInputSchema, PrFilesOutputSchema, PrGetInputSchema, PrGetOutputSchema, PrListInputSchema, PrListOutputSchema, PrMergeInputSchema, PrMergeOutputSchema, PrMergeStatusInputSchema, PrMergeStatusOutputSchema, PrReopenInputSchema, PrReopenOutputSchema, PrReviewCommentInputSchema, PrReviewCommentOutputSchema, PrSearchInputSchema, PrSearchOutputSchema, PrUpdateInputSchema, PrUpdateOutputSchema, ForgePrStackCreateInputSchema, ForgePrStackDissolveInputSchema, ForgePrStackGetInputSchema, ForgePrStackListInputSchema, ForgePrStackMergeInputSchema, ForgePrStackRestackInputSchema, ForgePrStackUpdateInputSchema, ForgePrStackMutationOutputSchema, ForgePrStackListOutputSchema, ForgePrStackGetOutputSchema, ForgePrStackOperationOutputSchema } from "../../schemas.js";
+// ── forge-read-file ───────────────────────────────────────────────────────
+export const ReadFileInputSchema = z.object({
+    repo: RepoRefSchema,
+    path: z.string().min(1).describe('File path relative to the repository root.'),
+    ref: z
+        .string()
+        .optional()
+        .describe('Git ref (branch / tag / sha) to read at. Defaults to the repo default branch.')
+});
+export const ReadFileOutputSchema = z.object({
+    path: z.string(),
+    ref: z.string(),
+    binary: z.boolean(),
+    size: z.number(),
+    content: z.string().optional().describe('utf8 content; omitted for binary blobs.')
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/tools/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/tools/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EACN,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,6BAA6B,EAC7B,+BAA+B,EAC/B,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,8BAA8B,EAC9B,6BAA6B,EAC7B,gCAAgC,EAChC,4BAA4B,EAC5B,2BAA2B,EAC3B,iCAAiC,EACjC,MAAM,kBAAkB,CAAC;AA2D1B,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC9E,GAAG,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+EAA+E,CAAC;CAC3F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CAClF,CAAC,CAAC"}