@useago/sdk 0.1.0

package/dist/streaming/SSEHandler.d.ts

@@ -0,0 +1,46 @@
+import type { AgoMessage, ToolCallData } from "../client/types";
+export interface SSEHandlerCallbacks {
+    onStart?: (data: {
+        conversationId: string;
+        messageId: string;
+    }) => void;
+    onChunk?: (data: {
+        content: string;
+        conversationId: string;
+        messageId: string;
+    }) => void;
+    onToolCall?: (toolCall: ToolCallData) => void;
+    onClientFunction?: (data: {
+        invocationId: string;
+        functionName: string;
+        arguments: Record<string, unknown>;
+        conversationId: string;
+    }) => void;
+    onComplete?: (message: AgoMessage) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Handles SSE streaming responses from AGO backend
+ */
+export declare class SSEHandler {
+    private callbacks;
+    private buffer;
+    private message;
+    private toolCalls;
+    private sources;
+    private followUpReplies;
+    private isFirstChunk;
+    constructor(callbacks: SSEHandlerCallbacks);
+    /**
+     * Process a streaming response
+     */
+    processStream(response: Response): Promise<AgoMessage>;
+    private processBuffer;
+    private handleChunk;
+    private parseToolCall;
+    private buildFinalMessage;
+}
+/**
+ * Check if an error is a network error that should trigger polling fallback
+ */
+export declare function isStreamNetworkError(error: Error): boolean;

package/dist/streaming/index.d.ts

@@ -0,0 +1,2 @@
+export { SSEHandler, isStreamNetworkError } from "./SSEHandler";
+export type { SSEHandlerCallbacks } from "./SSEHandler";

package/dist/testing/createMockClient.d.ts

@@ -0,0 +1,42 @@
+import type { AgoClient } from "../client/AgoClient";
+import type { AgoClientEvents, AgoEventName } from "../client/types";
+type MockFn = (...args: any[]) => any;
+export interface MockAgoClientOptions {
+    overrides?: Partial<Record<string, MockFn>>;
+}
+export interface MockAgoClient extends AgoClient {
+    /**
+     * Simulate a server-pushed event.
+     * ```ts
+     * mock.__emitEvent("message:complete", { id: "1", content: "hi", ... });
+     * ```
+     */
+    __emitEvent<K extends AgoEventName>(event: K, data: AgoClientEvents[K]): void;
+    /**
+     * All recorded method calls: `[methodName, ...args][]`
+     */
+    __calls: Array<{
+        method: string;
+        args: unknown[];
+    }>;
+    /**
+     * Get calls for a specific method.
+     */
+    __callsFor(method: string): Array<{
+        method: string;
+        args: unknown[];
+    }>;
+}
+/**
+ * Create a mock AgoClient for testing. Works with any framework.
+ *
+ * ```ts
+ * import { createMockClient } from "@useago/sdk/testing";
+ *
+ * const mock = createMockClient();
+ * mock.__emitEvent("message:complete", someMessage);
+ * expect(mock.__callsFor("sendMessage")).toHaveLength(1);
+ * ```
+ */
+export declare function createMockClient(options?: MockAgoClientOptions): MockAgoClient;
+export {};

package/dist/testing/index.d.ts

@@ -0,0 +1,2 @@
+export { createMockClient } from "./createMockClient";
+export type { MockAgoClient, MockAgoClientOptions } from "./createMockClient";

package/dist/utils/eventEmitter.d.ts

@@ -0,0 +1,23 @@
+type EventHandler<T = unknown> = (data: T) => void;
+/**
+ * Simple typed event emitter
+ */
+export declare class EventEmitter<Events extends Record<string, any> = Record<string, unknown>> {
+    private handlers;
+    on<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): void;
+    off<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): void;
+    emit<K extends keyof Events>(event: K, data: Events[K]): void;
+    /**
+     * Subscribe to an event and auto-unsubscribe after the first call.
+     */
+    once<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): void;
+    /**
+     * Returns a Promise that resolves the next time `event` fires.
+     * Rejects if `timeout` (ms) is reached first.
+     */
+    waitFor<K extends keyof Events>(event: K, options?: {
+        timeout?: number;
+    }): Promise<Events[K]>;
+    removeAllListeners(event?: keyof Events): void;
+}
+export {};

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { EventEmitter } from "./eventEmitter";
+export { Logger, logger } from "./logger";

package/dist/utils/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Debug logger for SDK
+ */
+export declare class Logger {
+    private enabled;
+    constructor(enabled?: boolean);
+    enable(): void;
+    disable(): void;
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+}
+export declare const logger: Logger;

package/dist/widget/index.d.ts

@@ -0,0 +1 @@
+export type { AgoWidgetConfig, AgoWidgetColors } from "./types";

package/dist/widget/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Widget configuration types.
+ *
+ * These types describe the `window.AGO` configuration object
+ * used by the embeddable chat widget snippet.
+ *
+ * @example
+ * ```ts
+ * import type { AgoWidgetConfig } from "@useago/sdk/widget";
+ * ```
+ */
+export interface AgoWidgetColors {
+    button?: string;
+    header?: string;
+    agentMessage?: string;
+    agentMessageFont?: string;
+    background?: string;
+    font?: string;
+    userMessage?: string;
+    userMessageFont?: string;
+}
+export interface AgoWidgetConfig {
+    basepath: string;
+    widgetApiKey: string;
+    defaultAgent?: string;
+    email?: string;
+    title?: string;
+    icon?: string;
+    prompt?: string;
+    notifications?: boolean;
+    notificationMessage?: string;
+    colors?: AgoWidgetColors;
+    hideFooter?: boolean;
+    jwt?: string;
+    authToken?: string;
+    permission?: string;
+}
+declare global {
+    interface Window {
+        AGO: AgoWidgetConfig;
+    }
+}

package/dist/widget.cjs

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=widget.cjs.map

package/dist/widget.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/widget.d.ts

@@ -0,0 +1 @@
+export * from './widget/index'

package/dist/widget.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=widget.js.map

package/dist/widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@useago/sdk",
+  "version": "0.1.0",
+  "description": "JavaScript SDK for AGO Chat integration",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs",
+      "types": "./dist/react.d.ts"
+    },
+    "./widget": {
+      "import": "./dist/widget.js",
+      "require": "./dist/widget.cjs",
+      "types": "./dist/widget.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "react-markdown": "^9.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.0.0",
+    "jsdom": "^28.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^3.0.0",
+    "vitest": "^1.0.0"
+  },
+  "keywords": [
+    "ago",
+    "chat",
+    "sdk",
+    "ai",
+    "chatbot"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/useago/sdk.git"
+  }
+}