@geraldmaron/construct 1.2.3 → 1.3.0

package/templates/distribution/construct-brand.typ

@@ -55,13 +55,17 @@
 #let construct-font-display = ("Space Grotesk",)
 #let construct-font-mono = ("JetBrains Mono",)
 
+#let horizontalrule = block(width: 100%, above: 0.85em, below: 0.95em)[
+  #line(length: 100%, stroke: 0.6pt + hairline-strong)
+]
+
 // Type scale. One modular ramp shared by every document type so sizing never
 // drifts between a PRD, a research brief, and a decision record.
 
 #let fs-micro = 8pt
 #let fs-small = 8.5pt
 #let fs-meta = 9pt
-#let fs-body = 10pt
+#let fs-body = 10.4pt
 #let fs-h4 = 8.5pt
 #let fs-h3 = 11pt
 #let fs-h2 = 13pt
@@ -76,8 +80,8 @@
 #let wt-semibold = 600
 #let wt-bold = 700
 
-#let construct-figure-max-width = 58%
-#let construct-figure-max-height = 2.35in
+#let construct-figure-max-width = 92%
+#let construct-figure-max-height = 3.4in
 
 // A document-type word maps to a compact badge so the masthead reads as a
 // labelled artifact rather than a bare title.
@@ -290,20 +294,18 @@
 
 #let construct-theme(body) = {
   set text(font: construct-font-sans, size: fs-body, fill: ink-body, lang: "en", tracking: 0.002em)
-  set par(justify: false, leading: 0.82em, spacing: 1.15em)
+  set par(justify: false, leading: 0.9em, spacing: 1.24em)
   set heading(numbering: none, outlined: true)
 
   show strong: set text(font: construct-font-sans, weight: wt-semibold, fill: ink)
   show emph: set text(style: "italic")
 
-  // Lists inherit the open body leading; a per-item block gap keeps a wrapped
-  // bullet from reading as two bullets, with the gap clearly wider than the
-  // line leading within an item.
+  // Lists need looser vertical rhythm than body prose, but ordered lists must
+  // preserve Typst's native counter context or every item will render as `1.`.
+  // Spacing belongs on the list container, not on a wrapped enum.item block.
 
-  show list.item: it => block(below: 0.6em, it)
-  show enum.item: it => block(below: 0.6em, it)
-  set list(marker: (text(fill: ink)[•], text(fill: ink-muted)[‣], text(fill: ink-faint)[–]), indent: 2pt, body-indent: 8pt, spacing: 0.9em)
-  set enum(indent: 2pt, body-indent: 8pt, spacing: 0.9em)
+  set list(marker: (text(fill: ink)[•], text(fill: ink-muted)[‣], text(fill: ink-faint)[–]), indent: 2pt, body-indent: 9pt, spacing: 1.02em)
+  set enum(numbering: "1.", indent: 2pt, body-indent: 9pt, spacing: 1.02em)
 
   // Links carry ink with a hairline underline so citations stay legible without
   // introducing color.
@@ -322,7 +324,7 @@
       text(font: construct-font-display, size: fs-h1, weight: wt-semibold, fill: ink, tracking: -0.015em)[#it.body]
       v(0.22em)
       line(length: 100%, stroke: 0.5pt + hairline)
-      v(0.55em, weak: true)
+      v(0.7em, weak: true)
     })
   }
   show heading.where(level: 2): it => {
@@ -331,14 +333,14 @@
       text(font: construct-font-display, size: fs-h2, weight: wt-semibold, fill: ink, tracking: -0.01em)[#it.body]
       v(0.4em)
       line(length: 26pt, stroke: 1.5pt + ink)
-      v(0.62em, weak: true)
+      v(0.78em, weak: true)
     })
   }
   show heading.where(level: 3): it => {
     v(1.15em, weak: true)
     block(sticky: true, {
       text(font: construct-font-sans, size: fs-h3, weight: wt-semibold, fill: ink-strong)[#it.body]
-      v(0.38em, weak: true)
+      v(0.48em, weak: true)
     })
   }
   show heading.where(level: 4): it => {
@@ -414,10 +416,13 @@
       radius: 4pt,
     )[
       #align(center)[
-        #box(width: construct-figure-max-width)[
-          #show image: img => image(img, width: 100%, height: construct-figure-max-height, fit: "contain")
-          #it.body
-        ]
+        #show image: img => image(
+          img,
+          width: construct-figure-max-width,
+          height: construct-figure-max-height,
+          fit: "contain",
+        )
+        #it.body
       ]
     ]
     if it.caption != none {

package/templates/distribution/construct-decision.typ

@@ -8,7 +8,7 @@
 
 #set page(
   paper: "a4",
-  margin: (x: 2cm, top: 1.8cm, bottom: 2.2cm),
+  margin: (x: 2.15cm, top: 1.95cm, bottom: 2.35cm),
   numbering: "1",
   header: construct-running-header(
     "$if(title)$$title$$endif$",

package/templates/distribution/construct-pdf.typ

@@ -8,7 +8,7 @@
 
 #set page(
   paper: "a4",
-  margin: (x: 2cm, top: 1.8cm, bottom: 2.2cm),
+  margin: (x: 2.15cm, top: 1.95cm, bottom: 2.35cm),
   numbering: "1",
   header: construct-running-header(
     "$if(title)$$title$$endif$",

package/templates/distribution/construct-prd.typ

@@ -8,7 +8,7 @@
 
 #set page(
   paper: "a4",
-  margin: (x: 2cm, top: 1.8cm, bottom: 2.2cm),
+  margin: (x: 2.15cm, top: 1.95cm, bottom: 2.35cm),
   numbering: "1",
   header: construct-running-header(
     "$if(title)$$title$$endif$",

package/templates/distribution/construct-research.typ

@@ -8,7 +8,7 @@
 
 #set page(
   paper: "a4",
-  margin: (x: 1.85cm, top: 1.75cm, bottom: 2.1cm),
+  margin: (x: 2cm, top: 1.9cm, bottom: 2.25cm),
   numbering: "1",
   header: construct-running-header(
     "$if(title)$$title$$endif$",

package/templates/distribution/mermaid-puppeteer.json

@@ -0,0 +1,8 @@
+{
+  "args": [
+    "--no-sandbox",
+    "--disable-setuid-sandbox",
+    "--disable-dev-shm-usage",
+    "--disable-gpu"
+  ]
+}

package/templates/docs/persona-artifact.md

@@ -1,6 +1,6 @@
 # <Role display name>
 
-> Anchor doc for the <role-id> persona. Methodology: `docs/guides/concepts/persona-research.md`. This file is generated by `construct profile create` and is part of the discover + frame phases. The persona is not promotable until every section below is filled from evidence, not opinion.
+> Anchor doc for the <role-id> persona. Methodology: `docs/guides/concepts/persona-research.md`. This file is generated by `construct scope create` and is part of the discover + frame phases. The persona is not promotable until every section below is filled from evidence, not opinion.
 
 ## Goals
 

package/templates/docs/prd.md

@@ -20,6 +20,8 @@ not the whole document. Keep em dashes rare; prefer commas, periods, or parenthe
 -->
 
 ## Summary
+This PRD defines {title} for {primary user or customer segment}. It explains the current friction, the measurable outcome this work should unlock, and the smallest shippable path to prove the change works. Replace this paragraph with evidence-backed product context before review.
+
 <!--
 One paragraph (3-5 sentences) that a busy reader can use as the whole PRD.
 What the change is, who it's for, why now, and what changes when it ships.
@@ -27,6 +29,8 @@ No solutions in this section that aren't decided. No ticket IDs. No team names.
 -->
 
 ## Background
+Today, {current workflow or system} creates avoidable friction for {affected users}. The evidence that matters for this PRD should include observed behavior, quantitative signals, or qualitative research, and the links below should let reviewers verify the claim without relying on memory.
+
 <!--
 Context the reader needs to evaluate this PRD without asking around.
 Include relevant prior work (linked PRDs, ADRs, RFCs), observed signals, and
@@ -38,6 +42,8 @@ Avoid roadmap-speak ("this is a Q3 priority"); state what is happening to users.
 -->
 
 ## Problem
+{Affected users} cannot reliably achieve {desired outcome} because {constraint or failure mode}. The problem is important now because the current workaround is costly, error-prone, or blocks adoption for a clearly named segment.
+
 <!--
 The specific user or business outcome that is currently blocked. One or two
 paragraphs. State the pain, not the solution.

package/apps/chat/engine/ai-sdk-agent.mjs

@@ -1,183 +0,0 @@
-/**
- * apps/chat/engine/ai-sdk-agent.mjs — the real owned-loop engine (Vercel AI SDK).
- *
- * Lazy-loaded by the launcher only when `construct chat` runs the rich/owned path,
- * so the optional dependencies (`ai`, `@ai-sdk/*`, `zod`) never load in the zero-dep
- * core or in tests of the mapping layer. It resolves a Construct model id (the
- * router's `provider/model` form) to an AI SDK language model through the adapter
- * registry (provider-adapters.mjs), builds the agent tool set from the tool
- * registry, and runs streamText under the turn's compiled execution policy
- * (turn-controls.mjs): the step cap, tool-group / schema budget, output cap, and
- * caching eligibility all derive from the resolved capability profile, so the loop
- * adapts to the model while staying behavior-preserving for hosted-direct. It
- * yields the SDK fullStream parts unchanged; loop-driver.mjs owns the
- * normalization into the event union.
- */
-
-import { listChatModels } from './models.mjs';
-import { resolveLanguageModel } from './provider-adapters.mjs';
-import { resolveTurnControls } from './turn-controls.mjs';
-import { buildSystemPrompt } from '../../../lib/chat/system-prompt.mjs';
-import { applyToolBudget } from '../../../lib/mcp/tool-budget.mjs';
-import { recordPolicyTelemetry } from '../../../lib/chat/policy-telemetry.mjs';
-import { maybeCompact, estimateTextTokens, messageText } from '../../../lib/chat/context-compactor.mjs';
-
-// Real summarization of the compactible layers (tool results, prior assistant
-// reasoning) the contract elides, run on the same language model as the turn.
-// Bounded output and zero retries keep the once-per-compaction cost small; a throw
-// is caught upstream and falls back to the deterministic extractive summary, so a
-// summarizer failure degrades fidelity without breaking the turn.
-
-function makeSummarizer({ generateText, languageModel, signal }) {
-  return async (text, meta = {}) => {
-    const { text: summary } = await generateText({
-      model: languageModel,
-      system: 'Compress earlier agent work into a faithful, terse recap for context continuation. Preserve decisions, findings, file paths, identifiers, and unresolved threads. Never invent facts. No preamble.',
-      prompt: `Summarize these ${meta.segmentCount || 'earlier'} turn(s) of an agent working in a repository. Use compact bullets, keep concrete identifiers, stay under 200 words:\n\n${text}`,
-      maxOutputTokens: 512,
-      maxRetries: 0,
-      abortSignal: signal,
-    });
-    return summary;
-  };
-}
-
-export async function createAiSdkAgent({ env = process.env, cwd = process.cwd(), model = null, handlers = {}, systemPrompt = '', tools = null, onTelemetry = recordPolicyTelemetry } = {}) {
-  const { streamText, stepCountIs, generateText } = await import('ai');
-
-  const { buildAgentTools } = await import('./tools/registry.mjs');
-  const sdkTools = await buildAgentTools({ env, cwd, handlers, only: tools });
-
-  const messages = [];
-  const languageModels = new Map();
-  let activeModelId = model;
-  let contextTokens = 0;
-
-  async function languageModelFor(modelId) {
-    const id = modelId || activeModelId;
-    if (!id) {
-      const err = new Error('No model selected and no configured provider found. Run `construct models` or set CX_MODEL_STANDARD.');
-      err.code = 'PROVIDER_MODEL_UNRESOLVED';
-      throw err;
-    }
-    if (!languageModels.has(id)) {
-      languageModels.set(id, await resolveLanguageModel(id, env));
-    }
-    return languageModels.get(id);
-  }
-
-  return {
-    sessionId: `construct-${Date.now()}`,
-    model,
-    listModels: () => listChatModels({ env }),
-    async *streamTurn(text, { signal, model: turnModel = null, turnOverlay = null } = {}) {
-      if (turnModel) activeModelId = turnModel;
-      const languageModel = await languageModelFor(activeModelId);
-
-      const controls = resolveTurnControls({ model: activeModelId, turnOverlay, env });
-      if (controls.degraded) {
-        onTelemetry({
-          kind: 'execution-policy-degraded',
-          model: activeModelId,
-          capabilityClass: controls.policy?.source?.capabilityClass || 'unknown',
-          reasons: controls.policy?.telemetry?.reasons || [],
-        });
-      }
-      const turnTools = applyToolBudget(sdkTools, {
-        allowedToolGroups: controls.allowedToolGroups,
-        maxToolSchemas: controls.maxToolSchemas,
-      });
-
-      // Per-turn routing policy belongs in the SYSTEM role (via buildSystemPrompt),
-      // never prepended to the user message: a user-role policy gets echoed in model
-      // reasoning and compounds in persisted history.
-      messages.push({ role: 'user', content: String(text) });
-      const systemText = buildSystemPrompt({ base: systemPrompt || undefined, overlay: turnOverlay });
-
-      const request = {
-        model: languageModel,
-        tools: turnTools,
-        stopWhen: stepCountIs(controls.iterations),
-        abortSignal: signal,
-        maxRetries: 0,
-      };
-      if (controls.outputCap) request.maxOutputTokens = controls.outputCap;
-
-      // A cache-eligible provider marks the stable system prefix as a cache
-      // breakpoint: the AI SDK maps a single leading system message onto the
-      // provider's system field, so the request stays output-identical and only the
-      // cache_control annotation is added. Every other provider keeps the plain
-      // system string — today's exact request shape.
-      if (controls.cacheEligible) {
-        const providerNs = String(activeModelId || '').split('/')[0] || 'anthropic';
-        request.messages = [
-          { role: 'system', content: systemText, providerOptions: { [providerNs]: { cacheControl: { type: 'ephemeral' } } } },
-          ...messages,
-        ];
-      } else {
-        request.system = systemText;
-        request.messages = messages;
-      }
-
-      const result = streamText(request);
-
-      // The compaction trigger needs the current context SIZE, which is the last
-      // model call's per-step input (system + full history), not the turn's
-      // aggregate input — totalUsage sums input across tool steps and would
-      // over-count a multi-step turn, tripping compaction below the real budget.
-      // Prefer the last finish-step's per-call usage; fall back to the aggregate
-      // only when the host reports no per-step usage. Host numbers only, no split.
-      let lastStepUsage = null;
-      let aggregateUsage = null;
-      for await (const part of result.fullStream) {
-        if (part.type === 'finish-step' && part.usage) lastStepUsage = part.usage;
-        if (part.type === 'finish') aggregateUsage = part.totalUsage || part.usage || aggregateUsage;
-        yield part;
-      }
-      const turnUsage = lastStepUsage || aggregateUsage;
-
-      // Persist the assistant turn (incl. tool exchanges) so the next prompt has history.
-      try {
-        const response = await result.response;
-        if (Array.isArray(response?.messages)) messages.push(...response.messages);
-        // Surface the model that actually answered — the OpenRouter free router
-        // resolves to an underlying model id, not the "openrouter/free" alias.
-        const resolved = response?.modelId;
-        if (resolved && resolved !== activeModelId && !String(activeModelId).endsWith(resolved)) {
-          yield { type: 'model-resolved', model: resolved };
-        }
-      } catch { /* history append is best-effort */ }
-
-      // The next turn's context ≈ this turn's input (system + full history) plus the
-      // output just appended. When that crosses the policy's continuation trigger,
-      // compact without silent loss. Behavior-preserving: hosted only crosses near
-      // its ~150k budget, so short conversations are never touched. Compaction is
-      // best-effort — any failure leaves the live history intact.
-      const input = Number(turnUsage?.inputTokens) || 0;
-      const output = Number(turnUsage?.outputTokens) || 0;
-      if (input || output) contextTokens = input + output;
-
-      const trigger = controls.continuation?.triggerTokens || null;
-      if (trigger && contextTokens >= trigger) {
-        try {
-          const outcome = await maybeCompact({
-            messages,
-            systemText,
-            triggerTokens: trigger,
-            contextTokens,
-            summarize: makeSummarizer({ generateText, languageModel, signal }),
-          });
-          if (outcome.packet) yield { type: 'context-continuation', packet: outcome.packet, compacted: outcome.compacted };
-          if (outcome.notice) {
-            yield { type: 'context-notice', level: outcome.blocker ? 'warn' : 'info', code: outcome.blocker ? 'context-blocker' : 'context-compacted', message: outcome.notice };
-          }
-          if (outcome.compacted && Array.isArray(outcome.messages)) {
-            messages.length = 0;
-            messages.push(...outcome.messages);
-            contextTokens = estimateTextTokens(systemText) + messages.reduce((n, m) => n + estimateTextTokens(messageText(m)), 0);
-          }
-        } catch { /* compaction must never break a turn */ }
-      }
-    },
-  };
-}

package/apps/chat/engine/loop-driver.mjs

@@ -1,211 +0,0 @@
-/**
- * apps/chat/engine/loop-driver.mjs — Construct's owned agent loop, exposed as a
- * driver implementing the normalized event union (lib/chat/harness/driver.mjs).
- *
- * ADR-0041 reverses the delegate-the-loop posture: Construct now runs the loop
- * (prompt -> model -> tool calls -> tool results -> repeat) on a provider-agnostic
- * engine (Vercel AI SDK), so every token, tool result, and routing choice is
- * first-party data. This module is the seam that keeps the rest of the surface
- * host-agnostic: it owns the lifecycle (start/prompt/cancel/stop), maps the
- * engine's fullStream parts onto the driver event union, and accumulates per-turn
- * usage from the host's own numbers (no fabricated splits).
- *
- * The engine itself is injected as `createAgent` so this mapping layer is tested
- * against a scripted mock with no network or API key — the same dependency-
- * injection discipline the retired host adapters used (fetchImpl / spawnFn). The
- * real engine lives in ai-sdk-agent.mjs and is lazy-imported only when chat runs.
- */
-
-import { AsyncEventQueue } from '../../../lib/chat/harness/driver.mjs';
-import { listChatModels, recommendChatModel } from './models.mjs';
-
-// Vercel AI SDK fullStream parts use a few delta field names across versions;
-// read text from any of them so the mapping survives a minor SDK bump.
-
-function partText(part) {
-  if (typeof part.text === 'string') return part.text;
-  if (typeof part.textDelta === 'string') return part.textDelta;
-  if (typeof part.delta === 'string') return part.delta;
-  return '';
-}
-
-// Usage arrives on finish parts as inputTokens/outputTokens/etc.; normalize to
-// the union's token shape, emitting only fields the engine actually reported.
-
-function normalizeUsage(part) {
-  const u = part.totalUsage || part.usage || null;
-  if (!u) return null;
-  const tokens = {};
-  if (Number.isFinite(u.inputTokens)) tokens.input = u.inputTokens;
-  if (Number.isFinite(u.outputTokens)) tokens.output = u.outputTokens;
-  if (Number.isFinite(u.reasoningTokens)) tokens.reasoning = u.reasoningTokens;
-  if (Number.isFinite(u.cachedInputTokens)) tokens.cacheRead = u.cachedInputTokens;
-  if (Number.isFinite(u.totalTokens)) tokens.total = u.totalTokens;
-  else if (Number.isFinite(tokens.input) || Number.isFinite(tokens.output)) {
-    tokens.total = (tokens.input || 0) + (tokens.output || 0) + (tokens.reasoning || 0);
-  }
-  if (!Object.keys(tokens).length) return null;
-  const event = { type: 'usage', tokens };
-  if (part.providerMetadata?.cost && Number.isFinite(part.providerMetadata.cost.amount)) {
-    event.cost = { amount: part.providerMetadata.cost.amount, currency: part.providerMetadata.cost.currency || 'USD' };
-  }
-  return event;
-}
-
-// One fullStream part -> zero or more normalized driver events on the turn queue.
-// Tool ids are tracked so a tool_call is emitted once and tool_update carries the
-// terminal state, matching the union the renderers already consume.
-
-function mapPart(part, queue, state) {
-  switch (part.type) {
-    case 'text-delta':
-    case 'text': {
-      const t = partText(part);
-      if (t) queue.push({ type: 'text', text: t, messageId: part.id || null });
-      break;
-    }
-    case 'reasoning-delta':
-    case 'reasoning': {
-      const t = partText(part);
-      if (t) queue.push({ type: 'thinking', text: t, messageId: part.id || null });
-      break;
-    }
-    case 'model-resolved': {
-      if (part.model) queue.push({ type: 'model_resolved', model: part.model });
-      break;
-    }
-    case 'context-notice': {
-      queue.push({ type: 'notice', level: part.level || 'info', code: part.code || 'context', message: part.message || '' });
-      break;
-    }
-    case 'context-continuation': {
-      queue.push({ type: 'context_continuation', packet: part.packet || null, compacted: part.compacted === true });
-      break;
-    }
-    case 'tool-call': {
-      const id = part.toolCallId || part.id;
-      state.tools.add(id);
-      queue.push({ type: 'tool_call', id, title: part.toolName || 'tool', kind: part.toolName || 'other', status: 'pending', input: part.input ?? part.args ?? null });
-      break;
-    }
-    case 'tool-result': {
-      const id = part.toolCallId || part.id;
-      queue.push({ type: 'tool_update', id, status: 'completed', content: part.output ?? part.result ?? null });
-      break;
-    }
-    case 'tool-error': {
-      const id = part.toolCallId || part.id;
-      queue.push({ type: 'tool_update', id, status: 'failed', content: part.error ? String(part.error.message || part.error) : null });
-      break;
-    }
-    case 'finish-step':
-    case 'finish': {
-      const usage = normalizeUsage(part);
-      if (usage) queue.push(usage);
-      break;
-    }
-    case 'error':
-      state.errored = true;
-      queue.push({ type: 'error', message: part.error ? String(part.error.message || part.error) : 'engine error' });
-      break;
-    case 'abort':
-      state.aborted = true;
-      break;
-    default:
-      break;
-  }
-}
-
-export function createOwnedLoopDriver({
-  env = process.env,
-  cwd = process.cwd(),
-  model = null,
-  handlers = {},
-  systemPrompt = '',
-  tools = null,
-  createAgent,
-} = {}) {
-  if (typeof createAgent !== 'function') {
-    throw new Error('createOwnedLoopDriver requires a `createAgent` factory (real engine or test mock)');
-  }
-
-  let agent = null;
-  let activeTurn = null;
-  let currentModel = model || null;
-
-  async function start() {
-    agent = await createAgent({ env, cwd, model: currentModel, handlers, systemPrompt, tools });
-    if (agent?.model && !currentModel) currentModel = agent.model;
-    return { sessionId: agent?.sessionId || `owned-${Date.now()}`, capabilities: { host: 'construct', ownedLoop: true } };
-  }
-
-  function prompt(text, opts = {}) {
-    if (!agent) throw new Error('prompt() called before start()');
-    const queue = new AsyncEventQueue();
-    const controller = new AbortController();
-    const turn = { queue, controller, tools: new Set(), aborted: false, errored: false };
-    activeTurn = turn;
-    if (opts.model) currentModel = opts.model;
-
-    (async () => {
-      try {
-        const stream = await agent.streamTurn(text, {
-          signal: controller.signal,
-          model: currentModel,
-          turnOverlay: opts.turnOverlay ?? null,
-        });
-        for await (const part of stream) {
-          if (queue.closed) break;
-          mapPart(part, queue, turn);
-        }
-        queue.push({ type: 'done', stopReason: turn.aborted ? 'cancelled' : turn.errored ? 'error' : 'end_turn' });
-      } catch (err) {
-        if (err?.name === 'AbortError' || turn.aborted) {
-          queue.push({ type: 'done', stopReason: 'cancelled' });
-        } else {
-          queue.push({ type: 'error', message: err?.message || String(err) });
-          queue.push({ type: 'done', stopReason: 'error' });
-        }
-      } finally {
-        queue.close();
-        if (activeTurn === turn) activeTurn = null;
-      }
-    })();
-
-    return queue;
-  }
-
-  function cancel() {
-    if (activeTurn) {
-      activeTurn.aborted = true;
-      try { activeTurn.controller.abort(); } catch { /* already aborted */ }
-    }
-  }
-
-  function stop() {
-    try { agent?.dispose?.(); } catch { /* nothing to dispose */ }
-  }
-
-  async function listModels() {
-    if (agent?.listModels) {
-      try { return await agent.listModels(); } catch { /* fall through to catalog */ }
-    }
-    return listChatModels({ env });
-  }
-
-  async function recommendModel() {
-    if (currentModel) return null;
-    return recommendChatModel({ env });
-  }
-
-  return {
-    start,
-    prompt,
-    cancel,
-    stop,
-    listModels,
-    recommendModel,
-    get model() { return currentModel; },
-    get sessionId() { return agent?.sessionId || null; },
-  };
-}