@agentuity/runtime 0.0.6

package/AGENTS.md

@@ -0,0 +1,128 @@
+# Agent Guidelines for @agentuity/runtime
+
+## Package Overview
+
+Server runtime for building Agentuity applications. Built on Hono framework and optimized for Bun runtime with OpenTelemetry observability.
+
+## Commands
+
+- **Build**: `bun run build` (compiles for Bun target)
+- **Typecheck**: `bun run typecheck` (runs TypeScript type checking)
+- **Clean**: `bun run clean` (removes dist/)
+
+## Architecture
+
+- **Runtime**: Bun server runtime
+- **Framework**: Hono (lightweight web framework)
+- **Build target**: Bun runtime
+- **Dependencies**: `@agentuity/core`, Hono, OpenTelemetry
+- **Observability**: Built-in OpenTelemetry for logs, traces, and metrics
+
+## Structure
+
+```
+src/
+├── index.ts        # Main exports
+├── app.ts          # createApp() function
+├── agent.ts        # Agent types and defineAgent()
+├── router.ts       # createRouter() with extended methods
+├── logger.ts       # Logging utilities
+├── _server.ts      # Internal server creation
+├── _context.ts     # Internal context management
+└── _util.ts        # Internal utilities
+```
+
+## Code Style
+
+- **Hono patterns** - Follow Hono's context-based API design
+- **Type safety** - Extensive use of TypeScript generics
+- **Middleware pattern** - Support Hono middleware
+- **Async handlers** - All handlers can be async
+- **OpenTelemetry** - Use tracer/logger from context
+
+## Important Conventions
+
+- **Agent context** - Every agent handler receives `AgentContext` as first parameter
+- **Schema validation** - Support StandardSchemaV1 (works with Zod, Valibot, etc.)
+- **Streaming support** - Agents can return ReadableStream for streaming responses
+- **WebSocket support** - Use `router.websocket()` for WebSocket routes
+- **SSE support** - Use `router.sse()` for Server-Sent Events
+- **Session tracking** - Each request gets unique sessionId
+- **Storage abstractions** - Provide kv, objectstore, stream, vector interfaces
+
+## Agent Definition Pattern
+
+```typescript
+import { defineAgent } from '@agentuity/runtime';
+import { z } from 'zod';
+
+export default defineAgent({
+	metadata: {
+		id: 'unique-id',
+		identifier: 'folder-name',
+		name: 'Human Name',
+		description: 'What it does',
+		filename: __filename,
+		version: 'hash-or-version',
+	},
+	inputSchema: z.object({
+		/* ... */
+	}),
+	outputSchema: z.object({
+		/* ... */
+	}),
+	handler: async (ctx, input) => {
+		// ctx.logger, ctx.tracer, ctx.kv, etc.
+		return output;
+	},
+});
+```
+
+## Router Extensions
+
+The `createRouter()` function returns an extended Hono instance with:
+
+- **Standard HTTP methods**: `get`, `post`, `put`, `delete`, `patch`
+- **Streaming**: `stream(path, handler)` - Returns ReadableStream
+- **WebSocket**: `websocket(path, handler)` - WebSocket connections
+- **SSE**: `sse(path, handler)` - Server-Sent Events
+
+## AgentContext API
+
+Every agent handler receives:
+
+```typescript
+interface AgentContext {
+	logger: Logger; // Structured logger
+	tracer: Tracer; // OpenTelemetry tracer
+	sessionId: string; // Unique session ID
+	kv: KeyValueStorage; // Key-value storage
+	objectstore: ObjectStorage; // Object storage
+	stream: StreamStorage; // Stream storage
+	vector: VectorStorage; // Vector storage
+	agent: AgentRegistry; // Access other agents
+	waitUntil: (promise) => void; // Background tasks
+}
+```
+
+## Observability
+
+- **Logging**: Use `ctx.logger.info/warn/error()` not console.log
+- **Tracing**: Create spans with `ctx.tracer.startSpan()`
+- **Metrics**: Access via `c.var.meter` in Hono context
+- **Environment**: Metrics/traces sent to OTLP endpoints
+
+## Testing
+
+- Use Bun's test runner: `bun test`
+- Mock storage interfaces (kv, objectstore, etc.)
+- Test agent handlers with mock context
+- Use Hono's testing utilities for routes
+
+## Publishing Checklist
+
+1. Run `bun run build` to compile for Bun runtime
+2. Verify OpenTelemetry dependencies are correct versions
+3. Test with real Hono server
+4. Must publish **after** @agentuity/core
+5. Ensure React is only in devDependencies (for type checking web components)

package/README.md

@@ -0,0 +1,221 @@
+# @agentuity/runtime
+
+Server runtime for building Agentuity applications with Bun and Hono.
+
+## Installation
+
+```bash
+bun add @agentuity/runtime
+```
+
+## Overview
+
+`@agentuity/runtime` provides the server-side runtime for Agentuity applications. Built on [Hono](https://hono.dev/) and optimized for [Bun](https://bun.sh/), it enables you to create type-safe agents with automatic routing, validation, and observability.
+
+## Quick Start
+
+### Creating an Application
+
+```typescript
+import { createApp } from '@agentuity/runtime';
+
+const { app, server, logger } = createApp();
+
+// Start the server
+server.listen(3000);
+logger.info('Server running on http://localhost:3000');
+```
+
+### Defining an Agent
+
+```typescript
+import { type AgentContext, createAgent } from '@agentuity/runtime';
+import { z } from 'zod';
+
+const agent = createAgent({
+	schema: {
+		input: z.object({
+			message: z.string(),
+		}),
+		output: z.object({
+			response: z.string(),
+		}),
+	},
+	handler: async (ctx: AgentContext, input) => {
+		ctx.logger.info('Processing message:', input.message);
+		return { response: `You said: ${input.message}` };
+	},
+});
+
+export default agent;
+```
+
+### Creating Custom Routes
+
+```typescript
+import { createRouter } from '@agentuity/runtime';
+
+const router = createRouter();
+
+router.get('/hello', (c) => {
+	return c.json({ message: 'Hello, world!' });
+});
+
+router.post('/data', async (c) => {
+	const body = await c.req.json();
+	return c.json({ received: body });
+});
+
+export default router;
+```
+
+### Streaming Responses
+
+```typescript
+router.stream('/events', async (c) => {
+	return new ReadableStream({
+		start(controller) {
+			controller.enqueue('Event 1\n');
+			controller.enqueue('Event 2\n');
+			controller.close();
+		},
+	});
+});
+```
+
+### WebSocket Support
+
+```typescript
+router.websocket('/chat', (c) => (ws) => {
+	ws.onOpen(() => {
+		console.log('Client connected');
+	});
+
+	ws.onMessage((event) => {
+		const data = JSON.parse(event.data);
+		ws.send(JSON.stringify({ echo: data }));
+	});
+
+	ws.onClose(() => {
+		console.log('Client disconnected');
+	});
+});
+```
+
+### Server-Sent Events (SSE)
+
+```typescript
+router.sse('/updates', (c) => async (stream) => {
+	for (let i = 0; i < 10; i++) {
+		await stream.writeSSE({
+			data: JSON.stringify({ count: i }),
+			event: 'update',
+		});
+		await stream.sleep(1000);
+	}
+});
+```
+
+## API Reference
+
+### createApp(config?)
+
+Creates a new Agentuity application instance.
+
+**Returns:**
+
+- `app` - Hono application instance
+- `server` - Server instance with `listen()` method
+- `logger` - Structured logger
+
+### createAgent(config)
+
+Creates a type-safe agent with input/output validation.
+
+**Config:**
+
+- `schema.input?` - Schema for input validation (Zod, Valibot, etc.)
+- `schema.output?` - Schema for output validation
+- `handler` - Agent handler function `(ctx: AgentContext, input) => output`
+
+### createRouter()
+
+Creates a new router for defining custom API routes.
+
+**Methods:**
+
+- `get/post/put/delete/patch` - HTTP method handlers
+- `stream(path, handler)` - Streaming response handler
+- `websocket(path, handler)` - WebSocket handler
+- `sse(path, handler)` - Server-Sent Events handler
+
+### AgentContext
+
+Context object available in agent handlers:
+
+```typescript
+interface AgentContext {
+	logger: Logger; // Structured logger
+	tracer: Tracer; // OpenTelemetry tracer
+	sessionId: string; // Unique session ID
+	kv: KeyValueStorage; // Key-value storage
+	objectstore: ObjectStorage; // Object storage
+	stream: StreamStorage; // Stream storage
+	vector: VectorStorage; // Vector storage
+	agent: AgentRegistry; // Access to other agents
+	waitUntil: (promise) => void; // Defer cleanup tasks
+}
+```
+
+## Storage Services
+
+Agentuity provides built-in storage abstractions:
+
+- **KeyValueStorage** - Simple key-value storage
+- **ObjectStorage** - Object/blob storage
+- **StreamStorage** - Streaming data storage
+- **VectorStorage** - Vector embeddings storage
+
+Access these via the agent context:
+
+```typescript
+const agent = createAgent({
+	schema: {
+		output: z.object({ value: z.string().optional() }),
+	},
+	handler: async (ctx, input) => {
+		await ctx.kv.set('key', 'value');
+		const value = await ctx.kv.get('key');
+		return { value };
+	},
+});
+```
+
+## Observability
+
+Built-in OpenTelemetry support for logging, tracing, and metrics:
+
+```typescript
+const agent = createAgent({
+	schema: {
+		output: z.object({ success: z.boolean() }),
+	},
+	handler: async (ctx, input) => {
+		ctx.logger.info('Processing request');
+
+		const span = ctx.tracer.startSpan('custom-operation');
+		// ... do work ...
+		span.end();
+
+		return { success: true };
+	},
+});
+```
+
+## TypeScript
+
+Fully typed with TypeScript. Input and output types are automatically inferred from your schemas.
+
+## License
+
+MIT

package/dist/_config.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Returns the SDK Version that was used to build this app
+ *
+ * @returns string
+ */
+export declare function getSDKVersion(): string;
+/**
+ * Returns the App Name that was used when this app was built
+ *
+ * @returns string
+ */
+export declare function getAppName(): string;
+/**
+ * Returns the App Version that was used when this app was built
+ *
+ * @returns string
+ */
+export declare function getAppVersion(): string;
+/**
+ * Returns the Organization ID for this app
+ *
+ * @returns string
+ */
+export declare function getOrganizationId(): string | undefined;
+/**
+ * Returns the Project ID for this app
+ *
+ * @returns string
+ */
+export declare function getProjectId(): string | undefined;
+/**
+ * Returns the Deployment ID for this app that was deployed
+ *
+ * @returns string | undefined
+ */
+export declare function getDeploymentId(): string | undefined;
+/**
+ * Returns true if the app is running in dev mode
+ *
+ * @returns boolean
+ */
+export declare function isDevMode(): boolean;
+/**
+ * Returns true if the app is running in production mode
+ *
+ * @returns boolean
+ */
+export declare function isProduction(): boolean;
+/**
+ * Returns the CLI version that was used when this app was built
+ *
+ * @returns string
+ */
+export declare function getCLIVersion(): string;
+/**
+ * Returns the environment setting for this app
+ *
+ * @returns string
+ */
+export declare function getEnvironment(): string;
+//# sourceMappingURL=_config.d.ts.map

package/dist/_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_config.d.ts","sourceRoot":"","sources":["../src/_config.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/_context.d.ts

@@ -0,0 +1,33 @@
+import type { Tracer } from '@opentelemetry/api';
+import type { KeyValueStorage, ObjectStorage, StreamStorage, VectorStorage } from '@agentuity/core';
+import type { AgentContext, AgentName } from './agent';
+import type { Logger } from './logger';
+export interface RequestAgentContextArgs<TAgentMap, TAgent> {
+    sessionId: string;
+    agent: TAgentMap;
+    current: TAgent;
+    agentName: AgentName;
+    logger: Logger;
+    tracer: Tracer;
+    setHeader: (k: string, v: string) => void;
+}
+export declare class RequestAgentContext<TAgentMap, TAgent> implements AgentContext {
+    agent: TAgentMap;
+    current: TAgent;
+    agentName: AgentName;
+    logger: Logger;
+    sessionId: string;
+    tracer: Tracer;
+    kv: KeyValueStorage;
+    objectstore: ObjectStorage;
+    stream: StreamStorage;
+    vector: VectorStorage;
+    private waituntilHandler;
+    constructor(args: RequestAgentContextArgs<TAgentMap, TAgent>);
+    waitUntil(callback: Promise<void> | (() => void | Promise<void>)): void;
+    waitUntilAll(): Promise<void>;
+}
+export declare const inAgentContext: () => boolean;
+export declare const getAgentContext: () => AgentContext;
+export declare const runInAgentContext: <TAgentMap, TAgent>(ctxObject: Record<string, unknown>, args: RequestAgentContextArgs<TAgentMap, TAgent>, next: () => Promise<void>) => Promise<void>;
+//# sourceMappingURL=_context.d.ts.map

package/dist/_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_context.d.ts","sourceRoot":"","sources":["../src/_context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIvC,MAAM,WAAW,uBAAuB,CAAC,SAAS,EAAE,MAAM;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,qBAAa,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAE,YAAW,YAAY;IAC1E,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAG,eAAe,CAAC;IACrB,WAAW,EAAG,aAAa,CAAC;IAC5B,MAAM,EAAG,aAAa,CAAC;IACvB,MAAM,EAAG,aAAa,CAAC;IACvB,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,IAAI,EAAE,uBAAuB,CAAC,SAAS,EAAE,MAAM,CAAC;IAW5D,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;IAIvE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAID,eAAO,MAAM,cAAc,QAAO,OAGjC,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,YAMlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,SAAS,EAAE,MAAM,EAClD,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,MAAM,uBAAuB,CAAC,SAAS,EAAE,MAAM,CAAC,EAChD,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC,kBAgBzB,CAAC"}

package/dist/_idle.d.ts

@@ -0,0 +1,7 @@
+/**
+ * returns true if the server is idle (no pending requests, websockets, or waitUntil tasks)
+ *
+ * @returns true if idle
+ */
+export declare function isIdle(): boolean;
+//# sourceMappingURL=_idle.d.ts.map

package/dist/_idle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_idle.d.ts","sourceRoot":"","sources":["../src/_idle.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,MAAM,YAiBrB"}

package/dist/_server.d.ts

@@ -0,0 +1,17 @@
+import { type Tracer } from '@opentelemetry/api';
+import type { SpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { Hono } from 'hono';
+import type { BunWebSocketData } from 'hono/bun';
+import type { AppConfig, Env } from './app';
+import type { Logger } from './logger';
+export declare function getServer(): Bun.Server<BunWebSocketData> | null;
+export declare function getApp(): Hono<any, import("hono/types").BlankSchema, "/"> | null;
+export declare function getLogger(): Logger | null;
+export declare function getTracer(): Tracer | null;
+/**
+ * add a custom span processor that will be added to the otel configuration. this method must be
+ * called before the createApp is called for it to be added.
+ */
+export declare function addSpanProcessor(processor: SpanProcessor): void;
+export declare const createServer: <E extends Env>(app: Hono<E>, _config?: AppConfig) => Bun.Server<BunWebSocketData>;
+//# 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":"AACA,OAAO,EAKN,KAAK,MAAM,EAGX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAavC,wBAAgB,SAAS,wCAExB;AAED,wBAAgB,MAAM,4DAErB;AAED,wBAAgB,SAAS,kBAExB;AAED,wBAAgB,SAAS,kBAExB;AAcD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,QAExD;AA2CD,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,SAAS,iCA8G5E,CAAC"}

package/dist/_services.d.ts

@@ -0,0 +1,2 @@
+export declare function registerServices(o: any): void;
+//# sourceMappingURL=_services.d.ts.map

package/dist/_services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_services.d.ts","sourceRoot":"","sources":["../src/_services.ts"],"names":[],"mappings":"AA8IA,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,QAqBtC"}

package/dist/_util.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from 'hono';
+export declare function returnResponse(ctx: Context, result: any): Response;
+/**
+ * SHA256 hash of the given values
+ *
+ * @param val one or more strings to hash
+ * @returns hash string in hex format
+ */
+export declare function hash(...val: string[]): string;
+/**
+ * Safely stringify an object to JSON, handling circular references
+ * @param obj - The object to stringify
+ * @returns JSON string representation
+ */
+export declare function safeStringify(obj: unknown): string;
+//# sourceMappingURL=_util.d.ts.map

package/dist/_util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_util.d.ts","sourceRoot":"","sources":["../src/_util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,YAMvD;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAI7C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAkClD"}

package/dist/_waituntil.d.ts

@@ -0,0 +1,20 @@
+import { type Tracer } from '@opentelemetry/api';
+import type { Logger } from './logger';
+/**
+ * returns true if wait until is pending
+ * @returns boolean
+ */
+export declare function hasWaitUntilPending(): boolean;
+export default class WaitUntilHandler {
+    private promises;
+    private tracer;
+    private started;
+    private hasCalledWaitUntilAll;
+    private setHeader;
+    constructor(setHeader: (k: string, v: string) => void, tracer: Tracer);
+    waitUntil(promise: Promise<void> | (() => void | Promise<void>)): void;
+    hasPending(): boolean;
+    private markSessionCompleted;
+    waitUntilAll(logger: Logger, sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=_waituntil.d.ts.map

package/dist/_waituntil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_waituntil.d.ts","sourceRoot":"","sources":["../src/_waituntil.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,MAAM,EAAS,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKvC;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C;AAED,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACpC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,SAAS,CAAiC;gBAE/B,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,EAAE,MAAM,EAAE,MAAM;IAOrE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;IAsCtE,UAAU,IAAI,OAAO;YAId,oBAAoB;IAKrB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAyK3E"}

package/dist/agent.d.ts

@@ -0,0 +1,88 @@
+import type { StandardSchemaV1, KeyValueStorage, ObjectStorage, StreamStorage, VectorStorage } from '@agentuity/core';
+import { type Tracer } from '@opentelemetry/api';
+import type { MiddlewareHandler } from 'hono';
+import type { Logger } from './logger';
+export interface AgentContext {
+    waitUntil: (promise: Promise<void> | (() => void | Promise<void>)) => void;
+    agent?: any;
+    current?: any;
+    agentName?: AgentName;
+    logger: Logger;
+    sessionId: string;
+    tracer: Tracer;
+    kv: KeyValueStorage;
+    objectstore: ObjectStorage;
+    stream: StreamStorage;
+    vector: VectorStorage;
+}
+interface AgentMetadata {
+    /**
+     * the unique identifier for this agent and project
+     */
+    id: string;
+    /**
+     * the folder name for the agent
+     */
+    identifier: string;
+    /**
+     * the human readable name for the agent (identifier is used if not specified)
+     */
+    name: string;
+    /**
+     * the human readable description for the agent (empty if not provided)
+     */
+    description: string;
+    /**
+     * the relative path to the agent from the root project directory
+     */
+    filename: string;
+    /**
+     * a unique version for the agent. computed as the SHA256 contents of the file.
+     */
+    version: string;
+}
+/**
+ * The Agent handler interface.
+ */
+export type Agent<TInput extends StandardSchemaV1 | undefined = any, TOutput extends StandardSchemaV1 | undefined = any, TStream extends boolean = false> = {
+    metadata: AgentMetadata;
+    handler: (ctx: AgentContext, ...args: any[]) => any | Promise<any>;
+} & (TInput extends StandardSchemaV1 ? {
+    inputSchema: TInput;
+} : {
+    inputSchema?: never;
+}) & (TOutput extends StandardSchemaV1 ? {
+    outputSchema: TOutput;
+} : {
+    outputSchema?: never;
+}) & (TStream extends true ? {
+    stream: true;
+} : {
+    stream?: false;
+});
+type InferSchemaInput<T> = T extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<T> : never;
+type InferStreamOutput<TOutput, TStream extends boolean> = TStream extends true ? TOutput extends StandardSchemaV1 ? ReadableStream<StandardSchemaV1.InferOutput<TOutput>> : ReadableStream<unknown> : TOutput extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TOutput> : void;
+export interface AgentRunner<TInput extends StandardSchemaV1 | undefined = any, TOutput extends StandardSchemaV1 | undefined = any, TStream extends boolean = false> {
+    metadata: AgentMetadata;
+    run: undefined extends TInput ? () => Promise<InferStreamOutput<Exclude<TOutput, undefined>, TStream>> : (input: InferSchemaInput<Exclude<TInput, undefined>>) => Promise<InferStreamOutput<Exclude<TOutput, undefined>, TStream>>;
+}
+/**
+ * Union type of all registered agent names.
+ * Falls back to `string` when no agents are registered (before augmentation).
+ * After augmentation, this becomes a strict union of agent names for full type safety.
+ */
+export type AgentName = string;
+export type AgentRegistry = Record<AgentName, AgentRunner>;
+export declare const registerAgent: (name: AgentName, agent: Agent) => void;
+export declare function createAgent<TInput extends StandardSchemaV1 | undefined = undefined, TOutput extends StandardSchemaV1 | undefined = undefined, TStream extends boolean = false>(config: {
+    schema?: {
+        input?: TInput;
+        output?: TOutput;
+        stream?: TStream;
+    };
+    metadata?: Partial<Omit<AgentMetadata, 'id'>>;
+    handler: TInput extends StandardSchemaV1 ? TStream extends true ? TOutput extends StandardSchemaV1 ? (c: AgentContext, input: StandardSchemaV1.InferOutput<TInput>) => Promise<ReadableStream<StandardSchemaV1.InferOutput<TOutput>>> | ReadableStream<StandardSchemaV1.InferOutput<TOutput>> : (c: AgentContext, input: StandardSchemaV1.InferOutput<TInput>) => Promise<ReadableStream<unknown>> | ReadableStream<unknown> : TOutput extends StandardSchemaV1 ? (c: AgentContext, input: StandardSchemaV1.InferOutput<TInput>) => Promise<StandardSchemaV1.InferOutput<TOutput>> | StandardSchemaV1.InferOutput<TOutput> : (c: AgentContext, input: StandardSchemaV1.InferOutput<TInput>) => Promise<void> | void : TStream extends true ? TOutput extends StandardSchemaV1 ? (c: AgentContext) => Promise<ReadableStream<StandardSchemaV1.InferOutput<TOutput>>> | ReadableStream<StandardSchemaV1.InferOutput<TOutput>> : (c: AgentContext) => Promise<ReadableStream<unknown>> | ReadableStream<unknown> : TOutput extends StandardSchemaV1 ? (c: AgentContext) => Promise<StandardSchemaV1.InferOutput<TOutput>> | StandardSchemaV1.InferOutput<TOutput> : (c: AgentContext) => Promise<void> | void;
+}): Agent<TInput, TOutput, TStream>;
+export declare const createAgentMiddleware: (agentName: AgentName) => MiddlewareHandler;
+export {};
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

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

package/dist/app.d.ts

@@ -0,0 +1,24 @@
+import { type Env as HonoEnv, Hono } from 'hono';
+import type { Logger } from './logger';
+import { type Meter, type Tracer } from '@opentelemetry/api';
+export interface AppConfig {
+}
+export interface Variables {
+    logger: Logger;
+    meter: Meter;
+    tracer: Tracer;
+}
+export interface Env extends HonoEnv {
+    Variables: Variables;
+}
+/**
+ * create a new app instance
+ *
+ * @returns App instance
+ */
+export declare function createApp(config?: AppConfig): {
+    app: Hono<Env, import("hono/types").BlankSchema, "/">;
+    server: Bun.Server<import("hono/bun").BunWebSocketData>;
+    logger: Logger;
+};
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,IAAI,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG7D,MAAM,WAAW,SAAS;CAEzB;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,GAAI,SAAQ,OAAO;IACnC,SAAS,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS;;;;EAK3C"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './agent';
+export * from './app';
+export * from './router';
+export type { Logger } from './logger';
+export { getApp } from './_server';
+//# sourceMappingURL=index.d.ts.map