@reminix/runtime 0.5.0 → 0.6.1

package/dist/index.js

@@ -1,8 +1,34 @@
 /**
- * Reminix Runtime Types
- * @packageDocumentation
+ * Reminix Agent Runtime
+ *
+ * Build AI agents that integrate seamlessly with the Reminix API.
+ *
+ * @example
+ * ```typescript
+ * import { Agent, serve } from '@reminix/runtime';
+ *
+ * const agent = new Agent('my-agent');
+ *
+ * agent.onInvoke(async (input) => {
+ *   return { output: `Processed: ${input.message}` };
+ * });
+ *
+ * agent.onChat(async (messages) => {
+ *   const lastMessage = messages[messages.length - 1];
+ *   return {
+ *     message: { role: 'assistant', content: `Reply to: ${lastMessage.content}` }
+ *   };
+ * });
+ *
+ * serve(agent, { port: 8080 });
+ * ```
  */
-export { loadHandler, isFile } from './loader';
-export { discoverRegistry } from './registry';
-export { executeAgent, executeTool, executeHandler } from './executor';
+// Export schemas for runtime validation
+export { ToolCallFunctionSchema, ToolCallSchema, MessageRoleSchema, ChatMessageSchema, AssistantMessageSchema, InvokeRequestSchema, ChatRequestSchema, InvokeResponseSchema, ChatResponseSchema, StreamChunkSchema, } from './types';
+// Export Agent class, options, and errors
+export { Agent, NotImplementedError, AgentError } from './agent';
+// Export server
+export { serve, createApp } from './server';
+// Export streaming utilities
+export { formatSseEvent, formatSseDone, streamToSse } from './streaming';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAmCH,wCAAwC;AACxC,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,0CAA0C;AAC1C,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAqB,MAAM,SAAS,CAAC;AAEpF,gBAAgB;AAChB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAqB,MAAM,UAAU,CAAC;AAE/D,6BAA6B;AAC7B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Hono server for hosting AI agents.
+ */
+import { Hono } from 'hono';
+import { Agent } from './agent';
+/**
+ * Options for the serve function.
+ */
+export interface ServeOptions {
+    /** Host to bind to (default: '0.0.0.0') */
+    host?: string;
+    /** Port to listen on (default: 8080) */
+    port?: number;
+}
+/**
+ * Create a Hono app with agent routes.
+ *
+ * @param agents - List of agents to serve
+ * @returns Configured Hono app
+ */
+export declare function createApp(agents: Agent[]): Hono;
+/**
+ * Start a server hosting the provided agents.
+ *
+ * @param agents - A single agent or array of agents to serve
+ * @param options - Server options (host, port)
+ *
+ * @example
+ * ```typescript
+ * const agent = new Agent('my-agent');
+ * agent.onInvoke(async (input) => ({ output: 'hello' }));
+ *
+ * serve(agent, { port: 8080 });
+ * // or
+ * serve([agent1, agent2], { port: 8080 });
+ * ```
+ */
+export declare function serve(agents: Agent | Agent[], options?: ServeOptions): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EAAE,KAAK,EAAmC,MAAM,SAAS,CAAC;AAcjE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAyL/C;AA+BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI,CA8B/E"}

package/dist/server.js

@@ -0,0 +1,243 @@
+/**
+ * Hono server for hosting AI agents.
+ */
+import { Hono } from 'hono';
+import { streamSSE } from 'hono/streaming';
+import { serve as honoServe } from '@hono/node-server';
+import { AgentError, NotImplementedError } from './agent';
+import { streamToSse } from './streaming';
+import { ChatRequestSchema, InvokeRequestSchema, } from './types';
+import { VERSION } from './version';
+/**
+ * Create a Hono app with agent routes.
+ *
+ * @param agents - List of agents to serve
+ * @returns Configured Hono app
+ */
+export function createApp(agents) {
+    const app = new Hono();
+    // Build agent registry
+    const registry = new Map();
+    for (const agent of agents) {
+        if (registry.has(agent.name)) {
+            throw new Error(`Duplicate agent name: ${agent.name}`);
+        }
+        registry.set(agent.name, agent);
+    }
+    // Health check endpoint
+    app.get('/health', (c) => {
+        const response = {
+            status: 'healthy',
+            agents: Array.from(registry.keys()),
+        };
+        return c.json(response);
+    });
+    // Discovery endpoint for Reminix platform
+    app.get('/_discover', (c) => {
+        const response = {
+            runtime: {
+                version: VERSION,
+                language: 'typescript',
+                framework: 'hono',
+            },
+            agents: agents.map((agent) => agent.toInfo()),
+        };
+        return c.json(response);
+    });
+    // Per-agent health endpoint
+    app.get('/agent/:name/health', (c) => {
+        const name = c.req.param('name');
+        const agent = registry.get(name);
+        if (!agent) {
+            return c.json({ error: `Agent not found: ${name}` }, 404);
+        }
+        const response = {
+            name: agent.name,
+            invoke: agent.hasInvoke,
+            chat: agent.hasChat,
+        };
+        return c.json(response);
+    });
+    // Invoke endpoint
+    app.post('/agent/:name/invoke', async (c) => {
+        const name = c.req.param('name');
+        const agent = registry.get(name);
+        if (!agent) {
+            return c.json({ error: `Agent not found: ${name}` }, 404);
+        }
+        // Parse and validate request
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: 'Invalid JSON body' }, 400);
+        }
+        const parseResult = InvokeRequestSchema.safeParse(body);
+        if (!parseResult.success) {
+            const errors = parseResult.error.issues
+                .map((i) => `${i.path.join('.')}: ${i.message}`)
+                .join('; ');
+            return c.json({ error: `Invalid request: ${errors}` }, 400);
+        }
+        const { input, stream } = parseResult.data;
+        // Extract context from raw body (not in schema to keep it flexible)
+        const context = body.context;
+        try {
+            const result = await agent.handleInvoke(input, context);
+            // Check if streaming
+            if (isAsyncGenerator(result)) {
+                if (stream) {
+                    // Return SSE stream
+                    return streamSSE(c, async (sseStream) => {
+                        for await (const event of streamToSse(result)) {
+                            await sseStream.writeSSE({ data: event.replace(/^data: /, '').replace(/\n\n$/, '') });
+                        }
+                    });
+                }
+                else {
+                    // Collect chunks into single response
+                    const chunks = [];
+                    for await (const chunk of result) {
+                        chunks.push(chunk.chunk);
+                    }
+                    return c.json({ output: chunks.join('') });
+                }
+            }
+            return c.json(result);
+        }
+        catch (err) {
+            return handleError(c, err);
+        }
+    });
+    // Chat endpoint
+    app.post('/agent/:name/chat', async (c) => {
+        const name = c.req.param('name');
+        const agent = registry.get(name);
+        if (!agent) {
+            return c.json({ error: `Agent not found: ${name}` }, 404);
+        }
+        // Parse and validate request
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: 'Invalid JSON body' }, 400);
+        }
+        const parseResult = ChatRequestSchema.safeParse(body);
+        if (!parseResult.success) {
+            const errors = parseResult.error.issues
+                .map((i) => `${i.path.join('.')}: ${i.message}`)
+                .join('; ');
+            return c.json({ error: `Invalid request: ${errors}` }, 400);
+        }
+        const { messages, stream } = parseResult.data;
+        // Extract context from raw body (not in schema to keep it flexible)
+        const context = body.context;
+        // Validate messages array is not empty
+        if (messages.length === 0) {
+            return c.json({ error: 'Messages array cannot be empty' }, 400);
+        }
+        // Validate message roles
+        const validRoles = ['system', 'user', 'assistant', 'tool'];
+        for (const msg of messages) {
+            if (!validRoles.includes(msg.role)) {
+                return c.json({ error: `Invalid role: ${msg.role}` }, 400);
+            }
+        }
+        try {
+            const result = await agent.handleChat(messages, context);
+            // Check if streaming
+            if (isAsyncGenerator(result)) {
+                if (stream) {
+                    // Return SSE stream
+                    return streamSSE(c, async (sseStream) => {
+                        for await (const event of streamToSse(result)) {
+                            await sseStream.writeSSE({ data: event.replace(/^data: /, '').replace(/\n\n$/, '') });
+                        }
+                    });
+                }
+                else {
+                    // Collect chunks into single response
+                    const chunks = [];
+                    for await (const chunk of result) {
+                        chunks.push(chunk.chunk);
+                    }
+                    return c.json({
+                        message: { role: 'assistant', content: chunks.join('') },
+                    });
+                }
+            }
+            return c.json(result);
+        }
+        catch (err) {
+            return handleError(c, err);
+        }
+    });
+    return app;
+}
+/**
+ * Check if a value is an async generator.
+ */
+function isAsyncGenerator(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        Symbol.asyncIterator in value &&
+        typeof value.next === 'function');
+}
+/**
+ * Handle errors from agent handlers.
+ */
+function handleError(c, err) {
+    if (err instanceof NotImplementedError) {
+        return c.json({ error: err.message }, 501);
+    }
+    if (err instanceof AgentError) {
+        return c.json({ error: err.message }, 502);
+    }
+    const message = err instanceof Error ? err.message : 'Internal server error';
+    return c.json({ error: message }, 500);
+}
+/**
+ * Start a server hosting the provided agents.
+ *
+ * @param agents - A single agent or array of agents to serve
+ * @param options - Server options (host, port)
+ *
+ * @example
+ * ```typescript
+ * const agent = new Agent('my-agent');
+ * agent.onInvoke(async (input) => ({ output: 'hello' }));
+ *
+ * serve(agent, { port: 8080 });
+ * // or
+ * serve([agent1, agent2], { port: 8080 });
+ * ```
+ */
+export function serve(agents, options = {}) {
+    const { host = '0.0.0.0', port = 8080 } = options;
+    // Normalize to array
+    const agentList = Array.isArray(agents) ? agents : [agents];
+    if (agentList.length === 0) {
+        throw new Error('At least one agent must be provided');
+    }
+    // Check for duplicate names
+    const names = new Set();
+    for (const agent of agentList) {
+        if (names.has(agent.name)) {
+            throw new Error(`Duplicate agent name: ${agent.name}`);
+        }
+        names.add(agent.name);
+    }
+    const app = createApp(agentList);
+    console.log(`Starting Reminix Agent Runtime...`);
+    console.log(`Agents: ${agentList.map((a) => a.name).join(', ')}`);
+    console.log(`Listening on http://${host}:${port}`);
+    honoServe({
+        fetch: app.fetch,
+        hostname: host,
+        port,
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/streaming.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Streaming utilities for Server-Sent Events (SSE).
+ */
+import type { StreamChunk } from './types';
+/**
+ * Format data as an SSE event.
+ */
+export declare function formatSseEvent(data: Record<string, unknown>): string;
+/**
+ * Format the SSE done marker.
+ */
+export declare function formatSseDone(): string;
+/**
+ * Validate a streaming chunk.
+ *
+ * @param chunk - The chunk to validate
+ * @returns An error message if invalid, null if valid
+ */
+export declare function validateChunk(chunk: unknown): string | null;
+/**
+ * Convert an async generator to an SSE stream.
+ *
+ * @param generator - The async generator yielding StreamChunk objects
+ * @returns An async generator yielding SSE-formatted strings
+ */
+export declare function streamToSse(generator: AsyncGenerator<StreamChunk, void, unknown>): AsyncGenerator<string, void, unknown>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAc3D;AAED;;;;;GAKG;AACH,wBAAuB,WAAW,CAChC,SAAS,EAAE,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,GACpD,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAiBvC"}

package/dist/streaming.js

@@ -0,0 +1,58 @@
+/**
+ * Streaming utilities for Server-Sent Events (SSE).
+ */
+/**
+ * Format data as an SSE event.
+ */
+export function formatSseEvent(data) {
+    return `data: ${JSON.stringify(data)}\n\n`;
+}
+/**
+ * Format the SSE done marker.
+ */
+export function formatSseDone() {
+    return 'data: [DONE]\n\n';
+}
+/**
+ * Validate a streaming chunk.
+ *
+ * @param chunk - The chunk to validate
+ * @returns An error message if invalid, null if valid
+ */
+export function validateChunk(chunk) {
+    if (typeof chunk !== 'object' || chunk === null) {
+        return 'Chunk must be an object';
+    }
+    if (!('chunk' in chunk)) {
+        return 'Chunk missing required "chunk" field';
+    }
+    if (typeof chunk.chunk !== 'string') {
+        return 'Chunk "chunk" field must be a string';
+    }
+    return null;
+}
+/**
+ * Convert an async generator to an SSE stream.
+ *
+ * @param generator - The async generator yielding StreamChunk objects
+ * @returns An async generator yielding SSE-formatted strings
+ */
+export async function* streamToSse(generator) {
+    try {
+        for await (const chunk of generator) {
+            const error = validateChunk(chunk);
+            if (error) {
+                yield formatSseEvent({ error });
+                yield formatSseDone();
+                return;
+            }
+            yield formatSseEvent(chunk);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        yield formatSseEvent({ error: `Stream error: ${message}` });
+    }
+    yield formatSseDone();
+}
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAA6B;IAC1D,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,sCAAsC,CAAC;IAChD,CAAC;IAED,IAAI,OAAQ,KAAqB,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrD,OAAO,sCAAsC,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAChC,SAAqD;IAErD,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;gBAChC,MAAM,aAAa,EAAE,CAAC;gBACtB,OAAO;YACT,CAAC;YACD,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,MAAM,cAAc,CAAC,EAAE,KAAK,EAAE,iBAAiB,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,aAAa,EAAE,CAAC;AACxB,CAAC"}