@intentcomputing/koko-agent-sdk 1.0.1

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

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

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

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

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

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

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

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

package/lib/typescript/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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/commonjs/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"}