@graineai/inapp-react-native 0.21.0 → 0.22.0

package/dist/client.d.ts

@@ -17,6 +17,16 @@ export interface SessionConfig {
     appearance?: Record<string, any>;
     variables?: Record<string, string>;
     components?: any[];
+    appActions?: Array<{
+        tool_name?: string;
+        toolName?: string;
+        name?: string;
+    }>;
+}
+export interface ActionDiagnosis {
+    usable: string[];
+    undeclared: string[];
+    unhandled: string[];
 }
 export declare class GraineInAppClient {
     readonly opts: GraineInAppOptions;
@@ -46,6 +56,8 @@ export declare class GraineInAppClient {
     private emit;
     private get fetch();
     session(): Promise<SessionConfig>;
+    checkActions(): ActionDiagnosis;
+    private reportActionMismatch;
     private ticket;
     connect(): Promise<void>;
     private openSocket;

package/dist/client.js

@@ -68,8 +68,37 @@ export class GraineInAppClient {
             throw new Error(data?.error || `Embed rejected (${res.status})`);
         }
         this.config = data;
+        this.reportActionMismatch();
         return this.config;
     }
+    checkActions() {
+        const registered = [...this.actions.keys()];
+        const declared = new Set((this.config?.appActions ?? [])
+            .map((a) => a?.tool_name || a?.toolName || a?.name)
+            .filter((n) => Boolean(n)));
+        return {
+            usable: registered.filter((n) => declared.has(n)),
+            undeclared: registered.filter((n) => !declared.has(n)),
+            unhandled: [...declared].filter((n) => !this.actions.has(n)),
+        };
+    }
+    reportActionMismatch() {
+        if (this.actions.size === 0)
+            return;
+        const { undeclared, unhandled } = this.checkActions();
+        if (!undeclared.length && !unhandled.length)
+            return;
+        this.emit("diagnostic", { type: "actions", ...this.checkActions() });
+        if (undeclared.length) {
+            console.warn(`[Graine] This app registered ${undeclared.length} action(s) the agent is not ` +
+                `configured to call, so the agent cannot use them: ${undeclared.join(", ")}. ` +
+                `Add them to the agent's app_actions in Embed & Widgets.`);
+        }
+        if (unhandled.length) {
+            console.warn(`[Graine] The agent is configured to call ${unhandled.length} action(s) this ` +
+                `build does not implement: ${unhandled.join(", ")}. It will be refused mid-sentence.`);
+        }
+    }
     async ticket() {
         try {
             const res = await this.fetch(`${this.opts.baseUrl}/api/embed/ticket`, {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export type { ActionHandler, AppActionRequest, AppActionResult, AppEvent, ScreenContext, ScreenField, } from "./protocol.js";
-export { GraineInAppClient, type GraineInAppOptions, type SessionConfig } from "./client.js";
+export { GraineInAppClient, type GraineInAppOptions, type SessionConfig, type ActionDiagnosis, } from "./client.js";
 export { VoiceSession, liveAudioStreamAdapter, base64ToPcm16, CAPTURE_SAMPLE_RATE, type AudioAdapter, type VoiceSessionOptions, } from "./voice.js";
 export { EchoGuard, decodeAgentAudio, decodeMuLaw, decodePcm16, base64ToBytes, type AudioFormat, type DecodedAudio, } from "./audio.js";
 export { addMaskRule, maskDeep, maskString } from "./mask.js";

package/dist/index.js

@@ -1,4 +1,4 @@
-export { GraineInAppClient } from "./client.js";
+export { GraineInAppClient, } from "./client.js";
 export { VoiceSession, liveAudioStreamAdapter, base64ToPcm16, CAPTURE_SAMPLE_RATE, } from "./voice.js";
 export { EchoGuard, decodeAgentAudio, decodeMuLaw, decodePcm16, base64ToBytes, } from "./audio.js";
 export { addMaskRule, maskDeep, maskString } from "./mask.js";

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@graineai/inapp-react-native",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "type": "module",
-  "description": "Graine in-app agent for React Native \u2014 an agent that sees the screen your customer is on and can act on it.",
+  "description": "Graine in-app agent for React Native — an agent that sees the screen your customer is on and can act on it.",
   "license": "MIT",
   "private": false,
   "main": "dist/index.js",