10xgraph-client 0.0.0-stage → 0.6.0

package/dist/message.d.ts

@@ -0,0 +1,174 @@
+export declare class MediaRef {
+    kind: 'url' | 'file_id' | 'data';
+    url?: string;
+    file_id?: string;
+    data_base64?: string;
+    mime_type?: string;
+    size_bytes?: number;
+    sha256?: string;
+    filename?: string;
+    width?: number;
+    height?: number;
+    duration_ms?: number;
+    page?: number;
+    constructor(kind?: 'url' | 'file_id' | 'data', url?: string, file_id?: string, data_base64?: string, mime_type?: string, size_bytes?: number, sha256?: string, filename?: string, width?: number, height?: number, duration_ms?: number, page?: number);
+}
+export declare class AnnotationRef {
+    url?: string;
+    file_id?: string;
+    page?: number;
+    index?: number;
+    title?: string;
+    constructor(url?: string, file_id?: string, page?: number, index?: number, title?: string);
+}
+export declare class TextBlock {
+    type: 'text';
+    text: string;
+    annotations: AnnotationRef[];
+    constructor(text?: string, annotations?: AnnotationRef[]);
+}
+export declare class ImageBlock {
+    type: 'image';
+    media: MediaRef;
+    alt_text?: string;
+    bbox?: number[];
+    constructor(media?: MediaRef, alt_text?: string, bbox?: number[]);
+}
+export declare class AudioBlock {
+    type: 'audio';
+    media: MediaRef;
+    transcript?: string;
+    sample_rate?: number;
+    channels?: number;
+    constructor(media?: MediaRef, transcript?: string, sample_rate?: number, channels?: number);
+}
+export declare class VideoBlock {
+    type: 'video';
+    media: MediaRef;
+    thumbnail?: MediaRef;
+    constructor(media?: MediaRef, thumbnail?: MediaRef);
+}
+export declare class DocumentBlock {
+    type: 'document';
+    media: MediaRef;
+    pages?: number[];
+    excerpt?: string;
+    constructor(media?: MediaRef, pages?: number[], excerpt?: string);
+}
+export declare class DataBlock {
+    type: 'data';
+    mime_type: string;
+    data_base64?: string;
+    media?: MediaRef;
+    constructor(mime_type?: string, data_base64?: string, media?: MediaRef);
+}
+export declare class ToolCallBlock {
+    type: 'tool_call';
+    id: string;
+    name: string;
+    args: Record<string, any>;
+    tool_type?: string;
+    constructor(id?: string, name?: string, args?: Record<string, any>, tool_type?: string);
+}
+export declare class RemoteToolCallBlock {
+    type: 'remote_tool_call';
+    id: string;
+    name: string;
+    args: Record<string, any>;
+    tool_type: string;
+    constructor(id?: string, name?: string, args?: Record<string, any>, tool_type?: string);
+}
+export declare class ToolResultBlock {
+    type: 'tool_result';
+    call_id: string;
+    output: any;
+    is_error: boolean;
+    status?: 'completed' | 'failed';
+    constructor(props: {
+        call_id: string;
+        output: any;
+        status: 'completed' | 'failed';
+        is_error: boolean;
+    });
+}
+export declare class ReasoningBlock {
+    type: 'reasoning';
+    summary: string;
+    details?: string[];
+    constructor(summary?: string, details?: string[]);
+}
+export declare class AnnotationBlock {
+    type: 'annotation';
+    kind: 'citation' | 'note';
+    refs: AnnotationRef[];
+    spans?: [number, number][];
+    constructor(kind?: 'citation' | 'note', refs?: AnnotationRef[], spans?: [number, number][]);
+}
+export declare class ErrorBlock {
+    type: 'error';
+    message: string;
+    code?: string;
+    data?: Record<string, any>;
+    constructor(message?: string, code?: string, data?: Record<string, any>);
+}
+export type ContentBlock = TextBlock | ImageBlock | AudioBlock | VideoBlock | DocumentBlock | DataBlock | ToolCallBlock | RemoteToolCallBlock | ToolResultBlock | ReasoningBlock | AnnotationBlock | ErrorBlock;
+export declare class TokenUsages {
+    completion_tokens: number;
+    prompt_tokens: number;
+    total_tokens: number;
+    reasoning_tokens: number;
+    cache_creation_input_tokens: number;
+    cache_read_input_tokens: number;
+    image_tokens?: number;
+    audio_tokens?: number;
+}
+export declare class Message {
+    message_id: string | null;
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: ContentBlock[];
+    delta: boolean;
+    tools_calls?: Record<string, any>[];
+    timestamp: number;
+    metadata: Record<string, any>;
+    usages?: TokenUsages;
+    raw?: Record<string, any>;
+    constructor(role: 'user' | 'assistant' | 'system' | 'tool', content: ContentBlock[], message_id?: string | null);
+    static text_message(content: string, role?: 'user' | 'assistant' | 'system' | 'tool', message_id?: string | null): Message;
+    static tool_message(content: ContentBlock[], message_id?: string | null, meta?: Record<string, any>): Message;
+    text(): string;
+    attach_media(media: MediaRef, as_type: 'image' | 'audio' | 'video' | 'document'): void;
+    /**
+     * Create a message with an image (via URL or base64).
+     *
+     * @example
+     * ```ts
+     * const msg = Message.withImage('Describe this', 'https://example.com/photo.jpg');
+     * const msg2 = Message.withImage('Describe this', 'data:image/png;base64,...');
+     * ```
+     */
+    static withImage(text: string, imageUrl: string, role?: 'user' | 'assistant' | 'system'): Message;
+    /**
+     * Create a message with a file reference (e.g. from uploadFile result).
+     *
+     * @example
+     * ```ts
+     * const upload = await client.uploadFile(pdfFile);
+     * const msg = Message.withFile('Summarize this PDF', upload.data.file_id, 'application/pdf');
+     * ```
+     */
+    static withFile(text: string, fileId: string, mimeType?: string, role?: 'user' | 'assistant' | 'system'): Message;
+    /**
+     * Create a multimodal message with arbitrary content blocks.
+     *
+     * @example
+     * ```ts
+     * const msg = Message.multimodal([
+     *   new TextBlock('Look at these'),
+     *   new ImageBlock(new MediaRef('url', 'https://...')),
+     *   new ImageBlock(new MediaRef('url', 'https://...')),
+     * ]);
+     * ```
+     */
+    static multimodal(blocks: ContentBlock[], role?: 'user' | 'assistant' | 'system'): Message;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/message.d.ts.map

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

package/dist/request.d.ts

@@ -0,0 +1,33 @@
+import type { WebSocketImpl } from './ws.js';
+export interface TenxGraphBearerAuth {
+    type: 'bearer';
+    token: string;
+}
+export interface TenxGraphBasicAuth {
+    type: 'basic';
+    username: string;
+    password: string;
+}
+export interface TenxGraphHeaderAuth {
+    type: 'header';
+    name: string;
+    value: string;
+    prefix?: string | null;
+}
+export type TenxGraphAuth = TenxGraphBearerAuth | TenxGraphBasicAuth | TenxGraphHeaderAuth;
+export interface RequestContext {
+    baseUrl: string;
+    authToken?: string | null;
+    auth?: TenxGraphAuth | null;
+    headers?: HeadersInit;
+    credentials?: RequestCredentials;
+    timeout: number;
+    debug: boolean;
+    webSocketImpl?: WebSocketImpl;
+}
+export declare function buildHeaders(context: Pick<RequestContext, 'authToken' | 'auth' | 'headers'>, defaults?: HeadersInit): Record<string, string>;
+export declare function getRequestCredentials(context: Pick<RequestContext, 'credentials'>): Pick<RequestInit, 'credentials'> | Record<string, never>;
+export declare function bearerAuth(token: string): TenxGraphBearerAuth;
+export declare function basicAuth(username: string, password: string): TenxGraphBasicAuth;
+export declare function headerAuth(name: string, value: string, prefix?: string | null): TenxGraphHeaderAuth;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE3F,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AA8FD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC,EAC/D,QAAQ,CAAC,EAAE,WAAW,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,GAC3C,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAM1D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAE7D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAEhF;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,mBAAmB,CAErB"}

package/dist/tools.d.ts

@@ -0,0 +1,67 @@
+import { Message } from './message.js';
+export interface ToolHandler {
+    (args: any): Promise<any>;
+}
+/**
+ * JSON Schema describing a tool's arguments.
+ *
+ * `properties` and `required` are optional, matching JSON Schema itself: a tool
+ * whose arguments are all optional needs neither, and a tool that takes no
+ * arguments can be declared as `{ type: 'object' }`. Additional JSON Schema
+ * keywords (`additionalProperties`, `$defs`, ...) are passed through untouched.
+ */
+export interface ToolParameter {
+    type: string;
+    properties?: Record<string, any>;
+    required?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Fill in the JSON Schema defaults a tool declaration may leave out, so the
+ * wire format sent to the server is always a complete object schema.
+ */
+export declare function normalizeToolParameters(parameters?: ToolParameter): ToolParameter;
+export interface Tool {
+    type: string;
+    function: {
+        name: string;
+        description: string;
+        parameters: ToolParameter;
+    };
+}
+export interface ToolRegistration {
+    node?: string;
+    name: string;
+    description?: string;
+    parameters?: ToolParameter;
+    handler: ToolHandler;
+}
+export interface ToolDefinition extends ToolHandler {
+    name: string;
+    description?: string;
+    parameters?: ToolParameter;
+    node?: string;
+}
+export declare class ToolExecutor {
+    private tools;
+    private toolsByNode;
+    constructor(tools?: ToolDefinition[]);
+    /**
+     * Register a new tool
+     */
+    registerTool(registration: ToolRegistration): void;
+    /**
+     * Get tools for a specific node
+     */
+    getToolsForNode(node: string): ToolDefinition[];
+    /**
+     * Get all tools in OpenAI-compatible format
+     */
+    all_tools(): Tool[];
+    /**
+     * Extract and execute all tool calls from the response
+     * Returns an array of tool result messages
+     */
+    executeToolCalls(messages: Message[]): Promise<Message[]>;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAwC,MAAM,cAAc,CAAC;AAG7E,MAAM,WAAW,WAAW;IAC1B,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,aAAa,CAUjF;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,aAAa,CAAC;KAC3B,CAAC;CACH;AAGD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;CACtB;AAGD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,WAAW,CAA2C;gBAElD,KAAK,GAAE,cAAc,EAAO;IAiBxC;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI;IAuClD;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAK/C;;OAEG;IACH,SAAS,IAAI,IAAI,EAAE;IAkBnB;;;OAGG;IACG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAgEhE"}

package/dist/ws.d.ts

@@ -0,0 +1,48 @@
+import { TenxGraphAuth } from './request.js';
+/**
+ * Sec-WebSocket-Protocol token the server recognizes for browser-safe bearer auth.
+ * The client opens the socket with `[WS_BEARER_SUBPROTOCOL, "<jwt>"]`; the server
+ * extracts the second protocol entry as the token. This works in browsers (which
+ * cannot set request headers on a WebSocket) and avoids leaking the token in the URL.
+ */
+export declare const WS_BEARER_SUBPROTOCOL = "10xgraph-bearer";
+/** Minimal constructor shape shared by the browser `WebSocket` and the Node `ws` package. */
+export type WebSocketImpl = new (url: string, protocols?: string | string[], options?: unknown) => WebSocket;
+/** The auth/transport fields the WS helpers read from a request context. */
+export interface WsAuthContext {
+    baseUrl: string;
+    authToken?: string | null;
+    auth?: TenxGraphAuth | null;
+    headers?: HeadersInit;
+    credentials?: RequestCredentials;
+    debug?: boolean;
+    /** Optional WebSocket implementation for runtimes without a global (Node < 21). */
+    webSocketImpl?: WebSocketImpl;
+}
+/**
+ * Resolve the bearer token with the same priority as `buildHeaders`.
+ *
+ * `auth` takes precedence over `authToken`, matching the HTTP path. When `auth`
+ * is set to a non-bearer scheme (basic/header) there is no bearer token to send,
+ * so this returns `null` rather than silently falling back to `authToken` — the
+ * HTTP path would not send a bearer in that case either.
+ */
+export declare function resolveBearerToken(context: Pick<WsAuthContext, 'authToken' | 'auth'>): string | null;
+/**
+ * Convert the HTTP base URL to a WebSocket URL and append `path`.
+ * The token is never placed in the URL — it travels via the `10xgraph-bearer`
+ * subprotocol (browser-safe) and, in Node, the Authorization header.
+ */
+export declare function buildWsUrl(context: Pick<WsAuthContext, 'baseUrl'>, path: string): string;
+/**
+ * Open a WebSocket with bearer auth.
+ *
+ * - If a token is present it is sent as the `10xgraph-bearer` subprotocol (works
+ *   in browsers and Node `ws`).
+ * - In Node-style implementations that accept a third `options` argument, the
+ *   Authorization header is also passed (ignored by browsers).
+ * - The implementation is taken from `context.webSocketImpl`, falling back to the
+ *   global `WebSocket`. If neither exists a descriptive error is thrown.
+ */
+export declare function openWebSocket(url: string, context: WsAuthContext): WebSocket;
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgB,MAAM,cAAc,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AAEvD,6FAA6F;AAC7F,MAAM,MAAM,aAAa,GAAG,KAC1B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EAC7B,OAAO,CAAC,EAAE,OAAO,KACd,SAAS,CAAC;AAEf,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mFAAmF;IACnF,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,MAAM,CAAC,GACjD,MAAM,GAAG,IAAI,CAQf;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,CA0B5E"}

package/package.json

@@ -1,6 +1,101 @@
 {
   "name": "10xgraph-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.6.0",
+  "description": "TypeScript client for the 10xGraph API server: invoke and stream agent graphs, manage threads, memory and files, run client-side tools, and realtime audio. Formerly @10xscale/agentflow-client.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.build.json && vite build",
+    "clean": "rimraf dist",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --max-warnings 253",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui",
+    "coverage": "vitest run --coverage",
+    "coverage:open": "vitest run --coverage && xdg-open coverage/index.html",
+    "check": "npm run lint && npm run typecheck && npm run test:run",
+    "prepublishOnly": "npm run check && npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/10xGraph/10xgraph-client.git"
+  },
+  "bugs": {
+    "url": "https://github.com/10xGraph/10xgraph-client/issues"
+  },
+  "homepage": "https://10xgraph.com",
+  "devDependencies": {
+    "@eslint/js": "^9.13.0",
+    "@vitest/coverage-v8": "^3.2.7",
+    "@vitest/ui": "^3.2.7",
+    "eslint": "^9.13.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "^3.3.0",
+    "rimraf": "^6.0.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.11.0",
+    "vite": "^7.3.6",
+    "vitest": "^3.2.7"
+  },
+  "keywords": [
+    "10xgraph",
+    "10xscale",
+    "agentflow",
+    "ai-agents",
+    "multi-agent",
+    "agent",
+    "llm",
+    "typescript",
+    "api-client",
+    "sdk",
+    "streaming",
+    "sse",
+    "websocket",
+    "realtime-audio",
+    "client-side-tools",
+    "remote-tools",
+    "threads",
+    "memory",
+    "react",
+    "nodejs"
+  ],
+  "author": "Shudipto Trafder <shudiptotrafder@gmail.com>",
+  "contributors": [
+    {
+      "name": "10xGraph",
+      "url": "https://github.com/10xGraph"
+    }
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/agent.ts

@@ -0,0 +1,43 @@
+import { Message } from './message.js';
+
+// Define ExecutionMeta interface
+interface ExecutionMeta {
+  current_node: string;
+  step: number;
+  interrupt?: {
+    node: string;
+    reason: string;
+    status: string;
+    data?: Record<string, any>;
+  };
+  is_running: boolean;
+  is_interrupted: boolean;
+  is_stopped_requested: boolean;
+}
+
+// Define default ExecutionMeta implementation
+class DefaultExecutionMeta implements ExecutionMeta {
+  current_node: string = 'START';
+  step: number = 0;
+  is_running: boolean = true;
+  is_interrupted: boolean = false;
+  is_stopped_requested: boolean = false;
+
+  interrupt?: {
+    node: string;
+    reason: string;
+    status: string;
+    data?: Record<string, any>;
+  };
+}
+
+// Define AgentState class
+export class AgentState {
+  context: Message[] = [];
+  context_summary: string | null = null;
+  execution_meta: ExecutionMeta = new DefaultExecutionMeta();
+
+  constructor(initialData: Partial<Record<string, any>> = {}) {
+    Object.assign(this, initialData);
+  }
+}