@vercel/factory 0.0.21 → 0.0.23

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @vercel/factory
 
+## 0.0.23
+
+### Patch Changes
+
+- c7bf541: add `readGitHubRepositoryFile` and `listGitHubRepositoryDirectory` to read repository files and directories at a ref, returning null when the path does not exist.
+
+## 0.0.22
+
+### Patch Changes
+
+- 2b90bb3: Validate sandbox harness integration against the harness releases matching AI SDK 7.0.105 to avoid incompatible provider types in fresh installs.
+- f8d68e2: Add `factory create --empty` for deploying an inert Factory host, including support for generating it inside an existing Git worktree.
+- 59e4b10: Add exact-version repository event scripts with durable Task execution, scoped classification,
+  and idempotent GitHub issue comment and label actions.
+- f69894b: Preserve delegated work during session refreshes and scaffold streaming worker command output.
+
 ## 0.0.21
 
 ### Patch Changes

package/dist/build-factory.d.mts

@@ -8,7 +8,7 @@ interface BuildFactoryOptions<TConfig extends EveNextConfig = EveNextConfig> {
   nextConfig: EveNextConfigInput<TConfig>;
   root?: string;
 }
-/** Create an Eve Next.js configuration wrapper for the agents beneath a Factory project root. */
+/** Create a Next.js configuration that mounts the Eve agents beneath a Factory project root. */
 declare function buildFactory<TConfig extends EveNextConfig>({ factoryConfig, nextConfig, root }: BuildFactoryOptions<TConfig>): EveNextConfigFunction<TConfig>;
 //#endregion
 export { BuildFactoryOptions, buildFactory };

package/dist/build-factory.mjs

@@ -2,11 +2,12 @@ import { defineFactory } from "./schema/factory-config.mjs";
 import { readdirSync } from "node:fs";
 import path from "node:path";
 //#region src/build-factory.ts
-/** Create an Eve Next.js configuration wrapper for the agents beneath a Factory project root. */
+/** Create a Next.js configuration that mounts the Eve agents beneath a Factory project root. */
 function buildFactory({ factoryConfig, nextConfig, root = process.cwd() }) {
 	defineFactory(factoryConfig);
 	const agentDefinitions = Object.fromEntries(readdirSync(path.join(root, "agents"), { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => [entry.name, path.join(root, "agents", entry.name)]));
 	return async (phase, context) => {
+		if (Object.keys(agentDefinitions).length === 0) return typeof nextConfig === "function" ? nextConfig(phase, context) : nextConfig;
 		const { withEve } = await import("eve/next");
 		return withEve(nextConfig, { agents: agentDefinitions })(phase, context);
 	};

package/dist/build-factory.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-factory.mjs","names":[],"sources":["../src/build-factory.ts"],"sourcesContent":["import { readdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  type EveNextConfig,\n  type EveNextConfigFunction,\n  type EveNextConfigInput,\n  type WithEveAgentsConfig,\n} from \"eve/next\";\nimport { defineFactory, type FactoryConfigInput } from \"./schema/factory-config\";\n\n/** Inputs for validating a Factory configuration and discovering its Eve agents at build time. */\nexport interface BuildFactoryOptions<TConfig extends EveNextConfig = EveNextConfig> {\n  factoryConfig: FactoryConfigInput;\n  nextConfig: EveNextConfigInput<TConfig>;\n  root?: string;\n}\n\n/** Create an Eve Next.js configuration wrapper for the agents beneath a Factory project root. */\nexport function buildFactory<TConfig extends EveNextConfig>({\n  factoryConfig,\n  nextConfig,\n  root = process.cwd(),\n}: BuildFactoryOptions<TConfig>): EveNextConfigFunction<TConfig> {\n  defineFactory(factoryConfig);\n  const agentDefinitions: WithEveAgentsConfig = Object.fromEntries(\n    readdirSync(path.join(root, \"agents\"), { withFileTypes: true })\n      .filter((entry) => entry.isDirectory())\n      .map((entry) => [entry.name, path.join(root, \"agents\", entry.name)]),\n  );\n  return async (phase, context) => {\n    const { withEve } = await import(\"eve/next\");\n    return withEve(nextConfig, { agents: agentDefinitions })(phase, context);\n  };\n}\n"],"mappings":";;;;;AAkBA,SAAgB,aAA4C,EAC1D,eACA,YACA,OAAO,QAAQ,IAAI,KAC4C;CAC/D,cAAc,aAAa;CAC3B,MAAM,mBAAwC,OAAO,YACnD,YAAY,KAAK,KAAK,MAAM,QAAQ,GAAG,EAAE,eAAe,KAAK,CAAC,CAAC,CAC5D,QAAQ,UAAU,MAAM,YAAY,CAAC,CAAC,CACtC,KAAK,UAAU,CAAC,MAAM,MAAM,KAAK,KAAK,MAAM,UAAU,MAAM,IAAI,CAAC,CAAC,CACvE;CACA,OAAO,OAAO,OAAO,YAAY;EAC/B,MAAM,EAAE,YAAY,MAAM,OAAO;EACjC,OAAO,QAAQ,YAAY,EAAE,QAAQ,iBAAiB,CAAC,CAAC,CAAC,OAAO,OAAO;CACzE;AACF"}
+{"version":3,"file":"build-factory.mjs","names":[],"sources":["../src/build-factory.ts"],"sourcesContent":["import { readdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  type EveNextConfig,\n  type EveNextConfigFunction,\n  type EveNextConfigInput,\n  type WithEveAgentsConfig,\n} from \"eve/next\";\nimport { defineFactory, type FactoryConfigInput } from \"./schema/factory-config\";\n\n/** Inputs for validating a Factory configuration and discovering its Eve agents at build time. */\nexport interface BuildFactoryOptions<TConfig extends EveNextConfig = EveNextConfig> {\n  factoryConfig: FactoryConfigInput;\n  nextConfig: EveNextConfigInput<TConfig>;\n  root?: string;\n}\n\n/** Create a Next.js configuration that mounts the Eve agents beneath a Factory project root. */\nexport function buildFactory<TConfig extends EveNextConfig>({\n  factoryConfig,\n  nextConfig,\n  root = process.cwd(),\n}: BuildFactoryOptions<TConfig>): EveNextConfigFunction<TConfig> {\n  defineFactory(factoryConfig);\n  const agentDefinitions: WithEveAgentsConfig = Object.fromEntries(\n    readdirSync(path.join(root, \"agents\"), { withFileTypes: true })\n      .filter((entry) => entry.isDirectory())\n      .map((entry) => [entry.name, path.join(root, \"agents\", entry.name)]),\n  );\n  return async (phase, context) => {\n    if (Object.keys(agentDefinitions).length === 0) {\n      return typeof nextConfig === \"function\" ? nextConfig(phase, context) : nextConfig;\n    }\n    const { withEve } = await import(\"eve/next\");\n    return withEve(nextConfig, { agents: agentDefinitions })(phase, context);\n  };\n}\n"],"mappings":";;;;;AAkBA,SAAgB,aAA4C,EAC1D,eACA,YACA,OAAO,QAAQ,IAAI,KAC4C;CAC/D,cAAc,aAAa;CAC3B,MAAM,mBAAwC,OAAO,YACnD,YAAY,KAAK,KAAK,MAAM,QAAQ,GAAG,EAAE,eAAe,KAAK,CAAC,CAAC,CAC5D,QAAQ,UAAU,MAAM,YAAY,CAAC,CAAC,CACtC,KAAK,UAAU,CAAC,MAAM,MAAM,KAAK,KAAK,MAAM,UAAU,MAAM,IAAI,CAAC,CAAC,CACvE;CACA,OAAO,OAAO,OAAO,YAAY;EAC/B,IAAI,OAAO,KAAK,gBAAgB,CAAC,CAAC,WAAW,GAC3C,OAAO,OAAO,eAAe,aAAa,WAAW,OAAO,OAAO,IAAI;EAEzE,MAAM,EAAE,YAAY,MAAM,OAAO;EACjC,OAAO,QAAQ,YAAY,EAAE,QAAQ,iBAAiB,CAAC,CAAC,CAAC,OAAO,OAAO;CACzE;AACF"}

package/dist/client.d.mts

@@ -153,11 +153,11 @@ declare class FactoryClient {
     limit?: number;
   }): Promise<{
     items: {
+      deliveryId: string;
       id: `sig_${string}`;
       schemaVersion: 1;
       repositoryId: `repo_${string}`;
       source: SignalSource;
-      deliveryId: string;
       replyTo: {
         channel: string;
         address: string;
@@ -166,6 +166,7 @@ declare class FactoryClient {
       outcome: "pending" | "accepted" | "duplicate" | "unactionable" | "low_confidence" | "ignored";
       repository: string;
       taskIds: `task_${string}`[];
+      reason?: string | undefined;
       triage?: {
         attempt: number;
         state: "running" | "blocked" | "uncertain";
@@ -176,7 +177,6 @@ declare class FactoryClient {
         failure?: "cancelled" | "billing_verification_required" | "provider_failed" | "no_decision" | "launch_unconfirmed" | undefined;
       } | undefined;
       detail?: string | undefined;
-      reason?: string | undefined;
       decidedAt?: string | undefined;
       tasksNextCursor?: string | null | undefined;
     }[];
@@ -184,11 +184,11 @@ declare class FactoryClient {
   }>;
   /** Retry only the observed stopped attempt; concurrent or stale retries conflict. */
   retryIntake(id: string, expectedAttempt: number): Promise<{
+    deliveryId: string;
     id: `sig_${string}`;
     schemaVersion: 1;
     repositoryId: `repo_${string}`;
     source: SignalSource;
-    deliveryId: string;
     replyTo: {
       channel: string;
       address: string;
@@ -197,6 +197,7 @@ declare class FactoryClient {
     outcome: "pending" | "accepted" | "duplicate" | "unactionable" | "low_confidence" | "ignored";
     repository: string;
     taskIds: `task_${string}`[];
+    reason?: string | undefined;
     triage?: {
       attempt: number;
       state: "running" | "blocked" | "uncertain";
@@ -207,7 +208,6 @@ declare class FactoryClient {
       failure?: "cancelled" | "billing_verification_required" | "provider_failed" | "no_decision" | "launch_unconfirmed" | undefined;
     } | undefined;
     detail?: string | undefined;
-    reason?: string | undefined;
     decidedAt?: string | undefined;
     tasksNextCursor?: string | null | undefined;
   }>;

package/dist/eve/task-execution.d.mts

@@ -60,6 +60,10 @@ declare function requireTaskExecution(stores: Pick<FactoryStores, "tasks">, ctx:
   session: Pick<SessionContext["session"], "id" | "auth">;
 }, requestedTaskId: TaskId): Promise<({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -73,10 +77,6 @@ declare function requireTaskExecution(stores: Pick<FactoryStores, "tasks">, ctx:
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -136,6 +136,10 @@ declare function requireTaskExecution(stores: Pick<FactoryStores, "tasks">, ctx:
   parentTaskId?: `task_${string}`;
 }) | ({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -149,10 +153,6 @@ declare function requireTaskExecution(stores: Pick<FactoryStores, "tasks">, ctx:
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -218,6 +218,10 @@ declare function requireTaskExecution(stores: Pick<FactoryStores, "tasks">, ctx:
   parentTaskId?: `task_${string}`;
 }) | ({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -231,10 +235,6 @@ declare function requireTaskExecution(stores: Pick<FactoryStores, "tasks">, ctx:
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -300,6 +300,10 @@ declare function requireTaskExecution(stores: Pick<FactoryStores, "tasks">, ctx:
   parentTaskId: `task_${string}`;
 }) | ({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -313,10 +317,6 @@ declare function requireTaskExecution(stores: Pick<FactoryStores, "tasks">, ctx:
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;

package/dist/github.d.mts

@@ -65,6 +65,10 @@ interface GitHubRepositoryRequest {
 interface GitHubPullRequestTarget extends GitHubRepositoryRequest {
   pullRequestNumber: number;
 }
+/** Repository-scoped identity of one GitHub issue. */
+interface GitHubIssueTarget extends GitHubRepositoryRequest {
+  issueNumber: number;
+}
 /** Provider-owned number and URL that identify one GitHub pull request. */
 interface GitHubPullRequestReference {
   pullRequestNumber: number;
@@ -190,6 +194,12 @@ type ListPullRequestCommentsInput = GitHubPullRequestTarget;
 interface CreatePullRequestCommentInput extends ListPullRequestCommentsInput {
   body: string;
 }
+/** Repository issue whose comments should be listed. */
+type ListIssueCommentsInput = GitHubIssueTarget;
+/** Repository issue and body for a new comment. */
+interface CreateIssueCommentInput extends GitHubIssueTarget {
+  body: string;
+}
 /** Existing issue-style comment and replacement body to persist. */
 interface UpdatePullRequestCommentInput extends GitHubRepositoryRequest {
   commentId: number;
@@ -199,6 +209,10 @@ interface UpdatePullRequestCommentInput extends GitHubRepositoryRequest {
 interface PullRequestLabelInput extends GitHubPullRequestTarget {
   label: string;
 }
+/** Repository issue and label targeted by a metadata-only label operation. */
+interface IssueLabelInput extends GitHubIssueTarget {
+  label: string;
+}
 /** Repository label to create when absent, retaining any existing color and description. */
 interface EnsureGitHubLabelInput extends GitHubRepositoryRequest {
   name: string;
@@ -320,10 +334,14 @@ declare function updateCheckRun(input: UpdateCheckRunInput): Promise<GitHubCheck
 declare function listCheckRunsForRef(input: ListCheckRunsForRefInput): Promise<readonly GitHubCheckRun[]>;
 /** List every issue-style comment in a pull request conversation. */
 declare function listPullRequestComments(input: ListPullRequestCommentsInput): Promise<readonly GitHubIssueComment[]>;
+/** List issue comments with a ten-page bound so reconciliation never scans without limit. */
+declare function listIssueComments(input: ListIssueCommentsInput): Promise<readonly GitHubIssueComment[]>;
 /** Read a page of all PR discussion types without treating any author's text as authorization. */
 declare function listPullRequestDiscussion(input: ListPullRequestDiscussionInput): Promise<GitHubPullRequestDiscussionPage>;
 /** Add one issue-style comment to a pull request conversation. */
 declare function createPullRequestComment(input: CreatePullRequestCommentInput): Promise<GitHubIssueComment>;
+/** Add one issue comment and return GitHub's persisted identity. */
+declare function createIssueComment(input: CreateIssueCommentInput): Promise<GitHubIssueComment>;
 /** Edit one issue-style pull request comment. */
 declare function updatePullRequestComment(input: UpdatePullRequestCommentInput): Promise<GitHubIssueComment>;
 /** One issue comment as GitHub reports it, with the issue it belongs to. */
@@ -344,6 +362,39 @@ declare function readReviewComment(input: ReadReviewCommentInput): Promise<GitHu
 declare function answerReviewComment(input: AnswerReviewCommentInput): Promise<GitHubReviewComment>;
 /** Submit a summary and optional inline comments against a reviewed pull request commit. */
 declare function submitPullRequestReview(input: SubmitPullRequestReviewInput): Promise<SubmittedPullRequestReview>;
+/** Input for reading one text file from a repository branch, tag, or commit. */
+interface ReadGitHubRepositoryFileInput extends GitHubRepositoryRequest {
+  /** Repository-relative file path, such as `.factory/config.yml`. */
+  path: string;
+  /** Branch, tag, or commit to read. Defaults to the repository's default branch. */
+  ref?: string;
+  /** Largest accepted file size in bytes. Default: 65,536. */
+  maxBytes?: number;
+}
+/** One text file read from a repository, with the blob SHA GitHub reports for it. */
+interface GitHubRepositoryFile {
+  sha: string;
+  text: string;
+}
+/** Read one text file from a repository ref, or return null when the path does not exist. */
+declare function readGitHubRepositoryFile(input: ReadGitHubRepositoryFileInput): Promise<GitHubRepositoryFile | null>;
+/** Input for listing the entries directly inside one repository directory. */
+interface ListGitHubRepositoryDirectoryInput extends GitHubRepositoryRequest {
+  /** Repository-relative directory path, such as `.factory/flows`. */
+  path: string;
+  /** Branch, tag, or commit to read. Defaults to the repository's default branch. */
+  ref?: string;
+}
+/** One entry directly inside a repository directory. */
+interface GitHubRepositoryDirectoryEntry {
+  name: string;
+  path: string;
+  type: "file" | "dir" | "symlink" | "submodule";
+  sha: string;
+  size: number;
+}
+/** List the entries directly inside one repository directory, or return null when it does not exist. */
+declare function listGitHubRepositoryDirectory(input: ListGitHubRepositoryDirectoryInput): Promise<GitHubRepositoryDirectoryEntry[] | null>;
 /** Read the current head branch and commit of a pull request. */
 declare function readPullRequestHead(input: GitHubPullRequestTarget): Promise<GitHubPullRequestHead>;
 /** Read the provider-owned identity and lifecycle of one pull request. */
@@ -358,6 +409,8 @@ declare function listOpenPullRequests(input: ListOpenPullRequestsInput): Promise
 declare function ensureGitHubLabel(input: EnsureGitHubLabelInput): Promise<void>;
 /** Add one label to a pull request. */
 declare function addLabel(input: PullRequestLabelInput): Promise<readonly string[]>;
+/** Add one existing repository label to an issue. */
+declare function addIssueLabel(input: IssueLabelInput): Promise<readonly string[]>;
 /** Remove one label from a pull request. */
 declare function removeLabel(input: PullRequestLabelInput): Promise<readonly string[]>;
 /** Raw payload, shared secret, and provider signature used for webhook verification. */
@@ -450,5 +503,5 @@ declare function normalizeGitHubPullRequestClosed(options: WebhookEvent): GitHub
 /** Normalize a completed, unsuccessful GitHub Actions run into a CI failure signal. */
 declare function normalizeGitHubWorkflowRunFailure(options: WebhookEvent): GitHubCiFailureSignal | null;
 //#endregion
-export { AnswerReviewCommentInput, CheckRunAnnotation, CheckRunAnnotationLevel, CheckRunConclusion, CheckRunFields, CheckRunOutput, CheckRunProgressStatus, type CheckoutGitHubRepositoryInput, type CommittedGitChange, CompletedCheckRunFields, ConfiguredEventRepositoryInput, ConflictedGitHubPullRequest, CreateCheckRunInput, type CreateGitHubBranchInput, type CreateGitHubCommitInput, type CreateGitHubPublicationPullRequestInput, type CreateGitHubTreeInput, CreatePullRequestCommentInput, CreatePullRequestInput, type CreatedGitHubPublicationPullRequest, CreatedGitHubPullRequest, EnsureGitHubLabelInput, FactoryMentionOptions, FactoryQuestionReply, FactoryReviewComment, type FetchGitHubBundleInput, type FetchGitHubRefsInput, type GitHubAppFactoryInput, type GitHubAppInstallationToken, type GitHubAppLike, type GitHubAppPermissions, GitHubCheckRun, GitHubCheckoutConflictError, GitHubCiFailureSignal, type GitHubCommit, GitHubDefaultBranchPush, type GitHubGitTransport, GitHubIssueComment, GitHubIssueCommentRecord, GitHubIssueSignal, GitHubPublicationApiError, type GitHubPublicationClient, type GitHubPublicationClientOptions, type GitHubPublicationLimits, type GitHubPublicationPullRequest, GitHubPullRequest, GitHubPullRequestClosed, GitHubPullRequestDiscussionComment, GitHubPullRequestDiscussionPage, GitHubPullRequestDiscussionReview, GitHubPullRequestHead, GitHubPullRequestReference, GitHubPullRequestSignal, GitHubPullRequestTarget, type GitHubRefMapping, GitHubRepositoryAuthorRequest, type GitHubRepositoryBundle, GitHubRepositoryRequest, GitHubReviewComment, GitHubReviewCommentAuthorError, type GitHubTreeDeletion, type GitHubTreeEntry, type GitHubTreeUpsert, type GitTransferSandbox, IncompleteCheckRunFields, ListCheckRunsForRefInput, ListConflictedPullRequestsInput, type ListGitHubPublicationPullRequestsInput, ListOpenPullRequestsInput, ListPullRequestCommentsInput, ListPullRequestDiscussionInput, type MarkGitHubPullRequestReadyInput, type MintGitHubAppInstallationTokenInput, NormalizeFactoryCommentInput, NormalizeFactoryReviewCommentInput, ObservedCheckRunStatus, PullRequestLabelInput, PullRequestReviewComment, PullRequestReviewEvent, type PushGitHubBundleInput, type PushGitHubHeadInput, type ReadCommittedGitChangeInput, type ReadGitHubBranchHeadInput, type ReadGitHubCommitInput, type ReadGitHubPullRequestInput, type ReadGitTransferFileInput, ReadReviewCommentInput, ReviewCommentAuthorPolicy, type RunSandboxGitInput, type SandboxGit, type SandboxGitCommandInput, type SandboxGitCommandResult, StalePullRequestHeadError, SubmitPullRequestReviewInput, SubmittedPullRequestReview, UpdateCheckRunInput, type UpdateGitHubBranchInput, UpdatePullRequestCommentInput, VerifyGitHubSignatureInput, type WithSandboxGitBundleInput, type WriteGitTransferFileInput, addLabel, answerReviewComment, checkoutGitHubRepository, closePullRequest, configuredEventRepositorySlug, createCheckRun, createGitHubPublicationClient, createPullRequest, createPullRequestComment, ensureGitHubLabel, factorySessionBranch, factoryTaskBranch, hasGitHubRepositoryWriteAccess, isSafeGitRef, listCheckRunsForRef, listConflictedPullRequests, listOpenPullRequests, listPullRequestComments, listPullRequestDiscussion, mintGitHubAppInstallationToken, normalizeFactoryQuestionReply, normalizeFactoryReviewComment, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readCommittedGitChange, readIssueComment, readPullRequest, readPullRequestHead, readReviewComment, removeLabel, runSandboxGit, stripFactoryQuestionMention, submitPullRequestReview, updateCheckRun, updatePullRequestComment, verifyGitHubSignature };
+export { AnswerReviewCommentInput, CheckRunAnnotation, CheckRunAnnotationLevel, CheckRunConclusion, CheckRunFields, CheckRunOutput, CheckRunProgressStatus, type CheckoutGitHubRepositoryInput, type CommittedGitChange, CompletedCheckRunFields, ConfiguredEventRepositoryInput, ConflictedGitHubPullRequest, CreateCheckRunInput, type CreateGitHubBranchInput, type CreateGitHubCommitInput, type CreateGitHubPublicationPullRequestInput, type CreateGitHubTreeInput, CreateIssueCommentInput, CreatePullRequestCommentInput, CreatePullRequestInput, type CreatedGitHubPublicationPullRequest, CreatedGitHubPullRequest, EnsureGitHubLabelInput, FactoryMentionOptions, FactoryQuestionReply, FactoryReviewComment, type FetchGitHubBundleInput, type FetchGitHubRefsInput, type GitHubAppFactoryInput, type GitHubAppInstallationToken, type GitHubAppLike, type GitHubAppPermissions, GitHubCheckRun, GitHubCheckoutConflictError, GitHubCiFailureSignal, type GitHubCommit, GitHubDefaultBranchPush, type GitHubGitTransport, GitHubIssueComment, GitHubIssueCommentRecord, GitHubIssueSignal, GitHubIssueTarget, GitHubPublicationApiError, type GitHubPublicationClient, type GitHubPublicationClientOptions, type GitHubPublicationLimits, type GitHubPublicationPullRequest, GitHubPullRequest, GitHubPullRequestClosed, GitHubPullRequestDiscussionComment, GitHubPullRequestDiscussionPage, GitHubPullRequestDiscussionReview, GitHubPullRequestHead, GitHubPullRequestReference, GitHubPullRequestSignal, GitHubPullRequestTarget, type GitHubRefMapping, GitHubRepositoryAuthorRequest, type GitHubRepositoryBundle, GitHubRepositoryDirectoryEntry, GitHubRepositoryFile, GitHubRepositoryRequest, GitHubReviewComment, GitHubReviewCommentAuthorError, type GitHubTreeDeletion, type GitHubTreeEntry, type GitHubTreeUpsert, type GitTransferSandbox, IncompleteCheckRunFields, IssueLabelInput, ListCheckRunsForRefInput, ListConflictedPullRequestsInput, type ListGitHubPublicationPullRequestsInput, ListGitHubRepositoryDirectoryInput, ListIssueCommentsInput, ListOpenPullRequestsInput, ListPullRequestCommentsInput, ListPullRequestDiscussionInput, type MarkGitHubPullRequestReadyInput, type MintGitHubAppInstallationTokenInput, NormalizeFactoryCommentInput, NormalizeFactoryReviewCommentInput, ObservedCheckRunStatus, PullRequestLabelInput, PullRequestReviewComment, PullRequestReviewEvent, type PushGitHubBundleInput, type PushGitHubHeadInput, type ReadCommittedGitChangeInput, type ReadGitHubBranchHeadInput, type ReadGitHubCommitInput, type ReadGitHubPullRequestInput, ReadGitHubRepositoryFileInput, type ReadGitTransferFileInput, ReadReviewCommentInput, ReviewCommentAuthorPolicy, type RunSandboxGitInput, type SandboxGit, type SandboxGitCommandInput, type SandboxGitCommandResult, StalePullRequestHeadError, SubmitPullRequestReviewInput, SubmittedPullRequestReview, UpdateCheckRunInput, type UpdateGitHubBranchInput, UpdatePullRequestCommentInput, VerifyGitHubSignatureInput, type WithSandboxGitBundleInput, type WriteGitTransferFileInput, addIssueLabel, addLabel, answerReviewComment, checkoutGitHubRepository, closePullRequest, configuredEventRepositorySlug, createCheckRun, createGitHubPublicationClient, createIssueComment, createPullRequest, createPullRequestComment, ensureGitHubLabel, factorySessionBranch, factoryTaskBranch, hasGitHubRepositoryWriteAccess, isSafeGitRef, listCheckRunsForRef, listConflictedPullRequests, listGitHubRepositoryDirectory, listIssueComments, listOpenPullRequests, listPullRequestComments, listPullRequestDiscussion, mintGitHubAppInstallationToken, normalizeFactoryQuestionReply, normalizeFactoryReviewComment, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readCommittedGitChange, readGitHubRepositoryFile, readIssueComment, readPullRequest, readPullRequestHead, readReviewComment, removeLabel, runSandboxGit, stripFactoryQuestionMention, submitPullRequestReview, updateCheckRun, updatePullRequestComment, verifyGitHubSignature };
 //# sourceMappingURL=github.d.mts.map

package/dist/github.mjs

@@ -311,6 +311,16 @@ async function listPullRequestComments(input) {
 		if (response.length < 100) return comments;
 	}
 }
+/** List issue comments with a ten-page bound so reconciliation never scans without limit. */
+async function listIssueComments(input) {
+	const comments = [];
+	for (let page = 1; page <= 10; page += 1) {
+		const response = z.array(issueCommentSchema).max(100).parse(await gitHubRequest(input, `/issues/${positiveInteger(input.issueNumber, "issueNumber")}/comments?per_page=100&page=${page}`));
+		comments.push(...response.map(parseIssueComment));
+		if (response.length < 100) return comments;
+	}
+	throw new Error("Issue comment lookup is incomplete after ten pages");
+}
 /** Read a page of all PR discussion types without treating any author's text as authorization. */
 async function listPullRequestDiscussion(input) {
 	const page = z.number().int().positive().parse(input.page ?? 1);
@@ -363,6 +373,13 @@ async function createPullRequestComment(input) {
 		body: JSON.stringify({ body: input.body })
 	}));
 }
+/** Add one issue comment and return GitHub's persisted identity. */
+async function createIssueComment(input) {
+	return parseIssueComment(await gitHubRequest(input, `/issues/${positiveInteger(input.issueNumber, "issueNumber")}/comments`, {
+		method: "POST",
+		body: JSON.stringify({ body: input.body })
+	}));
+}
 /** Edit one issue-style pull request comment. */
 async function updatePullRequestComment(input) {
 	return parseIssueComment(await gitHubRequest(input, `/issues/comments/${positiveInteger(input.commentId, "commentId")}`, {
@@ -447,6 +464,57 @@ async function submitPullRequestReview(input) {
 		state: review.state
 	};
 }
+const repositoryFileSchema = z.object({
+	type: z.literal("file"),
+	sha: z.string().min(1),
+	size: z.number().int().nonnegative(),
+	encoding: z.literal("base64"),
+	content: z.string()
+});
+/** Read one text file from a repository ref, or return null when the path does not exist. */
+async function readGitHubRepositoryFile(input) {
+	const path = repositoryContentsPath(input.path, input.ref);
+	const maxBytes = positiveInteger(input.maxBytes ?? 65536, "maxBytes");
+	const body = await readRepositoryContents(input, path);
+	if (body === null) return null;
+	const file = repositoryFileSchema.parse(body);
+	if (file.size > maxBytes) throw new Error(`${input.path} is ${file.size} bytes, above the ${maxBytes}-byte limit`);
+	return {
+		sha: file.sha,
+		text: Buffer.from(file.content, "base64").toString("utf8")
+	};
+}
+const repositoryDirectorySchema = z.array(z.object({
+	name: z.string().min(1),
+	path: z.string().min(1),
+	type: z.enum([
+		"file",
+		"dir",
+		"symlink",
+		"submodule"
+	]),
+	sha: z.string().min(1),
+	size: z.number().int().nonnegative()
+}));
+function repositoryContentsPath(path, ref) {
+	const segments = path.split("/");
+	if (segments.some((segment) => segment === "" || segment === "." || segment === "..")) throw new Error("path must be a repository-relative file path");
+	const query = ref === void 0 ? "" : `?ref=${encodeURIComponent(ref)}`;
+	return `/contents/${segments.map(encodeURIComponent).join("/")}${query}`;
+}
+async function readRepositoryContents(input, path) {
+	try {
+		return await gitHubRequest(input, path);
+	} catch (error) {
+		if (error instanceof GitHubRequestError && error.status === 404) return null;
+		throw error;
+	}
+}
+/** List the entries directly inside one repository directory, or return null when it does not exist. */
+async function listGitHubRepositoryDirectory(input) {
+	const body = await readRepositoryContents(input, repositoryContentsPath(input.path, input.ref));
+	return body === null ? null : repositoryDirectorySchema.parse(body);
+}
 /** Read the current head branch and commit of a pull request. */
 async function readPullRequestHead(input) {
 	const pull = pullRequestHeadSchema.parse(await gitHubRequest(input, `/pulls/${positiveInteger(input.pullRequestNumber, "pullRequestNumber")}`));
@@ -557,6 +625,13 @@ async function addLabel(input) {
 		body: JSON.stringify({ labels: [input.label] })
 	}));
 }
+/** Add one existing repository label to an issue. */
+async function addIssueLabel(input) {
+	return parseLabels(await gitHubRequest(input, `/issues/${positiveInteger(input.issueNumber, "issueNumber")}/labels`, {
+		method: "POST",
+		body: JSON.stringify({ labels: [input.label] })
+	}));
+}
 /** Remove one label from a pull request. */
 async function removeLabel(input) {
 	return parseLabels(await gitHubRequest(input, `/issues/${positiveInteger(input.pullRequestNumber, "pullRequestNumber")}/labels/${encodeURIComponent(input.label)}`, { method: "DELETE" }));
@@ -902,6 +977,6 @@ function normalizeGitHubWorkflowRunFailure(options) {
 	};
 }
 //#endregion
-export { GitHubCheckoutConflictError, GitHubPublicationApiError, GitHubReviewCommentAuthorError, StalePullRequestHeadError, addLabel, answerReviewComment, checkoutGitHubRepository, closePullRequest, configuredEventRepositorySlug, createCheckRun, createGitHubPublicationClient, createPullRequest, createPullRequestComment, ensureGitHubLabel, factorySessionBranch, factoryTaskBranch, hasGitHubRepositoryWriteAccess, isSafeGitRef, listCheckRunsForRef, listConflictedPullRequests, listOpenPullRequests, listPullRequestComments, listPullRequestDiscussion, mintGitHubAppInstallationToken, normalizeFactoryQuestionReply, normalizeFactoryReviewComment, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readCommittedGitChange, readIssueComment, readPullRequest, readPullRequestHead, readReviewComment, removeLabel, runSandboxGit, stripFactoryQuestionMention, submitPullRequestReview, updateCheckRun, updatePullRequestComment, verifyGitHubSignature };
+export { GitHubCheckoutConflictError, GitHubPublicationApiError, GitHubReviewCommentAuthorError, StalePullRequestHeadError, addIssueLabel, addLabel, answerReviewComment, checkoutGitHubRepository, closePullRequest, configuredEventRepositorySlug, createCheckRun, createGitHubPublicationClient, createIssueComment, createPullRequest, createPullRequestComment, ensureGitHubLabel, factorySessionBranch, factoryTaskBranch, hasGitHubRepositoryWriteAccess, isSafeGitRef, listCheckRunsForRef, listConflictedPullRequests, listGitHubRepositoryDirectory, listIssueComments, listOpenPullRequests, listPullRequestComments, listPullRequestDiscussion, mintGitHubAppInstallationToken, normalizeFactoryQuestionReply, normalizeFactoryReviewComment, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readCommittedGitChange, readGitHubRepositoryFile, readIssueComment, readPullRequest, readPullRequestHead, readReviewComment, removeLabel, runSandboxGit, stripFactoryQuestionMention, submitPullRequestReview, updateCheckRun, updatePullRequestComment, verifyGitHubSignature };
 
 //# sourceMappingURL=github.mjs.map