@alfe.ai/gateway 0.9.19 → 0.10.0

package/dist/health.js

@@ -5662,16 +5662,20 @@ const MAX_IPC_MESSAGE_BYTES = 1024 * 1024;
 * Map a cloud command name to an IPC method name.
 * Cloud commands use dot-notation matching IPC methods.
 *
-* Currently empty — Phase 1 has no daemon-to-plugin commands.
-* Commands will be added here as the protocol evolves.
+* Work reads are dispatched by executeWorkCommand so they select a capable
+* OpenClaw plugin and fail immediately instead of joining an offline queue.
 */
-const CLOUD_COMMAND_TO_IPC = {};
+const CLOUD_COMMAND_TO_IPC = {
+	"work.snapshot": "work.snapshot",
+	"work.job_runs": "work.job_runs",
+	"work.actions": "work.actions"
+};
 /**
 * Translate a cloud COMMAND into a local IPC request.
 * Returns null if the command isn't recognized.
 */
 function cloudCommandToIPCRequest(command) {
-	const method = CLOUD_COMMAND_TO_IPC[command.command];
+	const method = Object.hasOwn(CLOUD_COMMAND_TO_IPC, command.command) ? CLOUD_COMMAND_TO_IPC[command.command] : void 0;
 	if (!method) return null;
 	return {
 		type: "req",
@@ -6997,6 +7001,42 @@ var CommandQueue = class {
 	}
 };
 //#endregion
+//#region src/work-commands.ts
+const WORK_COMMANDS = [
+	"work.snapshot",
+	"work.job_runs",
+	"work.actions"
+];
+function isWorkCommand(command) {
+	return WORK_COMMANDS.includes(command);
+}
+const MAX_WORK_RESPONSE_BYTES = 768 * 1024;
+/** Read requests never enter an offline queue or choose an arbitrary connected plugin. */
+async function executeWorkCommand(command, agentId, runtime, ipc) {
+	const error = (code, message) => ({
+		type: "COMMAND_ACK",
+		commandId: command.commandId,
+		status: "error",
+		result: {
+			code,
+			message
+		}
+	});
+	if (!isWorkCommand(command.command)) return error("UNKNOWN_COMMAND", "Unsupported work command");
+	if (command.agentId !== agentId) return error("AGENT_MISMATCH", "Work request targets a different agent");
+	if (runtime !== "openclaw") return error("UNSUPPORTED_RUNTIME", "Work visibility is available for OpenClaw agents");
+	if (!command.payload || typeof command.payload !== "object" || Array.isArray(command.payload)) return error("INVALID_PARAMS", "Work parameters must be an object");
+	const plugin = ipc?.getRegisteredPlugins().find(([, info]) => info.name === "@alfe.ai/openclaw" && info.capabilities.includes("work.read"));
+	if (!ipc || !plugin) return error("WORK_UNAVAILABLE", "The runtime work bridge is unavailable; update the agent if needed");
+	try {
+		const response = await ipc.sendRequest(plugin[0], command.command, command.payload, 6e3);
+		if (Buffer.byteLength(JSON.stringify(response), "utf8") > MAX_WORK_RESPONSE_BYTES) return error("RESPONSE_TOO_LARGE", "Runtime work data exceeds the response limit");
+		return ipcResponseToCloudAck(command.commandId, response);
+	} catch {
+		return error("WORK_UNAVAILABLE", "The runtime work bridge did not respond");
+	}
+}
+//#endregion
 //#region src/process-manager.ts
 /**
 * Process management — launchd/systemd service installation.
@@ -9211,6 +9251,10 @@ let cloudConnected = false;
 * so a duplicate is ACKed with the prior result without re-executing.
 */
 const commandDedupe = new CommandDedupe();
+const workCommandDedupe = new CommandDedupe({
+	maxEntries: 4,
+	ttlMs: 5e3
+});
 let shuttingDown = false;
 let commandRegistry;
 let resolvedCliVersion;
@@ -9553,7 +9597,7 @@ async function startDaemon() {
 * bounce the box a second time.
 */
 async function handleCloudCommand(command) {
-	const { ack, duplicate } = await commandDedupe.run(command.commandId, () => executeCloudCommand(command));
+	const { ack, duplicate } = await (isWorkCommand(command.command) ? workCommandDedupe : commandDedupe).run(command.commandId, () => executeCloudCommand(command));
 	if (duplicate) {
 		logger.info({
 			commandId: command.commandId,
@@ -9606,6 +9650,7 @@ async function drainRuntimeBeforeExit(reason) {
 	}, "Runtime still mid-turn at drain grace deadline — proceeding with daemon exit");
 }
 async function executeCloudCommand(command) {
+	if (isWorkCommand(command.command)) return executeWorkCommand(command, config.agentId, config.runtime, ipcServer);
 	if (command.command === "daemon.update") {
 		const version = command.payload?.version ?? "latest";
 		setTimeout(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/gateway",
-  "version": "0.9.19",
+  "version": "0.10.0",
   "description": "Alfe local gateway daemon — persistent control plane for agent integrations",
   "type": "module",
   "bin": {
@@ -23,7 +23,7 @@
     "pino-roll": "^1.2.0",
     "smol-toml": ">=1.6.1",
     "ws": "^8.18.0",
-    "@alfe.ai/agent-api-client": "^0.19.1",
+    "@alfe.ai/agent-api-client": "^0.19.2",
     "@alfe.ai/ai-proxy-local": "^0.0.17",
     "@alfe.ai/config": "^0.4.1",
     "@alfe.ai/integration-manifest": "^0.4.2",