@wowyuarm/dsh-agent-team 0.1.0

package/packages/client-agent-team/lib/types/client/navigation.js

@@ -0,0 +1,96 @@
+const STORAGE_KEY = 'dsh.agent-team.navigation';
+function readSnapshot() {
+    if (typeof localStorage === 'undefined')
+        return { mode: 'conversation' };
+    try {
+        const parsed = JSON.parse(localStorage.getItem(STORAGE_KEY) ?? '');
+        return {
+            mode: parsed.mode === 'team' ? 'team' : 'conversation',
+            ...(typeof parsed.workspaceId === 'string' ? { workspaceId: parsed.workspaceId } : {}),
+        };
+    }
+    catch {
+        return { mode: 'conversation' };
+    }
+}
+function persistSnapshot(snapshot) {
+    if (typeof localStorage === 'undefined')
+        return;
+    try {
+        const { mode, workspaceId } = snapshot;
+        localStorage.setItem(STORAGE_KEY, JSON.stringify({ mode, ...(workspaceId === undefined ? {} : { workspaceId }) }));
+    }
+    catch {
+        // Local persistence is a convenience; private mode and quota failures do not block navigation.
+    }
+}
+/** Root-scoped Team mode state. Slot lifetimes subscribe to this source. */
+export class TeamNavigation {
+    snapshot = readSnapshot();
+    listeners = new Set();
+    getSnapshot = () => this.snapshot;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    };
+    actions() {
+        return {
+            enterTeam: () => { this.setMode('team'); },
+            leaveTeam: () => { this.setMode('conversation'); },
+            selectWorkspace: workspaceId => { this.setWorkspace(workspaceId); },
+            selectChannel: channelRef => { this.setChannel(channelRef); },
+            selectThread: (taskRef, threadRef, channelRef, taskNumber) => { this.setThread(taskRef, threadRef, channelRef, taskNumber); },
+            backToWorkspace: () => { this.setThread(undefined); },
+            backToChannels: () => { this.clearChannel(); },
+        };
+    }
+    dispose() {
+        this.listeners.clear();
+    }
+    setMode(mode) {
+        if (this.snapshot.mode === mode)
+            return;
+        this.snapshot = { ...this.snapshot, mode };
+        this.commit();
+    }
+    setWorkspace(workspaceId) {
+        if (this.snapshot.workspaceId === workspaceId)
+            return;
+        const { channelRef: _channelRef, taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, ...base } = this.snapshot;
+        this.snapshot = { ...base, workspaceId };
+        this.commit();
+    }
+    setChannel(channelRef) {
+        if (this.snapshot.channelRef === channelRef && this.snapshot.threadRef === undefined)
+            return;
+        const { taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, ...base } = this.snapshot;
+        this.snapshot = { ...base, channelRef };
+        this.commit();
+    }
+    clearChannel() {
+        const { channelRef: _channelRef, ...base } = this.snapshot;
+        if (this.snapshot.channelRef === undefined)
+            return;
+        this.snapshot = base;
+        this.commit();
+    }
+    setThread(taskRef, threadRef, channelRef, taskNumber) {
+        if (this.snapshot.threadRef === threadRef && this.snapshot.taskRef === taskRef && this.snapshot.channelRef === channelRef && this.snapshot.taskNumber === taskNumber)
+            return;
+        if (threadRef === undefined || taskRef === undefined) {
+            const { taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, ...base } = this.snapshot;
+            this.snapshot = base;
+        }
+        else {
+            const { channelRef: _channelRef, taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, ...base } = this.snapshot;
+            this.snapshot = { ...base, taskRef, threadRef, ...(channelRef === undefined ? {} : { channelRef }), ...(taskNumber === undefined ? {} : { taskNumber }) };
+        }
+        this.commit();
+    }
+    commit() {
+        persistSnapshot(this.snapshot);
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+export { STORAGE_KEY };

package/packages/client-agent-team/lib/types/client/slots.d.ts

@@ -0,0 +1,74 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { AgentTeamAddMemberRequest, AgentTeamChannelRef, AgentTeamClientMemberStatus, AgentTeamCreateChannelRequest, AgentTeamCreateChannelResult, AgentTeamJoinChannelRequest, AgentTeamJoinChannelResult, AgentTeamMemberResult, AgentTeamMembersRequest, AgentTeamRemoveChannelMemberRequest, AgentTeamRemoveChannelMemberResult, AgentTeamReplyRequest, AgentTeamReplyResult, AgentTeamConfirmationRequired, AgentTeamThreadHistory, AgentTeamThreadHistoryRequest, AgentTeamThreadReadRequest, AgentTeamThreadReadResult, AgentTeamTaskRequest, AgentTeamTaskResult, AgentTeamSendMessageRequest, AgentTeamSendMessageResult, AgentTeamUpdateChannelRequest, AgentTeamUpdateChannelResult, AgentTeamUpdateMemberRequest, AgentTeamView, AgentTeamViewRequest } from '@wowyuarm/dsh-agent-team/types';
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { TeamNavigationActions, TeamNavigationSnapshot } from './navigation.ts';
+import type { TeamChangeListener, TeamChangeScope } from './team-changes.ts';
+export interface TeamNavigationSource {
+    getSnapshot: () => TeamNavigationSnapshot;
+    subscribe: (listener: () => void) => () => void;
+}
+/** Subscribe to one projection scope's invalidation stream; disposal aborts the shared poll. */
+export type SubscribeTeamChanges = (scope: TeamChangeScope, listener: TeamChangeListener) => () => void;
+/** One selectable model row inside one provider group of the Host catalog. */
+export interface TeamModelOption {
+    readonly id: string;
+    readonly name: string;
+}
+/** Provider-grouped slice of the Host model catalog the editors render. */
+export interface TeamModelProviderGroup {
+    readonly id: string;
+    readonly name: string;
+    readonly models: readonly TeamModelOption[];
+}
+/** Host-scoped catalog load result; per-provider listing failures ride `failures`. */
+export interface TeamModelCatalog {
+    readonly groups: readonly TeamModelProviderGroup[];
+    readonly failures: readonly {
+        readonly id: string;
+        readonly name: string;
+        readonly message: string;
+    }[];
+}
+export type TeamSidebarProps = PropsRuntime<'sidebar.workspaces'> & PropsLocale<'team'> & TeamNavigationActions & {
+    navigation: TeamNavigationSource;
+    loadMembers: (request: AgentTeamMembersRequest) => Promise<RemoteResult<readonly AgentTeamClientMemberStatus[]>>;
+    subscribeChanges: SubscribeTeamChanges;
+    addMember: (request: AgentTeamAddMemberRequest) => Promise<RemoteResult<AgentTeamMemberResult>>;
+    loadChannels: (request: AgentTeamViewRequest) => Promise<RemoteResult<AgentTeamView>>;
+    createChannel: (request: AgentTeamCreateChannelRequest) => Promise<RemoteResult<AgentTeamCreateChannelResult>>;
+    updateChannel: (request: AgentTeamUpdateChannelRequest) => Promise<RemoteResult<AgentTeamUpdateChannelResult>>;
+    updateMember: (request: AgentTeamUpdateMemberRequest) => Promise<RemoteResult<AgentTeamMemberResult>>;
+    joinChannel: (request: AgentTeamJoinChannelRequest) => Promise<RemoteResult<AgentTeamJoinChannelResult>>;
+    removeChannelMember: (request: AgentTeamRemoveChannelMemberRequest) => Promise<RemoteResult<AgentTeamRemoveChannelMemberResult>>;
+    /** Session-independent Host model catalog (`llm.models`); needs no live Member. */
+    loadModels: () => Promise<RemoteResult<TeamModelCatalog>>;
+    /** Focus the Member's own Session conversation page in the ordinary shell. */
+    openMemberSession: (sessionId: AgentTeamClientMemberStatus['member']['sessionId']) => void;
+    selectedChannelRef?: AgentTeamChannelRef;
+};
+export type TeamConversationProps = PropsRuntime<'conversation'> & PropsLocale<'team'> & TeamNavigationActions & {
+    navigation: TeamNavigationSource;
+    loadChannels: (request: AgentTeamViewRequest) => Promise<RemoteResult<AgentTeamView>>;
+    readThread: (request: AgentTeamThreadReadRequest) => Promise<RemoteResult<AgentTeamThreadReadResult>>;
+    loadThreadHistory: (request: AgentTeamThreadHistoryRequest) => Promise<RemoteResult<AgentTeamThreadHistory>>;
+    subscribeChanges: SubscribeTeamChanges;
+    sendMessage: (request: AgentTeamSendMessageRequest) => Promise<RemoteResult<AgentTeamSendMessageResult>>;
+    joinChannel: (request: AgentTeamJoinChannelRequest) => Promise<RemoteResult<AgentTeamJoinChannelResult>>;
+    removeChannelMember: (request: AgentTeamRemoveChannelMemberRequest) => Promise<RemoteResult<AgentTeamRemoveChannelMemberResult>>;
+    reply: (request: AgentTeamReplyRequest) => Promise<RemoteResult<AgentTeamReplyResult | AgentTeamConfirmationRequired>>;
+    changeTask: (request: AgentTeamTaskRequest) => Promise<RemoteResult<AgentTeamTaskResult>>;
+    loadMembers: (request: AgentTeamMembersRequest) => Promise<RemoteResult<readonly AgentTeamClientMemberStatus[]>>;
+};
+export type TeamSettingsProps = PropsRuntime<'sidebar.settings'> & PropsLocale<'team'> & {
+    loadMemberGroups: () => Promise<readonly TeamMemberGroup[]>;
+};
+export interface TeamMemberGroup {
+    readonly workspaceId: string;
+    readonly workspaceTitle: string;
+    readonly members: readonly AgentTeamClientMemberStatus[];
+}
+export type TeamFooterProps = PropsRuntime<'sidebar.footer.action'> & PropsLocale<'team'> & TeamNavigationActions & {
+    navigation: TeamNavigationSource;
+    loadMemberGroups: () => Promise<readonly TeamMemberGroup[]>;
+};
+//# sourceMappingURL=slots.d.ts.map

package/packages/client-agent-team/lib/types/client/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../src/client/slots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACjF,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,mCAAmC,EACnC,kCAAkC,EAClC,qBAAqB,EACrB,oBAAoB,EACpB,6BAA6B,EAC7B,sBAAsB,EACtB,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,aAAa,EACb,oBAAoB,EACrB,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAE5E,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,sBAAsB,CAAA;IACzC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAChD;AAED,gGAAgG;AAChG,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,kBAAkB,KAAK,MAAM,IAAI,CAAA;AAEvG,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;CAC5C;AAED,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACvG;AAED,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,oBAAoB,CAAC,GAC7D,WAAW,CAAC,MAAM,CAAC,GACnB,qBAAqB,GACrB;IACA,UAAU,EAAE,oBAAoB,CAAA;IAChC,WAAW,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,YAAY,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAAC,CAAA;IAChH,gBAAgB,EAAE,oBAAoB,CAAA;IACtC,SAAS,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAAA;IAC/F,YAAY,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAA;IACrF,aAAa,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAC,YAAY,CAAC,4BAA4B,CAAC,CAAC,CAAA;IAC9G,aAAa,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAC,YAAY,CAAC,4BAA4B,CAAC,CAAC,CAAA;IAC9G,YAAY,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAAA;IACrG,WAAW,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAA;IACxG,mBAAmB,EAAE,CAAC,OAAO,EAAE,mCAAmC,KAAK,OAAO,CAAC,YAAY,CAAC,kCAAkC,CAAC,CAAC,CAAA;IAChI,mFAAmF;IACnF,UAAU,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAA;IACzD,8EAA8E;IAC9E,iBAAiB,EAAE,CAAC,SAAS,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,KAAK,IAAI,CAAA;IAC1F,kBAAkB,CAAC,EAAE,mBAAmB,CAAA;CACzC,CAAA;AAEH,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,qBAAqB,GAAG;IAC/G,UAAU,EAAE,oBAAoB,CAAA;IAChC,YAAY,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAA;IACrF,UAAU,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,OAAO,CAAC,YAAY,CAAC,yBAAyB,CAAC,CAAC,CAAA;IACrG,iBAAiB,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,CAAA;IAC5G,gBAAgB,EAAE,oBAAoB,CAAA;IACtC,WAAW,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAA;IACxG,WAAW,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAA;IACxG,mBAAmB,EAAE,CAAC,OAAO,EAAE,mCAAmC,KAAK,OAAO,CAAC,YAAY,CAAC,kCAAkC,CAAC,CAAC,CAAA;IAChI,KAAK,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,YAAY,CAAC,oBAAoB,GAAG,6BAA6B,CAAC,CAAC,CAAA;IACtH,UAAU,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,CAAA;IACzF,WAAW,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,YAAY,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAAC,CAAA;CACjH,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,kBAAkB,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG;IACvF,gBAAgB,EAAE,MAAM,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAA;CAC5D,CAAA;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,2BAA2B,EAAE,CAAA;CACzD;AAED,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,uBAAuB,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,qBAAqB,GAAG;IAClH,UAAU,EAAE,oBAAoB,CAAA;IAChC,gBAAgB,EAAE,MAAM,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAA;CAC5D,CAAA"}

package/packages/client-agent-team/lib/types/client/slots.js

@@ -0,0 +1 @@
+export {};

package/packages/client-agent-team/lib/types/client/team-changes.d.ts

@@ -0,0 +1,28 @@
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { AgentTeamChangeScope, AgentTeamChangesRequest, AgentTeamChangesResult } from '@wowyuarm/dsh-agent-team/types';
+export type TeamChangeScope = AgentTeamChangeScope;
+/** One invalidation delivered to every surface subscribed to one scope. */
+export type TeamChangeUpdate = {
+    readonly type: 'changed';
+    readonly version: number;
+} | {
+    readonly type: 'failed';
+    readonly message: string;
+};
+export type TeamChangeListener = (update: TeamChangeUpdate) => void;
+type ChangesFn = (request: AgentTeamChangesRequest, signal?: AbortSignal) => Promise<RemoteResult<AgentTeamChangesResult>>;
+/**
+ * One long-poll per change scope, shared by every listening surface: panels
+ * and pages never open parallel `changes` requests for the same scope, and
+ * the poll is aborted as soon as the last subscriber leaves.
+ */
+export declare class TeamChangeStream {
+    private readonly changes;
+    private readonly polls;
+    constructor(changes: ChangesFn);
+    subscribe(scope: TeamChangeScope, listener: TeamChangeListener): () => void;
+    private run;
+    private fail;
+}
+export {};
+//# sourceMappingURL=team-changes.d.ts.map

package/packages/client-agent-team/lib/types/client/team-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-changes.d.ts","sourceRoot":"","sources":["../../../src/client/team-changes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAE3H,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAA;AAElD,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzD,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAEnE,KAAK,SAAS,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,CAAA;AAa1H;;;;GAIG;AACH,qBAAa,gBAAgB;IAGf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;gBAExB,OAAO,EAAE,SAAS;IAE/C,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;YAmB7D,GAAG;IAyBjB,OAAO,CAAC,IAAI;CAKb"}

package/packages/client-agent-team/lib/types/client/team-changes.js

@@ -0,0 +1,70 @@
+function scopeKey(scope) {
+    return scope.kind === 'workspace' ? `workspace:${scope.workspaceId}`
+        : scope.kind === 'channel' ? `channel:${scope.channelRef}`
+            : `thread:${scope.threadRef}`;
+}
+/**
+ * One long-poll per change scope, shared by every listening surface: panels
+ * and pages never open parallel `changes` requests for the same scope, and
+ * the poll is aborted as soon as the last subscriber leaves.
+ */
+export class TeamChangeStream {
+    changes;
+    polls = new Map();
+    constructor(changes) {
+        this.changes = changes;
+    }
+    subscribe(scope, listener) {
+        const key = scopeKey(scope);
+        let poll = this.polls.get(key);
+        if (poll === undefined) {
+            poll = { controller: new AbortController(), listeners: new Set() };
+            this.polls.set(key, poll);
+            void this.run(key, scope, poll);
+        }
+        poll.listeners.add(listener);
+        return () => {
+            const current = this.polls.get(key);
+            if (current === undefined || !current.listeners.delete(listener))
+                return;
+            if (current.listeners.size === 0) {
+                this.polls.delete(key);
+                current.controller.abort();
+            }
+        };
+    }
+    async run(key, scope, poll) {
+        const { signal } = poll.controller;
+        // Sample the current version silently first: subscribers just fetched
+        // their initial projection, and an immediate wake would double-fetch.
+        const probe = await this.changes({ afterVersion: 0, scope }, signal);
+        if (signal.aborted)
+            return;
+        if (!probe.ok) {
+            this.fail(key, poll, probe.error.message);
+            return;
+        }
+        let version = probe.value.version;
+        while (!signal.aborted) {
+            const result = await this.changes({ afterVersion: version, scope }, signal);
+            if (signal.aborted)
+                return;
+            if (!result.ok) {
+                this.fail(key, poll, result.error.message);
+                return;
+            }
+            if (result.value.version > version) {
+                version = result.value.version;
+                for (const listener of poll.listeners)
+                    listener({ type: 'changed', version });
+            }
+        }
+    }
+    fail(key, poll, message) {
+        // A dead poll must not stay registered: the next subscriber restarts it.
+        if (this.polls.get(key) === poll)
+            this.polls.delete(key);
+        for (const listener of poll.listeners)
+            listener({ type: 'failed', message });
+    }
+}

package/packages/client-agent-team/lib/types/client/team-formatters.d.ts

@@ -0,0 +1,53 @@
+import type { AgentTeamActivity, AgentTeamClaim, AgentTeamMemberId, AgentTeamTask } from '@wowyuarm/dsh-agent-team/types';
+import type { TeamConversationProps } from './slots.ts';
+export declare function formatTaskStatus(status: AgentTeamTask['status'], t: TeamConversationProps['t']): string;
+export declare function formatClaimState(state: AgentTeamClaim['state'], t: TeamConversationProps['t']): string;
+/**
+ * Status indicator variant for a Task status. Active states map to StateDot
+ * variants; every status renders a dot so all Task chips share one shape
+ * language — todo is a hollow ring (not started), closed a quiet gray dot
+ * (archived).
+ */
+export declare function taskStatusDot(status: AgentTeamTask['status']): 'ongoing' | 'warning' | 'done' | 'todo' | 'closed';
+/** One-line title snippet derived from the Task's root Message body. */
+export declare function formatTaskTitle(body: string): string;
+/** Deterministic avatar hue for one Member identity; stable across sessions and themes. */
+export declare function memberHue(memberId: string): number;
+export interface MentionSegment {
+    readonly text: string;
+    readonly mention: boolean;
+    /** Canonical handle of the mentioned Member; present only on mention segments. */
+    readonly name?: string;
+}
+/**
+ * Locate one Message's structured mention names inside its literal body. A
+ * name matches case-insensitively with an optional leading '@' on Unicode word
+ * boundaries, and longer names win at the same position. Mention segments
+ * render the canonical `@Handle`; names absent from the body come back
+ * unmatched so the consumer can append them as a fallback chip row.
+ */
+export declare function splitMentionNames(text: string, names: readonly string[]): {
+    segments: MentionSegment[];
+    unmatched: readonly string[];
+};
+/** Canonical chip handles for one Message's structured mention refs. */
+export declare function mentionNamesOf(mentions: readonly AgentTeamMemberId[], handles: ReadonlyMap<AgentTeamMemberId, string>): string[];
+/**
+ * Whether an Agent body survives literal rendering unchanged: no fences,
+ * inline code, emphasis markers, links, images, tables, or block constructs.
+ * Only such plain-prose bodies may reuse the Human inline mention flow —
+ * anything richer keeps the trailing chip row because the Markdown primitive
+ * renders block-level documents that cannot interleave inline chips.
+ */
+export declare function isPlainTextBody(text: string): boolean;
+/**
+ * Wall-clock label for one Message instant: time within the current day,
+ * month-day time within the year, full date otherwise.
+ */
+export declare function formatMessageTime(occurredAt: string, now?: Date): string;
+export declare function formatActivity(activity: AgentTeamActivity, options: {
+    readonly t: TeamConversationProps['t'];
+    readonly actorName: (memberId: AgentTeamMemberId) => string;
+    readonly claims: readonly AgentTeamClaim[];
+}): string;
+//# sourceMappingURL=team-formatters.d.ts.map

package/packages/client-agent-team/lib/types/client/team-formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-formatters.d.ts","sourceRoot":"","sources":["../../../src/client/team-formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACzH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,MAAM,CAQvG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,MAAM,CAMtG;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAEjH;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,kFAAkF;IAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAwBtI;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAEhI;AAKD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,MAAM,CAS9E;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE;IACnE,QAAQ,CAAC,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,MAAM,CAAA;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAA;CAC3C,GAAG,MAAM,CAaT"}

package/packages/client-agent-team/lib/types/client/team-formatters.js

@@ -0,0 +1,128 @@
+export function formatTaskStatus(status, t) {
+    return t({
+        todo: 'taskStatusTodo',
+        in_progress: 'taskStatusInProgress',
+        in_review: 'taskStatusInReview',
+        done: 'taskStatusDone',
+        closed: 'taskStatusClosed',
+    }[status]);
+}
+export function formatClaimState(state, t) {
+    return t({
+        active: 'claimStateActive',
+        done: 'claimStateDone',
+        released: 'claimStateReleased',
+    }[state]);
+}
+/**
+ * Status indicator variant for a Task status. Active states map to StateDot
+ * variants; every status renders a dot so all Task chips share one shape
+ * language — todo is a hollow ring (not started), closed a quiet gray dot
+ * (archived).
+ */
+export function taskStatusDot(status) {
+    return { todo: 'todo', in_progress: 'ongoing', in_review: 'warning', done: 'done', closed: 'closed' }[status];
+}
+/** One-line title snippet derived from the Task's root Message body. */
+export function formatTaskTitle(body) {
+    const firstLine = body.split('\n', 1)[0]?.trim() ?? '';
+    return firstLine.length > 120 ? `${firstLine.slice(0, 119)}…` : firstLine;
+}
+/** Deterministic avatar hue for one Member identity; stable across sessions and themes. */
+export function memberHue(memberId) {
+    let hash = 0;
+    for (let index = 0; index < memberId.length; index += 1)
+        hash = (hash * 31 + memberId.charCodeAt(index)) % 360;
+    return hash;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Locate one Message's structured mention names inside its literal body. A
+ * name matches case-insensitively with an optional leading '@' on Unicode word
+ * boundaries, and longer names win at the same position. Mention segments
+ * render the canonical `@Handle`; names absent from the body come back
+ * unmatched so the consumer can append them as a fallback chip row.
+ */
+export function splitMentionNames(text, names) {
+    if (names.length === 0)
+        return { segments: [{ text, mention: false }], unmatched: [] };
+    const ordered = [...names].sort((left, right) => right.length - left.length);
+    // The lookbehind keeps the optional '@' from consuming the separator of an
+    // email-like occurrence: the character before the name (or before its '@')
+    // must not be a letter, digit, underscore, or another '@'.
+    const pattern = new RegExp(`(?<![\\p{L}\\p{N}_@])@?(?:${ordered.map(name => `(${escapeRegExp(name)})`).join('|')})(?=$|[^\\p{L}\\p{N}_])`, 'giu');
+    const segments = [];
+    const matched = new Set();
+    let cursor = 0;
+    for (const match of text.matchAll(pattern)) {
+        const groupIndex = match.findIndex((group, index) => index >= 1 && group !== undefined);
+        if (groupIndex < 1)
+            continue;
+        if (match.index > cursor)
+            segments.push({ text: text.slice(cursor, match.index), mention: false });
+        const name = ordered[groupIndex - 1];
+        segments.push({ text: `@${name}`, mention: true, name });
+        matched.add(name.toLowerCase());
+        cursor = match.index + match[0].length;
+    }
+    if (cursor < text.length)
+        segments.push({ text: text.slice(cursor), mention: false });
+    return { segments, unmatched: names.filter(name => !matched.has(name.toLowerCase())) };
+}
+/** Canonical chip handles for one Message's structured mention refs. */
+export function mentionNamesOf(mentions, handles) {
+    return mentions.map(memberId => handles.get(memberId)).filter((name) => name !== undefined);
+}
+const MARKDOWN_BLOCK_CONSTRUCT = /(^|\n)[ \t]{0,3}(?:#{1,6}[ \t]|>[ \t]|[-*+][ \t]|\d+[.)][ \t])|^[ \t]*\|.+\|/m;
+const MARKDOWN_INLINE_CONSTRUCT = /[`*_[\]!]|~~~|```/;
+/**
+ * Whether an Agent body survives literal rendering unchanged: no fences,
+ * inline code, emphasis markers, links, images, tables, or block constructs.
+ * Only such plain-prose bodies may reuse the Human inline mention flow —
+ * anything richer keeps the trailing chip row because the Markdown primitive
+ * renders block-level documents that cannot interleave inline chips.
+ */
+export function isPlainTextBody(text) {
+    return !(MARKDOWN_BLOCK_CONSTRUCT.test(text) || MARKDOWN_INLINE_CONSTRUCT.test(text));
+}
+const pad = (value) => String(value).padStart(2, '0');
+/**
+ * Wall-clock label for one Message instant: time within the current day,
+ * month-day time within the year, full date otherwise.
+ */
+export function formatMessageTime(occurredAt, now = new Date()) {
+    const at = new Date(occurredAt);
+    if (Number.isNaN(at.getTime()))
+        return '';
+    const time = `${pad(at.getHours())}:${pad(at.getMinutes())}`;
+    const sameDay = at.getFullYear() === now.getFullYear() && at.getMonth() === now.getMonth() && at.getDate() === now.getDate();
+    if (sameDay)
+        return time;
+    const date = `${at.getFullYear()}-${pad(at.getMonth() + 1)}-${pad(at.getDate())}`;
+    if (at.getFullYear() === now.getFullYear())
+        return `${date.slice(5)} ${time}`;
+    return `${date} ${time}`;
+}
+export function formatActivity(activity, options) {
+    const actor = options.actorName(activity.actor);
+    if (activity.kind === 'accept')
+        return options.t('activityAccepted', { actor });
+    if (activity.kind === 'close')
+        return options.t('activityClosed', { actor });
+    if (activity.kind === 'reopen')
+        return options.t('activityReopened', { actor });
+    const direction = 'claimRef' in activity
+        ? options.claims.find(claim => claim.claimRef === activity.claimRef)?.direction ?? options.t('claims')
+        : options.t('claims');
+    if (activity.kind === 'claim')
+        return options.t('activityClaimed', { actor, direction });
+    if (activity.kind === 'done')
+        return options.t('activityClaimDone', { actor, direction });
+    if (activity.kind === 'release')
+        return options.t('activityClaimReleased', { actor, direction });
+    if (activity.kind === 'claims_released')
+        return options.t('activityClaimsReleased', { actor, count: activity.claimRefs.length });
+    throw new Error(`unknown Team Activity kind: ${activity.kind}`);
+}

package/packages/client-agent-team/lib/types/client/team-membership.d.ts

@@ -0,0 +1,25 @@
+import type { AgentTeamChannelRef, AgentTeamJoinChannelRequest, AgentTeamJoinChannelResult, AgentTeamMemberId, AgentTeamRemoveChannelMemberRequest, AgentTeamRemoveChannelMemberResult } from '@wowyuarm/dsh-agent-team/types';
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { WorkspaceId } from '@deepseek-ai/dsh-client-runtime/client';
+/** One idempotent membership intent: `joined` rows leave, others join. */
+export interface ChannelMembershipChange {
+    readonly workspaceId: WorkspaceId;
+    readonly channelRef: AgentTeamChannelRef;
+    readonly memberId: AgentTeamMemberId;
+    readonly joined: boolean;
+}
+export interface ChannelMembershipTransport {
+    readonly joinChannel: (request: AgentTeamJoinChannelRequest) => Promise<RemoteResult<AgentTeamJoinChannelResult>>;
+    readonly removeChannelMember: (request: AgentTeamRemoveChannelMemberRequest) => Promise<RemoteResult<AgentTeamRemoveChannelMemberResult>>;
+}
+/**
+ * Shared Channel membership mutation. One stable requestId per direction,
+ * Member, and Channel survives transport failures until the Host commits it;
+ * rows observe pending flags and error text keyed by `rowKeyOf`.
+ */
+export declare function useChannelMembership(transport: ChannelMembershipTransport, rowKeyOf: (change: ChannelMembershipChange) => string, onCommitted: (change: ChannelMembershipChange) => void | Promise<void>): {
+    readonly pending: ReadonlySet<string>;
+    readonly errors: ReadonlyMap<string, string>;
+    readonly change: (change: ChannelMembershipChange) => Promise<void>;
+};
+//# sourceMappingURL=team-membership.d.ts.map

package/packages/client-agent-team/lib/types/client/team-membership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-membership.d.ts","sourceRoot":"","sources":["../../../src/client/team-membership.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,iBAAiB,EACjB,mCAAmC,EACnC,kCAAkC,EAEnC,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAEzE,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAA;IACjH,QAAQ,CAAC,mBAAmB,EAAE,CAAC,OAAO,EAAE,mCAAmC,KAAK,OAAO,CAAC,YAAY,CAAC,kCAAkC,CAAC,CAAC,CAAA;CAC1I;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,MAAM,EACrD,WAAW,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACrE;IACD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5C,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpE,CA6BA"}

package/packages/client-agent-team/lib/types/client/team-membership.js

@@ -0,0 +1,39 @@
+import { useRef, useState } from 'react';
+/**
+ * Shared Channel membership mutation. One stable requestId per direction,
+ * Member, and Channel survives transport failures until the Host commits it;
+ * rows observe pending flags and error text keyed by `rowKeyOf`.
+ */
+export function useChannelMembership(transport, rowKeyOf, onCommitted) {
+    const [pending, setPending] = useState(new Set());
+    const [errors, setErrors] = useState(new Map());
+    const requestIds = useRef(new Map());
+    const change = async (membership) => {
+        const rowKey = rowKeyOf(membership);
+        if (pending.has(rowKey))
+            return;
+        setPending(current => new Set(current).add(rowKey));
+        setErrors(current => { const next = new Map(current); next.delete(rowKey); return next; });
+        const key = `${membership.joined ? 'remove' : 'join'}:${membership.memberId}:${membership.channelRef}`;
+        const requestId = requestIds.current.get(key) ?? crypto.randomUUID();
+        requestIds.current.set(key, requestId);
+        const request = { requestId, workspaceId: membership.workspaceId, channelRef: membership.channelRef, memberId: membership.memberId };
+        try {
+            const result = membership.joined ? await transport.removeChannelMember(request) : await transport.joinChannel(request);
+            if (result.ok) {
+                requestIds.current.delete(key);
+                await onCommitted(membership);
+            }
+            else {
+                setErrors(current => new Map(current).set(rowKey, result.error.message));
+            }
+        }
+        catch (cause) {
+            setErrors(current => new Map(current).set(rowKey, cause instanceof Error ? cause.message : String(cause)));
+        }
+        finally {
+            setPending(current => { const next = new Set(current); next.delete(rowKey); return next; });
+        }
+    };
+    return { pending, errors, change };
+}

package/packages/client-agent-team/lib/types/client/team-separators.d.ts

@@ -0,0 +1,23 @@
+/** One rendered timeline block: a same-sender run or an injected day marker. */
+export type TimelineBlock<T> = {
+    readonly kind: 'run';
+    readonly items: readonly T[];
+} | {
+    readonly kind: 'day';
+    readonly label: string;
+};
+/** Local-calendar day key for one wall-clock instant; shared by bespoke loops. */
+export declare function timelineDayKey(occurredAt: string): string;
+/**
+ * Numeric day label matching the message-time convention: MM-DD within the
+ * current year, full YYYY-MM-DD across years.
+ */
+export declare function daySeparatorLabel(occurredAt: string, now?: Date): string;
+/**
+ * Chunk one ordered timeline into same-sender runs, breaking a run at every
+ * calendar-day change so identity chrome restarts across days. Items without a
+ * wall-clock instant (activities) inherit the preceding message's day and never
+ * trigger a boundary; callers interleave activity rows between returned blocks.
+ */
+export declare function chunkRunsWithDays<T>(items: readonly T[], senderOf: (item: T) => string | undefined, occurredAtOf: (item: T) => string | undefined): readonly TimelineBlock<T>[];
+//# sourceMappingURL=team-separators.d.ts.map

package/packages/client-agent-team/lib/types/client/team-separators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-separators.d.ts","sourceRoot":"","sources":["../../../src/client/team-separators.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAIpD,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAOD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,MAAM,CAG9E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,GAAG,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,CA0B/K"}

package/packages/client-agent-team/lib/types/client/team-separators.js

@@ -0,0 +1,52 @@
+const pad = (value) => String(value).padStart(2, '0');
+/** Local-calendar day key for one wall-clock instant; shared by bespoke loops. */
+export function timelineDayKey(occurredAt) {
+    return localDateKey(occurredAt);
+}
+function localDateKey(occurredAt) {
+    const at = new Date(occurredAt);
+    return `${at.getFullYear()}-${pad(at.getMonth() + 1)}-${pad(at.getDate())}`;
+}
+/**
+ * Numeric day label matching the message-time convention: MM-DD within the
+ * current year, full YYYY-MM-DD across years.
+ */
+export function daySeparatorLabel(occurredAt, now = new Date()) {
+    const key = localDateKey(occurredAt);
+    return key.startsWith(String(now.getFullYear())) ? key.slice(5) : key;
+}
+/**
+ * Chunk one ordered timeline into same-sender runs, breaking a run at every
+ * calendar-day change so identity chrome restarts across days. Items without a
+ * wall-clock instant (activities) inherit the preceding message's day and never
+ * trigger a boundary; callers interleave activity rows between returned blocks.
+ */
+export function chunkRunsWithDays(items, senderOf, occurredAtOf) {
+    const blocks = [];
+    let lastDate;
+    for (const item of items) {
+        const occurredAt = occurredAtOf(item);
+        if (occurredAt === undefined) {
+            blocks.push({ kind: 'run', items: [item] });
+            continue;
+        }
+        const date = localDateKey(occurredAt);
+        if (lastDate !== undefined && date !== lastDate) {
+            blocks.push({ kind: 'day', label: daySeparatorLabel(occurredAt) });
+            // The boundary also ends any open same-sender run before it.
+            lastDate = date;
+        }
+        else if (lastDate === undefined) {
+            lastDate = date;
+        }
+        let last = blocks[blocks.length - 1];
+        if (last?.kind === 'run' && senderOf(last.items[last.items.length - 1]) === senderOf(item)) {
+            last = { kind: 'run', items: [...last.items, item] };
+            blocks[blocks.length - 1] = last;
+        }
+        else {
+            blocks.push({ kind: 'run', items: [item] });
+        }
+    }
+    return blocks;
+}

package/packages/client-agent-team/lib/types/client/timeline-scroll.d.ts

@@ -0,0 +1,18 @@
+export interface TimelineScroll {
+    readonly ref: React.RefObject<HTMLElement>;
+    onScroll: () => void;
+    /** Whether the reader currently sits within the follow margin of the bottom. */
+    isPinned: () => boolean;
+    /** Jump to the unread-boundary marker on the next content commit. */
+    jumpToBoundary: () => void;
+    /** Jump to the latest fact on the next content commit. */
+    jumpToLatest: () => void;
+}
+/**
+ * Chat-timeline scroll policy shared by the Channel and Thread pages: follow
+ * new facts only while the reader stays pinned to the bottom, keep prepended
+ * history visually stable, and honor explicit jump requests exactly once per
+ * content commit. The content key must change whenever rendered facts change.
+ */
+export declare function useTimelineScroll(contentKey: string): TimelineScroll;
+//# sourceMappingURL=timeline-scroll.d.ts.map