@eazo/sdk 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -1,7 +1,11 @@
 export { auth } from "./internal/capabilities/auth";
 export { device } from "./internal/capabilities/device";
 export { storage } from "./internal/capabilities/storage";
+export { ai } from "./internal/capabilities/ai";
+export { memory } from "./internal/capabilities/memory";
 export type { LoginOptions } from "./internal/capabilities/auth";
 export type { StorageCredentials, UploadResult } from "./internal/capabilities/storage";
+export type { MemoryActionParams } from "./internal/capabilities/memory";
+export type { ChatCompletion, ChatCompletionChunk, ChatCompletionCreateParamsNonStreaming, ChatCompletionCreateParamsStreaming, } from "./internal/capabilities/ai";
 export type { User, DeviceContext, AuthState, EazoState } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE1D,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACxF,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAExD,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACxF,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,sCAAsC,EACtC,mCAAmC,GACpC,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.storage = exports.device = exports.auth = void 0;
+exports.memory = exports.ai = exports.storage = exports.device = exports.auth = void 0;
 var auth_1 = require("./internal/capabilities/auth");
 Object.defineProperty(exports, "auth", { enumerable: true, get: function () { return auth_1.auth; } });
 var device_1 = require("./internal/capabilities/device");
 Object.defineProperty(exports, "device", { enumerable: true, get: function () { return device_1.device; } });
 var storage_1 = require("./internal/capabilities/storage");
 Object.defineProperty(exports, "storage", { enumerable: true, get: function () { return storage_1.storage; } });
+var ai_1 = require("./internal/capabilities/ai");
+Object.defineProperty(exports, "ai", { enumerable: true, get: function () { return ai_1.ai; } });
+var memory_1 = require("./internal/capabilities/memory");
+Object.defineProperty(exports, "memory", { enumerable: true, get: function () { return memory_1.memory; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qDAAoD;AAA3C,4FAAA,IAAI,OAAA;AACb,yDAAwD;AAA/C,gGAAA,MAAM,OAAA;AACf,2DAA0D;AAAjD,kGAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qDAAoD;AAA3C,4FAAA,IAAI,OAAA;AACb,yDAAwD;AAA/C,gGAAA,MAAM,OAAA;AACf,2DAA0D;AAAjD,kGAAA,OAAO,OAAA;AAChB,iDAAgD;AAAvC,wFAAA,EAAE,OAAA;AACX,yDAAwD;AAA/C,gGAAA,MAAM,OAAA"}

package/dist/internal/capabilities/ai.d.ts

@@ -0,0 +1,54 @@
+import OpenAI from "openai";
+export type { ChatCompletion, ChatCompletionChunk } from "openai/resources/chat/completions";
+export type { ChatCompletionCreateParamsNonStreaming, ChatCompletionCreateParamsStreaming, } from "openai/resources/chat/completions";
+/**
+ * Send a chat completion request to the built-in AI (AWS Bedrock via bedrock-mantle).
+ *
+ * Uses the official `openai` package under the hood — all parameter types are
+ * identical to the OpenAI SDK. The response is returned as-is in OpenAI standard
+ * format, including streaming chunks.
+ *
+ * @example Non-streaming
+ * ```ts
+ * const result = await ai.chat({
+ *   model: 'deepseek.v3.1',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ * });
+ * console.log(result.choices[0].message.content);
+ * ```
+ *
+ * @example Streaming
+ * ```ts
+ * const stream = await ai.chat({
+ *   model: 'deepseek.v3.1',
+ *   messages: [{ role: 'user', content: 'Tell me a story.' }],
+ *   stream: true,
+ * });
+ * for await (const chunk of stream) {
+ *   process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
+ * }
+ * ```
+ *
+ * @example Function calling
+ * ```ts
+ * const result = await ai.chat({
+ *   model: 'deepseek.v3.1',
+ *   messages: [{ role: 'user', content: 'What is the weather in Shanghai?' }],
+ *   tools: [{ type: 'function', function: { name: 'get_weather', description: '...', parameters: {...} } }],
+ *   tool_choice: 'auto',
+ * });
+ * ```
+ */
+declare function chat(params: OpenAI.Chat.ChatCompletionCreateParamsNonStreaming): Promise<OpenAI.Chat.ChatCompletion>;
+declare function chat(params: OpenAI.Chat.ChatCompletionCreateParamsStreaming): Promise<AsyncIterable<OpenAI.Chat.ChatCompletionChunk>>;
+export declare const ai: {
+    /**
+     * Configure the private key for AI requests.
+     * Alternative to setting the EAZO_PRIVATE_KEY environment variable.
+     */
+    configure(opts: {
+        privateKey: string;
+    }): void;
+    chat: typeof chat;
+};
+//# sourceMappingURL=ai.d.ts.map

package/dist/internal/capabilities/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../src/internal/capabilities/ai.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAmC5B,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7F,YAAY,EACV,sCAAsC,EACtC,mCAAmC,GACpC,MAAM,mCAAmC,CAAC;AAM3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,iBAAe,IAAI,CACjB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,sCAAsC,GACzD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACvC,iBAAe,IAAI,CACjB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,mCAAmC,GACtD,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAwB3D,eAAO,MAAM,EAAE;IACb;;;OAGG;oBACa;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;;CAK9C,CAAC"}

package/dist/internal/capabilities/ai.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ai = void 0;
+const openai_1 = __importDefault(require("openai"));
+const config_1 = require("../config");
+// ---------------------------------------------------------------------------
+// Private key storage
+// ---------------------------------------------------------------------------
+let privateKey = null;
+function setPrivateKey(key) {
+    privateKey = key;
+}
+function getPrivateKey() {
+    if (privateKey)
+        return privateKey;
+    if (typeof process !== "undefined" && process.env.EAZO_PRIVATE_KEY) {
+        return process.env.EAZO_PRIVATE_KEY;
+    }
+    return null;
+}
+function buildClient() {
+    const key = getPrivateKey();
+    if (!key) {
+        throw new Error("@eazo/sdk: missing private key. Set EAZO_PRIVATE_KEY env var or call ai.configure({ privateKey }).");
+    }
+    return new openai_1.default({
+        baseURL: `${(0, config_1.getApiBase)()}/v1`,
+        apiKey: key,
+    });
+}
+async function chat(params) {
+    const client = buildClient();
+    if (params.stream) {
+        // openai SDK Stream is itself an AsyncIterable<ChatCompletionChunk>
+        return client.chat.completions.create(params);
+    }
+    return client.chat.completions.create(params);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+exports.ai = {
+    /**
+     * Configure the private key for AI requests.
+     * Alternative to setting the EAZO_PRIVATE_KEY environment variable.
+     */
+    configure(opts) {
+        setPrivateKey(opts.privateKey);
+    },
+    chat,
+};
+//# sourceMappingURL=ai.js.map

package/dist/internal/capabilities/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../../src/internal/capabilities/ai.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAC5B,sCAAuC;AAEvC,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,IAAI,UAAU,GAAkB,IAAI,CAAC;AAErC,SAAS,aAAa,CAAC,GAAW;IAChC,UAAU,GAAG,GAAG,CAAC;AACnB,CAAC;AAED,SAAS,aAAa;IACpB,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACnE,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,gBAAM,CAAC;QAChB,OAAO,EAAE,GAAG,IAAA,mBAAU,GAAE,KAAK;QAC7B,MAAM,EAAE,GAAG;KACZ,CAAC,CAAC;AACL,CAAC;AAyDD,KAAK,UAAU,IAAI,CACjB,MAEmD;IAEnD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAE7B,IAAK,MAA0D,CAAC,MAAM,EAAE,CAAC;QACvE,oEAAoE;QACpE,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CACnC,MAAyD,CACC,CAAC;IAC/D,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CACnC,MAA4D,CAC7D,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAEjE,QAAA,EAAE,GAAG;IAChB;;;OAGG;IACH,SAAS,CAAC,IAA4B;QACpC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,IAAI;CACL,CAAC"}

package/dist/internal/capabilities/memory.d.ts

@@ -0,0 +1,45 @@
+export interface MemoryActionParams {
+    /** Readable description of the user action, e.g. "User clicked the publish button on the app editor page" */
+    content: string;
+    /** ISO 8601 timestamp. Defaults to now when omitted. */
+    timestamp?: string;
+    /** Associate this action with a Gum session ID */
+    session_id?: string;
+    /** Action category, e.g. "click", "search", "page_view" */
+    event_type?: string;
+    /** Page identifier where the action occurred, e.g. "app_editor" */
+    page?: string;
+    /** Business ID anchors for retrieval, e.g. { app_id: "app_123" } */
+    anchors?: Record<string, string>;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Entity tags associated with this action */
+    entities?: string[];
+    /** Device identifier */
+    device_id?: string;
+    /** App identifier */
+    app?: string;
+    /** Platform, e.g. "web", "ios", "android" */
+    platform?: string;
+}
+export declare const memory: {
+    /**
+     * Report a user action event to Gum memory service.
+     *
+     * Requires the user to be authenticated — the current session is forwarded
+     * automatically via `x-eazo-session`. The developer public key is read from
+     * `NEXT_PUBLIC_EAZO_PUBLIC_KEY` or set via `auth.configure({ publicKey })`.
+     *
+     * @example
+     * ```ts
+     * await memory.reportAction({
+     *   content: "User clicked the publish button on the app editor page",
+     *   event_type: "click",
+     *   page: "app_editor",
+     *   anchors: { app_id: "app_123" },
+     * });
+     * ```
+     */
+    reportAction(params: MemoryActionParams): Promise<void>;
+};
+//# sourceMappingURL=memory.d.ts.map

package/dist/internal/capabilities/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/internal/capabilities/memory.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,6GAA6G;IAC7G,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,eAAO,MAAM,MAAM;IACjB;;;;;;;;;;;;;;;;OAgBG;yBACwB,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAkC9D,CAAC"}

package/dist/internal/capabilities/memory.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memory = void 0;
+const config_1 = require("../config");
+const auth_1 = require("./auth");
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+exports.memory = {
+    /**
+     * Report a user action event to Gum memory service.
+     *
+     * Requires the user to be authenticated — the current session is forwarded
+     * automatically via `x-eazo-session`. The developer public key is read from
+     * `NEXT_PUBLIC_EAZO_PUBLIC_KEY` or set via `auth.configure({ publicKey })`.
+     *
+     * @example
+     * ```ts
+     * await memory.reportAction({
+     *   content: "User clicked the publish button on the app editor page",
+     *   event_type: "click",
+     *   page: "app_editor",
+     *   anchors: { app_id: "app_123" },
+     * });
+     * ```
+     */
+    async reportAction(params) {
+        const publicKey = (0, config_1.getPublicKey)();
+        if (!publicKey) {
+            throw new Error("@eazo/sdk: missing public key. Set NEXT_PUBLIC_EAZO_PUBLIC_KEY or call auth.configure({ publicKey }).");
+        }
+        const session = await auth_1.auth.getSessionHeader();
+        if (!session) {
+            throw new Error("@eazo/sdk: user is not authenticated. Call auth.login() before reporting memory actions.");
+        }
+        const res = await fetch(`${(0, config_1.getApiBase)()}/api/open/gum/action`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-eazo-publickey": publicKey,
+                "x-eazo-session": session,
+            },
+            body: JSON.stringify(params),
+        });
+        if (!res.ok) {
+            let message = `Failed to report memory action: ${res.status}`;
+            try {
+                const body = await res.json();
+                if (body?.message)
+                    message = body.message;
+            }
+            catch { /* ignore */ }
+            throw new Error(message);
+        }
+    },
+};
+//# sourceMappingURL=memory.js.map

package/dist/internal/capabilities/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/internal/capabilities/memory.ts"],"names":[],"mappings":";;;AAAA,sCAAqD;AACrD,iCAA8B;AA+B9B,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAEjE,QAAA,MAAM,GAAG;IACpB;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,MAAM,SAAS,GAAG,IAAA,qBAAY,GAAE,CAAC;QACjC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,WAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAA,mBAAU,GAAE,sBAAsB,EAAE;YAC7D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,kBAAkB,EAAE,SAAS;gBAC7B,gBAAgB,EAAE,OAAO;aAC1B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAC7B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,OAAO,GAAG,mCAAmC,GAAG,CAAC,MAAM,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA0B,CAAC;gBACtD,IAAI,IAAI,EAAE,OAAO;oBAAE,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eazo/sdk",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Eazo platform SDK — capability-first API for web apps that run on Eazo Mobile and the web browser",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -45,7 +45,8 @@
   "dependencies": {
     "@radix-ui/react-dialog": "^1.1.4",
     "authing-js-sdk": "^4.23.55",
-    "elliptic": "^6.6.1"
+    "elliptic": "^6.6.1",
+    "openai": "^6.34.0"
   },
   "peerDependencies": {
     "react": ">=18"