browserclaw-agent 0.1.0

package/dist/agent-loop.d.ts

@@ -0,0 +1,49 @@
+import type { CrawlPage, BrowserClaw } from 'browserclaw';
+import type { UserMessage } from './types.js';
+import type { AgentAction, AgentLoopResult, CatalogSkill } from './types.js';
+/**
+ * Wrap drained user interjections in a nonce-tagged block so the LLM can
+ * distinguish user data from system instructions. Sanitizes the text to
+ * prevent tag-spoofing attacks — any sequence of `<<INTERJECTION_*>>` or
+ * `<<END_INTERJECTION_*>>` inside user content is neutralized regardless of
+ * nonce.
+ */
+export declare function buildInterjectionBlock(messages: UserMessage[], nonce: string): string | null;
+export declare function assertNavigateUrlAllowed(url: string): void;
+export declare function assertExtractExpressionAllowed(expression: string): void;
+export type TerminationJudgment = {
+    ready: true;
+    answer: string;
+} | {
+    ready: false;
+    missing: string;
+};
+/**
+ * Trigger a termination check periodically once the agent has been gathering
+ * for a while. Pure — safe to unit-test.
+ */
+export declare function shouldCheckTermination(step: number): boolean;
+export interface PageHolder {
+    page: CrawlPage;
+}
+export interface UserChatHooks {
+    /** Drain all pending user interjections. Called at the top of each step. */
+    drainMessages: () => UserMessage[];
+    /** Per-session random token used to wrap user-interjection content so the LLM can't confuse user data for system instructions. */
+    nonce: string;
+}
+export interface AgentLoopOptions {
+    waitForUser?: () => Promise<string>;
+    browser?: BrowserClaw;
+    domainSkill?: CatalogSkill | null;
+    maxSteps?: number;
+    userChat?: UserChatHooks;
+    /** Custom action handlers keyed by action name. Called before built-in actions. */
+    customActions?: Record<string, (action: AgentAction, page: CrawlPage) => Promise<void>>;
+    /** Override the default agent system prompt. */
+    systemPrompt?: string;
+    /** Transform the prompt before it reaches the planner and agent loop. */
+    buildTask?: (prompt: string) => string;
+}
+export declare function runAgentLoop(prompt: string, pageOrHolder: CrawlPage | PageHolder, emit: (event: string, data: unknown) => void, signal: AbortSignal, options?: AgentLoopOptions): Promise<AgentLoopResult>;
+//# sourceMappingURL=agent-loop.d.ts.map

package/dist/agent-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,OAAO,KAAK,EAAE,WAAW,EAAa,eAAe,EAAiB,YAAY,EAAc,MAAM,YAAY,CAAC;AAanH;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiC5F;AA8kBD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAsB1D;AAMD,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAIvE;AA0ND,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtG;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG5D;AA2CD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,aAAa,EAAE,MAAM,WAAW,EAAE,CAAC;IACnC,kIAAkI;IAClI,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACxF,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,SAAS,GAAG,UAAU,EACpC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,EAC5C,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CAm1B1B"}