@intentcomputing/koko-agent-sdk 1.0.1

package/lib/module/commercial/branding.js

@@ -0,0 +1,63 @@
+"use strict";
+
+import { t } from "../i18n/index.js";
+export const DEFAULT_ENTITLEMENTS = {
+  custom_branding: false,
+  locale: true
+};
+const DEFAULT_PRIMARY = '#0A84FF';
+function wantsCustomBranding(branding) {
+  if (!branding) return false;
+  return Boolean(branding.name && branding.name.trim() && branding.name.trim() !== 'Koko' || branding.icon != null || branding.tagline && branding.tagline.trim() || branding.placeholder && branding.placeholder.trim() || branding.primaryColor && branding.primaryColor.trim());
+}
+
+/**
+ * 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 function resolveBranding(locale, branding, entitlements) {
+  const allowed = entitlements?.custom_branding === true;
+  const custom = wantsCustomBranding(branding);
+  const downgraded = custom && !allowed;
+  const useCustom = custom && allowed;
+  let iconSource = null;
+  let mark = t(locale, 'brand.defaultMark');
+  if (useCustom && branding?.icon != null) {
+    if (typeof branding.icon === 'string') {
+      if (/^https?:\/\//i.test(branding.icon) || branding.icon.startsWith('data:')) {
+        iconSource = {
+          uri: branding.icon
+        };
+      } else {
+        mark = branding.icon.slice(0, 2);
+      }
+    } else {
+      iconSource = branding.icon;
+    }
+  }
+  return {
+    name: useCustom && branding?.name?.trim() ? branding.name.trim() : t(locale, 'brand.defaultName'),
+    mark,
+    iconSource,
+    tagline: useCustom && branding?.tagline?.trim() ? branding.tagline.trim() : t(locale, 'brand.defaultTagline'),
+    placeholder: useCustom && branding?.placeholder?.trim() ? branding.placeholder.trim() : t(locale, 'brand.defaultPlaceholder'),
+    primaryColor: useCustom && branding?.primaryColor?.trim() ? branding.primaryColor.trim() : DEFAULT_PRIMARY,
+    downgraded
+  };
+}
+export function emptyAccount() {
+  return {
+    plan: 'free',
+    entitlements: {
+      ...DEFAULT_ENTITLEMENTS
+    },
+    quota: {
+      daily: 30,
+      used_today: 0,
+      remaining: 30
+    }
+  };
+}
+//# sourceMappingURL=branding.js.map

package/lib/module/commercial/branding.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["t","DEFAULT_ENTITLEMENTS","custom_branding","locale","DEFAULT_PRIMARY","wantsCustomBranding","branding","Boolean","name","trim","icon","tagline","placeholder","primaryColor","resolveBranding","entitlements","allowed","custom","downgraded","useCustom","iconSource","mark","test","startsWith","uri","slice","emptyAccount","plan","quota","daily","used_today","remaining"],"sourceRoot":"../../../src","sources":["commercial/branding.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/commercial/devMode.js

@@ -0,0 +1,45 @@
+"use strict";
+
+/** True only in Metro debug clients (never in store release binaries). */
+export function isMetroDevBuild() {
+  try {
+    // eslint-disable-next-line no-undef
+    return typeof __DEV__ !== 'undefined' && __DEV__ === true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 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 function resolveDebugLogging(config) {
+  if (config?.debug === true || config?.devMode === true) return true;
+  if (config?.debug === false || config?.devMode === false) return false;
+  return isMetroDevBuild();
+}
+
+/**
+ * @deprecated Use resolveDebugLogging. Kept for call-site migration.
+ * Previously also meant "relax security" — that behavior is removed.
+ */
+export function resolveDevMode(config) {
+  return resolveDebugLogging(config);
+}
+
+/**
+ * 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 function allowLocalGatewayForDebugClient() {
+  return isMetroDevBuild();
+}
+//# sourceMappingURL=devMode.js.map

package/lib/module/commercial/devMode.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isMetroDevBuild","__DEV__","resolveDebugLogging","config","debug","devMode","resolveDevMode","allowLocalGatewayForDebugClient"],"sourceRoot":"../../../src","sources":["commercial/devMode.ts"],"mappings":";;AAEA;AACA,OAAO,SAASA,eAAeA,CAAA,EAAY;EACzC,IAAI;IACF;IACA,OAAO,OAAOC,OAAO,KAAK,WAAW,IAAIA,OAAO,KAAK,IAAI;EAC3D,CAAC,CAAC,MAAM;IACN,OAAO,KAAK;EACd;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CACjCC,MAAmD,EAC1C;EACT,IAAIA,MAAM,EAAEC,KAAK,KAAK,IAAI,IAAID,MAAM,EAAEE,OAAO,KAAK,IAAI,EAAE,OAAO,IAAI;EACnE,IAAIF,MAAM,EAAEC,KAAK,KAAK,KAAK,IAAID,MAAM,EAAEE,OAAO,KAAK,KAAK,EAAE,OAAO,KAAK;EACtE,OAAOL,eAAe,CAAC,CAAC;AAC1B;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASM,cAAcA,CAC5BH,MAAmD,EAC1C;EACT,OAAOD,mBAAmB,CAACC,MAAM,CAAC;AACpC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASI,+BAA+BA,CAAA,EAAY;EACzD,OAAOP,eAAe,CAAC,CAAC;AAC1B","ignoreList":[]}

package/lib/module/commercial/trust.js

@@ -0,0 +1,62 @@
+"use strict";
+
+/**
+ * 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.
+ */
+
+// `agent.intentcomputing.net` is a different Intent Computing service and must
+// not be trusted as a gateway.
+const OFFICIAL_HOST_SUFFIXES = ['sdk.intentcomputing.cn', 'sdk.intentcomputing.net'];
+export function isLocalDevHost(hostname) {
+  const host = hostname.toLowerCase();
+  return host === 'localhost' || host === '127.0.0.1' || host === '10.0.2.2' || host === '0.0.0.0';
+}
+export function isOfficialGatewayHost(hostname) {
+  const host = hostname.toLowerCase();
+  return OFFICIAL_HOST_SUFFIXES.some(h => host === h || host.endsWith(`.${h}`));
+}
+
+/** Hosts whose /v1/me branding claims we trust. */
+export function isTrustedEntitlementHost(baseUrl) {
+  try {
+    const u = new URL(baseUrl.includes('://') ? baseUrl : `https://${baseUrl}`);
+    return isOfficialGatewayHost(u.hostname) || isLocalDevHost(u.hostname);
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * @param allowLocalLab when true (Metro debug client only), localhost/LAN OK.
+ */
+export function isAllowedGatewayUrl(baseUrl, allowLocalLab) {
+  try {
+    const u = new URL(baseUrl.includes('://') ? baseUrl : `https://${baseUrl}`);
+    if (isOfficialGatewayHost(u.hostname)) return {
+      ok: true
+    };
+    if (allowLocalLab && isLocalDevHost(u.hostname)) return {
+      ok: true
+    };
+    if (allowLocalLab) {
+      const ipv4 = /^\d{1,3}(\.\d{1,3}){3}$/.test(u.hostname);
+      if (ipv4) return {
+        ok: true
+      };
+    }
+    return {
+      ok: false,
+      reason: allowLocalLab ? `unsupported gateway host: ${u.hostname}` : `unsupported gateway host: ${u.hostname}`
+    };
+  } catch {
+    return {
+      ok: false,
+      reason: 'invalid gateway.baseUrl'
+    };
+  }
+}
+//# sourceMappingURL=trust.js.map

package/lib/module/commercial/trust.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OFFICIAL_HOST_SUFFIXES","isLocalDevHost","hostname","host","toLowerCase","isOfficialGatewayHost","some","h","endsWith","isTrustedEntitlementHost","baseUrl","u","URL","includes","isAllowedGatewayUrl","allowLocalLab","ok","ipv4","test","reason"],"sourceRoot":"../../../src","sources":["commercial/trust.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA,MAAMA,sBAAsB,GAAG,CAC7B,wBAAwB,EACxB,yBAAyB,CAC1B;AAED,OAAO,SAASC,cAAcA,CAACC,QAAgB,EAAW;EACxD,MAAMC,IAAI,GAAGD,QAAQ,CAACE,WAAW,CAAC,CAAC;EACnC,OACED,IAAI,KAAK,WAAW,IACpBA,IAAI,KAAK,WAAW,IACpBA,IAAI,KAAK,UAAU,IACnBA,IAAI,KAAK,SAAS;AAEtB;AAEA,OAAO,SAASE,qBAAqBA,CAACH,QAAgB,EAAW;EAC/D,MAAMC,IAAI,GAAGD,QAAQ,CAACE,WAAW,CAAC,CAAC;EACnC,OAAOJ,sBAAsB,CAACM,IAAI,CAC/BC,CAAC,IAAKJ,IAAI,KAAKI,CAAC,IAAIJ,IAAI,CAACK,QAAQ,CAAC,IAAID,CAAC,EAAE,CAC5C,CAAC;AACH;;AAEA;AACA,OAAO,SAASE,wBAAwBA,CAACC,OAAe,EAAW;EACjE,IAAI;IACF,MAAMC,CAAC,GAAG,IAAIC,GAAG,CAACF,OAAO,CAACG,QAAQ,CAAC,KAAK,CAAC,GAAGH,OAAO,GAAG,WAAWA,OAAO,EAAE,CAAC;IAC3E,OAAOL,qBAAqB,CAACM,CAAC,CAACT,QAAQ,CAAC,IAAID,cAAc,CAACU,CAAC,CAACT,QAAQ,CAAC;EACxE,CAAC,CAAC,MAAM;IACN,OAAO,KAAK;EACd;AACF;;AAEA;AACA;AACA;AACA,OAAO,SAASY,mBAAmBA,CACjCJ,OAAe,EACfK,aAAsB,EACwB;EAC9C,IAAI;IACF,MAAMJ,CAAC,GAAG,IAAIC,GAAG,CAACF,OAAO,CAACG,QAAQ,CAAC,KAAK,CAAC,GAAGH,OAAO,GAAG,WAAWA,OAAO,EAAE,CAAC;IAC3E,IAAIL,qBAAqB,CAACM,CAAC,CAACT,QAAQ,CAAC,EAAE,OAAO;MAAEc,EAAE,EAAE;IAAK,CAAC;IAC1D,IAAID,aAAa,IAAId,cAAc,CAACU,CAAC,CAACT,QAAQ,CAAC,EAAE,OAAO;MAAEc,EAAE,EAAE;IAAK,CAAC;IACpE,IAAID,aAAa,EAAE;MACjB,MAAME,IAAI,GAAG,yBAAyB,CAACC,IAAI,CAACP,CAAC,CAACT,QAAQ,CAAC;MACvD,IAAIe,IAAI,EAAE,OAAO;QAAED,EAAE,EAAE;MAAK,CAAC;IAC/B;IACA,OAAO;MACLA,EAAE,EAAE,KAAK;MACTG,MAAM,EAAEJ,aAAa,GACjB,6BAA6BJ,CAAC,CAACT,QAAQ,EAAE,GACzC,6BAA6BS,CAAC,CAACT,QAAQ;IAC7C,CAAC;EACH,CAAC,CAAC,MAAM;IACN,OAAO;MAAEc,EAAE,EAAE,KAAK;MAAEG,MAAM,EAAE;IAA0B,CAAC;EACzD;AACF","ignoreList":[]}

package/lib/module/confirmation/gate.js

@@ -0,0 +1,54 @@
+"use strict";
+
+/**
+ * Irreversible / high-risk intents — confirmed once **before** the agent run.
+ * Ordinary list deletes are NOT sensitive.
+ */
+export const DEFAULT_SENSITIVE_PATTERNS = [/转账|转\s*\d|transfer|withdraw|send\s*(usdt|usdc|eth|btc)?/i, /授权|approve|export\s*(key|seed|mnemonic)|私钥|助记词/i, /删除(钱包|账户|账号|密钥)|永久删除|注销账户|销毁/i, /delete\s*(wallet|account|key|seed)|destroy\s*account/i, /confirm\s*(transfer|payment)|确认(转账|支付|授权)/i];
+export function isSensitiveLabel(label, policy) {
+  if (!label) return false;
+  const patterns = policy?.sensitivePatterns?.length ? policy.sensitivePatterns : DEFAULT_SENSITIVE_PATTERNS;
+  return patterns.some(re => re.test(label));
+}
+
+/** Goal looks like a high-risk operation → preflight confirm. */
+export function isSensitiveGoal(goal, policy) {
+  return isSensitiveLabel(goal, policy);
+}
+
+/**
+ * Mid-step gate (legacy). Prefer preflight; during unattended runs this should no-op.
+ */
+export async function runConfirmationGate(ctx, policy, onConfirm) {
+  const mode = policy?.mode ?? 'preflight';
+  if (mode === 'off' || mode === 'preflight') {
+    // Preflight already asked (or disabled). Never block mid-execution.
+    return true;
+  }
+  const requireConfirm = policy?.requireUserConfirm !== false;
+  if (!requireConfirm) return true;
+  const label = ctx.label ?? ctx.action;
+  if (!isSensitiveLabel(label, policy) && !isSensitiveLabel(ctx.action, policy)) {
+    return true;
+  }
+  if (!onConfirm) return false;
+  return onConfirm(ctx);
+}
+
+/**
+ * Ask once before the agent loop. Returns false if user declines.
+ */
+export async function runPreflightConfirm(goal, policy, onConfirm) {
+  const mode = policy?.mode ?? 'preflight';
+  if (mode === 'off') return true;
+  if (mode !== 'preflight' && mode !== 'inline') return true;
+  const requireConfirm = policy?.requireUserConfirm !== false;
+  if (!requireConfirm) return true;
+  if (!isSensitiveGoal(goal, policy)) return true;
+  if (!onConfirm) return false;
+  return onConfirm({
+    action: 'preflight',
+    label: goal
+  });
+}
+//# sourceMappingURL=gate.js.map

package/lib/module/confirmation/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_SENSITIVE_PATTERNS","isSensitiveLabel","label","policy","patterns","sensitivePatterns","length","some","re","test","isSensitiveGoal","goal","runConfirmationGate","ctx","onConfirm","mode","requireConfirm","requireUserConfirm","action","runPreflightConfirm"],"sourceRoot":"../../../src","sources":["confirmation/gate.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA,OAAO,MAAMA,0BAAoC,GAAG,CAClD,0DAA0D,EAC1D,iDAAiD,EACjD,+BAA+B,EAC/B,uDAAuD,EACvD,4CAA4C,CAC7C;AAED,OAAO,SAASC,gBAAgBA,CAC9BC,KAAyB,EACzBC,MAA2B,EAClB;EACT,IAAI,CAACD,KAAK,EAAE,OAAO,KAAK;EACxB,MAAME,QAAQ,GAAGD,MAAM,EAAEE,iBAAiB,EAAEC,MAAM,GAC9CH,MAAM,CAACE,iBAAiB,GACxBL,0BAA0B;EAC9B,OAAOI,QAAQ,CAACG,IAAI,CAAEC,EAAE,IAAKA,EAAE,CAACC,IAAI,CAACP,KAAK,CAAC,CAAC;AAC9C;;AAEA;AACA,OAAO,SAASQ,eAAeA,CAC7BC,IAAY,EACZR,MAA2B,EAClB;EACT,OAAOF,gBAAgB,CAACU,IAAI,EAAER,MAAM,CAAC;AACvC;;AAEA;AACA;AACA;AACA,OAAO,eAAeS,mBAAmBA,CACvCC,GAA4B,EAC5BV,MAAsC,EACtCW,SAA8D,EAC5C;EAClB,MAAMC,IAAI,GAAGZ,MAAM,EAAEY,IAAI,IAAI,WAAW;EACxC,IAAIA,IAAI,KAAK,KAAK,IAAIA,IAAI,KAAK,WAAW,EAAE;IAC1C;IACA,OAAO,IAAI;EACb;EAEA,MAAMC,cAAc,GAAGb,MAAM,EAAEc,kBAAkB,KAAK,KAAK;EAC3D,IAAI,CAACD,cAAc,EAAE,OAAO,IAAI;EAEhC,MAAMd,KAAK,GAAGW,GAAG,CAACX,KAAK,IAAIW,GAAG,CAACK,MAAM;EACrC,IAAI,CAACjB,gBAAgB,CAACC,KAAK,EAAEC,MAAM,CAAC,IAAI,CAACF,gBAAgB,CAACY,GAAG,CAACK,MAAM,EAAEf,MAAM,CAAC,EAAE;IAC7E,OAAO,IAAI;EACb;EAEA,IAAI,CAACW,SAAS,EAAE,OAAO,KAAK;EAC5B,OAAOA,SAAS,CAACD,GAAG,CAAC;AACvB;;AAEA;AACA;AACA;AACA,OAAO,eAAeM,mBAAmBA,CACvCR,IAAY,EACZR,MAAsC,EACtCW,SAA8D,EAC5C;EAClB,MAAMC,IAAI,GAAGZ,MAAM,EAAEY,IAAI,IAAI,WAAW;EACxC,IAAIA,IAAI,KAAK,KAAK,EAAE,OAAO,IAAI;EAC/B,IAAIA,IAAI,KAAK,WAAW,IAAIA,IAAI,KAAK,QAAQ,EAAE,OAAO,IAAI;EAE1D,MAAMC,cAAc,GAAGb,MAAM,EAAEc,kBAAkB,KAAK,KAAK;EAC3D,IAAI,CAACD,cAAc,EAAE,OAAO,IAAI;EAChC,IAAI,CAACN,eAAe,CAACC,IAAI,EAAER,MAAM,CAAC,EAAE,OAAO,IAAI;EAE/C,IAAI,CAACW,SAAS,EAAE,OAAO,KAAK;EAE5B,OAAOA,SAAS,CAAC;IACfI,MAAM,EAAE,WAAW;IACnBhB,KAAK,EAAES;EACT,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/cursor/CursorOverlay.js

@@ -0,0 +1,136 @@
+"use strict";
+
+import React, { useEffect, useRef, useState } from 'react';
+import { Animated, StyleSheet, View } from 'react-native';
+import { CursorController } from "./controller.js";
+import { useTaskStore } from "../task/useTaskStore.js";
+import { TaskStore } from "../task/TaskStore.js";
+import { KOKO_CURSOR_TEST_ID } from "../ui/KokoOverlayLayer.js";
+import { KokoHostOverlay } from "../ui/hostOverlay.js";
+import { useOverlayOrigin } from "../ui/useOverlayOrigin.js";
+import { PointerHand } from "./PointerHand.js";
+import { CURSOR_H, CURSOR_TIP_X, CURSOR_TIP_Y, CURSOR_W } from "./pointer.js";
+
+/**
+ * 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.
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+export function CursorOverlay() {
+  const [state, setState] = useState(CursorController.getState());
+  const {
+    tasks,
+    activeTaskId,
+    ui
+  } = useTaskStore();
+  const running = tasks.some(t => t.id === activeTaskId && t.status === 'running');
+  const anim = useRef(new Animated.ValueXY({
+    x: state.x,
+    y: state.y
+  })).current;
+  const press = useRef(new Animated.Value(0)).current;
+  const opacity = useRef(new Animated.Value(0)).current;
+  const chromeEpoch = ui.chromeEpoch ?? 0;
+  const {
+    ref: layerRef,
+    origin,
+    measure
+  } = useOverlayOrigin();
+  useEffect(() => CursorController.subscribe(setState), []);
+  useEffect(() => {
+    if (!running && state.visible) {
+      CursorController.hide();
+    }
+  }, [running, state.visible]);
+  useEffect(() => {
+    if (running && state.visible) {
+      TaskStore.liftChrome();
+    }
+  }, [running, state.visible, state.x, state.y]);
+  useEffect(() => {
+    const duration = Math.max(0, state.moveDurationMs ?? 0);
+    const to = {
+      x: state.x - origin.x - CURSOR_TIP_X,
+      y: state.y - origin.y - CURSOR_TIP_Y
+    };
+    if (duration <= 0) {
+      anim.stopAnimation();
+      anim.setValue(to);
+      return;
+    }
+    Animated.timing(anim, {
+      toValue: to,
+      duration,
+      // Reduce native animation work while Fabric registers views during navigation.
+      useNativeDriver: false
+    }).start();
+  }, [state.x, state.y, state.moveDurationMs, origin.x, origin.y, anim]);
+  useEffect(() => {
+    Animated.spring(press, {
+      toValue: state.pressing ? 1 : 0,
+      useNativeDriver: false,
+      friction: 6
+    }).start();
+  }, [state.pressing, press]);
+  const show = running && state.visible;
+  useEffect(() => {
+    if (show) {
+      opacity.stopAnimation();
+      opacity.setValue(1);
+      return;
+    }
+    Animated.timing(opacity, {
+      toValue: 0,
+      duration: 80,
+      useNativeDriver: false
+    }).start();
+  }, [show, opacity]);
+  if (!show) return null;
+  const scale = press.interpolate({
+    inputRange: [0, 1],
+    outputRange: [1, 0.88]
+  });
+  return /*#__PURE__*/_jsx(KokoHostOverlay, {
+    liftToken: chromeEpoch,
+    children: /*#__PURE__*/_jsx(View, {
+      ref: layerRef,
+      onLayout: measure,
+      testID: KOKO_CURSOR_TEST_ID,
+      nativeID: KOKO_CURSOR_TEST_ID,
+      collapsable: false,
+      pointerEvents: "none",
+      style: styles.layer,
+      accessibilityElementsHidden: true,
+      importantForAccessibility: "no-hide-descendants",
+      children: /*#__PURE__*/_jsx(Animated.View, {
+        style: [styles.cursor, {
+          opacity,
+          transform: [...anim.getTranslateTransform(), {
+            scale
+          }]
+        }],
+        children: /*#__PURE__*/_jsx(PointerHand, {})
+      })
+    })
+  });
+}
+const styles = StyleSheet.create({
+  layer: {
+    ...StyleSheet.absoluteFillObject,
+    backgroundColor: 'transparent'
+  },
+  cursor: {
+    position: 'absolute',
+    width: CURSOR_W,
+    height: CURSOR_H,
+    left: 0,
+    top: 0
+  }
+});
+//# sourceMappingURL=CursorOverlay.js.map

package/lib/module/cursor/CursorOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","useEffect","useRef","useState","Animated","StyleSheet","View","CursorController","useTaskStore","TaskStore","KOKO_CURSOR_TEST_ID","KokoHostOverlay","useOverlayOrigin","PointerHand","CURSOR_H","CURSOR_TIP_X","CURSOR_TIP_Y","CURSOR_W","jsx","_jsx","CursorOverlay","state","setState","getState","tasks","activeTaskId","ui","running","some","t","id","status","anim","ValueXY","x","y","current","press","Value","opacity","chromeEpoch","ref","layerRef","origin","measure","subscribe","visible","hide","liftChrome","duration","Math","max","moveDurationMs","to","stopAnimation","setValue","timing","toValue","useNativeDriver","start","spring","pressing","friction","show","scale","interpolate","inputRange","outputRange","liftToken","children","onLayout","testID","nativeID","collapsable","pointerEvents","style","styles","layer","accessibilityElementsHidden","importantForAccessibility","cursor","transform","getTranslateTransform","create","absoluteFillObject","backgroundColor","position","width","height","left","top"],"sourceRoot":"../../../src","sources":["cursor/CursorOverlay.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/cursor/PointerHand.js

@@ -0,0 +1,47 @@
+"use strict";
+
+import React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { CURSOR_H, CURSOR_W, HAND_SHAPES, HAND_UNIT, HAND_STROKE } from "./pointer.js";
+
+/**
+ * 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.
+ */
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+export function PointerHand() {
+  return /*#__PURE__*/_jsxs(View, {
+    style: styles.hand,
+    pointerEvents: "none",
+    children: [renderLayer(HAND_STROKE, '#131313'), renderLayer(0, '#FFFFFF')]
+  });
+}
+function renderLayer(inflate, color) {
+  return HAND_SHAPES.map(([x, y, w, h, r], i) => /*#__PURE__*/_jsx(View, {
+    style: {
+      position: 'absolute',
+      left: (x - inflate) * HAND_UNIT,
+      top: (y - inflate) * HAND_UNIT,
+      width: (w + inflate * 2) * HAND_UNIT,
+      height: (h + inflate * 2) * HAND_UNIT,
+      borderRadius: (r + inflate) * HAND_UNIT,
+      backgroundColor: color
+    }
+  }, `${color}-${i}`));
+}
+const styles = StyleSheet.create({
+  hand: {
+    width: CURSOR_W,
+    height: CURSOR_H
+  }
+});
+//# sourceMappingURL=PointerHand.js.map

package/lib/module/cursor/PointerHand.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","StyleSheet","View","CURSOR_H","CURSOR_W","HAND_SHAPES","HAND_UNIT","HAND_STROKE","jsxs","_jsxs","jsx","_jsx","PointerHand","style","styles","hand","pointerEvents","children","renderLayer","inflate","color","map","x","y","w","h","r","i","position","left","top","width","height","borderRadius","backgroundColor","create"],"sourceRoot":"../../../src","sources":["cursor/PointerHand.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,UAAU,EAAEC,IAAI,QAAQ,cAAc;AAC/C,SAASC,QAAQ,EAAEC,QAAQ,EAAEC,WAAW,EAAEC,SAAS,EAAEC,WAAW,QAAQ,cAAW;;AAEnF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAZA,SAAAC,IAAA,IAAAC,KAAA,EAAAC,GAAA,IAAAC,IAAA;AAaA,OAAO,SAASC,WAAWA,CAAA,EAAG;EAC5B,oBACEH,KAAA,CAACP,IAAI;IAACW,KAAK,EAAEC,MAAM,CAACC,IAAK;IAACC,aAAa,EAAC,MAAM;IAAAC,QAAA,GAC3CC,WAAW,CAACX,WAAW,EAAE,SAAS,CAAC,EACnCW,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC;EAAA,CACtB,CAAC;AAEX;AAEA,SAASA,WAAWA,CAACC,OAAe,EAAEC,KAAa,EAAE;EACnD,OAAOf,WAAW,CAACgB,GAAG,CAAC,CAAC,CAACC,CAAC,EAAEC,CAAC,EAAEC,CAAC,EAAEC,CAAC,EAAEC,CAAC,CAAC,EAAEC,CAAC,kBACxChB,IAAA,CAACT,IAAI;IAEHW,KAAK,EAAE;MACLe,QAAQ,EAAE,UAAU;MACpBC,IAAI,EAAE,CAACP,CAAC,GAAGH,OAAO,IAAIb,SAAS;MAC/BwB,GAAG,EAAE,CAACP,CAAC,GAAGJ,OAAO,IAAIb,SAAS;MAC9ByB,KAAK,EAAE,CAACP,CAAC,GAAGL,OAAO,GAAG,CAAC,IAAIb,SAAS;MACpC0B,MAAM,EAAE,CAACP,CAAC,GAAGN,OAAO,GAAG,CAAC,IAAIb,SAAS;MACrC2B,YAAY,EAAE,CAACP,CAAC,GAAGP,OAAO,IAAIb,SAAS;MACvC4B,eAAe,EAAEd;IACnB;EAAE,GATG,GAAGA,KAAK,IAAIO,CAAC,EAUnB,CACF,CAAC;AACJ;AAEA,MAAMb,MAAM,GAAGb,UAAU,CAACkC,MAAM,CAAC;EAC/BpB,IAAI,EAAE;IACJgB,KAAK,EAAE3B,QAAQ;IACf4B,MAAM,EAAE7B;EACV;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/module/cursor/controller.js

@@ -0,0 +1,87 @@
+"use strict";
+
+const DEFAULT = {
+  visible: false,
+  x: 0,
+  y: 0,
+  pressing: false,
+  moveDurationMs: 0
+};
+
+/**
+ * Imperative cursor controller used by KokoAgent; CursorOverlay subscribes.
+ */
+class CursorControllerImpl {
+  state = {
+    ...DEFAULT
+  };
+  listeners = new Set();
+  subscribe(listener) {
+    this.listeners.add(listener);
+    listener(this.state);
+    return () => this.listeners.delete(listener);
+  }
+  getState() {
+    return this.state;
+  }
+  emit() {
+    for (const l of this.listeners) l(this.state);
+  }
+  showAt(x, y, moveDurationMs = 0) {
+    this.state = {
+      ...this.state,
+      visible: true,
+      x,
+      y,
+      moveDurationMs
+    };
+    this.emit();
+  }
+  hide() {
+    this.state = {
+      ...DEFAULT
+    };
+    this.emit();
+  }
+  setPressing(pressing) {
+    this.state = {
+      ...this.state,
+      pressing
+    };
+    this.emit();
+  }
+
+  /**
+   * Start moving toward the target immediately, then resolve when the
+   * visual move should have finished — so tap happens after the cursor arrives.
+   */
+  async moveTo(x, y, durationMs) {
+    const ms = Math.max(0, Math.floor(durationMs));
+
+    // First appearance: snap near target so we don't fly in from (0,0).
+    // Wait long enough for CursorOverlay's transparent Modal to present
+    // (hosts with native-stack often need >100ms; 32ms left it invisible).
+    if (!this.state.visible) {
+      this.showAt(x, y, 0);
+      await sleep(140);
+      return;
+    }
+    const dx = x - this.state.x;
+    const dy = y - this.state.y;
+    const dist = Math.hypot(dx, dy);
+    // Tiny hops: snap; longer moves: animate, then wait for arrival.
+    if (dist < 8 || ms === 0) {
+      this.showAt(x, y, 0);
+      await sleep(24);
+      return;
+    }
+    this.showAt(x, y, ms);
+    // Allow React to start Animated.timing, then wait for arrival.
+    await sleep(ms + 24);
+  }
+}
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+export const CursorController = new CursorControllerImpl();
+//# sourceMappingURL=controller.js.map

package/lib/module/cursor/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT","visible","x","y","pressing","moveDurationMs","CursorControllerImpl","state","listeners","Set","subscribe","listener","add","delete","getState","emit","l","showAt","hide","setPressing","moveTo","durationMs","ms","Math","max","floor","sleep","dx","dy","dist","hypot","Promise","resolve","setTimeout","CursorController"],"sourceRoot":"../../../src","sources":["cursor/controller.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/cursor/pointer.js

@@ -0,0 +1,45 @@
+"use strict";
+
+/**
+ * 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.
+ */
+
+/** Design grid the hand is laid out on. */
+const GRID_W = 34;
+const GRID_H = 44;
+
+/** Keep the grid ratio so the drawing is not squashed. */
+export const CURSOR_W = 26;
+export const CURSOR_H = Math.round(CURSOR_W * GRID_H / GRID_W);
+
+/** Points per grid unit. */
+export const HAND_UNIT = CURSOR_W / GRID_W;
+
+/** Outline weight, in grid units. */
+export 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 const HAND_SHAPES = [[10, 1.5, 7, 24.5, 3.5],
+// index finger, extended — its tip is the hotspot
+[16.5, 17, 6.5, 13, 3.2],
+// middle, folded
+[21.5, 19, 6.5, 12, 3.2],
+// ring, folded
+[26, 21.5, 5.5, 10.5, 2.7],
+// little, folded
+[7, 24, 24, 18, 6.5],
+// palm
+[2.5, 27, 9.5, 7, 3.5] // thumb, across the side of the palm
+];
+
+/** The index fingertip — this is what lands on the tap coordinate. */
+export const CURSOR_TIP_X = 13.5 * HAND_UNIT;
+export const CURSOR_TIP_Y = 0.6 * HAND_UNIT;
+//# sourceMappingURL=pointer.js.map

package/lib/module/cursor/pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["GRID_W","GRID_H","CURSOR_W","CURSOR_H","Math","round","HAND_UNIT","HAND_STROKE","HAND_SHAPES","CURSOR_TIP_X","CURSOR_TIP_Y"],"sourceRoot":"../../../src","sources":["cursor/pointer.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,MAAMA,MAAM,GAAG,EAAE;AACjB,MAAMC,MAAM,GAAG,EAAE;;AAEjB;AACA,OAAO,MAAMC,QAAQ,GAAG,EAAE;AAC1B,OAAO,MAAMC,QAAQ,GAAGC,IAAI,CAACC,KAAK,CAAEH,QAAQ,GAAGD,MAAM,GAAID,MAAM,CAAC;;AAEhE;AACA,OAAO,MAAMM,SAAS,GAAGJ,QAAQ,GAAGF,MAAM;;AAE1C;AACA,OAAO,MAAMO,WAAW,GAAG,GAAG;;AAE9B;AACA;AACA;AACA;AACA,OAAO,MAAMC,WAEZ,GAAG,CACF,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC;AAAE;AACzB,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC;AAAE;AAC1B,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC;AAAE;AAC1B,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC;AAAE;AAC5B,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC;AAAE;AACtB,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAAE;AAAA,CACzB;;AAED;AACA,OAAO,MAAMC,YAAY,GAAG,IAAI,GAAGH,SAAS;AAC5C,OAAO,MAAMI,YAAY,GAAG,GAAG,GAAGJ,SAAS","ignoreList":[]}