@alfe.ai/openclaw-mobile 0.0.25 → 0.0.27

package/dist/index.d.cts

@@ -1,2 +1,2 @@
-import plugin from "./plugin.cjs";
+import { t as plugin } from "./plugin.cjs";
 export { plugin as default };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import plugin from "./plugin.js";
+import { t as plugin } from "./plugin.js";
 export { plugin as default };

package/dist/plugin.cjs

@@ -1,6 +1,8 @@
-let _sinclair_typebox = require("@sinclair/typebox");
+let node_module = require("node:module");
 let _alfe_ai_config = require("@alfe.ai/config");
 let _alfe_ai_agent_api_client = require("@alfe.ai/agent-api-client");
+let _alfe_ai_openclaw_plugin_kit = require("@alfe.ai/openclaw-plugin-kit");
+let _sinclair_typebox = require("@sinclair/typebox");
 //#region src/plugin.ts
 /**
 * @alfe/openclaw-mobile — OpenClaw native plugin
@@ -16,141 +18,161 @@ let _alfe_ai_agent_api_client = require("@alfe.ai/agent-api-client");
 *   - mobile_send_sms — send an SMS message from the agent's phone number
 *   - mobile_call — initiate an outbound phone call
 */
-const pkg = (0, require("node:module").createRequire)(require("url").pathToFileURL(__filename).href)("../package.json");
-function ok(data) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify(data)
-		}],
-		details: data
-	};
+const pkg = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href)("../package.json");
+const SUPPORTED_COUNTRIES = [
+	"AU",
+	"US",
+	"CA",
+	"GB"
+];
+const E164_PATTERN = "^\\+\\d{7,15}$";
+const E164_RE = /^\+\d{7,15}$/u;
+const NUMBER_SEARCH_RE = /^[A-Za-z0-9*+ -]+$/u;
+const MAX_SEARCH_LENGTH = 32;
+const MAX_SMS_LENGTH = 4400;
+function requireString(params, field, options) {
+	const value = params[field];
+	if (typeof value !== "string" || value.length < 1 || value.length > options.maxLength) throw (0, _alfe_ai_openclaw_plugin_kit.publicToolError)(`${field} must be a non-empty string of at most ${String(options.maxLength)} characters`);
+	if (options.pattern && !options.pattern.test(value)) throw (0, _alfe_ai_openclaw_plugin_kit.publicToolError)(`${field} has an invalid format`);
+	return value;
 }
-function errResult(message) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify({ error: message })
-		}],
-		details: { error: message }
-	};
+function optionalSearchQuery(params) {
+	if (params.query === void 0) return void 0;
+	return requireString(params, "query", {
+		maxLength: MAX_SEARCH_LENGTH,
+		pattern: NUMBER_SEARCH_RE
+	});
 }
-function defineTool(def) {
-	return {
-		name: def.name,
-		description: def.description,
-		label: def.name,
-		parameters: def.parameters,
-		execute: async (_toolCallId, params) => {
-			try {
-				return ok(await def.handler(params));
-			} catch (e) {
-				return errResult(e.message);
-			}
-		}
-	};
+function optionalCountry(params) {
+	if (params.country === void 0) return void 0;
+	return requireCountry(params, "country");
 }
-let apiUrl = "";
-let apiKey = "";
-async function mobileApi(method, path, body, query) {
-	let url = `${apiUrl}${path}`;
-	if (query) {
-		const entries = Object.entries(query).filter((entry) => entry[1] !== void 0);
-		if (entries.length > 0) url += `?${new URLSearchParams(entries).toString()}`;
-	}
-	const headers = {
-		"Content-Type": "application/json",
-		Authorization: `Bearer ${apiKey}`
-	};
-	const res = await fetch(url, {
-		method,
-		headers,
-		body: body ? JSON.stringify(body) : void 0
+function requireCountry(params, field) {
+	const value = params[field];
+	if (typeof value !== "string" || !SUPPORTED_COUNTRIES.includes(value)) throw (0, _alfe_ai_openclaw_plugin_kit.publicToolError)(`${field} must be one of ${SUPPORTED_COUNTRIES.join(", ")}`);
+	return value;
+}
+function requireE164(params, field) {
+	return requireString(params, field, {
+		maxLength: 16,
+		pattern: E164_RE
 	});
-	const json = await res.json();
-	if (!res.ok) {
-		const issues = json.issues;
-		if (Array.isArray(issues) && issues.length > 0) {
-			const details = issues.map((i) => {
-				return `${i.path?.join(".") ?? "input"}: ${i.message ?? "invalid"}`;
-			}).join("; ");
-			throw new Error(`Validation error — ${details}`);
-		}
-		const errorMsg = typeof json.error === "string" ? json.error : typeof json.message === "string" ? json.message : `Mobile service returned ${String(res.status)}`;
-		throw new Error(errorMsg);
-	}
-	if (json.data && typeof json.data === "object") return json.data;
-	return json;
+}
+function requireConfirmation(params) {
+	if (params.confirm !== true) throw (0, _alfe_ai_openclaw_plugin_kit.publicToolError)("confirm must be true after the user explicitly approves the recurring charge");
+}
+const MOBILE_ACTIVATION_KEY = (0, _alfe_ai_openclaw_plugin_kit.getActivationKey)("mobile");
+let client;
+function getClient() {
+	if (!client) throw new Error("Mobile tools unavailable — no API config resolved");
+	return client;
 }
 const mobileTools = [
-	defineTool({
+	(0, _alfe_ai_openclaw_plugin_kit.defineTool)({
 		name: "mobile_get_number",
 		description: "Check if you have a phone number assigned. Returns the phone number, country code, monthly price, and status. If no number is assigned, use mobile_search_numbers and mobile_assign_number to get one.",
-		parameters: _sinclair_typebox.Type.Object({}),
+		parameters: _sinclair_typebox.Type.Object({}, { additionalProperties: false }),
 		handler: async () => {
-			return mobileApi("GET", "/mobile/numbers");
+			return getClient().getMobileNumber();
 		}
 	}),
-	defineTool({
+	(0, _alfe_ai_openclaw_plugin_kit.defineTool)({
 		name: "mobile_search_numbers",
 		description: "Search for available phone numbers that can be purchased. Returns a list of available numbers and the monthly price. Supported countries: AU (Australia), US (United States), CA (Canada), GB (United Kingdom).",
 		parameters: _sinclair_typebox.Type.Object({
-			country: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({ description: "Country code: AU, US, CA, or GB (default: AU)" })),
-			query: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({ description: "Optional search pattern — area code or text to match (e.g., '415' or 'COOL')" }))
-		}),
+			country: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.Union(SUPPORTED_COUNTRIES.map((country) => _sinclair_typebox.Type.Literal(country)), { description: "Country code: AU, US, CA, or GB (default: AU)" })),
+			query: _sinclair_typebox.Type.Optional(_sinclair_typebox.Type.String({
+				description: "Optional search pattern — area code or text to match (e.g., '415' or 'COOL')",
+				minLength: 1,
+				maxLength: MAX_SEARCH_LENGTH,
+				pattern: NUMBER_SEARCH_RE.source
+			}))
+		}, { additionalProperties: false }),
 		handler: async (params) => {
-			const { country, query } = params;
-			return mobileApi("GET", "/mobile/numbers/search", void 0, {
+			const country = optionalCountry(params);
+			const query = optionalSearchQuery(params);
+			return getClient().searchMobileNumbers({
 				country,
 				query
 			});
 		}
 	}),
-	defineTool({
+	(0, _alfe_ai_openclaw_plugin_kit.defineTool)({
 		name: "mobile_assign_number",
-		description: "Purchase and assign a phone number to yourself. You must search for available numbers first using mobile_search_numbers, then pass the chosen phoneNumber and countryCode here. Your organisation must have a payment method on file. The number will be billed monthly to the organisation's account.",
+		description: "Purchase and assign a phone number to yourself. You must search for available numbers first using mobile_search_numbers, then pass the chosen phoneNumber and countryCode here. Your organisation must have a payment method on file. The number will be billed monthly to the organisation's account and may replace an active number. Set confirm=true only after the user explicitly approves the charge.",
 		parameters: _sinclair_typebox.Type.Object({
-			phoneNumber: _sinclair_typebox.Type.String({ description: "The phone number to purchase (from mobile_search_numbers results)" }),
-			countryCode: _sinclair_typebox.Type.String({ description: "Country code: AU, US, CA, or GB" })
-		}),
+			phoneNumber: _sinclair_typebox.Type.String({
+				description: "The phone number to purchase (from mobile_search_numbers results)",
+				minLength: 8,
+				maxLength: 16,
+				pattern: E164_PATTERN
+			}),
+			countryCode: _sinclair_typebox.Type.Union(SUPPORTED_COUNTRIES.map((country) => _sinclair_typebox.Type.Literal(country)), { description: "Country code: AU, US, CA, or GB" }),
+			confirm: _sinclair_typebox.Type.Literal(true, { description: "Must be true after the user explicitly approves the recurring charge" })
+		}, { additionalProperties: false }),
 		handler: async (params) => {
-			const { phoneNumber, countryCode } = params;
-			return mobileApi("POST", "/mobile/numbers/assign", {
+			const phoneNumber = requireE164(params, "phoneNumber");
+			const countryCode = requireCountry(params, "countryCode");
+			requireConfirmation(params);
+			return getClient().assignMobileNumber({
 				phoneNumber,
 				countryCode
 			});
 		}
 	}),
-	defineTool({
+	(0, _alfe_ai_openclaw_plugin_kit.defineTool)({
 		name: "mobile_release_number",
-		description: "Release your currently assigned phone number. This will cancel the monthly subscription and the number will no longer be available for calls or SMS. This action cannot be undone — the same number may not be available again.",
-		parameters: _sinclair_typebox.Type.Object({}),
-		handler: async () => {
-			return mobileApi("POST", "/mobile/numbers/release", {});
+		description: "Release your currently assigned phone number. This will cancel the monthly subscription and the number will no longer be available for calls or SMS. This action cannot be undone — the same number may not be available again. Copy the exact current number into confirmPhoneNumber only after the user approves.",
+		parameters: _sinclair_typebox.Type.Object({ confirmPhoneNumber: _sinclair_typebox.Type.String({
+			description: "Exact currently assigned number, copied to confirm permanent release",
+			minLength: 8,
+			maxLength: 16,
+			pattern: E164_PATTERN
+		}) }, { additionalProperties: false }),
+		handler: async (params) => {
+			const confirmPhoneNumber = requireE164(params, "confirmPhoneNumber");
+			const mobileClient = getClient();
+			if ((await mobileClient.getMobileNumber()).phoneNumber !== confirmPhoneNumber) throw (0, _alfe_ai_openclaw_plugin_kit.publicToolError)("confirmPhoneNumber does not match the currently assigned number");
+			return mobileClient.releaseMobileNumber();
 		}
 	}),
-	defineTool({
+	(0, _alfe_ai_openclaw_plugin_kit.defineTool)({
 		name: "mobile_send_sms",
 		description: "Send an SMS text message from your phone number to the specified number. The recipient number must be in E.164 format (e.g., +12025551234).",
 		parameters: _sinclair_typebox.Type.Object({
-			to: _sinclair_typebox.Type.String({ description: "Recipient phone number in E.164 format (e.g., +12025551234)" }),
-			body: _sinclair_typebox.Type.String({ description: "The text message content to send" })
-		}),
+			to: _sinclair_typebox.Type.String({
+				description: "Recipient phone number in E.164 format (e.g., +12025551234)",
+				minLength: 8,
+				maxLength: 16,
+				pattern: E164_PATTERN
+			}),
+			body: _sinclair_typebox.Type.String({
+				description: "The text message content to send",
+				minLength: 1,
+				maxLength: MAX_SMS_LENGTH
+			})
+		}, { additionalProperties: false }),
 		handler: async (params) => {
-			const { to, body } = params;
-			return mobileApi("POST", "/mobile/sms/send", {
+			const to = requireE164(params, "to");
+			const body = requireString(params, "body", { maxLength: MAX_SMS_LENGTH });
+			return getClient().sendSms({
 				to,
 				body
 			});
 		}
 	}),
-	defineTool({
+	(0, _alfe_ai_openclaw_plugin_kit.defineTool)({
 		name: "mobile_call",
 		description: "Make an outbound phone call to the specified number. When the recipient answers, they will be connected to your voice pipeline. The number must be in E.164 format (e.g., +12025551234).",
-		parameters: _sinclair_typebox.Type.Object({ to: _sinclair_typebox.Type.String({ description: "Phone number to call in E.164 format (e.g., +12025551234)" }) }),
+		parameters: _sinclair_typebox.Type.Object({ to: _sinclair_typebox.Type.String({
+			description: "Phone number to call in E.164 format (e.g., +12025551234)",
+			minLength: 8,
+			maxLength: 16,
+			pattern: E164_PATTERN
+		}) }, { additionalProperties: false }),
 		handler: async (params) => {
-			const { to } = params;
-			return mobileApi("POST", "/mobile/calls/outbound", { to });
+			const to = requireE164(params, "to");
+			return getClient().startOutboundCall({ to });
 		}
 	})
 ];
@@ -163,24 +185,27 @@ const plugin = {
 		(0, _alfe_ai_agent_api_client.installToolErrorCapture)(api, { plugin: "openclaw-mobile" });
 		const log = api.logger;
 		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) {
-			globalThis.__mobilePluginActivated = true;
+		log.info(`Registered ${String(mobileTools.length)} mobile tools: ${mobileTools.map((tool) => tool.name).join(", ")}`);
+		(0, _alfe_ai_openclaw_plugin_kit.guardedStart)(MOBILE_ACTIVATION_KEY, log, () => {
 			log.info("Alfe Mobile plugin activating...");
 			try {
 				const config = (0, _alfe_ai_config.resolveConfig)();
-				apiUrl = config.apiUrl;
-				apiKey = config.apiKey;
+				client = new _alfe_ai_agent_api_client.AgentApiClient({
+					apiUrl: config.apiUrl,
+					apiKey: config.apiKey
+				});
+				log.info("Mobile API client configured");
 			} catch (err) {
 				log.error(`Failed to resolve config: ${err instanceof Error ? err.message : String(err)}`);
 				log.warn("Mobile tools will fail — no API config available");
+				(0, _alfe_ai_openclaw_plugin_kit.resetActivation)(MOBILE_ACTIVATION_KEY);
 			}
-			log.info(`Mobile API: ${apiUrl}`);
-		}
+		});
 		log.info("Alfe Mobile plugin activated");
 	},
 	deactivate(api) {
-		globalThis.__mobilePluginActivated = false;
+		client = void 0;
+		(0, _alfe_ai_openclaw_plugin_kit.resetActivation)(MOBILE_ACTIVATION_KEY);
 		api.logger.info("Alfe Mobile plugin deactivated");
 	}
 };

package/dist/plugin.d.cts

@@ -1,5 +1,28 @@
 import { TSchema } from "@sinclair/typebox";
 
+//#region ../openclaw-plugin-kit/dist/index.d.ts
+
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+//#region src/tools.d.ts
+/** Shape returned to OpenClaw from a tool `execute`. */
+interface ToolResult {
+  content: {
+    type: "text";
+    text: string;
+  }[];
+  details: unknown;
+  isError?: boolean;
+}
+interface ToolDef<TParameters = unknown> {
+  name: string;
+  description: string;
+  label: string;
+  parameters: TParameters;
+  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;
+}
+/** Deliberately model-safe validation/usage failure. Other exceptions stay private. */
+//#endregion
 //#region src/plugin.d.ts
 
 interface Logger {
@@ -11,25 +34,12 @@ interface Logger {
 interface OpenClawPluginApi {
   logger: Logger;
   registrationMode?: "full" | "setup-only" | "setup-runtime" | "cli-metadata";
-  registerTool(tool: ToolDef): void;
+  registerTool(tool: ToolDef<TSchema>): void;
   registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;
   on(event: string, handler: (...args: unknown[]) => void | Promise<void>, options?: {
     priority?: number;
   }): void;
 }
-interface ToolDef {
-  name: string;
-  description: string;
-  label: string;
-  parameters: TSchema;
-  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<{
-    content: {
-      type: "text";
-      text: string;
-    }[];
-    details: unknown;
-  }>;
-}
 declare const plugin: {
   id: string;
   name: string;
@@ -39,5 +49,5 @@ declare const plugin: {
   deactivate(api: OpenClawPluginApi): void;
 };
 //#endregion
-export { plugin as default };
+export { plugin as t };
 //# sourceMappingURL=plugin.d.cts.map

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;UAsBU,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":["KitLogger","ToolResult","ToolDef","TParameters","Record","Promise","PublicToolError","Error","publicToolError","ok","errResult","defineTool","IpcResponse","IpcClient","IpcModule","ConnectToDaemonOptions","ConnectToDaemonDependencies","connectToDaemon","ResolveOpenClawSdkOptions","ResolveOpenClawSdkDependencies","resolveOpenClawSdk","T","getActivationKey","isActivated","resetActivation","guardedStart"],"sources":["../../openclaw-plugin-kit/dist/index.d.ts","../src/plugin.ts"],"sourcesContent":["//#region src/types.d.ts\n/**\n * Minimal logger contract shared by every helper in the kit.\n *\n * Deliberately the *narrowest* shape in the fleet: some plugins declare\n * variadic loggers (`info(msg: string, ...args: unknown[])`), others\n * single-arg (`info(msg: string)`). Both are assignable to this. The kit\n * only ever calls with a single string.\n */\ninterface KitLogger {\n  info(msg: string): void;\n  warn(msg: string): void;\n  error(msg: string): void;\n  debug(msg: string): void;\n}\n//# sourceMappingURL=types.d.ts.map\n//#endregion\n//#region src/tools.d.ts\n/** Shape returned to OpenClaw from a tool `execute`. */\ninterface ToolResult {\n  content: {\n    type: \"text\";\n    text: string;\n  }[];\n  details: unknown;\n  isError?: boolean;\n}\ninterface ToolDef<TParameters = unknown> {\n  name: string;\n  description: string;\n  label: string;\n  parameters: TParameters;\n  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;\n}\n/** Deliberately model-safe validation/usage failure. Other exceptions stay private. */\ndeclare class PublicToolError extends Error {\n  readonly name = \"PublicToolError\";\n}\ndeclare function publicToolError(message: string): PublicToolError;\n/** Wrap bounded JSON in the OpenClaw tool-result envelope. */\ndeclare function ok(data: unknown): ToolResult;\n/** Wrap an explicitly public error in a captured OpenClaw error envelope. */\ndeclare function errResult(message: string): ToolResult;\n/**\n * Define a tool whose unexpected exceptions never expose provider, filesystem,\n * credential, or transport diagnostics to the model. Throw `PublicToolError`\n * only for a message deliberately safe for model display.\n */\ndeclare function defineTool<TParameters>(def: {\n  name: string;\n  description: string;\n  parameters: TParameters;\n  handler: (params: Record<string, unknown>) => Promise<unknown>;\n}): ToolDef<TParameters>;\n//# sourceMappingURL=tools.d.ts.map\n//#endregion\n//#region src/daemon.d.ts\ninterface IpcResponse {\n  ok: boolean;\n  error?: {\n    message?: string;\n  };\n  [key: string]: unknown;\n}\ninterface IpcClient {\n  on(event: string, handler: (...args: unknown[]) => void): void;\n  request(method: string, params: Record<string, unknown>): Promise<IpcResponse>;\n  start(): void;\n  stop(): void;\n}\ninterface IpcModule {\n  IPCClient: new (socketPath: string, log: KitLogger) => IpcClient;\n}\ninterface ConnectToDaemonOptions {\n  pluginId: string;\n  capabilities?: readonly string[];\n  onMessage?: (msg: Record<string, unknown>) => void;\n  standaloneNote?: string;\n}\ninterface ConnectToDaemonDependencies {\n  loadIpcModule?: () => Promise<IpcModule>;\n}\ndeclare function connectToDaemon(socketPath: string, log: KitLogger, options: ConnectToDaemonOptions, dependencies?: ConnectToDaemonDependencies): Promise<IpcClient | null>;\n//#endregion\n//#region src/sdk.d.ts\ninterface ResolveOpenClawSdkOptions {\n  specifier?: string;\n  exportName?: string;\n  unresolvableNote?: string;\n}\ninterface ResolveOpenClawSdkDependencies {\n  anchors?: readonly string[];\n  globalPackageJsonPath?: string;\n  requireFrom?: (anchor: string) => (specifier: string) => unknown;\n}\ndeclare function resolveOpenClawSdk<T = unknown>(log: KitLogger, options?: ResolveOpenClawSdkOptions, dependencies?: ResolveOpenClawSdkDependencies): T | null;\n//# sourceMappingURL=sdk.d.ts.map\n\n//#endregion\n//#region src/activation.d.ts\n/**\n * Canonical activation-flag key for a plugin: `__alfe<Name>PluginActivated`.\n *\n * Accepts a short name (`\"google\"`, `\"google-chat\"`) or a full package name\n * (`\"@alfe.ai/openclaw-teams\"`); scope + `openclaw-` prefix are stripped\n * and the remainder PascalCased:\n *\n *   getActivationKey(\"google\")                  → \"__alfeGooglePluginActivated\"\n *   getActivationKey(\"google-chat\")             → \"__alfeGoogleChatPluginActivated\"\n *   getActivationKey(\"@alfe.ai/openclaw-teams\") → \"__alfeTeamsPluginActivated\"\n */\ndeclare function getActivationKey(name: string): string;\n/** True when the activation flag for `key` is currently set. */\ndeclare function isActivated(key: string): boolean;\n/**\n * Clear the activation flag so a later start can run again.\n *\n * Call this LAST in stop/deactivate paths — after side effects are stopped\n * (see the ordering rule in the module doc). Also exported for soft-failure\n * paths inside a `guardedStart` fn that want to log at a custom level and\n * return normally instead of throwing.\n */\ndeclare function resetActivation(key: string): void;\n/**\n * Run a service start exactly once per activation cycle.\n *\n * - If the flag is already set, logs at debug and returns `false` (skipped).\n * - Otherwise sets the flag and runs `fn`.\n * - If `fn` throws synchronously OR returns a promise that rejects, the\n *   flag is RESET (so a later activate can retry) and the error is logged.\n *   Errors are not rethrown — matching fleet behavior where a failed start\n *   must never crash the host's plugin loader.\n *\n * Returns `true` when the start was initiated (even if an async portion\n * later fails), `false` when skipped or when `fn` threw synchronously.\n *\n * Note: cleaning up partial side effects on failure is `fn`'s job (throw\n * only after tearing down what was started); the kit only guarantees the\n * flag reset happens after `fn` has failed — i.e. after `fn`'s own cleanup.\n */\ndeclare function guardedStart(key: string, log: KitLogger, fn: () => void | Promise<void>): boolean;\n//# sourceMappingURL=activation.d.ts.map\n\n//#endregion\nexport { type ConnectToDaemonDependencies, type ConnectToDaemonOptions, type IpcClient, type IpcResponse, type KitLogger, PublicToolError, type ResolveOpenClawSdkDependencies, type ResolveOpenClawSdkOptions, type ToolDef, type ToolResult, connectToDaemon, defineTool, errResult, getActivationKey, guardedStart, isActivated, ok, publicToolError, resetActivation, resolveOpenClawSdk };\n//# sourceMappingURL=index.d.ts.map"],"mappings":";;;;ACwCgB;;;;UDrBNC,UAAAA,CC+BW;SACkD,EAAA;QAG3B,EAAA,MAAA;IAAO,IAAA,EAAA,MAAA;EAAA,CAAA,EA4O7C;EA8CL,OAAA,EAAA,OAAA;SAxCe,CAAA,EAAA,OAAA;;UD7QNC,OC+SyB,CAAA,cAAA,OAAA,CAAA,CAAA;;;;cD3SrBC;wCAC0BC,4BAA4BC,QAAQJ;;;;;;UCQlE,MAAA,CAOiB;MACjB,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;MAEmB,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;OAAR,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;OACkD,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;UAJ7D,iBAAA,CAOyC;EA4O7C,MAAA,EAlPI,MAgST;EAAA,gBAAA,CAAA,EAAA,MAAA,GAAA,YAAA,GAAA,eAAA,GAAA,cAAA;cAxCe,CAAA,IAAA,EAtPK,OAsPL,CAtPa,OAsPb,CAAA,CAAA,EAAA,IAAA;uBAkCE,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,GAAA,IAAA,EAAA,OAAA,EAAA,EAAA,GAvRqD,OAuRrD,CAAA,OAAA,CAAA,CAAA,EAAA,IAAA;EAAiB,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,GAAA,IAAA,EAAA,OAAA,EAAA,EAAA,GAAA,IAAA,GApRS,OAoRT,CAAA,IAAA,CAAA,EAAA,QAAA,EAAA;;;;cAxC7B;;;;;gBAMU;kBAkCE"}

package/dist/plugin.d.ts

@@ -1,5 +1,28 @@
 import { TSchema } from "@sinclair/typebox";
 
+//#region ../openclaw-plugin-kit/dist/index.d.ts
+
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+//#region src/tools.d.ts
+/** Shape returned to OpenClaw from a tool `execute`. */
+interface ToolResult {
+  content: {
+    type: "text";
+    text: string;
+  }[];
+  details: unknown;
+  isError?: boolean;
+}
+interface ToolDef<TParameters = unknown> {
+  name: string;
+  description: string;
+  label: string;
+  parameters: TParameters;
+  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;
+}
+/** Deliberately model-safe validation/usage failure. Other exceptions stay private. */
+//#endregion
 //#region src/plugin.d.ts
 
 interface Logger {
@@ -11,25 +34,12 @@ interface Logger {
 interface OpenClawPluginApi {
   logger: Logger;
   registrationMode?: "full" | "setup-only" | "setup-runtime" | "cli-metadata";
-  registerTool(tool: ToolDef): void;
+  registerTool(tool: ToolDef<TSchema>): void;
   registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;
   on(event: string, handler: (...args: unknown[]) => void | Promise<void>, options?: {
     priority?: number;
   }): void;
 }
-interface ToolDef {
-  name: string;
-  description: string;
-  label: string;
-  parameters: TSchema;
-  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<{
-    content: {
-      type: "text";
-      text: string;
-    }[];
-    details: unknown;
-  }>;
-}
 declare const plugin: {
   id: string;
   name: string;
@@ -39,5 +49,5 @@ declare const plugin: {
   deactivate(api: OpenClawPluginApi): void;
 };
 //#endregion
-export { plugin as default };
+export { plugin as t };
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;UAsBU,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":["KitLogger","ToolResult","ToolDef","TParameters","Record","Promise","PublicToolError","Error","publicToolError","ok","errResult","defineTool","IpcResponse","IpcClient","IpcModule","ConnectToDaemonOptions","ConnectToDaemonDependencies","connectToDaemon","ResolveOpenClawSdkOptions","ResolveOpenClawSdkDependencies","resolveOpenClawSdk","T","getActivationKey","isActivated","resetActivation","guardedStart"],"sources":["../../openclaw-plugin-kit/dist/index.d.ts","../src/plugin.ts"],"sourcesContent":["//#region src/types.d.ts\n/**\n * Minimal logger contract shared by every helper in the kit.\n *\n * Deliberately the *narrowest* shape in the fleet: some plugins declare\n * variadic loggers (`info(msg: string, ...args: unknown[])`), others\n * single-arg (`info(msg: string)`). Both are assignable to this. The kit\n * only ever calls with a single string.\n */\ninterface KitLogger {\n  info(msg: string): void;\n  warn(msg: string): void;\n  error(msg: string): void;\n  debug(msg: string): void;\n}\n//# sourceMappingURL=types.d.ts.map\n//#endregion\n//#region src/tools.d.ts\n/** Shape returned to OpenClaw from a tool `execute`. */\ninterface ToolResult {\n  content: {\n    type: \"text\";\n    text: string;\n  }[];\n  details: unknown;\n  isError?: boolean;\n}\ninterface ToolDef<TParameters = unknown> {\n  name: string;\n  description: string;\n  label: string;\n  parameters: TParameters;\n  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;\n}\n/** Deliberately model-safe validation/usage failure. Other exceptions stay private. */\ndeclare class PublicToolError extends Error {\n  readonly name = \"PublicToolError\";\n}\ndeclare function publicToolError(message: string): PublicToolError;\n/** Wrap bounded JSON in the OpenClaw tool-result envelope. */\ndeclare function ok(data: unknown): ToolResult;\n/** Wrap an explicitly public error in a captured OpenClaw error envelope. */\ndeclare function errResult(message: string): ToolResult;\n/**\n * Define a tool whose unexpected exceptions never expose provider, filesystem,\n * credential, or transport diagnostics to the model. Throw `PublicToolError`\n * only for a message deliberately safe for model display.\n */\ndeclare function defineTool<TParameters>(def: {\n  name: string;\n  description: string;\n  parameters: TParameters;\n  handler: (params: Record<string, unknown>) => Promise<unknown>;\n}): ToolDef<TParameters>;\n//# sourceMappingURL=tools.d.ts.map\n//#endregion\n//#region src/daemon.d.ts\ninterface IpcResponse {\n  ok: boolean;\n  error?: {\n    message?: string;\n  };\n  [key: string]: unknown;\n}\ninterface IpcClient {\n  on(event: string, handler: (...args: unknown[]) => void): void;\n  request(method: string, params: Record<string, unknown>): Promise<IpcResponse>;\n  start(): void;\n  stop(): void;\n}\ninterface IpcModule {\n  IPCClient: new (socketPath: string, log: KitLogger) => IpcClient;\n}\ninterface ConnectToDaemonOptions {\n  pluginId: string;\n  capabilities?: readonly string[];\n  onMessage?: (msg: Record<string, unknown>) => void;\n  standaloneNote?: string;\n}\ninterface ConnectToDaemonDependencies {\n  loadIpcModule?: () => Promise<IpcModule>;\n}\ndeclare function connectToDaemon(socketPath: string, log: KitLogger, options: ConnectToDaemonOptions, dependencies?: ConnectToDaemonDependencies): Promise<IpcClient | null>;\n//#endregion\n//#region src/sdk.d.ts\ninterface ResolveOpenClawSdkOptions {\n  specifier?: string;\n  exportName?: string;\n  unresolvableNote?: string;\n}\ninterface ResolveOpenClawSdkDependencies {\n  anchors?: readonly string[];\n  globalPackageJsonPath?: string;\n  requireFrom?: (anchor: string) => (specifier: string) => unknown;\n}\ndeclare function resolveOpenClawSdk<T = unknown>(log: KitLogger, options?: ResolveOpenClawSdkOptions, dependencies?: ResolveOpenClawSdkDependencies): T | null;\n//# sourceMappingURL=sdk.d.ts.map\n\n//#endregion\n//#region src/activation.d.ts\n/**\n * Canonical activation-flag key for a plugin: `__alfe<Name>PluginActivated`.\n *\n * Accepts a short name (`\"google\"`, `\"google-chat\"`) or a full package name\n * (`\"@alfe.ai/openclaw-teams\"`); scope + `openclaw-` prefix are stripped\n * and the remainder PascalCased:\n *\n *   getActivationKey(\"google\")                  → \"__alfeGooglePluginActivated\"\n *   getActivationKey(\"google-chat\")             → \"__alfeGoogleChatPluginActivated\"\n *   getActivationKey(\"@alfe.ai/openclaw-teams\") → \"__alfeTeamsPluginActivated\"\n */\ndeclare function getActivationKey(name: string): string;\n/** True when the activation flag for `key` is currently set. */\ndeclare function isActivated(key: string): boolean;\n/**\n * Clear the activation flag so a later start can run again.\n *\n * Call this LAST in stop/deactivate paths — after side effects are stopped\n * (see the ordering rule in the module doc). Also exported for soft-failure\n * paths inside a `guardedStart` fn that want to log at a custom level and\n * return normally instead of throwing.\n */\ndeclare function resetActivation(key: string): void;\n/**\n * Run a service start exactly once per activation cycle.\n *\n * - If the flag is already set, logs at debug and returns `false` (skipped).\n * - Otherwise sets the flag and runs `fn`.\n * - If `fn` throws synchronously OR returns a promise that rejects, the\n *   flag is RESET (so a later activate can retry) and the error is logged.\n *   Errors are not rethrown — matching fleet behavior where a failed start\n *   must never crash the host's plugin loader.\n *\n * Returns `true` when the start was initiated (even if an async portion\n * later fails), `false` when skipped or when `fn` threw synchronously.\n *\n * Note: cleaning up partial side effects on failure is `fn`'s job (throw\n * only after tearing down what was started); the kit only guarantees the\n * flag reset happens after `fn` has failed — i.e. after `fn`'s own cleanup.\n */\ndeclare function guardedStart(key: string, log: KitLogger, fn: () => void | Promise<void>): boolean;\n//# sourceMappingURL=activation.d.ts.map\n\n//#endregion\nexport { type ConnectToDaemonDependencies, type ConnectToDaemonOptions, type IpcClient, type IpcResponse, type KitLogger, PublicToolError, type ResolveOpenClawSdkDependencies, type ResolveOpenClawSdkOptions, type ToolDef, type ToolResult, connectToDaemon, defineTool, errResult, getActivationKey, guardedStart, isActivated, ok, publicToolError, resetActivation, resolveOpenClawSdk };\n//# sourceMappingURL=index.d.ts.map"],"mappings":";;;;ACwCgB;;;;UDrBNC,UAAAA,CC+BW;SACkD,EAAA;QAG3B,EAAA,MAAA;IAAO,IAAA,EAAA,MAAA;EAAA,CAAA,EA4O7C;EA8CL,OAAA,EAAA,OAAA;SAxCe,CAAA,EAAA,OAAA;;UD7QNC,OC+SyB,CAAA,cAAA,OAAA,CAAA,CAAA;;;;cD3SrBC;wCAC0BC,4BAA4BC,QAAQJ;;;;;;UCQlE,MAAA,CAOiB;MACjB,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;MAEmB,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;OAAR,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;OACkD,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;UAJ7D,iBAAA,CAOyC;EA4O7C,MAAA,EAlPI,MAgST;EAAA,gBAAA,CAAA,EAAA,MAAA,GAAA,YAAA,GAAA,eAAA,GAAA,cAAA;cAxCe,CAAA,IAAA,EAtPK,OAsPL,CAtPa,OAsPb,CAAA,CAAA,EAAA,IAAA;uBAkCE,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,GAAA,IAAA,EAAA,OAAA,EAAA,EAAA,GAvRqD,OAuRrD,CAAA,OAAA,CAAA,CAAA,EAAA,IAAA;EAAiB,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,GAAA,IAAA,EAAA,OAAA,EAAA,EAAA,GAAA,IAAA,GApRS,OAoRT,CAAA,IAAA,CAAA,EAAA,QAAA,EAAA;;;;cAxC7B;;;;;gBAMU;kBAkCE"}

package/dist/plugin.js

@@ -1,7 +1,8 @@
 import { createRequire } from "node:module";
-import { Type } from "@sinclair/typebox";
 import { resolveConfig } from "@alfe.ai/config";
-import { installToolErrorCapture } from "@alfe.ai/agent-api-client";
+import { AgentApiClient, installToolErrorCapture } from "@alfe.ai/agent-api-client";
+import { defineTool, getActivationKey, guardedStart, publicToolError, resetActivation } from "@alfe.ai/openclaw-plugin-kit";
+import { Type } from "@sinclair/typebox";
 //#region src/plugin.ts
 /**
 * @alfe/openclaw-mobile — OpenClaw native plugin
@@ -18,90 +19,79 @@ import { installToolErrorCapture } from "@alfe.ai/agent-api-client";
 *   - mobile_call — initiate an outbound phone call
 */
 const pkg = createRequire(import.meta.url)("../package.json");
-function ok(data) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify(data)
-		}],
-		details: data
-	};
+const SUPPORTED_COUNTRIES = [
+	"AU",
+	"US",
+	"CA",
+	"GB"
+];
+const E164_PATTERN = "^\\+\\d{7,15}$";
+const E164_RE = /^\+\d{7,15}$/u;
+const NUMBER_SEARCH_RE = /^[A-Za-z0-9*+ -]+$/u;
+const MAX_SEARCH_LENGTH = 32;
+const MAX_SMS_LENGTH = 4400;
+function requireString(params, field, options) {
+	const value = params[field];
+	if (typeof value !== "string" || value.length < 1 || value.length > options.maxLength) throw publicToolError(`${field} must be a non-empty string of at most ${String(options.maxLength)} characters`);
+	if (options.pattern && !options.pattern.test(value)) throw publicToolError(`${field} has an invalid format`);
+	return value;
 }
-function errResult(message) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify({ error: message })
-		}],
-		details: { error: message }
-	};
+function optionalSearchQuery(params) {
+	if (params.query === void 0) return void 0;
+	return requireString(params, "query", {
+		maxLength: MAX_SEARCH_LENGTH,
+		pattern: NUMBER_SEARCH_RE
+	});
 }
-function defineTool(def) {
-	return {
-		name: def.name,
-		description: def.description,
-		label: def.name,
-		parameters: def.parameters,
-		execute: async (_toolCallId, params) => {
-			try {
-				return ok(await def.handler(params));
-			} catch (e) {
-				return errResult(e.message);
-			}
-		}
-	};
+function optionalCountry(params) {
+	if (params.country === void 0) return void 0;
+	return requireCountry(params, "country");
 }
-let apiUrl = "";
-let apiKey = "";
-async function mobileApi(method, path, body, query) {
-	let url = `${apiUrl}${path}`;
-	if (query) {
-		const entries = Object.entries(query).filter((entry) => entry[1] !== void 0);
-		if (entries.length > 0) url += `?${new URLSearchParams(entries).toString()}`;
-	}
-	const headers = {
-		"Content-Type": "application/json",
-		Authorization: `Bearer ${apiKey}`
-	};
-	const res = await fetch(url, {
-		method,
-		headers,
-		body: body ? JSON.stringify(body) : void 0
+function requireCountry(params, field) {
+	const value = params[field];
+	if (typeof value !== "string" || !SUPPORTED_COUNTRIES.includes(value)) throw publicToolError(`${field} must be one of ${SUPPORTED_COUNTRIES.join(", ")}`);
+	return value;
+}
+function requireE164(params, field) {
+	return requireString(params, field, {
+		maxLength: 16,
+		pattern: E164_RE
 	});
-	const json = await res.json();
-	if (!res.ok) {
-		const issues = json.issues;
-		if (Array.isArray(issues) && issues.length > 0) {
-			const details = issues.map((i) => {
-				return `${i.path?.join(".") ?? "input"}: ${i.message ?? "invalid"}`;
-			}).join("; ");
-			throw new Error(`Validation error — ${details}`);
-		}
-		const errorMsg = typeof json.error === "string" ? json.error : typeof json.message === "string" ? json.message : `Mobile service returned ${String(res.status)}`;
-		throw new Error(errorMsg);
-	}
-	if (json.data && typeof json.data === "object") return json.data;
-	return json;
+}
+function requireConfirmation(params) {
+	if (params.confirm !== true) throw publicToolError("confirm must be true after the user explicitly approves the recurring charge");
+}
+const MOBILE_ACTIVATION_KEY = getActivationKey("mobile");
+let client;
+function getClient() {
+	if (!client) throw new Error("Mobile tools unavailable — no API config resolved");
+	return client;
 }
 const mobileTools = [
 	defineTool({
 		name: "mobile_get_number",
 		description: "Check if you have a phone number assigned. Returns the phone number, country code, monthly price, and status. If no number is assigned, use mobile_search_numbers and mobile_assign_number to get one.",
-		parameters: Type.Object({}),
+		parameters: Type.Object({}, { additionalProperties: false }),
 		handler: async () => {
-			return mobileApi("GET", "/mobile/numbers");
+			return getClient().getMobileNumber();
 		}
 	}),
 	defineTool({
 		name: "mobile_search_numbers",
 		description: "Search for available phone numbers that can be purchased. Returns a list of available numbers and the monthly price. Supported countries: AU (Australia), US (United States), CA (Canada), GB (United Kingdom).",
 		parameters: Type.Object({
-			country: Type.Optional(Type.String({ description: "Country code: AU, US, CA, or GB (default: AU)" })),
-			query: Type.Optional(Type.String({ description: "Optional search pattern — area code or text to match (e.g., '415' or 'COOL')" }))
-		}),
+			country: Type.Optional(Type.Union(SUPPORTED_COUNTRIES.map((country) => Type.Literal(country)), { description: "Country code: AU, US, CA, or GB (default: AU)" })),
+			query: Type.Optional(Type.String({
+				description: "Optional search pattern — area code or text to match (e.g., '415' or 'COOL')",
+				minLength: 1,
+				maxLength: MAX_SEARCH_LENGTH,
+				pattern: NUMBER_SEARCH_RE.source
+			}))
+		}, { additionalProperties: false }),
 		handler: async (params) => {
-			const { country, query } = params;
-			return mobileApi("GET", "/mobile/numbers/search", void 0, {
+			const country = optionalCountry(params);
+			const query = optionalSearchQuery(params);
+			return getClient().searchMobileNumbers({
 				country,
 				query
 			});
@@ -109,14 +99,22 @@ const mobileTools = [
 	}),
 	defineTool({
 		name: "mobile_assign_number",
-		description: "Purchase and assign a phone number to yourself. You must search for available numbers first using mobile_search_numbers, then pass the chosen phoneNumber and countryCode here. Your organisation must have a payment method on file. The number will be billed monthly to the organisation's account.",
+		description: "Purchase and assign a phone number to yourself. You must search for available numbers first using mobile_search_numbers, then pass the chosen phoneNumber and countryCode here. Your organisation must have a payment method on file. The number will be billed monthly to the organisation's account and may replace an active number. Set confirm=true only after the user explicitly approves the charge.",
 		parameters: Type.Object({
-			phoneNumber: Type.String({ description: "The phone number to purchase (from mobile_search_numbers results)" }),
-			countryCode: Type.String({ description: "Country code: AU, US, CA, or GB" })
-		}),
+			phoneNumber: Type.String({
+				description: "The phone number to purchase (from mobile_search_numbers results)",
+				minLength: 8,
+				maxLength: 16,
+				pattern: E164_PATTERN
+			}),
+			countryCode: Type.Union(SUPPORTED_COUNTRIES.map((country) => Type.Literal(country)), { description: "Country code: AU, US, CA, or GB" }),
+			confirm: Type.Literal(true, { description: "Must be true after the user explicitly approves the recurring charge" })
+		}, { additionalProperties: false }),
 		handler: async (params) => {
-			const { phoneNumber, countryCode } = params;
-			return mobileApi("POST", "/mobile/numbers/assign", {
+			const phoneNumber = requireE164(params, "phoneNumber");
+			const countryCode = requireCountry(params, "countryCode");
+			requireConfirmation(params);
+			return getClient().assignMobileNumber({
 				phoneNumber,
 				countryCode
 			});
@@ -124,22 +122,40 @@ const mobileTools = [
 	}),
 	defineTool({
 		name: "mobile_release_number",
-		description: "Release your currently assigned phone number. This will cancel the monthly subscription and the number will no longer be available for calls or SMS. This action cannot be undone — the same number may not be available again.",
-		parameters: Type.Object({}),
-		handler: async () => {
-			return mobileApi("POST", "/mobile/numbers/release", {});
+		description: "Release your currently assigned phone number. This will cancel the monthly subscription and the number will no longer be available for calls or SMS. This action cannot be undone — the same number may not be available again. Copy the exact current number into confirmPhoneNumber only after the user approves.",
+		parameters: Type.Object({ confirmPhoneNumber: Type.String({
+			description: "Exact currently assigned number, copied to confirm permanent release",
+			minLength: 8,
+			maxLength: 16,
+			pattern: E164_PATTERN
+		}) }, { additionalProperties: false }),
+		handler: async (params) => {
+			const confirmPhoneNumber = requireE164(params, "confirmPhoneNumber");
+			const mobileClient = getClient();
+			if ((await mobileClient.getMobileNumber()).phoneNumber !== confirmPhoneNumber) throw publicToolError("confirmPhoneNumber does not match the currently assigned number");
+			return mobileClient.releaseMobileNumber();
 		}
 	}),
 	defineTool({
 		name: "mobile_send_sms",
 		description: "Send an SMS text message from your phone number to the specified number. The recipient number must be in E.164 format (e.g., +12025551234).",
 		parameters: Type.Object({
-			to: Type.String({ description: "Recipient phone number in E.164 format (e.g., +12025551234)" }),
-			body: Type.String({ description: "The text message content to send" })
-		}),
+			to: Type.String({
+				description: "Recipient phone number in E.164 format (e.g., +12025551234)",
+				minLength: 8,
+				maxLength: 16,
+				pattern: E164_PATTERN
+			}),
+			body: Type.String({
+				description: "The text message content to send",
+				minLength: 1,
+				maxLength: MAX_SMS_LENGTH
+			})
+		}, { additionalProperties: false }),
 		handler: async (params) => {
-			const { to, body } = params;
-			return mobileApi("POST", "/mobile/sms/send", {
+			const to = requireE164(params, "to");
+			const body = requireString(params, "body", { maxLength: MAX_SMS_LENGTH });
+			return getClient().sendSms({
 				to,
 				body
 			});
@@ -148,10 +164,15 @@ const mobileTools = [
 	defineTool({
 		name: "mobile_call",
 		description: "Make an outbound phone call to the specified number. When the recipient answers, they will be connected to your voice pipeline. The number must be in E.164 format (e.g., +12025551234).",
-		parameters: Type.Object({ to: Type.String({ description: "Phone number to call in E.164 format (e.g., +12025551234)" }) }),
+		parameters: Type.Object({ to: Type.String({
+			description: "Phone number to call in E.164 format (e.g., +12025551234)",
+			minLength: 8,
+			maxLength: 16,
+			pattern: E164_PATTERN
+		}) }, { additionalProperties: false }),
 		handler: async (params) => {
-			const { to } = params;
-			return mobileApi("POST", "/mobile/calls/outbound", { to });
+			const to = requireE164(params, "to");
+			return getClient().startOutboundCall({ to });
 		}
 	})
 ];
@@ -164,24 +185,27 @@ const plugin = {
 		installToolErrorCapture(api, { plugin: "openclaw-mobile" });
 		const log = api.logger;
 		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) {
-			globalThis.__mobilePluginActivated = true;
+		log.info(`Registered ${String(mobileTools.length)} mobile tools: ${mobileTools.map((tool) => tool.name).join(", ")}`);
+		guardedStart(MOBILE_ACTIVATION_KEY, log, () => {
 			log.info("Alfe Mobile plugin activating...");
 			try {
 				const config = resolveConfig();
-				apiUrl = config.apiUrl;
-				apiKey = config.apiKey;
+				client = new AgentApiClient({
+					apiUrl: config.apiUrl,
+					apiKey: config.apiKey
+				});
+				log.info("Mobile API client configured");
 			} catch (err) {
 				log.error(`Failed to resolve config: ${err instanceof Error ? err.message : String(err)}`);
 				log.warn("Mobile tools will fail — no API config available");
+				resetActivation(MOBILE_ACTIVATION_KEY);
 			}
-			log.info(`Mobile API: ${apiUrl}`);
-		}
+		});
 		log.info("Alfe Mobile plugin activated");
 	},
 	deactivate(api) {
-		globalThis.__mobilePluginActivated = false;
+		client = void 0;
+		resetActivation(MOBILE_ACTIVATION_KEY);
 		api.logger.info("Alfe Mobile plugin deactivated");
 	}
 };

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 { installToolErrorCapture } from \"@alfe.ai/agent-api-client\";\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    // First thing, before any registerTool call: tool failures emit a\n    // deterministic [ERROR] line the gateway's runtime-output monitor captures\n    // to Sentry. See @alfe.ai/agent-api-client tool-error-capture.\n    installToolErrorCapture(api, { plugin: \"openclaw-mobile\" });\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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"}
+{"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 { createRequire } from \"node:module\";\nimport { resolveConfig } from \"@alfe.ai/config\";\nimport { AgentApiClient, installToolErrorCapture } from \"@alfe.ai/agent-api-client\";\nimport {\n  defineTool,\n  getActivationKey,\n  guardedStart,\n  publicToolError,\n  resetActivation,\n  type ToolDef,\n} from \"@alfe.ai/openclaw-plugin-kit\";\nimport { Type, type TSchema } from \"@sinclair/typebox\";\n\nconst require = createRequire(import.meta.url);\nconst pkg = require(\"../package.json\") as { version: string };\n\nconst SUPPORTED_COUNTRIES = [\"AU\", \"US\", \"CA\", \"GB\"] as const;\nconst E164_PATTERN = \"^\\\\+\\\\d{7,15}$\";\nconst E164_RE = /^\\+\\d{7,15}$/u;\nconst NUMBER_SEARCH_RE = /^[A-Za-z0-9*+ -]+$/u;\nconst MAX_SEARCH_LENGTH = 32;\nconst MAX_SMS_LENGTH = 4_400;\n\ntype SupportedCountry = (typeof SUPPORTED_COUNTRIES)[number];\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<TSchema>): void;\n  registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;\n  on(\n    event: string,\n    handler: (...args: unknown[]) => void | Promise<void>,\n    options?: { priority?: number },\n  ): void;\n}\n\nfunction requireString(\n  params: Record<string, unknown>,\n  field: string,\n  options: { maxLength: number; pattern?: RegExp },\n): string {\n  const value = params[field];\n  if (typeof value !== \"string\" || value.length < 1 || value.length > options.maxLength) {\n    throw publicToolError(\n      `${field} must be a non-empty string of at most ${String(options.maxLength)} characters`,\n    );\n  }\n  if (options.pattern && !options.pattern.test(value)) {\n    throw publicToolError(`${field} has an invalid format`);\n  }\n  return value;\n}\n\nfunction optionalSearchQuery(params: Record<string, unknown>): string | undefined {\n  if (params.query === undefined) return undefined;\n  return requireString(params, \"query\", {\n    maxLength: MAX_SEARCH_LENGTH,\n    pattern: NUMBER_SEARCH_RE,\n  });\n}\n\nfunction optionalCountry(params: Record<string, unknown>): SupportedCountry | undefined {\n  if (params.country === undefined) return undefined;\n  return requireCountry(params, \"country\");\n}\n\nfunction requireCountry(params: Record<string, unknown>, field: string): SupportedCountry {\n  const value = params[field];\n  if (typeof value !== \"string\" || !SUPPORTED_COUNTRIES.includes(value as SupportedCountry)) {\n    throw publicToolError(`${field} must be one of ${SUPPORTED_COUNTRIES.join(\", \")}`);\n  }\n  return value as SupportedCountry;\n}\n\nfunction requireE164(params: Record<string, unknown>, field: string): string {\n  return requireString(params, field, { maxLength: 16, pattern: E164_RE });\n}\n\nfunction requireConfirmation(params: Record<string, unknown>): void {\n  if (params.confirm !== true) {\n    throw publicToolError(\n      \"confirm must be true after the user explicitly approves the recurring charge\",\n    );\n  }\n}\n\n// ── Activation guard ─────────────────────────────────────────\n\nconst MOBILE_ACTIVATION_KEY = getActivationKey(\"mobile\");\n\n// ── API client ───────────────────────────────────────────────\n\nlet client: AgentApiClient | undefined;\n\nfunction getClient(): AgentApiClient {\n  if (!client) {\n    throw new Error(\"Mobile tools unavailable — no API config resolved\");\n  }\n  return client;\n}\n\n// ── Tool definitions ─────────────────────────────────────────\n\nconst mobileTools: ToolDef<TSchema>[] = [\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({}, { additionalProperties: false }),\n    handler: async () => {\n      return getClient().getMobileNumber();\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      {\n        country: Type.Optional(\n          Type.Union(\n            SUPPORTED_COUNTRIES.map((country) => Type.Literal(country)),\n            { description: \"Country code: AU, US, CA, or GB (default: AU)\" },\n          ),\n        ),\n        query: Type.Optional(\n          Type.String({\n            description: \"Optional search pattern — area code or text to match (e.g., '415' or 'COOL')\",\n            minLength: 1,\n            maxLength: MAX_SEARCH_LENGTH,\n            pattern: NUMBER_SEARCH_RE.source,\n          }),\n        ),\n      },\n      { additionalProperties: false },\n    ),\n    handler: async (params) => {\n      const country = optionalCountry(params);\n      const query = optionalSearchQuery(params);\n      return getClient().searchMobileNumbers({ 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 and may replace \" +\n      \"an active number. Set confirm=true only after the user explicitly approves the charge.\",\n    parameters: Type.Object(\n      {\n        phoneNumber: Type.String({\n          description: \"The phone number to purchase (from mobile_search_numbers results)\",\n          minLength: 8,\n          maxLength: 16,\n          pattern: E164_PATTERN,\n        }),\n        countryCode: Type.Union(\n          SUPPORTED_COUNTRIES.map((country) => Type.Literal(country)),\n          { description: \"Country code: AU, US, CA, or GB\" },\n        ),\n        confirm: Type.Literal(true, {\n          description: \"Must be true after the user explicitly approves the recurring charge\",\n        }),\n      },\n      { additionalProperties: false },\n    ),\n    handler: async (params) => {\n      const phoneNumber = requireE164(params, \"phoneNumber\");\n      const countryCode = requireCountry(params, \"countryCode\");\n      requireConfirmation(params);\n      return getClient().assignMobileNumber({ 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      \"Copy the exact current number into confirmPhoneNumber only after the user approves.\",\n    parameters: Type.Object(\n      {\n        confirmPhoneNumber: Type.String({\n          description: \"Exact currently assigned number, copied to confirm permanent release\",\n          minLength: 8,\n          maxLength: 16,\n          pattern: E164_PATTERN,\n        }),\n      },\n      { additionalProperties: false },\n    ),\n    handler: async (params) => {\n      const confirmPhoneNumber = requireE164(params, \"confirmPhoneNumber\");\n      const mobileClient = getClient();\n      const current = await mobileClient.getMobileNumber();\n      if (current.phoneNumber !== confirmPhoneNumber) {\n        throw publicToolError(\"confirmPhoneNumber does not match the currently assigned number\");\n      }\n      return mobileClient.releaseMobileNumber();\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      {\n        to: Type.String({\n          description: \"Recipient phone number in E.164 format (e.g., +12025551234)\",\n          minLength: 8,\n          maxLength: 16,\n          pattern: E164_PATTERN,\n        }),\n        body: Type.String({\n          description: \"The text message content to send\",\n          minLength: 1,\n          maxLength: MAX_SMS_LENGTH,\n        }),\n      },\n      { additionalProperties: false },\n    ),\n    handler: async (params) => {\n      const to = requireE164(params, \"to\");\n      const body = requireString(params, \"body\", { maxLength: MAX_SMS_LENGTH });\n      return getClient().sendSms({ 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      {\n        to: Type.String({\n          description: \"Phone number to call in E.164 format (e.g., +12025551234)\",\n          minLength: 8,\n          maxLength: 16,\n          pattern: E164_PATTERN,\n        }),\n      },\n      { additionalProperties: false },\n    ),\n    handler: async (params) => {\n      const to = requireE164(params, \"to\");\n      return getClient().startOutboundCall({ 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    // First thing, before any registerTool call: tool failures emit a\n    // deterministic [ERROR] line the gateway's runtime-output monitor captures\n    // to Sentry. See @alfe.ai/agent-api-client tool-error-capture.\n    installToolErrorCapture(api, { plugin: \"openclaw-mobile\" });\n    const log = api.logger;\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(\n      `Registered ${String(mobileTools.length)} mobile tools: ${mobileTools.map((tool) => tool.name).join(\", \")}`,\n    );\n\n    // Only initialize config once (side effects)\n    guardedStart(MOBILE_ACTIVATION_KEY, log, () => {\n      log.info(\"Alfe Mobile plugin activating...\");\n\n      try {\n        const config = resolveConfig();\n        client = new AgentApiClient({ apiUrl: config.apiUrl, apiKey: config.apiKey });\n        log.info(\"Mobile API client configured\");\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        // Reset so a later activate() can retry once config exists.\n        resetActivation(MOBILE_ACTIVATION_KEY);\n      }\n    });\n\n    log.info(\"Alfe Mobile plugin activated\");\n  },\n\n  deactivate(api: OpenClawPluginApi) {\n    // Stop side effects BEFORE resetting the activation flag.\n    client = undefined;\n    resetActivation(MOBILE_ACTIVATION_KEY);\n    api.logger.info(\"Alfe Mobile plugin deactivated\");\n  },\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA6BA,MAAM,MADU,cAAc,OAAO,KAAK,IAAI,CAC1B,kBAAkB;AAEtC,MAAM,sBAAsB;CAAC;CAAM;CAAM;CAAM;CAAK;AACpD,MAAM,eAAe;AACrB,MAAM,UAAU;AAChB,MAAM,mBAAmB;AACzB,MAAM,oBAAoB;AAC1B,MAAM,iBAAiB;AAuBvB,SAAS,cACP,QACA,OACA,SACQ;CACR,MAAM,QAAQ,OAAO;AACrB,KAAI,OAAO,UAAU,YAAY,MAAM,SAAS,KAAK,MAAM,SAAS,QAAQ,UAC1E,OAAM,gBACJ,GAAG,MAAM,yCAAyC,OAAO,QAAQ,UAAU,CAAC,aAC7E;AAEH,KAAI,QAAQ,WAAW,CAAC,QAAQ,QAAQ,KAAK,MAAM,CACjD,OAAM,gBAAgB,GAAG,MAAM,wBAAwB;AAEzD,QAAO;;AAGT,SAAS,oBAAoB,QAAqD;AAChF,KAAI,OAAO,UAAU,KAAA,EAAW,QAAO,KAAA;AACvC,QAAO,cAAc,QAAQ,SAAS;EACpC,WAAW;EACX,SAAS;EACV,CAAC;;AAGJ,SAAS,gBAAgB,QAA+D;AACtF,KAAI,OAAO,YAAY,KAAA,EAAW,QAAO,KAAA;AACzC,QAAO,eAAe,QAAQ,UAAU;;AAG1C,SAAS,eAAe,QAAiC,OAAiC;CACxF,MAAM,QAAQ,OAAO;AACrB,KAAI,OAAO,UAAU,YAAY,CAAC,oBAAoB,SAAS,MAA0B,CACvF,OAAM,gBAAgB,GAAG,MAAM,kBAAkB,oBAAoB,KAAK,KAAK,GAAG;AAEpF,QAAO;;AAGT,SAAS,YAAY,QAAiC,OAAuB;AAC3E,QAAO,cAAc,QAAQ,OAAO;EAAE,WAAW;EAAI,SAAS;EAAS,CAAC;;AAG1E,SAAS,oBAAoB,QAAuC;AAClE,KAAI,OAAO,YAAY,KACrB,OAAM,gBACJ,+EACD;;AAML,MAAM,wBAAwB,iBAAiB,SAAS;AAIxD,IAAI;AAEJ,SAAS,YAA4B;AACnC,KAAI,CAAC,OACH,OAAM,IAAI,MAAM,oDAAoD;AAEtE,QAAO;;AAKT,MAAM,cAAkC;CAEtC,WAAW;EACT,MAAM;EACN,aACE;EAGF,YAAY,KAAK,OAAO,EAAE,EAAE,EAAE,sBAAsB,OAAO,CAAC;EAC5D,SAAS,YAAY;AACnB,UAAO,WAAW,CAAC,iBAAiB;;EAEvC,CAAC;CAEF,WAAW;EACT,MAAM;EACN,aACE;EAGF,YAAY,KAAK,OACf;GACE,SAAS,KAAK,SACZ,KAAK,MACH,oBAAoB,KAAK,YAAY,KAAK,QAAQ,QAAQ,CAAC,EAC3D,EAAE,aAAa,iDAAiD,CACjE,CACF;GACD,OAAO,KAAK,SACV,KAAK,OAAO;IACV,aAAa;IACb,WAAW;IACX,WAAW;IACX,SAAS,iBAAiB;IAC3B,CAAC,CACH;GACF,EACD,EAAE,sBAAsB,OAAO,CAChC;EACD,SAAS,OAAO,WAAW;GACzB,MAAM,UAAU,gBAAgB,OAAO;GACvC,MAAM,QAAQ,oBAAoB,OAAO;AACzC,UAAO,WAAW,CAAC,oBAAoB;IAAE;IAAS;IAAO,CAAC;;EAE7D,CAAC;CAEF,WAAW;EACT,MAAM;EACN,aACE;EAKF,YAAY,KAAK,OACf;GACE,aAAa,KAAK,OAAO;IACvB,aAAa;IACb,WAAW;IACX,WAAW;IACX,SAAS;IACV,CAAC;GACF,aAAa,KAAK,MAChB,oBAAoB,KAAK,YAAY,KAAK,QAAQ,QAAQ,CAAC,EAC3D,EAAE,aAAa,mCAAmC,CACnD;GACD,SAAS,KAAK,QAAQ,MAAM,EAC1B,aAAa,wEACd,CAAC;GACH,EACD,EAAE,sBAAsB,OAAO,CAChC;EACD,SAAS,OAAO,WAAW;GACzB,MAAM,cAAc,YAAY,QAAQ,cAAc;GACtD,MAAM,cAAc,eAAe,QAAQ,cAAc;AACzD,uBAAoB,OAAO;AAC3B,UAAO,WAAW,CAAC,mBAAmB;IAAE;IAAa;IAAa,CAAC;;EAEtE,CAAC;CAEF,WAAW;EACT,MAAM;EACN,aACE;EAIF,YAAY,KAAK,OACf,EACE,oBAAoB,KAAK,OAAO;GAC9B,aAAa;GACb,WAAW;GACX,WAAW;GACX,SAAS;GACV,CAAC,EACH,EACD,EAAE,sBAAsB,OAAO,CAChC;EACD,SAAS,OAAO,WAAW;GACzB,MAAM,qBAAqB,YAAY,QAAQ,qBAAqB;GACpE,MAAM,eAAe,WAAW;AAEhC,QADgB,MAAM,aAAa,iBAAiB,EACxC,gBAAgB,mBAC1B,OAAM,gBAAgB,kEAAkE;AAE1F,UAAO,aAAa,qBAAqB;;EAE5C,CAAC;CAGF,WAAW;EACT,MAAM;EACN,aACE;EAEF,YAAY,KAAK,OACf;GACE,IAAI,KAAK,OAAO;IACd,aAAa;IACb,WAAW;IACX,WAAW;IACX,SAAS;IACV,CAAC;GACF,MAAM,KAAK,OAAO;IAChB,aAAa;IACb,WAAW;IACX,WAAW;IACZ,CAAC;GACH,EACD,EAAE,sBAAsB,OAAO,CAChC;EACD,SAAS,OAAO,WAAW;GACzB,MAAM,KAAK,YAAY,QAAQ,KAAK;GACpC,MAAM,OAAO,cAAc,QAAQ,QAAQ,EAAE,WAAW,gBAAgB,CAAC;AACzE,UAAO,WAAW,CAAC,QAAQ;IAAE;IAAI;IAAM,CAAC;;EAE3C,CAAC;CAEF,WAAW;EACT,MAAM;EACN,aACE;EAGF,YAAY,KAAK,OACf,EACE,IAAI,KAAK,OAAO;GACd,aAAa;GACb,WAAW;GACX,WAAW;GACX,SAAS;GACV,CAAC,EACH,EACD,EAAE,sBAAsB,OAAO,CAChC;EACD,SAAS,OAAO,WAAW;GACzB,MAAM,KAAK,YAAY,QAAQ,KAAK;AACpC,UAAO,WAAW,CAAC,kBAAkB,EAAE,IAAI,CAAC;;EAE/C,CAAC;CACH;AAID,MAAM,SAAS;CACb,IAAI;CACJ,MAAM;CACN,aAAa;CACb,SAAS,IAAI;CAEb,SAAS,KAAwB;AAI/B,0BAAwB,KAAK,EAAE,QAAQ,mBAAmB,CAAC;EAC3D,MAAM,MAAM,IAAI;AAGhB,OAAK,MAAM,QAAQ,YACjB,KAAI,aAAa,KAAK;AAExB,MAAI,KACF,cAAc,OAAO,YAAY,OAAO,CAAC,iBAAiB,YAAY,KAAK,SAAS,KAAK,KAAK,CAAC,KAAK,KAAK,GAC1G;AAGD,eAAa,uBAAuB,WAAW;AAC7C,OAAI,KAAK,mCAAmC;AAE5C,OAAI;IACF,MAAM,SAAS,eAAe;AAC9B,aAAS,IAAI,eAAe;KAAE,QAAQ,OAAO;KAAQ,QAAQ,OAAO;KAAQ,CAAC;AAC7E,QAAI,KAAK,+BAA+B;YACjC,KAAK;AACZ,QAAI,MAAM,6BAA6B,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAAG;AAC1F,QAAI,KAAK,mDAAmD;AAE5D,oBAAgB,sBAAsB;;IAExC;AAEF,MAAI,KAAK,+BAA+B;;CAG1C,WAAW,KAAwB;AAEjC,WAAS,KAAA;AACT,kBAAgB,sBAAsB;AACtC,MAAI,OAAO,KAAK,iCAAiC;;CAEpD"}

package/dist/plugin2.d.cts

@@ -0,0 +1,2 @@
+import { t as plugin } from "./plugin.cjs";
+export { plugin as default };

package/dist/plugin2.d.ts

@@ -0,0 +1,2 @@
+import { t as plugin } from "./plugin.js";
+export { plugin as default };

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "@alfe.ai/openclaw-mobile",
   "name": "Mobile",
-  "description": "Outbound SMS and phone calls via Twilio",
+  "description": "Phone number management, outbound SMS, and calls via Twilio",
   "entry": "./dist/plugin.js",
   "activation": { "onStartup": false },
   "contracts": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-mobile",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "description": "OpenClaw mobile plugin for Alfe — phone number management, SMS, and calls via Twilio",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,8 +28,9 @@
   ],
   "dependencies": {
     "@sinclair/typebox": "^0.34.48",
-    "@alfe.ai/agent-api-client": "0.13.0",
-    "@alfe.ai/config": "0.3.0"
+    "@alfe.ai/agent-api-client": "0.15.0",
+    "@alfe.ai/config": "0.4.1",
+    "@alfe.ai/openclaw-plugin-kit": "0.2.0"
   },
   "homepage": "https://alfe.ai",
   "author": "Alfe (https://alfe.ai)",
@@ -45,6 +46,7 @@
     "build": "tsdown",
     "dev": "tsdown --watch",
     "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
     "lint": "eslint ."
   }
 }