@artinet/fleet 0.1.0-alpha.1 → 0.1.0-alpha.2

package/README.md

@@ -1,21 +1,19 @@
-[![Website](https://img.shields.io/badge/website-artinet.io-black)](https://artinet.io/)
-[![npm version](https://img.shields.io/npm/v/@artinet/fleet.svg?logoColor=black)](https://www.npmjs.com/package/@artinet/fleet)
-[![Apache License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
-[![Discord](https://dcbadge.limes.pink/api/server/DaxzSchmmX?style=flat)](https://discord.gg/DaxzSchmmX)
-[![Known Vulnerabilities](https://snyk.io/test/npm/@artinet/fleet/badge.svg)](https://snyk.io/test/npm/@artinet/fleet)
-
-# @artinet/fleet
+<p align="center">
+ <a href="https://artinet.io"><img src="https://img.shields.io/badge/website-artinet.io-black" alt="Website"></a>
+<a href="https://www.npmjs.com/package/@artinet/fleet"><img src="https://img.shields.io/npm/v/@artinet/fleet?color=black" alt="Downloads"></a>
+<a><img src="https://img.shields.io/badge/License-Apache_2.0-black.svg" alt="License"></a>
+<a href="https://snyk.io/test/npm/@artinet/fleet"><img src="https://snyk.io/test/npm/@artinet/fleet/badge.svg" alt="Known Vulnerabilities"></a>
+</p>
+<h1 align="center"><em>fleet</em></h1>
 
 Deploy AI agents on any infrastructure.
 
 Fleet is a lightweight server framework for hosting [A2A Protocol](https://github.com/google-a2a/A2A) agents with built-in orchestration, tool integration (MCP), and Agent2Agent communication.
 
-> 🚧 **More servers coming soon** — Hono, Bun, and standalone adapters are on the roadmap.
-
 ## Installation
 
 ```bash
-npm install @artinet/fleet express openai @modelcontextprotocol/sdk
+npm install @artinet/fleet openai @modelcontextprotocol/sdk @a2a-js/sdk
 ```
 
 **Requirements:** Node.js ≥ 18.9.1
@@ -26,12 +24,32 @@ npm install @artinet/fleet express openai @modelcontextprotocol/sdk
 
 Set an `OPENAI_API_KEY` in you environment variables, then start your Server.
 
+**Express**:
+
+```bash
+npm install express
+```
+
 ```typescript
 import { fleet } from "@artinet/fleet/express";
 
 const { app } = fleet().launch(3000);
 ```
 
+**Hono**:
+
+```bash
+npm install hono
+```
+
+```typescript
+import { fleet } from "@artinet/fleet/hono";
+
+const { app } = fleet().launch(3000);
+```
+
+> 🚧 **More servers coming soon** — Bun adapters and edge support are on the roadmap.
+
 That's it. You now have:
 
 - `POST /deploy` — Deploy agents
@@ -152,6 +170,76 @@ for await (const update of client.sendStreamingMessage("Tell me a story")) {
 }
 ```
 
+### SQLite Storage
+
+Set up a SQLite Database with [drizzle](https://www.npmjs.com/package/drizzle-orm):
+
+```bash
+npm install drizzle-orm better-sqlite3
+```
+
+```typescript
+import { SQLiteStore, AgentsTable } from "@artinet/fleet/sqlite";
+import { fleet } from "@artinet/fleet/hono";
+/*Use any drizzle compatible Database*/
+import Database from "better-sqlite3";
+import { drizzle } from "drizzle-orm/better-sqlite3";
+
+const sqlite = new Database("fleet.db");
+const db = drizzle<AgentsTable>(sqlite);
+
+fleet({
+  storage: new SQLiteStore(db),
+}).launch(3000);
+```
+
+### Logging
+
+Settup a custom logger via the [@artinet/sdk](https://www.npmjs.com/package/@artinet/sdk):
+
+```bash
+npm install @artinet/sdk pino pino-pretty
+```
+
+```typescript
+import { configure } from "@artinet/sdk";
+import { configurePino } from "@artinet/sdk/pino";
+import pino from "pino";
+
+configure({
+  logger: configurePino(
+    pino({
+      level: "info",
+      transport: {
+        target: "pino-pretty",
+        options: { colorize: true },
+      },
+    })
+  ),
+});
+```
+
+## [Docker Configuration](https://github.com/the-artinet-project/artinet/blob/main/fleet/dockerfile)
+
+Build the docker image:
+
+```bash
+docker build -t artinet-fleet .
+```
+
+Copy the example and fill in your values:
+
+```bash
+cp .env.example .env
+# Edit .env with your API keys
+```
+
+Run:
+
+```bash
+docker run --env-file .env -v fleet-data:/data -p 3000:3000 -e PORT=3000 artinet-fleet
+```
+
 <!-- ## Custom Handlers
 
 ```typescript
@@ -190,17 +278,17 @@ const app = fleet(
 app.listen(3000);
 ``` -->
 
-## Configuration
+## Settings
 
-| Option                 | Type         | Default         | Description                                                                                                                     |
-| ---------------------- | ------------ | --------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `storage`              | `IDataStore` | `InMemoryStore` | Agent storage backend (storage adapters coming soon)                                                                            |
-| `basePath`             | `string`     | `"/"`           | Base path for all routes                                                                                                        |
-| `agentPath`            | `string`     | `"/agentId"`    | Agent interaction path                                                                                                          |
-| `deploymentPath`       | `string`     | `"/deploy"`     | Deployment endpoint                                                                                                             |
-| `testPath`             | `string`     | `"/test"`       | Test endpoint                                                                                                                   |
-| `inferenceProviderUrl` | `string`     | `undefined`     | An OpenAI API compatible endpoint                                                                                               |
-| `load`                 | `function`   | `loadAgent`     | Returns an A2A Protocol compliant agent wrapped in the [`@artinet/sdk`](<(https://github.com/the-artinet-project/artinet-sdk)>) |
+| Option                 | Type         | Default                        | Description                                                                                                                     |
+| ---------------------- | ------------ | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
+| `storage`              | `IDataStore` | `InMemoryStore`, `SQLiteStore` | Agent storage backend (storage adapters coming soon)                                                                            |
+| `basePath`             | `string`     | `"/"`                          | Base path for all routes                                                                                                        |
+| `agentPath`            | `string`     | `"/agentId"`                   | Agent interaction path                                                                                                          |
+| `deploymentPath`       | `string`     | `"/deploy"`                    | Deployment endpoint                                                                                                             |
+| `testPath`             | `string`     | `"/test"`                      | Test endpoint                                                                                                                   |
+| `inferenceProviderUrl` | `string`     | `undefined`                    | An OpenAI API compatible endpoint                                                                                               |
+| `load`                 | `function`   | `loadAgent`                    | Returns an A2A Protocol compliant agent wrapped in the [`@artinet/sdk`](<(https://github.com/the-artinet-project/artinet-sdk)>) |
 
 ## API Reference
 
@@ -209,7 +297,7 @@ app.listen(3000);
 | Method | Path                                       | Description          |
 | ------ | ------------------------------------------ | -------------------- |
 | POST   | `/deploy`                                  | Deploy a new agent   |
-| POST   | `/test`                                    | Test an agent        |
+| POST   | `/test`                                    | Test a new agent     |
 | GET    | `/agentId/:id/.well-known/agent-card.json` | Get agent card       |
 | POST   | `/agentId/:id`                             | JSON-RPC interaction |
 
@@ -228,14 +316,14 @@ app.listen(3000);
 ```
 
 @artinet/fleet
-├── /express # Express adapter (current)
-├── /hono # Coming soon
+├── /express # Express adapter
+├── /hono # Hono adapter
 └── /bun # Coming soon
 
 Depends on:
 ├── @artinet/armada # Core business logic
 ├── @artinet/sdk # A2A protocol client/server
-├── orc8 # Agent orchestration
+├── orc8 # Agent/Tool orchestration
 ├── agent-def # Standardized Agent Definitions
 ├── openai # OpenAI API Client
 └── @mcp # @modelcontextprotocol/sdk

package/dist/{src/default.d.ts → default.d.ts}

@@ -1,5 +1,5 @@
 import * as armada from "@artinet/armada";
-import { InMemoryStore } from "./storage.js";
+import { InMemoryStore } from "./storage/in-memory.js";
 export declare const DEFAULTS: {
     basePath: string;
     agentPath: string;
@@ -299,7 +299,7 @@ export declare const DEFAULTS: {
                             openWorldHint?: boolean | undefined;
                         } | undefined;
                         execution?: {
-                            taskSupport?: "required" | "optional" | "forbidden" | undefined;
+                            taskSupport?: "optional" | "required" | "forbidden" | undefined;
                         } | undefined;
                         _meta?: Record<string, unknown> | undefined;
                         icons?: {
@@ -426,7 +426,7 @@ export declare const DEFAULTS: {
                             openWorldHint?: boolean | undefined;
                         } | undefined;
                         execution?: {
-                            taskSupport?: "required" | "optional" | "forbidden" | undefined;
+                            taskSupport?: "optional" | "required" | "forbidden" | undefined;
                         } | undefined;
                         _meta?: Record<string, unknown> | undefined;
                         icons?: {

package/dist/{src/default.js → default.js}

@@ -1,6 +1,6 @@
 import * as armada from "@artinet/armada";
 import { RequestAgent, CreateAgent, TestAgent, loadAgent, invokeAgent, } from "./routes/index.js";
-import { InMemoryStore } from "./storage.js";
+import { InMemoryStore } from "./storage/in-memory.js";
 export const DEFAULTS = {
     basePath: "/",
     agentPath: armada.RETRIEVE_DEPLOYMENT_PATH,

package/dist/{src/index.d.ts → index.d.ts}

@@ -2,5 +2,6 @@ export * from "./server/index.js";
 export * from "./routes/index.js";
 export * from "./settings.js";
 export * from "./types.js";
-export * from "./storage.js";
 export * from "./ship.js";
+export * from "./storage/in-memory.js";
+export * from "./storage/sqlite.js";

package/dist/{src/index.js → index.js}

@@ -2,5 +2,6 @@ export * from "./server/index.js";
 export * from "./routes/index.js";
 export * from "./settings.js";
 export * from "./types.js";
-export * from "./storage.js";
 export * from "./ship.js";
+export * from "./storage/in-memory.js";
+export * from "./storage/sqlite.js";

package/dist/{src/routes → routes}/create/index.d.ts

@@ -292,7 +292,7 @@ export declare const CreateAgent: armada.Implementation<{
                         openWorldHint?: boolean | undefined;
                     } | undefined;
                     execution?: {
-                        taskSupport?: "required" | "optional" | "forbidden" | undefined;
+                        taskSupport?: "optional" | "required" | "forbidden" | undefined;
                     } | undefined;
                     _meta?: Record<string, unknown> | undefined;
                     icons?: {
@@ -419,7 +419,7 @@ export declare const CreateAgent: armada.Implementation<{
                         openWorldHint?: boolean | undefined;
                     } | undefined;
                     execution?: {
-                        taskSupport?: "required" | "optional" | "forbidden" | undefined;
+                        taskSupport?: "optional" | "required" | "forbidden" | undefined;
                     } | undefined;
                     _meta?: Record<string, unknown> | undefined;
                     icons?: {

package/dist/{src/routes → routes}/request/implementation/invoke.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { z } from "zod/v4";
 import * as sdk from "@artinet/sdk";
 import { RequestAgentRoute, invokeFunction } from "../types/definitions.js";

package/dist/{src/routes → routes}/request/implementation/invoke.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import * as sdk from "@artinet/sdk";
 import { assert } from "console";
 function isClient(agent) {

package/dist/{src/routes → routes}/request/implementation/load.d.ts

@@ -1,2 +1,6 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { loadFunction } from "../types/definitions.js";
 export declare const loadAgent: loadFunction;

package/dist/{src/routes → routes}/request/implementation/load.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { orc8 } from "orc8";
 import { openaiProvider } from "orc8/openai";
 import * as sdk from "@artinet/sdk";

package/dist/{src/routes → routes}/request/implementation/request.d.ts

@@ -1,2 +1,6 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { RequestAgentRoute } from "../types/definitions.js";
 export declare const requestImplementation: RequestAgentRoute["implementation"];

package/dist/{src/routes → routes}/request/implementation/request.js

@@ -1,5 +1,24 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { AgentConfigurationSchema } from "agent-def";
 import * as sdk from "@artinet/sdk";
+async function load(context, target) {
+    /**Check the cache first */
+    if (context.agents?.[target.uri]) {
+        return context.agents?.[target.uri];
+    }
+    const agent = (await context.load(target, context));
+    /**Cache the agent for future requests */
+    if (agent) {
+        context.agents = {
+            ...context.agents,
+            [target.uri]: agent,
+        };
+    }
+    return agent;
+}
 export const requestImplementation = async (request, context) => {
     if (!context.target) {
         throw sdk.INTERNAL_ERROR({
@@ -8,7 +27,7 @@ export const requestImplementation = async (request, context) => {
         });
     }
     const agentConfig = await sdk.validateSchema(AgentConfigurationSchema, context.target);
-    const agent = await context.load(agentConfig, context);
+    const agent = await load(context, agentConfig);
     if (!agent) {
         throw sdk.INTERNAL_ERROR({
             data: {

package/dist/{src/routes → routes}/request/implementation/test-invoke.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { TestAgentRoute } from "../types/definitions.js";
 import { Agent } from "../types/definitions.js";
 export declare const testInvoke: (request: TestAgentRoute["request"], _agent: Agent) => Promise<TestAgentRoute["response"] | null>;

package/dist/{src/routes → routes}/request/implementation/test-invoke.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import * as sdk from "@artinet/sdk";
 import { TestRequestSchema } from "../types/definitions.js";
 import { v4 as uuidv4 } from "uuid";

package/dist/{src/routes → routes}/request/interceptors/fetch-agent.d.ts

@@ -1,2 +1,6 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { RequestAgentRoute } from "../types/definitions.js";
 export declare const FetchAgent: RequestAgentRoute["intercept"];

package/dist/{src/routes → routes}/request/interceptors/fetch-agent.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import * as armada from "@artinet/armada";
 import { AgentConfigurationSchema } from "agent-def";
 import * as sdk from "@artinet/sdk";

package/dist/{src/routes → routes}/request/interceptors/get-agents.d.ts

@@ -1,2 +1,6 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { RequestAgentRoute } from "../types/definitions.js";
 export declare const GetAgents: RequestAgentRoute["intercept"];

package/dist/{src/routes → routes}/request/interceptors/get-agents.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { AgentConfigurationSchema } from "agent-def";
 import * as armada from "@artinet/armada";
 import * as sdk from "@artinet/sdk";

package/dist/{src/routes → routes}/request/request.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { RequestAgentRoute, TestAgentRoute } from "./types/definitions.js";
 export declare const requestAgent: (request: RequestAgentRoute["request"], context: RequestAgentRoute["context"], requestFn?: RequestAgentRoute["implementation"]) => Promise<RequestAgentRoute["response"]>;
 export declare const RequestAgent: RequestAgentRoute["implementation"];

package/dist/{src/routes → routes}/request/request.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import * as armada from "@artinet/armada";
 import { FetchAgent } from "./interceptors/fetch-agent.js";
 import { GetAgents } from "./interceptors/get-agents.js";

package/dist/{src/routes → routes}/request/types/definitions.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import * as armada from "@artinet/armada";
 import { AgentConfiguration } from "agent-def";
 import * as sdk from "@artinet/sdk";

package/dist/{src/routes → routes}/request/types/definitions.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import * as armada from "@artinet/armada";
 import * as sdk from "@artinet/sdk";
 import { z } from "zod/v4";

package/dist/{src/server → server}/express/agent-request.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import express from "express";
 import { RequestAgentRoute, RequestContext } from "../../routes/request/index.js";
 export declare const AGENT_FIELD_NAME = "agentId";

package/dist/{src/server → server}/express/agent-request.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { INVALID_REQUEST } from "@artinet/sdk";
 import { RequestAgent, } from "../../routes/request/index.js";
 import * as sdk from "@artinet/sdk";

package/dist/{src/server → server}/express/deploy-request.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import express from "express";
 import { CreateAgentRoute } from "../../routes/create/index.js";
 export type handler = (req: express.Request, res: express.Response, next: express.NextFunction, context: CreateAgentRoute["context"], deploy?: CreateAgentRoute["implementation"]) => Promise<void>;

package/dist/{src/server → server}/express/deploy-request.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { CreateAgent, CreateAgentRequestSchema, } from "../../routes/create/index.js";
 import { generateRequestId, generateRegistrationId } from "./utils.js";
 import { logger, validateSchema } from "@artinet/sdk";

package/dist/{src/server → server}/express/rpc.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import express from "express";
 import { ResultOrError } from "../../types.js";
 export declare function toJSONRPCResponse(id: string, result_or_error: ResultOrError): {

package/dist/{src/server → server}/express/rpc.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import * as sdk from "@artinet/sdk";
 export function toJSONRPCResponse(id, result_or_error) {
     if (result_or_error.type === "success") {

package/dist/{src/server → server}/express/server.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { Server } from "http";
 import express from "express";
 import { CreateAgentRoute } from "../../routes/create/index.js";
@@ -20,7 +24,7 @@ export interface Options {
 export declare function fleet(settings?: Partial<Settings>, { app, authOnRetrieve, enableTesting, }?: Options): {
     app: express.Application;
     launch: (port: number) => Server;
-    ship: (agents: CreateAgentRoute["request"][]) => Promise<{
+    ship: (agents: CreateAgentRoute["request"][], userId?: string) => Promise<{
         launch: (port?: number) => Server;
     }>;
 };

package/dist/{src/server → server}/express/server.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import * as sdk from "@artinet/sdk";
 import express from "express";
 import { DEFAULTS } from "../../default.js";
@@ -27,8 +31,9 @@ const createRequestContext = (context) => {
         found: undefined,
         target: undefined,
         defaultInstructions: undefined,
+        /**cache agents in memory so we don't have to load them from storage on every request */
+        // agents: undefined,
         agentId: undefined,
-        agents: undefined,
         requestId: undefined,
         timestamp: undefined,
     };
@@ -86,9 +91,12 @@ export function fleet(settings = DEFAULTS, { app = express(), authOnRetrieve = f
             sdk.logger.info(`Fleet server running on http://localhost:${port}`);
         });
     };
-    const ship = async (agents) => {
+    const ship = async (agents, userId) => {
         for (const agent of agents) {
-            const response = await set(agent, context);
+            const response = await set(agent, {
+                ...createRequestContext(context),
+                userId: userId ?? (await user?.({})),
+            });
             if (response.success) {
                 sdk.logger.info(`Agent shipped: ${response.agentId}`);
             }

package/dist/{src/server → server}/express/test-request.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import express from "express";
 import { TestAgentRoute } from "../../routes/request/index.js";
 export type handler = (req: express.Request, res: express.Response, next: express.NextFunction, context: TestAgentRoute["context"], test?: TestAgentRoute["implementation"]) => Promise<void>;

package/dist/{src/server → server}/express/test-request.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import * as sdk from "@artinet/sdk";
 import { TestAgent, TestRequestSchema, } from "../../routes/request/index.js";
 import { v4 as uuidv4 } from "uuid";

package/dist/{src/server → server}/express/utils.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import express from "express";
 export declare function generateRequestId(context: {
     requestId?: string;

package/dist/{src/server → server}/express/utils.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { v4 as uuidv4 } from "uuid";
 import slugify from "@sindresorhus/slugify";
 export function generateRequestId(context, req) {

package/dist/server/hono/agent-request.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as hono from "hono";
+import { RequestAgentRoute, RequestContext } from "../../routes/request/index.js";
+export declare const AGENT_FIELD_NAME = "agentId";
+export type handler = (ctx: hono.Context, next: hono.Next, context: RequestContext, request?: RequestAgentRoute["implementation"]) => Promise<void>;
+export declare function handle(ctx: hono.Context, _next: hono.Next, context: RequestContext, request?: RequestAgentRoute["implementation"]): Promise<void>;
+export declare const factory: (request?: RequestAgentRoute["implementation"]) => handler;
+/**
+ * Handler utilities for agent HTTP requests.
+ *
+ * Exports a reusable handler function for routing requests to agent instances,
+ * verifying agentId route param, and returning agent metadata
+ * or dispatching to JSON-RPC middleware as appropriate.
+ *
+ * Used by the deployment server to provide a standard agent endpoint interface.
+ *
+ * @module server/handlers/agent
+ */
+export interface Params {
+    ctx: hono.Context;
+    next: hono.Next;
+    context: Omit<RequestContext, "agentId">;
+    handler: handler;
+    user: (ctx: hono.Context) => Promise<string>;
+}
+export declare function request({ ctx, next, context, handler, user, }: Params): Promise<void>;