letta-city-cli 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# lcity CLI (Node.js)
+
+Shared command-line tool layer for all Letta agents in `letta-city-sim`.
+
+This package is structured to be published independently.
+
+- entrypoint: `bin/lcity.mjs`
+- command implementation: `src/cli.mjs`
+- package metadata: `package.json`
+
+## Run directly
+
+```powershell
+node .\lcity\bin\lcity.mjs health_check
+```
+
+## Use `.lcity/agent_id`
+
+```powershell
+New-Item -ItemType Directory -Force .lcity | Out-Null
+Set-Content .lcity\agent_id "eddy_lin"
+node .\lcity\bin\lcity.mjs health_check
+```
+
+## Install locally as command
+
+```powershell
+npm --prefix .\lcity install
+npm --prefix .\lcity link
+lcity health_check
+```
+
+Optional base URL override:
+
+```powershell
+node .\lcity\bin\lcity.mjs --api-base http://localhost:3001 health_check
+```
+
+Output is always JSON:
+
+```json
+{"ok":true,"status_code":200,"data":{"status":"ok","agent_id":"eddy_lin","letta_agent_id":"...","current_location_id":"lin_bedroom","state":"idle"}}
+```

package/bin/lcity.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { run } from "../src/cli.mjs";
+
+const code = await run(process.argv.slice(2));
+process.exit(code);

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "letta-city-cli",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "lcity": "./bin/lcity.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ]
+}

package/src/cli.mjs

@@ -0,0 +1,118 @@
+import fs from "node:fs";
+import path from "node:path";
+
+function parseArgs(argv) {
+  const args = {
+    command: null,
+    apiBase: process.env.LCITY_API_BASE || "http://localhost:3001",
+    agentIdFile: path.join(".lcity", "agent_id"),
+  };
+
+  const tokens = [...argv];
+  while (tokens.length > 0) {
+    const token = tokens.shift();
+
+    if (!args.command && !token.startsWith("--")) {
+      args.command = token;
+      continue;
+    }
+
+    if (token === "--api-base") {
+      args.apiBase = tokens.shift() || args.apiBase;
+      continue;
+    }
+
+    if (token === "--agent-id-file") {
+      args.agentIdFile = tokens.shift() || args.agentIdFile;
+      continue;
+    }
+  }
+
+  return args;
+}
+
+function resolveAgentId(agentIdFile) {
+  if (fs.existsSync(agentIdFile)) {
+    try {
+      const fileAgentId = fs.readFileSync(agentIdFile, "utf8").trim();
+      if (fileAgentId) {
+        return { agentId: fileAgentId, error: null };
+      }
+    } catch (err) {
+      return { agentId: null, error: `failed to read agent id file: ${err.message}` };
+    }
+  }
+
+  return {
+    agentId: null,
+    error: "missing ./.lcity/agent_id (or pass --agent-id-file)",
+  };
+}
+
+async function requestJson(url, { method = "GET", headers = {} } = {}) {
+  try {
+    const response = await fetch(url, { method, headers });
+    const text = await response.text();
+    let data = {};
+    if (text) {
+      try {
+        data = JSON.parse(text);
+      } catch {
+        data = { error: text };
+      }
+    }
+
+    return { statusCode: response.status, data };
+  } catch (err) {
+    return { statusCode: 0, data: { error: `network error: ${err.message}` } };
+  }
+}
+
+async function healthCheck(apiBase, agentId) {
+  const { statusCode, data } = await requestJson(`${apiBase.replace(/\/$/, "")}/agents/health`, {
+    method: "GET",
+    headers: {
+      "x-agent-id": agentId,
+    },
+  });
+
+  const output = {
+    ok: statusCode === 200,
+    status_code: statusCode,
+    data,
+  };
+
+  console.log(JSON.stringify(output));
+  return statusCode === 200 ? 0 : 1;
+}
+
+export async function run(argv) {
+  const args = parseArgs(argv);
+
+  if (!args.command || args.command === "help" || args.command === "--help") {
+    console.log(
+      JSON.stringify({
+        ok: true,
+        usage: [
+          "lcity health_check",
+          "lcity --api-base http://localhost:3001 health_check",
+          "lcity health_check --agent-id-file .lcity/agent_id",
+        ],
+      }),
+    );
+    return 0;
+  }
+
+  if (args.command === "health_check") {
+    const { agentId, error } = resolveAgentId(args.agentIdFile);
+    if (error) {
+      console.log(JSON.stringify({ ok: false, error }));
+      return 1;
+    }
+
+    return healthCheck(args.apiBase, agentId);
+  }
+
+  console.log(JSON.stringify({ ok: false, error: `unknown command: ${args.command}` }));
+  return 1;
+}