@intentcomputing/koko-agent-sdk 1.0.1

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

@@ -0,0 +1,26 @@
+import type { ViewNode } from '../types';
+export type AffordanceKind = 'button' | 'tab' | 'field' | 'row' | 'link' | 'sheet' | 'toggle' | 'adjustable' | 'other';
+export type Affordance = {
+    kind: AffordanceKind;
+    /** Primary human label (text or a11y). */
+    label: string;
+    nodeId: string;
+    /** Nearby list/row context if any. */
+    near?: string;
+    clickable: boolean;
+    /** Already-active tab / segment / option — re-tapping it is a no-op. */
+    selected?: boolean;
+};
+/**
+ * Semantic screen model for the planner — "what can this screen do?"
+ * Collects all candidates then keeps the highest-priority ones so bottom
+ * navigation is not crowded out by long product lists.
+ */
+export declare function extractAffordances(root: ViewNode, max?: number): Affordance[];
+/** Read-only page copy is state too: wizard steps may reuse every button. */
+export declare function readablePageContent(root: ViewNode, max?: number): string[];
+/** Compact text for LLM context (token-friendly). */
+export declare function screenModelText(root: ViewNode, max?: number, hostExtra?: string): string;
+/** One-line snapshot for history feedback after an action. */
+export declare function screenSnapshotLine(root: ViewNode, max?: number): string;
+//# sourceMappingURL=screenModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screenModel.d.ts","sourceRoot":"","sources":["../../../../src/privacy/screenModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAMzC,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,KAAK,GACL,OAAO,GACP,KAAK,GACL,MAAM,GACN,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,OAAO,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AA8MF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAK,GAAG,UAAU,EAAE,CA4LzE;AAaD,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAK,GAAG,MAAM,EAAE,CAiBtE;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,GAAG,SAAK,EACR,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CA8BR;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAK,GAAG,MAAM,CAMnE"}

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

@@ -0,0 +1,8 @@
+import type { ViewNode } from '../types';
+export type SensitiveScreenKind = 'password' | 'recovery_phrase' | 'private_key';
+/** Local-only classification. Never return a field value or mnemonic word. */
+export declare function sensitiveScreenKind(root: ViewNode | null | undefined): SensitiveScreenKind | null;
+export declare class SensitiveScreenError extends Error {
+    constructor();
+}
+//# sourceMappingURL=sensitiveScreen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sensitiveScreen.d.ts","sourceRoot":"","sources":["../../../../src/privacy/sensitiveScreen.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAEjF,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,mBAAmB,GAAG,IAAI,CAwCjG;AAED,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C"}

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

@@ -0,0 +1,58 @@
+import type { ViewNode } from '../types';
+/**
+ * Sensitive steps the agent must NOT automate:
+ * user completes them in the App (or system UI), then the run resumes.
+ */
+export type AppUserGateKind = 'recovery_phrase' | 'private_key' | 'password' | 'pin' | 'otp' | 'secure_input'
+/** OAuth / social login / hardware pairing / dApp connect — user must authorize. */
+ | 'authorization'
+/** Face ID / Touch ID / fingerprint. */
+ | 'biometric'
+/** System permission sheets (camera, Bluetooth, photos, …). */
+ | 'permission'
+/** Explicit consent / legal / seed reveal confirmation the user must do. */
+ | 'consent';
+export type AppUserGate = {
+    kind: AppUserGateKind;
+    label: string;
+    nodeId: string;
+};
+type Listener = (gate: AppUserGate | null) => void;
+/**
+ * Host-declared sensitive gate (passcode / OAuth / permissions…).
+ * Preferred when Fabric dump misses the real controls.
+ */
+declare class AppUserGateStoreImpl {
+    private hostGate;
+    /** User tapped「已完成」— clears until host sets a new gate. */
+    private manualResumeAt;
+    private listeners;
+    setHostGate(gate: AppUserGate | null): void;
+    /** User confirms they finished the sensitive App / system step. */
+    signalDone(): void;
+    /** Recheck only: the UI must not clear a host-declared private step. */
+    requestCheck(): void;
+    getHostGate(): AppUserGate | null;
+    wasManuallyResumedSince(sinceMs: number): boolean;
+    subscribe(listener: Listener): () => void;
+    private emit;
+}
+export declare const AppUserGateStore: AppUserGateStoreImpl;
+/** Host: current screen needs the user to finish a sensitive step. */
+export declare function setAppUserGate(gate: Omit<AppUserGate, 'nodeId'> & {
+    nodeId?: string;
+}): void;
+export declare function clearAppUserGate(): void;
+export declare function signalAppUserGateDone(): void;
+export declare function signalAppUserGateCheck(): void;
+/**
+ * Detect App / system steps the user must complete themselves.
+ * Merges host registration with dump heuristics.
+ */
+export declare function detectAppUserGate(root: ViewNode | null | undefined): AppUserGate | null;
+export declare function gateMessageValue(gate: AppUserGate, fallbackLocale?: string): import("../i18n").LocalizedMessage;
+export declare function gateMessage(gate: AppUserGate): string;
+/** Planner hint — never type secrets or fake authorizations. */
+export declare function userGateModelText(gate: AppUserGate | null): string;
+export {};
+//# sourceMappingURL=userGate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"userGate.d.ts","sourceRoot":"","sources":["../../../../src/privacy/userGate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAIzC;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,aAAa,GACb,UAAU,GACV,KAAK,GACL,KAAK,GACL,cAAc;AAChB,oFAAoF;GAClF,eAAe;AACjB,wCAAwC;GACtC,WAAW;AACb,+DAA+D;GAC7D,YAAY;AACd,4EAA4E;GAC1E,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAiCF,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;AAEnD;;;GAGG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,QAAQ,CAA4B;IAC5C,2DAA2D;IAC3D,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAuB;IAExC,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAYpC,mEAAmE;IACnE,UAAU;IAMV,wEAAwE;IACxE,YAAY;IAKZ,WAAW,IAAI,WAAW,GAAG,IAAI;IAIjC,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIjD,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAMzC,OAAO,CAAC,IAAI;CAGb;AAED,eAAO,MAAM,gBAAgB,sBAA6B,CAAC;AAE3D,sEAAsE;AACtE,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,QAOxD;AAED,wBAAgB,gBAAgB,SAE/B;AAED,wBAAgB,qBAAqB,SAEpC;AAED,wBAAgB,sBAAsB,SAErC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAChC,WAAW,GAAG,IAAI,CA+DpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,sCAQ1E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAErD;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,CAGlE"}

package/lib/typescript/module/protocol/actions.d.ts

@@ -0,0 +1,7 @@
+import type { KokoAgent } from '../KokoAgent';
+import type { AgentAction, AgentActionResult } from '../types';
+/**
+ * Execute one cloud-agent tool call against the local SDK.
+ */
+export declare function executeAgentAction(agent: KokoAgent, action: AgentAction): Promise<AgentActionResult>;
+//# sourceMappingURL=actions.d.ts.map

package/lib/typescript/module/protocol/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../src/protocol/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE/D;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAwD5B"}

package/lib/typescript/module/provider/HostAppearanceStore.d.ts

@@ -0,0 +1,64 @@
+import type { KokoLocale } from '../types';
+export type KokoTheme = 'light' | 'dark';
+export type KokoAppearance = {
+    locale?: string | null;
+    /**
+     * The **host App's** theme, not the SDK's.
+     *
+     * Koko chrome floats on top of the host UI, so it renders in the opposite
+     * theme: a pill in the App's own colors disappears into the screen behind
+     * it. Report what the App is using and the SDK picks the contrasting side.
+     */
+    theme?: KokoTheme | null;
+};
+type Listener = () => void;
+/**
+ * Runtime host appearance (locale / theme). Prefer this over static
+ * `config.locale` / `config.theme` so the host can follow its own settings.
+ */
+declare class HostAppearanceStoreImpl {
+    private state;
+    private listeners;
+    get(): KokoAppearance;
+    set(partial: KokoAppearance): void;
+    subscribe(listener: Listener): () => void;
+}
+export declare const HostAppearanceStore: HostAppearanceStoreImpl;
+/** Imperative API for hosts (OneKey / shop / etc.). */
+export declare function setKokoAppearance(partial: KokoAppearance): void;
+export declare function getKokoAppearance(): KokoAppearance;
+export type KokoThemeColors = {
+    mode: KokoTheme;
+    sheetBg: string;
+    overlay: string;
+    text: string;
+    textSecondary: string;
+    textMuted: string;
+    border: string;
+    inputBg: string;
+    chipBg: string;
+    userBubble: string;
+    handle: string;
+    progressBg: string;
+    progressText: string;
+    dialogBg: string;
+    statusBar: 'light-content' | 'dark-content';
+};
+export declare function resolveThemeColors(theme?: KokoTheme | null): KokoThemeColors;
+/**
+ * Theme for Koko chrome, given the host App's theme.
+ *
+ * Inverted on purpose: the progress pill, chat sheet and dialogs sit above the
+ * host UI as a distinct surface. Matching the App makes them blend into
+ * whatever is behind them; opposing it keeps the boundary obvious.
+ *
+ * A host that reports nothing is assumed light, which keeps chrome dark — the
+ * SDK's long-standing default.
+ */
+export declare function invertTheme(appTheme?: KokoTheme | null): KokoTheme;
+/** Chrome colors for a host App running `appTheme`. */
+export declare function resolveChromeColors(appTheme?: KokoTheme | null): KokoThemeColors;
+/** Resolve effective locale: host appearance → config → en. */
+export declare function resolveEffectiveLocale(hostLocale: string | null | undefined, configLocale: KokoLocale | string | null | undefined): string | null | undefined;
+export {};
+//# sourceMappingURL=HostAppearanceStore.d.ts.map

package/lib/typescript/module/provider/HostAppearanceStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostAppearanceStore.d.ts","sourceRoot":"","sources":["../../../../src/provider/HostAppearanceStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;GAGG;AACH,cAAM,uBAAuB;IAC3B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,SAAS,CAAuB;IAExC,GAAG,IAAI,cAAc;IAIrB,GAAG,CAAC,OAAO,EAAE,cAAc;IAa3B,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;CAM1C;AAED,eAAO,MAAM,mBAAmB,yBAAgC,CAAC;AAEjE,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,QAExD;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,eAAe,GAAG,cAAc,CAAC;CAC7C,CAAC;AAsCF,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,eAAe,CAE5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAElE;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CACjC,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI,GAC1B,eAAe,CAEjB;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,YAAY,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACnD,MAAM,GAAG,IAAI,GAAG,SAAS,CAE3B"}

package/lib/typescript/module/provider/KokoProvider.d.ts

@@ -0,0 +1,39 @@
+import React, { type ReactNode } from 'react';
+import { type KokoAgent } from '../KokoAgent';
+import type { KokoAgentConfig } from '../types';
+export type KokoProviderProps = {
+    children: ReactNode;
+    config?: KokoAgentConfig;
+    /** Show cursor overlay (default true). */
+    cursor?: boolean;
+    /**
+     * Progress pill (running only) + chat sheet host (default true).
+     * Idle = nothing visible; open via openKokoChat() from host UI.
+     */
+    observer?: boolean;
+    /**
+     * @deprecated Prefer `config.branding.placeholder` (paid entitlement) or locale defaults.
+     */
+    composerPlaceholder?: string;
+    /** Built-in confirm / ask-user dialogs (default true). */
+    dialogs?: boolean;
+    /**
+     * DEV remote smoke driver port (poll `127.0.0.1:<port>/cmd`).
+     * Host-agnostic; omit / 0 to disable.
+     */
+    remoteSmokePort?: number;
+    /**
+     * Resume a goal that a JS-context restart interrupted (default true).
+     *
+     * Actions like changing locale or theme can remount the RN root, which kills
+     * the run performing them. When that happens the SDK picks the goal back up
+     * on the next init and lets the planner finish it from the current screen.
+     *
+     * This means the agent can act shortly after launch without a fresh user
+     * request. Set false if a host would rather drop interrupted runs.
+     */
+    resumeAfterReload?: boolean;
+};
+export declare function KokoProvider({ children, config, cursor, observer, composerPlaceholder, dialogs, remoteSmokePort, resumeAfterReload, }: KokoProviderProps): React.JSX.Element;
+export declare function useKokoAgent(): KokoAgent;
+//# sourceMappingURL=KokoProvider.d.ts.map

package/lib/typescript/module/provider/KokoProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KokoProvider.d.ts","sourceRoot":"","sources":["../../../../src/provider/KokoProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAMZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAQhD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,MAAM,EACN,MAAa,EACb,QAAQ,EACR,mBAAmB,EACnB,OAAc,EACd,eAAe,EACf,iBAAwB,GACzB,EAAE,iBAAiB,qBA8CnB;AAED,wBAAgB,YAAY,IAAI,SAAS,CAGxC"}

package/lib/typescript/module/provider/KokoUiContext.d.ts

@@ -0,0 +1,22 @@
+import React, { type ReactNode } from 'react';
+import type { KokoAccountSnapshot, KokoAgentConfig, KokoLocale, KokoTheme } from '../types';
+import { type ResolvedBranding } from '../commercial/branding';
+import { type MessageKey } from '../i18n';
+import { type KokoThemeColors } from './HostAppearanceStore';
+export type KokoUiContextValue = {
+    locale: KokoLocale;
+    /** Theme Koko chrome paints in — the inverse of `appTheme`. */
+    theme: KokoTheme;
+    /** What the host App itself is running, as reported by the host. */
+    appTheme: KokoTheme;
+    colors: KokoThemeColors;
+    branding: ResolvedBranding;
+    account: KokoAccountSnapshot | null;
+    t: (key: MessageKey, vars?: Record<string, string | number>) => string;
+};
+export declare function KokoUiProvider({ config, children, }: {
+    config?: KokoAgentConfig;
+    children: ReactNode;
+}): React.JSX.Element;
+export declare function useKokoUi(): KokoUiContextValue;
+//# sourceMappingURL=KokoUiContext.d.ts.map

package/lib/typescript/module/provider/KokoUiContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KokoUiContext.d.ts","sourceRoot":"","sources":["../../../../src/provider/KokoUiContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAMZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EAEf,UAAU,EACV,SAAS,EACV,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,+DAA+D;IAC/D,KAAK,EAAE,SAAS,CAAC;IACjB,oEAAoE;IACpE,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;CACxE,CAAC;AAoBF,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB,qBA4EA;AAED,wBAAgB,SAAS,IAAI,kBAAkB,CAiB9C"}

package/lib/typescript/module/selector/match.d.ts

@@ -0,0 +1,27 @@
+import type { Selector, ViewNode } from '../types';
+/** Loose label match: substring either way, soft filler strip, small edit distance. */
+export declare function textMatches(haystack: string | undefined, needle: string, exact?: boolean): boolean;
+export declare function flattenTree(root: ViewNode): ViewNode[];
+export declare function findNodeById(root: ViewNode, id: string): ViewNode | null;
+export declare function nodeMatches(node: ViewNode, selector: Selector, root: ViewNode): boolean;
+export declare function findAll(root: ViewNode, selector: Selector): ViewNode[];
+export declare function find(root: ViewNode, selector: Selector, options?: {
+    preferNonInput?: boolean;
+}): ViewNode | null;
+/**
+ * Last-resort: find best interactive node whose visible text soft-matches needle.
+ * Used when the planner invents near-synonym copy not present verbatim.
+ */
+export declare function findBySoftLabel(root: ViewNode, needle: string, options?: {
+    preferNonInput?: boolean;
+}): ViewNode | null;
+/** Keep a broad actionable container from centering between adjacent controls. */
+export declare function centerOfLabel(node: ViewNode, label?: string): {
+    x: number;
+    y: number;
+};
+export declare function centerOf(node: ViewNode): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=match.d.ts.map

package/lib/typescript/module/selector/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../../../src/selector/match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAiFrE,uFAAuF;AACvF,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CA+CT;AA0DD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAQtD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAOxE;AAwCD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAIvF;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAEtE;AAgCD,wBAAgB,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,QAAQ,GAAG,IAAI,CA0ChH;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,QAAQ,GAAG,IAAI,CA4BvH;AAkCD,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAUtF;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAKjE"}

package/lib/typescript/module/task/TaskStore.d.ts

@@ -0,0 +1,65 @@
+import type { ObserverUiState, Task, TaskNode, TaskNodeKind, TaskNodeStatus, TaskStatus, TaskStoreSnapshot } from './types';
+import { type LocalizedText } from '../i18n';
+type Listener = (snap: TaskStoreSnapshot) => void;
+/**
+ * In-memory task + node history for the observer UI.
+ */
+export declare class TaskStoreImpl {
+    private tasks;
+    private activeTaskId;
+    private resultFlash;
+    private userGateWaiting;
+    private localizedTitles;
+    private localizedTaskTitles;
+    private localizedResult;
+    private unsubscribeAppearance;
+    private appearanceChanged;
+    private lastChromeLiftAt;
+    private ui;
+    private listeners;
+    subscribe(listener: Listener): () => void;
+    snapshot(): TaskStoreSnapshot;
+    private emit;
+    private computeSubtitle;
+    /** Pause chrome copy while waiting for App password/PIN/OTP. */
+    setUserGateWaiting(message: LocalizedText | null): void;
+    setUi(patch: Partial<ObserverUiState>): void;
+    /** Open chat sheet (history + input). */
+    openSheet(taskId?: string | null): void;
+    closeSheet(): void;
+    toggleSheet(): void;
+    /** Hide progress chrome for one agent gesture that would hit it. */
+    suppressChrome(): void;
+    restoreChrome(): void;
+    /**
+     * Remount progress Modal so it stacks above a host Settings/sheet Modal.
+     * Throttled to avoid flicker during rapid taps.
+     */
+    liftChrome(): void;
+    /** @deprecated use closeSheet */
+    hide(): void;
+    /** @deprecated use openSheet */
+    show(): void;
+    selectTask(taskId: string | null): void;
+    /** Remove a task from recent history (and clear selection if needed). */
+    removeTask(taskId: string): void;
+    startTask(title: string): Task;
+    ensureActiveTask(fallbackTitle?: string): string;
+    appendNode(input: {
+        kind: TaskNodeKind;
+        title: LocalizedText;
+        detail?: string;
+        status?: TaskNodeStatus;
+        taskId?: string;
+    }): TaskNode;
+    updateNode(nodeId: string, patch: Partial<Pick<TaskNode, 'detail' | 'status'>> & {
+        title?: LocalizedText;
+    }): void;
+    finishTask(status: Exclude<TaskStatus, 'running'>, taskId?: string, summary?: LocalizedText): void;
+    /** Clear the post-run result pill (after auto-dismiss). */
+    clearResultFlash(): void;
+    clear(): void;
+}
+export declare const TaskStore: TaskStoreImpl;
+export {};
+//# sourceMappingURL=TaskStore.d.ts.map

package/lib/typescript/module/task/TaskStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskStore.d.ts","sourceRoot":"","sources":["../../../../src/task/TaskStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,UAAU,EACV,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAqC,KAAK,aAAa,EAAyB,MAAM,SAAS,CAAC;AAEvG,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAQlD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,mBAAmB,CAAuC;IAClE,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,EAAE,CAKR;IACF,OAAO,CAAC,SAAS,CAAuB;IAExC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAqBzC,QAAQ,IAAI,iBAAiB;IAqB7B,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,eAAe;IAiBvB,gEAAgE;IAChE,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAMhD,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC;IAKrC,yCAAyC;IACzC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAYhC,UAAU;IAQV,WAAW;IAKX,oEAAoE;IACpE,cAAc;IAKd,aAAa;IAKb;;;OAGG;IACH,UAAU;IAOV,iCAAiC;IACjC,IAAI;IAIJ,gCAAgC;IAChC,IAAI;IAIJ,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOhC,yEAAyE;IACzE,UAAU,CAAC,MAAM,EAAE,MAAM;IAmBzB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAgC9B,gBAAgB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM;IAgBhD,UAAU,CAAC,KAAK,EAAE;QAChB,IAAI,EAAE,YAAY,CAAC;QACnB,KAAK,EAAE,aAAa,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,cAAc,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,QAAQ;IA4BZ,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,aAAa,CAAA;KAAE;IA2B1G,UAAU,CACR,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,EACtC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa;IA2CzB,2DAA2D;IAC3D,gBAAgB;IAMhB,KAAK;CAiBN;AAED,eAAO,MAAM,SAAS,eAAsB,CAAC"}

package/lib/typescript/module/task/types.d.ts

@@ -0,0 +1,66 @@
+export type TaskStatus = 'running' | 'success' | 'failed' | 'cancelled';
+export type TaskNodeKind = 'user' | 'plan' | 'dump' | 'find' | 'tap' | 'swipe' | 'type' | 'confirm' | 'info' | 'error';
+export type TaskNodeStatus = 'pending' | 'running' | 'done' | 'failed' | 'skipped';
+/** One step / log line inside a task session. */
+export type TaskNode = {
+    id: string;
+    kind: TaskNodeKind;
+    /** Subtitle / human-readable line. */
+    title: string;
+    detail?: string;
+    status: TaskNodeStatus;
+    createdAt: number;
+    finishedAt?: number;
+};
+/** One user intent / agent run. */
+export type Task = {
+    id: string;
+    /** User utterance or short goal. */
+    title: string;
+    status: TaskStatus;
+    createdAt: number;
+    updatedAt: number;
+    finishedAt?: number;
+    nodes: TaskNode[];
+};
+export type ObserverUiState = {
+    /**
+     * Chat sheet open: session history + NL input.
+     * Closed by default; opened via progress pill or host entry button.
+     */
+    sheetOpen: boolean;
+    /** Selected task for session detail; null → latest / active. */
+    selectedTaskId: string | null;
+    /**
+     * Temporarily hide progress pill + stop while an agent tap/swipe
+     * would hit the same screen region (e.g. bottom tab / cart).
+     */
+    chromeSuppressed: boolean;
+    /**
+     * Bumped to remount progress Modal above a newly presented host modal
+     * (e.g. Settings). Latest RN Modal wins the window stack.
+     */
+    chromeEpoch: number;
+};
+/** Brief success/failure line shown on the progress pill after a run ends. */
+export type ProgressResultFlash = {
+    status: Exclude<TaskStatus, 'running'>;
+    message: string;
+    taskId: string;
+    at: number;
+};
+export type TaskStoreSnapshot = {
+    tasks: Task[];
+    activeTaskId: string | null;
+    /** Current progress line while a task is running. */
+    subtitle: string | null;
+    /** Post-run result pill; cleared by UI after auto-dismiss. */
+    resultFlash: ProgressResultFlash | null;
+    /**
+     * Secure-input wait: non-null while agent paused for password/PIN/OTP.
+     * UI shows banner +「我已完成」.
+     */
+    userGateWaiting: string | null;
+    ui: ObserverUiState;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/task/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/task/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAExE,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,GACL,OAAO,GACP,MAAM,GACN,SAAS,GACT,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnF,iDAAiD;AACjD,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,mCAAmC;AACnC,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8DAA8D;IAC9D,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC;;;OAGG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,EAAE,EAAE,eAAe,CAAC;CACrB,CAAC"}

package/lib/typescript/module/task/useTaskStore.d.ts

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

package/lib/typescript/module/task/useTaskStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTaskStore.d.ts","sourceRoot":"","sources":["../../../../src/task/useTaskStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,wBAAgB,YAAY,IAAI,iBAAiB,CAIhD"}