@mcoda/shared 0.1.129 → 0.1.130

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from "./qa/QaTechStack.js";
 export * from "./metadata/CommandMetadata.js";
 export * from "./llm/LocalRunnerConfig.js";
 export * from "./llm/GenerativeOperation.js";
+export * from "./llm/CodexReasoningEffort.js";
 export * from "./mswarm/GenericJobContract.js";
 export * from "./mswarm/CapabilityContract.js";
 export * from "./mswarm/ArtifactSandboxContract.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,wBAAwB,CAAC;AACvC,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,mBAAmB,GACpB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,wBAAwB,CAAC;AACvC,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,mBAAmB,GACpB,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -8,6 +8,7 @@ export * from "./qa/QaTechStack.js";
 export * from "./metadata/CommandMetadata.js";
 export * from "./llm/LocalRunnerConfig.js";
 export * from "./llm/GenerativeOperation.js";
+export * from "./llm/CodexReasoningEffort.js";
 export * from "./mswarm/GenericJobContract.js";
 export * from "./mswarm/CapabilityContract.js";
 export * from "./mswarm/ArtifactSandboxContract.js";

package/dist/llm/CodexReasoningEffort.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Reasoning efforts codex-cli accepts for `model_reasoning_effort`.
+ *
+ * Ordered weakest to strongest. The order is load-bearing: callers that need to
+ * cap an effort at a model's ceiling compare ranks rather than enumerate the
+ * values above it.
+ *
+ * This mirrors codex-cli's own ReasoningEffort enum
+ * (Minimal|Low|Medium|High|XHigh|Max|Ultra). Verified against codex-cli 0.147.0:
+ * `codex exec -m gpt-5.6-sol -c model_reasoning_effort=ultra` reports
+ * `reasoning effort: ultra` in the session header and completes normally, and
+ * a value outside the enum is rejected upstream with
+ * "[reasoning.effort] [invalid_enum_value]".
+ */
+export declare const CODEX_REASONING_EFFORTS: readonly ["minimal", "low", "medium", "high", "xhigh", "max", "ultra"];
+export type CodexReasoningEffort = (typeof CODEX_REASONING_EFFORTS)[number];
+export declare const isCodexReasoningEffort: (value: string) => value is CodexReasoningEffort;
+/** Returns the canonical effort, or undefined when the value is not one codex accepts. */
+export declare const normalizeCodexReasoningEffort: (raw: string | undefined) => CodexReasoningEffort | undefined;
+/** Position in CODEX_REASONING_EFFORTS; higher means more reasoning. */
+export declare const codexReasoningEffortRank: (effort: CodexReasoningEffort) => number;
+//# sourceMappingURL=CodexReasoningEffort.d.ts.map

package/dist/llm/CodexReasoningEffort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodexReasoningEffort.d.ts","sourceRoot":"","sources":["../../src/llm/CodexReasoningEffort.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,wEAQ1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,KAAG,KAAK,IAAI,oBACA,CAAC;AAEjE,0FAA0F;AAC1F,eAAO,MAAM,6BAA6B,GACxC,KAAK,MAAM,GAAG,SAAS,KACtB,oBAAoB,GAAG,SAKzB,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,GAAI,QAAQ,oBAAoB,KAAG,MAC/B,CAAC"}

package/dist/llm/CodexReasoningEffort.js

@@ -0,0 +1,35 @@
+/**
+ * Reasoning efforts codex-cli accepts for `model_reasoning_effort`.
+ *
+ * Ordered weakest to strongest. The order is load-bearing: callers that need to
+ * cap an effort at a model's ceiling compare ranks rather than enumerate the
+ * values above it.
+ *
+ * This mirrors codex-cli's own ReasoningEffort enum
+ * (Minimal|Low|Medium|High|XHigh|Max|Ultra). Verified against codex-cli 0.147.0:
+ * `codex exec -m gpt-5.6-sol -c model_reasoning_effort=ultra` reports
+ * `reasoning effort: ultra` in the session header and completes normally, and
+ * a value outside the enum is rejected upstream with
+ * "[reasoning.effort] [invalid_enum_value]".
+ */
+export const CODEX_REASONING_EFFORTS = [
+    "minimal",
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "max",
+    "ultra",
+];
+export const isCodexReasoningEffort = (value) => CODEX_REASONING_EFFORTS.includes(value);
+/** Returns the canonical effort, or undefined when the value is not one codex accepts. */
+export const normalizeCodexReasoningEffort = (raw) => {
+    if (typeof raw !== "string")
+        return undefined;
+    const normalized = raw.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    return isCodexReasoningEffort(normalized) ? normalized : undefined;
+};
+/** Position in CODEX_REASONING_EFFORTS; higher means more reasoning. */
+export const codexReasoningEffortRank = (effort) => CODEX_REASONING_EFFORTS.indexOf(effort);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcoda/shared",
-  "version": "0.1.129",
+  "version": "0.1.130",
   "description": "Shared utilities and schemas for mcoda.",
   "type": "module",
   "main": "dist/index.js",