tmux-ide 2.9.0-beta.47 → 2.9.0-beta.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tmux-ide",
-  "version": "2.9.0-beta.47",
+  "version": "2.9.0-beta.49",
   "description": "A visual, agent-aware IDE for any tmux session, with optional workspace presets",
   "type": "module",
   "bin": {
@@ -64,7 +64,7 @@
     "postinstall": "node scripts/postinstall.js",
     "docs": "turbo run dev --filter=@tmux-ide/docs",
     "demo:tui": "bun --preload @opentui/solid/preload docs/scripts/render-tui-demo.tsx",
-    "test:tui-renderer": "bun test --preload @opentui/solid/preload --preload ./packages/daemon/test-support/opentui-renderer-preload.ts ./packages/daemon/src/tui/mirror/automatic-contrast-renderer.test.tsx ./packages/daemon/src/tui/mirror/pane-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/native-grid-projection-renderer.test.tsx ./packages/daemon/src/tui/mirror/widget-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/missions-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/recipes-gallery-renderer.test.tsx ./packages/daemon/src/tui/mirror/shell-chrome-renderer.test.tsx ./packages/daemon/src/tui/mirror/sidebar-renderer.test.tsx ./packages/daemon/src/tui/mirror/home-files-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/changes-terminal-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/activity-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/features/files/session-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-terminal-workspace-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-shell-view-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-root-error-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-backpressure-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-demand-cadence-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/files-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/changes-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/missions-activity-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/dialogs-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/optional-feature-registry-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/palette-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/pane-scoped-terminal-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/features/rich-preview/feature.test.ts ./packages/daemon/src/tui/mirror/runtime/rich-preview-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/application-shell-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/pane-frame-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/terminal-pane-chrome-view.test.tsx ./packages/daemon/src/tui/mirror/workspace/terminal-window-strip-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/workbench-shell-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/workbench-dock-dual-host-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/agent-terminal-canvas-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/command-palette-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/opentui-insertion-stability-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-shell-home-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/terminal-pane-header-polish-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-home-agent-roster-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-home-agent-flow-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/guided-tour-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-shell-sidebar-catalog-renderer.test.tsx ./packages/daemon/src/tui/mirror/ui/ui-renderer.test.tsx ./packages/daemon/src/tui/mirror/ui/pane-interaction-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-machine-sidebar-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-add-machine-dialog-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-fleet-switcher-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-palette-preview-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-fleet-palette-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-fleet-session-actions-renderer.test.tsx",
+    "test:tui-renderer": "bun test --preload @opentui/solid/preload --preload ./packages/daemon/test-support/opentui-renderer-preload.ts ./packages/daemon/src/tui/mirror/automatic-contrast-renderer.test.tsx ./packages/daemon/src/tui/mirror/pane-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/native-grid-projection-renderer.test.tsx ./packages/daemon/src/tui/mirror/widget-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/missions-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/recipes-gallery-renderer.test.tsx ./packages/daemon/src/tui/mirror/shell-chrome-renderer.test.tsx ./packages/daemon/src/tui/mirror/sidebar-renderer.test.tsx ./packages/daemon/src/tui/mirror/home-files-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/changes-terminal-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/activity-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/features/files/session-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-terminal-workspace-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-shell-view-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-root-error-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-backpressure-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-demand-cadence-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/files-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/changes-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/missions-activity-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/dialogs-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/optional-feature-registry-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/palette-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/pane-scoped-terminal-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/features/rich-preview/feature.test.ts ./packages/daemon/src/tui/mirror/runtime/rich-preview-optional-feature-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/application-shell-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/pane-frame-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/terminal-pane-chrome-view.test.tsx ./packages/daemon/src/tui/mirror/workspace/terminal-window-strip-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/workbench-shell-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/workbench-dock-dual-host-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/agent-terminal-canvas-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/command-palette-surface-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/opentui-insertion-stability-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-shell-home-renderer.test.tsx ./packages/daemon/src/tui/mirror/workspace/terminal-pane-header-polish-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-home-agent-roster-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-home-agent-flow-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/guided-tour-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-shell-sidebar-catalog-renderer.test.tsx ./packages/daemon/src/tui/mirror/ui/ui-renderer.test.tsx ./packages/daemon/src/tui/mirror/ui/pane-interaction-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-machine-sidebar-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-add-machine-dialog-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-new-agent-dialog-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-fleet-switcher-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-palette-preview-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-fleet-palette-renderer.test.tsx ./packages/daemon/src/tui/mirror/runtime/application-fleet-session-actions-renderer.test.tsx ./packages/daemon/src/tui/mirror/ui/agent-team-renderer.test.tsx",
     "test:tui-smoke": "bun scripts/smoke-tui-missions.mjs",
     "test:tui-live": "node scripts/tui-testdrive.mjs smoke",
     "test:tui-testdrive": "node --test scripts/lib/tui-testdrive-clipboard-hook.test.mjs scripts/lib/tui-testdrive-input.test.mjs",

package/packages/contracts/src/cohesion-fixture.ts

@@ -1,3 +1,4 @@
+import { PaneTeamMembershipSchemaZ } from "./pane-team.ts";
 import { z } from "zod";
 import { CommandIdSchemaZ } from "./commands.ts";
 import {
@@ -42,6 +43,7 @@ const SessionSidebarItemSchemaZ = z
 
 const AgentSidebarItemSchemaZ = z
   .object({
+    team: PaneTeamMembershipSchemaZ.optional(),
     id: SemanticProductIdSchemaZ,
     name: LabelSchemaZ,
     harness: z.enum(["codex", "claude-code", "custom"]),

package/packages/contracts/src/fleet-catalog.ts

@@ -1,3 +1,4 @@
+import { PaneTeamMembershipSchemaZ } from "./pane-team.ts";
 import {
   InteractionPaneEndpointSchemaZ,
   NativePaneIdentitySchemaZ,
@@ -121,6 +122,7 @@ export type FleetAgentHarness = z.infer<typeof FleetAgentHarnessSchemaZ>;
 export const FleetCatalogAgentEntryV1SchemaZ = z
   .object({
     agentId: FleetAgentIdSchemaZ,
+    team: PaneTeamMembershipSchemaZ.optional(),
     name: FleetLabelSchemaZ,
     harness: FleetAgentHarnessSchemaZ,
     activity: AgentActivitySchemaZ,

package/packages/contracts/src/index.ts

@@ -106,3 +106,5 @@ export * from "./tmux-server-interaction-events.ts";
 export * from "./automation-operations.ts";
 export * from "./native-interaction-journal.ts";
 export * from "./native-operation-identity.ts";
+
+export * from "./pane-team.ts";

package/packages/contracts/src/pane-team.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+
+/** Presentation membership; never grants control of a pane or a harness team. */
+export const PaneTeamMembershipSchemaZ = z
+  .object({
+    id: z.string().regex(/^team\.[a-zA-Z0-9_-]{16,64}$/u),
+    name: z
+      .string()
+      .min(1)
+      .max(80)
+      .refine(
+        (value) =>
+          value === value.trim() &&
+          Array.from(value).every((character) => {
+            const code = character.codePointAt(0)!;
+            return code > 31 && (code < 127 || code > 159);
+          }),
+      ),
+    source: z.enum(["manual", "claude-code"]),
+  })
+  .strict();
+export type PaneTeamMembership = z.infer<typeof PaneTeamMembershipSchemaZ>;
+
+/** Scope imported identities to their machine and live server, not session/layout. */
+export function paneTeamGroupKey(
+  team: PaneTeamMembership,
+  machineId: string,
+  serverId: string,
+  generation: string,
+): string {
+  return JSON.stringify([machineId, serverId, generation, team.source, team.id]);
+}

package/packages/daemon/dist/command-center/discovery.js

@@ -1,3 +1,5 @@
+import { readManualPaneTeam } from "../terminal/attachments/manual-pane-team.js";
+import { decodeTmuxArgument } from "../terminal/protocol/session-descriptor-discovery.js";
 import { nativePaneIdentity } from "../lib/native-pane-identity.js";
 import { liveSessionIdForNativeIdentity } from "../terminal/protocol/live-session-identity.js";
 import { runtimeTmuxArgs } from "../lib/runtime-namespace.js";
@@ -197,6 +199,10 @@ const FLEET_PANE_FORMAT = [
     "#{@agent_display_name}",
     "#{@agent_hint}",
     "#{pane_birth_id}",
+    "#{qa:pane_title}",
+    "#{qa:@ide_name}",
+    "#{qa:@tmux_ide_name_source}",
+    "#{@tmux_ide_team}",
     FLEET_LINE_SENTINEL,
 ].join(FLEET_FIELD_SEPARATOR);
 function emptyToNull(value) {
@@ -234,8 +240,8 @@ export function readAdoptedFleet(registry = getDefaultWorkspaceRegistry(), runTm
             continue;
         const fields = line.split(FLEET_FIELD_SEPARATOR);
         // session, pane, semantic pane, incarnation pid, active, command, path, state,
-        // statusText, displayName, hint, sentinel
-        if (fields.length !== 13 || fields[12] !== FLEET_LINE_SENTINEL)
+        // statusText, displayName, hint, birth ID, quoted title/name/source, sentinel
+        if (![16, 17].includes(fields.length) || fields.at(-1) !== FLEET_LINE_SENTINEL)
             continue;
         const sessionName = fields[0];
         if (!adoptedSet.has(sessionName))
@@ -252,6 +258,10 @@ export function readAdoptedFleet(registry = getDefaultWorkspaceRegistry(), runTm
             panesBySession.set(sessionName, panes);
         }
         panes.push({
+            team: fields.length === 17 ? readManualPaneTeam(fields[15], incarnation) : undefined,
+            nameSource: emptyToNull(decodeTmuxArgument(fields[14])),
+            title: decodeTmuxArgument(fields[12]),
+            name: emptyToNull(decodeTmuxArgument(fields[13])),
             runtimePaneId,
             semanticPaneId: emptyToNull(fields[2]),
             incarnation,

package/packages/daemon/dist/command-center/resources/agent-graph-overlay.js

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 import { AGENT_GRAPH_LABEL_MAX_LENGTH, projectAgentGraphOverlay, } from "@tmux-ide/contracts";
-import { isAgentPane, paneIdentities, resolveAgentPresentation, } from "./application-shell.js";
+import { isAgentPane, paneIdentities, resolveAgentPresentation, resolvedAgentLabel, } from "./application-shell.js";
 /**
  * The `@ide_role` values (besides `lead`) that a session lead is inferred to
  * relate to. Kept in lockstep with the roles {@link isAgentPane} recognizes.
@@ -104,7 +104,7 @@ export function projectApplicationShellAgentGraphOverlay(input) {
             status: nodeStatus(presentation.detectStatus),
             statusSource: presentation.statusSource,
             attention: presentation.attention,
-            label: nodeLabel(presentation.displayName ?? pane.name ?? pane.title),
+            label: nodeLabel(resolvedAgentLabel(pane, presentation, index)),
         });
         nodeWindowIds.add(windowId);
         if (pane.role === "lead")

package/packages/daemon/dist/command-center/resources/application-shell.js

@@ -1,3 +1,4 @@
+import { resolvePaneDisplayName } from "../../terminal/protocol/pane-display-name.js";
 import { hostname } from "node:os";
 import { basename } from "node:path";
 import { ApplicationShellProjectionInputV1WireSchemaZ, ApplicationShellProjectionInputV2SchemaZ, ApplicationShellProjectionInputV3SchemaZ, CANONICAL_SURFACE_REGISTRY, SemanticProductIdSchemaZ, TerminalAttachmentSemanticPaneIdSchemaZ, TerminalAttachmentSemanticWindowIdSchemaZ, projectApplicationShellV1, resolveAgentStatusPresentation, } from "@tmux-ide/contracts";
@@ -209,6 +210,8 @@ function deprecatedStandalonePaneIdentities(panes) {
     });
 }
 export function harnessForPane(pane) {
+    if (pane.teamMemberName)
+        return "claude-code";
     const detected = pane.agentKind?.toLowerCase();
     if (detected === "codex")
         return "codex";
@@ -221,35 +224,38 @@ export function harnessForPane(pane) {
         return "claude-code";
     return "custom";
 }
-const GENERIC_PANE_LABELS = new Set(["shell", "terminal", "tmux"]);
-function isGenericPaneLabel(value) {
-    const normalized = value?.trim().toLowerCase() ?? "";
-    return normalized.length === 0 || GENERIC_PANE_LABELS.has(normalized);
-}
 /**
  * A promoted configless pane can be stamped as `Terminal` before the native
  * inventory's process-tree pass resolves a wrapped/version-shaped agent
  * executable. Once that stronger identity exists, do not keep publishing the
  * provisional generic label into the sidebar and pane chrome.
  */
-function resolvedAgentLabel(pane, presentation, index) {
-    if (presentation.displayName !== undefined) {
-        return label(presentation.displayName, `Agent ${index + 1}`);
-    }
-    if (!isGenericPaneLabel(pane.name))
-        return label(pane.name, `Agent ${index + 1}`);
+export function resolvedAgentLabel(pane, presentation, index) {
+    const resolved = resolvePaneDisplayName({
+        semanticPaneId: pane.semanticPaneId ?? `agent.${index}`,
+        configuredName: pane.name,
+        configuredNameSource: pane.nameSource,
+        agentDisplayName: presentation.displayName,
+        teamMemberName: pane.teamMemberName,
+        currentCommand: pane.currentCommand,
+        title: pane.title,
+        hostName: hostname(),
+    });
+    if (["manual", "agent", "title"].includes(resolved.source))
+        return label(resolved.name, `Agent ${index + 1}`);
     const harness = harnessForPane(pane);
     if (harness === "codex")
         return "Codex";
     if (harness === "claude-code")
         return "Claude Code";
-    if (!isGenericPaneLabel(pane.title) && !isHostNameTitle(pane.title, hostname())) {
-        return label(pane.title, `Agent ${index + 1}`);
-    }
-    return `Agent ${index + 1}`;
+    return resolved.source === "process"
+        ? label(resolved.name, `Agent ${index + 1}`)
+        : `Agent ${index + 1}`;
 }
 const AGENT_STATE_STAMP = /^(?:working|blocked|done|idle):\d+$/u;
 export function isAgentPane(pane) {
+    if (pane.teamMemberName || pane.team)
+        return true;
     // A well-formed @agent_state stamp IS the agent contract: any pane that
     // self-reports is an agent pane, even when its command is a bare shell and
     // no @ide_type/role metadata exists. Staleness only affects the status, not
@@ -410,6 +416,7 @@ function projectApplicationShellResourceV1Core(session, paneIds, nowSec) {
                 // labels such as `Terminal` with the canonical harness name.
                 name: resolvedAgentLabel(pane, presentation, index),
                 harness: harnessForPane(pane),
+                ...(pane.team ? { team: pane.team } : {}),
                 activity: presentation.activity,
                 paneId,
                 attention: presentation.attention,

package/packages/daemon/dist/command-center/resources/fleet-catalog.js

@@ -25,7 +25,7 @@
 import { createHash } from "node:crypto";
 import { basename } from "node:path";
 import { FLEET_CATALOG_RESOURCE_VERSION, FLEET_LABEL_MAX_LENGTH, FLEET_MAX_AGENTS_PER_SESSION, FLEET_MAX_PANES_PER_SESSION, FLEET_MAX_SESSIONS, FLEET_MAX_TOTAL_AGENTS, FleetCatalogResourceV1SchemaZ, } from "@tmux-ide/contracts";
-import { harnessForPane, isAgentPane, resolveAgentPresentation, } from "./application-shell.js";
+import { harnessForPane, isAgentPane, resolveAgentPresentation, resolvedAgentLabel, } from "./application-shell.js";
 function digest(value) {
     return createHash("sha256").update(value).digest("hex").slice(0, 20);
 }
@@ -94,16 +94,19 @@ function toPresentationPane(pane, index) {
     return {
         semanticPaneId: null,
         index,
-        title: "",
+        title: pane.title ?? "",
         currentCommand: pane.currentCommand,
         active: pane.active,
         role: null,
-        name: null,
+        name: pane.name ?? null,
+        nameSource: pane.nameSource,
         type: null,
         agentKind: pane.agentHintRaw,
         agentStateRaw: pane.agentStateRaw,
         agentStatusTextRaw: pane.agentStatusTextRaw,
         agentDisplayNameRaw: pane.agentDisplayNameRaw,
+        teamMemberName: pane.teamMemberName,
+        team: pane.team,
         // Authority-only: the fleet never scrapes an unopened session. `null` (not
         // `undefined`) keeps `resolveAgentPresentation` on the ground-truth path
         // while its scrape verdict resolves to `unknown` without any capture.
@@ -122,8 +125,9 @@ function projectSession(session, nowSec, remainingAgentBudget) {
         const presentation = resolveAgentPresentation(presentationPane, nowSec);
         agents.push({
             agentId: fleetAgentIdForPane(session.name, pane),
-            name: fleetLabel(presentation.displayName ?? pane.currentCommand, `Agent ${index + 1}`),
+            name: fleetLabel(resolvedAgentLabel(presentationPane, presentation, index), `Agent ${index + 1}`),
             harness: harnessForPane(presentationPane),
+            ...(pane.team ? { team: pane.team } : {}),
             activity: presentation.activity,
             attention: presentation.attention,
             statusSource: presentation.statusSource,

package/packages/daemon/dist/command-center/resources/fleet-resource-route.js

@@ -19,7 +19,7 @@ export function mountFleetResourceRoute(app, options) {
         unavailableMessage: "Fleet catalog capability is unavailable",
         mismatchMessage: "Fleet catalog access requires owner authority",
     });
-    app.get("/api/resources/fleet-catalog", (c) => {
+    app.get("/api/resources/fleet-catalog", async (c) => {
         const gate = authorize(c);
         if (gate)
             return gate;
@@ -28,7 +28,7 @@ export function mountFleetResourceRoute(app, options) {
         // with a successful empty snapshot. Never expose raw socket/process errors.
         let sessions;
         try {
-            sessions = options.readFleet ? options.readFleet() : readAdoptedFleet(options.registry);
+            sessions = options.readFleet ? await options.readFleet() : readAdoptedFleet(options.registry);
         }
         catch {
             sessions = null;

package/packages/daemon/dist/lib/daemon-embed.js

@@ -6,6 +6,8 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
+import { join } from "node:path";
+import { createClaudeTeamMembershipReader } from "../terminal/attachments/claude-team-names.js";
 import { PaneSourceDiscovery } from "./pane-source-discovery.js";
 import { createBackgroundNativeCapture } from "./background-native-capture.js";
 import { createOwnedViewerAdapterFactory } from "./owned-viewer-factory.js";
@@ -707,6 +709,7 @@ async function startEmbeddedDaemonGeneration(opts) {
         // observe one daemon-generation authority rather than whichever server a
         // caller's ambient TMUX/PATH happens to select.
         const tmuxAuthority = resolveWorkspacePaneTmuxAuthority();
+        const readTeamMemberships = createClaudeTeamMembershipReader(join(resolveRuntimeNamespace().claudeDir, "teams"));
         const catalogTmuxRunner = createPinnedWorkspaceTmuxRunner(tmuxAuthority);
         const initialTmuxProof = captureTmuxServerProof(catalogTmuxRunner);
         const initialNativeIdentityParts = initialTmuxProof
@@ -1145,6 +1148,7 @@ async function startEmbeddedDaemonGeneration(opts) {
                 },
                 agentStatusProbeFactory: ({ run }) => createTmuxAgentStatusProbe({
                     run,
+                    readTeamMemberships,
                     captureNative: (pane, signal) => backgroundCapture?.({
                         paneId: pane.runtimePaneId,
                         nativeIdentity: pane.nativeIdentity ?? null,
@@ -1383,9 +1387,26 @@ async function startEmbeddedDaemonGeneration(opts) {
                 peekTerminalAttachmentRuntime,
                 paneStreamRuntime,
                 catalogLiveSessions: () => discoverLiveSessionSummaries(catalogTmuxRunner),
-                catalogFleet: () => readAdoptedFleet(workspaceRegistry, nativeGenerationTmuxRunner, (sessionName, pane) => pane.semanticPaneId
-                    ? (interactionEvidence?.captureInventoryEndpoint(sessionName, pane.runtimePaneId, pane.semanticPaneId) ?? null)
-                    : null, () => observationSelector?.nativeServerEpoch ?? null),
+                catalogFleet: async () => {
+                    const fleet = readAdoptedFleet(workspaceRegistry, nativeGenerationTmuxRunner, (sessionName, pane) => pane.semanticPaneId
+                        ? (interactionEvidence?.captureInventoryEndpoint(sessionName, pane.runtimePaneId, pane.semanticPaneId) ?? null)
+                        : null, () => observationSelector?.nativeServerEpoch ?? null);
+                    if (!fleet)
+                        return null;
+                    const names = await readTeamMemberships(fleet.flatMap((session) => session.panes.map((pane) => ({
+                        runtimePaneId: pane.runtimePaneId,
+                        pid: pane.incarnation,
+                    }))));
+                    return fleet.map((session) => ({
+                        ...session,
+                        panes: session.panes.map((pane) => {
+                            const name = names.get(pane.runtimePaneId);
+                            return name
+                                ? { ...pane, teamMemberName: name.name, team: pane.team ?? name.team }
+                                : pane;
+                        }),
+                    }));
+                },
                 fleetPreviewCapture: createFleetPreviewCapture(fleetFactsTmuxRunner, {
                     serverEpoch: () => observationSelector?.nativeServerEpoch ?? null,
                     capture: (request, signal) => backgroundCapture?.(request, signal) ?? Promise.resolve(null),

package/packages/daemon/dist/pane-team.js

@@ -0,0 +1,28 @@
+import { execFileSync } from "node:child_process";
+import { isAbsolute } from "node:path";
+import { runtimeTmuxArgs } from "./lib/runtime-namespace.js";
+import { manualPaneTeamStamp, PANE_TEAM_OPTION } from "./terminal/attachments/manual-pane-team.js";
+/** Explicit membership only. Never launches, stops, or messages an agent. */
+export function assignPaneTeam(options, run = (args) => execFileSync("tmux", args, { encoding: "utf8", timeout: 5000 })) {
+    if (!/^%\d+$/u.test(options.paneId))
+        throw new Error("Use an exact pane ID such as %3");
+    if (options.socketPath && options.socketName)
+        throw new Error("Choose one tmux socket selector");
+    if (options.socketPath && !isAbsolute(options.socketPath))
+        throw new Error("Socket path must be absolute");
+    if (options.socketName && !/^[a-zA-Z0-9_.-]+$/u.test(options.socketName))
+        throw new Error("Invalid socket name");
+    const args = (command) => options.socketPath
+        ? ["-S", options.socketPath, ...command]
+        : options.socketName
+            ? ["-L", options.socketName, ...command]
+            : runtimeTmuxArgs(command);
+    const pid = Number(run(args(["display-message", "-p", "-t", options.paneId, "#{pane_pid}"])).trim());
+    if (!Number.isSafeInteger(pid) || pid < 1)
+        throw new Error("Pane is no longer available");
+    const stamp = options.name === null ? null : manualPaneTeamStamp(options.name, pid);
+    run(args(stamp === null
+        ? ["set-option", "-p", "-u", "-t", options.paneId, PANE_TEAM_OPTION]
+        : ["set-option", "-p", "-t", options.paneId, PANE_TEAM_OPTION, stamp]));
+    return { paneId: options.paneId, team: options.name, source: stamp === null ? null : "manual" };
+}

package/packages/daemon/dist/terminal/attachments/agent-status-probe.js

@@ -1,3 +1,4 @@
+import { readManualPaneTeam } from "./manual-pane-team.js";
 /**
  * Agent-status probe for the application-shell inventory — the IO half of the
  * desktop projection's ground-truth agent detection.
@@ -40,6 +41,7 @@ const AGENT_OPTIONS_FORMAT = [
     "#{@agent_display_name}",
     "#{@agent_hint}",
     "#{pane_pid}",
+    "#{@tmux_ide_team}",
     AGENT_LINE_SENTINEL,
 ].join(AGENT_FIELD_SEPARATOR);
 /** Trailing non-empty lines captured for the scrape fallback. */
@@ -69,7 +71,7 @@ function parseAgentOptions(stdout) {
             continue;
         const fields = line.split(AGENT_FIELD_SEPARATOR);
         // paneId, state, statusText, displayName, hint, pid, sentinel
-        if (fields.length !== 7 || fields[6] !== AGENT_LINE_SENTINEL)
+        if (![7, 8].includes(fields.length) || fields.at(-1) !== AGENT_LINE_SENTINEL)
             continue;
         const runtimePaneId = fields[0];
         if (!RUNTIME_PANE_ID.test(runtimePaneId))
@@ -77,6 +79,7 @@ function parseAgentOptions(stdout) {
         const pidText = fields[5];
         const pid = /^[0-9]+$/u.test(pidText) ? Number(pidText) : null;
         result.set(runtimePaneId, {
+            team: fields.length === 8 ? readManualPaneTeam(fields[6], pid) : undefined,
             stateRaw: emptyToNull(fields[1]),
             statusTextRaw: emptyToNull(fields[2]),
             displayNameRaw: emptyToNull(fields[3]),
@@ -166,6 +169,7 @@ export function createTmuxAgentStatusProbe(deps) {
         const candidates = [];
         const emit = (pane, raw, scrape, agentKind) => {
             facts.set(pane.runtimePaneId, {
+                ...(raw?.team ? { team: raw.team } : {}),
                 agentKind,
                 agentStateRaw: raw?.stateRaw ?? null,
                 agentStatusTextRaw: raw?.statusTextRaw ?? null,
@@ -280,6 +284,34 @@ export function createTmuxAgentStatusProbe(deps) {
             });
             emit(pane, raw, verdict, manifest.id);
         }
+        if (deps.readTeamMemberships) {
+            const memberships = await deps.readTeamMemberships(input.panes.flatMap((pane) => {
+                const pid = options.get(pane.runtimePaneId)?.pid;
+                return pid ? [{ runtimePaneId: pane.runtimePaneId, pid }] : [];
+            }));
+            throwIfAborted(signal);
+            for (const [paneId, member] of memberships) {
+                const fact = facts.get(paneId);
+                if (fact)
+                    facts.set(paneId, {
+                        ...fact,
+                        teamMemberName: member.name,
+                        team: fact.team ?? member.team,
+                    });
+            }
+        }
+        if (deps.readTeamNames) {
+            const names = await deps.readTeamNames(input.panes.flatMap((pane) => {
+                const pid = options.get(pane.runtimePaneId)?.pid;
+                return pid ? [{ runtimePaneId: pane.runtimePaneId, pid }] : [];
+            }));
+            throwIfAborted(signal);
+            for (const [paneId, name] of names) {
+                const fact = facts.get(paneId);
+                if (fact)
+                    facts.set(paneId, { ...fact, teamMemberName: name });
+            }
+        }
         // Bound the cache: pane ids are server-unique and never re-probed after a
         // pane dies, so evict the oldest verdicts past the ceiling.
         if (stagedVerdicts.size > SCRAPE_CACHE_MAX_ENTRIES) {

package/packages/daemon/dist/terminal/attachments/claude-team-names.js

@@ -0,0 +1,146 @@
+import { createHash } from "node:crypto";
+/** Read-only compatibility adapter for Claude Code's runtime team metadata.
+ * Names are presentation evidence, never agent identity or permission authority.
+ */
+import { open, readdir } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { readProcessTableAsync, subtreeEntries, } from "../../tui/detect/process-tree.js";
+const token = (value) => typeof value === "string" &&
+    /^[a-zA-Z0-9_.@-]{1,160}$/u.test(value) &&
+    value !== "." &&
+    value !== "..";
+export function parseClaudeTeamMembers(value, directory) {
+    if (!value || typeof value !== "object")
+        return [];
+    const config = value;
+    if (!token(directory) ||
+        config.name !== directory ||
+        !Array.isArray(config.members) ||
+        config.members.length > 128)
+        return [];
+    return config.members.flatMap((value) => {
+        if (!value || typeof value !== "object")
+            return [];
+        const m = value;
+        if (!token(m.name) ||
+            m.name.length > 80 ||
+            !token(m.agentId) ||
+            m.backendType !== "tmux" ||
+            typeof m.tmuxPaneId !== "string" ||
+            !/^%\d+$/u.test(m.tmuxPaneId))
+            return [];
+        return [{ team: directory, name: m.name, agentId: m.agentId, paneId: m.tmuxPaneId }];
+    });
+}
+/** Conservative argv recognition: flattened ps text is not a shell parser.
+ * Ambiguous/quoted arguments fall back to the native title rather than guessing.
+ */
+function matchesProcess(command, member) {
+    const args = command.trim().split(/\s+/u);
+    const executable = args.shift() ?? "";
+    if (basename(executable) !== "claude" && !/\/claude\/versions\/\d[\w.-]*$/u.test(executable))
+        return false;
+    for (const [flag, expected] of [
+        ["--team-name", member.team],
+        ["--agent-id", member.agentId],
+        ["--agent-name", member.name],
+    ]) {
+        const positions = args.flatMap((arg, index) => arg === flag || arg.startsWith(`${flag}=`) ? [index] : []);
+        if (positions.length !== 1)
+            return false;
+        const i = positions[0];
+        if ((args[i] === flag ? args[i + 1] : args[i].slice(flag.length + 1)) !== expected)
+            return false;
+    }
+    return true;
+}
+export function resolveClaudeTeamMember(pane, members, processes) {
+    // A native pane id alone cannot bind a team: different servers reuse %N.
+    // Its live shell PID scopes the match to this host and this pane's subtree.
+    const subtree = subtreeEntries(processes, pane.pid);
+    const matches = members.filter((m) => m.paneId === pane.runtimePaneId && subtree.some((p) => matchesProcess(p.command, m)));
+    return matches.length === 1 ? matches[0] : null;
+}
+export function resolveClaudeTeamName(pane, members, processes) {
+    return resolveClaudeTeamMember(pane, members, processes)?.name ?? null;
+}
+async function readMembers(directory) {
+    try {
+        const entries = await readdir(directory, { withFileTypes: true });
+        if (entries.length > 128)
+            return [];
+        const members = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory() || !token(entry.name))
+                continue;
+            try {
+                const file = await open(join(directory, entry.name, "config.json"), "r");
+                try {
+                    if (!(await file.stat()).isFile())
+                        continue;
+                    const bytes = Buffer.alloc(256 * 1024 + 1);
+                    const { bytesRead } = await file.read(bytes, 0, bytes.length, 0);
+                    if (bytesRead > 256 * 1024)
+                        continue;
+                    members.push(...parseClaudeTeamMembers(JSON.parse(bytes.subarray(0, bytesRead).toString("utf8")), entry.name));
+                }
+                finally {
+                    await file.close();
+                }
+            }
+            catch {
+                /* Removal, atomic replacement and unknown schemas clear old facts. */
+            }
+        }
+        return members;
+    }
+    catch {
+        return [];
+    }
+}
+export function createClaudeTeamMembershipReader(directory, deps = {}) {
+    const now = deps.now ?? Date.now;
+    let snapshot = null;
+    let pending = null;
+    return async (panes) => {
+        if (!panes.length)
+            return new Map();
+        if (!snapshot || now() - snapshot.at >= 2000) {
+            pending ??= (async () => {
+                try {
+                    const members = await (deps.readMembers?.() ?? readMembers(directory));
+                    const processes = members.length
+                        ? await (deps.readProcesses?.() ?? readProcessTableAsync())
+                        : [];
+                    snapshot = { at: now(), members, processes };
+                }
+                catch {
+                    snapshot = { at: now(), members: [], processes: [] };
+                }
+            })().finally(() => {
+                pending = null;
+            });
+            await pending;
+        }
+        const current = snapshot;
+        const names = new Map();
+        for (const pane of panes) {
+            const member = resolveClaudeTeamMember(pane, current.members, current.processes);
+            if (member)
+                names.set(pane.runtimePaneId, {
+                    name: member.name,
+                    team: {
+                        id: `team.${createHash("sha256").update(member.team).digest("hex").slice(0, 32)}`,
+                        name: member.team.slice(0, 80),
+                        source: "claude-code",
+                    },
+                });
+        }
+        return names;
+    };
+}
+/** Compatibility API for callers interested only in the shared display name. */
+export function createClaudeTeamNameReader(directory, deps = {}) {
+    const read = createClaudeTeamMembershipReader(directory, deps);
+    return async (panes) => new Map([...(await read(panes))].map(([id, value]) => [id, value.name]));
+}

package/packages/daemon/dist/terminal/attachments/manual-pane-team.js

@@ -0,0 +1,30 @@
+import { createHash } from "node:crypto";
+import { PaneTeamMembershipSchemaZ } from "@tmux-ide/contracts";
+export const PANE_TEAM_OPTION = "@tmux_ide_team";
+/** Pane-local metadata survives layout moves, but never a replacement process. */
+export function manualPaneTeamStamp(name, pid) {
+    if (!Number.isSafeInteger(pid) || pid < 1)
+        throw new Error("Invalid pane process");
+    const team = PaneTeamMembershipSchemaZ.parse({
+        id: `team.${createHash("sha256").update(name).digest("hex").slice(0, 32)}`,
+        name,
+        source: "manual",
+    });
+    return `v1.${Buffer.from(JSON.stringify({ version: 1, pid, team })).toString("base64url")}`;
+}
+export function readManualPaneTeam(raw, pid) {
+    if (!raw || raw.length > 2048 || !pid)
+        return undefined;
+    try {
+        if (!/^v1\.[A-Za-z0-9_-]+$/u.test(raw))
+            return undefined;
+        const value = JSON.parse(Buffer.from(raw.slice(3), "base64url").toString("utf8"));
+        if (value.version !== 1 || value.pid !== pid)
+            return undefined;
+        const parsed = PaneTeamMembershipSchemaZ.safeParse(value.team);
+        return parsed.success && parsed.data.source === "manual" ? parsed.data : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/packages/daemon/dist/terminal/attachments/native-runtime.js

@@ -364,6 +364,7 @@ function projectTrustedMirrorInventory(trusted, workspaceName, expectedSessionNa
             active: pane.active,
             role: nullable(pane.role),
             name: nullable(pane.name),
+            ...(pane.nameSource ? { nameSource: nullable(pane.nameSource) } : {}),
             type: nullable(pane.type),
             missionStamp: nullable(pane.missionStamp),
             dir: boundedWireValue(pane.dir, 4_096),