sammy-sdk-client 0.1.0

package/README.md

@@ -0,0 +1,82 @@
+# sammy-sdk-client
+
+Zero-dependency JavaScript client for the [Sammy](https://sammy.dev) AI agent runtime. Works in any framework — React, Vue, Svelte, vanilla — and in any modern JavaScript runtime (browser, Node 18+, edge).
+
+`sammy-sdk-client` is the framework-agnostic transport layer. It speaks to the chat endpoint your server exposes (typically backed by [`sammy-sdk`](https://www.npmjs.com/package/sammy-sdk)'s `createSammyRouteHandler`) and handles JSON requests, conversation IDs, and SSE streaming.
+
+For React-specific helpers see [`sammy-sdk-react`](https://www.npmjs.com/package/sammy-sdk-react). For a drop-in chat widget see [`sammy-sdk-ui`](https://www.npmjs.com/package/sammy-sdk-ui).
+
+## Install
+
+```bash
+npm install sammy-sdk-client
+```
+
+You'll also need a chat endpoint on your backend. The fastest way is `createSammyRouteHandler` from `sammy-sdk`:
+
+```ts
+// app/api/chat/route.ts (Next.js App Router)
+import { Sammy, createSammyRouteHandler } from "sammy-sdk";
+const sammy = new Sammy();
+export const POST = createSammyRouteHandler(sammy);
+```
+
+## Usage
+
+```ts
+import { SammyClient } from "sammy-sdk-client";
+
+const client = new SammyClient({
+  endpoint: "/api/chat",
+  // Optional: custom headers (object or async function)
+  headers: async () => ({ Authorization: `Bearer ${await getToken()}` }),
+});
+
+// One-shot request/response (returns the full ChatResponse)
+const reply = await client.chat("List all open deals");
+console.log(reply.message);
+
+// Streaming
+const stream = client.stream("Summarise this week's pipeline");
+stream
+  .on("text", (chunk) => process.stdout.write(chunk))
+  .on("tool_call", (call) => console.log("calling tool:", call.name))
+  .on("tool_result", (r) => console.log("tool", r.name, "->", r.result.success))
+  .on("agent_handoff", (h) => console.log("handed off to:", h.targetAgent))
+  .on("done", (final) => console.log("\ntools used:", final.toolsUsed.length))
+  .on("error", (err) => console.error(err));
+```
+
+## Conversations
+
+`client.conversation(id?)` gives you a scoped object that re-uses the same `conversationId` across calls — useful for chat threads.
+
+```ts
+const thread = client.conversation();
+await thread.send("hi");
+await thread.send("what did I just say?");
+```
+
+## API surface
+
+- `new SammyClient(config)`
+- `client.chat(message, options?)` — `Promise<ChatResponse>` (one-shot JSON; the server must speak JSON for this path — `createSammyRouteHandler` does)
+- `client.stream(message, options?)` — `SammyStream` (event emitter)
+- `client.conversation(id?)` — convenience scope for a single conversation
+
+`SammyStream` events:
+
+| Event | Handler argument |
+|---|---|
+| `text` | `string` chunk to append to the assistant message |
+| `tool_call` | `ToolCallEvent` — `{ id, name, params }` |
+| `tool_result` | `ToolResultEvent` — `{ id, name, result: { success, data?, error? } }` |
+| `agent_handoff` | `AgentHandoffEvent` — `{ fromAgent, targetAgent, reason }` (multi-agent only) |
+| `done` | the full `ChatResponse` |
+| `error` | a real `Error` instance |
+
+All exported types — `SammyClientConfig`, `ChatOptions`, `ChatResponse`, `SammyStream`, `ToolCallEvent`, `ToolResultEvent`, `ToolResult`, `ToolCallResult`, `AgentHandoffEvent`, `Attachment` — are exported from the package root.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,14 @@
+import type { SammyClientConfig, ChatOptions, ChatResponse, SammyStream } from "./types";
+export declare class SammyClient {
+    private config;
+    constructor(config: SammyClientConfig);
+    chat(message: string, options?: ChatOptions): Promise<ChatResponse>;
+    stream(message: string, options?: ChatOptions): SammyStream;
+    conversation(id?: string): {
+        id: string;
+        send: (message: string) => Promise<ChatResponse>;
+        stream: (message: string) => SammyStream;
+    };
+    private resolveHeaders;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGzF,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,iBAAiB;IAQ/B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAwCzE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW;IAI3D,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM;;wBAIJ,MAAM;0BACJ,MAAM;;YAId,cAAc;CAK7B"}

package/dist/client.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SammyClient = void 0;
+const stream_1 = require("./stream");
+class SammyClient {
+    config;
+    constructor(config) {
+        this.config = {
+            retries: 3,
+            timeout: 30000,
+            ...config,
+        };
+    }
+    async chat(message, options) {
+        const headers = await this.resolveHeaders();
+        const response = await fetch(this.config.endpoint, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                ...headers,
+            },
+            body: JSON.stringify({
+                message,
+                conversationId: options?.conversationId || this.config.conversationId,
+                metadata: options?.metadata,
+                attachments: options?.attachments,
+            }),
+            signal: AbortSignal.timeout(this.config.timeout),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            throw new Error(`Sammy request failed: ${response.status} ${response.statusText}${text ? ` - ${text}` : ""}`);
+        }
+        const contentType = response.headers.get("content-type") || "";
+        if (!contentType.includes("application/json")) {
+            const text = await response.text().catch(() => "");
+            throw new Error(`Expected JSON from chat endpoint but got "${contentType}". ` +
+                `If you're using the Sammy SDK route handler, this should not happen — ` +
+                `make sure your /api/chat route uses createSammyRouteHandler() from sammy-sdk, ` +
+                `or use client.stream() instead of client.chat() for SSE-only endpoints. ` +
+                `Body preview: ${text.slice(0, 200)}`);
+        }
+        return response.json();
+    }
+    stream(message, options) {
+        return (0, stream_1.createStream)(this.config, message, options);
+    }
+    conversation(id) {
+        const conversationId = id || crypto.randomUUID();
+        return {
+            id: conversationId,
+            send: (message) => this.chat(message, { conversationId }),
+            stream: (message) => this.stream(message, { conversationId }),
+        };
+    }
+    async resolveHeaders() {
+        if (!this.config.headers)
+            return {};
+        if (typeof this.config.headers === "function")
+            return this.config.headers();
+        return this.config.headers;
+    }
+}
+exports.SammyClient = SammyClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { SammyClient } from "./client";
+export type { SammyClientConfig, ChatOptions, ChatResponse, SammyStream, ToolCallEvent, ToolResultEvent, ToolResult, ToolCallResult, AgentHandoffEvent, Attachment, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,eAAe,EACf,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SammyClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "SammyClient", { enumerable: true, get: function () { return client_1.SammyClient; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAuC;AAA9B,qGAAA,WAAW,OAAA"}

package/dist/stream.d.ts

@@ -0,0 +1,3 @@
+import type { SammyClientConfig, ChatOptions, SammyStream } from "./types";
+export declare function createStream(config: SammyClientConfig, message: string, options?: ChatOptions): SammyStream;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAgB,WAAW,EAAqD,MAAM,SAAS,CAAC;AAmB5I,wBAAgB,YAAY,CAC1B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,WAAW,CA8Gb"}

package/dist/stream.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStream = createStream;
+function coerceError(payload) {
+    if (payload instanceof Error)
+        return payload;
+    if (typeof payload === "string")
+        return new Error(payload);
+    if (payload && typeof payload === "object") {
+        const message = payload.message;
+        if (typeof message === "string")
+            return new Error(message);
+        try {
+            return new Error(JSON.stringify(payload));
+        }
+        catch {
+            return new Error("Unknown error");
+        }
+    }
+    return new Error("Unknown error");
+}
+function createStream(config, message, options) {
+    const handlers = {};
+    let abortController = new AbortController();
+    let finalResponse = null;
+    const emit = (event, payload) => {
+        const list = handlers[event];
+        if (!list)
+            return;
+        for (const handler of list) {
+            try {
+                handler(payload);
+            }
+            catch {
+                // Swallow handler errors so one bad listener doesn't kill the stream.
+            }
+        }
+    };
+    const stream = {
+        on(event, handler) {
+            if (!handlers[event])
+                handlers[event] = [];
+            handlers[event].push(handler);
+            return stream;
+        },
+        abort() {
+            abortController?.abort();
+            abortController = null;
+        },
+    };
+    (async () => {
+        try {
+            const headersFn = config.headers;
+            const resolvedHeaders = headersFn
+                ? typeof headersFn === "function" ? await headersFn() : headersFn
+                : {};
+            const response = await fetch(config.endpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", Accept: "text/event-stream", ...resolvedHeaders },
+                body: JSON.stringify({
+                    message,
+                    conversationId: options?.conversationId || config.conversationId,
+                    stream: true,
+                    metadata: options?.metadata,
+                }),
+                signal: abortController?.signal,
+            });
+            if (!response.ok || !response.body) {
+                throw new Error(`Stream failed: ${response.status} ${response.statusText}`);
+            }
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() || "";
+                for (const line of lines) {
+                    if (!line.startsWith("data: "))
+                        continue;
+                    const data = line.slice(6);
+                    if (data === "[DONE]")
+                        continue;
+                    let event;
+                    try {
+                        event = JSON.parse(data);
+                    }
+                    catch {
+                        continue;
+                    }
+                    switch (event.type) {
+                        case "text":
+                            if (typeof event.data === "string")
+                                emit("text", event.data);
+                            break;
+                        case "tool_call":
+                            emit("tool_call", event.data);
+                            break;
+                        case "tool_result":
+                            emit("tool_result", event.data);
+                            break;
+                        case "agent_handoff":
+                            emit("agent_handoff", event.data);
+                            break;
+                        case "done":
+                            finalResponse = event.data;
+                            break;
+                        case "error":
+                            emit("error", coerceError(event.data));
+                            break;
+                        default:
+                            // Forward-compatible: ignore unknown event types.
+                            break;
+                    }
+                }
+            }
+            emit("done", finalResponse ?? {});
+        }
+        catch (error) {
+            if (error.name === "AbortError")
+                return;
+            emit("error", coerceError(error));
+        }
+    })();
+    return stream;
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+export interface SammyClientConfig {
+    endpoint: string;
+    headers?: Record<string, string> | (() => Promise<Record<string, string>>);
+    conversationId?: string;
+    retries?: number;
+    timeout?: number;
+}
+export interface ChatOptions {
+    conversationId?: string;
+    metadata?: Record<string, unknown>;
+    attachments?: Attachment[];
+}
+export interface Attachment {
+    type: "image" | "document";
+    mimeType: string;
+    name: string;
+    data?: string;
+    url?: string;
+    extractedText?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ToolCallEvent {
+    id: string;
+    name: string;
+    params: Record<string, unknown>;
+}
+export interface ToolResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+export interface ToolResultEvent {
+    id: string;
+    name: string;
+    result: ToolResult;
+}
+export interface AgentHandoffEvent {
+    fromAgent: string;
+    targetAgent: string;
+    reason: string;
+}
+export interface ToolCallResult {
+    id: string;
+    name: string;
+    params: Record<string, unknown>;
+    success: boolean;
+    result?: unknown;
+    error?: string;
+}
+export interface ChatResponse {
+    message: string;
+    conversationId: string;
+    toolsUsed: ToolCallResult[];
+    agentUsed: string;
+    suggestedFollowUps: string[];
+    agentHandoff?: AgentHandoffEvent;
+}
+export interface SammyStream {
+    on(event: "text", handler: (chunk: string) => void): SammyStream;
+    on(event: "tool_call", handler: (call: ToolCallEvent) => void): SammyStream;
+    on(event: "tool_result", handler: (result: ToolResultEvent) => void): SammyStream;
+    on(event: "agent_handoff", handler: (handoff: AgentHandoffEvent) => void): SammyStream;
+    on(event: "done", handler: (response: ChatResponse) => void): SammyStream;
+    on(event: "error", handler: (error: Error) => void): SammyStream;
+    abort(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "sammy-sdk-client",
+  "version": "0.1.0",
+  "description": "Zero-dependency JavaScript client for the Sammy AI agent runtime (SSE streaming, conversations, attachments).",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "sammy",
+    "sammy-sdk",
+    "ai",
+    "agent",
+    "chat",
+    "client",
+    "sse",
+    "streaming"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sammymitch0071/sammy.git",
+    "directory": "packages/client"
+  },
+  "bugs": {
+    "url": "https://github.com/sammymitch0071/sammy/issues"
+  },
+  "homepage": "https://sammy.dev",
+  "devDependencies": {
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist tsconfig.tsbuildinfo"
+  }
+}