@cleocode/contracts 2026.9.21 → 2026.9.23

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,93 @@ 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. */
+    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";
+/** layahost's routing model, the default for a layahost connection. */
+export declare const LAYAHOST_DEFAULT_MODEL = "laya-auto";
 /** 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 +336,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 +417,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,26 @@ 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';
+/** layahost's routing model, the default for a layahost connection. */
+export const LAYAHOST_DEFAULT_MODEL = 'laya-auto';
+/** 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 +149,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 +200,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;AA8JX,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,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC;AAyClD,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,EAi7UpC,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,EAu9UpC,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',
@@ -3290,6 +3299,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',
@@ -8223,6 +8258,7 @@ export const OPERATIONS = [
                 required: false,
                 enum: DOCS_LIFECYCLE_STATUSES,
                 description: 'Override the new lifecycle status. Defaults to "draft" on every update. ' +
+                    'Alone (no file or content) it changes only the lifecycle status. ' +
                     `Valid: ${DOCS_LIFECYCLE_STATUSES.join('|')}.`,
             },
             {