dsh-ntr 0.3.4 → 0.3.5

package/src/impl.ts

@@ -2665,6 +2665,51 @@ export interface SessionLogLike {
   header?: { agentPreset?: unknown }
 }
 
+/**
+ * Structural view of a LIVE host session that can take catalog appends. The
+ * host's `Session.append` validates the payload before committing; an older
+ * host without the `subagent/catalog` event accepts the method but throws,
+ * which the helper below treats as "not supported".
+ */
+export interface SessionCatalogLike extends SessionLogLike {
+  append?: (type: string, data: Record<string, unknown>) => unknown
+}
+
+/**
+ * Record one ACP-side worker in the host's parent-owned subagent catalog as an
+ * EXTERNAL execution. Display-only: external entries have no child session, no
+ * activity/timing and no continuation, and `list_agents` omits them. The
+ * catalog is append-only, so a replayed/resumed dispatch must never add the
+ * same `childId` twice. Returns whether a new fact was appended.
+ */
+export function appendExternalSubagentCatalog(
+  session: SessionCatalogLike | undefined,
+  childId: string,
+  label: string,
+  now = Date.now(),
+): boolean {
+  if (childId === '' || session?.append === undefined) return false
+  const events = session.events
+  if (Array.isArray(events)) {
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+      const event = events[index] as { type?: unknown; data?: { childId?: unknown } } | undefined
+      if (event?.type === 'subagent/catalog' && event.data?.childId === childId) return false
+    }
+  }
+  try {
+    session.append('subagent/catalog', {
+      version: 2,
+      childId,
+      childCreatedAt: now,
+      mode: 'external',
+      label,
+    })
+    return true
+  } catch {
+    return false
+  }
+}
+
 /**
  * The agent preset a session actually runs.
  *

package/src/index.ts

@@ -9,9 +9,9 @@ import type { Context } from '@deepseek-ai/cordis'
 import type {} from '@deepseek-ai/dsh-host-webserver'
 import type { ConnectionRpcHandler, HostConnectionHandle } from '@deepseek-ai/dsh-client-connection'
 import { ACP_PRESET_ID, AcpLlmAdapter, BridgeManager, PLUGIN_VERSION } from './bridge.ts'
-import { EventHub, dispatchRpc, permissionReplayFrames, sessionAgentPreset, sessionAgentPresetFromLog, validateConfig } from './impl.ts'
+import { appendExternalSubagentCatalog, EventHub, dispatchRpc, permissionReplayFrames, sessionAgentPreset, sessionAgentPresetFromLog, validateConfig } from './impl.ts'
 import type { AcpEvent, ApprovalDeadlineKey } from './protocol.ts'
-import type { RosterPresetRow, SessionLogLike } from './impl.ts'
+import type { RosterPresetRow, SessionCatalogLike } from './impl.ts'
 import { UpdateService } from './update.ts'
 import type { UpdateManagerLike } from './update.ts'
 
@@ -39,7 +39,7 @@ interface ChannelRegisteringConnection extends HostConnectionHandle {
 
 /** Structural view of the host session store (`@deepseek-ai/dsh-session`'s `ctx.sessions`). */
 interface SessionsLike {
-  get(sessionId: string): SessionLogLike | undefined
+  get(sessionId: string): SessionCatalogLike | undefined
 }
 
 /**
@@ -260,6 +260,27 @@ export function apply(ctx: Context, config?: unknown): void {
     }
   }
 
+  /**
+   * Optional host integration: record detached ACP workers as EXTERNAL
+   * children in the parent chat session's subagent catalog. Display-only — the
+   * host renders them as read-only "external task" rows with no child
+   * session, activity or continuation — and is skipped silently on hosts
+   * without the catalog event.
+   */
+  const wireSubagentCatalog = (): void => {
+    const sessions = (typeof ctx.get === 'function' ? ctx.get('sessions') : undefined) as SessionsLike | undefined
+    if (sessions === undefined) return
+    manager.setSubagentCatalogReporter((dshSessionId, childId, label) => {
+      let session: SessionCatalogLike | undefined
+      try {
+        session = sessions.get(dshSessionId)
+      } catch {
+        return
+      }
+      appendExternalSubagentCatalog(session, childId, label)
+    })
+  }
+
   wireWorkspace()
   if (typeof ctx.inject === 'function') {
     // Late arrival for the workspace collaborators: a deployment missing one
@@ -271,9 +292,11 @@ export function apply(ctx: Context, config?: unknown): void {
   // The ACP-preset verdict only needs the session store (live) and the
   // persistence store (cold); the sandbox knobs are NOT its dependencies.
   wireAcpMode()
+  wireSubagentCatalog()
   if (typeof ctx.inject === 'function') {
     ctx.inject(['sessions'], () => {
       wireAcpMode()
+      wireSubagentCatalog()
     })
   }
 

package/src/protocol.ts

@@ -346,9 +346,10 @@ export interface AgentView {
 
 /**
  * Why the host released a session's agent process. The browser turns this into
- * one runtime-log line per cause; `idle` stays silent (expected lifecycle).
+ * one runtime-log line per cause; `idle` and `shutdown` stay silent (both are
+ * expected lifecycle transitions, not faults).
  */
-export type AcpReleaseCause = 'idle' | 'workspace' | 'resume-failed' | 'stalled' | 'died'
+export type AcpReleaseCause = 'idle' | 'workspace' | 'resume-failed' | 'stalled' | 'died' | 'shutdown'
 
 export type AcpEvent =
   | { type: 'agent/status'; agentId: string; state: AgentProcessState; error?: string; agent?: AgentView }