@ap3x/browser-agent 0.1.0

package/dist/filesystem/external-read.d.ts

@@ -0,0 +1,18 @@
+/** A pdf/docx file could not be parsed (corrupt, password-protected, not really that type). */
+export declare class FileParseError extends Error {
+    readonly path: string;
+    readonly name = "FileParseError";
+    constructor(path: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Read a whitelisted external file, dispatching on extension: `.pdf` and
+ * `.docx` are parsed to plain text; everything else is read as UTF-8 text
+ * (the pre-M11 behavior). Throws {@link FileParseError} for a malformed
+ * pdf/docx; a plain `fs` error (e.g. ENOENT) for a missing/unreadable path
+ * either way — both are caught at the `read_file` action boundary and turned
+ * into an `ActionResult.error`. The returned text is capped at {@link MAX_CHARS}.
+ */
+export declare function readExternalFile(path: string): Promise<string>;
+//# sourceMappingURL=external-read.d.ts.map

package/dist/filesystem/external-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-read.d.ts","sourceRoot":"","sources":["../../src/filesystem/external-read.ts"],"names":[],"mappings":"AAkDA,+FAA+F;AAC/F,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFvB,SAAkB,IAAI,oBAAoB;gBAE/B,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIhC;AAyFD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKpE"}

package/dist/filesystem/file-system.d.ts

@@ -0,0 +1,61 @@
+/** Serialized form for checkpoint/resume. */
+export interface FileSystemState {
+    files: Record<string, {
+        type: string;
+        data: string;
+    }>;
+    baseDir: string;
+    extractedContentCount: number;
+}
+/**
+ * Sanitize a full filename (static, matches the goldens): basename first (kills
+ * `../` traversal), stem repaired, extension lowercased. A stem that sanitizes to
+ * nothing becomes `file`.
+ */
+export declare function sanitizeFilename(name: string): string;
+export declare class FileSystem {
+    private readonly files;
+    private extractedContentCount;
+    readonly baseDir: string;
+    readonly dataDir: string;
+    private constructor();
+    /** Create a fresh filesystem. The data dir is wiped and recreated. */
+    static create(baseDir: string, options?: {
+        createDefaultFiles?: boolean;
+    }): Promise<FileSystem>;
+    /** Restore from a checkpoint at the same base dir; unknown types skipped. */
+    static fromState(state: FileSystemState): Promise<FileSystem>;
+    /** Serialize for checkpoint. */
+    getState(): FileSystemState;
+    getAllowedExtensions(): readonly string[];
+    getDir(): string;
+    listFiles(): string[];
+    /** Raw content of a managed file, or undefined. */
+    getFile(name: string): string | undefined;
+    /** The always-present todo.md content. */
+    getTodoContents(): string;
+    /** Write (replacing) a managed file. Returns an LLM-facing message. */
+    writeFile(name: string, content: string): Promise<string>;
+    /** Append to a managed file (creating it if new). */
+    appendFile(name: string, content: string): Promise<string>;
+    /** Targeted string replace — the todo.md checkbox-update primitive. */
+    replaceFileStr(name: string, oldStr: string, newStr: string): Promise<string>;
+    /** Read a managed file; formatted message. */
+    readFile(name: string): string;
+    /** Raw content for done attachments. */
+    displayFile(name: string): string | undefined;
+    /** Save extracted content to an auto-numbered file; returns the filename. */
+    saveExtractedContent(content: string): Promise<string>;
+    /** Remove the data dir from disk (in-memory state untouched). */
+    nuke(): Promise<void>;
+    /**
+     * Prompt-friendly listing of every file EXCEPT todo.md (which is surfaced whole
+     * elsewhere). Small files shown whole; large files previewed head+tail.
+     */
+    describe(): string;
+    private preview;
+    /** Validate + sanitize a target name, or return an LLM-facing error. */
+    private resolve;
+    private syncFile;
+}
+//# sourceMappingURL=file-system.d.ts.map

package/dist/filesystem/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../src/filesystem/file-system.ts"],"names":[],"mappings":"AAsCA,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAwBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AAmED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,qBAAqB,CAAK;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO;IAKP,sEAAsE;WACzD,MAAM,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAO,GAC7C,OAAO,CAAC,UAAU,CAAC;IAWtB,6EAA6E;WAChE,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAenE,gCAAgC;IAChC,QAAQ,IAAI,eAAe;IAM3B,oBAAoB,IAAI,SAAS,MAAM,EAAE;IAIzC,MAAM,IAAI,MAAM;IAIhB,SAAS,IAAI,MAAM,EAAE;IAIrB,mDAAmD;IACnD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC,0CAA0C;IAC1C,eAAe,IAAI,MAAM;IAIzB,uEAAuE;IACjE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS/D,qDAAqD;IAC/C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUhE,uEAAuE;IACjE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUnF,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAO9B,wCAAwC;IACxC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI7C,6EAA6E;IACvE,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ5D,iEAAiE;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAclB,OAAO,CAAC,OAAO;IAQf,wEAAwE;IACxE,OAAO,CAAC,OAAO;YA+BD,QAAQ;CAKvB"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @ap3x/browser-agent — the agent (loop, actions, history) that drives a
+ * browser over @ap3x/browser using @ap3x/ai for reasoning. M4 shipped the action
+ * registry + `defineAction`, the built-in actions, the sensitive-data pipeline,
+ * and the FileSystem workspace. M5 adds the agent step loop: the AgentOutput
+ * schema, the 3-slot message manager, context/nudge assembly, the multi-action
+ * executor, run history, the usage ledger, and the public `Agent`.
+ */
+export declare const PACKAGE = "@ap3x/browser-agent";
+export declare const VERSION = "0.1.0";
+export * from "./types";
+export * from "./tools/registry";
+export * from "./tools/actions";
+export * from "./tools/sensitive";
+export * from "./filesystem/file-system";
+export * from "./filesystem/external-read";
+export * from "./agent/output-schema";
+export * from "./agent/message-manager";
+export * from "./agent/context-builder";
+export * from "./agent/executor";
+export * from "./agent/history";
+export * from "./agent/step-loop";
+export * from "./agent/agent";
+export * from "./usage/ledger";
+export * from "./agent/event-stream";
+export { BrowserAgentBackend } from "./agent/backend";
+export * from "./observability/logger";
+export * from "./mcp";
+export * from "./agent/rematch";
+export * from "./agent/variable-detector";
+export * from "./agent/replay";
+export * from "./agent/gif";
+export * from "./agent/judge";
+export * from "./agent/captcha-watchdog";
+export * from "./agent/video";
+export * from "./testing";
+//# 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;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,wBAAwB,CAAC;AAC7C,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,OAAO,CAAC;AAGtB,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAI/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAG9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}