appostle-installer 0.0.19 → 0.0.21

package/dist/schema-templates/animations.md

@@ -1,48 +1,37 @@
 ---
-description: Named animation patterns (distinct from motion timing tokens)
-variables:
-  - key: animation.entry
-    type: text
-    label: Entry Pattern
-    value: ""
-    section: visual
-  - key: animation.entry.distance
-    type: number
-    label: Entry TranslateY (px)
-    value: ""
-    section: visual
-  - key: animation.entry.stagger
-    type: number
-    label: Sibling Stagger (ms)
-    value: ""
-    section: visual
-  - key: animation.hover
-    type: text
-    label: Hover Pattern
-    value: ""
-    section: visual
-  - key: animation.scroll
-    type: text
-    label: Scroll Pattern
-    value: ""
-    section: visual
-  - key: animation.status
-    type: text
-    label: Status Pattern
-    value: ""
-    section: visual
-  - key: animation.signature
-    type: text
-    label: Signature Pattern
-    value: ""
-    section: visual
-  - key: animation.principles
-    type: text
-    label: Principles
-    value: ""
-    section: visual
+description: Brand animation language. Each `## <name>` block is one animation with embedded HTML + CSS preview. Variable count per brand.
+variables: []
 ---
 
 # Animations
 
-[1–2 sentence description of the animation system and what it communicates.]
+[1–2 sentence description of the motion language this brand uses: when motion matters, what it communicates, what stays still.]
+
+## <animation-name>
+
+Role: <signature|entry|hover|scroll|status|loop|other>   (optional role hint — used by the brand-guide to mark emphasis)
+
+[Optional 1–2 sentence description of when and where this animation is used.]
+
+```html
+<!-- The demo HTML for the brand-guide preview. Use a unique-enough class name. -->
+<div class="my-anim-demo">Hello</div>
+```
+
+```css
+/* The CSS that drives the demo. Trust your class names — they live inside an
+   isolated card. Reference the brand's CSS vars (--font-hero, --accent-base,
+   --ease-default, etc.) so the demo feels branded. Keyframe names must be
+   unique within this brand's animations.md. */
+.my-anim-demo {
+  animation: my-anim 800ms var(--ease-default, ease-out) forwards;
+}
+@keyframes my-anim {
+  from { opacity: 0; transform: translateY(12px); }
+  to   { opacity: 1; transform: translateY(0); }
+}
+```
+
+## <next-animation-name>
+
+…declare as many `## <name>` sections as the brand actually uses. A brand with one distinctive animation declares one. A brand with twelve declares twelve.

package/dist/schema-templates/shadows.md

@@ -21,6 +21,11 @@ variables:
     label: Glow / Focus
     value: ""
     section: visual
+  - key: shadow.glass.enabled
+    type: text
+    label: Glass Overlay Enabled
+    value: ""
+    section: visual
   - key: shadow.principles
     type: text
     label: Principles

package/dist/schema-templates/shapes.md

@@ -24,12 +24,12 @@ variables:
     value: medium
     options: [sparse, medium, a-lot, loads]
     section: visual
-  - key: brand.shape.shape-1.min-size
+  - key: brand.shape.shape-1.size-range.min
     type: text
     label: Min Size — % of Page Height
     value: "10"
     section: visual
-  - key: brand.shape.shape-1.max-size
+  - key: brand.shape.shape-1.size-range.max
     type: text
     label: Max Size — % of Page Height
     value: "60"
@@ -62,12 +62,12 @@ variables:
     value: medium
     options: [sparse, medium, a-lot, loads]
     section: visual
-  - key: brand.shape.shape-2.min-size
+  - key: brand.shape.shape-2.size-range.min
     type: text
     label: Min Size — % of Page Height
     value: "10"
     section: visual
-  - key: brand.shape.shape-2.max-size
+  - key: brand.shape.shape-2.size-range.max
     type: text
     label: Max Size — % of Page Height
     value: "60"
@@ -100,12 +100,12 @@ variables:
     value: medium
     options: [sparse, medium, a-lot, loads]
     section: visual
-  - key: brand.shape.shape-3.min-size
+  - key: brand.shape.shape-3.size-range.min
     type: text
     label: Min Size — % of Page Height
     value: "10"
     section: visual
-  - key: brand.shape.shape-3.max-size
+  - key: brand.shape.shape-3.size-range.max
     type: text
     label: Max Size — % of Page Height
     value: "60"
@@ -138,12 +138,12 @@ variables:
     value: medium
     options: [sparse, medium, a-lot, loads]
     section: visual
-  - key: brand.shape.shape-4.min-size
+  - key: brand.shape.shape-4.size-range.min
     type: text
     label: Min Size — % of Page Height
     value: "10"
     section: visual
-  - key: brand.shape.shape-4.max-size
+  - key: brand.shape.shape-4.size-range.max
     type: text
     label: Max Size — % of Page Height
     value: "60"

package/dist/worker.js

@@ -2578,6 +2578,10 @@ function toAgentPayload(agent, options) {
     title: options?.title ?? null,
     labels: agent.labels,
     internal: agent.internal,
+    // Forward archivedAt on the live broadcast so paired clients (e.g. mobile)
+    // see the archive land — without this, only the device that ran the
+    // archive mutation knows about it.
+    archivedAt: agent.archivedAt ?? null,
     // Surface ownership so the client can render an owner badge / detect
     // "shared with me" agents. `sharedWithUserIds` deliberately stays off
     // the snapshot — only owners read the full ACL, via the dedicated
@@ -4235,6 +4239,7 @@ var GoogleFontsDownloadResponseSchema = z10.object({
 });
 
 // ../server/src/shared/messages.ts
+var InitialAgentSnapshotPageLimit = 200;
 var MutableDaemonConfigSchema = z11.object({
   mcp: z11.object({
     injectIntoAgents: z11.boolean()
@@ -6727,6 +6732,17 @@ var FetchAgentsResponseMessageSchema = z11.object({
     })
   })
 });
+var InitialAgentSnapshotMessageSchema = z11.object({
+  type: z11.literal("initial_agent_snapshot"),
+  payload: z11.object({
+    entries: z11.array(
+      z11.object({
+        agent: AgentSnapshotPayloadSchema,
+        project: ProjectPlacementPayloadSchema
+      })
+    )
+  })
+});
 var FetchWorkspacesResponseMessageSchema = z11.object({
   type: z11.literal("fetch_workspaces_response"),
   payload: z11.object({
@@ -7768,6 +7784,7 @@ var SessionOutboundMessageSchema = z11.discriminatedUnion("type", [
   AgentStreamMessageSchema,
   AgentStatusMessageSchema,
   FetchAgentsResponseMessageSchema,
+  InitialAgentSnapshotMessageSchema,
   FetchWorkspacesResponseMessageSchema,
   OpenProjectResponseMessageSchema,
   StartWorkspaceScriptResponseMessageSchema,
@@ -20929,11 +20946,53 @@ var ClaudeAgentSession = class {
       // sub-agents stop announcing them as suspected prompt injections. See
       // getSystemReminderGuidance for the full rationale.
       getSystemReminderGuidance(),
-      "Default response shape: open with a short, scannable plain-English read. 2\u20134 short sentences, one idea each, no comma-chained clauses or em-dash pile-ups. When the read covers 3+ discrete points, use bullets instead of prose. Then the technical detail in dense form (paths, line refs, code) without narration. Don't explain what well-named code already explains. Skip the shape for trivial questions.",
-      "For multi-step work with independent chunks, spawn Task subagents instead of doing every tool call yourself. Run them in parallel when chunks don't depend on each other. Keeps your main context lean.",
+      //
+      //
+      //
+      //
+      // ╔══════════════════════════════════════════════════════════════════╗
+      // ║  CUSTOM INSTRUCTIONS — add new system prompt lines below here  ║
+      // ║  Each line is a quoted string: "your instruction here",        ║
+      // ╚══════════════════════════════════════════════════════════════════╝
+      //
+      //
+      //
+      //
+      "Default response shape: open with a short, scannable plain-English read. 2\u20134 short sentences, one idea each, no comma-chained clauses or em-dash pile-ups. When the read covers 3+ discrete points, use bullets instead of prose. Then the technical detail in dense form (paths, line refs, code) without narration. Don\u2019t explain what well-named code already explains. Skip the shape for trivial questions.",
+      //
       "When the user sends `>learn`, re-explain your previous message in plain English only \u2014 1 short paragraph that helps them build the mental model. No code, no file references, no technical repeat.",
+      //
+      //
+      //
+      //
+      // ╔══════════════════════════════════════════════════════════════════╗
+      // ║  END CUSTOM INSTRUCTIONS — don't edit below this line          ║
+      // ╚══════════════════════════════════════════════════════════════════╝
+      //
+      //
+      //
+      //
       this.config.systemPrompt?.trim()
     ].filter((entry) => typeof entry === "string" && entry.length > 0).join("\n\n");
+    const appostleAgents = {
+      researcher: {
+        description: "Use this agent when you need to explore unfamiliar code, trace data flow across modules, search broadly across the codebase, or read more than 2 files you haven't seen yet. Delegate investigation work here to keep the main conversation context lean.",
+        prompt: "You are a codebase researcher. Your job is to investigate, trace, and report findings \u2014 never edit files. Read code, grep for patterns, follow imports, and build a clear picture. Report back a concise summary of what you found: key files, relevant code paths, and your conclusion. Keep your report under 300 words unless the investigation is complex.",
+        model: "sonnet"
+      },
+      refactorer: {
+        description: "Use this agent for refactors that touch more than 2 files \u2014 renames, migrations, pattern replacements, moving code between modules. Delegate multi-file changes here to isolate the blast radius.",
+        prompt: "You are a refactoring specialist. Make the requested changes across all affected files. Be thorough \u2014 update imports, references, types, and tests. Run typecheck after changes if available. Report what you changed and any issues found."
+      },
+      reviewer: {
+        description: "Use this agent to review code for bugs, security issues, performance problems, or style violations. Use it before committing large changes or when the user asks for a review.",
+        prompt: "You are a code reviewer. Analyze the code for correctness, security vulnerabilities (OWASP top 10), performance issues, and adherence to the project's coding standards. Be specific \u2014 cite file paths and line numbers. Flag severity: critical, warning, or nitpick. Keep the review focused and actionable."
+      },
+      debugger: {
+        description: "Use this agent to investigate bugs \u2014 read logs, trace error paths, check database state, reproduce issues. Delegate debugging here when the root cause isn't obvious from a quick look.",
+        prompt: "You are a debugger. Your job is to find the root cause, not patch symptoms. Check real data first \u2014 logs, network requests, database state. Trace the full lifecycle of the bug. Present your findings: root cause, evidence, and a proposed minimal fix. Do not edit files unless explicitly asked."
+      }
+    };
     const claudeBinary = await findExecutable("claude");
     this.logger.debug(
       {
@@ -20951,7 +21010,7 @@ var ClaudeAgentSession = class {
       // bypass launch capability available so later setPermissionMode("bypassPermissions")
       // calls do not fail after a model/thinking/rewind-driven restart.
       allowDangerouslySkipPermissions: true,
-      agents: this.defaults?.agents,
+      agents: { ...appostleAgents, ...this.defaults?.agents },
       canUseTool: this.handlePermissionRequest,
       ...claudeBinary ? { pathToClaudeCodeExecutable: claudeBinary } : {},
       // Use Claude Code preset system prompt and load CLAUDE.md files
@@ -33556,7 +33615,7 @@ function serializeFrontmatter(input) {
 
 // ../server/src/server/agent/handoff-mcp.ts
 function buildHandoffMcpServer(callerAgentId, options) {
-  const { agentManager, appostleHome, logger } = options;
+  const { agentManager, appostleHome, logger, agentStorage } = options;
   const log = logger.child({ module: "handoff-mcp", callerAgentId });
   const handoffTool = tool2(
     "handoff",
@@ -33635,6 +33694,22 @@ function buildHandoffMcpServer(callerAgentId, options) {
       } catch (err) {
         log.error({ err, agentId: snapshot.id }, "handoff: failed to start run");
       }
+      if (agentStorage) {
+        try {
+          setupFinishNotification({
+            agentManager,
+            agentStorage,
+            childAgentId: snapshot.id,
+            callerAgentId,
+            logger: log
+          });
+        } catch (err) {
+          log.error(
+            { err, agentId: snapshot.id },
+            "handoff: failed to wire auto-return notification"
+          );
+        }
+      }
       return {
         content: [
           {
@@ -33645,11 +33720,97 @@ function buildHandoffMcpServer(callerAgentId, options) {
       };
     }
   );
+  const reportTool = tool2(
+    "report",
+    [
+      "Send a curated message from this handoff child session back to its parent.",
+      "Use this when the user types `>report` \u2014 they want to deliver a specific update",
+      "to the parent right now, in their own words.",
+      "",
+      "Independent of the automatic on-finish notification: the parent still receives",
+      "the auto-return when this child eventually finishes. You can call this tool any",
+      "number of times over the lifetime of the handoff \u2014 each call is a separate",
+      "update.",
+      "",
+      "Only works in sessions that were spawned via `handoff`. Errors otherwise."
+    ].join("\n"),
+    {
+      message: z33.string().min(1).describe(
+        "The curated report to deliver to the parent session. Self-contained: the parent does not see this conversation's timeline."
+      )
+    },
+    async (args) => {
+      const childAgent = agentManager.getAgent(callerAgentId);
+      if (!childAgent) {
+        return {
+          isError: true,
+          content: [
+            { type: "text", text: `Caller agent ${callerAgentId} not found in agent manager` }
+          ]
+        };
+      }
+      const parentAgentId = childAgent.labels?.["appostle.parent-agent-id"];
+      if (!parentAgentId) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: "This session was not spawned via `handoff`, so there is no parent to report to."
+            }
+          ]
+        };
+      }
+      const parentAgent = agentManager.getAgent(parentAgentId);
+      if (!parentAgent) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: `Parent agent ${parentAgentId} is no longer available.`
+            }
+          ]
+        };
+      }
+      const childTitle = childAgent.config?.title ?? callerAgentId;
+      const trimmedMessage = args.message.trim();
+      const prompt = `<appostle-system>
+Agent ${callerAgentId} (${childTitle}) reported back:
+
+${trimmedMessage}
+</appostle-system>`;
+      try {
+        startAgentRun(agentManager, parentAgentId, prompt, log, {
+          replaceRunning: true
+        });
+      } catch (err) {
+        log.error({ err, parentAgentId }, "report: failed to inject prompt into parent");
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: `report failed: could not wake parent \u2014 ${err instanceof Error ? err.message : String(err)}`
+            }
+          ]
+        };
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Reported to parent ${parentAgentId}.`
+          }
+        ]
+      };
+    }
+  );
   const writePlanTool = buildWritePlanTool(callerAgentId, { agentManager, logger });
   const sdkInstance = createSdkMcpServer({
     name: "appostle",
     version: "0.1.0",
-    tools: [handoffTool, writePlanTool],
+    tools: [handoffTool, reportTool, writePlanTool],
     alwaysLoad: true
   });
   return {
@@ -34210,7 +34371,8 @@ var AgentManager = class {
       mcpServers.appostle = buildHandoffMcpServer(agentId, {
         agentManager: this,
         appostleHome: this.appostleHome,
-        logger: this.logger
+        logger: this.logger,
+        agentStorage: this.registry
       });
     }
     return { ...config, mcpServers };
@@ -34809,6 +34971,7 @@ var AgentManager = class {
       attentionReason: null,
       attentionTimestamp: null
     });
+    agent.archivedAt = archivedAt;
     this.notifyAgentState(agentId);
     await this.closeAgent(agentId);
     return { archivedAt };
@@ -40565,71 +40728,28 @@ function buildStructuralContext(allBrands) {
   return lines.length > 0 ? lines.join("\n") : "(No structural context established yet.)";
 }
 var TARGET_QUESTIONS = 7;
-var EMBEDDED_QA_FALLBACK = `## Compositional Philosophy
-- What's the single-sentence design philosophy that should govern every layout decision?
-- What's the ratio of whitespace to content density you're after?
-
-## Hero Behavior
-- How should the hero section behave? Full viewport takeover, contained module, asymmetric split?
-- Should the hero have scroll-triggered behavior or stay static?
-
-## Section Variation & Flow
-- How many distinct section types should the page cycle through?
-- Should any sections break out of the main container (full-bleed moments)?
-
-## Density & Spacing
-- How tight should content be packed within sections?
-- How much vertical breathing room between major sections?
-
-## Grid System
-- What grid philosophy \u2014 strict 12-column, asymmetric, modular, or freeform?
-
-## Containers & Cards
-- What's your card philosophy \u2014 flat, elevated, outlined, or glassmorphic?
-
-## Image Treatment
-- What role do images play \u2014 hero-level, supporting, or minimal?
-
-## CTA Strategy
-- How many CTAs per page and what's the hierarchy?
-
-## Mobile Behavior
-- How should the desktop layout transform on mobile?
-
-## Prohibitions & Bans
-- What design patterns are absolutely forbidden?
-- Any CSS properties or techniques that are banned?`;
-async function loadQaQuestions(logger) {
-  const filePath = await findFileUpward(QA_FILENAME);
-  if (filePath) {
-    try {
-      const content = await fs15.readFile(filePath, "utf8");
-      logger.debug({ filePath }, "layout-generator: loaded Q&A questions from disk");
-      return content;
-    } catch (err) {
-      logger.warn(
-        { err, filePath },
-        "layout-generator: failed to read Q&A file; using embedded fallback"
-      );
-    }
+async function loadSpecFile(filename, logger) {
+  const filePath = await findFileUpward(filename);
+  if (!filePath) {
+    throw new Error(
+      `layout-generator: ${filename} not found by walking up from ${fileURLToPath3(import.meta.url)}. This file is the canonical spec and must exist at the appostle repo root.`
+    );
   }
-  return EMBEDDED_QA_FALLBACK;
+  try {
+    const content = await fs15.readFile(filePath, "utf8");
+    logger.debug({ filePath }, `layout-generator: loaded ${filename} from disk`);
+    return content;
+  } catch (err) {
+    throw new Error(
+      `layout-generator: failed to read ${filename} at ${filePath}: ${err.message}`
+    );
+  }
+}
+async function loadQaQuestions(logger) {
+  return loadSpecFile(QA_FILENAME, logger);
 }
 async function loadLayoutPrompt(logger) {
-  const filePath = await findFileUpward(PROMPT_FILENAME);
-  if (filePath) {
-    try {
-      const content = await fs15.readFile(filePath, "utf8");
-      logger.debug({ filePath }, "layout-generator: loaded layout prompt from disk");
-      return content;
-    } catch (err) {
-      logger.warn(
-        { err, filePath },
-        "layout-generator: failed to read layout-prompt file; using embedded fallback"
-      );
-    }
-  }
-  return EMBEDDED_LAYOUT_PROMPT_FALLBACK;
+  return loadSpecFile(PROMPT_FILENAME, logger);
 }
 function interpolateTemplate(template, vars) {
   let out = template;
@@ -40638,66 +40758,6 @@ function interpolateTemplate(template, vars) {
   }
   return out;
 }
-var EMBEDDED_LAYOUT_PROMPT_FALLBACK = `You are an elite art director refining the layout and composition rules for a brand. This is ONLY about layout \u2014 structure, zones, grid, density, rhythm, containers, image placement, CTAs. Typography, colors, motion, animations, shadows are handled by separate brand files \u2014 do not duplicate them here.
-
-These rules must work across media \u2014 web pages, print, PDF, presentations. Use proportional language (fractions, ratios, percentages) as the primary system. CSS values are welcome as concrete examples but should not be the only expression of a rule.
-
-Your job: update the design role document based on the user's refinement prompt. This document will be injected wholesale into an AI builder's context. If your rules are vague, the output will be generic. If your rules are specific and opinionated, the output will be distinctive.
-
-The document must be a complete markdown document covering:
-- Enemy (a specific design this must NOT resemble, with 2-3 specific layout patterns that make it wrong \u2014 and for each, the exact counter-pattern this brand uses instead)
-- Signature Anomaly (the one structural layout choice that makes this unmistakably distinctive)
-- Compositional Philosophy (one structural law + the structural spine mechanism that enforces it across every zone)
-- Intensity Dials (Density 1-10, Grid Variance 1-10 \u2014 with concrete implications for THIS brand)
-- Opening Zone / Hero Behavior (surface coverage, bleed, content placement, containment)
-- Zone Inventory (ordered list of all major zones: name, layout job, dense/airy, full-bleed/contained \u2014 this is the master reference for the rhythm)
-- Zone Variation & Flow (how zones differ, transition strategy, full-bleed vs contained \u2014 references the Zone Inventory)
-- Density Philosophy (spacing values; the oscillation rhythm derived from the Zone Inventory \u2014 name which zones are dense, which are airy, in sequence)
-- Vertical Rhythm (three values: zone padding, element gap within zones, and the one zone that breaks the rhythm and why)
-- Grid System (exact column structure, asymmetry, proportions)
-- Content Width Strategy (max-width of the primary content area, which zones break it and why)
-- Container & Card Rules (borders, corners, nesting, exact border-radius)
-- Dividers & Graphic Structure (structural vs decorative, background strategy)
-- Image Treatment \u2014 Layout Only (placement, grid relationship, overlap behavior)
-- CTA Strategy (position in layout referencing Zone Inventory, container strategy, frequency)
-- Responsive Behavior (how the layout adapts across sizes \u2014 web: breakpoints and stacking; print: scale and margin strategy)
-- Bans (at least 20 specific layout prohibitions)
-
-## Critical rules
-
-1. This is a REFINEMENT. The user already has a role document (shown below). Their prompt refines, evolves, or redirects \u2014 it does NOT start from scratch unless they explicitly say so.
-
-2. SPECIFICITY IS MANDATORY. Every rule must be actionable at the structural level. Generic adjectives ("clean", "minimal", "modern", "elegant") are BANNED from the output.
-
-3. THE DOCUMENT MUST BE OPINIONATED, NOT HEDGED. Every sentence must prescribe or ban \u2014 never suggest. Use "Always", "Never", "Must", "Banned", "Required".
-
-4. STAY IN YOUR LANE. Do NOT include rules about typography, colors, motion/animation, or shadows \u2014 those belong in their own brand files.
-
-5. THE BANS ARE THE MOST IMPORTANT SECTION. At least 20 bans. The 7 universal AI-layout cliches MUST each appear as an explicit named ban: centered headline over full-width image; three equal-width feature cards in a row; alternating left-right image/text rows with identical padding; uniform zone height and padding; every block wrapped in a card with shadow + radius; CTA with gradient fill; full-width "Why Choose Us" icon grid. Plus 3-5 brand-specific AI tells.
-
-6. THE ENEMY IS MANDATORY. Name a specific real design and 2-3 exact layout patterns from it. Vague enemies fail.
-
-7. THE SIGNATURE ANOMALY IS MANDATORY. One specific structural choice. Apply the removal test: if removing this single decision would make the layout indistinguishable from a generic design \u2014 it qualifies. Must appear as a constraint in at least 2 other sections.
-
-8. USE THE STRUCTURAL CONTEXT. The {{structuralContext}} contains sibling brand files. Do not duplicate their rules \u2014 derive layout implications from them.
-
-## Current role document
-
-{{currentValues}}
-
-## Structural context (sibling brand files)
-
-{{structuralContext}}
-
-## User's refinement prompt
-
-{{userPrompt}}
-
-## Response format
-
-Return ONLY a JSON object: { "roleDocument": "# Brand Layout Role\\n\\n## Enemy\\n..." }
-
-Output ONLY the JSON object. No markdown fences. No explanation.`;
 function buildQaSystemPrompt(questions, layoutPromptSpec) {
   return `You are a chill creative director doing a quick vibe check on someone's layout taste.
 
@@ -42619,9 +42679,35 @@ var Session = class _Session {
     this.emit(message);
   }
   /**
-   * Send initial state to client after connection
+   * Push the first page of the agent directory unsolicited right after
+   * `server_info` so the client can paint attention state before its own
+   * paginated `fetch_agents_request` round-trip lands. The regular fetch
+   * still runs in parallel — it establishes the live-update subscription
+   * and paginates beyond the first page. This push exists purely to shave
+   * one relay round-trip from time-to-first-paint.
+   *
+   * Errors are swallowed: a failed push degrades to "wait for the client
+   * to ask," which is still correct.
    */
   async sendInitialState() {
+    try {
+      const synthetic = {
+        type: "fetch_agents_request",
+        requestId: "internal:initial-snapshot",
+        filter: { includeArchived: true },
+        page: { limit: InitialAgentSnapshotPageLimit }
+      };
+      const { entries } = await this.listFetchAgentsEntries(synthetic);
+      this.emit({
+        type: "initial_agent_snapshot",
+        payload: { entries }
+      });
+    } catch (error) {
+      this.sessionLogger.warn(
+        { err: error },
+        "Failed to push initial agent snapshot \u2014 client will fall back to fetch_agents_request"
+      );
+    }
   }
   /**
    * Normalize a user prompt (with optional image metadata) for AgentManager
@@ -53017,6 +53103,7 @@ var VoiceAssistantWebSocketServer = class {
     this.sessions.set(ws, connection);
     this.externalSessionsByKey.set(clientId, connection);
     this.sendToClient(ws, this.createServerInfoMessage());
+    void connection.session.sendInitialState();
     connection.connectionLogger.trace(
       {
         clientId,