@alfe.ai/openclaw-google 0.0.40 → 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.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/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,220 +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 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");
-function ok(data) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify(data)
-		}],
-		details: data
-	};
-}
-function errResult(message) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify({ error: message })
-		}],
-		details: { error: message }
-	};
-}
-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 instanceof Error ? e.message : "Unknown error");
-			}
-		}
-	};
-}
-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 = [
-	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
-			};
-		}
-	}),
-	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
-			};
-		}
-	}),
-	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 = () => {
-			if (globalThis.__googlePluginActivated === true) {
-				log.debug("Google plugin already activated — skipping duplicate");
-				return;
-			}
-			globalThis.__googlePluginActivated = true;
-			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");
-			}
-			log.info("Alfe Google Workspace plugin activated");
-		};
-		const stopGoogleService = () => {
-			globalThis.__googlePluginActivated = false;
-			client = null;
-			cachedAccounts = [];
-			log.info("Alfe Google Workspace plugin stopped");
-		};
-		if (api.registerService) api.registerService({
-			id: "alfe-google-workspace",
-			start: () => {
-				startGoogleService();
-			},
-			stop: () => {
-				stopGoogleService();
-			}
-		});
-	},
-	deactivate(api) {
-		globalThis.__googlePluginActivated = false;
-		client = null;
-		cachedAccounts = [];
-		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

@@ -1,54 +1,62 @@
 import { TSchema } from "@sinclair/typebox";
 
-//#region src/plugin.d.ts
+//#region ../openclaw-plugin-kit/dist/index.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;
+//# 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/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";
-  registerTool(tool: ToolDef): void;
-  registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;
+interface PluginApi {
+  logger: PluginLogger;
+  registrationMode?: "full" | "discovery" | "tool-discovery" | "setup-only" | "setup-runtime" | "cli-metadata";
+  registerTool(tool: ToolDef<TSchema>): void;
   registerService?(service: {
     id: string;
-    start: (ctx: PluginServiceContext) => void | Promise<void>;
-    stop?: (ctx: PluginServiceContext) => void | Promise<void>;
+    start: (context: PluginServiceContext) => void | Promise<void>;
+    stop?: (context: PluginServiceContext) => void | Promise<void>;
   }): 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: {
+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 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":";;;;UA2BU,MAAA,CAsBuC;MAEW,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAAO,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAKzD,KAAA,CAAA,GAAA,EAAO,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;;UAtBP,oBAAA,CA2B8B;QAA4B,CAAA,EA1BzD,MA0ByD,CAAA,MAAA,EAAA,OAAA,CAAA;EAAO,YAAA,CAAA,EAAA,MAAA;EAiMrE,QAAA,CAmEL,EAAA,MAAA;EAAA,MAAA,CAAA,EA3RU,MA2RV;;UAxRS,iBAAA,CAkRQ;EAAiB,MAAA,EAjRzB,MAiRyB;;qBA/Qd;uEACkD;;;iBAGtD,gCAAgC;iBAChC,gCAAgC;;4DAEW;;;;UAKlD,OAAA;;;;cAII;wCAC0B,4BAA4B;;;;;;;;cAiM9D;;;;;gBAMU;kBAuDE"}
+{"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

@@ -1,54 +1,62 @@
 import { TSchema } from "@sinclair/typebox";
 
-//#region src/plugin.d.ts
+//#region ../openclaw-plugin-kit/dist/index.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;
+//# 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/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";
-  registerTool(tool: ToolDef): void;
-  registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;
+interface PluginApi {
+  logger: PluginLogger;
+  registrationMode?: "full" | "discovery" | "tool-discovery" | "setup-only" | "setup-runtime" | "cli-metadata";
+  registerTool(tool: ToolDef<TSchema>): void;
   registerService?(service: {
     id: string;
-    start: (ctx: PluginServiceContext) => void | Promise<void>;
-    stop?: (ctx: PluginServiceContext) => void | Promise<void>;
+    start: (context: PluginServiceContext) => void | Promise<void>;
+    stop?: (context: PluginServiceContext) => void | Promise<void>;
   }): 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: {
+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 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":";;;;UA2BU,MAAA,CAsBuC;MAEW,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAAO,IAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,IAAA,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;EAKzD,KAAA,CAAA,GAAA,EAAO,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;;UAtBP,oBAAA,CA2B8B;QAA4B,CAAA,EA1BzD,MA0ByD,CAAA,MAAA,EAAA,OAAA,CAAA;EAAO,YAAA,CAAA,EAAA,MAAA;EAiMrE,QAAA,CAmEL,EAAA,MAAA;EAAA,MAAA,CAAA,EA3RU,MA2RV;;UAxRS,iBAAA,CAkRQ;EAAiB,MAAA,EAjRzB,MAiRyB;;qBA/Qd;uEACkD;;;iBAGtD,gCAAgC;iBAChC,gCAAgC;;4DAEW;;;;UAKlD,OAAA;;;;cAII;wCAC0B,4BAA4B;;;;;;;;cAiM9D;;;;;gBAMU;kBAuDE"}
+{"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"}