c8ctl-plugin-nano 1.59.0 → 1.59.1

package/agent-instance.mjs

@@ -34,9 +34,10 @@ const isPlainObject = (v) => v != null && typeof v === 'object' && !Array.isArra
  * element carries `zeebe:agentDefinition agentType="external"`?
  *
  * The engine surfaces exactly this eligibility as the pair of fields it stamps on
- * an external agent job's activation: an opaque per-activation `jobLease` token
- * (distinct from the job's `deadline`; nanobpmn #1106) plus the `elementInstanceKey`
- * the AgentInstance correlates on. The engine-native `aiAgentTask`/`aiAgentSubProcess`
+ * an external agent job's activation: an opaque per-activation lease token —
+ * `leaseToken` on the activated job (Camunda v10 ActivatedJobResult; distinct from
+ * the job's `deadline`, nanobpmn #1106) — plus the `elementInstanceKey` the
+ * AgentInstance correlates on. The engine-native `aiAgentTask`/`aiAgentSubProcess`
  * variants auto-mint their AgentInstance and never create an activatable job, so any
  * job a worker actually activates that carries a lease token IS an external agent
  * job. Absence of either field means "not an external agent job" → the producer
@@ -44,7 +45,7 @@ const isPlainObject = (v) => v != null && typeof v === 'object' && !Array.isArra
  */
 export function isExternalAgentJob(job) {
   if (!isPlainObject(job)) return false;
-  return isNonBlank(job.jobLease) && isNonBlank(job.elementInstanceKey);
+  return isNonBlank(job.leaseToken) && isNonBlank(job.elementInstanceKey);
 }
 
 /** Best-effort provider inference from a model identifier (openai/anthropic/…). */
@@ -145,7 +146,7 @@ function contentForResult(result) {
  *
  * @param {object} opts
  * @param {object} opts.camunda   Host SDK client (createAgentInstance/updateAgentInstance).
- * @param {object} opts.job       The activated job (jobKey/jobLease/elementInstanceKey/elementId).
+ * @param {object} opts.job       The activated job (jobKey/leaseToken/elementInstanceKey/elementId).
  * @param {object} [opts.profile] The worker profile (model/provider seed the definition).
  * @param {object} [opts.envelope] The normalized task envelope (task.prompt → systemPrompt).
  * @param {object} [opts.logger]  Output-mode-aware logger (warn/info/debug).
@@ -166,7 +167,12 @@ export function createAgentInstanceProducer(opts = {}) {
   const classify = typeof sessionAcp?.classifyUpdate === 'function' ? sessionAcp.classifyUpdate : null;
 
   const jobKey = job?.jobKey != null ? String(job.jobKey) : '';
-  const jobLease = job?.jobLease != null ? String(job.jobLease) : '';
+  // The activation lease is carried on the job as `leaseToken` (Camunda v10
+  // ActivatedJobResult). It is submitted BACK to createAgentInstance/updateAgentInstance
+  // as the request-body field `jobLease` (agent-instances.yaml) — the same opaque token,
+  // named differently on the two sides of the contract. One internal name here; the
+  // translation to `jobLease` happens only at each SDK call below.
+  const leaseToken = job?.leaseToken != null ? String(job.leaseToken) : '';
   const elementInstanceKey = job?.elementInstanceKey != null ? String(job.elementInstanceKey) : '';
   const elementId = job?.elementId != null ? String(job.elementId) : null;
 
@@ -212,7 +218,7 @@ export function createAgentInstanceProducer(opts = {}) {
         agentInstanceKey,
         elementInstanceKey,
         jobKey,
-        jobLease,
+        jobLease: leaseToken,
         history: [turn],
       };
       if (status) req.status = status;
@@ -321,7 +327,7 @@ export function createAgentInstanceProducer(opts = {}) {
         const res = await camunda[SDK_CREATE]({
           elementInstanceKey,
           jobKey,
-          jobLease,
+          jobLease: leaseToken,
           history: [configTurn],
         });
         agentInstanceKey =
@@ -425,7 +431,7 @@ export function createAgentInstanceProducer(opts = {}) {
             agentInstanceKey,
             elementInstanceKey,
             jobKey,
-            jobLease,
+            jobLease: leaseToken,
             status: 'COMPLETED',
           });
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c8ctl-plugin-nano",
-  "version": "1.59.0",
+  "version": "1.59.1",
   "type": "module",
   "description": "c8ctl plugin to start, inspect, and stop a local Nano BPM (nanobpmn) cluster",
   "main": "c8ctl-plugin.js",
@@ -73,12 +73,12 @@
   },
   "optionalDependencies": {
     "node-pty": "^1.0.0",
-    "@nanobpm/c8ctl-plugin-nano-darwin-arm64": "1.59.0",
-    "@nanobpm/c8ctl-plugin-nano-darwin-x64": "1.59.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-x64": "1.59.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-arm64": "1.59.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-armv7": "1.59.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-armv6": "1.59.0",
-    "@nanobpm/c8ctl-plugin-nano-win32-x64": "1.59.0"
+    "@nanobpm/c8ctl-plugin-nano-darwin-arm64": "1.59.1",
+    "@nanobpm/c8ctl-plugin-nano-darwin-x64": "1.59.1",
+    "@nanobpm/c8ctl-plugin-nano-linux-x64": "1.59.1",
+    "@nanobpm/c8ctl-plugin-nano-linux-arm64": "1.59.1",
+    "@nanobpm/c8ctl-plugin-nano-linux-armv7": "1.59.1",
+    "@nanobpm/c8ctl-plugin-nano-linux-armv6": "1.59.1",
+    "@nanobpm/c8ctl-plugin-nano-win32-x64": "1.59.1"
   }
 }

package/supervisor-engine.mjs

@@ -141,17 +141,22 @@ function mapJob(raw) {
   const pik = raw.processInstanceKey;
   if (pik !== undefined && pik !== null) job.processInstanceKey = String(pik);
   // Engine-native AgentInstance attribution (issue #194): the element instance the
-  // AgentInstance correlates on, the element id, and the opaque per-activation
-  // `jobLease` token that lease-gates a `createAgentInstance` for an `external`
-  // agent job (nanobpmn #1099/#1106). These ride opaquely to the runner exactly as
-  // the SDK activation surfaces them; absent for ordinary (non-agent) jobs, in which
-  // case the durable-transcript producer stays inert.
+  // AgentInstance correlates on, the element id, and the opaque per-activation lease
+  // token that lease-gates a `createAgentInstance` for an `external` agent job
+  // (nanobpmn #1099/#1106). The Camunda v10 REST contract carries the lease on the
+  // ACTIVATED JOB as `leaseToken` (jobs.yaml ActivatedJobResult) — NOT `jobLease`,
+  // which is the field name only on the createAgentInstance/updateAgentInstance REQUEST
+  // body (agent-instances.yaml). The harness carries ONE internal name — `leaseToken` —
+  // all the way through, and translates to `jobLease` only at that SDK body (see
+  // agent-instance.mjs). These ride opaquely to the runner exactly as the SDK activation
+  // surfaces them; absent for ordinary (non-agent) jobs, in which case the
+  // durable-transcript producer stays inert.
   const eik = raw.elementInstanceKey;
   if (eik !== undefined && eik !== null) job.elementInstanceKey = String(eik);
   const eid = raw.elementId;
   if (eid !== undefined && eid !== null) job.elementId = String(eid);
-  const lease = raw.jobLease;
-  if (lease !== undefined && lease !== null) job.jobLease = String(lease);
+  const lease = raw.leaseToken;
+  if (lease !== undefined && lease !== null) job.leaseToken = String(lease);
   return job;
 }
 
@@ -254,6 +259,12 @@ export function createRawEngineClient(opts = {}) {
         maxJobsToActivate: req.maxJobsToActivate,
         timeout: req.lockMs,
         requestTimeout: req.requestTimeoutMs,
+        // Request a per-activation lease (Camunda v10 `withLease`): the engine then
+        // stamps each activated job with a distinct opaque `leaseToken`
+        // (ActivatedJobResult.leaseToken) which lease-gates the external agent job's
+        // `createAgentInstance` (nanobpmn #1099/#1106). Without it the token is absent
+        // and the durable AgentInstance producer stays inert.
+        withLease: true,
       };
       // Give the abort budget slack over the server long-poll so we don't cancel
       // a still-valid long-poll a hair before the server would answer it.