@awak-app/simy-cli 0.1.5 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awak-app/simy-cli",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "Local SIMY Agentic Loop executor for Codex and Claude Code.",
   "type": "module",
   "bin": {

package/src/agent.js

@@ -64,6 +64,11 @@ import {
   scanGitRepositories,
   writeRepositoryInventory,
 } from "./repository-inventory.js";
+import {
+  CLI_API_CONTRACT_VERSION,
+  CLI_VERSION,
+  withCliContract,
+} from "./cli-contract.js";
 
 const DEVICE_HEARTBEAT_INTERVAL_MS = 20_000;
 
@@ -99,7 +104,11 @@ export async function startAgent({
         ]
       : [],
   );
-  const availableCapabilities = await readCapabilities(dependencies);
+  const installMode = updateManager?.snapshot?.()?.install_mode ?? null;
+  const availableCapabilities = withCliContract(
+    await readCapabilities(dependencies),
+    installMode,
+  );
   const heartbeatDevice = dependencies.heartbeatDevice || heartbeatLocalDevice;
   const runOptions = dependencies.runOptions || {};
   const repositoryScanRoot = resolve(
@@ -274,6 +283,8 @@ export async function startAgent({
       if (req.method === "GET" && url.pathname === "/v1/health") {
         json(res, 200, {
           ok: true,
+          cli_version: CLI_VERSION,
+          api_contract_version: CLI_API_CONTRACT_VERSION,
           daemon,
           web_origin: apiOrigin,
           session_valid: isSessionValid(session, Date.now(), apiOrigin),
@@ -283,7 +294,7 @@ export async function startAgent({
         return;
       }
       if (req.method === "GET" && url.pathname === "/v1/capabilities") {
-        json(res, 200, await readCapabilities(dependencies));
+        json(res, 200, availableCapabilities);
         return;
       }
       if (req.method === "POST" && agenticLoopPath === "/v1/agentic-loop/preflight") {
@@ -356,7 +367,12 @@ export async function startAgent({
         startHeartbeatTimer();
         loginUrl = null;
         registry.emit("change", registry.list());
-        json(res, 200, { ok: true, expires_at: session.expires_at });
+        json(res, 200, {
+          ok: true,
+          expires_at: session.expires_at,
+          cli_version: CLI_VERSION,
+          api_contract_version: CLI_API_CONTRACT_VERSION,
+        });
         void synchronizeAuthorizedSession();
         return;
       }
@@ -698,6 +714,9 @@ export async function startAgent({
     loginUrl = new URL("/local-cli/connect", apiOrigin);
     loginUrl.searchParams.set("port", String(port));
     loginUrl.searchParams.set("nonce", authNonce);
+    loginUrl.searchParams.set("cli_version", CLI_VERSION);
+    loginUrl.searchParams.set("api_contract_version", String(CLI_API_CONTRACT_VERSION));
+    if (installMode) loginUrl.searchParams.set("install_mode", installMode);
     if (!quiet) {
       console.log(`Sign in to SIMY: ${loginUrl.toString()}`);
       console.log(`Session file: ${sessionPath(apiOrigin, sessionRoot)}`);
@@ -910,6 +929,8 @@ export async function heartbeatLocalDevice({
       ),
       body: JSON.stringify({
         port,
+        cli_version: CLI_VERSION,
+        api_contract_version: CLI_API_CONTRACT_VERSION,
         capabilities,
         repo_inventory: repoInventory,
       }),

package/src/cli-contract.js

@@ -0,0 +1,11 @@
+export const CLI_VERSION = "0.2.0";
+export const CLI_API_CONTRACT_VERSION = 2;
+
+export function withCliContract(capabilities = {}, installMode = null) {
+  return {
+    ...capabilities,
+    cli_version: CLI_VERSION,
+    api_contract_version: CLI_API_CONTRACT_VERSION,
+    ...(installMode ? { install_mode: installMode } : {}),
+  };
+}