@reminix/runtime 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Reminix
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+# @reminix/runtime
+
+Reminix runtime for building handlers that run on Reminix.
+
+## Installation
+
+```bash
+npm install @reminix/runtime
+# or
+pnpm add @reminix/runtime
+# or
+yarn add @reminix/runtime
+```
+
+## Usage
+
+```typescript
+import type { AgentHandler, Context, Request, Response } from '@reminix/runtime';
+
+const myAgent: AgentHandler = async (context: Context, request: Request): Promise<Response> => {
+  // Your handler logic here
+  return {
+    messages: [
+      {
+        role: 'assistant',
+        content: 'Hello from my handler!',
+      },
+    ],
+  };
+};
+```
+
+## Components
+
+### Types
+
+- `Message` - Conversation message
+- `ToolCall` - Tool call made by an agent
+- `Context` - Persistent resources provided to handlers
+- `Request` - Current invocation request
+- `Response` - Handler response
+- `MemoryStore` - Memory store interface
+- `KnowledgeBase` - Knowledge base interface
+- `ToolRegistry` - Tool registry interface
+- `AgentHandler` - Agent handler function type
+- `ToolHandler` - Tool handler function type
+
+### Utilities
+
+- `load_handler(handlerPath)` - Load a handler from a file
+- `discover_registry(handlerPath)` - Auto-discover handlers from a directory structure
+- `execute_handler(handler, context, request)` - Execute a handler with context and request
+
+## License
+
+MIT

package/dist/executor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Core handler execution logic
+ */
+import type { AgentHandler, ToolHandler, Context, Request, Response } from './types';
+/**
+ * Execute an agent handler
+ */
+export declare function executeAgent(handler: AgentHandler, context: Context, request: Request): Promise<Response>;
+/**
+ * Execute a tool handler
+ */
+export declare function executeTool(handler: ToolHandler, context: Context, request: Request): Promise<Response>;
+/**
+ * Execute a handler (agent or tool)
+ */
+export declare function executeHandler(handler: AgentHandler | ToolHandler, context: Context, request: Request): Promise<Response>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAErF;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,GAAG,WAAW,EACnC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAEnB"}

package/dist/executor.js

@@ -0,0 +1,22 @@
+/**
+ * Core handler execution logic
+ */
+/**
+ * Execute an agent handler
+ */
+export async function executeAgent(handler, context, request) {
+    return await handler(context, request);
+}
+/**
+ * Execute a tool handler
+ */
+export async function executeTool(handler, context, request) {
+    return await handler(context, request);
+}
+/**
+ * Execute a handler (agent or tool)
+ */
+export async function executeHandler(handler, context, request) {
+    return await handler(context, request);
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAqB,EACrB,OAAgB,EAChB,OAAgB;IAEhB,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAoB,EACpB,OAAgB,EAChB,OAAgB;IAEhB,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAmC,EACnC,OAAgB,EAChB,OAAgB;IAEhB,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Reminix Runtime Types
+ * @packageDocumentation
+ */
+export type { Message, ToolCall, Context, Request, Response, MemoryStore, KnowledgeBase, ToolRegistry, ToolHandler, AgentHandler, } from './types';
+export { loadHandler, isFile, type LoadedHandler } from './loader';
+export { discoverRegistry, type Registry } from './registry';
+export { executeAgent, executeTool, executeHandler } from './executor';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,OAAO,EACP,QAAQ,EACR,OAAO,EACP,OAAO,EACP,QAAQ,EACR,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * Reminix Runtime Types
+ * @packageDocumentation
+ */
+export { loadHandler, isFile } from './loader';
+export { discoverRegistry } from './registry';
+export { executeAgent, executeTool, executeHandler } from './executor';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAsB,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAiB,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Load handler from file
+ */
+import type { AgentHandler, ToolHandler } from './types';
+export interface LoadedHandler {
+    agents?: Record<string, AgentHandler>;
+    tools?: Record<string, ToolHandler>;
+    prompts?: Record<string, unknown>;
+}
+/**
+ * Load handler from a file path
+ * Supports both TypeScript (.ts) and JavaScript (.js) files
+ */
+export declare function loadHandler(handlerPath: string): Promise<LoadedHandler>;
+/**
+ * Check if a path is a file (not a directory)
+ */
+export declare function isFile(path: string): boolean;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAqC7E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO5C"}

package/dist/loader.js

@@ -0,0 +1,52 @@
+/**
+ * Load handler from file
+ */
+import { pathToFileURL } from 'url';
+import { statSync } from 'fs';
+/**
+ * Load handler from a file path
+ * Supports both TypeScript (.ts) and JavaScript (.js) files
+ */
+export async function loadHandler(handlerPath) {
+    try {
+        // Convert file path to file URL for ES modules
+        const fileUrl = pathToFileURL(handlerPath).href;
+        // Dynamic import of the handler module
+        const module = await import(fileUrl);
+        // Extract agents, tools, and prompts
+        const loaded = {};
+        if (module.agents) {
+            loaded.agents = module.agents;
+        }
+        if (module.tools) {
+            loaded.tools = module.tools;
+        }
+        if (module.prompts) {
+            loaded.prompts = module.prompts;
+        }
+        // Validate that at least one export exists
+        if (!loaded.agents && !loaded.tools && !loaded.prompts) {
+            throw new Error(`Handler file "${handlerPath}" must export at least one of: agents, tools, or prompts`);
+        }
+        return loaded;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to load handler from "${handlerPath}": ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Check if a path is a file (not a directory)
+ */
+export function isFile(path) {
+    try {
+        const stats = statSync(path);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAS9B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB;IACnD,IAAI,CAAC;QACH,+CAA+C;QAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;QAEhD,uCAAuC;QACvC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QAErC,qCAAqC;QACrC,MAAM,MAAM,GAAkB,EAAE,CAAC;QAEjC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAChC,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC9B,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAClC,CAAC;QAED,2CAA2C;QAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CACb,iBAAiB,WAAW,0DAA0D,CACvF,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,gCAAgC,WAAW,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Registry for auto-discovering agents, tools, and prompts from directories
+ */
+import type { AgentHandler, ToolHandler } from './types';
+export interface Registry {
+    agents: Record<string, AgentHandler>;
+    tools: Record<string, ToolHandler>;
+    prompts: Record<string, unknown>;
+}
+/**
+ * Auto-discover and load handlers from a directory structure
+ *
+ * Expected structure:
+ *   handler/
+ *     agents/
+ *       chatbot.ts
+ *       assistant.ts
+ *     tools/
+ *       search.ts
+ *     prompts/
+ *       system.ts
+ */
+export declare function discoverRegistry(handlerPath: string): Promise<Registry>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEzD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4E7E"}

package/dist/registry.js

@@ -0,0 +1,208 @@
+/**
+ * Registry for auto-discovering agents, tools, and prompts from directories
+ */
+import { readdir, stat } from 'fs/promises';
+import { join, extname, basename } from 'path';
+import { pathToFileURL } from 'url';
+import { loadHandler } from './loader';
+/**
+ * Auto-discover and load handlers from a directory structure
+ *
+ * Expected structure:
+ *   handler/
+ *     agents/
+ *       chatbot.ts
+ *       assistant.ts
+ *     tools/
+ *       search.ts
+ *     prompts/
+ *       system.ts
+ */
+export async function discoverRegistry(handlerPath) {
+    const registry = {
+        agents: {},
+        tools: {},
+        prompts: {},
+    };
+    try {
+        // Check if path exists and is a directory
+        const stats = await stat(handlerPath);
+        if (!stats.isDirectory()) {
+            throw new Error(`Handler path must be a directory: ${handlerPath}`);
+        }
+        // Discover agents
+        const agentsPath = join(handlerPath, 'agents');
+        try {
+            const agentsStats = await stat(agentsPath);
+            if (agentsStats.isDirectory()) {
+                const agents = await loadDirectory(agentsPath);
+                // Filter to only AgentHandler types
+                for (const [key, value] of Object.entries(agents)) {
+                    if (typeof value === 'function') {
+                        registry.agents[key] = value;
+                    }
+                }
+            }
+        }
+        catch {
+            // agents/ directory doesn't exist, skip
+        }
+        // Discover tools
+        const toolsPath = join(handlerPath, 'tools');
+        try {
+            const toolsStats = await stat(toolsPath);
+            if (toolsStats.isDirectory()) {
+                const tools = await loadDirectory(toolsPath);
+                // Filter to only ToolHandler types
+                for (const [key, value] of Object.entries(tools)) {
+                    if (typeof value === 'function') {
+                        registry.tools[key] = value;
+                    }
+                }
+            }
+        }
+        catch {
+            // tools/ directory doesn't exist, skip
+        }
+        // Discover prompts
+        const promptsPath = join(handlerPath, 'prompts');
+        try {
+            const promptsStats = await stat(promptsPath);
+            if (promptsStats.isDirectory()) {
+                const prompts = await loadDirectory(promptsPath);
+                registry.prompts = prompts;
+            }
+        }
+        catch {
+            // prompts/ directory doesn't exist, skip
+        }
+        // Validate that at least something was discovered
+        if (Object.keys(registry.agents).length === 0 &&
+            Object.keys(registry.tools).length === 0 &&
+            Object.keys(registry.prompts).length === 0) {
+            throw new Error(`No agents, tools, or prompts found in directory: ${handlerPath}`);
+        }
+        return registry;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to discover registry from "${handlerPath}": ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Load all handler files from a directory
+ * Filename (without extension) becomes the key in the registry
+ */
+async function loadDirectory(dirPath) {
+    const handlers = {};
+    try {
+        const entries = await readdir(dirPath);
+        for (const entry of entries) {
+            const fullPath = join(dirPath, entry);
+            const stats = await stat(fullPath);
+            // Skip if not a file
+            if (!stats.isFile()) {
+                continue;
+            }
+            // Only process TypeScript/JavaScript files
+            const ext = extname(entry);
+            if (ext !== '.ts' && ext !== '.js' && ext !== '.mjs') {
+                continue;
+            }
+            // Extract the key from filename (without extension)
+            const key = entry.replace(ext, '');
+            try {
+                // Try loading as a handler file (expects agents/tools/prompts exports)
+                const loaded = await loadHandler(fullPath);
+                // Merge agents, tools, and prompts into the registry
+                if (loaded.agents) {
+                    const agentKeys = Object.keys(loaded.agents);
+                    if (agentKeys.length === 1) {
+                        handlers[key] = loaded.agents[agentKeys[0]];
+                    }
+                    else {
+                        for (const agentKey of agentKeys) {
+                            handlers[`${key}.${agentKey}`] = loaded.agents[agentKey];
+                        }
+                    }
+                }
+                if (loaded.tools) {
+                    const toolKeys = Object.keys(loaded.tools);
+                    if (toolKeys.length === 1) {
+                        handlers[key] = loaded.tools[toolKeys[0]];
+                    }
+                    else {
+                        for (const toolKey of toolKeys) {
+                            handlers[`${key}.${toolKey}`] = loaded.tools[toolKey];
+                        }
+                    }
+                }
+                if (loaded.prompts) {
+                    const promptKeys = Object.keys(loaded.prompts);
+                    if (promptKeys.length === 1) {
+                        handlers[key] = loaded.prompts[promptKeys[0]];
+                    }
+                    else {
+                        for (const promptKey of promptKeys) {
+                            handlers[`${key}.${promptKey}`] = loaded.prompts[promptKey];
+                        }
+                    }
+                }
+            }
+            catch {
+                // If loadHandler fails, try loading as direct export
+                // This handles files that export functions directly (e.g., export const chatbot)
+                try {
+                    const fileUrl = pathToFileURL(fullPath).href;
+                    const module = await import(fileUrl);
+                    // Determine type based on directory name
+                    const dirName = basename(dirPath);
+                    // Check for direct exports matching the directory type
+                    if (dirName === 'agents') {
+                        // Look for exported function with same name as file, or any exported function
+                        const exportedFunction = module[key] || module.default;
+                        if (typeof exportedFunction === 'function') {
+                            handlers[key] = exportedFunction;
+                        }
+                    }
+                    else if (dirName === 'tools') {
+                        const exportedFunction = module[key] || module.default;
+                        if (typeof exportedFunction === 'function') {
+                            handlers[key] = exportedFunction;
+                        }
+                    }
+                    else if (dirName === 'prompts') {
+                        // For prompts, accept any export (function, object, string, etc.)
+                        // Try to get export with same name as file, or default, or any named export
+                        const exportedValue = module[key] || module.default;
+                        if (exportedValue !== undefined) {
+                            handlers[key] = exportedValue;
+                        }
+                        else {
+                            // Check if module has any exports (excluding default module properties)
+                            const moduleKeys = Object.keys(module).filter((k) => k !== 'default' && !k.startsWith('__'));
+                            if (moduleKeys.length > 0) {
+                                // Use the first export, or the module itself if it's a simple object
+                                handlers[key] = module[moduleKeys[0]] || module;
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // Skip this file if both methods fail
+                    continue;
+                }
+            }
+        }
+        return handlers;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to load directory "${dirPath}": ${error.message}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Handler types for Reminix agents and tools
+ */
+/**
+ * Message in a conversation
+ */
+export interface Message {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool call made by an agent
+ */
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * Context provides persistent resources to handlers
+ */
+export interface Context {
+    /** Chat/thread identifier */
+    chatId: string;
+    /** Thread identifier (optional) */
+    threadId?: string;
+    /** Memory store for persistent memory */
+    memory: MemoryStore;
+    /** Knowledge base for RAG/retrieval */
+    knowledgeBase: KnowledgeBase;
+    /** Available tools registry */
+    tools?: ToolRegistry;
+    /** User identifier */
+    userId?: string;
+    /** Session identifier */
+    sessionId?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Extensible for future additions */
+    [key: string]: unknown;
+}
+/**
+ * Request represents the current invocation
+ */
+export interface Request {
+    /** Conversation messages */
+    messages: Message[];
+    /** Additional metadata for this request */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Response from a handler
+ */
+export interface Response {
+    /** Response messages */
+    messages: Message[];
+    /** Optional metadata (tokens, model, latency, etc.) */
+    metadata?: {
+        tokensUsed?: number;
+        model?: string;
+        latency?: number;
+        [key: string]: unknown;
+    };
+    /** Tool calls made by the agent */
+    toolCalls?: ToolCall[];
+    /** State updates */
+    stateUpdates?: Record<string, unknown>;
+    /** Extensible for future additions */
+    [key: string]: unknown;
+}
+/**
+ * Memory store interface
+ */
+export interface MemoryStore {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+/**
+ * Knowledge base interface
+ */
+export interface KnowledgeBase {
+    search(query: string, options?: Record<string, unknown>): Promise<unknown[]>;
+    add(content: string, metadata?: Record<string, unknown>): Promise<void>;
+    delete(id: string): Promise<void>;
+}
+/**
+ * Tool registry interface
+ */
+export interface ToolRegistry {
+    get(name: string): ToolHandler | undefined;
+    list(): string[];
+}
+/**
+ * Tool handler function signature
+ */
+export type ToolHandler = (context: Context, request: Request) => Promise<Response>;
+/**
+ * Agent handler function signature
+ */
+export type AgentHandler = (context: Context, request: Request) => Promise<Response>;
+//# 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,5 @@
+/**
+ * Handler types for Reminix agents and tools
+ */
+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;;GAEG"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@reminix/runtime",
+  "version": "0.3.0",
+  "type": "module",
+  "description": "Reminix runtime for building handlers",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "reminix",
+    "runtime",
+    "types",
+    "handler",
+    "typescript"
+  ],
+  "author": "Reminix <support@reminix.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/reminix-ai/reminix-typescript.git",
+    "directory": "packages/runtime"
+  },
+  "homepage": "https://github.com/reminix-ai/reminix-typescript",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "vitest": "^4.0.16",
+    "tsd": "^0.33.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "preversion": "pnpm test && pnpm lint"
+  }
+}