@intentcomputing/koko-agent-sdk 1.0.1

package/lib/typescript/module/explore/ExplorationGraph.d.ts.map

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

package/lib/typescript/module/explore/bootstrapExplore.d.ts

@@ -0,0 +1,40 @@
+/** Capture the current public screen as local exploration metadata. */
+import type { KokoAgent } from '../KokoAgent';
+import { type ExplorationGraphSnapshot } from './ExplorationGraph';
+export type BootstrapExploreOptions = {
+    /** @deprecated Exploration only observes the current screen; no crawling. */
+    mode?: 'full' | 'quick';
+    /** @deprecated No actions are executed. */
+    maxSteps?: number;
+    /** @deprecated Only the current screen is observed. */
+    maxScreens?: number;
+    /** @deprecated There are no candidate actions to prioritize. */
+    priorityPatterns?: RegExp[];
+    /** @deprecated There are no candidate actions to skip. */
+    skipPatterns?: RegExp[];
+    /** @deprecated No action progress events are emitted. */
+    onProgress?: (info: {
+        step: number;
+        label: string;
+        nodes: number;
+        edges: number;
+        depth: number;
+    }) => void;
+    /** App key for local graph persistence (bundle id / flavor). */
+    appKey?: string;
+};
+export type BootstrapExploreResult = {
+    success: boolean;
+    /** Always zero: observation never moves or operates the host. */
+    steps: number;
+    summary: string;
+    graph: ExplorationGraphSnapshot;
+};
+/**
+ * Compatibility entry point for read-only observation. Uses the caller's
+ * existing dump permission; never mints a permit, starts a task, navigates,
+ * changes LogBox settings or invokes host callbacks. Graphs are soft hints,
+ * and never constitute permission to execute a historical transition.
+ */
+export declare function bootstrapExplore(agent: KokoAgent, opts?: BootstrapExploreOptions): Promise<BootstrapExploreResult>;
+//# sourceMappingURL=bootstrapExplore.d.ts.map

package/lib/typescript/module/explore/bootstrapExplore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapExplore.d.ts","sourceRoot":"","sources":["../../../../src/explore/bootstrapExplore.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM9C,OAAO,EAA2C,KAAK,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE5G,MAAM,MAAM,uBAAuB,GAAG;IACpC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,yDAAyD;IACzD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,KAAK,IAAI,CAAC;IACX,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,wBAAwB,CAAC;CACjC,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAuCjC"}

package/lib/typescript/module/host/HostActions.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Optional host-declared actions — the low-friction way for complex Apps
+ * (OneKey / Tamagui) when native dump cannot see icons without a11y/testID.
+ *
+ * Hosts register controls only while mounted and visible. Callbacks supplement
+ * native controls; registration does not establish visibility or identity.
+ *
+ * IMPORTANT: host ids are NOT dump nodeIds. Never emit `id=host:…` in the
+ * screen model — planners will tap them and fail with "nodeId not found".
+ *
+ * Optional `run`: after a unique current native control is bound, a callback
+ * may execute its behavior instead of dispatching a geometric touch.
+ */
+import type { ViewNode } from '../types';
+export type HostActionKind = 'button' | 'tab' | 'nav' | 'field' | 'sheet' | 'other';
+/**
+ * Host action matching: also consider optional aliases (e.g. prior-locale tab copy).
+ */
+export type HostAction = {
+    /** Stable id, e.g. "tab.home" / "header.settings". */
+    id: string;
+    /** Human label shown to the planner (prefer host locale). */
+    label: string;
+    kind?: HostActionKind;
+    /** Prefer testID when the host already has one. */
+    testID?: string;
+    /** Free-text / a11y match fallback. */
+    text?: string;
+    /** Extra NL match strings (other locales / synonyms). */
+    aliases?: string[];
+    /** Optional deep-link or route hint for narration only. */
+    route?: string;
+    /**
+     * Host-provided invoke. Used only after unique native target binding.
+     * Register only while the CTA is mounted and visible; unregister on blur.
+     */
+    run?: () => void | Promise<void>;
+    /**
+     * When true (default for one-shot CTAs), unregister after a successful host run.
+     * Tabs / persistent chrome should set `oneshot: false`.
+     */
+    oneshot?: boolean;
+};
+type Listener = (actions: HostAction[]) => void;
+declare class HostActionsStoreImpl {
+    private actions;
+    private listeners;
+    /** Replace the whole catalog (typical: once at app start). */
+    setActions(actions: HostAction[]): void;
+    /** Append / upsert by id. */
+    registerActions(actions: HostAction[]): void;
+    /** Drop a previously registered action (e.g. EmptyWallet unmount). */
+    unregisterAction(id: string): void;
+    clear(): void;
+    getActions(): HostAction[];
+    getById(id: string): HostAction | undefined;
+    /** Match by label / text / testID (planner taps by copy, not host id). */
+    findForTap(needle: {
+        label?: string;
+        text?: string;
+        testID?: string;
+    }): HostAction | undefined;
+    subscribe(listener: Listener): () => void;
+    private emit;
+}
+/**
+ * A unique callback catalog entry is not a unique native control. Bind it to
+ * the node already chosen by the full selector (including index/nearText),
+ * otherwise the caller must preserve that selector and use a native touch.
+ */
+export declare function canRunHostActionForNode(action: HostAction, selected: ViewNode | null | undefined, root: ViewNode | null | undefined): boolean;
+/**
+ * Callbacks declare behavior, not visibility. Only current visible native
+ * evidence enters the model; missing native content can use fresh local OCR.
+ */
+export declare function filterVisibleHostActions(actions: HostAction[], root: ViewNode | null | undefined): HostAction[];
+/**
+ * Compact lines merged into ui_screen_model.
+ * No fake node ids — tap must use text「…」 / testID, never id=host:….
+ */
+export declare function hostActionsModelText(actions: HostAction[]): string;
+export declare const HostActionsStore: HostActionsStoreImpl;
+export declare function setHostActions(actions: HostAction[]): void;
+export declare function registerHostActions(actions: HostAction[]): void;
+export declare function unregisterHostAction(id: string): void;
+export declare function clearHostActions(): void;
+/**
+ * Upper bound on a single host action. These callbacks are app code we do not
+ * control: one that never settles wedges the whole goal with no step, no log
+ * line and no timeout above it. Observed as a goal sitting for minutes without
+ * ever reaching the planner.
+ */
+export declare const HOST_ACTION_TIMEOUT_MS = 8000;
+/**
+ * Await a host callback without letting it hang the agent. Resolves false when
+ * it throws or outruns its budget. False means the outcome is unknown: the
+ * callback may already have committed work, so callers must not replay a tap.
+ */
+export declare function runHostAction(run: () => void | Promise<void>, timeoutMs?: number): Promise<boolean>;
+export {};
+//# sourceMappingURL=HostActions.d.ts.map

package/lib/typescript/module/host/HostActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostActions.d.ts","sourceRoot":"","sources":["../../../../src/host/HostActions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,KAAK,GACL,KAAK,GACL,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,KAAK,QAAQ,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC;AAEhD,cAAM,oBAAoB;IACxB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,SAAS,CAAuB;IAExC,8DAA8D;IAC9D,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE;IAKhC,6BAA6B;IAC7B,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE;IAOrC,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,EAAE,MAAM;IAS3B,KAAK;IAKL,UAAU,IAAI,UAAU,EAAE;IAI1B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAK3C,0EAA0E;IAC1E,UAAU,CAAC,MAAM,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,UAAU,GAAG,SAAS;IAwB1B,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAMzC,OAAO,CAAC,IAAI;CAIb;AAwCD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACrC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAChC,OAAO,CA+CT;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,UAAU,EAAE,EACrB,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAChC,UAAU,EAAE,CAgCd;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAclE;AAED,eAAO,MAAM,gBAAgB,sBAA6B,CAAC;AAE3D,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,QAEnD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,QAExD;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,QAE9C;AAED,wBAAgB,gBAAgB,SAE/B;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC/B,SAAS,GAAE,MAA+B,GACzC,OAAO,CAAC,OAAO,CAAC,CAkBlB"}

package/lib/typescript/module/i18n/index.d.ts

@@ -0,0 +1,20 @@
+import { type RuntimeMessageKey } from './runtimeMessages';
+import type { KokoLocale } from '../types';
+export type MessageKey = RuntimeMessageKey | 'brand.defaultName' | 'brand.defaultTagline' | 'brand.defaultPlaceholder' | 'brand.defaultMark' | 'sheet.recentTasks' | 'sheet.timeline' | 'sheet.emptyTasks' | 'sheet.emptyNodesTitle' | 'sheet.emptyNodesHint' | 'sheet.send' | 'sheet.closeA11y' | 'sheet.stopA11y' | 'sheet.inputA11y' | 'sheet.deleteTaskTitle' | 'sheet.deleteTaskBody' | 'sheet.deleteTask' | 'status.running' | 'status.success' | 'status.failed' | 'status.cancelled' | 'kind.user' | 'kind.plan' | 'kind.dump' | 'kind.find' | 'kind.tap' | 'kind.swipe' | 'kind.type' | 'kind.confirm' | 'kind.info' | 'kind.error' | 'resume.note' | 'resume.verifyFirst' | 'progress.running' | 'progress.success' | 'progress.failed' | 'progress.cancelled' | 'progress.openA11y' | 'progress.stopA11y' | 'gate.check' | 'gate.checking' | 'gate.stillPrivate' | 'gate.unreadable' | 'gate.verifyResultFirst' | 'gate.replayStopped' | 'dialog.cancel' | 'dialog.confirm' | 'dialog.continue' | 'dialog.askTitle' | 'dialog.askPlaceholder' | 'confirm.preflightTitle' | 'confirm.preflightBody' | 'confirm.inlineTitle' | 'confirm.inlineBody';
+export declare function normalizeLocale(locale?: string | null): KokoLocale;
+export declare function gatewayLocale(locale: KokoLocale): string;
+export declare function t(locale: KokoLocale, key: MessageKey, vars?: Record<string, string | number>): string;
+export type MessageVars = Record<string, string | number>;
+export type LocalizedMessage = {
+    readonly kokoMessage: true;
+    readonly key: MessageKey;
+    readonly vars?: MessageVars;
+    readonly fallbackLocale?: string;
+};
+export type LocalizedText = string | LocalizedMessage;
+/** Resolve at use time so an in-flight task follows host language changes. */
+export declare function currentLocale(fallbackLocale?: string | null): KokoLocale;
+export declare function message(key: MessageKey, vars?: MessageVars, fallbackLocale?: string): LocalizedMessage;
+export declare function resolveText(value: LocalizedText): string;
+export declare function runtimeText(key: MessageKey, vars?: MessageVars, fallbackLocale?: string | null): string;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,UAAU,GAAG,iBAAiB,GACtC,mBAAmB,GACnB,sBAAsB,GACtB,0BAA0B,GAC1B,mBAAmB,GACnB,mBAAmB,GACnB,gBAAgB,GAChB,kBAAkB,GAClB,uBAAuB,GACvB,sBAAsB,GACtB,YAAY,GACZ,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,GACjB,uBAAuB,GACvB,sBAAsB,GACtB,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,UAAU,GACV,YAAY,GACZ,WAAW,GACX,cAAc,GACd,WAAW,GACX,YAAY,GACZ,aAAa,GACb,oBAAoB,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,GACjB,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,GACnB,YAAY,GACZ,eAAe,GACf,mBAAmB,GACnB,iBAAiB,GACjB,wBAAwB,GACxB,oBAAoB,GACpB,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,GACjB,uBAAuB,GACvB,wBAAwB,GACxB,uBAAuB,GACvB,qBAAqB,GACrB,oBAAoB,CAAC;AA0HzB,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,CAMlE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAExD;AAED,wBAAgB,CAAC,CACf,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,UAAU,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACrC,MAAM,CASR;AAGD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAEtD,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,CAExE;AACD,wBAAgB,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAEtG;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAExD;AACD,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEvG"}

package/lib/typescript/module/i18n/runtimeMessages.d.ts

@@ -0,0 +1,178 @@
+export declare const runtimeZh: {
+    readonly "runtime.element": "元素";
+    readonly "runtime.target": "目标";
+    readonly "runtime.field": "输入框";
+    readonly "runtime.scan": "扫描界面…";
+    readonly "runtime.scanned": "已扫描界面";
+    readonly "runtime.find": "定位「{label}」";
+    readonly "runtime.found": "已定位「{label}」";
+    readonly "runtime.notFound": "未找到「{label}」";
+    readonly "runtime.tap": "点击「{label}」";
+    readonly "runtime.tapped": "已点击「{label}」";
+    readonly "runtime.confirmBlocked": "已拦截：需确认「{label}」";
+    readonly "runtime.confirmationRequired": "操作需要用户确认，未执行点击";
+    readonly "runtime.toggle": "切换「{label}」";
+    readonly "runtime.toggled": "已切换「{label}」";
+    readonly "runtime.adjust": "调节「{label}」";
+    readonly "runtime.adjusted": "已调节「{label}」";
+    readonly "runtime.confirmed": "已确认「{label}」";
+    readonly "runtime.confirm": "等待确认「{label}」";
+    readonly "runtime.userConfirmed": "用户已确认「{label}」";
+    readonly "runtime.userDeclined": "用户拒绝「{label}」";
+    readonly "runtime.privateStep": "请在 App 内完成隐私步骤；SDK 不代填或选择秘密信息";
+    readonly "runtime.hostTargetMissing": "当前页面没有可验证的宿主操作入口";
+    readonly "runtime.positionChanged": "目标位置已变化，正在重新观察；未执行点击";
+    readonly "runtime.contentChanged": "目标内容已变化，正在重新观察；未执行点击";
+    readonly "runtime.reveal": "目标尚未出现在可见区域，正在滚动查找…";
+    readonly "runtime.swipe": "滑动页面…";
+    readonly "runtime.swiped": "已滑动";
+    readonly "runtime.zoomIn": "双指放大…";
+    readonly "runtime.zoomOut": "双指缩小…";
+    readonly "runtime.zoomedIn": "已放大";
+    readonly "runtime.zoomedOut": "已缩小";
+    readonly "runtime.input": "输入「{text}」";
+    readonly "runtime.typed": "已输入「{text}」";
+    readonly "runtime.missingTarget": "未找到可见目标；请选择当前可见导航，或在确认属于当前列表时滚动查找；未执行点击";
+    readonly "runtime.ocrUnobserved": "未找到可见目标；OCR 引用未经过本地观察或已过期；未执行点击";
+    readonly "runtime.ocrMissing": "未找到可见目标；OCR 目标已离开当前画面；未执行点击";
+    readonly "runtime.nodeUnavailable": "未找到可见目标；节点已离开当前画面或不可操作；未执行点击";
+    readonly "runtime.nodeChanged": "未找到可见目标；节点内容已变化或未在本轮观察；请重新规划；未执行点击";
+    readonly "runtime.hostNotVisible": "宿主操作入口当前不可见：{id}";
+    readonly "runtime.invalidTarget": "点击需要选择器、节点或有效坐标";
+    readonly "runtime.invalidPoint": "点击坐标无效：({x}, {y})";
+    readonly "runtime.outsideWindow": "点击坐标超出当前窗口；未执行点击";
+    readonly "runtime.cancelled": "已取消";
+    readonly "runtime.confirmationCancelled": "用户取消：未确认高风险操作";
+    readonly "runtime.alreadyRunning": "已有任务正在执行，请等待其结束";
+    readonly "runtime.missingToken": "缺少应用访问令牌，请检查 SDK 网关配置";
+    readonly "runtime.gateTimeout": "等待用户在 App 内完成安全步骤超时";
+    readonly "runtime.progressBudget": "任务仍在推进，扩展步数预算 → {steps}";
+    readonly "runtime.waitForApp": "请在 App 内完成：{request}";
+    readonly "runtime.inputInApp": "请在 App 内完成输入";
+    readonly "runtime.userContinued": "用户已在 App 内继续";
+    readonly "runtime.userTimeout": "等待用户操作超时，未确认完成";
+    readonly "runtime.loopStopped": "检测到空转或重复操作，已停止";
+    readonly "runtime.stepLimit": "达到安全步数上限";
+    readonly "runtime.scrollNoop": "scroll_noop: 内容位置未变化，已到边界或该方向无法滚动。请换方向或选择可见导航。";
+    readonly "runtime.scrollChanged": "swiped: 内容位置已变化，滚动有效";
+    readonly "runtime.gatewayRetry": "网关暂时不可用，重试 ({attempt}/{total})…";
+    readonly "runtime.gateConfirmed": "已确认完成安全输入";
+    readonly "runtime.gateCompleted": "安全输入已完成";
+    readonly "runtime.gateInputTimeout": "等待安全输入超时";
+    readonly "runtime.unreadable": "当前页面暂不可读，请重新观察后选择导航";
+    readonly "runtime.uncertainOutcome": "操作结果暂无法确认，已停止以避免重复执行";
+    readonly "runtime.operationFailed": "操作未完成，请查看执行记录后重试";
+    readonly "runtime.defaultTask": "Koko 任务";
+    readonly "runtime.recoveryPhrase": "请亲自在 App 内完成助记词备份或验证；助记词及候选词不会发送至云端";
+    readonly "runtime.privateKey": "请亲自在 App 内完成私钥操作；该页面不会发送至云端";
+    readonly "runtime.password": "请在 App 内输入密码，进入下一页后将自动继续；也可点「检查状态」";
+    readonly "runtime.pin": "请在 App 内输入 PIN 或密码，完成后继续";
+    readonly "runtime.otp": "请在 App 内输入验证码，完成后继续";
+    readonly "runtime.authorization": "请在 App 或系统中完成授权登录或连接，完成后继续";
+    readonly "runtime.biometric": "请完成面容或指纹验证，完成后继续";
+    readonly "runtime.permission": "请在系统弹窗中选择是否授权，完成后继续";
+    readonly "runtime.consent": "请在 App 内确认风险或条款后继续";
+    readonly "runtime.sensitiveStep": "请在 App 内完成此敏感步骤，完成后继续";
+    readonly "panel.close": "关闭";
+    readonly "panel.collapseA11y": "收起{name}任务面板";
+    readonly "panel.closeA11y": "关闭{name}任务面板";
+    readonly "panel.tasks": "任务";
+    readonly "panel.emptyTasks": "暂无任务";
+    readonly "panel.session": "会话 · {title}";
+    readonly "panel.stepOne": "{count}步";
+    readonly "panel.stepMany": "{count}步";
+    readonly "composer.incomplete": "未完成：{summary}";
+    readonly "composer.stopped": "已停止";
+    readonly "composer.stop": "停止";
+    readonly "runtime.localeChanged": "宿主语言已更改；上一次规划尚未执行，请按当前语言重新观察并规划";
+};
+export declare const runtimeEn: {
+    readonly "runtime.element": "element";
+    readonly "runtime.target": "target";
+    readonly "runtime.field": "text field";
+    readonly "runtime.scan": "Scanning screen…";
+    readonly "runtime.scanned": "Screen scanned";
+    readonly "runtime.find": "Finding “{label}”";
+    readonly "runtime.found": "Found “{label}”";
+    readonly "runtime.notFound": "Could not find “{label}”";
+    readonly "runtime.tap": "Tapping “{label}”";
+    readonly "runtime.tapped": "Tapped “{label}”";
+    readonly "runtime.confirmBlocked": "Waiting for confirmation of “{label}”";
+    readonly "runtime.confirmationRequired": "User confirmation is required; no tap was performed";
+    readonly "runtime.toggle": "Toggling “{label}”";
+    readonly "runtime.toggled": "Toggled “{label}”";
+    readonly "runtime.adjust": "Adjusting “{label}”";
+    readonly "runtime.adjusted": "Adjusted “{label}”";
+    readonly "runtime.confirmed": "Confirmed “{label}”";
+    readonly "runtime.confirm": "Waiting for confirmation of “{label}”";
+    readonly "runtime.userConfirmed": "You confirmed “{label}”";
+    readonly "runtime.userDeclined": "You declined “{label}”";
+    readonly "runtime.privateStep": "Complete the private step in the app; the assistant cannot enter or select secrets";
+    readonly "runtime.hostTargetMissing": "No verified entry for this host action is visible";
+    readonly "runtime.positionChanged": "The target moved. Observing again; no tap was performed";
+    readonly "runtime.contentChanged": "The target content changed. Observing again; no tap was performed";
+    readonly "runtime.reveal": "The target is not visible yet. Scrolling to find it…";
+    readonly "runtime.swipe": "Scrolling…";
+    readonly "runtime.swiped": "Scrolled";
+    readonly "runtime.zoomIn": "Zooming in…";
+    readonly "runtime.zoomOut": "Zooming out…";
+    readonly "runtime.zoomedIn": "Zoomed in";
+    readonly "runtime.zoomedOut": "Zoomed out";
+    readonly "runtime.input": "Typing “{text}”";
+    readonly "runtime.typed": "Typed “{text}”";
+    readonly "runtime.missingTarget": "No visible target was found. Choose visible navigation or scroll within the relevant list; no tap was performed";
+    readonly "runtime.ocrUnobserved": "This OCR reference was not observed locally or has expired; no tap was performed";
+    readonly "runtime.ocrMissing": "The OCR target is no longer visible; no tap was performed";
+    readonly "runtime.nodeUnavailable": "The target is no longer visible or enabled; no tap was performed";
+    readonly "runtime.nodeChanged": "The target changed or was not observed in this planning step. Plan again; no tap was performed";
+    readonly "runtime.hostNotVisible": "The host action is not visible: {id}";
+    readonly "runtime.invalidTarget": "A tap requires a selector, node, or valid coordinates";
+    readonly "runtime.invalidPoint": "Invalid tap coordinates: ({x}, {y})";
+    readonly "runtime.outsideWindow": "The target is outside the current window; no tap was performed";
+    readonly "runtime.cancelled": "Cancelled";
+    readonly "runtime.confirmationCancelled": "Cancelled: the sensitive action was not confirmed";
+    readonly "runtime.alreadyRunning": "A task is already running; wait for it to settle";
+    readonly "runtime.missingToken": "The app access token is missing. Check the SDK gateway configuration";
+    readonly "runtime.gateTimeout": "Timed out waiting for the private step in the app";
+    readonly "runtime.progressBudget": "The task is progressing. Extending the step budget to {steps}";
+    readonly "runtime.waitForApp": "Complete this in the app: {request}";
+    readonly "runtime.inputInApp": "Complete the input in the app";
+    readonly "runtime.userContinued": "You continued in the app";
+    readonly "runtime.userTimeout": "Timed out waiting for your action; completion was not confirmed";
+    readonly "runtime.loopStopped": "Stopped after detecting repeated actions without progress";
+    readonly "runtime.stepLimit": "Reached the safe step limit";
+    readonly "runtime.scrollNoop": "scroll_noop: Content did not move. The edge was reached or this direction cannot scroll. Change direction or choose visible navigation.";
+    readonly "runtime.scrollChanged": "swiped: Content moved; scrolling worked";
+    readonly "runtime.gatewayRetry": "The gateway is temporarily unavailable. Retrying ({attempt}/{total})…";
+    readonly "runtime.gateConfirmed": "Private input completion confirmed";
+    readonly "runtime.gateCompleted": "Private input completed";
+    readonly "runtime.gateInputTimeout": "Timed out waiting for private input";
+    readonly "runtime.unreadable": "The current screen is unreadable. Observe again before choosing navigation";
+    readonly "runtime.uncertainOutcome": "The action result could not be confirmed. Stopped to avoid repeating it";
+    readonly "runtime.operationFailed": "The action did not complete. Check the activity and try again";
+    readonly "runtime.defaultTask": "Koko task";
+    readonly "runtime.recoveryPhrase": "Back up or verify the recovery phrase yourself in the app. The phrase and candidate words stay on this device";
+    readonly "runtime.privateKey": "Complete the private key step yourself in the app. This screen stays on this device";
+    readonly "runtime.password": "Enter your password in the app. The assistant resumes on the next screen; you can also select “Check status”";
+    readonly "runtime.pin": "Enter your PIN or password in the app to continue";
+    readonly "runtime.otp": "Enter the verification code in the app to continue";
+    readonly "runtime.authorization": "Complete sign-in or connection authorization in the app or system to continue";
+    readonly "runtime.biometric": "Complete Face ID or fingerprint verification to continue";
+    readonly "runtime.permission": "Choose whether to grant permission in the system dialog to continue";
+    readonly "runtime.consent": "Review and confirm the risks or terms in the app to continue";
+    readonly "runtime.sensitiveStep": "Complete this sensitive step in the app to continue";
+    readonly "panel.close": "Close";
+    readonly "panel.collapseA11y": "Collapse {name} task panel";
+    readonly "panel.closeA11y": "Close {name} task panel";
+    readonly "panel.tasks": "Tasks";
+    readonly "panel.emptyTasks": "No tasks yet";
+    readonly "panel.session": "Activity · {title}";
+    readonly "panel.stepOne": "{count} step";
+    readonly "panel.stepMany": "{count} steps";
+    readonly "composer.incomplete": "Not completed: {summary}";
+    readonly "composer.stopped": "Stopped";
+    readonly "composer.stop": "Stop";
+    readonly "runtime.localeChanged": "The host language changed before execution. Observe and plan again in the current language.";
+};
+export type RuntimeMessageKey = keyof typeof runtimeEn;
+//# sourceMappingURL=runtimeMessages.d.ts.map

package/lib/typescript/module/i18n/runtimeMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeMessages.d.ts","sourceRoot":"","sources":["../../../../src/i18n/runtimeMessages.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuFZ,CAAC;AAEX,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuFZ,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,SAAS,CAAC"}

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

@@ -0,0 +1,66 @@
+export type { AgentAction, AgentActionResult, ConfirmationPolicy, DumpOptions, Frame, KokoAccountSnapshot, KokoAgentConfig, KokoBrandingConfig, KokoEntitlements, KokoLocale, KokoPlanId, KokoTheme, KokoUsageEvent, MatchRule, Point, Selector, SensitiveConfirmContext, SwipeOptions, PinchOptions, TapOptions, TypeOptions, ViewNode, } from './types';
+export type { ObserverUiState, Task, TaskNode, TaskNodeKind, TaskNodeStatus, TaskStatus, TaskStoreSnapshot, ProgressResultFlash, } from './task/types';
+export { KokoAgent, getKokoAgent, initKokoAgent } from './KokoAgent';
+export type { TapTarget, TypeTarget } from './KokoAgent';
+export { KokoProvider, useKokoAgent } from './provider/KokoProvider';
+export type { KokoProviderProps } from './provider/KokoProvider';
+export { KokoRemoteSmoke } from './debug/KokoRemoteSmoke';
+export type { KokoRemoteSmokeCmd } from './debug/KokoRemoteSmoke';
+export { useKokoUi } from './provider/KokoUiContext';
+export type { KokoUiContextValue } from './provider/KokoUiContext';
+export { setKokoAppearance, getKokoAppearance, HostAppearanceStore, resolveThemeColors, resolveChromeColors, invertTheme, } from './provider/HostAppearanceStore';
+export type { KokoAppearance, KokoThemeColors, } from './provider/HostAppearanceStore';
+export { CursorOverlay } from './cursor/CursorOverlay';
+export { CursorController } from './cursor/controller';
+export { KokoObserver } from './ui/KokoObserver';
+export type { KokoObserverProps } from './ui/KokoObserver';
+export { KokoChatSheet } from './ui/KokoChatSheet';
+export { KokoComposer } from './ui/KokoComposer';
+export type { KokoComposerProps } from './ui/KokoComposer';
+export { KokoEntryButton, openKokoChat, closeKokoChat, } from './ui/KokoEntryButton';
+export type { KokoEntryButtonProps } from './ui/KokoEntryButton';
+export { KokoSubtitle } from './ui/KokoSubtitle';
+export { KokoTaskPanel } from './ui/KokoTaskPanel';
+export { KokoDialogHost, DialogBus } from './ui/KokoDialogHost';
+export { KokoOverlayLayer, KOKO_OVERLAY_TEST_ID, } from './ui/KokoOverlayLayer';
+export type { KokoOverlayLayerProps } from './ui/KokoOverlayLayer';
+export type { ScreenshotOptions, ScreenshotResult, RecognizeScreenTextOptions, RecognizeScreenTextResult, } from './native/NativeBridge';
+export { NativeBridge } from './native/NativeBridge';
+export { classifyGoalIntent, goalTokens } from './assist/intentClassify';
+export type { AssistIntent, IntentResult } from './assist/intentClassify';
+export { rankNodesForGoal, assistHintsModelText } from './assist/nodeRank';
+export type { RankedNode } from './assist/nodeRank';
+export { buildOnDeviceAssist, buildOnDeviceAssistSync, } from './assist/OnDeviceAssist';
+export type { OnDeviceAssistResult, BuildAssistOptions, } from './assist/OnDeviceAssist';
+export { TaskStore, TaskStoreImpl } from './task/TaskStore';
+export { useTaskStore } from './task/useTaskStore';
+export { AgentSession } from './client/AgentSession';
+export type { AgentSessionOptions, AgentRunResult, AskUserHandler } from './client/AgentSession';
+export { GatewayClient, GatewayError, resolveGatewayBaseUrl, toLocalAgentAction, } from './client/GatewayClient';
+export type { GatewayConfig, GatewayNextRequest, GatewayNextResponse, GatewayAction, AgentHistoryItem, } from './client/GatewayClient';
+export { AccountStore } from './commercial/AccountStore';
+export { UsageBus } from './commercial/UsageBus';
+export { ExecutionGuard } from './commercial/ExecutionGuard';
+export { AgentDebug } from './commercial/AgentDebug';
+export { resolveDebugLogging, resolveDevMode, allowLocalGatewayForDebugClient, isMetroDevBuild, } from './commercial/devMode';
+export { resolveBranding, DEFAULT_ENTITLEMENTS } from './commercial/branding';
+export type { ResolvedBranding } from './commercial/branding';
+export { isTrustedEntitlementHost, isAllowedGatewayUrl, isOfficialGatewayHost, isLocalDevHost, } from './commercial/trust';
+export { t, normalizeLocale, gatewayLocale } from './i18n';
+export type { MessageKey } from './i18n';
+export { redactViewTreeClient, viewTreeOutline } from './privacy/redact';
+export { extractAffordances, screenModelText, screenSnapshotLine, } from './privacy/screenModel';
+export type { Affordance, AffordanceKind } from './privacy/screenModel';
+export { HostActionsStore, setHostActions, registerHostActions, unregisterHostAction, clearHostActions, hostActionsModelText, filterVisibleHostActions, } from './host/HostActions';
+export type { HostAction, HostActionKind } from './host/HostActions';
+export { ExplorationGraph, fingerprintFromLabels, goalTokensForExplore, goalExploreQuery, exploreHintsModelText, normalizeExploreLabel, resolveExploreLabelOnScreen, exploreLabelSynonyms, } from './explore/ExplorationGraph';
+export type { ExploreNode, ExploreEdge, ExplorationGraphSnapshot, PathStep, } from './explore/ExplorationGraph';
+export { bootstrapExplore } from './explore/bootstrapExplore';
+export type { BootstrapExploreOptions, BootstrapExploreResult, } from './explore/bootstrapExplore';
+export { find, findAll, findBySoftLabel, flattenTree, centerOf, findNodeById, nodeMatches, } from './selector/match';
+export { executeAgentAction } from './protocol/actions';
+export { isSensitiveLabel, isSensitiveGoal, runConfirmationGate, runPreflightConfirm } from './confirmation/gate';
+export { detectAppUserGate, gateMessage, userGateModelText } from './privacy/userGate';
+export type { AppUserGate, AppUserGateKind } from './privacy/userGate';
+export { AppUserGateStore, setAppUserGate, clearAppUserGate, signalAppUserGateDone, } from './privacy/userGate';
+//# sourceMappingURL=index.d.ts.map

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

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

package/lib/typescript/module/native/NativeBridge.d.ts

@@ -0,0 +1,70 @@
+import type { DumpOptions, Point, ViewNode } from '../types';
+export type ScreenshotOptions = {
+    /** Hide koko-agent-overlay layers before capture (default true). */
+    hideOverlays?: boolean;
+};
+export type ScreenshotResult = {
+    pngBase64: string;
+    width: number;
+    height: number;
+    scale?: number;
+};
+export type RecognizeScreenTextOptions = {
+    /** Hide koko-agent-overlay layers before capture (default true). */
+    hideOverlays?: boolean;
+    /** Max distinct tokens to return (default 24). */
+    maxTokens?: number;
+    /** BCP-47 language hints for Vision OCR (iOS). */
+    languages?: string[];
+};
+export type RecognizeScreenTextResult = {
+    tokens: string[];
+    texts: Array<{
+        text: string;
+        confidence: number;
+        /** Window-absolute logical coordinates when the backend can provide them. */
+        frame?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    }>;
+    /** e.g. vision | stub | unavailable */
+    backend: string;
+};
+export declare const NativeBridge: {
+    isAvailable(): boolean;
+    /** iOS bundle identifier / Android applicationId. Empty when native module is missing. */
+    hostAppId(): string;
+    dump(options?: DumpOptions): Promise<ViewNode>;
+    tap(point: Point): Promise<void>;
+    /** Public capability flags only; never requests account data. */
+    inspectWebWalletProvider(point: Point): Promise<{
+        present: boolean;
+        hasRequest?: boolean;
+        isMetaMask?: boolean;
+        isUKey?: boolean;
+    } | null>;
+    swipe(from: Point, to: Point, durationMs: number): Promise<void>;
+    /**
+     * Two-finger pinch at center. scale>1 zoom in, scale<1 zoom out.
+     * Falls back to error if native build lacks dispatchPinch.
+     */
+    pinch(center: Point, scale: number, durationMs: number): Promise<void>;
+    /** Invoke a presented system alert action by button title. */
+    invokeAlertAction(title: string): Promise<boolean>;
+    typeText(text: string, clear: boolean): Promise<void>;
+    focusNode(nodeId: string): Promise<void>;
+    /** Ensure software keyboard / first responder at a screen point (TextInput). */
+    focusAt(point: Point): Promise<void>;
+    dismissKeyboard(): Promise<void>;
+    scrollIntoView(_point: Point): Promise<void>;
+    screenshot(options?: ScreenshotOptions): Promise<ScreenshotResult>;
+    /**
+     * On-device screen OCR via Vision (iOS) or an opted-in ML Kit host (Android).
+     * Soft-fails to empty tokens when the native method is missing.
+     */
+    recognizeScreenText(options?: RecognizeScreenTextOptions): Promise<RecognizeScreenTextResult>;
+};
+//# sourceMappingURL=NativeBridge.d.ts.map

package/lib/typescript/module/native/NativeBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeBridge.d.ts","sourceRoot":"","sources":["../../../../src/native/NativeBridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAI7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,6EAA6E;QAC7E,KAAK,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACjE,CAAC,CAAC;IACH,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAqCF,eAAO,MAAM,YAAY;mBACR,OAAO;IAItB,0FAA0F;iBAC7E,MAAM;mBAKC,WAAW,GAAQ,OAAO,CAAC,QAAQ,CAAC;eAW7C,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC,iEAAiE;oCAC3B,KAAK;iBA3DyB,OAAO;qBAAe,OAAO;qBAAe,OAAO;iBAAW,OAAO;;gBAiE7H,KAAK,MAAM,KAAK,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE;;;OAGG;kBACW,KAAK,SAAS,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtE,8DAA8D;6BAC/B,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;mBAOzC,MAAM,SAAS,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;sBAInC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,gFAAgF;mBACjE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;uBAIX,OAAO,CAAC,IAAI,CAAC;2BAOT,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;yBAO9B,iBAAiB,GAAQ,OAAO,CAAC,gBAAgB,CAAC;IAMtE;;;OAGG;kCAEQ,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC;CAmCtC,CAAC"}

package/lib/typescript/module/native/navigationLabel.d.ts

@@ -0,0 +1,4 @@
+import type { ViewNode } from '../types';
+/** Explicit semantic navigation IDs, never inferred from icon position alone. */
+export declare function navigationLabel(node: ViewNode): string | undefined;
+//# sourceMappingURL=navigationLabel.d.ts.map

package/lib/typescript/module/native/navigationLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationLabel.d.ts","sourceRoot":"","sources":["../../../../src/native/navigationLabel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAOlE"}

package/lib/typescript/module/native/normalizeViewTree.d.ts

@@ -0,0 +1,4 @@
+import type { ViewNode } from '../types';
+/** NSNumber boolean expressions can arrive as 0/1 through the RN bridge. */
+export declare function normalizeViewTree(node: ViewNode): ViewNode;
+//# sourceMappingURL=normalizeViewTree.d.ts.map

package/lib/typescript/module/native/normalizeViewTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeViewTree.d.ts","sourceRoot":"","sources":["../../../../src/native/normalizeViewTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAW1D"}

package/lib/typescript/module/native/pruneOffscreen.d.ts

@@ -0,0 +1,3 @@
+import type { ViewNode } from '../types';
+export declare function pruneOffscreen(root: ViewNode): ViewNode;
+//# sourceMappingURL=pruneOffscreen.d.ts.map

package/lib/typescript/module/native/pruneOffscreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruneOffscreen.d.ts","sourceRoot":"","sources":["../../../../src/native/pruneOffscreen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,UAAU,CAAC;AAqEhD,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAEvD"}

package/lib/typescript/module/native/scrollViewport.d.ts

@@ -0,0 +1,13 @@
+import type { Frame, Point, ViewNode } from '../types';
+/** Visible scroll regions, clipped by the window and every clipping ancestor. */
+export declare function scrollViewports(root: ViewNode): Array<{
+    node: ViewNode;
+    frame: Frame;
+}>;
+export declare function boundedScrollGesture(frame: Frame, from: Point, to: Point): {
+    from: Point;
+    to: Point;
+};
+/** Position-only evidence: changing prices must not masquerade as scrolling. */
+export declare function scrollPosition(root: ViewNode, from: Point): string | null;
+//# sourceMappingURL=scrollViewport.d.ts.map

package/lib/typescript/module/native/scrollViewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollViewport.d.ts","sourceRoot":"","sources":["../../../../src/native/scrollViewport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AASvD,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,CAWvF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,KAAK,CAAA;CAAE,CAOrG;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAiBzE"}

package/lib/typescript/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/module/privacy/redact.d.ts

@@ -0,0 +1,9 @@
+import type { ViewNode } from '../types';
+/**
+ * Client-side redaction before upload (defense in depth; server also redacts).
+ */
+export declare function redactViewTreeClient(node: ViewNode, maxDepth?: number): ViewNode;
+/** Applies to every outbound field, including OCR/model/history and test IDs. */
+export declare function redactOutbound<T>(value: T, tree?: ViewNode | null | Array<ViewNode | null | undefined>): T;
+export declare function viewTreeOutline(node: ViewNode, maxLines?: number): string;
+//# sourceMappingURL=redact.d.ts.map

package/lib/typescript/module/privacy/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../../src/privacy/redact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC;;GAEG;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,SAAK,GAAG,QAAQ,CAK5E;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CA2B1G;AAmDD,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,SAAM,GAAG,MAAM,CAqBtE"}

package/lib/typescript/module/privacy/screenEvidence.d.ts

@@ -0,0 +1,14 @@
+import type { ViewNode } from '../types';
+/** Shared by local gates and the final upload boundary; never inspect values. */
+export declare const PRIVATE_INPUT_PROMPT_RE: RegExp;
+export declare function isPrivateInput(node: ViewNode): boolean;
+/** Text spoken by a node; test IDs are metadata, never user-facing copy. */
+export declare function nodeLabels(node: ViewNode): string[];
+export declare function isSdkChrome(node: ViewNode): boolean;
+export declare function isSystemSheet(node: ViewNode): boolean;
+/** Static own copy, excluding aggregated ancestors and offered menu actions. */
+export declare function staticScreenLabels(root: ViewNode): Array<{
+    node: ViewNode;
+    label: string;
+}>;
+//# sourceMappingURL=screenEvidence.d.ts.map

package/lib/typescript/module/privacy/screenEvidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenEvidence.d.ts","sourceRoot":"","sources":["../../../../src/privacy/screenEvidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,QAC6U,CAAC;AAElX,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAMtD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAInD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEnD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErD;AAYD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAc3F"}