pullfrog 0.0.196 → 0.0.198

package/dist/agents/claude.d.ts

@@ -0,0 +1 @@
+export declare const claude: import("./shared.ts").Agent;

package/dist/agents/index.d.ts

@@ -0,0 +1,6 @@
+import type { Agent } from "./shared.ts";
+export type { Agent, AgentUsage } from "./shared.ts";
+export declare const agents: {
+    claude: Agent;
+    opentoad: Agent;
+};

package/dist/agents/opentoad.d.ts

@@ -0,0 +1 @@
+export declare const opentoad: import("./shared.ts").Agent;

package/dist/agents/shared.d.ts

@@ -0,0 +1,46 @@
+import type { AgentId } from "../external.ts";
+import type { ResolvedInstructions } from "../utils/instructions.ts";
+import type { ResolvedPayload } from "../utils/payload.ts";
+import type { TodoTracker } from "../utils/todoTracking.ts";
+export declare const MAX_STDERR_LINES = 20;
+export declare const MAX_COMMIT_RETRIES = 3;
+export declare function getGitStatus(): string;
+export declare function buildCommitPrompt(_agentId: AgentId, status: string): string;
+/**
+ * token/cost usage data from a single agent run
+ */
+export interface AgentUsage {
+    agent: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number | undefined;
+    cacheWriteTokens?: number | undefined;
+    costUsd?: number | undefined;
+}
+/**
+ * Result returned by agent execution
+ */
+export interface AgentResult {
+    success: boolean;
+    output?: string | undefined;
+    error?: string | undefined;
+    metadata?: Record<string, unknown>;
+    usage?: AgentUsage | undefined;
+}
+/**
+ * Minimal context passed to agent.run()
+ */
+export interface AgentRunContext {
+    payload: ResolvedPayload;
+    resolvedModel?: string | undefined;
+    mcpServerUrl: string;
+    tmpdir: string;
+    instructions: ResolvedInstructions;
+    todoTracker?: TodoTracker | undefined;
+}
+export interface Agent {
+    name: AgentId;
+    install: (token?: string) => Promise<string>;
+    run: (ctx: AgentRunContext) => Promise<AgentResult>;
+}
+export declare const agent: (input: Agent) => Agent;

package/dist/cli.mjs

@@ -144992,7 +144992,7 @@ var import_semver = __toESM(require_semver2(), 1);
 // package.json
 var package_default = {
   name: "pullfrog",
-  version: "0.0.196",
+  version: "0.0.198",
   type: "module",
   bin: {
     pullfrog: "dist/cli.mjs",
@@ -145005,7 +145005,7 @@ var package_default = {
   scripts: {
     test: "vitest",
     typecheck: "tsc --noEmit",
-    build: "node esbuild.config.js",
+    build: "node esbuild.config.js && tsc -p tsconfig.exports.json",
     "check:entrypoints": "node scripts/check-entrypoint-imports.ts",
     play: "node play.ts",
     runtest: "node test/run.ts",
@@ -145066,22 +145066,19 @@ var package_default = {
     url: "https://github.com/pullfrog/pullfrog/issues"
   },
   homepage: "https://github.com/pullfrog/pullfrog#readme",
-  zshy: {
-    exports: "./index.ts"
-  },
   main: "./dist/index.js",
   module: "./dist/index.js",
   types: "./dist/index.d.ts",
   exports: {
     ".": {
       "@pullfrog/source": "./index.ts",
-      types: "./dist/index.d.cts",
+      types: "./dist/index.d.ts",
       import: "./dist/index.js",
-      require: "./dist/index.cjs"
+      default: "./dist/index.js"
     },
     "./internal": {
       "@pullfrog/source": "./internal/index.ts",
-      types: "./dist/internal.d.cts",
+      types: "./dist/internal/index.d.ts",
       import: "./dist/internal.js",
       default: "./dist/internal.js"
     },
@@ -153828,7 +153825,7 @@ async function run2() {
 }
 
 // cli.ts
-var VERSION10 = "0.0.196";
+var VERSION10 = "0.0.198";
 var bin = basename2(process.argv[1] || "");
 var PROG = bin === "pf" || bin === "pullfrog" ? bin : "pullfrog";
 var rawArgs = process.argv.slice(2);

package/dist/external.d.ts

@@ -0,0 +1,213 @@
+/**
+ * ⚠️ LIMITED IMPORTS - this file is imported by Next.js and must avoid pulling in backend code.
+ * All shared constants, types, and data used by both the Next.js app and the action runtime live here.
+ * Other files in action/ re-export from this file for backward compatibility.
+ */
+export declare const pullfrogMcpName = "pullfrog";
+/** @see {@link file://./agents/shared.ts} Agent interface that uses this type */
+export type AgentId = "claude" | "opentoad";
+/**
+ * format a tool name the way each agent's MCP client presents it to the model.
+ * claude code: mcp__pullfrog__select_mode
+ * opencode:    pullfrog_select_mode
+ */
+export declare function formatMcpToolRef(agentId: AgentId, toolName: string): string;
+export type { ModelAlias, ModelProvider, ProviderConfig } from "./models.ts";
+export { getModelEnvVars, getModelProvider, getProviderDisplayName, modelAliases, parseModel, providers, resolveCliModel, resolveModelSlug, } from "./models.ts";
+export type ToolPermission = "disabled" | "enabled";
+export type ShellPermission = "disabled" | "restricted" | "enabled";
+export type PushPermission = "disabled" | "restricted" | "enabled";
+export type WorkflowPermissionValue = "read" | "write" | "none";
+export type WorkflowIdTokenPermissionValue = "write" | "none";
+export interface WorkflowPermissions {
+    actions?: WorkflowPermissionValue;
+    attestations?: WorkflowPermissionValue;
+    checks?: WorkflowPermissionValue;
+    contents?: WorkflowPermissionValue;
+    deployments?: WorkflowPermissionValue;
+    discussions?: WorkflowPermissionValue;
+    "id-token"?: WorkflowIdTokenPermissionValue;
+    issues?: WorkflowPermissionValue;
+    models?: WorkflowPermissionValue;
+    packages?: WorkflowPermissionValue;
+    pages?: WorkflowPermissionValue;
+    "pull-requests"?: WorkflowPermissionValue;
+    "repository-projects"?: WorkflowPermissionValue;
+    "security-events"?: WorkflowPermissionValue;
+    statuses?: WorkflowPermissionValue;
+}
+export type AuthorPermission = "admin" | "maintain" | "write" | "triage" | "read" | "none";
+interface BasePayloadEvent {
+    issue_number?: number;
+    is_pr?: boolean;
+    branch?: string;
+    /** title of the issue/PR (or contextual title for comments) */
+    title?: string;
+    /** primary content for this trigger (issue body, PR body, comment body, review body, etc.) */
+    body?: string | null;
+    comment_id?: number;
+    review_id?: number;
+    review_state?: string;
+    thread?: any;
+    pull_request?: any;
+    check_suite?: {
+        id: number;
+        head_sha: string;
+        head_branch: string | null;
+        status: string | null;
+        conclusion: string | null;
+        url: string;
+    };
+    comment_ids?: number[] | "all";
+    /** permission level of the user who triggered this event */
+    authorPermission?: AuthorPermission;
+    /** when true, runs silently without progress comments (e.g., auto-labeling) */
+    silent?: boolean;
+    [key: string]: any;
+}
+interface PullRequestOpenedEvent extends BasePayloadEvent {
+    trigger: "pull_request_opened";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    body: string | null;
+    branch: string;
+}
+interface PullRequestReadyForReviewEvent extends BasePayloadEvent {
+    trigger: "pull_request_ready_for_review";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    body: string | null;
+    branch: string;
+}
+interface PullRequestReviewRequestedEvent extends BasePayloadEvent {
+    trigger: "pull_request_review_requested";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    body: string | null;
+    branch: string;
+}
+interface PullRequestReviewSubmittedEvent extends BasePayloadEvent {
+    trigger: "pull_request_review_submitted";
+    issue_number: number;
+    is_pr: true;
+    review_id: number;
+    /** review body is the primary content */
+    body: string | null;
+    review_state: string;
+    branch: string;
+}
+interface PullRequestReviewCommentCreatedEvent extends BasePayloadEvent {
+    trigger: "pull_request_review_comment_created";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    comment_id: number;
+    /** comment body is the primary content (null if already in prompt) */
+    body: string | null;
+    thread?: any;
+    branch: string;
+}
+interface IssuesOpenedEvent extends BasePayloadEvent {
+    trigger: "issues_opened";
+    issue_number: number;
+    title: string;
+    body: string | null;
+}
+interface IssuesAssignedEvent extends BasePayloadEvent {
+    trigger: "issues_assigned";
+    issue_number: number;
+    title: string;
+    body: string | null;
+}
+interface IssuesLabeledEvent extends BasePayloadEvent {
+    trigger: "issues_labeled";
+    issue_number: number;
+    title: string;
+    body: string | null;
+}
+interface IssueCommentCreatedEvent extends BasePayloadEvent {
+    trigger: "issue_comment_created";
+    comment_id: number;
+    /** distinguishes this from PR review comments (which use pull_request_review_comment_created) */
+    comment_type: "issue";
+    /** comment body is the primary content (null if already in prompt) */
+    body: string | null;
+    issue_number: number;
+    is_pr?: true;
+    branch?: string;
+    title?: string;
+}
+interface CheckSuiteCompletedEvent extends BasePayloadEvent {
+    trigger: "check_suite_completed";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    body: string | null;
+    pull_request: any;
+    branch: string;
+    check_suite: {
+        id: number;
+        head_sha: string;
+        head_branch: string | null;
+        status: string | null;
+        conclusion: string | null;
+        url: string;
+    };
+}
+interface WorkflowDispatchEvent extends BasePayloadEvent {
+    trigger: "workflow_dispatch";
+}
+interface FixReviewEvent extends BasePayloadEvent {
+    trigger: "fix_review";
+    issue_number: number;
+    is_pr: true;
+    review_id: number;
+    /** when true, only address comments the triggerer approved with 👍 (vs all comments) */
+    approved_only?: boolean | undefined;
+}
+interface ImplementPlanEvent extends BasePayloadEvent {
+    trigger: "implement_plan";
+    issue_number: number;
+    plan_comment_id: number;
+    /** plan content is the primary content (null if already in prompt) */
+    body: string | null;
+}
+interface PullRequestSynchronizeEvent extends BasePayloadEvent {
+    trigger: "pull_request_synchronize";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    body: string | null;
+    branch: string;
+    /** SHA before the push -- used to compute incremental range-diff between PR versions */
+    before_sha: string;
+}
+interface UnknownEvent extends BasePayloadEvent {
+    trigger: "unknown";
+}
+export type PayloadEvent = PullRequestOpenedEvent | PullRequestReadyForReviewEvent | PullRequestSynchronizeEvent | PullRequestReviewRequestedEvent | PullRequestReviewSubmittedEvent | PullRequestReviewCommentCreatedEvent | IssuesOpenedEvent | IssuesAssignedEvent | IssuesLabeledEvent | IssueCommentCreatedEvent | CheckSuiteCompletedEvent | WorkflowDispatchEvent | FixReviewEvent | ImplementPlanEvent | UnknownEvent;
+export interface WriteablePayload {
+    "~pullfrog": true;
+    /** semantic version of the payload to ensure compatibility */
+    version: string;
+    /** provider/model slug (e.g. "anthropic/claude-opus") */
+    model?: string | undefined;
+    /** the user's actual request (body if @pullfrog tagged) */
+    prompt: string;
+    /** github username of the human who triggered this workflow run */
+    triggerer?: string | undefined;
+    /** event-level instructions for this trigger type (flag-expanded server-side) */
+    eventInstructions?: string | undefined;
+    /** event data from webhook payload - discriminated union based on trigger field */
+    event: PayloadEvent;
+    /** timeout for agent run (e.g., "10m", "1h30m") - defaults to "1h" */
+    timeout?: string | undefined;
+    /** working directory for the agent */
+    cwd?: string | undefined;
+    /** pre-created progress comment ID for updating status */
+    progressCommentId?: string | undefined;
+}
+export type Payload = Readonly<WriteablePayload>;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Library entry point for npm package
+ * This exports the main function for programmatic usage
+ */
+export type { Agent, AgentResult, AgentRunContext } from "./agents/shared.ts";
+export { type Inputs as ExecutionInputs, type MainResult, main, } from "./main.ts";