modjules 0.1.1

package/dist/storage/memory.d.ts

@@ -0,0 +1,40 @@
+import { Activity } from '../types.js';
+import { ActivityStorage } from './types.js';
+/**
+ * In-memory implementation of ActivityStorage.
+ * Useful for testing or environments where persistence is not required.
+ */
+export declare class MemoryStorage implements ActivityStorage {
+    private activities;
+    /**
+     * Initializes the storage. No-op for memory storage.
+     */
+    init(): Promise<void>;
+    /**
+     * Closes the storage and clears memory.
+     */
+    close(): Promise<void>;
+    /**
+     * Appends an activity to the in-memory list.
+     *
+     * **Guarantee:**
+     * - Idempotent: If an activity with the same ID exists, it updates it in place.
+     * - Append-only: New activities are always added to the end.
+     *
+     * **Side Effects:**
+     * - Modifies the internal `activities` array.
+     */
+    append(activity: Activity): Promise<void>;
+    /**
+     * Retrieves an activity by ID.
+     */
+    get(activityId: string): Promise<Activity | undefined>;
+    /**
+     * Retrieves the latest activity.
+     */
+    latest(): Promise<Activity | undefined>;
+    /**
+     * Yields all activities in chronological order.
+     */
+    scan(): AsyncIterable<Activity>;
+}

package/dist/storage/node-fs.d.ts

@@ -0,0 +1,54 @@
+import { Activity } from '../types.js';
+import { ActivityStorage } from './types.js';
+/**
+ * Node.js filesystem implementation of ActivityStorage.
+ * Stores activities in a JSONL file located at `.jules/cache/<sessionId>/activities.jsonl`.
+ */
+export declare class NodeFileStorage implements ActivityStorage {
+    private filePath;
+    private initialized;
+    constructor(sessionId: string, rootDir?: string);
+    /**
+     * Initializes the storage by ensuring the cache directory exists.
+     *
+     * **Side Effects:**
+     * - Creates the `.jules/cache/<sessionId>` directory if it does not exist.
+     * - Sets the internal `initialized` flag.
+     */
+    init(): Promise<void>;
+    /**
+     * Closes the storage.
+     */
+    close(): Promise<void>;
+    /**
+     * Appends an activity to the file.
+     *
+     * **Side Effects:**
+     * - Appends a new line containing the JSON representation of the activity to `activities.jsonl`.
+     * - Implicitly calls `init()` if not already initialized.
+     */
+    append(activity: Activity): Promise<void>;
+    /**
+     * Retrieves an activity by ID.
+     * Uses a linear scan of the file.
+     */
+    get(activityId: string): Promise<Activity | undefined>;
+    /**
+     * Retrieves the latest activity.
+     * Scans the entire file to find the last entry.
+     */
+    latest(): Promise<Activity | undefined>;
+    /**
+     * Yields all activities in the file.
+     *
+     * **Behavior:**
+     * - Opens a read stream to `activities.jsonl`.
+     * - Reads line-by-line using `readline`.
+     * - Parses each line as JSON.
+     *
+     * **Edge Cases:**
+     * - Logs a warning and skips lines if JSON parsing fails (corrupt data).
+     * - Returns immediately (yields nothing) if the file does not exist.
+     */
+    scan(): AsyncIterable<Activity>;
+}

package/dist/storage/types.d.ts

@@ -0,0 +1,38 @@
+import { Activity } from '../types.js';
+/**
+ * Abstract interface for the isomorphic storage layer.
+ * Implementations handle the specifics of persisting immutable activities
+ * to the available medium (Filesystem, IndexedDB, Memory, etc.).
+ */
+export interface ActivityStorage {
+    /**
+     * Lifecycle method to initialize the storage (e.g., open DB connection, ensure storage directory exists).
+     * Must be called before any other method.
+     */
+    init(): Promise<void>;
+    /**
+     * Lifecycle method to close connections or flush buffers.
+     */
+    close(): Promise<void>;
+    /**
+     * Persists a single activity.
+     * Implementations MUST guarantee this is an append-only operation (or upsert if ID matches).
+     * It should NEVER delete or modify a different activity.
+     */
+    append(activity: Activity): Promise<void>;
+    /**
+     * Retrieves a specific activity by its ID.
+     * @returns The activity if found, or undefined.
+     */
+    get(activityId: string): Promise<Activity | undefined>;
+    /**
+     * Retrieves the most recently appended activity.
+     * Crucial for determining the high-water mark for network synchronization.
+     */
+    latest(): Promise<Activity | undefined>;
+    /**
+     * Yields all stored activities in chronological order (insertion order).
+     * Must support standard 'for await...of' loops.
+     */
+    scan(): AsyncIterable<Activity>;
+}

package/dist/streaming.d.ts

@@ -0,0 +1,16 @@
+import { ApiClient } from './api.js';
+import { Activity, Origin } from './types.js';
+import { Platform } from './platform/types.js';
+/**
+ * Options for controlling the activity stream.
+ * @internal
+ */
+export type StreamActivitiesOptions = {
+    /**
+     * Filters to exclude certain activities.
+     */
+    exclude?: {
+        originator: Origin;
+    };
+};
+export declare function streamActivities(sessionId: string, apiClient: ApiClient, pollingInterval: number, platform: Platform, options?: StreamActivitiesOptions): AsyncGenerator<Activity>;