mongo.do 0.1.0 → 0.1.1

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

@@ -1,255 +0,0 @@
-/**
- * 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

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