@useago/sdk 0.3.2 → 0.3.3

package/dist/rolldown-runtime-BqCkTl7Q.cjs

@@ -1,50 +0,0 @@
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-Object.defineProperty(exports, "__commonJSMin", {
-	enumerable: true,
-	get: function() {
-		return __commonJSMin;
-	}
-});
-Object.defineProperty(exports, "__exportAll", {
-	enumerable: true,
-	get: function() {
-		return __exportAll;
-	}
-});
-Object.defineProperty(exports, "__toESM", {
-	enumerable: true,
-	get: function() {
-		return __toESM;
-	}
-});

package/dist/rolldown-runtime-CNZpIYwj.js

@@ -1,33 +0,0 @@
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-export { __exportAll as n, __toESM as r, __commonJSMin as t };

package/dist/state/ClientContextRegistry.d.ts

@@ -1,64 +0,0 @@
-/**
- * A single piece of context the client wants the LLM to know about.
- */
-export interface ContextEntry {
-    /** Human-readable label (e.g. "Order detail", "Current user") */
-    name?: string;
-    /** Short description of what this context represents */
-    description?: string;
-    /** Arbitrary structured data the AI should know about */
-    data?: Record<string, unknown>;
-}
-/**
- * Serialised client context sent with each message.
- */
-export interface ContextSnapshot {
-    /** All active context entries keyed by their registration key */
-    entries: Record<string, ContextEntry>;
-}
-/**
- * A function that returns a fresh context entry on demand.
- * Evaluated every time a message is sent — use it to pull data from stores,
- * refs, or any source that isn't captured by React state.
- */
-export type DynamicContextProvider = () => ContextEntry | null | undefined;
-/**
- * Registry that collects client-side context from across the component tree.
- *
- * Components register/unregister context slices via unique keys.
- * When a message is sent the registry produces a single snapshot.
- */
-export declare class ClientContextRegistry {
-    private entries;
-    private dynamicProviders;
-    /**
-     * Register or update a static context entry.
-     */
-    set(key: string, entry: ContextEntry): void;
-    /**
-     * Remove a static context entry (typically on component unmount).
-     */
-    remove(key: string): boolean;
-    /**
-     * Register a dynamic context provider. The function is called every time
-     * a message is sent, so it always returns the freshest data.
-     *
-     * Use this for context that lives outside React state — global stores,
-     * refs, or computed values that shouldn't trigger re-renders.
-     */
-    addDynamicProvider(key: string, provider: DynamicContextProvider): void;
-    /**
-     * Remove a dynamic context provider.
-     */
-    removeDynamicProvider(key: string): boolean;
-    /**
-     * Build a snapshot of the current client context.
-     * Evaluates every registered dynamic provider. Returns `null` when there is
-     * nothing to report.
-     */
-    getSnapshot(): ContextSnapshot | null;
-    /**
-     * Remove all entries and dynamic providers.
-     */
-    clear(): void;
-}

package/dist/state/createStore.d.ts

@@ -1,30 +0,0 @@
-/**
- * A minimal observable store: one value, synchronous subscriptions, and
- * optional persistence via {@link PersistOptions} (localStorage by default).
- *
- * ```ts
- * const store = createStore({ count: 0 });
- * store.subscribe((state) => save(state));
- * store.set({ count: 1 }); // listeners fire synchronously
- *
- * const cart = createStore({ items: [] }, { key: "cart" }); // persisted
- * ```
- */
-export interface Store<T> {
-    /** Current state. */
-    get(): T;
-    /** Replace the state and notify subscribers synchronously. */
-    set(next: T): void;
-    /** Register a listener; returns a function that removes it. */
-    subscribe(listener: (state: T) => void): () => void;
-}
-/** The slice of the Web Storage API that {@link createStore} relies on. */
-type StorageLike = Pick<Storage, "getItem" | "setItem">;
-export interface PersistOptions {
-    /** Key under which the state is JSON-serialized. */
-    key: string;
-    /** Storage backend; defaults to `globalThis.localStorage`. */
-    storage?: StorageLike;
-}
-export declare function createStore<T>(initial: T, persist?: PersistOptions): Store<T>;
-export {};

package/dist/streaming/SSEHandler.d.ts

@@ -1,46 +0,0 @@
-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/helpers.d.ts

@@ -1,67 +0,0 @@
-import type { AgoClient } from "../client/AgoClient";
-import type { AgoMessage, AgoClientEvents, ToolCallData, ClientFunctionInvocation } from "../client/types";
-/**
- * Subscribe to complete messages with a simple callback. Returns an unsubscribe function.
- *
- * ```ts
- * const unsub = onMessage(client, (msg) => console.log(msg.content));
- * // later: unsub();
- * ```
- */
-export declare function onMessage(client: AgoClient, callback: (message: AgoMessage) => void): () => void;
-/**
- * Subscribe to streaming text chunks.
- *
- * ```ts
- * onMessageChunk(client, ({ content }) => {
- *   outputEl.textContent += content;
- * });
- * ```
- */
-export declare function onMessageChunk(client: AgoClient, callback: (data: AgoClientEvents["message:chunk"]) => void): () => void;
-/**
- * Subscribe to message start events.
- */
-export declare function onMessageStart(client: AgoClient, callback: (data: AgoClientEvents["message:start"]) => void): () => void;
-/**
- * Subscribe to message errors.
- */
-export declare function onMessageError(client: AgoClient, callback: (data: AgoClientEvents["message:error"]) => void): () => void;
-/**
- * Subscribe to tool call events.
- */
-export declare function onToolCall(client: AgoClient, callback: (toolCall: ToolCallData) => void): () => void;
-/**
- * Subscribe to client function invocations.
- */
-export declare function onFunctionInvoke(client: AgoClient, callback: (data: ClientFunctionInvocation) => void): () => void;
-/**
- * Send a message and iterate over chunks as an async generator.
- * Gives you full control over how you process the stream.
- *
- * ```ts
- * for await (const chunk of createMessageStream(client, "Hello!")) {
- *   console.log(chunk.type, chunk.data);
- * }
- * ```
- */
-export declare function createMessageStream(client: AgoClient, content: string, options?: {
-    conversationId?: string;
-    agentId?: string;
-    files?: File[];
-}): AsyncGenerator<{
-    type: "start";
-    data: AgoClientEvents["message:start"];
-} | {
-    type: "chunk";
-    data: AgoClientEvents["message:chunk"];
-} | {
-    type: "complete";
-    data: AgoMessage;
-} | {
-    type: "error";
-    data: AgoClientEvents["message:error"];
-} | {
-    type: "toolCall";
-    data: ToolCallData;
-}>;

package/dist/streaming/index.d.ts

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

package/dist/testing/createMockClient.d.ts

@@ -1,42 +0,0 @@
-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

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

package/dist/utils/eventEmitter.d.ts

@@ -1,23 +0,0 @@
-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

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

package/dist/utils/logger.d.ts

@@ -1,14 +0,0 @@
-/**
- * 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/vue/composables/useAgo.d.ts

@@ -1,17 +0,0 @@
-import { AgoClient } from "../../client/AgoClient";
-import type { AgoConfig } from "../../client/types";
-/**
- * Get or create an AgoClient.
- *
- * - Without args: returns the client from `AgoPlugin` (throws if none).
- * - With config: creates a new client instance.
- *
- * ```ts
- * // From plugin
- * const client = useAgo();
- *
- * // Standalone
- * const client = useAgo({ baseUrl: "https://YOUR-DOMAIN.useago.com" });
- * ```
- */
-export declare function useAgo(config?: AgoConfig): AgoClient;

package/dist/vue/composables/useAgoEvents.d.ts

@@ -1,11 +0,0 @@
-import type { AgoClientEvents, AgoEventName } from "../../client/types";
-/**
- * Subscribe to AGO client events with auto-cleanup on unmount.
- *
- * ```ts
- * useAgoEvents("message:complete", (msg) => {
- *   console.log("Got message:", msg.content);
- * });
- * ```
- */
-export declare function useAgoEvents<K extends AgoEventName>(event: K, handler: (data: AgoClientEvents[K]) => void): void;

package/dist/vue/composables/useAgoFunction.d.ts

@@ -1,34 +0,0 @@
-import type { ClientFunctionHandler, ClientFunctionSchema } from "../../functions/types";
-/**
- * Register a client-side function with auto-cleanup on unmount.
- *
- * ```ts
- * useAgoFunction("showToast", {
- *   description: "Show a toast",
- *   parameters: { type: "object", properties: { message: { type: "string" } } },
- *   handler: async (args) => { toast(args.message); return { shown: true }; },
- * });
- * ```
- */
-export declare function useAgoFunction(name: string, options: {
-    description: string;
-    parameters: ClientFunctionSchema["parameters"];
-    handler: ClientFunctionHandler;
-}): void;
-export interface AgoRoute {
-    name: string;
-    path: string;
-    description: string;
-}
-/**
- * Register navigation routes with auto-cleanup on unmount.
- * Works with vue-router's `useRouter().push`.
- *
- * ```ts
- * const router = useRouter();
- * useAgoNavigation((path) => router.push(path), [
- *   { name: "dashboard", path: "/dashboard", description: "Main dashboard" },
- * ]);
- * ```
- */
-export declare function useAgoNavigation(navigate: (path: string) => void, routes: AgoRoute[]): void;

package/dist/vue/composables/useAgoStore.d.ts

@@ -1,18 +0,0 @@
-import { type ShallowRef } from "vue";
-import type { Store } from "../../state/createStore";
-/**
- * Read a framework-agnostic AGO store (`createStore`) as a reactive Vue ref.
- *
- * The ref's `.value` updates on every `store.set(...)`. Mutate through the store,
- * not the ref. A `shallowRef` is used because the store replaces its value
- * wholesale, so deep reactivity would be wasted work.
- *
- * ```ts
- * const cart = createStore({ items: [] as string[] });
- *
- * // in setup():
- * const state = useAgoStore(cart);
- * // template: {{ state.items.length }}
- * ```
- */
-export declare function useAgoStore<T>(store: Store<T>): ShallowRef<T>;