@alfe.ai/openclaw-mobile 0.0.11 → 0.0.13

package/dist/plugin.cjs

@@ -160,7 +160,6 @@ const plugin = {
 	version: pkg.version,
 	activate(api) {
 		const log = api.logger;
-		if (api.registrationMode && api.registrationMode !== "full") return;
 		for (const tool of mobileTools) api.registerTool(tool);
 		log.info(`Registered ${String(mobileTools.length)} mobile tools: ${mobileTools.map((t) => t.name).join(", ")}`);
 		if (!globalThis.__mobilePluginActivated) {

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;UAqBU,MAAA,CAsB0D;EAAO,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EA8LrE,IAAA,CAAA,GAAA,EA4CL,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAAA,KAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;OAtCe,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;UAnNN,iBAAA,CAqPyB;UApPzB;;qBAEW;uEACkD;4DACX;;;;UAKlD,OAAA;;;;cAII;wCAC0B,4BAA4B;;;;;;;;cA8L9D;;;;;gBAMU;kBAkCE"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;UAqBU,MAAA,CAsB0D;EAAO,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EA8LrE,IAAA,CAAA,GAAA,EAwCL,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAAA,KAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;OAlCe,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;UAnNN,iBAAA,CAiPyB;UAhPzB;;qBAEW;uEACkD;4DACX;;;;UAKlD,OAAA;;;;cAII;wCAC0B,4BAA4B;;;;;;;;cA8L9D;;;;;gBAMU;kBA8BE"}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;UAqBU,MAAA,CAsB0D;EAAO,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EA8LrE,IAAA,CAAA,GAAA,EA4CL,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAAA,KAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;OAtCe,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;UAnNN,iBAAA,CAqPyB;UApPzB;;qBAEW;uEACkD;4DACX;;;;UAKlD,OAAA;;;;cAII;wCAC0B,4BAA4B;;;;;;;;cA8L9D;;;;;gBAMU;kBAkCE"}
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;UAqBU,MAAA,CAsB0D;EAAO,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EA8LrE,IAAA,CAAA,GAAA,EAwCL,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAAA,KAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;OAlCe,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;UAnNN,iBAAA,CAiPyB;UAhPzB;;qBAEW;uEACkD;4DACX;;;;UAKlD,OAAA;;;;cAII;wCAC0B,4BAA4B;;;;;;;;cA8L9D;;;;;gBAMU;kBA8BE"}

package/dist/plugin.js

@@ -161,7 +161,6 @@ const plugin = {
 	version: pkg.version,
 	activate(api) {
 		const log = api.logger;
-		if (api.registrationMode && api.registrationMode !== "full") return;
 		for (const tool of mobileTools) api.registerTool(tool);
 		log.info(`Registered ${String(mobileTools.length)} mobile tools: ${mobileTools.map((t) => t.name).join(", ")}`);
 		if (!globalThis.__mobilePluginActivated) {

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["/**\n * @alfe/openclaw-mobile — OpenClaw native plugin\n *\n * Registers mobile tools (SMS, calls, number management) with OpenClaw.\n * Tools call the mobile service API using the agent's API key for authentication.\n *\n * This plugin provides:\n *   - mobile_get_number — check if a phone number is assigned\n *   - mobile_search_numbers — search available numbers for purchase\n *   - mobile_assign_number — purchase and assign a phone number\n *   - mobile_release_number — release the assigned phone number\n *   - mobile_send_sms — send an SMS message from the agent's phone number\n *   - mobile_call — initiate an outbound phone call\n */\n\nimport { Type, type TSchema } from \"@sinclair/typebox\";\nimport { resolveConfig } from \"@alfe.ai/config\";\nimport { createRequire } from 'node:module';\nconst require = createRequire(import.meta.url);\nconst pkg = require('../package.json') as { version: string };\n\ninterface Logger {\n  info(msg: string, ...args: unknown[]): void;\n  warn(msg: string, ...args: unknown[]): void;\n  error(msg: string, ...args: unknown[]): void;\n  debug(msg: string, ...args: unknown[]): void;\n}\n\ninterface OpenClawPluginApi {\n  logger: Logger;\n  registrationMode?: \"full\" | \"setup-only\" | \"setup-runtime\" | \"cli-metadata\";\n  registerTool(tool: ToolDef): void;\n  registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;\n  on(event: string, handler: (...args: unknown[]) => void | Promise<void>, options?: { priority?: number }): void;\n}\n\n// ── Tool types ───────────────────────────────────────────────\n\ninterface ToolDef {\n  name: string;\n  description: string;\n  label: string;\n  parameters: TSchema;\n  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<{\n    content: { type: \"text\"; text: string }[];\n    details: unknown;\n  }>;\n}\n\nfunction ok(data: unknown) {\n  return { content: [{ type: \"text\" as const, text: JSON.stringify(data) }], details: data };\n}\n\nfunction errResult(message: string) {\n  return { content: [{ type: \"text\" as const, text: JSON.stringify({ error: message }) }], details: { error: message } };\n}\n\nfunction defineTool(def: {\n  name: string;\n  description: string;\n  parameters: TSchema;\n  handler: (params: Record<string, unknown>) => Promise<unknown>;\n}): ToolDef {\n  return {\n    name: def.name,\n    description: def.description,\n    label: def.name,\n    parameters: def.parameters,\n    execute: async (_toolCallId: string, params: Record<string, unknown>) => {\n      try {\n        const result = await def.handler(params);\n        return ok(result);\n      } catch (e) {\n        return errResult((e as Error).message);\n      }\n    },\n  };\n}\n\n// ── API client ───────────────────────────────────────────────\n\nlet apiUrl = \"\";\nlet apiKey = \"\";\n\nasync function mobileApi(\n  method: string,\n  path: string,\n  body?: Record<string, unknown>,\n  query?: Record<string, string | undefined>,\n): Promise<Record<string, unknown>> {\n  let url = `${apiUrl}${path}`;\n  if (query) {\n    const entries = Object.entries(query).filter((entry): entry is [string, string] => entry[1] !== undefined);\n    if (entries.length > 0) {\n      url += `?${new URLSearchParams(entries).toString()}`;\n    }\n  }\n\n  const headers: Record<string, string> = {\n    \"Content-Type\": \"application/json\",\n    Authorization: `Bearer ${apiKey}`,\n  };\n\n  const res = await fetch(url, {\n    method,\n    headers,\n    body: body ? JSON.stringify(body) : undefined,\n  });\n\n  const json = (await res.json()) as Record<string, unknown>;\n  if (!res.ok) {\n    // Extract Zod validation issues if present (returned as { message: \"CORE_VALIDATION_FAILED\", issues: [...] })\n    const issues = json.issues as { path?: string[]; message?: string }[] | undefined;\n    if (Array.isArray(issues) && issues.length > 0) {\n      const details = issues\n        .map((i) => {\n          const field = i.path?.join(\".\") ?? \"input\";\n          return `${field}: ${i.message ?? \"invalid\"}`;\n        })\n        .join(\"; \");\n      throw new Error(`Validation error — ${details}`);\n    }\n\n    const errorMsg = typeof json.error === \"string\"\n      ? json.error\n      : typeof json.message === \"string\"\n        ? json.message\n        : `Mobile service returned ${String(res.status)}`;\n    throw new Error(errorMsg);\n  }\n\n  // unwrap { data: ... } envelope if present\n  if (json.data && typeof json.data === \"object\") {\n    return json.data as Record<string, unknown>;\n  }\n  return json;\n}\n\n// ── Tool definitions ─────────────────────────────────────────\n\nconst mobileTools: ToolDef[] = [\n  // ── Number management ───────────────────────────────────────\n  defineTool({\n    name: \"mobile_get_number\",\n    description:\n      \"Check if you have a phone number assigned. Returns the phone number, \" +\n      \"country code, monthly price, and status. If no number is assigned, \" +\n      \"use mobile_search_numbers and mobile_assign_number to get one.\",\n    parameters: Type.Object({}),\n    handler: async () => {\n      return mobileApi(\"GET\", \"/mobile/numbers\");\n    },\n  }),\n\n  defineTool({\n    name: \"mobile_search_numbers\",\n    description:\n      \"Search for available phone numbers that can be purchased. \" +\n      \"Returns a list of available numbers and the monthly price. \" +\n      \"Supported countries: AU (Australia), US (United States), CA (Canada), GB (United Kingdom).\",\n    parameters: Type.Object({\n      country: Type.Optional(Type.String({ description: \"Country code: AU, US, CA, or GB (default: AU)\" })),\n      query: Type.Optional(Type.String({ description: \"Optional search pattern — area code or text to match (e.g., '415' or 'COOL')\" })),\n    }),\n    handler: async (params) => {\n      const { country, query } = params as { country?: string; query?: string };\n      return mobileApi(\"GET\", \"/mobile/numbers/search\", undefined, { country, query });\n    },\n  }),\n\n  defineTool({\n    name: \"mobile_assign_number\",\n    description:\n      \"Purchase and assign a phone number to yourself. You must search for available \" +\n      \"numbers first using mobile_search_numbers, then pass the chosen phoneNumber and \" +\n      \"countryCode here. Your organisation must have a payment method on file. \" +\n      \"The number will be billed monthly to the organisation's account.\",\n    parameters: Type.Object({\n      phoneNumber: Type.String({ description: \"The phone number to purchase (from mobile_search_numbers results)\" }),\n      countryCode: Type.String({ description: \"Country code: AU, US, CA, or GB\" }),\n    }),\n    handler: async (params) => {\n      const { phoneNumber, countryCode } = params as { phoneNumber: string; countryCode: string };\n      return mobileApi(\"POST\", \"/mobile/numbers/assign\", { phoneNumber, countryCode });\n    },\n  }),\n\n  defineTool({\n    name: \"mobile_release_number\",\n    description:\n      \"Release your currently assigned phone number. This will cancel the monthly \" +\n      \"subscription and the number will no longer be available for calls or SMS. \" +\n      \"This action cannot be undone — the same number may not be available again.\",\n    parameters: Type.Object({}),\n    handler: async () => {\n      return mobileApi(\"POST\", \"/mobile/numbers/release\", {});\n    },\n  }),\n\n  // ── Messaging & calls ───────────────────────────────────────\n  defineTool({\n    name: \"mobile_send_sms\",\n    description:\n      \"Send an SMS text message from your phone number to the specified number. \" +\n      \"The recipient number must be in E.164 format (e.g., +12025551234).\",\n    parameters: Type.Object({\n      to: Type.String({ description: \"Recipient phone number in E.164 format (e.g., +12025551234)\" }),\n      body: Type.String({ description: \"The text message content to send\" }),\n    }),\n    handler: async (params) => {\n      const { to, body } = params as { to: string; body: string };\n      return mobileApi(\"POST\", \"/mobile/sms/send\", { to, body });\n    },\n  }),\n\n  defineTool({\n    name: \"mobile_call\",\n    description:\n      \"Make an outbound phone call to the specified number. \" +\n      \"When the recipient answers, they will be connected to your voice pipeline. \" +\n      \"The number must be in E.164 format (e.g., +12025551234).\",\n    parameters: Type.Object({\n      to: Type.String({ description: \"Phone number to call in E.164 format (e.g., +12025551234)\" }),\n    }),\n    handler: async (params) => {\n      const { to } = params as { to: string };\n      return mobileApi(\"POST\", \"/mobile/calls/outbound\", { to });\n    },\n  }),\n];\n\n// ── Plugin definition ────────────────────────────────────────\n\nconst plugin = {\n  id: \"@alfe.ai/openclaw-mobile\",\n  name: \"Alfe Mobile Plugin\",\n  description: \"Mobile integration — phone number management, SMS, and phone calls via Twilio\",\n  version: pkg.version,\n\n  activate(api: OpenClawPluginApi) {\n    const log = api.logger;\n\n    // Only run during full gateway execution — skip CLI commands, setup, etc.\n    if (api.registrationMode && api.registrationMode !== \"full\") {\n      return;\n    }\n\n    // Always register tools — OpenClaw may reload the plugin registry per-session\n    for (const tool of mobileTools) {\n      api.registerTool(tool);\n    }\n    log.info(`Registered ${String(mobileTools.length)} mobile tools: ${mobileTools.map((t) => t.name).join(\", \")}`);\n\n    // Only initialize config once (side effects)\n    if (!(globalThis as Record<string, unknown>).__mobilePluginActivated) {\n      (globalThis as Record<string, unknown>).__mobilePluginActivated = true;\n      log.info(\"Alfe Mobile plugin activating...\");\n\n      try {\n        const config = resolveConfig();\n        apiUrl = config.apiUrl;\n        apiKey = config.apiKey;\n      } catch (err) {\n        log.error(`Failed to resolve config: ${err instanceof Error ? err.message : String(err)}`);\n        log.warn(\"Mobile tools will fail — no API config available\");\n      }\n\n      log.info(`Mobile API: ${apiUrl}`);\n    }\n\n    log.info(\"Alfe Mobile plugin activated\");\n  },\n\n  deactivate(api: OpenClawPluginApi) {\n    (globalThis as Record<string, unknown>).__mobilePluginActivated = false;\n    api.logger.info(\"Alfe Mobile plugin deactivated\");\n  },\n};\n\nexport default plugin;\n"],"mappings":"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"}
+{"version":3,"file":"plugin.js","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["/**\n * @alfe/openclaw-mobile — OpenClaw native plugin\n *\n * Registers mobile tools (SMS, calls, number management) with OpenClaw.\n * Tools call the mobile service API using the agent's API key for authentication.\n *\n * This plugin provides:\n *   - mobile_get_number — check if a phone number is assigned\n *   - mobile_search_numbers — search available numbers for purchase\n *   - mobile_assign_number — purchase and assign a phone number\n *   - mobile_release_number — release the assigned phone number\n *   - mobile_send_sms — send an SMS message from the agent's phone number\n *   - mobile_call — initiate an outbound phone call\n */\n\nimport { Type, type TSchema } from \"@sinclair/typebox\";\nimport { resolveConfig } from \"@alfe.ai/config\";\nimport { createRequire } from 'node:module';\nconst require = createRequire(import.meta.url);\nconst pkg = require('../package.json') as { version: string };\n\ninterface Logger {\n  info(msg: string, ...args: unknown[]): void;\n  warn(msg: string, ...args: unknown[]): void;\n  error(msg: string, ...args: unknown[]): void;\n  debug(msg: string, ...args: unknown[]): void;\n}\n\ninterface OpenClawPluginApi {\n  logger: Logger;\n  registrationMode?: \"full\" | \"setup-only\" | \"setup-runtime\" | \"cli-metadata\";\n  registerTool(tool: ToolDef): void;\n  registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;\n  on(event: string, handler: (...args: unknown[]) => void | Promise<void>, options?: { priority?: number }): void;\n}\n\n// ── Tool types ───────────────────────────────────────────────\n\ninterface ToolDef {\n  name: string;\n  description: string;\n  label: string;\n  parameters: TSchema;\n  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<{\n    content: { type: \"text\"; text: string }[];\n    details: unknown;\n  }>;\n}\n\nfunction ok(data: unknown) {\n  return { content: [{ type: \"text\" as const, text: JSON.stringify(data) }], details: data };\n}\n\nfunction errResult(message: string) {\n  return { content: [{ type: \"text\" as const, text: JSON.stringify({ error: message }) }], details: { error: message } };\n}\n\nfunction defineTool(def: {\n  name: string;\n  description: string;\n  parameters: TSchema;\n  handler: (params: Record<string, unknown>) => Promise<unknown>;\n}): ToolDef {\n  return {\n    name: def.name,\n    description: def.description,\n    label: def.name,\n    parameters: def.parameters,\n    execute: async (_toolCallId: string, params: Record<string, unknown>) => {\n      try {\n        const result = await def.handler(params);\n        return ok(result);\n      } catch (e) {\n        return errResult((e as Error).message);\n      }\n    },\n  };\n}\n\n// ── API client ───────────────────────────────────────────────\n\nlet apiUrl = \"\";\nlet apiKey = \"\";\n\nasync function mobileApi(\n  method: string,\n  path: string,\n  body?: Record<string, unknown>,\n  query?: Record<string, string | undefined>,\n): Promise<Record<string, unknown>> {\n  let url = `${apiUrl}${path}`;\n  if (query) {\n    const entries = Object.entries(query).filter((entry): entry is [string, string] => entry[1] !== undefined);\n    if (entries.length > 0) {\n      url += `?${new URLSearchParams(entries).toString()}`;\n    }\n  }\n\n  const headers: Record<string, string> = {\n    \"Content-Type\": \"application/json\",\n    Authorization: `Bearer ${apiKey}`,\n  };\n\n  const res = await fetch(url, {\n    method,\n    headers,\n    body: body ? JSON.stringify(body) : undefined,\n  });\n\n  const json = (await res.json()) as Record<string, unknown>;\n  if (!res.ok) {\n    // Extract Zod validation issues if present (returned as { message: \"CORE_VALIDATION_FAILED\", issues: [...] })\n    const issues = json.issues as { path?: string[]; message?: string }[] | undefined;\n    if (Array.isArray(issues) && issues.length > 0) {\n      const details = issues\n        .map((i) => {\n          const field = i.path?.join(\".\") ?? \"input\";\n          return `${field}: ${i.message ?? \"invalid\"}`;\n        })\n        .join(\"; \");\n      throw new Error(`Validation error — ${details}`);\n    }\n\n    const errorMsg = typeof json.error === \"string\"\n      ? json.error\n      : typeof json.message === \"string\"\n        ? json.message\n        : `Mobile service returned ${String(res.status)}`;\n    throw new Error(errorMsg);\n  }\n\n  // unwrap { data: ... } envelope if present\n  if (json.data && typeof json.data === \"object\") {\n    return json.data as Record<string, unknown>;\n  }\n  return json;\n}\n\n// ── Tool definitions ─────────────────────────────────────────\n\nconst mobileTools: ToolDef[] = [\n  // ── Number management ───────────────────────────────────────\n  defineTool({\n    name: \"mobile_get_number\",\n    description:\n      \"Check if you have a phone number assigned. Returns the phone number, \" +\n      \"country code, monthly price, and status. If no number is assigned, \" +\n      \"use mobile_search_numbers and mobile_assign_number to get one.\",\n    parameters: Type.Object({}),\n    handler: async () => {\n      return mobileApi(\"GET\", \"/mobile/numbers\");\n    },\n  }),\n\n  defineTool({\n    name: \"mobile_search_numbers\",\n    description:\n      \"Search for available phone numbers that can be purchased. \" +\n      \"Returns a list of available numbers and the monthly price. \" +\n      \"Supported countries: AU (Australia), US (United States), CA (Canada), GB (United Kingdom).\",\n    parameters: Type.Object({\n      country: Type.Optional(Type.String({ description: \"Country code: AU, US, CA, or GB (default: AU)\" })),\n      query: Type.Optional(Type.String({ description: \"Optional search pattern — area code or text to match (e.g., '415' or 'COOL')\" })),\n    }),\n    handler: async (params) => {\n      const { country, query } = params as { country?: string; query?: string };\n      return mobileApi(\"GET\", \"/mobile/numbers/search\", undefined, { country, query });\n    },\n  }),\n\n  defineTool({\n    name: \"mobile_assign_number\",\n    description:\n      \"Purchase and assign a phone number to yourself. You must search for available \" +\n      \"numbers first using mobile_search_numbers, then pass the chosen phoneNumber and \" +\n      \"countryCode here. Your organisation must have a payment method on file. \" +\n      \"The number will be billed monthly to the organisation's account.\",\n    parameters: Type.Object({\n      phoneNumber: Type.String({ description: \"The phone number to purchase (from mobile_search_numbers results)\" }),\n      countryCode: Type.String({ description: \"Country code: AU, US, CA, or GB\" }),\n    }),\n    handler: async (params) => {\n      const { phoneNumber, countryCode } = params as { phoneNumber: string; countryCode: string };\n      return mobileApi(\"POST\", \"/mobile/numbers/assign\", { phoneNumber, countryCode });\n    },\n  }),\n\n  defineTool({\n    name: \"mobile_release_number\",\n    description:\n      \"Release your currently assigned phone number. This will cancel the monthly \" +\n      \"subscription and the number will no longer be available for calls or SMS. \" +\n      \"This action cannot be undone — the same number may not be available again.\",\n    parameters: Type.Object({}),\n    handler: async () => {\n      return mobileApi(\"POST\", \"/mobile/numbers/release\", {});\n    },\n  }),\n\n  // ── Messaging & calls ───────────────────────────────────────\n  defineTool({\n    name: \"mobile_send_sms\",\n    description:\n      \"Send an SMS text message from your phone number to the specified number. \" +\n      \"The recipient number must be in E.164 format (e.g., +12025551234).\",\n    parameters: Type.Object({\n      to: Type.String({ description: \"Recipient phone number in E.164 format (e.g., +12025551234)\" }),\n      body: Type.String({ description: \"The text message content to send\" }),\n    }),\n    handler: async (params) => {\n      const { to, body } = params as { to: string; body: string };\n      return mobileApi(\"POST\", \"/mobile/sms/send\", { to, body });\n    },\n  }),\n\n  defineTool({\n    name: \"mobile_call\",\n    description:\n      \"Make an outbound phone call to the specified number. \" +\n      \"When the recipient answers, they will be connected to your voice pipeline. \" +\n      \"The number must be in E.164 format (e.g., +12025551234).\",\n    parameters: Type.Object({\n      to: Type.String({ description: \"Phone number to call in E.164 format (e.g., +12025551234)\" }),\n    }),\n    handler: async (params) => {\n      const { to } = params as { to: string };\n      return mobileApi(\"POST\", \"/mobile/calls/outbound\", { to });\n    },\n  }),\n];\n\n// ── Plugin definition ────────────────────────────────────────\n\nconst plugin = {\n  id: \"@alfe.ai/openclaw-mobile\",\n  name: \"Alfe Mobile Plugin\",\n  description: \"Mobile integration — phone number management, SMS, and phone calls via Twilio\",\n  version: pkg.version,\n\n  activate(api: OpenClawPluginApi) {\n    const log = api.logger;\n\n\n    // Always register tools — OpenClaw may reload the plugin registry per-session\n    for (const tool of mobileTools) {\n      api.registerTool(tool);\n    }\n    log.info(`Registered ${String(mobileTools.length)} mobile tools: ${mobileTools.map((t) => t.name).join(\", \")}`);\n\n    // Only initialize config once (side effects)\n    if (!(globalThis as Record<string, unknown>).__mobilePluginActivated) {\n      (globalThis as Record<string, unknown>).__mobilePluginActivated = true;\n      log.info(\"Alfe Mobile plugin activating...\");\n\n      try {\n        const config = resolveConfig();\n        apiUrl = config.apiUrl;\n        apiKey = config.apiKey;\n      } catch (err) {\n        log.error(`Failed to resolve config: ${err instanceof Error ? err.message : String(err)}`);\n        log.warn(\"Mobile tools will fail — no API config available\");\n      }\n\n      log.info(`Mobile API: ${apiUrl}`);\n    }\n\n    log.info(\"Alfe Mobile plugin activated\");\n  },\n\n  deactivate(api: OpenClawPluginApi) {\n    (globalThis as Record<string, unknown>).__mobilePluginActivated = false;\n    api.logger.info(\"Alfe Mobile plugin deactivated\");\n  },\n};\n\nexport default plugin;\n"],"mappings":"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"}

package/openclaw.plugin.json

@@ -3,6 +3,17 @@
   "name": "Mobile",
   "description": "Outbound SMS and phone calls via Twilio",
   "entry": "./dist/plugin.js",
+  "activation": { "onStartup": false },
+  "contracts": {
+    "tools": [
+      "mobile_send_sms",
+      "mobile_call",
+      "mobile_search_numbers",
+      "mobile_assign_number",
+      "mobile_get_number",
+      "mobile_release_number"
+    ]
+  },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-mobile",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "OpenClaw mobile plugin for Alfe — phone number management, SMS, and calls via Twilio",
   "type": "module",
   "main": "./dist/index.js",