agent-web-os 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,250 @@
+import * as just_bash from 'just-bash';
+import { InMemoryFs, FileContent, MkdirOptions, RmOptions, CpOptions } from 'just-bash';
+import { CommandContext, ExecResult, Bash } from 'just-bash/browser';
+export { Bash, CommandContext, ExecResult, defineCommand } from 'just-bash/browser';
+
+type ObservableInMemoryFsWriteFileSyncOptions = Parameters<InMemoryFs["writeFileSync"]>[2];
+type ObservableInMemoryFsWriteFileSyncMetadata = Parameters<InMemoryFs["writeFileSync"]>[3];
+type ObservableInMemoryFsWriteFileLazy = Parameters<InMemoryFs["writeFileLazy"]>[1];
+type ObservableInMemoryFsWriteFileLazyMetadata = Parameters<InMemoryFs["writeFileLazy"]>[2];
+type ObservableInMemoryFsWriteOptions = Parameters<InMemoryFs["writeFile"]>[2];
+type ObservableInMemoryFsEntryType = "file" | "directory" | "symlink";
+type ObservableInMemoryFsChangeEventName = "add" | "addDir" | "change" | "unlink" | "unlinkDir";
+type ObservableInMemoryFsChangeEvent = {
+    event: ObservableInMemoryFsChangeEventName;
+    path: string;
+    entryType: ObservableInMemoryFsEntryType;
+    previousPath?: string;
+};
+type ObservableInMemoryFsOptions = {
+    /** Whether to console.log change events (default: false) */
+    consoleLogChanges?: boolean;
+    /** Root path used to filter which changes are console-logged (default: "/") */
+    workspaceRoot?: string;
+};
+declare function assertObservableInMemoryFs(value: unknown): ObservableInMemoryFs;
+type ObservableInMemoryFsListener = (event: ObservableInMemoryFsChangeEvent) => void;
+declare class ObservableInMemoryFs extends InMemoryFs {
+    private listeners;
+    private lazyPaths;
+    private suppressSyncEventCount;
+    private suppressConsoleLogCount;
+    private suppressChangeEmissionCount;
+    private readonly consoleLogChanges;
+    private readonly isLoggableWorkspacePath;
+    constructor(options?: ObservableInMemoryFsOptions);
+    isPathLazy(filePath: string): boolean;
+    private clearLazyPath;
+    private clearLazyPathsUnder;
+    subscribe(listener: ObservableInMemoryFsListener): () => void;
+    private shouldEmitChanges;
+    suppressObservability<T>(operation: () => Promise<T>): Promise<T>;
+    private queueChangeEmission;
+    private areConsoleLogsSuppressed;
+    private runWithSuppressedConsoleLogs;
+    private shouldConsoleLogChangeEvent;
+    private emit;
+    private areSyncEventsSuppressed;
+    private runWithSuppressedSyncEvents;
+    writeFileSync(path: string, content: FileContent, options?: ObservableInMemoryFsWriteFileSyncOptions, metadata?: ObservableInMemoryFsWriteFileSyncMetadata): void;
+    writeFileLazy(path: string, lazy: ObservableInMemoryFsWriteFileLazy, metadata?: ObservableInMemoryFsWriteFileLazyMetadata): void;
+    private emitWriteEvent;
+    private emitMkdirEvent;
+    private emitRemovalEvent;
+    mkdirSync(path: string, options?: MkdirOptions): void;
+    readFileBuffer(path: string): Promise<Uint8Array>;
+    stat(path: string): Promise<just_bash.FsStat>;
+    lstat(path: string): Promise<just_bash.FsStat>;
+    writeFile(path: string, content: FileContent, options?: ObservableInMemoryFsWriteOptions): Promise<void>;
+    appendFile(path: string, content: FileContent, options?: ObservableInMemoryFsWriteOptions): Promise<void>;
+    mkdir(path: string, options?: MkdirOptions): Promise<void>;
+    rm(path: string, options?: RmOptions): Promise<void>;
+    cp(src: string, dest: string, options?: CpOptions): Promise<void>;
+    mv(src: string, dest: string): Promise<void>;
+    chmod(path: string, mode: number): Promise<void>;
+    symlink(target: string, linkPath: string): Promise<void>;
+    link(existingPath: string, newPath: string): Promise<void>;
+    utimes(path: string, atime: Date, mtime: Date): Promise<void>;
+}
+
+type BinCommandRegistrar = (name: string, handler: (args: string[], ctx: CommandContext) => Promise<ExecResult>) => void;
+type VitePreviewListener = (previewUrl: string | null) => void;
+type BatchFileLoader = (paths: string[]) => Promise<Map<string, Uint8Array>>;
+interface AlmostNodeSessionVfs {
+    existsSync(path: string): boolean;
+    statSync(path: string): {
+        isDirectory(): boolean;
+        isFile(): boolean;
+    };
+    readFileSync(path: string, encoding?: string): any;
+    writeFileSync(path: string, data: string | Uint8Array): void;
+    mkdirSync(path: string, options?: {
+        recursive?: boolean;
+    }): void;
+    readdirSync(path: string): string[];
+    unlinkSync(path: string): void;
+    rmdirSync(path: string): void;
+    renameSync(oldPath: string, newPath: string): void;
+}
+declare global {
+    interface Window {
+        __esbuild?: unknown;
+        __esbuildInitPromise?: Promise<void>;
+    }
+}
+declare class AlmostNodeSession {
+    private readonly fs;
+    private readonly _vfs;
+    get vfs(): AlmostNodeSessionVfs;
+    private readonly disposeObservableSubscription;
+    private initializePromise;
+    private initialized;
+    private pendingOperations;
+    private suppressObservableMirrorCount;
+    private registeredBinCommands;
+    private binCommandRegistrar?;
+    private batchFileLoader?;
+    private viteServer?;
+    private vitePort;
+    private vitePreviewUrl;
+    private vitePreviewListener?;
+    private parsedPackageJsonCache;
+    private transformedTextCache;
+    constructor(fs: ObservableInMemoryFs);
+    dispose(): void;
+    setBinCommandRegistrar(registrar: BinCommandRegistrar): void;
+    setBatchFileLoader(loader: BatchFileLoader): void;
+    setVitePreviewListener(listener: VitePreviewListener | undefined): void;
+    setViteHmrTarget(target: Window | null): void;
+    /**
+     * Resolve a bare module specifier (e.g. "@mui/material" or "react") to a
+     * `/node_modules/...` URL path that the ViteDevServer can serve.
+     *
+     * Resolution order mirrors Node/bundler conventions:
+     *   1. package.json "exports" (condition "import" → "default")
+     *   2. package.json "module"
+     *   3. package.json "main"
+     *   4. index.js / index.mjs fallback
+     *
+     * For deep imports like "@mui/material/Button", we resolve from the
+     * package directory directly.
+     */
+    private resolveBarePkgEntryCache;
+    /**
+     * Packages whose imports are handled by the browser import map.
+     * These are NOT rewritten to /node_modules/... paths.
+     * Now empty: react/react-dom are served from node_modules via our
+     * CJS→ESM shim, which supports the actual installed version rather
+     * than the outdated esm.sh CDN pinned in almostnode's import map.
+     */
+    private importMapPackages;
+    private parseCachedPackageJson;
+    private transformTextWithCache;
+    private resolveBarePkgEntry;
+    private _resolveBarePkgEntry;
+    private resolveExportsEntry;
+    /**
+     * Handle wildcard exports like "./*" → { "default": { "default": "./esm/* /index.js" } }
+     */
+    private resolveWildcardExports;
+    /**
+     * Recursively resolve a condition value from an exports entry.
+     * Handles: string, { import, module, default, require }, and nested conditions.
+     * Skips "types" conditions since we need JS, not .d.ts files.
+     *
+     * Priority: browser > module > import > default > require
+     * "browser" and "module" are preferred because they point to true ESM bundles.
+     * "import" is deprioritised because some packages (e.g. @emotion/*) map it to
+     * a CJS-to-ESM wrapper (.cjs.mjs) that uses require()/exports which fails
+     * in a browser context.
+     */
+    private resolveConditionValue;
+    /**
+     * Rewrite bare import specifiers in JavaScript source to /node_modules/... paths.
+     * When virtualPrefix is provided (e.g. "/__virtual__/5173"), prepends it to
+     * resolved paths so the browser stays within the service-worker-routed URL
+     * namespace and cascading relative imports keep going through the SW.
+     */
+    rewriteBareImports(code: string, root: string, virtualPrefix?: string): string;
+    private serveExistingVirtualStaticFile;
+    private stopViteServer;
+    private resolveNpmBinPath;
+    private resolveAndRegisterBinCommands;
+    private trackOperation;
+    private flushPendingOperations;
+    private withSuppressedObservableMirroring;
+    private copyObservablePathIntoVirtualFs;
+    private getNodeModulesPackageRoot;
+    private hydrateObservablePackageIntoVirtualFs;
+    private hydrateObservablePathsIntoVirtualFs;
+    private hydrateObservableDependencyPackagesIntoVirtualFs;
+    private hydrateObservableProjectIntoVirtualFs;
+    applyVirtualWrite(targetPath: string, data: string | Uint8Array): Promise<void>;
+    applyVirtualMkdir(targetPath: string): Promise<void>;
+    applyVirtualRemove(targetPath: string, recursive: boolean): Promise<void>;
+    applyVirtualRename(previousPath: string, nextPath: string): Promise<void>;
+    private ensureInitialized;
+    private readPackageJson;
+    private runNpmScript;
+    executeNpm(args: string[], ctx: CommandContext): Promise<ExecResult>;
+    executeNode(args: string[], ctx: CommandContext): Promise<ExecResult>;
+    executeVite(args: string[], ctx: CommandContext): Promise<ExecResult>;
+}
+declare function createAlmostNodeSession(fs: ObservableInMemoryFs): AlmostNodeSession;
+
+/**
+ * Shared types for agent-web-os.
+ */
+interface ToolResult {
+    success: boolean;
+    error?: string;
+    [key: string]: any;
+}
+
+declare const DEFAULT_BASH_SHELL_ENV: {
+    readonly LANG: "C.UTF-8";
+    readonly LC_ALL: "C.UTF-8";
+    readonly PYTHONIOENCODING: "utf-8";
+    readonly PYTHONUTF8: "1";
+};
+type BrowserBashSession = {
+    fs: ObservableInMemoryFs;
+    bash: Bash;
+    almostNodeSession: AlmostNodeSession;
+    rootPath: string;
+    cwd: string;
+    dispose: () => void;
+};
+type BrowserBashSessionOptions = {
+    /** Root path in the virtual filesystem (default: "/workspace") */
+    rootPath?: string;
+    /** Shell environment variables */
+    env?: Record<string, string>;
+    /** Options for the ObservableInMemoryFs */
+    fsOptions?: ObservableInMemoryFsOptions;
+};
+type ExecuteBrowserBashOptions = {
+    /** Whether to truncate command output (default: true) */
+    truncateOutput?: boolean;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+    /** Command timeout in ms (default: DEFAULT_BASH_COMMAND_TIMEOUT_MS) */
+    commandTimeoutMs?: number;
+    /** Output truncation limit (default: DEFAULT_BASH_OUTPUT_LIMIT) */
+    outputLimit?: number;
+};
+/** Create a browser-based bash session with in-memory filesystem and almostnode */
+declare function createBrowserBashSession(options?: BrowserBashSessionOptions): BrowserBashSession;
+/** Execute a bash command and return a ToolResult */
+declare function executeBrowserBash(session: BrowserBashSession, command: string, options?: ExecuteBrowserBashOptions): Promise<ToolResult>;
+
+type ServerBridge = {
+    initServiceWorker(): Promise<void>;
+    registerServer(server: unknown, port: number): void;
+    unregisterServer(port: number): void;
+    getServerUrl(port: number): string;
+};
+declare const getServerBridge: () => ServerBridge;
+declare const resetServerBridge: () => void;
+
+export { AlmostNodeSession, type AlmostNodeSessionVfs, type BrowserBashSession, DEFAULT_BASH_SHELL_ENV, ObservableInMemoryFs, type ObservableInMemoryFsChangeEvent, type ObservableInMemoryFsChangeEventName, type ObservableInMemoryFsOptions, type ServerBridge, type ToolResult, assertObservableInMemoryFs, createAlmostNodeSession, createBrowserBashSession, executeBrowserBash, getServerBridge, resetServerBridge };

package/dist/index.d.ts

@@ -0,0 +1,250 @@
+import * as just_bash from 'just-bash';
+import { InMemoryFs, FileContent, MkdirOptions, RmOptions, CpOptions } from 'just-bash';
+import { CommandContext, ExecResult, Bash } from 'just-bash/browser';
+export { Bash, CommandContext, ExecResult, defineCommand } from 'just-bash/browser';
+
+type ObservableInMemoryFsWriteFileSyncOptions = Parameters<InMemoryFs["writeFileSync"]>[2];
+type ObservableInMemoryFsWriteFileSyncMetadata = Parameters<InMemoryFs["writeFileSync"]>[3];
+type ObservableInMemoryFsWriteFileLazy = Parameters<InMemoryFs["writeFileLazy"]>[1];
+type ObservableInMemoryFsWriteFileLazyMetadata = Parameters<InMemoryFs["writeFileLazy"]>[2];
+type ObservableInMemoryFsWriteOptions = Parameters<InMemoryFs["writeFile"]>[2];
+type ObservableInMemoryFsEntryType = "file" | "directory" | "symlink";
+type ObservableInMemoryFsChangeEventName = "add" | "addDir" | "change" | "unlink" | "unlinkDir";
+type ObservableInMemoryFsChangeEvent = {
+    event: ObservableInMemoryFsChangeEventName;
+    path: string;
+    entryType: ObservableInMemoryFsEntryType;
+    previousPath?: string;
+};
+type ObservableInMemoryFsOptions = {
+    /** Whether to console.log change events (default: false) */
+    consoleLogChanges?: boolean;
+    /** Root path used to filter which changes are console-logged (default: "/") */
+    workspaceRoot?: string;
+};
+declare function assertObservableInMemoryFs(value: unknown): ObservableInMemoryFs;
+type ObservableInMemoryFsListener = (event: ObservableInMemoryFsChangeEvent) => void;
+declare class ObservableInMemoryFs extends InMemoryFs {
+    private listeners;
+    private lazyPaths;
+    private suppressSyncEventCount;
+    private suppressConsoleLogCount;
+    private suppressChangeEmissionCount;
+    private readonly consoleLogChanges;
+    private readonly isLoggableWorkspacePath;
+    constructor(options?: ObservableInMemoryFsOptions);
+    isPathLazy(filePath: string): boolean;
+    private clearLazyPath;
+    private clearLazyPathsUnder;
+    subscribe(listener: ObservableInMemoryFsListener): () => void;
+    private shouldEmitChanges;
+    suppressObservability<T>(operation: () => Promise<T>): Promise<T>;
+    private queueChangeEmission;
+    private areConsoleLogsSuppressed;
+    private runWithSuppressedConsoleLogs;
+    private shouldConsoleLogChangeEvent;
+    private emit;
+    private areSyncEventsSuppressed;
+    private runWithSuppressedSyncEvents;
+    writeFileSync(path: string, content: FileContent, options?: ObservableInMemoryFsWriteFileSyncOptions, metadata?: ObservableInMemoryFsWriteFileSyncMetadata): void;
+    writeFileLazy(path: string, lazy: ObservableInMemoryFsWriteFileLazy, metadata?: ObservableInMemoryFsWriteFileLazyMetadata): void;
+    private emitWriteEvent;
+    private emitMkdirEvent;
+    private emitRemovalEvent;
+    mkdirSync(path: string, options?: MkdirOptions): void;
+    readFileBuffer(path: string): Promise<Uint8Array>;
+    stat(path: string): Promise<just_bash.FsStat>;
+    lstat(path: string): Promise<just_bash.FsStat>;
+    writeFile(path: string, content: FileContent, options?: ObservableInMemoryFsWriteOptions): Promise<void>;
+    appendFile(path: string, content: FileContent, options?: ObservableInMemoryFsWriteOptions): Promise<void>;
+    mkdir(path: string, options?: MkdirOptions): Promise<void>;
+    rm(path: string, options?: RmOptions): Promise<void>;
+    cp(src: string, dest: string, options?: CpOptions): Promise<void>;
+    mv(src: string, dest: string): Promise<void>;
+    chmod(path: string, mode: number): Promise<void>;
+    symlink(target: string, linkPath: string): Promise<void>;
+    link(existingPath: string, newPath: string): Promise<void>;
+    utimes(path: string, atime: Date, mtime: Date): Promise<void>;
+}
+
+type BinCommandRegistrar = (name: string, handler: (args: string[], ctx: CommandContext) => Promise<ExecResult>) => void;
+type VitePreviewListener = (previewUrl: string | null) => void;
+type BatchFileLoader = (paths: string[]) => Promise<Map<string, Uint8Array>>;
+interface AlmostNodeSessionVfs {
+    existsSync(path: string): boolean;
+    statSync(path: string): {
+        isDirectory(): boolean;
+        isFile(): boolean;
+    };
+    readFileSync(path: string, encoding?: string): any;
+    writeFileSync(path: string, data: string | Uint8Array): void;
+    mkdirSync(path: string, options?: {
+        recursive?: boolean;
+    }): void;
+    readdirSync(path: string): string[];
+    unlinkSync(path: string): void;
+    rmdirSync(path: string): void;
+    renameSync(oldPath: string, newPath: string): void;
+}
+declare global {
+    interface Window {
+        __esbuild?: unknown;
+        __esbuildInitPromise?: Promise<void>;
+    }
+}
+declare class AlmostNodeSession {
+    private readonly fs;
+    private readonly _vfs;
+    get vfs(): AlmostNodeSessionVfs;
+    private readonly disposeObservableSubscription;
+    private initializePromise;
+    private initialized;
+    private pendingOperations;
+    private suppressObservableMirrorCount;
+    private registeredBinCommands;
+    private binCommandRegistrar?;
+    private batchFileLoader?;
+    private viteServer?;
+    private vitePort;
+    private vitePreviewUrl;
+    private vitePreviewListener?;
+    private parsedPackageJsonCache;
+    private transformedTextCache;
+    constructor(fs: ObservableInMemoryFs);
+    dispose(): void;
+    setBinCommandRegistrar(registrar: BinCommandRegistrar): void;
+    setBatchFileLoader(loader: BatchFileLoader): void;
+    setVitePreviewListener(listener: VitePreviewListener | undefined): void;
+    setViteHmrTarget(target: Window | null): void;
+    /**
+     * Resolve a bare module specifier (e.g. "@mui/material" or "react") to a
+     * `/node_modules/...` URL path that the ViteDevServer can serve.
+     *
+     * Resolution order mirrors Node/bundler conventions:
+     *   1. package.json "exports" (condition "import" → "default")
+     *   2. package.json "module"
+     *   3. package.json "main"
+     *   4. index.js / index.mjs fallback
+     *
+     * For deep imports like "@mui/material/Button", we resolve from the
+     * package directory directly.
+     */
+    private resolveBarePkgEntryCache;
+    /**
+     * Packages whose imports are handled by the browser import map.
+     * These are NOT rewritten to /node_modules/... paths.
+     * Now empty: react/react-dom are served from node_modules via our
+     * CJS→ESM shim, which supports the actual installed version rather
+     * than the outdated esm.sh CDN pinned in almostnode's import map.
+     */
+    private importMapPackages;
+    private parseCachedPackageJson;
+    private transformTextWithCache;
+    private resolveBarePkgEntry;
+    private _resolveBarePkgEntry;
+    private resolveExportsEntry;
+    /**
+     * Handle wildcard exports like "./*" → { "default": { "default": "./esm/* /index.js" } }
+     */
+    private resolveWildcardExports;
+    /**
+     * Recursively resolve a condition value from an exports entry.
+     * Handles: string, { import, module, default, require }, and nested conditions.
+     * Skips "types" conditions since we need JS, not .d.ts files.
+     *
+     * Priority: browser > module > import > default > require
+     * "browser" and "module" are preferred because they point to true ESM bundles.
+     * "import" is deprioritised because some packages (e.g. @emotion/*) map it to
+     * a CJS-to-ESM wrapper (.cjs.mjs) that uses require()/exports which fails
+     * in a browser context.
+     */
+    private resolveConditionValue;
+    /**
+     * Rewrite bare import specifiers in JavaScript source to /node_modules/... paths.
+     * When virtualPrefix is provided (e.g. "/__virtual__/5173"), prepends it to
+     * resolved paths so the browser stays within the service-worker-routed URL
+     * namespace and cascading relative imports keep going through the SW.
+     */
+    rewriteBareImports(code: string, root: string, virtualPrefix?: string): string;
+    private serveExistingVirtualStaticFile;
+    private stopViteServer;
+    private resolveNpmBinPath;
+    private resolveAndRegisterBinCommands;
+    private trackOperation;
+    private flushPendingOperations;
+    private withSuppressedObservableMirroring;
+    private copyObservablePathIntoVirtualFs;
+    private getNodeModulesPackageRoot;
+    private hydrateObservablePackageIntoVirtualFs;
+    private hydrateObservablePathsIntoVirtualFs;
+    private hydrateObservableDependencyPackagesIntoVirtualFs;
+    private hydrateObservableProjectIntoVirtualFs;
+    applyVirtualWrite(targetPath: string, data: string | Uint8Array): Promise<void>;
+    applyVirtualMkdir(targetPath: string): Promise<void>;
+    applyVirtualRemove(targetPath: string, recursive: boolean): Promise<void>;
+    applyVirtualRename(previousPath: string, nextPath: string): Promise<void>;
+    private ensureInitialized;
+    private readPackageJson;
+    private runNpmScript;
+    executeNpm(args: string[], ctx: CommandContext): Promise<ExecResult>;
+    executeNode(args: string[], ctx: CommandContext): Promise<ExecResult>;
+    executeVite(args: string[], ctx: CommandContext): Promise<ExecResult>;
+}
+declare function createAlmostNodeSession(fs: ObservableInMemoryFs): AlmostNodeSession;
+
+/**
+ * Shared types for agent-web-os.
+ */
+interface ToolResult {
+    success: boolean;
+    error?: string;
+    [key: string]: any;
+}
+
+declare const DEFAULT_BASH_SHELL_ENV: {
+    readonly LANG: "C.UTF-8";
+    readonly LC_ALL: "C.UTF-8";
+    readonly PYTHONIOENCODING: "utf-8";
+    readonly PYTHONUTF8: "1";
+};
+type BrowserBashSession = {
+    fs: ObservableInMemoryFs;
+    bash: Bash;
+    almostNodeSession: AlmostNodeSession;
+    rootPath: string;
+    cwd: string;
+    dispose: () => void;
+};
+type BrowserBashSessionOptions = {
+    /** Root path in the virtual filesystem (default: "/workspace") */
+    rootPath?: string;
+    /** Shell environment variables */
+    env?: Record<string, string>;
+    /** Options for the ObservableInMemoryFs */
+    fsOptions?: ObservableInMemoryFsOptions;
+};
+type ExecuteBrowserBashOptions = {
+    /** Whether to truncate command output (default: true) */
+    truncateOutput?: boolean;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+    /** Command timeout in ms (default: DEFAULT_BASH_COMMAND_TIMEOUT_MS) */
+    commandTimeoutMs?: number;
+    /** Output truncation limit (default: DEFAULT_BASH_OUTPUT_LIMIT) */
+    outputLimit?: number;
+};
+/** Create a browser-based bash session with in-memory filesystem and almostnode */
+declare function createBrowserBashSession(options?: BrowserBashSessionOptions): BrowserBashSession;
+/** Execute a bash command and return a ToolResult */
+declare function executeBrowserBash(session: BrowserBashSession, command: string, options?: ExecuteBrowserBashOptions): Promise<ToolResult>;
+
+type ServerBridge = {
+    initServiceWorker(): Promise<void>;
+    registerServer(server: unknown, port: number): void;
+    unregisterServer(port: number): void;
+    getServerUrl(port: number): string;
+};
+declare const getServerBridge: () => ServerBridge;
+declare const resetServerBridge: () => void;
+
+export { AlmostNodeSession, type AlmostNodeSessionVfs, type BrowserBashSession, DEFAULT_BASH_SHELL_ENV, ObservableInMemoryFs, type ObservableInMemoryFsChangeEvent, type ObservableInMemoryFsChangeEventName, type ObservableInMemoryFsOptions, type ServerBridge, type ToolResult, assertObservableInMemoryFs, createAlmostNodeSession, createBrowserBashSession, executeBrowserBash, getServerBridge, resetServerBridge };