@intentcomputing/koko-agent-sdk 1.0.1

package/lib/typescript/commonjs/types.d.ts

@@ -0,0 +1,372 @@
+/** Frame in window / screen coordinates (density-independent points). */
+export type Frame = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** One node in the dumped native view tree. */
+export type ViewNode = {
+    /** Stable-enough path for this dump snapshot (e.g. "0/2/1"). */
+    id: string;
+    /** Native class name (UIView / android.view.View subclass). */
+    type: string;
+    frame: Frame;
+    /** Visible text aggregated from this node and text descendants. */
+    text?: string;
+    accessibilityLabel?: string;
+    testID?: string;
+    /** True for secure/password text fields (user must type; agent waits). */
+    secure?: boolean;
+    /** Already-active tab / segment / option — re-tapping it does nothing. */
+    selected?: boolean;
+    /** System alert / action sheet / share / menu surface. */
+    sheet?: boolean;
+    /** UISwitch-like toggle. */
+    toggle?: boolean;
+    on?: boolean;
+    /** Picker / slider / stepper / adjustable control. */
+    adjustable?: boolean;
+    /** Current numeric value when known (slider / stepper / segment index). */
+    value?: number;
+    min?: number;
+    max?: number;
+    clickable: boolean;
+    enabled: boolean;
+    visible: boolean;
+    /** Whether this view can scroll vertically; supplied by the native host. */
+    scrollable?: boolean;
+    /** Descendants are clipped to this view's window-relative bounds. */
+    clipsChildren?: boolean;
+    children: ViewNode[];
+};
+/** Single match rule inside a multi-factor selector. */
+export type MatchRule = {
+    text: string;
+    exact?: boolean;
+} | {
+    nearText: string;
+    exact?: boolean;
+} | {
+    clickable: boolean;
+} | {
+    type: string;
+} | {
+    testID: string;
+} | {
+    accessibilityLabel: string;
+    exact?: boolean;
+} | {
+    region: 'top' | 'bottom' | 'left' | 'right' | 'center';
+    ratio?: number;
+};
+/**
+ * Multi-factor selector (DOM-like).
+ * All `match` rules must pass; `index` picks the N-th among matches.
+ */
+export type Selector = {
+    match: MatchRule[];
+    index?: number;
+};
+export type Point = {
+    x: number;
+    y: number;
+};
+export type TapOptions = {
+    /** Search by scrolling when absent. Planners disable this and choose navigation explicitly. */
+    revealIfNeeded?: boolean;
+    /** Skip cursor animation. */
+    silent?: boolean;
+    /** Cursor move duration ms. */
+    cursorDurationMs?: number;
+};
+export type SwipeOptions = {
+    durationMs?: number;
+    silent?: boolean;
+};
+export type PinchOptions = {
+    /** Finger travel duration ms (default 280). */
+    durationMs?: number;
+    silent?: boolean;
+};
+export type TypeOptions = {
+    clear?: boolean;
+    silent?: boolean;
+};
+/** Sensitive-action confirmation policy. */
+export type ConfirmationPolicy = {
+    /**
+     * When true (default), high-risk goals need a human OK.
+     * Combined with `mode` (default `preflight`).
+     */
+    requireUserConfirm: boolean;
+    /**
+     * - `preflight` (default): ask once before the run; execution is unattended
+     * - `inline`: legacy per-tap confirm (not recommended)
+     * - `off`: never ask
+     */
+    mode?: 'preflight' | 'inline' | 'off';
+    /** Keywords / patterns that trigger the gate (matched against goal / labels). */
+    sensitivePatterns?: RegExp[];
+};
+/** UI language for built-in chrome (chat sheet, dialogs, progress). */
+export type KokoLocale = 'zh' | 'en';
+/**
+ * A light or dark color scheme.
+ *
+ * Where it names the host App's theme (`config.theme`, `setKokoAppearance`),
+ * Koko chrome renders in the opposite one for contrast.
+ */
+export type KokoTheme = 'light' | 'dark';
+/**
+ * Host branding for the built-in chat sheet.
+ * Custom name / icon / tagline / placeholder require plan entitlement `custom_branding`.
+ * Without entitlement, SDK falls back to default Koko branding.
+ */
+export type KokoBrandingConfig = {
+    /** Display name (paid). Default: Koko */
+    name?: string;
+    /**
+     * Brand mark — image URI / require() source, or a short letter shown in the badge.
+     * Custom image/letter beyond default "K" requires `custom_branding`.
+     */
+    icon?: number | {
+        uri: string;
+    } | string;
+    /** Tagline under the name (paid). */
+    tagline?: string;
+    /** Composer placeholder (paid when customized). */
+    placeholder?: string;
+    /** Accent color for badge / send button (paid with branding). */
+    primaryColor?: string;
+};
+/** Plan entitlements returned by gateway `/v1/me`. */
+export type KokoEntitlements = {
+    custom_branding: boolean;
+    locale: boolean;
+};
+export type KokoPlanId = 'free' | 'pro' | 'enterprise';
+export type KokoAccountSnapshot = {
+    plan: KokoPlanId;
+    region?: string;
+    provider?: string;
+    entitlements: KokoEntitlements;
+    quota: {
+        daily: number;
+        used_today: number;
+        remaining: number;
+        /** Present when gateway bills LLM tokens via the account service. */
+        meter?: 'llm_tokens' | 'agent_step';
+        free_monthly?: number;
+        free_used?: number;
+        free_remaining?: number;
+        prepaid_balance?: number;
+    };
+};
+/**
+ * Side-channel usage notifications for host analytics / UX.
+ * Does NOT affect task execution or billing (server is authoritative).
+ */
+export type KokoUsageEvent = {
+    type: 'task_started';
+    taskId?: string;
+    goal: string;
+    at: number;
+} | {
+    type: 'task_finished';
+    taskId?: string;
+    status: 'success' | 'failed' | 'cancelled';
+    steps?: number;
+    at: number;
+} | {
+    type: 'agent_step';
+    sessionId?: string;
+    step?: number;
+    tool?: string;
+    at: number;
+} | {
+    type: 'quota_exceeded';
+    message?: string;
+    quota?: KokoAccountSnapshot['quota'];
+    at: number;
+} | {
+    type: 'sheet_opened' | 'sheet_closed';
+    at: number;
+} | {
+    type: 'branding_downgraded';
+    reason: 'missing_entitlement';
+    at: number;
+};
+export type KokoAgentConfig = {
+    /** Public chooser labels that the host confirms refer to its own injected wallet provider. */
+    webWalletAliases?: string[];
+    /** Called when a sensitive step needs a human confirm. Return true to proceed. */
+    onConfirmSensitive?: (ctx: SensitiveConfirmContext) => Promise<boolean>;
+    confirmation?: ConfirmationPolicy;
+    /**
+     * Max depth when dumping (performance). Must clear the host's real nesting:
+     * RN plus a component library spends 25-35 levels on navigators, safe-area,
+     * gesture and style wrappers before reaching the first button, so a tight cap
+     * silently truncates the page body and leaves the agent only the shallow
+     * chrome around it.
+     */
+    dumpMaxDepth?: number;
+    /** Drop non-visible nodes from dump. */
+    dumpSkipInvisible?: boolean;
+    /** Default cursor animation duration. */
+    cursorDurationMs?: number;
+    /**
+     * Show task subtitle + history panel (default true).
+     * Set false to disable observer chrome / auto logging.
+     */
+    observer?: boolean;
+    /**
+     * Official gateway. Defaults applied in runGoal if omitted:
+     * baseUrl https://sdk.intentcomputing.net — LLM vendor is server-side only.
+     */
+    gateway?: {
+        baseUrl?: string;
+        /** App member token (not an LLM key). */
+        token: string;
+        /**
+         * Host App ID (bundle id / package name). Bound to the API key on the server.
+         * Defaults to the native host App ID when omitted.
+         */
+        appId?: string;
+    };
+    /**
+     * Verbose developer logs: App capabilities / steps the SDK sees.
+     * Does not print security policy details.
+     * Default: on in Metro `__DEV__`; set `false` to silence.
+     * @deprecated `devMode` is an alias for `debug`. Prefer `debug`.
+     */
+    debug?: boolean;
+    /** @deprecated Use `debug`. Same meaning: verbose capability logs only. */
+    devMode?: boolean;
+    /**
+     * Built-in UI language. Default `en` (pass `zh` for Chinese).
+     * Prefer `setKokoAppearance({ locale })` so the host can follow its own setting.
+     */
+    locale?: KokoLocale;
+    /**
+     * The **host App's** theme — not the SDK's. Default `light`.
+     *
+     * Koko chrome paints in the opposite theme so it reads as a separate
+     * surface floating over the App: report `dark` and the pill, chat sheet
+     * and dialogs go light, and vice versa.
+     *
+     * Prefer `setKokoAppearance({ theme })` so chrome follows the host when the
+     * user changes it at runtime.
+     */
+    theme?: KokoTheme;
+    /**
+     * Branding for chat sheet header / placeholder.
+     * Requires lifetime branding license (`custom_branding` from official `/v1/me`).
+     * Soft-enforced in built-in UI only; usage billing is separate (server-side).
+     */
+    branding?: KokoBrandingConfig;
+    /**
+     * Optional host analytics. Never blocks or changes agent execution.
+     */
+    onUsageEvent?: (event: KokoUsageEvent) => void;
+};
+export type SensitiveConfirmContext = {
+    action: string;
+    label?: string;
+    selector?: Selector;
+    node?: ViewNode;
+};
+export type DumpOptions = {
+    maxDepth?: number;
+    skipInvisible?: boolean;
+    /**
+     * Internal observation dump — do not write task log / subtitle.
+     * Use for per-step UI refresh; keep false for explicit agent `dump` tool.
+     */
+    silent?: boolean;
+};
+/** Agent ↔ SDK JSON tool-call protocol (cloud agent side). */
+export type AgentAction = {
+    tool: 'dump';
+    args?: DumpOptions;
+} | {
+    tool: 'find';
+    args: {
+        selector: Selector;
+    };
+} | {
+    tool: 'findAll';
+    args: {
+        selector: Selector;
+    };
+} | {
+    tool: 'tap';
+    args: {
+        selector?: Selector;
+        nodeId?: string;
+        point?: Point;
+        options?: TapOptions;
+    };
+} | {
+    tool: 'swipe';
+    args: {
+        from: Point;
+        to: Point;
+        options?: SwipeOptions;
+    };
+} | {
+    tool: 'pinch';
+    args: {
+        center: Point;
+        scale: number;
+        options?: PinchOptions;
+    };
+} | {
+    tool: 'type';
+    args: {
+        text: string;
+        selector?: Selector;
+        nodeId?: string;
+        options?: TypeOptions;
+    };
+} | {
+    tool: 'confirm';
+    args: {
+        label?: string;
+        action?: string;
+    };
+};
+export type AgentActionResult = {
+    ok: true;
+    tool: 'dump';
+    tree: ViewNode;
+} | {
+    ok: true;
+    tool: 'find';
+    node: ViewNode | null;
+} | {
+    ok: true;
+    tool: 'findAll';
+    nodes: ViewNode[];
+} | {
+    ok: true;
+    tool: 'tap';
+} | {
+    ok: true;
+    tool: 'swipe';
+} | {
+    ok: true;
+    tool: 'pinch';
+} | {
+    ok: true;
+    tool: 'type';
+} | {
+    ok: true;
+    tool: 'confirm';
+    confirmed: boolean;
+} | {
+    ok: false;
+    tool: AgentAction['tool'];
+    error: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/commonjs/types.d.ts.map

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

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

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * Chat sheet: backdrop fades in first, then sheet slides down from the top.
+ */
+export declare function KokoChatSheet({ placeholder }: {
+    placeholder?: string;
+}): React.JSX.Element | null;
+//# sourceMappingURL=KokoChatSheet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KokoChatSheet.d.ts","sourceRoot":"","sources":["../../../../src/ui/KokoChatSheet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AA8GjF;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,WAAW,EAAE,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,4BAmhBtE"}

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

@@ -0,0 +1,13 @@
+import React from 'react';
+export type KokoComposerProps = {
+    /** Placeholder for the natural-language input. */
+    placeholder?: string;
+    /** Disable while true (in addition to running task). */
+    disabled?: boolean;
+};
+/**
+ * Natural-language dialog (需求 §1.1 / §3.5):
+ * 用户自由输入一句话 → 云端 Agent → 本 App 内 dump/find/tap，字幕与任务可观测。
+ */
+export declare function KokoComposer({ placeholder, disabled, }: KokoComposerProps): React.JSX.Element;
+//# sourceMappingURL=KokoComposer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KokoComposer.d.ts","sourceRoot":"","sources":["../../../../src/ui/KokoComposer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAgC,MAAM,OAAO,CAAC;AAerD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,WAAW,EACX,QAAgB,GACjB,EAAE,iBAAiB,qBA0FnB"}

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

@@ -0,0 +1,32 @@
+import React from 'react';
+export type ConfirmRequest = {
+    id: string;
+    title: string;
+    message: string;
+    resolve: (ok: boolean) => void;
+};
+export type AskRequest = {
+    id: string;
+    question: string;
+    resolve: (answer: string | null) => void;
+};
+type Listener = (state: {
+    confirm: ConfirmRequest | null;
+    ask: AskRequest | null;
+}) => void;
+declare class DialogBusImpl {
+    confirm: ConfirmRequest | null;
+    ask: AskRequest | null;
+    private listeners;
+    subscribe(l: Listener): () => void;
+    private emit;
+    requestConfirm(title: string, message: string): Promise<boolean>;
+    requestAsk(question: string): Promise<string | null>;
+}
+export declare const DialogBus: DialogBusImpl;
+/**
+ * Built-in confirm + ask-user modal. Mounted by KokoProvider.
+ */
+export declare function KokoDialogHost(): React.JSX.Element;
+export {};
+//# sourceMappingURL=KokoDialogHost.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KokoDialogHost.d.ts","sourceRoot":"","sources":["../../../../src/ui/KokoDialogHost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAYhE,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1C,CAAC;AAEF,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE,KAAK,IAAI,CAAC;AAE5F,cAAM,aAAa;IACjB,OAAO,EAAE,cAAc,GAAG,IAAI,CAAQ;IACtC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAQ;IAC9B,OAAO,CAAC,SAAS,CAAuB;IAExC,SAAS,CAAC,CAAC,EAAE,QAAQ;IAQrB,OAAO,CAAC,IAAI;IAIZ,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBhE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAcrD;AAED,eAAO,MAAM,SAAS,eAAsB,CAAC;AAE7C;;GAEG;AACH,wBAAgB,cAAc,sBAyG7B"}

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

@@ -0,0 +1,18 @@
+import React from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+export type KokoEntryButtonProps = {
+    label?: string;
+    style?: StyleProp<ViewStyle>;
+};
+/**
+ * Demo convenience button. Production hosts should draw their own entry UI
+ * and call `openKokoChat()` / `agent.openChat()`.
+ *
+ * Marked as overlay so dump/tap skip it — otherwise the agent mistakes it for
+ * an in-app control near bottom tabs (e.g. 我的).
+ */
+export declare function KokoEntryButton({ label, style, }: KokoEntryButtonProps): React.JSX.Element;
+/** Imperative open for custom host buttons (preferred). */
+export declare function openKokoChat(taskId?: string | null): void;
+export declare function closeKokoChat(): void;
+//# sourceMappingURL=KokoEntryButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KokoEntryButton.d.ts","sourceRoot":"","sources":["../../../../src/ui/KokoEntryButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAA+B,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAK3F,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAc,EACd,KAAK,GACN,EAAE,oBAAoB,qBAsBtB;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,QAElD;AAED,wBAAgB,aAAa,SAE5B"}

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

@@ -0,0 +1,13 @@
+import React from 'react';
+export type KokoObserverProps = {
+    /** @deprecated Prefer config.branding.placeholder */
+    composerPlaceholder?: string;
+    /** Draw agent cursor in the same overlay Modal (default true). */
+    cursor?: boolean;
+};
+/**
+ * Progress pill + stop (+ optional cursor) in one host overlay Modal.
+ * After a run ends, shows an animated success/fail icon then auto-dismisses.
+ */
+export declare function KokoObserver({ composerPlaceholder, cursor, }: KokoObserverProps): React.JSX.Element;
+//# sourceMappingURL=KokoObserver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KokoObserver.d.ts","sourceRoot":"","sources":["../../../../src/ui/KokoObserver.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAuCjF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,qDAAqD;IACrD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,mBAAmB,EACnB,MAAa,GACd,EAAE,iBAAiB,qBAwWnB"}

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

@@ -0,0 +1,35 @@
+import React, { type ReactNode } from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+/** Native dump / tap / screenshot skip views whose testID starts with this. */
+export declare const KOKO_OVERLAY_TEST_ID = "koko-agent-overlay";
+/** Cursor layer — skipped in dump, but NOT hidden during tap (must stay visible). */
+export declare const KOKO_CURSOR_TEST_ID = "koko-agent-cursor";
+export type KokoOverlayLayerProps = {
+    children: ReactNode;
+    style?: StyleProp<ViewStyle>;
+    /**
+     * `box-none` (default): children receive touches; empty area passes through.
+     * `none`: entire layer ignores touches (cursor).
+     * `auto`: layer blocks (modal sheet content).
+     */
+    pointerEvents?: 'box-none' | 'none' | 'auto' | 'box-only';
+    /** Override testID / nativeID (default: koko-agent-overlay). */
+    testID?: string;
+};
+/**
+ * Host for SDK chrome (progress / cursor / sheet / dialogs).
+ * Marked so native dump & agent taps can ignore / pierce this layer.
+ */
+export declare function KokoOverlayLayer({ children, style, pointerEvents, testID, }: KokoOverlayLayerProps): React.JSX.Element;
+export declare const overlayFill: {
+    fill: {
+        zIndex: number;
+        elevation: number;
+        position: "absolute";
+        left: 0;
+        right: 0;
+        top: 0;
+        bottom: 0;
+    };
+};
+//# sourceMappingURL=KokoOverlayLayer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KokoOverlayLayer.d.ts","sourceRoot":"","sources":["../../../../src/ui/KokoOverlayLayer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhF,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1D,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,KAAK,EACL,aAA0B,EAC1B,MAA6B,GAC9B,EAAE,qBAAqB,qBAcvB;AAED,eAAO,MAAM,WAAW;;;;;;;;;;CAMtB,CAAC"}

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

@@ -0,0 +1,7 @@
+import React from 'react';
+/**
+ * Karaoke-style subtitle for the current task action.
+ * Prefer KokoObserver progress pill in the default UX; kept for custom layouts.
+ */
+export declare function KokoSubtitle(): React.JSX.Element | null;
+//# sourceMappingURL=KokoSubtitle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KokoSubtitle.d.ts","sourceRoot":"","sources":["../../../../src/ui/KokoSubtitle.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAIjD;;;GAGG;AACH,wBAAgB,YAAY,6BAuC3B"}

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

@@ -0,0 +1,7 @@
+import React from 'react';
+/**
+ * @deprecated Prefer KokoChatSheet via KokoObserver / KokoEntryButton.
+ * Legacy inline task list; maps to sheetOpen for expand/collapse.
+ */
+export declare function KokoTaskPanel(): React.JSX.Element | null;
+//# sourceMappingURL=KokoTaskPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KokoTaskPanel.d.ts","sourceRoot":"","sources":["../../../../src/ui/KokoTaskPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAmFvC;;;GAGG;AACH,wBAAgB,aAAa,6BAiE5B"}

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

@@ -0,0 +1,28 @@
+import React, { type ReactNode } from 'react';
+import { type ViewStyle } from 'react-native';
+type OverlayProps = {
+    children: ReactNode;
+    /** Remount / bring-to-front token (host FullWindowOverlay). */
+    liftToken?: number;
+    style?: ViewStyle;
+};
+/**
+ * Host chrome above native Settings / stack modals.
+ *
+ * Prefer FullWindowOverlay: it adds a view to the window rather than presenting
+ * a view controller, so `pointerEvents="box-none"` lets the user keep using the
+ * App underneath while a task runs. An RN Modal is its own iOS window and
+ * swallows every touch that is not aimed at the chrome itself — the agent does
+ * not notice, because the native tap skips Koko chrome windows, but the user
+ * cannot tap anything until the task ends.
+ *
+ * Modal stays as the fallback for hosts without react-native-screens, and
+ * `forceModalOverlay` keeps it reachable if a host needs it.
+ */
+export declare function KokoHostOverlay({ children, liftToken, style, forceModalOverlay, }: OverlayProps & {
+    forceModalOverlay?: boolean;
+}): React.JSX.Element;
+/** Whether this build can pierce native-stack modals via screens overlay. */
+export declare function kokoHostOverlayUsesScreens(): boolean;
+export {};
+//# sourceMappingURL=hostOverlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hostOverlay.d.ts","sourceRoot":"","sources":["../../../../src/ui/hostOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAGtB,KAAK,YAAY,GAAG;IAClB,QAAQ,EAAE,SAAS,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AA0BF;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,SAAa,EACb,KAAK,EACL,iBAAyB,GAC1B,EAAE,YAAY,GAAG;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,qBAkEhD;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD"}

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

@@ -0,0 +1,26 @@
+import React from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+/** Minimal vector-less icons for SDK UI (no icon font dependency). */
+export declare function IconClose({ color, size, style, }: {
+    color?: string;
+    size?: number;
+    style?: StyleProp<ViewStyle>;
+}): React.JSX.Element;
+export declare function IconStop({ color, size, style, }: {
+    color?: string;
+    size?: number;
+    style?: StyleProp<ViewStyle>;
+}): React.JSX.Element;
+/** Checkmark (two bars) for success result. */
+export declare function IconCheck({ color, size, style, }: {
+    color?: string;
+    size?: number;
+    style?: StyleProp<ViewStyle>;
+}): React.JSX.Element;
+/** Horizontal dash for cancelled. */
+export declare function IconDash({ color, size, style, }: {
+    color?: string;
+    size?: number;
+    style?: StyleProp<ViewStyle>;
+}): React.JSX.Element;
+//# sourceMappingURL=icons.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../../src/ui/icons.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhF,sEAAsE;AAEtE,wBAAgB,SAAS,CAAC,EACxB,KAAgC,EAChC,IAAS,EACT,KAAK,GACN,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,qBA8BA;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAc,EACd,IAAS,EACT,KAAK,GACN,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,qBAeA;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,EACxB,KAAc,EACd,IAAS,EACT,KAAK,GACN,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,qBA8BA;AAED,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,EACvB,KAAc,EACd,IAAS,EACT,KAAK,GACN,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,qBAgBA"}

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

@@ -0,0 +1,21 @@
+import type { Point } from '../types';
+export type ChromeRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export declare function setProgressChromeFrame(rect: ChromeRect | null): void;
+export declare function getProgressChromeFrame(): ChromeRect | null;
+/**
+ * Clearance rect = where the chrome actually is, padded for hitSlop.
+ *
+ * Follows the chrome once the user drags it; the fixed bottom-right band is
+ * only a guess for before the first measurement lands. Blanketing the corner
+ * regardless would both hide host controls the chrome has been moved off of
+ * and keep swallowing tab-bar centres that were never covered.
+ */
+export declare function getChromeClearanceRect(): ChromeRect;
+export declare function pointOverlapsProgressChrome(point: Point, pad?: number): boolean;
+export declare function pointsOverlapProgressChrome(points: Point[], pad?: number): boolean;
+//# sourceMappingURL=progressChrome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progressChrome.d.ts","sourceRoot":"","sources":["../../../../src/ui/progressChrome.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAKF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,QAE7D;AAED,wBAAgB,sBAAsB,IAAI,UAAU,GAAG,IAAI,CAE1D;AAkBD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,UAAU,CAUnD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,SAAK,GAAG,OAAO,CAQ3E;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,KAAK,EAAE,EACf,GAAG,SAAK,GACP,OAAO,CAET"}

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

@@ -0,0 +1,12 @@
+export type SafeAreaInsets = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+/**
+ * Optional safe-area without requiring react-native-safe-area-context as peer.
+ * Prefers live context → native initial metrics → platform heuristics (Modal-safe).
+ */
+export declare function useSafeAreaInsetsOptional(): SafeAreaInsets;
+//# sourceMappingURL=safeArea.d.ts.map