@rcrsr/rill-agent-foundry 0.19.0 → 0.20.0

package/dist/index.d.ts

@@ -266,6 +266,17 @@ export interface HandlerDescription {
 		readonly description?: string | undefined;
 		readonly defaultValue?: unknown;
 	}>;
+	/**
+	 * Handler return type annotation, formatted with the same grammar as
+	 * parameter type strings (e.g. `stream(dict(content: string)):string`).
+	 * Undefined when the handler closure has no `:T` annotation, or when the
+	 * rill-build emitting the handler is too old to expose the field.
+	 */
+	readonly returnType?: string | undefined;
+}
+export interface InitContext {
+	readonly globalVars?: Record<string, string> | undefined;
+	readonly ahiResolver?: ((agentName: string, request: RunRequest) => Promise<RunResponse>) | undefined;
 }
 export interface RunRequest {
 	readonly params?: Record<string, unknown> | undefined;
@@ -275,13 +286,25 @@ export interface RunContext {
 	readonly sessionVars?: Record<string, string> | undefined;
 	readonly onLog?: ((message: string) => void) | undefined;
 	readonly onChunk?: ((chunk: unknown) => Promise<void>) | undefined;
+	readonly signal?: AbortSignal | undefined;
 }
 export interface RunResponse {
 	readonly state: "completed" | "error";
 	readonly result: unknown;
 	readonly streamed?: boolean | undefined;
 }
+export interface AgentHandler {
+	describe(): HandlerDescription | null;
+	init(context?: InitContext): Promise<void>;
+	execute(request?: RunRequest, context?: RunContext): Promise<RunResponse>;
+	dispose(): Promise<void>;
+}
+export interface AgentManifest {
+	readonly defaultAgent: string;
+	readonly agents: ReadonlyMap<string, AgentHandler>;
+}
 export interface AgentRouter {
+	readonly manifest: AgentManifest;
 	run(agentName: string, request: RunRequest, context?: RunContext): Promise<RunResponse>;
 	describe(agentName: string): HandlerDescription | null;
 	agents(): string[];
@@ -300,13 +323,13 @@ export declare function buildSyncResponse(result: RunResponse, responseId: strin
  *
  * When debug is true, the original message is passed through verbatim.
  * When debug is false or absent, a generic message is returned based on
- * the error code per IR-10 (FOUNDRY_AGENT_DEBUG_ERRORS=false behavior).
+ * the error code (FOUNDRY_AGENT_DEBUG_ERRORS=false behavior).
  */
 export declare function buildErrorResponse(code: string, message: string, debug?: boolean): ErrorResponse;
 /**
  * Generate Foundry tool definitions from the default agent's handler descriptions.
  *
- * Only the default agent's handlers are exposed (AC-21).
+ * Only the default agent's handlers are exposed.
  * Returns an empty array when describe() returns null.
  */
 export declare function generateToolDefinitions(router: AgentRouter): FoundryToolDefinition[];
@@ -394,5 +417,46 @@ export interface FoundryHarness {
  *   GET  /metrics    — FoundryMetrics JSON
  */
 export declare function createFoundryHarness(router: AgentRouter, options?: FoundryHarnessOptions): FoundryHarness;
+export interface RillHarnessLogger {
+	info(...args: unknown[]): void;
+	warn(...args: unknown[]): void;
+	error(...args: unknown[]): void;
+}
+export interface RillCompiledPackage {
+	readonly mount: string;
+	readonly buildOutput: {
+		readonly outputPath: string;
+	};
+}
+export interface RillServeContext {
+	readonly config: Record<string, unknown>;
+	readonly logger: RillHarnessLogger;
+	readonly packages: readonly RillCompiledPackage[];
+	readonly requestedMount: string | undefined;
+	readonly args: readonly string[];
+	readonly onShutdown: (handler: () => void | Promise<void>) => void;
+	readonly onSourceChange: (handler: () => void | Promise<void>) => void;
+}
+export interface RillPostBuildContext {
+	readonly outputDir: string;
+	readonly packages: readonly RillCompiledPackage[];
+	readonly logger: RillHarnessLogger;
+}
+export interface RillHarness {
+	readonly name: string;
+	readonly postBuild?: (ctx: RillPostBuildContext) => Promise<void>;
+	readonly serve?: (ctx: RillServeContext) => Promise<number>;
+}
+/**
+ * Default export consumed by the rill CLI (`rill install --replace`,
+ * `rill run`) when this package is declared as a bundle harness. `serve`
+ * assembles a router from the bundle's compiled packages and hosts it over the
+ * Foundry Responses harness on `config.port` (default 3000).
+ */
+declare const harness: RillHarness;
+
+export {
+	harness as default,
+};
 
 export {};

package/dist/index.js

@@ -526,6 +526,8 @@ import { DefaultAzureCredential } from "@azure/identity";
 import { validateParams, routerErrorToStatus } from "@rcrsr/rill-agent";
 
 // ../../shared/hono-kit/src/index.ts
+import { existsSync } from "fs";
+import path from "path";
 import { Hono } from "hono";
 import { serve } from "@hono/node-server";
 function assertJsonObject(parsed) {
@@ -556,6 +558,34 @@ function createHarnessLifecycle(options) {
   }
   return { app, listen, close };
 }
+function compiledPackageEntries(ctx) {
+  return ctx.packages.map((p) => ({
+    name: p.mount,
+    dir: p.buildOutput.outputPath
+  }));
+}
+function readHarnessPort(config, fallback) {
+  const p = config["port"];
+  if (typeof p === "number" && Number.isInteger(p)) return p;
+  if (typeof p === "string" && /^\d+$/.test(p)) return Number(p);
+  return fallback;
+}
+function assertCompiledHandlers(ctx) {
+  for (const pkg of ctx.packages) {
+    const handlerPath = path.join(pkg.buildOutput.outputPath, "handler.js");
+    if (!existsSync(handlerPath)) {
+      throw new Error(`missing handler file: ${handlerPath}`);
+    }
+  }
+}
+async function runRillServe(ctx, start) {
+  const handle = await start(compiledPackageEntries(ctx));
+  ctx.onShutdown(async () => {
+    await handle.close();
+  });
+  return new Promise(() => {
+  });
+}
 
 // src/harness.ts
 var DEFAULT_PORT = 8088;
@@ -948,6 +978,25 @@ function createFoundryHarness(router, options) {
   }
   return { listen, close, app, metrics };
 }
+
+// src/index.ts
+import { createRouter, assembleManifest } from "@rcrsr/rill-agent";
+var HARNESS_NAME = "@rcrsr/rill-agent-foundry";
+var harness = {
+  name: HARNESS_NAME,
+  postBuild: async (ctx) => {
+    assertCompiledHandlers(ctx);
+  },
+  serve: (ctx) => runRillServe(ctx, async (entries) => {
+    const router = await createRouter(await assembleManifest(entries));
+    const port = readHarnessPort(ctx.config, 3e3);
+    const server = createFoundryHarness(router, { port });
+    await server.listen();
+    ctx.logger.info(`[${HARNESS_NAME}] listening on :${port}`);
+    return server;
+  })
+};
+var index_default = harness;
 export {
   CapacityError,
   CredentialError,
@@ -959,6 +1008,7 @@ export {
   createFoundryHarness,
   createIdGenerator,
   createSessionManager,
+  index_default as default,
   extractInput,
   generateId,
   generateToolDefinitions,

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@rcrsr/rill-agent-foundry",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "rill agent foundry — Azure-hosted harness factory",
   "license": "MIT",
   "author": "Andre Bremer",
   "type": "module",
+  "rill": {
+    "role": "harness"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "keywords": [
@@ -25,13 +28,13 @@
     "@opentelemetry/resources": "^2.7.1",
     "@opentelemetry/sdk-node": "^0.216.0",
     "hono": "^4.12.16",
-    "@rcrsr/rill-agent": "~0.19.0"
+    "@rcrsr/rill-agent": "~0.20.0"
   },
   "devDependencies": {
     "@opentelemetry/api": "^1.9.0",
     "dts-bundle-generator": "^9.5.1",
     "tsup": "^8.5.0",
-    "@rcrsr/rill-agent-hono-kit": "^0.19.0"
+    "@rcrsr/rill-agent-hono-kit": "^0.20.0"
   },
   "files": [
     "dist"
@@ -52,7 +55,7 @@
     "build": "tsup && dts-bundle-generator --config dts-bundle-generator.config.cjs && node -e \"const fs=require('fs');const walk=(d)=>fs.readdirSync(d,{withFileTypes:true}).flatMap(e=>e.isDirectory()?walk(d+'/'+e.name):[d+'/'+e.name]);const hits=walk('dist').filter(f=>fs.readFileSync(f,'utf8').includes('@rcrsr/rill-agent-hono-kit'));if(hits.length){console.error('hono-kit leak in dist:',hits);process.exit(1);}\"",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint --config ../../../eslint.config.js src/",
+    "lint": "oxlint --config ../../../.oxlintrc.json src/ tests/",
     "check": "pnpm run build && pnpm run test && pnpm run lint"
   }
 }