@kb-labs/host-agent-entry 2.14.0

package/README.md

@@ -0,0 +1 @@
+# TODO

package/dist/commands/flags.d.ts

@@ -0,0 +1,46 @@
+declare const registerFlags: {
+    gateway: {
+        type: "string";
+        describe: string;
+        required: boolean;
+    };
+    name: {
+        type: "string";
+        describe: string;
+    };
+    workspace: {
+        type: "array";
+        describe: string;
+        string: boolean;
+    };
+    namespace: {
+        type: "string";
+        describe: string;
+        default: string;
+    };
+    json: {
+        type: "boolean";
+        describe: string;
+        default: boolean;
+    };
+};
+declare const statusFlags: {
+    json: {
+        type: "boolean";
+        describe: string;
+        default: boolean;
+    };
+};
+declare const listFlags: {
+    json: {
+        type: "boolean";
+        describe: string;
+        default: boolean;
+    };
+    gateway: {
+        type: "string";
+        describe: string;
+    };
+};
+
+export { listFlags, registerFlags, statusFlags };

package/dist/commands/flags.js

@@ -0,0 +1,49 @@
+// src/commands/flags.ts
+var registerFlags = {
+  gateway: {
+    type: "string",
+    describe: "Gateway URL (e.g. http://localhost:4000 or https://gateway.example.com)",
+    required: true
+  },
+  name: {
+    type: "string",
+    describe: "Display name for this host (default: hostname)"
+  },
+  workspace: {
+    type: "array",
+    describe: "Workspace paths this agent is allowed to access (can specify multiple)",
+    string: true
+  },
+  namespace: {
+    type: "string",
+    describe: 'Namespace ID (default: "default")',
+    default: "default"
+  },
+  json: {
+    type: "boolean",
+    describe: "Output as JSON",
+    default: false
+  }
+};
+var statusFlags = {
+  json: {
+    type: "boolean",
+    describe: "Output as JSON",
+    default: false
+  }
+};
+var listFlags = {
+  json: {
+    type: "boolean",
+    describe: "Output as JSON",
+    default: false
+  },
+  gateway: {
+    type: "string",
+    describe: "Gateway URL (default: from ~/.kb/agent.json or http://localhost:4000)"
+  }
+};
+
+export { listFlags, registerFlags, statusFlags };
+//# sourceMappingURL=flags.js.map
+//# sourceMappingURL=flags.js.map

package/dist/commands/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/flags.ts"],"names":[],"mappings":";AAAO,IAAM,aAAA,GAAgB;AAAA,EAC3B,OAAA,EAAS;AAAA,IACP,IAAA,EAAM,QAAA;AAAA,IACN,QAAA,EAAU,yEAAA;AAAA,IACV,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,QAAA;AAAA,IACN,QAAA,EAAU;AAAA,GACZ;AAAA,EACA,SAAA,EAAW;AAAA,IACT,IAAA,EAAM,OAAA;AAAA,IACN,QAAA,EAAU,wEAAA;AAAA,IACV,MAAA,EAAQ;AAAA,GACV;AAAA,EACA,SAAA,EAAW;AAAA,IACT,IAAA,EAAM,QAAA;AAAA,IACN,QAAA,EAAU,mCAAA;AAAA,IACV,OAAA,EAAS;AAAA,GACX;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,SAAA;AAAA,IACN,QAAA,EAAU,gBAAA;AAAA,IACV,OAAA,EAAS;AAAA;AAEb;AAEO,IAAM,WAAA,GAAc;AAAA,EACzB,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,SAAA;AAAA,IACN,QAAA,EAAU,gBAAA;AAAA,IACV,OAAA,EAAS;AAAA;AAEb;AAEO,IAAM,SAAA,GAAY;AAAA,EACvB,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,SAAA;AAAA,IACN,QAAA,EAAU,gBAAA;AAAA,IACV,OAAA,EAAS;AAAA,GACX;AAAA,EACA,OAAA,EAAS;AAAA,IACP,IAAA,EAAM,QAAA;AAAA,IACN,QAAA,EAAU;AAAA;AAEd","file":"flags.js","sourcesContent":["export const registerFlags = {\n  gateway: {\n    type: 'string' as const,\n    describe: 'Gateway URL (e.g. http://localhost:4000 or https://gateway.example.com)',\n    required: true,\n  },\n  name: {\n    type: 'string' as const,\n    describe: 'Display name for this host (default: hostname)',\n  },\n  workspace: {\n    type: 'array' as const,\n    describe: 'Workspace paths this agent is allowed to access (can specify multiple)',\n    string: true,\n  },\n  namespace: {\n    type: 'string' as const,\n    describe: 'Namespace ID (default: \"default\")',\n    default: 'default',\n  },\n  json: {\n    type: 'boolean' as const,\n    describe: 'Output as JSON',\n    default: false,\n  },\n};\n\nexport const statusFlags = {\n  json: {\n    type: 'boolean' as const,\n    describe: 'Output as JSON',\n    default: false,\n  },\n};\n\nexport const listFlags = {\n  json: {\n    type: 'boolean' as const,\n    describe: 'Output as JSON',\n    default: false,\n  },\n  gateway: {\n    type: 'string' as const,\n    describe: 'Gateway URL (default: from ~/.kb/agent.json or http://localhost:4000)',\n  },\n};\n"]}

package/dist/commands/list.d.ts

@@ -0,0 +1,13 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+/**
+ * workspace:list command
+ * List all connected Workspace Agents via Gateway REST API.
+ */
+type ListInput = {
+    json?: boolean;
+    gateway?: string;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, ListInput, unknown>;
+
+export { _default as default };

package/dist/commands/list.js

@@ -0,0 +1,114 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+// src/commands/list.ts
+var list_default = defineCommand({
+  id: "workspace:list",
+  description: "List all connected Workspace Agents",
+  handler: {
+    async execute(ctx, rawInput) {
+      const input = rawInput.flags ?? rawInput;
+      let gatewayUrl = input.gateway;
+      if (!gatewayUrl) {
+        try {
+          const configPath = join(homedir(), ".kb", "agent.json");
+          const config = JSON.parse(readFileSync(configPath, "utf-8"));
+          gatewayUrl = config.gatewayUrl;
+        } catch {
+        }
+      }
+      gatewayUrl = gatewayUrl ?? ctx.runtime?.env?.("KB_GATEWAY_URL") ?? "http://localhost:4000";
+      let token;
+      try {
+        const configPath = join(homedir(), ".kb", "agent.json");
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        if (config.clientId && config.clientSecret) {
+          const tokenRes = await fetch(`${gatewayUrl}/auth/token`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ clientId: config.clientId, clientSecret: config.clientSecret })
+          });
+          if (tokenRes.ok) {
+            const body = await tokenRes.json();
+            token = body.accessToken;
+          }
+        }
+      } catch {
+      }
+      const headers = {};
+      if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+      }
+      let hosts = [];
+      try {
+        const res = await fetch(`${gatewayUrl}/hosts`, { headers });
+        if (res.ok) {
+          const body = await res.json();
+          hosts = body.hosts;
+        } else {
+          ctx.ui?.error?.(`Failed to list hosts: HTTP ${res.status}`);
+          return { exitCode: 1, hosts: [] };
+        }
+      } catch (err) {
+        ctx.ui?.error?.(`Cannot reach Gateway at ${gatewayUrl}: ${err instanceof Error ? err.message : String(err)}`);
+        return { exitCode: 1, hosts: [] };
+      }
+      if (input.json) {
+        ctx.ui?.json?.({ hosts });
+        return { exitCode: 0, hosts };
+      }
+      if (hosts.length === 0) {
+        ctx.ui?.info?.("No Workspace Agents connected.");
+        return { exitCode: 0, hosts: [] };
+      }
+      const statusIcon = (s) => {
+        switch (s) {
+          case "online":
+            return "\x1B[32m\u25CF\x1B[0m";
+          case "reconnecting":
+            return "\x1B[33m\u25D0\x1B[0m";
+          case "degraded":
+            return "\x1B[33m\u25D0\x1B[0m";
+          case "offline":
+            return "\x1B[31m\u25CB\x1B[0m";
+          default:
+            return "?";
+        }
+      };
+      const ago = (ts) => {
+        const sec = Math.floor((Date.now() - ts) / 1e3);
+        if (sec < 60) {
+          return `${sec}s ago`;
+        }
+        if (sec < 3600) {
+          return `${Math.floor(sec / 60)}m ago`;
+        }
+        if (sec < 86400) {
+          return `${Math.floor(sec / 3600)}h ago`;
+        }
+        return `${Math.floor(sec / 86400)}d ago`;
+      };
+      const lines = hosts.map(
+        (h) => `  ${statusIcon(h.status)} ${h.name.padEnd(28)} ${h.status.padEnd(14)} ${(h.capabilities || []).join(", ").padEnd(30)} ${ago(h.lastSeen)}`
+      );
+      ctx.ui?.success?.("Workspace Agents", {
+        sections: [{
+          items: [
+            `  ${"Name".padEnd(30)} ${"Status".padEnd(14)} ${"Capabilities".padEnd(30)} Last Seen`,
+            `  ${"\u2500".repeat(30)} ${"\u2500".repeat(14)} ${"\u2500".repeat(30)} \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`,
+            ...lines,
+            "",
+            `  ${hosts.filter((h) => h.status === "online").length} online, ${hosts.filter((h) => h.status === "offline").length} offline (${hosts.length} total)`
+          ]
+        }]
+      });
+      return { exitCode: 0, hosts };
+    }
+  }
+});
+
+export { list_default as default };
+//# sourceMappingURL=list.js.map
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/list.ts"],"names":[],"mappings":"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","file":"list.js","sourcesContent":["/**\n * workspace:list command\n * List all connected Workspace Agents via Gateway REST API.\n */\n\nimport { defineCommand, type PluginContextV3 } from '@kb-labs/sdk';\nimport { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { homedir } from 'node:os';\n\ntype ListInput = {\n  json?: boolean;\n  gateway?: string;\n};\n\ninterface HostEntry {\n  hostId: string;\n  name: string;\n  status: string;\n  capabilities: string[];\n  hostType?: string;\n  lastSeen: number;\n  connections: string[];\n}\n\ntype ListResult = {\n  exitCode: number;\n  hosts: HostEntry[];\n};\n\nexport default defineCommand({\n  id: 'workspace:list',\n  description: 'List all connected Workspace Agents',\n\n  handler: {\n    async execute(ctx: PluginContextV3, rawInput: ListInput): Promise<ListResult> {\n      const input: ListInput = (rawInput as any).flags ?? rawInput;\n\n      // Resolve Gateway URL: flag > agent config > env > default\n      let gatewayUrl = input.gateway;\n      if (!gatewayUrl) {\n        try {\n          const configPath = join(homedir(), '.kb', 'agent.json');\n          const config = JSON.parse(readFileSync(configPath, 'utf-8'));\n          gatewayUrl = config.gatewayUrl;\n        } catch {\n          // No agent config\n        }\n      }\n      gatewayUrl = gatewayUrl ?? ctx.runtime?.env?.('KB_GATEWAY_URL') ?? 'http://localhost:4000';\n\n      // Get auth token\n      let token: string | undefined;\n      try {\n        const configPath = join(homedir(), '.kb', 'agent.json');\n        const config = JSON.parse(readFileSync(configPath, 'utf-8'));\n        if (config.clientId && config.clientSecret) {\n          const tokenRes = await fetch(`${gatewayUrl}/auth/token`, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json' },\n            body: JSON.stringify({ clientId: config.clientId, clientSecret: config.clientSecret }),\n          });\n          if (tokenRes.ok) {\n            const body = await tokenRes.json() as { accessToken?: string };\n            token = body.accessToken;\n          }\n        }\n      } catch {\n        // Auth failed — try without\n      }\n\n      // Fetch hosts\n      const headers: Record<string, string> = {};\n      if (token) {\n        headers['Authorization'] = `Bearer ${token}`;\n      }\n\n      let hosts: HostEntry[] = [];\n      try {\n        const res = await fetch(`${gatewayUrl}/hosts`, { headers });\n        if (res.ok) {\n          const body = await res.json() as { hosts: HostEntry[] };\n          hosts = body.hosts;\n        } else {\n          ctx.ui?.error?.(`Failed to list hosts: HTTP ${res.status}`);\n          return { exitCode: 1, hosts: [] };\n        }\n      } catch (err) {\n        ctx.ui?.error?.(`Cannot reach Gateway at ${gatewayUrl}: ${err instanceof Error ? err.message : String(err)}`);\n        return { exitCode: 1, hosts: [] };\n      }\n\n      if (input.json) {\n        ctx.ui?.json?.({ hosts });\n        return { exitCode: 0, hosts };\n      }\n\n      if (hosts.length === 0) {\n        ctx.ui?.info?.('No Workspace Agents connected.');\n        return { exitCode: 0, hosts: [] };\n      }\n\n      // Format table\n      const statusIcon = (s: string) => {\n        switch (s) {\n          case 'online': return '\\u001b[32m●\\u001b[0m';\n          case 'reconnecting': return '\\u001b[33m◐\\u001b[0m';\n          case 'degraded': return '\\u001b[33m◐\\u001b[0m';\n          case 'offline': return '\\u001b[31m○\\u001b[0m';\n          default: return '?';\n        }\n      };\n\n      const ago = (ts: number) => {\n        const sec = Math.floor((Date.now() - ts) / 1000);\n        if (sec < 60) {return `${sec}s ago`;}\n        if (sec < 3600) {return `${Math.floor(sec / 60)}m ago`;}\n        if (sec < 86400) {return `${Math.floor(sec / 3600)}h ago`;}\n        return `${Math.floor(sec / 86400)}d ago`;\n      };\n\n      const lines = hosts.map(h =>\n        `  ${statusIcon(h.status)} ${h.name.padEnd(28)} ${h.status.padEnd(14)} ${(h.capabilities || []).join(', ').padEnd(30)} ${ago(h.lastSeen)}`\n      );\n\n      ctx.ui?.success?.('Workspace Agents', {\n        sections: [{\n          items: [\n            `  ${'Name'.padEnd(30)} ${'Status'.padEnd(14)} ${'Capabilities'.padEnd(30)} Last Seen`,\n            `  ${'─'.repeat(30)} ${'─'.repeat(14)} ${'─'.repeat(30)} ─────────`,\n            ...lines,\n            '',\n            `  ${hosts.filter(h => h.status === 'online').length} online, ${hosts.filter(h => h.status === 'offline').length} offline (${hosts.length} total)`,\n          ],\n        }],\n      });\n\n      return { exitCode: 0, hosts };\n    },\n  },\n});\n"]}

package/dist/commands/register.d.ts

@@ -0,0 +1,16 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+/**
+ * workspace:register command (alias: agent:register)
+ * Register this machine with a Platform Gateway and save credentials to ~/.kb/agent.json.
+ */
+type RegisterInput = {
+    gateway: string;
+    name?: string;
+    workspace?: string[];
+    namespace?: string;
+    json?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, RegisterInput, unknown>;
+
+export { _default as default };

package/dist/commands/register.js

@@ -0,0 +1,115 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { stat, mkdir, writeFile } from 'fs/promises';
+import { resolve, normalize, join } from 'path';
+import { hostname, homedir } from 'os';
+
+// src/commands/register.ts
+var register_default = defineCommand({
+  id: "workspace:register",
+  description: "Register this machine with a Platform Gateway",
+  handler: {
+    async execute(ctx, rawInput) {
+      const input = rawInput.flags ?? rawInput;
+      const gatewayUrl = (input.gateway ?? "").replace(/\/$/, "");
+      const name = input.name ?? hostname();
+      const namespaceId = input.namespace ?? "default";
+      const rawWorkspace = input.workspace;
+      const rawPaths = rawWorkspace ? Array.isArray(rawWorkspace) ? rawWorkspace : [rawWorkspace] : [process.cwd()];
+      const workspacePaths = [];
+      for (const p of rawPaths) {
+        const resolved = resolve(normalize(p));
+        let pathStat = null;
+        try {
+          pathStat = await stat(resolved);
+        } catch {
+        }
+        if (!pathStat?.isDirectory()) {
+          ctx.ui?.error?.(`Workspace path does not exist or is not a directory: ${resolved}`);
+          return { exitCode: 1 };
+        }
+        workspacePaths.push(resolved);
+      }
+      if (!gatewayUrl) {
+        ctx.ui?.error?.("--gateway is required. Example: kb workspace:register --gateway http://localhost:4000");
+        return { exitCode: 1 };
+      }
+      if (!gatewayUrl.startsWith("http://") && !gatewayUrl.startsWith("https://")) {
+        ctx.ui?.error?.("Invalid gateway URL \u2014 must start with http:// or https://");
+        return { exitCode: 1 };
+      }
+      ctx.ui?.info?.(`Registering with Gateway: ${gatewayUrl}`);
+      let res;
+      try {
+        res = await fetch(`${gatewayUrl}/auth/register`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ name, namespaceId, capabilities: ["filesystem", "git", "execution", "search", "shell"] })
+        });
+      } catch (err) {
+        ctx.ui?.error?.(`Failed to reach Gateway: ${err instanceof Error ? err.message : String(err)}`);
+        return { exitCode: 1 };
+      }
+      if (!res.ok) {
+        const rawBody = await res.text().catch(() => "");
+        const body = rawBody.slice(0, 200).replace(/[\r\n]/g, " ");
+        ctx.ui?.error?.(`Gateway returned ${res.status}: ${body}`);
+        return { exitCode: 1 };
+      }
+      let data;
+      try {
+        data = await res.json();
+      } catch {
+        ctx.ui?.error?.("Gateway response is not valid JSON");
+        return { exitCode: 1 };
+      }
+      if (!data.clientId || !data.clientSecret || !data.hostId) {
+        ctx.ui?.error?.("Gateway response is missing required fields (clientId, clientSecret, hostId)");
+        return { exitCode: 1 };
+      }
+      const SECRET_PATTERN = /^[A-Za-z0-9_\-+/=]{16,}$/;
+      if (typeof data.clientSecret !== "string" || !SECRET_PATTERN.test(data.clientSecret)) {
+        ctx.ui?.error?.("Gateway returned an invalid client secret (unexpected format)");
+        return { exitCode: 1 };
+      }
+      const kbDir = join(homedir(), ".kb");
+      await mkdir(kbDir, { recursive: true });
+      const configPath = join(kbDir, "agent.json");
+      const agentConfig = {
+        clientId: data.clientId,
+        clientSecret: data.clientSecret,
+        hostId: data.hostId,
+        gatewayUrl,
+        namespaceId,
+        hostType: "local",
+        workspacePaths,
+        execution: {
+          mode: "in-process",
+          timeoutMs: 12e4
+        }
+      };
+      await writeFile(configPath, JSON.stringify(agentConfig, null, 2), { mode: 384 });
+      if (input.json) {
+        ctx.ui?.json?.({ configPath, hostId: data.hostId, clientId: data.clientId });
+      } else {
+        ctx.ui?.success?.("Workspace Agent registered", {
+          sections: [{
+            items: [
+              `Host ID:    ${data.hostId}`,
+              `Client ID:  ${data.clientId}`,
+              `Gateway:    ${gatewayUrl}`,
+              `Namespace:  ${namespaceId}`,
+              `Workspaces: ${workspacePaths.join(", ")}`,
+              `Config:     ${configPath}`
+            ]
+          }]
+        });
+        ctx.ui?.info?.("Next: start the daemon with `pnpm dev:start:host-agent` or `kb workspace:start`.");
+      }
+      return { exitCode: 0, configPath };
+    }
+  }
+});
+
+export { register_default as default };
+//# sourceMappingURL=register.js.map
+//# sourceMappingURL=register.js.map

package/dist/commands/register.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/register.ts"],"names":[],"mappings":"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","file":"register.js","sourcesContent":["/**\n * workspace:register command (alias: agent:register)\n * Register this machine with a Platform Gateway and save credentials to ~/.kb/agent.json.\n */\n\nimport { defineCommand, type PluginContextV3 } from '@kb-labs/sdk';\nimport { writeFile, mkdir, stat } from 'node:fs/promises';\nimport { join, resolve, normalize } from 'node:path';\nimport { homedir, hostname } from 'node:os';\n\ntype RegisterInput = {\n  gateway: string;\n  name?: string;\n  workspace?: string[];\n  namespace?: string;\n  json?: boolean;\n};\n\ntype RegisterResult = {\n  exitCode: number;\n  configPath?: string;\n};\n\nexport default defineCommand({\n  id: 'workspace:register',\n  description: 'Register this machine with a Platform Gateway',\n\n  handler: {\n    async execute(ctx: PluginContextV3, rawInput: RegisterInput): Promise<RegisterResult> {\n      const input: RegisterInput = (rawInput as any).flags ?? rawInput;\n      const gatewayUrl = (input.gateway ?? '').replace(/\\/$/, '');\n      const name = input.name ?? hostname();\n      const namespaceId = input.namespace ?? 'default';\n      const rawWorkspace = input.workspace;\n      const rawPaths = rawWorkspace\n        ? (Array.isArray(rawWorkspace) ? rawWorkspace : [rawWorkspace as unknown as string])\n        : [process.cwd()];\n\n      // Resolve and validate workspace paths: must be absolute directories, no traversal\n      const workspacePaths: string[] = [];\n      for (const p of rawPaths) {\n        const resolved = resolve(normalize(p));\n        let pathStat: Awaited<ReturnType<typeof stat>> | null = null;\n        try { pathStat = await stat(resolved); } catch { /* will error below */ }\n        if (!pathStat?.isDirectory()) {\n          ctx.ui?.error?.(`Workspace path does not exist or is not a directory: ${resolved}`);\n          return { exitCode: 1 };\n        }\n        workspacePaths.push(resolved);\n      }\n\n      if (!gatewayUrl) {\n        ctx.ui?.error?.('--gateway is required. Example: kb workspace:register --gateway http://localhost:4000');\n        return { exitCode: 1 };\n      }\n\n      // Validate URL\n      if (!gatewayUrl.startsWith('http://') && !gatewayUrl.startsWith('https://')) {\n        ctx.ui?.error?.('Invalid gateway URL — must start with http:// or https://');\n        return { exitCode: 1 };\n      }\n\n      ctx.ui?.info?.(`Registering with Gateway: ${gatewayUrl}`);\n\n      // POST /auth/register\n      let res: Response;\n      try {\n        res = await fetch(`${gatewayUrl}/auth/register`, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({ name, namespaceId, capabilities: ['filesystem', 'git', 'execution', 'search', 'shell'] }),\n        });\n      } catch (err) {\n        ctx.ui?.error?.(`Failed to reach Gateway: ${err instanceof Error ? err.message : String(err)}`);\n        return { exitCode: 1 };\n      }\n\n      if (!res.ok) {\n        const rawBody = await res.text().catch(() => '');\n        const body = rawBody.slice(0, 200).replace(/[\\r\\n]/g, ' ');\n        ctx.ui?.error?.(`Gateway returned ${res.status}: ${body}`);\n        return { exitCode: 1 };\n      }\n\n      let data: { clientId?: string; clientSecret?: string; hostId?: string };\n      try {\n        data = await res.json() as typeof data;\n      } catch {\n        ctx.ui?.error?.('Gateway response is not valid JSON');\n        return { exitCode: 1 };\n      }\n\n      if (!data.clientId || !data.clientSecret || !data.hostId) {\n        ctx.ui?.error?.('Gateway response is missing required fields (clientId, clientSecret, hostId)');\n        return { exitCode: 1 };\n      }\n\n      // Format validation — secrets must be non-empty strings with safe characters only\n      const SECRET_PATTERN = /^[A-Za-z0-9_\\-+/=]{16,}$/;\n      if (typeof data.clientSecret !== 'string' || !SECRET_PATTERN.test(data.clientSecret)) {\n        ctx.ui?.error?.('Gateway returned an invalid client secret (unexpected format)');\n        return { exitCode: 1 };\n      }\n\n      // Write ~/.kb/agent.json\n      const kbDir = join(homedir(), '.kb');\n      await mkdir(kbDir, { recursive: true });\n      const configPath = join(kbDir, 'agent.json');\n\n      const agentConfig = {\n        clientId: data.clientId,\n        clientSecret: data.clientSecret,\n        hostId: data.hostId,\n        gatewayUrl,\n        namespaceId,\n        hostType: 'local' as const,\n        workspacePaths,\n        execution: {\n          mode: 'in-process' as const,\n          timeoutMs: 120_000,\n        },\n      };\n\n      await writeFile(configPath, JSON.stringify(agentConfig, null, 2), { mode: 0o600 });\n\n      if (input.json) {\n        ctx.ui?.json?.({ configPath, hostId: data.hostId, clientId: data.clientId });\n      } else {\n        ctx.ui?.success?.('Workspace Agent registered', {\n          sections: [{\n            items: [\n              `Host ID:    ${data.hostId}`,\n              `Client ID:  ${data.clientId}`,\n              `Gateway:    ${gatewayUrl}`,\n              `Namespace:  ${namespaceId}`,\n              `Workspaces: ${workspacePaths.join(', ')}`,\n              `Config:     ${configPath}`,\n            ],\n          }],\n        });\n        ctx.ui?.info?.('Next: start the daemon with `pnpm dev:start:host-agent` or `kb workspace:start`.');\n      }\n\n      return { exitCode: 0, configPath };\n    },\n  },\n});\n"]}

package/dist/commands/status.d.ts

@@ -0,0 +1,12 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+/**
+ * workspace:status command (alias: agent:status)
+ * Show Workspace Agent daemon status via IPC socket.
+ */
+type StatusInput = {
+    json?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, StatusInput, unknown>;
+
+export { _default as default };

package/dist/commands/status.js

@@ -0,0 +1,57 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { HostAgentClient } from '@kb-labs/host-agent-client';
+import { createTransport } from '@kb-labs/host-agent-transport';
+
+// src/commands/status.ts
+var status_default = defineCommand({
+  id: "workspace:status",
+  description: "Show Workspace Agent daemon status",
+  handler: {
+    async execute(ctx, rawInput) {
+      const input = rawInput.flags ?? rawInput;
+      let ipcStatus = null;
+      try {
+        const transport = createTransport({ mode: "auto" });
+        const client = new HostAgentClient({ transport, requestTimeout: 3e3 });
+        await client.connect();
+        ipcStatus = await client.status();
+        client.close();
+      } catch {
+      }
+      if (ipcStatus === null) {
+        if (input.json) {
+          ctx.ui?.json?.({ running: false });
+        } else {
+          ctx.ui?.info?.("Workspace Agent is not running. Start with: pnpm dev:start host-agent");
+        }
+        return { exitCode: 0, running: false };
+      }
+      const statusLabel = ipcStatus.connected ? "connected" : ipcStatus.reconnecting ? "reconnecting..." : "disconnected";
+      const result = {
+        exitCode: 0,
+        running: true,
+        connected: ipcStatus.connected,
+        hostId: ipcStatus.hostId,
+        gatewayUrl: ipcStatus.gatewayUrl
+      };
+      if (input.json) {
+        ctx.ui?.json?.(result);
+      } else {
+        ctx.ui?.success?.("Workspace Agent Status", {
+          sections: [{
+            items: [
+              `Status:     ${statusLabel}`,
+              ...ipcStatus.hostId ? [`Host ID:    ${ipcStatus.hostId}`] : [],
+              ...ipcStatus.gatewayUrl ? [`Gateway:    ${ipcStatus.gatewayUrl}`] : []
+            ]
+          }]
+        });
+      }
+      return result;
+    }
+  }
+});
+
+export { status_default as default };
+//# sourceMappingURL=status.js.map
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/status.ts"],"names":[],"mappings":";;;;;AAqBA,IAAO,iBAAQ,aAAA,CAAc;AAAA,EAC3B,EAAA,EAAI,kBAAA;AAAA,EACJ,WAAA,EAAa,oCAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,QAAA,EAA8C;AAChF,MAAA,MAAM,KAAA,GAAsB,SAAiB,KAAA,IAAS,QAAA;AAEtD,MAAA,IAAI,SAAA,GAAyG,IAAA;AAE7G,MAAA,IAAI;AACF,QAAA,MAAM,SAAA,GAAY,eAAA,CAAgB,EAAE,IAAA,EAAM,QAAQ,CAAA;AAClD,QAAA,MAAM,SAAS,IAAI,eAAA,CAAgB,EAAE,SAAA,EAAW,cAAA,EAAgB,KAAM,CAAA;AACtE,QAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,QAAA,SAAA,GAAY,MAAM,OAAO,MAAA,EAAO;AAChC,QAAA,MAAA,CAAO,KAAA,EAAM;AAAA,MACf,CAAA,CAAA,MAAQ;AAAA,MAER;AAEA,MAAA,IAAI,cAAc,IAAA,EAAM;AACtB,QAAA,IAAI,MAAM,IAAA,EAAM;AACd,UAAA,GAAA,CAAI,EAAA,EAAI,IAAA,GAAO,EAAE,OAAA,EAAS,OAAO,CAAA;AAAA,QACnC,CAAA,MAAO;AACL,UAAA,GAAA,CAAI,EAAA,EAAI,OAAO,uEAAuE,CAAA;AAAA,QACxF;AACA,QAAA,OAAO,EAAE,QAAA,EAAU,CAAA,EAAG,OAAA,EAAS,KAAA,EAAM;AAAA,MACvC;AAEA,MAAA,MAAM,cAAc,SAAA,CAAU,SAAA,GAC1B,WAAA,GACA,SAAA,CAAU,eACR,iBAAA,GACA,cAAA;AAEN,MAAA,MAAM,MAAA,GAAuB;AAAA,QAC3B,QAAA,EAAU,CAAA;AAAA,QACV,OAAA,EAAS,IAAA;AAAA,QACT,WAAW,SAAA,CAAU,SAAA;AAAA,QACrB,QAAQ,SAAA,CAAU,MAAA;AAAA,QAClB,YAAY,SAAA,CAAU;AAAA,OACxB;AAEA,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,GAAA,CAAI,EAAA,EAAI,OAAO,MAAM,CAAA;AAAA,MACvB,CAAA,MAAO;AACL,QAAA,GAAA,CAAI,EAAA,EAAI,UAAU,wBAAA,EAA0B;AAAA,UAC1C,UAAU,CAAC;AAAA,YACT,KAAA,EAAO;AAAA,cACL,eAAe,WAAW,CAAA,CAAA;AAAA,cAC1B,GAAI,UAAU,MAAA,GAAS,CAAC,eAAe,SAAA,CAAU,MAAM,CAAA,CAAE,CAAA,GAAI,EAAC;AAAA,cAC9D,GAAI,UAAU,UAAA,GAAa,CAAC,eAAe,SAAA,CAAU,UAAU,CAAA,CAAE,CAAA,GAAI;AAAC;AACxE,WACD;AAAA,SACF,CAAA;AAAA,MACH;AAEA,MAAA,OAAO,MAAA;AAAA,IACT;AAAA;AAEJ,CAAC","file":"status.js","sourcesContent":["/**\n * workspace:status command (alias: agent:status)\n * Show Workspace Agent daemon status via IPC socket.\n */\n\nimport { defineCommand, type PluginContextV3 } from '@kb-labs/sdk';\nimport { HostAgentClient } from '@kb-labs/host-agent-client';\nimport { createTransport } from '@kb-labs/host-agent-transport';\n\ntype StatusInput = {\n  json?: boolean;\n};\n\ntype StatusResult = {\n  exitCode: number;\n  running: boolean;\n  connected?: boolean;\n  hostId?: string;\n  gatewayUrl?: string;\n};\n\nexport default defineCommand({\n  id: 'workspace:status',\n  description: 'Show Workspace Agent daemon status',\n\n  handler: {\n    async execute(ctx: PluginContextV3, rawInput: StatusInput): Promise<StatusResult> {\n      const input: StatusInput = (rawInput as any).flags ?? rawInput;\n\n      let ipcStatus: { connected: boolean; hostId?: string; gatewayUrl?: string; reconnecting?: boolean } | null = null;\n\n      try {\n        const transport = createTransport({ mode: 'auto' });\n        const client = new HostAgentClient({ transport, requestTimeout: 3000 });\n        await client.connect();\n        ipcStatus = await client.status();\n        client.close();\n      } catch {\n        // IPC unreachable — daemon not running\n      }\n\n      if (ipcStatus === null) {\n        if (input.json) {\n          ctx.ui?.json?.({ running: false });\n        } else {\n          ctx.ui?.info?.('Workspace Agent is not running. Start with: pnpm dev:start host-agent');\n        }\n        return { exitCode: 0, running: false };\n      }\n\n      const statusLabel = ipcStatus.connected\n        ? 'connected'\n        : ipcStatus.reconnecting\n          ? 'reconnecting...'\n          : 'disconnected';\n\n      const result: StatusResult = {\n        exitCode: 0,\n        running: true,\n        connected: ipcStatus.connected,\n        hostId: ipcStatus.hostId,\n        gatewayUrl: ipcStatus.gatewayUrl,\n      };\n\n      if (input.json) {\n        ctx.ui?.json?.(result);\n      } else {\n        ctx.ui?.success?.('Workspace Agent Status', {\n          sections: [{\n            items: [\n              `Status:     ${statusLabel}`,\n              ...(ipcStatus.hostId ? [`Host ID:    ${ipcStatus.hostId}`] : []),\n              ...(ipcStatus.gatewayUrl ? [`Gateway:    ${ipcStatus.gatewayUrl}`] : []),\n            ],\n          }],\n        });\n      }\n\n      return result;\n    },\n  },\n});\n"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { default as manifest, default as pluginManifest } from './manifest.js';
+import '@kb-labs/perm-presets';

package/dist/index.js

@@ -0,0 +1,155 @@
+import { combinePermissions, kbPlatformPreset, defineCommandFlags } from '@kb-labs/sdk';
+
+// src/manifest.ts
+
+// src/commands/flags.ts
+var registerFlags = {
+  gateway: {
+    type: "string",
+    describe: "Gateway URL (e.g. http://localhost:4000 or https://gateway.example.com)",
+    required: true
+  },
+  name: {
+    type: "string",
+    describe: "Display name for this host (default: hostname)"
+  },
+  workspace: {
+    type: "array",
+    describe: "Workspace paths this agent is allowed to access (can specify multiple)",
+    string: true
+  },
+  namespace: {
+    type: "string",
+    describe: 'Namespace ID (default: "default")',
+    default: "default"
+  },
+  json: {
+    type: "boolean",
+    describe: "Output as JSON",
+    default: false
+  }
+};
+var statusFlags = {
+  json: {
+    type: "boolean",
+    describe: "Output as JSON",
+    default: false
+  }
+};
+var listFlags = {
+  json: {
+    type: "boolean",
+    describe: "Output as JSON",
+    default: false
+  },
+  gateway: {
+    type: "string",
+    describe: "Gateway URL (default: from ~/.kb/agent.json or http://localhost:4000)"
+  }
+};
+
+// src/manifest.ts
+var pluginPermissions = combinePermissions().with(kbPlatformPreset).withFs({
+  mode: "readWrite",
+  allow: [".kb/**", "~/.kb/**"]
+}).withEnv(["HOME", "USER", "KB_GATEWAY_URL"]).withQuotas({
+  timeoutMs: 3e4,
+  memoryMb: 128
+}).build();
+var manifest = {
+  schema: "kb.plugin/3",
+  id: "@kb-labs/host-agent",
+  version: "0.2.0",
+  display: {
+    name: "Workspace Agent",
+    description: "Connect this machine to KB Labs Platform for remote plugin execution.",
+    tags: ["workspace-agent", "gateway", "cloud", "execution"]
+  },
+  platform: {
+    requires: [],
+    optional: ["logger"]
+  },
+  cli: {
+    commands: [
+      // Primary commands: workspace:*
+      {
+        id: "workspace:register",
+        group: "workspace",
+        describe: "Register this machine with a Platform Gateway.",
+        longDescription: "Calls POST /auth/register on the given Gateway URL, receives credentials, and writes ~/.kb/agent.json. Must be run once before starting the Workspace Agent daemon.",
+        handler: "./commands/register.js#default",
+        handlerPath: "./commands/register.js",
+        flags: defineCommandFlags(registerFlags),
+        examples: [
+          "kb workspace:register --gateway http://localhost:4000",
+          "kb workspace:register --gateway https://gateway.kblabs.dev --name my-laptop --workspace ~/projects/my-app"
+        ]
+      },
+      {
+        id: "workspace:status",
+        group: "workspace",
+        describe: "Show Workspace Agent connection status.",
+        longDescription: "Connects to the daemon via IPC socket and queries its status (connected, hostId, gatewayUrl, capabilities). Start the daemon with `kb workspace:start` or `pnpm dev:start:host-agent`.",
+        handler: "./commands/status.js#default",
+        handlerPath: "./commands/status.js",
+        flags: defineCommandFlags(statusFlags),
+        examples: [
+          "kb workspace:status",
+          "kb workspace:status --json"
+        ]
+      },
+      {
+        id: "workspace:list",
+        group: "workspace",
+        describe: "List all connected Workspace Agents.",
+        longDescription: "Queries the Gateway REST API for all registered hosts and shows their status, capabilities, and last seen time.",
+        handler: "./commands/list.js#default",
+        handlerPath: "./commands/list.js",
+        flags: defineCommandFlags(listFlags),
+        examples: [
+          "kb workspace:list",
+          "kb workspace:list --json",
+          "kb workspace:list --gateway https://gateway.kblabs.dev"
+        ]
+      },
+      // Legacy aliases: agent:* (backwards compatible)
+      {
+        id: "agent:register",
+        group: "agent",
+        describe: "[Alias for workspace:register] Register this machine with a Platform Gateway.",
+        handler: "./commands/register.js#default",
+        handlerPath: "./commands/register.js",
+        flags: defineCommandFlags(registerFlags),
+        examples: [
+          "kb agent:register --gateway http://localhost:4000"
+        ]
+      },
+      {
+        id: "agent:status",
+        group: "agent",
+        describe: "[Alias for workspace:status] Show Workspace Agent connection status.",
+        handler: "./commands/status.js#default",
+        handlerPath: "./commands/status.js",
+        flags: defineCommandFlags(statusFlags),
+        examples: [
+          "kb agent:status",
+          "kb agent:status --json"
+        ]
+      }
+    ]
+  },
+  capabilities: [],
+  permissions: pluginPermissions,
+  artifacts: [
+    {
+      id: "workspace-agent.config",
+      pathTemplate: "~/.kb/agent.json",
+      description: "Workspace Agent credentials and configuration."
+    }
+  ]
+};
+var manifest_default = manifest;
+
+export { manifest, manifest_default as pluginManifest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/flags.ts","../src/manifest.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const registerFlags = {\n  gateway: {\n    type: 'string' as const,\n    describe: 'Gateway URL (e.g. http://localhost:4000 or https://gateway.example.com)',\n    required: true,\n  },\n  name: {\n    type: 'string' as const,\n    describe: 'Display name for this host (default: hostname)',\n  },\n  workspace: {\n    type: 'array' as const,\n    describe: 'Workspace paths this agent is allowed to access (can specify multiple)',\n    string: true,\n  },\n  namespace: {\n    type: 'string' as const,\n    describe: 'Namespace ID (default: \"default\")',\n    default: 'default',\n  },\n  json: {\n    type: 'boolean' as const,\n    describe: 'Output as JSON',\n    default: false,\n  },\n};\n\nexport const statusFlags = {\n  json: {\n    type: 'boolean' as const,\n    describe: 'Output as JSON',\n    default: false,\n  },\n};\n\nexport const listFlags = {\n  json: {\n    type: 'boolean' as const,\n    describe: 'Output as JSON',\n    default: false,\n  },\n  gateway: {\n    type: 'string' as const,\n    describe: 'Gateway URL (default: from ~/.kb/agent.json or http://localhost:4000)',\n  },\n};\n","import { defineCommandFlags, combinePermissions, kbPlatformPreset } from '@kb-labs/sdk';\nimport { registerFlags, statusFlags, listFlags } from './commands/flags.js';\n\nconst pluginPermissions = combinePermissions()\n  .with(kbPlatformPreset)\n  .withFs({\n    mode: 'readWrite',\n    allow: ['.kb/**', '~/.kb/**'],\n  })\n  .withEnv(['HOME', 'USER', 'KB_GATEWAY_URL'])\n  .withQuotas({\n    timeoutMs: 30000,\n    memoryMb: 128,\n  })\n  .build();\n\nexport const manifest = {\n  schema: 'kb.plugin/3',\n  id: '@kb-labs/host-agent',\n  version: '0.2.0',\n\n  display: {\n    name: 'Workspace Agent',\n    description: 'Connect this machine to KB Labs Platform for remote plugin execution.',\n    tags: ['workspace-agent', 'gateway', 'cloud', 'execution'],\n  },\n\n  platform: {\n    requires: [],\n    optional: ['logger'],\n  },\n\n  cli: {\n    commands: [\n      // Primary commands: workspace:*\n      {\n        id: 'workspace:register',\n        group: 'workspace',\n        describe: 'Register this machine with a Platform Gateway.',\n        longDescription:\n          'Calls POST /auth/register on the given Gateway URL, receives credentials, ' +\n          'and writes ~/.kb/agent.json. Must be run once before starting the Workspace Agent daemon.',\n\n        handler: './commands/register.js#default',\n        handlerPath: './commands/register.js',\n\n        flags: defineCommandFlags(registerFlags),\n\n        examples: [\n          'kb workspace:register --gateway http://localhost:4000',\n          'kb workspace:register --gateway https://gateway.kblabs.dev --name my-laptop --workspace ~/projects/my-app',\n        ],\n      },\n\n      {\n        id: 'workspace:status',\n        group: 'workspace',\n        describe: 'Show Workspace Agent connection status.',\n        longDescription:\n          'Connects to the daemon via IPC socket and queries its status (connected, hostId, gatewayUrl, capabilities). ' +\n          'Start the daemon with `kb workspace:start` or `pnpm dev:start:host-agent`.',\n\n        handler: './commands/status.js#default',\n        handlerPath: './commands/status.js',\n\n        flags: defineCommandFlags(statusFlags),\n\n        examples: [\n          'kb workspace:status',\n          'kb workspace:status --json',\n        ],\n      },\n\n      {\n        id: 'workspace:list',\n        group: 'workspace',\n        describe: 'List all connected Workspace Agents.',\n        longDescription:\n          'Queries the Gateway REST API for all registered hosts and shows their status, capabilities, and last seen time.',\n\n        handler: './commands/list.js#default',\n        handlerPath: './commands/list.js',\n\n        flags: defineCommandFlags(listFlags),\n\n        examples: [\n          'kb workspace:list',\n          'kb workspace:list --json',\n          'kb workspace:list --gateway https://gateway.kblabs.dev',\n        ],\n      },\n\n      // Legacy aliases: agent:* (backwards compatible)\n      {\n        id: 'agent:register',\n        group: 'agent',\n        describe: '[Alias for workspace:register] Register this machine with a Platform Gateway.',\n\n        handler: './commands/register.js#default',\n        handlerPath: './commands/register.js',\n\n        flags: defineCommandFlags(registerFlags),\n\n        examples: [\n          'kb agent:register --gateway http://localhost:4000',\n        ],\n      },\n\n      {\n        id: 'agent:status',\n        group: 'agent',\n        describe: '[Alias for workspace:status] Show Workspace Agent connection status.',\n\n        handler: './commands/status.js#default',\n        handlerPath: './commands/status.js',\n\n        flags: defineCommandFlags(statusFlags),\n\n        examples: [\n          'kb agent:status',\n          'kb agent:status --json',\n        ],\n      },\n    ],\n  },\n\n  capabilities: [],\n  permissions: pluginPermissions,\n  artifacts: [\n    {\n      id: 'workspace-agent.config',\n      pathTemplate: '~/.kb/agent.json',\n      description: 'Workspace Agent credentials and configuration.',\n    },\n  ],\n};\n\nexport default manifest;\n"]}

package/dist/manifest.d.ts

@@ -0,0 +1,62 @@
+import * as _kb_labs_perm_presets from '@kb-labs/perm-presets';
+
+declare const manifest: {
+    schema: string;
+    id: string;
+    version: string;
+    display: {
+        name: string;
+        description: string;
+        tags: string[];
+    };
+    platform: {
+        requires: never[];
+        optional: string[];
+    };
+    cli: {
+        commands: ({
+            id: string;
+            group: string;
+            describe: string;
+            longDescription: string;
+            handler: string;
+            handlerPath: string;
+            flags: {
+                name: string;
+                type: "string" | "boolean" | "number" | "array";
+                alias?: string;
+                default?: unknown;
+                description?: string;
+                choices?: string[];
+                required?: boolean;
+            }[];
+            examples: string[];
+        } | {
+            id: string;
+            group: string;
+            describe: string;
+            handler: string;
+            handlerPath: string;
+            flags: {
+                name: string;
+                type: "string" | "boolean" | "number" | "array";
+                alias?: string;
+                default?: unknown;
+                description?: string;
+                choices?: string[];
+                required?: boolean;
+            }[];
+            examples: string[];
+            longDescription?: undefined;
+        })[];
+    };
+    capabilities: never[];
+    permissions: _kb_labs_perm_presets.RuntimePermissionSpec;
+    artifacts: {
+        id: string;
+        pathTemplate: string;
+        description: string;
+    }[];
+};
+
+export { manifest as default, manifest };

package/dist/manifest.js

@@ -0,0 +1,155 @@
+import { combinePermissions, kbPlatformPreset, defineCommandFlags } from '@kb-labs/sdk';
+
+// src/manifest.ts
+
+// src/commands/flags.ts
+var registerFlags = {
+  gateway: {
+    type: "string",
+    describe: "Gateway URL (e.g. http://localhost:4000 or https://gateway.example.com)",
+    required: true
+  },
+  name: {
+    type: "string",
+    describe: "Display name for this host (default: hostname)"
+  },
+  workspace: {
+    type: "array",
+    describe: "Workspace paths this agent is allowed to access (can specify multiple)",
+    string: true
+  },
+  namespace: {
+    type: "string",
+    describe: 'Namespace ID (default: "default")',
+    default: "default"
+  },
+  json: {
+    type: "boolean",
+    describe: "Output as JSON",
+    default: false
+  }
+};
+var statusFlags = {
+  json: {
+    type: "boolean",
+    describe: "Output as JSON",
+    default: false
+  }
+};
+var listFlags = {
+  json: {
+    type: "boolean",
+    describe: "Output as JSON",
+    default: false
+  },
+  gateway: {
+    type: "string",
+    describe: "Gateway URL (default: from ~/.kb/agent.json or http://localhost:4000)"
+  }
+};
+
+// src/manifest.ts
+var pluginPermissions = combinePermissions().with(kbPlatformPreset).withFs({
+  mode: "readWrite",
+  allow: [".kb/**", "~/.kb/**"]
+}).withEnv(["HOME", "USER", "KB_GATEWAY_URL"]).withQuotas({
+  timeoutMs: 3e4,
+  memoryMb: 128
+}).build();
+var manifest = {
+  schema: "kb.plugin/3",
+  id: "@kb-labs/host-agent",
+  version: "0.2.0",
+  display: {
+    name: "Workspace Agent",
+    description: "Connect this machine to KB Labs Platform for remote plugin execution.",
+    tags: ["workspace-agent", "gateway", "cloud", "execution"]
+  },
+  platform: {
+    requires: [],
+    optional: ["logger"]
+  },
+  cli: {
+    commands: [
+      // Primary commands: workspace:*
+      {
+        id: "workspace:register",
+        group: "workspace",
+        describe: "Register this machine with a Platform Gateway.",
+        longDescription: "Calls POST /auth/register on the given Gateway URL, receives credentials, and writes ~/.kb/agent.json. Must be run once before starting the Workspace Agent daemon.",
+        handler: "./commands/register.js#default",
+        handlerPath: "./commands/register.js",
+        flags: defineCommandFlags(registerFlags),
+        examples: [
+          "kb workspace:register --gateway http://localhost:4000",
+          "kb workspace:register --gateway https://gateway.kblabs.dev --name my-laptop --workspace ~/projects/my-app"
+        ]
+      },
+      {
+        id: "workspace:status",
+        group: "workspace",
+        describe: "Show Workspace Agent connection status.",
+        longDescription: "Connects to the daemon via IPC socket and queries its status (connected, hostId, gatewayUrl, capabilities). Start the daemon with `kb workspace:start` or `pnpm dev:start:host-agent`.",
+        handler: "./commands/status.js#default",
+        handlerPath: "./commands/status.js",
+        flags: defineCommandFlags(statusFlags),
+        examples: [
+          "kb workspace:status",
+          "kb workspace:status --json"
+        ]
+      },
+      {
+        id: "workspace:list",
+        group: "workspace",
+        describe: "List all connected Workspace Agents.",
+        longDescription: "Queries the Gateway REST API for all registered hosts and shows their status, capabilities, and last seen time.",
+        handler: "./commands/list.js#default",
+        handlerPath: "./commands/list.js",
+        flags: defineCommandFlags(listFlags),
+        examples: [
+          "kb workspace:list",
+          "kb workspace:list --json",
+          "kb workspace:list --gateway https://gateway.kblabs.dev"
+        ]
+      },
+      // Legacy aliases: agent:* (backwards compatible)
+      {
+        id: "agent:register",
+        group: "agent",
+        describe: "[Alias for workspace:register] Register this machine with a Platform Gateway.",
+        handler: "./commands/register.js#default",
+        handlerPath: "./commands/register.js",
+        flags: defineCommandFlags(registerFlags),
+        examples: [
+          "kb agent:register --gateway http://localhost:4000"
+        ]
+      },
+      {
+        id: "agent:status",
+        group: "agent",
+        describe: "[Alias for workspace:status] Show Workspace Agent connection status.",
+        handler: "./commands/status.js#default",
+        handlerPath: "./commands/status.js",
+        flags: defineCommandFlags(statusFlags),
+        examples: [
+          "kb agent:status",
+          "kb agent:status --json"
+        ]
+      }
+    ]
+  },
+  capabilities: [],
+  permissions: pluginPermissions,
+  artifacts: [
+    {
+      id: "workspace-agent.config",
+      pathTemplate: "~/.kb/agent.json",
+      description: "Workspace Agent credentials and configuration."
+    }
+  ]
+};
+var manifest_default = manifest;
+
+export { manifest_default as default, manifest };
+//# sourceMappingURL=manifest.js.map
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/flags.ts","../src/manifest.ts"],"names":[],"mappings":"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","file":"manifest.js","sourcesContent":["export const registerFlags = {\n  gateway: {\n    type: 'string' as const,\n    describe: 'Gateway URL (e.g. http://localhost:4000 or https://gateway.example.com)',\n    required: true,\n  },\n  name: {\n    type: 'string' as const,\n    describe: 'Display name for this host (default: hostname)',\n  },\n  workspace: {\n    type: 'array' as const,\n    describe: 'Workspace paths this agent is allowed to access (can specify multiple)',\n    string: true,\n  },\n  namespace: {\n    type: 'string' as const,\n    describe: 'Namespace ID (default: \"default\")',\n    default: 'default',\n  },\n  json: {\n    type: 'boolean' as const,\n    describe: 'Output as JSON',\n    default: false,\n  },\n};\n\nexport const statusFlags = {\n  json: {\n    type: 'boolean' as const,\n    describe: 'Output as JSON',\n    default: false,\n  },\n};\n\nexport const listFlags = {\n  json: {\n    type: 'boolean' as const,\n    describe: 'Output as JSON',\n    default: false,\n  },\n  gateway: {\n    type: 'string' as const,\n    describe: 'Gateway URL (default: from ~/.kb/agent.json or http://localhost:4000)',\n  },\n};\n","import { defineCommandFlags, combinePermissions, kbPlatformPreset } from '@kb-labs/sdk';\nimport { registerFlags, statusFlags, listFlags } from './commands/flags.js';\n\nconst pluginPermissions = combinePermissions()\n  .with(kbPlatformPreset)\n  .withFs({\n    mode: 'readWrite',\n    allow: ['.kb/**', '~/.kb/**'],\n  })\n  .withEnv(['HOME', 'USER', 'KB_GATEWAY_URL'])\n  .withQuotas({\n    timeoutMs: 30000,\n    memoryMb: 128,\n  })\n  .build();\n\nexport const manifest = {\n  schema: 'kb.plugin/3',\n  id: '@kb-labs/host-agent',\n  version: '0.2.0',\n\n  display: {\n    name: 'Workspace Agent',\n    description: 'Connect this machine to KB Labs Platform for remote plugin execution.',\n    tags: ['workspace-agent', 'gateway', 'cloud', 'execution'],\n  },\n\n  platform: {\n    requires: [],\n    optional: ['logger'],\n  },\n\n  cli: {\n    commands: [\n      // Primary commands: workspace:*\n      {\n        id: 'workspace:register',\n        group: 'workspace',\n        describe: 'Register this machine with a Platform Gateway.',\n        longDescription:\n          'Calls POST /auth/register on the given Gateway URL, receives credentials, ' +\n          'and writes ~/.kb/agent.json. Must be run once before starting the Workspace Agent daemon.',\n\n        handler: './commands/register.js#default',\n        handlerPath: './commands/register.js',\n\n        flags: defineCommandFlags(registerFlags),\n\n        examples: [\n          'kb workspace:register --gateway http://localhost:4000',\n          'kb workspace:register --gateway https://gateway.kblabs.dev --name my-laptop --workspace ~/projects/my-app',\n        ],\n      },\n\n      {\n        id: 'workspace:status',\n        group: 'workspace',\n        describe: 'Show Workspace Agent connection status.',\n        longDescription:\n          'Connects to the daemon via IPC socket and queries its status (connected, hostId, gatewayUrl, capabilities). ' +\n          'Start the daemon with `kb workspace:start` or `pnpm dev:start:host-agent`.',\n\n        handler: './commands/status.js#default',\n        handlerPath: './commands/status.js',\n\n        flags: defineCommandFlags(statusFlags),\n\n        examples: [\n          'kb workspace:status',\n          'kb workspace:status --json',\n        ],\n      },\n\n      {\n        id: 'workspace:list',\n        group: 'workspace',\n        describe: 'List all connected Workspace Agents.',\n        longDescription:\n          'Queries the Gateway REST API for all registered hosts and shows their status, capabilities, and last seen time.',\n\n        handler: './commands/list.js#default',\n        handlerPath: './commands/list.js',\n\n        flags: defineCommandFlags(listFlags),\n\n        examples: [\n          'kb workspace:list',\n          'kb workspace:list --json',\n          'kb workspace:list --gateway https://gateway.kblabs.dev',\n        ],\n      },\n\n      // Legacy aliases: agent:* (backwards compatible)\n      {\n        id: 'agent:register',\n        group: 'agent',\n        describe: '[Alias for workspace:register] Register this machine with a Platform Gateway.',\n\n        handler: './commands/register.js#default',\n        handlerPath: './commands/register.js',\n\n        flags: defineCommandFlags(registerFlags),\n\n        examples: [\n          'kb agent:register --gateway http://localhost:4000',\n        ],\n      },\n\n      {\n        id: 'agent:status',\n        group: 'agent',\n        describe: '[Alias for workspace:status] Show Workspace Agent connection status.',\n\n        handler: './commands/status.js#default',\n        handlerPath: './commands/status.js',\n\n        flags: defineCommandFlags(statusFlags),\n\n        examples: [\n          'kb agent:status',\n          'kb agent:status --json',\n        ],\n      },\n    ],\n  },\n\n  capabilities: [],\n  permissions: pluginPermissions,\n  artifacts: [\n    {\n      id: 'workspace-agent.config',\n      pathTemplate: '~/.kb/agent.json',\n      description: 'Workspace Agent credentials and configuration.',\n    },\n  ],\n};\n\nexport default manifest;\n"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@kb-labs/host-agent-entry",
+  "version": "2.14.0",
+  "type": "module",
+  "description": "CLI commands for Host Agent — register and status.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./plugin-manifest": {
+      "import": "./dist/manifest.js",
+      "types": "./dist/manifest.d.ts"
+    },
+    "./dist/*": "./dist/*"
+  },
+  "kb": {
+    "manifest": "./dist/manifest.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@kb-labs/host-agent-transport": "2.14.0",
+    "@kb-labs/host-agent-client": "2.14.0",
+    "@kb-labs/host-agent-contracts": "2.14.0",
+    "@kb-labs/sdk": "1.6.6"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.3",
+    "eslint": "^9",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4",
+    "@kb-labs/devkit": "2.14.0"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup --config tsup.config.ts && node -e \"const fs=require('fs'),p=require('path');const f=p.join(process.cwd(),'../../../.kb/cache/cli-manifests.json');try{fs.unlinkSync(f);console.log('[host-agent-cli] plugin cache cleared')}catch{}\"",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}