@upbeat-works/fisgon 0.1.0

package/LICENSE.md

@@ -0,0 +1,10 @@
+# O'Saasy License Agreement
+
+Copyright © 2026, Upbeat SL.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+1. The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+2. No licensee or downstream recipient may use the Software (including any modified or derivative versions) to directly compete with the original Licensor by offering it to third parties as a hosted, managed, or Software-as-a-Service (SaaS) product or cloud service where the primary value of the service is the functionality of the Software itself.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# fisgon
+
+*__Fisgón__ (fee-SGOHN) is Spanish for "nosy person" — the kind who can't help but peek through the window to see what's going on.*
+
+<p align="center">
+  <img src=".github/sickos.png" width="100" alt="Yes... ha ha ha... YES!" />
+</p>
+
+*That's exactly what this tool does. It watches every fetch request, every SQL query, every navigation event, every email your app sends — and it loves every second of it. Your app has no secrets from el fisgón.*
+
+*100% of the code was written by Claude Opus. A human just pointed and said "make it snoop on everything." The fisgón obliged.*
+
+---
+
+Low-level primitives for LLM-driven application testing.
+
+Fisgon lets an LLM agent control a real browser while observing both client-side **and** server-side events. It captures every fetch request, navigation, SQL query, and custom event into **ticks** — groups of events collected during silence — giving the agent a complete picture of what happened after each action.
+
+## How it works
+
+<p align="center">
+  <a href="https://x.com/i/status/2020660017272365349">
+    <img src=".github/demo.png" height="250" alt="Watch demo" />
+  </a>
+  <br />
+  <a href="https://x.com/i/status/2020660017272365349">Watch demo</a>
+</p>
+
+1. **Start a session** — Fisgon launches a browser and connects probes
+2. **Give an instruction** — An LLM agent navigates the app like a real user, discovering links, filling forms, and clicking buttons
+3. **Observe everything** — Browser probes capture fetch traffic and navigation; server probes capture SQL queries and custom events (e.g. email content, background jobs)
+4. **Save and replay** — The agent's trace is distilled into a deterministic YAML task file that can be replayed without an LLM
+
+```
+fisgon start                                   # launch browser + session
+fisgon do "Sign up and verify email" --save-task signup  # LLM does it, saves task
+fisgon run signup                              # replay without LLM
+```
+
+## Install
+
+```bash
+npm install fisgon
+```
+
+## CLI
+
+```bash
+fisgon start [options]              # Start a session with browser
+fisgon do <instruction> [options]   # LLM agent performs a task
+fisgon run <task-name> [options]    # Replay a saved task
+fisgon navigate <url> [options]     # Navigate to a URL
+fisgon actions                      # List interactive elements on page
+fisgon interact <selector> [options] # Interact with an element
+fisgon tick [options]               # Wait for next tick
+fisgon events                       # View all session events
+fisgon open <actionId>              # Inspect an action's HTML
+fisgon stop                         # Stop the session
+```
+
+## Configuration
+
+Create a `fisgon.config.ts` (or `.js` / `.mjs`) in your project root:
+
+```typescript
+import { defineConfig } from 'fisgon'
+
+export default defineConfig({
+  url: 'http://localhost:3000',
+  loginUrl: '/login',
+  identity: {
+    admin: { email: 'admin@example.com', password: 'secret' },
+  },
+  probes: {
+    fetch: { match: ['/api/**'] },
+    navigation: true,
+  },
+  tick: {
+    silenceMs: 500,  // wait 500ms of silence to close a tick
+    maxMs: 30000,    // max tick duration
+  },
+})
+```
+
+## Server-side probes
+
+Fisgon can observe your server too. Add a probe to capture SQL queries and custom events:
+
+```typescript
+import { createProbe } from 'fisgon/server'
+
+const probe = createProbe({ url: 'http://localhost:9876' })
+
+// In your request handler:
+const scoped = probe.fromRequest(request)
+scoped.fromSQL('INSERT INTO users ...')
+scoped.emit({ source: 'email', type: 'sent', timestamp: Date.now(), data: { to, subject, text } })
+```
+
+## Task files
+
+Tasks live in `.fisgon/tasks/` as YAML:
+
+```yaml
+name: login
+description: Log in with email and password
+params:
+  email: admin@example.com
+  password: secret
+steps:
+  - tool: navigate
+    args:
+      url: "{{loginUrl}}"
+  - tool: interact
+    args:
+      action: type
+      selector: input[name="email"]
+      value: "{{email}}"
+  - tool: interact
+    args:
+      action: type
+      selector: input[name="password"]
+      value: "{{password}}"
+  - tool: interact
+    args:
+      action: click
+      selector: button[type="submit"]
+validate:
+  url_contains: /dashboard
+```
+
+Tasks support `{{param}}` placeholders and `extract` to capture dynamic values (like magic link URLs from email events) for use in later steps.
+
+## Architecture
+
+```
+CLI ──────────────┐
+                  │  WebSocket
+Browser probes ───┤──────────── Agent (Cloudflare Durable Object)
+                  │                 ├── Event ingestion
+                  │                 ├── Tick detection
+Server probes ────┘  HTTP POST      ├── SQLite session store
+                                    └── LLM task execution
+```
+
+The agent runs locally via `wrangler dev` or remotely on Cloudflare Workers. The CLI and browser probes connect over WebSocket; server probes send events via HTTP POST. The browser gets instrumented with injected scripts that track fetch requests, navigation, and interactive elements.
+
+## License
+
+[O'Saasy License](LICENSE.md) — free to use, modify, and distribute; cannot be offered as a competing SaaS product.

package/dist/adapters/drizzle.d.ts

@@ -0,0 +1,17 @@
+import { type ScopedProbe } from '../core/types.js';
+type DrizzleDb = {
+    insert(table: unknown): {
+        values(...args: unknown[]): unknown;
+    };
+    update(table: unknown): {
+        set(...args: unknown[]): unknown;
+    };
+    delete(table: unknown): {
+        where(...args: unknown[]): unknown;
+    };
+    select(...args: unknown[]): unknown;
+    [key: string]: unknown;
+};
+export declare function drizzleAdapter<T extends DrizzleDb>(db: T, scoped: ScopedProbe): T;
+export {};
+//# sourceMappingURL=drizzle.d.ts.map

package/dist/adapters/drizzle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.d.ts","sourceRoot":"","sources":["../../src/adapters/drizzle.ts"],"names":[],"mappings":"AAAA,OAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEpD,KAAK,SAAS,GAAG;IACf,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;KAAE,CAAA;IAC/D,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;KAAE,CAAA;IAC5D,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;KAAE,CAAA;IAC9D,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAkBD,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,CAyCjF"}

package/dist/adapters/drizzle.js

@@ -0,0 +1,83 @@
+// Extracts a table name from a Drizzle table object.
+// Drizzle tables have a Symbol-keyed property or a `_.name` property.
+function getTableName(table) {
+    if (table && typeof table === 'object') {
+        const t = table;
+        // Drizzle v0.30+ uses _.name
+        if (t._ && typeof t._ === 'object' && 'name' in t._) {
+            return String(t._.name);
+        }
+        // Fallback: try Symbol.for('drizzle:Name')
+        const sym = Symbol.for('drizzle:Name');
+        if (sym in t)
+            return String(t[sym]);
+    }
+    return 'unknown';
+}
+export function drizzleAdapter(db, scoped) {
+    if (!scoped.active)
+        return db;
+    return new Proxy(db, {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            if (prop === 'insert' && typeof value === 'function') {
+                return (table) => {
+                    const tableName = getTableName(table);
+                    const result = value.call(target, table);
+                    return wrapChain(result, 'insert', tableName, scoped);
+                };
+            }
+            if (prop === 'update' && typeof value === 'function') {
+                return (table) => {
+                    const tableName = getTableName(table);
+                    const result = value.call(target, table);
+                    return wrapChain(result, 'update', tableName, scoped);
+                };
+            }
+            if (prop === 'delete' && typeof value === 'function') {
+                return (table) => {
+                    const tableName = getTableName(table);
+                    const result = value.call(target, table);
+                    return wrapChain(result, 'delete', tableName, scoped);
+                };
+            }
+            if (prop === 'select' && typeof value === 'function') {
+                return (...args) => {
+                    const result = value.apply(target, args);
+                    return wrapChain(result, 'select', 'query', scoped);
+                };
+            }
+            return value;
+        },
+    });
+}
+function wrapChain(obj, operation, tableName, scoped) {
+    if (!obj || typeof obj !== 'object')
+        return obj;
+    return new Proxy(obj, {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            if (typeof value === 'function') {
+                return (...args) => {
+                    const result = value.apply(target, args);
+                    // If the result is a thenable (query execution), emit the event
+                    if (result && typeof result === 'object' && 'then' in result) {
+                        scoped.emit({
+                            source: 'sql',
+                            type: operation,
+                            timestamp: Date.now(),
+                            data: { table: tableName },
+                        });
+                    }
+                    // Continue wrapping for chaining
+                    if (result && typeof result === 'object') {
+                        return wrapChain(result, operation, tableName, scoped);
+                    }
+                    return result;
+                };
+            }
+            return value;
+        },
+    });
+}
+//# sourceMappingURL=drizzle.js.map

package/dist/adapters/drizzle.js.map

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

package/dist/adapters/prisma.d.ts

@@ -0,0 +1,16 @@
+import { type ScopedProbe } from '../core/types.js';
+type PrismaClient = {
+    $use?(middleware: (params: PrismaMiddlewareParams, next: (params: PrismaMiddlewareParams) => Promise<unknown>) => Promise<unknown>): void;
+    $extends?(extension: unknown): unknown;
+    [key: string]: unknown;
+};
+type PrismaMiddlewareParams = {
+    model?: string;
+    action: string;
+    args: unknown;
+    dataPath: string[];
+    runInTransaction: boolean;
+};
+export declare function prismaAdapter<T extends PrismaClient>(client: T, scoped: ScopedProbe): T;
+export {};
+//# sourceMappingURL=prisma.d.ts.map

package/dist/adapters/prisma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/adapters/prisma.ts"],"names":[],"mappings":"AAAA,OAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEpD,KAAK,YAAY,GAAG;IAClB,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;IACzI,QAAQ,CAAC,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAA;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,gBAAgB,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,CAqDvF"}

package/dist/adapters/prisma.js

@@ -0,0 +1,69 @@
+export function prismaAdapter(client, scoped) {
+    if (!scoped.active)
+        return client;
+    // Use Prisma middleware ($use) if available
+    if (typeof client.$use === 'function') {
+        client.$use(async (params, next) => {
+            const timestamp = Date.now();
+            scoped.emit({
+                source: 'sql',
+                type: mapPrismaAction(params.action),
+                timestamp,
+                data: {
+                    table: params.model ?? 'unknown',
+                    action: params.action,
+                },
+            });
+            return next(params);
+        });
+        return client;
+    }
+    // Fallback: use $extends (Prisma 5+)
+    if (typeof client.$extends === 'function') {
+        return client.$extends({
+            query: {
+                $allModels: {
+                    async $allOperations({ model, operation, args, query }) {
+                        scoped.emit({
+                            source: 'sql',
+                            type: mapPrismaAction(operation),
+                            timestamp: Date.now(),
+                            data: {
+                                table: model,
+                                action: operation,
+                            },
+                        });
+                        return query(args);
+                    },
+                },
+            },
+        });
+    }
+    return client;
+}
+function mapPrismaAction(action) {
+    switch (action) {
+        case 'create':
+        case 'createMany':
+            return 'insert';
+        case 'update':
+        case 'updateMany':
+        case 'upsert':
+            return 'update';
+        case 'delete':
+        case 'deleteMany':
+            return 'delete';
+        case 'findFirst':
+        case 'findMany':
+        case 'findUnique':
+        case 'findFirstOrThrow':
+        case 'findUniqueOrThrow':
+        case 'count':
+        case 'aggregate':
+        case 'groupBy':
+            return 'select';
+        default:
+            return action;
+    }
+}
+//# sourceMappingURL=prisma.js.map

package/dist/adapters/prisma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.js","sourceRoot":"","sources":["../../src/adapters/prisma.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,aAAa,CAAyB,MAAS,EAAE,MAAmB;IAClF,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,MAAM,CAAA;IAEjC,4CAA4C;IAC5C,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAE5B,MAAM,CAAC,IAAI,CAAC;gBACV,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;gBACpC,SAAS;gBACT,IAAI,EAAE;oBACJ,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;oBAChC,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB;aACF,CAAC,CAAA;YAEF,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;QACrB,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAA;IACf,CAAC;IAED,qCAAqC;IACrC,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC;YACrB,KAAK,EAAE;gBACL,UAAU,EAAE;oBACV,KAAK,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAKnD;wBACC,MAAM,CAAC,IAAI,CAAC;4BACV,MAAM,EAAE,KAAK;4BACb,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC;4BAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;4BACrB,IAAI,EAAE;gCACJ,KAAK,EAAE,KAAK;gCACZ,MAAM,EAAE,SAAS;6BAClB;yBACF,CAAC,CAAA;wBAEF,OAAO,KAAK,CAAC,IAAI,CAAC,CAAA;oBACpB,CAAC;iBACF;aACF;SACF,CAAM,CAAA;IACT,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,YAAY;YACf,OAAO,QAAQ,CAAA;QACjB,KAAK,QAAQ,CAAC;QACd,KAAK,YAAY,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAA;QACjB,KAAK,QAAQ,CAAC;QACd,KAAK,YAAY;YACf,OAAO,QAAQ,CAAA;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU,CAAC;QAChB,KAAK,YAAY,CAAC;QAClB,KAAK,kBAAkB,CAAC;QACxB,KAAK,mBAAmB,CAAC;QACzB,KAAK,OAAO,CAAC;QACb,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAA;QACjB;YACE,OAAO,MAAM,CAAA;IACjB,CAAC;AACH,CAAC"}

package/dist/agent/ai.d.ts

@@ -0,0 +1,3 @@
+export declare const model: import("@ai-sdk/provider").LanguageModelV3;
+export declare const structuredModel: import("@ai-sdk/provider").LanguageModelV3;
+//# sourceMappingURL=ai.d.ts.map

package/dist/agent/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/agent/ai.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,KAAK,4CAA2D,CAAA;AAS7E,eAAO,MAAM,eAAe,4CAAkD,CAAA"}

package/dist/agent/ai.js

@@ -0,0 +1,19 @@
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import { createAiGateway } from 'ai-gateway-provider';
+import { createOpenAI } from 'ai-gateway-provider/providers/openai';
+import { env } from 'cloudflare:workers';
+const gateway = createOpenAICompatible({
+    name: 'cf-ai-gateway',
+    baseURL: `https://gateway.ai.cloudflare.com/v1/${env.ACCOUNT_ID}/${env.AI_GATEWAY}/compat`,
+    apiKey: env.AI_GATEWAY_TOKEN,
+});
+export const model = gateway.chatModel('anthropic/claude-haiku-4-5-20251001');
+// OpenAI model via AI Gateway for structured output (json_schema)
+const aiGateway = createAiGateway({
+    accountId: env.ACCOUNT_ID,
+    gateway: env.AI_GATEWAY,
+    apiKey: env.AI_GATEWAY_TOKEN,
+});
+const openai = createOpenAI();
+export const structuredModel = aiGateway(openai.chat('gpt-5-nano-2025-08-07'));
+//# sourceMappingURL=ai.js.map

package/dist/agent/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/agent/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AACnE,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAExC,MAAM,OAAO,GAAG,sBAAsB,CAAC;IACtC,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,wCAAwC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,SAAS;IAC1F,MAAM,EAAE,GAAG,CAAC,gBAAgB;CAC5B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAA;AAE7E,kEAAkE;AAClE,MAAM,SAAS,GAAG,eAAe,CAAC;IACjC,SAAS,EAAE,GAAG,CAAC,UAAU;IACzB,OAAO,EAAE,GAAG,CAAC,UAAU;IACvB,MAAM,EAAE,GAAG,CAAC,gBAAgB;CAC5B,CAAC,CAAA;AACF,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;AAC7B,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAA"}

package/dist/agent/browser-bridge.d.ts

@@ -0,0 +1,42 @@
+import { type Action, type InteractCommand } from '../core/types.js';
+export type BrowserBridge = {
+    navigate(url: string): Promise<void>;
+    evaluateScript(script: string): Promise<unknown>;
+    getActions(): Promise<Action[]>;
+    getInnerHTML(actionId: string): Promise<string>;
+    interact(command: InteractCommand): Promise<void>;
+    setCookie(name: string, value: string, domain: string): Promise<void>;
+    close(): Promise<void>;
+};
+export type BrowserCommand = {
+    type: 'browser-navigate';
+    url: string;
+} | {
+    type: 'browser-evaluate';
+    script: string;
+} | {
+    type: 'browser-actions';
+} | {
+    type: 'browser-open';
+    actionId: string;
+} | {
+    type: 'browser-interact';
+    command: InteractCommand;
+} | {
+    type: 'browser-set-cookie';
+    name: string;
+    value: string;
+    domain: string;
+} | {
+    type: 'browser-close';
+};
+export type BrowserResult = {
+    type: 'browser-result';
+    success: true;
+    data?: unknown;
+} | {
+    type: 'browser-result';
+    success: false;
+    error: string;
+};
+//# sourceMappingURL=browser-bridge.d.ts.map

package/dist/agent/browser-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-bridge.d.ts","sourceRoot":"","sources":["../../src/agent/browser-bridge.ts"],"names":[],"mappings":"AAAA,OAAQ,EAAE,KAAK,MAAM,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAMrE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/C,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB,CAAA;AAMD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAA;AAE7B,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/agent/browser-bridge.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-bridge.js.map

package/dist/agent/browser-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-bridge.js","sourceRoot":"","sources":["../../src/agent/browser-bridge.ts"],"names":[],"mappings":""}

package/dist/agent/index.d.ts

@@ -0,0 +1,66 @@
+import { Agent, type Connection, type WSMessage } from 'agents';
+import { type TaskFile } from '../core/task-file.js';
+import { type ProbeEvent, type Tick, type FisgonConfig, type IdentityConfig, type Action, type InteractCommand, type BrowserMode } from '../core/types.js';
+import { type StepLog } from './llm-driver.js';
+import { type AgentState } from './session-state.js';
+export declare class FisgonAgent extends Agent<Cloudflare.Env, AgentState> {
+    initialState: AgentState;
+    private sessions;
+    private dbInitialized;
+    private initDb;
+    onConnect(connection: Connection): Promise<void>;
+    onClose(connection: Connection): Promise<void>;
+    onRequest(request: Request): Promise<Response>;
+    onMessage(connection: Connection, message: WSMessage): Promise<void>;
+    startSession(config: FisgonConfig, browserMode: BrowserMode, identity?: IdentityConfig): {
+        sessionId: string;
+    };
+    stopSession(sessionId: string): Promise<void>;
+    navigate(sessionId: string, url: string, asIdentity?: string): Promise<{
+        tick: Tick;
+    }>;
+    performTask(sessionId: string, instruction: string): Promise<{
+        result: string;
+    }>;
+    distillTask(sessionId: string, stepLogs: StepLog[], instruction: string, finalUrl: string): Promise<{
+        task: TaskFile;
+    }>;
+    matchTasks(instruction: string, tasks: Array<{
+        name: string;
+        description: string;
+    }>): Promise<{
+        tasks: string[] | null;
+        remaining: string | null;
+    }>;
+    getActions(sessionId: string): Promise<{
+        actions: Action[];
+    }>;
+    openAction(sessionId: string, actionId: string): Promise<{
+        html: string;
+    }>;
+    interact(sessionId: string, command: InteractCommand): Promise<void>;
+    waitForNextTick(sessionId: string, timeout?: number): Promise<{
+        tick: Tick;
+    }>;
+    getEvents(sessionId: string): {
+        events: ProbeEvent[];
+    };
+    listSessions(): {
+        sessions: Array<{
+            id: string;
+            status: string;
+            browserMode: string;
+            createdAt: number;
+        }>;
+    };
+    emitEvent(event: ProbeEvent): void;
+    private ingestEvent;
+    private handleTickComplete;
+    private handleBrowserResult;
+    private sendBrowserCommand;
+    private waitForTick;
+    private createTaskContext;
+    private requireRuntime;
+    private broadcastState;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

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