pullfrog 0.0.203 → 0.0.205

package/dist/utils/progressComment.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Single source of truth for reading, updating, deleting, and creating "progress comments" —
+ * the GitHub comments Pullfrog uses to surface a run's status.
+ *
+ * A progress comment can be one of two distinct GitHub entities with non-overlapping IDs and
+ * distinct REST endpoints:
+ *   - "issue":  a top-level issue/PR timeline comment (octokit.rest.issues.*Comment)
+ *   - "review": an inline PR review-thread comment   (octokit.rest.pulls.*ReviewComment)
+ *
+ * Callers carry a `ProgressComment` (id + type) value end-to-end so the right endpoint is always
+ * picked. Adding a third comment type later means one new branch in this file, not six.
+ */
+export type ProgressCommentType = "issue" | "review";
+export type ProgressComment = {
+    id: number;
+    type: ProgressCommentType;
+};
+/**
+ * Parse the on-the-wire `{ id: string; type }` shape (the form carried in `JsonPayload`)
+ * into the in-memory `ProgressComment` shape. Returns undefined when the id isn't a
+ * positive integer so callers can short-circuit cleanly. Callers handle logging.
+ */
+export declare function parseProgressComment(raw: {
+    id: string;
+    type: ProgressCommentType;
+} | null | undefined): ProgressComment | undefined;
+interface CommentResponse {
+    data: {
+        id: number;
+        body?: string | null | undefined;
+        html_url: string;
+        node_id?: string;
+    };
+}
+export interface ProgressCommentOctokit {
+    rest: {
+        issues: {
+            createComment: (params: {
+                owner: string;
+                repo: string;
+                issue_number: number;
+                body: string;
+            }) => Promise<CommentResponse>;
+            getComment: (params: {
+                owner: string;
+                repo: string;
+                comment_id: number;
+            }) => Promise<CommentResponse>;
+            updateComment: (params: {
+                owner: string;
+                repo: string;
+                comment_id: number;
+                body: string;
+            }) => Promise<CommentResponse>;
+            deleteComment: (params: {
+                owner: string;
+                repo: string;
+                comment_id: number;
+            }) => Promise<unknown>;
+        };
+        pulls: {
+            createReplyForReviewComment: (params: {
+                owner: string;
+                repo: string;
+                pull_number: number;
+                comment_id: number;
+                body: string;
+            }) => Promise<CommentResponse>;
+            getReviewComment: (params: {
+                owner: string;
+                repo: string;
+                comment_id: number;
+            }) => Promise<CommentResponse>;
+            updateReviewComment: (params: {
+                owner: string;
+                repo: string;
+                comment_id: number;
+                body: string;
+            }) => Promise<CommentResponse>;
+            deleteReviewComment: (params: {
+                owner: string;
+                repo: string;
+                comment_id: number;
+            }) => Promise<unknown>;
+        };
+    };
+}
+interface ApiCtx {
+    octokit: ProgressCommentOctokit;
+    owner: string;
+    repo: string;
+}
+/**
+ * Fetch a progress comment via the appropriate REST endpoint for its type.
+ * Returns the common subset of fields callers actually use.
+ */
+export declare function getProgressComment(ctx: ApiCtx, comment: ProgressComment): Promise<{
+    id: number;
+    body: string | undefined;
+    html_url: string;
+}>;
+/**
+ * Update a progress comment in place via the appropriate REST endpoint.
+ * Returns the common subset of fields callers actually use.
+ */
+export declare function updateProgressComment(ctx: ApiCtx, comment: ProgressComment, body: string): Promise<{
+    id: number;
+    body: string | undefined;
+    html_url: string;
+    node_id: string | undefined;
+}>;
+/**
+ * Delete a progress comment via the appropriate REST endpoint.
+ * Lower-level than `deleteProgressComment` in mcp/comment.ts — that one also clears
+ * tool state. Callers that don't have a ToolContext (post cleanup, error handlers)
+ * should use this directly; the higher-level wrapper delegates here.
+ */
+export declare function deleteProgressCommentApi(ctx: ApiCtx, comment: ProgressComment): Promise<void>;
+/**
+ * Discriminated target for `createLeapingProgressComment`. The two variants map to the two
+ * distinct GitHub create endpoints; review-reply additionally needs the parent comment ID.
+ */
+export type CreateProgressCommentTarget = {
+    kind: "issue";
+    issueNumber: number;
+} | {
+    kind: "reviewReply";
+    pullNumber: number;
+    replyToCommentId: number;
+};
+export interface CreatedProgressComment {
+    comment: ProgressComment;
+    body: string | undefined;
+    html_url: string;
+}
+/**
+ * Create the initial "Leaping into action..." progress comment.
+ *
+ * Reliability: when `kind: "reviewReply"` fails (e.g. the parent comment was deleted or the
+ * thread is otherwise unreachable), falls back to a top-level issue comment on the same PR
+ * rather than leaving the run with no progress surface. The fallback is logged.
+ *
+ * (PR # === issue # in GitHub's number space, so `pullNumber` doubles as the fallback target.)
+ */
+export declare function createLeapingProgressComment(ctx: ApiCtx, target: CreateProgressCommentTarget, body: string): Promise<CreatedProgressComment>;
+export {};

package/dist/utils/runContext.d.ts

@@ -20,10 +20,26 @@ export interface RepoSettings {
     learnings: string | null;
     envAllowlist: string | null;
 }
+/**
+ * Account-level billing plan. Orthogonal to repo-level OSS status. Mirrors
+ * the server's `AccountPlan` in `utils/billing.ts`. `"none"` = free tier,
+ * `"payg"` = card on file / pay-as-you-go.
+ */
+export type AccountPlan = "none" | "payg";
+/**
+ * "Is Pullfrog absorbing marginal infra cost for this repo?" — composite
+ * predicate over the two orthogonal dimensions (repo-level OSS, account-level
+ * plan). Mirrors `isInfraCovered` in the server's `utils/billing.ts`.
+ */
+export declare function isInfraCovered(params: {
+    isOss: boolean;
+    plan: AccountPlan;
+}): boolean;
 export interface RunContext {
     settings: RepoSettings;
     apiToken: string;
     oss: boolean;
+    plan: AccountPlan;
     proxyModel?: string | undefined;
     dbSecrets?: Record<string, string> | undefined;
 }

package/dist/utils/runContextData.d.ts

@@ -1,6 +1,6 @@
 import type { Octokit } from "@octokit/rest";
 import { type OctokitWithPlugins } from "./github.ts";
-import { type RepoSettings } from "./runContext.ts";
+import { type AccountPlan, type RepoSettings } from "./runContext.ts";
 export interface RunContextData {
     repo: {
         owner: string;
@@ -10,6 +10,7 @@ export interface RunContextData {
     repoSettings: RepoSettings;
     apiToken: string;
     oss: boolean;
+    plan: AccountPlan;
     proxyModel?: string | undefined;
     dbSecrets?: Record<string, string> | undefined;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pullfrog",
-  "version": "0.0.203",
+  "version": "0.0.205",
   "type": "module",
   "bin": {
     "pullfrog": "dist/cli.mjs",