@owlmeans/llm-common 0.1.18-rc.35 → 0.1.18-rc.37

package/README.md

@@ -20,7 +20,7 @@ extends these; `@owlmeans/llm` implements against them.
 ## Installation
 
 ```bash
-bun add @owlmeans/llm-common@^0.1.18-rc.35
+bun add @owlmeans/llm-common@^0.1.18-rc.37
 ```
 
 ## Usage
@@ -96,7 +96,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.36
+npx @owlmeans/agent-skills@^0.1.18-rc.41
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/llm-common",
-  "version": "0.1.18-rc.35",
-  "generatedAt": "2026-09-22T22:24:39.580Z",
+  "version": "0.1.18-rc.37",
+  "generatedAt": "2026-09-28T02:06:37.884Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/llm-common/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: llm-common
-description: How to use @owlmeans/llm-common — runtime-free serializable contracts for LLM inference and execution (ModelProvider, ExecutionEffort/Level, ModelPolicy, PromptPolicy, SkillDefinition, ExecutionState, spectator records, NullCapture, LlmFileProvider). Auto-invoked when importing those contracts or extending them for a domain.
+description: How to use @owlmeans/llm-common — runtime-free serializable contracts for LLM inference and execution (ModelProvider, ExecutionEffort/Level, ModelPolicy, PromptPolicy, SkillDefinition, ExecutionState and its cumulative-results view, PromptBlock, spectator records, NullCapture, LlmFileProvider). Auto-invoked when importing those contracts or extending them for a domain.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/llm-common
 
 **Layer:** Core
-**Install:** `"@owlmeans/llm-common": "^0.1.18-rc.35"` in `dependencies`
+**Install:** `"@owlmeans/llm-common": "^0.1.18-rc.37"` in `dependencies`
 
 The contracts half of the LLM stack. **No `@langchain/*` runtime dependency** — importable
 from a browser bundle, a queue worker, or any package that must not pull an inference SDK.
@@ -22,15 +22,18 @@ The dependency direction is one-way: a domain contracts package extends these;
 | `ModelProvider` | `OpenAI` · `Anthropic` · `Compatible`. Each value is an `LlmPlugin.type` in `@owlmeans/llm`. |
 | `ExecutionLevel` | `Project` → `Task` → `Helper`. Refinement is downward only. |
 | `ExecutionEffort` | `Economy` · `Standard` · `High` · `Max` — the single "how hard should this run" axis. |
+| `ModelEffort` · `MODEL_EFFORT_ORDER` | The PROVIDER's effort value (`none` … `max`) sent as OpenAI `reasoning.effort` / Anthropic `output_config.effort`; `ModelConfigPatch.effort`. Not `ExecutionEffort`, which only sizes budgets. Which levels a model accepts is the `llm` plugins' table. |
 | `StructuredMode` | `Native` (provider JSON-schema mode) vs `Tool` (forced tool call). |
 | `SpectatorContentType`, `SPECTATOR_GENERAL` | Observability record enums/defaults. |
 | `ModelRole` | Open `string` — declare your own enum, its values stay assignable. |
 | `ModelConfigPatch` / `ModelConfigOverride` | The JSON-safe config subset; never credentials. Carries the model-capability fields (`contextWindow`, `maxOutput`, `combinedWindow`) alongside the budget ones — see the `llm` skill for what each means. |
 | `ModelPolicy` | `{ effort, roleOverrides?, modelOverrides?, utilityRole? }` — inherited by every refinement. |
 | `UTILITY_ROLE` | `'utility'` — the conventional cheap tier for side calls (a relevance pick, a classification). `ModelPolicy.utilityRole` points it at another alias; `ExecutionService.utility` resolves it. |
-| `ExecutionState` / `TaskExecutionState` | The persistable core (`level`/`purpose`/`policy`, plus `phase`/`completed`/`cursor`/`data`). |
+| `ExecutionState` / `TaskExecutionState` | The persistable core (`level`/`purpose`/`policy`, optional `prompt`/`inquiry`/`results`, plus `phase`/`completed`/`cursor`/`data`). |
 | `LlmPurpose` | `{ type?, dedication? }` — metadata carried on every model call. |
-| `PromptBlock`, `PROMPT_BLOCK_ORDER`, `DEFAULT_SKILL_ORDER` | The ordered sections of a composed system prompt — the order IS the cache key. |
+| `PromptBlock`, `PROMPT_BLOCK_ORDER`, `DEFAULT_SKILL_ORDER` | The ordered sections of a composed system prompt — `Role`, `Skills`, `Packages`, `Results`, `Context`; the order IS the cache key. |
+| `CumulativeResults`, `CumulativeResultsSection` | A pipeline step's view of what earlier steps produced: `step`, rendered `sections` (oldest first), `omitted` step names, `chars`, and a `digest` that is never rendered. |
+| `renderCumulativeResults(view)` · `CUMULATIVE_RESULTS_PREAMBLE` · `CUMULATIVE_RESULTS_OMITTED_LEAD`/`_TAIL` | The view as prompt text: the fixed rules, the sections, the "not listed for space" line — or `''` for no view. |
 | `SkillDefinition` | One named block of reusable prompt knowledge. `body` must be a pure constant. |
 | `PromptPolicy` | `{ role?, skills?, cacheSystem?, cacheTtl? }` — carried on `ExecutionState`, merged downward. |
 | `CacheTtl`, `CacheUsage` | `'5m' \| '1h'`; normalized prompt-cache accounting. |
@@ -54,6 +57,22 @@ LlmFileProvider`); implementing it from scratch means all four:
 Resolving the project root is deliberately NOT part of the contract, and an implementation must not
 narrow an inherited signature — that is what stops a rich helper from satisfying this one.
 
+## `ExecutionState.results` — the cumulative-results view
+
+What the earlier steps of the pipeline an execution works inside produced, cut by `@owlmeans/agent`'s
+`cumulativeResultsPlugin` for ONE step. It is state, not a collaborator — plain rendered text, so a
+snapshot and a restore compose the same prompt — and it is inherited down the execution chain like
+any state field, but REPLACED (`ExecutionService.withResults`), never merged, when another step is
+handed its own view.
+
+`renderCumulativeResults` is pure: the same view renders the same bytes, an absent or empty view
+renders NOTHING (never a heading over an empty list, which a model reads as "nothing was produced"),
+and the digest never reaches a prompt. `CUMULATIVE_RESULTS_PREAMBLE` is written for the weakest model
+a pipeline may run on — use the names verbatim, import only from the listed specifier, never declare
+a listed thing again, a missing thing does not exist yet unless the list says it left something out,
+and a source file shown in the conversation is NEWER than the list and wins. Change its wording only
+deliberately: it opens a block that recurs on every call of a step.
+
 ## Extension rules
 
 Open types are open **on purpose** — extend, do not fork:
@@ -97,6 +116,13 @@ instances, credentials, file handles, callbacks, `ModelConfig` (it carries `secr
 Nothing at runtime. `@langchain/core` is a **dev** dependency, for the `UsageMetadata` type
 on a spectator message only.
 
+## Testing
+
+Category A. `bun test ./tests` (the package's `test` script, so the root run includes it):
+`inquiry.spec.ts` for the answer helpers, `results.spec.ts` for the block order and the rendered view.
+
 ## Related
 
 - [[llm]] — the runtime that implements these contracts
+- [[llm-prompt-caching]] — why `Results` sits where it does in the block order
+- [[agent]] — `cumulativeResultsPlugin`, which cuts the view

package/build/consts.d.ts

@@ -45,6 +45,23 @@ export declare enum ExecutionEffort {
     High = "high",
     Max = "max"
 }
+/**
+ * The PROVIDER's own effort knob — OpenAI `reasoning.effort`, Anthropic
+ * `output_config.effort`. Not {@link ExecutionEffort}: that is this package's tier, which
+ * sizes token budgets; this is a value sent on the wire. Which levels a model accepts is a
+ * provider-plugin fact in `@owlmeans/llm`.
+ */
+export declare enum ModelEffort {
+    None = "none",
+    Minimal = "minimal",
+    Low = "low",
+    Medium = "medium",
+    High = "high",
+    XHigh = "xhigh",
+    Max = "max"
+}
+/** {@link ModelEffort} from least to most work — the order an escalation climbs. */
+export declare const MODEL_EFFORT_ORDER: readonly ModelEffort[];
 /**
  * How a model is asked to produce a schema-conforming object.
  *
@@ -80,12 +97,18 @@ export declare const SPECTATOR_GENERAL = "general";
  * - `Packages` — capabilities resolved from whatever the request happens to mention.
  *                Varies per request, so it gets its OWN breakpoint and can never
  *                invalidate the two blocks above it.
+ * - `Results`  — what the earlier steps of the pipeline this call runs in produced
+ *                (`ExecutionState.results`). Stable within one step, different on the
+ *                next, so it sits BELOW every boundary that is cached across steps and
+ *                is emitted only when a view is present — a call without one composes
+ *                exactly the bytes it composed before this block existed.
  * - `Context`  — volatile, caller-supplied system text. Never cached.
  */
 export declare enum PromptBlock {
     Role = "role",
     Skills = "skills",
     Packages = "packages",
+    Results = "results",
     Context = "context"
 }
 /**

package/build/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,oBAAY,aAAa;IACvB,yFAAyF;IACzF,MAAM,WAAW;IACjB,8BAA8B;IAC9B,SAAS,cAAc;IACvB,yFAAyF;IACzF,UAAU,eAAe;IACzB;;;;;;;;;;;;OAYG;IACH,SAAS,cAAc;CACxB;AAED;;;GAGG;AACH,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED;;;;GAIG;AACH,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,GAAG,QAAQ;CACZ;AAED;;;;;;;;;GASG;AACH,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED,0DAA0D;AAC1D,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,cAAc;CACvB;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,YAAY,CAAA;AAE1C;;;;;;;;;;;;;;GAcG;AACH,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAK3C,CAAA;AAEV,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,YAAY,CAAA"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,oBAAY,aAAa;IACvB,yFAAyF;IACzF,MAAM,WAAW;IACjB,8BAA8B;IAC9B,SAAS,cAAc;IACvB,yFAAyF;IACzF,UAAU,eAAe;IACzB;;;;;;;;;;;;OAYG;IACH,SAAS,cAAc;CACxB;AAED;;;GAGG;AACH,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED;;;;GAIG;AACH,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,GAAG,QAAQ;CACZ;AAED;;;;;GAKG;AACH,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;CACZ;AAED,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAGpD,CAAA;AAED;;;;;;;;;GASG;AACH,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED,0DAA0D;AAC1D,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,cAAc;CACvB;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,YAAY,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAM3C,CAAA;AAEV,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,YAAY,CAAA"}

package/build/consts.js

@@ -48,6 +48,27 @@ export var ExecutionEffort;
     ExecutionEffort["High"] = "high";
     ExecutionEffort["Max"] = "max";
 })(ExecutionEffort || (ExecutionEffort = {}));
+/**
+ * The PROVIDER's own effort knob — OpenAI `reasoning.effort`, Anthropic
+ * `output_config.effort`. Not {@link ExecutionEffort}: that is this package's tier, which
+ * sizes token budgets; this is a value sent on the wire. Which levels a model accepts is a
+ * provider-plugin fact in `@owlmeans/llm`.
+ */
+export var ModelEffort;
+(function (ModelEffort) {
+    ModelEffort["None"] = "none";
+    ModelEffort["Minimal"] = "minimal";
+    ModelEffort["Low"] = "low";
+    ModelEffort["Medium"] = "medium";
+    ModelEffort["High"] = "high";
+    ModelEffort["XHigh"] = "xhigh";
+    ModelEffort["Max"] = "max";
+})(ModelEffort || (ModelEffort = {}));
+/** {@link ModelEffort} from least to most work — the order an escalation climbs. */
+export const MODEL_EFFORT_ORDER = [
+    ModelEffort.None, ModelEffort.Minimal, ModelEffort.Low, ModelEffort.Medium,
+    ModelEffort.High, ModelEffort.XHigh, ModelEffort.Max,
+];
 /**
  * How a model is asked to produce a schema-conforming object.
  *
@@ -85,6 +106,11 @@ export const SPECTATOR_GENERAL = 'general';
  * - `Packages` — capabilities resolved from whatever the request happens to mention.
  *                Varies per request, so it gets its OWN breakpoint and can never
  *                invalidate the two blocks above it.
+ * - `Results`  — what the earlier steps of the pipeline this call runs in produced
+ *                (`ExecutionState.results`). Stable within one step, different on the
+ *                next, so it sits BELOW every boundary that is cached across steps and
+ *                is emitted only when a view is present — a call without one composes
+ *                exactly the bytes it composed before this block existed.
  * - `Context`  — volatile, caller-supplied system text. Never cached.
  */
 export var PromptBlock;
@@ -92,6 +118,7 @@ export var PromptBlock;
     PromptBlock["Role"] = "role";
     PromptBlock["Skills"] = "skills";
     PromptBlock["Packages"] = "packages";
+    PromptBlock["Results"] = "results";
     PromptBlock["Context"] = "context";
 })(PromptBlock || (PromptBlock = {}));
 /**
@@ -103,6 +130,7 @@ export const PROMPT_BLOCK_ORDER = [
     PromptBlock.Role,
     PromptBlock.Skills,
     PromptBlock.Packages,
+    PromptBlock.Results,
     PromptBlock.Context,
 ];
 /** Sort weight of a skill that declares none — see `SkillDefinition.order`. */

package/build/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,MAAM,CAAN,IAAY,aAqBX;AArBD,WAAY,aAAa;IACvB,yFAAyF;IACzF,kCAAiB,CAAA;IACjB,8BAA8B;IAC9B,wCAAuB,CAAA;IACvB,yFAAyF;IACzF,0CAAyB,CAAA;IACzB;;;;;;;;;;;;OAYG;IACH,wCAAuB,CAAA;AACzB,CAAC,EArBW,aAAa,KAAb,aAAa,QAqBxB;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,+BAAa,CAAA;IACb,mCAAiB,CAAA;AACnB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,wCAAqB,CAAA;IACrB,gCAAa,CAAA;IACb,8BAAW,CAAA;AACb,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAED;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,mCAAiB,CAAA;IACjB,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,0DAA0D;AAC1D,MAAM,CAAN,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,qCAAa,CAAA;IACb,qCAAa,CAAA;IACb,8CAAsB,CAAA;AACxB,CAAC,EAJW,oBAAoB,KAApB,oBAAoB,QAI/B;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAA;AAE1C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,gCAAiB,CAAA;IACjB,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;AACrB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,WAAW,CAAC,IAAI;IAChB,WAAW,CAAC,MAAM;IAClB,WAAW,CAAC,QAAQ;IACpB,WAAW,CAAC,OAAO;CACX,CAAA;AAEV,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAA"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,MAAM,CAAN,IAAY,aAqBX;AArBD,WAAY,aAAa;IACvB,yFAAyF;IACzF,kCAAiB,CAAA;IACjB,8BAA8B;IAC9B,wCAAuB,CAAA;IACvB,yFAAyF;IACzF,0CAAyB,CAAA;IACzB;;;;;;;;;;;;OAYG;IACH,wCAAuB,CAAA;AACzB,CAAC,EArBW,aAAa,KAAb,aAAa,QAqBxB;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,+BAAa,CAAA;IACb,mCAAiB,CAAA;AACnB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,wCAAqB,CAAA;IACrB,gCAAa,CAAA;IACb,8BAAW,CAAA;AACb,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,WAQX;AARD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,kCAAmB,CAAA;IACnB,0BAAW,CAAA;IACX,gCAAiB,CAAA;IACjB,4BAAa,CAAA;IACb,8BAAe,CAAA;IACf,0BAAW,CAAA;AACb,CAAC,EARW,WAAW,KAAX,WAAW,QAQtB;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM;IAC1E,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG;CACrD,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,mCAAiB,CAAA;IACjB,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,0DAA0D;AAC1D,MAAM,CAAN,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,qCAAa,CAAA;IACb,qCAAa,CAAA;IACb,8CAAsB,CAAA;AACxB,CAAC,EAJW,oBAAoB,KAApB,oBAAoB,QAI/B;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,gCAAiB,CAAA;IACjB,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;AACrB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,WAAW,CAAC,IAAI;IAChB,WAAW,CAAC,MAAM;IAClB,WAAW,CAAC,QAAQ;IACpB,WAAW,CAAC,OAAO;IACnB,WAAW,CAAC,OAAO;CACX,CAAA;AAEV,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAA"}

package/build/index.d.ts

@@ -5,4 +5,5 @@ export type * from './files/types.js';
 export * from './files/utils.js';
 export * from './delegate/index.js';
 export * from './inquiry/index.js';
+export * from './results/index.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,kBAAkB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,kBAAkB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}

package/build/index.js

@@ -2,4 +2,5 @@ export * from './consts.js';
 export * from './files/utils.js';
 export * from './delegate/index.js';
 export * from './inquiry/index.js';
+export * from './results/index.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAI3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAI3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}

package/build/results/consts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The fixed wording that introduces a {@link CumulativeResults} view in a prompt.
+ *
+ * Written for the WEAKEST model a pipeline may run on, so every rule is literal and says what to do
+ * rather than what to consider. It is a pure constant — no interpolation, no clock — because it
+ * opens a block that recurs verbatim on every call of a step, and the rules are the reason the
+ * block exists at all: a list of names with no instruction attached is read as a suggestion, and a
+ * suggestion is exactly what a model re-derives, renames or re-cases.
+ *
+ * The last rules carry the list's own limits. It is written between steps and can go stale in ways
+ * a live file read cannot, so a file actually shown in the conversation must win; and it may leave
+ * things out for space, so "not listed" means "does not exist yet" only when nothing was left out.
+ */
+export declare const CUMULATIVE_RESULTS_PREAMBLE = "## Results of earlier steps\n\nEverything below was read from the project's files by code, after each earlier step of this work finished. No model wrote it.\n\nRules for using it:\n- These are the AUTHORITATIVE names produced by earlier steps. Use every name, path and import specifier exactly as written here. Never re-derive, rename, re-case or guess a different path.\n- Import a listed symbol only from the specifier listed for it.\n- Never declare anything listed here a second time. Import it, call it or extend it instead.\n- Anything the current task needs that this list does not contain does not exist yet, unless the list says it left something out for space; then look in the project's files first. Create a missing thing only if the task says to, and never under a name that merely resembles a listed one.\n- A source file actually shown elsewhere in this conversation is NEWER than this list and wins wherever the two disagree: this list can go stale between steps, a file you are shown cannot.\n- An entry marked \"(names only)\" lists names without their detail. Read that file before relying on its shape.\n- A summary marked \"(not verified)\" was written by a model and never checked against the files. Treat it as a hint, never as a fact.";
+/** Opens the line naming the steps a view left out for space. The names follow it. */
+export declare const CUMULATIVE_RESULTS_OMITTED_LEAD = "Not listed here for space:";
+/** Closes that line — what the model is to do about a step it cannot see. */
+export declare const CUMULATIVE_RESULTS_OMITTED_TAIL = "Those steps finished and what they made exists in the project's files. Look there before creating anything they may already have made.";
+//# sourceMappingURL=consts.d.ts.map

package/build/results/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/results/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,+uCAW6F,CAAA;AAErI,sFAAsF;AACtF,eAAO,MAAM,+BAA+B,+BAA+B,CAAA;AAE3E,6EAA6E;AAC7E,eAAO,MAAM,+BAA+B,2IAC+F,CAAA"}

package/build/results/consts.js

@@ -0,0 +1,30 @@
+/**
+ * The fixed wording that introduces a {@link CumulativeResults} view in a prompt.
+ *
+ * Written for the WEAKEST model a pipeline may run on, so every rule is literal and says what to do
+ * rather than what to consider. It is a pure constant — no interpolation, no clock — because it
+ * opens a block that recurs verbatim on every call of a step, and the rules are the reason the
+ * block exists at all: a list of names with no instruction attached is read as a suggestion, and a
+ * suggestion is exactly what a model re-derives, renames or re-cases.
+ *
+ * The last rules carry the list's own limits. It is written between steps and can go stale in ways
+ * a live file read cannot, so a file actually shown in the conversation must win; and it may leave
+ * things out for space, so "not listed" means "does not exist yet" only when nothing was left out.
+ */
+export const CUMULATIVE_RESULTS_PREAMBLE = `## Results of earlier steps
+
+Everything below was read from the project's files by code, after each earlier step of this work finished. No model wrote it.
+
+Rules for using it:
+- These are the AUTHORITATIVE names produced by earlier steps. Use every name, path and import specifier exactly as written here. Never re-derive, rename, re-case or guess a different path.
+- Import a listed symbol only from the specifier listed for it.
+- Never declare anything listed here a second time. Import it, call it or extend it instead.
+- Anything the current task needs that this list does not contain does not exist yet, unless the list says it left something out for space; then look in the project's files first. Create a missing thing only if the task says to, and never under a name that merely resembles a listed one.
+- A source file actually shown elsewhere in this conversation is NEWER than this list and wins wherever the two disagree: this list can go stale between steps, a file you are shown cannot.
+- An entry marked "(names only)" lists names without their detail. Read that file before relying on its shape.
+- A summary marked "(not verified)" was written by a model and never checked against the files. Treat it as a hint, never as a fact.`;
+/** Opens the line naming the steps a view left out for space. The names follow it. */
+export const CUMULATIVE_RESULTS_OMITTED_LEAD = 'Not listed here for space:';
+/** Closes that line — what the model is to do about a step it cannot see. */
+export const CUMULATIVE_RESULTS_OMITTED_TAIL = 'Those steps finished and what they made exists in the project\'s files. Look there before creating anything they may already have made.';
+//# sourceMappingURL=consts.js.map

package/build/results/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/results/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;qIAW0F,CAAA;AAErI,sFAAsF;AACtF,MAAM,CAAC,MAAM,+BAA+B,GAAG,4BAA4B,CAAA;AAE3E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,+BAA+B,GAC1C,yIAAyI,CAAA"}

package/build/results/index.d.ts

@@ -0,0 +1,4 @@
+export * from './consts.js';
+export type * from './types.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/build/results/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/results/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,YAAY,CAAA"}

package/build/results/index.js

@@ -0,0 +1,3 @@
+export * from './consts.js';
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

package/build/results/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/results/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAE3B,cAAc,YAAY,CAAA"}

package/build/results/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * One producing step's contribution to a {@link CumulativeResults} view, already rendered.
+ *
+ * `step` names the step that produced it — for a step of a pipeline composed under another, the
+ * composing path as well (`design/screens`) — so two pipelines' steps of the same name never read
+ * as one.
+ */
+export interface CumulativeResultsSection {
+    step: string;
+    text: string;
+}
+/**
+ * What the earlier steps of a pipeline produced, cut for ONE later step.
+ *
+ * Serializable and immutable: it travels on `ExecutionState.results`, so it survives a snapshot and
+ * a restore, and a resumed run composes the same prompt the interrupted one did. Everything in it is
+ * already rendered — the view is cut by the pipeline runtime, where the budgets are known, and the
+ * prompt layer only places it.
+ */
+export interface CumulativeResults {
+    /** The step this view was cut for. */
+    step: string;
+    /** Oldest first. Each is one producing step, rendered in full or as names only. */
+    sections: CumulativeResultsSection[];
+    /** Steps whose results exist but were left out of this view to stay inside its budget. */
+    omitted: string[];
+    /** Characters of the sections as rendered, separators included. */
+    chars: number;
+    /**
+     * A digest of the sections — for a trace line or a debugger, to tell two views apart.
+     *
+     * NEVER rendered into a prompt: it is exactly the kind of varying, meaningless byte a model would
+     * copy into its answer or treat as an instruction.
+     */
+    digest: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/results/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/results/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,mFAAmF;IACnF,QAAQ,EAAE,wBAAwB,EAAE,CAAA;IACpC,0FAA0F;IAC1F,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAA;CACf"}

package/build/results/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/results/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/results/types.ts"],"names":[],"mappings":""}

package/build/results/utils.d.ts

@@ -0,0 +1,11 @@
+import type { CumulativeResults } from './types.js';
+/**
+ * A {@link CumulativeResults} view as prompt text, or `''` when there is nothing to say.
+ *
+ * Pure and total: the same view renders to the same bytes on every runtime, and an absent or empty
+ * view renders to NOTHING — not a heading over an empty list, which a model would read as "no
+ * earlier step produced anything" and act on. The view's digest is never rendered; its sections are
+ * placed in the order the view holds them, which is oldest first.
+ */
+export declare const renderCumulativeResults: (view: CumulativeResults | null | undefined) => string;
+//# sourceMappingURL=utils.d.ts.map

package/build/results/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/results/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAKnD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,SAAU,iBAAiB,GAAG,IAAI,GAAG,SAAS,KAAG,MAmBpF,CAAA"}

package/build/results/utils.js

@@ -0,0 +1,28 @@
+import { CUMULATIVE_RESULTS_OMITTED_LEAD, CUMULATIVE_RESULTS_OMITTED_TAIL, CUMULATIVE_RESULTS_PREAMBLE, } from './consts.js';
+/** Separator between sections — the same two newlines every other prompt join uses. */
+const SEPARATOR = '\n\n';
+/**
+ * A {@link CumulativeResults} view as prompt text, or `''` when there is nothing to say.
+ *
+ * Pure and total: the same view renders to the same bytes on every runtime, and an absent or empty
+ * view renders to NOTHING — not a heading over an empty list, which a model would read as "no
+ * earlier step produced anything" and act on. The view's digest is never rendered; its sections are
+ * placed in the order the view holds them, which is oldest first.
+ */
+export const renderCumulativeResults = (view) => {
+    if (view == null) {
+        return '';
+    }
+    const sections = view.sections.map(section => section.text.trim()).filter(text => text !== '');
+    const omitted = view.omitted.filter(step => step.trim() !== '');
+    if (sections.length === 0 && omitted.length === 0) {
+        return '';
+    }
+    const parts = [CUMULATIVE_RESULTS_PREAMBLE, ...sections];
+    if (omitted.length > 0) {
+        parts.push(`${CUMULATIVE_RESULTS_OMITTED_LEAD} ${omitted.map(step => `\`${step}\``).join(', ')}. `
+            + CUMULATIVE_RESULTS_OMITTED_TAIL);
+    }
+    return parts.join(SEPARATOR);
+};
+//# sourceMappingURL=utils.js.map

package/build/results/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/results/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAAE,+BAA+B,EAAE,2BAA2B,GAC9F,MAAM,aAAa,CAAA;AAGpB,uFAAuF;AACvF,MAAM,SAAS,GAAG,MAAM,CAAA;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAA0C,EAAU,EAAE;IAC5F,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAA;IAC9F,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC/D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,2BAA2B,EAAE,GAAG,QAAQ,CAAC,CAAA;IACxD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CACR,GAAG,+BAA+B,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;cACrF,+BAA+B,CAClC,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AAC9B,CAAC,CAAA"}

package/build/types.d.ts

@@ -1,5 +1,6 @@
-import type { ExecutionEffort, ExecutionLevel, PromptBlock } from './consts.js';
+import type { ExecutionEffort, ExecutionLevel, ModelEffort, PromptBlock } from './consts.js';
 import type { InquiryConfig } from './inquiry/types.js';
+import type { CumulativeResults } from './results/types.js';
 /**
  * Free-form observability metadata attached to every model call — forwarded to the
  * inference provider as run metadata and recorded on every spectator entry. Kept
@@ -30,6 +31,8 @@ export interface ModelConfigPatch {
     maxTokensCap?: number;
     topP?: number;
     disableThinking?: boolean;
+    /** Provider-native effort; clamped to what the model accepts, dropped where it accepts none. */
+    effort?: ModelEffort;
     /** Total window the model accepts (input + output). Informational / validation only. */
     contextWindow?: number;
     /** What the PROVIDER can emit in one request. Hard ceiling for `maxTokens`/`maxTokensCap`. */
@@ -138,6 +141,15 @@ export interface ExecutionState {
      * same policy, as the one that parked it.
      */
     inquiry?: InquiryConfig;
+    /**
+     * What the earlier steps of the pipeline this execution works inside produced, cut for the step
+     * at hand. Rendered into `PromptBlock.Results` by the prompt service.
+     *
+     * State, not a collaborator: it is plain rendered text, and a resumed run must compose the
+     * prompt the interrupted one did. Inherited by every refinement like any other state field, and
+     * replaced — never merged — when a later step is handed its own view.
+     */
+    results?: CumulativeResults;
 }
 /**
  * The task level's own fields.

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,8FAA8F;IAC9F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,6EAA6E;AAC7E,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,gBAAgB,CAAA;AAE3D;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,MAAM,EAAE,eAAe,CAAA;IACvB,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAA;IACrD,kFAAkF;IAClF,cAAc,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,CAAA;IAChE;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAA;AAElC;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,CAAA;IACrB,OAAO,EAAE,UAAU,CAAA;IACnB,MAAM,EAAE,WAAW,CAAA;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,4FAA4F;IAC5F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,yFAAyF;AACzF,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,UAAU,CAAA;QACpB,OAAO,EAAE,MAAM,CAAA;QACf,EAAE,EAAE,MAAM,CAAA;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,KAAK,EAAE;QACL,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,OAAO,EAAE,CAAA;QACnB,MAAM,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,OAAO,CAAA;SAAE,CAAA;QACnD,QAAQ,EAAE,OAAO,CAAA;KAClB,CAAA;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,CAAA;QAChB,iBAAiB,CAAC,EAAE,OAAO,CAAA;QAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAA;QAC3B,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,UAAU,CAAC,EAAE,OAAO,CAAA;KACrB,GAAG,IAAI,CAAA;IACR,WAAW,EAAE;QACX,+FAA+F;QAC/F,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,YAAY,EAAE,OAAO,CAAA;QACrB;;;;WAIG;QACH,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,WAAW,EAAE,OAAO,CAAA;KACrB,CAAA;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@owlmeans/llm-common",
-  "version": "0.1.18-rc.35",
+  "version": "0.1.18-rc.37",
   "license": "MIT",
   "type": "module",
   "scripts": {
     "build": "tsc -b",
     "dev": "sleep 171 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
-    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+    "watch": "tsc -b -w --preserveWatchOutput --pretty",
+    "test": "bun test ./tests"
   },
   "main": "build/index.js",
   "module": "build/index.js",

package/src/consts.ts

@@ -49,6 +49,28 @@ export enum ExecutionEffort {
   Max = 'max',
 }
 
+/**
+ * The PROVIDER's own effort knob — OpenAI `reasoning.effort`, Anthropic
+ * `output_config.effort`. Not {@link ExecutionEffort}: that is this package's tier, which
+ * sizes token budgets; this is a value sent on the wire. Which levels a model accepts is a
+ * provider-plugin fact in `@owlmeans/llm`.
+ */
+export enum ModelEffort {
+  None = 'none',
+  Minimal = 'minimal',
+  Low = 'low',
+  Medium = 'medium',
+  High = 'high',
+  XHigh = 'xhigh',
+  Max = 'max',
+}
+
+/** {@link ModelEffort} from least to most work — the order an escalation climbs. */
+export const MODEL_EFFORT_ORDER: readonly ModelEffort[] = [
+  ModelEffort.None, ModelEffort.Minimal, ModelEffort.Low, ModelEffort.Medium,
+  ModelEffort.High, ModelEffort.XHigh, ModelEffort.Max,
+]
+
 /**
  * How a model is asked to produce a schema-conforming object.
  *
@@ -87,12 +109,18 @@ export const SPECTATOR_GENERAL = 'general'
  * - `Packages` — capabilities resolved from whatever the request happens to mention.
  *                Varies per request, so it gets its OWN breakpoint and can never
  *                invalidate the two blocks above it.
+ * - `Results`  — what the earlier steps of the pipeline this call runs in produced
+ *                (`ExecutionState.results`). Stable within one step, different on the
+ *                next, so it sits BELOW every boundary that is cached across steps and
+ *                is emitted only when a view is present — a call without one composes
+ *                exactly the bytes it composed before this block existed.
  * - `Context`  — volatile, caller-supplied system text. Never cached.
  */
 export enum PromptBlock {
   Role = 'role',
   Skills = 'skills',
   Packages = 'packages',
+  Results = 'results',
   Context = 'context',
 }
 
@@ -105,6 +133,7 @@ export const PROMPT_BLOCK_ORDER: readonly PromptBlock[] = [
   PromptBlock.Role,
   PromptBlock.Skills,
   PromptBlock.Packages,
+  PromptBlock.Results,
   PromptBlock.Context,
 ] as const
 

package/src/index.ts

@@ -6,3 +6,4 @@ export type * from './files/types.js'
 export * from './files/utils.js'
 export * from './delegate/index.js'
 export * from './inquiry/index.js'
+export * from './results/index.js'

package/src/results/consts.ts

@@ -0,0 +1,32 @@
+/**
+ * The fixed wording that introduces a {@link CumulativeResults} view in a prompt.
+ *
+ * Written for the WEAKEST model a pipeline may run on, so every rule is literal and says what to do
+ * rather than what to consider. It is a pure constant — no interpolation, no clock — because it
+ * opens a block that recurs verbatim on every call of a step, and the rules are the reason the
+ * block exists at all: a list of names with no instruction attached is read as a suggestion, and a
+ * suggestion is exactly what a model re-derives, renames or re-cases.
+ *
+ * The last rules carry the list's own limits. It is written between steps and can go stale in ways
+ * a live file read cannot, so a file actually shown in the conversation must win; and it may leave
+ * things out for space, so "not listed" means "does not exist yet" only when nothing was left out.
+ */
+export const CUMULATIVE_RESULTS_PREAMBLE = `## Results of earlier steps
+
+Everything below was read from the project's files by code, after each earlier step of this work finished. No model wrote it.
+
+Rules for using it:
+- These are the AUTHORITATIVE names produced by earlier steps. Use every name, path and import specifier exactly as written here. Never re-derive, rename, re-case or guess a different path.
+- Import a listed symbol only from the specifier listed for it.
+- Never declare anything listed here a second time. Import it, call it or extend it instead.
+- Anything the current task needs that this list does not contain does not exist yet, unless the list says it left something out for space; then look in the project's files first. Create a missing thing only if the task says to, and never under a name that merely resembles a listed one.
+- A source file actually shown elsewhere in this conversation is NEWER than this list and wins wherever the two disagree: this list can go stale between steps, a file you are shown cannot.
+- An entry marked "(names only)" lists names without their detail. Read that file before relying on its shape.
+- A summary marked "(not verified)" was written by a model and never checked against the files. Treat it as a hint, never as a fact.`
+
+/** Opens the line naming the steps a view left out for space. The names follow it. */
+export const CUMULATIVE_RESULTS_OMITTED_LEAD = 'Not listed here for space:'
+
+/** Closes that line — what the model is to do about a step it cannot see. */
+export const CUMULATIVE_RESULTS_OMITTED_TAIL =
+  'Those steps finished and what they made exists in the project\'s files. Look there before creating anything they may already have made.'

package/src/results/index.ts

@@ -0,0 +1,3 @@
+export * from './consts.js'
+export type * from './types.js'
+export * from './utils.js'

package/src/results/types.ts

@@ -0,0 +1,37 @@
+/**
+ * One producing step's contribution to a {@link CumulativeResults} view, already rendered.
+ *
+ * `step` names the step that produced it — for a step of a pipeline composed under another, the
+ * composing path as well (`design/screens`) — so two pipelines' steps of the same name never read
+ * as one.
+ */
+export interface CumulativeResultsSection {
+  step: string
+  text: string
+}
+
+/**
+ * What the earlier steps of a pipeline produced, cut for ONE later step.
+ *
+ * Serializable and immutable: it travels on `ExecutionState.results`, so it survives a snapshot and
+ * a restore, and a resumed run composes the same prompt the interrupted one did. Everything in it is
+ * already rendered — the view is cut by the pipeline runtime, where the budgets are known, and the
+ * prompt layer only places it.
+ */
+export interface CumulativeResults {
+  /** The step this view was cut for. */
+  step: string
+  /** Oldest first. Each is one producing step, rendered in full or as names only. */
+  sections: CumulativeResultsSection[]
+  /** Steps whose results exist but were left out of this view to stay inside its budget. */
+  omitted: string[]
+  /** Characters of the sections as rendered, separators included. */
+  chars: number
+  /**
+   * A digest of the sections — for a trace line or a debugger, to tell two views apart.
+   *
+   * NEVER rendered into a prompt: it is exactly the kind of varying, meaningless byte a model would
+   * copy into its answer or treat as an instruction.
+   */
+  digest: string
+}

package/src/results/utils.ts

@@ -0,0 +1,36 @@
+import {
+  CUMULATIVE_RESULTS_OMITTED_LEAD, CUMULATIVE_RESULTS_OMITTED_TAIL, CUMULATIVE_RESULTS_PREAMBLE,
+} from './consts.js'
+import type { CumulativeResults } from './types.js'
+
+/** Separator between sections — the same two newlines every other prompt join uses. */
+const SEPARATOR = '\n\n'
+
+/**
+ * A {@link CumulativeResults} view as prompt text, or `''` when there is nothing to say.
+ *
+ * Pure and total: the same view renders to the same bytes on every runtime, and an absent or empty
+ * view renders to NOTHING — not a heading over an empty list, which a model would read as "no
+ * earlier step produced anything" and act on. The view's digest is never rendered; its sections are
+ * placed in the order the view holds them, which is oldest first.
+ */
+export const renderCumulativeResults = (view: CumulativeResults | null | undefined): string => {
+  if (view == null) {
+    return ''
+  }
+  const sections = view.sections.map(section => section.text.trim()).filter(text => text !== '')
+  const omitted = view.omitted.filter(step => step.trim() !== '')
+  if (sections.length === 0 && omitted.length === 0) {
+    return ''
+  }
+
+  const parts = [CUMULATIVE_RESULTS_PREAMBLE, ...sections]
+  if (omitted.length > 0) {
+    parts.push(
+      `${CUMULATIVE_RESULTS_OMITTED_LEAD} ${omitted.map(step => `\`${step}\``).join(', ')}. `
+      + CUMULATIVE_RESULTS_OMITTED_TAIL,
+    )
+  }
+
+  return parts.join(SEPARATOR)
+}

package/src/types.ts

@@ -1,5 +1,6 @@
-import type { ExecutionEffort, ExecutionLevel, PromptBlock } from './consts.js'
+import type { ExecutionEffort, ExecutionLevel, ModelEffort, PromptBlock } from './consts.js'
 import type { InquiryConfig } from './inquiry/types.js'
+import type { CumulativeResults } from './results/types.js'
 
 /**
  * Free-form observability metadata attached to every model call — forwarded to the
@@ -33,6 +34,8 @@ export interface ModelConfigPatch {
   maxTokensCap?: number
   topP?: number
   disableThinking?: boolean
+  /** Provider-native effort; clamped to what the model accepts, dropped where it accepts none. */
+  effort?: ModelEffort
   /** Total window the model accepts (input + output). Informational / validation only. */
   contextWindow?: number
   /** What the PROVIDER can emit in one request. Hard ceiling for `maxTokens`/`maxTokensCap`. */
@@ -148,6 +151,15 @@ export interface ExecutionState {
    * same policy, as the one that parked it.
    */
   inquiry?: InquiryConfig
+  /**
+   * What the earlier steps of the pipeline this execution works inside produced, cut for the step
+   * at hand. Rendered into `PromptBlock.Results` by the prompt service.
+   *
+   * State, not a collaborator: it is plain rendered text, and a resumed run must compose the
+   * prompt the interrupted one did. Inherited by every refinement like any other state field, and
+   * replaced — never merged — when a later step is handed its own view.
+   */
+  results?: CumulativeResults
 }
 
 /**

package/tests/results.spec.ts

@@ -0,0 +1,65 @@
+import { describe, expect, test } from 'bun:test'
+import {
+  CUMULATIVE_RESULTS_OMITTED_LEAD, CUMULATIVE_RESULTS_PREAMBLE, PROMPT_BLOCK_ORDER, PromptBlock,
+  renderCumulativeResults,
+} from '../src/index.js'
+import type { CumulativeResults } from '../src/index.js'
+
+/**
+ * The prompt-facing half of cumulative pipeline results: where the block sits and what it says.
+ * Both are cache facts as much as wording — a view must render to the same bytes every time, and
+ * an absent view must render to nothing at all.
+ */
+
+const view = (patch: Partial<CumulativeResults> = {}): CumulativeResults => ({
+  step: 'resources',
+  sections: [
+    { step: 'types', text: '### types\n- type `User`: { id: string } — import from `@app/common`' },
+    { step: 'files', text: '### files (names only)\n- file: `a.ts`' },
+  ],
+  omitted: [],
+  chars: 100,
+  digest: 'digest-that-must-never-be-rendered',
+  ...patch,
+})
+
+describe('@owlmeans/llm-common — results block placement', () => {
+  test('sits after the packages block and before the per-call context', () => {
+    expect(PROMPT_BLOCK_ORDER).toEqual([
+      PromptBlock.Role, PromptBlock.Skills, PromptBlock.Packages, PromptBlock.Results,
+      PromptBlock.Context,
+    ])
+  })
+})
+
+describe('@owlmeans/llm-common — rendering a results view', () => {
+  test('no view, or a view with nothing in it, renders nothing at all', () => {
+    expect(renderCumulativeResults(undefined)).toBe('')
+    expect(renderCumulativeResults(null)).toBe('')
+    expect(renderCumulativeResults(view({ sections: [] }))).toBe('')
+  })
+
+  test('opens with the fixed rules, then the sections oldest first', () => {
+    const text = renderCumulativeResults(view())
+
+    expect(text.startsWith(CUMULATIVE_RESULTS_PREAMBLE)).toBe(true)
+    expect(text).toContain('No model wrote it.')
+    expect(text).toContain('Import a listed symbol only from the specifier listed for it.')
+    expect(text).toContain('is NEWER than this list')
+    expect(text.indexOf('### types')).toBeLessThan(text.indexOf('### files'))
+  })
+
+  test('never renders the digest, and renders the same bytes every time', () => {
+    const text = renderCumulativeResults(view())
+
+    expect(text).not.toContain('digest-that-must-never-be-rendered')
+    expect(renderCumulativeResults(view())).toBe(text)
+  })
+
+  test('names the steps left out for space, and says their results exist', () => {
+    const text = renderCumulativeResults(view({ omitted: ['scaffold', 'design/screens'] }))
+
+    expect(text).toContain(`${CUMULATIVE_RESULTS_OMITTED_LEAD} \`scaffold\`, \`design/screens\`.`)
+    expect(text.endsWith('Look there before creating anything they may already have made.')).toBe(true)
+  })
+})