@cleocode/contracts 2026.9.23 → 2026.9.24

package/dist/decide.js

@@ -66,8 +66,31 @@ export const DECISION_REQUEST_LIMITS = {
 export const DECISION_PROVIDER_KINDS = ['layahost', 'jev'];
 /** Base URL of the layahost API (its OpenAPI `servers[0].url`). */
 export const LAYAHOST_BASE_URL = 'https://layahost.com';
+/**
+ * Base URL of Jev's own API (TypeSafe AI). Source: the canonical spec
+ * `system-one-integration`, "Provider research: capability map" ("Jev itself
+ * (TypeSafe AI, `https://api.typesafe.ai`, OpenAPI v0.2.0)").
+ */
+export const JEV_DEFAULT_BASE_URL = 'https://api.typesafe.ai';
 /** layahost's routing model, the default for a layahost connection. */
 export const LAYAHOST_DEFAULT_MODEL = 'laya-auto';
+// ─── Named provider profiles (T12733) ────────────────────────────────────────
+/**
+ * A valid profile name: 1-32 characters of lowercase letters, digits and
+ * `-`, starting and ending with a letter or digit (e.g. `default`, `work`,
+ * `team-b`). A profile is addressed as `<provider>/<name>`, e.g.
+ * `layahost/default` or `jev/team`; one provider may hold several profiles
+ * (accounts), each with its own key.
+ */
+export const DECIDE_PROFILE_NAME_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,30}[a-z0-9])?$/;
+/** The profile name used when none is given: `<provider>/default`. */
+export const DECIDE_DEFAULT_PROFILE_NAME = 'default';
+/**
+ * The stored `baseUrl` of a profile that uses its provider's preset URL. It
+ * is resolved when the profile is used, so a changed preset URL flows
+ * through to every profile that kept the default.
+ */
+export const DECIDE_PROFILE_DEFAULT_URL = 'default';
 /** The Jev minimum every provider supports; the default when a provider reports nothing. */
 export const JEV_MINIMUM_CAPABILITIES = {
     wire: 'jev-systemone/1',

package/dist/decide.js.map

@@ -1 +1 @@
-{"version":3,"file":"decide.js","sourceRoot":"","sources":["../src/decide.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"decide.js","sourceRoot":"","sources":["../src/decide.ts"],"names":[],"mappings":"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"}

package/dist/dispatch/operations-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations-registry.d.ts","sourceRoot":"","sources":["../../src/dispatch/operations-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEjG,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAMvE;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE1F;AAeD,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,YAAY,EAu9UpC,CAAC"}
+{"version":3,"file":"operations-registry.d.ts","sourceRoot":"","sources":["../../src/dispatch/operations-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEjG,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAMvE;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE1F;AAeD,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,YAAY,EAimVpC,CAAC"}

package/dist/dispatch/operations-registry.js

@@ -3004,6 +3004,13 @@ export const OPERATIONS = [
                 description: 'taskId parameter',
                 cli: { positional: true },
             },
+            {
+                name: 'expectedUpdatedAt',
+                type: 'string',
+                required: false,
+                description: 'Optimistic-concurrency guard: fail with E_CONFLICT unless the task updatedAt still equals this value',
+                cli: { flag: 'if-match' },
+            },
         ],
     },
     {
@@ -3663,7 +3670,7 @@ export const OPERATIONS = [
         gateway: 'mutate',
         domain: 'tasks',
         operation: 'start',
-        description: 'tasks.start (mutate)',
+        description: "tasks.start (mutate) — start work and take the caller session's leased claim (E_TASK_CLAIMED when another session holds it)",
         tier: 0,
         idempotent: false,
         sessionRequired: false,
@@ -3676,6 +3683,20 @@ export const OPERATIONS = [
                 description: 'taskId parameter',
                 cli: { positional: true },
             },
+            {
+                name: 'takeOver',
+                type: 'boolean',
+                required: false,
+                description: "Take over another session's EXPIRED claim lease (audited)",
+                cli: { flag: 'take-over' },
+            },
+            {
+                name: 'forceClaim',
+                type: 'boolean',
+                required: false,
+                description: "Take over another session's LIVE claim lease (audited)",
+                cli: { flag: 'force-claim' },
+            },
         ],
     },
     {
@@ -3784,11 +3805,11 @@ export const OPERATIONS = [
         gateway: 'mutate',
         domain: 'tasks',
         operation: 'claim',
-        description: 'tasks.claim (mutate) — claim a task by assigning it to the current session',
+        description: "tasks.claim (mutate) — take, renew or override the caller session's leased claim on a task (never the human assignee)",
         tier: 0,
         idempotent: false,
         sessionRequired: true,
-        requiredParams: ['taskId', 'agentId'],
+        requiredParams: ['taskId'],
         params: [
             {
                 name: 'taskId',
@@ -3799,8 +3820,26 @@ export const OPERATIONS = [
             {
                 name: 'agentId',
                 type: 'string',
-                required: true,
-                description: 'Agent ID to assign the task to',
+                required: false,
+                description: "Agent ID recorded with the lease (default: the session's agent / CLEO_AGENT_ID)",
+            },
+            {
+                name: 'renew',
+                type: 'boolean',
+                required: false,
+                description: "Renew the caller's own lease",
+            },
+            {
+                name: 'takeOver',
+                type: 'boolean',
+                required: false,
+                description: "Take over another session's EXPIRED lease (audited)",
+            },
+            {
+                name: 'forceClaim',
+                type: 'boolean',
+                required: false,
+                description: "Take over another session's LIVE lease (audited)",
             },
         ],
     },
@@ -3808,7 +3847,7 @@ export const OPERATIONS = [
         gateway: 'mutate',
         domain: 'tasks',
         operation: 'unclaim',
-        description: 'tasks.unclaim (mutate) — unclaim a task by removing the current assignee',
+        description: "tasks.unclaim (mutate) — release the caller session's claim lease (never the human assignee)",
         tier: 0,
         idempotent: false,
         sessionRequired: true,
@@ -3820,6 +3859,12 @@ export const OPERATIONS = [
                 required: true,
                 description: 'Task ID to unclaim',
             },
+            {
+                name: 'forceClaim',
+                type: 'boolean',
+                required: false,
+                description: "Release another session's lease (audited)",
+            },
         ],
     },
     {
@@ -4074,6 +4119,20 @@ export const OPERATIONS = [
                 required: false,
                 description: 'When true (default), adds toTaskId as a dependency on fromTaskId so it cannot complete before the pivot resolves',
             },
+            {
+                name: 'takeOver',
+                type: 'boolean',
+                required: false,
+                description: "Take over another session's EXPIRED claim on toTaskId (audited)",
+                cli: { flag: 'take-over' },
+            },
+            {
+                name: 'forceClaim',
+                type: 'boolean',
+                required: false,
+                description: "Take over another session's LIVE claim on toTaskId (audited)",
+                cli: { flag: 'force-claim' },
+            },
         ],
     },
     // parallel.start and parallel.end merged into orchestrate.parallel via action param (T5615)
@@ -6717,6 +6776,78 @@ export const OPERATIONS = [
         requiredParams: [],
         params: [],
     },
+    {
+        gateway: 'query',
+        domain: 'nexus',
+        operation: 'projects.fleet',
+        description: 'nexus.projects.fleet (query) — fleet view: every project with its location on each device, last recorded git state (local, and remote as of the last fetch) and staleness; paged, counts first, read-only',
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [
+            {
+                name: 'device',
+                type: 'string',
+                required: false,
+                description: 'Only locations on this device (device id, hostname, or current)',
+            },
+            {
+                name: 'missing',
+                type: 'boolean',
+                required: false,
+                description: 'Only projects with a missing location',
+            },
+            {
+                name: 'dirty',
+                type: 'boolean',
+                required: false,
+                description: 'Only projects with a dirty location',
+            },
+            {
+                name: 'behind',
+                type: 'boolean',
+                required: false,
+                description: 'Only projects with a location behind its upstream (as of the last fetch)',
+            },
+            {
+                name: 'ahead',
+                type: 'boolean',
+                required: false,
+                description: 'Only projects with a location ahead of its upstream (as of the last fetch)',
+            },
+            {
+                name: 'stale',
+                type: 'boolean',
+                required: false,
+                description: 'Only projects with a never-probed, old-probe or old-fetch location',
+            },
+            {
+                name: 'errored',
+                type: 'boolean',
+                required: false,
+                description: 'Only projects whose last probe recorded an error',
+            },
+            {
+                name: 'staleAfterMs',
+                type: 'number',
+                required: false,
+                description: 'Staleness window for probes, fetches and heartbeats (default 24h)',
+            },
+            {
+                name: 'limit',
+                type: 'number',
+                required: false,
+                description: 'Page size in projects (default 50, max 500; 0 = all)',
+            },
+            {
+                name: 'offset',
+                type: 'number',
+                required: false,
+                description: 'Projects skipped before the page',
+            },
+        ],
+    },
     {
         gateway: 'mutate',
         domain: 'nexus',