@formmy.app/chat 0.0.1-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Formmy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+# @formmy.app/chat
+
+Official SDK for Formmy AI Chat - Build conversational AI experiences in your React applications.
+
+## Installation
+
+```bash
+npm install @formmy.app/chat
+```
+
+**Peer Dependencies:**
+```bash
+npm install react ai @ai-sdk/react
+```
+
+## Quick Start
+
+### Backend (Node.js)
+
+Use the `Formmy` client to manage agents and conversations from your server.
+
+```typescript
+import { Formmy } from '@formmy.app/chat';
+
+const formmy = new Formmy({ secretKey: 'sk_live_xxx' });
+
+// List all agents
+const agents = await formmy.agents.list();
+
+// Create a new agent
+const { agent } = await formmy.agents.create({
+  name: 'Customer Support',
+  instructions: 'You are a helpful customer support agent.',
+  welcomeMessage: 'Hello! How can I help you today?',
+});
+
+// Send a message (non-streaming)
+const response = await formmy.chat.send('Hello!', {
+  agentId: agent.id,
+  sessionId: 'user_123',
+});
+```
+
+### Frontend (React)
+
+Use the provider and components to add chat to your React app.
+
+```tsx
+import { FormmyProvider, ChatBubble } from '@formmy.app/chat/react';
+
+function App() {
+  return (
+    <FormmyProvider publishableKey="pk_live_xxx">
+      <YourApp />
+      <ChatBubble
+        agentId="agent_xxx"
+        position="bottom-right"
+        theme="light"
+      />
+    </FormmyProvider>
+  );
+}
+```
+
+### Headless Hook
+
+Build custom chat UIs with the `useFormmyChat` hook.
+
+```tsx
+import { useFormmyChat } from '@formmy.app/chat/react';
+
+function CustomChat({ agentId }: { agentId: string }) {
+  const { messages, input, setInput, handleSubmit, isLoading } = useFormmyChat({
+    agentId,
+  });
+
+  return (
+    <div>
+      {messages.map((msg) => (
+        <div key={msg.id}>
+          <strong>{msg.role}:</strong> {msg.content}
+        </div>
+      ))}
+
+      <form onSubmit={handleSubmit}>
+        <input
+          value={input}
+          onChange={(e) => setInput(e.target.value)}
+          placeholder="Type a message..."
+        />
+        <button type="submit" disabled={isLoading}>
+          Send
+        </button>
+      </form>
+    </div>
+  );
+}
+```
+
+## API Reference
+
+### Formmy Client
+
+```typescript
+const formmy = new Formmy({ secretKey: 'sk_live_xxx' });
+
+// Agents
+formmy.agents.list()
+formmy.agents.get(agentId)
+formmy.agents.create({ name, instructions, welcomeMessage?, model? })
+formmy.agents.update(agentId, { name?, instructions?, model? })
+formmy.agents.delete(agentId)
+
+// Chat
+formmy.chat.send(message, { agentId, sessionId })
+formmy.chat.history(sessionId, agentId)
+```
+
+### React Components
+
+#### FormmyProvider
+
+```tsx
+<FormmyProvider
+  publishableKey="pk_live_xxx"
+  baseUrl="https://formmy.app"  // optional
+>
+  {children}
+</FormmyProvider>
+```
+
+#### ChatBubble
+
+```tsx
+<ChatBubble
+  agentId="agent_xxx"           // required
+  position="bottom-right"        // bottom-right | bottom-left
+  theme="light"                  // light | dark
+  welcomeMessage="Hello!"        // optional override
+  buttonLabel="Chat with us"     // optional
+/>
+```
+
+#### useFormmyChat
+
+```typescript
+const {
+  messages,      // Message[]
+  input,         // string
+  setInput,      // (value: string) => void
+  handleSubmit,  // (e: FormEvent) => void
+  isLoading,     // boolean
+  error,         // Error | null
+  reload,        // () => void
+  stop,          // () => void
+} = useFormmyChat({ agentId });
+```
+
+## Keys
+
+| Key Type | Prefix | Usage | Scope |
+|----------|--------|-------|-------|
+| Secret Key | `sk_live_` | Backend only | Full API access |
+| Publishable Key | `pk_live_` | Frontend safe | Chat only, domain-restricted |
+
+Get your keys at [formmy.app/dashboard/api-keys](https://formmy.app/dashboard/api-keys)
+
+## TypeScript
+
+Full TypeScript support included.
+
+```typescript
+import type {
+  FormmyMessage,
+  Agent,
+  FormmyConfig
+} from '@formmy.app/chat';
+```
+
+## Documentation
+
+Full documentation at [formmy.app/docs/sdk](https://formmy.app/docs/sdk)
+
+## License
+
+MIT

package/dist/core/client.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @formmy.app/react - Backend Client
+ *
+ * Usage:
+ * ```typescript
+ * import { Formmy } from '@formmy.app/react/client';
+ *
+ * const formmy = new Formmy({ secretKey: 'sk_live_xxx' });
+ *
+ * // Create agent
+ * const agent = await formmy.agents.create({ name: 'Mi Asistente' });
+ *
+ * // List agents
+ * const { agents } = await formmy.agents.list();
+ * ```
+ */
+import type { FormmyConfig, CreateAgentInput, UpdateAgentInput, AgentsListResponse, AgentResponse } from "./types";
+export declare class FormmyError extends Error {
+    code: string;
+    status: number;
+    constructor(message: string, code: string, status: number);
+}
+export declare class Formmy {
+    private secretKey;
+    private baseUrl;
+    constructor(config: FormmyConfig);
+    get agents(): {
+        /**
+         * List all agents for the authenticated user
+         */
+        list: () => Promise<AgentsListResponse>;
+        /**
+         * Get a specific agent by ID
+         */
+        get: (agentId: string) => Promise<AgentResponse>;
+        /**
+         * Create a new agent
+         */
+        create: (data: CreateAgentInput) => Promise<AgentResponse>;
+        /**
+         * Update an existing agent
+         */
+        update: (agentId: string, data: UpdateAgentInput) => Promise<AgentResponse>;
+        /**
+         * Delete an agent (soft delete)
+         */
+        delete: (agentId: string) => Promise<{
+            success: boolean;
+        }>;
+    };
+    get chat(): {
+        /**
+         * Send a message and get a response (non-streaming)
+         * For streaming, use the useFormmyChat hook on the frontend
+         */
+        send: (options: {
+            agentId: string;
+            message: string;
+            conversationId?: string;
+        }) => Promise<{
+            content: string;
+            conversationId: string;
+        }>;
+    };
+    private request;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACd,MAAM,SAAS,CAAC;AAIjB,qBAAa,WAAY,SAAQ,KAAK;IAG3B,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;gBAFrB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAKxB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,YAAY;IAiBhC,IAAI,MAAM;QAEN;;WAEG;oBACa,OAAO,CAAC,kBAAkB,CAAC;QAI3C;;WAEG;uBACkB,MAAM,KAAG,OAAO,CAAC,aAAa,CAAC;QAOpD;;WAEG;uBACkB,gBAAgB,KAAG,OAAO,CAAC,aAAa,CAAC;QAI9D;;WAEG;0BAEQ,MAAM,QACT,gBAAgB,KACrB,OAAO,CAAC,aAAa,CAAC;QAQzB;;WAEG;0BACqB,MAAM,KAAG,OAAO,CAAC;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC;MAOjE;IAMD,IAAI,IAAI;QAEJ;;;WAGG;wBACmB;YACpB,OAAO,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC;YAChB,cAAc,CAAC,EAAE,MAAM,CAAC;SACzB,KAAG,OAAO,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,CAAA;SAAE,CAAC;MA4D3D;YAMa,OAAO;CA4BtB"}

package/dist/core/client.js

@@ -0,0 +1,156 @@
+/**
+ * @formmy.app/react - Backend Client
+ *
+ * Usage:
+ * ```typescript
+ * import { Formmy } from '@formmy.app/react/client';
+ *
+ * const formmy = new Formmy({ secretKey: 'sk_live_xxx' });
+ *
+ * // Create agent
+ * const agent = await formmy.agents.create({ name: 'Mi Asistente' });
+ *
+ * // List agents
+ * const { agents } = await formmy.agents.list();
+ * ```
+ */
+const DEFAULT_BASE_URL = "https://formmy.app";
+export class FormmyError extends Error {
+    code;
+    status;
+    constructor(message, code, status) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.name = "FormmyError";
+    }
+}
+export class Formmy {
+    secretKey;
+    baseUrl;
+    constructor(config) {
+        if (!config.secretKey) {
+            throw new Error("Formmy client requires a secretKey (sk_live_xxx)");
+        }
+        if (!config.secretKey.startsWith("sk_live_")) {
+            throw new Error("Invalid secretKey format. Must start with sk_live_");
+        }
+        this.secretKey = config.secretKey;
+        this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Agents Namespace
+    // ═══════════════════════════════════════════════════════════════════════════
+    get agents() {
+        return {
+            /**
+             * List all agents for the authenticated user
+             */
+            list: async () => {
+                return this.request("GET", "?intent=agents.list");
+            },
+            /**
+             * Get a specific agent by ID
+             */
+            get: async (agentId) => {
+                return this.request("GET", `?intent=agents.get&agentId=${agentId}`);
+            },
+            /**
+             * Create a new agent
+             */
+            create: async (data) => {
+                return this.request("POST", "?intent=agents.create", data);
+            },
+            /**
+             * Update an existing agent
+             */
+            update: async (agentId, data) => {
+                return this.request("POST", `?intent=agents.update&agentId=${agentId}`, data);
+            },
+            /**
+             * Delete an agent (soft delete)
+             */
+            delete: async (agentId) => {
+                return this.request("POST", `?intent=agents.delete&agentId=${agentId}`);
+            },
+        };
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Chat Namespace (for server-side chat)
+    // ═══════════════════════════════════════════════════════════════════════════
+    get chat() {
+        return {
+            /**
+             * Send a message and get a response (non-streaming)
+             * For streaming, use the useFormmyChat hook on the frontend
+             */
+            send: async (options) => {
+                // For server-side, we make a regular POST and read the full response
+                const sessionId = options.conversationId || `sdk_${Date.now()}`;
+                const response = await fetch(`${this.baseUrl}/api/v2/sdk?intent=chat&agentId=${options.agentId}`, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        Authorization: `Bearer ${this.secretKey}`,
+                    },
+                    body: JSON.stringify({
+                        message: {
+                            id: `msg_${Date.now()}`,
+                            role: "user",
+                            parts: [{ type: "text", text: options.message }],
+                        },
+                        id: sessionId,
+                    }),
+                });
+                if (!response.ok) {
+                    const error = await response.json().catch(() => ({}));
+                    throw new FormmyError(error.error || "Request failed", error.code || "REQUEST_FAILED", response.status);
+                }
+                // Read streaming response as text
+                const text = await response.text();
+                // Parse SSE response - Vercel AI SDK format
+                // Lines starting with "0:" contain text content chunks
+                const lines = text.split("\n");
+                const contentParts = [];
+                for (const line of lines) {
+                    if (line.startsWith("0:")) {
+                        try {
+                            const parsed = JSON.parse(line.slice(2));
+                            if (typeof parsed === "string") {
+                                contentParts.push(parsed);
+                            }
+                        }
+                        catch {
+                            // Log malformed chunks but don't lose the rest
+                            console.warn("[Formmy SDK] Malformed SSE chunk:", line.slice(0, 100));
+                        }
+                    }
+                }
+                return {
+                    content: contentParts.join(""),
+                    conversationId: sessionId,
+                };
+            },
+        };
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // Private methods
+    // ═══════════════════════════════════════════════════════════════════════════
+    async request(method, path, body) {
+        const url = `${this.baseUrl}/api/v2/sdk${path}`;
+        const response = await fetch(url, {
+            method,
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.secretKey}`,
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            throw new FormmyError(data.error || "Request failed", data.code || "REQUEST_FAILED", response.status);
+        }
+        return data;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @formmy.app/react - Type definitions
+ */
+export interface FormmyConfig {
+    /** Publishable key for frontend (pk_live_xxx) */
+    publishableKey?: string;
+    /** Secret key for backend (sk_live_xxx) */
+    secretKey?: string;
+    /** Base URL for Formmy API (default: https://formmy.app) */
+    baseUrl?: string;
+}
+export interface FormmyProviderProps extends FormmyConfig {
+    children: React.ReactNode;
+}
+export interface UseFormmyChatOptions {
+    /** Agent ID to chat with */
+    agentId: string;
+    /** Initial messages to load */
+    initialMessages?: Message[];
+    /** Existing conversation ID to continue */
+    conversationId?: string;
+    /** Called when a new message is received */
+    onMessage?: (message: Message) => void;
+    /** Called on error */
+    onError?: (error: Error) => void;
+    /** Called when streaming finishes */
+    onFinish?: () => void;
+}
+export interface Message {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content?: string;
+    parts?: MessagePart[];
+    createdAt?: Date;
+}
+export type MessagePart = {
+    type: "text";
+    text: string;
+} | {
+    type: string;
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+    output?: unknown;
+};
+export interface Agent {
+    id: string;
+    name: string;
+    slug: string;
+    aiModel: string;
+    instructions?: string;
+    welcomeMessage?: string;
+    customInstructions?: string;
+    status: "ACTIVE" | "INACTIVE" | "DELETED";
+    createdAt: string;
+    updatedAt?: string;
+}
+export interface CreateAgentInput {
+    name: string;
+    instructions?: string;
+    welcomeMessage?: string;
+    model?: string;
+}
+export interface UpdateAgentInput {
+    name?: string;
+    instructions?: string;
+    welcomeMessage?: string;
+    customInstructions?: string;
+    model?: string;
+}
+export interface ChatBubbleProps {
+    /** Agent ID to chat with */
+    agentId: string;
+    /** Position of the bubble trigger */
+    position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
+    /** Theme customization */
+    theme?: ChatTheme;
+    /** Initial open state */
+    defaultOpen?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+}
+export interface ChatTheme {
+    /** Primary color for buttons and accents */
+    primaryColor?: string;
+    /** Background color for the chat panel */
+    backgroundColor?: string;
+    /** Text color */
+    textColor?: string;
+    /** Border radius for the panel */
+    borderRadius?: string;
+}
+export interface ApiResponse<T> {
+    data?: T;
+    error?: string;
+    code?: string;
+}
+export interface AgentsListResponse {
+    agents: Agent[];
+}
+export interface AgentResponse {
+    agent: Agent;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,5 @@
+/**
+ * @formmy.app/react - Type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/hooks/use-formmy-chat.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @formmy.app/chat/react - useFormmyChat Hook
+ *
+ * Headless hook for chat functionality, wrapping Vercel AI SDK's useChat.
+ *
+ * Usage:
+ * ```tsx
+ * import { useFormmyChat } from '@formmy.app/chat/react';
+ *
+ * function Chat() {
+ *   const { messages, sendMessage, status } = useFormmyChat({
+ *     agentId: 'agent_123',
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(m => <div key={m.id}>{getMessageText(m)}</div>)}
+ *       <button onClick={() => sendMessage('Hello!')}>Send</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+import type { UseFormmyChatOptions } from "../core/types";
+/**
+ * Extract text content from a message's parts
+ */
+export declare function getMessageText(message: {
+    parts?: Array<{
+        type: string;
+        text?: string;
+    }>;
+}): string;
+/**
+ * Headless chat hook - provides all chat functionality without UI
+ */
+export declare function useFormmyChat(options: UseFormmyChatOptions): {
+    messages: import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[];
+    status: import("ai").ChatStatus;
+    error: Error | undefined;
+    sessionId: string;
+    agentId: string;
+    sendMessage: (text: string) => Promise<void>;
+    reset: () => void;
+    stop: () => Promise<void>;
+    setMessages: (messages: import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[] | ((messages: import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[]) => import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[])) => void;
+    getMessageText: typeof getMessageText;
+    _chat: import("@ai-sdk/react").UseChatHelpers<import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>>;
+};
+//# sourceMappingURL=use-formmy-chat.d.ts.map

package/dist/hooks/use-formmy-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-formmy-chat.d.ts","sourceRoot":"","sources":["../../src/hooks/use-formmy-chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAK1D;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,MAAM,CAMlG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB;;;;;;wBAmG1C,MAAM;;;;;;EAuCtB"}