@bunny-agent/manager 0.9.28

package/dist/transcript.d.ts

@@ -0,0 +1,112 @@
+import type { TranscriptEntry, TranscriptWriter } from "./types.js";
+/**
+ * JSONL Transcript Writer
+ *
+ * Writes transcript entries as JSONL (JSON Lines) format for debugging and replay.
+ * Each line is a valid JSON object representing a transcript entry.
+ *
+ * @example
+ * ```ts
+ * import { JsonlTranscriptWriter } from "@bunny-agent/manager";
+ *
+ * const writer = new JsonlTranscriptWriter("./transcript.jsonl");
+ *
+ * const agent = new BunnyAgent({ ... });
+ * const response = await agent.stream({
+ *   messages,
+ *   transcriptWriter: writer,
+ * });
+ *
+ * // After streaming completes
+ * await writer.close();
+ * ```
+ */
+export declare class JsonlTranscriptWriter implements TranscriptWriter {
+    private readonly filePath;
+    private readonly stream;
+    private closed;
+    /**
+     * Create a new JSONL transcript writer
+     * @param filePath - Path to write the JSONL file
+     * @param options - Writer options
+     */
+    constructor(filePath: string, options?: {
+        append?: boolean;
+    });
+    /**
+     * Write a transcript entry as a JSONL line
+     */
+    write(entry: TranscriptEntry): void;
+    /**
+     * Close the writer and flush pending data
+     */
+    close(): Promise<void>;
+    /**
+     * Get the file path of the transcript
+     */
+    getFilePath(): string;
+}
+/**
+ * In-memory transcript writer for testing and debugging
+ *
+ * @example
+ * ```ts
+ * const writer = new MemoryTranscriptWriter();
+ * const response = await agent.stream({ messages, transcriptWriter: writer });
+ *
+ * // Access entries after streaming
+ * console.log(writer.getEntries());
+ * ```
+ */
+export declare class MemoryTranscriptWriter implements TranscriptWriter {
+    private readonly entries;
+    write(entry: TranscriptEntry): void;
+    /**
+     * Get all recorded entries
+     */
+    getEntries(): ReadonlyArray<TranscriptEntry>;
+    /**
+     * Get entries as JSONL string
+     */
+    toJsonl(): string;
+    /**
+     * Get only chunk entries with decoded text
+     */
+    getChunks(): string[];
+    /**
+     * Get the full streamed output as a single string
+     */
+    getFullOutput(): string;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+}
+/**
+ * Console transcript writer for debugging
+ * Outputs transcript entries to console in a readable format
+ */
+export declare class ConsoleTranscriptWriter implements TranscriptWriter {
+    private readonly prefix;
+    constructor(prefix?: string);
+    write(entry: TranscriptEntry): void;
+}
+/**
+ * Multi-writer that writes to multiple transcript writers
+ * Useful for both logging and recording simultaneously
+ *
+ * @example
+ * ```ts
+ * const writer = new MultiTranscriptWriter([
+ *   new JsonlTranscriptWriter("./transcript.jsonl"),
+ *   new ConsoleTranscriptWriter(),
+ * ]);
+ * ```
+ */
+export declare class MultiTranscriptWriter implements TranscriptWriter {
+    private readonly writers;
+    constructor(writers: TranscriptWriter[]);
+    write(entry: TranscriptEntry): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=transcript.d.ts.map

package/dist/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,qBAAsB,YAAW,gBAAgB;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;gBACS,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO;IAQhE;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAQnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAInC;;OAEG;IACH,UAAU,IAAI,aAAa,CAAC,eAAe,CAAC;IAI5C;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAMrB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,SAAiB;IAInC,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;CAmBpC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAsB,YAAW,gBAAgB;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,EAAE,gBAAgB,EAAE;IAIjC,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/transcript.js

@@ -0,0 +1,176 @@
+import * as fs from "node:fs";
+/**
+ * JSONL Transcript Writer
+ *
+ * Writes transcript entries as JSONL (JSON Lines) format for debugging and replay.
+ * Each line is a valid JSON object representing a transcript entry.
+ *
+ * @example
+ * ```ts
+ * import { JsonlTranscriptWriter } from "@bunny-agent/manager";
+ *
+ * const writer = new JsonlTranscriptWriter("./transcript.jsonl");
+ *
+ * const agent = new BunnyAgent({ ... });
+ * const response = await agent.stream({
+ *   messages,
+ *   transcriptWriter: writer,
+ * });
+ *
+ * // After streaming completes
+ * await writer.close();
+ * ```
+ */
+export class JsonlTranscriptWriter {
+    filePath;
+    stream;
+    closed = false;
+    /**
+     * Create a new JSONL transcript writer
+     * @param filePath - Path to write the JSONL file
+     * @param options - Writer options
+     */
+    constructor(filePath, options = {}) {
+        this.filePath = filePath;
+        this.stream = fs.createWriteStream(filePath, {
+            flags: options.append ? "a" : "w",
+            encoding: "utf-8",
+        });
+    }
+    /**
+     * Write a transcript entry as a JSONL line
+     */
+    write(entry) {
+        if (this.closed) {
+            throw new Error("TranscriptWriter is closed");
+        }
+        const line = JSON.stringify(entry) + "\n";
+        this.stream.write(line);
+    }
+    /**
+     * Close the writer and flush pending data
+     */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        return new Promise((resolve, reject) => {
+            this.stream.end((error) => {
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Get the file path of the transcript
+     */
+    getFilePath() {
+        return this.filePath;
+    }
+}
+/**
+ * In-memory transcript writer for testing and debugging
+ *
+ * @example
+ * ```ts
+ * const writer = new MemoryTranscriptWriter();
+ * const response = await agent.stream({ messages, transcriptWriter: writer });
+ *
+ * // Access entries after streaming
+ * console.log(writer.getEntries());
+ * ```
+ */
+export class MemoryTranscriptWriter {
+    entries = [];
+    write(entry) {
+        this.entries.push(entry);
+    }
+    /**
+     * Get all recorded entries
+     */
+    getEntries() {
+        return this.entries;
+    }
+    /**
+     * Get entries as JSONL string
+     */
+    toJsonl() {
+        return this.entries.map((e) => JSON.stringify(e)).join("\n") + "\n";
+    }
+    /**
+     * Get only chunk entries with decoded text
+     */
+    getChunks() {
+        return this.entries
+            .filter((e) => e.type === "chunk" && e.text)
+            .map((e) => e.text);
+    }
+    /**
+     * Get the full streamed output as a single string
+     */
+    getFullOutput() {
+        return this.getChunks().join("");
+    }
+    /**
+     * Clear all entries
+     */
+    clear() {
+        this.entries.length = 0;
+    }
+}
+/**
+ * Console transcript writer for debugging
+ * Outputs transcript entries to console in a readable format
+ */
+export class ConsoleTranscriptWriter {
+    prefix;
+    constructor(prefix = "[Transcript]") {
+        this.prefix = prefix;
+    }
+    write(entry) {
+        const timestamp = new Date(entry.timestamp).toISOString();
+        const type = entry.type.toUpperCase().padEnd(8);
+        if (entry.type === "chunk" && entry.text) {
+            // For chunks, show the text content
+            console.log(`${this.prefix} ${timestamp} ${type} ${entry.text}`);
+        }
+        else if (entry.type === "error") {
+            console.error(`${this.prefix} ${timestamp} ${type} ${entry.text ?? entry.data}`);
+        }
+        else if (entry.metadata) {
+            console.log(`${this.prefix} ${timestamp} ${type} ${JSON.stringify(entry.metadata)}`);
+        }
+        else {
+            console.log(`${this.prefix} ${timestamp} ${type}`);
+        }
+    }
+}
+/**
+ * Multi-writer that writes to multiple transcript writers
+ * Useful for both logging and recording simultaneously
+ *
+ * @example
+ * ```ts
+ * const writer = new MultiTranscriptWriter([
+ *   new JsonlTranscriptWriter("./transcript.jsonl"),
+ *   new ConsoleTranscriptWriter(),
+ * ]);
+ * ```
+ */
+export class MultiTranscriptWriter {
+    writers;
+    constructor(writers) {
+        this.writers = writers;
+    }
+    async write(entry) {
+        await Promise.all(this.writers.map((w) => w.write(entry)));
+    }
+    async close() {
+        await Promise.all(this.writers.map((w) => (w.close ? w.close() : Promise.resolve())));
+    }
+}
+//# sourceMappingURL=transcript.js.map

package/dist/transcript.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,249 @@
+/**
+ * Volume info (for backends that support persistent volumes)
+ */
+export interface Volume {
+    volumeId: string;
+    /** Space ID from the backend (e.g. Sandock space id when volume is tied to a space) */
+    spaceId?: string;
+    mountPath: string;
+    /** Optional display name (e.g. volume name from config) */
+    name?: string;
+}
+/**
+ * Options for executing a command in the sandbox
+ */
+export interface ExecOptions {
+    /** Working directory for the command */
+    cwd?: string;
+    /**
+     * Environment variables for normal `exec` (merged into the subprocess env).
+     * Not used by {@link streamCodingRunFromSandbox} — put runner vars in
+     * {@link BunnyAgentCodingRunBody.env} instead.
+     */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** AbortSignal for cancelling the operation */
+    signal?: AbortSignal;
+}
+/**
+ * JSON body for bunny-agent-daemon `POST /api/coding/run` (same shape as apps/daemon).
+ */
+export interface BunnyAgentCodingRunBody {
+    runner?: string;
+    model?: string;
+    userInput: string;
+    systemPrompt?: string;
+    maxTurns?: number;
+    allowedTools?: string[];
+    resume?: string;
+    skillPaths?: string[];
+    cwd?: string;
+    /**
+     * Extra env vars merged into the runner subprocess env (after daemon `process.env`).
+     * String keys and string values only; invalid entries are dropped by the daemon.
+     */
+    env?: Record<string, string>;
+    /** Skip tool approval checks (bypass permissions). */
+    yolo?: boolean;
+}
+/**
+ * Represents a handle to an active sandbox instance
+ */
+export interface SandboxHandle {
+    /**
+     * Get the sandbox instance ID (available after attach).
+     * Returns null for local sandboxes that don't have a remote ID.
+     */
+    getSandboxId(): string | null;
+    /**
+     * Get the volume mounts for this sandbox (available after attach).
+     * Returns null for sandboxes that don't support volumes.
+     */
+    getVolumes(): Volume[] | null;
+    /**
+     * Get the working directory for this sandbox handle
+     * @returns The working directory path
+     */
+    getWorkdir(): string;
+    /**
+     * Execute a command in the sandbox and stream the output
+     * @param command - The command and arguments to execute
+     * @param opts - Execution options
+     * @returns An async iterable of stdout chunks
+     */
+    exec(command: string[], opts?: ExecOptions): AsyncIterable<Uint8Array>;
+    /**
+     * Upload files to the sandbox
+     * @param files - Array of files to upload
+     * @param targetDir - Target directory in the sandbox
+     */
+    upload(files: Array<{
+        path: string;
+        content: Uint8Array | string;
+    }>, targetDir: string): Promise<void>;
+    /**
+     * Read a file from the sandbox
+     * @param filePath - Path to the file in the sandbox
+     * @returns The file content as a string
+     */
+    readFile(filePath: string): Promise<string>;
+    /**
+     * Destroy the sandbox and release resources
+     */
+    destroy(): Promise<void>;
+}
+/**
+ * Question for AskUserQuestion tool
+ */
+export interface Question {
+    question: string;
+    header?: string;
+    options?: Array<{
+        label: string;
+        description?: string;
+    }>;
+    multiSelect?: boolean;
+}
+/**
+ * Adapter interface for sandbox implementations
+ */
+export interface SandboxAdapter {
+    /**
+     * Attach to or create a sandbox
+     * @returns A handle to the sandbox
+     */
+    attach(): Promise<SandboxHandle>;
+    /**
+     * Get the current handle if already attached, or null if not attached yet.
+     * @returns A handle to the sandbox if already attached, null otherwise
+     */
+    getHandle(): SandboxHandle | null;
+    /**
+     * Get the environment variables configured for this sandbox.
+     * These will be passed to all commands executed in the sandbox.
+     */
+    getEnv?(): Record<string, string>;
+    /**
+     * Get the working directory configured for this sandbox.
+     */
+    getWorkdir?(): string;
+    /**
+     * Get the runner command to execute in the sandbox.
+     * Returns the command array (e.g., ["bunny-agent", "run"] or ["node", "/path/to/bundle.mjs", "run"])
+     */
+    getRunnerCommand?(): string[];
+}
+/**
+ * Output format types
+ * - "text": Plain text output (final result only)
+ * - "json": Single JSON result object
+ * - "stream-json": Realtime streaming JSON (NDJSON)
+ * - "stream": SSE-based AI SDK UI Data Stream format
+ */
+export type OutputFormat = "text" | "json" | "stream-json" | "stream";
+/**
+ * Specification for the agent runner
+ */
+export interface RunnerSpec {
+    /** The model to use */
+    model: string;
+    /**
+     * CLI runner type: which implementation to use when running `bunny-agent run`
+     * (e.g. claude, pi, codex, gemini, opencode). Default is "claude".
+     */
+    runnerType?: "claude" | "pi" | "codex" | "gemini" | "opencode";
+    /** Optional system prompt override (overrides template's CLAUDE.md) */
+    systemPrompt?: string;
+    /** Maximum number of conversation turns */
+    maxTurns?: number;
+    /** Allowed tools (undefined means all tools, or use template's settings) */
+    allowedTools?: string[];
+    /** Output format for streaming responses */
+    outputFormat?: OutputFormat;
+    /** Additional skill paths (files or directories) for pi runner */
+    skillPaths?: string[];
+    /**
+     * When true, skip all tool approval checks (bypass permissions).
+     * When false (default), runner pauses before executing any tool and waits for approval
+     * via the .bunny-agent/approvals/{toolUseID}.json file mechanism.
+     */
+    yolo?: boolean;
+}
+/**
+ * Options for creating a BunnyAgent instance
+ */
+export interface BunnyAgentOptions {
+    /** Sandbox adapter to use */
+    sandbox: SandboxAdapter;
+    /** Runner specification */
+    runner: RunnerSpec;
+    /** Environment variables to pass to the sandbox */
+    env?: Record<string, string>;
+}
+/**
+ * A message in the conversation
+ */
+export interface Message {
+    /** Role of the message sender */
+    role: "user" | "assistant" | "system";
+    /** Content of the message */
+    content: string | Array<{
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+    }>;
+}
+/**
+ * Input for streaming a task
+ */
+export interface StreamInput {
+    /** Messages to send to the agent */
+    messages: Message[];
+    /** Workspace configuration */
+    workspace?: {
+        /** Path to the workspace directory */
+        path?: string;
+    };
+    /** Content type for the response (defaults to text/event-stream) */
+    contentType?: string;
+    /** Transcript writer for recording all streamed data (optional) */
+    transcriptWriter?: TranscriptWriter;
+    /** Runner session ID to resume a previous conversation (from assistant message metadata) */
+    resume?: string;
+    /** AbortSignal for cancelling the operation */
+    signal?: AbortSignal;
+}
+/**
+ * A single transcript entry
+ */
+export interface TranscriptEntry {
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Type of entry */
+    type: "chunk" | "metadata" | "error" | "start" | "end";
+    /** Raw data (base64 encoded for binary) */
+    data?: string;
+    /** Decoded text (if data is text) */
+    text?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Interface for writing transcript entries
+ */
+export interface TranscriptWriter {
+    /**
+     * Write a transcript entry
+     * @param entry - The entry to write
+     */
+    write(entry: TranscriptEntry): void | Promise<void>;
+    /**
+     * Close the writer and flush any pending data
+     */
+    close?(): void | Promise<void>;
+}
+//# 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":"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"}

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,50 @@
+{
+  "name": "@bunny-agent/manager",
+  "version": "0.9.28",
+  "description": "BunnyAgent Manager - Manages sandbox and runner lifecycle, defines core interfaces",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vikadata/bunny-agent.git",
+    "directory": "packages/manager"
+  },
+  "keywords": [
+    "sandbox",
+    "agent",
+    "bunny-agent",
+    "runner",
+    "manager"
+  ],
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.6.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo 'no lint configured'",
+    "test": "vitest run --passWithNoTests"
+  }
+}