@inbrowser/agent 0.0.0-placeholder → 0.2.0

package/dist/events/codec.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Event value codec — round-trip non-JSON-safe values through the log.
+ *
+ * The naive approach (`JSON.stringify` everything that lands in
+ * `args`, `before`, `after`) is lossy for the exact types real
+ * Firebase code uses:
+ *
+ *   - `Date` → ISO string. Replay writes `string` where `Date` was.
+ *   - `Timestamp` (Firestore) → `{ seconds, nanoseconds }` map. Replay
+ *     writes a MAP, not a Timestamp. Range queries break silently.
+ *   - `FieldValue.serverTimestamp()` → `{}`. Sentinel never fires.
+ *   - `Uint8Array` → array of numbers. Bytes corrupted.
+ *   - `bigint` → throws (JSON.stringify can't serialize bigint).
+ *
+ * This module provides a small, extensible codec layer. The default
+ * codec handles the universal cases (Date / Uint8Array / bigint) via
+ * tagged envelopes. Hosts with domain-specific types (Firestore
+ * Timestamp, FieldValue, DocumentReference) compose their own codec
+ * on top — see `composeCodecs` + the AGENTS.md recipe.
+ *
+ * Not handled: `undefined`. Firestore doesn't write `undefined` to
+ * docs (it throws), and JSON.stringify drops `undefined`-valued
+ * object properties before we ever see them. Encoding it would
+ * require a "no-transform" sentinel that the walker collides with;
+ * not worth the complexity for a value real Firebase code never
+ * produces.
+ *
+ * Tagged envelope shape: `{ "__pyric": "<tag>", ...fields }`. The
+ * `__pyric` prefix makes encoded values self-describing and the
+ * round-trip lossless. Hosts using `__pyric` for their own things
+ * SHOULD pick a different prefix.
+ */
+export declare const ENVELOPE_KEY: "__pyric";
+export interface EventValueCodec {
+    /** Convert a value into a JSON-safe shape. Identity on already-safe values. */
+    encode(value: unknown): unknown;
+    /** Invert `encode`. Identity on values that have no envelope. */
+    decode(value: unknown): unknown;
+}
+/**
+ * Walks a value tree, applying a per-node transform. Returns a new
+ * tree (the input is NOT mutated). The transform returns `undefined`
+ * for nodes it doesn't want to transform; the walker then recurses
+ * into the node's children — BUT only when the node is a plain
+ * object or an array. Class instances (anything whose prototype is
+ * not `Object.prototype`) are returned as-is so composed codecs
+ * don't accidentally Object.entries() through a typed value and
+ * rebuild it as a bag-of-fields.
+ *
+ * Exported so codec authors can build their own codecs correctly —
+ * see `codec.ts` header for the pattern.
+ */
+export declare function walkValue(value: unknown, transform: (v: unknown) => unknown): unknown;
+/**
+ * Default codec — handles universal non-JSON types every consumer
+ * needs. Hosts compose Firestore-specific codecs on top via
+ * `composeCodecs`.
+ */
+export declare const defaultEventValueCodec: EventValueCodec;
+/**
+ * Identity codec — pass-through. Use when the host serializes args
+ * itself before passing to a wrapped tool (e.g. tool args are
+ * already JSON-safe by contract). Cheaper than `defaultEventValueCodec`
+ * because it skips the walk.
+ */
+export declare const identityCodec: EventValueCodec;
+/**
+ * Compose two codecs. The outer codec encodes first, decodes last.
+ *
+ *   composeCodecs(outer, inner)
+ *     encode(v) → outer.encode(inner.encode(v))
+ *     decode(v) → inner.decode(outer.decode(v))
+ *
+ * Typical usage: layer a Firestore codec over the default.
+ *
+ *   const codec = composeCodecs(firestoreCodec, defaultEventValueCodec);
+ */
+export declare function composeCodecs(outer: EventValueCodec, inner: EventValueCodec): EventValueCodec;
+//# sourceMappingURL=codec.d.ts.map

package/dist/events/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/events/codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,eAAO,MAAM,YAAY,EAAG,SAAkB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAChC,iEAAiE;IACjE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAiBrF;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAqCpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,eAG3B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAAG,eAAe,CAK7F"}

package/dist/events/codec.js

@@ -0,0 +1,142 @@
+/**
+ * Event value codec — round-trip non-JSON-safe values through the log.
+ *
+ * The naive approach (`JSON.stringify` everything that lands in
+ * `args`, `before`, `after`) is lossy for the exact types real
+ * Firebase code uses:
+ *
+ *   - `Date` → ISO string. Replay writes `string` where `Date` was.
+ *   - `Timestamp` (Firestore) → `{ seconds, nanoseconds }` map. Replay
+ *     writes a MAP, not a Timestamp. Range queries break silently.
+ *   - `FieldValue.serverTimestamp()` → `{}`. Sentinel never fires.
+ *   - `Uint8Array` → array of numbers. Bytes corrupted.
+ *   - `bigint` → throws (JSON.stringify can't serialize bigint).
+ *
+ * This module provides a small, extensible codec layer. The default
+ * codec handles the universal cases (Date / Uint8Array / bigint) via
+ * tagged envelopes. Hosts with domain-specific types (Firestore
+ * Timestamp, FieldValue, DocumentReference) compose their own codec
+ * on top — see `composeCodecs` + the AGENTS.md recipe.
+ *
+ * Not handled: `undefined`. Firestore doesn't write `undefined` to
+ * docs (it throws), and JSON.stringify drops `undefined`-valued
+ * object properties before we ever see them. Encoding it would
+ * require a "no-transform" sentinel that the walker collides with;
+ * not worth the complexity for a value real Firebase code never
+ * produces.
+ *
+ * Tagged envelope shape: `{ "__pyric": "<tag>", ...fields }`. The
+ * `__pyric` prefix makes encoded values self-describing and the
+ * round-trip lossless. Hosts using `__pyric` for their own things
+ * SHOULD pick a different prefix.
+ */
+export const ENVELOPE_KEY = '__pyric';
+/**
+ * Walks a value tree, applying a per-node transform. Returns a new
+ * tree (the input is NOT mutated). The transform returns `undefined`
+ * for nodes it doesn't want to transform; the walker then recurses
+ * into the node's children — BUT only when the node is a plain
+ * object or an array. Class instances (anything whose prototype is
+ * not `Object.prototype`) are returned as-is so composed codecs
+ * don't accidentally Object.entries() through a typed value and
+ * rebuild it as a bag-of-fields.
+ *
+ * Exported so codec authors can build their own codecs correctly —
+ * see `codec.ts` header for the pattern.
+ */
+export function walkValue(value, transform) {
+    const replaced = transform(value);
+    if (replaced !== undefined)
+        return replaced;
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value))
+        return value.map((v) => walkValue(v, transform));
+    // Only descend into plain {} objects. A class instance reaches here
+    // either because the transform doesn't recognize it (likely the
+    // caller's own type — return unchanged), or because we already
+    // decoded an envelope into an instance and a *later* pass shouldn't
+    // re-walk its fields.
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== Object.prototype && proto !== null)
+        return value;
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        out[k] = walkValue(v, transform);
+    }
+    return out;
+}
+/**
+ * Default codec — handles universal non-JSON types every consumer
+ * needs. Hosts compose Firestore-specific codecs on top via
+ * `composeCodecs`.
+ */
+export const defaultEventValueCodec = {
+    encode(value) {
+        return walkValue(value, (v) => {
+            if (v instanceof Date) {
+                return { [ENVELOPE_KEY]: 'Date', iso: v.toISOString() };
+            }
+            if (v instanceof Uint8Array) {
+                return {
+                    [ENVELOPE_KEY]: 'Uint8Array',
+                    b64: Buffer.from(v).toString('base64'),
+                };
+            }
+            if (typeof v === 'bigint') {
+                return { [ENVELOPE_KEY]: 'bigint', value: v.toString() };
+            }
+            return undefined;
+        });
+    },
+    decode(value) {
+        return walkValue(value, (v) => {
+            if (v === null || typeof v !== 'object')
+                return undefined;
+            if (Array.isArray(v))
+                return undefined;
+            const obj = v;
+            const tag = obj[ENVELOPE_KEY];
+            if (typeof tag !== 'string')
+                return undefined;
+            if (tag === 'Date' && typeof obj['iso'] === 'string') {
+                return new Date(obj['iso']);
+            }
+            if (tag === 'Uint8Array' && typeof obj['b64'] === 'string') {
+                return new Uint8Array(Buffer.from(obj['b64'], 'base64'));
+            }
+            if (tag === 'bigint' && typeof obj['value'] === 'string') {
+                return BigInt(obj['value']);
+            }
+            return undefined;
+        });
+    },
+};
+/**
+ * Identity codec — pass-through. Use when the host serializes args
+ * itself before passing to a wrapped tool (e.g. tool args are
+ * already JSON-safe by contract). Cheaper than `defaultEventValueCodec`
+ * because it skips the walk.
+ */
+export const identityCodec = {
+    encode: (v) => v,
+    decode: (v) => v,
+};
+/**
+ * Compose two codecs. The outer codec encodes first, decodes last.
+ *
+ *   composeCodecs(outer, inner)
+ *     encode(v) → outer.encode(inner.encode(v))
+ *     decode(v) → inner.decode(outer.decode(v))
+ *
+ * Typical usage: layer a Firestore codec over the default.
+ *
+ *   const codec = composeCodecs(firestoreCodec, defaultEventValueCodec);
+ */
+export function composeCodecs(outer, inner) {
+    return {
+        encode: (v) => outer.encode(inner.encode(v)),
+        decode: (v) => inner.decode(outer.decode(v)),
+    };
+}
+//# sourceMappingURL=codec.js.map

package/dist/events/codec.js.map

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

package/dist/events/log-core.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Pure / browser-safe pieces of the event log surface:
+ *
+ *   - `EventLog`, `AppendDraft` — types describing the writer's
+ *     contract; consumers (wrap, replay) describe handlers without
+ *     pulling in the writer implementation.
+ *   - `HOST_AGENT_ID` — string constant; canonical declaration is
+ *     `types/events.ts` (also browser-safe).
+ *   - `generateEventId`, `buildRollbackEvent`, `EventTooLargeError`,
+ *     `DEFAULT_MAX_EVENT_BYTES` — pure helpers used by both the
+ *     Node-side writer (`log.ts`) and the browser-safe `wrapMutating`
+ *     decorator.
+ *
+ * The Node-side writer (`openEventLog`, `defaultProjectLogDir`) lives
+ * in `./log.ts` and imports `node:fs` / `node:os`. Splitting along
+ * this axis lets `wrap.ts` and the universal `@inbrowser/agent` entry
+ * use the pure helpers without dragging Node imports into browser
+ * bundles.
+ */
+import type { MutationEvent, MutationEventFilter, ReverseOp } from '../types/events.js';
+export { HOST_AGENT_ID } from '../types/events.js';
+/**
+ * Default per-event byte cap. Matches the Linux PIPE_BUF default and
+ * stays well inside macOS's atomic-write window. Above this, append
+ * atomicity isn't guaranteed and concurrent writers can interleave.
+ */
+export declare const DEFAULT_MAX_EVENT_BYTES: number;
+/**
+ * Time-prefixed base36 id with an optional per-log sequence so two
+ * appends within the same millisecond stay strictly sortable by
+ * emission order. Without the sequence the only tiebreaker is the
+ * random suffix, which can flip ordering — a real bug for
+ * `replayEvents`'s sinceEventId cursor.
+ */
+export declare function generateEventId(now?: () => number, sequence?: number): string;
+export declare class EventTooLargeError extends Error {
+    readonly bytes: number;
+    readonly cap: number;
+    readonly tool: string;
+    readonly name = "EventTooLargeError";
+    constructor(bytes: number, cap: number, tool: string);
+}
+export interface EventLog {
+    readonly path: string;
+    readonly projectId: string;
+    /**
+     * Append a single event. `id` + `ts` are auto-populated when absent
+     * so callers can pass a partial draft. Returns the full event for
+     * convenience (e.g. wrapMutating's plan-then-commit flow).
+     */
+    append(draft: AppendDraft): MutationEvent;
+    /**
+     * Read all events matching the filter. Returns an array, not a
+     * stream — the log is small (tens to thousands of events).
+     */
+    read(filter?: MutationEventFilter): MutationEvent[];
+    /**
+     * Lazily-built cache of event ids that have already been applied
+     * by `replayEvents` (i.e. an event with
+     * `metadata.type === 'migrate_applied'` referencing them exists).
+     * Invalidated on every `append`.
+     */
+    appliedEventIds(): Set<string>;
+    /** Release resources. Idempotent. */
+    close(): void;
+}
+export type AppendDraft = Omit<MutationEvent, 'id' | 'ts'> & Partial<Pick<MutationEvent, 'id' | 'ts'>>;
+export declare function buildRollbackEvent(opts: {
+    original: MutationEvent;
+    reason: 'failure' | 'undo';
+    reverseOp?: ReverseOp;
+    agent: string;
+    sessionId: string;
+    now?: () => number;
+}): AppendDraft;
+//# sourceMappingURL=log-core.d.ts.map

package/dist/events/log-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-core.d.ts","sourceRoot":"","sources":["../../src/events/log-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EAEnB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAY,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,MAAiB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvF;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAJvB,SAAkB,IAAI,wBAAwB;gBAEnC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM;CASxB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAAC;IAC1C;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,aAAa,EAAE,CAAC;IACpD;;;;;OAKG;IACH,eAAe,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,qCAAqC;IACrC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC,GACxD,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;AAE5C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GAAG,WAAW,CAiBd"}

package/dist/events/log-core.js

@@ -0,0 +1,73 @@
+/**
+ * Pure / browser-safe pieces of the event log surface:
+ *
+ *   - `EventLog`, `AppendDraft` — types describing the writer's
+ *     contract; consumers (wrap, replay) describe handlers without
+ *     pulling in the writer implementation.
+ *   - `HOST_AGENT_ID` — string constant; canonical declaration is
+ *     `types/events.ts` (also browser-safe).
+ *   - `generateEventId`, `buildRollbackEvent`, `EventTooLargeError`,
+ *     `DEFAULT_MAX_EVENT_BYTES` — pure helpers used by both the
+ *     Node-side writer (`log.ts`) and the browser-safe `wrapMutating`
+ *     decorator.
+ *
+ * The Node-side writer (`openEventLog`, `defaultProjectLogDir`) lives
+ * in `./log.ts` and imports `node:fs` / `node:os`. Splitting along
+ * this axis lets `wrap.ts` and the universal `@inbrowser/agent` entry
+ * use the pure helpers without dragging Node imports into browser
+ * bundles.
+ */
+export { HOST_AGENT_ID } from '../types/events.js';
+/**
+ * Default per-event byte cap. Matches the Linux PIPE_BUF default and
+ * stays well inside macOS's atomic-write window. Above this, append
+ * atomicity isn't guaranteed and concurrent writers can interleave.
+ */
+export const DEFAULT_MAX_EVENT_BYTES = 64 * 1024;
+/**
+ * Time-prefixed base36 id with an optional per-log sequence so two
+ * appends within the same millisecond stay strictly sortable by
+ * emission order. Without the sequence the only tiebreaker is the
+ * random suffix, which can flip ordering — a real bug for
+ * `replayEvents`'s sinceEventId cursor.
+ */
+export function generateEventId(now = Date.now, sequence) {
+    const ts = now().toString(36).padStart(9, '0');
+    const seq = sequence !== undefined ? `-${sequence.toString(36).padStart(4, '0')}` : '';
+    const rand = Math.random().toString(36).slice(2, 6);
+    return `${ts}${seq}-${rand}`;
+}
+export class EventTooLargeError extends Error {
+    bytes;
+    cap;
+    tool;
+    name = 'EventTooLargeError';
+    constructor(bytes, cap, tool) {
+        super(`event for tool=${tool} is ${bytes} bytes, exceeds cap ${cap}. ` +
+            `Atomic append is not guaranteed above this size; concurrent writers can interleave. ` +
+            `Raise via openEventLog({ maxEventBytes }) only if you accept the loss of atomicity guarantees, ` +
+            `or shrink the payload (truncate before/after snapshots, omit large args).`);
+        this.bytes = bytes;
+        this.cap = cap;
+        this.tool = tool;
+    }
+}
+export function buildRollbackEvent(opts) {
+    const nowFn = opts.now ?? Date.now;
+    void nowFn;
+    return {
+        agent: opts.agent,
+        sessionId: opts.sessionId,
+        tool: opts.original.tool,
+        phase: 'rollback',
+        target: opts.original.target,
+        reversible: false,
+        irreversibleReason: 'rollback events are terminal',
+        ...(opts.reverseOp ? { reverseOp: opts.reverseOp } : {}),
+        metadata: {
+            reason: opts.reason,
+            originalEventId: opts.original.id,
+        },
+    };
+}
+//# sourceMappingURL=log-core.js.map

package/dist/events/log-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-core.js","sourceRoot":"","sources":["../../src/events/log-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB,IAAI,CAAC,GAAG,EAAE,QAAiB;IAC7E,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,GAAG,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGhC;IACA;IACA;IAJO,IAAI,GAAG,oBAAoB,CAAC;IAC9C,YACW,KAAa,EACb,GAAW,EACX,IAAY;QAErB,KAAK,CACH,kBAAkB,IAAI,OAAO,KAAK,uBAAuB,GAAG,IAAI;YAC9D,sFAAsF;YACtF,iGAAiG;YACjG,2EAA2E,CAC9E,CAAC;QATO,UAAK,GAAL,KAAK,CAAQ;QACb,QAAG,GAAH,GAAG,CAAQ;QACX,SAAI,GAAJ,IAAI,CAAQ;IAQvB,CAAC;CACF;AA8BD,MAAM,UAAU,kBAAkB,CAAC,IAOlC;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACnC,KAAK,KAAK,CAAC;IACX,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;QACxB,KAAK,EAAE,UAAkC;QACzC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;QAC5B,UAAU,EAAE,KAAK;QACjB,kBAAkB,EAAE,8BAA8B;QAClD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,QAAQ,EAAE;YACR,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;SAClC;KACF,CAAC;AACJ,CAAC"}

package/dist/events/log.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Project event log — NDJSON append-only writer. Node-only.
+ *
+ * Pure helpers (`generateEventId`, `buildRollbackEvent`, `HOST_AGENT_ID`,
+ * `EventTooLargeError`, `DEFAULT_MAX_EVENT_BYTES`) and the `EventLog`
+ * + `AppendDraft` types live in `./log-core.ts` — that file is
+ * browser-safe and is what `wrap.ts` / `replay.ts` import.
+ *
+ * Each Firebase project gets one log at
+ * `~/.pyric/projects/<projectId>/events.ndjson`. Every mutating tool
+ * call emits at least two lines (plan + commit); failures get a
+ * rollback line. `agent events` reads + filters; `agent undo` consults
+ * the log to find the matching commit event and invoke its reverseOp.
+ *
+ * Design notes:
+ *   - **Append-only.** Never rewrite. `agent undo` doesn't delete the
+ *     committed event; it appends a new `rollback`-phase event that
+ *     references the original id. This keeps the file replayable.
+ *   - **Atomic per-event writes.** Each `append()` is one
+ *     `appendFileSync` call so multi-process writers can't interleave
+ *     within an event. Events have a hard byte cap (default 64KB) to
+ *     stay inside the kernel's atomic-append window on Linux + macOS.
+ *   - **Synchronous IO.** The log is small. A streaming reader would
+ *     be over-engineering today.
+ *   - **Injectable fs.** Tests pass a fake `io` object so they don't
+ *     hit the real disk.
+ *   - **Codec hook.** `args`, `before`, `after` are run through an
+ *     `EventValueCodec` on append + decoded on read.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { type EventValueCodec } from './codec.js';
+import { type EventLog } from './log-core.js';
+export { HOST_AGENT_ID, DEFAULT_MAX_EVENT_BYTES, generateEventId, EventTooLargeError, buildRollbackEvent, } from './log-core.js';
+export type { EventLog, AppendDraft } from './log-core.js';
+export declare function defaultProjectLogDir(): string;
+export interface EventLogIO {
+    existsSync: typeof existsSync;
+    mkdirSync: typeof mkdirSync;
+    appendFileSync: typeof appendFileSync;
+    readFileSync: typeof readFileSync;
+}
+export interface OpenEventLogOptions {
+    projectId: string;
+    /** Absolute path to the directory containing per-project subdirs.
+     *  Defaults to `~/.pyric/projects`. */
+    logDir?: string;
+    /** Defaults to fs primitives; injectable for tests. */
+    io?: EventLogIO;
+    /** Injectable clock; defaults to `Date.now`. */
+    now?: () => number;
+    /** Codec for `args` / `before` / `after`. Default round-trips
+     *  Date / Uint8Array / bigint / undefined. Pass a composed codec
+     *  for Firestore types — see `codec.ts:composeCodecs`. */
+    codec?: EventValueCodec;
+    /** Per-event byte cap. Defaults to 64KB. Exceeding throws
+     *  `EventTooLargeError`. */
+    maxEventBytes?: number;
+}
+export declare function openEventLog(opts: OpenEventLogOptions): EventLog;
+//# sourceMappingURL=log.d.ts.map

package/dist/events/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/events/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG9E,OAAO,EAAE,KAAK,eAAe,EAA0B,MAAM,YAAY,CAAC;AAC1E,OAAO,EAGL,KAAK,QAAQ,EAGd,MAAM,eAAe,CAAC;AAMvB,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3D,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,YAAY,EAAE,OAAO,YAAY,CAAC;CACnC;AASD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB;2CACuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;8DAE0D;IAC1D,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;gCAC4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,QAAQ,CA+GhE"}

package/dist/events/log.js

@@ -0,0 +1,193 @@
+/**
+ * Project event log — NDJSON append-only writer. Node-only.
+ *
+ * Pure helpers (`generateEventId`, `buildRollbackEvent`, `HOST_AGENT_ID`,
+ * `EventTooLargeError`, `DEFAULT_MAX_EVENT_BYTES`) and the `EventLog`
+ * + `AppendDraft` types live in `./log-core.ts` — that file is
+ * browser-safe and is what `wrap.ts` / `replay.ts` import.
+ *
+ * Each Firebase project gets one log at
+ * `~/.pyric/projects/<projectId>/events.ndjson`. Every mutating tool
+ * call emits at least two lines (plan + commit); failures get a
+ * rollback line. `agent events` reads + filters; `agent undo` consults
+ * the log to find the matching commit event and invoke its reverseOp.
+ *
+ * Design notes:
+ *   - **Append-only.** Never rewrite. `agent undo` doesn't delete the
+ *     committed event; it appends a new `rollback`-phase event that
+ *     references the original id. This keeps the file replayable.
+ *   - **Atomic per-event writes.** Each `append()` is one
+ *     `appendFileSync` call so multi-process writers can't interleave
+ *     within an event. Events have a hard byte cap (default 64KB) to
+ *     stay inside the kernel's atomic-append window on Linux + macOS.
+ *   - **Synchronous IO.** The log is small. A streaming reader would
+ *     be over-engineering today.
+ *   - **Injectable fs.** Tests pass a fake `io` object so they don't
+ *     hit the real disk.
+ *   - **Codec hook.** `args`, `before`, `after` are run through an
+ *     `EventValueCodec` on append + decoded on read.
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { defaultEventValueCodec } from './codec.js';
+import { DEFAULT_MAX_EVENT_BYTES, EventTooLargeError, generateEventId, } from './log-core.js';
+// Convenience re-exports — Node-side callers can grab everything
+// log-related from one entry. Browser-safe callers (wrap.ts,
+// replay.ts) import from `./log-core.js` directly to avoid pulling
+// `node:fs` into the universal `@inbrowser/agent` entry.
+export { HOST_AGENT_ID, DEFAULT_MAX_EVENT_BYTES, generateEventId, EventTooLargeError, buildRollbackEvent, } from './log-core.js';
+export function defaultProjectLogDir() {
+    return `${homedir()}/.pyric/projects`;
+}
+const DEFAULT_IO = {
+    existsSync,
+    mkdirSync,
+    appendFileSync,
+    readFileSync,
+};
+export function openEventLog(opts) {
+    if (!/^[a-zA-Z0-9_.-]+$/.test(opts.projectId)) {
+        throw new Error(`openEventLog: projectId ${JSON.stringify(opts.projectId)} contains disallowed characters; use [a-zA-Z0-9_.-]+`);
+    }
+    const io = opts.io ?? DEFAULT_IO;
+    const now = opts.now ?? Date.now;
+    const baseDir = opts.logDir ?? defaultProjectLogDir();
+    const projectDir = `${baseDir.replace(/\/$/, '')}/${opts.projectId}`;
+    const path = `${projectDir}/events.ndjson`;
+    const codec = opts.codec ?? defaultEventValueCodec;
+    const maxBytes = opts.maxEventBytes ?? DEFAULT_MAX_EVENT_BYTES;
+    if (!io.existsSync(projectDir))
+        io.mkdirSync(projectDir, { recursive: true });
+    // Strictly-monotonic counter — combined with the millisecond
+    // timestamp, makes ids sortable in emission order even when many
+    // appends share a `Date.now()` value.
+    let sequence = 0;
+    let closed = false;
+    // Lazy-built cache of `migrate_applied` originalEventIds. Invalidated
+    // on every append so the next read rebuilds it.
+    let _appliedCache = null;
+    function ensureOpen() {
+        if (closed)
+            throw new Error(`event log ${path} is closed`);
+    }
+    function appendEvent(draft) {
+        ensureOpen();
+        const event = {
+            id: draft.id ?? generateEventId(now, sequence++),
+            ts: draft.ts ?? new Date(now()).toISOString(),
+            agent: draft.agent,
+            sessionId: draft.sessionId,
+            tool: draft.tool,
+            ...(draft.args !== undefined ? { args: codec.encode(draft.args) } : {}),
+            phase: draft.phase,
+            target: draft.target,
+            ...(draft.before !== undefined ? { before: codec.encode(draft.before) } : {}),
+            ...(draft.after !== undefined ? { after: codec.encode(draft.after) } : {}),
+            reversible: draft.reversible,
+            ...(draft.irreversibleReason ? { irreversibleReason: draft.irreversibleReason } : {}),
+            ...(draft.reverseOp ? { reverseOp: encodeReverseOp(draft.reverseOp, codec) } : {}),
+            ...(draft.metadata ? { metadata: draft.metadata } : {}),
+        };
+        const line = JSON.stringify(event) + '\n';
+        const bytes = Buffer.byteLength(line, 'utf8');
+        if (bytes > maxBytes) {
+            throw new EventTooLargeError(bytes, maxBytes, draft.tool);
+        }
+        io.appendFileSync(path, line);
+        _appliedCache = null;
+        return event;
+    }
+    function readAll(filter) {
+        ensureOpen();
+        if (!io.existsSync(path))
+            return [];
+        const raw = io.readFileSync(path, 'utf8');
+        if (!raw)
+            return [];
+        const out = [];
+        for (const line of raw.split('\n')) {
+            if (!line)
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                // Skip malformed lines — append-only files can become corrupt
+                // if a writer crashes mid-write. Surfacing as a hard error
+                // would prevent `agent events` from ever working again.
+                continue;
+            }
+            const decoded = {
+                ...parsed,
+                ...(parsed.args !== undefined ? { args: codec.decode(parsed.args) } : {}),
+                ...(parsed.before !== undefined ? { before: codec.decode(parsed.before) } : {}),
+                ...(parsed.after !== undefined ? { after: codec.decode(parsed.after) } : {}),
+                ...(parsed.reverseOp ? { reverseOp: decodeReverseOp(parsed.reverseOp, codec) } : {}),
+            };
+            if (filter && !matches(decoded, filter))
+                continue;
+            out.push(decoded);
+        }
+        return out;
+    }
+    function appliedEventIds() {
+        if (_appliedCache !== null)
+            return _appliedCache;
+        const set = new Set();
+        for (const ev of readAll()) {
+            const md = ev.metadata;
+            if (md?.type === 'migrate_applied' && typeof md.appliedEventId === 'string') {
+                set.add(md.appliedEventId);
+            }
+        }
+        _appliedCache = set;
+        return set;
+    }
+    return {
+        path,
+        projectId: opts.projectId,
+        append: appendEvent,
+        read: readAll,
+        appliedEventIds,
+        close() {
+            if (closed)
+                return;
+            closed = true;
+        },
+    };
+}
+function encodeReverseOp(op, codec) {
+    return {
+        tool: op.tool,
+        args: codec.encode(op.args),
+        ...(op.description ? { description: op.description } : {}),
+    };
+}
+function decodeReverseOp(op, codec) {
+    return {
+        tool: op.tool,
+        args: codec.decode(op.args),
+        ...(op.description ? { description: op.description } : {}),
+    };
+}
+function matches(event, filter) {
+    if (filter.id && event.id !== filter.id)
+        return false;
+    if (filter.sessionId && event.sessionId !== filter.sessionId)
+        return false;
+    if (filter.tool && event.tool !== filter.tool)
+        return false;
+    if (filter.agent && event.agent !== filter.agent)
+        return false;
+    if (filter.phase && event.phase !== filter.phase)
+        return false;
+    if (filter.targetKind && event.target.kind !== filter.targetKind)
+        return false;
+    if (filter.since && event.ts < filter.since)
+        return false;
+    if (filter.until && event.ts >= filter.until)
+        return false;
+    return true;
+}
+//# sourceMappingURL=log.js.map

package/dist/events/log.js.map

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