@genesislcap/ai-assistant 15.27.0-agent-log-submit.3 → 15.27.1

package/dist/esm/state/persistence/session-persister.js

@@ -270,7 +270,7 @@ export class SessionPersister {
      */
     persistSession() {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
             const { provider, enabled } = this.deps.getPersistence();
             if (!enabled || !provider)
                 return;
@@ -288,7 +288,7 @@ export class SessionPersister {
             // mints fresh configs (the showcase) would otherwise hand us a never-activated
             // closure whose `serialize()` returns undefined.
             const liveSnapshots = {};
-            const liveActive = (_a = driver === null || driver === void 0 ? void 0 : driver.getActiveAgent) === null || _a === void 0 ? void 0 : _a.call(driver);
+            const liveActive = driver === null || driver === void 0 ? void 0 : driver.getActiveAgent();
             if (liveActive === null || liveActive === void 0 ? void 0 : liveActive.serialize) {
                 try {
                     const snap = liveActive.serialize();
@@ -344,7 +344,7 @@ export class SessionPersister {
                     sessionKey: key,
                     host: window.location.host,
                     messages: messages.slice(0, Math.min(boundary, messages.length)),
-                    activeAgentName: (_b = s.activeAgent) === null || _b === void 0 ? void 0 : _b.name,
+                    activeAgentName: (_a = s.activeAgent) === null || _a === void 0 ? void 0 : _a.name,
                     pinnedAgentName: s.pinnedAgentName,
                     flowOwnerAgentName: null,
                     sessionCostUsd: s.sessionUsage.costUsd,
@@ -365,7 +365,7 @@ export class SessionPersister {
                     return;
                 }
                 this.logMeta('persistence.suppressed', {
-                    agent: (_c = liveActive === null || liveActive === void 0 ? void 0 : liveActive.name) !== null && _c !== void 0 ? _c : null,
+                    agent: (_b = liveActive === null || liveActive === void 0 ? void 0 : liveActive.name) !== null && _b !== void 0 ? _b : null,
                     isFlowOwner: s.flowOwnerAgentName === (liveActive === null || liveActive === void 0 ? void 0 : liveActive.name),
                     frozeAtMessages: frozen.messages.length,
                     custom: !!(liveActive === null || liveActive === void 0 ? void 0 : liveActive.notResumableMessage),
@@ -382,7 +382,7 @@ export class SessionPersister {
                     // event was added to the resumable branch — so a session that broke while an agent was
                     // mid-flow still reported nothing at all, which is precisely the blind spot the
                     // user-facing warning exists to cover.
-                    this.recordSaveOutcome(false, (_d = e === null || e === void 0 ? void 0 : e.message) !== null && _d !== void 0 ? _d : String(e));
+                    this.recordSaveOutcome(false, (_c = e === null || e === void 0 ? void 0 : e.message) !== null && _c !== void 0 ? _c : String(e));
                     // Deliberately NOT reporting from here. This is the non-resumable branch and a reload is
                     // the modal's only action, so advising one now would destroy the in-flight work the
                     // snapshot could not carry. `recordSaveOutcome` has already set `_brokenSince`, so the
@@ -395,11 +395,11 @@ export class SessionPersister {
                     this.logMeta('persistence.save-failed', {
                         messages: frozen.messages.length,
                         agents: [],
-                        active: (_e = liveActive === null || liveActive === void 0 ? void 0 : liveActive.name) !== null && _e !== void 0 ? _e : null,
+                        active: (_d = liveActive === null || liveActive === void 0 ? void 0 : liveActive.name) !== null && _d !== void 0 ? _d : null,
                         hasSerialize: !!(liveActive === null || liveActive === void 0 ? void 0 : liveActive.serialize),
                         frozen: true,
-                        error: (_f = e === null || e === void 0 ? void 0 : e.name) !== null && _f !== void 0 ? _f : typeof e,
-                        message: (_g = e === null || e === void 0 ? void 0 : e.message) !== null && _g !== void 0 ? _g : String(e),
+                        error: (_e = e === null || e === void 0 ? void 0 : e.name) !== null && _e !== void 0 ? _e : typeof e,
+                        message: (_f = e === null || e === void 0 ? void 0 : e.message) !== null && _f !== void 0 ? _f : String(e),
                     });
                     logger.error('Session save (interrupted marker) failed:', e);
                 }
@@ -411,7 +411,7 @@ export class SessionPersister {
                 sessionKey: key,
                 host: window.location.host,
                 messages: [...messages],
-                activeAgentName: (_h = s.activeAgent) === null || _h === void 0 ? void 0 : _h.name,
+                activeAgentName: (_g = s.activeAgent) === null || _g === void 0 ? void 0 : _g.name,
                 pinnedAgentName: s.pinnedAgentName,
                 flowOwnerAgentName: s.flowOwnerAgentName,
                 sessionCostUsd: s.sessionUsage.costUsd,
@@ -435,7 +435,7 @@ export class SessionPersister {
             const captured = {
                 messages: messages.length,
                 agents: Object.keys(agentSnapshots),
-                active: (_j = liveActive === null || liveActive === void 0 ? void 0 : liveActive.name) !== null && _j !== void 0 ? _j : null,
+                active: (_h = liveActive === null || liveActive === void 0 ? void 0 : liveActive.name) !== null && _h !== void 0 ? _h : null,
                 hasSerialize: !!(liveActive === null || liveActive === void 0 ? void 0 : liveActive.serialize),
                 agentSnapshots,
             };
@@ -454,7 +454,7 @@ export class SessionPersister {
                 // means the body never reached the wire at all, because a provider builds its
                 // request body inside the `fetch` init, so a throw while serialising creates no
                 // request and leaves no server-side trace.
-                this.recordSaveOutcome(false, (_k = e === null || e === void 0 ? void 0 : e.message) !== null && _k !== void 0 ? _k : String(e));
+                this.recordSaveOutcome(false, (_j = e === null || e === void 0 ? void 0 : e.message) !== null && _j !== void 0 ? _j : String(e));
                 // Report straight away rather than waiting for the next attempt: we are on the resumable
                 // path, so a reload is safe NOW, and a one-cycle delay is a second of extra exposure for
                 // no benefit.
@@ -471,8 +471,8 @@ export class SessionPersister {
                     agents: captured.agents,
                     active: captured.active,
                     hasSerialize: captured.hasSerialize,
-                    error: (_l = e === null || e === void 0 ? void 0 : e.name) !== null && _l !== void 0 ? _l : typeof e,
-                    message: (_m = e === null || e === void 0 ? void 0 : e.message) !== null && _m !== void 0 ? _m : String(e),
+                    error: (_k = e === null || e === void 0 ? void 0 : e.name) !== null && _k !== void 0 ? _k : typeof e,
+                    message: (_l = e === null || e === void 0 ? void 0 : e.message) !== null && _l !== void 0 ? _l : String(e),
                 });
                 logger.error('Session save failed:', e);
             }
@@ -487,7 +487,7 @@ export class SessionPersister {
      */
     restore() {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e;
+            var _a, _b, _c, _d;
             const { provider } = this.deps.getPersistence();
             if (!provider)
                 return;
@@ -536,8 +536,8 @@ export class SessionPersister {
                 // Prime each stateful agent's persisted machine/state image FIRST — before
                 // seeding Redux or driver history — so the image is waiting on the driver no
                 // matter when the agent re-activates. The flow-owner lock self-heals on
-                // activation (OrchestratingDriver.applyAgent re-sets it).
-                (_a = driver === null || driver === void 0 ? void 0 : driver.primeRestoredAgentState) === null || _a === void 0 ? void 0 : _a.call(driver, snapshot.agentSnapshots);
+                // activation (OrchestratingDriver.installAgent re-sets it).
+                driver === null || driver === void 0 ? void 0 : driver.primeRestoredAgentState(snapshot.agentSnapshots);
                 // Seed the carry-forward cache so the immediate post-restore autosave (fired
                 // by the history change below, before any agent re-activates) preserves the
                 // machine snapshot instead of overwriting it with an empty one (GENC-1351).
@@ -550,7 +550,7 @@ export class SessionPersister {
                 // actually came back (meta events reset on reload, so this is the only window
                 // onto the saved→loaded handoff).
                 this.logMeta('persistence.restored', {
-                    agents: Object.keys((_b = snapshot.agentSnapshots) !== null && _b !== void 0 ? _b : {}),
+                    agents: Object.keys((_a = snapshot.agentSnapshots) !== null && _a !== void 0 ? _a : {}),
                     agentSnapshots: snapshot.agentSnapshots,
                     pinnedAgentName: snapshot.pinnedAgentName,
                     flowOwnerAgentName: snapshot.flowOwnerAgentName,
@@ -618,7 +618,7 @@ export class SessionPersister {
                 }
                 const messages = [...trimmed, ...trailers];
                 ref.actions.aiAssistant.loadSession(toLoadSessionPayload(Object.assign(Object.assign({}, snapshot), { messages })));
-                (_c = driver === null || driver === void 0 ? void 0 : driver.loadHistory) === null || _c === void 0 ? void 0 : _c.call(driver, [...messages]);
+                (_b = driver === null || driver === void 0 ? void 0 : driver.loadHistory) === null || _b === void 0 ? void 0 : _b.call(driver, [...messages]);
                 // Interrupted flow (§5.9): pre-fill the composer with the prompt that started
                 // the flow so "send it again" is one keystroke, and record it for observability.
                 if (snapshot.interrupted) {
@@ -641,8 +641,8 @@ export class SessionPersister {
                 // driver's routing agrees with the restored (picker-locked) store state.
                 const orchestrator = asOrchestrator(driver);
                 if (orchestrator) {
-                    orchestrator.setPinnedAgent((_d = snapshot.pinnedAgentName) !== null && _d !== void 0 ? _d : null);
-                    orchestrator.setFlowOwner((_e = snapshot.flowOwnerAgentName) !== null && _e !== void 0 ? _e : null);
+                    orchestrator.setPinnedAgent((_c = snapshot.pinnedAgentName) !== null && _c !== void 0 ? _c : null);
+                    orchestrator.setFlowOwner((_d = snapshot.flowOwnerAgentName) !== null && _d !== void 0 ? _d : null);
                 }
                 logger.debug('Session restored', { key, messages: messages.length });
             }

package/docs/migration-GENC-1580.md

@@ -1,47 +1,26 @@
 # Migration Guide — GENC-1580 (agent lifecycle leaves the orchestrator)
 
-> ## ⚠️ Partly shipped — the rename has not landed, so do not action the rename
+> ## ⚠️ §4 only is still unshipped
 >
-> The structural half of this change is in. What is **not** in is the one part that would break
-> you: `ChatDriver.applyAgent` has not been renamed. It was held back deliberately, to land alone
-> as the last PR of GENC-1580 — the rename cannot be caught by a compiler in a JavaScript caller,
-> so it is worth scheduling rather than absorbing alongside a refactor.
+> Everything in this guide is now true **except §4** (`pinned-changed`), which carries its own
+> notice. The breaking rename landed in this release.
 >
-> **What the package you are reading this in actually has:**
+> **Self-check, whatever version you are on:** if `ChatDriver.installAgent` exists, you are on the
+> breaking release and §1–§3 and §5 apply. If only `applyAgent` exists, you are on an earlier one
+> and should not touch your calls.
 >
-> | This guide says | Actually available today |
-> | --- | --- |
-> | `ChatDriver.activateAgent` | ✓ — available, fires the lifecycle hooks |
-> | `ChatDriver.agentSession` | ✓ — available (`@internal`) |
-> | `getActiveAgent` / `primeRestoredAgentState` implemented by both drivers | ✓ — and `setPinnedAgent` / `setFlowOwner` are on the interface now, all four **optional** |
-> | `ChatDriver.installAgent` | ✗ — **still `ChatDriver.applyAgent`, unchanged** |
-> | `pinned-changed` is dispatched | ✗ — still dead wiring (§7.2 of `code-health.md`) |
+> **What breaks:** `ChatDriver.applyAgent` is gone (§1), and four `AiDriver` members are now
+> required rather than optional (§3). Both are compile-time breaks in TypeScript; §1 is **not**
+> caught by a compiler in a JavaScript caller, which is why it shipped alone.
 >
-> **Self-check, whatever version you are on:** if `installAgent` is not present on `ChatDriver`,
-> the rename has not landed and you should not touch your `applyAgent` calls. §4 is also **not**
-> shipped — it carries its own notice. Everything else here is current.
+> **This ships as a MINOR version, not a major.** The AI surface is `@beta` and has no external
+> consumers — the only callers are migrated by hand alongside the release. So a `^15` range will
+> pick this up: if you call `ChatDriver` directly or implement `AiDriver`, read §1 and §3 before
+> upgrading rather than relying on the version number to warn you.
 >
-> **Nothing you have today breaks on this release.** `applyAgent` keeps working, and every
-> `AiDriver` member this ticket touched is declared optional, so an implementor of that interface
-> is unaffected too.
->
-> GENC-1580 ships in more than one PR. The first delivered an internal decomposition of `main.ts`
-> only — five feature controllers, no public API change of any kind. **The agent-lifecycle work
-> described here comes in a later PR under the same ticket**, and this notice is removed in the
-> same change that makes the guide true.
->
-> ---
->
-> When it does land: **config-compatible — no changes required to `chatConfig`, `agents`, or
-> `persistence`.** No element property, attribute, event or `::part()` changes. Nothing about which
-> driver runs your agents changes, so **no runtime behaviour changes**.
->
-> You will need to read this if you call `ChatDriver` directly, or if you implement `AiDriver`
-> yourself. If you only configure the element, there is nothing here for you.
->
-> All surfaces below are `@beta` unless marked otherwise.
-
----
+> **Config-compatible** — no changes to `chatConfig`, `agents` or `persistence`, no element
+> property, attribute, event or `::part()` changes, and **no runtime behaviour changes**. You only
+> need this guide if you call `ChatDriver` directly or implement `AiDriver` yourself.
 
 ## Why
 
@@ -67,8 +46,9 @@ longer depends on which driver you got.
 
 ### 1. `ChatDriver.applyAgent` is renamed to `installAgent`
 
-**This is the only breaking change in this release.** `applyAgent` was public `@beta` and appeared
-in the published type rollup.
+`applyAgent` was public `@beta` and appeared in the published type rollup, so this is a
+compile-time break for a TypeScript caller — and a silent one for a JavaScript caller, which is
+why it shipped in a release of its own.
 
 ```ts
 // before
@@ -97,6 +77,10 @@ name `installAgent` says what it does, so the next reader has to choose delibera
 state to restore, `activateAgent`. If you are re-applying a per-turn tool surface on an agent
 already activated, `installAgent`.
 
+`OrchestratingDriver`'s own private `applyAgent` was renamed to match. It was never public, so
+there is nothing to do — but the two are related, and leaving them differently named would have
+been worse than the original footgun.
+
 ### 2. `ChatDriver.agentSession` is exposed
 
 ```ts
@@ -123,27 +107,90 @@ which is the coupling that used to span two classes.
 
 | Member | Was | Now |
 | --- | --- | --- |
-| `getActiveAgent?()` | `OrchestratingDriver` only | both |
-| `setPinnedAgent?(name)` | not on the interface | both |
-| `setFlowOwner?(name)` | not on the interface | both |
-| `primeRestoredAgentState?(snapshots)` | `OrchestratingDriver` only | both |
+| `getActiveAgent()` | `OrchestratingDriver` only, optional | both, **required** |
+| `setPinnedAgent(name)` | not on the interface | both, **required** |
+| `setFlowOwner(name)` | not on the interface | both, **required** |
+| `primeRestoredAgentState(snapshots)` | `OrchestratingDriver` only, optional | both, **required** |
+
+**If you only call these, there is nothing to do** — and you can now drop your guards, because the
+interface finally promises what both shipped drivers have always provided:
+
+```ts
+// before
+const reserve = driver.getActiveAgent?.()?.contextReserve;
 
-**Nothing to do, and nothing breaks.** All four are declared **optional**, so a third party
-implementing `AiDriver` is unaffected: two were already optional and two are new additions. Keep
-your `?.()` guards — they still type-check, and the interface makes no promise a caller can lean
-on yet.
+// after
+const reserve = driver.getActiveAgent()?.contextReserve;
+```
 
-The `?` comes off in the same release as the `installAgent` rename, which is the only breaking
-change in this ticket. That is when the guards can go:
+**If you implement `AiDriver` yourself, this is the break.** Add the four methods. Each has a
+sensible inert form if your driver has nothing to route between — record the value and return it,
+or no-op:
 
 ```ts
-// after the breaking release, not before
-const reserve = driver.getActiveAgent().contextReserve;
+import type { AgentConfig } from '@genesislcap/ai-assistant';
+
+class MyDriver implements AiDriver {
+  // …your existing members — `AiDriver` extends `EventTarget` and has 11 required
+  // members in total, so this fragment alone will not compile…
+
+  private active?: AgentConfig;
+
+  getActiveAgent() {
+    return this.active;
+  }
+  setPinnedAgent(_name: string | null) {}
+  setFlowOwner(_name: string | null) {}
+  primeRestoredAgentState(_snapshots: Record<string, unknown>) {}
+}
 ```
 
-Fourteen members on `AiDriver` remain optional. They are a separate problem, and `ai-driver.ts`
-still carries a doc comment claiming the element depends only on this interface, which is not yet
-true.
+<details>
+<summary>A complete inert implementation, if you want one to start from</summary>
+
+`AiDriver` extends `EventTarget` and has 11 required members. This compiles as written — the four
+above plus the seven that were already required:
+
+```ts
+import type { ChatAttachment, ChatDriverResult, ChatMessage } from '@genesislcap/foundation-ai';
+import type { AgentConfig, AiDriver } from '@genesislcap/ai-assistant';
+
+class MyDriver extends EventTarget implements AiDriver {
+  private active?: AgentConfig;
+
+  // the four this release promotes
+  getActiveAgent() {
+    return this.active;
+  }
+  setPinnedAgent(_name: string | null) {}
+  setFlowOwner(_name: string | null) {}
+  primeRestoredAgentState(_snapshots: Record<string, unknown>) {}
+
+  // the seven that were already required
+  async sendMessage(_input: string, _attachments?: ChatAttachment[]): Promise<ChatDriverResult> {
+    return { reason: 'done' };
+  }
+  async continueFromHistory(_primer?: ChatMessage[]): Promise<ChatDriverResult> {
+    return { reason: 'done' };
+  }
+  resolveInteraction(_interactionId: string, _result: unknown) {}
+  loadHistory(_messages: ChatMessage[]) {}
+  isBusy() {
+    return false;
+  }
+  async getSuggestions(): Promise<string[]> {
+    return [];
+  }
+  getActiveProviderName() {
+    return 'my-provider';
+  }
+}
+```
+
+</details>
+
+Fourteen of `AiDriver`'s 25 members remain optional — compaction, diagnostics, interactions,
+`cancel`/`dispose`. Feature-detect those as before; this release changes nothing about them.
 
 ### 4. `pinned-changed` — still not dispatched, still nothing to do
 
@@ -182,8 +229,9 @@ behaviour on the session-restore path and deserves its own release to be judged
   a release.
 - `OrchestratingDriver`'s routing: classification, handoffs, the handoff cap, terminality rules,
   the continuation tool, and per-agent history masking.
-- `OrchestratingDriver.applyAgent` — it was already private, and stays private. It shrinks, but its
-  name and signature are not part of any contract.
+- `OrchestratingDriver`'s installer — private before and after, so its rename to `installAgent`
+  (§1) is invisible to you; it also shrank, but neither its name nor its signature is part of any
+  contract.
 - Session persistence and restore, including the shape written to the persistence provider.
 
 ## Known remaining: sub-agent lifecycle
@@ -208,8 +256,10 @@ This release also splits the two largest modules. None of it is consumer-visible
 package's entry points (`.`, `./config`, `./chat-driver`, `./react`), but if you deep-import from
 `dist/esm/...` — which is unsupported — paths have moved:
 
-- `chat-driver.ts` sheds its turn-failure taxonomy, interaction handling, turn recording, turn
-  setup, fold machinery and provider resolution into sibling modules.
+- `chat-driver.ts` sheds its turn-failure taxonomy (`turn-failures.ts`), interaction handling
+  (`interaction-controller.ts`), turn recording and diagnostics (`turn-recorder.ts`), fold
+  machinery (`fold-controller.ts`) and its constants (`chat-driver.constants.ts`) into sibling
+  modules. Turn setup and provider resolution were considered and **not** extracted.
 - `main.ts` sheds the settings modal, composer controls, cost ledger, budget latching, context gate
   and diagnostics assembly into controllers.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "15.27.0-agent-log-submit.3",
+  "version": "15.27.1",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -74,26 +74,26 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.27.0-agent-log-submit.3",
-    "@genesislcap/genx": "15.27.0-agent-log-submit.3",
-    "@genesislcap/rollup-builder": "15.27.0-agent-log-submit.3",
-    "@genesislcap/ts-builder": "15.27.0-agent-log-submit.3",
-    "@genesislcap/uvu-playwright-builder": "15.27.0-agent-log-submit.3",
-    "@genesislcap/vite-builder": "15.27.0-agent-log-submit.3",
-    "@genesislcap/webpack-builder": "15.27.0-agent-log-submit.3",
+    "@genesislcap/foundation-testing": "15.27.1",
+    "@genesislcap/genx": "15.27.1",
+    "@genesislcap/rollup-builder": "15.27.1",
+    "@genesislcap/ts-builder": "15.27.1",
+    "@genesislcap/uvu-playwright-builder": "15.27.1",
+    "@genesislcap/vite-builder": "15.27.1",
+    "@genesislcap/webpack-builder": "15.27.1",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2",
     "esbuild": "0.25.12"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "15.27.0-agent-log-submit.3",
-    "@genesislcap/foundation-logger": "15.27.0-agent-log-submit.3",
-    "@genesislcap/foundation-notifications": "15.27.0-agent-log-submit.3",
-    "@genesislcap/foundation-redux": "15.27.0-agent-log-submit.3",
-    "@genesislcap/foundation-ui": "15.27.0-agent-log-submit.3",
-    "@genesislcap/foundation-utils": "15.27.0-agent-log-submit.3",
-    "@genesislcap/rapid-design-system": "15.27.0-agent-log-submit.3",
-    "@genesislcap/web-core": "15.27.0-agent-log-submit.3",
+    "@genesislcap/foundation-ai": "15.27.1",
+    "@genesislcap/foundation-logger": "15.27.1",
+    "@genesislcap/foundation-notifications": "15.27.1",
+    "@genesislcap/foundation-redux": "15.27.1",
+    "@genesislcap/foundation-ui": "15.27.1",
+    "@genesislcap/foundation-utils": "15.27.1",
+    "@genesislcap/rapid-design-system": "15.27.1",
+    "@genesislcap/web-core": "15.27.1",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },

package/dist/dts/utils/resolve-debug-log-note.d.ts

@@ -1,25 +0,0 @@
-import type { ChatDebugLogSubmitConfig } from '@genesislcap/foundation-ai';
-/** Default cap on the user's note. Short by design — it is a caption for the log, not a report. */
-export declare const DEBUG_LOG_NOTE_DEFAULT_MAX_LENGTH = 500;
-/** Default prompt in the empty note. */
-export declare const DEBUG_LOG_NOTE_DEFAULT_PLACEHOLDER = "What were you doing, or what went wrong? (optional)";
-/** The same prompt for a `required` note — "(optional)" would contradict the disabled Send. */
-export declare const DEBUG_LOG_NOTE_REQUIRED_PLACEHOLDER = "What were you doing, or what went wrong?";
-/** `ChatDebugLogNoteConfig` with every option resolved. */
-export interface ResolvedDebugLogNoteConfig {
-    placeholder: string;
-    required: boolean;
-    maxLength: number;
-}
-/**
- * Resolve `debugLogSubmit.note` — `undefined`/`true` mean "compose box with defaults",
- * `false` means "no compose box, send on first click" (→ `null`), and an object customises
- * the box. Keeps the template free of the boolean-or-object dance.
- */
-export declare function resolveDebugLogNoteConfig(config: ChatDebugLogSubmitConfig | undefined): ResolvedDebugLogNoteConfig | null;
-/**
- * Normalise the typed note for the submission: trimmed, and `undefined` when empty so a
- * host can `message ?? fallback` without checking for whitespace.
- */
-export declare function normalizeDebugLogNote(note: string): string | undefined;
-//# sourceMappingURL=resolve-debug-log-note.d.ts.map

package/dist/dts/utils/resolve-debug-log-note.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve-debug-log-note.d.ts","sourceRoot":"","sources":["../../../src/utils/resolve-debug-log-note.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEnG,mGAAmG;AACnG,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD,wCAAwC;AACxC,eAAO,MAAM,kCAAkC,wDACQ,CAAC;AAExD,+FAA+F;AAC/F,eAAO,MAAM,mCAAmC,6CAA6C,CAAC;AAE9F,2DAA2D;AAC3D,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,wBAAwB,GAAG,SAAS,GAC3C,0BAA0B,GAAG,IAAI,CAmBnC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtE"}

package/dist/esm/utils/resolve-debug-log-note.js

@@ -1,37 +0,0 @@
-/** Default cap on the user's note. Short by design — it is a caption for the log, not a report. */
-export const DEBUG_LOG_NOTE_DEFAULT_MAX_LENGTH = 500;
-/** Default prompt in the empty note. */
-export const DEBUG_LOG_NOTE_DEFAULT_PLACEHOLDER = 'What were you doing, or what went wrong? (optional)';
-/** The same prompt for a `required` note — "(optional)" would contradict the disabled Send. */
-export const DEBUG_LOG_NOTE_REQUIRED_PLACEHOLDER = 'What were you doing, or what went wrong?';
-/**
- * Resolve `debugLogSubmit.note` — `undefined`/`true` mean "compose box with defaults",
- * `false` means "no compose box, send on first click" (→ `null`), and an object customises
- * the box. Keeps the template free of the boolean-or-object dance.
- */
-export function resolveDebugLogNoteConfig(config) {
-    var _a;
-    if (!config || config.note === false)
-        return null;
-    // `typeof null === 'object'`: a host building its config dynamically can hand us `null`
-    // even though the type forbids it, and that must read as "defaults", not crash.
-    const note = typeof config.note === 'object' && config.note !== null ? config.note : {};
-    // `>= 1`, not `> 0`: a fractional cap under 1 would floor to 0 and lock the textarea.
-    const maxLength = typeof note.maxLength === 'number' && note.maxLength >= 1
-        ? Math.floor(note.maxLength)
-        : DEBUG_LOG_NOTE_DEFAULT_MAX_LENGTH;
-    const required = note.required === true;
-    return {
-        placeholder: (_a = note.placeholder) !== null && _a !== void 0 ? _a : (required ? DEBUG_LOG_NOTE_REQUIRED_PLACEHOLDER : DEBUG_LOG_NOTE_DEFAULT_PLACEHOLDER),
-        required,
-        maxLength,
-    };
-}
-/**
- * Normalise the typed note for the submission: trimmed, and `undefined` when empty so a
- * host can `message ?? fallback` without checking for whitespace.
- */
-export function normalizeDebugLogNote(note) {
-    const trimmed = note.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}