@projectaria/cf-agents 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Core types for ARIA Cloudflare Agents integration
+ *
+ * Memory Primitives:
+ * - Session: Current conversation thread with chronological messages
+ * - State: Temporary data within the current conversation
+ * - Memory: Searchable, cross-session information
+ */
+import type { WorkingMemory } from "@projectaria/aria-agents";
+export type { UIMessage } from "ai";
+/**
+ * Session represents a single, ongoing interaction between a user and the agent.
+ * Contains the chronological sequence of messages and actions during that specific interaction.
+ */
+export interface AriaSession {
+    /** Unique session identifier (agent name) */
+    id: string;
+    /** Chronological message history */
+    messages: AriaMessage[];
+    /** Current active flow */
+    activeFlow?: AriaFlowState;
+    /** Message history limit (default: 50) */
+    historyLimit: number;
+    /** Session timestamp */
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * State (session.state): Data within the current conversation
+ * Used to manage information relevant only to the current active conversation.
+ * Examples: shopping cart items, user preferences mentioned in this session.
+ */
+export interface AriaSessionState {
+    /** Working memory - temporary data for current conversation */
+    workingMemory: WorkingMemory;
+    /** Current flow being executed */
+    activeFlowId?: string;
+    /** Current node within the flow */
+    activeNodeId?: string;
+    /** Message history limit */
+    historyLimit: number;
+    /** Session metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Flow state tracking
+ */
+export interface AriaFlowState {
+    flowId: string;
+    currentNodeId: string;
+    enteredAt: number;
+}
+/**
+ * Message format compatible with both ARIA and AI SDK
+ */
+export interface AriaMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string;
+    timestamp: number;
+    /** Optional tool call information */
+    toolCall?: {
+        toolName: string;
+        toolCallId: string;
+        input?: Record<string, unknown>;
+        output?: unknown;
+    };
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Flow transition record for tracking execution history
+ */
+export interface FlowTransition {
+    id: string;
+    flowId: string;
+    fromNodeId: string | null;
+    toNodeId: string;
+    transitionedAt: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Memory represents searchable, cross-session information.
+ * Acts as a knowledge base the agent can search beyond the immediate conversation.
+ */
+export interface AriaMemory {
+    /** Unique memory identifier */
+    id: string;
+    /** Session this memory belongs to (null if cross-session) */
+    sessionId: string | null;
+    /** Memory content/key for retrieval */
+    key: string;
+    /** Memory value */
+    value: unknown;
+    /** Memory type for categorization */
+    type: "preference" | "fact" | "context" | "entity" | "custom";
+    /** Timestamp when memory was created */
+    createdAt: number;
+    /** Timestamp when memory was last accessed */
+    lastAccessedAt: number;
+    /** Access frequency for relevance scoring */
+    accessCount: number;
+    /** Optional embedding vector for semantic search */
+    embedding?: number[];
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Memory search query
+ */
+export interface MemorySearchQuery {
+    /** Search query text */
+    query?: string;
+    /** Memory types to search */
+    types?: Array<"preference" | "fact" | "context" | "entity" | "custom">;
+    /** Session filter (null = all sessions) */
+    sessionId?: string | null;
+    /** Maximum results */
+    limit?: number;
+    /** Minimum relevance score (0-1) */
+    minScore?: number;
+}
+/**
+ * Memory search result
+ */
+export interface MemorySearchResult {
+    memory: AriaMemory;
+    score: number;
+    relevance: string;
+}
+/**
+ * Configuration for ARIA Agent
+ */
+export interface AriaAgentConfig {
+    /** Maximum messages in session history */
+    historyLimit?: number;
+    /** Whether to enable cross-session memory */
+    enableMemory?: boolean;
+    /** Memory retention period (milliseconds) */
+    memoryRetentionMs?: number;
+    /** Whether to track flow transitions */
+    trackTransitions?: boolean;
+    /** Custom session ID generator */
+    generateSessionId?: () => string;
+}
+/**
+ * Agent environment bindings
+ */
+export type AriaEnv = Cloudflare.Env & {
+    /** AI model API key */
+    OPENAI_API_KEY?: string;
+    /** Optional: Anthropic API key */
+    ANTHROPIC_API_KEY?: string;
+};
+/**
+ * Re-export WorkingMemory from ARIA agents
+ */
+export type { WorkingMemory } from "@projectaria/aria-agents";
+//# 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,10 @@
+/**
+ * Core types for ARIA Cloudflare Agents integration
+ *
+ * Memory Primitives:
+ * - Session: Current conversation thread with chronological messages
+ * - State: Temporary data within the current conversation
+ * - Memory: Searchable, cross-session information
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@projectaria/cf-agents",
+  "version": "0.1.0",
+  "description": "ARIA Cloudflare Agents integration with proper memory primitives for meaningful multi-turn conversations",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "peerDependencies": {
+    "agents": "^0.3.3",
+    "@cloudflare/ai-chat": ">=0.0.3",
+    "ai": "^6.0.0"
+  },
+  "dependencies": {
+    "ai": "^6.0.0",
+    "nanoid": "^3.3.7"
+  },
+  "devDependencies": {
+    "@cloudflare/ai-chat": "^0.0.3",
+    "@cloudflare/workers-types": "^4.20260103.0",
+    "@projectaria/aria-agents": "workspace:*",
+    "@types/nanoid": "^3.0.0",
+    "agents": "^0.3.3",
+    "typescript": "^5.7.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/projectaria/aria"
+  },
+  "license": "MIT",
+  "keywords": [
+    "aria",
+    "cloudflare",
+    "agents",
+    "ai",
+    "conversational",
+    "memory",
+    "sessions",
+    "durable-objects",
+    "workers"
+  ]
+}