@reminix/runtime 0.0.13 → 0.0.15

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export { serve, createApp } from './server.js';
 export type { ServeOptions, CreateAppOptions, FullServeOptions } from './server.js';
 export { VERSION } from './version.js';
-export type { Role, ExecuteRequest, ExecuteResponse, Message, ToolSchema, ToolExecuteRequest, ToolExecuteResponse, } from './types.js';
+export type { Role, Message, InvokeRequest, InvokeResponse, AgentInvokeRequest, AgentInvokeResponse, ToolCallRequest, ToolCallResponse, JSONSchema, Capabilities, RuntimeError, RuntimeErrorResponse, } from './types.js';
 export { AgentBase, Agent, agent, chatAgent } from './agent.js';
-export type { AgentMetadata, ExecuteHandler, ExecuteStreamHandler, FetchHandler, AgentOptions, ChatAgentOptions, } from './agent.js';
+export type { AgentMetadata, InvokeHandler, InvokeStreamHandler, FetchHandler, AgentOptions, ChatAgentOptions, } from './agent.js';
 export { AgentAdapter } from './agent-adapter.js';
 export { ToolBase, Tool, tool } from './tool.js';
-export type { ToolMetadata, ToolOptions, ExecuteHandler as ToolExecuteHandler } from './tool.js';
+export type { ToolMetadata, ToolOptions, ToolHandler } from './tool.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,IAAI,EACJ,cAAc,EACd,eAAe,EACf,OAAO,EAEP,UAAU,EACV,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,IAAI,EACJ,OAAO,EACP,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAWvC,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAShE,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAevC,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAShE,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAI1C,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CA+GzD;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY,EAAE,gBAAgB;CAAG;AAE3E;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAgB1D"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAkC1C,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAkJzD;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY,EAAE,gBAAgB;CAAG;AAE3E;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAgB1D"}

package/dist/server.js

@@ -5,6 +5,27 @@ import { Hono } from 'hono';
 import { streamSSE } from 'hono/streaming';
 import { serve as honoServe } from '@hono/node-server';
 import { VERSION } from './version.js';
+/**
+ * Enable debug mode via environment variable to include stack traces in error responses
+ */
+const REMINIX_CLOUD = ['true', '1', 'yes'].includes((process.env.REMINIX_CLOUD || '').toLowerCase());
+/**
+ * Create a structured error response
+ */
+function createErrorResponse(error, errorType = 'ExecutionError') {
+    const message = error instanceof Error ? error.message : String(error);
+    const response = {
+        error: {
+            type: errorType,
+            message,
+        },
+    };
+    // Include stack trace in debug mode
+    if (REMINIX_CLOUD && error instanceof Error && error.stack) {
+        response.error.stack = error.stack;
+    }
+    return response;
+}
 /**
  * Create a Hono application with agent and tool endpoints.
  *
@@ -44,7 +65,6 @@ export function createApp(options) {
             agents: agents.map((agent) => ({
                 name: agent.name,
                 ...agent.metadata,
-                streaming: agent.streaming,
             })),
             tools: tools.map((tool) => ({
                 name: tool.name,
@@ -57,21 +77,11 @@ export function createApp(options) {
         const agentName = c.req.param('agentName');
         const agent = agentMap.get(agentName);
         if (!agent) {
-            return c.json({ error: `Agent '${agentName}' not found` }, 404);
+            return c.json(createErrorResponse(new Error(`Agent '${agentName}' not found`), 'NotFoundError'), 404);
         }
         const body = await c.req.json();
-        // Get requestKeys from agent metadata (all agents have defaults)
-        const requestKeys = agent.metadata.requestKeys ?? [];
-        // Extract declared keys from body into input object
-        // e.g., requestKeys: ['prompt'] with body { prompt: '...' } -> input = { prompt: '...' }
-        const input = {};
-        for (const key of requestKeys) {
-            if (key in body) {
-                input[key] = body[key];
-            }
-        }
         const request = {
-            input,
+            input: body.input ?? {},
             stream: body.stream === true,
             context: body.context,
         };
@@ -79,30 +89,67 @@ export function createApp(options) {
         if (request.stream) {
             return streamSSE(c, async (stream) => {
                 try {
-                    for await (const chunk of agent.executeStream(request)) {
-                        await stream.writeSSE({ data: chunk });
+                    for await (const chunk of agent.invokeStream(request)) {
+                        await stream.writeSSE({ data: JSON.stringify({ delta: chunk }) });
                     }
-                    await stream.writeSSE({ data: '[DONE]' });
+                    await stream.writeSSE({ data: JSON.stringify({ done: true }) });
                 }
                 catch (error) {
-                    const message = error instanceof Error ? error.message : 'Unknown error';
-                    await stream.writeSSE({ data: JSON.stringify({ error: message }) });
+                    const errorResponse = createErrorResponse(error, error instanceof Error ? error.constructor.name : 'ExecutionError');
+                    await stream.writeSSE({ data: JSON.stringify(errorResponse) });
                 }
             });
         }
-        const response = await agent.execute(request);
-        return c.json(response);
+        // Non-streaming: catch errors and return structured response
+        try {
+            const response = await agent.invoke(request);
+            return c.json(response);
+        }
+        catch (error) {
+            // Determine error type and status code
+            let statusCode = 500;
+            let errorType = error instanceof Error ? error.constructor.name : 'ExecutionError';
+            if (error instanceof Error) {
+                if (error.message.includes('not implemented') || error.name === 'NotImplementedError') {
+                    statusCode = 501;
+                    errorType = 'NotImplementedError';
+                }
+                else if (error.name === 'ValidationError' || error.message.includes('validation')) {
+                    statusCode = 400;
+                    errorType = 'ValidationError';
+                }
+            }
+            return c.json(createErrorResponse(error, errorType), statusCode);
+        }
     });
     // Tool call endpoint
     app.post('/tools/:toolName/call', async (c) => {
         const toolName = c.req.param('toolName');
         const tool = toolMap.get(toolName);
         if (!tool) {
-            return c.json({ error: `Tool '${toolName}' not found` }, 404);
+            return c.json(createErrorResponse(new Error(`Tool '${toolName}' not found`), 'NotFoundError'), 404);
         }
         const body = await c.req.json();
-        const response = await tool.execute(body);
-        return c.json(response);
+        const request = {
+            input: body.input ?? {},
+            context: body.context,
+        };
+        try {
+            const result = await tool.call(request);
+            return c.json(result);
+        }
+        catch (error) {
+            // Determine error type and status code
+            let statusCode = 500;
+            let errorType = error instanceof Error ? error.constructor.name : 'ExecutionError';
+            if (error instanceof Error) {
+                if (error.name === 'ValidationError' || error.message.includes('validation')) {
+                    statusCode = 400;
+                    errorType = 'ValidationError';
+                }
+            }
+            return c.json(createErrorResponse(error, errorType), statusCode);
+        }
     });
     return app;
 }

package/dist/server.js.map

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

package/dist/tool.d.ts

@@ -1,16 +1,16 @@
 /**
  * Reminix Runtime Tool definitions
  */
-import type { ToolSchema, ToolExecuteRequest, ToolExecuteResponse } from './types.js';
+import type { ToolCallRequest, ToolCallResponse, JSONSchema, Capabilities } from './types.js';
 /** Metadata for a tool */
 export interface ToolMetadata {
-    type: 'tool';
     description: string;
-    parameters: ToolSchema;
-    output?: ToolSchema;
+    capabilities?: Capabilities;
+    input: JSONSchema;
+    output?: JSONSchema;
 }
-/** Execute handler function type */
-export type ExecuteHandler = (input: Record<string, unknown>, context?: Record<string, unknown>) => Promise<unknown> | unknown;
+/** Handler function type */
+export type ToolHandler = (input: Record<string, unknown>, context?: Record<string, unknown>) => Promise<unknown> | unknown;
 /**
  * Abstract base class for all tools.
  */
@@ -19,25 +19,25 @@ export declare abstract class ToolBase {
     abstract get name(): string;
     /** Human-readable description */
     abstract get description(): string;
-    /** JSON Schema for input parameters */
-    abstract get parameters(): ToolSchema;
+    /** JSON Schema for input */
+    abstract get input(): JSONSchema;
     /** Optional JSON Schema for output */
-    get output(): ToolSchema | undefined;
+    get output(): JSONSchema | undefined;
     /** Metadata for runtime discovery */
     get metadata(): ToolMetadata;
-    /** Execute the tool with the given input */
-    abstract execute(request: ToolExecuteRequest): Promise<ToolExecuteResponse>;
+    /** Call the tool with the given request */
+    abstract call(request: ToolCallRequest): Promise<ToolCallResponse>;
 }
 /** Options for creating a tool */
 export interface ToolOptions {
     /** Human-readable description of what the tool does */
     description: string;
-    /** JSON Schema for input parameters */
-    parameters: ToolSchema;
-    /** Optional JSON Schema for output (for documentation and type inference) */
-    output?: ToolSchema;
+    /** JSON Schema for input */
+    input: JSONSchema;
+    /** Optional JSON Schema for output (defaults to string) */
+    output?: JSONSchema;
     /** Handler function to execute when the tool is called */
-    handler: ExecuteHandler;
+    handler: ToolHandler;
 }
 /**
  * A tool created using the tool() factory function.
@@ -45,15 +45,21 @@ export interface ToolOptions {
 export declare class Tool extends ToolBase {
     private _name;
     private _description;
-    private _parameters;
+    private _input;
     private _output?;
-    private _executeHandler;
+    private _handler;
     constructor(name: string, options: ToolOptions);
     get name(): string;
     get description(): string;
-    get parameters(): ToolSchema;
-    get output(): ToolSchema | undefined;
-    execute(request: ToolExecuteRequest): Promise<ToolExecuteResponse>;
+    get input(): JSONSchema;
+    get output(): JSONSchema | undefined;
+    /**
+     * Call the tool by invoking the handler function.
+     *
+     * Exceptions are not caught here - they propagate to the server
+     * which returns appropriate HTTP error codes.
+     */
+    call(request: ToolCallRequest): Promise<ToolCallResponse>;
 }
 /**
  * Factory function to create a tool.
@@ -64,7 +70,7 @@ export declare class Tool extends ToolBase {
  *
  * const getWeather = tool('get_weather', {
  *   description: 'Get current weather for a location',
- *   parameters: {
+ *   input: {
  *     type: 'object',
  *     properties: {
  *       location: { type: 'string', description: 'City name' },

package/dist/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtF,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,oCAAoC;AACpC,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEhC;;GAEG;AACH,8BAAsB,QAAQ;IAC5B,6BAA6B;IAC7B,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IAE5B,iCAAiC;IACjC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC;IAEnC,uCAAuC;IACvC,QAAQ,KAAK,UAAU,IAAI,UAAU,CAAC;IAEtC,sCAAsC;IACtC,IAAI,MAAM,IAAI,UAAU,GAAG,SAAS,CAEnC;IAED,qCAAqC;IACrC,IAAI,QAAQ,IAAI,YAAY,CAU3B;IAED,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAC5E;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,UAAU,EAAE,UAAU,CAAC;IACvB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,IAAK,SAAQ,QAAQ;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,eAAe,CAAiB;gBAE5B,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IAS9C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,IAAI,MAAM,IAAI,UAAU,GAAG,SAAS,CAEnC;IAEK,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CASzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAE7D"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAU9F,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEhC;;GAEG;AACH,8BAAsB,QAAQ;IAC5B,6BAA6B;IAC7B,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IAE5B,iCAAiC;IACjC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC;IAEnC,4BAA4B;IAC5B,QAAQ,KAAK,KAAK,IAAI,UAAU,CAAC;IAEjC,sCAAsC;IACtC,IAAI,MAAM,IAAI,UAAU,GAAG,SAAS,CAEnC;IAED,qCAAqC;IACrC,IAAI,QAAQ,IAAI,YAAY,CAS3B;IAED,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CACnE;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,IAAK,SAAQ,QAAQ;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAc;gBAElB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IAS9C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,KAAK,IAAI,UAAU,CAEtB;IAED,IAAI,MAAM,IAAI,UAAU,GAAG,SAAS,CAEnC;IAED;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAIhE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAE7D"}

package/dist/tool.js

@@ -1,6 +1,13 @@
 /**
  * Reminix Runtime Tool definitions
  */
+/**
+ * Default output schema for tools.
+ * Response: { output: '...' }
+ */
+const DEFAULT_TOOL_OUTPUT = {
+    type: 'string',
+};
 /**
  * Abstract base class for all tools.
  */
@@ -12,9 +19,8 @@ export class ToolBase {
     /** Metadata for runtime discovery */
     get metadata() {
         const meta = {
-            type: 'tool',
             description: this.description,
-            parameters: this.parameters,
+            input: this.input,
         };
         if (this.output) {
             meta.output = this.output;
@@ -28,16 +34,16 @@ export class ToolBase {
 export class Tool extends ToolBase {
     _name;
     _description;
-    _parameters;
+    _input;
     _output;
-    _executeHandler;
+    _handler;
     constructor(name, options) {
         super();
         this._name = name;
         this._description = options.description;
-        this._parameters = options.parameters;
+        this._input = options.input;
         this._output = options.output;
-        this._executeHandler = options.handler;
+        this._handler = options.handler;
     }
     get name() {
         return this._name;
@@ -45,21 +51,21 @@ export class Tool extends ToolBase {
     get description() {
         return this._description;
     }
-    get parameters() {
-        return this._parameters;
+    get input() {
+        return this._input;
     }
     get output() {
-        return this._output;
+        return this._output ?? DEFAULT_TOOL_OUTPUT;
     }
-    async execute(request) {
-        try {
-            const result = await this._executeHandler(request.input, request.context);
-            return { output: result };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : 'Unknown error';
-            return { output: null, error: message };
-        }
+    /**
+     * Call the tool by invoking the handler function.
+     *
+     * Exceptions are not caught here - they propagate to the server
+     * which returns appropriate HTTP error codes.
+     */
+    async call(request) {
+        const result = await this._handler(request.input, request.context);
+        return { output: result };
     }
 }
 /**
@@ -71,7 +77,7 @@ export class Tool extends ToolBase {
  *
  * const getWeather = tool('get_weather', {
  *   description: 'Get current weather for a location',
- *   parameters: {
+ *   input: {
  *     type: 'object',
  *     properties: {
  *       location: { type: 'string', description: 'City name' },

package/dist/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH;;GAEG;AACH,MAAM,OAAgB,QAAQ;IAU5B,sCAAsC;IACtC,IAAI,MAAM;QACR,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,qCAAqC;IACrC,IAAI,QAAQ;QACV,MAAM,IAAI,GAAiB;YACzB,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CAIF;AAcD;;GAEG;AACH,MAAM,OAAO,IAAK,SAAQ,QAAQ;IACxB,KAAK,CAAS;IACd,YAAY,CAAS;IACrB,WAAW,CAAa;IACxB,OAAO,CAAc;IACrB,eAAe,CAAiB;IAExC,YAAY,IAAY,EAAE,OAAoB;QAC5C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IACzC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAA2B;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACzE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC1C,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,OAAoB;IACrD,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,mBAAmB,GAAe;IACtC,IAAI,EAAE,QAAQ;CACf,CAAC;AAgBF;;GAEG;AACH,MAAM,OAAgB,QAAQ;IAU5B,sCAAsC;IACtC,IAAI,MAAM;QACR,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,qCAAqC;IACrC,IAAI,QAAQ;QACV,MAAM,IAAI,GAAiB;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CAIF;AAcD;;GAEG;AACH,MAAM,OAAO,IAAK,SAAQ,QAAQ;IACxB,KAAK,CAAS;IACd,YAAY,CAAS;IACrB,MAAM,CAAa;IACnB,OAAO,CAAc;IACrB,QAAQ,CAAc;IAE9B,YAAY,IAAY,EAAE,OAAoB;QAC5C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAClC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,IAAI,mBAAmB,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,OAAwB;QACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,OAAoB;IACrD,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/types.d.ts

@@ -18,29 +18,53 @@ export interface Message {
     tool_call_id?: string;
     name?: string;
 }
-export interface ExecuteRequest {
+/** Base request type for invoke/call operations */
+export interface InvokeRequest {
     input: Record<string, unknown>;
     stream?: boolean;
     context?: Record<string, unknown>;
 }
-/**
- * Response from agent execute.
- * The shape depends on the agent's responseKeys.
- * - Regular agents: { output: unknown }
- * - Chat agents: { messages: Message[] }
- */
-export type ExecuteResponse = Record<string, unknown>;
-export interface ToolSchema {
-    type: 'object';
-    properties: Record<string, unknown>;
+/** Request type for agent invoke operations */
+export type AgentInvokeRequest = InvokeRequest;
+/** Request type for tool call operations */
+export type ToolCallRequest = InvokeRequest;
+/** Base response type for invoke/call operations */
+export interface InvokeResponse {
+    output: unknown;
+    metadata?: Record<string, unknown>;
+}
+/** Response type for agent invoke operations */
+export type AgentInvokeResponse = InvokeResponse;
+/** Response type for tool call operations */
+export type ToolCallResponse = InvokeResponse;
+export interface JSONSchema {
+    type: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'null';
+    properties?: Record<string, unknown>;
     required?: string[];
+    items?: unknown;
+    description?: string;
+    default?: unknown;
+    [key: string]: unknown;
 }
-export interface ToolExecuteRequest {
-    input: Record<string, unknown>;
-    context?: Record<string, unknown>;
+export interface Capabilities {
+    streaming?: boolean;
+    [key: string]: unknown;
 }
-export interface ToolExecuteResponse {
-    output: unknown;
-    error?: string | null;
+/**
+ * Structured runtime error information
+ */
+export interface RuntimeError {
+    /** Error type/category (e.g., 'ValidationError', 'ExecutionError') */
+    type: string;
+    /** Human-readable error message */
+    message: string;
+    /** Stack trace (only included when REMINIX_CLOUD is enabled) */
+    stack?: string;
+}
+/**
+ * Error response from runtime endpoints
+ */
+export interface RuntimeErrorResponse {
+    error: RuntimeError;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0BAA0B;AAC1B,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAItD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0BAA0B;AAC1B,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAE/C,4CAA4C;AAC5C,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC;AAI5C,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,gDAAgD;AAChD,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAEjD,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAI9C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IAIpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,CAAC;CACrB"}

package/dist/version.d.ts

@@ -1,5 +1,5 @@
 /**
  * Runtime version.
  */
-export declare const VERSION = "0.0.13";
+export declare const VERSION = "0.0.15";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,5 +1,5 @@
 /**
  * Runtime version.
  */
-export const VERSION = '0.0.13';
+export const VERSION = '0.0.15';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reminix/runtime",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Reminix Runtime - Serve AI agents as REST APIs with streaming support",
   "license": "Apache-2.0",
   "author": {