@intentcomputing/koko-agent-sdk 1.0.1

package/lib/module/privacy/userGate.js

@@ -0,0 +1,202 @@
+"use strict";
+
+import { message, resolveText } from "../i18n/index.js";
+import { sensitiveScreenKind } from "./sensitiveScreen.js";
+import { isPrivateInput, isSdkChrome, isSystemSheet, nodeLabels, PRIVATE_INPUT_PROMPT_RE, staticScreenLabels } from "./screenEvidence.js";
+
+/**
+ * Sensitive steps the agent must NOT automate:
+ * user completes them in the App (or system UI), then the run resumes.
+ */
+
+const PASSWORD_RE = /密码|支付密码|交易密码|登录密码|安全码|设置密码|确认密码|创建密码|输入密码|passcode|password|passwd|\bpin\b|\bcvv\b|\botp\b|验证码|短信验证|set\s*passcode|confirm\s*passcode/i;
+const AUTH_RE = /继续使用\s*(google|apple|github)|sign\s*in\s*with|oauth|授权登录|授权连接|连接硬件|配对|pair\s*device|connect\s*wallet|walletconnect|批准|approve\s*(request|connection)|允许此|允许访问/i;
+const BIO_RE = /面容|指纹|触控\s*id|face\s*id|touch\s*id|biometric|生物识别|解锁以/i;
+const PERMISSION_RE = /(?:想|希望|请求|需要).{0,16}(?:访问|使用|发送通知|获取|拍摄|录音)|是否允许|允许.{0,24}(?:访问|使用|拍摄|录音|定位|相机|蓝牙|麦克风|照片)|(?:would\s+like|wants?|requests?)\s+to\s+(?:access|use|send|record)|allow\s+(?:access\s+to|use\s+of)/i;
+const CONSENT_RE = /我已备份|我明白风险|同意并继续|接受条款|i\s+(?:have\s+backed\s+up|understand\s+the\s+risks)|agree\s+and\s+continue|accept\s+(?:the\s+)?terms/i;
+function labelOf(n) {
+  return nodeLabels(n).join(' ');
+}
+function classifyByLabel(label, secure) {
+  if (/验证码|otp|sms/i.test(label)) return 'otp';
+  if (/\bpin\b|passcode|安全码/i.test(label)) return 'pin';
+  if (secure || /密码|password|passwd/i.test(label)) return 'password';
+  if (BIO_RE.test(label)) return 'biometric';
+  if (PERMISSION_RE.test(label)) return 'permission';
+  if (CONSENT_RE.test(label)) return 'consent';
+  if (AUTH_RE.test(label)) return 'authorization';
+  if (PASSWORD_RE.test(label)) return 'secure_input';
+  return 'secure_input';
+}
+/**
+ * Host-declared sensitive gate (passcode / OAuth / permissions…).
+ * Preferred when Fabric dump misses the real controls.
+ */
+class AppUserGateStoreImpl {
+  hostGate = null;
+  /** User tapped「已完成」— clears until host sets a new gate. */
+  manualResumeAt = 0;
+  listeners = new Set();
+  setHostGate(gate) {
+    this.hostGate = gate ? {
+      kind: gate.kind,
+      label: String(gate.label || '需要你完成').slice(0, 80),
+      nodeId: String(gate.nodeId || 'host:gate').slice(0, 80)
+    } : null;
+    if (gate) this.manualResumeAt = 0;
+    this.emit();
+  }
+
+  /** User confirms they finished the sensitive App / system step. */
+  signalDone() {
+    this.hostGate = null;
+    this.manualResumeAt = Date.now();
+    this.emit();
+  }
+
+  /** Recheck only: the UI must not clear a host-declared private step. */
+  requestCheck() {
+    this.manualResumeAt = Date.now();
+    this.emit();
+  }
+  getHostGate() {
+    return this.hostGate;
+  }
+  wasManuallyResumedSince(sinceMs) {
+    return this.manualResumeAt > 0 && this.manualResumeAt >= sinceMs;
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    listener(this.hostGate);
+    return () => this.listeners.delete(listener);
+  }
+  emit() {
+    for (const l of this.listeners) l(this.hostGate);
+  }
+}
+export const AppUserGateStore = new AppUserGateStoreImpl();
+
+/** Host: current screen needs the user to finish a sensitive step. */
+export function setAppUserGate(gate) {
+  AppUserGateStore.setHostGate({
+    kind: gate.kind,
+    label: gate.label,
+    nodeId: gate.nodeId ?? `host:gate:${gate.kind}`
+  });
+}
+export function clearAppUserGate() {
+  AppUserGateStore.setHostGate(null);
+}
+export function signalAppUserGateDone() {
+  AppUserGateStore.signalDone();
+}
+export function signalAppUserGateCheck() {
+  AppUserGateStore.requestCheck();
+}
+
+/**
+ * Detect App / system steps the user must complete themselves.
+ * Merges host registration with dump heuristics.
+ */
+export function detectAppUserGate(root) {
+  const host = AppUserGateStore.getHostGate();
+  if (host) return host;
+  if (!root) return null;
+  const sensitive = sensitiveScreenKind(root);
+  if (sensitive) {
+    return {
+      kind: sensitive,
+      label: '请在 App 内完成隐私步骤',
+      nodeId: 'local-private-screen'
+    };
+  }
+  let hit = null;
+  // All permission evidence must belong to this modal, never its background.
+  const sheetPermission = sheet => {
+    const labels = [];
+    const collect = n => {
+      if (n.visible === false || isSdkChrome(n)) return;
+      labels.push(...nodeLabels(n));
+      for (const child of n.children) collect(child);
+    };
+    collect(sheet);
+    return /相机|蓝牙|麦克风|相册|通知|定位|权限|camera|bluetooth|microphone|photos|notifications|location|permission/i.test(labels.join(' ')) && labels.some(label => /^(?:允许|始终允许|使用期间允许|仅本次允许|allow(?:\s+access)?|while using(?: the app)?|only this time)$/i.test(label)) && labels.some(label => /^(?:不允许|拒绝|稍后|don.t allow|deny|not now)$/i.test(label));
+  };
+  const walk = n => {
+    if (hit || isSdkChrome(n) || n.visible === false) return;
+    if (isSystemSheet(n) && sheetPermission(n)) {
+      hit = {
+        kind: 'permission',
+        label: 'System permission request',
+        nodeId: n.id
+      };
+      return;
+    }
+    const label = labelOf(n);
+    const secure = n.secure === true;
+    if (isPrivateInput(n)) {
+      hit = {
+        kind: classifyByLabel(label, secure),
+        label: '请在 App 内完成安全输入',
+        nodeId: n.id
+      };
+      return;
+    }
+
+    // Affirmative legal/risk consent is a real user decision even as a button.
+    if (n.clickable && nodeLabels(n).some(text => text.length <= 80 && CONSENT_RE.test(text))) {
+      hit = {
+        kind: 'consent',
+        label: '请在 App 内确认风险或条款',
+        nodeId: n.id
+      };
+      return;
+    }
+    for (const c of n.children) walk(c);
+  };
+  walk(root);
+  if (hit) return hit;
+  // A short menu is still a menu. Only static requests, actual inputs, modal
+  // evidence or explicit host declarations can establish a waiting gate.
+  for (const {
+    node,
+    label
+  } of staticScreenLabels(root)) {
+    if (label.length > 160) continue;
+    const password = PRIVATE_INPUT_PROMPT_RE.test(label);
+    const biometric = BIO_RE.test(label) && /请|验证|认证|解锁|verify|authenticate|unlock|use .+ to/i.test(label);
+    const authorization = AUTH_RE.test(label) && /请|等待|批准|授权|sign\s*in\s*with|approve|authorize|confirm|pair\s*device/i.test(label);
+    if (password || PERMISSION_RE.test(label) || CONSENT_RE.test(label) || biometric || authorization) {
+      return {
+        kind: classifyByLabel(label, false),
+        label,
+        nodeId: node.id
+      };
+    }
+  }
+  return hit;
+}
+export function gateMessageValue(gate, fallbackLocale) {
+  const keys = {
+    recovery_phrase: 'runtime.recoveryPhrase',
+    private_key: 'runtime.privateKey',
+    password: 'runtime.password',
+    pin: 'runtime.pin',
+    otp: 'runtime.otp',
+    authorization: 'runtime.authorization',
+    biometric: 'runtime.biometric',
+    permission: 'runtime.permission',
+    consent: 'runtime.consent'
+  };
+  return message(keys[gate.kind] ?? 'runtime.sensitiveStep', undefined, fallbackLocale);
+}
+export function gateMessage(gate) {
+  return resolveText(gateMessageValue(gate));
+}
+
+/** Planner hint — never type secrets or fake authorizations. */
+export function userGateModelText(gate) {
+  if (!gate) return '';
+  return `- [gate:${gate.kind}] 「${gate.label}」— 等待用户在 App/系统内完成，禁止 type / 禁止代填密钥密码 / 禁止伪造授权`;
+}
+//# sourceMappingURL=userGate.js.map

package/lib/module/privacy/userGate.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["message","resolveText","sensitiveScreenKind","isPrivateInput","isSdkChrome","isSystemSheet","nodeLabels","PRIVATE_INPUT_PROMPT_RE","staticScreenLabels","PASSWORD_RE","AUTH_RE","BIO_RE","PERMISSION_RE","CONSENT_RE","labelOf","n","join","classifyByLabel","label","secure","test","AppUserGateStoreImpl","hostGate","manualResumeAt","listeners","Set","setHostGate","gate","kind","String","slice","nodeId","emit","signalDone","Date","now","requestCheck","getHostGate","wasManuallyResumedSince","sinceMs","subscribe","listener","add","delete","l","AppUserGateStore","setAppUserGate","clearAppUserGate","signalAppUserGateDone","signalAppUserGateCheck","detectAppUserGate","root","host","sensitive","hit","sheetPermission","sheet","labels","collect","visible","push","child","children","some","walk","id","clickable","text","length","c","node","password","biometric","authorization","gateMessageValue","fallbackLocale","keys","recovery_phrase","private_key","pin","otp","permission","consent","undefined","gateMessage","userGateModelText"],"sourceRoot":"../../../src","sources":["privacy/userGate.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/protocol/actions.js

@@ -0,0 +1,108 @@
+"use strict";
+
+/**
+ * Execute one cloud-agent tool call against the local SDK.
+ */
+export async function executeAgentAction(agent, action) {
+  try {
+    switch (action.tool) {
+      case 'dump':
+        {
+          const tree = await agent.dump(action.args);
+          return {
+            ok: true,
+            tool: 'dump',
+            tree
+          };
+        }
+      case 'find':
+        {
+          const node = await agent.find(action.args.selector);
+          return {
+            ok: true,
+            tool: 'find',
+            node
+          };
+        }
+      case 'findAll':
+        {
+          const nodes = await agent.findAll(action.args.selector);
+          return {
+            ok: true,
+            tool: 'findAll',
+            nodes
+          };
+        }
+      case 'tap':
+        {
+          await agent.tap({
+            selector: action.args.selector,
+            nodeId: action.args.nodeId,
+            point: action.args.point,
+            options: action.args.options
+          });
+          return {
+            ok: true,
+            tool: 'tap'
+          };
+        }
+      case 'swipe':
+        {
+          await agent.swipe(action.args.from, action.args.to, action.args.options);
+          return {
+            ok: true,
+            tool: 'swipe'
+          };
+        }
+      case 'pinch':
+        {
+          await agent.pinch(action.args.center, action.args.scale, action.args.options);
+          return {
+            ok: true,
+            tool: 'pinch'
+          };
+        }
+      case 'type':
+        {
+          await agent.type(action.args.text, {
+            selector: action.args.selector,
+            nodeId: action.args.nodeId,
+            options: action.args.options
+          });
+          return {
+            ok: true,
+            tool: 'type'
+          };
+        }
+      case 'confirm':
+        {
+          const confirmed = await agent.requestConfirm({
+            action: action.args.action ?? 'confirm',
+            label: action.args.label
+          });
+          return {
+            ok: true,
+            tool: 'confirm',
+            confirmed
+          };
+        }
+      default:
+        {
+          const _exhaustive = action;
+          return {
+            ok: false,
+            tool: 'dump',
+            error: `Unknown tool: ${JSON.stringify(_exhaustive)}`
+          };
+        }
+    }
+  } catch (e) {
+    const message = e instanceof Error ? e.message : String(e);
+    return {
+      ok: false,
+      tool: action.tool,
+      error: message
+    };
+  }
+}
+//# sourceMappingURL=actions.js.map

package/lib/module/protocol/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["executeAgentAction","agent","action","tool","tree","dump","args","ok","node","find","selector","nodes","findAll","tap","nodeId","point","options","swipe","from","to","pinch","center","scale","type","text","confirmed","requestConfirm","label","_exhaustive","error","JSON","stringify","e","message","Error","String"],"sourceRoot":"../../../src","sources":["protocol/actions.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/provider/HostAppearanceStore.js

@@ -0,0 +1,101 @@
+"use strict";
+
+/**
+ * Runtime host appearance (locale / theme). Prefer this over static
+ * `config.locale` / `config.theme` so the host can follow its own settings.
+ */
+class HostAppearanceStoreImpl {
+  state = {};
+  listeners = new Set();
+  get() {
+    return this.state;
+  }
+  set(partial) {
+    const next = {
+      locale: partial.locale !== undefined ? partial.locale : this.state.locale,
+      theme: partial.theme !== undefined ? partial.theme : this.state.theme
+    };
+    if (next.locale === this.state.locale && next.theme === this.state.theme) {
+      return;
+    }
+    this.state = next;
+    for (const l of this.listeners) l();
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+}
+export const HostAppearanceStore = new HostAppearanceStoreImpl();
+
+/** Imperative API for hosts (OneKey / shop / etc.). */
+export function setKokoAppearance(partial) {
+  HostAppearanceStore.set(partial);
+}
+export function getKokoAppearance() {
+  return HostAppearanceStore.get();
+}
+const DARK = {
+  mode: 'dark',
+  sheetBg: '#121316',
+  overlay: 'rgba(8, 10, 14, 0.58)',
+  text: '#F5F5F7',
+  textSecondary: 'rgba(255,255,255,0.72)',
+  textMuted: 'rgba(255,255,255,0.45)',
+  border: 'rgba(255,255,255,0.1)',
+  inputBg: 'rgba(255,255,255,0.06)',
+  chipBg: 'rgba(255,255,255,0.05)',
+  userBubble: 'rgba(10,132,255,0.18)',
+  handle: 'rgba(255,255,255,0.22)',
+  progressBg: 'rgba(20,20,22,0.94)',
+  progressText: '#fff',
+  dialogBg: '#1C1C1E',
+  statusBar: 'light-content'
+};
+const LIGHT = {
+  mode: 'light',
+  sheetBg: '#FFFFFF',
+  overlay: 'rgba(0, 0, 0, 0.48)',
+  text: '#111827',
+  textSecondary: 'rgba(17,24,39,0.72)',
+  textMuted: 'rgba(17,24,39,0.45)',
+  border: 'rgba(17,24,39,0.1)',
+  inputBg: 'rgba(17,24,39,0.05)',
+  chipBg: 'rgba(17,24,39,0.04)',
+  userBubble: 'rgba(10,132,255,0.12)',
+  handle: 'rgba(17,24,39,0.18)',
+  progressBg: 'rgba(255,255,255,0.96)',
+  progressText: '#111827',
+  dialogBg: '#FFFFFF',
+  statusBar: 'dark-content'
+};
+export function resolveThemeColors(theme) {
+  return theme === 'light' ? LIGHT : DARK;
+}
+
+/**
+ * Theme for Koko chrome, given the host App's theme.
+ *
+ * Inverted on purpose: the progress pill, chat sheet and dialogs sit above the
+ * host UI as a distinct surface. Matching the App makes them blend into
+ * whatever is behind them; opposing it keeps the boundary obvious.
+ *
+ * A host that reports nothing is assumed light, which keeps chrome dark — the
+ * SDK's long-standing default.
+ */
+export function invertTheme(appTheme) {
+  return appTheme === 'dark' ? 'light' : 'dark';
+}
+
+/** Chrome colors for a host App running `appTheme`. */
+export function resolveChromeColors(appTheme) {
+  return resolveThemeColors(invertTheme(appTheme));
+}
+
+/** Resolve effective locale: host appearance → config → en. */
+export function resolveEffectiveLocale(hostLocale, configLocale) {
+  return hostLocale ?? configLocale;
+}
+//# sourceMappingURL=HostAppearanceStore.js.map

package/lib/module/provider/HostAppearanceStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["HostAppearanceStoreImpl","state","listeners","Set","get","set","partial","next","locale","undefined","theme","l","subscribe","listener","add","delete","HostAppearanceStore","setKokoAppearance","getKokoAppearance","DARK","mode","sheetBg","overlay","text","textSecondary","textMuted","border","inputBg","chipBg","userBubble","handle","progressBg","progressText","dialogBg","statusBar","LIGHT","resolveThemeColors","invertTheme","appTheme","resolveChromeColors","resolveEffectiveLocale","hostLocale","configLocale"],"sourceRoot":"../../../src","sources":["provider/HostAppearanceStore.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/provider/KokoProvider.js

@@ -0,0 +1,74 @@
+"use strict";
+
+import React, { createContext, useContext, useEffect, useMemo, useRef } from 'react';
+import { StyleSheet, View } from 'react-native';
+import { CursorOverlay } from "../cursor/CursorOverlay.js";
+import { getKokoAgent, initKokoAgent } from "../KokoAgent.js";
+import { KokoDialogHost } from "../ui/KokoDialogHost.js";
+import { KokoObserver } from "../ui/KokoObserver.js";
+import { KokoRemoteSmoke } from "../debug/KokoRemoteSmoke.js";
+import { KokoUiProvider } from "./KokoUiContext.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const KokoContext = /*#__PURE__*/createContext(null);
+export function KokoProvider({
+  children,
+  config,
+  cursor = true,
+  observer,
+  composerPlaceholder,
+  dialogs = true,
+  remoteSmokePort,
+  resumeAfterReload = true
+}) {
+  const mergedConfig = useMemo(() => {
+    if (!config && !composerPlaceholder) return config;
+    return {
+      ...config,
+      branding: {
+        ...config?.branding,
+        placeholder: config?.branding?.placeholder ?? composerPlaceholder
+      }
+    };
+  }, [config, composerPlaceholder]);
+  const agent = useMemo(() => {
+    if (mergedConfig) return initKokoAgent(mergedConfig);
+    return getKokoAgent();
+  }, [mergedConfig]);
+  const showObserver = observer ?? mergedConfig?.observer !== false;
+  const smokePort = remoteSmokePort ?? 0;
+  const resumeTried = useRef(false);
+  useEffect(() => {
+    if (!resumeAfterReload || resumeTried.current) return;
+    resumeTried.current = true;
+    // Let the host finish remounting its navigator first, or the resumed run
+    // plans against a half-built tree.
+    const timer = setTimeout(() => {
+      void agent.resumeInterruptedRun().catch(() => {});
+    }, 1500);
+    return () => clearTimeout(timer);
+  }, [agent, resumeAfterReload]);
+  return /*#__PURE__*/_jsx(KokoContext.Provider, {
+    value: agent,
+    children: /*#__PURE__*/_jsx(KokoUiProvider, {
+      config: mergedConfig,
+      children: /*#__PURE__*/_jsxs(View, {
+        style: styles.root,
+        children: [children, cursor && !showObserver ? /*#__PURE__*/_jsx(CursorOverlay, {}) : null, showObserver ? /*#__PURE__*/_jsx(KokoObserver, {
+          cursor: cursor
+        }) : null, dialogs ? /*#__PURE__*/_jsx(KokoDialogHost, {}) : null, smokePort > 0 ? /*#__PURE__*/_jsx(KokoRemoteSmoke, {
+          port: smokePort
+        }) : null]
+      })
+    })
+  });
+}
+export function useKokoAgent() {
+  const ctx = useContext(KokoContext);
+  return ctx ?? getKokoAgent();
+}
+const styles = StyleSheet.create({
+  root: {
+    flex: 1
+  }
+});
+//# sourceMappingURL=KokoProvider.js.map

package/lib/module/provider/KokoProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useContext","useEffect","useMemo","useRef","StyleSheet","View","CursorOverlay","getKokoAgent","initKokoAgent","KokoDialogHost","KokoObserver","KokoRemoteSmoke","KokoUiProvider","jsx","_jsx","jsxs","_jsxs","KokoContext","KokoProvider","children","config","cursor","observer","composerPlaceholder","dialogs","remoteSmokePort","resumeAfterReload","mergedConfig","branding","placeholder","agent","showObserver","smokePort","resumeTried","current","timer","setTimeout","resumeInterruptedRun","catch","clearTimeout","Provider","value","style","styles","root","port","useKokoAgent","ctx","create","flex"],"sourceRoot":"../../../src","sources":["provider/KokoProvider.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/provider/KokoUiContext.js

@@ -0,0 +1,96 @@
+"use strict";
+
+import React, { createContext, useContext, useEffect, useMemo, useRef } from 'react';
+import { useSyncExternalStore } from 'react';
+import { AccountStore } from "../commercial/AccountStore.js";
+import { resolveBranding } from "../commercial/branding.js";
+import { UsageBus } from "../commercial/UsageBus.js";
+import { normalizeLocale, t } from "../i18n/index.js";
+import { HostAppearanceStore, invertTheme, resolveThemeColors } from "./HostAppearanceStore.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const KokoUiContext = /*#__PURE__*/createContext(null);
+function subscribeAccount(cb) {
+  return AccountStore.subscribe(() => cb());
+}
+function getAccountSnapshot() {
+  return AccountStore.get();
+}
+function subscribeAppearance(cb) {
+  return HostAppearanceStore.subscribe(cb);
+}
+function getAppearanceSnapshot() {
+  return HostAppearanceStore.get();
+}
+export function KokoUiProvider({
+  config,
+  children
+}) {
+  const appearance = useSyncExternalStore(subscribeAppearance, getAppearanceSnapshot, getAppearanceSnapshot);
+  const locale = normalizeLocale(appearance.locale ?? config?.locale);
+  // `theme` names the host App's theme; chrome takes the other one so it stays
+  // readable against the App behind it. Absent a report, assume a light App —
+  // that keeps chrome dark, as it has always been.
+  const appTheme = appearance.theme ?? config?.theme ?? 'light';
+  const theme = invertTheme(appTheme);
+  const colors = useMemo(() => resolveThemeColors(theme), [theme]);
+  const account = useSyncExternalStore(subscribeAccount, getAccountSnapshot, getAccountSnapshot);
+  const downgradeEmitted = useRef(false);
+  useEffect(() => {
+    const unsub = config?.onUsageEvent ? UsageBus.subscribe(config.onUsageEvent) : undefined;
+    return () => {
+      unsub?.();
+    };
+  }, [config?.onUsageEvent]);
+  useEffect(() => {
+    const token = config?.gateway?.token;
+    if (!token) return;
+    void AccountStore.refresh({
+      token,
+      baseUrl: config?.gateway?.baseUrl
+    });
+  }, [config?.gateway?.token, config?.gateway?.baseUrl]);
+  const branding = useMemo(() => resolveBranding(locale, config?.branding, account?.entitlements), [locale, config?.branding, account?.entitlements]);
+  useEffect(() => {
+    if (branding.downgraded && !downgradeEmitted.current) {
+      downgradeEmitted.current = true;
+      UsageBus.emit({
+        type: 'branding_downgraded',
+        reason: 'missing_entitlement',
+        at: Date.now()
+      });
+    }
+    if (!branding.downgraded) downgradeEmitted.current = false;
+  }, [branding.downgraded]);
+  const value = useMemo(() => ({
+    locale,
+    theme,
+    appTheme,
+    colors,
+    branding,
+    account,
+    t: (key, vars) => t(locale, key, vars)
+  }), [locale, theme, appTheme, colors, branding, account]);
+  return /*#__PURE__*/_jsx(KokoUiContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+export function useKokoUi() {
+  const ctx = useContext(KokoUiContext);
+  if (!ctx) {
+    const locale = 'en';
+    const appTheme = 'light';
+    const theme = invertTheme(appTheme);
+    return {
+      locale,
+      theme,
+      appTheme,
+      colors: resolveThemeColors(theme),
+      branding: resolveBranding(locale, undefined, undefined),
+      account: null,
+      t: (key, vars) => t(locale, key, vars)
+    };
+  }
+  return ctx;
+}
+//# sourceMappingURL=KokoUiContext.js.map

package/lib/module/provider/KokoUiContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useContext","useEffect","useMemo","useRef","useSyncExternalStore","AccountStore","resolveBranding","UsageBus","normalizeLocale","t","HostAppearanceStore","invertTheme","resolveThemeColors","jsx","_jsx","KokoUiContext","subscribeAccount","cb","subscribe","getAccountSnapshot","get","subscribeAppearance","getAppearanceSnapshot","KokoUiProvider","config","children","appearance","locale","appTheme","theme","colors","account","downgradeEmitted","unsub","onUsageEvent","undefined","token","gateway","refresh","baseUrl","branding","entitlements","downgraded","current","emit","type","reason","at","Date","now","value","key","vars","Provider","useKokoUi","ctx"],"sourceRoot":"../../../src","sources":["provider/KokoUiContext.tsx"],"mappings":"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","ignoreList":[]}