@owlmeans/viable-common 0.0.43 → 0.0.45

package/README.md

@@ -21,7 +21,7 @@ filesystem, no inference SDK. It is safe to import from a browser bundle.
 ## Installation
 
 ```bash
-bun add @owlmeans/viable-common@^0.0.43
+bun add @owlmeans/viable-common@^0.0.45
 ```
 
 ## Rules worth knowing before you change something
@@ -39,7 +39,7 @@ means "inherit" has no other spelling. `tests/convert.spec.ts` walks every expor
 both faults, and for draft-04 tuple `items`.
 
 **A field that crosses a version skew carries no `enum`.** A connector is installed with
-`npx -y @owlmeans/viable-mcp@^0.1.18-rc.41` and talks to a separately deployed platform, so an executor kind it
+`npx -y @owlmeans/viable-mcp@^0.1.18-rc.45` and talks to a separately deployed platform, so an executor kind it
 sends must remain an unused capability on an older platform rather than a refused session.
 
 **A ceiling exists once.** The inquiry answer cap here equals `DEFAULT_INQUIRY_ANSWER_CHARS` in
@@ -59,7 +59,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.46
+npx @owlmeans/agent-skills@^0.1.18-rc.49
 ```
 
 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/viable-common",
-  "version": "0.0.43",
-  "generatedAt": "2026-10-04T01:01:54.404Z",
+  "version": "0.0.45",
+  "generatedAt": "2026-10-05T21:03:06.405Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/agent-presentation/SKILL.md

@@ -6,10 +6,10 @@ description: Shared, runtime-free taxonomy for presenting OwlMeans Viable agent
 
 # Agent output presentation
 
-**Install:** `"@owlmeans/viable-common": "^0.0.43"` in `dependencies`
+**Install:** `"@owlmeans/viable-common": "^0.0.45"` in `dependencies`
 
 `@owlmeans/viable-common`'s `agent/presentation.ts` owns the browser-safe vocabulary for agent
-output. Keep the server and every client on `classifyAgentMessage()`; consumers may refine a
+output. Keep the server and every client on `agentPresentationHelper.classifyAgentMessage()`; consumers may refine a
 provisional classification as streamed text becomes parseable, but must not invent a competing
 taxonomy.
 
@@ -24,7 +24,7 @@ taxonomy.
   compatibility; the final server hint is based on complete output and the browser refines it while
   it streams. Keep legacy `outputType` intact.
 - Unwrap a single LangChain tool call's `args` before semantic classification
-  (`agentToolCallArguments`). Known schemas render as cards; unknown objects and arrays remain
+  (`agentPresentationHelper.agentToolCallArguments`). Known schemas render as cards; unknown objects and arrays remain
   generic structured output, never raw JSON.
 - `structuredKindOf`'s shape checks are ORDER-SENSITIVE where one payload could match more than
   one: a scaffold plan carries its own `stories` array, so `ScaffoldPlan` (`identity` + `guestHome`
@@ -40,7 +40,7 @@ taxonomy.
   `source-extract`), or the single call's shape only reaches a `Generic*` kind. Without the
   action check, a free-flight `read_sources({ files })` call reads as an `ArtifactSelection` card
   instead of a tool call, because its args happen to shape-match that schema.
-- `isAgentMessageHidden()` owns utility-run suppression. The source extractor's `source-extract`
+- `agentPresentationHelper.isAgentMessageHidden()` owns utility-run suppression. The source extractor's `source-extract`
   range-selection calls are internal context reduction and never render in thinking or history.
 
 ## Consumer rules

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

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/viable-common
 
 **Layer:** Cross-cutting domain (contracts only)
-**Install:** `"@owlmeans/viable-common": "^0.0.43"` in `dependencies`
+**Install:** `"@owlmeans/viable-common": "^0.0.45"` in `dependencies`
 **Subpaths:** `.` · `./slot` · `./connect` · `./convert` · `./integrity` · `./intent` — the barrel
 re-exports every subpath except `./intent`.
 **Runtime-free:** no `@langchain/*`, no filesystem, no Ajv at run time (a devDependency, for the
@@ -31,11 +31,11 @@ execution state and card fields name.
 
 | Subpath | What it declares |
 |---|---|
-| `.` (barrel) | The planning module (`VIABLE_*_TYPE`, `VIABLE_TYPE_SCHEMAS`, `VIABLE_FLOW_SCHEMAS`, `ViableStoryStatus`/`ViableProjectStatus` and their transitions, `ViableSpecCategory`, `ViableRelationship`, `ViableChannel`, `ViableProjectCard`/`ViableStoryCard`, the card helpers, the landing sentence helpers, the `Project*` refusals); `SlotMetadata` and the three metadata vocabularies (`metadataConfigs`, `metadataLists`, `metadataSecrets`), `BRANDING_ENV_KEYS` / `brandingEnv`; `ProjectArea` / `AREA_PATHS` / `AREA_ACCESS` / `AREA_TIER`, `ADMIN_PERMISSION` / `OPERATOR_PERMISSION`; the tenancy contract (`ProjectTenancy`, `ViableTenancyDecision`, `NO_TENANCY`, `tenancyOf`, `tenantedArea`, `TENANCY_QUOTE_MAX`); `ModelRole` and the viable `ExecutionState`; the `ViableSkill` / `ViablePersona` enums; the `Blueprint` layer types, `BlueprintRef` / `BlueprintPatch`, `BlueprintCase` / `GameKind` / `WorkKind`, `CASE_QUOTE_MAX`, `DEFAULT_BLUEPRINT_ID` / `BLUEPRINT_META_KEY`, `landingGatePreferenceOf`; the target topology (`TopologyDescriptor`, `LAYOUT_TOPOLOGIES`, `resolveTopology`, `packageForRole` — meaning in `/blueprints`); the BA shapes (`mergeConnectingStories`), the dev (`AccessBlock`, `AccessLevel`, `PermissionDefault`), UX, design and scaffold shapes and their schemas, `StoryDesignPort`; `ModerationCategory` / `ModerationSubject` / `decideModeration`; the `docs/` metadata paths; `PreviewEventType`; the agent-output taxonomy (`classifyAgentMessage`, `isAgentMessageHidden` — `/agent-presentation`) and the spectator entry types |
-| `./slot` | `SlotCommandType` and the `SlotFileCommand` / `SlotShellCommand` / `SlotGitCommand` / `SlotDatabaseCommand` sets; `SlotDatabaseInfo`, `SlotDatabaseQueryArgs` / `SlotDatabaseQueryResult`, `DATABASE_READ_LIMITS`; the per-command deadlines and timeouts (`commandDeadline`, `commandTimeout`), `SubProject`, `LAYOUTS` / `ROLE_DIRS` / `subprojectDirOf`, `WorkloadKind`, the target ports and process markers, `slotOrigin` / `targetRedirectUrisForOrigin` |
-| `./connect` | `ConnectTarget`, `ConnectLlm`, `ConnectHarness`, `ConnectExecutor`, `ConnectOpKind`, `ConnectProjectStatus`, `ConnectStoryStatus`, `ConnectPipelineState`, `ConnectWaitReason`, `ConnectProjectBranding` / `ConnectProjectBrandingSave`, the planning-kit views (`PlanningKitView`, `ConnectKitDescribe`, `ConnectKitApplyBody`, `ConnectKitApplyResult` and their `*Schema`s), `ModelTier` + `tierOfRole`/`clampTier`, `ModelTask*`, `InquiryPayload` + `ConnectInquiryKind`, the session and domain-status views, the `Connect*` error family, `connectProtocols(opts)` and every `*Schema` behind them |
-| `./convert` | `ConversionStage`/`Status`/`Decision` and the `stageAfter`/`decisionFor`/`canEnter` transitions, `OriginKind`/`OriginShape`/`OriginState`, `StackId` + `STACK_FAMILY`, `ArchitectureCase`, `ConvertibilityVerdict`/`ConvertibilityReason`, the census classifiers (`fileClassOf`, `sizeClassOf`, `entropyClassOf`, `binaryByExtension`), the `docs/conversion/` paths, `CONVERTED_ORIGIN_DIR`, `SOURCE_LIST_EXCLUSIONS`, `CENSUS_SKIP_DIRS`, `RELOCATE_ALWAYS_KEEP`, and the model-answer schemas the conversion asks with |
-| `./integrity` | `TargetLayout` + `TARGET_LAYOUTS`, `detectTargetLayout`, `verifyTargetShape`, `TARGET_INTEGRITY_FILES`, `TARGET_PROTECTED_FILES`, `isLegacyLayout`, `targetPackageName` |
+| `.` (barrel) | The planning module (`VIABLE_*_TYPE`, `VIABLE_TYPE_SCHEMAS`, `VIABLE_FLOW_SCHEMAS`, `ViableStoryStatus`/`ViableProjectStatus` and their transitions, `ViableSpecCategory`, `ViableRelationship`, `ViableChannel`, `ViableProjectCard`/`ViableStoryCard`, the card helpers, the landing sentence helpers, the `Project*` refusals); `SlotMetadata` and the three metadata vocabularies (`metadataConfigs`, `metadataLists`, `metadataSecrets`), `BRANDING_ENV_KEYS` / `brandingEnv`; `ProjectArea` / `AREA_PATHS` / `AREA_ACCESS` / `AREA_TIER`, `ADMIN_PERMISSION` / `OPERATOR_PERMISSION`; the tenancy contract (`ProjectTenancy`, `ViableTenancyDecision`, `NO_TENANCY`, `tenancyHelper` (`tenancyOf`, `tenantedArea`), `TENANCY_QUOTE_MAX`); `ModelRole` and the viable `ExecutionState`; the `ViableSkill` / `ViablePersona` enums; the `Blueprint` layer types, `BlueprintRef` / `BlueprintPatch`, `BlueprintCase` / `GameKind` / `WorkKind`, `CASE_QUOTE_MAX`, `DEFAULT_BLUEPRINT_ID` / `BLUEPRINT_META_KEY`, `landingGatePreferenceOf`; the target topology (`TopologyDescriptor`, `LAYOUT_TOPOLOGIES`, `topologyHelper` (`resolveTopology`, `packageForRole`) — meaning in `/blueprints`); the BA shapes (`connectingStoryHelper.mergeConnectingStories`), the dev (`AccessBlock`, `AccessLevel`, `PermissionDefault`), UX, design and scaffold shapes and their schemas, `StoryDesignPort`; `ModerationCategory` / `ModerationSubject` / `moderationVerdictHelper.decideModeration`; the `docs/` metadata paths; `PreviewEventType` (error kinds plus `Analytics` — an analytics event a target's web posted through the preview reporter's channel; the target-side plugins live in `@owlmeans/viable-log`) and the `OwlMeansAnalyticsPayload` shape; the agent-output taxonomy (`agentPresentationHelper` — `classifyAgentMessage`, `isAgentMessageHidden`; `/agent-presentation`) and the spectator entry types |
+| `./slot` | `SlotCommandType` and the `SlotFileCommand` / `SlotShellCommand` / `SlotGitCommand` / `SlotDatabaseCommand` sets; `SlotDatabaseInfo`, `SlotDatabaseQueryArgs` / `SlotDatabaseQueryResult`, `DATABASE_READ_LIMITS`; the per-command deadlines and timeouts (`slotCommandHelper` — `commandDeadline`, `commandTimeout`), `SubProject`, `LAYOUTS` / `ROLE_DIRS` / `slotLayoutHelper.subprojectDirOf`, `WorkloadKind`, the target ports and process markers, `slotOriginHelper` (`slotOrigin` / `targetRedirectUrisForOrigin`) |
+| `./connect` | `ConnectTarget`, `ConnectLlm`, `ConnectHarness`, `ConnectExecutor`, `ConnectOpKind`, `ConnectProjectStatus`, `ConnectStoryStatus`, `ConnectPipelineState`, `ConnectWaitReason`, `ConnectProjectBranding` / `ConnectProjectBrandingSave`, the planning-kit views (`PlanningKitView`, `ConnectKitDescribe`, `ConnectKitApplyBody`, `ConnectKitApplyResult` and their `*Schema`s), `ModelTier` + `modelTierHelper` (`tierOfRole`/`clampTier`), `ModelTask*`, `InquiryPayload` + `ConnectInquiryKind`, the session and domain-status views, the convert bodies (`ConnectConvertCreateBody`, `ConnectConvertStartBody`, `ConnectConvertProceedBody`), the `Connect*` error family with `ConnectConfirmation` / `ConnectConfirmationAction`, `connectProtocols(opts)` and every `*Schema` behind them |
+| `./convert` | `ConversionStage`/`Status`/`Decision` and the `conversionStageHelper` transitions (`stageAfter`/`decisionFor`/`canEnter`), `OriginKind`/`OriginShape`/`OriginState`, `StackId` + `STACK_FAMILY`, `ArchitectureCase`, `ConvertibilityVerdict`/`ConvertibilityReason`, the census classifiers (`censusHelper` — `fileClassOf`, `sizeClassOf`, `entropyClassOf`, `binaryByExtension`), the `docs/conversion/` paths, `CONVERTED_ORIGIN_DIR`, `SOURCE_LIST_EXCLUSIONS`, `CENSUS_SKIP_DIRS`, `RELOCATE_ALWAYS_KEEP`, and the model-answer schemas the conversion asks with |
+| `./integrity` | `TargetLayout` + `TARGET_LAYOUTS`, `targetLayoutHelper` (`detectTargetLayout`, `isLegacyLayout`, `targetPackageName`), `targetIntegrityHelper.verifyTargetShape`, `TARGET_INTEGRITY_FILES`, `TARGET_PROTECTED_FILES` |
 | `./intent` | `intent` (the four aliases), `makeIntentProtocols(opts?)`, `intentFlow` + `IntentFlowStep` + `INTENT_PAYLOAD_REF`, `IntentStashBodySchema` / `IntentPickupBodySchema`, the `INTENT_*` constants, `IntentDraft`, `IntentExpired` (404) / `IntentThrottled` (429) |
 
 ## The planning module
@@ -109,7 +109,7 @@ the wire and in target files — a parent agent's vocabulary, which never change
 
 `area` and `primary` are required in `ViableStoryFieldsSchema`; a create without an area still
 validates, because validation runs after the planning middlewares and the viable plugin fills the
-area of a narrative a person wrote. `storyFieldsOf` answers an absent area as `guest` and an
+area of a narrative a person wrote. `viableCardHelper.storyFieldsOf` answers an absent area as `guest` and an
 absent flag as `false`.
 
 ### The landing gate on the cards
@@ -122,12 +122,12 @@ full-scale screen after signing in (`/target-areas`). Two fields record it:
   is never written, since `null` would read as a decided "none" that nothing asks again. `at`
   carries no `format` because the planning registry compiles without ajv-formats.
 - story `fields.landing: true` marks the chosen card — at most one per project — and is what design
-  and development key on. `storyWriteInputOf` copies it into `StoryWriteInput.landing` only when
+  and development key on. `viableCardHelper.storyWriteInputOf` copies it into `StoryWriteInput.landing` only when
   set, so `StoryMeta.landing` appears only in that story's `docs/stories/<code>.md`; like `primary`
   it is the CARD's and is never passed in `StoryWriteContent`.
 
-`withLandingSentence` appends `LANDING_STORY_SENTENCE` to the chosen narrative — a note for people
-reading the board, never the authority. It is idempotent (`hasLandingSentence`,
+`landingSentenceHelper.withLandingSentence` appends `LANDING_STORY_SENTENCE` to the chosen narrative — a note for people
+reading the board, never the authority. It is idempotent (`.hasLandingSentence`,
 whitespace-insensitive), joins with one space, and never pushes a title past `TITLE_MAX`: a
 narrative with no room is returned uncut.
 
@@ -145,9 +145,9 @@ application, the project owner's, that every person acts in.
   is refused.
 - It reaches a run only through `BlueprintRef.tenancy`, and only when a flag is on; resolution
   alone writes it into `experience.tenancy` — never a blueprint or a case table. Read it through
-  `tenancyOf(blueprint)`: `NO_TENANCY` (frozen, both off) for no blueprint, layer, key or an
+  `tenancyHelper.tenancyOf(blueprint)`: `NO_TENANCY` (frozen, both off) for no blueprint, layer, key or an
   unreadable value — only a literal `true` turns a flag on.
-- `tenantedArea(area, tenancy)` — `user` follows `users`, `operator` follows `operators`; `guest`
+- `tenancyHelper.tenantedArea(area, tenancy)` — `user` follows `users`, `operator` follows `operators`; `guest`
   and `admin` (the project owner, above every tenant) are never tenanted.
 - Classification, the access policy, per-record kinds and the IAM client config live in
   `@owlmeans/viable` (`/target-tenancy`).
@@ -165,13 +165,13 @@ The co-located `*.spec.md` / `*.ux.md` / `*.ui.md` files of a target are FILES,
 prose lives in the `design` payload — so no type declares a `ux` or `ui` slot.
 
 A story CODE (`US-XXXXX`) is the target's vocabulary: every file, registry entry and widget stamp
-names the code, and a card id never reaches a target file — `storyWriteInputOf` refuses a card
+names the code, and a card id never reaches a target file — `viableCardHelper.storyWriteInputOf` refuses a card
 with no code (`ProjectStoryMissconfigured('no-code')`). A project's code is its alias, minted by
 the platform's name ladder; the slug policy only guards uniqueness.
 
 `follows`, `shares-widget` and `shares-screen` run story → story. Only `follows` is WRITTEN: a
 connective story follows the flow story it was anchored after, created in the same transition from
-`MergedStoryDraft.after` (the clamped 1-based position, filled by `mergeConnectingStories` alone).
+`MergedStoryDraft.after` (the clamped 1-based position, filled by `connectingStoryHelper.mergeConnectingStories` alone).
 The `shares-*` types are declared only — the `scaffold` specification is their single authority.
 
 ### The write channel
@@ -179,7 +179,7 @@ The `shares-*` types are declared only — the `scaffold` specification is their
 `ViableChannel` (`web`, `connect`, `agent`, `pipeline`) is what a planning write carries on
 `PlanningScope.channel` and records on `actor.channel`. It is never read from the wire: the API
 services derive `connect` from an access-token request and `web` from everything else; the agent's
-own writes are `agent` or `pipeline`. Three rules ask `isUserChannel`:
+own writes are `agent` or `pipeline`. Three rules ask `viableCardHelper.isUserChannel`:
 
 - the balance refusal — `ConnectOutOfCredits` for `connect`, `AgentOutOfTokens` otherwise;
 - re-formatting a narrative through the analyst — `web`/`connect` only;
@@ -188,11 +188,11 @@ own writes are `agent` or `pipeline`. Three rules ask `isUserChannel`:
 
 ### Card helpers and the design port
 
-`isViableProject` / `isViableStory` check kind AND type. `projectBriefOf(project, specs)` assembles
+`viableCardHelper.isViableProject` / `.isViableStory` check kind AND type. `viableSpecHelper.projectBriefOf(project, specs)` assembles
 the `AgentProject` brief (highest revision per part, `''` for an unwritten part, `alias` from the
-code). `userStoryOf(card, design?)` builds the coders' aggregate — the card wins on narrative,
-code, area and actor, the design supplies entities and screens; `userStoryOfDesign(design)` is the
-design-only reading. `storyDraftOf(card)` feeds the analysis prompts and moderation.
+code). `viableCardHelper.userStoryOf(card, design?)` builds the coders' aggregate — the card wins on narrative,
+code, area and actor, the design supplies entities and screens; `storyDesignHelper.userStoryOfDesign(design)` is the
+design-only reading. `viableCardHelper.storyDraftOf(card)` feeds the analysis prompts and moderation.
 `ExecutionState.projectCard` and `TaskExecutionState.card` carry the cards as plain data.
 
 `StoryDesignPort` is addressed by CARD id — `current(cardId)` and
@@ -226,6 +226,18 @@ schema, and a count the model should respect lives in the `description` and is c
 never as `minItems`/`maxItems`. The descriptions are what the planning model reads; `gate.target`
 is filled by code and described as such.
 
+**One reading of the landing page.** What a guest home draws is decided by the pure
+`landingPlanHelper` beside the schema, never re-derived by a consumer: `landingBandsOf` (the bands, in `LANDING_BAND_ORDER`,
+one presence rule each), `landingMenuOf` (the header menu: present bands only, page order, capped,
+padded to `LANDING_MENU.min`) and `homeSlotsOf` (the buttons a home link can attach to; a gate with
+fields removes `LANDING_GATE_SLOTS`). The optional bands (`useCases`, `differentiator`, `approach`,
+`about`) each carry a `basis` copied word for word from a source and checked downstream;
+`testimonials` is optional; `links` absent/`null` means undecided, `[]` decided none.
+`linksDecided` (optional, nullable, strings) lists the story codes whose links were decided at
+DEVELOPMENT time — a decision of no control included; absent on a plan whose links the planner
+decided. It is written by code only, so `ScaffoldPlanAnswerSchema` leaves it out of what the model
+is offered while the stored `ScaffoldPlanSchema` validates it.
+
 **A field that crosses a version skew carries no `enum`.** Users run `viable-mcp` from a moving
 `npx` range against a separately deployed platform, so `ConnectCapabilitiesSchema.executors.items`
 is a bare string: a newer executor kind is an unused capability on an older platform, never a
@@ -262,6 +274,10 @@ DEPLOYMENT's parts are injected: the guard alias, the ownership gate, and the pa
   `ConnectProjectStatus.project` flattens the project card into a parent agent's names (`name` =
   title, `alias` = code, the three brief bodies) plus `status` and `intrinsic`;
   `ConnectConfirmBody` carries the three brief parts including `designSystem`.
+- `convert.start` and `convert.proceed` carry `confirm?: boolean` (`ConnectConvertStartBody(Schema)`
+  — the start's whole body — and `ConnectConvertProceedBody(Schema)`): a PERSON agreed to what the
+  step costs. The platform refuses a step that would use the plan's conversion or spend credits
+  without it (`ConnectConfirmationRequired`); a `null` is "not confirmed", never a refused body.
 - Branding routes hang under `base` (guard + ownership gate, no paid gate). The save body
   (`ConnectProjectBrandingSaveSchema`) is a PATCH of strings with structural bounds only
   (`CONNECT_BRANDING_*_MAX`, each equal to its platform twin); value acceptability is the
@@ -291,7 +307,7 @@ different ones) and the manager web agree on every address, schema and step. Pla
 - **`intentFlow` is walked on both sides and never becomes the live flow model.** `compose`
   (initial, the site) →`handoff`→ `land` (initial, the landing) →`review`→ `review` (`HOME`), plus
   the EXPLICIT `land` →`sign-in`→ `sign-in` (`DISPATCHER`) →`next`→ `review`. A signed-out visitor
-  is parked with `suspendFlow` at `sign-in`. The parameter is `?ref=` — never `?flow=` (`web-flow`
+  is parked with `flowLandingOf(context).suspendFlow` at `sign-in`. The parameter is `?ref=` — never `?flow=` (`web-flow`
   parses it on every page load) and never `?intent=` (the login surrogate window owns it).
 - **CORS is not declared here**: the routes ride the global `origin: '*'` (no credentials);
   `makeIntentProtocols` carries a `TODO(cors)` naming the origins to keep if that is restricted.
@@ -322,7 +338,7 @@ on the type only; the Google tag's CSP hosts never travel in it — the publishe
 (`technology`, `stack`, `template`, `createApp`, `packages`) and one OPTIONAL `experience` layer —
 what the product does for its users, changing no dependency and no coder prompt. Read `experience`
 only through a total helper: `landingGatePreferenceOf` (`LandingGatePreference.Allow` for no layer,
-no key or an unknown value) and `tenancyOf`. An execution carries a `BlueprintRef` — `id`,
+no key or an unknown value) and `tenancyHelper.tenancyOf`. An execution carries a `BlueprintRef` — `id`,
 optional `case`, optional `tenancy`, an override patch — never a resolved blueprint.
 
 `BlueprintCase` (`web`, `scalable`, `ai-pipeline`, `ai-agent`, `game`, `work-management`,
@@ -369,7 +385,7 @@ skips an unresolved alias — a missing body is a rule no model receives.
 - **`SubProject`** — a ROLE vocabulary mapped per layout (`ROLE_DIRS`), never joined onto a path.
   Both generations arrive on the wire, so the enum stays total over what any live agent sends, and
   no role but `Common` resolves to the `common` directory.
-- **`ConversionStage`** — advanced only through `stageAfter` / `canEnter` / `decisionFor`; a
+- **`ConversionStage`** — advanced only through `conversionStageHelper.stageAfter` / `.canEnter` / `.decisionFor`; a
   transition computed at a call site re-enters a stage already paid for.
 - **`ModerationCategory`** — a wire contract with eight languages of wording behind it; a fifth
   shape is PHRASED into one of the four, never added.
@@ -385,7 +401,7 @@ one allowed difference is stated: the platform's two keep what a volume it owns
 SDK's keeps what a DEVELOPER owns (`.viable`, the two `.env` files).
 
 `docs/conversion/` is addressed only through the path builders (`CONVERSION_*_FILE`,
-`conversionStoryDoc`, `conversionSeedDoc`) — the purge reads them back, and a path spelled at a
+`conversionDocHelper.conversionStoryDoc`, `.conversionSeedDoc`) — the purge reads them back, and a path spelled at a
 call site is a file the purge leaves behind.
 
 ## The inquiry vocabulary is a deliberate COPY; the ceiling is not
@@ -404,16 +420,23 @@ silently at the smaller; never introduce a local cap.
 
 `ConnectError` and its family (`ConnectSessionNotFound`, `ConnectSessionGone`, `ConnectOpTimeout`,
 `ConnectOpRefused`, `LocalSlotUnsupported`, `ConnectOpUnknown`, `ConnectOutOfCredits`,
-`ConnectConsentRequired`) are `ResilientError` classes with `viable-connect:` markers. The two
-refusals a connector phrases for a person pack their fields into the message (only `type` and
-`message` survive a marshal), are built with `static encode(...)` and rebuilt in
-`finalizeUnmarshal()`:
+`ConnectConsentRequired`, `ConnectConfirmationRequired`) are `ResilientError` classes with
+`viable-connect:` markers. The three refusals a connector phrases for a person pack their fields
+into the message (only `type` and `message` survive a marshal), are built with `static encode(...)`
+and rebuilt in `finalizeUnmarshal()`:
 
 - `ConnectOutOfCredits` — `out-of-credits:<gate>:<requiredUsd>:<balanceUsd>:<encodeURIComponent(topUpUrl)>`;
 - `ConnectConsentRequired` — `consent-required:<gate>:<deadline epoch ms | 0>:<encodeURIComponent(consentUrl)>`
   (`0` = unknown; epoch ms and the URL last because ISO dates and URLs contain colons). It is the
   connector's face of the EU spend consent (`PerformanceConsentRequired` on the web, `/payment`):
-  only a PERSON gives it, in the browser at `consentUrl`.
+  only a PERSON gives it, in the browser at `consentUrl`;
+- `ConnectConfirmationRequired` — `confirmation-required:<action>:<cap>:<spent>:<estimate>:<fromAllowance>:<fromCreditLimits>:<moneyUsd>`,
+  `encode(fields: ConnectConfirmation)` and its inverse `decode(packed)` (an unreadable number reads
+  back as `0`, never `NaN`). A conversion verb (`action`: `convert-start` / `convert-proceed`) would
+  use the plan's conversion or spend credits: `cap` and `spent` are the conversion limit and what the
+  conversion used of it (`0` with no plan unit), `estimate` the stage's, split into `fromAllowance`
+  and `fromCreditLimits` (credits) and `moneyUsd` (topped-up credits, the only money figure). A person
+  agrees in the CONVERSATION and the caller repeats the call with `confirm: true`.
 
 `ConnectSessionGone` is registered FATAL on the agent side: the step fails as an OUTCOME, so the
 run row records where it stopped and `pipeline.resume` picks it up when a connector returns.
@@ -432,7 +455,7 @@ refuses an exported class whose status was not decided:
 | Status | Classes |
 |---|---|
 | 402 | `ConnectOutOfCredits` |
-| 428 | `ConnectConsentRequired` |
+| 428 | `ConnectConsentRequired`, `ConnectConfirmationRequired` |
 | 404 | `ProjectNotFound`, `ProjectStoryNotFound`, `ConnectSessionNotFound`, `ConnectOpUnknown` |
 | 409 | `ProjectAgentOccupied`, `ProjectStoryMissconfigured`, `ConnectSessionGone` (no connector attached), `LocalSlotUnsupported` |
 | 422 | `ConnectOpRefused` |
@@ -449,15 +472,15 @@ the manager's `useErrorPhrase` read the same substrings. A marker change changes
 | File | Pins |
 |---|---|
 | `planning.spec.ts` | the two flows and transition tables, type declarations, slots, code policies, reserved types outside `cardTypes`, field schemas (null optionals, refused strays and closed-set values), landing fields and sentence, the tenancy decision, the work kind and bounded case quote, card helpers, the `follows` anchor, refusal type names after a marshal |
-| `tenancy.spec.ts` | `NO_TENANCY` frozen, `tenancyOf` defaults and the literal-`true` rule, `tenantedArea` |
+| `tenancy.spec.ts` | `NO_TENANCY` frozen, `tenancyHelper.tenancyOf` defaults and the literal-`true` rule, `.tenantedArea` |
 | `access-schema.spec.ts` | the model-facing access schema: model keys only, byte-identical |
-| `scaffold.spec.ts` | old- and new-shape plans passing the schema and slot, `null` optionals, no `minItems` |
+| `scaffold.spec.ts` | old- and new-shape plans passing the schema and slot, `null` optionals, no `minItems`, closed anchors/slots, the landing helpers |
 | `blueprint.spec.ts` · `branding.spec.ts` | `landingGatePreferenceOf` defaults · the build env and metadata vocabulary |
-| `connect-entrypoints.spec.ts` · `connect-convert.spec.ts` | every route's method and path, aliases = `connectRef`, the paid gate on the delegated session alone, no socket or story route, branding body, the kit routes and their closed shapes · conversion routes, an unknown executor kind accepted |
+| `connect-entrypoints.spec.ts` · `connect-convert.spec.ts` | every route's method and path, aliases = `connectRef`, the paid gate on the delegated session alone, no socket or story route, branding body, the kit routes and their closed shapes · conversion routes, the start's body and both verbs' `confirm`, an unknown executor kind accepted |
 | `convert.spec.ts` | the three structural walks over the barrel, nullable enums under Ajv, census classifiers, stage transitions |
-| `design.spec.ts` | the design aggregate, staleness ranking, schema refusals, `userStoryOfDesign` |
-| `error-status.spec.ts` · `connect-errors.spec.ts` | declared statuses through a marshal · packed refusal fields fresh and after a round trip |
-| `intent.spec.ts` | the four declarations without guards, schema cases incl. crafted refs, the flow walk and `suspendFlow` payload, error statuses |
+| `design.spec.ts` | the design aggregate, staleness ranking, schema refusals, `storyDesignHelper.userStoryOfDesign` |
+| `error-status.spec.ts` · `connect-errors.spec.ts` | declared statuses through a marshal · packed refusal fields fresh and after a round trip, the confirmation's `decode` |
+| `intent.spec.ts` | the four declarations without guards, schema cases incl. crafted refs, the flow walk and `flowLandingOf(context).suspendFlow` payload, error statuses |
 | `presentation.spec.ts` | the agent-output classifier (`/agent-presentation`) |
 
 ## Depends On
@@ -476,7 +499,7 @@ the manager's `useErrorPhrase` read the same substrings. A marker change changes
 
 - [[viable-sdk]] · [[viable-mcp]] — the connector SDK written against these contracts, and its npx
   stdio server
-- [[flow]] · [[client-flow]] — the model `intentFlow` is walked with, and `suspendFlow`
+- [[flow]] · [[client-flow]] — the model `intentFlow` is walked with, and `flowLandingOf(context).suspendFlow`
 - [[inquiry]] · [[llm-common]] — the primitive `InquiryPayload` mirrors; the model runtime's contracts
 - [[planning]] — the workcard model the planning module builds on
 - DOMAIN meaning lives downstream (`target-areas`, `target-tenancy`, `scaffolding`,

package/build/agent/consts.d.ts

@@ -0,0 +1,58 @@
+/**
+ * A compact, runtime-free description of how an agent message should be presented.
+ *
+ * The server emits this with thinking events and the browser refines it as streaming output
+ * becomes parseable. Keeping the vocabulary here prevents the two runtimes from drifting into
+ * their own guesses about the same model response.
+ */
+export declare enum AgentMessageCategory {
+    Code = "code",
+    Diff = "diff",
+    Structured = "structured",
+    Markdown = "markdown",
+    Plain = "plain"
+}
+export declare enum AgentCodeLanguage {
+    ReactTsx = "react-tsx",
+    Css = "css",
+    TypeScript = "typescript",
+    Json = "json",
+    Other = "other"
+}
+/** A semantic shape that the manager can render as a purpose-built card. */
+export declare enum AgentStructuredKind {
+    ToolCalls = "tool-calls",
+    ArtifactSelection = "artifact-selection",
+    EntitySelection = "entity-selection",
+    StoryPlan = "story-plan",
+    ScreenPlan = "screen-plan",
+    ComponentPlan = "component-plan",
+    TransitionPlan = "transition-plan",
+    EntrypointSelection = "entrypoint-selection",
+    AccessPolicy = "access-policy",
+    ScaffoldPlan = "scaffold-plan",
+    RuntimeDecision = "runtime-decision",
+    CandidateRanking = "candidate-ranking",
+    Decision = "decision",
+    GenericRecord = "generic-record",
+    GenericList = "generic-list",
+    GenericValue = "generic-value"
+}
+export declare enum AgentMarkdownKind {
+    Specification = "specification",
+    DesignDocument = "design-document",
+    Documentation = "documentation"
+}
+/** The family of specialist that produced an output, not an authorization role. */
+export declare enum AgentMessageRole {
+    Technical = "technical",
+    Analytical = "analytical",
+    Product = "product",
+    Ux = "ux",
+    VisualDesign = "visual-design",
+    Architect = "architect",
+    Developer = "developer",
+    Repair = "repair",
+    Orchestrator = "orchestrator"
+}
+//# sourceMappingURL=consts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/agent/consts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,KAAK,UAAU;CAChB;AAED,oBAAY,iBAAiB;IAC3B,QAAQ,cAAc;IACtB,GAAG,QAAQ;IACX,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,4EAA4E;AAC5E,oBAAY,mBAAmB;IAC7B,SAAS,eAAe;IACxB,iBAAiB,uBAAuB;IACxC,eAAe,qBAAqB;IACpC,SAAS,eAAe;IACxB,UAAU,gBAAgB;IAC1B,aAAa,mBAAmB;IAChC,cAAc,oBAAoB;IAClC,mBAAmB,yBAAyB;IAC5C,YAAY,kBAAkB;IAC9B,YAAY,kBAAkB;IAC9B,eAAe,qBAAqB;IACpC,gBAAgB,sBAAsB;IACtC,QAAQ,aAAa;IACrB,aAAa,mBAAmB;IAChC,WAAW,iBAAiB;IAC5B,YAAY,kBAAkB;CAC/B;AAED,oBAAY,iBAAiB;IAC3B,aAAa,kBAAkB;IAC/B,cAAc,oBAAoB;IAClC,aAAa,kBAAkB;CAChC;AAED,mFAAmF;AACnF,oBAAY,gBAAgB;IAC1B,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,EAAE,OAAO;IACT,YAAY,kBAAkB;IAC9B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,YAAY,iBAAiB;CAC9B"}

package/build/agent/consts.js

@@ -0,0 +1,63 @@
+/**
+ * A compact, runtime-free description of how an agent message should be presented.
+ *
+ * The server emits this with thinking events and the browser refines it as streaming output
+ * becomes parseable. Keeping the vocabulary here prevents the two runtimes from drifting into
+ * their own guesses about the same model response.
+ */
+export var AgentMessageCategory;
+(function (AgentMessageCategory) {
+    AgentMessageCategory["Code"] = "code";
+    AgentMessageCategory["Diff"] = "diff";
+    AgentMessageCategory["Structured"] = "structured";
+    AgentMessageCategory["Markdown"] = "markdown";
+    AgentMessageCategory["Plain"] = "plain";
+})(AgentMessageCategory || (AgentMessageCategory = {}));
+export var AgentCodeLanguage;
+(function (AgentCodeLanguage) {
+    AgentCodeLanguage["ReactTsx"] = "react-tsx";
+    AgentCodeLanguage["Css"] = "css";
+    AgentCodeLanguage["TypeScript"] = "typescript";
+    AgentCodeLanguage["Json"] = "json";
+    AgentCodeLanguage["Other"] = "other";
+})(AgentCodeLanguage || (AgentCodeLanguage = {}));
+/** A semantic shape that the manager can render as a purpose-built card. */
+export var AgentStructuredKind;
+(function (AgentStructuredKind) {
+    AgentStructuredKind["ToolCalls"] = "tool-calls";
+    AgentStructuredKind["ArtifactSelection"] = "artifact-selection";
+    AgentStructuredKind["EntitySelection"] = "entity-selection";
+    AgentStructuredKind["StoryPlan"] = "story-plan";
+    AgentStructuredKind["ScreenPlan"] = "screen-plan";
+    AgentStructuredKind["ComponentPlan"] = "component-plan";
+    AgentStructuredKind["TransitionPlan"] = "transition-plan";
+    AgentStructuredKind["EntrypointSelection"] = "entrypoint-selection";
+    AgentStructuredKind["AccessPolicy"] = "access-policy";
+    AgentStructuredKind["ScaffoldPlan"] = "scaffold-plan";
+    AgentStructuredKind["RuntimeDecision"] = "runtime-decision";
+    AgentStructuredKind["CandidateRanking"] = "candidate-ranking";
+    AgentStructuredKind["Decision"] = "decision";
+    AgentStructuredKind["GenericRecord"] = "generic-record";
+    AgentStructuredKind["GenericList"] = "generic-list";
+    AgentStructuredKind["GenericValue"] = "generic-value";
+})(AgentStructuredKind || (AgentStructuredKind = {}));
+export var AgentMarkdownKind;
+(function (AgentMarkdownKind) {
+    AgentMarkdownKind["Specification"] = "specification";
+    AgentMarkdownKind["DesignDocument"] = "design-document";
+    AgentMarkdownKind["Documentation"] = "documentation";
+})(AgentMarkdownKind || (AgentMarkdownKind = {}));
+/** The family of specialist that produced an output, not an authorization role. */
+export var AgentMessageRole;
+(function (AgentMessageRole) {
+    AgentMessageRole["Technical"] = "technical";
+    AgentMessageRole["Analytical"] = "analytical";
+    AgentMessageRole["Product"] = "product";
+    AgentMessageRole["Ux"] = "ux";
+    AgentMessageRole["VisualDesign"] = "visual-design";
+    AgentMessageRole["Architect"] = "architect";
+    AgentMessageRole["Developer"] = "developer";
+    AgentMessageRole["Repair"] = "repair";
+    AgentMessageRole["Orchestrator"] = "orchestrator";
+})(AgentMessageRole || (AgentMessageRole = {}));
+//# sourceMappingURL=consts.js.map

package/build/agent/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/agent/consts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC9B,qCAAa,CAAA;IACb,qCAAa,CAAA;IACb,iDAAyB,CAAA;IACzB,6CAAqB,CAAA;IACrB,uCAAe,CAAA;AACjB,CAAC,EANW,oBAAoB,KAApB,oBAAoB,QAM/B;AAED,MAAM,CAAN,IAAY,iBAMX;AAND,WAAY,iBAAiB;IAC3B,2CAAsB,CAAA;IACtB,gCAAW,CAAA;IACX,8CAAyB,CAAA;IACzB,kCAAa,CAAA;IACb,oCAAe,CAAA;AACjB,CAAC,EANW,iBAAiB,KAAjB,iBAAiB,QAM5B;AAED,4EAA4E;AAC5E,MAAM,CAAN,IAAY,mBAiBX;AAjBD,WAAY,mBAAmB;IAC7B,+CAAwB,CAAA;IACxB,+DAAwC,CAAA;IACxC,2DAAoC,CAAA;IACpC,+CAAwB,CAAA;IACxB,iDAA0B,CAAA;IAC1B,uDAAgC,CAAA;IAChC,yDAAkC,CAAA;IAClC,mEAA4C,CAAA;IAC5C,qDAA8B,CAAA;IAC9B,qDAA8B,CAAA;IAC9B,2DAAoC,CAAA;IACpC,6DAAsC,CAAA;IACtC,4CAAqB,CAAA;IACrB,uDAAgC,CAAA;IAChC,mDAA4B,CAAA;IAC5B,qDAA8B,CAAA;AAChC,CAAC,EAjBW,mBAAmB,KAAnB,mBAAmB,QAiB9B;AAED,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,oDAA+B,CAAA;IAC/B,uDAAkC,CAAA;IAClC,oDAA+B,CAAA;AACjC,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B;AAED,mFAAmF;AACnF,MAAM,CAAN,IAAY,gBAUX;AAVD,WAAY,gBAAgB;IAC1B,2CAAuB,CAAA;IACvB,6CAAyB,CAAA;IACzB,uCAAmB,CAAA;IACnB,6BAAS,CAAA;IACT,kDAA8B,CAAA;IAC9B,2CAAuB,CAAA;IACvB,2CAAuB,CAAA;IACvB,qCAAiB,CAAA;IACjB,iDAA6B,CAAA;AAC/B,CAAC,EAVW,gBAAgB,KAAhB,gBAAgB,QAU3B"}

package/build/agent/consts.local.d.ts

@@ -0,0 +1,21 @@
+import { AgentMarkdownKind, AgentStructuredKind } from './consts.js';
+export declare const documentActions: Record<string, AgentMarkdownKind>;
+export declare const codeActions: Set<string>;
+/**
+ * The model's schema makes the final output self-describing; while it streams, the helper action
+ * gives the client the same semantic cue before a complete JSON value exists.
+ */
+export declare const structuredActions: Record<string, AgentStructuredKind>;
+/**
+ * Classifies known model output by source AND shape. The `value` comes from a caller's JSON
+ * parser; this runtime-free package intentionally never repairs or parses streamed JSON itself.
+ */
+/**
+ * Actions run by an unconstrained tool-calling loop (the coding agent, the repair/architect/
+ * lookup sub-agents, source extraction) rather than a single pinned-schema call. Their tool calls
+ * are file/shell operations, not model-schema output, so they always render as ToolCalls even
+ * when a call's arguments happen to shape-match a schema kind — `read_sources({ files })` looks
+ * exactly like an ArtifactSelection.
+ */
+export declare const agentLoopActions: Set<string>;
+//# sourceMappingURL=consts.local.d.ts.map

package/build/agent/consts.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../../src/agent/consts.local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEpE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAO7D,CAAA;AAED,eAAO,MAAM,WAAW,aAAuD,CAAA;AAE/E;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAajE,CAAA;AAED;;;GAGG;AACH;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,aAG3B,CAAA"}

package/build/agent/consts.local.js

@@ -0,0 +1,44 @@
+import { AgentMarkdownKind, AgentStructuredKind } from './consts.js';
+export const documentActions = {
+    'write-specification': AgentMarkdownKind.Specification,
+    'summarize-specification': AgentMarkdownKind.Specification,
+    'write-design-concept': AgentMarkdownKind.DesignDocument,
+    'describe-ui-component': AgentMarkdownKind.DesignDocument,
+    'describe-ui-screen': AgentMarkdownKind.DesignDocument,
+    'describe-ui-layout': AgentMarkdownKind.DesignDocument,
+};
+export const codeActions = new Set(['code', 'update-code', 'update-code-full']);
+/**
+ * The model's schema makes the final output self-describing; while it streams, the helper action
+ * gives the client the same semantic cue before a complete JSON value exists.
+ */
+export const structuredActions = {
+    'choose-files-for-fix': AgentStructuredKind.ArtifactSelection,
+    'list-files-to-fix': AgentStructuredKind.ArtifactSelection,
+    'extract-user-stories-from-spec': AgentStructuredKind.StoryPlan,
+    'derive-connecting-stories': AgentStructuredKind.StoryPlan,
+    'derive-area-scaffold-stories': AgentStructuredKind.StoryPlan,
+    'describe-ux-story-transitions': AgentStructuredKind.TransitionPlan,
+    'find-entrypoint-for-screen': AgentStructuredKind.EntrypointSelection,
+    'describe-api-access': AgentStructuredKind.AccessPolicy,
+    'describe-screen-access': AgentStructuredKind.AccessPolicy,
+    'plan-scaffold': AgentStructuredKind.ScaffoldPlan,
+    'runtime-gate': AgentStructuredKind.RuntimeDecision,
+    'detect-story-with-home-screen': AgentStructuredKind.CandidateRanking,
+};
+/**
+ * Classifies known model output by source AND shape. The `value` comes from a caller's JSON
+ * parser; this runtime-free package intentionally never repairs or parses streamed JSON itself.
+ */
+/**
+ * Actions run by an unconstrained tool-calling loop (the coding agent, the repair/architect/
+ * lookup sub-agents, source extraction) rather than a single pinned-schema call. Their tool calls
+ * are file/shell operations, not model-schema output, so they always render as ToolCalls even
+ * when a call's arguments happen to shape-match a schema kind — `read_sources({ files })` looks
+ * exactly like an ArtifactSelection.
+ */
+export const agentLoopActions = new Set([
+    'coding-agent-ask', 'arbitrary-modification', 'fix-agent', 'architect', 'declaration-lookup',
+    'source-extract',
+]);
+//# sourceMappingURL=consts.local.js.map

package/build/agent/consts.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../../src/agent/consts.local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEpE,MAAM,CAAC,MAAM,eAAe,GAAsC;IAChE,qBAAqB,EAAE,iBAAiB,CAAC,aAAa;IACtD,yBAAyB,EAAE,iBAAiB,CAAC,aAAa;IAC1D,sBAAsB,EAAE,iBAAiB,CAAC,cAAc;IACxD,uBAAuB,EAAE,iBAAiB,CAAC,cAAc;IACzD,oBAAoB,EAAE,iBAAiB,CAAC,cAAc;IACtD,oBAAoB,EAAE,iBAAiB,CAAC,cAAc;CACvD,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAwC;IACpE,sBAAsB,EAAE,mBAAmB,CAAC,iBAAiB;IAC7D,mBAAmB,EAAE,mBAAmB,CAAC,iBAAiB;IAC1D,gCAAgC,EAAE,mBAAmB,CAAC,SAAS;IAC/D,2BAA2B,EAAE,mBAAmB,CAAC,SAAS;IAC1D,8BAA8B,EAAE,mBAAmB,CAAC,SAAS;IAC7D,+BAA+B,EAAE,mBAAmB,CAAC,cAAc;IACnE,4BAA4B,EAAE,mBAAmB,CAAC,mBAAmB;IACrE,qBAAqB,EAAE,mBAAmB,CAAC,YAAY;IACvD,wBAAwB,EAAE,mBAAmB,CAAC,YAAY;IAC1D,eAAe,EAAE,mBAAmB,CAAC,YAAY;IACjD,cAAc,EAAE,mBAAmB,CAAC,eAAe;IACnD,+BAA+B,EAAE,mBAAmB,CAAC,gBAAgB;CACtE,CAAA;AAED;;;GAGG;AACH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IACtC,kBAAkB,EAAE,wBAAwB,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB;IAC5F,gBAAgB;CACjB,CAAC,CAAA"}

package/build/agent/index.d.ts

@@ -1,5 +1,7 @@
 export type * from './types.js';
+export type * from './presentation/types.js';
 export * from './spectator/index.js';
 export * from './memory.js';
 export * from './presentation.js';
+export * from './consts.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,yBAAyB,CAAA;AAC5C,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA"}

package/build/agent/index.js

@@ -1,4 +1,5 @@
 export * from './spectator/index.js';
 export * from './memory.js';
 export * from './presentation.js';
+export * from './consts.js';
 //# sourceMappingURL=index.js.map

package/build/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAGA,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA"}

package/build/agent/presentation/types.d.ts

@@ -0,0 +1,21 @@
+import type { AgentCodeLanguage, AgentMessageRole } from '../consts.js';
+import type { AgentMessageClassificationInput, AgentMessagePresentation } from '../types.js';
+/** How an agent's thinking event is presented: its specialist family, its language, its card. */
+export interface AgentPresentationHelper {
+    /**
+     * Source extraction is an internal context-reduction pass. Its terminal tool call contains only
+     * line ranges, which are useful to the coder but add no useful information to a person's journal.
+     */
+    isAgentMessageHidden: (input: AgentMessageClassificationInput) => boolean;
+    /** Maps the attribution that reached the event boundary to the visual specialist family. */
+    agentMessageRoleOf: (input: AgentMessageClassificationInput) => AgentMessageRole;
+    /** Pulls a schema argument out of LangChain's serialised tool-call shape. */
+    agentToolCallArguments: (value: unknown) => unknown;
+    /** Finds the language of a unified diff from its destination (or source) file path. */
+    agentDiffLanguageOf: (text: string) => AgentCodeLanguage;
+    /** Conservative code detection; prose with one identifier remains plain text. */
+    agentCodeLanguageOf: (text: string) => AgentCodeLanguage;
+    isUnifiedDiff: (text: string) => boolean;
+    classifyAgentMessage: (input: AgentMessageClassificationInput) => AgentMessagePresentation;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/agent/presentation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/presentation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACvE,OAAO,KAAK,EAAE,+BAA+B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAE5F,iGAAiG;AACjG,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,oBAAoB,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,OAAO,CAAA;IACzE,4FAA4F;IAC5F,kBAAkB,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,gBAAgB,CAAA;IAChF,6EAA6E;IAC7E,sBAAsB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;IACnD,uFAAuF;IACvF,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAA;IACxD,iFAAiF;IACjF,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAA;IACxD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACxC,oBAAoB,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,wBAAwB,CAAA;CAC3F"}

package/build/agent/presentation/types.js.map

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