@phantom/phantom-openclaw-plugin 0.2.0 → 0.2.2

package/README.md

@@ -69,6 +69,7 @@ See [Prerequisites](#prerequisites) below for detailed setup instructions.
 - **Automatic Authentication**: Handles OAuth flow and session management automatically
 - **Type-Safe**: Full TypeScript support with proper type definitions
 - **Simple Setup**: Minimal configuration - just enable the plugin and use
+- **Perpetuals Trading**: Full Hyperliquid perps support — swap and deposit funds, manage positions, and trade perpetuals
 
 ## Prerequisites
 
@@ -354,6 +355,142 @@ Fetch a swap quote from Phantom's routing engine. Supports same-chain Solana, sa
 
 **⚠️ Warning:** When `execute: true`, this tool submits transactions immediately and irreversibly.
 
+---
+
+### Perpetuals Tools (Hyperliquid)
+
+The plugin exposes 12 tools for perpetuals trading on Hyperliquid via Phantom's backend. All signing uses the wallet's EVM key (Arbitrum EIP-712).
+
+#### Read-only
+
+##### `get_perp_account`
+
+Returns perp account balance: `accountValue`, `availableBalance`, `availableToTrade`.
+
+**Parameters:** `walletId` (optional), `derivationIndex` (optional, default 0)
+
+##### `get_perp_markets`
+
+Returns all available perpetual markets with current price, funding rate, open interest, 24h volume, and max leverage.
+
+**Parameters:** `walletId` (optional)
+
+##### `get_perp_positions`
+
+Returns all open positions with direction, size, entry price, leverage, unrealized PnL, and liquidation price.
+
+**Parameters:** `walletId` (optional), `derivationIndex` (optional, default 0)
+
+##### `get_perp_orders`
+
+Returns all open orders (limit, take-profit, stop-loss) with order ID, type, price, size, and reduce-only flag.
+
+**Parameters:** `walletId` (optional), `derivationIndex` (optional, default 0)
+
+##### `get_perp_trade_history`
+
+Returns historical trades with price, size, trade value, fee, and closed PnL.
+
+**Parameters:** `walletId` (optional), `derivationIndex` (optional, default 0)
+
+#### Write
+
+##### `deposit_to_hyperliquid`
+
+Swaps tokens to USDC via Phantom's routing engine and transfers the USDC into the Hyperliquid perp account.
+
+**Parameters:**
+
+- `sourceChainId` (string, required): Source chain — `"solana:mainnet"`, `"eip155:42161"`, `"eip155:8453"`, `"eip155:1"`, or `"eip155:137"`
+- `amount` (string, required): Amount to deposit in human-readable units
+- `tokenAddress` (string, optional): ERC-20/SPL token address — omit for native SOL or default USDC per chain
+- `walletId` (string, optional), `derivationIndex` (number, optional, default 0)
+
+**⚠️ Warning:** Submits transactions immediately and irreversibly.
+
+##### `open_perp_position`
+
+Opens a perpetual position. Market orders use 10% slippage (IOC). Limit orders rest on the book (GTC).
+
+**Parameters:**
+
+- `market` (string, required): Market symbol (e.g. `"BTC"`, `"ETH"`, `"SOL"`)
+- `direction` (string, required): `"long"` or `"short"`
+- `sizeUsd` (string, required): Notional position size in USD (e.g. `"500"`)
+- `leverage` (number, required): Leverage multiplier (e.g. `10` for 10x)
+- `orderType` (string, required): `"market"` or `"limit"`
+- `limitPrice` (string, optional): Required for limit orders
+- `reduceOnly` (boolean, optional): Default false
+- `walletId` (string, optional), `derivationIndex` (number, optional, default 0)
+
+**⚠️ Warning:** Submits transactions immediately and irreversibly.
+
+##### `close_perp_position`
+
+Closes an open position using a market IOC order. Defaults to 100% close.
+
+**Parameters:**
+
+- `market` (string, required): Market symbol (e.g. `"BTC"`)
+- `sizePercent` (number, optional): Percentage to close (1–100, default 100)
+- `walletId` (string, optional), `derivationIndex` (number, optional, default 0)
+
+**⚠️ Warning:** Submits transactions immediately and irreversibly.
+
+##### `cancel_perp_order`
+
+Cancels an open order by ID. Use `get_perp_orders` to retrieve order IDs.
+
+**Parameters:**
+
+- `market` (string, required): Market symbol
+- `orderId` (number, required): Order ID from `get_perp_orders`
+- `walletId` (string, optional), `derivationIndex` (number, optional, default 0)
+
+##### `update_perp_leverage`
+
+Updates leverage and margin type for a market. Takes effect on new orders.
+
+**Parameters:**
+
+- `market` (string, required): Market symbol
+- `leverage` (number, required): New leverage multiplier
+- `marginType` (string, required): `"isolated"` or `"cross"`
+- `walletId` (string, optional), `derivationIndex` (number, optional, default 0)
+
+##### `transfer_spot_to_perps`
+
+Moves USDC **within Hypercore** from the spot account to the perp account. Use when USDC is already on Hyperliquid. Does not bridge from external chains.
+
+**Parameters:**
+
+- `amountUsdc` (string, required): Amount of USDC to transfer
+- `walletId` (string, optional), `derivationIndex` (number, optional, default 0)
+
+##### `withdraw_from_perps`
+
+Moves USDC from the perp account back to the Hyperliquid spot account.
+
+**Parameters:**
+
+- `amountUsdc` (string, required): Amount of USDC to withdraw
+- `walletId` (string, optional), `derivationIndex` (number, optional, default 0)
+
+#### Typical Agent Workflow
+
+```text
+1. get_perp_markets          → find market, check price
+2. get_token_balances        → verify USDC balance on source chain
+3. deposit_to_hyperliquid    → swap to USDC and deposit to perp account
+4. get_perp_account          → confirm balance in perp account
+5. open_perp_position        → open long at 10x leverage
+6. get_perp_positions        → monitor position
+7. close_perp_position       → close when done
+8. withdraw_from_perps       → move USDC back to spot
+```
+
+---
+
 ## Network IDs Reference
 
 Network identifiers follow the CAIP-2/CAIP-10 format. Here are the supported networks:

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * OpenClaw Plugin API types
+ */
+/**
+ * OpenClaw Plugin API interface
+ */
+type OpenClawApi = {
+    /** OpenClaw config payload (can be full openclaw.json, not only plugin-scoped config) */
+    config?: Record<string, unknown>;
+    /** Register a tool with OpenClaw */
+    registerTool: (definition: {
+        name: string;
+        description: string;
+        parameters: unknown;
+        execute: (id: string, params: Record<string, unknown>) => Promise<{
+            content: unknown;
+            isError?: boolean;
+        }>;
+    }) => void;
+};
+
+/**
+ * Phantom OpenClaw Plugin
+ *
+ * Integrates Phantom wallet operations directly with OpenClaw agents
+ * by wrapping the Phantom MCP Server tools.
+ */
+
+/**
+ * Plugin registration function
+ */
+declare function register(api: OpenClawApi): Promise<void>;
+
+export { register as default };

package/dist/index.js

@@ -0,0 +1,453 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  default: () => register
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/session.ts
+var import_mcp_server = require("@phantom/mcp-server");
+var PluginSession = class {
+  constructor(options = {}) {
+    this.initialized = false;
+    this.initializingPromise = null;
+    this.sessionManager = new import_mcp_server.SessionManager({
+      appId: options.appId ?? "phantom-openclaw",
+      callbackPort: options.callbackPort,
+      sessionDir: options.sessionDir
+    });
+  }
+  /**
+   * Initialize the session (authenticate if needed)
+   * Thread-safe: concurrent calls will await the same initialization promise
+   */
+  async initialize() {
+    if (this.initialized) {
+      return;
+    }
+    if (this.initializingPromise) {
+      return this.initializingPromise;
+    }
+    this.initializingPromise = this.sessionManager.initialize().then(() => {
+      this.initialized = true;
+    }).catch((error) => {
+      this.initializingPromise = null;
+      throw error;
+    });
+    return this.initializingPromise;
+  }
+  /**
+   * Get the authenticated PhantomClient
+   */
+  getClient() {
+    if (!this.initialized) {
+      throw new Error("Session not initialized. Call initialize() first.");
+    }
+    return this.sessionManager.getClient();
+  }
+  /**
+   * Get the current session data
+   */
+  getSession() {
+    if (!this.initialized) {
+      throw new Error("Session not initialized. Call initialize() first.");
+    }
+    return this.sessionManager.getSession();
+  }
+};
+
+// src/tools/register-tools.ts
+var import_typebox = require("@sinclair/typebox");
+var import_mcp_server2 = require("@phantom/mcp-server");
+var SCHEMA_OPTION_KEYS = ["description", "title", "default"];
+var JSON_SCHEMA_TYPES = [
+  "string",
+  "number",
+  "integer",
+  "boolean",
+  "null",
+  "object",
+  "array"
+];
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function isJsonSchemaType(value) {
+  return typeof value === "string" && JSON_SCHEMA_TYPES.includes(value);
+}
+function pickOptions(schema, keys) {
+  const options = {};
+  for (const key of keys) {
+    const value = schema[key];
+    if (value !== void 0) {
+      options[key] = value;
+    }
+  }
+  return options;
+}
+function isPrimitiveLiteral(value) {
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === null;
+}
+function literalSchema(value, options = {}) {
+  if (value === null) {
+    return import_typebox.Type.Null(options);
+  }
+  return import_typebox.Type.Literal(value, options);
+}
+function toJsonSchema(value) {
+  if (!isRecord(value)) {
+    return {};
+  }
+  const schema = {};
+  if (isJsonSchemaType(value.type)) {
+    schema.type = value.type;
+  } else if (Array.isArray(value.type)) {
+    const types = value.type.filter(isJsonSchemaType);
+    if (types.length > 0) {
+      schema.type = types;
+    }
+  }
+  if (typeof value.description === "string") {
+    schema.description = value.description;
+  }
+  if (typeof value.title === "string") {
+    schema.title = value.title;
+  }
+  if ("default" in value) {
+    schema.default = value.default;
+  }
+  if (Array.isArray(value.enum)) {
+    schema.enum = value.enum;
+  }
+  if ("const" in value) {
+    schema.const = value.const;
+  }
+  if (isRecord(value.properties)) {
+    schema.properties = Object.fromEntries(
+      Object.entries(value.properties).map(([key, prop]) => [key, toJsonSchema(prop)])
+    );
+  }
+  if (Array.isArray(value.required)) {
+    schema.required = value.required.filter((item) => typeof item === "string");
+  }
+  if (value.items !== void 0) {
+    schema.items = toJsonSchema(value.items);
+  }
+  if (typeof value.minimum === "number") {
+    schema.minimum = value.minimum;
+  }
+  if (typeof value.maximum === "number") {
+    schema.maximum = value.maximum;
+  }
+  if (typeof value.exclusiveMinimum === "number") {
+    schema.exclusiveMinimum = value.exclusiveMinimum;
+  }
+  if (typeof value.exclusiveMaximum === "number") {
+    schema.exclusiveMaximum = value.exclusiveMaximum;
+  }
+  if (typeof value.minLength === "number") {
+    schema.minLength = value.minLength;
+  }
+  if (typeof value.maxLength === "number") {
+    schema.maxLength = value.maxLength;
+  }
+  if (typeof value.pattern === "string") {
+    schema.pattern = value.pattern;
+  }
+  if (typeof value.format === "string") {
+    schema.format = value.format;
+  }
+  if (typeof value.minItems === "number") {
+    schema.minItems = value.minItems;
+  }
+  if (typeof value.maxItems === "number") {
+    schema.maxItems = value.maxItems;
+  }
+  if (typeof value.uniqueItems === "boolean") {
+    schema.uniqueItems = value.uniqueItems;
+  }
+  if (typeof value.minProperties === "number") {
+    schema.minProperties = value.minProperties;
+  }
+  if (typeof value.maxProperties === "number") {
+    schema.maxProperties = value.maxProperties;
+  }
+  if (typeof value.additionalProperties === "boolean") {
+    schema.additionalProperties = value.additionalProperties;
+  } else if (isRecord(value.additionalProperties)) {
+    schema.additionalProperties = toJsonSchema(value.additionalProperties);
+  }
+  if (Array.isArray(value.oneOf)) {
+    schema.oneOf = value.oneOf.map(toJsonSchema);
+  }
+  if (Array.isArray(value.anyOf)) {
+    schema.anyOf = value.anyOf.map(toJsonSchema);
+  }
+  if (Array.isArray(value.allOf)) {
+    schema.allOf = value.allOf.map(toJsonSchema);
+  }
+  return schema;
+}
+function convertEnum(schema) {
+  if (!schema.enum || schema.enum.length === 0) {
+    return null;
+  }
+  if (!schema.enum.every(isPrimitiveLiteral)) {
+    return import_typebox.Type.Unsafe(schema);
+  }
+  const baseOptions = pickOptions(schema, SCHEMA_OPTION_KEYS);
+  if (schema.enum.length === 1) {
+    return literalSchema(schema.enum[0], baseOptions);
+  }
+  return import_typebox.Type.Union(
+    schema.enum.map((value) => literalSchema(value)),
+    baseOptions
+  );
+}
+function convertObjectSchema(schema) {
+  const properties = schema.properties ?? {};
+  const required = new Set(schema.required ?? []);
+  const convertedProperties = Object.fromEntries(
+    Object.entries(properties).map(([key, value]) => {
+      const converted = convertSchemaNode(value);
+      return [key, required.has(key) ? converted : import_typebox.Type.Optional(converted)];
+    })
+  );
+  const options = pickOptions(schema, [...SCHEMA_OPTION_KEYS, "minProperties", "maxProperties"]);
+  if (typeof schema.additionalProperties === "boolean") {
+    options.additionalProperties = schema.additionalProperties;
+  } else if (schema.additionalProperties) {
+    options.additionalProperties = convertSchemaNode(schema.additionalProperties);
+  }
+  return import_typebox.Type.Object(convertedProperties, options);
+}
+function convertArraySchema(schema) {
+  const itemSchema = schema.items ? convertSchemaNode(schema.items) : import_typebox.Type.Unknown();
+  return import_typebox.Type.Array(itemSchema, pickOptions(schema, [...SCHEMA_OPTION_KEYS, "minItems", "maxItems", "uniqueItems"]));
+}
+function convertSingleTypeSchema(schema, type) {
+  switch (type) {
+    case "string":
+      return import_typebox.Type.String(pickOptions(schema, [...SCHEMA_OPTION_KEYS, "minLength", "maxLength", "pattern", "format"]));
+    case "number":
+      return import_typebox.Type.Number(
+        pickOptions(schema, [...SCHEMA_OPTION_KEYS, "minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum"])
+      );
+    case "integer":
+      return import_typebox.Type.Integer(
+        pickOptions(schema, [...SCHEMA_OPTION_KEYS, "minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum"])
+      );
+    case "boolean":
+      return import_typebox.Type.Boolean(pickOptions(schema, SCHEMA_OPTION_KEYS));
+    case "null":
+      return import_typebox.Type.Null(pickOptions(schema, SCHEMA_OPTION_KEYS));
+    case "array":
+      return convertArraySchema(schema);
+    case "object":
+      return convertObjectSchema(schema);
+    default:
+      return import_typebox.Type.Unknown(pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+}
+function convertSchemaNode(schema) {
+  const enumSchema = convertEnum(schema);
+  if (enumSchema) {
+    return enumSchema;
+  }
+  if (schema.const !== void 0 && isPrimitiveLiteral(schema.const)) {
+    return literalSchema(schema.const, pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+  if (schema.oneOf && schema.oneOf.length > 0) {
+    return import_typebox.Type.Union(schema.oneOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+  if (schema.anyOf && schema.anyOf.length > 0) {
+    return import_typebox.Type.Union(schema.anyOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+  if (schema.allOf && schema.allOf.length > 0) {
+    return import_typebox.Type.Intersect(schema.allOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+  if (schema.type === void 0) {
+    if (schema.properties) {
+      return convertObjectSchema({ ...schema, type: "object" });
+    }
+    if (schema.items) {
+      return convertArraySchema({ ...schema, type: "array" });
+    }
+    return import_typebox.Type.Unknown(pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+  const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+  if (types.length === 1) {
+    return convertSingleTypeSchema(schema, types[0]);
+  }
+  return import_typebox.Type.Union(
+    types.map((type) => convertSingleTypeSchema(schema, type)),
+    pickOptions(schema, SCHEMA_OPTION_KEYS)
+  );
+}
+function convertSchema(mcpSchema) {
+  return convertSchemaNode(toJsonSchema(mcpSchema));
+}
+function registerPhantomTools(api, session) {
+  for (const mcpTool of import_mcp_server2.tools) {
+    api.registerTool({
+      name: mcpTool.name,
+      description: mcpTool.description,
+      parameters: convertSchema(mcpTool.inputSchema),
+      async execute(_id, params) {
+        const createLogger = (prefix) => ({
+          info: (msg) => console.info(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          error: (msg) => console.error(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          debug: (msg) => console.debug(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          child: (name) => createLogger(`${prefix}:${name}`)
+        });
+        const context = {
+          client: session.getClient(),
+          session: session.getSession(),
+          logger: createLogger(mcpTool.name)
+        };
+        try {
+          const result = await mcpTool.handler(params, context);
+          const normalized = result ?? null;
+          return {
+            content: [
+              {
+                type: "text",
+                text: typeof normalized === "string" ? normalized : JSON.stringify(normalized, null, 2)
+              }
+            ]
+          };
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify({ error: errorMessage }, null, 2)
+              }
+            ],
+            isError: true
+          };
+        }
+      }
+    });
+  }
+}
+
+// src/index.ts
+var sessionInstance = null;
+var PLUGIN_ID = "phantom-openclaw-plugin";
+var STRING_CONFIG_KEYS = [
+  "PHANTOM_APP_ID",
+  "PHANTOM_CLIENT_ID",
+  "PHANTOM_CLIENT_SECRET",
+  "PHANTOM_AUTH_BASE_URL",
+  "PHANTOM_CONNECT_BASE_URL",
+  "PHANTOM_API_BASE_URL",
+  "PHANTOM_CALLBACK_PATH",
+  "PHANTOM_SSO_PROVIDER",
+  "PHANTOM_MCP_DEBUG"
+];
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function getPluginConfig(fullConfig) {
+  if (!fullConfig) {
+    return void 0;
+  }
+  const plugins = fullConfig.plugins;
+  if (!isRecord2(plugins)) {
+    return fullConfig;
+  }
+  const entries = plugins.entries;
+  if (!isRecord2(entries)) {
+    return fullConfig;
+  }
+  const pluginEntry = entries[PLUGIN_ID];
+  if (!isRecord2(pluginEntry)) {
+    return fullConfig;
+  }
+  const pluginConfig = pluginEntry.config;
+  if (isRecord2(pluginConfig)) {
+    return pluginConfig;
+  }
+  return fullConfig;
+}
+function applyConfigToEnv(config) {
+  if (!config) {
+    return;
+  }
+  for (const key of STRING_CONFIG_KEYS) {
+    const value = config[key];
+    if (typeof value === "string" && value.trim().length > 0) {
+      process.env[key] = value.trim();
+    }
+  }
+  const rawPort = config.PHANTOM_CALLBACK_PORT;
+  let parsedPort = null;
+  if (typeof rawPort === "number") {
+    parsedPort = rawPort;
+  } else if (typeof rawPort === "string") {
+    const parsed = Number.parseInt(rawPort, 10);
+    parsedPort = Number.isNaN(parsed) ? null : parsed;
+  }
+  if (parsedPort !== null && Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535) {
+    process.env.PHANTOM_CALLBACK_PORT = String(parsedPort);
+  }
+}
+function getSession(config) {
+  if (!sessionInstance) {
+    const pluginConfig = getPluginConfig(config);
+    applyConfigToEnv(pluginConfig);
+    const appId = (process.env.PHANTOM_APP_ID ?? process.env.PHANTOM_CLIENT_ID)?.trim();
+    if (!appId) {
+      throw new Error(
+        'PHANTOM_APP_ID is required. Configure it in "~/.openclaw/openclaw.json" at plugins.entries["phantom-openclaw-plugin"].config.PHANTOM_APP_ID'
+      );
+    }
+    const envPort = process.env.PHANTOM_CALLBACK_PORT?.trim();
+    const parsedPort = envPort ? Number.parseInt(envPort, 10) : NaN;
+    const callbackPort = Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535 ? parsedPort : void 0;
+    sessionInstance = new PluginSession({
+      appId,
+      callbackPort
+    });
+  }
+  return sessionInstance;
+}
+function resetSession() {
+  sessionInstance = null;
+}
+async function register(api) {
+  try {
+    const session = getSession(api.config);
+    await session.initialize();
+    registerPhantomTools(api, session);
+  } catch (error) {
+    console.error("Failed to initialize Phantom OpenClaw plugin:", error);
+    resetSession();
+    throw error;
+  }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/session.ts","../src/tools/register-tools.ts"],"sourcesContent":["/**\n * Phantom OpenClaw Plugin\n *\n * Integrates Phantom wallet operations directly with OpenClaw agents\n * by wrapping the Phantom MCP Server tools.\n */\n\nimport type { OpenClawApi } from \"./client/types.js\";\nimport { PluginSession } from \"./session.js\";\nimport { registerPhantomTools } from \"./tools/register-tools.js\";\n\n// Singleton session instance\nlet sessionInstance: PluginSession | null = null;\nconst PLUGIN_ID = \"phantom-openclaw-plugin\";\n\nconst STRING_CONFIG_KEYS = [\n  \"PHANTOM_APP_ID\",\n  \"PHANTOM_CLIENT_ID\",\n  \"PHANTOM_CLIENT_SECRET\",\n  \"PHANTOM_AUTH_BASE_URL\",\n  \"PHANTOM_CONNECT_BASE_URL\",\n  \"PHANTOM_API_BASE_URL\",\n  \"PHANTOM_CALLBACK_PATH\",\n  \"PHANTOM_SSO_PROVIDER\",\n  \"PHANTOM_MCP_DEBUG\",\n] as const;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\n/**\n * OpenClaw passes the full openclaw.json object as api.config.\n * Extract this plugin's scoped config when available.\n */\nfunction getPluginConfig(fullConfig?: Record<string, unknown>): Record<string, unknown> | undefined {\n  if (!fullConfig) {\n    return undefined;\n  }\n\n  const plugins = fullConfig.plugins;\n  if (!isRecord(plugins)) {\n    return fullConfig;\n  }\n\n  const entries = plugins.entries;\n  if (!isRecord(entries)) {\n    return fullConfig;\n  }\n\n  const pluginEntry = entries[PLUGIN_ID];\n  if (!isRecord(pluginEntry)) {\n    return fullConfig;\n  }\n\n  const pluginConfig = pluginEntry.config;\n  if (isRecord(pluginConfig)) {\n    return pluginConfig;\n  }\n\n  return fullConfig;\n}\n\nfunction applyConfigToEnv(config?: Record<string, unknown>): void {\n  if (!config) {\n    return;\n  }\n\n  for (const key of STRING_CONFIG_KEYS) {\n    const value = config[key];\n    if (typeof value === \"string\" && value.trim().length > 0) {\n      process.env[key] = value.trim();\n    }\n  }\n\n  const rawPort = config.PHANTOM_CALLBACK_PORT;\n  let parsedPort: number | null = null;\n\n  if (typeof rawPort === \"number\") {\n    parsedPort = rawPort;\n  } else if (typeof rawPort === \"string\") {\n    const parsed = Number.parseInt(rawPort, 10);\n    parsedPort = Number.isNaN(parsed) ? null : parsed;\n  }\n\n  if (parsedPort !== null && Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535) {\n    process.env.PHANTOM_CALLBACK_PORT = String(parsedPort);\n  }\n}\n\n/**\n * Get or create the plugin session with configuration\n */\nfunction getSession(config?: Record<string, unknown>): PluginSession {\n  if (!sessionInstance) {\n    const pluginConfig = getPluginConfig(config);\n    applyConfigToEnv(pluginConfig);\n\n    const appId = (process.env.PHANTOM_APP_ID ?? process.env.PHANTOM_CLIENT_ID)?.trim();\n    if (!appId) {\n      throw new Error(\n        'PHANTOM_APP_ID is required. Configure it in \"~/.openclaw/openclaw.json\" at plugins.entries[\"phantom-openclaw-plugin\"].config.PHANTOM_APP_ID',\n      );\n    }\n\n    const envPort = process.env.PHANTOM_CALLBACK_PORT?.trim();\n    const parsedPort = envPort ? Number.parseInt(envPort, 10) : NaN;\n    const callbackPort = Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535 ? parsedPort : undefined;\n\n    sessionInstance = new PluginSession({\n      appId,\n      callbackPort,\n    });\n  }\n  return sessionInstance;\n}\n\n/**\n * Reset the session singleton (used for cleanup on initialization failure)\n */\nfunction resetSession(): void {\n  sessionInstance = null;\n}\n\n/**\n * Plugin registration function\n */\nexport default async function register(api: OpenClawApi) {\n  try {\n    // Initialize session (authenticate if needed)\n    const session = getSession(api.config);\n    await session.initialize();\n\n    // Register all Phantom MCP tools\n    registerPhantomTools(api, session);\n  } catch (error) {\n    console.error(\"Failed to initialize Phantom OpenClaw plugin:\", error); // eslint-disable-line no-console\n    // Reset singleton so next attempt gets a fresh instance\n    resetSession();\n    throw error;\n  }\n}\n","/**\n * Session management for Phantom OpenClaw plugin\n * Wraps the SessionManager from @phantom/mcp-server\n */\n\nimport { SessionManager } from \"@phantom/mcp-server\";\nimport type { PhantomClient, SessionData } from \"@phantom/mcp-server\";\n\n/**\n * Configuration options for PluginSession\n */\nexport interface PluginSessionOptions {\n  /** Application identifier from Phantom Portal */\n  appId?: string;\n  /** OAuth callback port (default: 8080) */\n  callbackPort?: number;\n  /** Directory to store session data (default: ~/.phantom-mcp) */\n  sessionDir?: string;\n}\n\n/**\n * Plugin session manager\n * Handles authentication and provides access to PhantomClient\n */\nexport class PluginSession {\n  private sessionManager: SessionManager;\n  private initialized = false;\n  private initializingPromise: Promise<void> | null = null;\n\n  constructor(options: PluginSessionOptions = {}) {\n    // Initialize SessionManager with configuration\n    this.sessionManager = new SessionManager({\n      appId: options.appId ?? \"phantom-openclaw\",\n      callbackPort: options.callbackPort,\n      sessionDir: options.sessionDir,\n    });\n  }\n\n  /**\n   * Initialize the session (authenticate if needed)\n   * Thread-safe: concurrent calls will await the same initialization promise\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    // If already initializing, return the existing promise\n    if (this.initializingPromise) {\n      return this.initializingPromise;\n    }\n\n    // Create and store the initialization promise\n    this.initializingPromise = this.sessionManager\n      .initialize()\n      .then(() => {\n        this.initialized = true;\n      })\n      .catch(error => {\n        // Clear promise on error so subsequent calls can retry\n        this.initializingPromise = null;\n        throw error;\n      });\n\n    return this.initializingPromise;\n  }\n\n  /**\n   * Get the authenticated PhantomClient\n   */\n  getClient(): PhantomClient {\n    if (!this.initialized) {\n      throw new Error(\"Session not initialized. Call initialize() first.\");\n    }\n    return this.sessionManager.getClient();\n  }\n\n  /**\n   * Get the current session data\n   */\n  getSession(): SessionData {\n    if (!this.initialized) {\n      throw new Error(\"Session not initialized. Call initialize() first.\");\n    }\n    return this.sessionManager.getSession();\n  }\n}\n","/**\n * Register Phantom MCP tools as OpenClaw tools\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { TSchema } from \"@sinclair/typebox\";\nimport { tools } from \"@phantom/mcp-server\";\nimport type { OpenClawApi } from \"../client/types.js\";\nimport type { PluginSession } from \"../session.js\";\n\n/**\n * Convert MCP tool JSON schema to TypeBox schema\n */\ntype JsonSchemaType = \"string\" | \"number\" | \"integer\" | \"boolean\" | \"null\" | \"object\" | \"array\";\n\ntype JsonSchema = {\n  type?: JsonSchemaType | JsonSchemaType[];\n  description?: string;\n  title?: string;\n  default?: unknown;\n  enum?: unknown[];\n  const?: unknown;\n  properties?: Record<string, JsonSchema>;\n  required?: string[];\n  items?: JsonSchema;\n  minimum?: number;\n  maximum?: number;\n  exclusiveMinimum?: number;\n  exclusiveMaximum?: number;\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n  format?: string;\n  minItems?: number;\n  maxItems?: number;\n  uniqueItems?: boolean;\n  minProperties?: number;\n  maxProperties?: number;\n  additionalProperties?: boolean | JsonSchema;\n  oneOf?: JsonSchema[];\n  anyOf?: JsonSchema[];\n  allOf?: JsonSchema[];\n};\n\nconst SCHEMA_OPTION_KEYS = [\"description\", \"title\", \"default\"] as const;\nconst JSON_SCHEMA_TYPES: readonly JsonSchemaType[] = [\n  \"string\",\n  \"number\",\n  \"integer\",\n  \"boolean\",\n  \"null\",\n  \"object\",\n  \"array\",\n];\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isJsonSchemaType(value: unknown): value is JsonSchemaType {\n  return typeof value === \"string\" && JSON_SCHEMA_TYPES.includes(value as JsonSchemaType);\n}\n\nfunction pickOptions(schema: JsonSchema, keys: readonly string[]): Record<string, unknown> {\n  const options: Record<string, unknown> = {};\n  for (const key of keys) {\n    const value = schema[key as keyof JsonSchema];\n    if (value !== undefined) {\n      options[key] = value;\n    }\n  }\n  return options;\n}\n\nfunction isPrimitiveLiteral(value: unknown): value is string | number | boolean | null {\n  return typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\" || value === null;\n}\n\nfunction literalSchema(value: string | number | boolean | null, options: Record<string, unknown> = {}): TSchema {\n  if (value === null) {\n    return Type.Null(options);\n  }\n  return Type.Literal(value, options);\n}\n\nfunction toJsonSchema(value: unknown): JsonSchema {\n  if (!isRecord(value)) {\n    return {};\n  }\n\n  const schema: JsonSchema = {};\n\n  if (isJsonSchemaType(value.type)) {\n    schema.type = value.type;\n  } else if (Array.isArray(value.type)) {\n    const types = value.type.filter(isJsonSchemaType);\n    if (types.length > 0) {\n      schema.type = types;\n    }\n  }\n\n  if (typeof value.description === \"string\") {\n    schema.description = value.description;\n  }\n  if (typeof value.title === \"string\") {\n    schema.title = value.title;\n  }\n  if (\"default\" in value) {\n    schema.default = value.default;\n  }\n  if (Array.isArray(value.enum)) {\n    schema.enum = value.enum;\n  }\n  if (\"const\" in value) {\n    schema.const = value.const;\n  }\n  if (isRecord(value.properties)) {\n    schema.properties = Object.fromEntries(\n      Object.entries(value.properties).map(([key, prop]) => [key, toJsonSchema(prop)]),\n    );\n  }\n  if (Array.isArray(value.required)) {\n    schema.required = value.required.filter((item): item is string => typeof item === \"string\");\n  }\n  if (value.items !== undefined) {\n    schema.items = toJsonSchema(value.items);\n  }\n  if (typeof value.minimum === \"number\") {\n    schema.minimum = value.minimum;\n  }\n  if (typeof value.maximum === \"number\") {\n    schema.maximum = value.maximum;\n  }\n  if (typeof value.exclusiveMinimum === \"number\") {\n    schema.exclusiveMinimum = value.exclusiveMinimum;\n  }\n  if (typeof value.exclusiveMaximum === \"number\") {\n    schema.exclusiveMaximum = value.exclusiveMaximum;\n  }\n  if (typeof value.minLength === \"number\") {\n    schema.minLength = value.minLength;\n  }\n  if (typeof value.maxLength === \"number\") {\n    schema.maxLength = value.maxLength;\n  }\n  if (typeof value.pattern === \"string\") {\n    schema.pattern = value.pattern;\n  }\n  if (typeof value.format === \"string\") {\n    schema.format = value.format;\n  }\n  if (typeof value.minItems === \"number\") {\n    schema.minItems = value.minItems;\n  }\n  if (typeof value.maxItems === \"number\") {\n    schema.maxItems = value.maxItems;\n  }\n  if (typeof value.uniqueItems === \"boolean\") {\n    schema.uniqueItems = value.uniqueItems;\n  }\n  if (typeof value.minProperties === \"number\") {\n    schema.minProperties = value.minProperties;\n  }\n  if (typeof value.maxProperties === \"number\") {\n    schema.maxProperties = value.maxProperties;\n  }\n  if (typeof value.additionalProperties === \"boolean\") {\n    schema.additionalProperties = value.additionalProperties;\n  } else if (isRecord(value.additionalProperties)) {\n    schema.additionalProperties = toJsonSchema(value.additionalProperties);\n  }\n  if (Array.isArray(value.oneOf)) {\n    schema.oneOf = value.oneOf.map(toJsonSchema);\n  }\n  if (Array.isArray(value.anyOf)) {\n    schema.anyOf = value.anyOf.map(toJsonSchema);\n  }\n  if (Array.isArray(value.allOf)) {\n    schema.allOf = value.allOf.map(toJsonSchema);\n  }\n\n  return schema;\n}\n\nfunction convertEnum(schema: JsonSchema): TSchema | null {\n  if (!schema.enum || schema.enum.length === 0) {\n    return null;\n  }\n\n  if (!schema.enum.every(isPrimitiveLiteral)) {\n    return Type.Unsafe(schema);\n  }\n\n  const baseOptions = pickOptions(schema, SCHEMA_OPTION_KEYS);\n  if (schema.enum.length === 1) {\n    return literalSchema(schema.enum[0], baseOptions);\n  }\n\n  return Type.Union(\n    schema.enum.map(value => literalSchema(value)),\n    baseOptions,\n  );\n}\n\nfunction convertObjectSchema(schema: JsonSchema): TSchema {\n  const properties = schema.properties ?? {};\n  const required = new Set(schema.required ?? []);\n\n  const convertedProperties = Object.fromEntries(\n    Object.entries(properties).map(([key, value]) => {\n      const converted = convertSchemaNode(value);\n      return [key, required.has(key) ? converted : Type.Optional(converted)];\n    }),\n  );\n\n  const options = pickOptions(schema, [...SCHEMA_OPTION_KEYS, \"minProperties\", \"maxProperties\"]);\n  if (typeof schema.additionalProperties === \"boolean\") {\n    options.additionalProperties = schema.additionalProperties;\n  } else if (schema.additionalProperties) {\n    options.additionalProperties = convertSchemaNode(schema.additionalProperties);\n  }\n\n  return Type.Object(convertedProperties, options);\n}\n\nfunction convertArraySchema(schema: JsonSchema): TSchema {\n  const itemSchema = schema.items ? convertSchemaNode(schema.items) : Type.Unknown();\n  return Type.Array(itemSchema, pickOptions(schema, [...SCHEMA_OPTION_KEYS, \"minItems\", \"maxItems\", \"uniqueItems\"]));\n}\n\nfunction convertSingleTypeSchema(schema: JsonSchema, type: JsonSchemaType): TSchema {\n  switch (type) {\n    case \"string\":\n      return Type.String(pickOptions(schema, [...SCHEMA_OPTION_KEYS, \"minLength\", \"maxLength\", \"pattern\", \"format\"]));\n    case \"number\":\n      return Type.Number(\n        pickOptions(schema, [...SCHEMA_OPTION_KEYS, \"minimum\", \"maximum\", \"exclusiveMinimum\", \"exclusiveMaximum\"]),\n      );\n    case \"integer\":\n      return Type.Integer(\n        pickOptions(schema, [...SCHEMA_OPTION_KEYS, \"minimum\", \"maximum\", \"exclusiveMinimum\", \"exclusiveMaximum\"]),\n      );\n    case \"boolean\":\n      return Type.Boolean(pickOptions(schema, SCHEMA_OPTION_KEYS));\n    case \"null\":\n      return Type.Null(pickOptions(schema, SCHEMA_OPTION_KEYS));\n    case \"array\":\n      return convertArraySchema(schema);\n    case \"object\":\n      return convertObjectSchema(schema);\n    default:\n      return Type.Unknown(pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n}\n\nfunction convertSchemaNode(schema: JsonSchema): TSchema {\n  const enumSchema = convertEnum(schema);\n  if (enumSchema) {\n    return enumSchema;\n  }\n\n  if (schema.const !== undefined && isPrimitiveLiteral(schema.const)) {\n    return literalSchema(schema.const, pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n\n  if (schema.oneOf && schema.oneOf.length > 0) {\n    return Type.Union(schema.oneOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n\n  if (schema.anyOf && schema.anyOf.length > 0) {\n    return Type.Union(schema.anyOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n\n  if (schema.allOf && schema.allOf.length > 0) {\n    return Type.Intersect(schema.allOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n\n  if (schema.type === undefined) {\n    if (schema.properties) {\n      return convertObjectSchema({ ...schema, type: \"object\" });\n    }\n    if (schema.items) {\n      return convertArraySchema({ ...schema, type: \"array\" });\n    }\n    return Type.Unknown(pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n\n  const types = Array.isArray(schema.type) ? schema.type : [schema.type];\n  if (types.length === 1) {\n    return convertSingleTypeSchema(schema, types[0]);\n  }\n\n  return Type.Union(\n    types.map(type => convertSingleTypeSchema(schema, type)),\n    pickOptions(schema, SCHEMA_OPTION_KEYS),\n  );\n}\n\nfunction convertSchema(mcpSchema: unknown): TSchema {\n  return convertSchemaNode(toJsonSchema(mcpSchema));\n}\n\n/**\n * Register all Phantom MCP tools with OpenClaw\n */\nexport function registerPhantomTools(api: OpenClawApi, session: PluginSession): void {\n  for (const mcpTool of tools) {\n    api.registerTool({\n      name: mcpTool.name,\n      description: mcpTool.description,\n      parameters: convertSchema(mcpTool.inputSchema),\n      async execute(_id: string, params: Record<string, unknown>) {\n        // Create tool context for MCP tool with recursive logger\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const createLogger = (prefix: string): any => ({\n          info: (msg: string) => console.info(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          error: (msg: string) => console.error(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          debug: (msg: string) => console.debug(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          child: (name: string) => createLogger(`${prefix}:${name}`),\n        });\n\n        const context = {\n          client: session.getClient(),\n          session: session.getSession(),\n          logger: createLogger(mcpTool.name),\n        };\n\n        try {\n          // Execute the MCP tool handler\n          const result = await mcpTool.handler(params, context);\n\n          // Return in OpenClaw format with defensive handling for undefined\n          const normalized = result ?? null;\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: typeof normalized === \"string\" ? normalized : JSON.stringify(normalized, null, 2),\n              },\n            ],\n          };\n        } catch (error) {\n          const errorMessage = error instanceof Error ? error.message : String(error);\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: JSON.stringify({ error: errorMessage }, null, 2),\n              },\n            ],\n            isError: true,\n          };\n        }\n      },\n    });\n  }\n}\n"],"mappings":"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","names":["import_mcp_server","isRecord"]}

package/dist/index.mjs

@@ -0,0 +1,430 @@
+// src/session.ts
+import { SessionManager } from "@phantom/mcp-server";
+var PluginSession = class {
+  constructor(options = {}) {
+    this.initialized = false;
+    this.initializingPromise = null;
+    this.sessionManager = new SessionManager({
+      appId: options.appId ?? "phantom-openclaw",
+      callbackPort: options.callbackPort,
+      sessionDir: options.sessionDir
+    });
+  }
+  /**
+   * Initialize the session (authenticate if needed)
+   * Thread-safe: concurrent calls will await the same initialization promise
+   */
+  async initialize() {
+    if (this.initialized) {
+      return;
+    }
+    if (this.initializingPromise) {
+      return this.initializingPromise;
+    }
+    this.initializingPromise = this.sessionManager.initialize().then(() => {
+      this.initialized = true;
+    }).catch((error) => {
+      this.initializingPromise = null;
+      throw error;
+    });
+    return this.initializingPromise;
+  }
+  /**
+   * Get the authenticated PhantomClient
+   */
+  getClient() {
+    if (!this.initialized) {
+      throw new Error("Session not initialized. Call initialize() first.");
+    }
+    return this.sessionManager.getClient();
+  }
+  /**
+   * Get the current session data
+   */
+  getSession() {
+    if (!this.initialized) {
+      throw new Error("Session not initialized. Call initialize() first.");
+    }
+    return this.sessionManager.getSession();
+  }
+};
+
+// src/tools/register-tools.ts
+import { Type } from "@sinclair/typebox";
+import { tools } from "@phantom/mcp-server";
+var SCHEMA_OPTION_KEYS = ["description", "title", "default"];
+var JSON_SCHEMA_TYPES = [
+  "string",
+  "number",
+  "integer",
+  "boolean",
+  "null",
+  "object",
+  "array"
+];
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function isJsonSchemaType(value) {
+  return typeof value === "string" && JSON_SCHEMA_TYPES.includes(value);
+}
+function pickOptions(schema, keys) {
+  const options = {};
+  for (const key of keys) {
+    const value = schema[key];
+    if (value !== void 0) {
+      options[key] = value;
+    }
+  }
+  return options;
+}
+function isPrimitiveLiteral(value) {
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === null;
+}
+function literalSchema(value, options = {}) {
+  if (value === null) {
+    return Type.Null(options);
+  }
+  return Type.Literal(value, options);
+}
+function toJsonSchema(value) {
+  if (!isRecord(value)) {
+    return {};
+  }
+  const schema = {};
+  if (isJsonSchemaType(value.type)) {
+    schema.type = value.type;
+  } else if (Array.isArray(value.type)) {
+    const types = value.type.filter(isJsonSchemaType);
+    if (types.length > 0) {
+      schema.type = types;
+    }
+  }
+  if (typeof value.description === "string") {
+    schema.description = value.description;
+  }
+  if (typeof value.title === "string") {
+    schema.title = value.title;
+  }
+  if ("default" in value) {
+    schema.default = value.default;
+  }
+  if (Array.isArray(value.enum)) {
+    schema.enum = value.enum;
+  }
+  if ("const" in value) {
+    schema.const = value.const;
+  }
+  if (isRecord(value.properties)) {
+    schema.properties = Object.fromEntries(
+      Object.entries(value.properties).map(([key, prop]) => [key, toJsonSchema(prop)])
+    );
+  }
+  if (Array.isArray(value.required)) {
+    schema.required = value.required.filter((item) => typeof item === "string");
+  }
+  if (value.items !== void 0) {
+    schema.items = toJsonSchema(value.items);
+  }
+  if (typeof value.minimum === "number") {
+    schema.minimum = value.minimum;
+  }
+  if (typeof value.maximum === "number") {
+    schema.maximum = value.maximum;
+  }
+  if (typeof value.exclusiveMinimum === "number") {
+    schema.exclusiveMinimum = value.exclusiveMinimum;
+  }
+  if (typeof value.exclusiveMaximum === "number") {
+    schema.exclusiveMaximum = value.exclusiveMaximum;
+  }
+  if (typeof value.minLength === "number") {
+    schema.minLength = value.minLength;
+  }
+  if (typeof value.maxLength === "number") {
+    schema.maxLength = value.maxLength;
+  }
+  if (typeof value.pattern === "string") {
+    schema.pattern = value.pattern;
+  }
+  if (typeof value.format === "string") {
+    schema.format = value.format;
+  }
+  if (typeof value.minItems === "number") {
+    schema.minItems = value.minItems;
+  }
+  if (typeof value.maxItems === "number") {
+    schema.maxItems = value.maxItems;
+  }
+  if (typeof value.uniqueItems === "boolean") {
+    schema.uniqueItems = value.uniqueItems;
+  }
+  if (typeof value.minProperties === "number") {
+    schema.minProperties = value.minProperties;
+  }
+  if (typeof value.maxProperties === "number") {
+    schema.maxProperties = value.maxProperties;
+  }
+  if (typeof value.additionalProperties === "boolean") {
+    schema.additionalProperties = value.additionalProperties;
+  } else if (isRecord(value.additionalProperties)) {
+    schema.additionalProperties = toJsonSchema(value.additionalProperties);
+  }
+  if (Array.isArray(value.oneOf)) {
+    schema.oneOf = value.oneOf.map(toJsonSchema);
+  }
+  if (Array.isArray(value.anyOf)) {
+    schema.anyOf = value.anyOf.map(toJsonSchema);
+  }
+  if (Array.isArray(value.allOf)) {
+    schema.allOf = value.allOf.map(toJsonSchema);
+  }
+  return schema;
+}
+function convertEnum(schema) {
+  if (!schema.enum || schema.enum.length === 0) {
+    return null;
+  }
+  if (!schema.enum.every(isPrimitiveLiteral)) {
+    return Type.Unsafe(schema);
+  }
+  const baseOptions = pickOptions(schema, SCHEMA_OPTION_KEYS);
+  if (schema.enum.length === 1) {
+    return literalSchema(schema.enum[0], baseOptions);
+  }
+  return Type.Union(
+    schema.enum.map((value) => literalSchema(value)),
+    baseOptions
+  );
+}
+function convertObjectSchema(schema) {
+  const properties = schema.properties ?? {};
+  const required = new Set(schema.required ?? []);
+  const convertedProperties = Object.fromEntries(
+    Object.entries(properties).map(([key, value]) => {
+      const converted = convertSchemaNode(value);
+      return [key, required.has(key) ? converted : Type.Optional(converted)];
+    })
+  );
+  const options = pickOptions(schema, [...SCHEMA_OPTION_KEYS, "minProperties", "maxProperties"]);
+  if (typeof schema.additionalProperties === "boolean") {
+    options.additionalProperties = schema.additionalProperties;
+  } else if (schema.additionalProperties) {
+    options.additionalProperties = convertSchemaNode(schema.additionalProperties);
+  }
+  return Type.Object(convertedProperties, options);
+}
+function convertArraySchema(schema) {
+  const itemSchema = schema.items ? convertSchemaNode(schema.items) : Type.Unknown();
+  return Type.Array(itemSchema, pickOptions(schema, [...SCHEMA_OPTION_KEYS, "minItems", "maxItems", "uniqueItems"]));
+}
+function convertSingleTypeSchema(schema, type) {
+  switch (type) {
+    case "string":
+      return Type.String(pickOptions(schema, [...SCHEMA_OPTION_KEYS, "minLength", "maxLength", "pattern", "format"]));
+    case "number":
+      return Type.Number(
+        pickOptions(schema, [...SCHEMA_OPTION_KEYS, "minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum"])
+      );
+    case "integer":
+      return Type.Integer(
+        pickOptions(schema, [...SCHEMA_OPTION_KEYS, "minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum"])
+      );
+    case "boolean":
+      return Type.Boolean(pickOptions(schema, SCHEMA_OPTION_KEYS));
+    case "null":
+      return Type.Null(pickOptions(schema, SCHEMA_OPTION_KEYS));
+    case "array":
+      return convertArraySchema(schema);
+    case "object":
+      return convertObjectSchema(schema);
+    default:
+      return Type.Unknown(pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+}
+function convertSchemaNode(schema) {
+  const enumSchema = convertEnum(schema);
+  if (enumSchema) {
+    return enumSchema;
+  }
+  if (schema.const !== void 0 && isPrimitiveLiteral(schema.const)) {
+    return literalSchema(schema.const, pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+  if (schema.oneOf && schema.oneOf.length > 0) {
+    return Type.Union(schema.oneOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+  if (schema.anyOf && schema.anyOf.length > 0) {
+    return Type.Union(schema.anyOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+  if (schema.allOf && schema.allOf.length > 0) {
+    return Type.Intersect(schema.allOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+  if (schema.type === void 0) {
+    if (schema.properties) {
+      return convertObjectSchema({ ...schema, type: "object" });
+    }
+    if (schema.items) {
+      return convertArraySchema({ ...schema, type: "array" });
+    }
+    return Type.Unknown(pickOptions(schema, SCHEMA_OPTION_KEYS));
+  }
+  const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+  if (types.length === 1) {
+    return convertSingleTypeSchema(schema, types[0]);
+  }
+  return Type.Union(
+    types.map((type) => convertSingleTypeSchema(schema, type)),
+    pickOptions(schema, SCHEMA_OPTION_KEYS)
+  );
+}
+function convertSchema(mcpSchema) {
+  return convertSchemaNode(toJsonSchema(mcpSchema));
+}
+function registerPhantomTools(api, session) {
+  for (const mcpTool of tools) {
+    api.registerTool({
+      name: mcpTool.name,
+      description: mcpTool.description,
+      parameters: convertSchema(mcpTool.inputSchema),
+      async execute(_id, params) {
+        const createLogger = (prefix) => ({
+          info: (msg) => console.info(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          error: (msg) => console.error(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          debug: (msg) => console.debug(`[${prefix}] ${msg}`),
+          // eslint-disable-line no-console
+          child: (name) => createLogger(`${prefix}:${name}`)
+        });
+        const context = {
+          client: session.getClient(),
+          session: session.getSession(),
+          logger: createLogger(mcpTool.name)
+        };
+        try {
+          const result = await mcpTool.handler(params, context);
+          const normalized = result ?? null;
+          return {
+            content: [
+              {
+                type: "text",
+                text: typeof normalized === "string" ? normalized : JSON.stringify(normalized, null, 2)
+              }
+            ]
+          };
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify({ error: errorMessage }, null, 2)
+              }
+            ],
+            isError: true
+          };
+        }
+      }
+    });
+  }
+}
+
+// src/index.ts
+var sessionInstance = null;
+var PLUGIN_ID = "phantom-openclaw-plugin";
+var STRING_CONFIG_KEYS = [
+  "PHANTOM_APP_ID",
+  "PHANTOM_CLIENT_ID",
+  "PHANTOM_CLIENT_SECRET",
+  "PHANTOM_AUTH_BASE_URL",
+  "PHANTOM_CONNECT_BASE_URL",
+  "PHANTOM_API_BASE_URL",
+  "PHANTOM_CALLBACK_PATH",
+  "PHANTOM_SSO_PROVIDER",
+  "PHANTOM_MCP_DEBUG"
+];
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function getPluginConfig(fullConfig) {
+  if (!fullConfig) {
+    return void 0;
+  }
+  const plugins = fullConfig.plugins;
+  if (!isRecord2(plugins)) {
+    return fullConfig;
+  }
+  const entries = plugins.entries;
+  if (!isRecord2(entries)) {
+    return fullConfig;
+  }
+  const pluginEntry = entries[PLUGIN_ID];
+  if (!isRecord2(pluginEntry)) {
+    return fullConfig;
+  }
+  const pluginConfig = pluginEntry.config;
+  if (isRecord2(pluginConfig)) {
+    return pluginConfig;
+  }
+  return fullConfig;
+}
+function applyConfigToEnv(config) {
+  if (!config) {
+    return;
+  }
+  for (const key of STRING_CONFIG_KEYS) {
+    const value = config[key];
+    if (typeof value === "string" && value.trim().length > 0) {
+      process.env[key] = value.trim();
+    }
+  }
+  const rawPort = config.PHANTOM_CALLBACK_PORT;
+  let parsedPort = null;
+  if (typeof rawPort === "number") {
+    parsedPort = rawPort;
+  } else if (typeof rawPort === "string") {
+    const parsed = Number.parseInt(rawPort, 10);
+    parsedPort = Number.isNaN(parsed) ? null : parsed;
+  }
+  if (parsedPort !== null && Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535) {
+    process.env.PHANTOM_CALLBACK_PORT = String(parsedPort);
+  }
+}
+function getSession(config) {
+  if (!sessionInstance) {
+    const pluginConfig = getPluginConfig(config);
+    applyConfigToEnv(pluginConfig);
+    const appId = (process.env.PHANTOM_APP_ID ?? process.env.PHANTOM_CLIENT_ID)?.trim();
+    if (!appId) {
+      throw new Error(
+        'PHANTOM_APP_ID is required. Configure it in "~/.openclaw/openclaw.json" at plugins.entries["phantom-openclaw-plugin"].config.PHANTOM_APP_ID'
+      );
+    }
+    const envPort = process.env.PHANTOM_CALLBACK_PORT?.trim();
+    const parsedPort = envPort ? Number.parseInt(envPort, 10) : NaN;
+    const callbackPort = Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535 ? parsedPort : void 0;
+    sessionInstance = new PluginSession({
+      appId,
+      callbackPort
+    });
+  }
+  return sessionInstance;
+}
+function resetSession() {
+  sessionInstance = null;
+}
+async function register(api) {
+  try {
+    const session = getSession(api.config);
+    await session.initialize();
+    registerPhantomTools(api, session);
+  } catch (error) {
+    console.error("Failed to initialize Phantom OpenClaw plugin:", error);
+    resetSession();
+    throw error;
+  }
+}
+export {
+  register as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session.ts","../src/tools/register-tools.ts","../src/index.ts"],"sourcesContent":["/**\n * Session management for Phantom OpenClaw plugin\n * Wraps the SessionManager from @phantom/mcp-server\n */\n\nimport { SessionManager } from \"@phantom/mcp-server\";\nimport type { PhantomClient, SessionData } from \"@phantom/mcp-server\";\n\n/**\n * Configuration options for PluginSession\n */\nexport interface PluginSessionOptions {\n  /** Application identifier from Phantom Portal */\n  appId?: string;\n  /** OAuth callback port (default: 8080) */\n  callbackPort?: number;\n  /** Directory to store session data (default: ~/.phantom-mcp) */\n  sessionDir?: string;\n}\n\n/**\n * Plugin session manager\n * Handles authentication and provides access to PhantomClient\n */\nexport class PluginSession {\n  private sessionManager: SessionManager;\n  private initialized = false;\n  private initializingPromise: Promise<void> | null = null;\n\n  constructor(options: PluginSessionOptions = {}) {\n    // Initialize SessionManager with configuration\n    this.sessionManager = new SessionManager({\n      appId: options.appId ?? \"phantom-openclaw\",\n      callbackPort: options.callbackPort,\n      sessionDir: options.sessionDir,\n    });\n  }\n\n  /**\n   * Initialize the session (authenticate if needed)\n   * Thread-safe: concurrent calls will await the same initialization promise\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    // If already initializing, return the existing promise\n    if (this.initializingPromise) {\n      return this.initializingPromise;\n    }\n\n    // Create and store the initialization promise\n    this.initializingPromise = this.sessionManager\n      .initialize()\n      .then(() => {\n        this.initialized = true;\n      })\n      .catch(error => {\n        // Clear promise on error so subsequent calls can retry\n        this.initializingPromise = null;\n        throw error;\n      });\n\n    return this.initializingPromise;\n  }\n\n  /**\n   * Get the authenticated PhantomClient\n   */\n  getClient(): PhantomClient {\n    if (!this.initialized) {\n      throw new Error(\"Session not initialized. Call initialize() first.\");\n    }\n    return this.sessionManager.getClient();\n  }\n\n  /**\n   * Get the current session data\n   */\n  getSession(): SessionData {\n    if (!this.initialized) {\n      throw new Error(\"Session not initialized. Call initialize() first.\");\n    }\n    return this.sessionManager.getSession();\n  }\n}\n","/**\n * Register Phantom MCP tools as OpenClaw tools\n */\n\nimport { Type } from \"@sinclair/typebox\";\nimport type { TSchema } from \"@sinclair/typebox\";\nimport { tools } from \"@phantom/mcp-server\";\nimport type { OpenClawApi } from \"../client/types.js\";\nimport type { PluginSession } from \"../session.js\";\n\n/**\n * Convert MCP tool JSON schema to TypeBox schema\n */\ntype JsonSchemaType = \"string\" | \"number\" | \"integer\" | \"boolean\" | \"null\" | \"object\" | \"array\";\n\ntype JsonSchema = {\n  type?: JsonSchemaType | JsonSchemaType[];\n  description?: string;\n  title?: string;\n  default?: unknown;\n  enum?: unknown[];\n  const?: unknown;\n  properties?: Record<string, JsonSchema>;\n  required?: string[];\n  items?: JsonSchema;\n  minimum?: number;\n  maximum?: number;\n  exclusiveMinimum?: number;\n  exclusiveMaximum?: number;\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n  format?: string;\n  minItems?: number;\n  maxItems?: number;\n  uniqueItems?: boolean;\n  minProperties?: number;\n  maxProperties?: number;\n  additionalProperties?: boolean | JsonSchema;\n  oneOf?: JsonSchema[];\n  anyOf?: JsonSchema[];\n  allOf?: JsonSchema[];\n};\n\nconst SCHEMA_OPTION_KEYS = [\"description\", \"title\", \"default\"] as const;\nconst JSON_SCHEMA_TYPES: readonly JsonSchemaType[] = [\n  \"string\",\n  \"number\",\n  \"integer\",\n  \"boolean\",\n  \"null\",\n  \"object\",\n  \"array\",\n];\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isJsonSchemaType(value: unknown): value is JsonSchemaType {\n  return typeof value === \"string\" && JSON_SCHEMA_TYPES.includes(value as JsonSchemaType);\n}\n\nfunction pickOptions(schema: JsonSchema, keys: readonly string[]): Record<string, unknown> {\n  const options: Record<string, unknown> = {};\n  for (const key of keys) {\n    const value = schema[key as keyof JsonSchema];\n    if (value !== undefined) {\n      options[key] = value;\n    }\n  }\n  return options;\n}\n\nfunction isPrimitiveLiteral(value: unknown): value is string | number | boolean | null {\n  return typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\" || value === null;\n}\n\nfunction literalSchema(value: string | number | boolean | null, options: Record<string, unknown> = {}): TSchema {\n  if (value === null) {\n    return Type.Null(options);\n  }\n  return Type.Literal(value, options);\n}\n\nfunction toJsonSchema(value: unknown): JsonSchema {\n  if (!isRecord(value)) {\n    return {};\n  }\n\n  const schema: JsonSchema = {};\n\n  if (isJsonSchemaType(value.type)) {\n    schema.type = value.type;\n  } else if (Array.isArray(value.type)) {\n    const types = value.type.filter(isJsonSchemaType);\n    if (types.length > 0) {\n      schema.type = types;\n    }\n  }\n\n  if (typeof value.description === \"string\") {\n    schema.description = value.description;\n  }\n  if (typeof value.title === \"string\") {\n    schema.title = value.title;\n  }\n  if (\"default\" in value) {\n    schema.default = value.default;\n  }\n  if (Array.isArray(value.enum)) {\n    schema.enum = value.enum;\n  }\n  if (\"const\" in value) {\n    schema.const = value.const;\n  }\n  if (isRecord(value.properties)) {\n    schema.properties = Object.fromEntries(\n      Object.entries(value.properties).map(([key, prop]) => [key, toJsonSchema(prop)]),\n    );\n  }\n  if (Array.isArray(value.required)) {\n    schema.required = value.required.filter((item): item is string => typeof item === \"string\");\n  }\n  if (value.items !== undefined) {\n    schema.items = toJsonSchema(value.items);\n  }\n  if (typeof value.minimum === \"number\") {\n    schema.minimum = value.minimum;\n  }\n  if (typeof value.maximum === \"number\") {\n    schema.maximum = value.maximum;\n  }\n  if (typeof value.exclusiveMinimum === \"number\") {\n    schema.exclusiveMinimum = value.exclusiveMinimum;\n  }\n  if (typeof value.exclusiveMaximum === \"number\") {\n    schema.exclusiveMaximum = value.exclusiveMaximum;\n  }\n  if (typeof value.minLength === \"number\") {\n    schema.minLength = value.minLength;\n  }\n  if (typeof value.maxLength === \"number\") {\n    schema.maxLength = value.maxLength;\n  }\n  if (typeof value.pattern === \"string\") {\n    schema.pattern = value.pattern;\n  }\n  if (typeof value.format === \"string\") {\n    schema.format = value.format;\n  }\n  if (typeof value.minItems === \"number\") {\n    schema.minItems = value.minItems;\n  }\n  if (typeof value.maxItems === \"number\") {\n    schema.maxItems = value.maxItems;\n  }\n  if (typeof value.uniqueItems === \"boolean\") {\n    schema.uniqueItems = value.uniqueItems;\n  }\n  if (typeof value.minProperties === \"number\") {\n    schema.minProperties = value.minProperties;\n  }\n  if (typeof value.maxProperties === \"number\") {\n    schema.maxProperties = value.maxProperties;\n  }\n  if (typeof value.additionalProperties === \"boolean\") {\n    schema.additionalProperties = value.additionalProperties;\n  } else if (isRecord(value.additionalProperties)) {\n    schema.additionalProperties = toJsonSchema(value.additionalProperties);\n  }\n  if (Array.isArray(value.oneOf)) {\n    schema.oneOf = value.oneOf.map(toJsonSchema);\n  }\n  if (Array.isArray(value.anyOf)) {\n    schema.anyOf = value.anyOf.map(toJsonSchema);\n  }\n  if (Array.isArray(value.allOf)) {\n    schema.allOf = value.allOf.map(toJsonSchema);\n  }\n\n  return schema;\n}\n\nfunction convertEnum(schema: JsonSchema): TSchema | null {\n  if (!schema.enum || schema.enum.length === 0) {\n    return null;\n  }\n\n  if (!schema.enum.every(isPrimitiveLiteral)) {\n    return Type.Unsafe(schema);\n  }\n\n  const baseOptions = pickOptions(schema, SCHEMA_OPTION_KEYS);\n  if (schema.enum.length === 1) {\n    return literalSchema(schema.enum[0], baseOptions);\n  }\n\n  return Type.Union(\n    schema.enum.map(value => literalSchema(value)),\n    baseOptions,\n  );\n}\n\nfunction convertObjectSchema(schema: JsonSchema): TSchema {\n  const properties = schema.properties ?? {};\n  const required = new Set(schema.required ?? []);\n\n  const convertedProperties = Object.fromEntries(\n    Object.entries(properties).map(([key, value]) => {\n      const converted = convertSchemaNode(value);\n      return [key, required.has(key) ? converted : Type.Optional(converted)];\n    }),\n  );\n\n  const options = pickOptions(schema, [...SCHEMA_OPTION_KEYS, \"minProperties\", \"maxProperties\"]);\n  if (typeof schema.additionalProperties === \"boolean\") {\n    options.additionalProperties = schema.additionalProperties;\n  } else if (schema.additionalProperties) {\n    options.additionalProperties = convertSchemaNode(schema.additionalProperties);\n  }\n\n  return Type.Object(convertedProperties, options);\n}\n\nfunction convertArraySchema(schema: JsonSchema): TSchema {\n  const itemSchema = schema.items ? convertSchemaNode(schema.items) : Type.Unknown();\n  return Type.Array(itemSchema, pickOptions(schema, [...SCHEMA_OPTION_KEYS, \"minItems\", \"maxItems\", \"uniqueItems\"]));\n}\n\nfunction convertSingleTypeSchema(schema: JsonSchema, type: JsonSchemaType): TSchema {\n  switch (type) {\n    case \"string\":\n      return Type.String(pickOptions(schema, [...SCHEMA_OPTION_KEYS, \"minLength\", \"maxLength\", \"pattern\", \"format\"]));\n    case \"number\":\n      return Type.Number(\n        pickOptions(schema, [...SCHEMA_OPTION_KEYS, \"minimum\", \"maximum\", \"exclusiveMinimum\", \"exclusiveMaximum\"]),\n      );\n    case \"integer\":\n      return Type.Integer(\n        pickOptions(schema, [...SCHEMA_OPTION_KEYS, \"minimum\", \"maximum\", \"exclusiveMinimum\", \"exclusiveMaximum\"]),\n      );\n    case \"boolean\":\n      return Type.Boolean(pickOptions(schema, SCHEMA_OPTION_KEYS));\n    case \"null\":\n      return Type.Null(pickOptions(schema, SCHEMA_OPTION_KEYS));\n    case \"array\":\n      return convertArraySchema(schema);\n    case \"object\":\n      return convertObjectSchema(schema);\n    default:\n      return Type.Unknown(pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n}\n\nfunction convertSchemaNode(schema: JsonSchema): TSchema {\n  const enumSchema = convertEnum(schema);\n  if (enumSchema) {\n    return enumSchema;\n  }\n\n  if (schema.const !== undefined && isPrimitiveLiteral(schema.const)) {\n    return literalSchema(schema.const, pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n\n  if (schema.oneOf && schema.oneOf.length > 0) {\n    return Type.Union(schema.oneOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n\n  if (schema.anyOf && schema.anyOf.length > 0) {\n    return Type.Union(schema.anyOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n\n  if (schema.allOf && schema.allOf.length > 0) {\n    return Type.Intersect(schema.allOf.map(convertSchemaNode), pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n\n  if (schema.type === undefined) {\n    if (schema.properties) {\n      return convertObjectSchema({ ...schema, type: \"object\" });\n    }\n    if (schema.items) {\n      return convertArraySchema({ ...schema, type: \"array\" });\n    }\n    return Type.Unknown(pickOptions(schema, SCHEMA_OPTION_KEYS));\n  }\n\n  const types = Array.isArray(schema.type) ? schema.type : [schema.type];\n  if (types.length === 1) {\n    return convertSingleTypeSchema(schema, types[0]);\n  }\n\n  return Type.Union(\n    types.map(type => convertSingleTypeSchema(schema, type)),\n    pickOptions(schema, SCHEMA_OPTION_KEYS),\n  );\n}\n\nfunction convertSchema(mcpSchema: unknown): TSchema {\n  return convertSchemaNode(toJsonSchema(mcpSchema));\n}\n\n/**\n * Register all Phantom MCP tools with OpenClaw\n */\nexport function registerPhantomTools(api: OpenClawApi, session: PluginSession): void {\n  for (const mcpTool of tools) {\n    api.registerTool({\n      name: mcpTool.name,\n      description: mcpTool.description,\n      parameters: convertSchema(mcpTool.inputSchema),\n      async execute(_id: string, params: Record<string, unknown>) {\n        // Create tool context for MCP tool with recursive logger\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const createLogger = (prefix: string): any => ({\n          info: (msg: string) => console.info(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          error: (msg: string) => console.error(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          debug: (msg: string) => console.debug(`[${prefix}] ${msg}`), // eslint-disable-line no-console\n          child: (name: string) => createLogger(`${prefix}:${name}`),\n        });\n\n        const context = {\n          client: session.getClient(),\n          session: session.getSession(),\n          logger: createLogger(mcpTool.name),\n        };\n\n        try {\n          // Execute the MCP tool handler\n          const result = await mcpTool.handler(params, context);\n\n          // Return in OpenClaw format with defensive handling for undefined\n          const normalized = result ?? null;\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: typeof normalized === \"string\" ? normalized : JSON.stringify(normalized, null, 2),\n              },\n            ],\n          };\n        } catch (error) {\n          const errorMessage = error instanceof Error ? error.message : String(error);\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: JSON.stringify({ error: errorMessage }, null, 2),\n              },\n            ],\n            isError: true,\n          };\n        }\n      },\n    });\n  }\n}\n","/**\n * Phantom OpenClaw Plugin\n *\n * Integrates Phantom wallet operations directly with OpenClaw agents\n * by wrapping the Phantom MCP Server tools.\n */\n\nimport type { OpenClawApi } from \"./client/types.js\";\nimport { PluginSession } from \"./session.js\";\nimport { registerPhantomTools } from \"./tools/register-tools.js\";\n\n// Singleton session instance\nlet sessionInstance: PluginSession | null = null;\nconst PLUGIN_ID = \"phantom-openclaw-plugin\";\n\nconst STRING_CONFIG_KEYS = [\n  \"PHANTOM_APP_ID\",\n  \"PHANTOM_CLIENT_ID\",\n  \"PHANTOM_CLIENT_SECRET\",\n  \"PHANTOM_AUTH_BASE_URL\",\n  \"PHANTOM_CONNECT_BASE_URL\",\n  \"PHANTOM_API_BASE_URL\",\n  \"PHANTOM_CALLBACK_PATH\",\n  \"PHANTOM_SSO_PROVIDER\",\n  \"PHANTOM_MCP_DEBUG\",\n] as const;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\n/**\n * OpenClaw passes the full openclaw.json object as api.config.\n * Extract this plugin's scoped config when available.\n */\nfunction getPluginConfig(fullConfig?: Record<string, unknown>): Record<string, unknown> | undefined {\n  if (!fullConfig) {\n    return undefined;\n  }\n\n  const plugins = fullConfig.plugins;\n  if (!isRecord(plugins)) {\n    return fullConfig;\n  }\n\n  const entries = plugins.entries;\n  if (!isRecord(entries)) {\n    return fullConfig;\n  }\n\n  const pluginEntry = entries[PLUGIN_ID];\n  if (!isRecord(pluginEntry)) {\n    return fullConfig;\n  }\n\n  const pluginConfig = pluginEntry.config;\n  if (isRecord(pluginConfig)) {\n    return pluginConfig;\n  }\n\n  return fullConfig;\n}\n\nfunction applyConfigToEnv(config?: Record<string, unknown>): void {\n  if (!config) {\n    return;\n  }\n\n  for (const key of STRING_CONFIG_KEYS) {\n    const value = config[key];\n    if (typeof value === \"string\" && value.trim().length > 0) {\n      process.env[key] = value.trim();\n    }\n  }\n\n  const rawPort = config.PHANTOM_CALLBACK_PORT;\n  let parsedPort: number | null = null;\n\n  if (typeof rawPort === \"number\") {\n    parsedPort = rawPort;\n  } else if (typeof rawPort === \"string\") {\n    const parsed = Number.parseInt(rawPort, 10);\n    parsedPort = Number.isNaN(parsed) ? null : parsed;\n  }\n\n  if (parsedPort !== null && Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535) {\n    process.env.PHANTOM_CALLBACK_PORT = String(parsedPort);\n  }\n}\n\n/**\n * Get or create the plugin session with configuration\n */\nfunction getSession(config?: Record<string, unknown>): PluginSession {\n  if (!sessionInstance) {\n    const pluginConfig = getPluginConfig(config);\n    applyConfigToEnv(pluginConfig);\n\n    const appId = (process.env.PHANTOM_APP_ID ?? process.env.PHANTOM_CLIENT_ID)?.trim();\n    if (!appId) {\n      throw new Error(\n        'PHANTOM_APP_ID is required. Configure it in \"~/.openclaw/openclaw.json\" at plugins.entries[\"phantom-openclaw-plugin\"].config.PHANTOM_APP_ID',\n      );\n    }\n\n    const envPort = process.env.PHANTOM_CALLBACK_PORT?.trim();\n    const parsedPort = envPort ? Number.parseInt(envPort, 10) : NaN;\n    const callbackPort = Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535 ? parsedPort : undefined;\n\n    sessionInstance = new PluginSession({\n      appId,\n      callbackPort,\n    });\n  }\n  return sessionInstance;\n}\n\n/**\n * Reset the session singleton (used for cleanup on initialization failure)\n */\nfunction resetSession(): void {\n  sessionInstance = null;\n}\n\n/**\n * Plugin registration function\n */\nexport default async function register(api: OpenClawApi) {\n  try {\n    // Initialize session (authenticate if needed)\n    const session = getSession(api.config);\n    await session.initialize();\n\n    // Register all Phantom MCP tools\n    registerPhantomTools(api, session);\n  } catch (error) {\n    console.error(\"Failed to initialize Phantom OpenClaw plugin:\", error); // eslint-disable-line no-console\n    // Reset singleton so next attempt gets a fresh instance\n    resetSession();\n    throw error;\n  }\n}\n"],"mappings":"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","names":["isRecord"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/phantom-openclaw-plugin",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "OpenClaw plugin that bridges tool calls to Phantom's MCP server for wallet operations.",
   "repository": {
     "type": "git",
@@ -43,7 +43,7 @@
     "typescript": "^5.0.4"
   },
   "dependencies": {
-    "@phantom/mcp-server": "workspace:^",
+    "@phantom/mcp-server": "^0.2.2",
     "@sinclair/typebox": "^0.32.0"
   },
   "files": [
@@ -55,4 +55,4 @@
   "publishConfig": {
     "directory": "_release/package"
   }
-}
+}