@nylorun/agents 0.7.0-beta → 0.9.0-beta

package/dist/mcp/index.d.ts

@@ -1,2 +1,2 @@
-export { mcp, McpError } from "./mcp.js";
-export type { McpCapability, McpOptions } from "./mcp.js";
+export { mcp, McpError, normalizeMcpServers } from "@nylorun/core/define";
+export type { McpCapability, McpOptions, McpServerSpec } from "@nylorun/core/define";

package/dist/mcp/index.js

@@ -1 +1 @@
-export { mcp, McpError } from "./mcp.js";
+export { mcp, McpError, normalizeMcpServers } from "@nylorun/core/define";

package/dist/sandbox/index.d.ts

@@ -1,4 +1,4 @@
-export { sandbox, SandboxError } from "./sandbox.js";
-export type { SandboxCapability, SandboxCapabilityOptions, SandboxOptions, } from "./sandbox.js";
+export { sandbox, SandboxError } from "@nylorun/core/define";
+export type { SandboxCapability, SandboxCapabilityOptions, SandboxOptions, } from "@nylorun/core/define";
 export { createActionSandbox, definitionDeclaresSandbox, isActionSandboxTool, } from "./client.js";
 export type { ActionSandbox, ActionSandboxToolResult, CreateActionSandboxOptions, } from "./client.js";

package/dist/sandbox/index.js

@@ -1,2 +1,2 @@
-export { sandbox, SandboxError } from "./sandbox.js";
+export { sandbox, SandboxError } from "@nylorun/core/define";
 export { createActionSandbox, definitionDeclaresSandbox, isActionSandboxTool, } from "./client.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nylorun/agents",
-  "version": "0.7.0-beta",
+  "version": "0.9.0-beta",
   "description": "Nylorun agent definitions, session client and connected executor",
   "type": "module",
   "license": "Apache-2.0",
@@ -27,6 +27,10 @@
     "./executor": {
       "types": "./dist/executor.d.ts",
       "import": "./dist/executor.js"
+    },
+    "./ag-ui": {
+      "types": "./dist/ag-ui/index.d.ts",
+      "import": "./dist/ag-ui/index.js"
     }
   },
   "scripts": {
@@ -35,7 +39,8 @@
     "test": "vitest run --passWithNoTests"
   },
   "dependencies": {
-    "@nylorun/core": "0.6.0-beta",
+    "@ag-ui/core": "~1.0.0",
+    "@nylorun/core": "0.8.0-beta",
     "gray-matter": "^4.0.3"
   },
   "peerDependencies": {
@@ -51,7 +56,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/nylorun/harness.git",
+    "url": "git+https://github.com/nylorun/agents.git",
     "directory": "agents"
   },
   "publishConfig": {

package/dist/mcp/mcp.d.ts

@@ -1,30 +0,0 @@
-import type { CapabilityDeclaration, McpServerManifest } from "@nylorun/core/define";
-export interface McpOptions {
-    /** Capability id. Defaults to `"mcp"`. */
-    readonly id?: string;
-}
-export interface McpCapability extends CapabilityDeclaration {
-    readonly mcpServers: Readonly<Record<string, McpServerManifest>>;
-}
-export declare class McpError extends Error {
-    readonly code: string;
-    constructor(code: string, message: string);
-}
-/**
- * Declare MCP servers as one capability for `Agent.use`.
- *
- * The map shape matches agent-plugins `mcpServers` and manifest v3: each key
- * must equal that server's `name`. Supported transports are `stdio`,
- * `streamable-http`, and `sse` (see https://agent-plugins.org/plugin-authors/mcp-servers).
- *
- * ```ts
- * Agent({...}).use(mcp({
- *   github: {
- *     name: "github",
- *     type: "streamable-http",
- *     url: "https://mcp.example.com/github",
- *   },
- * }))
- * ```
- */
-export declare function mcp(servers: Readonly<Record<string, McpServerManifest>>, options?: McpOptions): McpCapability;

package/dist/mcp/mcp.js

@@ -1,80 +0,0 @@
-export class McpError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.name = "McpError";
-        this.code = code;
-    }
-}
-/**
- * Declare MCP servers as one capability for `Agent.use`.
- *
- * The map shape matches agent-plugins `mcpServers` and manifest v3: each key
- * must equal that server's `name`. Supported transports are `stdio`,
- * `streamable-http`, and `sse` (see https://agent-plugins.org/plugin-authors/mcp-servers).
- *
- * ```ts
- * Agent({...}).use(mcp({
- *   github: {
- *     name: "github",
- *     type: "streamable-http",
- *     url: "https://mcp.example.com/github",
- *   },
- * }))
- * ```
- */
-export function mcp(servers, options = {}) {
-    const id = options.id ?? "mcp";
-    if (!isRecord(servers)) {
-        throw new McpError("mcp.invalid", "mcp() expects a non-empty map of MCP servers");
-    }
-    const entries = Object.entries(servers);
-    if (entries.length === 0) {
-        throw new McpError("mcp.empty", "mcp() requires at least one MCP server");
-    }
-    const mcpServers = {};
-    for (const [key, server] of entries) {
-        if (!isMcpServer(server)) {
-            throw new McpError("mcp.invalid-server", `MCP server '${key}' is not a valid stdio, streamable-http, or sse declaration`);
-        }
-        if (server.name !== key) {
-            throw new McpError("mcp.name-mismatch", `MCP server key '${key}' must equal the server name '${server.name}'`);
-        }
-        mcpServers[key] = freezeServer(server);
-    }
-    return { id, mcpServers: Object.freeze(mcpServers) };
-}
-function freezeServer(server) {
-    if (server.type === "stdio") {
-        return Object.freeze({
-            name: server.name,
-            type: "stdio",
-            command: server.command,
-            ...(server.args === undefined ? {} : { args: Object.freeze([...server.args]) }),
-            ...(server.env === undefined
-                ? {}
-                : { env: Object.freeze({ ...server.env }) }),
-            ...(server.cwd === undefined ? {} : { cwd: server.cwd }),
-        });
-    }
-    return Object.freeze({
-        name: server.name,
-        type: server.type,
-        url: server.url,
-        ...(server.headers === undefined
-            ? {}
-            : { headers: Object.freeze({ ...server.headers }) }),
-    });
-}
-function isMcpServer(value) {
-    if (!isRecord(value) || typeof value.name !== "string" || !value.name)
-        return false;
-    if (value.type === "stdio")
-        return typeof value.command === "string" && value.command.length > 0;
-    if (value.type === "streamable-http" || value.type === "sse")
-        return typeof value.url === "string" && value.url.length > 0;
-    return false;
-}
-function isRecord(value) {
-    return !!value && typeof value === "object" && !Array.isArray(value);
-}

package/dist/sandbox/sandbox.d.ts

@@ -1,27 +0,0 @@
-import type { CapabilityDeclaration, SandboxManifest, ToolDefinition } from "@nylorun/core/define";
-/** What computer the agent needs. The Runtime decides where it runs. */
-export type SandboxOptions = SandboxManifest;
-export interface SandboxCapabilityOptions {
-    /** Capability id. Defaults to `"sandbox"`. */
-    readonly id?: string;
-}
-export interface SandboxCapability extends CapabilityDeclaration {
-    readonly sandbox: SandboxManifest;
-    readonly tools: readonly ToolDefinition[];
-}
-export declare class SandboxError extends Error {
-    readonly code: string;
-    constructor(code: string, message: string);
-}
-/**
- * Give the agent an isolated Linux machine with a persistent `/workspace`.
- *
- * Adds the built-in `bash`, `read`, `write`, `edit`, `grep` and `glob` tools. They run in the
- * Nylorun Runtime, which picks the backend. Agent code declares requirements only.
- *
- * ```ts
- * Agent({ id: "analyst", instructions: "..." }).use(sandbox())
- * Agent({ ... }).use(sandbox({ image: "node:24", network: { allow: ["api.github.com"] } }))
- * ```
- */
-export declare function sandbox(options?: SandboxOptions, capability?: SandboxCapabilityOptions): SandboxCapability;

package/dist/sandbox/sandbox.js

@@ -1,92 +0,0 @@
-import { SANDBOX_DEFERRED_FIELDS, SANDBOX_FIELDS, SANDBOX_INSTRUCTIONS, SANDBOX_NETWORK_PRESETS, createSandboxTools, isSandboxHostPattern, parseSandboxDuration, parseSandboxSize, } from "@nylorun/core/define";
-export class SandboxError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.name = "SandboxError";
-        this.code = code;
-    }
-}
-/**
- * Give the agent an isolated Linux machine with a persistent `/workspace`.
- *
- * Adds the built-in `bash`, `read`, `write`, `edit`, `grep` and `glob` tools. They run in the
- * Nylorun Runtime, which picks the backend. Agent code declares requirements only.
- *
- * ```ts
- * Agent({ id: "analyst", instructions: "..." }).use(sandbox())
- * Agent({ ... }).use(sandbox({ image: "node:24", network: { allow: ["api.github.com"] } }))
- * ```
- */
-export function sandbox(options = {}, capability = {}) {
-    const id = capability.id ?? "sandbox";
-    if (!isRecord(options))
-        throw new SandboxError("sandbox.invalid", "sandbox() expects an options object");
-    for (const key of Object.keys(options)) {
-        if (SANDBOX_DEFERRED_FIELDS.includes(key))
-            throw new SandboxError("sandbox.unsupported", `sandbox({ ${key} }) is not supported in this version. ` +
-                `Supported options: ${SANDBOX_FIELDS.join(", ")}. See docs/design/sandboxes.md for what is planned.`);
-        if (!SANDBOX_FIELDS.includes(key))
-            throw new SandboxError("sandbox.unknown-option", `Unknown sandbox option '${key}'. Supported options: ${SANDBOX_FIELDS.join(", ")}`);
-    }
-    return Object.freeze({
-        id,
-        instructions: Object.freeze([SANDBOX_INSTRUCTIONS]),
-        tools: createSandboxTools(),
-        sandbox: freezeOptions(options),
-    });
-}
-function freezeOptions(options) {
-    const result = {};
-    if (options.image !== undefined) {
-        if (typeof options.image !== "string" || options.image.trim().length === 0)
-            throw new SandboxError("sandbox.invalid-image", "sandbox({ image }) must be a non-empty OCI image reference");
-        result.image = options.image;
-    }
-    if (options.network !== undefined) {
-        if (!isRecord(options.network))
-            throw new SandboxError("sandbox.invalid-network", "sandbox({ network }) must be an object");
-        for (const key of Object.keys(options.network))
-            if (key !== "preset" && key !== "allow")
-                throw new SandboxError("sandbox.invalid-network", `Unknown network option '${key}'. Use preset and allow.`);
-        const { preset, allow } = options.network;
-        if (preset !== undefined && !SANDBOX_NETWORK_PRESETS.includes(preset))
-            throw new SandboxError("sandbox.invalid-network", `network.preset must be one of ${SANDBOX_NETWORK_PRESETS.join(", ")}`);
-        if (allow !== undefined) {
-            if (!Array.isArray(allow))
-                throw new SandboxError("sandbox.invalid-network", "network.allow must be an array of host names");
-            for (const host of allow)
-                if (typeof host !== "string" || !isSandboxHostPattern(host))
-                    throw new SandboxError("sandbox.invalid-network", `network.allow entry '${String(host)}' must be a host name such as api.github.com or *.example.com (no scheme, port or path)`);
-        }
-        result.network = Object.freeze({
-            ...(preset === undefined ? {} : { preset: preset }),
-            ...(allow === undefined ? {} : { allow: Object.freeze([...allow]) }),
-        });
-    }
-    if (options.resources !== undefined) {
-        if (!isRecord(options.resources))
-            throw new SandboxError("sandbox.invalid-resources", "sandbox({ resources }) must be an object");
-        for (const key of Object.keys(options.resources))
-            if (key !== "cpus" && key !== "memory")
-                throw new SandboxError("sandbox.invalid-resources", `resources.${key} is not supported in this version. Use cpus and memory.`);
-        const { cpus, memory } = options.resources;
-        if (cpus !== undefined && (!Number.isInteger(cpus) || cpus < 1 || cpus > 64))
-            throw new SandboxError("sandbox.invalid-resources", "resources.cpus must be an integer from 1 to 64");
-        if (memory !== undefined && (typeof memory !== "string" || parseSandboxSize(memory) === undefined))
-            throw new SandboxError("sandbox.invalid-resources", "resources.memory must be a size such as 512MiB or 2GiB");
-        result.resources = Object.freeze({
-            ...(cpus === undefined ? {} : { cpus }),
-            ...(memory === undefined ? {} : { memory }),
-        });
-    }
-    if (options.idle !== undefined) {
-        if (typeof options.idle !== "string" || parseSandboxDuration(options.idle) === undefined)
-            throw new SandboxError("sandbox.invalid-idle", "sandbox({ idle }) must be a duration such as 30s, 15m or 1h");
-        result.idle = options.idle;
-    }
-    return Object.freeze(result);
-}
-function isRecord(value) {
-    return !!value && typeof value === "object" && !Array.isArray(value);
-}