@cloudbase/agent-ui-miniprogram 0.0.12 → 1.0.1-alpha.7

package/dist/transport.d.ts

@@ -1,85 +0,0 @@
-/**
- * AG-UI Transport Implementations
- */
-import { type BaseEvent, type RunAgentInput, type Transport } from "./types";
-/**
- * Mock transport implementation for testing and development.
- *
- * Simulates an AG-UI agent backend by emitting a configurable sequence
- * of events. Useful for unit tests, prototyping, and demo applications.
- *
- * @example
- * ```typescript
- * // Create with predefined events
- * const transport = new MockTransport({
- *   events: MockTransport.createTextResponse('Hello, world!'),
- *   delayMs: 100, // Simulate network latency
- * });
- *
- * // Or set events dynamically
- * transport.setEvents(MockTransport.createToolCallResponse('get_weather', { city: 'NYC' }));
- * ```
- */
-export declare class MockTransport implements Transport {
-    private events;
-    private delayMs;
-    constructor(options?: {
-        events?: BaseEvent[];
-        delayMs?: number;
-    });
-    /**
-     * Set the events to emit during the next `run()` call.
-     *
-     * @param events - Array of AG-UI events to emit
-     */
-    setEvents(events: BaseEvent[]): void;
-    /**
-     * Create a simple text response event sequence.
-     *
-     * @param text - The text content of the assistant's response
-     * @param messageId - Optional message ID (defaults to "msg-1")
-     * @returns Array of events representing a complete text response
-     */
-    static createTextResponse(text: string, messageId?: string): BaseEvent[];
-    /**
-     * Create a tool call response event sequence.
-     *
-     * @param toolName - Name of the tool being called
-     * @param args - Arguments to pass to the tool (will be JSON stringified)
-     * @param toolCallId - Optional tool call ID (defaults to "tc-1")
-     * @returns Array of events representing a tool call (without RUN_FINISHED)
-     */
-    static createToolCallResponse(toolName: string, args: Record<string, unknown>, toolCallId?: string): BaseEvent[];
-    run(_input: RunAgentInput): AsyncIterable<BaseEvent>;
-    private delay;
-}
-/**
- * Production transport for WeChat Cloud Development (Cloudbase).
- *
- * Connects to a WeChat AI Bot configured in the Cloud Development console.
- * Requires the `wx.cloud.extend.AI.bot.sendMessage` API to be available.
- *
- * @example
- * ```typescript
- * const transport = new CloudbaseTransport({
- *   botId: 'bot-xxxxxx', // Your bot ID from Cloud Development console
- * });
- *
- * Component({
- *   behaviors: [createAGUIBehavior({ transport })],
- * });
- * ```
- */
-export declare class CloudbaseTransport implements Transport {
-    private botId;
-    /**
-     * Create a new CloudbaseTransport instance.
-     *
-     * @param options - Configuration options
-     * @param options.botId - The bot ID from WeChat Cloud Development console
-     */
-    constructor(options: {
-        botId: string;
-    });
-    run(input: RunAgentInput): AsyncIterable<BaseEvent>;
-}

package/dist/types.d.ts

@@ -1,315 +0,0 @@
-/**
- * AG-UI WeChat Miniprogram SDK Types
- */
-/**
- * Event types for AG-UI protocol
- * @see @ag-ui/core EventType
- */
-export declare enum EventType {
-    TEXT_MESSAGE_START = "TEXT_MESSAGE_START",
-    TEXT_MESSAGE_CONTENT = "TEXT_MESSAGE_CONTENT",
-    TEXT_MESSAGE_END = "TEXT_MESSAGE_END",
-    TEXT_MESSAGE_CHUNK = "TEXT_MESSAGE_CHUNK",
-    THINKING_TEXT_MESSAGE_START = "THINKING_TEXT_MESSAGE_START",
-    THINKING_TEXT_MESSAGE_CONTENT = "THINKING_TEXT_MESSAGE_CONTENT",
-    THINKING_TEXT_MESSAGE_END = "THINKING_TEXT_MESSAGE_END",
-    TOOL_CALL_START = "TOOL_CALL_START",
-    TOOL_CALL_ARGS = "TOOL_CALL_ARGS",
-    TOOL_CALL_END = "TOOL_CALL_END",
-    TOOL_CALL_CHUNK = "TOOL_CALL_CHUNK",
-    TOOL_CALL_RESULT = "TOOL_CALL_RESULT",
-    THINKING_START = "THINKING_START",
-    THINKING_END = "THINKING_END",
-    STATE_SNAPSHOT = "STATE_SNAPSHOT",
-    STATE_DELTA = "STATE_DELTA",
-    MESSAGES_SNAPSHOT = "MESSAGES_SNAPSHOT",
-    ACTIVITY_SNAPSHOT = "ACTIVITY_SNAPSHOT",
-    ACTIVITY_DELTA = "ACTIVITY_DELTA",
-    RAW = "RAW",
-    CUSTOM = "CUSTOM",
-    RUN_STARTED = "RUN_STARTED",
-    RUN_FINISHED = "RUN_FINISHED",
-    RUN_ERROR = "RUN_ERROR",
-    STEP_STARTED = "STEP_STARTED",
-    STEP_FINISHED = "STEP_FINISHED"
-}
-/**
- * Base event interface - all events have these fields
- */
-export interface BaseEvent {
-    type: EventType;
-    timestamp?: number;
-    rawEvent?: unknown;
-}
-/**
- * Event type interfaces for type casting in switch statements
- */
-export interface RunStartedEvent extends BaseEvent {
-    type: EventType.RUN_STARTED;
-    threadId: string;
-    runId: string;
-    parentRunId?: string;
-}
-export interface RunFinishedEvent extends BaseEvent {
-    type: EventType.RUN_FINISHED;
-    threadId: string;
-    runId: string;
-}
-export interface RunErrorEvent extends BaseEvent {
-    type: EventType.RUN_ERROR;
-    message: string;
-    code?: string;
-}
-export interface TextMessageStartEvent extends BaseEvent {
-    type: EventType.TEXT_MESSAGE_START;
-    messageId: string;
-    role: "developer" | "system" | "assistant" | "user";
-}
-export interface TextMessageContentEvent extends BaseEvent {
-    type: EventType.TEXT_MESSAGE_CONTENT;
-    messageId: string;
-    delta: string;
-}
-export interface TextMessageEndEvent extends BaseEvent {
-    type: EventType.TEXT_MESSAGE_END;
-    messageId: string;
-}
-export interface ToolCallStartEvent extends BaseEvent {
-    type: EventType.TOOL_CALL_START;
-    toolCallId: string;
-    toolCallName: string;
-    parentMessageId?: string;
-}
-export interface ToolCallArgsEvent extends BaseEvent {
-    type: EventType.TOOL_CALL_ARGS;
-    toolCallId: string;
-    delta: string;
-}
-export interface ToolCallEndEvent extends BaseEvent {
-    type: EventType.TOOL_CALL_END;
-    toolCallId: string;
-}
-export interface MessagesSnapshotEvent extends BaseEvent {
-    type: EventType.MESSAGES_SNAPSHOT;
-    messages: Message[];
-}
-/**
- * Message structure for AG-UI
- * @see @ag-ui/core Message
- */
-export interface Message {
-    id: string;
-    role: "user" | "assistant" | "system" | "tool" | "developer";
-    content: string;
-    name?: string;
-    toolCallId?: string;
-    toolCalls?: ToolCall[];
-}
-/**
- * Tool definition
- */
-export interface Tool {
-    name: string;
-    description: string;
-    parameters?: Record<string, unknown>;
-}
-/**
- * Tool call structure
- */
-export interface ToolCall {
-    id: string;
-    type: "function";
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-/**
- * Context for agent runs
- */
-export interface Context {
-    description: string;
-    value: string;
-}
-/**
- * Input for running an agent
- */
-export interface RunAgentInput {
-    threadId: string;
-    runId?: string;
-    messages?: Message[];
-    tools?: Tool[];
-    context?: Context[];
-    state?: unknown;
-    forwardedProps?: Record<string, unknown>;
-}
-/**
- * Transport interface - abstracts the network layer
- * All implementations handle their own HTTP/WebSocket details internally
- */
-export interface Transport {
-    run(input: RunAgentInput): AsyncIterable<BaseEvent>;
-}
-/**
- * Parameters passed to tool handler during execution
- */
-export interface ToolHandlerParams {
-    /** Tool name */
-    name: string;
-    /** Tool description */
-    description: string;
-    /** Unique ID for this tool call */
-    toolCallId: string;
-    /** Parsed arguments from the agent */
-    args: Record<string, unknown>;
-}
-/**
- * Tool handler function signature
- * Must return a string result (or Promise<string>)
- */
-export type ToolHandler = (params: ToolHandlerParams) => string | Promise<string>;
-/**
- * Extended Tool with handler function (AG-UI Tool doesn't include handler)
- */
-export interface ClientTool extends Tool {
-    handler: ToolHandler;
-}
-/**
- * Tool call execution status
- */
-export type ToolCallStatus = "pending" | "ready" | "executing" | "completed" | "failed";
-/**
- * Tool call state for UI tracking
- */
-export interface ToolCallState {
-    /** Tool call ID (from TOOL_CALL_START event) */
-    toolCallId: string;
-    name: string;
-    /** Raw accumulated args string (streaming progress) */
-    argsString: string;
-    /** Parsed args (available after TOOL_CALL_END) */
-    args: Record<string, unknown>;
-    status: ToolCallStatus;
-    result?: unknown;
-    error?: AGUIClientError;
-}
-/**
- * Text part of a UI message
- */
-export interface TextPart {
-    /** Message ID this part belongs to */
-    id: string;
-    type: "text";
-    text: string;
-    state?: "streaming" | "done";
-}
-/**
- * Tool part of a UI message - extends ToolCallState with type discriminator and message id
- */
-export interface ToolPart extends ToolCallState {
-    /** Message ID this part belongs to */
-    id: string;
-    type: "tool";
-}
-/**
- * Union of all UI message part types
- */
-export type UIMessagePart = TextPart | ToolPart;
-/**
- * UI Message - merged and structured for rendering
- * Consecutive assistant messages are merged, tool messages are filtered out,
- * content is represented as an ordered array of parts.
- */
-export interface UIMessage {
-    /** First raw message id in the merge group */
-    id: string;
-    role: "user" | "assistant" | "system" | "developer";
-    parts: UIMessagePart[];
-}
-/**
- * Error codes for the SDK
- */
-export type AGUIClientErrorCode = "INIT_ERROR" | "TRANSPORT_ERROR" | "RUNTIME_ERROR" | "INVALID_EVENT" | "TOOL_EXECUTION_ERROR" | "TOOL_NOT_FOUND" | "PARSE_ERROR" | "TIMEOUT" | "INVALID_CONFIG" | "UNKNOWN";
-/**
- * Structured error type for the SDK
- */
-export interface AGUIClientError {
-    code: AGUIClientErrorCode;
-    message: string;
-    recoverable: boolean;
-    details?: unknown;
-    originalError?: Error;
-}
-/**
- * Initialization configuration for AGUI
- */
-export interface AGUIConfig {
-    transport: Transport;
-    threadId?: string;
-}
-/**
- * Options for createAGUIBehavior factory function
- */
-export interface CreateAGUIBehaviorOptions extends Partial<AGUIConfig> {
-    messages?: Message[];
-    tools?: ClientTool[];
-    contexts?: Context[];
-    /** Callback for every raw event received from transport */
-    onRawEvent?: (event: BaseEvent) => void;
-}
-/**
- * Complete AGUI state exposed via Behavior's data
- */
-export interface AGUIState {
-    messages: Message[];
-    /** UI-optimized messages with merged assistant messages and parts-based content */
-    uiMessages: UIMessage[];
-    isRunning: boolean;
-    runId: string | null;
-    activeToolCalls: ToolCallState[];
-    error: AGUIClientError | null;
-    threadId: string;
-    /** Registered tool definitions (without handlers, for UI display) */
-    tools: Tool[];
-    /** Registered contexts */
-    contexts: Context[];
-}
-/**
- * The `this.agui` interface available on components using the AGUI Behavior.
- * Provides both methods and state getters for a unified API.
- *
- * State getters proxy to `this.data.agui.*` for convenience, so you can use
- * either `this.agui.messages` or `this.data.agui.messages` to read state.
- * WXML templates should still use `{{agui.xxx}}` which binds to `this.data.agui`.
- */
-export interface AGUINamespace extends Readonly<AGUIState> {
-    readonly config: CreateAGUIBehaviorOptions;
-    init(config: AGUIConfig): void;
-    setThreadId(threadId: string): void;
-    sendMessage(input: string | Message[]): Promise<void>;
-    appendMessage(message: Message): void;
-    setMessages(messages: Message[]): void;
-    reset(): void;
-    addTool(tool: ClientTool): void;
-    removeTool(name: string): void;
-    updateTool(name: string, updates: Partial<ClientTool>): void;
-    clearTools(): void;
-}
-/**
- * Pending tool call during streaming
- */
-export interface PendingToolCall {
-    id: string;
-    name: string;
-    argsString: string;
-    parentMessageId?: string;
-}
-/**
- * Active message being streamed
- */
-export interface ActiveMessage {
-    id: string;
-    role: string;
-    content: string;
-    toolCalls?: ToolCall[];
-}