@cleocode/contracts 2026.9.22 → 2026.9.24

package/dist/decide.d.ts

@@ -119,6 +119,17 @@ export interface DecisionRequest {
     readonly state: DecisionState;
     /** Question name → question (1–32 entries). Names key the answers in {@link DecisionOutcome}. */
     readonly questions: Readonly<Record<string, DecisionQuestion>>;
+    /**
+     * Language hint (e.g. `en`). Sent only to a provider whose capabilities
+     * include `langHint`; others never see it (T12664).
+     */
+    readonly lang?: string;
+    /**
+     * Provider-side answer cache. `false` asks a provider with `cacheControl`
+     * not to answer from its cache (real latency, sensitive text). Ignored by
+     * providers without the capability.
+     */
+    readonly cache?: boolean;
 }
 /** Answer to a {@link NoulDecisionQuestion}. */
 export interface NoulDecisionAnswer {
@@ -167,13 +178,202 @@ export interface DecisionOutcome {
     readonly latencyMs: number;
     /** Provider-reported cost in US dollars, when known. */
     readonly costUsd?: number;
+    /** Provider-reported cost in integer micro-dollars, when known (T12664). */
+    readonly costMicros?: number;
+    /**
+     * Account balance in integer micro-dollars reported with this answer, when
+     * known. The Jev wire adapter never sets it (the layahost OpenAPI reports
+     * balance only via `GET /v1/usage`, T12715); other providers may.
+     */
+    readonly balanceMicros?: number;
+    /** Provider model checkpoint that answered, when reported. */
+    readonly checkpoint?: string;
     /** Provider-reported input-token count, when known. */
     readonly inputTokens?: number;
 }
+/**
+ * Every supported decision-provider kind, recommended first.
+ *
+ * - `layahost` — the hosted provider at {@link LAYAHOST_BASE_URL}; the user
+ *   supplies only an API key.
+ * - `jev`      — any other Jev-compatible endpoint; the user supplies the URL.
+ */
+export declare const DECISION_PROVIDER_KINDS: readonly ["layahost", "jev"];
+/** A decision-provider kind. See {@link DECISION_PROVIDER_KINDS}. */
+export type DecisionProviderKind = (typeof DECISION_PROVIDER_KINDS)[number];
+/** Base URL of the layahost API (its OpenAPI `servers[0].url`). */
+export declare 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 declare const JEV_DEFAULT_BASE_URL = "https://api.typesafe.ai";
+/** layahost's routing model, the default for a layahost connection. */
+export declare const LAYAHOST_DEFAULT_MODEL = "laya-auto";
+/**
+ * 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 declare const DECIDE_PROFILE_NAME_PATTERN: RegExp;
+/** The profile name used when none is given: `<provider>/default`. */
+export declare 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 declare const DECIDE_PROFILE_DEFAULT_URL = "default";
+/** How a profile's base URL is set: the provider's preset URL, or an override. */
+export type DecideProfileUrlSource = 'default' | 'override';
+/**
+ * Reachability of a decision provider, as `GET /v1/models` reports it.
+ *
+ * - `reachable`         — the listing answered 2xx.
+ * - `unauthorized`      — the provider rejected the key.
+ * - `key_limit_reached` — the key's monthly decision limit is reached.
+ * - `unconfigured`      — no valid base URL + key stored.
+ * - `unreachable`       — network failure, timeout, or any other HTTP status.
+ */
+export type DecideProviderState = 'reachable' | 'unauthorized' | 'key_limit_reached' | 'unconfigured' | 'unreachable';
+/** Result of probing one profile (`cleo decide profiles --probe`). Secret-free. */
+export interface DecideProfileProbe {
+    /** Reachability verdict. */
+    readonly state: DecideProviderState;
+    /** HTTP status of the probe, when one was received. */
+    readonly httpStatus?: number;
+    /** Probe latency, ms. */
+    readonly latencyMs?: number;
+    /** Secret-free explanation, when there is one. */
+    readonly detail?: string;
+}
+/** One named System One provider profile, as listed. Carries no key, only its masked preview. */
+export interface DecideProfileSummary {
+    /** Profile id, `<provider>/<name>`, e.g. `layahost/work`. */
+    readonly id: string;
+    /** Profile name within its provider, e.g. `work`. */
+    readonly name: string;
+    /** Whether everyday decisions use this profile. Exactly one profile is active when any is. */
+    readonly active: boolean;
+    /** Whether the profile holds an acceptable base URL and a non-blank key. */
+    readonly configured: boolean;
+    /** Provider kind. */
+    readonly provider: DecisionProviderKind;
+    /** Resolved base URL (userinfo removed). */
+    readonly baseUrl: string;
+    /** Whether the URL is the provider's preset (`default`) or an override. */
+    readonly urlSource: DecideProfileUrlSource;
+    /** Default model, when stored. */
+    readonly model?: string;
+    /** Masked key preview (`…abcd`). */
+    readonly keyPreview: string;
+    /** ISO timestamp of the profile's last write, when known. */
+    readonly updatedAt?: string;
+    /** Reachability, when probed. */
+    readonly probe?: DecideProfileProbe;
+}
+/**
+ * A profile resolved for use (`resolveDecideProfile`): its id, provider, base
+ * URL (a stored `default` already resolved to the preset), plaintext API key
+ * and default model. Contains the key: pass it to the wire and never log or
+ * emit it. `profile` repeats `name` so the value can be used directly as a
+ * decision connection whose provider state is cached per profile.
+ */
+export interface DecideProfileConnection {
+    /** Profile id, `<provider>/<name>`. */
+    readonly name: string;
+    /** Same as {@link DecideProfileConnection.name}. */
+    readonly profile: string;
+    /** Provider kind. */
+    readonly provider: DecisionProviderKind;
+    /** Resolved base URL. */
+    readonly baseUrl: string;
+    /** Plaintext API key. SECRET. */
+    readonly apiKey: string;
+    /** Default model, when stored. */
+    readonly model?: string;
+}
+/** Result of listing the System One profiles. Secret-free. */
+export interface DecideProfileListResult {
+    /** Absolute path of the credential store. */
+    readonly path: string;
+    /** Id (`<provider>/<name>`) of the active profile, or `null` when none is configured. */
+    readonly active: string | null;
+    /** Every stored profile, sorted by id. */
+    readonly profiles: readonly DecideProfileSummary[];
+    /**
+     * True when the top-level settings disagreed with the active profile's
+     * entry (an older CLEO rewrote the file) and were taken as authoritative.
+     */
+    readonly reconciled: boolean;
+}
 /** Connection settings for a decision provider. */
 export interface DecisionProviderConfig {
     /** Absolute base URL of the provider's API (no trailing path to the endpoint). */
     readonly baseUrl: string;
+    /** Provider kind; absent means a custom Jev-compatible endpoint (`jev`). */
+    readonly provider?: DecisionProviderKind;
+}
+/**
+ * What a decision provider can do beyond the Jev minimum
+ * (`POST /v1/systemone`, 32 questions, 32,000-character state). A caller asks
+ * for a capability; the client degrades when it is absent (spec
+ * `system-one-integration` §2.2).
+ */
+export interface DecisionProviderCapabilities {
+    /** Wire protocol the provider speaks. */
+    readonly wire: string;
+    /** Most questions one request may carry. */
+    readonly maxQuestionsPerRequest: number;
+    /** Largest state, in characters. */
+    readonly maxStateChars: number;
+    /** Batch endpoint limits, when the provider has one. */
+    readonly batch?: {
+        readonly maxRequests: number;
+        readonly maxQuestions: number;
+    };
+    /** Built-in template names, when the provider has templates. */
+    readonly templates?: readonly string[];
+    /** Server-side flows are available. */
+    readonly flows?: boolean;
+    /** A usage/balance endpoint and cost headers are available. */
+    readonly usage?: boolean;
+    /** The request's `cache` field is honoured. */
+    readonly cacheControl?: boolean;
+    /** The request's `lang` field is honoured. */
+    readonly langHint?: boolean;
+    /** How the provider reports cost. */
+    readonly reportsCost?: 'micros' | 'usd' | false;
+}
+/** The Jev minimum every provider supports; the default when a provider reports nothing. */
+export declare const JEV_MINIMUM_CAPABILITIES: DecisionProviderCapabilities;
+/** One item of a batch call: its outcome, or why it failed. */
+export type DecisionBatchItem = {
+    readonly ok: true;
+    readonly outcome: DecisionOutcome;
+} | {
+    readonly ok: false;
+    readonly status?: number;
+    readonly errorKind: string;
+};
+/** Account usage and balance as a provider reports it. */
+export interface DecisionProviderUsage {
+    /** Balance in integer micro-dollars. */
+    readonly balanceMicros?: number;
+    /** Decisions the balance still covers. */
+    readonly decisionsLeft?: number;
+    /** Plan name. */
+    readonly plan?: string;
+    /** End of the current plan period, ISO-8601. */
+    readonly periodEnd?: string;
+    /** Decisions and cost over the queried window. */
+    readonly totals?: {
+        readonly decisions?: number;
+        readonly costMicros?: number;
+    };
 }
 /** Zod schema for {@link DecisionQuestionType}. */
 export declare const decisionQuestionTypeSchema: z.ZodEnum<{
@@ -245,6 +445,8 @@ export declare const decisionQuestionSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
  */
 export declare const decisionRequestSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
+    lang: z.ZodOptional<z.ZodString>;
+    cache: z.ZodOptional<z.ZodBoolean>;
     state: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodJSONSchema>, z.ZodRecord<z.ZodString, z.ZodJSONSchema>]>;
     questions: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"noul">;
@@ -324,10 +526,22 @@ export declare const decisionOutcomeSchema: z.ZodObject<{
     requestId: z.ZodOptional<z.ZodString>;
     latencyMs: z.ZodNumber;
     costUsd: z.ZodOptional<z.ZodNumber>;
+    costMicros: z.ZodOptional<z.ZodNumber>;
+    balanceMicros: z.ZodOptional<z.ZodNumber>;
+    checkpoint: z.ZodOptional<z.ZodString>;
     inputTokens: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+/** Zod schema for {@link DecisionProviderKind}. */
+export declare const decisionProviderKindSchema: z.ZodEnum<{
+    layahost: "layahost";
+    jev: "jev";
+}>;
 /** Zod schema for {@link DecisionProviderConfig}; `baseUrl` must be an absolute URL. */
 export declare const decisionProviderConfigSchema: z.ZodObject<{
     baseUrl: z.ZodURL;
+    provider: z.ZodOptional<z.ZodEnum<{
+        layahost: "layahost";
+        jev: "jev";
+    }>>;
 }, z.core.$strip>;
 //# sourceMappingURL=decide.d.ts.map

package/dist/decide.d.ts.map

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

package/dist/decide.js

@@ -55,6 +55,49 @@ export const DECISION_REQUEST_LIMITS = {
     /** Maximum number of levels on a `score` question's scale. */
     maxScoreLevels: 10,
 };
+// ─── Provider kinds (T12713) ─────────────────────────────────────────────────
+/**
+ * Every supported decision-provider kind, recommended first.
+ *
+ * - `layahost` — the hosted provider at {@link LAYAHOST_BASE_URL}; the user
+ *   supplies only an API key.
+ * - `jev`      — any other Jev-compatible endpoint; the user supplies the URL.
+ */
+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',
+    maxQuestionsPerRequest: 32,
+    maxStateChars: 32_000,
+    reportsCost: 'usd',
+};
 // ─── Zod schemas ──────────────────────────────────────────────────────────────
 /** Zod schema for {@link DecisionQuestionType}. */
 export const decisionQuestionTypeSchema = z.enum(DECISION_QUESTION_TYPES);
@@ -129,6 +172,11 @@ export const decisionQuestionSchema = z.discriminatedUnion('type', [
  */
 export const decisionRequestSchema = z.object({
     model: z.string().min(1).optional(),
+    lang: z
+        .string()
+        .regex(/^[a-z]{2,3}(-[A-Za-z0-9]{2,8})?$/)
+        .optional(),
+    cache: z.boolean().optional(),
     state: decisionStateSchema,
     questions: z.record(z.string().min(1), decisionQuestionSchema).refine((questions) => {
         const count = Object.keys(questions).length;
@@ -175,10 +223,16 @@ export const decisionOutcomeSchema = z.object({
     requestId: z.string().min(1).optional(),
     latencyMs: z.number().nonnegative(),
     costUsd: z.number().nonnegative().optional(),
+    costMicros: z.number().int().nonnegative().optional(),
+    balanceMicros: z.number().int().optional(),
+    checkpoint: z.string().min(1).optional(),
     inputTokens: z.number().int().nonnegative().optional(),
 });
+/** Zod schema for {@link DecisionProviderKind}. */
+export const decisionProviderKindSchema = z.enum(DECISION_PROVIDER_KINDS);
 /** Zod schema for {@link DecisionProviderConfig}; `baseUrl` must be an absolute URL. */
 export const decisionProviderConfigSchema = z.object({
     baseUrl: z.url(),
+    provider: decisionProviderKindSchema.optional(),
 });
 //# sourceMappingURL=decide.js.map

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iFAAiF;AAEjF,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAEnF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC;;;;OAIG;IACH,aAAa,EAAE,MAAM;IACrB,kDAAkD;IAClD,YAAY,EAAE,CAAC;IACf,kDAAkD;IAClD,YAAY,EAAE,EAAE;IAChB,gEAAgE;IAChE,gBAAgB,EAAE,CAAC;IACnB,8DAA8D;IAC9D,cAAc,EAAE,CAAC;IACjB,8DAA8D;IAC9D,cAAc,EAAE,EAAE;CACV,CAAC;AAkKX,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,UAAU,EAAE,KAAK,CAAU,CAAC;AAKpE,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAE9D,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC;AAElD,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,wCAAwC,CAAC;AAEpF,sEAAsE;AACtE,MAAM,CAAC,MAAM,2BAA2B,GAAG,SAAS,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AAuIpD,4FAA4F;AAC5F,MAAM,CAAC,MAAM,wBAAwB,GAAiC;IACpE,IAAI,EAAE,iBAAiB;IACvB,sBAAsB,EAAE,EAAE;IAC1B,aAAa,EAAE,MAAM;IACrB,WAAW,EAAE,KAAK;CACnB,CAAC;AAqBF,iFAAiF;AAEjF,mDAAmD;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AAE1E,oDAAoD;AACpD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAE5E,mDAAmD;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAEhG,8DAA8D;AAC9D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;KACtE,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IAC9B,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACrF,IAAI,IAAI,GAAG,uBAAuB,CAAC,aAAa,EAAE,CAAC;QACjD,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,YAAY,IAAI,6BAA6B,uBAAuB,CAAC,aAAa,EAAE;SAC9F,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,mDAAmD;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvB,YAAY,EAAE,0BAA0B,CAAC,QAAQ,EAAE;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,YAAY,EAAE,0BAA0B,CAAC,QAAQ,EAAE;IACnD,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SACrC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,uBAAuB,CAAC,gBAAgB,EAAE;QAC5F,OAAO,EAAE,oCAAoC,uBAAuB,CAAC,gBAAgB,UAAU;KAChG,CAAC;CACL,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,YAAY,EAAE,0BAA0B,CAAC,QAAQ,EAAE;IACnD,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,uBAAuB,CAAC,cAAc,CAAC;SAC3C,GAAG,CAAC,uBAAuB,CAAC,cAAc,CAAC;CAC/C,CAAC,CAAC;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACjE,0BAA0B;IAC1B,4BAA4B;IAC5B,2BAA2B;CAC5B,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CAAC,kCAAkC,CAAC;SACzC,QAAQ,EAAE;IACb,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,mBAAmB;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC,MAAM,CACnE,CAAC,SAAS,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QAC5C,OAAO,CACL,KAAK,IAAI,uBAAuB,CAAC,YAAY;YAC7C,KAAK,IAAI,uBAAuB,CAAC,YAAY,CAC9C,CAAC;IACJ,CAAC,EACD;QACE,OAAO,EAAE,mBAAmB,uBAAuB,CAAC,YAAY,IAAI,uBAAuB,CAAC,YAAY,YAAY;KACrH,CACF;CACF,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,WAAW,EAAE,kBAAkB;IAC/B,UAAU,EAAE,kBAAkB;CAC/B,CAAC,CAAC;AAEH,mDAAmD;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC;IAC9D,UAAU,EAAE,kBAAkB;CAC/B,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,kBAAkB,CAAC;SACzB,GAAG,CAAC,uBAAuB,CAAC,cAAc,CAAC;SAC3C,GAAG,CAAC,uBAAuB,CAAC,cAAc,CAAC;IAC9C,UAAU,EAAE,kBAAkB;CAC/B,CAAC,CAAC;AAEH,iEAAiE;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC/D,wBAAwB;IACxB,0BAA0B;IAC1B,yBAAyB;CAC1B,CAAC,CAAC;AAEH,wFAAwF;AACxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,oBAAoB,CAAC;IAC1D,MAAM,EAAE,2BAA2B;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACrD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC;AAEH,mDAAmD;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AAE1E,wFAAwF;AACxF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;IAChB,QAAQ,EAAE,0BAA0B,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC"}

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,EAk7UpC,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

@@ -790,12 +790,21 @@ export const OPERATIONS = [
         gateway: 'query',
         domain: 'tasks',
         operation: 'history',
-        description: 'Show task work history (time tracked per task)',
+        description: 'Show task work history; with taskId, the task audit trail; with ranking, who changed its priority/severity/kind/depends and why (T12693)',
         tier: 1,
         idempotent: true,
         sessionRequired: false,
         requiredParams: [],
-        params: [],
+        params: [
+            { name: 'taskId', type: 'string', required: false, description: 'Task to show history for' },
+            { name: 'limit', type: 'number', required: false, description: 'Maximum entries' },
+            {
+                name: 'ranking',
+                type: 'boolean',
+                required: false,
+                description: 'Only ranking-input changes (actor, session, reason, before/after)',
+            },
+        ],
     },
     {
         gateway: 'query',
@@ -2995,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' },
+            },
         ],
     },
     {
@@ -3290,6 +3306,32 @@ export const OPERATIONS = [
         ],
         outputSchema: OUTPUT_CONTRACTS['tasks.assignee'],
     },
+    {
+        gateway: 'mutate',
+        domain: 'tasks',
+        operation: 'ranking.revert',
+        description: 'tasks.ranking.revert (mutate) — undo one recorded ranking change (priority/severity/kind/depends) as a new audited change (T12693, D11161)',
+        tier: 1,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: ['entryId'],
+        params: [
+            {
+                name: 'entryId',
+                type: 'string',
+                required: true,
+                description: 'ranking_changed audit row id (cleo history ranking <taskId>)',
+                cli: { positional: true },
+            },
+            { name: 'reason', type: 'string', required: false, description: 'Why it is reverted' },
+            {
+                name: 'force',
+                type: 'boolean',
+                required: false,
+                description: 'Revert even though a field changed again since',
+            },
+        ],
+    },
     {
         gateway: 'mutate',
         domain: 'tasks',
@@ -3628,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,
@@ -3641,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' },
+            },
         ],
     },
     {
@@ -3749,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',
@@ -3764,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)",
             },
         ],
     },
@@ -3773,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,
@@ -3785,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)",
+            },
         ],
     },
     {
@@ -4039,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)
@@ -6682,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',