@intentcomputing/koko-agent-sdk 1.0.1

package/lib/typescript/commonjs/ui/safeArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeArea.d.ts","sourceRoot":"","sources":["../../../../src/ui/safeArea.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAsDF;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,cAAc,CA6B1D"}

package/lib/typescript/commonjs/ui/useOverlayOrigin.d.ts

@@ -0,0 +1,22 @@
+import type { View } from 'react-native';
+export type OverlayOrigin = {
+    x: number;
+    y: number;
+};
+/**
+ * Where the overlay layer itself sits inside the window.
+ *
+ * Agent coordinates are window-absolute: that is what the native dump reports
+ * and where a synthetic touch is dispatched. The cursor, though, is laid out
+ * inside the host's React tree, and hosts routinely pad their root for the
+ * status bar — so a fingertip drawn at the tap coordinate lands a status bar
+ * lower than the touch it is meant to represent. Measuring the layer's own
+ * origin and subtracting it keeps the two in the same space, and costs nothing
+ * for hosts that do not pad (the origin is then zero).
+ */
+export declare function useOverlayOrigin(): {
+    ref: import("react").RefObject<View>;
+    origin: OverlayOrigin;
+    measure: () => void;
+};
+//# sourceMappingURL=useOverlayOrigin.d.ts.map

package/lib/typescript/commonjs/ui/useOverlayOrigin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOverlayOrigin.d.ts","sourceRoot":"","sources":["../../../../src/ui/useOverlayOrigin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,MAAM,aAAa,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB;;;;EAY/B"}

package/lib/typescript/module/KokoAgent.d.ts

@@ -0,0 +1,167 @@
+import { TaskStore, type TaskStoreImpl } from './task/TaskStore';
+import { AgentSession, type AgentSessionOptions } from './client/AgentSession';
+import { type LocalizedText } from './i18n';
+import type { AgentAction, AgentActionResult, DumpOptions, KokoAgentConfig, PinchOptions, Point, Selector, SensitiveConfirmContext, SwipeOptions, TapOptions, TypeOptions, ViewNode } from './types';
+export type TapTarget = {
+    selector?: Selector;
+    nodeId?: string;
+    point?: Point;
+    options?: TapOptions;
+    /** Used by confirmation gate + subtitle. */
+    label?: string;
+    /** Internal: preserve input-field targeting while focusing a type action. */
+    inputTarget?: boolean;
+};
+export type TypeTarget = {
+    selector?: Selector;
+    nodeId?: string;
+    options?: TypeOptions;
+    label?: string;
+};
+/**
+ * Koko Agent SDK runtime — dump / find / tap / swipe / pinch / type + cursor + confirm gate + task log.
+ */
+export declare class KokoAgent {
+    private config;
+    private lastTree;
+    private planningTree;
+    private readonly ocrTargets;
+    private nextOcrTargetId;
+    /** Labels already confirmed in the current runGoal — avoid repeat dialogs on retry. */
+    private confirmedSensitive;
+    /** Last tap used a host `run` callback (tab/CTA) — skip false tap_noop. */
+    lastTapViaHost: {
+        kind?: string;
+        label?: string;
+    } | null;
+    /** Current NL goal; direct SDK callers may opt into visible scroll search. */
+    activeGoal?: string;
+    constructor(config?: KokoAgentConfig);
+    configure(patch: Partial<KokoAgentConfig>): void;
+    getConfig(): KokoAgentConfig;
+    private message;
+    private text;
+    isNativeReady(): boolean;
+    /** Start a user-facing task (shows subtitle + appears in panel). */
+    startTask(title: string): import(".").Task;
+    finishTask(status?: 'success' | 'failed' | 'cancelled', summary?: LocalizedText): void;
+    /** Manually append an observer log node (for cloud agent narration). */
+    log(kind: Parameters<typeof TaskStore.appendNode>[0]['kind'], title: LocalizedText, detail?: string): import(".").TaskNode | null;
+    /** Open a cloud-backed agent session (official gateway; LLM vendor is server-side). */
+    createSession(opts: AgentSessionOptions): AgentSession;
+    /**
+     * One-shot: talk to official gateway → local dump/find/tap until done.
+     * Users never supply model API keys. Token comes from opts or KokoProvider config.gateway.
+     */
+    private activeSession;
+    private executionEpoch;
+    private claimingCheckpoint;
+    /** @internal Sessions created through createSession share runGoal's owner. */
+    acquireSession(session: AgentSession): boolean;
+    /** @internal Release only an owner acquired by a direct session.run(). */
+    releaseSession(session: AgentSession): void;
+    /** @internal Invalidates gestures already waiting on confirmation/animation. */
+    cancelPendingActions(): void;
+    private assertExecutionCurrent;
+    runGoal(goal: string, opts?: Partial<AgentSessionOptions> & {
+        resumes?: number;
+    }): Promise<import(".").AgentRunResult>;
+    /**
+     * Pick up a run that a JS-context restart interrupted, if any.
+     *
+     * Called once per init by KokoProvider. Resolves to the resumed goal, or null
+     * when there was nothing fresh to resume. The planner decides what is left to
+     * do from the screen the App came back on — if the goal already happened, it
+     * answers `done` without touching anything.
+     */
+    resumeInterruptedRun(): Promise<string | null>;
+    /**
+     * On-device exploration crawl — builds a local screen/transition graph
+     * without a host feature tree. Safe-ish (skips sensitive labels). Call
+     * after SDK init / on a debug build; then runGoal can reuse the graph.
+     */
+    bootstrapExplore(opts?: import('./explore/bootstrapExplore').BootstrapExploreOptions): Promise<import(".").BootstrapExploreResult>;
+    /** Snapshot of the on-device exploration graph (nodes/edges). */
+    getExplorationGraph(): import(".").ExplorationGraphSnapshot;
+    clearExplorationGraph(): void;
+    /** Refresh plan / quota / entitlements from gateway. */
+    refreshAccount(): Promise<import("./types").KokoAccountSnapshot | null>;
+    getAccount(): import("./types").KokoAccountSnapshot | null;
+    /** Stop the in-flight runGoal / session, if any. */
+    stop(): void;
+    /** Open chat sheet (history + NL input) from host UI. */
+    openChat(taskId?: string | null): void;
+    closeChat(): void;
+    getTaskStore(): TaskStoreImpl;
+    dump(options?: DumpOptions): Promise<ViewNode>;
+    /**
+     * Screenshot the host app. By default hides Koko overlay layers
+     * (progress / cursor / sheet) so the image matches what dump sees.
+     */
+    screenshot(options?: {
+        hideOverlays?: boolean;
+    }): Promise<import(".").ScreenshotResult>;
+    getLastTree(): ViewNode | null;
+    /** @internal Return a locally observed OCR label for validating a planned action. */
+    observedOcrLabel(nodeId: string | undefined): string | undefined;
+    /** @internal Pin the screen whose node ids the planner is about to see. */
+    setPlanningTree(tree: ViewNode | null): void;
+    find(selector: Selector, tree?: ViewNode): Promise<ViewNode | null>;
+    findAll(selector: Selector, tree?: ViewNode): Promise<ViewNode[]>;
+    tap(target: TapTarget): Promise<void>;
+    /** Animation and confirmations may outlive the layout that was planned. */
+    private assertTapTargetCurrent;
+    /** Refresh node metadata after scroll-based target resolution. */
+    private ensureSafeTapPoint;
+    /** Reveal by visible swipes, only inside a natively confirmed scrollable list. */
+    private revealVisibleTarget;
+    swipe(from: Point, to: Point, options?: SwipeOptions): Promise<void>;
+    /**
+     * Two-finger pinch at center. scale>1 zoom in, scale<1 zoom out.
+     */
+    pinch(center: Point, scale: number, options?: PinchOptions): Promise<void>;
+    type(text: string, target?: TypeTarget): Promise<void>;
+    requestConfirm(ctx: SensitiveConfirmContext): Promise<boolean>;
+    hideCursor(): void;
+    /** Run one agent protocol tool call. */
+    runAction(action: AgentAction): Promise<AgentActionResult>;
+    private track;
+    private done;
+    private fail;
+    private resolvePoint;
+    private validatedNativeNode;
+    private currentOcrPoint;
+    /**
+     * A coordinate tap has no node to sanity-check it against, so an invented
+     * point would dispatch into nowhere and only surface later as tap_noop.
+     * Fail loudly instead.
+     */
+    /**
+     * A tree that bottoms out exactly at the cap was almost certainly cut short,
+     * and the part that gets cut is the page body — the agent is then left with
+     * the shallow chrome and reports the control as missing. Surface it rather
+     * than letting it read as an empty screen.
+     */
+    private warnIfDepthCapped;
+    /**
+     * Cheap screen fingerprint used to tell real navigation from a dead action.
+     * The "before" side can reuse the tree the session just dumped for this step:
+     * an extra full walk per tap is work the JS thread does not have to spare
+     * while a task is running.
+     */
+    private snapshotLine;
+    private pointWithinWindow;
+    /** Resolve the view node for a tap target (for toggle/adjustable routing). */
+    /**
+     * Where to point while a host action runs.
+     *
+     * Best effort by design: the whole reason this path exists is that the dump
+     * sometimes cannot see the control, so a miss here is normal and must not
+     * turn a working host action into a failed step.
+     */
+    private hostActionPoint;
+    private resolveNode;
+}
+export declare function getKokoAgent(): KokoAgent;
+export declare function initKokoAgent(config?: KokoAgentConfig): KokoAgent;
+//# sourceMappingURL=KokoAgent.d.ts.map

package/lib/typescript/module/KokoAgent.d.ts.map

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

package/lib/typescript/module/assist/OnDeviceAssist.d.ts

@@ -0,0 +1,31 @@
+import type { ViewNode } from '../types';
+import { type AssistIntent } from './intentClassify';
+import { type RankedNode } from './nodeRank';
+export type OnDeviceAssistResult = {
+    intent: AssistIntent;
+    confidence: number;
+    tokens: string[];
+    ocrTokens: string[];
+    /** Goal-derived labels verified against local OCR, never raw page text. */
+    goalOcrLabels?: string[];
+    /** Only allowlisted public wallet product names, verified locally. */
+    walletChoices?: string[];
+    ranked: RankedNode[];
+    /** Compact planner block (empty when nothing useful). */
+    modelText: string;
+    backend: string;
+};
+export type BuildAssistOptions = {
+    /** Skip Vision OCR (tests / hosts without camera-style capture). Default false. */
+    skipOcr?: boolean;
+    /** Cap OCR tokens merged into ranking. */
+    maxOcrTokens?: number;
+};
+/**
+ * On-device assist: JS intent + node rank, optional native OCR.
+ * Enriches the cloud planner `ui_screen_model` — does not replace the LLM.
+ */
+export declare function buildOnDeviceAssist(goal: string, tree: ViewNode | null | undefined, opts?: BuildAssistOptions): Promise<OnDeviceAssistResult>;
+/** Sync path for unit tests / hosts that already have OCR tokens. */
+export declare function buildOnDeviceAssistSync(goal: string, tree: ViewNode | null | undefined, ocrTokens?: string[], backend?: string): OnDeviceAssistResult;
+//# sourceMappingURL=OnDeviceAssist.d.ts.map

package/lib/typescript/module/assist/OnDeviceAssist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnDeviceAssist.d.ts","sourceRoot":"","sources":["../../../../src/assist/OnDeviceAssist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAsB,KAAK,YAAY,EAAqB,MAAM,kBAAkB,CAAC;AAE5F,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,mFAAmF;IACnF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACjC,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAuD/B;AAED,qEAAqE;AACrE,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACjC,SAAS,GAAE,MAAM,EAAO,EACxB,OAAO,SAAO,GACb,oBAAoB,CA4BtB"}

package/lib/typescript/module/assist/intentClassify.d.ts

@@ -0,0 +1,18 @@
+/**
+ * On-device goal intent classification (structural, host-agnostic).
+ * Complements Core ML / Vision OCR — no package IDs or product copy.
+ */
+export type AssistIntent = 'tap' | 'type' | 'scroll' | 'back' | 'search' | 'settings' | 'unknown';
+export type IntentResult = {
+    intent: AssistIntent;
+    confidence: number;
+    /** Tokens useful for node ranking (from the goal itself). */
+    tokens: string[];
+};
+/** Extract short goal tokens for ranking (CJK chunks + latin words). */
+export declare function goalTokens(goal: string): string[];
+/**
+ * Cheap on-device intent — runs everywhere (JS). iOS Vision OCR enriches tokens separately.
+ */
+export declare function classifyGoalIntent(goal: string): IntentResult;
+//# sourceMappingURL=intentClassify.d.ts.map

package/lib/typescript/module/assist/intentClassify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intentClassify.d.ts","sourceRoot":"","sources":["../../../../src/assist/intentClassify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GACpB,KAAK,GACL,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAiCF,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAejD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAgD7D"}

package/lib/typescript/module/assist/nodeRank.d.ts

@@ -0,0 +1,32 @@
+import type { ViewNode } from '../types';
+import type { AssistIntent } from './intentClassify';
+export type RankedNode = {
+    id: string;
+    label: string;
+    score: number;
+    clickable: boolean;
+    kindHint: 'button' | 'field' | 'scroll' | 'other';
+};
+export type OcrTextHit = {
+    text: string;
+    confidence: number;
+    frame?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+};
+/**
+ * Rank dump nodes for an on-device assist pass (goal tokens + OCR tokens + intent).
+ */
+export declare function rankNodesForGoal(tree: ViewNode, opts: {
+    intent: AssistIntent;
+    tokens: string[];
+    /** Extra tokens from Vision OCR (iOS). */
+    ocrTokens?: string[];
+    limit?: number;
+}): RankedNode[];
+/** Compact block for the cloud planner screen model. */
+export declare function assistHintsModelText(intent: AssistIntent, confidence: number, ranked: RankedNode[], ocrTokens: string[], backend: string, ocrTexts?: OcrTextHit[]): string;
+//# sourceMappingURL=nodeRank.d.ts.map

package/lib/typescript/module/assist/nodeRank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeRank.d.ts","sourceRoot":"","sources":["../../../../src/assist/nodeRank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE,CAAC;AAqCF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE;IACJ,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,UAAU,EAAE,CA0Dd;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,EAAE,EACpB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,UAAU,EAAO,GAC1B,MAAM,CAiCR"}

package/lib/typescript/module/assist/ocrTarget.d.ts

@@ -0,0 +1,25 @@
+import type { Point, Frame, ViewNode } from '../types';
+export type PositionedOcrText = {
+    text: string;
+    confidence: number;
+    frame?: Frame;
+};
+/** Visible web regions let a short translated action stay scoped to the page. */
+export declare function visibleWebViewFrames(root: ViewNode): Frame[];
+export declare function ocrHitInFrames(hit: PositionedOcrText, frames: Frame[]): boolean;
+/** Candidate labels are derived only from the user's goal, never screen text. */
+export declare function goalOcrCandidates(goal: string): string[];
+export declare function verifiedGoalOcrLabels(goal: string, root: ViewNode | null | undefined, texts: PositionedOcrText[]): string[];
+export declare const PUBLIC_WALLET_CHOICES: readonly ["WalletConnect", "MetaMask", "Coinbase Wallet", "Uniswap Mobile", "Uniswap Wallet", "Binance Wallet", "Trust Wallet", "Phantom", "OKX Wallet", "Rabby Wallet", "OneKey", "UKey", "UKey Wallet", "Solflare"];
+export declare function walletConnectionAllowed(goal: string): boolean;
+export declare function verifiedWalletChoices(goal: string, root: ViewNode | null | undefined, texts: PositionedOcrText[]): string[];
+/**
+ * Resolve text that is visible in a WebView/Canvas but absent from the native
+ * accessibility tree. The frame comes from native OCR and is already in the
+ * same window-absolute logical coordinate space used by dispatchTap.
+ */
+export declare function findOcrTextPoint(texts: PositionedOcrText[], wanted: string): Point | null;
+export declare function findOcrTextHit(texts: PositionedOcrText[], wanted: string, options?: {
+    translatedWebRegions?: Frame[];
+}): PositionedOcrText | null;
+//# sourceMappingURL=ocrTarget.d.ts.map

package/lib/typescript/module/assist/ocrTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocrTarget.d.ts","sourceRoot":"","sources":["../../../../src/assist/ocrTarget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAQF,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,CAe5D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAI/E;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBxD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAQ3H;AAGD,eAAO,MAAM,qBAAqB,uNAGxB,CAAC;AAEX,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAI7D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAS3H;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,iBAAiB,EAAE,EAC1B,MAAM,EAAE,MAAM,GACb,KAAK,GAAG,IAAI,CAMd;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,iBAAiB,EAAE,EAC1B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,KAAK,EAAE,CAAA;CAAO,GAC/C,iBAAiB,GAAG,IAAI,CA6B1B"}

package/lib/typescript/module/assist/webVisualChange.d.ts

@@ -0,0 +1,6 @@
+import { type PositionedOcrText } from './ocrTarget';
+import type { ViewNode } from '../types';
+/** Local-only text sets: callers may report only whether content changed. */
+export declare function webVisualLabels(root: ViewNode | null, hits: PositionedOcrText[]): Set<string> | null;
+export declare function webVisualChanged(before: Set<string> | null, after: Set<string> | null): boolean;
+//# sourceMappingURL=webVisualChange.d.ts.map

package/lib/typescript/module/assist/webVisualChange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webVisualChange.d.ts","sourceRoot":"","sources":["../../../../src/assist/webVisualChange.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAYpG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,OAAO,CAK/F"}

package/lib/typescript/module/client/ActionOutcomeUnknownError.d.ts

@@ -0,0 +1,13 @@
+import { type LocalizedText } from '../i18n';
+/** A dispatched action may have committed; replay would risk a duplicate. */
+export declare class ActionOutcomeUnknownError extends Error {
+    readonly detail: string;
+    readonly localizedMessage: import("../i18n").LocalizedMessage;
+    constructor(detail: string);
+}
+/** Validation rejected a target before an action was dispatched. Replan safely. */
+export declare class ActionValidationError extends Error {
+    readonly localizedMessage: LocalizedText;
+    constructor(localizedMessage: LocalizedText);
+}
+//# sourceMappingURL=ActionOutcomeUnknownError.d.ts.map

package/lib/typescript/module/client/ActionOutcomeUnknownError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionOutcomeUnknownError.d.ts","sourceRoot":"","sources":["../../../../src/client/ActionOutcomeUnknownError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAEnE,6EAA6E;AAC7E,qBAAa,yBAA0B,SAAQ,KAAK;IAEtC,QAAQ,CAAC,MAAM,EAAE,MAAM;IADnC,QAAQ,CAAC,gBAAgB,qCAAuC;gBAC3C,MAAM,EAAE,MAAM;CAIpC;AAED,mFAAmF;AACnF,qBAAa,qBAAsB,SAAQ,KAAK;IAClC,QAAQ,CAAC,gBAAgB,EAAE,aAAa;gBAA/B,gBAAgB,EAAE,aAAa;CAIrD"}

package/lib/typescript/module/client/AgentSession.d.ts

@@ -0,0 +1,56 @@
+import type { KokoAgent } from '../KokoAgent';
+import { type GatewayConfig } from './GatewayClient';
+export type AskUserHandler = (question: string) => Promise<string | null>;
+export type AgentSessionOptions = GatewayConfig & {
+    locale?: string;
+    localRetries?: number;
+    onAskUser?: AskUserHandler;
+    onNarration?: (text: string) => void;
+    userGateTimeoutMs?: number;
+    /** Picked up after a JS-context restart killed the original run. */
+    resumedFromReload?: boolean;
+};
+export type AgentRunResult = {
+    success: boolean;
+    summary: string;
+    steps: number;
+    sessionId: string;
+};
+/**
+ * Cursor-like session with:
+ * - Preflight risk confirm (before loop)
+ * - Unattended execution (stop only)
+ * - Pause when App shows password/PIN/OTP until user finishes
+ */
+export declare class AgentSession {
+    private readonly agent;
+    private readonly gateway;
+    private readonly opts;
+    private sessionId;
+    private history;
+    private stopped;
+    private running;
+    private readonly operationReplayGuard;
+    constructor(agent: KokoAgent, opts: AgentSessionOptions);
+    stop(): void;
+    private uiLocale;
+    private text;
+    private message;
+    private assertRunning;
+    run(goal: string): Promise<AgentRunResult>;
+    private runInternal;
+    private pushHistory;
+    /** Retry transient upstream / network failures so a completed UI goal is not
+     * marked failed just because the next planning round could not reach the LLM. */
+    private nextWithRetry;
+    private safeDump;
+    private webVisualLabels;
+    /**
+     * When the App presents credentials or recovery material, wait locally.
+     * Koko does not collect secrets — user types in the App UI.
+     */
+    private waitForAppUserGateIfNeeded;
+    private executeWithRetry;
+    private executeOnce;
+}
+//# sourceMappingURL=AgentSession.d.ts.map

package/lib/typescript/module/client/AgentSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSession.d.ts","sourceRoot":"","sources":["../../../../src/client/AgentSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAiB9C,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAmCzB,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA8B;gBAEvD,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,mBAAmB;IASvD,IAAI;IAKJ,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,aAAa;IAIf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;YAYlC,WAAW;IA0gBzB,OAAO,CAAC,WAAW;IASnB;qFACiF;YACnE,aAAa;YAkCb,QAAQ;YAkBR,eAAe;IAU7B;;;OAGG;YACW,0BAA0B;YA2F1B,gBAAgB;YA+BhB,WAAW;CAmE1B"}

package/lib/typescript/module/client/GatewayClient.d.ts

@@ -0,0 +1,149 @@
+import type { AgentAction, Point, Selector } from '../types';
+import type { KokoAccountSnapshot, KokoPlanId } from '../types';
+import type { ViewNode } from '../types';
+export type GatewayConfig = {
+    /**
+     * Official gateway origin. Defaults to https://sdk.intentcomputing.net
+     * Localhost only in Metro debug clients (lab dogfood), not customer self-host.
+     */
+    baseUrl?: string;
+    /**
+     * App / member token from your product backend or dashboard.
+     * Never an LLM API key — users never see model keys.
+     */
+    token: string;
+    /**
+     * Host App ID (iOS bundle id / Android package name).
+     * Defaults to the native module's hostAppId. Must match the App ID bound to the token.
+     */
+    appId?: string;
+};
+export declare function resolveGatewayBaseUrl(cfg: GatewayConfig): string;
+export type AgentHistoryItem = {
+    tool: string;
+    args?: Record<string, unknown>;
+    result: string;
+    ok?: boolean;
+};
+export type GatewayNextRequest = {
+    session_id?: string;
+    goal: string;
+    ui_tree?: unknown;
+    ui_outline?: string;
+    ui_screen_model?: string;
+    /** Local-only evidence; gateway serializes only labels derived from goal. */
+    local_ocr_goal_labels?: string[];
+    local_ocr_wallet_choices?: string[];
+    local_web_wallet_aliases?: string[];
+    history: AgentHistoryItem[];
+    locale?: string;
+    user_reply?: string;
+    platform?: 'ios' | 'android' | 'unknown';
+};
+/** Build hints from the same redacted tree that crosses the upload boundary. */
+export declare function safePlannerModel(tree: ViewNode, goal: string, localOcrGoalLabels?: string[], localWalletChoices?: string[], hostWalletAliases?: string[]): string;
+export type GatewayAction = {
+    tool: 'dump';
+    args?: {
+        reason?: string;
+    };
+} | {
+    tool: 'find';
+    args: {
+        match: Array<Record<string, unknown>>;
+        index?: number;
+    };
+} | {
+    tool: 'tap';
+    args: {
+        selector?: Selector;
+        nodeId?: string;
+        /** Last-resort window point when the control is visible but not in the tree. */
+        point?: Point;
+        label?: string;
+    };
+} | {
+    tool: 'swipe';
+    args: {
+        from: Point;
+        to: Point;
+        label?: string;
+    };
+} | {
+    tool: 'pinch';
+    args: {
+        center: Point;
+        scale: number;
+        label?: string;
+    };
+} | {
+    tool: 'type';
+    args: {
+        text: string;
+        selector?: Selector;
+        nodeId?: string;
+        clear?: boolean;
+        label?: string;
+    };
+} | {
+    tool: 'ask_user';
+    args: {
+        question: string;
+    };
+} | {
+    tool: 'done';
+    args: {
+        success: boolean;
+        summary: string;
+    };
+};
+export type GatewayNextResponse = {
+    ok: true;
+    session_id: string;
+    narration: string | null;
+    action: GatewayAction;
+    provider: string;
+    model: string;
+    step: number;
+    region: string;
+    execution_permit: string;
+};
+export type GatewaySessionResponse = {
+    ok: true;
+    session_id: string;
+    execution_permit: string;
+};
+export declare class GatewayError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly quota?: KokoAccountSnapshot['quota'];
+    readonly plan?: KokoPlanId;
+    constructor(message: string, opts: {
+        code: string;
+        status: number;
+        quota?: KokoAccountSnapshot['quota'];
+        plan?: KokoPlanId;
+    });
+}
+export declare class GatewayClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly appId;
+    constructor(cfg: GatewayConfig);
+    getBaseUrl(): string;
+    getAppId(): string;
+    private authHeaders;
+    private parseError;
+    health(): Promise<Record<string, unknown>>;
+    /** Open session + initial execution permit (before first dump). */
+    beginSession(sessionId?: string): Promise<GatewaySessionResponse>;
+    me(): Promise<KokoAccountSnapshot>;
+    usage(limit?: number): Promise<{
+        quota: KokoAccountSnapshot['quota'];
+        plan: KokoPlanId;
+        events: unknown[];
+    }>;
+    next(body: GatewayNextRequest): Promise<GatewayNextResponse>;
+}
+export declare function toLocalAgentAction(action: GatewayAction): AgentAction | null;
+//# sourceMappingURL=GatewayClient.d.ts.map

package/lib/typescript/module/client/GatewayClient.d.ts.map

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

package/lib/typescript/module/client/OperationReplayGuard.d.ts

@@ -0,0 +1,13 @@
+import type { GatewayAction } from './GatewayClient';
+import type { ViewNode } from '../types';
+/** Keep only hashes of prior public operation entries across privacy purges. */
+export declare class OperationReplayGuard {
+    private attempts;
+    hasHandoff: boolean;
+    reset(): void;
+    markHandoff(): void;
+    private key;
+    record(action: GatewayAction, tree: ViewNode | null): void;
+    blocks(action: GatewayAction, tree: ViewNode | null): boolean;
+}
+//# sourceMappingURL=OperationReplayGuard.d.ts.map

package/lib/typescript/module/client/OperationReplayGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationReplayGuard.d.ts","sourceRoot":"","sources":["../../../../src/client/OperationReplayGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAazC,gFAAgF;AAChF,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAqB;IACrC,UAAU,UAAS;IAEnB,KAAK;IACL,WAAW;IAEX,OAAO,CAAC,GAAG;IA6BX,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAKnD,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO;CAI9D"}