@opengeni/runtime 3.2.2 → 3.4.0

package/dist/browser-current-tab.d.ts

@@ -0,0 +1,46 @@
+export declare class BrowserTargetResolutionError extends Error {
+    readonly code: "browser_session_required" | "browser_target_required";
+    constructor(code: "browser_session_required" | "browser_target_required", message: string);
+}
+export type CurrentBrowserTabDeps = {
+    /** This agent session's live BrowserSessions. */
+    listLiveSessions: () => Promise<ReadonlyArray<{
+        id: string;
+        lastUsedAt: string;
+    }>>;
+    /** The tabs of one BrowserSession. */
+    listTargets: (browserSessionId: string) => Promise<ReadonlyArray<{
+        id: string;
+        kind: string;
+        selected: boolean;
+    }>>;
+};
+export type ResolvedBrowserSession = {
+    browserSessionId: string;
+    /** True when the identifier came from memory or lookup, not the caller. */
+    implicit: boolean;
+};
+export type ResolvedBrowserTarget = ResolvedBrowserSession & {
+    targetId: string;
+    implicitTarget: boolean;
+};
+export declare class CurrentBrowserTab {
+    private readonly deps;
+    private current;
+    constructor(deps: CurrentBrowserTabDeps);
+    /** Record the session and, when known, the tab a successful call used. */
+    use(browserSessionId: string, targetId?: string | null): void;
+    forgetTarget(browserSessionId: string, targetId: string): void;
+    forgetSession(browserSessionId: string): void;
+    /** A call that relied on remembered identifiers failed: resolve afresh next time. */
+    failed(resolved: ResolvedBrowserSession & {
+        implicitTarget?: boolean;
+    }): void;
+    session(browserSessionId: string | undefined): Promise<ResolvedBrowserSession>;
+    target(value: {
+        browserSessionId?: string | undefined;
+        targetId?: string | undefined;
+    }): Promise<ResolvedBrowserTarget>;
+}
+/** An element ref passed where a locator is expected, as a bare string. */
+export declare function expandRefShorthand(action: unknown): unknown;

package/dist/browser-model-text.d.ts

@@ -0,0 +1,126 @@
+/**
+ * The model's text view of browser tool results.
+ *
+ * A browser tool result keeps its complete typed value in `structuredContent`
+ * for Code Mode, the API and the UI. What the model reads is this text: an
+ * outline with one line per page element, in the role/name vocabulary that
+ * locators use. It repeats no envelope keys, quoting or bookkeeping ids the
+ * model never sends back, which makes a page view about half the tokens of
+ * the same value as JSON.
+ */
+export type BrowserTextNode = {
+    ref: string;
+    role: string;
+    depth: number;
+    name?: string | undefined;
+    description?: string | undefined;
+    value?: string | {
+        redacted: true;
+        reason: string;
+    } | undefined;
+    states?: readonly string[] | undefined;
+    actions?: readonly string[] | undefined;
+};
+export type BrowserTextTarget = {
+    id: string;
+    kind: string;
+    title: string;
+    url: string;
+    selected?: boolean | undefined;
+};
+export type BrowserTextObservation = {
+    target: BrowserTextTarget;
+    viewport?: {
+        width: number;
+        height: number;
+        deviceScaleFactor?: number | undefined;
+        maxTouchPoints?: number | undefined;
+    } | null | undefined;
+    focusedRef?: string | null | undefined;
+    changedRegions?: readonly unknown[] | undefined;
+    diagnostics?: {
+        consoleErrorCount: number;
+        failedRequestCount: number;
+        downloadCount: number;
+        pageErrorCount: number;
+    } | null | undefined;
+    dialog?: {
+        type: string;
+        message: string;
+        defaultPrompt?: string | undefined;
+    } | null | undefined;
+    screenshot?: unknown;
+    agentView: {
+        sourceKind: string;
+        nodes: readonly BrowserTextNode[];
+        omittedNodeCount?: number | undefined;
+        removedRefCount?: number | undefined;
+        clippedFieldCount?: number | undefined;
+    };
+};
+export declare function browserNodeLine(node: BrowserTextNode, allRefs: boolean, baseDepth?: number): string;
+export declare function browserTargetLine(target: BrowserTextTarget): string;
+export declare function browserObservationText(observation: BrowserTextObservation, options?: {
+    allRefs?: boolean;
+}): string;
+export type BrowserTextResolvedTarget = {
+    actionIndex: number;
+    ref: string | null;
+    role: string;
+    name: string | null;
+    container: {
+        role: string;
+        name: string | null;
+    } | null;
+};
+export declare function browserActionText(receipt: {
+    targetId: string;
+    state: string;
+    error?: ({
+        code: string;
+        message: string;
+        retryable: boolean;
+    } & Record<string, unknown>) | null | undefined;
+    targets?: readonly BrowserTextResolvedTarget[] | undefined;
+    observation?: BrowserTextObservation | null | undefined;
+    allRefs?: boolean | undefined;
+}): string;
+export declare function browserSessionLine(session: {
+    id: string;
+    lifecycle: string;
+    placement: {
+        kind: string;
+    };
+    engine?: string | null | undefined;
+    headless?: boolean | null | undefined;
+    identityId?: string | null | undefined;
+    failureCode?: string | null | undefined;
+}): string;
+type AttachedProfileText = {
+    id: string;
+    name: string;
+    profileLabel?: string | undefined;
+};
+export declare function browserOpenText(output: {
+    session: Parameters<typeof browserSessionLine>[0];
+    targets: readonly BrowserTextTarget[];
+    otherTabCount?: number | undefined;
+    observation?: BrowserTextObservation | undefined;
+    attachedProfile?: AttachedProfileText | undefined;
+    otherAttachedProfiles?: readonly AttachedProfileText[] | undefined;
+}): string;
+export declare function browserTabsText(output: {
+    browserSessionId: string;
+    targets: readonly BrowserTextTarget[];
+    mutationObservation?: BrowserTextObservation | undefined;
+}): string;
+export declare function browserReadText(output: {
+    targetId: string;
+    mode: string;
+    scopeFound: boolean;
+    nodes: readonly BrowserTextNode[];
+    totalMatches: number;
+    omittedMatches: number;
+    clippedFieldCount: number;
+}): string;
+export {};