badgr-agent-resume 0.1.0

package/README.md

@@ -0,0 +1,157 @@
+# badgr-agent-resume
+
+Add step-level checkpoints to agent runs so they survive crashes, timeouts, and restarts — without repeating completed steps.
+
+```ts
+import { agentRun } from "badgr-agent-resume";
+
+await agentRun("support-agent", async (run) => {
+  const plan  = await run.step("create-plan",   generatePlan);
+  const order = await run.step("fetch-order",   () => fetchOrder(plan.id));
+  return      await run.step("write-response", () => generateReply(order));
+});
+```
+
+**Free. No signup required.** Checkpoints are saved to `.badgr/runs/` on your machine.
+
+---
+
+## The problem it solves
+
+Multi-step agents crash mid-run and restart from scratch. A 20-minute agent that fails at step 8 of 10 wastes 18 minutes of compute and re-runs side effects. `badgr-agent-resume` wraps each step with a checkpoint — if the run crashes, the next execution skips completed steps and picks up exactly where it left off.
+
+---
+
+## Quick start
+
+```bash
+npm install badgr-agent-resume
+```
+
+```ts
+import { agentRun } from "badgr-agent-resume";
+
+await agentRun("my-agent", async (run) => {
+  // Each step is checkpointed. On re-run, completed steps are skipped.
+  const data    = await run.step("fetch-data",    () => fetchFromApi());
+  const summary = await run.step("summarize",     () => callLlm(data));
+  return         await run.step("send-email",     () => sendEmail(summary));
+});
+// Checkpoints saved to: .badgr/runs/my-agent-<timestamp>.json
+```
+
+If `summarize` crashes, re-running the script skips `fetch-data` (already done) and resumes from `summarize`.
+
+---
+
+## How checkpointing works
+
+Each `run.step(name, fn)` call:
+
+1. Checks `.badgr/runs/` for an existing run with this name
+2. If the step was completed in a previous run, returns the saved output immediately
+3. If not, executes `fn`, saves the output, and marks the step complete
+4. If `fn` throws, the step is marked `failed` and the error is rethrown
+
+Steps are identified by name, so renaming a step invalidates its checkpoint.
+
+---
+
+## API
+
+### `agentRun(name, fn, options?)`
+
+Runs an agent with checkpointing. Returns the final value of `fn`.
+
+```ts
+await agentRun(
+  "my-agent",          // run name — used to find existing checkpoints
+  async (run) => {
+    return await run.step("step-name", async () => {
+      // your step logic
+    });
+  },
+  {
+    stateDir?: string; // where to save checkpoints (default: .badgr/runs)
+  }
+);
+```
+
+### `run.step(name, fn)`
+
+Executes a step with checkpointing. If the step completed in a previous run, `fn` is not called — the saved output is returned instead.
+
+### `run.timeline()`
+
+Returns a human-readable timeline of all steps:
+
+```
+create-plan    completed  1.2s
+fetch-order    completed  0.4s
+write-response running    ...
+```
+
+### `run.state()`
+
+Returns the full run state as a typed object.
+
+---
+
+## CLI — inspect a saved run
+
+```bash
+# Show the status of a saved run and resume instructions
+npx badgr-agent-resume resume <run-id>
+
+# Machine-readable JSON
+npx badgr-agent-resume resume <run-id> --json
+
+# Show optional hosted run history link
+npx badgr-agent-resume connect
+```
+
+---
+
+## TypeScript API
+
+```ts
+import { agentRun, loadRun, formatTimeline } from "badgr-agent-resume";
+
+// Load a saved run by ID
+const state = await loadRun("my-agent-1718000000000");
+
+// Format the timeline
+console.log(formatTimeline(state));
+// create-plan    completed  1.2s
+// fetch-order    completed  0.4s
+// write-response failed     0.1s  Error: API timeout
+```
+
+**Types:**
+
+```ts
+interface AgentRunState {
+  id: string;
+  name: string;
+  createdAt: string;
+  updatedAt: string;
+  steps: RecordedStep[];
+  result?: unknown;
+}
+
+interface RecordedStep<T = unknown> {
+  name: string;
+  status: "completed" | "failed" | "running";
+  startedAt: string;
+  finishedAt?: string;
+  output?: T;
+  error?: string;
+}
+```
+
+---
+
+## Requirements
+
+- Node.js 18+
+- TypeScript 5+ (for type definitions)

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { createLogger, fireTelemetry } from "badgr-shared";
+import { buildRunReport, loadRun, formatTimeline } from "./index.js";
+fireTelemetry({ package: "badgr-agent-resume", command: process.argv[2] });
+const [command, runId] = process.argv.slice(2);
+const json = process.argv.includes("--json");
+if (!command || command === "--help" || command === "-h") {
+    console.log(`badgr-agent-resume — local step checkpoint wrapper for resumable agent runs
+
+Usage:
+  npx badgr-agent-resume resume <run_id>
+  npx badgr-agent-resume resume <run_id> --json
+  npx badgr-agent-resume connect
+
+Commands:
+  resume <run_id>        Show the status of a saved run and resume instructions
+  connect                Show the optional AI Badgr hosted run history link
+
+Flags:
+  --json                 Output machine-readable JSON
+
+Library usage (no CLI needed):
+  import { agentRun } from "badgr-agent-resume";
+
+  await agentRun("my-agent", async (run) => {
+    const plan  = await run.step("create-plan", generatePlan);
+    const order = await run.step("fetch-order", () => fetchOrder(plan.id));
+    return      run.step("write-response", () => generateReply(order));
+  });
+
+Exit codes:
+  0  Run loaded successfully
+  1  Run not found or load error
+  2  Bad usage
+
+No signup required. Hosted run history and alerts are optional.
+
+Environment:
+  BADGR_TELEMETRY=0      Disable anonymous usage telemetry`);
+    process.exit(0);
+}
+if (command === "connect") {
+    console.log("Want hosted run history, remote checkpoints, email alerts, and shareable traces?");
+    console.log("https://aibadgr.com/agents/connect");
+    console.log("");
+    console.log("Signup is only required if you choose to upload traces or checkpoints.");
+    process.exit(0);
+}
+if (command !== "resume" || !runId) {
+    console.error(`Error: expected "resume <run_id>", got "${command ?? ""} ${runId ?? ""}".trim()`);
+    console.error("Usage: npx badgr-agent-resume resume <run_id> [--json]");
+    process.exit(2);
+}
+try {
+    const state = await loadRun(runId);
+    const report = buildRunReport(state);
+    const logger = createLogger(json);
+    if (json) {
+        logger.report(report);
+    }
+    else {
+        console.log(`Run: ${state.id}  status: ${report.status}`);
+        console.log("");
+        console.log(formatTimeline(state));
+        const failed = state.steps.find((s) => s.status === "failed");
+        if (failed) {
+            console.log("");
+            console.log(`Failed step: ${failed.name}`);
+            if (failed.error)
+                console.log(`Error: ${failed.error}`);
+            console.log("");
+            console.log("Resume from where it stopped:");
+            console.log(`  npx badgr-agent-resume resume ${state.id}`);
+        }
+        console.log("");
+        console.log("Optional: hosted run history and alerts:");
+        console.log("  npx badgr-agent-resume connect");
+    }
+}
+catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { type JsonReport } from "badgr-shared";
+export type StepStatus = "completed" | "failed" | "running";
+export interface RecordedStep<T = unknown> {
+    name: string;
+    status: StepStatus;
+    startedAt: string;
+    finishedAt?: string;
+    output?: T;
+    error?: string;
+}
+export interface AgentRunState {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    steps: RecordedStep[];
+    result?: unknown;
+}
+export interface AgentRunOptions {
+    runId?: string;
+    stateDir?: string;
+    resume?: boolean;
+}
+export interface AgentRunContext {
+    id: string;
+    step<T>(name: string, fn: () => Promise<T> | T): Promise<T>;
+    timeline(): string;
+    state(): AgentRunState;
+}
+export declare function agentRun<T>(name: string, fn: (run: AgentRunContext) => Promise<T> | T, options?: AgentRunOptions): Promise<T>;
+export declare function loadRun(runId: string, stateDir?: string): Promise<AgentRunState>;
+export declare function formatTimeline(state: AgentRunState): string;
+export declare function buildRunReport(state: AgentRunState): JsonReport;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0D,KAAK,UAAU,EAAsB,MAAM,cAAc,CAAC;AAE3H,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5D,QAAQ,IAAI,MAAM,CAAC;IACnB,KAAK,IAAI,aAAa,CAAC;CACxB;AAID,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,CAAC,CAAC,CA4CvI;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAE3F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAM3D;AAiCD,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAgB/D"}

package/dist/index.js

@@ -0,0 +1,126 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { BadgrToolError, createReport, reportStatusFromFindings } from "badgr-shared";
+const DEFAULT_DIR = ".badgr";
+export async function agentRun(name, fn, options = {}) {
+    const stateDir = resolve(options.stateDir ?? DEFAULT_DIR);
+    await mkdir(join(stateDir, "runs"), { recursive: true });
+    const runId = options.runId ?? await resolveLatestRunId(stateDir, name) ?? createRunId();
+    const path = statePath(stateDir, runId);
+    const state = options.resume !== false && existsSync(path)
+        ? await readState(path)
+        : { id: runId, name, createdAt: new Date().toISOString(), updatedAt: new Date().toISOString(), steps: [] };
+    const context = {
+        id: state.id,
+        async step(stepName, stepFn) {
+            const existing = state.steps.find((step) => step.name === stepName && step.status === "completed");
+            if (existing)
+                return existing.output;
+            const failedIndex = state.steps.findIndex((step) => step.name === stepName && step.status === "failed");
+            if (failedIndex >= 0)
+                state.steps.splice(failedIndex, 1);
+            const record = { name: stepName, status: "running", startedAt: new Date().toISOString() };
+            state.steps.push(record);
+            await persist(stateDir, state);
+            try {
+                const output = await stepFn();
+                record.status = "completed";
+                record.finishedAt = new Date().toISOString();
+                record.output = output;
+                await persist(stateDir, state);
+                return output;
+            }
+            catch (error) {
+                record.status = "failed";
+                record.finishedAt = new Date().toISOString();
+                record.error = error instanceof Error ? error.message : String(error);
+                await persist(stateDir, state);
+                const message = `Run failed: ${state.id}\n\n${formatTimeline(state)}\n\nResume:\nnpx @aibadgr/agent-resume resume ${state.id}`;
+                throw new BadgrToolError(message, "AGENT_STEP_FAILED", { runId: state.id, failedStep: stepName });
+            }
+        },
+        timeline: () => formatTimeline(state),
+        state: () => structuredClone(state),
+    };
+    const result = await fn(context);
+    state.result = result;
+    await persist(stateDir, state);
+    return result;
+}
+export async function loadRun(runId, stateDir = DEFAULT_DIR) {
+    return readState(statePath(resolve(stateDir), runId));
+}
+export function formatTimeline(state) {
+    return state.steps.map((step) => {
+        if (step.status === "completed")
+            return `✓ ${step.name} completed`;
+        if (step.status === "failed")
+            return `✗ ${step.name} ${step.error ?? "failed"}`;
+        return `• ${step.name} running`;
+    }).join("\n");
+}
+async function persist(stateDir, state) {
+    state.updatedAt = new Date().toISOString();
+    await writeFile(statePath(stateDir, state.id), `${JSON.stringify(state, null, 2)}\n`);
+    await writeFile(join(stateDir, "runs", `${state.id}.steps.json`), `${JSON.stringify(state.steps, null, 2)}\n`);
+    await writeFile(join(stateDir, "runs", `${state.id}.checkpoint.json`), `${JSON.stringify(buildCheckpoint(state), null, 2)}\n`);
+    await writeFile(join(stateDir, `${safeName(state.name)}.latest`), state.id);
+}
+async function readState(path) {
+    return JSON.parse(await readFile(path, "utf8"));
+}
+async function resolveLatestRunId(stateDir, name) {
+    const path = join(stateDir, `${safeName(name)}.latest`);
+    if (!existsSync(path))
+        return undefined;
+    return (await readFile(path, "utf8")).trim();
+}
+function statePath(stateDir, runId) {
+    return join(stateDir, "runs", `${runId}.json`);
+}
+function safeName(name) {
+    return name.replace(/[^a-z0-9._-]+/gi, "_");
+}
+function createRunId() {
+    return `run_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+export function buildRunReport(state) {
+    const findings = buildFindings(state);
+    const status = reportStatusFromFindings(findings);
+    return createReport({
+        tool: "agent-resume",
+        reportId: `rpt_${state.id}`,
+        status,
+        summary: status === "failed" ? `Run failed at ${state.steps.find((step) => step.status === "failed")?.name ?? "unknown step"}` : "Run checkpoints are available locally",
+        findings,
+        recommendedActions: status === "failed"
+            ? [`Resume failed run: npx @aibadgr/agent-resume resume ${state.id}`, "Connect for hosted run history and alerts"]
+            : ["Keep local checkpoints for reproducible agent runs", "Connect for hosted run history and alerts"],
+        nextCommand: "npx @aibadgr/agent-resume connect",
+        actionUrl: "https://aibadgr.com/agents/connect",
+        metadata: { runId: state.id, runName: state.name, stepCount: state.steps.length },
+    });
+}
+function buildFindings(state) {
+    if (state.steps.length === 0)
+        return [{ severity: "warning", code: "AGENT_NO_STEPS_RECORDED", message: "No steps have been recorded yet." }];
+    return state.steps.map((step) => ({
+        severity: step.status === "failed" ? "error" : step.status === "running" ? "warning" : "info",
+        code: step.status === "failed" ? "AGENT_STEP_FAILED" : step.status === "running" ? "AGENT_STEP_INCOMPLETE" : "AGENT_STEP_COMPLETED",
+        message: step.status === "failed" ? `${step.name} ${step.error ?? "failed"}` : `${step.name} ${step.status}`,
+        details: { startedAt: step.startedAt, finishedAt: step.finishedAt },
+    }));
+}
+function buildCheckpoint(state) {
+    const completedSteps = state.steps.filter((step) => step.status === "completed");
+    const failedStep = state.steps.find((step) => step.status === "failed");
+    return {
+        runId: state.id,
+        runName: state.name,
+        lastSuccessfulStep: completedSteps.at(-1)?.name,
+        failedStep: failedStep?.name,
+        updatedAt: state.updatedAt,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,wBAAwB,EAAuC,MAAM,cAAc,CAAC;AAmC3H,MAAM,WAAW,GAAG,QAAQ,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,IAAY,EAAE,EAA4C,EAAE,UAA2B,EAAE;IACzH,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,WAAW,CAAC,CAAC;IAC1D,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;IACzF,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC;QACxD,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC;QACvB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAA0B,CAAC;IAErI,MAAM,OAAO,GAAoB;QAC/B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM;YACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;YACnG,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC,MAA4C,CAAC;YAE3E,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;YACxG,IAAI,WAAW,IAAI,CAAC;gBAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YACzD,MAAM,MAAM,GAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACxG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC;gBAC9B,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;gBAC5B,MAAM,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC7C,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;gBACvB,MAAM,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC/B,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC;gBACzB,MAAM,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC7C,MAAM,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,MAAM,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC/B,MAAM,OAAO,GAAG,eAAe,KAAK,CAAC,EAAE,OAAO,cAAc,CAAC,KAAK,CAAC,iDAAiD,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC/H,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpG,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC;QACrC,KAAK,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC;KACpC,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAa,EAAE,QAAQ,GAAG,WAAW;IACjE,OAAO,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO,KAAK,IAAI,CAAC,IAAI,YAAY,CAAC;QACnE,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,EAAE,CAAC;QAChF,OAAO,KAAK,IAAI,CAAC,IAAI,UAAU,CAAC;IAClC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,QAAgB,EAAE,KAAoB;IAC3D,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACtF,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,aAAa,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/G,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,kBAAkB,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/H,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAkB,CAAC;AACnE,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,IAAY;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,KAAa;IAChD,OAAO,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACpF,CAAC;AAGD,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,OAAO,KAAK,CAAC,EAAE,EAAE;QAC3B,MAAM;QACN,OAAO,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,iBAAiB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,IAAI,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,uCAAuC;QACxK,QAAQ;QACR,kBAAkB,EAAE,MAAM,KAAK,QAAQ;YACrC,CAAC,CAAC,CAAC,uDAAuD,KAAK,CAAC,EAAE,EAAE,EAAE,2CAA2C,CAAC;YAClH,CAAC,CAAC,CAAC,oDAAoD,EAAE,2CAA2C,CAAC;QACvG,WAAW,EAAE,mCAAmC;QAChD,SAAS,EAAE,oCAAoC;QAC/C,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE;KAClF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAoB;IACzC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;IAC7I,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChC,QAAQ,EAAE,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QAC7F,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,sBAAsB;QACnI,OAAO,EAAE,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE;QAC5G,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;KACpE,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,eAAe,CAAC,KAAoB;IAC3C,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IACjF,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IACxE,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,OAAO,EAAE,KAAK,CAAC,IAAI;QACnB,kBAAkB,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI;QAC/C,UAAU,EAAE,UAAU,EAAE,IAAI;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "badgr-agent-resume",
+  "version": "0.1.0",
+  "description": "Tiny TypeScript step checkpoint wrapper for resumable agent runs.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": { "badgr-agent-resume": "dist/cli.js" },
+  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
+  "files": ["dist", "README.md"],
+  "scripts": { "build": "tsc -b", "typecheck": "tsc -b --pretty false", "test": "vitest run" },
+  "dependencies": { "badgr-shared": "0.1.1" },
+  "engines": { "node": ">=18.0.0" },
+  "keywords": ["agent", "resume", "checkpoint", "context", "workflow"],
+  "license": "MIT"
+}