@projectaria/cf-agents 0.1.1 → 0.1.3

package/dist/AriaAgent.d.ts

@@ -1,186 +0,0 @@
-/**
- * ARIA Agent - Cloudflare Agents integration with proper memory primitives
- *
- * Memory Architecture:
- * 1. Session: Current conversation thread with chronological messages
- * 2. State: Temporary data within the current conversation (working memory)
- * 3. Memory: Searchable, cross-session information (knowledge base)
- *
- * AI SDK 6.0 Message Types (matching agents@0.3.3):
- * - UIMessage: Format with UI metadata (id, role, parts)
- * - ModelMessage: Format expected by LLM models
- * - convertToModelMessages: Converts UIMessage[] to ModelMessage[]
- */
-import { AIChatAgent } from "agents/ai-chat-agent";
-import { type AgentContext } from "agents";
-import type { StreamTextOnFinishCallback, ToolSet } from "ai";
-import type { AriaEnv, AriaMemory, AriaSession, AriaSessionState, FlowTransition, MemorySearchQuery, MemorySearchResult, WorkingMemory } from "./types";
-/**
- * ARIA Agent extending AIChatAgent
- *
- * Provides:
- * - Session management with conversation history
- * - State management (working memory) for session-local data
- * - Memory layer for cross-session knowledge
- * - Flow orchestration integration
- * - Multi-turn conversation support
- */
-export declare class AriaAgent extends AIChatAgent<AriaEnv, AriaSessionState> {
-    private config;
-    private flowDefinitions;
-    constructor(ctx: AgentContext, env: AriaEnv);
-    /**
-     * Initialize ARIA-specific database tables
-     */
-    private initializeTables;
-    /**
-     * Initial state when no session exists
-     */
-    initialState: AriaSessionState;
-    /**
-     * Get the current session
-     * Session = Current conversation thread with chronological messages
-     */
-    getSession(): AriaSession;
-    /**
-     * Get session creation time from storage
-     */
-    private getCreatedAt;
-    /**
-     * Record a session event for tracking
-     */
-    private recordSessionEvent;
-    /**
-     * Get working memory (state within current conversation)
-     * Examples: shopping cart items, user preferences mentioned in this session
-     */
-    getWorkingMemory(): WorkingMemory;
-    /**
-     * Set a value in working memory
-     */
-    setWorkingMemory(key: string, value: unknown): void;
-    /**
-     * Clear all working memory
-     */
-    clearWorkingMemory(): void;
-    /**
-     * Handle state updates (called by Cloudflare Agents framework)
-     * This is triggered whenever setState is called, either from the server or from a connected client.
-     *
-     * Use cases:
-     * - React state synchronization via useAgent hook
-     * - Logging state changes
-     * - Triggering side effects on state changes
-     *
-     * @param state - The updated state
-     * @param source - "server" if update came from the agent, or a Connection object if from a client
-     */
-    onStateUpdate(state: AriaSessionState, source: "server" | unknown): void;
-    /**
-     * Store a memory for cross-session retrieval
-     * Memory = Searchable, cross-session information (knowledge base)
-     */
-    storeMemory(memory: Omit<AriaMemory, "id" | "createdAt" | "lastAccessedAt" | "accessCount">): string;
-    /**
-     * Search memory by query
-     * Returns relevant memories across all sessions
-     */
-    searchMemories(query: MemorySearchQuery): MemorySearchResult[];
-    /**
-     * Get a specific memory by key
-     */
-    getMemory(key: string): AriaMemory | null;
-    /**
-     * Update memory access (increments access count and updates timestamp)
-     */
-    private updateMemoryAccess;
-    /**
-     * Clean up old memories based on retention policy
-     */
-    cleanupOldMemories(): void;
-    /**
-     * Register a flow definition
-     */
-    registerFlow(flow: import("@projectaria/aria-agents").FlowDefinition): void;
-    /**
-     * Record a flow transition
-     */
-    recordFlowTransition(flowId: string, fromNodeId: string | null, toNodeId: string, metadata?: Record<string, unknown>): void;
-    /**
-     * Get flow transition history
-     */
-    getFlowHistory(flowId?: string, limit?: number): FlowTransition[];
-    /**
-     * Handle incoming chat messages
-     * This is where ARIA's flow orchestration would be integrated
-     */
-    onChatMessage(onFinish: StreamTextOnFinishCallback<ToolSet>, options?: {
-        abortSignal?: AbortSignal;
-        clientTools?: Array<{
-            name: string;
-            description?: string;
-            parameters?: import("ai").JSONSchema7;
-        }>;
-    }): Promise<Response | undefined>;
-    /**
-     * Build system prompt with conversation context
-     */
-    private buildSystemPrompt;
-    /**
-     * Run an ARIA agent with persistence
-     * This method allows you to use ARIA's createAgent() with persistent memory
-     *
-     * @param agent - The ARIA agent created via createAgent()
-     * @param input - The user input
-     * @returns The agent response with persisted session state
-     */
-    runAriaAgent(agent: import("@projectaria/aria-agents").Agent, input: string): Promise<{
-        text: string;
-        session: import("@projectaria/aria-agents").AgentSession;
-    }>;
-    /**
-     * Stream an ARIA agent response with persistence
-     *
-     * @param agent - The ARIA agent created via createAgent()
-     * @param input - The user input
-     * @returns Stream result with session
-     */
-    streamAriaAgent(agent: import("@projectaria/aria-agents").Agent, input: string): Promise<{
-        fullStream: AsyncIterable<import("@projectaria/aria-agents").AriaStreamPart>;
-        textStream: AsyncIterable<string>;
-        usage?: Promise<import("ai").LanguageModelUsage | undefined>;
-    }>;
-    /**
-     * Build ARIA agent prompt with context from session and memories
-     */
-    private buildAriaAgentPrompt;
-    /**
-     * Extract and store memories from ARIA agent conversation
-     */
-    private extractAndStoreMemories;
-    /**
-     * Extract preference key from message content
-     */
-    private extractPreferenceKey;
-    /**
-     * Extract fact key from message content
-     */
-    private extractFactKey;
-    /**
-     * Called when agent starts
-     */
-    onStart(): Promise<void>;
-    /**
-     * Called when a client connects
-     */
-    onConnect(connection: import("agents").Connection, ctx: import("agents").ConnectionContext): Promise<void>;
-    /**
-     * Cleanup when destroyed
-     */
-    destroy(): Promise<void>;
-    /**
-     * Handle HTTP requests
-     */
-    onRequest(request: Request): Promise<Response>;
-}
-//# sourceMappingURL=AriaAgent.d.ts.map

package/dist/AriaAgent.d.ts.map

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