@ap3x/browser-agent 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -104,6 +104,7 @@ export declare class Agent {
104
104
  private stepLoop?;
105
105
  private pendingPaused;
106
106
  private pendingStopped;
107
+ private readonly pendingSteers;
107
108
  /** Set once, after `run()` completes, when `output.generateGif` is on. */
108
109
  private lastGif?;
109
110
  /** Set once, after `run()` completes, when `output.recordHar` is on. */
@@ -143,6 +144,10 @@ export declare class Agent {
143
144
  pause(): void;
144
145
  resume(): void;
145
146
  stop(): void;
147
+ /** Course-correct a running (or not-yet-started) run: `text` is delivered to
148
+ * the agent as a nudge on its next step. Buffered until the step loop exists
149
+ * (mirroring `pause`), then flushed in order. */
150
+ steer(text: string): void;
146
151
  /** Clone the caller's (or default) registry and apply the vision filter (E7). */
147
152
  private buildRegistry;
148
153
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/agent/backend.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAO,KAAK,EAAwC,MAAM,UAAU,CAAC;AAEjF,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAwEvD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,GAAG,SAAS,CA8C3E;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0D;IACpF,OAAO,CAAC,MAAM,CAAC,CAAQ;gBAEX,MAAM,EAAE,KAAK,GAAG,YAAY;IAKxC,OAAO,CAAC,QAAQ;IAIV,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAezF,uFAAuF;YACzE,UAAU;IAQxB,OAAO,CAAC,WAAW;IAcnB,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI;IAO5E,KAAK,IAAI,IAAI;IAIb,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO;IAIhD,eAAe,IAAI,KAAK,CAAC,MAAM,CAAC;CAKjC"}
1
+ {"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/agent/backend.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAO,KAAK,EAAwC,MAAM,UAAU,CAAC;AAEjF,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAwEvD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,GAAG,SAAS,CA8C3E;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0D;IACpF,OAAO,CAAC,MAAM,CAAC,CAAQ;gBAEX,MAAM,EAAE,KAAK,GAAG,YAAY;IAKxC,OAAO,CAAC,QAAQ;IAIV,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAgCzF,uFAAuF;YACzE,UAAU;IAQxB,OAAO,CAAC,WAAW;IAcnB,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI;IAO5E,KAAK,IAAI,IAAI;IAIb,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO;IAIhD,eAAe,IAAI,KAAK,CAAC,MAAM,CAAC;CAKjC"}
@@ -1,3 +1,4 @@
1
+ import type { BrowserPostcondition } from "./postconditions";
1
2
  import type { DOMInteractedElement, TabInfo } from "@ap3x/browser";
2
3
  import { type ActionResult } from "../tools/types";
3
4
  import type { UsageSummary } from "../usage/ledger";
@@ -30,6 +31,8 @@ export interface StepMetadata {
30
31
  export declare function stepDurationSeconds(metadata: StepMetadata): number;
31
32
  /** One recorded step. */
32
33
  export interface AgentHistory {
34
+ /** Host-recorded expectations, independently checked on replay. */
35
+ postconditions?: BrowserPostcondition[];
33
36
  modelOutput?: AgentOutput;
34
37
  result: ActionResult[];
35
38
  state: BrowserStateHistory;
@@ -1 +1 @@
1
- {"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/agent/history.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;CAC9D;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,uCAAuC;AACvC,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,yBAAyB;AACzB,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAUD,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,WAAW,GACX,cAAc,GACd,aAAa,GACb,SAAS,GACT,SAAS,CAAC;AAEd,8EAA8E;AAC9E,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAM;IACtC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC,sEAAsE;IACtE,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI7B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,UAAU;IAMlB,kEAAkE;IAClE,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,4DAA4D;IAC5D,MAAM,IAAI,OAAO;IAKjB,qFAAqF;IACrF,YAAY,IAAI,OAAO,GAAG,SAAS;IAMnC,uEAAuE;IACvE,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IAInC,SAAS,IAAI,OAAO;IAIpB,0BAA0B;IAC1B,IAAI,IAAI,MAAM,EAAE;IAIhB,kFAAkF;IAClF,WAAW,IAAI,MAAM,EAAE;IAWvB,2CAA2C;IAC3C,oBAAoB,IAAI,MAAM;IAO9B,6FAA6F;IAC7F,MAAM,IAAI,gBAAgB;IAI1B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB;CAa1D;AAED,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}
1
+ {"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/agent/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAU7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;CAC9D;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,uCAAuC;AACvC,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,yBAAyB;AACzB,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAUD,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,WAAW,GACX,cAAc,GACd,aAAa,GACb,SAAS,GACT,SAAS,CAAC;AAEd,8EAA8E;AAC9E,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAM;IACtC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC,sEAAsE;IACtE,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI7B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,UAAU;IAMlB,kEAAkE;IAClE,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,4DAA4D;IAC5D,MAAM,IAAI,OAAO;IAKjB,qFAAqF;IACrF,YAAY,IAAI,OAAO,GAAG,SAAS;IAMnC,uEAAuE;IACvE,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IAInC,SAAS,IAAI,OAAO;IAIpB,0BAA0B;IAC1B,IAAI,IAAI,MAAM,EAAE;IAIhB,kFAAkF;IAClF,WAAW,IAAI,MAAM,EAAE;IAWvB,2CAA2C;IAC3C,oBAAoB,IAAI,MAAM;IAO9B,6FAA6F;IAC7F,MAAM,IAAI,gBAAgB;IAI1B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB;CAa1D;AAED,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}
@@ -1 +1 @@
1
- {"version":3,"file":"judge.d.ts","sourceRoot":"","sources":["../../src/agent/judge.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,GAAG,EAER,KAAK,KAAK,EACV,KAAK,qBAAqB,EAE1B,KAAK,KAAK,EAEX,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAC;AAEH,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;CACd;AAmED,8GAA8G;AAC9G,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA4BtB"}
1
+ {"version":3,"file":"judge.d.ts","sourceRoot":"","sources":["../../src/agent/judge.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,GAAG,EAER,KAAK,KAAK,EACV,KAAK,qBAAqB,EAE1B,KAAK,KAAK,EAEX,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAC;AAEH,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;CACd;AAmED,8GAA8G;AAC9G,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA4BtB"}
@@ -0,0 +1,39 @@
1
+ import type { BrowserDriver, BrowserSession } from "@ap3x/browser";
2
+ export type BrowserPostcondition = {
3
+ kind: "url";
4
+ equals: string;
5
+ } | {
6
+ kind: "page_identity";
7
+ title?: string;
8
+ textIncludes?: string;
9
+ } | {
10
+ kind: "visible";
11
+ selector: string;
12
+ } | {
13
+ kind: "selected_value";
14
+ selector: string;
15
+ value: string;
16
+ };
17
+ export declare const BrowserPostconditionSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
18
+ kind: import("@sinclair/typebox").TLiteral<"url">;
19
+ equals: import("@sinclair/typebox").TString;
20
+ }>, import("@sinclair/typebox").TObject<{
21
+ kind: import("@sinclair/typebox").TLiteral<"page_identity">;
22
+ title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
23
+ textIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
24
+ }>, import("@sinclair/typebox").TObject<{
25
+ kind: import("@sinclair/typebox").TLiteral<"visible">;
26
+ selector: import("@sinclair/typebox").TString;
27
+ }>, import("@sinclair/typebox").TObject<{
28
+ kind: import("@sinclair/typebox").TLiteral<"selected_value">;
29
+ selector: import("@sinclair/typebox").TString;
30
+ value: import("@sinclair/typebox").TString;
31
+ }>]>;
32
+ export declare class PostconditionError extends Error {
33
+ readonly condition: BrowserPostcondition;
34
+ readonly reasonCode = "postcondition_failed";
35
+ constructor(condition: BrowserPostcondition);
36
+ }
37
+ /** Read-only observations verify the live page rather than a tool's success message. */
38
+ export declare function verifyPostconditions(conditions: readonly BrowserPostcondition[], driver: BrowserDriver, session: BrowserSession, signal?: AbortSignal): Promise<void>;
39
+ //# sourceMappingURL=postconditions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"postconditions.d.ts","sourceRoot":"","sources":["../../src/agent/postconditions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEnE,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAChE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;IAqBrC,CAAC;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAE/B,QAAQ,CAAC,SAAS,EAAE,oBAAoB;IADpD,QAAQ,CAAC,UAAU,0BAA0B;gBACxB,SAAS,EAAE,oBAAoB;CAIrD;AACD,wFAAwF;AACxF,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,SAAS,oBAAoB,EAAE,EAC3C,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAiCf"}
@@ -1,18 +1,16 @@
1
1
  import { type BackendNodeId, type DOMInteractedElement, type DomSelectorMap, type EnhancedDOMTreeNode, MatchLevel } from "@ap3x/browser";
2
2
  export interface RematchSuccess {
3
3
  level: MatchLevel;
4
+ confidence?: "exact" | "high" | "medium" | "low";
4
5
  backendNodeId: BackendNodeId;
5
6
  node: EnhancedDOMTreeNode;
6
7
  }
7
8
  export interface RematchFailure {
8
9
  level: undefined;
9
10
  diagnostic: string;
11
+ reasonCode?: "ambiguous_target" | "target_not_found";
10
12
  }
11
13
  export type RematchResult = RematchSuccess | RematchFailure;
12
- /**
13
- * Re-locate a recorded element in the current (live) selector map. Returns the
14
- * live backendNodeId + match level on success, or a diagnostic on total miss.
15
- */
16
14
  export declare function rematchElement(recorded: DOMInteractedElement, selectorMap: DomSelectorMap): RematchResult;
17
15
  /**
18
16
  * Heuristic: does this recorded element look like it OPENS a menu/dropdown
@@ -1 +1 @@
1
- {"version":3,"file":"rematch.d.ts","sourceRoot":"","sources":["../../src/agent/rematch.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,UAAU,EAKX,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;AA8C5D;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,EAAE,cAAc,GAC1B,aAAa,CA0Df;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAKrE;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAKnE"}
1
+ {"version":3,"file":"rematch.d.ts","sourceRoot":"","sources":["../../src/agent/rematch.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,UAAU,EAKX,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;CACtD;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;AAwD5D,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,EAAE,cAAc,GAC1B,aAAa,CAoBf;AAiED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAKrE;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAKnE"}
@@ -10,6 +10,21 @@ import { type DetectedVariable } from "./variable-detector";
10
10
  export declare const HistoryFileSchema: import("@sinclair/typebox").TObject<{
11
11
  version: import("@sinclair/typebox").TLiteral<1>;
12
12
  history: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
13
+ postconditions: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
14
+ kind: import("@sinclair/typebox").TLiteral<"url">;
15
+ equals: import("@sinclair/typebox").TString;
16
+ }>, import("@sinclair/typebox").TObject<{
17
+ kind: import("@sinclair/typebox").TLiteral<"page_identity">;
18
+ title: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
19
+ textIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
20
+ }>, import("@sinclair/typebox").TObject<{
21
+ kind: import("@sinclair/typebox").TLiteral<"visible">;
22
+ selector: import("@sinclair/typebox").TString;
23
+ }>, import("@sinclair/typebox").TObject<{
24
+ kind: import("@sinclair/typebox").TLiteral<"selected_value">;
25
+ selector: import("@sinclair/typebox").TString;
26
+ value: import("@sinclair/typebox").TString;
27
+ }>]>>>;
13
28
  modelOutput: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
14
29
  thinking: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
15
30
  evaluation_previous_goal: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -1 +1 @@
1
- {"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/agent/replay.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/agent/replay.ts"],"names":[],"mappings":"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"}
@@ -95,6 +95,10 @@ export declare class StepLoop {
95
95
  pause(): void;
96
96
  resume(): void;
97
97
  stop(): void;
98
+ /** Inject a mid-run course-correction: `text` rides into the NEXT step's
99
+ * messages as a transient nudge (drained per step, like the loop-detector's).
100
+ * Lets a caller steer a running agent without pausing or restarting it. */
101
+ steer(text: string): void;
98
102
  get isDone(): boolean;
99
103
  /** Current consecutive-failure count (observability / tests). */
100
104
  get failures(): number;
@@ -1 +1 @@
1
- {"version":3,"file":"step-loop.d.ts","sourceRoot":"","sources":["../../src/agent/step-loop.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"step-loop.d.ts","sourceRoot":"","sources":["../../src/agent/step-loop.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ import { type AgentRunOptions } from "@ap3x/agent-core";
2
+ import type { Static, TSchema } from "@sinclair/typebox";
3
+ import { type SensitiveData } from "../tools/sensitive";
4
+ import type { ActionResult } from "../tools/types";
5
+ import { type BrowserPostcondition } from "./postconditions";
6
+ import type { RerunDeps } from "./replay";
7
+ export interface BrowserWorkflowStep {
8
+ action: string;
9
+ params: Record<string, unknown>;
10
+ postconditions: BrowserPostcondition[];
11
+ replaySafe?: boolean;
12
+ }
13
+ export interface BrowserWorkflow<S extends TSchema> {
14
+ id: string;
15
+ version: string;
16
+ parameters: S;
17
+ steps: (params: Static<S>) => BrowserWorkflowStep[];
18
+ }
19
+ export interface BrowserWorkflowStepResult {
20
+ index: number;
21
+ action: string;
22
+ attempts: number;
23
+ outcome: "succeeded" | "failed";
24
+ reasonCode?: "action_failed" | "postcondition_failed";
25
+ result: ActionResult;
26
+ snapshot: {
27
+ url: string;
28
+ title: string;
29
+ text: string;
30
+ };
31
+ }
32
+ export interface BrowserWorkflowResult {
33
+ id: string;
34
+ version: string;
35
+ outcome: "succeeded" | "failed" | "cancelled";
36
+ steps: BrowserWorkflowStepResult[];
37
+ }
38
+ /** Typed reusable recipes with independent postconditions and explicit retry declarations. */
39
+ export declare class BrowserWorkflowCatalog {
40
+ private readonly entries;
41
+ register<S extends TSchema>(workflow: BrowserWorkflow<S>): void;
42
+ list(): Array<{
43
+ id: string;
44
+ version: string;
45
+ }>;
46
+ run(id: string, params: unknown, deps: RerunDeps, options?: AgentRunOptions & {
47
+ maxAttempts?: number;
48
+ sensitiveData?: SensitiveData;
49
+ onStep?: (step: BrowserWorkflowStepResult) => void | Promise<void>;
50
+ }): Promise<BrowserWorkflowResult>;
51
+ }
52
+ //# sourceMappingURL=workflow-catalog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow-catalog.d.ts","sourceRoot":"","sources":["../../src/agent/workflow-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAqC,MAAM,kBAAkB,CAAC;AAC3F,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,cAAc,EAAE,oBAAoB,EAAE,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AACD,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,OAAO;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,CAAC;IACd,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,mBAAmB,EAAE,CAAC;CACrD;AACD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC;IAChC,UAAU,CAAC,EAAE,eAAe,GAAG,sBAAsB,CAAC;IACtD,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AACD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC9C,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC;AACD,8FAA8F;AAC9F,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+C;IACvE,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAK/D,IAAI,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAGxC,GAAG,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,eAAe,GAAG;QACzB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/D,GACL,OAAO,CAAC,qBAAqB,CAAC;CA4GlC"}