agentxjs 0.0.1

package/dist/types-Cgfcw91r.d.ts

@@ -0,0 +1,282 @@
+import { StreamEventType, Repository, UserMessage } from '@agentxjs/types';
+
+/**
+ * Server Types
+ *
+ * Type definitions for AgentX server module.
+ * These are application-level types, not core domain types.
+ */
+
+/**
+ * Supported transport types
+ */
+type TransportType = "sse" | "websocket";
+/**
+ * Transport connection state
+ */
+type ConnectionState = "connecting" | "open" | "closing" | "closed";
+/**
+ * Transport connection interface
+ */
+interface TransportConnection {
+    /**
+     * Unique connection ID
+     */
+    readonly connectionId: string;
+    /**
+     * Associated agent ID
+     */
+    readonly agentId: string;
+    /**
+     * Connection state
+     */
+    readonly state: ConnectionState;
+    /**
+     * Send a Stream event to the client
+     */
+    send(event: StreamEventType): void;
+    /**
+     * Close the connection
+     */
+    close(): void;
+    /**
+     * Register close handler
+     */
+    onClose(handler: () => void): void;
+}
+/**
+ * AgentX Handler - Framework-agnostic request handler
+ *
+ * Based on Web Standards (Request/Response).
+ * Can be adapted to any framework.
+ */
+interface AgentXHandler {
+    /**
+     * Handle a web request
+     */
+    (request: Request): Promise<Response>;
+}
+/**
+ * Handler options
+ */
+interface AgentXHandlerOptions {
+    /**
+     * Transport type (default: "sse")
+     */
+    transport?: TransportType;
+    /**
+     * Base path prefix (default: "")
+     */
+    basePath?: string;
+    /**
+     * Allow dynamic agent creation via API (default: false)
+     */
+    allowDynamicCreation?: boolean;
+    /**
+     * Allowed definition names for dynamic creation
+     */
+    allowedDefinitions?: string[];
+    /**
+     * Repository for persistence (optional)
+     *
+     * If provided, enables /images/*, /sessions/*, /messages/* endpoints.
+     */
+    repository?: Repository;
+    /**
+     * CORS configuration
+     */
+    cors?: CorsOptions;
+    /**
+     * Lifecycle hooks
+     */
+    hooks?: AgentXHandlerHooks;
+}
+/**
+ * CORS options
+ */
+interface CorsOptions {
+    /**
+     * Allowed origins
+     */
+    origin?: string | string[] | boolean;
+    /**
+     * Allowed methods
+     */
+    methods?: string[];
+    /**
+     * Allowed headers
+     */
+    headers?: string[];
+    /**
+     * Credentials
+     */
+    credentials?: boolean;
+}
+/**
+ * Handler lifecycle hooks
+ */
+interface AgentXHandlerHooks {
+    /**
+     * Called when a client connects to an agent's SSE
+     */
+    onConnect?: (agentId: string, connectionId: string) => void | Promise<void>;
+    /**
+     * Called when a client disconnects
+     */
+    onDisconnect?: (agentId: string, connectionId: string) => void | Promise<void>;
+    /**
+     * Called before processing a message
+     */
+    onMessage?: (agentId: string, message: UserMessage) => void | Promise<void>;
+    /**
+     * Called on errors
+     */
+    onError?: (agentId: string, error: Error) => void | Promise<void>;
+}
+/**
+ * Parsed request info
+ */
+interface ParsedRequest {
+    /**
+     * Request type
+     */
+    type: RequestType;
+    /**
+     * Agent ID (if applicable)
+     */
+    agentId?: string;
+    /**
+     * Definition name (if applicable)
+     */
+    definitionName?: string;
+    /**
+     * Image ID (if applicable)
+     */
+    imageId?: string;
+    /**
+     * Session ID (if applicable)
+     */
+    sessionId?: string;
+    /**
+     * User ID (if applicable)
+     */
+    userId?: string;
+    /**
+     * Message ID (if applicable)
+     */
+    messageId?: string;
+    /**
+     * Container ID (if applicable)
+     */
+    containerId?: string;
+    /**
+     * Request body (if applicable)
+     */
+    body?: unknown;
+}
+/**
+ * Request types
+ */
+type RequestType = "platform_info" | "platform_health" | "list_agents" | "create_agent" | "get_agent" | "delete_agent" | "connect_sse" | "send_message" | "interrupt" | "list_definitions" | "get_definition" | "save_definition" | "delete_definition" | "head_definition" | "list_images" | "get_image" | "save_image" | "delete_image" | "head_image" | "list_image_sessions" | "delete_image_sessions" | "run_image" | "list_sessions" | "get_session" | "save_session" | "delete_session" | "head_session" | "list_session_messages" | "delete_session_messages" | "count_session_messages" | "resume_session" | "list_user_sessions" | "get_message" | "save_message" | "delete_message" | "list_containers" | "create_container" | "get_container" | "save_container" | "delete_container" | "head_container" | "not_found";
+/**
+ * Platform info response
+ */
+interface PlatformInfoResponse {
+    platform: "AgentX";
+    version: string;
+    agentCount: number;
+}
+/**
+ * Health check response
+ */
+interface HealthResponse {
+    status: "healthy" | "degraded" | "unhealthy";
+    timestamp: number;
+    agentCount: number;
+}
+/**
+ * Agent list response
+ */
+interface AgentListResponse {
+    agents: AgentInfoResponse[];
+}
+/**
+ * Agent info response
+ */
+interface AgentInfoResponse {
+    agentId: string;
+    name: string;
+    description?: string;
+    lifecycle: string;
+    state: string;
+    createdAt: number;
+}
+/**
+ * Create agent request
+ */
+interface CreateAgentRequest {
+    /**
+     * Definition name (must be registered)
+     */
+    definition: string;
+    /**
+     * Agent configuration
+     */
+    config?: Record<string, unknown>;
+    /**
+     * Optional agent ID (auto-generated if not provided)
+     */
+    agentId?: string;
+}
+/**
+ * Create agent response
+ */
+interface CreateAgentResponse {
+    agentId: string;
+    name: string;
+    lifecycle: string;
+    state: string;
+    createdAt: number;
+    endpoints: {
+        sse: string;
+        messages: string;
+        interrupt: string;
+    };
+}
+/**
+ * Send message request
+ */
+interface SendMessageRequest {
+    /**
+     * Message content (string or UserMessage)
+     */
+    content: string | UserMessage["content"];
+}
+/**
+ * Send message response
+ */
+interface SendMessageResponse {
+    status: "processing";
+}
+/**
+ * Interrupt response
+ */
+interface InterruptResponse {
+    interrupted: boolean;
+}
+/**
+ * Error response
+ */
+interface ErrorResponse {
+    error: {
+        code: ErrorCode;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * Error codes
+ */
+type ErrorCode = "AGENT_NOT_FOUND" | "AGENT_BUSY" | "AGENT_DESTROYED" | "INVALID_REQUEST" | "DEFINITION_NOT_FOUND" | "IMAGE_NOT_FOUND" | "DYNAMIC_CREATION_DISABLED" | "INTERNAL_ERROR";
+
+export type { AgentXHandler as A, ConnectionState as C, ErrorResponse as E, HealthResponse as H, InterruptResponse as I, ParsedRequest as P, RequestType as R, SendMessageRequest as S, TransportConnection as T, AgentXHandlerOptions as a, TransportType as b, AgentXHandlerHooks as c, CorsOptions as d, PlatformInfoResponse as e, AgentListResponse as f, AgentInfoResponse as g, CreateAgentRequest as h, CreateAgentResponse as i, SendMessageResponse as j, ErrorCode as k };

package/dist/types-OVKV6qpE.d.cts

@@ -0,0 +1,118 @@
+import { Runtime, Repository, LoggerFactory, AgentIdResolver, Sandbox, AgentDefinition, AgentContext, RuntimeDriver, Logger } from '@agentxjs/types';
+
+/**
+ * SSERuntime - Browser Runtime implementation
+ *
+ * "Define Once, Run Anywhere"
+ *
+ * Provides Runtime for browser that connects to remote AgentX server via SSE.
+ * Uses the same API as NodeRuntime, enabling unified code across platforms.
+ *
+ * @example
+ * ```typescript
+ * import { createAgentX } from "agentxjs";
+ * import { createSSERuntime } from "agentxjs/client";
+ * import { defineAgent } from "agentxjs";
+ *
+ * const MyAgent = defineAgent({
+ *   name: "Assistant",
+ *   systemPrompt: "You are a helpful assistant",
+ * });
+ *
+ * // Browser: connect to remote server
+ * const runtime = createSSERuntime({ serverUrl: "http://localhost:5200/agentx" });
+ * const agentx = createAgentX(runtime);
+ * const agent = agentx.agents.create(MyAgent);
+ *
+ * // Same API as server-side!
+ * agent.on("assistant_message", (event) => {
+ *   console.log(event.data.content);
+ * });
+ *
+ * await agent.receive("Hello!");
+ * ```
+ */
+
+/**
+ * SSERuntime configuration
+ */
+interface SSERuntimeConfig {
+    /**
+     * Server base URL (e.g., "http://localhost:5200/agentx")
+     */
+    serverUrl: string;
+    /**
+     * Optional request headers (for auth, etc.)
+     * Note: These headers are used for HTTP requests (POST, DELETE, etc.)
+     * but NOT for SSE connections (EventSource doesn't support headers).
+     * For SSE auth, use sseParams to pass token via query string.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Optional query parameters to append to SSE URL.
+     * Use this for authentication since EventSource doesn't support headers.
+     *
+     * @example
+     * ```typescript
+     * createSSERuntime({
+     *   serverUrl: "http://localhost:5200/agentx",
+     *   headers: { Authorization: "Bearer xxx" }, // For HTTP requests
+     *   sseParams: { token: "xxx" }, // For SSE connections
+     * });
+     * ```
+     */
+    sseParams?: Record<string, string>;
+}
+/**
+ * SSERuntime - Runtime for browser with SSE driver
+ *
+ * Connects to remote AgentX server via SSE.
+ * All resources (LLM, etc.) are provided by the server.
+ *
+ * Uses RemoteContainer which calls server POST /agents to create agents.
+ * This ensures browser and server use the same agentId.
+ */
+declare class SSERuntime implements Runtime {
+    readonly name = "sse";
+    readonly repository: Repository;
+    readonly loggerFactory: LoggerFactory;
+    readonly agentIdResolver: AgentIdResolver;
+    private readonly serverUrl;
+    private readonly headers;
+    private readonly sseParams;
+    constructor(config: SSERuntimeConfig);
+    createSandbox(_containerId: string): Sandbox;
+    createDriver(_definition: AgentDefinition, context: AgentContext, _sandbox: Sandbox): RuntimeDriver;
+    createLogger(name: string): Logger;
+}
+/**
+ * Create SSE Runtime for browser
+ *
+ * @example
+ * ```typescript
+ * import { createAgentX } from "agentxjs";
+ * import { sseRuntime } from "agentxjs/runtime/sse";
+ *
+ * createAgentX(sseRuntime({
+ *   serverUrl: "http://localhost:5200/agentx",
+ *   headers: { Authorization: "Bearer xxx" },
+ * }));
+ * ```
+ */
+declare function sseRuntime(config: SSERuntimeConfig): Runtime;
+/**
+ * @deprecated Use `sseRuntime()` instead for consistency with `nodeRuntime()`
+ */
+declare const createSSERuntime: typeof sseRuntime;
+
+/**
+ * Client Types
+ *
+ * Type definitions for AgentX client module (browser).
+ */
+/**
+ * Connection state
+ */
+type ConnectionState = "disconnected" | "connecting" | "connected" | "reconnecting" | "error";
+
+export { type ConnectionState as C, type SSERuntimeConfig as S, SSERuntime as a, createSSERuntime as c, sseRuntime as s };

package/dist/types-OVKV6qpE.d.ts

@@ -0,0 +1,118 @@
+import { Runtime, Repository, LoggerFactory, AgentIdResolver, Sandbox, AgentDefinition, AgentContext, RuntimeDriver, Logger } from '@agentxjs/types';
+
+/**
+ * SSERuntime - Browser Runtime implementation
+ *
+ * "Define Once, Run Anywhere"
+ *
+ * Provides Runtime for browser that connects to remote AgentX server via SSE.
+ * Uses the same API as NodeRuntime, enabling unified code across platforms.
+ *
+ * @example
+ * ```typescript
+ * import { createAgentX } from "agentxjs";
+ * import { createSSERuntime } from "agentxjs/client";
+ * import { defineAgent } from "agentxjs";
+ *
+ * const MyAgent = defineAgent({
+ *   name: "Assistant",
+ *   systemPrompt: "You are a helpful assistant",
+ * });
+ *
+ * // Browser: connect to remote server
+ * const runtime = createSSERuntime({ serverUrl: "http://localhost:5200/agentx" });
+ * const agentx = createAgentX(runtime);
+ * const agent = agentx.agents.create(MyAgent);
+ *
+ * // Same API as server-side!
+ * agent.on("assistant_message", (event) => {
+ *   console.log(event.data.content);
+ * });
+ *
+ * await agent.receive("Hello!");
+ * ```
+ */
+
+/**
+ * SSERuntime configuration
+ */
+interface SSERuntimeConfig {
+    /**
+     * Server base URL (e.g., "http://localhost:5200/agentx")
+     */
+    serverUrl: string;
+    /**
+     * Optional request headers (for auth, etc.)
+     * Note: These headers are used for HTTP requests (POST, DELETE, etc.)
+     * but NOT for SSE connections (EventSource doesn't support headers).
+     * For SSE auth, use sseParams to pass token via query string.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Optional query parameters to append to SSE URL.
+     * Use this for authentication since EventSource doesn't support headers.
+     *
+     * @example
+     * ```typescript
+     * createSSERuntime({
+     *   serverUrl: "http://localhost:5200/agentx",
+     *   headers: { Authorization: "Bearer xxx" }, // For HTTP requests
+     *   sseParams: { token: "xxx" }, // For SSE connections
+     * });
+     * ```
+     */
+    sseParams?: Record<string, string>;
+}
+/**
+ * SSERuntime - Runtime for browser with SSE driver
+ *
+ * Connects to remote AgentX server via SSE.
+ * All resources (LLM, etc.) are provided by the server.
+ *
+ * Uses RemoteContainer which calls server POST /agents to create agents.
+ * This ensures browser and server use the same agentId.
+ */
+declare class SSERuntime implements Runtime {
+    readonly name = "sse";
+    readonly repository: Repository;
+    readonly loggerFactory: LoggerFactory;
+    readonly agentIdResolver: AgentIdResolver;
+    private readonly serverUrl;
+    private readonly headers;
+    private readonly sseParams;
+    constructor(config: SSERuntimeConfig);
+    createSandbox(_containerId: string): Sandbox;
+    createDriver(_definition: AgentDefinition, context: AgentContext, _sandbox: Sandbox): RuntimeDriver;
+    createLogger(name: string): Logger;
+}
+/**
+ * Create SSE Runtime for browser
+ *
+ * @example
+ * ```typescript
+ * import { createAgentX } from "agentxjs";
+ * import { sseRuntime } from "agentxjs/runtime/sse";
+ *
+ * createAgentX(sseRuntime({
+ *   serverUrl: "http://localhost:5200/agentx",
+ *   headers: { Authorization: "Bearer xxx" },
+ * }));
+ * ```
+ */
+declare function sseRuntime(config: SSERuntimeConfig): Runtime;
+/**
+ * @deprecated Use `sseRuntime()` instead for consistency with `nodeRuntime()`
+ */
+declare const createSSERuntime: typeof sseRuntime;
+
+/**
+ * Client Types
+ *
+ * Type definitions for AgentX client module (browser).
+ */
+/**
+ * Connection state
+ */
+type ConnectionState = "disconnected" | "connecting" | "connected" | "reconnecting" | "error";
+
+export { type ConnectionState as C, type SSERuntimeConfig as S, SSERuntime as a, createSSERuntime as c, sseRuntime as s };

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "agentxjs",
+  "version": "0.0.1",
+  "description": "Define, Run, Scale AI Agents - The Open Source Agent Platform",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./client": {
+      "types": "./dist/runtime/sse/index.d.ts",
+      "import": "./dist/runtime/sse/index.js",
+      "require": "./dist/runtime/sse/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "require": "./dist/server/index.cjs"
+    },
+    "./server/adapters": {
+      "types": "./dist/server/adapters/index.d.ts",
+      "import": "./dist/server/adapters/index.js",
+      "require": "./dist/server/adapters/index.cjs"
+    },
+    "./server/adapters/express": {
+      "types": "./dist/server/adapters/express.d.ts",
+      "import": "./dist/server/adapters/express.js",
+      "require": "./dist/server/adapters/express.cjs"
+    },
+    "./server/adapters/hono": {
+      "types": "./dist/server/adapters/hono.d.ts",
+      "import": "./dist/server/adapters/hono.js",
+      "require": "./dist/server/adapters/hono.cjs"
+    },
+    "./server/adapters/next": {
+      "types": "./dist/server/adapters/next.d.ts",
+      "import": "./dist/server/adapters/next.js",
+      "require": "./dist/server/adapters/next.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ky": "^1.14.0",
+    "rxjs": "^7.8.2",
+    "@agentxjs/agent": "0.1.0",
+    "@agentxjs/types": "0.0.1",
+    "@agentxjs/engine": "0.1.0",
+    "@agentxjs/common": "0.1.0"
+  },
+  "devDependencies": {
+    "@deepracticex/vitest-cucumber": "^1.4.3",
+    "@types/node": "^24.9.2",
+    "@vitest/ui": "^3.2.4",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist test-results",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui"
+  }
+}