nolo-cli 0.1.30 → 0.1.32

package/noloReadBridgePrompt.ts

@@ -0,0 +1,16 @@
+const REPO_CLI_PREFIX = "bun packages/cli/index.ts";
+
+export function buildNoloReadOnlyBridgePrompt() {
+  return [
+    "--- Nolo read-only CLI bridge ---",
+    "This CLI runtime does not receive server-side function tools directly.",
+    "Use these repo-local read commands to fetch authoritative Nolo docs and records on demand instead of trusting prompt snapshots or summaries alone.",
+    "Run commands from the repository root. The runner already provides server URL and auth in the environment.",
+    `Read doc/page truth: ${REPO_CLI_PREFIX} doc read "<pageKey>"`,
+    `Read skill doc truth: ${REPO_CLI_PREFIX} skill-doc read "<pageKey>"`,
+    `Read dialog truth: ${REPO_CLI_PREFIX} dialog read "<dialogId|dialogUrl>"`,
+    `Read shared space truth: ${REPO_CLI_PREFIX} space read "<spaceId|spaceKey|spaceUrl>"`,
+    `Read agent truth: ${REPO_CLI_PREFIX} agent read "<agentKey|agentAlias|agentUrl>"`,
+    "If a read command fails, report the exact command and error.",
+  ].join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nolo-cli",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "type": "module",
   "description": "Agent-first terminal workspace for Nolo",
   "bin": {
@@ -97,25 +97,226 @@
     "runtimeModeArgs.ts",
     "tableCommands.ts",
     "updateCommands.ts",
-    "client/**/*.ts",
-    "tui/**/*.ts",
+    "client/compactDialog.test.ts",
+    "client/localAgentRecords.test.ts",
+    "client/localRuntimeDryRun.test.ts",
+    "client/agentRunTaskRunRecorder.ts",
+    "client/workspaceSession.test.ts",
+    "client/localProviderResolver.test.ts",
+    "client/localDialogRecords.ts",
+    "client/agentRunLocalExecutor.ts",
+    "client/localDialogRecords.test.ts",
+    "client/profileConfig.test.ts",
+    "client/profileConfig.ts",
+    "client/agentRunRuntimeSelection.ts",
+    "client/localAgentRecords.ts",
+    "client/taskWorktree.ts",
+    "client/localToolPolicy.test.ts",
+    "client/streamingOutput.test.ts",
+    "client/streamingOutput.ts",
+    "client/localToolPolicy.ts",
+    "client/compactDialog.ts",
+    "client/hybridRecordStore.test.ts",
+    "client/agentRun.ts",
+    "client/localRuntimeAdapter.test.ts",
+    "client/agentRunRuntimeSelection.test.ts",
+    "client/agentRunLocalExecution.test.ts",
+    "client/agentRunInput.ts",
+    "client/localProviderResolver.ts",
+    "client/taskRunPrompt.ts",
+    "client/hybridRecordStore.ts",
+    "client/agentConfigResolver.test.ts",
+    "client/agentRunServerTransport.ts",
+    "client/workspaceSession.ts",
+    "client/agentRun.test.ts",
+    "client/agentConfigResolver.ts",
+    "client/agentRunLocalExecution.ts",
+    "client/localRuntimeAdapter.ts",
+    "tui/tuiPresentation.ts",
+    "tui/readlineWorkspace.ts",
+    "tui/session.ts",
+    "tui/tuiPresentation.test.ts",
+    "tui/tuiCommandInterpreter.test.ts",
+    "tui/tuiCommandInterpreter.ts",
+    "tui/tuiCatalog.ts",
     "README.md",
-    "ai/**/*.ts",
-    "connector-experimental/**/*.ts",
-    "agent-runtime/**/*.ts",
-    "connector-experimental/**/*.ts",
-    "app/**/*.ts",
-    "create/**/*.ts",
-    "database/**/*.ts",
-    "ai/**/*.ts",
-    "chat/**/*.ts",
-    "render/**/*.ts",
-    "auth/**/*.ts",
-    "share/**/*.ts",
-    "life/**/*.ts",
-    "core/**/*.ts",
-    "server/**/*.ts",
-    "integrations/**/*.ts"
+    "ai/agent.ts",
+    "ai/tools/agent/taskRunTool.ts",
+    "ai/agent/agentSlice.ts",
+    "ai/agent/machineRunPermissions.ts",
+    "ai/index.ts",
+    "connector-experimental/protocol.ts",
+    "connector-experimental/machineInfo.ts",
+    "spaceAttachCommands.ts",
+    "cliRuntimeDoctorReport.ts",
+    "noloReadBridgePrompt.ts",
+    "cli/commandRegistry.ts",
+    "cli/client/profileConfig.ts",
+    "cli/runtimeModeArgs.ts",
+    "cli/tui/readlineWorkspace.ts",
+    "cli/updateCommands.ts",
+    "cli/client/hybridRecordStore.ts",
+    "cli/cliEnvHelpers.ts",
+    "cli/cliIoTypes.ts",
+    "cli/machineWsRunDispatch.ts",
+    "cli/localRuntimeDb.ts",
+    "cli/agentRecordHelpers.ts",
+    "cli/customCodingAgentFlow.ts",
+    "cli/customCodingAgentRecord.ts",
+    "cli/agentCommandSupport.ts",
+    "cli/hybridReadHelpers.ts",
+    "cli/agentListHelpers.ts",
+    "cli/client/localRuntimeAdapter.ts",
+    "cli/agentListCommands.ts",
+    "cli/agentMachineCommands.ts",
+    "cli/runtimeDoctorCommands.ts",
+    "cli/connectorWebSocketTarget.ts",
+    "cli/agentAliases.ts",
+    "cli/machineCommandPrompts.ts",
+    "cli/client/taskWorktree.ts",
+    "cli/agentRuntimeLocal.ts",
+    "cli/client/taskRunPrompt.ts",
+    "cli/client/localAgentRecords.ts",
+    "cli/spaceMutationHelpers.ts",
+    "cli/client/agentRun.ts",
+    "cli/agentRunLocalWorkspace.ts",
+    "cli/agentRunParsing.ts",
+    "cli/scriptPassthroughHelpers.ts",
+    "cli/defaultServer.ts",
+    "cli/buildPublish.ts",
+    "cli/buildPublishArtifactAssembly.ts",
+    "cli/buildPublishImportAnalysis.ts",
+    "cli/publishPackage.ts",
+    "cli/cliCommandTypes.ts",
+    "cli/cliCommandAdapters.ts",
+    "cli/cliCommandDispatch.ts",
+    "cli/internalCommandEntries.ts",
+    "cli/scriptCommandEntries.ts",
+    "cli/agentCreateCustomCommands.ts",
+    "cli/agentDialogsCommands.ts",
+    "cli/agentDoctorCommands.ts",
+    "cli/agentUnpublishCommands.ts",
+    "cli/agentSuperviseCommands.ts",
+    "cli/agentPullCommand.ts",
+    "cli/agentRecordCommands.ts",
+    "cli/agentRunCommand.ts",
+    "cli/cliCommandFactories.ts",
+    "cli/dialogReadCommands.ts",
+    "cli/dialogStatusCommands.ts",
+    "cli/dialogReadHelpers.ts",
+    "cli/dialogDataAccess.ts",
+    "cli/pageCreateCommands.ts",
+    "cli/pageDeleteCommands.ts",
+    "cli/pageReadCommands.ts",
+    "cli/pageUpdateCommands.ts",
+    "cli/agentInternalCommandEntries.ts",
+    "cli/dialogInternalCommandEntries.ts",
+    "cli/docInternalCommandEntries.ts",
+    "cli/runtimeInternalCommandEntries.ts",
+    "cli/spaceInternalCommandEntries.ts",
+    "cli/systemInternalCommandEntries.ts",
+    "cli/workflowInternalCommandEntries.ts",
+    "cli/noloReadBridgePrompt.ts",
+    "cli/machineDaemonCommands.ts",
+    "cli/machineHeartbeatCommands.ts",
+    "cli/machineWatchCommands.ts",
+    "cli/machineWsSession.ts",
+    "cli/machineCommandResolution.ts",
+    "cli/machineStatusCommands.ts",
+    "cli/connectorRunArtifact.ts",
+    "cli/machineWsPromptMaterialization.ts",
+    "cli/pageWriteHelpers.ts",
+    "cli/secretScanHelpers.ts",
+    "cli/runtimePassthroughCommands.ts",
+    "cli/cliRuntimeDoctorReport.ts",
+    "cli/spaceAttachCommands.ts",
+    "cli/spaceCategoryCommands.ts",
+    "cli/spaceDeleteCommands.ts",
+    "cli/spaceCommands.ts",
+    "cli/spaceReadCommands.ts",
+    "cli/authCommands.ts",
+    "cli/machineCommands.ts",
+    "cli/tableDataOutput.ts",
+    "cli/tableQueryParsing.ts",
+    "cli/tableDataSafety.ts",
+    "cli/taskRunParsing.ts",
+    "cli/taskRunActions.ts",
+    "cli/tableMetaCommands.ts",
+    "cli/tableMutationCommands.ts",
+    "cli/tableCommands.ts",
+    "cli/taskRunCommand.ts",
+    "cli/tableQueryRequest.ts",
+    "cli/client/compactDialog.ts",
+    "cli/client/agentRunLocalExecution.ts",
+    "cli/client/workspaceSession.ts",
+    "cli/client/localProviderResolver.ts",
+    "cli/client/agentRunInput.ts",
+    "cli/client/agentRunTaskRunRecorder.ts",
+    "cli/client/localDialogRecords.ts",
+    "cli/client/localToolPolicy.ts",
+    "cli/client/streamingOutput.ts",
+    "cli/client/agentRunRuntimeSelection.ts",
+    "cli/client/agentRunLocalExecutor.ts",
+    "cli/client/agentRunServerTransport.ts",
+    "cli/taskRunPromptShared.ts",
+    "cli/client/agentConfigResolver.ts",
+    "cli/tui/tuiCatalog.ts",
+    "cli/tui/session.ts",
+    "cli/tui/tuiCommandInterpreter.ts",
+    "cli/tui/tuiPresentation.ts",
+    "agent-runtime/index.ts",
+    "agent-runtime/localLoop.ts",
+    "agent-runtime/localWorkspaceTools.ts",
+    "agent-runtime/dialogStatus.ts",
+    "agent-runtime/hostRuntimeConfig.ts",
+    "agent-runtime/taskWorkspace.ts",
+    "agent-runtime/workspaceSession.ts",
+    "agent-runtime/runtimeDecision.ts",
+    "agent-runtime/types.ts",
+    "agent-runtime/hostAdapter.ts",
+    "agent-runtime/agentConfigOptions.ts",
+    "agent-runtime/openAiCompatibleProvider.ts",
+    "agent-runtime/openAiCompatibleProviderConfig.ts",
+    "agent-runtime/platformChatProvider.ts",
+    "agent-runtime/runtimeFacts.ts",
+    "agent-runtime/agentRecordKeys.ts",
+    "agent-runtime/agentRecordConfig.ts",
+    "agent-runtime/dialogMessageRecord.ts",
+    "agent-runtime/dialogWritePlan.ts",
+    "agent-runtime/hybridRecordStore.ts",
+    "agent-runtime/localToolPolicy.ts",
+    "agent-runtime/runtimeToolPolicy.ts",
+    "connector-experimental/heartbeatLoop.ts",
+    "connector-experimental/daemonLauncher.ts",
+    "connector-experimental/capabilities.ts",
+    "connector-experimental/codexBinary.ts",
+    "app/types.ts",
+    "create/space/spaceKeys.ts",
+    "create/types.ts",
+    "database/keys.ts",
+    "database/server/dbPath.ts",
+    "database/server/db.ts",
+    "database/config.ts",
+    "database/tombstones.ts",
+    "database/server/ensureDbOpen.ts",
+    "database/server/legacyServerDb.ts",
+    "database/server/authorityStoreTypes.ts",
+    "database/server/serverStoreFactory.ts",
+    "database/server/levelAuthorityStore.ts",
+    "database/server/memoryAuthorityStore.ts",
+    "database/utils/ulid.ts",
+    "ai/agent/cliExecutor.ts",
+    "ai/agent/agentRunDialogLineage.ts",
+    "ai/skills/skillDocProtocol.ts",
+    "ai/skills/skillSummaryMarker.ts",
+    "ai/agent/cliPrompt.ts",
+    "ai/policy/types.ts",
+    "chat/messages/fetchMessages.ts",
+    "chat/messages/types.ts",
+    "render/table/activityColumns.ts",
+    "share/keys.ts",
+    "share/helpers.ts",
+    "share/types.ts"
   ],
   "publishConfig": {
     "access": "public"
@@ -127,50 +328,9 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "unist-util-visit": "^5.0.0",
-    "date-fns-tz": "^2.0.0",
-    "level": "^10.0.0",
-    "js-yaml": "^4.1.0",
-    "@types/crypto-js": "^4.1.2",
-    "crypto-js": "^4.1.1",
-    "tweetnacl": "^1.0.3",
-    "@reduxjs/toolkit": "^2.5.0",
-    "react-redux": "^9.2.0",
-    "react": "^19.2.1",
-    "react-hot-toast": "^2.4.1",
-    "react-i18next": "^14.1.2",
-    "i18next": "^23.11.5",
-    "browser-image-compression": "^2.0.2",
-    "pino": "^9.9.0",
     "ulid": "^2.3.0",
-    "slate": "^0.112.0",
-    "slate-react": "^0.112.1",
-    "pdfjs-dist": "^5.2.133",
-    "slate-history": "^0.113.1",
-    "mdast-util-from-markdown": "^2.0.2",
-    "mdast-util-gfm": "^3.0.0",
-    "micromark-extension-gfm": "^3.0.0",
-    "@react-native-community/netinfo": "^11.5.0",
-    "react-native-blob-util": "^0.24.7",
     "rambda": "^8.6.0",
-    "@lobehub/icons": "^5.0.1",
-    "pizzip": "^3.2.0",
-    "docxtemplater": "^3.67.5",
-    "iztro": "^2.5.8",
-    "zod": "^3.25.20",
-    "react-hook-form": "^7.51.5",
-    "@hookform/resolvers": "^3.3.2",
-    "react-native-sse": "^1.2.1",
-    "xlsx": "^0.18.5",
-    "react-router-dom": "^6.23.1",
-    "croner": "^8.0.1",
-    "mermaid": "^11.6.0",
-    "react-native-keychain": "^9.2.2",
-    "async-mutex": "^0.5.0",
-    "js-base64": "^3.7.7",
-    "react-dom": "^19.2.1",
-    "diff": "^8.0.2",
-    "playwright": "^1.59.1",
-    "@waffo/pancake-ts": "^0.5.2"
+    "level": "^10.0.0",
+    "js-yaml": "^4.1.0"
   }
 }

package/runtimeDoctorCommands.ts

@@ -1,41 +1,22 @@
-import { resolveAgentRuntimeDecision } from "./agent-runtime/runtimeDecision";
 import {
   type AgentCommandDeps,
   type LocalRuntimeProbeResult,
 } from "./agentCommandSupport";
+import {
+  buildCliRuntimeDoctorProbe,
+  buildCliRuntimeDoctorReport,
+  formatCliRuntimeDoctorReport,
+} from "./cliRuntimeDoctorReport";
 import {
   resolveAuthToken,
   resolveServerUrl,
   type EnvLike,
 } from "./cliEnvHelpers";
 
-function detectLocalAgentConfig(env: EnvLike) {
-  return Boolean(readLocalAgentKey(env) || env.NOLO_AGENT_CACHE_READY);
-}
-
 function readLocalAgentKey(env: EnvLike) {
   return env.NOLO_LOCAL_AGENT_KEY || env.NOLO_AGENT || "";
 }
 
-function detectLocalProvider(env: EnvLike) {
-  return Boolean(
-    env.OPENAI_API_KEY ||
-    env.ANTHROPIC_API_KEY ||
-    env.GOOGLE_API_KEY ||
-    env.NOLO_LOCAL_OPENAI_BASE_URL ||
-    env.OLLAMA_BASE_URL
-  );
-}
-
-function detectProviderLabel(env: EnvLike) {
-  if (env.NOLO_LOCAL_OPENAI_BASE_URL) return `openai-compatible endpoint ${env.NOLO_LOCAL_OPENAI_BASE_URL}`;
-  if (env.OLLAMA_BASE_URL) return `ollama-compatible endpoint ${env.OLLAMA_BASE_URL}`;
-  if (env.OPENAI_API_KEY) return "openai via env OPENAI_API_KEY";
-  if (env.ANTHROPIC_API_KEY) return "anthropic via env ANTHROPIC_API_KEY";
-  if (env.GOOGLE_API_KEY) return "google via env GOOGLE_API_KEY";
-  return "missing";
-}
-
 async function defaultLocalRuntimeProbe(env: EnvLike): Promise<LocalRuntimeProbeResult> {
   const { resolveCliLocalRuntimeDbPath } = await import("./localRuntimeDb");
   const dbPath = resolveCliLocalRuntimeDbPath({ env });
@@ -72,47 +53,15 @@ export async function runDoctorRuntimeCommand(
   const authToken = resolveAuthToken(args, env);
   const serverUrl = resolveServerUrl(args, env);
   const localProbe = await (deps.localRuntimeProbe ?? defaultLocalRuntimeProbe)(env);
-  const hasLocalAgentConfig = detectLocalAgentConfig(env) && localProbe.ok && localProbe.agentFound;
-  const hasLocalProvider = detectLocalProvider(env);
-  const missingLocalCapabilities = [
-    ...(localProbe.ok ? [] : ["leveldb"]),
-    ...(hasLocalAgentConfig ? [] : ["agent-config"]),
-    ...(hasLocalProvider ? [] : ["provider"]),
-  ];
-  const decision = resolveAgentRuntimeDecision({
-    requestedMode: "auto",
-    syncRequested: false,
-    host: "cli",
-    hasLocalAgentConfig,
-    hasLocalProvider,
-    hasLocalPersistence: true,
-    missingLocalCapabilities,
-    requiresServer: false,
-    serverFallbackAvailable: Boolean(authToken || env.NOLO_SERVER || env.BASE_URL),
-  });
-
-  output.write(`Runtime: ${decision.mode}\n`);
-  output.write(`Reason: ${decision.reason}\n`);
-  output.write(`LevelDB: ${localProbe.ok ? "ok" : "failed"}\n`);
-  output.write(`DB path: ${localProbe.dbPath}\n`);
-  if (!localProbe.ok && localProbe.error) {
-    output.write(`DB error: ${localProbe.error}\n`);
-  }
-  if (localProbe.agentKey) {
-    output.write(`Agent config: ${localProbe.agentFound ? "found" : "missing"} (${localProbe.agentKey})\n`);
-  } else {
-    output.write("Agent config: missing (no local agent key)\n");
-  }
-  output.write(`Provider: ${hasLocalProvider ? "available" : "missing"} (${detectProviderLabel(env)})\n`);
-  output.write("Persistence: LevelDB local store\n");
-  output.write(`Sync: ${authToken ? "available" : "unavailable"}${authToken ? "" : " (not authenticated)"}\n`);
-  output.write(`Server fallback: ${decision.runnable && decision.mode === "server" ? serverUrl : authToken || env.NOLO_SERVER || env.BASE_URL ? serverUrl : "unavailable"}\n`);
-  if (decision.missingLocalCapabilities.length > 0) {
-    output.write("Missing local capabilities:\n");
-    for (const capability of decision.missingLocalCapabilities) {
-      output.write(`- ${capability}\n`);
-    }
-  }
+  const report = buildCliRuntimeDoctorReport(
+    buildCliRuntimeDoctorProbe({
+      env,
+      localProbe,
+      authToken,
+      serverUrl,
+    })
+  );
+  output.write(formatCliRuntimeDoctorReport(report));
 
-  return decision.runnable ? 0 : 1;
+  return report.decision.runnable ? 0 : 1;
 }

package/spaceAttachCommands.ts

@@ -0,0 +1,134 @@
+import { ContentType } from "./app/types";
+import { getReadableCliDb, type AgentCommandDeps } from "./agentCommandSupport";
+import { resolveAgentRecordFromHybridStore } from "./agentRecordHelpers";
+import {
+  parseUserIdFromAuthToken,
+  readOption,
+  resolveAuthToken,
+  resolveServerCandidates,
+  resolveServerUrl,
+} from "./cliEnvHelpers";
+import {
+  parseSpaceIdFromInput,
+  readSpaceRecordWithFallback,
+  writeSpaceRecord,
+} from "./spaceMutationHelpers";
+
+function usage() {
+  return [
+    "Usage:",
+    "  nolo space attach-agent --space <spaceId|spaceKey|spaceUrl> --agent <agentKey|alias|agentUrl>",
+    "",
+  ].join("\n");
+}
+
+export async function runSpaceAttachAgentCommand(
+  args: string[],
+  deps: AgentCommandDeps = {}
+) {
+  const env = deps.env ?? process.env;
+  const output = deps.output ?? process.stdout;
+
+  if (args.includes("--help") || args.includes("-h")) {
+    output.write(`${usage()}\n`);
+    return 0;
+  }
+
+  const rawSpace = readOption(args, "--space");
+  const rawAgent = readOption(args, "--agent");
+  if (!rawSpace || !rawAgent) {
+    output.write(`${usage()}\n`);
+    return 1;
+  }
+
+  const authToken = resolveAuthToken(args, env);
+  const userId = parseUserIdFromAuthToken(authToken);
+  if (!authToken || !userId) {
+    output.write("[nolo] space attach-agent requires an auth token with userId. Run `nolo login`.\n");
+    return 1;
+  }
+
+  const db = deps.db ?? await getReadableCliDb(output);
+  const fetchImpl = deps.fetchImpl ?? fetch;
+  const fallbackFetchImpl = deps.fallbackFetchImpl;
+  const defaultServerUrl = resolveServerUrl(args, env);
+  const serverCandidates = resolveServerCandidates(args, env, defaultServerUrl);
+
+  try {
+    const spaceId = parseSpaceIdFromInput(rawSpace);
+    const spaceRecord = await readSpaceRecordWithFallback({
+      authToken,
+      db,
+      fallbackFetchImpl,
+      fetchImpl,
+      serverCandidates,
+      spaceId,
+    });
+    const resolvedAgent = await resolveAgentRecordFromHybridStore({
+      agentInput: rawAgent,
+      cliArgs: args,
+      env,
+      db,
+      fetchImpl,
+      fallbackFetchImpl,
+    });
+    if (!resolvedAgent?.record || typeof resolvedAgent.record !== "object") {
+      throw new Error(`agent not found: ${rawAgent}`);
+    }
+    const agentKey = resolvedAgent.agentKey;
+
+    const title =
+      typeof resolvedAgent.record.name === "string" && resolvedAgent.record.name.trim()
+        ? resolvedAgent.record.name.trim()
+        : agentKey;
+    const now = Date.now();
+    const nextSpaceRecord = {
+      ...spaceRecord,
+      updatedAt: now,
+      contents: {
+        ...(spaceRecord?.contents ?? {}),
+        [agentKey]: {
+          ...(spaceRecord?.contents?.[agentKey] ?? {}),
+          title,
+          type: ContentType.AGENT,
+          contentKey: agentKey,
+          updatedAt: now,
+          createdAt: spaceRecord?.contents?.[agentKey]?.createdAt ?? now,
+        },
+      },
+    };
+
+    await writeSpaceRecord({
+      authToken,
+      db,
+      fallbackFetchImpl,
+      fetchImpl,
+      record: nextSpaceRecord,
+      serverUrl: defaultServerUrl,
+      spaceId,
+      userId,
+    });
+
+    output.write(
+      `${JSON.stringify(
+        {
+          ok: true,
+          baseUrl: defaultServerUrl,
+          spaceId,
+          agentKey,
+          title,
+        },
+        null,
+        2
+      )}\n`
+    );
+    return 0;
+  } catch (error) {
+    output.write(
+      `[nolo] space attach-agent failed: ${
+        error instanceof Error ? error.message : String(error)
+      }\n`
+    );
+    return 1;
+  }
+}

package/spaceInternalCommandEntries.ts

@@ -1,5 +1,6 @@
 import { createEnvCommand } from "./cliCommandFactories";
 import type { CommandEntry } from "./cliCommandTypes";
+import { runSpaceAttachAgentCommand } from "./spaceAttachCommands";
 import {
   runSpaceCategoryCommand,
   runSpaceContentCategoryCommand,
@@ -12,6 +13,7 @@ export function getSpaceInternalCommandEntries(): CommandEntry[] {
   return [
     createEnvCommand(["space", "list"], "List joined spaces", runSpaceListCommand),
     createEnvCommand(["space", "read"], "Read a space", runSpaceReadCommand),
+    createEnvCommand(["space", "attach-agent"], "Attach an existing agent to a space", runSpaceAttachAgentCommand),
     createEnvCommand(["space", "category"], "Create or update a space category", runSpaceCategoryCommand),
     createEnvCommand(["space", "content-category"], "Move content into a space category", runSpaceContentCategoryCommand),
     createEnvCommand(["space", "delete"], "Delete spaces by safe filters", runSpaceDeleteCommand),