@owlmeans/viable-common 0.0.42 → 0.0.44

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.42
+bun add @owlmeans/viable-common@^0.0.44
 ```
 
 ## 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.40` and talks to a separately deployed platform, so an executor kind it
+`npx -y @owlmeans/viable-mcp@^0.1.18-rc.42` 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.48
 ```
 
 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.42",
-  "generatedAt": "2026-10-03T15:33:53.025Z",
+  "version": "0.0.44",
+  "generatedAt": "2026-10-05T08:32:19.128Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -6,7 +6,7 @@ description: Shared, runtime-free taxonomy for presenting OwlMeans Viable agent
 
 # Agent output presentation
 
-**Install:** `"@owlmeans/viable-common": "^0.0.42"` in `dependencies`
+**Install:** `"@owlmeans/viable-common": "^0.0.44"` 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

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.42"` in `dependencies`
+**Install:** `"@owlmeans/viable-common": "^0.0.44"` 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,9 +31,9 @@ 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`, `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 |
+| `.` (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` (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 (`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 |
+| `./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 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 `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` |
 | `./intent` | `intent` (the four aliases), `makeIntentProtocols(opts?)`, `intentFlow` + `IntentFlowStep` + `INTENT_PAYLOAD_REF`, `IntentStashBodySchema` / `IntentPickupBodySchema`, the `INTENT_*` constants, `IntentDraft`, `IntentExpired` (404) / `IntentThrottled` (429) |
@@ -98,7 +98,7 @@ the wire and in target files — a parent agent's vocabulary, which never change
 | project `id` / story `id` | `id` (a card id) |
 | project `alias` / `name` / `description` | `code` / `title` / `description` |
 | project `specification` / `vision` / `designSystem` | specification bodies, categories `specification` / `vision` / `design-system` |
-| project `formerAliases`, `language`, `blueprint`, `blueprintCase`, `gameKind`, `target`, `origin`, `connectLlmMode`, `converterLlmMode` | `fields.*` |
+| project `formerAliases`, `language`, `blueprint`, `blueprintCase`, `gameKind`, `workKind`, `caseQuote`, `target`, `origin`, `connectLlmMode`, `converterLlmMode` | `fields.*` |
 | the landing-gate decision | project `fields.landing` — `{ story: code \| null, at }` |
 | the tenancy decision | project `fields.tenancy` — `ViableTenancyDecision` `{ operators, users, quotes?, by: 'model' \| 'owner', at }` |
 | story narrative (`story`) / `code` / `status` | `title` / `code` / `status` (same strings) |
@@ -262,6 +262,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
@@ -325,8 +329,15 @@ only through a total helper: `landingGatePreferenceOf` (`LandingGatePreference.A
 no key or an unknown value) and `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`) and `GameKind` are what
-`fields.blueprintCase` / `fields.gameKind` carry. What a case MEANS (`BLUEPRINT_CASES`,
+`BlueprintCase` (`web`, `scalable`, `ai-pipeline`, `ai-agent`, `game`, `work-management`,
+`work-management-tenanted`) and `GameKind` are what `fields.blueprintCase` / `fields.gameKind`
+carry. `work-management-tenanted` is never classified directly: code picks it from
+`work-management` when the project's tenancy decision has a flag on. `WorkKind` (`project`, `crm`,
+`service-desk`, `inventory`, `recruiting`, `field-service`, `process`) is `fields.workKind` — which
+ready-made card types and flows a work-management product starts from, changing no dependency —
+and `fields.caseQuote` (≤ `CASE_QUOTE_MAX`) is the requester's sentence that case was verified
+against. `TemplateLayer.seeds` names case seed directories under the overlay's `.cases/`, copied
+over the staged tree in order (names, never paths; a variant lists its base seed first). What a case MEANS (`BLUEPRINT_CASES`,
 `applyBlueprintCase`, `applyBlueprintPatch` / `freezeBlueprint`, `joinPersonaSkills`, the
 classification schema) lives in `@owlmeans/viable` (`/blueprints`, `/blueprint-cases`); that table
 is `Record<BlueprintCase, …>`, so a new member fails to compile there until it has a row.
@@ -397,16 +408,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.
@@ -425,7 +443,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` |
@@ -441,15 +459,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, card helpers, the `follows` anchor, refusal type names after a marshal |
+| `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` |
 | `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` |
 | `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 |
+| `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 `suspendFlow` payload, error statuses |
 | `presentation.spec.ts` | the agent-output classifier (`/agent-presentation`) |
 

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

@@ -2,4 +2,5 @@ export type * from './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,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":"AAEA,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA"}

package/build/agent/presentation.d.ts

@@ -1,89 +1,5 @@
-/**
- * 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"
-}
-export interface AgentCodePresentation {
-    category: AgentMessageCategory.Code | AgentMessageCategory.Diff;
-    language: AgentCodeLanguage;
-    role: AgentMessageRole;
-}
-export interface AgentStructuredPresentation {
-    category: AgentMessageCategory.Structured;
-    structure: AgentStructuredKind;
-    role: AgentMessageRole;
-}
-export interface AgentMarkdownPresentation {
-    category: AgentMessageCategory.Markdown;
-    document: AgentMarkdownKind;
-    role: AgentMessageRole;
-}
-export interface AgentPlainPresentation {
-    category: AgentMessageCategory.Plain;
-    role: AgentMessageRole;
-}
-export type AgentMessagePresentation = AgentCodePresentation | AgentStructuredPresentation | AgentMarkdownPresentation | AgentPlainPresentation;
-/** The attribution and content available to either side of a thinking event. */
-export interface AgentMessageClassificationInput {
-    agent?: string;
-    helper?: string;
-    action?: string;
-    outputType?: string;
-    text?: string;
-    value?: unknown;
-}
+import { AgentCodeLanguage, AgentMessageRole } from './consts.js';
+import type { AgentMessageClassificationInput, AgentMessagePresentation } from './types.js';
 /**
  * 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.

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

@@ -1 +1 @@
-{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../src/agent/presentation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../src/agent/presentation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAA2C,gBAAgB,EAAuB,MAAM,aAAa,CAAA;AAE/H,OAAO,KAAK,EAAE,+BAA+B,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAc3F;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UAAW,+BAA+B,KAAG,OACxC,CAAA;AAEtC,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,UAAW,+BAA+B,KAAG,gBAgB3E,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,UAAW,OAAO,KAAG,OAIvD,CAAA;AAkDD,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,SAAU,MAAM,KAAG,iBAGlD,CAAA;AAaD,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,SAAU,MAAM,KAAG,iBAmBlD,CAAA;AAED,eAAO,MAAM,aAAa,SAAU,MAAM,KAAG,OACuD,CAAA;AAcpG,eAAO,MAAM,oBAAoB,UAAW,+BAA+B,KAAG,wBAsC7E,CAAA"}

package/build/agent/presentation.js

@@ -1,92 +1,5 @@
-/**
- * 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 = {}));
-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,
-};
-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.
- */
-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,
-};
+import { agentLoopActions, codeActions, documentActions, structuredActions } from './consts.local.js';
+import { AgentCodeLanguage, AgentMarkdownKind, AgentMessageCategory, AgentMessageRole, AgentStructuredKind } from './consts.js';
 const asRecord = (value) => value != null && typeof value === 'object' && !Array.isArray(value)
     ? value
     : undefined;
@@ -241,21 +154,6 @@ const markdownKindOf = (text) => {
     const listItems = text.match(/^\s*(?:[-*+]\s+|\d+[.)]\s+)/gm)?.length ?? 0;
     return listItems >= 2 ? AgentMarkdownKind.Documentation : undefined;
 };
-/**
- * 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.
- */
-const agentLoopActions = new Set([
-    'coding-agent-ask', 'arbitrary-modification', 'fix-agent', 'architect', 'declaration-lookup',
-    'source-extract',
-]);
 const isGenericStructure = (kind) => kind == null || kind === AgentStructuredKind.GenericRecord || kind === AgentStructuredKind.GenericList ||
     kind === AgentStructuredKind.GenericValue;
 export const classifyAgentMessage = (input) => {