@vercel/factory 0.0.21 → 0.0.22

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @vercel/factory
 
+## 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. */
@@ -358,6 +376,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 +470,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, GitHubRepositoryRequest, GitHubReviewComment, GitHubReviewCommentAuthorError, type GitHubTreeDeletion, type GitHubTreeEntry, type GitHubTreeUpsert, type GitTransferSandbox, IncompleteCheckRunFields, IssueLabelInput, ListCheckRunsForRefInput, ListConflictedPullRequestsInput, type ListGitHubPublicationPullRequestsInput, 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, 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, listIssueComments, listOpenPullRequests, listPullRequestComments, listPullRequestDiscussion, mintGitHubAppInstallationToken, normalizeFactoryQuestionReply, normalizeFactoryReviewComment, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readCommittedGitChange, 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")}`, {
@@ -557,6 +574,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 +926,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, listIssueComments, listOpenPullRequests, listPullRequestComments, listPullRequestDiscussion, mintGitHubAppInstallationToken, normalizeFactoryQuestionReply, normalizeFactoryReviewComment, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readCommittedGitChange, readIssueComment, readPullRequest, readPullRequestHead, readReviewComment, removeLabel, runSandboxGit, stripFactoryQuestionMention, submitPullRequestReview, updateCheckRun, updatePullRequestComment, verifyGitHubSignature };
 
 //# sourceMappingURL=github.mjs.map