@intentcomputing/koko-agent-sdk 1.0.1

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

@@ -0,0 +1,57 @@
+/**
+ * Survive a JS-context restart mid-run.
+ *
+ * Some actions destroy the runtime that is performing them: changing locale or
+ * theme, toggling RTL, flipping a feature flag, anything the host answers with
+ * a root remount or `reloadAsync`. The tap succeeds, the App comes back — but
+ * the `runGoal` promise, its session and the whole TaskStore died with the old
+ * context, so the caller can never learn the outcome.
+ *
+ * So checkpoint the goal to disk while it runs. On the next SDK init a fresh
+ * checkpoint means "we were interrupted", and the run can be picked up again
+ * from whatever screen the App came back on.
+ *
+ * Storage is best-effort: without AsyncStorage this degrades to memory, which
+ * cannot survive a reload. That is the same tradeoff ExplorationGraph makes —
+ * a missing optional peer must not break a run, only reduce it.
+ */
+/**
+ * A reload takes a second or two. Anything older than this was not an
+ * interruption — it is a run that died for some other reason (force quit,
+ * crash, the user walking away), and silently driving the UI on next launch
+ * would be surprising rather than helpful.
+ */
+export declare const RESUME_MAX_AGE_MS = 90000;
+/**
+ * One resume per goal. If the goal itself is what reloads the App, resuming it
+ * reloads again; without a cap that is an infinite loop across launches.
+ */
+export declare const RESUME_MAX_ATTEMPTS = 1;
+export type RunCheckpointData = {
+    goal: string;
+    startedAt: number;
+    /** Bumped per step, so age reflects liveness rather than run length. */
+    updatedAt: number;
+    /** Resumes already spent on this goal. */
+    resumes: number;
+};
+export declare const RunCheckpoint: {
+    /** Mark a goal as in flight. `resumes` carries over when resuming. */
+    begin(goal: string, resumes?: number): Promise<void>;
+    /** Keep the checkpoint fresh while the loop makes progress. */
+    touch(): Promise<void>;
+    /** The run reached a verdict — nothing left to resume. */
+    clear(): Promise<void>;
+    /**
+     * Claim an interrupted run, if there is one worth resuming.
+     *
+     * Clears before returning: a resume that dies the same way must not be
+     * claimed again on the next launch.
+     */
+    claimResumable(opts?: {
+        maxAgeMs?: number;
+        maxAttempts?: number;
+        now?: number;
+    }): Promise<RunCheckpointData | null>;
+};
+//# sourceMappingURL=RunCheckpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RunCheckpoint.d.ts","sourceRoot":"","sources":["../../../../src/client/RunCheckpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAuBH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA2CF,eAAO,MAAM,aAAa;IACxB,sEAAsE;gBAC1D,MAAM;IAOlB,+DAA+D;;IAQ/D,0DAA0D;;IAQ1D;;;;;OAKG;0BACyB;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAetC,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Idle / dead-loop detection (mirrors SDK client + KokoAgent explore/escape).
+ * Stop on no-progress loops only — not because a goal needs many steps.
+ */
+export type HistoryLike = {
+    tool: string;
+    args?: Record<string, unknown>;
+    result: string;
+    ok?: boolean;
+};
+export declare function actionFingerprint(item: HistoryLike): string;
+export declare function isLooping(history: HistoryLike[]): boolean;
+export declare function isNearLoop(history: HistoryLike[]): boolean;
+export declare const LOOP_ESCAPE_HINT = "\u3010\u6062\u590D\u8BC4\u4F30 \u2014 \u8FD1\u671F\u89C2\u5BDF\u6216\u52A8\u4F5C\u91CD\u590D\uFF0C\u5148\u6838\u9A8C\u5F53\u524D\u72B6\u6001\u3011\n- \u5BF9\u7167\u7528\u6237\u76EE\u6807\u548C\u6700\u65B0\u8BC1\u636E\uFF1A\u5DF2\u9A8C\u8BC1\u5168\u90E8\u7ED3\u679C\u624D done(true)\uFF1B\u91CD\u590D\u6216\u7A7A\u8F6C\u672C\u8EAB\u4E0D\u4EE3\u8868\u6210\u529F\n- \u52A0\u8F7D\u3001\u8F6C\u573A\u6216\u5DF2\u63D0\u4EA4\u64CD\u4F5C\u4ECD\u5F85\u7ED3\u679C\u65F6\uFF0C\u53EF\u4EE5\u5728\u5BA2\u6237\u7AEF\u9884\u7B97\u5185\u7528 dump \u53EA\u8BFB\u6838\u9A8C\uFF1B\u6301\u7EED\u4E0D\u53D8\u5219\u5982\u5B9E done(false)\u8BF4\u660E\u672A\u786E\u8BA4\uFF0C\u4E0D\u91CD\u63D0\u8BF7\u6C42\u6216\u91CD\u8D70\u5DF2\u5B8C\u6210\u6D41\u7A0B\n- tap_noop / tap_failed \u540E\u5148\u6838\u5BF9\u5F53\u524D\u63A7\u4EF6\u4E0E\u72B6\u6001\uFF1B\u53EA\u6709\u5B58\u5728\u6709\u8BC1\u636E\u4E14\u5B89\u5168\u7684\u66FF\u4EE3\u52A8\u4F5C\u624D\u8C03\u6574 selector\u3001\u76EE\u6807\u6216\u8DEF\u5F84\uFF0C\u4E0D\u80FD\u4E3A\u4E86\u9003\u9038\u800C\u731C\u70B9\n- \u4E0E\u5F53\u524D\u5B50\u76EE\u6807\u76F8\u5173\u7684\u6807\u9898\u3001\u6B63\u6587\u3001\u9875\u7801\u6216\u72B6\u6001\u6301\u7EED\u53D8\u5316\u65F6\uFF0C\u540C\u540D\u6216\u4EA4\u66FF\u6309\u94AE\u4ECD\u53EF\u80FD\u662F\u6B63\u5E38\u8FDB\u5C55\uFF1B\u4E0D\u8981\u6309\u56FA\u5B9A\u70B9\u51FB\u6B21\u6570\u6216\u52A8\u4F5C\u5E8F\u5217\u8BA4\u5B9A\u5FAA\u73AF\n- \u4E0B\u4E00\u6B65\u63A7\u4EF6\u786E\u5B9E\u53EF\u89C1\u3001\u53EF\u64CD\u4F5C\u4E14\u5C5E\u4E8E\u5F53\u524D\u76EE\u6807\u65F6\u518D tap/type\uFF1B\u5DF2\u6EE1\u8DB3\u7684\u9009\u4E2D\u72B6\u6001\u4E0D\u91CD\u590D\u5207\u6362\n- \u4EC5\u76EE\u6807\u5C5E\u4E8E\u5F53\u524D\u5217\u8868\u4E14\u6709\u6EDA\u52A8\u533A\u57DF\u8FB9\u754C\u65F6\u624D swipe \u67E5\u627E\uFF1B\u624B\u52BF\u8D77\u7EC8\u70B9\u5728\u533A\u57DF\u5185\uFF0C\u4E0D\u80FD\u7528\u6ED1\u52A8\u731C\u6D4B\u5BFC\u822A\n- \u6570\u503C\u63A7\u4EF6\u6309\u5B9E\u9645\u7C7B\u578B\u3001\u5F53\u524D\u503C\u3001\u8303\u56F4\u548C\u7528\u6237\u7CBE\u5EA6\u8981\u6C42\u8C03\u6574\uFF0C\u4E0D\u9884\u8BBE\u624B\u52BF\u65B9\u5411\uFF1B\u65E0\u6548\u679C\u3001\u5230\u8FB9\u754C\u6216\u7F3A\u5C11\u8BC1\u636E\u65F6\u8BF4\u660E\u53D7\u963B\n- find/tap \u4F7F\u7528\u6700\u65B0\u80FD\u529B\u91CC\u7684\u6587\u6848\u6216 id\uFF1B\u7F3A\u5C11\u5B89\u5168\u4E0B\u4E00\u6B65\u65F6\u5141\u8BB8\u53EA\u8BFB\u89C2\u5BDF\u6216\u5982\u5B9E\u7ED3\u675F\uFF0C\u4E0D\u5F3A\u5236\u5207\u6362\u8DEF\u5F84";
+//# sourceMappingURL=loopDetect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loopDetect.d.ts","sourceRoot":"","sources":["../../../../src/client/loopDetect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAkC3D;AA8DD,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAyEzD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAmB1D;AAED,eAAO,MAAM,gBAAgB,u5EAQyB,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { ViewNode } from '../types';
+import type { GatewayAction } from './GatewayClient';
+/** Only replace a search query with a uniquely identified visible recent item. */
+export declare function recentSearchAction(action: GatewayAction, root: ViewNode | null, goal: string): GatewayAction | null;
+//# sourceMappingURL=recentSearch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recentSearch.d.ts","sourceRoot":"","sources":["../../../../src/client/recentSearch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQrD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAoCnH"}

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

@@ -0,0 +1,4 @@
+import type { GatewayAction } from './GatewayClient';
+/** Protect a host-wallet request from accidentally selecting an unrelated provider. */
+export declare function wrongHostWalletChoice(goal: string, action: GatewayAction, choices: string[], aliases: string[], observedLabel?: string): boolean;
+//# sourceMappingURL=walletChoiceGuard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"walletChoiceGuard.d.ts","sourceRoot":"","sources":["../../../../src/client/walletChoiceGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAWhJ"}

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

@@ -0,0 +1,5 @@
+import type { ViewNode } from '../types';
+import type { GatewayAction, AgentHistoryItem } from './GatewayClient';
+/** Select a visible app-results category only when the user's query is on this page. */
+export declare function webResultCategory(action: GatewayAction, root: ViewNode | null, goal: string, history: AgentHistoryItem[]): GatewayAction | null;
+//# sourceMappingURL=webResultCategory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webResultCategory.d.ts","sourceRoot":"","sources":["../../../../src/client/webResultCategory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,aAAa,GAAG,IAAI,CAuB/I"}

package/lib/typescript/module/commercial/AccountStore.d.ts

@@ -0,0 +1,17 @@
+import { type GatewayConfig } from '../client/GatewayClient';
+import type { KokoAccountSnapshot, KokoEntitlements, KokoPlanId } from '../types';
+type Listener = (account: KokoAccountSnapshot | null) => void;
+declare class AccountStoreImpl {
+    private account;
+    private listeners;
+    private inflight;
+    get(): KokoAccountSnapshot | null;
+    subscribe(listener: Listener): () => void;
+    private emit;
+    refresh(gateway: GatewayConfig): Promise<KokoAccountSnapshot | null>;
+    entitlements(): KokoEntitlements;
+    plan(): KokoPlanId;
+}
+export declare const AccountStore: AccountStoreImpl;
+export {};
+//# sourceMappingURL=AccountStore.d.ts.map

package/lib/typescript/module/commercial/AccountStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountStore.d.ts","sourceRoot":"","sources":["../../../../src/commercial/AccountStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAKlF,KAAK,QAAQ,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;AAgB9D,cAAM,gBAAgB;IACpB,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAoD;IAEpE,GAAG,IAAI,mBAAmB,GAAG,IAAI;IAIjC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAQzC,OAAO,CAAC,IAAI;IAIN,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAgC1E,YAAY,IAAI,gBAAgB;IAIhC,IAAI,IAAI,UAAU;CAGnB;AAED,eAAO,MAAM,YAAY,kBAAyB,CAAC"}

package/lib/typescript/module/commercial/AgentDebug.d.ts

@@ -0,0 +1,25 @@
+import type { KokoAgentConfig } from '../types';
+import type { ViewNode } from '../types';
+type Cfg = Pick<KokoAgentConfig, 'debug' | 'devMode'> | undefined;
+/**
+ * Developer-facing logs: what the SDK observed in the host App
+ * (controls / fields / actions). Never logs security policy internals.
+ */
+export declare const AgentDebug: {
+    enabled(config?: Cfg): boolean;
+    /** High-level run lifecycle (goal only, no policy). */
+    runStart(config: Cfg, goal: string): void;
+    runEnd(config: Cfg, summary: string, ok: boolean): void;
+    /** The dump stopped at its depth cap, so the page body never reached us. */
+    dumpTruncated(config: Cfg, cap: number): void;
+    /** Capabilities discovered on the current screen. */
+    screenCapabilities(config: Cfg, tree: ViewNode | null | undefined): void;
+    /** What the agent is about to do in the App (user-visible action). */
+    appAction(config: Cfg, step: number, tool: string, detail?: string): void;
+    /** Soft failure for developers — generic, no rule leakage. */
+    runIssue(config: Cfg, message: string): void;
+};
+/** Strip security/policy jargon from messages shown in debug console. */
+export declare function sanitizeDevMessage(message: string): string;
+export {};
+//# sourceMappingURL=AgentDebug.d.ts.map

package/lib/typescript/module/commercial/AgentDebug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentDebug.d.ts","sourceRoot":"","sources":["../../../../src/commercial/AgentDebug.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,KAAK,GAAG,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,UAAU;qBACJ,GAAG,GAAG,OAAO;IAI9B,uDAAuD;qBACtC,GAAG,QAAQ,MAAM;mBAMnB,GAAG,WAAW,MAAM,MAAM,OAAO;IAMhD,4EAA4E;0BACtD,GAAG,OAAO,MAAM;IAStC,qDAAqD;+BAC1B,GAAG,QAAQ,QAAQ,GAAG,IAAI,GAAG,SAAS;IAmBjE,sEAAsE;sBAE5D,GAAG,QACL,MAAM,QACN,MAAM,WACH,MAAM;IAQjB,8DAA8D;qBAC7C,GAAG,WAAW,MAAM;CAMtC,CAAC;AA+CF,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAY1D"}

package/lib/typescript/module/commercial/ExecutionGuard.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Soft client gate: local dump/tap/swipe/type require a short-lived
+ * execution_permit from the official (or local-lab) gateway session.
+ * Always enforced — debug logging does not bypass this.
+ */
+export type GuardedAction = 'dump' | 'find' | 'tap' | 'swipe' | 'pinch' | 'type' | 'screenshot';
+declare class ExecutionGuardImpl {
+    private permit;
+    private sessionId;
+    setPermit(permit: string | null, sessionId?: string | null): void;
+    getPermit(): string | null;
+    getSessionId(): string | null;
+    clear(): void;
+    assert(action: GuardedAction): void;
+}
+export declare const ExecutionGuard: ExecutionGuardImpl;
+export {};
+//# sourceMappingURL=ExecutionGuard.d.ts.map

package/lib/typescript/module/commercial/ExecutionGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionGuard.d.ts","sourceRoot":"","sources":["../../../../src/commercial/ExecutionGuard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;AAuBhG,cAAM,kBAAkB;IACtB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAuB;IAExC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1D,SAAS;IAIT,YAAY;IAIZ,KAAK;IAKL,MAAM,CAAC,MAAM,EAAE,aAAa;CAa7B;AAED,eAAO,MAAM,cAAc,oBAA2B,CAAC"}

package/lib/typescript/module/commercial/UsageBus.d.ts

@@ -0,0 +1,18 @@
+import type { KokoUsageEvent } from '../types';
+type Listener = (event: KokoUsageEvent) => void;
+/**
+ * Fan-out for usage / lifecycle events. Host `onUsageEvent` is wired here.
+ * Never used to gate execution.
+ */
+declare class UsageBusImpl {
+    private listeners;
+    private recent;
+    private readonly maxRecent;
+    subscribe(listener: Listener): () => void;
+    emit(event: KokoUsageEvent): void;
+    getRecent(): KokoUsageEvent[];
+    clear(): void;
+}
+export declare const UsageBus: UsageBusImpl;
+export {};
+//# sourceMappingURL=UsageBus.d.ts.map

package/lib/typescript/module/commercial/UsageBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageBus.d.ts","sourceRoot":"","sources":["../../../../src/commercial/UsageBus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAEhD;;;GAGG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAO;IAEjC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC,IAAI,CAAC,KAAK,EAAE,cAAc;IAc1B,SAAS,IAAI,cAAc,EAAE;IAI7B,KAAK;CAGN;AAED,eAAO,MAAM,QAAQ,cAAqB,CAAC"}

package/lib/typescript/module/commercial/branding.d.ts

@@ -0,0 +1,25 @@
+import type { KokoAccountSnapshot, KokoBrandingConfig, KokoEntitlements, KokoLocale } from '../types';
+export declare const DEFAULT_ENTITLEMENTS: KokoEntitlements;
+export type ResolvedBranding = {
+    name: string;
+    /** Letter shown when no image icon. */
+    mark: string;
+    /** Image source when host provided a require()/uri icon and entitlement allows. */
+    iconSource: number | {
+        uri: string;
+    } | null;
+    tagline: string;
+    placeholder: string;
+    primaryColor: string;
+    /** True when host asked for custom branding but plan denied it. */
+    downgraded: boolean;
+};
+/**
+ * Resolve what the **built-in** chat UI may show.
+ * This is a soft client gate for honest hosts + official gateway.
+ * Forked SDKs / custom chrome can always draw their own brand — that is outside
+ * this product surface. Usage metering remains server-authoritative.
+ */
+export declare function resolveBranding(locale: KokoLocale, branding: KokoBrandingConfig | undefined, entitlements: KokoEntitlements | undefined): ResolvedBranding;
+export declare function emptyAccount(): KokoAccountSnapshot;
+//# sourceMappingURL=branding.d.ts.map

package/lib/typescript/module/commercial/branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../../../src/commercial/branding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EAEX,MAAM,UAAU,CAAC;AAGlB,eAAO,MAAM,oBAAoB,EAAE,gBAGlC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,UAAU,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAeF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,YAAY,EAAE,gBAAgB,GAAG,SAAS,GACzC,gBAAgB,CAsClB;AAED,wBAAgB,YAAY,IAAI,mBAAmB,CAMlD"}

package/lib/typescript/module/commercial/devMode.d.ts

@@ -0,0 +1,26 @@
+import type { KokoAgentConfig } from '../types';
+/** True only in Metro debug clients (never in store release binaries). */
+export declare function isMetroDevBuild(): boolean;
+/**
+ * Verbose SDK / agent execution logs for developers.
+ * Does NOT relax security (permits, gateway allowlist).
+ *
+ * On when:
+ * - `config.debug === true`, or
+ * - Metro `__DEV__` and `config.debug !== false`
+ *
+ * Release builds: only if host explicitly sets `debug: true`
+ * (logs only — still cannot use localhost gateway or skip permits).
+ */
+export declare function resolveDebugLogging(config?: Pick<KokoAgentConfig, 'debug' | 'devMode'>): boolean;
+/**
+ * @deprecated Use resolveDebugLogging. Kept for call-site migration.
+ * Previously also meant "relax security" — that behavior is removed.
+ */
+export declare function resolveDevMode(config?: Pick<KokoAgentConfig, 'debug' | 'devMode'>): boolean;
+/**
+ * Localhost / LAN gateway is only for Intent Computing debugging the
+ * in-repo gateway against a Metro debug app — not a customer "self-host" mode.
+ */
+export declare function allowLocalGatewayForDebugClient(): boolean;
+//# sourceMappingURL=devMode.d.ts.map

package/lib/typescript/module/commercial/devMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devMode.d.ts","sourceRoot":"","sources":["../../../../src/commercial/devMode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,0EAA0E;AAC1E,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC,GAClD,OAAO,CAIT;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC,GAClD,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,OAAO,CAEzD"}

package/lib/typescript/module/commercial/trust.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Gateway host policy + entitlement trust.
+ *
+ * Customers always use official Intent Computing hosts in release apps.
+ * Localhost is allowed only in Metro debug clients (so we can dogfood the
+ * in-repo gateway) — that is NOT a supported "self-host your own AI" mode.
+ */
+export declare function isLocalDevHost(hostname: string): boolean;
+export declare function isOfficialGatewayHost(hostname: string): boolean;
+/** Hosts whose /v1/me branding claims we trust. */
+export declare function isTrustedEntitlementHost(baseUrl: string): boolean;
+/**
+ * @param allowLocalLab when true (Metro debug client only), localhost/LAN OK.
+ */
+export declare function isAllowedGatewayUrl(baseUrl: string, allowLocalLab: boolean): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+//# sourceMappingURL=trust.d.ts.map

package/lib/typescript/module/commercial/trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.d.ts","sourceRoot":"","sources":["../../../../src/commercial/trust.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQxD;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED,mDAAmD;AACnD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,OAAO,GACrB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAkB9C"}

package/lib/typescript/module/confirmation/gate.d.ts

@@ -0,0 +1,18 @@
+import type { ConfirmationPolicy, SensitiveConfirmContext } from '../types';
+/**
+ * Irreversible / high-risk intents — confirmed once **before** the agent run.
+ * Ordinary list deletes are NOT sensitive.
+ */
+export declare const DEFAULT_SENSITIVE_PATTERNS: RegExp[];
+export declare function isSensitiveLabel(label: string | undefined, policy?: ConfirmationPolicy): boolean;
+/** Goal looks like a high-risk operation → preflight confirm. */
+export declare function isSensitiveGoal(goal: string, policy?: ConfirmationPolicy): boolean;
+/**
+ * Mid-step gate (legacy). Prefer preflight; during unattended runs this should no-op.
+ */
+export declare function runConfirmationGate(ctx: SensitiveConfirmContext, policy: ConfirmationPolicy | undefined, onConfirm?: (ctx: SensitiveConfirmContext) => Promise<boolean>): Promise<boolean>;
+/**
+ * Ask once before the agent loop. Returns false if user declines.
+ */
+export declare function runPreflightConfirm(goal: string, policy: ConfirmationPolicy | undefined, onConfirm?: (ctx: SensitiveConfirmContext) => Promise<boolean>): Promise<boolean>;
+//# sourceMappingURL=gate.d.ts.map

package/lib/typescript/module/confirmation/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../../../src/confirmation/gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,EAM9C,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAMT;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAET;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,OAAO,CAAC,GAC7D,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,OAAO,CAAC,GAC7D,OAAO,CAAC,OAAO,CAAC,CAelB"}

package/lib/typescript/module/cursor/CursorOverlay.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+/**
+ * Native-looking mouse pointer while the agent acts.
+ *
+ * Uses KokoHostOverlay (FullWindowOverlay on iOS when available) so the
+ * cursor stays above react-native-screens Settings / stack modals.
+ *
+ * Only mount while the cursor is actually visible — an empty FullWindowOverlay
+ * stacked under KokoObserver can steal the top presentation and hide the
+ * progress pill during host.run-only assist paths.
+ */
+export declare function CursorOverlay(): React.JSX.Element | null;
+//# sourceMappingURL=CursorOverlay.d.ts.map

package/lib/typescript/module/cursor/CursorOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CursorOverlay.d.ts","sourceRoot":"","sources":["../../../../src/cursor/CursorOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAW3D;;;;;;;;;GASG;AACH,wBAAgB,aAAa,6BAsG5B"}

package/lib/typescript/module/cursor/PointerHand.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+/**
+ * The agent's pointer: a hand with the index finger extended.
+ *
+ * Drawn from views rather than an image. The SDK's assets sit outside the
+ * host's Metro project root, and a host that rewrites asset paths (monorepos
+ * commonly do) can leave the request unresolvable — the pointer then silently
+ * does not render, which is the one thing the user watches to know the agent
+ * is acting. Views cannot fail that way, and they stay sharp at any density.
+ *
+ * Two passes: dark shapes inflated to form the outline, then the white fill
+ * over them. Overlaps within a pass are invisible, so the union reads as one
+ * silhouette with no internal seams.
+ */
+export declare function PointerHand(): React.JSX.Element;
+//# sourceMappingURL=PointerHand.d.ts.map

package/lib/typescript/module/cursor/PointerHand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointerHand.d.ts","sourceRoot":"","sources":["../../../../src/cursor/PointerHand.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,sBAO1B"}

package/lib/typescript/module/cursor/controller.d.ts

@@ -0,0 +1,30 @@
+type CursorListener = (state: CursorState) => void;
+export type CursorState = {
+    visible: boolean;
+    x: number;
+    y: number;
+    pressing: boolean;
+    /** How long the overlay should animate to (x, y). 0 = snap. */
+    moveDurationMs: number;
+};
+/**
+ * Imperative cursor controller used by KokoAgent; CursorOverlay subscribes.
+ */
+declare class CursorControllerImpl {
+    private state;
+    private listeners;
+    subscribe(listener: CursorListener): () => void;
+    getState(): CursorState;
+    private emit;
+    showAt(x: number, y: number, moveDurationMs?: number): void;
+    hide(): void;
+    setPressing(pressing: boolean): void;
+    /**
+     * Start moving toward the target immediately, then resolve when the
+     * visual move should have finished — so tap happens after the cursor arrives.
+     */
+    moveTo(x: number, y: number, durationMs: number): Promise<void>;
+}
+export declare const CursorController: CursorControllerImpl;
+export {};
+//# sourceMappingURL=controller.d.ts.map

package/lib/typescript/module/cursor/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../src/cursor/controller.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAUF;;GAEG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,SAAS,CAA6B;IAE9C,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI;IAM/C,QAAQ,IAAI,WAAW;IAIvB,OAAO,CAAC,IAAI;IAIZ,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,SAAI;IAW/C,IAAI;IAKJ,WAAW,CAAC,QAAQ,EAAE,OAAO;IAK7B;;;OAGG;IACG,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA0BtE;AAMD,eAAO,MAAM,gBAAgB,sBAA6B,CAAC"}

package/lib/typescript/module/cursor/pointer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Geometry for the agent's on-screen pointer.
+ *
+ * Two overlays draw it (KokoObserver when the progress chrome is mounted,
+ * CursorOverlay otherwise), so this lives in one place: a hotspot that
+ * disagreed between them would put the pointer somewhere the tap did not go.
+ */
+/** Keep the grid ratio so the drawing is not squashed. */
+export declare const CURSOR_W = 26;
+export declare const CURSOR_H: number;
+/** Points per grid unit. */
+export declare const HAND_UNIT: number;
+/** Outline weight, in grid units. */
+export declare const HAND_STROKE = 1.6;
+/**
+ * The hand as a union of rounded bars: `[x, y, width, height, radius]` in grid
+ * units. Order is back to front, though within a layer it does not matter.
+ */
+export declare const HAND_SHAPES: ReadonlyArray<readonly [number, number, number, number, number]>;
+/** The index fingertip — this is what lands on the tap coordinate. */
+export declare const CURSOR_TIP_X: number;
+export declare const CURSOR_TIP_Y: number;
+//# sourceMappingURL=pointer.d.ts.map

package/lib/typescript/module/cursor/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../../../src/cursor/pointer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,0DAA0D;AAC1D,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,QAAQ,QAA2C,CAAC;AAEjE,4BAA4B;AAC5B,eAAO,MAAM,SAAS,QAAoB,CAAC;AAE3C,qCAAqC;AACrC,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,CACrC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAQlD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,YAAY,QAAmB,CAAC;AAC7C,eAAO,MAAM,YAAY,QAAkB,CAAC"}

package/lib/typescript/module/debug/KokoRemoteSmoke.d.ts

@@ -0,0 +1,96 @@
+export type KokoRemoteSmokeCmd = {
+    id: string;
+    type: 'ping';
+} | {
+    id: string;
+    type: 'openChat';
+    taskId?: string | null;
+} | {
+    id: string;
+    type: 'closeChat';
+} | {
+    id: string;
+    type: 'stop';
+} | {
+    id: string;
+    type: 'snapshot';
+} | {
+    id: string;
+    type: 'verifyLocalWebText';
+    text: string;
+    goal: string;
+    cursorAtTarget?: boolean;
+} | {
+    id: string;
+    type: 'inspectWalletChoices';
+} | {
+    id: string;
+    type: 'inspectWebWalletProvider';
+} | {
+    id: string;
+    type: 'inspectWebState';
+} | {
+    id: string;
+    type: 'chromeTrace';
+    clear?: boolean;
+} | {
+    id: string;
+    type: 'dump';
+    includeTree?: boolean;
+} | {
+    id: string;
+    type: 'tap';
+    point?: {
+        x: number;
+        y: number;
+    };
+    text?: string;
+    nodeId?: string;
+} | {
+    id: string;
+    type: 'runGoal';
+    goal: string;
+} | {
+    id: string;
+    type: 'recognizeScreenText';
+    maxTokens?: number;
+    languages?: string[];
+} | {
+    id: string;
+    type: 'alertAction';
+    title: string;
+} | {
+    id: string;
+    type: 'cursorAt';
+    x: number;
+    y: number;
+    holdMs?: number;
+} | {
+    id: string;
+    type: 'onDeviceAssist';
+    goal: string;
+    skipOcr?: boolean;
+} | {
+    id: string;
+    type: 'explore';
+    maxSteps?: number;
+    maxScreens?: number;
+    mode?: 'full' | 'quick';
+    appKey?: string;
+} | {
+    id: string;
+    type: 'exploreGraph';
+} | {
+    id: string;
+    type: 'clearExploreGraph';
+};
+/**
+ * DEV-only remote driver: poll a host HTTP queue and run SDK ops.
+ * Host-agnostic — any app can enable via KokoProvider `remoteSmokePort`.
+ * Simulator reaches Mac localhost as 127.0.0.1.
+ */
+export declare function KokoRemoteSmoke({ port, enabled, }: {
+    port?: number;
+    enabled?: boolean;
+}): null;
+//# sourceMappingURL=KokoRemoteSmoke.d.ts.map

package/lib/typescript/module/debug/KokoRemoteSmoke.d.ts.map

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

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

@@ -0,0 +1,96 @@
+/**
+ * On-device exploration graph — screen fingerprints + labeled transitions.
+ * No host feature catalog required. Persist best-effort (AsyncStorage if present).
+ */
+export type ExploreNode = {
+    id: string;
+    /** Compact affordance labels used for matching. */
+    labels: string[];
+    fingerprint: string;
+    seenAt: number;
+    visitCount: number;
+};
+export type ExploreEdge = {
+    id: string;
+    fromId: string;
+    toId: string;
+    /** Tap / host label that caused the transition. */
+    label: string;
+    count: number;
+    lastAt: number;
+};
+export type ExplorationGraphSnapshot = {
+    version: 1;
+    appKey: string;
+    updatedAt: number;
+    nodes: ExploreNode[];
+    edges: ExploreEdge[];
+};
+export type PathStep = {
+    fromId: string;
+    toId: string;
+    label: string;
+};
+/** Normalize labels for graph identity (locale-ish noise trimmed). */
+export declare function normalizeExploreLabel(label: string): string;
+/** All synonym spellings for an explore / affordance label. */
+export declare function exploreLabelSynonyms(label: string): string[];
+/**
+ * Map a historical explore tap label onto a label currently on screen
+ * (exact / synonym). Returns null when nothing matches.
+ */
+export declare function resolveExploreLabelOnScreen(desired: string, available: string[]): string | null;
+/**
+ * Fingerprint a screen from affordance labels (order-insensitive top-N).
+ */
+export declare function fingerprintFromLabels(labels: string[], max?: number): string;
+export declare class ExplorationGraphStore {
+    private appKey;
+    private nodes;
+    private edges;
+    private loaded;
+    private saveTimer;
+    setAppKey(appKey: string): void;
+    getAppKey(): string;
+    ensureLoaded(): Promise<void>;
+    private scheduleSave;
+    persist(): Promise<void>;
+    snapshot(): ExplorationGraphSnapshot;
+    clear(): void;
+    /** Upsert a screen node; returns node id (= fingerprint). */
+    observeScreen(labels: string[]): ExploreNode;
+    /**
+     * Record a transition after a tap. No-op if screen did not change.
+     */
+    recordTransition(fromLabels: string[], label: string, toLabels: string[]): ExploreEdge | null;
+    /** Nodes whose labels match any of the query tokens. */
+    findNodesMatching(tokens: string[]): ExploreNode[];
+    /**
+     * BFS shortest path of tap labels from current fingerprint toward any
+     * node matching goal tokens.
+     */
+    findPathToGoal(fromLabels: string[], goalTokens: string[], maxDepth?: number): PathStep[] | null;
+    /**
+     * Soft hints for the planner: known outgoing labels from current screen
+     * that historically led toward goal-matching screens.
+     */
+    hintLabelsTowardGoal(fromLabels: string[], goalTokens: string[], limit?: number): string[];
+    stats(): {
+        nodes: number;
+        edges: number;
+        appKey: string;
+    };
+}
+export declare const ExplorationGraph: ExplorationGraphStore;
+/** Extract goal tokens for graph search (structural NL bits). */
+export declare function goalTokensForExplore(goal: string): string[];
+/**
+ * Split explore query into destination tokens vs broader keywords.
+ * E.g. 「设置语言」targets 语言 screens, not every screen that merely says 设置.
+ */
+export declare function goalExploreQuery(goal: string): {
+    targetTokens: string[];
+    allTokens: string[];
+};
+export declare function exploreHintsModelText(hints: string[]): string;
+//# sourceMappingURL=ExplorationGraph.d.ts.map