@design.estate/dees-catalog 11.2.2 → 12.0.0

package/dist_ts_web/elements/00group-harness/index.d.ts

@@ -8,6 +8,7 @@ export * from './dees-harness-overflow-text.js';
 export * from './dees-harness-chat/index.js';
 export * from './dees-harness-composer/index.js';
 export * from './dees-harness-content-blocks/index.js';
+export * from './dees-harness-conversation-picker/index.js';
 export * from './dees-harness-message/index.js';
 export * from './dees-harness-permission-card/index.js';
 export * from './dees-harness-question-card/index.js';

package/dist_ts_web/elements/00group-harness/index.js

@@ -11,6 +11,7 @@ export * from './dees-harness-overflow-text.js';
 export * from './dees-harness-chat/index.js';
 export * from './dees-harness-composer/index.js';
 export * from './dees-harness-content-blocks/index.js';
+export * from './dees-harness-conversation-picker/index.js';
 export * from './dees-harness-message/index.js';
 export * from './dees-harness-permission-card/index.js';
 export * from './dees-harness-question-card/index.js';
@@ -23,4 +24,4 @@ export * from './dees-harness-status/index.js';
 export * from './dees-harness-todos/index.js';
 export * from './dees-harness-tool-card/index.js';
 export * from './dees-harness-usage/index.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90c193ZWIvZWxlbWVudHMvMDBncm91cC1oYXJuZXNzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLG9DQUFvQztBQUNwQywyRUFBMkU7QUFDM0UsNkVBQTZFO0FBQzdFLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxtQkFBbUIsQ0FBQztBQUNsQyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLE9BQU8sRUFBRSxlQUFlLEVBQUUsY0FBYyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDeEUsT0FBTyxFQUFFLGlCQUFpQixFQUFFLGlCQUFpQixFQUFFLGlCQUFpQixFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDOUYsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLGlDQUFpQyxDQUFDO0FBRWhELGNBQWMsOEJBQThCLENBQUM7QUFDN0MsY0FBYyxrQ0FBa0MsQ0FBQztBQUNqRCxjQUFjLHdDQUF3QyxDQUFDO0FBQ3ZELGNBQWMsaUNBQWlDLENBQUM7QUFDaEQsY0FBYyx5Q0FBeUMsQ0FBQztBQUN4RCxjQUFjLHVDQUF1QyxDQUFDO0FBQ3RELGNBQWMsc0NBQXNDLENBQUM7QUFDckQsY0FBYyxtQ0FBbUMsQ0FBQztBQUNsRCxjQUFjLHNDQUFzQyxDQUFDO0FBQ3JELGNBQWMseUNBQXlDLENBQUM7QUFDeEQsY0FBYywrQkFBK0IsQ0FBQztBQUM5QyxjQUFjLGdDQUFnQyxDQUFDO0FBQy9DLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyxtQ0FBbUMsQ0FBQztBQUNsRCxjQUFjLCtCQUErQixDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90c193ZWIvZWxlbWVudHMvMDBncm91cC1oYXJuZXNzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLG9DQUFvQztBQUNwQywyRUFBMkU7QUFDM0UsNkVBQTZFO0FBQzdFLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxtQkFBbUIsQ0FBQztBQUNsQyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLE9BQU8sRUFBRSxlQUFlLEVBQUUsY0FBYyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDeEUsT0FBTyxFQUFFLGlCQUFpQixFQUFFLGlCQUFpQixFQUFFLGlCQUFpQixFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDOUYsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLGlDQUFpQyxDQUFDO0FBRWhELGNBQWMsOEJBQThCLENBQUM7QUFDN0MsY0FBYyxrQ0FBa0MsQ0FBQztBQUNqRCxjQUFjLHdDQUF3QyxDQUFDO0FBQ3ZELGNBQWMsNkNBQTZDLENBQUM7QUFDNUQsY0FBYyxpQ0FBaUMsQ0FBQztBQUNoRCxjQUFjLHlDQUF5QyxDQUFDO0FBQ3hELGNBQWMsdUNBQXVDLENBQUM7QUFDdEQsY0FBYyxzQ0FBc0MsQ0FBQztBQUNyRCxjQUFjLG1DQUFtQyxDQUFDO0FBQ2xELGNBQWMsc0NBQXNDLENBQUM7QUFDckQsY0FBYyx5Q0FBeUMsQ0FBQztBQUN4RCxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsZ0NBQWdDLENBQUM7QUFDL0MsY0FBYywrQkFBK0IsQ0FBQztBQUM5QyxjQUFjLG1DQUFtQyxDQUFDO0FBQ2xELGNBQWMsK0JBQStCLENBQUMifQ==

package/dist_ts_web/elements/00group-harness/interfaces.d.ts

@@ -364,42 +364,57 @@ export interface IHarnessResourceMeta<TState extends string = string> {
     draggable?: boolean;
 }
 /**
- * A controlled zero-or-one association for one resource. The target is any
- * other list item — a session or another resource such as a terminal.
+ * The controlled set of associations for one resource. A resource can be attached to several
+ * items at once, and a target is any other list item — a session or another resource such as a
+ * terminal. An empty array is an unattached resource.
  */
 export interface IHarnessResourceAssociation {
     resourceId: string;
-    target: IHarnessSessionListItemRef;
+    targets: IHarnessSessionListItemRef[];
 }
 export interface IHarnessResourceEventDetail<TState extends string = string> {
     resource: IHarnessResourceMeta<TState>;
-    /** The controlled association target, or null when the resource is unattached. */
-    target: IHarnessSessionListItemRef | null;
+    /** The controlled association targets; empty when the resource is unattached. */
+    targets: IHarnessSessionListItemRef[];
 }
 /**
- * Association is an explicit host action, never a drop: dragging a resource
- * only moves it inside the ordered list.
+ * Attaching is an explicit choice, never an accident of reordering: a drag only attaches when it
+ * is released on the centre of a row, and the edges of that same row stay positional. Keyboard
+ * moves are always positional; keyboard attaching goes through the host's menu.
  */
-export type THarnessResourceAssociationInteractionSource = 'action' | 'keyboard';
-export type THarnessResourceAssociationRequestDetail<TState extends string = string> = {
-    intent: 'attach';
+export type THarnessResourceAssociationInteractionSource = 'action' | 'keyboard' | 'pointer';
+/**
+ * A validated association request. `attach` adds the first target, `attach-additional` adds
+ * another one beside existing targets, `move` replaces one specific target, and `detach` removes
+ * one. `fromTarget` always names the attachment being replaced or removed, never the whole set.
+ */
+export type THarnessResourceAssociateDetail<TState extends string = string> = {
+    mode: 'attach';
     resource: IHarnessResourceMeta<TState>;
     fromTarget: null;
     toTarget: IHarnessSessionListItemRef;
     source: THarnessResourceAssociationInteractionSource;
 } | {
-    intent: 'detach';
+    mode: 'attach-additional';
     resource: IHarnessResourceMeta<TState>;
-    fromTarget: IHarnessSessionListItemRef;
-    toTarget: null;
+    fromTarget: null;
+    toTarget: IHarnessSessionListItemRef;
     source: THarnessResourceAssociationInteractionSource;
 } | {
-    intent: 'reassign';
+    mode: 'move';
     resource: IHarnessResourceMeta<TState>;
     fromTarget: IHarnessSessionListItemRef;
     toTarget: IHarnessSessionListItemRef;
     source: THarnessResourceAssociationInteractionSource;
+} | {
+    mode: 'detach';
+    resource: IHarnessResourceMeta<TState>;
+    fromTarget: IHarnessSessionListItemRef;
+    toTarget: null;
+    source: THarnessResourceAssociationInteractionSource;
 };
+/** Explicit mode for `requestAssociation`; omitted lets the list infer it from the current set. */
+export type THarnessResourceAssociateMode = THarnessResourceAssociateDetail['mode'];
 export type THarnessResourceContextSource = 'pointer' | 'action' | 'keyboard';
 /** Detail of `harness-resource-context`; the host owns the actual menu. */
 export interface IHarnessResourceContextDetail<TState extends string = string> extends IHarnessResourceEventDetail<TState> {
@@ -407,8 +422,12 @@ export interface IHarnessResourceContextDetail<TState extends string = string> e
     clientY: number;
     source: THarnessResourceContextSource;
     originalEvent: MouseEvent | KeyboardEvent;
-    /** Routes a host menu choice through the component's validated controlled request event. */
-    requestAssociation: (toTarget: IHarnessSessionListItemRef | null) => boolean;
+    /**
+     * Routes a host menu choice through the component's validated controlled request event. With no
+     * mode, an unattached resource attaches and a singly attached one moves; a resource with several
+     * attachments is refused, because only the host knows which attachment was meant.
+     */
+    requestAssociation: (toTarget: IHarnessSessionListItemRef | null, mode?: THarnessResourceAssociateMode, fromTarget?: IHarnessSessionListItemRef | null) => boolean;
     /** Closes the external-menu disclosure state and restores focus to its invoking control. */
     close: () => void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design.estate/dees-catalog",
-  "version": "11.2.2",
+  "version": "12.0.0",
   "private": false,
   "description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.",
   "main": "dist_ts_web/index.js",

package/readme.md

@@ -165,6 +165,7 @@ task guide and examples deliberately; the generated table does not replace them.
 | `dees-harness-chat` | harness | [DeesHarnessChat](#deesharnesschat) | [Source](ts_web/elements/00group-harness/dees-harness-chat/dees-harness-chat.ts) |
 | `dees-harness-composer` | harness | [DeesHarnessComposer](#deesharnesscomposer) | [Source](ts_web/elements/00group-harness/dees-harness-composer/dees-harness-composer.ts) |
 | `dees-harness-content-blocks` | harness | [DeesHarnessContentBlocks](#deesharnesscontentblocks) | [Source](ts_web/elements/00group-harness/dees-harness-content-blocks/dees-harness-content-blocks.ts) |
+| `dees-harness-conversation-picker` | harness | [DeesHarnessConversationPicker](#deesharnessconversationpicker) | [Source](ts_web/elements/00group-harness/dees-harness-conversation-picker/dees-harness-conversation-picker.ts) |
 | `dees-harness-message` | harness | [DeesHarnessMessage](#deesharnessmessage) | [Source](ts_web/elements/00group-harness/dees-harness-message/dees-harness-message.ts) |
 | `dees-harness-message-list` | harness | [DeesHarnessMessageList](#deesharnessmessagelist) | [Source](ts_web/elements/00group-harness/dees-harness-message-list/dees-harness-message-list.ts) |
 | `dees-harness-overflow-text` | harness | [DeesHarnessOverflowText](#deesharnessoverflowtext) | [Source](ts_web/elements/00group-harness/dees-harness-overflow-text.ts) |
@@ -2767,6 +2768,25 @@ Scratchpad edits emit `harness-scratchpad-save` with `{ text, expectedRevision }
 
 Direct sidebar hosts can set `intelligenceAvailabilityStatus`, `intelligenceUnavailableReason`, and `intelligenceHeading`; `intelligenceEnabled` still controls whether the section exists. The properties default to `available`, an empty reason, and `Session Intelligence`. A blank heading falls back to `Session Intelligence`, and unavailable state without a reason renders `<heading> is unavailable.` Only `available` permits `harness-session-intelligence-ask`; checking and unavailable states retain history and expose accessible status text. The availability union is exported as `THarnessIntelligenceAvailabilityStatus`.
 
+#### `DeesHarnessConversationPicker`
+
+Keyboard-first picker for one conversation, or one attachable resource, used wherever a menu would otherwise list every possible target. It is presentation only: it never mutates a session, a resource, or an association — it resolves one choice and leaves the change to the host.
+
+Set `.sessions`, `.groups` and `.resources` to the same models the list renders. `.excludeTargets` removes targets that would be a no-op (a resource's existing attachments), and `.eligibleTargets` restricts the offer to a host-declared allow-list; absent means unrestricted. Typing filters on title, project label and group name — the same fields the session list searches. Up/Down move the active row, Enter picks it, Escape cancels. `harness-picker-choose` carries `{ target: IHarnessSessionListItemRef }`; `harness-picker-cancel` carries nothing.
+
+`DeesHarnessConversationPicker.pick(options)` is the one-call form: it opens the picker inside `DeesModal`, resolves with the chosen ref or `null` on cancel, closes the modal, and returns focus to whatever had it before. Reuse it for disambiguation as well — pass a resource's current attachments as `eligibleTargets` to ask which attachment a Move or Detach applies to.
+
+```typescript
+const target = await DeesHarnessConversationPicker.pick({
+  sessions: list.sessions,
+  groups: list.groups,
+  excludeTargets: currentTargets,
+  eligibleTargets: list.eligibleTargetsByResourceId[resource.id],
+  heading: `Attach ${resource.title} to…`,
+});
+if (target) detail.requestAssociation(target, currentTargets.length ? 'attach-additional' : 'attach');
+```
+
 #### `DeesHarnessSessionList`
 
 Searchable, card-based conversation column for sidebars or a `DeesModal` (`harness-session-select` on click, `harness-session-open` on double-click/Enter). Cards stay collapsed until their independent accessible expansion control is used. Selection and working-state changes do not affect expansion.
@@ -2785,22 +2805,29 @@ The compact **New group** button sits beside search whenever `enableGrouping` is
 
 The Sessions demo pairs the list with a selected-session workspace. Its controls step through starting, working, feedback, approval, completion and failure without timers or backend operations. Question and permission responses update the selected session; declining approval pauses it. The narrow layout switches between the preserved list and detail panes with an **All sessions** control that restores row focus.
 
-Generic host resources use the exported `IHarnessResourceMeta` and `IHarnessResourceAssociation` contracts. Set `.resources`, `.resourceAssociations`, `.selectedResourceId`, and `.eligibleTargetsByResourceId`. Resource rows render as top-level rows in the ordered list, never as children of a session. Optional `projectLabel` renders on the resource metadata line after the kind and is searched like the title and preview. Resource metadata is presentation-only: the list never mounts a terminal, browser, file viewer, or other runtime.
+Generic host resources use the exported `IHarnessResourceMeta` and `IHarnessResourceAssociation` contracts. Set `.resources`, `.resourceAssociations`, `.selectedResourceId`, and `.eligibleTargetsByResourceId`. Resource rows render as top-level rows in the ordered list, never as children of a session. Optional `projectLabel` renders on the resource metadata line after the kind and is searched like the title and preview. A resource can be attached to several items at once: `IHarnessResourceAssociation.targets` is a set of refs, de-duplicated on projection, and the row shows one marker per attachment — two by name, the rest as a `+N` count with every name in the row's title. `IHarnessResourceEventDetail.targets` carries the same set on select, open and context events. Resource metadata is presentation-only: the list never mounts a terminal, browser, file viewer, or other runtime.
 
-**Attaching is a separate explicit action, not a drop.** An association is an access grant: it shows as a decorative marker on the resource row (a link icon plus the target's title, resolved from `sessions` or `resources` regardless of search or collapse) and never moves the row. Dropping is purely positional and never attaches. The association stays single-valued — a resource has at most one target — and the target is any other item, so a resource may be attached to a session **or** to another resource such as a terminal:
+**Attaching is a deliberate gesture, never an accident of reordering.** An association is an access grant: it shows as a decorative marker on the resource row (a link icon plus each target's title, resolved from `sessions` or `resources` regardless of search or collapse) and never moves the row. A resource dropped on the **centre half of a row** attaches to it; the outer quarters of that same row, and every gap between rows, stay purely positional. The row being targeted shows a ring, a tint and a link badge, and no insertion gap opens while it does. A drag attaches an unattached resource and moves a singly attached one. A resource attached to several conversations is only repositioned by drag — it offers no attach affordance on any row, because a drag cannot say which of its attachments was meant; use **Move to…** for that. Keyboard moves stay positional; attaching by keyboard goes through the host's menu. The target is any other item, so a resource may be attached to a session **or** to another resource such as a terminal, and to several at once:
 
 ```typescript
 list.resourceAssociations = [
-  { resourceId: 'file:notes', target: { kind: 'resource', id: 'terminal:build' } },
+  { resourceId: 'file:notes', targets: [{ kind: 'resource', id: 'terminal:build' }] },
+  {
+    resourceId: 'terminal:build',
+    targets: [{ kind: 'session', id: 's-4' }, { kind: 'session', id: 's-0' }],
+  },
 ];
 ```
 
-Association records are projected only when the resource exists, the target exists, the target is not the resource itself, and no earlier record claimed that resource. `eligibleTargetsByResourceId` restricts attach/reassign targets for host menus: a missing entry leaves the resource unrestricted, an empty array means no eligible target. Which resource kinds may host an attachment is the host's rule, not the component's.
+Targets are projected only when the resource exists, the target exists, the target is not the resource itself, and no earlier target in the same record already claimed it. `eligibleTargetsByResourceId` restricts targets for both the host menu and the drop affordance: a missing entry leaves the resource unrestricted, an empty array means no eligible target, and an ineligible row offers no attach affordance and commits nothing. Which resource kinds may host an attachment is the host's rule, not the component's.
+
+`requestResourceAssociation(resourceId, toTarget, source?, mode?, fromTarget?)` and the context detail's `requestAssociation(toTarget, mode?, fromTarget?)` emit `harness-resource-associate` with `THarnessResourceAssociateDetail`: `mode` is `attach`, `attach-additional`, `move` or `detach`, and `fromTarget` names the single attachment being replaced or removed. With no mode, an unattached resource attaches and a singly attached one moves; a resource with several attachments is refused, because only the host knows which one the user meant — pass a mode and a `fromTarget`, or ask with `DeesHarnessConversationPicker`.
 
 ```typescript
-import type {
-  IHarnessResourceContextDetail,
-  THarnessResourceAssociationRequestDetail,
+import {
+  DeesHarnessConversationPicker,
+  type IHarnessResourceContextDetail,
+  type THarnessResourceAssociateDetail,
 } from '@design.estate/dees-catalog';
 
 const list = document.querySelector('dees-harness-session-list')!;
@@ -2810,37 +2837,42 @@ list.resources = [
   { id: 'file:notes', kind: 'file', title: 'Release notes', preview: '6.7.0 draft' },
 ];
 list.resourceAssociations = [
-  { resourceId: 'shell:build', target: { kind: 'session', id: 'session-1' } },
+  { resourceId: 'shell:build', targets: [{ kind: 'session', id: 'session-1' }] },
 ];
 list.eligibleTargetsByResourceId = {
   'shell:build': [{ kind: 'session', id: 'session-1' }, { kind: 'session', id: 'session-2' }],
   'file:notes': [{ kind: 'session', id: 'session-2' }, { kind: 'resource', id: 'shell:build' }],
 };
 
-list.addEventListener('harness-resource-association-request', async (event) => {
-  const resourceEvent = event as CustomEvent<THarnessResourceAssociationRequestDetail>;
-  const { resource, toTarget } = resourceEvent.detail;
-  await persistAssociation(resource.id, toTarget);
+list.addEventListener('harness-resource-associate', async (event) => {
+  const resourceEvent = event as CustomEvent<THarnessResourceAssociateDetail>;
+  const { resource, mode, fromTarget, toTarget } = resourceEvent.detail;
+  await persistAssociation(resource.id, { mode, fromTarget, toTarget });
   list.resourceAssociations = await loadAssociations();
 });
 
-list.addEventListener('harness-resource-context', (event) => {
+list.addEventListener('harness-resource-context', async (event) => {
   const resourceEvent = event as CustomEvent<IHarnessResourceContextDetail>;
-  openHostMenu({
-    x: resourceEvent.detail.clientX,
-    y: resourceEvent.detail.clientY,
-    attach: (target) => resourceEvent.detail.requestAssociation(target),
-    detach: () => resourceEvent.detail.requestAssociation(null),
-    onClose: resourceEvent.detail.close,
+  const { resource, targets } = resourceEvent.detail;
+  resourceEvent.detail.close();
+  const target = await DeesHarnessConversationPicker.pick({
+    sessions: list.sessions,
+    groups: list.groups,
+    excludeTargets: targets,
+    eligibleTargets: list.eligibleTargetsByResourceId[resource.id],
+    heading: `Attach ${resource.title} to…`,
   });
+  if (target) {
+    resourceEvent.detail.requestAssociation(target, targets.length ? 'attach-additional' : 'attach');
+  }
 });
 ```
 
-`harness-resource-select` and `harness-resource-open` carry `{ resource, target }`, where `target` is the controlled association ref or null. `harness-resource-context` adds viewport coordinates, the pointer/Actions/keyboard source, the original event, `requestAssociation(toTarget)`, and `close()` for focus restoration. The visible Actions button has menu disclosure semantics; native `ContextMenu` and `Shift+F10` invoke the same host-owned path. The component does not require `DeesContextmenu` and does not own menu choices.
+`harness-resource-select` and `harness-resource-open` carry `{ resource, targets }`, where `targets` is the controlled set of association refs and is empty for an unattached resource. `harness-resource-context` adds viewport coordinates, the pointer/Actions/keyboard source, the original event, `requestAssociation(toTarget, mode?, fromTarget?)`, and `close()` for focus restoration. The visible Actions button has menu disclosure semantics; native `ContextMenu` and `Shift+F10` invoke the same host-owned path. The component does not require `DeesContextmenu` and does not own menu choices.
 
-All component-originated association request paths converge on the public `requestResourceAssociation(resourceId, toTarget, source?)` method. A valid change emits one bubbling/composed `harness-resource-association-request` discriminated by `intent: 'attach' | 'detach' | 'reassign'` and carrying `resource`, `fromTarget`, `toTarget`, and `source: 'action' | 'keyboard'`. The method returns `false` and emits nothing for unknown resources, unknown or ineligible targets, a target that is the resource itself, detach from an unattached resource, or the current target. It never mutates resources, associations, selection, groups, or order.
+All component-originated association paths converge on the public `requestResourceAssociation(resourceId, toTarget, source?, mode?, fromTarget?)` method. A valid change emits one bubbling/composed `harness-resource-associate` discriminated by `mode: 'attach' | 'attach-additional' | 'move' | 'detach'` and carrying `resource`, `fromTarget`, `toTarget`, and `source: 'action' | 'keyboard' | 'pointer'`. The method returns `false` and emits nothing for unknown resources, unknown or ineligible targets, a target that is the resource itself, a target already in the set, a `move`/`detach` whose `fromTarget` is not in the set, an `attach` on an already attached resource, an `attach-additional` on an unattached one, or an ambiguous request with no mode. It never mutates resources, associations, selection, groups, or order.
 
-Association projection is deterministic and non-destructive: resource records without a non-empty ID, kind, or title, unknown resource/target references, self-targets, and later duplicate records for a resource are ignored; the first valid association wins. Duplicate resource metadata IDs likewise use the first resource. Eligibility does not hide an existing authoritative association, which remains visible and detachable. Requested changes are announced separately from completion; completion is announced only after the controlled association input reflects the requested target.
+Association projection is deterministic and non-destructive: resource records without a non-empty ID, kind, or title, unknown resource/target references, self-targets, and repeated targets are ignored; several records for one resource merge into one de-duplicated set. Duplicate resource metadata IDs likewise use the first resource. Eligibility does not hide an existing authoritative association, which remains visible and detachable. Requested changes are announced separately from completion; completion is announced only after the controlled association input reflects the requested set.
 
 Search covers resource ID, kind, title, and preview, and matches sessions and resources as peers — a matching session no longer reveals its attached resources, and a matching resource no longer reveals its target. Resources render with zero sessions. Resource dragging edge-scrolls the list exactly like session dragging and emits only `harness-item-move`. Use the Actions/context path for keyboard and mobile association workflows; coarse-pointer grip and Actions targets are at least 44px.
 

package/ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@design.estate/dees-catalog',
-  version: '11.2.2',
+  version: '12.0.0',
   description: 'A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.'
 }

package/ts_web/elements/00group-harness/dees-harness-conversation-picker/dees-harness-conversation-picker.demo.ts

@@ -0,0 +1,46 @@
+import { html } from '@design.estate/dees-element';
+import { demoPage } from '../../../demos/templates.js';
+import type { IHarnessSessionGroup, IHarnessSessionMeta, IHarnessResourceMeta } from '../interfaces.js';
+
+const demoSessions: IHarnessSessionMeta[] = [
+  { id: 's1', title: 'Fix sitemap cache key', projectLabel: 'storefront', updatedAt: Date.now() - 1_000 },
+  { id: 's2', title: 'Investigate model rate limits', projectLabel: 'gateway', updatedAt: Date.now() - 2_000 },
+  { id: 's3', title: 'Prepare the catalog release', projectLabel: 'catalog', updatedAt: Date.now() - 3_000 },
+  { id: 's4', title: 'Improve agent onboarding', updatedAt: Date.now() - 4_000 },
+];
+
+const demoResources: IHarnessResourceMeta[] = [
+  { id: 'terminal:build', kind: 'terminal', title: 'Build shell', icon: 'lucide:Terminal', projectLabel: 'storefront' },
+];
+
+const demoGroups: IHarnessSessionGroup[] = [
+  { id: 'active', name: 'Workspace', itemIds: [{ kind: 'session', id: 's1' }, { kind: 'session', id: 's2' }] },
+  { id: 'review', name: 'Review', itemIds: [{ kind: 'session', id: 's3' }] },
+];
+
+export const demoFunc = () => demoPage(
+  'Conversation picker',
+  'Keyboard-first target picker: type to filter on title, project label or group, Enter picks, Escape cancels.',
+  html`
+    <style>
+      .pickerDemo {
+        max-width: 420px;
+        padding: 16px;
+        border: 1px solid var(--dees-color-border-subtle);
+        border-radius: var(--dees-radius-xl);
+        background: var(--dees-color-bg-secondary);
+      }
+    </style>
+    <div class="pickerDemo">
+      <dees-harness-conversation-picker
+        heading="Attach Build shell to…"
+        .sessions=${demoSessions}
+        .groups=${demoGroups}
+        .resources=${demoResources}
+        .excludeTargets=${[{ kind: 'session' as const, id: 's4' }]}
+        @harness-picker-choose=${(event: CustomEvent) => console.log('picked', event.detail.target)}
+        @harness-picker-cancel=${() => console.log('cancelled')}
+      ></dees-harness-conversation-picker>
+    </div>
+  `,
+);