From 4c4ae96d57517ccbd76ef3074d5ea5e07974bb4d Mon Sep 17 00:00:00 2001
From: "Maksym Hryzodub [DREAM]" <maksym.hryzodub@dreamvention.com>
Date: Wed, 23 Sep 2026 15:19:04 +0300
Subject: [PATCH 1/3] fix(admin,api): no "after restart" badge until the new
 pod has listed its tools (CLEAN-109)

A snapshot older than the running pod belongs to its predecessor; it now
reads as "listing pending" (no per-tool flags) instead of "this pod lacks
everything". The sheet loads through the store on every open, shows a quiet
"loading its tools" note while pending and polls until the listing lands.
A real-container test proves the recorder lookup across modules.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---
 .../components/toolCatalog/Sheet.vue          |  77 ++++++++++++--
 .../toolCatalog/data/toolCatalog.mapper.ts    |   4 +
 .../toolCatalog/domain/toolCatalog.types.ts   |   7 ++
 .../toolCatalog/utils/filterCatalog.test.ts   |   1 +
 .../api/data/repositories/api/schemas.gen.ts  |   8 +-
 .../api/data/repositories/api/types.gen.ts    |   4 +
 .../domain/toolCatalog.service.spec.ts        |  40 +++++--
 .../toolCatalog/domain/toolCatalog.service.ts |  38 +++++--
 .../toolCatalog/domain/toolCatalog.types.ts   |   8 ++
 .../toolCatalog/dto/agentToolCatalog.dto.ts   |   7 ++
 .../toolListingRecorder.di.spec.ts            | 100 ++++++++++++++++++
 specs/016-agent-tool-parity/data-model.md     |   3 +-
 12 files changed, 275 insertions(+), 22 deletions(-)
 create mode 100644 api/src/slices/agent/toolCatalog/toolListingRecorder.di.spec.ts

diff --git a/admin/slices/agent/toolCatalog/components/toolCatalog/Sheet.vue b/admin/slices/agent/toolCatalog/components/toolCatalog/Sheet.vue
index 21126c21..056fbc10 100644
--- a/admin/slices/agent/toolCatalog/components/toolCatalog/Sheet.vue
+++ b/admin/slices/agent/toolCatalog/components/toolCatalog/Sheet.vue
@@ -1,6 +1,6 @@
 <script setup lang="ts">
-import { computed, ref, watch } from 'vue'
-import { Search, X } from 'lucide-vue-next'
+import { computed, onBeforeUnmount, ref, watch } from 'vue'
+import { Loader2, Search, X } from 'lucide-vue-next'
 import {
   Sheet,
   SheetContent,
@@ -41,11 +41,24 @@ const catalog = computed(() => store.byAgent(props.agentId))
 const agent = computed(() => agentStore.byId(props.agentId))
 const ui = computed(() => store.uiOf(props.agentId))
 
-const { pending, error, refresh } = useAsyncData(
-  `admin-tool-catalog-${props.agentId}`,
-  () => store.fetchByAgent(props.agentId),
-  { immediate: false, server: false },
-)
+// Loading state only; the record itself is read from the store (docs/state.md).
+// Plain refs rather than useAsyncData: this sheet re-reads on every open and
+// polls while the agent boots, and a keyed cache in between is exactly the
+// kind of second copy that showed a restarted agent its old list.
+const pending = ref(false)
+const error = ref<unknown>(null)
+
+async function refresh(): Promise<void> {
+  pending.value = true
+  try {
+    await store.fetchByAgent(props.agentId)
+    error.value = null
+  } catch (e) {
+    error.value = e
+  } finally {
+    pending.value = false
+  }
+}
 
 // Load on first open, and again on every open so a tool that landed since is
 // there; the cached record renders meanwhile, so nothing flickers.
@@ -68,6 +81,46 @@ watch(
   },
 )
 
+// A freshly started pod lists its tools a few seconds after it is up. While
+// the sheet is open and the API says the listing is still pending, poll —
+// bounded, so a pod that never lists (or an operator who walks away) does not
+// keep the tab busy forever.
+const POLL_MS = 4000
+const POLL_LIMIT = 30
+let pollTimer: ReturnType<typeof setTimeout> | null = null
+let pollCount = 0
+
+function stopPolling() {
+  if (pollTimer) clearTimeout(pollTimer)
+  pollTimer = null
+  pollCount = 0
+}
+
+function schedulePoll() {
+  if (pollTimer || !props.open) return
+  if (catalog.value?.listingState !== 'pending') return
+  if (pollCount >= POLL_LIMIT) return
+  pollTimer = setTimeout(async () => {
+    pollTimer = null
+    pollCount += 1
+    if (!props.open) return
+    await refresh()
+    schedulePoll()
+  }, POLL_MS)
+}
+
+watch(
+  () => [props.open, catalog.value?.listingState] as const,
+  ([isOpen, state]) => {
+    if (!isOpen) return stopPolling()
+    if (state === 'pending') schedulePoll()
+    else stopPolling()
+  },
+  { immediate: true },
+)
+
+onBeforeUnmount(stopPolling)
+
 const query = computed({
   get: () => ui.value.query,
   set: (value: string) => store.setQuery(props.agentId, value),
@@ -192,11 +245,19 @@ const searchRef = ref<InstanceType<typeof Input> | null>(null)
       </ScrollArea>
 
       <p
-        v-if="catalog?.podStartedAt === null"
+        v-if="catalog?.listingState === 'none'"
         class="border-t px-4 py-2 text-[11px] text-muted-foreground"
       >
         The agent is not running. Tools are listed as they will be once it starts.
       </p>
+      <p
+        v-else-if="catalog?.listingState === 'pending'"
+        class="flex items-center gap-1.5 border-t px-4 py-2 text-[11px] text-muted-foreground"
+        role="status"
+      >
+        <Loader2 class="size-3 animate-spin" />
+        The agent has started and is loading its tools; this list updates on its own.
+      </p>
     </SheetContent>
   </Sheet>
 </template>
diff --git a/admin/slices/agent/toolCatalog/data/toolCatalog.mapper.ts b/admin/slices/agent/toolCatalog/data/toolCatalog.mapper.ts
index 028f8cd5..98b70906 100644
--- a/admin/slices/agent/toolCatalog/data/toolCatalog.mapper.ts
+++ b/admin/slices/agent/toolCatalog/data/toolCatalog.mapper.ts
@@ -49,6 +49,10 @@ export class ToolCatalogMapper {
       agentId: str(dto.agentId),
       podStartedAt: dto.podStartedAt ?? null,
       listedAt: dto.listedAt ?? null,
+      listingState:
+        dto.listingState === 'fresh' || dto.listingState === 'pending'
+          ? dto.listingState
+          : 'none',
       groups: Array.isArray(dto.groups)
         ? dto.groups.map((g) => this.toGroup(g))
         : [],
diff --git a/admin/slices/agent/toolCatalog/domain/toolCatalog.types.ts b/admin/slices/agent/toolCatalog/domain/toolCatalog.types.ts
index fd868b0e..0db090f7 100644
--- a/admin/slices/agent/toolCatalog/domain/toolCatalog.types.ts
+++ b/admin/slices/agent/toolCatalog/domain/toolCatalog.types.ts
@@ -28,10 +28,17 @@ export interface IAgentToolGroup {
   tools: IAgentToolEntry[];
 }
 
+/**
+ * none — no pod runs; pending — the running pod has not listed its tools yet;
+ * fresh — the per-tool `inPod` flags come from this pod.
+ */
+export type ToolListingStates = 'none' | 'pending' | 'fresh';
+
 export interface IAgentToolCatalog {
   agentId: string;
   podStartedAt: string | null;
   listedAt: string | null;
+  listingState: ToolListingStates;
   groups: IAgentToolGroup[];
 }
 
diff --git a/admin/slices/agent/toolCatalog/utils/filterCatalog.test.ts b/admin/slices/agent/toolCatalog/utils/filterCatalog.test.ts
index 9484b94c..94fe8eda 100644
--- a/admin/slices/agent/toolCatalog/utils/filterCatalog.test.ts
+++ b/admin/slices/agent/toolCatalog/utils/filterCatalog.test.ts
@@ -15,6 +15,7 @@ const catalog: IAgentToolCatalog = {
   agentId: 'a',
   podStartedAt: null,
   listedAt: null,
+  listingState: 'none',
   groups: [
     {
       key: 'agents',
diff --git a/admin/slices/setup/api/data/repositories/api/schemas.gen.ts b/admin/slices/setup/api/data/repositories/api/schemas.gen.ts
index 4b4c4be0..ebbc2109 100644
--- a/admin/slices/setup/api/data/repositories/api/schemas.gen.ts
+++ b/admin/slices/setup/api/data/repositories/api/schemas.gen.ts
@@ -3549,6 +3549,12 @@ export const AgentToolCatalogDtoSchema = {
       description: "When the pod last called tools/list; null if it never did.",
       example: "2026-09-22T10:33:05.000Z",
     },
+    listingState: {
+      type: "string",
+      enum: ["none", "pending", "fresh"],
+      description:
+        "none — no pod runs; pending — the running pod has not listed its tools yet, so no inPod flag is set; fresh — the snapshot is from this pod.",
+    },
     groups: {
       type: "array",
       items: {
@@ -3556,7 +3562,7 @@ export const AgentToolCatalogDtoSchema = {
       },
     },
   },
-  required: ["agentId", "podStartedAt", "listedAt", "groups"],
+  required: ["agentId", "podStartedAt", "listedAt", "listingState", "groups"],
 } as const;
 
 export const SecretEntryDtoSchema = {
diff --git a/admin/slices/setup/api/data/repositories/api/types.gen.ts b/admin/slices/setup/api/data/repositories/api/types.gen.ts
index b1a9b615..e9590dc4 100644
--- a/admin/slices/setup/api/data/repositories/api/types.gen.ts
+++ b/admin/slices/setup/api/data/repositories/api/types.gen.ts
@@ -1643,6 +1643,10 @@ export type AgentToolCatalogDto = {
    * When the pod last called tools/list; null if it never did.
    */
   listedAt: string | null;
+  /**
+   * none — no pod runs; pending — the running pod has not listed its tools yet, so no inPod flag is set; fresh — the snapshot is from this pod.
+   */
+  listingState: "none" | "pending" | "fresh";
   groups: Array<AgentToolGroupDto>;
 };
 
diff --git a/api/src/slices/agent/toolCatalog/domain/toolCatalog.service.spec.ts b/api/src/slices/agent/toolCatalog/domain/toolCatalog.service.spec.ts
index 31eef6e6..42e368b8 100644
--- a/api/src/slices/agent/toolCatalog/domain/toolCatalog.service.spec.ts
+++ b/api/src/slices/agent/toolCatalog/domain/toolCatalog.service.spec.ts
@@ -1,5 +1,9 @@
 import { NotFoundException } from '@nestjs/common';
-import { ToolCatalogService, agentPrincipal } from './toolCatalog.service';
+import {
+  ToolCatalogService,
+  agentPrincipal,
+  listingStateOf,
+} from './toolCatalog.service';
 import type { IListedTool } from '#/mcp/services/tool-catalog.service';
 import { UserRoleTypes } from '#/user/user/domain';
 
@@ -130,27 +134,51 @@ describe('ToolCatalogService.forAgent', () => {
     });
   });
 
-  it('inPod: null without a pod, false for a pod that never listed, per name otherwise', async () => {
+  it('inPod: null without a pod or a listing from this pod, per name once the pod listed', async () => {
     const tools = [listed('old', 'agents'), listed('new', 'agents')];
 
     const noPod = await harness({ tools, pod: false }).service.forAgent('agent-1');
     expect(noPod.podStartedAt).toBeNull();
+    expect(noPod.listingState).toBe('none');
     expect(noPod.groups[0].tools.map((t) => t.inPod)).toEqual([null, null]);
     expect(noPod.groups[0].afterRestart).toBe(false);
 
+    // Never listed: we cannot say what the pod lacks, so no badge.
     const neverListed = await harness({ tools, snapshot: null }).service.forAgent('agent-1');
     expect(neverListed.listedAt).toBeNull();
-    expect(neverListed.groups[0].tools.map((t) => t.inPod)).toEqual([false, false]);
-    expect(neverListed.groups[0].afterRestart).toBe(true);
+    expect(neverListed.listingState).toBe('pending');
+    expect(neverListed.groups[0].tools.map((t) => t.inPod)).toEqual([null, null]);
+    expect(neverListed.groups[0].afterRestart).toBe(false);
 
+    // The previous pod's snapshot, right after a restart: the new pod has not
+    // listed yet, and its predecessor's list must not read as this pod's.
+    const stale = await harness({
+      tools,
+      snapshot: { toolNames: ['old'], listedAt: new Date('2026-09-22T09:00:00.000Z') },
+    }).service.forAgent('agent-1');
+    expect(stale.listingState).toBe('pending');
+    expect(stale.groups[0].tools.map((t) => t.inPod)).toEqual([null, null]);
+    expect(stale.groups[0].afterRestart).toBe(false);
+
+    // Listed by this pod (a few seconds after it started): precise flags.
     const partial = await harness({
       tools,
-      snapshot: { toolNames: ['old'], listedAt: new Date(POD_START) },
+      snapshot: { toolNames: ['old'], listedAt: new Date('2026-09-22T10:00:05.000Z') },
     }).service.forAgent('agent-1');
+    expect(partial.listingState).toBe('fresh');
     const byName = Object.fromEntries(partial.groups[0].tools.map((t) => [t.name, t.inPod]));
     expect(byName).toEqual({ old: true, new: false });
     expect(partial.groups[0].afterRestart).toBe(true);
-    expect(partial.listedAt).toBe(POD_START);
+    expect(partial.listedAt).toBe('2026-09-22T10:00:05.000Z');
+  });
+
+  it('listingStateOf tolerates clock skew between kubelet and the API', () => {
+    expect(listingStateOf(null, new Date())).toBe('none');
+    expect(listingStateOf(POD_START, null)).toBe('pending');
+    // Listed 3 s "before" the pod started: two clocks, one pod — still fresh.
+    expect(listingStateOf(POD_START, new Date('2026-09-22T09:59:57.000Z'))).toBe('fresh');
+    // Listed a minute before: a previous pod.
+    expect(listingStateOf(POD_START, new Date('2026-09-22T09:59:00.000Z'))).toBe('pending');
   });
 
   it('appends external servers as opaque groups without url or auth, with drift', async () => {
diff --git a/api/src/slices/agent/toolCatalog/domain/toolCatalog.service.ts b/api/src/slices/agent/toolCatalog/domain/toolCatalog.service.ts
index b2c3865f..6eee58b6 100644
--- a/api/src/slices/agent/toolCatalog/domain/toolCatalog.service.ts
+++ b/api/src/slices/agent/toolCatalog/domain/toolCatalog.service.ts
@@ -19,6 +19,7 @@ import {
   IAgentToolEntry,
   IAgentToolGroup,
   IToolListingGateway,
+  ToolListingStates,
 } from './toolCatalog.types';
 
 /**
@@ -76,14 +77,20 @@ export class ToolCatalogService {
 
     const pod = pods.find((p) => p.agentId === agentId) ?? null;
     const podStartedAt = pod?.startedAt ?? null;
-    const known = snapshot ? new Set(snapshot.toolNames) : null;
+
+    // A snapshot only speaks for the pod that made it. Right after a restart
+    // the new pod is up before it has listed its tools, and the previous
+    // pod's snapshot would read as "this pod lacks everything" — a badge that
+    // told the person to restart the agent they had just restarted. So a
+    // snapshot older than the pod counts as "not listed yet": no badge,
+    // and the sheet says the agent is still loading its tools.
+    const listingState = listingStateOf(podStartedAt, snapshot?.listedAt ?? null);
+    const known =
+      listingState === 'fresh' && snapshot ? new Set(snapshot.toolNames) : null;
 
     const inPodOf = (name: string): boolean | null => {
-      // No pod: nothing to restart, so no marker (data-model.md §3).
-      if (!podStartedAt) return null;
-      // A pod that never listed predates this feature — it needs a restart
-      // to receive anything new, so every tool reads as absent.
-      if (!known) return false;
+      // No pod, or no listing from this pod yet: nothing to claim.
+      if (!known) return null;
       return known.has(name);
     };
 
@@ -140,7 +147,26 @@ export class ToolCatalogService {
       agentId,
       podStartedAt,
       listedAt: snapshot ? snapshot.listedAt.toISOString() : null,
+      listingState,
       groups,
     };
   }
 }
+
+/**
+ * Container start and the first tools/list are seconds apart in the same
+ * direction, but the two clocks (kubelet vs. this API) need not agree to the
+ * millisecond; a small slack keeps a legitimate listing from reading as
+ * older than its pod.
+ */
+const CLOCK_SLACK_MS = 10_000;
+
+export function listingStateOf(
+  podStartedAt: string | null,
+  listedAt: Date | null,
+): ToolListingStates {
+  if (!podStartedAt) return 'none';
+  if (!listedAt) return 'pending';
+  const start = new Date(podStartedAt).getTime();
+  return listedAt.getTime() + CLOCK_SLACK_MS >= start ? 'fresh' : 'pending';
+}
diff --git a/api/src/slices/agent/toolCatalog/domain/toolCatalog.types.ts b/api/src/slices/agent/toolCatalog/domain/toolCatalog.types.ts
index 5f76d5da..0ca3b63d 100644
--- a/api/src/slices/agent/toolCatalog/domain/toolCatalog.types.ts
+++ b/api/src/slices/agent/toolCatalog/domain/toolCatalog.types.ts
@@ -34,12 +34,20 @@ export interface IAgentToolGroup {
   tools: IAgentToolEntry[];
 }
 
+/**
+ * none — no pod runs; pending — the running pod has not listed its tools yet
+ * (or only an older pod did); fresh — the snapshot comes from this pod, so
+ * per-tool `inPod` flags are meaningful.
+ */
+export type ToolListingStates = 'none' | 'pending' | 'fresh';
+
 export interface IAgentToolCatalog {
   agentId: string;
   /** ISO; null when no pod runs. */
   podStartedAt: string | null;
   /** ISO of the last tools/list the pod made; null if it never did. */
   listedAt: string | null;
+  listingState: ToolListingStates;
   groups: IAgentToolGroup[];
 }
 
diff --git a/api/src/slices/agent/toolCatalog/dto/agentToolCatalog.dto.ts b/api/src/slices/agent/toolCatalog/dto/agentToolCatalog.dto.ts
index 71b7a18d..8c2e95b1 100644
--- a/api/src/slices/agent/toolCatalog/dto/agentToolCatalog.dto.ts
+++ b/api/src/slices/agent/toolCatalog/dto/agentToolCatalog.dto.ts
@@ -88,6 +88,13 @@ export class AgentToolCatalogDto {
   })
   listedAt: string | null;
 
+  @ApiProperty({
+    enum: ['none', 'pending', 'fresh'],
+    description:
+      'none — no pod runs; pending — the running pod has not listed its tools yet, so no inPod flag is set; fresh — the snapshot is from this pod.',
+  })
+  listingState: 'none' | 'pending' | 'fresh';
+
   @ApiProperty({ type: [AgentToolGroupDto] })
   groups: AgentToolGroupDto[];
 }
diff --git a/api/src/slices/agent/toolCatalog/toolListingRecorder.di.spec.ts b/api/src/slices/agent/toolCatalog/toolListingRecorder.di.spec.ts
new file mode 100644
index 00000000..e509b5e4
--- /dev/null
+++ b/api/src/slices/agent/toolCatalog/toolListingRecorder.di.spec.ts
@@ -0,0 +1,100 @@
+import { Injectable, Module } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { Test } from '@nestjs/testing';
+import type { Request } from 'express';
+import { McpToolsHandler } from '#/mcp/services/handlers/mcp-tools.handler';
+import { McpRegistryService } from '#/mcp/services/mcp-registry.service';
+import {
+  TOOL_LISTING_RECORDER,
+  type IToolListingRecorder,
+} from '#/mcp/interfaces/tool-listing-recorder.interface';
+import { ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+
+/**
+ * The tools handler finds the listing recorder through `ModuleRef.get(token,
+ * { strict: false })` from INSIDE the mcp module, while the recorder is
+ * provided by another module under a `useExisting` alias — exactly how
+ * ToolCatalogModule wires it. A lookup that silently fails there means the
+ * snapshot is never written and every pod reads as "after restart" forever,
+ * so this test runs the real Nest container rather than a mock ModuleRef.
+ */
+abstract class IRecorderGateway implements IToolListingRecorder {
+  abstract record(agentId: string, toolNames: string[]): Promise<void>;
+}
+
+@Injectable()
+class RecorderGateway extends IRecorderGateway {
+  calls: Array<[string, string[]]> = [];
+  async record(agentId: string, toolNames: string[]): Promise<void> {
+    this.calls.push([agentId, toolNames]);
+    return Promise.resolve();
+  }
+}
+
+@Module({
+  providers: [
+    { provide: IRecorderGateway, useClass: RecorderGateway },
+    { provide: TOOL_LISTING_RECORDER, useExisting: IRecorderGateway },
+  ],
+  exports: [IRecorderGateway, TOOL_LISTING_RECORDER],
+})
+class RecorderModule {}
+
+/** Stands in for McpModule: knows nothing about RecorderModule. */
+@Injectable()
+class HandlerHost {
+  constructor(public readonly moduleRef: ModuleRef) {}
+}
+
+@Module({ providers: [HandlerHost] })
+class HostModule {}
+
+describe('tools/list snapshot — real container lookup (CLEAN-109)', () => {
+  it('the handler reaches a recorder provided under a useExisting alias in another module', async () => {
+    const app = await Test.createTestingModule({
+      imports: [RecorderModule, HostModule],
+    }).compile();
+
+    const host = app.get(HandlerHost);
+    const registry = {
+      getTools: () => [
+        {
+          type: 'tool' as const,
+          metadata: {
+            name: 'list_agents',
+            description: 'x',
+            parameters: z.object({}),
+            topic: 'agents',
+            title: 'List agents',
+            template: 'List all agents',
+          },
+          providerClass: Symbol('none'),
+          methodName: 'run',
+        },
+      ],
+      findTool: () => undefined,
+    } as unknown as McpRegistryService;
+
+    const handlers = new Map<unknown, (r: unknown) => Promise<unknown>>();
+    const mcpServer = {
+      server: {
+        transport: { sessionId: 'sess-1' },
+        setRequestHandler: (schema: unknown, fn: (r: unknown) => Promise<unknown>) =>
+          handlers.set(schema, fn),
+      },
+    } as unknown as McpServer;
+    const httpRequest = {
+      user: { sub: 'agent:a-9', email: '', roles: ['agent'] },
+    } as unknown as Request;
+
+    const handler = new McpToolsHandler(host.moduleRef, registry);
+    handler.registerHandlers(mcpServer, httpRequest);
+    await handlers.get(ListToolsRequestSchema)!({});
+    await new Promise((r) => setImmediate(r));
+
+    const recorder = app.get(IRecorderGateway) as RecorderGateway;
+    expect(recorder.calls).toEqual([['a-9', ['list_agents']]]);
+  });
+});
diff --git a/specs/016-agent-tool-parity/data-model.md b/specs/016-agent-tool-parity/data-model.md
index b6e152fe..f48ff1a6 100644
--- a/specs/016-agent-tool-parity/data-model.md
+++ b/specs/016-agent-tool-parity/data-model.md
@@ -72,7 +72,8 @@ interface AgentToolEntry {
 
 Derivation:
 - `tools` = `ToolCatalogService.listFor(principal)` with `principal = { sub: 'agent:<id>', roles: agent.isAdmin ? [Owner] : [Agent] }`.
-- `inPod` = `podStartedAt === null ? null : (snapshot ? snapshot.toolNames.includes(name) : false)`.
+- `listingState`: `none` when no pod runs; `pending` when there is no snapshot or the snapshot is older than the pod (with 10 s of clock slack) — the running pod has not listed its tools yet; `fresh` otherwise.
+- `inPod` = `listingState === 'fresh' ? snapshot.toolNames.includes(name) : null`. A badge is only ever a claim backed by this pod's own listing; right after a restart the sheet shows "loading its tools" and polls instead.
 - External groups = `AgentMcpResolver.resolveForAgent(agent)` minus built-in ids (`mcp-ranch`, `mcp-knowledge`, `mcp-documents`, `mcp-cleanslice`); `authValue` and `url` are **not** returned.
 - Response is not cached; one DB read (snapshot) + resolver + pod list.
 

From 71a4194510d017c037c5d60445323c09d7f9e6b6 Mon Sep 17 00:00:00 2001
From: "Maksym Hryzodub [DREAM]" <maksym.hryzodub@dreamvention.com>
Date: Wed, 23 Sep 2026 15:19:05 +0300
Subject: [PATCH 2/3] chore: bump version to 0.3.62 (CLEAN-109)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d666bcfb..bcee9ab3 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "ranch",
-  "version": "0.3.61",
+  "version": "0.3.62",
   "private": true,
   "packageManager": "bun@1.2.12",
   "workspaces": [

From 476a435cc0d5f0ddb1270df0df171386dbb91c37 Mon Sep 17 00:00:00 2001
From: "Maksym Hryzodub [DREAM]" <maksym.hryzodub@dreamvention.com>
Date: Wed, 23 Sep 2026 15:24:02 +0300
Subject: [PATCH 3/3] test(api): type the recorder lookup explicitly in the DI
 spec (CLEAN-109)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---
 .../slices/agent/toolCatalog/toolListingRecorder.di.spec.ts   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/api/src/slices/agent/toolCatalog/toolListingRecorder.di.spec.ts b/api/src/slices/agent/toolCatalog/toolListingRecorder.di.spec.ts
index e509b5e4..c83723b6 100644
--- a/api/src/slices/agent/toolCatalog/toolListingRecorder.di.spec.ts
+++ b/api/src/slices/agent/toolCatalog/toolListingRecorder.di.spec.ts
@@ -94,7 +94,9 @@ describe('tools/list snapshot — real container lookup (CLEAN-109)', () => {
     await handlers.get(ListToolsRequestSchema)!({});
     await new Promise((r) => setImmediate(r));
 
-    const recorder = app.get(IRecorderGateway) as RecorderGateway;
+    const recorder = app.get<IRecorderGateway, RecorderGateway>(
+      IRecorderGateway,
+    );
     expect(recorder.calls).toEqual([['a-9', ['list_agents']]]);
   });
 });