@artinet/cruiser 0.1.5 → 0.1.6

package/dist/openclaw/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview openclaw → artinet
+ *
+ * @module @artinet/cruiser/openclaw
+ * @description
+ * This adapter "docks" OpenClaw Gateway agents into artinet.
+ */
+import { Dock, Park } from '../corsair.js';
+import { type OpenClawAgent } from './utils.js';
+/**
+ * Configuration options for OpenClaw Gateway WebSocket calls.
+ */
+export type OpenClawDockOptions = {
+    /**
+     * Timeout for WS connect handshake in milliseconds.
+     */
+    connectTimeoutMs?: number;
+    /**
+     * Timeout for gateway request completion in milliseconds.
+     */
+    timeoutMs?: number;
+};
+/**
+ * @deprecated Use {@link OpenClawDockOptions} instead.
+ */
+export type OpenClawParkOptions = OpenClawDockOptions;
+/**
+ * Docks an OpenClaw Gateway agent into artinet.
+ *
+ * This adapter uses OpenClaw's native Gateway WebSocket protocol.
+ *
+ * OpenClaw docs:
+ * https://docs.openclaw.ai/gateway/protocol
+ */
+export declare const dock: Dock<OpenClawAgent, OpenClawDockOptions>;
+/**
+ * @deprecated Use {@link dock} instead.
+ */
+export declare const park: Park<OpenClawAgent, OpenClawDockOptions>;
+export type { OpenClawAgent } from './utils.js';

package/dist/openclaw/index.js

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview openclaw → artinet
+ *
+ * @module @artinet/cruiser/openclaw
+ * @description
+ * This adapter "docks" OpenClaw Gateway agents into artinet.
+ */
+import * as sdk from '@artinet/sdk';
+import { OpenClawGatewayClient } from './client.js';
+import { extractOpenClawText, getAgentCard } from './utils.js';
+/**
+ * Docks an OpenClaw Gateway agent into artinet.
+ *
+ * This adapter uses OpenClaw's native Gateway WebSocket protocol.
+ *
+ * OpenClaw docs:
+ * https://docs.openclaw.ai/gateway/protocol
+ */
+export const dock = async function dock(agent, card, options) {
+    const agentCard = await getAgentCard({ agent, card });
+    const gatewayUrl = (agent.gatewayUrl ?? 'ws://127.0.0.1:18789').replace(/\/+$/, '');
+    const agentId = agent.agentId ?? 'main';
+    const connectTimeoutMs = options?.connectTimeoutMs && options.connectTimeoutMs > 0 ? options.connectTimeoutMs : 10_000;
+    const requestTimeoutMs = options?.timeoutMs && options.timeoutMs > 0 ? options.timeoutMs : 60_000;
+    const gateway = new OpenClawGatewayClient({
+        url: gatewayUrl,
+        authToken: agent.authToken,
+        authPassword: agent.authPassword,
+        agent,
+        device: agent.device,
+        scopes: agent.scopes,
+        connectTimeoutMs,
+    });
+    await gateway.ensureConnected();
+    sdk.logger.debug(`OpenClaw[${agentCard.name}]:[card:${JSON.stringify(agentCard)}]`);
+    return sdk.cr8(agentCard).from(async function* (context) {
+        sdk.logger.debug(`OpenClaw[${agentCard.name}]:[context:${context.contextId}]: starting`);
+        const task = await context.getTask();
+        const text = sdk.extractTextContent(context.userMessage);
+        if (!text || text.trim().length === 0) {
+            yield sdk.describe.update.failed({
+                taskId: context.taskId,
+                contextId: context.contextId,
+                message: sdk.describe.message({
+                    taskId: context.taskId,
+                    contextId: context.contextId,
+                    parts: [sdk.describe.part.text('no input text detected')],
+                }),
+            });
+            return;
+        }
+        try {
+            const result = await gateway.requestAgentRun({
+                message: text,
+                agentId,
+                sessionKey: agent.sessionKey ?? context.contextId,
+                timeoutMs: requestTimeoutMs,
+            });
+            const responseText = extractOpenClawText(result);
+            const message = sdk.describe.message({
+                taskId: context.taskId,
+                contextId: context.contextId,
+                parts: [sdk.describe.part.text(responseText)],
+            });
+            yield sdk.describe.update.completed({
+                taskId: context.taskId,
+                contextId: context.contextId,
+                message,
+                metadata: {
+                    ...(task.metadata ?? {}),
+                    result,
+                },
+            });
+        }
+        catch (error) {
+            sdk.logger.error('OpenClaw execution failed', error);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            yield sdk.describe.update.failed({
+                taskId: context.taskId,
+                contextId: context.contextId,
+                message: sdk.describe.message({
+                    taskId: context.taskId,
+                    contextId: context.contextId,
+                    parts: [sdk.describe.part.text(`error invoking OpenClaw agent: ${errorMessage}`)],
+                    metadata: {
+                        ...(task.metadata ?? {}),
+                        error: errorMessage,
+                    },
+                }),
+            });
+        }
+    });
+};
+/**
+ * @deprecated Use {@link dock} instead.
+ */
+export const park = dock;

package/dist/openclaw/utils.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview openclaw → artinet utils
+ *
+ * @module @artinet/cruiser/openclaw/utils
+ * @internal
+ */
+import * as sdk from "@artinet/sdk";
+export type OpenClawTool = {
+    name: string;
+    description?: string;
+};
+export type OpenClawDeviceIdentity = {
+    id: string;
+    publicKey: string;
+    privateKeyPem?: string;
+    signature?: string;
+    signedAt?: number;
+    nonce?: string;
+};
+export type OpenClawAgent = {
+    /**
+     * A2A card display name.
+     */
+    name: string;
+    /**
+     * Gateway base URL, e.g. http://127.0.0.1:18789
+     */
+    gatewayUrl?: string;
+    /**
+     * OpenClaw agent id. Defaults to "main".
+     */
+    agentId?: string;
+    /**
+     * Gateway auth token (token mode).
+     */
+    authToken?: string;
+    /**
+     * Gateway auth password (password mode).
+     */
+    authPassword?: string;
+    /**
+     * Optional fixed session key routed by OpenClaw gateway.
+     */
+    sessionKey?: string;
+    /**
+     * Optional explicit device identity for strict pairing setups.
+     */
+    device?: OpenClawDeviceIdentity;
+    /**
+     * Optional path where cruiser stores generated OpenClaw device auth state.
+     * Defaults to ~/artinet-openclaw.auth when auto device auth is enabled.
+     */
+    authFilePath?: string;
+    /**
+     * Enables automatic device identity bootstrap + persisted device token usage.
+     * Defaults to true.
+     */
+    autoDeviceAuth?: boolean;
+    /**
+     * Optional custom scopes passed during gateway connect.
+     */
+    scopes?: string[];
+    description?: string;
+    tools?: OpenClawTool[];
+};
+export declare function getAgentCard({ agent, card, }: {
+    agent: OpenClawAgent;
+    card?: sdk.A2A.AgentCardParams;
+}): Promise<sdk.A2A.AgentCard>;
+export declare function extractOpenClawText(result: OpenClawResult): string;
+export type OpenClawResult = Record<string, unknown>;

package/dist/openclaw/utils.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview openclaw → artinet utils
+ *
+ * @module @artinet/cruiser/openclaw/utils
+ * @internal
+ */
+import * as sdk from "@artinet/sdk";
+function createSkills(tools) {
+    return (tools?.map((tool) => ({
+        id: tool.name,
+        name: tool.name,
+        description: tool.description ?? `Tool: ${tool.name}`,
+        tags: ["tool"],
+    })) ?? []);
+}
+function createDescription(agent) {
+    if (agent.description && agent.description.trim().length > 0) {
+        return agent.description.trim();
+    }
+    return "An OpenClaw Gateway agent connected through @artinet/cruiser";
+}
+export async function getAgentCard({ agent, card, }) {
+    return sdk.describe.card({
+        name: agent.name,
+        ...(typeof card === "string" ? { name: card } : card),
+        description: createDescription(agent),
+        capabilities: {
+            streaming: true,
+            pushNotifications: true,
+            stateTransitionHistory: false,
+        },
+        defaultInputModes: ["text"],
+        defaultOutputModes: ["text"],
+        skills: createSkills(agent.tools),
+    });
+}
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}
+export function extractOpenClawText(result) {
+    const record = asRecord(result);
+    if (!record) {
+        return "";
+    }
+    const payloads = record.payloads;
+    if (Array.isArray(payloads)) {
+        const text = payloads
+            .map((payload) => {
+            const entry = asRecord(payload);
+            if (typeof entry?.text === "string") {
+                return entry.text;
+            }
+            return "";
+        })
+            .filter((item) => item.length > 0)
+            .join("\n")
+            .trim();
+        if (text.length > 0) {
+            return text;
+        }
+    }
+    const choices = record.choices;
+    if (!Array.isArray(choices) || choices.length === 0) {
+        return "";
+    }
+    const firstChoice = asRecord(choices[0]);
+    const message = asRecord(firstChoice?.message);
+    const content = message?.content;
+    if (typeof content === "string") {
+        return content;
+    }
+    if (Array.isArray(content)) {
+        return content
+            .map((part) => {
+            if (typeof part === "string") {
+                return part;
+            }
+            const partRecord = asRecord(part);
+            if (typeof partRecord?.text === "string") {
+                return partRecord.text;
+            }
+            return JSON.stringify(part);
+        })
+            .join("\n");
+    }
+    return "";
+}

package/package.json

@@ -1,142 +1,148 @@
 {
-  "name": "@artinet/cruiser",
-  "version": "0.1.5",
-  "description": "A library for building A2A enabled runtime Agents.",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+    "name": "@artinet/cruiser",
+    "version": "0.1.6",
+    "description": "A library for building A2A enabled runtime Agents.",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        },
+        "./mastra": {
+            "types": "./dist/mastra/index.d.ts",
+            "import": "./dist/mastra/index.js",
+            "default": "./dist/mastra/index.js"
+        },
+        "./langchain": {
+            "types": "./dist/langchain/index.d.ts",
+            "import": "./dist/langchain/index.js",
+            "default": "./dist/langchain/index.js"
+        },
+        "./claude": {
+            "types": "./dist/claude/index.d.ts",
+            "import": "./dist/claude/index.js",
+            "default": "./dist/claude/index.js"
+        },
+        "./openai": {
+            "types": "./dist/openai/index.d.ts",
+            "import": "./dist/openai/index.js",
+            "default": "./dist/openai/index.js"
+        },
+        "./strands": {
+            "types": "./dist/strands/index.d.ts",
+            "import": "./dist/strands/index.js",
+            "default": "./dist/strands/index.js"
+        },
+        "./openclaw": {
+            "types": "./dist/openclaw/index.d.ts",
+            "import": "./dist/openclaw/index.js",
+            "default": "./dist/openclaw/index.js"
+        }
     },
-    "./mastra": {
-      "types": "./dist/mastra/index.d.ts",
-      "import": "./dist/mastra/index.js",
-      "default": "./dist/mastra/index.js"
+    "rootDir": ".",
+    "files": [
+        "dist",
+        "package.json",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "tsc --project tsconfig.json",
+        "clean": "rimraf dist",
+        "rebuild": "rimraf dist node_modules/ package-lock.json && npm i && npm run build",
+        "lint": "eslint src --ext .ts",
+        "package-test": "npm run build && npm pack && sync && sleep 1 && docker build -f ./deployment/test.dockerfile -t cruiser-test . && docker run --env-file .env --rm cruiser-test && rm artinet-cruiser-*.tgz",
+        "prepublishOnly": "rimraf dist && npm run build && npm run lint && npm test",
+        "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+        "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
+        "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage"
     },
-    "./langchain": {
-      "types": "./dist/langchain/index.d.ts",
-      "import": "./dist/langchain/index.js",
-      "default": "./dist/langchain/index.js"
+    "keywords": [
+        "agent2agent",
+        "a2a",
+        "artinet",
+        "ai",
+        "agent",
+        "artificial intelligence",
+        "mastra",
+        "langchain",
+        "claude",
+        "openai",
+        "strands",
+        "openclaw"
+    ],
+    "author": "artinet",
+    "license": "Apache-2.0",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/the-artinet-project/artinet.git"
     },
-    "./claude": {
-      "types": "./dist/claude/index.d.ts",
-      "import": "./dist/claude/index.js",
-      "default": "./dist/claude/index.js"
+    "bugs": {
+        "url": "https://github.com/the-artinet-project/artinet/issues"
     },
-    "./openai": {
-      "types": "./dist/openai/index.d.ts",
-      "import": "./dist/openai/index.js",
-      "default": "./dist/openai/index.js"
+    "homepage": "https://artinet.io",
+    "dependencies": {
+        "@artinet/sdk": "^0.6.4",
+        "@artinet/types": "^0.1.4",
+        "uuid": "^13.0.0"
     },
-    "./strands": {
-      "types": "./dist/strands/index.d.ts",
-      "import": "./dist/strands/index.js",
-      "default": "./dist/strands/index.js"
-    }
-  },
-  "rootDir": ".",
-  "files": [
-    "dist",
-    "package.json",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsc --project tsconfig.json",
-    "clean": "rimraf dist",
-    "rebuild": "rimraf dist node_modules/ package-lock.json && npm i && npm run build",
-    "lint": "eslint src --ext .ts",
-    "package-test": "npm run build && npm pack && sync && sleep 1 && docker build -f ./deployment/test.dockerfile -t cruiser-test . && docker run --env-file .env --rm cruiser-test && rm artinet-cruiser-*.tgz",
-    "prepublishOnly": "rimraf dist && npm run build && npm run lint && npm test",
-    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
-    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
-    "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage"
-  },
-  "keywords": [
-    "agent2agent",
-    "a2a",
-    "artinet",
-    "ai",
-    "agent",
-    "artificial intelligence",
-    "mastra",
-    "langchain",
-    "claude",
-    "openai",
-    "strands"
-  ],
-  "author": "artinet",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/the-artinet-project/artinet.git"
-  },
-  "bugs": {
-    "url": "https://github.com/the-artinet-project/artinet/issues"
-  },
-  "homepage": "https://artinet.io",
-  "dependencies": {
-    "@artinet/sdk": "^0.6.4",
-    "@artinet/types": "^0.1.4",
-    "uuid": "^13.0.0"
-  },
-  "peerDependencies": {
-    "@a2a-js/sdk": "^0.3.7",
-    "@anthropic-ai/claude-agent-sdk": "^0.2.2",
-    "@anthropic-ai/sdk": "^0.71.2",
-    "@mastra/core": "^0.24.9",
-    "@mastra/server": "^0.24.9",
-    "@modelcontextprotocol/sdk": "^1.24.3",
-    "@strands-agents/sdk": "^0.1.4",
-    "express": "^5.1.0",
-    "langchain": "^1.2.7",
-    "openai": "^6.15.0"
-  },
-  "peerDependenciesMeta": {
-    "@a2a-js/sdk": {
-      "optional": false
+    "peerDependencies": {
+        "@a2a-js/sdk": "^0.3.7",
+        "@anthropic-ai/claude-agent-sdk": "^0.2.2",
+        "@anthropic-ai/sdk": "^0.71.2",
+        "@mastra/core": "^0.24.9",
+        "@mastra/server": "^0.24.9",
+        "@modelcontextprotocol/sdk": "^1.24.3",
+        "@strands-agents/sdk": "^0.1.4",
+        "express": "^5.1.0",
+        "langchain": "^1.2.7",
+        "openai": "^6.15.0"
+    },
+    "peerDependenciesMeta": {
+        "@a2a-js/sdk": {
+            "optional": false
+        },
+        "express": {
+            "optional": false
+        },
+        "@modelcontextprotocol/sdk": {
+            "optional": false
+        }
+    },
+    "devDependencies": {
+        "@openrouter/ai-sdk-provider": "^1.5.4",
+        "@a2a-js/sdk": "^0.3.7",
+        "@anthropic-ai/claude-agent-sdk": "^0.2.2",
+        "@anthropic-ai/sdk": "^0.71.2",
+        "@eslint/js": "^9.39.2",
+        "@langchain/openai": "^1.2.1",
+        "@mastra/core": "^1.4.0",
+        "@mastra/server": "^1.4.0",
+        "@openai/agents": "^0.3.7",
+        "@strands-agents/sdk": "^0.1.4",
+        "@types/jest": "^29.5.14",
+        "@types/node": "^25.0.9",
+        "@types/uuid": "^10.0.0",
+        "ai": "^5.0.10",
+        "eslint": "^9.39.2",
+        "globals": "^17.0.0",
+        "jest": "29.7.0",
+        "langchain": "^1.2.10",
+        "rimraf": "^6.1.2",
+        "ts-jest": "^29.4.6",
+        "ts-node": "^10.9.2",
+        "tsx": "^4.21.0",
+        "typescript": "^5.9.3",
+        "typescript-eslint": "^8.53.0"
     },
-    "express": {
-      "optional": false
+    "engines": {
+        "node": ">=20.0.0"
     },
-    "@modelcontextprotocol/sdk": {
-      "optional": false
+    "directories": {
+        "test": "tests"
     }
-  },
-  "devDependencies": {
-    "@openrouter/ai-sdk-provider": "^1.5.4",
-    "@a2a-js/sdk": "^0.3.7",
-    "@anthropic-ai/claude-agent-sdk": "^0.2.2",
-    "@anthropic-ai/sdk": "^0.71.2",
-    "@eslint/js": "^9.39.2",
-    "@langchain/openai": "^1.2.1",
-    "@mastra/core": "^0.24.9",
-    "@mastra/server": "^2.0.4",
-    "@openai/agents": "^0.3.7",
-    "@strands-agents/sdk": "^0.1.4",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^25.0.9",
-    "@types/uuid": "^10.0.0",
-    "ai": "^5.0.10",
-    "eslint": "^9.39.2",
-    "globals": "^17.0.0",
-    "jest": "29.7.0",
-    "langchain": "^1.2.10",
-    "rimraf": "^6.1.2",
-    "ts-jest": "^29.4.6",
-    "ts-node": "^10.9.2",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.53.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "directories": {
-    "test": "tests"
-  }
 }