mongo.do 0.1.0

package/dist/agentfs/mondo-agent.d.ts

@@ -0,0 +1,255 @@
+/**
+ * MonDoAgent - Cloudflare Agent with integrated AgentFS
+ *
+ * Provides a unified API for AI agents to interact with:
+ * - Virtual filesystem (files, directories)
+ * - Glob pattern matching
+ * - Grep content search
+ * - Key-value storage
+ * - Tool call audit logging
+ * - WebSocket integration for real-time tool execution
+ *
+ * Designed for use with Cloudflare's Agent infrastructure.
+ */
+import type { FileSystem, GrepMatch, KeyValueStore } from './types';
+/**
+ * Agent state interface - extends with custom fields
+ */
+export interface AgentState {
+    initialized: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Agent environment interface - Cloudflare bindings
+ */
+export interface AgentEnv {
+    AI?: {
+        run: (model: string, input: unknown) => Promise<unknown>;
+    };
+    VECTORIZE?: {
+        query: (query: unknown) => Promise<unknown>;
+        insert: (data: unknown) => Promise<unknown>;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Agent context interface - Durable Object context
+ */
+export interface AgentContext {
+    id: string;
+    storage: {
+        get: (key: string) => Promise<unknown>;
+        put: (key: string, value: unknown) => Promise<void>;
+        delete: (key: string) => Promise<boolean>;
+        list: () => Promise<Map<string, unknown>>;
+    };
+    blockConcurrencyWhile: <T>(fn: () => Promise<T>) => Promise<T>;
+}
+/**
+ * WebSocket connection interface
+ */
+export interface WebSocketConnection {
+    accept: () => void;
+    send: (data: string) => void;
+    close: (code?: number, reason?: string) => void;
+    addEventListener: (event: string, handler: (event: unknown) => void) => void;
+    removeEventListener: (event: string, handler: (event: unknown) => void) => void;
+    readyState: number;
+}
+/**
+ * WebSocket message interface for tool calls
+ */
+export interface WebSocketMessage {
+    type: string;
+    id?: string;
+    tool?: string;
+    inputs?: Record<string, unknown>;
+    stream?: boolean;
+}
+/**
+ * SQL database interface (from Cloudflare DO)
+ */
+export interface SqlDatabase {
+    exec: (sql: string) => Promise<{
+        results: unknown[];
+    }>;
+    prepare: (sql: string) => {
+        bind: (...params: unknown[]) => ReturnType<SqlDatabase['prepare']>;
+        run: () => Promise<{
+            results: unknown[];
+        }>;
+        first: () => Promise<unknown | null>;
+        all: () => Promise<{
+            results: unknown[];
+        }>;
+    };
+}
+import { type AgentFSDatabase } from './vfs';
+import { type KVStorageBackend } from './kv-store';
+import { ToolCallAuditLog, type AuditBackend } from './toolcalls';
+/**
+ * Options for creating a MonDoAgent instance (legacy)
+ */
+export interface MonDoAgentOptions {
+    /** Database backend for filesystem operations */
+    database: AgentFSDatabase;
+    /** Optional: Custom KV storage backend (defaults to database-backed) */
+    kvBackend?: KVStorageBackend;
+    /** Optional: Custom audit backend (defaults to database-backed) */
+    auditBackend?: AuditBackend;
+}
+/**
+ * Options for glob convenience method
+ */
+export interface AgentGlobOptions {
+    /** Case-insensitive matching */
+    nocase?: boolean;
+    /** Include dot files */
+    dot?: boolean;
+}
+/**
+ * Options for grep convenience method
+ */
+export interface AgentGrepOptions {
+    /** Glob pattern to filter files */
+    glob?: string;
+    /** Case-insensitive search */
+    caseInsensitive?: boolean;
+    /** Maximum number of results */
+    maxResults?: number;
+    /** Number of context lines before and after */
+    contextLines?: number;
+}
+/**
+ * MonDoAgent - Unified interface for AI agent operations
+ *
+ * Integrates the AgentFS virtual filesystem, glob, grep, KV store, and tool call
+ * auditing with Cloudflare Agent infrastructure.
+ *
+ * @example
+ * ```typescript
+ * const agent = new MonDoAgent(ctx, env)
+ * await agent.init()
+ *
+ * // Filesystem operations
+ * await agent.fs.writeFile('/config.json', '{}')
+ * const content = await agent.fs.readFile('/config.json')
+ *
+ * // Glob matching
+ * const tsFiles = await agent.glob('**\/*.ts')
+ *
+ * // Content search
+ * const matches = await agent.grep('TODO', { glob: '**\/*.ts' })
+ *
+ * // Key-value storage
+ * await agent.kv.set('session:123', { user: 'alice' })
+ * const session = await agent.kv.get('session:123')
+ *
+ * // Audit logging
+ * await agent.audit.record('read_file', { path: '/test.txt' }, { content: 'hello' })
+ * ```
+ */
+export declare class MonDoAgent {
+    /** Virtual filesystem for file and directory operations (with auto-auditing) */
+    readonly fs: FileSystem;
+    /** Key-value store for session data, caches, etc. (with auto-auditing) */
+    readonly kv: KeyValueStore;
+    /** Append-only audit log for tool call tracking */
+    readonly audit: ToolCallAuditLog;
+    /** Internal raw filesystem (without auditing wrapper) */
+    private readonly _rawFs;
+    /** Internal raw KV store (without auditing wrapper) */
+    private readonly _rawKv;
+    /** Agent state */
+    private _state;
+    /** SQL database from Cloudflare Agent */
+    readonly sql: SqlDatabase;
+    /** Agent context */
+    protected readonly ctx: AgentContext;
+    /** Agent environment */
+    protected readonly env: AgentEnv;
+    /** Active WebSocket connections */
+    private readonly _connections;
+    /**
+     * Create a new MonDoAgent instance
+     *
+     * @param ctx - Agent context (from Cloudflare Agent)
+     * @param env - Agent environment (Cloudflare bindings)
+     */
+    constructor(ctx: AgentContext, env: AgentEnv);
+    /**
+     * Create SQL interface (simulating Cloudflare Agent's this.sql)
+     */
+    private createSqlInterface;
+    /**
+     * Set agent state (Cloudflare Agent compatibility)
+     */
+    setState(newState: Partial<AgentState>): void;
+    /**
+     * Get agent state (Cloudflare Agent compatibility)
+     */
+    getState(): AgentState;
+    /**
+     * Initialize the agent
+     * Sets up all resources and marks state as initialized
+     */
+    init(): Promise<void>;
+    /**
+     * Handle WebSocket connection
+     * Accepts connection, sets up handlers, and sends welcome message
+     */
+    onConnect(ws: WebSocketConnection, _request: Request): Promise<void>;
+    /**
+     * Handle WebSocket message
+     * Parses tool call, executes it, and sends response
+     */
+    onMessage(ws: WebSocketConnection, message: WebSocketMessage): Promise<void>;
+    /**
+     * Execute a tool call and return the result
+     */
+    private executeToolCall;
+    /**
+     * Find files matching a glob pattern (with auto-auditing)
+     *
+     * @param pattern - Glob pattern (e.g., '**\/*.ts', 'src/*.js')
+     * @param options - Optional glob options
+     * @returns Array of matching file paths
+     */
+    glob(pattern: string, options?: AgentGlobOptions): Promise<string[]>;
+    /**
+     * Search file contents for a pattern (with auto-auditing)
+     *
+     * @param pattern - Regular expression pattern to search for
+     * @param options - Optional grep options
+     * @returns Array of grep matches
+     */
+    grep(pattern: string, options?: AgentGrepOptions): Promise<GrepMatch[]>;
+    /**
+     * Search and return only file paths containing matches
+     *
+     * @param pattern - Regular expression pattern to search for
+     * @param options - Optional grep options
+     * @returns Array of unique file paths
+     */
+    grepFiles(pattern: string, options?: AgentGrepOptions): Promise<string[]>;
+    /**
+     * Count matches per file
+     *
+     * @param pattern - Regular expression pattern to search for
+     * @param options - Optional grep options
+     * @returns Map of file path to match count
+     */
+    grepCount(pattern: string, options?: AgentGrepOptions): Promise<Map<string, number>>;
+}
+/**
+ * Create a new MonDoAgent instance (legacy factory function)
+ *
+ * @param options - Configuration options
+ * @returns Configured MonDoAgent instance
+ */
+export declare function createMonDoAgent(_options: MonDoAgentOptions): MonDoAgent;
+/**
+ * Type guard to check if an object is a MonDoAgent
+ */
+export declare function isMonDoAgent(obj: unknown): obj is MonDoAgent;
+//# sourceMappingURL=mondo-agent.d.ts.map

package/dist/agentfs/mondo-agent.d.ts.map

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