@awebai/oats 0.22.14 → 0.22.16

package/lib/servers.mjs

@@ -232,6 +232,7 @@ export function checkRemote(target, io = {}) {
     launchOptions: list("launchOptions", []),
     remote: list("remote", []),
     features: list("features", []),
+    operationsApi: probe.operationsApi === 1 ? 1 : null,
     advertised: Array.isArray(probe.runtimes),
   };
 }
@@ -479,7 +480,34 @@ export function routeCommand(serverId, cmd, oatsArgs, io = {}) {
     const { envelope, stderr } = runRemote(target, json(withScope(["status", ...oatsArgs])), io);
     return { envelope: envelope.ok ? { ...envelope, result: { ...envelope.result, server: serverId, target, snapshots: listSnapshots(serverId) } } : envelope, stderr };
   }
-  throw serverError("E_USAGE", `--server routes spawn, retire, status, session and okf harvest only (not ${cmd})`);
+  if (OPERATIONS_COMMANDS.has(cmd)) {
+    // The operations contract (inspect, operation run, use, soul set): the
+    // remote must advertise it before anything is sent. An explicit --dir is
+    // the exact member context the caller chose and travels as is; without
+    // one, a --home selection is left to the host (the home is its own
+    // context) and anything else runs in the registered workspace.
+    // An exact remote home (or a saved instance name) resolves through its
+    // FROZEN route exactly as session attach does: the snapshot's target,
+    // and a home/name disagreement is refused; the registration's target is
+    // used only for scope requests, which get its workspace as --dir.
+    let args = [...oatsArgs];
+    const valueOf = (name) => { const i = args.indexOf(name); return i >= 0 && args[i + 1] && !args[i + 1].startsWith("--") ? args[i + 1] : undefined; };
+    let route;
+    if (valueOf("--home") !== undefined || valueOf("--instance") !== undefined) {
+      route = resolveRoute(serverId, { instance: valueOf("--instance"), home: valueOf("--home") }, cmd);
+      target = route.target;
+      const ii = args.indexOf("--instance");
+      if (ii >= 0) { args.splice(ii, 2); if (valueOf("--home") === undefined) args.push("--home", route.home); }
+    }
+    const remote = checkRemote(target, io);
+    if (!Array.isArray(remote.features) || !remote.features.includes("operations") || remote.operationsApi !== 1) {
+      throw serverError("E_REMOTE_INCOMPATIBLE", `remote oats ${remote.version} at ${target.sshHost} does not advertise the operations contract (kernels from ${OPERATIONS_REMOTE_VERSION} do); upgrade it there; nothing was sent`);
+    }
+    const scoped = args.includes("--dir") || args.includes("--home") ? args : [...args, "--dir", target.workspace];
+    const { envelope, stderr } = runRemote(target, json([cmd, ...scoped]), io);
+    return { envelope: envelope.result && typeof envelope.result === "object" ? { ...envelope, result: { ...envelope.result, server: serverId, ...(route ? { route: { home: route.home, instance: route.snapshot?.instance || null, frozen: !!route.snapshot } } : {}) } } : envelope, stderr };
+  }
+  throw serverError("E_USAGE", `--server routes spawn, retire, status, session, okf harvest, schedule, inspect, operation, use and soul only (not ${cmd})`);
 }
 
 // ------------------------------------------------------------------- roster
@@ -621,6 +649,9 @@ export function inspectRemote(serverId, { instance, home } = {}, io = {}) {
 /** The kernel version whose probe first advertises the `session-start`
  *  feature; the probe's features list is the actual check. */
 export const SESSION_START_REMOTE_VERSION = "0.22.9";
+/** The kernel version whose probe first advertises the operations contract. */
+export const OPERATIONS_REMOTE_VERSION = "0.22.16";
+const OPERATIONS_COMMANDS = new Set(["inspect", "operation", "use", "soul"]);
 
 /** `session start` on the execution host for a remote instance: the same
  *  route resolution as inspect, refused before any mutation when the remote

package/package-catalog.json

@@ -2,7 +2,7 @@
   "packages": {
     "oats.okf": {
       "url": "https://github.com/awebai/oats-okf.git",
-      "ref": "v1.5.2",
+      "ref": "v1.6.0",
       "path": "oats-package"
     },
     "oats.aweb": {
@@ -33,12 +33,33 @@
   },
   "capabilities": {
     "oats.review": "oats.dev",
-    "oas.okf": { "package": "oats.okf", "capability": "oats.okf" },
-    "oas.aweb": { "package": "oats.aweb", "capability": "oats.aweb" },
-    "oas.jira": { "package": "oats.jira", "capability": "oats.jira" },
-    "oas.linear": { "package": "oats.linear", "capability": "oats.linear" },
-    "oas.authoring": { "package": "oats.authoring", "capability": "oats.authoring" },
-    "oas.dev": { "package": "oats.dev", "capability": "oats.dev" },
-    "oas.review": { "package": "oats.dev", "capability": "oats.review" }
+    "oas.okf": {
+      "package": "oats.okf",
+      "capability": "oats.okf"
+    },
+    "oas.aweb": {
+      "package": "oats.aweb",
+      "capability": "oats.aweb"
+    },
+    "oas.jira": {
+      "package": "oats.jira",
+      "capability": "oats.jira"
+    },
+    "oas.linear": {
+      "package": "oats.linear",
+      "capability": "oats.linear"
+    },
+    "oas.authoring": {
+      "package": "oats.authoring",
+      "capability": "oats.authoring"
+    },
+    "oas.dev": {
+      "package": "oats.dev",
+      "capability": "oats.dev"
+    },
+    "oas.review": {
+      "package": "oats.dev",
+      "capability": "oats.review"
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awebai/oats",
-  "version": "0.22.14",
+  "version": "0.22.16",
   "description": "OATS (Open Agent Team Specification) — durable souls, disposable instances, targetable capability packages, and the runtime-neutral oats CLI/kernel.",
   "keywords": [
     "agents",