@otisworks/batch-kit 0.0.1

package/README.md

@@ -0,0 +1,239 @@
+# batch-kit
+
+An ergonomic CLI + library for the [Anthropic Message Batches API](https://platform.claude.com/docs/en/build-with-claude/batch-processing).
+
+Process large volumes of documents with Claude at **50% off** the standard API cost — without hand-writing JSONL, tracking batch IDs, or reimplementing polling loops.
+
+```bash
+batch add --dir ./reviews --prompt "Summarize this review:\n\n{content}"
+batch send
+# ...later...
+batch fetch --latest --output summaries.json
+```
+
+---
+
+## Why
+
+The Batch API is great for cost-effective bulk processing, but the raw developer experience is manual: you build the JSONL request shape yourself, poll for status, and track which batch is which. batch-kit wraps `@anthropic-ai/sdk` and handles all of that behind a familiar, git-like workflow.
+
+## Requirements
+
+- Node.js **18+**
+- An `ANTHROPIC_API_KEY`
+
+## Install
+
+```bash
+npm install @otisworks/batch-kit
+```
+
+For the CLI globally:
+
+```bash
+npm install -g @otisworks/batch-kit
+```
+
+## Setup
+
+Set your API key via environment variable or a `.env` file in your working directory:
+
+```
+ANTHROPIC_API_KEY=sk-ant-...
+```
+
+The CLI automatically loads `.env` from the current directory.
+
+---
+
+## CLI
+
+The CLI follows a git-like staged workflow: **add** documents, **review** them, **send** the batch, then **fetch** results.
+
+### `batch add`
+
+Stage documents from a directory using a prompt template.
+
+```bash
+batch add --dir ./documents --prompt "Summarize:\n\n{content}"
+```
+
+| Option | Description |
+|---|---|
+| `-d, --dir <dir>` | Directory of documents (required) |
+| `-p, --prompt <template>` | Prompt template (required) |
+| `-m, --model <model>` | Model override |
+| `--max-tokens <n>` | `max_tokens` override |
+| `-e, --ext <list>` | Comma-separated extensions, e.g. `.txt,.md` |
+
+**Template variables:** `{content}` (file contents), `{filename}`, `{index}`.
+
+Supported file types: `.txt` and `.md` by default.
+
+### `batch review`
+
+Preview what's currently staged.
+
+```bash
+batch review
+```
+
+### `batch reset`
+
+Discard the staging area.
+
+```bash
+batch reset
+```
+
+### `batch send`
+
+Submit staged documents as a single batch. Prints the batch ID and clears staging.
+
+```bash
+batch send            # submit and exit
+batch send --wait     # block until processing finishes
+```
+
+### `batch status`
+
+Check a batch's processing status and per-request counts.
+
+```bash
+batch status <batch-id>
+batch status --latest    # most recently submitted batch
+```
+
+### `batch fetch`
+
+Retrieve results. Results are matched back to their source filenames.
+
+```bash
+batch fetch <batch-id>
+batch fetch --latest
+batch fetch --latest --wait                  # wait for completion first
+batch fetch --latest --output results.json   # write JSON to a file
+```
+
+| Option | Description |
+|---|---|
+| `-l, --latest` | Use the most recently submitted batch |
+| `-o, --output <file>` | Write results as JSON |
+| `-w, --wait` | Wait for completion before fetching |
+
+### `batch history`
+
+Show the operation log (send / status / fetch events).
+
+```bash
+batch history
+```
+
+### Global options
+
+| Option | Description |
+|---|---|
+| `--state-dir <dir>` | State directory (default `./.batch-state`) |
+
+---
+
+## Example workflow
+
+```bash
+# Stage 50 customer reviews for summarization
+batch add --dir ./reviews --prompt "Summarize this review in 2 sentences:\n\n{content}"
+
+batch review
+#   50 document(s) staged: ...
+
+batch send
+#   Batch submitted: msgbatch_01...
+
+# (later — even from a fresh terminal)
+batch status --latest
+#   status: ended  counts: succeeded=50 ...
+
+batch fetch --latest --output summaries.json
+#   Wrote 50 result(s) to summaries.json (50 succeeded).
+```
+
+---
+
+## Library
+
+```typescript
+import { BatchKit } from "@otisworks/batch-kit";
+
+const kit = new BatchKit({
+  apiKey: process.env.ANTHROPIC_API_KEY, // optional; defaults to env var
+  stateDir: "./.batch-state",            // optional
+});
+
+// Stage documents
+await kit.add("./documents", {
+  prompt: "Extract keywords:\n\n{content}",
+  model: "claude-opus-4-8",
+  maxTokens: 1024,
+});
+
+// Preview
+const { count, files } = await kit.review();
+
+// Submit
+const batchId = await kit.send();
+
+// Wait for completion
+await kit.wait(batchId, {
+  onPoll: ({ status, counts }) => console.log(status, counts),
+});
+
+// Stream results (matched back to files via customId)
+for await (const result of kit.results(batchId)) {
+  if (result.type === "succeeded") {
+    console.log(result.customId, result.text);
+  }
+}
+```
+
+Batch-id methods (`status`, `wait`, `results`) also accept the string `"latest"`
+to target the most recently submitted batch.
+
+See [`examples/programmatic.mjs`](./examples/programmatic.mjs) for a runnable example.
+
+---
+
+## How state works
+
+batch-kit persists job metadata to a local `.batch-state/` directory:
+
+```
+.batch-state/
+├── jobs/<batch-id>.json   # metadata + customId→filename map per batch
+├── staged.json            # the current staging area
+└── history.jsonl          # append-only operation log
+```
+
+This is what makes `--latest` and cross-session `fetch` work.
+
+> **Note:** State is local to the machine and directory you run in (much like
+> `.git/`). If you `send` on one machine, you'll need that machine's
+> `.batch-state/` to resolve `--latest` later. The batch itself lives on
+> Anthropic's servers regardless — you can always fetch by explicit batch ID.
+>
+> batch-kit assumes single-user, non-concurrent usage. Writes are atomic
+> (temp file + rename) to avoid corruption on interruption.
+
+---
+
+## Development
+
+```bash
+npm install
+npm run build       # compile TypeScript to dist/
+npm test            # run unit tests (no API calls)
+npm run typecheck   # type-check without emitting
+```
+
+## License
+
+MIT

package/dist/BatchKit.d.ts

@@ -0,0 +1,66 @@
+import { StateManager } from "./stateManager.js";
+import type { AddOptions, BatchKitOptions, BatchResult, RequestCounts, ReviewSummary, StagedRequest } from "./types.js";
+/** Options for {@link BatchKit.wait}. */
+export interface WaitOptions {
+    /** Poll interval in ms. Default 5000. */
+    intervalMs?: number;
+    /** Give up after this many ms. Default 24h. */
+    timeoutMs?: number;
+    /** Called on each poll with the current counts + status. */
+    onPoll?: (info: {
+        status: string;
+        counts: RequestCounts;
+    }) => void;
+}
+/**
+ * Main entry point. Stage documents, send them as a batch, poll, and read
+ * results back.
+ *
+ * State persistence is intentionally not wired in yet — `add` stages
+ * in-memory for now. That layer comes next.
+ */
+export declare class BatchKit {
+    private readonly client;
+    private readonly defaultModel;
+    private readonly defaultMaxTokens;
+    private readonly state;
+    constructor(options?: BatchKitOptions);
+    /** Access the underlying state store (job history, latest lookup). */
+    get store(): StateManager;
+    /**
+     * Resolve a batch id, supporting the special value `"latest"` which looks up
+     * the most recently submitted job from persisted state.
+     */
+    resolveBatchId(batchIdOrLatest: string): Promise<string>;
+    /**
+     * Read supported files from a directory, interpolate the prompt template,
+     * and stage them as requests. Returns the number of requests staged.
+     */
+    add(dir: string, options: AddOptions): Promise<number>;
+    /** Preview what's currently staged. */
+    review(): Promise<ReviewSummary>;
+    /** The currently staged requests. */
+    stagedRequests(): Promise<StagedRequest[]>;
+    /** Discard all staged requests. */
+    reset(): Promise<void>;
+    /**
+     * Submit all staged requests as a single batch. Returns the batch id.
+     * Clears the staging area on success.
+     */
+    send(): Promise<string>;
+    /** Fetch the current status + counts for a batch. Accepts `"latest"`. */
+    status(batchIdOrLatest: string): Promise<{
+        status: string;
+        counts: RequestCounts;
+        endedAt: string | null;
+        batchId: string;
+    }>;
+    /** Poll until the batch finishes processing (or timeout). Accepts `"latest"`. */
+    wait(batchIdOrLatest: string, options?: WaitOptions): Promise<void>;
+    /**
+     * Stream normalized results for a completed batch. Results may arrive out of
+     * order; use `customId` to match them back to source files.
+     */
+    results(batchIdOrLatest: string): AsyncGenerator<BatchResult>;
+}
+//# sourceMappingURL=BatchKit.d.ts.map

package/dist/BatchKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchKit.d.ts","sourceRoot":"","sources":["../src/BatchKit.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,WAAW,EAEX,aAAa,EACb,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC;AAMpB,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,KAAK,IAAI,CAAC;CACpE;AAED;;;;;;GAMG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,OAAO,GAAE,eAAoB;IAazC,sEAAsE;IACtE,IAAI,KAAK,IAAI,YAAY,CAExB;IAED;;;OAGG;IACG,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS9D;;;OAGG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IA8C5D,uCAAuC;IACjC,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAQtC,qCAAqC;IAC/B,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAIhD,mCAAmC;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAqC7B,yEAAyE;IACnE,MAAM,CACV,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAa9F,iFAAiF;IAC3E,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7E;;;OAGG;IACI,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC;CA6BrE"}

package/dist/BatchKit.js

@@ -0,0 +1,205 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { interpolate, toCustomId } from "./template.js";
+import { StateManager } from "./stateManager.js";
+const DEFAULT_MODEL = "claude-opus-4-8";
+const DEFAULT_MAX_TOKENS = 1024;
+const DEFAULT_EXTENSIONS = [".txt", ".md"];
+/**
+ * Main entry point. Stage documents, send them as a batch, poll, and read
+ * results back.
+ *
+ * State persistence is intentionally not wired in yet — `add` stages
+ * in-memory for now. That layer comes next.
+ */
+export class BatchKit {
+    client;
+    defaultModel;
+    defaultMaxTokens;
+    state;
+    constructor(options = {}) {
+        const apiKey = options.apiKey ?? process.env.ANTHROPIC_API_KEY;
+        if (!apiKey) {
+            throw new Error("No API key provided. Pass { apiKey } or set ANTHROPIC_API_KEY.");
+        }
+        this.client = new Anthropic({ apiKey });
+        this.defaultModel = options.defaultModel ?? DEFAULT_MODEL;
+        this.defaultMaxTokens = options.defaultMaxTokens ?? DEFAULT_MAX_TOKENS;
+        this.state = new StateManager(options.stateDir);
+    }
+    /** Access the underlying state store (job history, latest lookup). */
+    get store() {
+        return this.state;
+    }
+    /**
+     * Resolve a batch id, supporting the special value `"latest"` which looks up
+     * the most recently submitted job from persisted state.
+     */
+    async resolveBatchId(batchIdOrLatest) {
+        if (batchIdOrLatest !== "latest")
+            return batchIdOrLatest;
+        const job = await this.state.latestJob();
+        if (!job) {
+            throw new Error("No previous batches found in state. Nothing to resolve for 'latest'.");
+        }
+        return job.batchId;
+    }
+    /**
+     * Read supported files from a directory, interpolate the prompt template,
+     * and stage them as requests. Returns the number of requests staged.
+     */
+    async add(dir, options) {
+        const model = options.model ?? this.defaultModel;
+        const maxTokens = options.maxTokens ?? this.defaultMaxTokens;
+        const allowed = new Set((options.extensions ?? DEFAULT_EXTENSIONS).map((e) => e.toLowerCase()));
+        const entries = await readdir(dir, { withFileTypes: true });
+        const files = entries
+            .filter((e) => e.isFile() && allowed.has(path.extname(e.name).toLowerCase()))
+            .map((e) => e.name)
+            .sort();
+        if (files.length === 0) {
+            throw new Error(`No files matching ${[...allowed].join(", ")} found in ${dir}`);
+        }
+        // Staging is disk-backed so add/review/send work across CLI invocations.
+        const staged = await this.state.loadStaged();
+        const startIndex = staged.length;
+        for (let i = 0; i < files.length; i++) {
+            const filename = files[i];
+            const raw = await readFile(path.join(dir, filename), "utf8");
+            const index = startIndex + i;
+            const prompt = interpolate(options.prompt, {
+                content: raw.trim(),
+                filename,
+                index,
+            });
+            staged.push({
+                customId: toCustomId(index, filename),
+                filename,
+                prompt,
+                model,
+                maxTokens,
+            });
+        }
+        await this.state.saveStaged(staged);
+        return files.length;
+    }
+    /** Preview what's currently staged. */
+    async review() {
+        const staged = await this.state.loadStaged();
+        return {
+            count: staged.length,
+            files: staged.map((r) => r.filename),
+        };
+    }
+    /** The currently staged requests. */
+    async stagedRequests() {
+        return this.state.loadStaged();
+    }
+    /** Discard all staged requests. */
+    async reset() {
+        await this.state.clearStaged();
+    }
+    /**
+     * Submit all staged requests as a single batch. Returns the batch id.
+     * Clears the staging area on success.
+     */
+    async send() {
+        const staged = await this.state.loadStaged();
+        if (staged.length === 0) {
+            throw new Error("Nothing staged. Call add() first.");
+        }
+        const requests = staged.map((r) => ({
+            custom_id: r.customId,
+            params: {
+                model: r.model,
+                max_tokens: r.maxTokens,
+                messages: [{ role: "user", content: r.prompt }],
+            },
+        }));
+        const batch = await this.client.messages.batches.create({ requests });
+        // Persist job metadata so future runs can find it (and map results -> files).
+        const job = {
+            batchId: batch.id,
+            createdAt: new Date().toISOString(),
+            model: staged[0]?.model ?? this.defaultModel,
+            requestCount: staged.length,
+            requests: staged.map((r) => ({
+                customId: r.customId,
+                filename: r.filename,
+            })),
+            lastStatus: batch.processing_status,
+            lastCheckedAt: new Date().toISOString(),
+        };
+        await this.state.saveJob(job);
+        await this.state.record({ op: "send", batchId: batch.id, detail: `${job.requestCount} requests` });
+        await this.state.clearStaged();
+        return batch.id;
+    }
+    /** Fetch the current status + counts for a batch. Accepts `"latest"`. */
+    async status(batchIdOrLatest) {
+        const batchId = await this.resolveBatchId(batchIdOrLatest);
+        const batch = await this.client.messages.batches.retrieve(batchId);
+        await this.state.updateStatus(batchId, batch.processing_status);
+        await this.state.record({ op: "status", batchId, detail: batch.processing_status });
+        return {
+            status: batch.processing_status,
+            counts: batch.request_counts,
+            endedAt: batch.ended_at,
+            batchId,
+        };
+    }
+    /** Poll until the batch finishes processing (or timeout). Accepts `"latest"`. */
+    async wait(batchIdOrLatest, options = {}) {
+        const batchId = await this.resolveBatchId(batchIdOrLatest);
+        const intervalMs = options.intervalMs ?? 5000;
+        const timeoutMs = options.timeoutMs ?? 24 * 60 * 60 * 1000;
+        const start = Date.now();
+        for (;;) {
+            const batch = await this.client.messages.batches.retrieve(batchId);
+            await this.state.updateStatus(batchId, batch.processing_status);
+            options.onPoll?.({
+                status: batch.processing_status,
+                counts: batch.request_counts,
+            });
+            if (batch.processing_status === "ended")
+                return;
+            if (Date.now() - start > timeoutMs) {
+                throw new Error(`Timed out waiting for batch ${batchId} (still ${batch.processing_status})`);
+            }
+            await new Promise((r) => setTimeout(r, intervalMs));
+        }
+    }
+    /**
+     * Stream normalized results for a completed batch. Results may arrive out of
+     * order; use `customId` to match them back to source files.
+     */
+    async *results(batchIdOrLatest) {
+        const batchId = await this.resolveBatchId(batchIdOrLatest);
+        await this.state.record({ op: "fetch", batchId });
+        const stream = await this.client.messages.batches.results(batchId);
+        for await (const item of stream) {
+            const { custom_id: customId, result } = item;
+            switch (result.type) {
+                case "succeeded": {
+                    const text = result.message.content
+                        .filter((b) => b.type === "text")
+                        .map((b) => b.text)
+                        .join("");
+                    yield { customId, type: "succeeded", message: result.message, text };
+                    break;
+                }
+                case "errored":
+                    yield { customId, type: "errored", error: result.error };
+                    break;
+                case "canceled":
+                    yield { customId, type: "canceled" };
+                    break;
+                case "expired":
+                    yield { customId, type: "expired" };
+                    break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=BatchKit.js.map

package/dist/BatchKit.js.map

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

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,212 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { readFileSync, existsSync } from "node:fs";
+import { writeFile } from "node:fs/promises";
+import { BatchKit } from "./BatchKit.js";
+// --- minimal .env loader (Node 18 has no --env-file) ---
+function loadDotenv() {
+    if (!existsSync(".env"))
+        return;
+    for (const line of readFileSync(".env", "utf8").split("\n")) {
+        const m = line.match(/^\s*([\w.-]+)\s*=\s*(.*)?\s*$/);
+        if (!m || line.trim().startsWith("#"))
+            continue;
+        const key = m[1];
+        const val = (m[2] ?? "").trim().replace(/^['"]|['"]$/g, "");
+        if (!(key in process.env))
+            process.env[key] = val;
+    }
+}
+function makeKit(stateDir) {
+    loadDotenv();
+    try {
+        return new BatchKit(stateDir ? { stateDir } : {});
+    }
+    catch (err) {
+        fail(err.message);
+    }
+}
+function fail(msg) {
+    console.error(`error: ${msg}`);
+    process.exit(1);
+}
+const program = new Command();
+program
+    .name("batch")
+    .description("Ergonomic CLI for the Anthropic Message Batches API")
+    .version("0.0.1")
+    .option("--state-dir <dir>", "directory for persisted state", "./.batch-state");
+function stateDir() {
+    return program.opts().stateDir;
+}
+// --- add ---
+program
+    .command("add")
+    .description("Stage documents from a directory with a prompt template")
+    .requiredOption("-d, --dir <dir>", "directory of documents")
+    .requiredOption("-p, --prompt <template>", "prompt template ({content}, {filename}, {index})")
+    .option("-m, --model <model>", "model override")
+    .option("--max-tokens <n>", "max_tokens override", (v) => parseInt(v, 10))
+    .option("-e, --ext <extensions>", "comma-separated extensions (e.g. .txt,.md)")
+    .action(async (opts) => {
+    const kit = makeKit(stateDir());
+    try {
+        const n = await kit.add(opts.dir, {
+            prompt: opts.prompt,
+            model: opts.model,
+            maxTokens: opts.maxTokens,
+            extensions: opts.ext
+                ? opts.ext.split(",").map((e) => (e.startsWith(".") ? e : `.${e}`).toLowerCase())
+                : undefined,
+        });
+        const { count } = await kit.review();
+        console.log(`Staged ${n} document(s). ${count} total staged.`);
+    }
+    catch (err) {
+        fail(err.message);
+    }
+});
+// --- review ---
+program
+    .command("review")
+    .description("Preview what's currently staged")
+    .action(async () => {
+    const kit = makeKit(stateDir());
+    const { count, files } = await kit.review();
+    if (count === 0) {
+        console.log("Nothing staged. Use `batch add` first.");
+        return;
+    }
+    console.log(`${count} document(s) staged:`);
+    for (const f of files)
+        console.log(`  - ${f}`);
+});
+// --- reset ---
+program
+    .command("reset")
+    .description("Discard the staging area")
+    .action(async () => {
+    const kit = makeKit(stateDir());
+    await kit.reset();
+    console.log("Staging cleared.");
+});
+// --- send ---
+program
+    .command("send")
+    .description("Submit staged documents as a batch")
+    .option("-w, --wait", "block until the batch finishes")
+    .action(async (opts) => {
+    const kit = makeKit(stateDir());
+    let id;
+    try {
+        id = await kit.send();
+    }
+    catch (err) {
+        fail(err.message);
+    }
+    console.log(`Batch submitted: ${id}`);
+    if (opts.wait) {
+        console.log("Waiting for completion...");
+        await kit.wait(id, {
+            onPoll: ({ status, counts }) => console.log(`  ${status} (succeeded=${counts.succeeded} processing=${counts.processing} errored=${counts.errored})`),
+        });
+        console.log("Done. Use `batch fetch --latest` to retrieve results.");
+    }
+    else {
+        console.log("Check later with `batch status --latest` and `batch fetch --latest`.");
+    }
+});
+// --- status ---
+program
+    .command("status [batchId]")
+    .description("Check batch status (use --latest for the most recent)")
+    .option("-l, --latest", "use the most recently submitted batch")
+    .action(async (batchId, opts) => {
+    const kit = makeKit(stateDir());
+    const target = opts.latest ? "latest" : batchId;
+    if (!target)
+        fail("provide a batchId or use --latest");
+    try {
+        const s = await kit.status(target);
+        console.log(`Batch ${s.batchId}`);
+        console.log(`  status: ${s.status}`);
+        const c = s.counts;
+        console.log(`  counts: succeeded=${c.succeeded} processing=${c.processing} errored=${c.errored} canceled=${c.canceled} expired=${c.expired}`);
+        if (s.endedAt)
+            console.log(`  ended: ${s.endedAt}`);
+    }
+    catch (err) {
+        fail(err.message);
+    }
+});
+// --- fetch ---
+program
+    .command("fetch [batchId]")
+    .description("Fetch results (use --latest for the most recent)")
+    .option("-l, --latest", "use the most recently submitted batch")
+    .option("-o, --output <file>", "write results as JSON to a file")
+    .option("-w, --wait", "wait for completion before fetching")
+    .action(async (batchId, opts) => {
+    const kit = makeKit(stateDir());
+    const target = opts.latest ? "latest" : batchId;
+    if (!target)
+        fail("provide a batchId or use --latest");
+    try {
+        const resolvedId = await kit.resolveBatchId(target);
+        const job = await kit.store.getJob(resolvedId);
+        const fileFor = new Map((job?.requests ?? []).map((r) => [r.customId, r.filename]));
+        if (opts.wait) {
+            console.log("Waiting for completion...");
+            await kit.wait(resolvedId, {
+                onPoll: ({ status, counts }) => console.log(`  ${status} (succeeded=${counts.succeeded} processing=${counts.processing})`),
+            });
+        }
+        const collected = [];
+        let ok = 0;
+        for await (const r of kit.results(resolvedId)) {
+            const file = fileFor.get(r.customId) ?? r.customId;
+            const entry = {
+                customId: r.customId,
+                file,
+                type: r.type,
+            };
+            if (r.type === "succeeded") {
+                entry.text = r.text;
+                ok++;
+            }
+            collected.push(entry);
+        }
+        if (opts.output) {
+            await writeFile(opts.output, JSON.stringify(collected, null, 2), "utf8");
+            console.log(`Wrote ${collected.length} result(s) to ${opts.output} (${ok} succeeded).`);
+        }
+        else {
+            for (const e of collected) {
+                console.log(`\n--- ${e.file} [${e.type}] ---`);
+                if (e.text)
+                    console.log(e.text.trim());
+            }
+            console.log(`\n${ok}/${collected.length} succeeded.`);
+        }
+    }
+    catch (err) {
+        fail(err.message);
+    }
+});
+// --- history ---
+program
+    .command("history")
+    .description("Show the operation log")
+    .action(async () => {
+    const kit = makeKit(stateDir());
+    const entries = await kit.store.history();
+    if (entries.length === 0) {
+        console.log("No history yet.");
+        return;
+    }
+    for (const h of entries) {
+        console.log(`${h.at}  ${h.op.padEnd(6)}  ${h.batchId}${h.detail ? "  (" + h.detail + ")" : ""}`);
+    }
+});
+program.parseAsync().catch((err) => fail(err.message));
+//# 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,7 @@
+export { BatchKit } from "./BatchKit.js";
+export type { WaitOptions } from "./BatchKit.js";
+export { StateManager } from "./stateManager.js";
+export { interpolate, toCustomId } from "./template.js";
+export type { TemplateVars } from "./template.js";
+export type { AddOptions, BatchKitOptions, BatchResult, HistoryEntry, JobRecord, JobRequestRef, ProcessingStatus, RequestCounts, ReviewSummary, StagedRequest, } from "./types.js";
+//# 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":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { BatchKit } from "./BatchKit.js";
+export { StateManager } from "./stateManager.js";
+export { interpolate, toCustomId } from "./template.js";
+//# 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,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/stateManager.d.ts

@@ -0,0 +1,46 @@
+import type { HistoryEntry, JobRecord, StagedRequest } from "./types.js";
+/**
+ * Persists batch job metadata to disk under a state directory.
+ *
+ * Layout:
+ *   <stateDir>/
+ *     jobs/<batchId>.json    one file per submitted batch
+ *     history.jsonl          append-only operation log
+ *
+ * Assumptions (documented, MVP): single user, single machine, no concurrent
+ * processes. Writes are atomic (temp file + rename) so a crash mid-write won't
+ * corrupt an existing job file.
+ */
+export declare class StateManager {
+    readonly stateDir: string;
+    private readonly jobsDir;
+    private readonly historyFile;
+    private readonly stagedFile;
+    constructor(stateDir?: string);
+    /** Ensure the state directory structure exists. */
+    private ensureDirs;
+    private jobPath;
+    /** Atomic write: write to a temp file, then rename over the target. */
+    private atomicWrite;
+    /** Persist (create or overwrite) a job record. */
+    saveJob(job: JobRecord): Promise<void>;
+    /** Load a job record by batch id, or null if not found. */
+    getJob(batchId: string): Promise<JobRecord | null>;
+    /** List all job records, most recently created first. */
+    listJobs(): Promise<JobRecord[]>;
+    /** The most recently created job, or null if none. */
+    latestJob(): Promise<JobRecord | null>;
+    /** Update the status fields on an existing job (no-op if not found). */
+    updateStatus(batchId: string, lastStatus: NonNullable<JobRecord["lastStatus"]>): Promise<void>;
+    /** Append an entry to the history log. */
+    record(entry: Omit<HistoryEntry, "at">): Promise<void>;
+    /** Load the currently staged requests (empty array if none). */
+    loadStaged(): Promise<StagedRequest[]>;
+    /** Persist the full staging area (overwrites). */
+    saveStaged(staged: StagedRequest[]): Promise<void>;
+    /** Clear the staging area. */
+    clearStaged(): Promise<void>;
+    /** Read the full history log (empty if none). */
+    history(): Promise<HistoryEntry[]>;
+}
+//# sourceMappingURL=stateManager.d.ts.map

package/dist/stateManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateManager.d.ts","sourceRoot":"","sources":["../src/stateManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,QAAQ,SAAmB;IAOvC,mDAAmD;YACrC,UAAU;IAIxB,OAAO,CAAC,OAAO;IAMf,uEAAuE;YACzD,WAAW;IAMzB,kDAAkD;IAC5C,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5C,2DAA2D;IACrD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAUxD,yDAAyD;IACnD,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAqBtC,sDAAsD;IAChD,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAK5C,wEAAwE;IAClE,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC;IAQhB,0CAA0C;IACpC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5D,gEAAgE;IAC1D,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAS5C,kDAAkD;IAC5C,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD,8BAA8B;IACxB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,iDAAiD;IAC3C,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;CAQzC"}

package/dist/stateManager.js

@@ -0,0 +1,132 @@
+import { mkdir, readFile, writeFile, readdir, rename } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { randomBytes } from "node:crypto";
+/**
+ * Persists batch job metadata to disk under a state directory.
+ *
+ * Layout:
+ *   <stateDir>/
+ *     jobs/<batchId>.json    one file per submitted batch
+ *     history.jsonl          append-only operation log
+ *
+ * Assumptions (documented, MVP): single user, single machine, no concurrent
+ * processes. Writes are atomic (temp file + rename) so a crash mid-write won't
+ * corrupt an existing job file.
+ */
+export class StateManager {
+    stateDir;
+    jobsDir;
+    historyFile;
+    stagedFile;
+    constructor(stateDir = "./.batch-state") {
+        this.stateDir = stateDir;
+        this.jobsDir = path.join(stateDir, "jobs");
+        this.historyFile = path.join(stateDir, "history.jsonl");
+        this.stagedFile = path.join(stateDir, "staged.json");
+    }
+    /** Ensure the state directory structure exists. */
+    async ensureDirs() {
+        await mkdir(this.jobsDir, { recursive: true });
+    }
+    jobPath(batchId) {
+        // batchId is API-generated (msgbatch_...), safe as a filename, but guard anyway.
+        const safe = batchId.replace(/[^a-zA-Z0-9_.-]/g, "_");
+        return path.join(this.jobsDir, `${safe}.json`);
+    }
+    /** Atomic write: write to a temp file, then rename over the target. */
+    async atomicWrite(target, data) {
+        const tmp = `${target}.${randomBytes(6).toString("hex")}.tmp`;
+        await writeFile(tmp, data, "utf8");
+        await rename(tmp, target);
+    }
+    /** Persist (create or overwrite) a job record. */
+    async saveJob(job) {
+        await this.ensureDirs();
+        await this.atomicWrite(this.jobPath(job.batchId), JSON.stringify(job, null, 2));
+    }
+    /** Load a job record by batch id, or null if not found. */
+    async getJob(batchId) {
+        const file = this.jobPath(batchId);
+        if (!existsSync(file))
+            return null;
+        try {
+            return JSON.parse(await readFile(file, "utf8"));
+        }
+        catch {
+            return null;
+        }
+    }
+    /** List all job records, most recently created first. */
+    async listJobs() {
+        if (!existsSync(this.jobsDir))
+            return [];
+        const files = (await readdir(this.jobsDir)).filter((f) => f.endsWith(".json"));
+        const jobs = [];
+        for (const f of files) {
+            try {
+                jobs.push(JSON.parse(await readFile(path.join(this.jobsDir, f), "utf8")));
+            }
+            catch {
+                // skip corrupt/partial files
+            }
+        }
+        jobs.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+        return jobs;
+    }
+    /** The most recently created job, or null if none. */
+    async latestJob() {
+        const jobs = await this.listJobs();
+        return jobs[0] ?? null;
+    }
+    /** Update the status fields on an existing job (no-op if not found). */
+    async updateStatus(batchId, lastStatus) {
+        const job = await this.getJob(batchId);
+        if (!job)
+            return;
+        job.lastStatus = lastStatus;
+        job.lastCheckedAt = new Date().toISOString();
+        await this.saveJob(job);
+    }
+    /** Append an entry to the history log. */
+    async record(entry) {
+        await this.ensureDirs();
+        const line = JSON.stringify({ at: new Date().toISOString(), ...entry });
+        // Append is atomic enough for single-writer; each line is self-contained.
+        await writeFile(this.historyFile, line + "\n", { flag: "a" });
+    }
+    // --- staging (for the git-like CLI: add/review/send across invocations) ---
+    /** Load the currently staged requests (empty array if none). */
+    async loadStaged() {
+        if (!existsSync(this.stagedFile))
+            return [];
+        try {
+            return JSON.parse(await readFile(this.stagedFile, "utf8"));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Persist the full staging area (overwrites). */
+    async saveStaged(staged) {
+        await this.ensureDirs();
+        await this.atomicWrite(this.stagedFile, JSON.stringify(staged, null, 2));
+    }
+    /** Clear the staging area. */
+    async clearStaged() {
+        if (existsSync(this.stagedFile)) {
+            await this.atomicWrite(this.stagedFile, "[]");
+        }
+    }
+    /** Read the full history log (empty if none). */
+    async history() {
+        if (!existsSync(this.historyFile))
+            return [];
+        const raw = await readFile(this.historyFile, "utf8");
+        return raw
+            .split("\n")
+            .filter((l) => l.trim().length > 0)
+            .map((l) => JSON.parse(l));
+    }
+}
+//# sourceMappingURL=stateManager.js.map

package/dist/stateManager.js.map

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

package/dist/template.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Prompt template interpolation. Pure functions, no I/O — easy to unit test.
+ */
+export interface TemplateVars {
+    content: string;
+    filename: string;
+    index: number;
+}
+/**
+ * Interpolate `{content}`, `{filename}`, `{index}` into a template string.
+ * Unknown `{tokens}` are left untouched.
+ */
+export declare function interpolate(template: string, vars: TemplateVars): string;
+/**
+ * Derive an API-safe custom_id from an index + filename.
+ * The Batch API requires custom_id to match [a-zA-Z0-9_-] and be <=64 chars.
+ */
+export declare function toCustomId(index: number, filename: string): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAKxE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGlE"}

package/dist/template.js

@@ -0,0 +1,22 @@
+/**
+ * Prompt template interpolation. Pure functions, no I/O — easy to unit test.
+ */
+/**
+ * Interpolate `{content}`, `{filename}`, `{index}` into a template string.
+ * Unknown `{tokens}` are left untouched.
+ */
+export function interpolate(template, vars) {
+    return template
+        .replaceAll("{content}", vars.content)
+        .replaceAll("{filename}", vars.filename)
+        .replaceAll("{index}", String(vars.index));
+}
+/**
+ * Derive an API-safe custom_id from an index + filename.
+ * The Batch API requires custom_id to match [a-zA-Z0-9_-] and be <=64 chars.
+ */
+export function toCustomId(index, filename) {
+    const safe = filename.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return `${index}_${safe}`.slice(0, 64);
+}
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,IAAkB;IAC9D,OAAO,QAAQ;SACZ,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC;SACrC,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC;SACvC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,QAAgB;IACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Public types for batch-kit.
+ *
+ * We re-export a few SDK types so consumers don't need to import from
+ * @anthropic-ai/sdk directly for the common cases.
+ */
+import type { Message } from "@anthropic-ai/sdk/resources/messages/messages";
+/** Options for constructing a {@link BatchKit} instance. */
+export interface BatchKitOptions {
+    /** Anthropic API key. Defaults to `process.env.ANTHROPIC_API_KEY`. */
+    apiKey?: string;
+    /** Directory for persisted job state. Defaults to `./.batch-state`. */
+    stateDir?: string;
+    /** Default model for requests when not specified per-`add`. */
+    defaultModel?: string;
+    /** Default max_tokens for requests when not specified per-`add`. */
+    defaultMaxTokens?: number;
+}
+/** Options passed to {@link BatchKit.add}. */
+export interface AddOptions {
+    /**
+     * Prompt template. Supports `{content}`, `{filename}`, `{index}` variables.
+     */
+    prompt: string;
+    /** Model override for this batch of documents. */
+    model?: string;
+    /** max_tokens override for this batch of documents. */
+    maxTokens?: number;
+    /** File extensions to include (lowercase, with dot). Defaults to `.txt`, `.md`. */
+    extensions?: string[];
+}
+/** A single staged request, ready to be sent to the Batch API. */
+export interface StagedRequest {
+    /** Unique, API-safe id ([a-zA-Z0-9_-], <=64 chars). */
+    customId: string;
+    /** Source filename this request was built from. */
+    filename: string;
+    /** Fully-interpolated prompt text. */
+    prompt: string;
+    /** Model for this request. */
+    model: string;
+    /** max_tokens for this request. */
+    maxTokens: number;
+}
+/** Result of {@link BatchKit.review}. */
+export interface ReviewSummary {
+    /** Number of staged requests. */
+    count: number;
+    /** Filenames staged. */
+    files: string[];
+}
+/** Processing status mirrored from the Anthropic API. */
+export type ProcessingStatus = "in_progress" | "canceling" | "ended";
+/** Per-status tallies mirrored from the Anthropic API. */
+export interface RequestCounts {
+    processing: number;
+    succeeded: number;
+    errored: number;
+    canceled: number;
+    expired: number;
+}
+/** Maps a request's customId back to its source filename. */
+export interface JobRequestRef {
+    customId: string;
+    filename: string;
+}
+/** Persisted metadata for a single submitted batch. */
+export interface JobRecord {
+    /** Anthropic batch id (e.g. msgbatch_...). */
+    batchId: string;
+    /** ISO timestamp when submitted via this tool. */
+    createdAt: string;
+    /** Model used for the batch. */
+    model: string;
+    /** Number of requests in the batch. */
+    requestCount: number;
+    /** customId -> filename mapping for matching results back to files. */
+    requests: JobRequestRef[];
+    /** Last known processing status (updated on status/wait/fetch). */
+    lastStatus?: ProcessingStatus;
+    /** ISO timestamp of the last status check. */
+    lastCheckedAt?: string;
+}
+/** A single line in the append-only history log. */
+export interface HistoryEntry {
+    /** ISO timestamp of the operation. */
+    at: string;
+    /** Operation kind. */
+    op: "send" | "status" | "fetch";
+    /** Batch the operation concerns. */
+    batchId: string;
+    /** Optional free-form detail. */
+    detail?: string;
+}
+/** One result line from a completed batch, normalized for consumers. */
+export type BatchResult = {
+    customId: string;
+    type: "succeeded";
+    message: Message;
+    text: string;
+} | {
+    customId: string;
+    type: "errored";
+    error: unknown;
+} | {
+    customId: string;
+    type: "canceled";
+} | {
+    customId: string;
+    type: "expired";
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;AAE7E,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uDAAuD;AACvD,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,mEAAmE;IACnE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChC,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACtC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@otisworks/batch-kit",
+  "version": "0.0.1",
+  "description": "Ergonomic CLI + library for the Anthropic Message Batches API",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "batch": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "anthropic",
+    "claude",
+    "batch",
+    "batches",
+    "cli",
+    "ai"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/otisworks/batch-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/otisworks/batch-kit/issues"
+  },
+  "homepage": "https://github.com/otisworks/batch-kit#readme",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.112.4",
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.6.0"
+  }
+}