agent-browser-loop 0.1.0

package/src/id.ts

@@ -0,0 +1,109 @@
+/**
+ * Friendly ID generator using common words (similar to GitHub's style)
+ * Generates IDs like "swift-fox", "calm-river", "bold-star"
+ * When all combinations are used, appends numbers: "swift-fox-1", "swift-fox-2"
+ */
+
+const ADJECTIVES = [
+  "swift",
+  "calm",
+  "bold",
+  "warm",
+  "cool",
+  "dark",
+  "pale",
+  "keen",
+  "soft",
+  "wild",
+  "pure",
+  "deep",
+  "fair",
+  "glad",
+  "kind",
+  "safe",
+  "wise",
+  "fast",
+  "free",
+  "true",
+  "blue",
+  "gold",
+  "gray",
+  "pink",
+  "teal",
+];
+
+const NOUNS = [
+  "fox",
+  "owl",
+  "bee",
+  "elm",
+  "oak",
+  "sun",
+  "sky",
+  "bay",
+  "gem",
+  "arc",
+  "orb",
+  "fin",
+  "ray",
+  "dew",
+  "ash",
+  "ivy",
+  "jet",
+  "ink",
+  "fog",
+  "ice",
+  "fir",
+  "cod",
+  "eel",
+  "ant",
+  "bat",
+];
+
+export type IdGenerator = {
+  next: () => string;
+  release: (id: string) => void;
+};
+
+/**
+ * Creates a friendly ID generator that tracks used IDs
+ * and ensures uniqueness within the given set
+ */
+export function createIdGenerator(existingIds?: Set<string>): IdGenerator {
+  const used = new Set<string>(existingIds);
+
+  function next(): string {
+    // Try random combinations first (up to reasonable attempts)
+    const maxAttempts = ADJECTIVES.length * NOUNS.length * 2;
+    for (let i = 0; i < maxAttempts; i++) {
+      const adj = ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)];
+      const noun = NOUNS[Math.floor(Math.random() * NOUNS.length)];
+      const id = `${adj}-${noun}`;
+      if (!used.has(id)) {
+        used.add(id);
+        return id;
+      }
+    }
+
+    // Most combinations used, try systematically with numbers
+    let counter = 1;
+    while (true) {
+      for (let i = 0; i < maxAttempts; i++) {
+        const adj = ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)];
+        const noun = NOUNS[Math.floor(Math.random() * NOUNS.length)];
+        const id = `${adj}-${noun}-${counter}`;
+        if (!used.has(id)) {
+          used.add(id);
+          return id;
+        }
+      }
+      counter++;
+    }
+  }
+
+  function release(id: string): void {
+    used.delete(id);
+  }
+
+  return { next, release };
+}

package/src/index.ts

@@ -0,0 +1,58 @@
+export * as actions from "./actions";
+export type { AgentBrowserOptions } from "./browser";
+export { AgentBrowser, createBrowser } from "./browser";
+// Re-export utilities
+export { findChromeExecutable } from "./chrome";
+// Commands (shared execution logic)
+export {
+  type ActionResult,
+  type Command,
+  commandSchema,
+  executeActions,
+  executeCommand,
+  executeWait,
+  formatStepText,
+  formatWaitText,
+  getStateWithFormat,
+  type StepAction,
+  stepActionSchema,
+  type WaitCondition,
+  waitConditionSchema,
+} from "./commands";
+export {
+  browserCliConfigSchema,
+  defineBrowserConfig,
+  parseBrowserConfig,
+} from "./config";
+// Daemon
+export {
+  cleanupDaemonFiles,
+  DaemonClient,
+  type DaemonOptions,
+  ensureDaemon,
+  getPidPath,
+  getSocketPath,
+  isDaemonRunning,
+  startDaemon,
+} from "./daemon";
+// Server
+export type { BrowserServerConfig } from "./server";
+export { startBrowserServer } from "./server";
+export { formatStateText, getState } from "./state";
+export type {
+  BrowserCliConfig,
+  BrowserConfig,
+  BrowserState,
+  ClickOptions,
+  DumpNetworkOptions,
+  DumpStateOptions,
+  DumpStateTextOptions,
+  GetStateOptions,
+  InteractiveElement,
+  NavigateOptions,
+  NetworkEvent,
+  ScrollPosition,
+  StorageState,
+  TabInfo,
+  TypeOptions,
+} from "./types";

package/src/log.ts

@@ -0,0 +1,42 @@
+import {
+  neon,
+  SimplePrettyTerminalTransport,
+} from "@loglayer/transport-simple-pretty-terminal";
+import { ConsoleTransport, type ILogLayer, LogLayer } from "loglayer";
+import { serializeError } from "serialize-error";
+import { createContext } from "./context";
+
+const isDevelopment = process.env.NODE_ENV !== "production";
+
+const baseLoggerInstance = new LogLayer({
+  errorSerializer: serializeError,
+  transport: isDevelopment
+    ? [
+        new SimplePrettyTerminalTransport({
+          runtime: "node",
+          theme: neon,
+        }),
+      ]
+    : [
+        new ConsoleTransport({
+          logger: console,
+        }),
+      ],
+});
+
+const baseLogger = baseLoggerInstance;
+
+const LogContext = createContext<ILogLayer>("log");
+
+export function withLog<R>(metadata: Record<string, unknown>, fn: () => R) {
+  const currentLogger = LogContext.useSafe() ?? baseLogger;
+  const child = currentLogger.child().withContext(metadata);
+  return LogContext.with(child, fn);
+}
+
+export const log = new Proxy(baseLogger, {
+  get(target, prop) {
+    const loggerToUse = LogContext.useSafe() ?? target;
+    return loggerToUse[prop as keyof ILogLayer];
+  },
+});