@alfe.ai/openclaw-google 0.0.41 → 0.0.42

package/README.md

@@ -0,0 +1,48 @@
+# `@alfe.ai/openclaw-google`
+
+OpenClaw tools for multi-account Google Workspace access through the
+[`gws`](https://github.com/googleworkspace/cli) CLI.
+
+The plugin exposes three tools:
+
+- `google_list_accounts` discovers the connected accounts.
+- `google_run_command` runs a `gws` command for one required account email.
+- `google_disconnect_account` permanently disconnects one confirmed account.
+
+## Safety and command syntax
+
+The account selector is mandatory for every credential-touching call. The
+selected per-account config directory is the only Google credential source
+passed to the child process; ambient Google token and credentials-file
+environment variables are removed.
+
+`command` uses familiar shell-style quoting only to form an argument vector—it
+is never passed to a shell. This preserves JSON arguments such as:
+
+```text
+drive files list --params '{"pageSize": 10}'
+```
+
+`gws auth` commands are blocked because the integration owns authentication.
+`--upload` and `--output` paths are confined to the configured agent workspace.
+Destructive method names require `confirmCommand` to exactly repeat the command,
+unless `--dry-run` is present. Account disconnection similarly requires an
+exact `confirmEmail`.
+
+Non-zero `gws` exits are returned as explicit tool errors. Their diagnostics
+are bounded and redact credentials plus local config/workspace paths.
+
+## Development
+
+```bash
+pnpm --filter @alfe.ai/openclaw-google lint
+pnpm --filter @alfe.ai/openclaw-google typecheck
+pnpm --filter @alfe.ai/openclaw-google test
+pnpm --filter @alfe.ai/openclaw-google build
+```
+
+The package publishes ESM and CJS entrypoints and declares its complete static
+tool catalog in `openclaw.plugin.json`.
+
+Part of [Alfe](https://alfe.ai). See the [documentation](https://docs.alfe.ai)
+for platform setup.

package/dist/index.cjs

@@ -1,2 +1,2 @@
-const require_plugin = require("./plugin.cjs");
-module.exports = require_plugin;
+const require_plugin = require("./plugin2.cjs");
+module.exports = require_plugin.plugin;

package/dist/index.js

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

package/dist/plugin.cjs

@@ -1,188 +1,2 @@
-let _sinclair_typebox = require("@sinclair/typebox");
-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 node_child_process = require("node:child_process");
-let node_path = require("node:path");
-let node_os = require("node:os");
-//#region src/plugin.ts
-/**
-* @alfe/openclaw-google — OpenClaw native plugin
-*
-* Registers Google Workspace account management tools with OpenClaw.
-* Multi-account by design — every gws command requires an explicit
-* `email` (schema-enforced) so the LLM picks the target account per call.
-*
-* Tools:
-*   - google_list_accounts        — list connected Google accounts
-*   - google_run_command          — run a gws command (requires email)
-*   - google_disconnect_account   — disconnect an account
-*
-* 2026-05-14 (connections-redesign PR 1): the "default account" concept is
-* gone. Use `google_list_accounts` to discover available accounts, then
-* pass `email` to `google_run_command` to target one.
-*/
-const pkg = (0, require("node:module").createRequire)(require("url").pathToFileURL(__filename).href)("../package.json");
-const GOOGLE_ACTIVATION_KEY = (0, _alfe_ai_openclaw_plugin_kit.getActivationKey)("google");
-function sanitizeEmail(email) {
-	return email.replace(/@/g, "-").replace(/\./g, "-");
-}
-function resolveConfigDir(email) {
-	return (0, node_path.join)((0, node_os.homedir)(), ".config", `gws-${sanitizeEmail(email)}`);
-}
-let client = null;
-let cachedAccounts = [];
-function getClient() {
-	if (!client) {
-		const config = (0, _alfe_ai_config.resolveConfig)();
-		client = new _alfe_ai_agent_api_client.AgentApiClient({
-			apiKey: config.apiKey,
-			apiUrl: config.apiUrl
-		});
-	}
-	return client;
-}
-async function refreshAccountCache() {
-	cachedAccounts = (await getClient().getGoogleCredentials()).accounts.map((a) => ({
-		email: a.email,
-		displayName: a.displayName,
-		connectedAt: a.connectedAt,
-		configDir: resolveConfigDir(a.email)
-	}));
-	return cachedAccounts;
-}
-function findAccount(email) {
-	const account = cachedAccounts.find((a) => a.email === email);
-	if (!account) throw new Error(`Google account "${email}" not found. Available: ${cachedAccounts.map((a) => a.email).join(", ")}`);
-	return account;
-}
-function runGwsCommand(args, configDir) {
-	return new Promise((resolve) => {
-		(0, node_child_process.execFile)("gws", args, {
-			env: {
-				...process.env,
-				GOOGLE_WORKSPACE_CLI_CONFIG_DIR: configDir
-			},
-			timeout: 6e4,
-			maxBuffer: 10 * 1024 * 1024
-		}, (error, stdout, stderr) => {
-			resolve({
-				stdout,
-				stderr,
-				exitCode: typeof error?.code === "number" ? error.code : error ? 1 : 0
-			});
-		});
-	});
-}
-const googleTools = [
-	(0, _alfe_ai_openclaw_plugin_kit.defineTool)({
-		name: "google_list_accounts",
-		description: "List all connected Google Workspace accounts. Shows email, display name, when each account was connected, and the gws CLI config directory path. Use this to resolve which account to target (e.g., 'Kevin\\'s emails' → kevin@alfe.ai).",
-		parameters: _sinclair_typebox.Type.Object({}),
-		handler: async () => {
-			const accounts = await refreshAccountCache();
-			return {
-				accounts: accounts.map((a) => ({
-					email: a.email,
-					displayName: a.displayName,
-					connectedAt: a.connectedAt,
-					configDir: a.configDir
-				})),
-				count: accounts.length
-			};
-		}
-	}),
-	(0, _alfe_ai_openclaw_plugin_kit.defineTool)({
-		name: "google_run_command",
-		description: "Run a gws (Google Workspace CLI) command targeting a specific account. Automatically sets GOOGLE_WORKSPACE_CLI_CONFIG_DIR for the target account. Email is required — call google_list_accounts first if you don't know which account to use. Example: google_run_command({ command: 'gmail list', email: 'kevin@alfe.ai' })",
-		parameters: _sinclair_typebox.Type.Object({
-			command: _sinclair_typebox.Type.String({ description: "The gws CLI command and arguments (e.g., 'gmail list', 'calendar agenda', 'drive list')" }),
-			email: _sinclair_typebox.Type.String({ description: "Email of the Google account to use. Required — there is no implicit default." })
-		}),
-		handler: async (params) => {
-			const { command, email } = params;
-			if (cachedAccounts.length === 0) await refreshAccountCache();
-			const account = findAccount(email);
-			const args = command.split(/\s+/).filter(Boolean);
-			if (args.length === 0) throw new Error("Command cannot be empty");
-			const result = await runGwsCommand(args, account.configDir);
-			return {
-				account: account.email,
-				command: `gws ${command}`,
-				...result
-			};
-		}
-	}),
-	(0, _alfe_ai_openclaw_plugin_kit.defineTool)({
-		name: "google_disconnect_account",
-		description: "Disconnect a specific Google account from this agent. Revokes the OAuth token and removes the account.",
-		parameters: _sinclair_typebox.Type.Object({ email: _sinclair_typebox.Type.String({ description: "Email of the Google account to disconnect" }) }),
-		handler: async (params) => {
-			const { email } = params;
-			const result = await getClient().disconnectGoogleAccount(email);
-			await refreshAccountCache();
-			return {
-				message: `${email} has been disconnected`,
-				remainingAccounts: result.accounts
-			};
-		}
-	})
-];
-const plugin = {
-	id: "@alfe.ai/openclaw-google",
-	name: "Alfe Google Workspace Plugin",
-	description: "Multi-account Google Workspace management — list accounts and run gws commands with an explicit account selector",
-	version: pkg.version,
-	activate(api) {
-		(0, _alfe_ai_agent_api_client.installToolErrorCapture)(api, { plugin: "openclaw-google" });
-		const log = api.logger;
-		for (const tool of googleTools) api.registerTool(tool);
-		log.info(`Registered ${googleTools.length.toString()} Google tools: ${googleTools.map((t) => t.name).join(", ")}`);
-		const startGoogleService = () => {
-			(0, _alfe_ai_openclaw_plugin_kit.guardedStart)(GOOGLE_ACTIVATION_KEY, log, () => {
-				log.info("Alfe Google Workspace plugin activating...");
-				try {
-					const config = (0, _alfe_ai_config.resolveConfig)();
-					client = new _alfe_ai_agent_api_client.AgentApiClient({
-						apiKey: config.apiKey,
-						apiUrl: config.apiUrl
-					});
-					refreshAccountCache().then((accounts) => {
-						log.info(`Cached ${accounts.length.toString()} Google account(s): ${accounts.map((a) => a.email).join(", ")}`);
-					}).catch((err) => {
-						log.warn(`Failed to pre-cache Google accounts: ${err instanceof Error ? err.message : "unknown"}`);
-					});
-				} catch (err) {
-					log.error(`Failed to resolve config: ${err instanceof Error ? err.message : "unknown"}`);
-					log.warn("Google tools will fail — no API config available");
-					(0, _alfe_ai_openclaw_plugin_kit.resetActivation)(GOOGLE_ACTIVATION_KEY);
-					return;
-				}
-				log.info("Alfe Google Workspace plugin activated");
-			});
-		};
-		const stopGoogleService = () => {
-			client = null;
-			cachedAccounts = [];
-			(0, _alfe_ai_openclaw_plugin_kit.resetActivation)(GOOGLE_ACTIVATION_KEY);
-			log.info("Alfe Google Workspace plugin stopped");
-		};
-		if (api.registerService) api.registerService({
-			id: "alfe-google-workspace",
-			start: () => {
-				startGoogleService();
-			},
-			stop: () => {
-				stopGoogleService();
-			}
-		});
-	},
-	deactivate(api) {
-		client = null;
-		cachedAccounts = [];
-		(0, _alfe_ai_openclaw_plugin_kit.resetActivation)(GOOGLE_ACTIVATION_KEY);
-		api.logger.info("Alfe Google Workspace plugin deactivated");
-	}
-};
-//#endregion
-module.exports = plugin;
+const require_plugin = require("./plugin2.cjs");
+module.exports = require_plugin.plugin;

package/dist/plugin.d.cts

@@ -5,16 +5,6 @@ import { TSchema } from "@sinclair/typebox";
 //# sourceMappingURL=types.d.ts.map
 //#endregion
 //#region src/tools.d.ts
-/**
- * Tool-definition helpers — the `defineTool` / `ok` / `errResult` trio that
- * was copy-pasted across 8 plugins (identity, google, teams, mobile,
- * whatsapp, voice, chat a2a-tools, base openclaw).
- *
- * Error handling is standardized on the openclaw-google variant — the only
- * copy that survived non-`Error` throws (`e instanceof Error ? e.message :
- * "Unknown error"`). The other copies did `(e as Error).message`, which
- * crashes the tool executor when a handler throws a string/object.
- */
 /** Shape returned to OpenClaw from a tool `execute`. */
 interface ToolResult {
   content: {
@@ -22,15 +12,8 @@ interface ToolResult {
     text: string;
   }[];
   details: unknown;
+  isError?: boolean;
 }
-/**
- * An OpenClaw tool definition.
- *
- * `parameters` is generic because the fleet is split between TypeBox
- * `TSchema` schemas (identity/google/teams/mobile/whatsapp) and plain
- * JSON-Schema objects (chat a2a-tools). Instantiate with whichever schema
- * type the plugin uses — the kit itself has no schema dependency.
- */
 interface ToolDef<TParameters = unknown> {
   name: string;
   description: string;
@@ -38,44 +21,42 @@ interface ToolDef<TParameters = unknown> {
   parameters: TParameters;
   execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;
 }
-/** Wrap a successful handler result in the OpenClaw tool-result envelope. */
+/** Deliberately model-safe validation/usage failure. Other exceptions stay private. */
 //#endregion
-//#region src/plugin.d.ts
-
-interface Logger {
-  info(msg: string, ...args: unknown[]): void;
-  warn(msg: string, ...args: unknown[]): void;
-  error(msg: string, ...args: unknown[]): void;
-  debug(msg: string, ...args: unknown[]): void;
+//#region src/runtime.d.ts
+interface PluginLogger {
+  info(message: string, ...args: unknown[]): void;
+  warn(message: string, ...args: unknown[]): void;
+  error(message: string, ...args: unknown[]): void;
+  debug(message: string, ...args: unknown[]): void;
 }
 interface PluginServiceContext {
   config?: Record<string, unknown>;
   workspaceDir?: string;
   stateDir?: string;
-  logger?: Logger;
+  logger?: PluginLogger;
 }
-interface OpenClawPluginApi {
-  logger: Logger;
-  registrationMode?: "full" | "setup-only" | "setup-runtime" | "cli-metadata";
+interface PluginApi {
+  logger: PluginLogger;
+  registrationMode?: "full" | "discovery" | "tool-discovery" | "setup-only" | "setup-runtime" | "cli-metadata";
   registerTool(tool: ToolDef<TSchema>): void;
-  registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;
   registerService?(service: {
     id: string;
-    start: (ctx: PluginServiceContext) => void | Promise<void>;
-    stop?: (ctx: PluginServiceContext) => void | Promise<void>;
-  }): void;
-  on(event: string, handler: (...args: unknown[]) => void | Promise<void>, options?: {
-    priority?: number;
+    start: (context: PluginServiceContext) => void | Promise<void>;
+    stop?: (context: PluginServiceContext) => void | Promise<void>;
   }): void;
 }
-declare const plugin: {
+interface GooglePlugin {
   id: string;
   name: string;
   description: string;
   version: string;
-  activate(api: OpenClawPluginApi): void;
-  deactivate(api: OpenClawPluginApi): void;
-};
+  activate(api: PluginApi): void;
+  deactivate(api: PluginApi): void;
+}
+//#endregion
+//#region src/plugin.d.ts
+declare const plugin: GooglePlugin;
 //#endregion
 export { plugin as t };
 //# sourceMappingURL=plugin.d.cts.map

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":["KitLogger","ToolResult","ToolDef","TParameters","Record","Promise","ok","errResult","defineTool","IpcResponse","IpcClient","ConnectToDaemonOptions","connectToDaemon","ResolveOpenClawSdkOptions","resolveOpenClawSdk","T","getActivationKey","isActivated","resetActivation","guardedStart","ScheduleRefreshOptions","RefreshHandle","scheduleRefresh"],"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/**\n * Tool-definition helpers — the `defineTool` / `ok` / `errResult` trio that\n * was copy-pasted across 8 plugins (identity, google, teams, mobile,\n * whatsapp, voice, chat a2a-tools, base openclaw).\n *\n * Error handling is standardized on the openclaw-google variant — the only\n * copy that survived non-`Error` throws (`e instanceof Error ? e.message :\n * \"Unknown error\"`). The other copies did `(e as Error).message`, which\n * crashes the tool executor when a handler throws a string/object.\n */\n/** Shape returned to OpenClaw from a tool `execute`. */\ninterface ToolResult {\n  content: {\n    type: \"text\";\n    text: string;\n  }[];\n  details: unknown;\n}\n/**\n * An OpenClaw tool definition.\n *\n * `parameters` is generic because the fleet is split between TypeBox\n * `TSchema` schemas (identity/google/teams/mobile/whatsapp) and plain\n * JSON-Schema objects (chat a2a-tools). Instantiate with whichever schema\n * type the plugin uses — the kit itself has no schema dependency.\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/** Wrap a successful handler result in the OpenClaw tool-result envelope. */\ndeclare function ok(data: unknown): ToolResult;\n/** Wrap an error message in the OpenClaw tool-result envelope. */\ndeclare function errResult(message: string): ToolResult;\n/**\n * Define an OpenClaw tool from a plain async handler. Handler throws (of\n * any type — `Error` or not) are converted to `errResult` envelopes so the\n * LLM sees a structured error instead of the tool executor crashing.\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\n/** Response envelope for daemon IPC requests. */\ninterface IpcResponse {\n  ok: boolean;\n  error?: {\n    message?: string;\n  };\n  [key: string]: unknown;\n}\n/** The subset of `@alfe.ai/openclaw`'s IPCClient the kit relies on. */\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 ConnectToDaemonOptions {\n  /** Plugin package name sent with `capability.register` (e.g. `@alfe.ai/openclaw-sync`). */\n  pluginId: string;\n  /** Capabilities to register on every (re)connect. Constants stay per-plugin. */\n  capabilities?: readonly string[];\n  /**\n   * Optional handler for daemon → plugin messages. Only invoked with\n   * object payloads — the kit does the message-shape checking.\n   */\n  onMessage?: (msg: Record<string, unknown>) => void;\n  /** Log line when the daemon isn't available (plugin runs standalone). */\n  standaloneNote?: string;\n}\n/**\n * Attempt to connect to the Alfe daemon IPC socket. Returns `null` (after\n * an info log) when `@alfe.ai/openclaw` isn't installed — plugins degrade\n * gracefully to standalone mode.\n */\ndeclare function connectToDaemon(socketPath: string, log: KitLogger, options: ConnectToDaemonOptions): Promise<IpcClient | null>;\n//# sourceMappingURL=daemon.d.ts.map\n//#endregion\n//#region src/sdk.d.ts\ninterface ResolveOpenClawSdkOptions {\n  /** Module specifier resolved from OpenClaw's context. */\n  specifier?: string;\n  /** Named export to extract from the resolved module. */\n  exportName?: string;\n  /** Warn line emitted when the SDK can't be resolved. */\n  unresolvableNote?: string;\n}\n/**\n * Resolve a named export from the running OpenClaw process's SDK.\n *\n * Defaults target `dispatchInboundDirectDmWithRuntime` from\n * `openclaw/plugin-sdk/channel-inbound` — the export both existing\n * consumers (chat, google-chat) need. Returns `null` (after a warn log)\n * when unresolvable; callers degrade gracefully.\n */\ndeclare function resolveOpenClawSdk<T = unknown>(log: KitLogger, options?: ResolveOpenClawSdkOptions): 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//#endregion\n//#region src/refresh.d.ts\ninterface ScheduleRefreshOptions {\n  /** Cadence between successful refreshes (per-provider token lifetime — stays in the consuming package). */\n  intervalMs: number;\n  /** Delay before retrying after a failed refresh. */\n  retryMs: number;\n  /** Run one refresh immediately instead of waiting a full interval first. Default false. */\n  immediate?: boolean;\n}\ninterface RefreshHandle {\n  /** Cancel the schedule. Safe to call multiple times. */\n  stop(): void;\n}\n/**\n * Run `refreshFn` every `intervalMs`; on failure, log a warning and retry\n * after `retryMs`. Timers are unref'd so the schedule never keeps the\n * process alive.\n */\ndeclare function scheduleRefresh(refreshFn: () => Promise<void>, options: ScheduleRefreshOptions, log: KitLogger): RefreshHandle;\n//# sourceMappingURL=refresh.d.ts.map\n\n//#endregion\nexport { type ConnectToDaemonOptions, type IpcClient, type IpcResponse, type KitLogger, type RefreshHandle, type ResolveOpenClawSdkOptions, type ScheduleRefreshOptions, type ToolDef, type ToolResult, connectToDaemon, defineTool, errResult, getActivationKey, guardedStart, isActivated, ok, resetActivation, resolveOpenClawSdk, scheduleRefresh };\n//# sourceMappingURL=index.d.ts.map"],"mappings":";;;;ACkCgB;;;;;AAWC;;;;;;;;;UDhBPC,UAAAA,CC2BuC;SAEW,EAAA;IAAO,IAAA,EAAA,MAAA;IAoK7D,IAAA,EAAA,MAqEL;EAAA,CAAA,EAAA;SA/De,EAAA,OAAA;;;;;;;;;;UDxLNC;;;;cAIIC;wCAC0BC,4BAA4BC,QAAQJ;;;;;;UCflE,MAAA,CAWC;EAAM,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAGP,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAiB,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAAA,KAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;OACjB,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;UARA,oBAAA,CAUW;QACkD,CAAA,EAV5D,MAU4D,CAAA,MAAA,EAAA,OAAA,CAAA;cAGtD,CAAA,EAAA,MAAA;UAAgC,CAAA,EAAA,MAAA;QAChC,CAAA,EAXN,MAWM;;UARP,iBAAA,CAUkD;EAAO,MAAA,EATzD,MASyD;EAoK7D,gBAqEL,CAAA,EAAA,MAAA,GAAA,YAAA,GAAA,eAAA,GAAA,cAAA;EAAA,YAAA,CAAA,IAAA,EAhPoB,OAgPpB,CAhP4B,OAgP5B,CAAA,CAAA,EAAA,IAAA;uBA/De,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,GAAA,IAAA,EAAA,OAAA,EAAA,EAAA,GAhLuD,OAgLvD,CAAA,OAAA,CAAA,CAAA,EAAA,IAAA;iBAwDE,EAAA,OAAA,EAAA;IAAiB,EAAA,EAAA,MAAA;iBArOlB,gCAAgC;iBAChC,gCAAgC;;4DAEW;;;;cAoKtD;;;;;gBAMU;kBAwDE"}
+{"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/runtime.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":";;;;ACyCC;;;;UDtBSC,UAAAA,CC4Ba;EAGvB,OAAiB,EAAA;IAAS,IAAA,EAAA,MAAA;QAChB,EAAA,MAAA;;SAQW,EAAA,OAAA;SAGA,CAAA,EAAA,OAAA;;UDnCXC,OCoCW,CAAA,cAAA,OAAA,CAAA,CAAA;QAAgC,MAAA;EAAO,WAAA,EAAA,MAAA;EAuC5D,KAAiB,EAAA,MAAA;EAAY,UAAA,EDvEfC,WCuEe;SAKb,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,ED3EwBC,MC2ExB,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GD3EoDC,OC2EpD,CD3E4DJ,UC2E5D,CAAA;;;;;AD3EwBG,UCIvB,YAAA,CDJuBA;MAAoCH,CAAAA,OAAAA,EAAAA,MAAAA,EAAAA,GAAAA,IAAAA,EAAAA,OAAAA,EAAAA,CAAAA,EAAAA,IAAAA;MAARI,CAAAA,OAAAA,EAAAA,MAAAA,EAAAA,GAAAA,IAAAA,EAAAA,OAAAA,EAAAA,CAAAA,EAAAA,IAAAA;EAAO,KAAA,CAAA,OAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;;UCWjE,oBAAA;EAPO,MAAA,CAAA,EAQN,MARkB,CAAA,MAAA,EAAA,OAAA,CAAA;EAOnB,YAAA,CAAA,EAAA,MAAA;EAAoB,QAAA,CAAA,EAAA,MAAA;QACnB,CAAA,EAGA,YAHA;;AAGY,UAGN,SAAA,CAHM;EAGN,MAAA,EACP,YADgB;EAAA,gBAAA,CAAA,EAAA,MAAA,GAAA,WAAA,GAAA,gBAAA,GAAA,YAAA,GAAA,eAAA,GAAA,cAAA;cAChB,CAAA,IAAA,EAQW,OARX,CAQmB,OARnB,CAAA,CAAA,EAAA,IAAA;iBAQmB,EAAA,OAAA,EAAA;IAAR,EAAA,EAAA,MAAA;IAGA,KAAA,EAAA,CAAA,OAAA,EAAA,oBAAA,EAAA,GAAA,IAAA,GAAgC,OAAhC,CAAA,IAAA,CAAA;IAAgC,IAAA,CAAA,EAAA,CAAA,OAAA,EAChC,oBADgC,EAAA,GAAA,IAAA,GACA,OADA,CAAA,IAAA,CAAA;MAChC,IAAA;;UAuCJ,YAAA;;;;;gBAKD;kBACE;;;;cCxGZ,QAAQ"}

package/dist/plugin.d.ts

@@ -5,16 +5,6 @@ import { TSchema } from "@sinclair/typebox";
 //# sourceMappingURL=types.d.ts.map
 //#endregion
 //#region src/tools.d.ts
-/**
- * Tool-definition helpers — the `defineTool` / `ok` / `errResult` trio that
- * was copy-pasted across 8 plugins (identity, google, teams, mobile,
- * whatsapp, voice, chat a2a-tools, base openclaw).
- *
- * Error handling is standardized on the openclaw-google variant — the only
- * copy that survived non-`Error` throws (`e instanceof Error ? e.message :
- * "Unknown error"`). The other copies did `(e as Error).message`, which
- * crashes the tool executor when a handler throws a string/object.
- */
 /** Shape returned to OpenClaw from a tool `execute`. */
 interface ToolResult {
   content: {
@@ -22,15 +12,8 @@ interface ToolResult {
     text: string;
   }[];
   details: unknown;
+  isError?: boolean;
 }
-/**
- * An OpenClaw tool definition.
- *
- * `parameters` is generic because the fleet is split between TypeBox
- * `TSchema` schemas (identity/google/teams/mobile/whatsapp) and plain
- * JSON-Schema objects (chat a2a-tools). Instantiate with whichever schema
- * type the plugin uses — the kit itself has no schema dependency.
- */
 interface ToolDef<TParameters = unknown> {
   name: string;
   description: string;
@@ -38,44 +21,42 @@ interface ToolDef<TParameters = unknown> {
   parameters: TParameters;
   execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;
 }
-/** Wrap a successful handler result in the OpenClaw tool-result envelope. */
+/** Deliberately model-safe validation/usage failure. Other exceptions stay private. */
 //#endregion
-//#region src/plugin.d.ts
-
-interface Logger {
-  info(msg: string, ...args: unknown[]): void;
-  warn(msg: string, ...args: unknown[]): void;
-  error(msg: string, ...args: unknown[]): void;
-  debug(msg: string, ...args: unknown[]): void;
+//#region src/runtime.d.ts
+interface PluginLogger {
+  info(message: string, ...args: unknown[]): void;
+  warn(message: string, ...args: unknown[]): void;
+  error(message: string, ...args: unknown[]): void;
+  debug(message: string, ...args: unknown[]): void;
 }
 interface PluginServiceContext {
   config?: Record<string, unknown>;
   workspaceDir?: string;
   stateDir?: string;
-  logger?: Logger;
+  logger?: PluginLogger;
 }
-interface OpenClawPluginApi {
-  logger: Logger;
-  registrationMode?: "full" | "setup-only" | "setup-runtime" | "cli-metadata";
+interface PluginApi {
+  logger: PluginLogger;
+  registrationMode?: "full" | "discovery" | "tool-discovery" | "setup-only" | "setup-runtime" | "cli-metadata";
   registerTool(tool: ToolDef<TSchema>): void;
-  registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;
   registerService?(service: {
     id: string;
-    start: (ctx: PluginServiceContext) => void | Promise<void>;
-    stop?: (ctx: PluginServiceContext) => void | Promise<void>;
-  }): void;
-  on(event: string, handler: (...args: unknown[]) => void | Promise<void>, options?: {
-    priority?: number;
+    start: (context: PluginServiceContext) => void | Promise<void>;
+    stop?: (context: PluginServiceContext) => void | Promise<void>;
   }): void;
 }
-declare const plugin: {
+interface GooglePlugin {
   id: string;
   name: string;
   description: string;
   version: string;
-  activate(api: OpenClawPluginApi): void;
-  deactivate(api: OpenClawPluginApi): void;
-};
+  activate(api: PluginApi): void;
+  deactivate(api: PluginApi): void;
+}
+//#endregion
+//#region src/plugin.d.ts
+declare const plugin: GooglePlugin;
 //#endregion
 export { plugin as t };
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","names":["KitLogger","ToolResult","ToolDef","TParameters","Record","Promise","ok","errResult","defineTool","IpcResponse","IpcClient","ConnectToDaemonOptions","connectToDaemon","ResolveOpenClawSdkOptions","resolveOpenClawSdk","T","getActivationKey","isActivated","resetActivation","guardedStart","ScheduleRefreshOptions","RefreshHandle","scheduleRefresh"],"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/**\n * Tool-definition helpers — the `defineTool` / `ok` / `errResult` trio that\n * was copy-pasted across 8 plugins (identity, google, teams, mobile,\n * whatsapp, voice, chat a2a-tools, base openclaw).\n *\n * Error handling is standardized on the openclaw-google variant — the only\n * copy that survived non-`Error` throws (`e instanceof Error ? e.message :\n * \"Unknown error\"`). The other copies did `(e as Error).message`, which\n * crashes the tool executor when a handler throws a string/object.\n */\n/** Shape returned to OpenClaw from a tool `execute`. */\ninterface ToolResult {\n  content: {\n    type: \"text\";\n    text: string;\n  }[];\n  details: unknown;\n}\n/**\n * An OpenClaw tool definition.\n *\n * `parameters` is generic because the fleet is split between TypeBox\n * `TSchema` schemas (identity/google/teams/mobile/whatsapp) and plain\n * JSON-Schema objects (chat a2a-tools). Instantiate with whichever schema\n * type the plugin uses — the kit itself has no schema dependency.\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/** Wrap a successful handler result in the OpenClaw tool-result envelope. */\ndeclare function ok(data: unknown): ToolResult;\n/** Wrap an error message in the OpenClaw tool-result envelope. */\ndeclare function errResult(message: string): ToolResult;\n/**\n * Define an OpenClaw tool from a plain async handler. Handler throws (of\n * any type — `Error` or not) are converted to `errResult` envelopes so the\n * LLM sees a structured error instead of the tool executor crashing.\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\n/** Response envelope for daemon IPC requests. */\ninterface IpcResponse {\n  ok: boolean;\n  error?: {\n    message?: string;\n  };\n  [key: string]: unknown;\n}\n/** The subset of `@alfe.ai/openclaw`'s IPCClient the kit relies on. */\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 ConnectToDaemonOptions {\n  /** Plugin package name sent with `capability.register` (e.g. `@alfe.ai/openclaw-sync`). */\n  pluginId: string;\n  /** Capabilities to register on every (re)connect. Constants stay per-plugin. */\n  capabilities?: readonly string[];\n  /**\n   * Optional handler for daemon → plugin messages. Only invoked with\n   * object payloads — the kit does the message-shape checking.\n   */\n  onMessage?: (msg: Record<string, unknown>) => void;\n  /** Log line when the daemon isn't available (plugin runs standalone). */\n  standaloneNote?: string;\n}\n/**\n * Attempt to connect to the Alfe daemon IPC socket. Returns `null` (after\n * an info log) when `@alfe.ai/openclaw` isn't installed — plugins degrade\n * gracefully to standalone mode.\n */\ndeclare function connectToDaemon(socketPath: string, log: KitLogger, options: ConnectToDaemonOptions): Promise<IpcClient | null>;\n//# sourceMappingURL=daemon.d.ts.map\n//#endregion\n//#region src/sdk.d.ts\ninterface ResolveOpenClawSdkOptions {\n  /** Module specifier resolved from OpenClaw's context. */\n  specifier?: string;\n  /** Named export to extract from the resolved module. */\n  exportName?: string;\n  /** Warn line emitted when the SDK can't be resolved. */\n  unresolvableNote?: string;\n}\n/**\n * Resolve a named export from the running OpenClaw process's SDK.\n *\n * Defaults target `dispatchInboundDirectDmWithRuntime` from\n * `openclaw/plugin-sdk/channel-inbound` — the export both existing\n * consumers (chat, google-chat) need. Returns `null` (after a warn log)\n * when unresolvable; callers degrade gracefully.\n */\ndeclare function resolveOpenClawSdk<T = unknown>(log: KitLogger, options?: ResolveOpenClawSdkOptions): 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//#endregion\n//#region src/refresh.d.ts\ninterface ScheduleRefreshOptions {\n  /** Cadence between successful refreshes (per-provider token lifetime — stays in the consuming package). */\n  intervalMs: number;\n  /** Delay before retrying after a failed refresh. */\n  retryMs: number;\n  /** Run one refresh immediately instead of waiting a full interval first. Default false. */\n  immediate?: boolean;\n}\ninterface RefreshHandle {\n  /** Cancel the schedule. Safe to call multiple times. */\n  stop(): void;\n}\n/**\n * Run `refreshFn` every `intervalMs`; on failure, log a warning and retry\n * after `retryMs`. Timers are unref'd so the schedule never keeps the\n * process alive.\n */\ndeclare function scheduleRefresh(refreshFn: () => Promise<void>, options: ScheduleRefreshOptions, log: KitLogger): RefreshHandle;\n//# sourceMappingURL=refresh.d.ts.map\n\n//#endregion\nexport { type ConnectToDaemonOptions, type IpcClient, type IpcResponse, type KitLogger, type RefreshHandle, type ResolveOpenClawSdkOptions, type ScheduleRefreshOptions, type ToolDef, type ToolResult, connectToDaemon, defineTool, errResult, getActivationKey, guardedStart, isActivated, ok, resetActivation, resolveOpenClawSdk, scheduleRefresh };\n//# sourceMappingURL=index.d.ts.map"],"mappings":";;;;ACkCgB;;;;;AAWC;;;;;;;;;UDhBPC,UAAAA,CC2BuC;SAEW,EAAA;IAAO,IAAA,EAAA,MAAA;IAoK7D,IAAA,EAAA,MAqEL;EAAA,CAAA,EAAA;SA/De,EAAA,OAAA;;;;;;;;;;UDxLNC;;;;cAIIC;wCAC0BC,4BAA4BC,QAAQJ;;;;;;UCflE,MAAA,CAWC;EAAM,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAGP,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAiB,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAAA,KAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;OACjB,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;UARA,oBAAA,CAUW;QACkD,CAAA,EAV5D,MAU4D,CAAA,MAAA,EAAA,OAAA,CAAA;cAGtD,CAAA,EAAA,MAAA;UAAgC,CAAA,EAAA,MAAA;QAChC,CAAA,EAXN,MAWM;;UARP,iBAAA,CAUkD;EAAO,MAAA,EATzD,MASyD;EAoK7D,gBAqEL,CAAA,EAAA,MAAA,GAAA,YAAA,GAAA,eAAA,GAAA,cAAA;EAAA,YAAA,CAAA,IAAA,EAhPoB,OAgPpB,CAhP4B,OAgP5B,CAAA,CAAA,EAAA,IAAA;uBA/De,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,GAAA,IAAA,EAAA,OAAA,EAAA,EAAA,GAhLuD,OAgLvD,CAAA,OAAA,CAAA,CAAA,EAAA,IAAA;iBAwDE,EAAA,OAAA,EAAA;IAAiB,EAAA,EAAA,MAAA;iBArOlB,gCAAgC;iBAChC,gCAAgC;;4DAEW;;;;cAoKtD;;;;;gBAMU;kBAwDE"}
+{"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/runtime.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":";;;;ACyCC;;;;UDtBSC,UAAAA,CC4Ba;EAGvB,OAAiB,EAAA;IAAS,IAAA,EAAA,MAAA;QAChB,EAAA,MAAA;;SAQW,EAAA,OAAA;SAGA,CAAA,EAAA,OAAA;;UDnCXC,OCoCW,CAAA,cAAA,OAAA,CAAA,CAAA;QAAgC,MAAA;EAAO,WAAA,EAAA,MAAA;EAuC5D,KAAiB,EAAA,MAAA;EAAY,UAAA,EDvEfC,WCuEe;SAKb,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,ED3EwBC,MC2ExB,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GD3EoDC,OC2EpD,CD3E4DJ,UC2E5D,CAAA;;;;;AD3EwBG,UCIvB,YAAA,CDJuBA;MAAoCH,CAAAA,OAAAA,EAAAA,MAAAA,EAAAA,GAAAA,IAAAA,EAAAA,OAAAA,EAAAA,CAAAA,EAAAA,IAAAA;MAARI,CAAAA,OAAAA,EAAAA,MAAAA,EAAAA,GAAAA,IAAAA,EAAAA,OAAAA,EAAAA,CAAAA,EAAAA,IAAAA;EAAO,KAAA,CAAA,OAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;;UCWjE,oBAAA;EAPO,MAAA,CAAA,EAQN,MARkB,CAAA,MAAA,EAAA,OAAA,CAAA;EAOnB,YAAA,CAAA,EAAA,MAAA;EAAoB,QAAA,CAAA,EAAA,MAAA;QACnB,CAAA,EAGA,YAHA;;AAGY,UAGN,SAAA,CAHM;EAGN,MAAA,EACP,YADgB;EAAA,gBAAA,CAAA,EAAA,MAAA,GAAA,WAAA,GAAA,gBAAA,GAAA,YAAA,GAAA,eAAA,GAAA,cAAA;cAChB,CAAA,IAAA,EAQW,OARX,CAQmB,OARnB,CAAA,CAAA,EAAA,IAAA;iBAQmB,EAAA,OAAA,EAAA;IAAR,EAAA,EAAA,MAAA;IAGA,KAAA,EAAA,CAAA,OAAA,EAAA,oBAAA,EAAA,GAAA,IAAA,GAAgC,OAAhC,CAAA,IAAA,CAAA;IAAgC,IAAA,CAAA,EAAA,CAAA,OAAA,EAChC,oBADgC,EAAA,GAAA,IAAA,GACA,OADA,CAAA,IAAA,CAAA;MAChC,IAAA;;UAuCJ,YAAA;;;;;gBAKD;kBACE;;;;cCxGZ,QAAQ"}