comisai 1.0.45 → 1.0.46

package/node_modules/@comis/agent/dist/executor/degraded-reply-i18n.d.ts

@@ -1,26 +1,26 @@
 /**
  * degraded-reply-i18n — the en/he/ar/ru phrase table + tag-driven string
  * selectors for the deterministic degraded replies a failed turn shows the end
- * user (GEN-02).
+ * user.
  *
  * This is a THIN platform-strings catalog — NEVER agent prose. It mirrors the
- * LIVE `degraded-reply.ts` composition exactly (the design's documented entry
- * shape is stale): a context-exhausted base + a 3-key cause lead + a 2-variant
+ * LIVE `degraded-reply.ts` composition exactly: a context-exhausted base + a
+ * 3-key cause lead + a 2-variant
  * cap-knob advice (history vs default) + a 2-variant no-knob advice + the
  * output-starved annotation + the loop-detected reply.
  *
  * Invariants:
  *  - PURE: no I/O, no logging, no clock — same (lang, opts) → same string.
- *  - en byte-identical (I1): the `en` row IS today's English literals — the
+ *  - en byte-identical: the `en` row IS today's English literals — the
  *    single source from which `degraded-reply.ts` composes. No drift, no alias.
  *  - Fallback (never throws): an unknown language (or a missing entry) maps to
  *    the `en` row — `TABLE[normalizeKey(lang)] ?? TABLE.en`.
- *  - I5 (verbatim across languages): the knob path
+ *  - Verbatim across languages: the knob path
  *    (`contextEngine.budget.effectiveContextCap{Small,Nano}`), the
  *    `(0 = uncapped)` operator hint, the `(incident <traceId>)` ref, and the
  *    warning marker (U+26A0 U+FE0F) are interpolated VERBATIM — never translated
  *    — so the operator's remedy knob is correct in every language.
- *  - I2 (no Trojan-Source): NO phrase-table string carries a bidi control
+ *  - No Trojan-Source: NO phrase-table string carries a bidi control
  *    codepoint. RTL strings (he/ar) are authored with the technical tokens
  *    (`{knob}`, `{traceId}`) on clause boundaries and NO inline directional
  *    controls. This source NEVER contains a raw bidi glyph.
@@ -29,20 +29,20 @@
  */
 import type { ContextExhaustionCause } from "../context-engine/errors.js";
 /**
- * W4 (obs-llm-troubleshooting): small/nano classes name the EXACT cap knob the
+ * small/nano classes name the EXACT cap knob the
  * operator must raise; other classes get the generic advice (no class cap
  * applies). The SINGLE home for this map — `degraded-reply.ts` imports it back
- * (no copy, no alias; no-BC §2.9). Interpolated VERBATIM into every language (I5).
+ * (no copy, no alias). Interpolated VERBATIM into every language.
  */
 export declare const CAP_KNOB_BY_CLASS: Record<string, string>;
-/** The closed set of reply-language table keys (mirrors DET-02's ReplyLanguage). */
+/** The closed set of reply-language table keys (mirrors resolveReplyLanguage's ReplyLanguage). */
 export declare const LANG_KEYS: readonly ["en", "he", "ar", "ru"];
 export type LangKey = (typeof LANG_KEYS)[number];
 /**
  * One language's strings, mirroring the LIVE `degraded-reply.ts` composition.
- * Every value is a plain string (keeps the I2 walk simple). The two advice
+ * Every value is a plain string (keeps the bidi-scan walk simple). The two advice
  * templates carry a literal `{knob}` placeholder the selector interpolates with
- * the resolved `CAP_KNOB_BY_CLASS` value (VERBATIM, I5).
+ * the resolved `CAP_KNOB_BY_CLASS` value (VERBATIM).
  */
 export interface DegradedReplyStrings {
     /** Lead sentence for the context-exhausted reply. */
@@ -57,7 +57,7 @@ export interface DegradedReplyStrings {
      *  overflow, so "narrowing the ask" is meaningless — the remedy is the window /
      *  tool footprint / a larger model. NEVER suggests shortening the message. */
     capKnobAdviceFixedOverhead: string;
-    /** No-knob advice, default form (the historical generic advice). */
+    /** No-knob advice, default form (the generic advice when no class cap applies). */
     genericAdviceDefault: string;
     /** No-knob advice, oversized-history form. */
     genericAdviceHistory: string;
@@ -72,7 +72,7 @@ export interface DegradedReplyStrings {
 export declare const DEGRADED_REPLY_TABLE: Record<LangKey, DegradedReplyStrings>;
 /**
  * The output-starved annotation to APPEND to truncated partial text, in the
- * requested language (en fallback). Carries the warning marker verbatim (I5).
+ * requested language (en fallback). Carries the warning marker verbatim.
  */
 export declare function selectOutputStarvedAnnotation(lang: string): string;
 /** Opts for {@link selectContextExhaustedReply} — mirrors the live builder opts. */
@@ -85,7 +85,7 @@ export interface SelectContextExhaustedOpts {
  * The synthesized context-exhausted reply in the requested language (en
  * fallback). Composes via the SAME nested cause x knob branching as the live
  * builder: base + causeLead[cause] + advice + incidentRef. The knob value, the
- * `(0 = uncapped)` hint, and the incident ref are interpolated VERBATIM (I5).
+ * `(0 = uncapped)` hint, and the incident ref are interpolated VERBATIM.
  */
 export declare function selectContextExhaustedReply(lang: string, opts: SelectContextExhaustedOpts): string;
 /** Opts for {@link selectLoopDetectedReply}. */
@@ -94,6 +94,6 @@ export interface SelectLoopDetectedOpts {
 }
 /**
  * The honest loop-detected reply in the requested language (en fallback), with
- * the incident ref appended verbatim (I5).
+ * the incident ref appended verbatim.
  */
 export declare function selectLoopDetectedReply(lang: string, opts: SelectLoopDetectedOpts): string;

package/node_modules/@comis/agent/dist/executor/degraded-reply-i18n.js

@@ -2,26 +2,26 @@
 /**
  * degraded-reply-i18n — the en/he/ar/ru phrase table + tag-driven string
  * selectors for the deterministic degraded replies a failed turn shows the end
- * user (GEN-02).
+ * user.
  *
  * This is a THIN platform-strings catalog — NEVER agent prose. It mirrors the
- * LIVE `degraded-reply.ts` composition exactly (the design's documented entry
- * shape is stale): a context-exhausted base + a 3-key cause lead + a 2-variant
+ * LIVE `degraded-reply.ts` composition exactly: a context-exhausted base + a
+ * 3-key cause lead + a 2-variant
  * cap-knob advice (history vs default) + a 2-variant no-knob advice + the
  * output-starved annotation + the loop-detected reply.
  *
  * Invariants:
  *  - PURE: no I/O, no logging, no clock — same (lang, opts) → same string.
- *  - en byte-identical (I1): the `en` row IS today's English literals — the
+ *  - en byte-identical: the `en` row IS today's English literals — the
  *    single source from which `degraded-reply.ts` composes. No drift, no alias.
  *  - Fallback (never throws): an unknown language (or a missing entry) maps to
  *    the `en` row — `TABLE[normalizeKey(lang)] ?? TABLE.en`.
- *  - I5 (verbatim across languages): the knob path
+ *  - Verbatim across languages: the knob path
  *    (`contextEngine.budget.effectiveContextCap{Small,Nano}`), the
  *    `(0 = uncapped)` operator hint, the `(incident <traceId>)` ref, and the
  *    warning marker (U+26A0 U+FE0F) are interpolated VERBATIM — never translated
  *    — so the operator's remedy knob is correct in every language.
- *  - I2 (no Trojan-Source): NO phrase-table string carries a bidi control
+ *  - No Trojan-Source: NO phrase-table string carries a bidi control
  *    codepoint. RTL strings (he/ar) are authored with the technical tokens
  *    (`{knob}`, `{traceId}`) on clause boundaries and NO inline directional
  *    controls. This source NEVER contains a raw bidi glyph.
@@ -29,20 +29,20 @@
  * @module
  */
 /**
- * W4 (obs-llm-troubleshooting): small/nano classes name the EXACT cap knob the
+ * small/nano classes name the EXACT cap knob the
  * operator must raise; other classes get the generic advice (no class cap
  * applies). The SINGLE home for this map — `degraded-reply.ts` imports it back
- * (no copy, no alias; no-BC §2.9). Interpolated VERBATIM into every language (I5).
+ * (no copy, no alias). Interpolated VERBATIM into every language.
  */
 export const CAP_KNOB_BY_CLASS = {
     small: "contextEngine.budget.effectiveContextCapSmall",
     nano: "contextEngine.budget.effectiveContextCapNano",
 };
-/** The closed set of reply-language table keys (mirrors DET-02's ReplyLanguage). */
+/** The closed set of reply-language table keys (mirrors resolveReplyLanguage's ReplyLanguage). */
 export const LANG_KEYS = ["en", "he", "ar", "ru"];
 // ---------------------------------------------------------------------------
-// en — the single source of the English literals (I1 byte-identical). COPIED
-// verbatim from degraded-reply.ts. The "⚠️" below is the warning emoji
+// en — the single source of the English literals (the byte-identical contract):
+// the `degraded-reply.ts` builders compose from this row. The "⚠️" below is the warning emoji
 // (U+26A0 U+FE0F) — ALLOWED (not in the bidi set) and preserved across languages.
 // ---------------------------------------------------------------------------
 const EN = {
@@ -74,7 +74,7 @@ const EN = {
 // ---------------------------------------------------------------------------
 // he — Hebrew. Authored translations; technical tokens ({knob}/{traceId}) on
 // clause boundaries; the warning emoji + (0 = uncapped) verbatim. NO inline
-// bidi controls (I2).
+// bidi controls.
 // ---------------------------------------------------------------------------
 const HE = {
     contextExhaustedBase: "לא הצלחתי לעבד את הבקשה שלך — חלון ההקשר מוצה לפני שהמודל הספיק לרוץ. ",
@@ -97,7 +97,7 @@ const HE = {
 };
 // ---------------------------------------------------------------------------
 // ar — Arabic. Authored translations; technical tokens on clause boundaries;
-// warning emoji + (0 = uncapped) verbatim. NO inline bidi controls (I2).
+// warning emoji + (0 = uncapped) verbatim. NO inline bidi controls.
 // ---------------------------------------------------------------------------
 const AR = {
     contextExhaustedBase: "تعذّر عليّ معالجة طلبك — استُنفدت نافذة السياق قبل أن يتمكن النموذج من العمل. ",
@@ -150,7 +150,7 @@ export const DEGRADED_REPLY_TABLE = {
 };
 /**
  * Normalize a (possibly arbitrary) language tag to a closed table key. The
- * caller (DET-02 `resolveReplyLanguage`) already emits the closed en|he|ar|ru
+ * caller (`resolveReplyLanguage`) already emits the closed en|he|ar|ru
  * set, so this is a defensive second gate: lowercase + primary subtag; anything
  * outside the four supported languages falls back to "en". NEVER throws.
  */
@@ -173,13 +173,13 @@ function strings(lang) {
     // normalizeKey already collapses unknowns to "en"; the `?? en` is belt-and-suspenders.
     return DEGRADED_REPLY_TABLE[normalizeKey(lang)] ?? DEGRADED_REPLY_TABLE.en;
 }
-/** Build the `(incident <traceId>)` ref VERBATIM across languages (I5), or "". */
+/** Build the `(incident <traceId>)` ref VERBATIM across languages, or "". */
 function incidentRef(traceId) {
     return traceId !== undefined && traceId.length > 0 ? ` (incident ${traceId})` : "";
 }
 /**
  * The output-starved annotation to APPEND to truncated partial text, in the
- * requested language (en fallback). Carries the warning marker verbatim (I5).
+ * requested language (en fallback). Carries the warning marker verbatim.
  */
 export function selectOutputStarvedAnnotation(lang) {
     return strings(lang).outputStarvedAnnotation;
@@ -188,15 +188,15 @@ export function selectOutputStarvedAnnotation(lang) {
  * The synthesized context-exhausted reply in the requested language (en
  * fallback). Composes via the SAME nested cause x knob branching as the live
  * builder: base + causeLead[cause] + advice + incidentRef. The knob value, the
- * `(0 = uncapped)` hint, and the incident ref are interpolated VERBATIM (I5).
+ * `(0 = uncapped)` hint, and the incident ref are interpolated VERBATIM.
  */
 export function selectContextExhaustedReply(lang, opts) {
     const t = strings(lang);
     const cause = opts.cause ?? "aggregate";
     const knob = opts.capabilityClass !== undefined ? CAP_KNOB_BY_CLASS[opts.capabilityClass] : undefined;
-    // Issue-6: "narrowing the ask" only belongs when the ask/aggregate is the
+    // "narrowing the ask" only belongs when the ask/aggregate is the
     // problem — for an oversized history message it is the misleading clause.
-    // Root-cause fix (2026-06-22): for fixed_overhead_exceeds_window the message
+    // For fixed_overhead_exceeds_window the message
     // size is irrelevant entirely, so the advice points at the window / tool
     // footprint / a larger model — never "shorten your message" or "narrow the ask".
     let advice;
@@ -221,7 +221,7 @@ export function selectContextExhaustedReply(lang, opts) {
 }
 /**
  * The honest loop-detected reply in the requested language (en fallback), with
- * the incident ref appended verbatim (I5).
+ * the incident ref appended verbatim.
  */
 export function selectLoopDetectedReply(lang, opts) {
     return strings(lang).loopDetected + incidentRef(opts.traceId);

package/node_modules/@comis/agent/dist/executor/degraded-reply.d.ts

@@ -6,43 +6,43 @@
  * loop_detected).
  * Fail-closed: always returns a non-empty honest line even when partial text is empty.
  *
- * GEN-02 (Phase 181-03): each builder takes an optional resolved `language` tag
- * (en|he|ar|ru, DET-02) and DELEGATES the actual string selection to
+ * Each builder takes an optional resolved `language` tag
+ * (en|he|ar|ru) and DELEGATES the actual string selection to
  * `degraded-reply-i18n.ts` — the single source of the phrase strings. With no
- * `language` (or "en") the historical English reply is returned byte-identical
- * (I1): the i18n `en` row IS today's literals, so there is no duplicate and no
+ * `language` (or "en") the canonical English reply is returned byte-identical:
+ * the i18n `en` row IS today's literals, so there is no duplicate and no
  * drift. The knob path, the `(0 = uncapped)` hint, the incident ref, and the
- * warning marker stay verbatim across languages (I5).
+ * warning marker stay verbatim across languages.
  *
  * @module
  */
 import type { ContextExhaustionCause } from "../context-engine/errors.js";
 export { CAP_KNOB_BY_CLASS } from "./degraded-reply-i18n.js";
-/** Optional context for the synthesized context-exhausted reply (W4). */
+/** Optional context for the synthesized context-exhausted reply. */
 export interface ContextExhaustedReplyOpts {
     /** The model's capabilityClass — "small"/"nano" name the exact cap knob to raise. */
     capabilityClass?: string;
     /** The turn's traceId — appended as an incident ref so the operator (or an LLM
      *  agent) can run `comis explain <traceId>` directly from the chat message. */
     traceId?: string;
-    /** Issue-6: why the fit failed — branches the advice so it names the remedy
-     *  that actually applies. Omitted/aggregate → the historical reply. */
+    /** Why the fit failed — branches the advice so it names the remedy
+     *  that actually applies. Omitted/aggregate → the default reply. */
     cause?: ContextExhaustionCause;
-    /** GEN-02 (DET-02): the resolved reply language (en|he|ar|ru). Omitted/"en"
-     *  → the historical English reply byte-identical. */
+    /** The resolved reply language (en|he|ar|ru). Omitted/"en"
+     *  → the canonical English reply byte-identical. */
     language?: string;
 }
 /**
  * Returns the annotation string to APPEND for an output_starved turn.
  * Starts with "\n\n⚠️ " so appending to partial text is visually separated.
- * GEN-02: localized when `language` is a he/ar/ru tag; en byte-identical otherwise.
+ * Localized when `language` is a he/ar/ru tag; en byte-identical otherwise.
  */
 export declare function buildOutputStarvedAnnotation(language?: string): string;
 /**
  * Returns the synthesized honest reply to REPLACE result.response for a
  * context_exhausted turn (the model never ran; the prior content was either
- * the Phase-166 canned message or the operator-facing redirect). Still PURE —
- * same opts → same string. With no opts the historical English reply is
+ * a canned placeholder or the operator-facing redirect). Still PURE —
+ * same opts → same string. With no opts the canonical English reply is
  * returned byte-identical.
  */
 export declare function buildContextExhaustedReply(opts?: ContextExhaustedReplyOpts): string;
@@ -50,11 +50,11 @@ export declare function buildContextExhaustedReply(opts?: ContextExhaustedReplyO
  * Top-level dispatcher: returns the annotation (output_starved) or synthesized
  * reply (context_exhausted / loop_detected). Returns undefined for any other
  * endReason so that healthy turns are strict no-ops. Forwards the resolved
- * `language` tag (GEN-02) to each builder.
+ * `language` tag to each builder.
  */
 export declare function buildDegradedReply(endReason: string, opts?: ContextExhaustedReplyOpts): string | undefined;
 /**
- * Honest reply for a turn the loop-guard stopped (F-15): the model kept repeating
+ * Honest reply for a turn the loop-guard stopped: the model kept repeating
  * an action that made no progress (most often a tool that kept failing or was
  * blocked) and was halted before it could run to the makespan ceiling. Used as an
  * APPEND when partial text exists, or a REPLACE when the turn produced no usable

package/node_modules/@comis/agent/dist/executor/degraded-reply.js

@@ -7,25 +7,25 @@
  * loop_detected).
  * Fail-closed: always returns a non-empty honest line even when partial text is empty.
  *
- * GEN-02 (Phase 181-03): each builder takes an optional resolved `language` tag
- * (en|he|ar|ru, DET-02) and DELEGATES the actual string selection to
+ * Each builder takes an optional resolved `language` tag
+ * (en|he|ar|ru) and DELEGATES the actual string selection to
  * `degraded-reply-i18n.ts` — the single source of the phrase strings. With no
- * `language` (or "en") the historical English reply is returned byte-identical
- * (I1): the i18n `en` row IS today's literals, so there is no duplicate and no
+ * `language` (or "en") the canonical English reply is returned byte-identical:
+ * the i18n `en` row IS today's literals, so there is no duplicate and no
  * drift. The knob path, the `(0 = uncapped)` hint, the incident ref, and the
- * warning marker stay verbatim across languages (I5).
+ * warning marker stay verbatim across languages.
  *
  * @module
  */
 import { selectOutputStarvedAnnotation, selectContextExhaustedReply, selectLoopDetectedReply, } from "./degraded-reply-i18n.js";
-// CAP_KNOB_BY_CLASS now lives in degraded-reply-i18n.ts (the single home — it is
-// interpolated into every language's advice). Re-exported here for the historical
-// import path; no copy, no alias (no-BC §2.9).
+// CAP_KNOB_BY_CLASS lives in degraded-reply-i18n.ts (the single home — it is
+// interpolated into every language's advice). Re-exported here for the existing
+// import path; no copy, no alias.
 export { CAP_KNOB_BY_CLASS } from "./degraded-reply-i18n.js";
 /**
  * Returns the annotation string to APPEND for an output_starved turn.
  * Starts with "\n\n⚠️ " so appending to partial text is visually separated.
- * GEN-02: localized when `language` is a he/ar/ru tag; en byte-identical otherwise.
+ * Localized when `language` is a he/ar/ru tag; en byte-identical otherwise.
  */
 export function buildOutputStarvedAnnotation(language) {
     return selectOutputStarvedAnnotation(language ?? "en");
@@ -33,8 +33,8 @@ export function buildOutputStarvedAnnotation(language) {
 /**
  * Returns the synthesized honest reply to REPLACE result.response for a
  * context_exhausted turn (the model never ran; the prior content was either
- * the Phase-166 canned message or the operator-facing redirect). Still PURE —
- * same opts → same string. With no opts the historical English reply is
+ * a canned placeholder or the operator-facing redirect). Still PURE —
+ * same opts → same string. With no opts the canonical English reply is
  * returned byte-identical.
  */
 export function buildContextExhaustedReply(opts) {
@@ -48,7 +48,7 @@ export function buildContextExhaustedReply(opts) {
  * Top-level dispatcher: returns the annotation (output_starved) or synthesized
  * reply (context_exhausted / loop_detected). Returns undefined for any other
  * endReason so that healthy turns are strict no-ops. Forwards the resolved
- * `language` tag (GEN-02) to each builder.
+ * `language` tag to each builder.
  */
 export function buildDegradedReply(endReason, opts) {
     if (endReason === "output_starved")
@@ -60,7 +60,7 @@ export function buildDegradedReply(endReason, opts) {
     return undefined;
 }
 /**
- * Honest reply for a turn the loop-guard stopped (F-15): the model kept repeating
+ * Honest reply for a turn the loop-guard stopped: the model kept repeating
  * an action that made no progress (most often a tool that kept failing or was
  * blocked) and was halted before it could run to the makespan ceiling. Used as an
  * APPEND when partial text exists, or a REPLACE when the turn produced no usable

package/node_modules/@comis/agent/dist/executor/error-classifier.d.ts

@@ -1,7 +1,7 @@
 /**
  * Classifies raw API/provider errors into user-friendly categories.
  *
- * requires that raw error internals (API keys, URLs, stack traces)
+ * Raw error internals (API keys, URLs, stack traces) must
  * never reach the user. This module bridges the gap by parsing known error
  * patterns and returning safe, actionable messages while keeping
  * operator-level detail in the logs.
@@ -59,8 +59,8 @@ export interface ClassifiedError {
     userMessage: string;
     /** Whether the user should reasonably retry. */
     retryable: boolean;
-    /** Operator-facing detail: binding knob + numbers (I7). Rides WARN
-     *  logs/explain — NEVER the user reply (T-177-13). */
+    /** Operator-facing detail: binding knob + numbers. Rides WARN
+     *  logs/explain — NEVER the user reply. */
     hint?: string;
 }
 /**
@@ -71,12 +71,11 @@ export interface ClassifiedError {
  */
 export declare function classifyError(error: unknown): ClassifiedError;
 /**
- * The effective-timeout binding provenance a classify consumer threads in
- * (LAT-01): which resolution level bound the timeout (177-02 `source`), whose
+ * The effective-timeout binding provenance a classify consumer threads
+ * in: which resolution level bound the timeout (`source`), whose
  * config owns the knob, and the configured numbers. Every field optional —
  * absent fields degrade gracefully to placeholders / the error's own numbers,
- * so legacy callers and parallel-plan type drift (e.g. a not-yet-landed
- * `stallCeilingMultiplier` on EffectiveTimeout) never break the call shape.
+ * so callers that pass no provenance never break the call shape.
  */
 export interface PromptTimeoutBinding {
     source?: TimeoutSource;
@@ -91,17 +90,17 @@ export interface PromptTimeoutBinding {
  * Separated because PromptTimeoutError is identified by instanceof,
  * not by message content.
  *
- * LAT-01 (Phase 177): renders the operator-facing `hint` — the BINDING knob
+ * Renders the operator-facing `hint` — the BINDING knob
  * (via the timeout-knob table), the configured value, the elapsed time, and
  * WHICH limit fired (stall / makespan / whole-turn retry). The `userMessage`
  * stays generic/user-safe: config-key detail rides logs + obs.explain only,
- * never the user reply (T-177-13). A `graph_constant` binding renders honest
- * prose instead of a fake `agents.*` key (D-11).
+ * never the user reply. A `graph_constant` binding renders honest
+ * prose instead of a fake `agents.*` key.
  *
  * @param error - The PromptTimeoutError (carries `limit` + the configured
- *                numbers from 177-01).
- * @param binding - The effective-timeout binding provenance (177-02); absent
- *                  ⇒ legacy caller ⇒ the placeholder agent knob (graceful).
+ *                numbers).
+ * @param binding - The effective-timeout binding provenance; absent
+ *                  ⇒ no provenance from the caller ⇒ the placeholder agent knob (graceful).
  * @param elapsedMs - Wall-clock elapsed since execution start, when known.
  */
 export declare function classifyPromptTimeout(error: PromptTimeoutError, binding?: PromptTimeoutBinding, elapsedMs?: number): ClassifiedError;

package/node_modules/@comis/agent/dist/executor/error-classifier.js

@@ -2,7 +2,7 @@
 /**
  * Classifies raw API/provider errors into user-friendly categories.
  *
- * requires that raw error internals (API keys, URLs, stack traces)
+ * Raw error internals (API keys, URLs, stack traces) must
  * never reach the user. This module bridges the gap by parsing known error
  * patterns and returning safe, actionable messages while keeping
  * operator-level detail in the logs.
@@ -68,7 +68,7 @@ const ERROR_PATTERNS = [
     // errors keep their current classification — the optional `(?:\w+\.)?`
     // accepts Go's standard `Go struct field <StructTypeName>.<path>` form
     // (e.g. `ChatRequest.tools.function.parameters...`) alongside the
-    // empty-type-name variant from ollama#10164 (175-REVIEW WR-02).
+    // empty-type-name variant from ollama#10164.
     // Retryable=true because the runner performs exactly one
     // strip-pattern/format-and-retry per session.
     {
@@ -94,11 +94,11 @@ const ERROR_PATTERNS = [
     // "REFUSED" that the /refus/ content-filter pattern would otherwise steal
     // (mislabelling a network outage as a "content restriction"), and BEFORE
     // empty_response because the silent-failure handler wraps a connection error
-    // as "…produced empty response after retry … — <providerError>" (F-17).
+    // as "…produced empty response after retry … — <providerError>".
     // The `…|error` arm catches the OpenAI-compat SDK's APIConnectionError, whose
-    // message is the BARE phrase "Connection error." (no errno token) — the live
-    // 30-UC UC-30 provider-down case (Ollama unreachable): without it the wrapper
-    // fell through to empty_response and the user saw "a tool call returned no
+    // message is the BARE phrase "Connection error." (no errno token) — the
+    // provider-down case (Ollama unreachable): without it the wrapper
+    // falls through to empty_response and the user sees "a tool call returned no
     // output" for a network outage. Transient → retryable.
     {
         test: /ECONNREFUSED|ECONNRESET|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|EPIPE|socket hang ?up|fetch failed|getaddrinfo|network error|connect(?:ion)?[ _](?:refused|reset|timed out|failure|error)/i,
@@ -111,7 +111,7 @@ const ERROR_PATTERNS = [
     // because the silent-failure handler wraps it as "…produced empty response
     // after retry … — 404 {…not_found_error… is not available…}", which would
     // otherwise be misreported to the user as "a tool call returned no output"
-    // (F-17 — live-found 2026-06-13 via claude-fable-5 → 404 "Claude Fable 5 is
+    // (e.g. claude-fable-5 → 404 "Claude Fable 5 is
     // not available. Please use Opus 4.8."). Deterministic (same model keeps
     // 404-ing) → not retryable. Scoped to model/not_found semantics so it never
     // steals the OpenAI reasoning_item "not found" case (signed-replay, tested
@@ -176,17 +176,17 @@ export function classifyError(error) {
  * Separated because PromptTimeoutError is identified by instanceof,
  * not by message content.
  *
- * LAT-01 (Phase 177): renders the operator-facing `hint` — the BINDING knob
+ * Renders the operator-facing `hint` — the BINDING knob
  * (via the timeout-knob table), the configured value, the elapsed time, and
  * WHICH limit fired (stall / makespan / whole-turn retry). The `userMessage`
  * stays generic/user-safe: config-key detail rides logs + obs.explain only,
- * never the user reply (T-177-13). A `graph_constant` binding renders honest
- * prose instead of a fake `agents.*` key (D-11).
+ * never the user reply. A `graph_constant` binding renders honest
+ * prose instead of a fake `agents.*` key.
  *
  * @param error - The PromptTimeoutError (carries `limit` + the configured
- *                numbers from 177-01).
- * @param binding - The effective-timeout binding provenance (177-02); absent
- *                  ⇒ legacy caller ⇒ the placeholder agent knob (graceful).
+ *                numbers).
+ * @param binding - The effective-timeout binding provenance; absent
+ *                  ⇒ no provenance from the caller ⇒ the placeholder agent knob (graceful).
  * @param elapsedMs - Wall-clock elapsed since execution start, when known.
  */
 export function classifyPromptTimeout(error, binding, elapsedMs) {
@@ -205,14 +205,14 @@ export function classifyPromptTimeout(error, binding, elapsedMs) {
             `stall budget ${String(error.stallBudgetMs ?? error.timeoutMs)}ms exceeded${elapsed} with no stream/tool activity` +
                 (binding?.source === "graph_constant"
                     ? // Honest prose for a non-knob — never a raise-suggestion that names
-                        // a config key the operator cannot set (D-11).
+                        // a config key the operator cannot set.
                         ` — ${knob}`
                     : ` — raise ${knob} (currently ${String(binding?.promptTimeoutMs ?? error.timeoutMs)});` +
                         ` local prefill on consumer hardware can exceed it`);
     }
     else {
         // limit undefined ⇒ the non-resettable whole-turn path (retry/fallback
-        // prompts keep retryPromptTimeoutMs semantics — research Open Q2; never
+        // prompts keep retryPromptTimeoutMs semantics; never
         // present it as a stall-budget kill).
         hint =
             `whole-turn retry timeout ${String(error.timeoutMs)}ms exceeded${elapsed}` +

package/node_modules/@comis/agent/dist/executor/executor-context-engine-setup.d.ts

@@ -37,29 +37,29 @@ export interface ContextEngineSetupDeps {
     oauthManager?: OAuthTokenManager;
     /** Wall-clock + monotonic time reads. */
     clock: import("@comis/core").ClockPort;
-    /** Optional LCD context store (Phase 128 dag-mode assembly). Threaded into
+    /** Optional LCD context store (dag-mode assembly). Threaded into
      *  createContextEngine's deps alongside `conversationId: formattedKey` so the
      *  dag branch returns the LCD assembler (reads what the afterTurn ingest
      *  writes). TYPE-only core port (the agent↛memory cut); absent ⇒ the dag
      *  branch falls through to the pipeline. */
     contextStore?: import("@comis/core").ContextStorePort;
-    /** R1 (132-05): the daemon-owned per-tenant summarizer spend+breaker. When
+    /** The daemon-owned per-tenant summarizer spend+breaker. When
      *  present, `getSummarizerDeps` wraps the leaf summarizer seam with
      *  `gate(tenantId, inner)` so an open breaker / over-cap tenant BYPASSES the LLM
      *  → the leaf/condense ladder floors to truncation-only (no turn failure).
      *  ONE daemon-owned instance (per-tenant aggregate across sessions/agents);
      *  absent ⇒ the raw seam (non-daemon callers / tests). */
     summarizerSpendBreaker?: SummarizerSpendBreaker;
-    /** INT-W1: the Phase-176 boot-probe served window PAIRED with the
+    /** The boot-probe served window PAIRED with the
      *  `providers.entries` key it was probed from (= PiExecutorDeps.
      *  servedContextWindow, auto-present on the frozenDeps this subset is built
      *  from). Consumed by `resolveCompactionModelChain` to provider-gate the
      *  served bound for a compaction OVERRIDE model (`servedContextWindow.
-     *  providerKey === compactionResolution.provider` — WR-02 config-key space);
-     *  the PRIMARY summarizer's served bound instead reuses the executor
+     *  providerKey === compactionResolution.provider` — compared in config-key
+     *  space); the PRIMARY summarizer's served bound instead reuses the executor
      *  reconcile's already-gated `windowProvenance.served`. Absent ⇒ no served
      *  truth (non-Ollama provider or probe off/failed) — configured windows
-     *  govern, byte-identical pre-INT-W1. */
+     *  govern. */
     servedContextWindow?: {
         providerKey: string;
         window: number;
@@ -71,17 +71,17 @@ export interface ContextEngineSetupParams {
     deps: ContextEngineSetupDeps;
     formattedKey: string;
     sessionKey: string;
-    /** R4 (132-03): the tenant for the dag assembler's LCD read scope (the SAME
+    /** The tenant for the dag assembler's LCD read scope (the SAME
      *  source executor-post-execution uses for the ingest scope:
      *  `deps.tenantId ?? sessionKey.tenantId`). Threaded onto ContextEngineDeps so
-     *  the assembler builds an agent + tenant scoped read (WR-02). */
+     *  the assembler builds an agent + tenant scoped read. */
     tenantId: string;
-    /** DAG-CRIT-1 (WR-02): the turn's agentId — the positional execute() arg
+    /** The turn's agentId — the positional execute() arg
      *  (`agentId ?? "default"`, the SAME `effectiveAgentId` expression
      *  executor-post-execution uses for the LCD ingest scope), supplied by the
      *  caller and NOT read from deps. On the executeAgent path the turn agentId is
      *  set on the ALS RequestContext, never onto frozenDeps, so `deps.agentId` is
-     *  undefined and the assembler used to fail closed (recalled 0 history). Threading
+     *  undefined and the assembler would fail closed (recall 0 history). Threading
      *  it here makes the dag READ scope == the ingest WRITE scope so the assembler
      *  builds a non-undefined readScope. `deps.agentId` stays the fallback for
      *  non-executeAgent callers. */
@@ -118,9 +118,9 @@ export interface ContextEngineSetupParams {
     };
     /** Getter for cached system tokens estimate */
     getCachedSystemTokensEstimate: () => number;
-    /** I1 / WR-01: getter for the cached WHOLE fresh-tail preamble token estimate (a
+    /** Getter for the cached WHOLE fresh-tail preamble token estimate (a
      *  SEPARATE budget subtrahend — the entire dynamicPreamble + inlineMemory blob, NOT
-     *  just recall; never folded into S). See token-budget.ts WR-01. */
+     *  just recall; never folded into the system-tokens estimate). See token-budget.ts. */
     getCachedFreshTailPreambleTokens: () => number;
     /** Getter for current token anchor */
     getTokenAnchor: () => TokenAnchor | null;
@@ -128,25 +128,25 @@ export interface ContextEngineSetupParams {
     onAnchorReset: () => void;
     /** Current discovery tracker (if active) */
     currentDiscoveryTracker?: DiscoveryTracker;
-    /** C1 (Phase 165): the resolved ModelProfile for the current turn.
+    /** The resolved ModelProfile for the current turn.
      *  Absent ⇒ lcd-assembler applies the fail-closed nano cap + WARN.
      *  Pass params.modelProfile (already in scope at the pi-executor call site). */
     modelProfile?: import("./model-profile.js").ModelProfile;
-    /** KNOB-02 (Phase 176): served/capability window provenance built at the
+    /** Served/capability window provenance built at the
      *  pi-executor reconcile — threaded onto ContextEngineDeps so the
      *  lcd-assembler's computeTokenBudgetForProfile reports the TRUE configured
-     *  window when the served window binds. Absent ⇒ pre-KNOB-02 raw reporting. */
+     *  window when the served window binds. Absent ⇒ raw reporting. */
     windowProvenance?: import("../context-engine/types.js").WindowProvenance;
-    /** Phase 166 T-S4: security-pin markers sourced from pi-executor's deps.canaryToken.
+    /** Security-pin markers sourced from pi-executor's deps.canaryToken.
      *  Threaded into ContextEngineDeps so the dag eviction never drops security context. */
     securityPinMarkers?: import("../context-engine/security-context-pinner.js").SecurityPinMarkers;
-    /** Phase 166: callback invoked when assembled input tokens are measured (Plan 04 uses this). */
+    /** Callback invoked when assembled input tokens are measured. */
     onAssembledInputTokens?: (tokens: number) => void;
-    /** Phase 166: callback invoked when the effective window is known (Plan 04 uses this). */
+    /** Callback invoked when the effective window is known. */
     onEffectiveWindow?: (windowTokens: number) => void;
-    /** Phase 166: callback invoked when thinking-effort governor down-shifts thinkingLevel. */
+    /** Callback invoked when thinking-effort governor down-shifts thinkingLevel. */
     onThinkingDownshifted?: (level: string) => void;
-    /** Phase 166: getter returning the current thinking level for this dispatch. */
+    /** Getter returning the current thinking level for this dispatch. */
     getThinkingLevel?: () => string | undefined;
 }
 /** Result of context engine setup. */
@@ -164,14 +164,14 @@ export interface ContextEngineSetupResult {
         signatureScrubs: number;
         signatureScrubsToolCallsAffected: number;
     };
-    /** Phase 129 (C1): the leaf-summarizer deps getter the afterTurn trigger
+    /** The leaf-summarizer deps getter the afterTurn trigger
      *  consumes. Threaded into PostExecutionParams.deps.getSummarizerDeps at the
      *  pi-executor call site so the leaf pass fires live over threshold. Resolves
      *  the model fresh per call (honors mid-session model cycling) UNLESS a
      *  `modelSnapshot` is supplied — in which case the chain uses it verbatim
-     *  instead of reading `session.agent.state.model`. The DEFERRED (C4) compaction
+     *  instead of reading `session.agent.state.model`. The DEFERRED compaction
      *  path passes a snapshot captured BEFORE `session.dispose()` so a detached pass
-     *  never re-reads a torn-down session (WR-04). */
+     *  never re-reads a torn-down session. */
     getSummarizerDeps: (modelSnapshot?: CompactionModelSnapshot) => LeafSummarizerDeps;
 }
 /**