pullfrog 0.1.7 → 0.1.8

package/dist/mcp/shell.d.ts

@@ -9,6 +9,11 @@ export declare const ShellParams: import("arktype/internal/variants/object.ts").
 export type SandboxMethod = "unshare" | "sudo-unshare" | "none";
 /** get the current sandbox method (for testing/diagnostics) */
 export declare function getSandboxMethod(): SandboxMethod;
+/** chars of shell output kept inline in the agent reply. anything past this
+ * blows the agent's context budget on commands that dump big logs (test
+ * runners, build tools, grep on large trees), so the overflow is spilled
+ * to a tempfile the agent can re-read selectively (cat/tail/grep). */
+export declare const MAX_OUTPUT_CHARS = 5000;
 export declare function ShellTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
     command: string;
     description: string;

package/dist/toolState.d.ts

@@ -1,5 +1,6 @@
 import type { AgentUsage } from "./agents/shared.ts";
 import type { PrepResult } from "./prep/types.ts";
+import type { AgentDiagnostic } from "./utils/agentHangReport.ts";
 import type { DiffCoverageState } from "./utils/diffCoverage.ts";
 import { type ProgressComment, type ProgressCommentType } from "./utils/progressComment.ts";
 import type { TodoTracker } from "./utils/todoTracking.ts";
@@ -98,6 +99,7 @@ export interface ToolState {
     model?: string | undefined;
     todoTracker?: TodoTracker | undefined;
     diffCoverage?: DiffCoverageState | undefined;
+    agentDiagnostic?: AgentDiagnostic | undefined;
 }
 interface InitToolStateParams {
     progressComment: {

package/dist/utils/agentHangReport.d.ts

@@ -0,0 +1,38 @@
+/**
+ * mutable per-run handle the agent harness writes to as a run progresses.
+ * the action's outer try/catch in `main.ts` reads this off `toolState` when
+ * the activity-timeout watchdog wins the race against the harness's own
+ * catch — the bare timer reject reason ("activity timeout: no output for
+ * 302s") tells the user nothing actionable, but `recentStderr` +
+ * `lastProviderError` together usually point straight at the upstream cause.
+ *
+ * `recentStderr` is shared by reference with the harness's bounded ring
+ * buffer, so the diagnostic always reflects the latest captured tail.
+ */
+export type AgentDiagnostic = {
+    /** display label for the agent, e.g. "Pullfrog". used in the headline. */
+    label: string;
+    /** shared reference to the harness's bounded stderr ring buffer. */
+    recentStderr: string[];
+    /** most-recent provider-error label from `detectProviderError`, if any. */
+    lastProviderError: string | undefined;
+    /** count of stdout events successfully parsed before the failure. */
+    eventCount: number;
+};
+/**
+ * Build a user-facing markdown body for an agent hang or failure.
+ *
+ * Rendered into both the PR progress comment and the GitHub Actions job
+ * summary. Returns `null` when no diagnostic is available, which signals to
+ * the caller to fall back to its bare-error rendering.
+ *
+ * `errorMessage` is the underlying timer / spawn reject string (e.g.
+ * `activity timeout: no output for 301s`). The idle seconds are parsed out
+ * of it for the hang explanation — total runtime would overstate the stall
+ * for runs that streamed for a long time before going quiet.
+ */
+export declare function formatAgentHangBody(input: {
+    diagnostic: AgentDiagnostic | undefined;
+    isHang: boolean;
+    errorMessage: string;
+}): string | null;

package/dist/utils/gitAuth.d.ts

@@ -44,4 +44,31 @@ export declare function setGitAuthServer(server: GitAuthServer): void;
  * await $git("push", ["-u", "origin", "feature"], { token });
  */
 export declare function $git(subcommand: SafeGitSubcommand, args: string[], options: GitAuthOptions): Promise<GitResult>;
+/**
+ * shallow-clone unreachable: when an existing local depth is too shallow for
+ * git to traverse to the requested ref's ancestry, the remote walk fails with
+ * one of these wordings (git emits the full OID via oid_to_hex, so the bound
+ * is 40 for SHA-1 or 64 for SHA-256). detecting both lets a single deepen
+ * retry recover before the error reaches the agent — see issue #564 for the
+ * original `git_fetch` precedent and #656 for the `checkout_pr` follow-up.
+ */
+export declare const SHALLOW_UNREACHABLE_PATTERNS: RegExp[];
+/**
+ * large enough to clear the merge base on most real-world PRs without
+ * downloading the full history; matches the fallback used by
+ * `checkoutPrBranch` when the GitHub compare API is unavailable.
+ */
+export declare const DEEPEN_RETRY_DEPTH = 1000;
+/**
+ * authenticated `git fetch` that recovers from shallow-unreachable errors
+ * by retrying once with `--deepen=1000`. callers pass the same args they
+ * would to `$git("fetch", ...)`; on shallow-unreachable failures in a
+ * shallow repo, the second attempt prepends `--deepen=N` and strips any
+ * caller-supplied `--depth=` (the two flags are mutually exclusive, and
+ * the caller's depth is what got us into this mess).
+ *
+ * non-shallow-unreachable errors and non-shallow repos rethrow unchanged,
+ * so this is safe to wrap any fetch without changing fast-path behavior.
+ */
+export declare function $gitFetchWithDeepen(args: string[], options: GitAuthOptions, label?: string): Promise<GitResult>;
 export {};

package/dist/utils/providerErrors.d.ts

@@ -1,2 +1,13 @@
+/**
+ * Result of a provider-error scan: the classification label plus a
+ * human-readable excerpt centered on the matched line. The excerpt is what
+ * gets surfaced in `» provider error detected (...)` log lines — see
+ * `extractExcerpt` for the windowing/byte-cap policy.
+ */
+export type ProviderErrorMatch = {
+    label: string;
+    excerpt: string;
+};
+export declare function findProviderErrorMatch(text: string): ProviderErrorMatch | null;
 export declare function detectProviderError(text: string): string | null;
 export declare function isRouterKeylimitExhaustedError(text: string): boolean;

package/package.json

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