@wowyuarm/dsh-agent-team 0.1.14-alpha.2 → 0.1.14

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

@@ -1,4 +1,7 @@
 import agentTeamRemote from '@wowyuarm/dsh-agent-team/remote';
+import { HumanSettingsSection } from "./HumanSettingsSection.js";
+import { HUMAN_PROFILE_NAMESPACE, TeamHumanIdentity } from "./human-identity.js";
+import { bytesToBase64 } from "./attachment-preview.js";
 import { TeamNavigation } from "./navigation.js";
 import { TeamChangeStream, TeamReadStream } from "./team-changes.js";
 import { TeamDraftStore } from "./drafts.js";
@@ -10,28 +13,9 @@ import { en, zh } from "./locales.js";
 export { TeamNavigation } from "./navigation.js";
 const NS = 'team';
 export const inject = [
-    'slots', 'workspaces', 'locale', 'remote', 'remote.session', 'sessions', 'connection', 'conversation', 'uiWorkspace',
+    'slots', 'workspaces', 'locale', 'remote', 'remote.session', 'sessions', 'connection', 'conversation',
 ];
-/**
- * 0.1.7 moved the conversation selection into the workspace service: the
- * rendered session is the one holding its `mainView` reference (the shipped
- * consumers read the same projection), so the Team client reads the selection
- * through retention instead of a service-owned `current`.
- */
-function currentMainSessionId(ctx) {
-    const sessions = ctx.sessions;
-    return Object.values(sessions.list.getSnapshot().byId)
-        .find(session => (session.retainedBy.mainView ?? 0) > 0)?.id;
-}
-/**
- * Session ids this client opened as Member views, per client instance. The
- * 0.1.7 workspace service exposes no clear, so a dead return target leaves
- * the departed Member selection in place; excluding Member sessions from the
- * next capture keeps that stale selection from becoming a false return
- * target.
- */
-const openedMemberSessions = new WeakMap();
-function registerModeShadow(ctx, navigation, changes, reads, drafts, name, component, extraInject, 
+function registerModeShadow(ctx, navigation, changes, reads, drafts, humanIdentity, name, component, extraInject, 
 // Keyed seats (`main`) address one panel by key; the reserved 'conversation'
 // key is where the shipped Conversation registers, so the Team seat shadows
 // that same panel instead of adding a second one.
@@ -40,16 +24,14 @@ entryKey) {
     // views (see registerModeShadow), so the shipped conversation root renders
     // the selected Member Session inside the Team shell.
     const openMemberSessionImpl = (sessionId) => {
+        const sessions = ctx.sessions;
         const snapshot = navigation.getSnapshot();
-        const current = currentMainSessionId(ctx);
+        const current = sessions.list.getSnapshot().current;
         // The return target is captured on first entry only — switching between
         // Member Sessions must keep pointing at the Human's original session.
-        const memberSessions = openedMemberSessions.get(ctx) ?? new Set();
-        openedMemberSessions.set(ctx, memberSessions);
-        memberSessions.add(sessionId);
-        const returnTo = snapshot.memberSessionId === undefined && current !== undefined && current !== sessionId && !memberSessions.has(current) ? current : undefined;
+        const returnTo = snapshot.memberSessionId === undefined && current !== undefined && current !== sessionId ? current : undefined;
         navigation.actions().enterMemberSession(sessionId, returnTo);
-        ctx.uiWorkspace.openSession(sessionId);
+        sessions.open(sessionId);
     };
     // Remote bindings shared by every Team slot; surface-specific entries extend it below.
     const sharedRemotes = {
@@ -58,6 +40,7 @@ entryKey) {
         subscribeReads: (listener) => reads.subscribe(listener),
         subscribeChanges: (scope, listener) => changes.subscribe(scope, listener),
         drafts,
+        humanIdentity,
         loadMembers: (request) => ctx.remote.agentTeam.members(request),
         joinChannel: (request) => ctx.remote.agentTeam.joinChannel(request),
         removeChannelMember: (request) => ctx.remote.agentTeam.removeChannelMember(request),
@@ -111,6 +94,7 @@ entryKey) {
                             changeTask: (request) => ctx.remote.agentTeam.changeTask(request),
                             promoteThread: (request) => ctx.remote.agentTeam.promoteThread(request),
                             resolveTaskRefs: (request) => ctx.remote.agentTeam.resolveTaskRefs(request),
+                            resolveThreadRefs: (request) => ctx.remote.agentTeam.resolveThreadRefs(request),
                         } : {}),
                         ...(name === 'sidebar.workspaces' ? {
                             addMember: (request) => ctx.remote.agentTeam.addMember(request),
@@ -139,20 +123,44 @@ function applyUi(ctx) {
     const disposeNavigation = ctx.reflect.provide('teamNavigation', navigation);
     const drafts = new TeamDraftStore();
     const disposeDrafts = ctx.reflect.provide('teamDrafts', drafts);
+    // The Human's own identity: one projection every seat reads, refreshed once
+    // after a profile write so a rename reaches the timeline and the member refs
+    // without a reload. Reads are demand-driven — the first seat that subscribes
+    // starts the read.
+    // The profile page writes through the settings transport. It arrives from the
+    // settings plugin, and Cordis refuses a `remote.<namespace>` read that was
+    // never injected, so the binding is an optional injection rather than either
+    // a hard activation dependency (a settings-less host would lose Team mode
+    // entirely) or an undeclared read (which throws at the first write).
+    let settingsTransport;
+    ctx.inject(['remote.settings'], (scope) => {
+        settingsTransport = scope.remote.settings;
+    });
+    const humanIdentity = new TeamHumanIdentity({
+        loadProfile: () => ctx.remote.agentTeam.humanProfile({}),
+        loadAvatarUrl: async (avatarRef) => {
+            // Avatar bytes ride the dedicated avatar Remote (never the TTL-bound
+            // attachment cache); a data URL is what an `<img>` seat can show directly.
+            const result = await ctx.remote.agentTeam.getHumanAvatar({ avatarRef });
+            if (!result.ok || !result.value.mediaType.startsWith('image/'))
+                return null;
+            return `data:${result.value.mediaType};base64,${result.value.bytesBase64}`;
+        },
+    });
     ctx.effect(() => () => {
         navigation.dispose();
         drafts.dispose();
+        humanIdentity.dispose();
         void disposeNavigation();
         void disposeDrafts();
     }, 'agent-team: navigation service');
     // The one restore owner: leaving an embedded Member Session view must
-    // rebind the underlying selection, or the departed Member session stays the
-    // workspace service's `mainView` retention into the next Member entry's
-    // return-target capture. Takeover is conditional — only when the selection
-    // still IS the departed Member session — so a selection someone else made
-    // in the meantime survives. A dead return target keeps the departed
-    // selection: 0.1.7 exposes no public clear, and the retention is inert
-    // behind the Team seat until the next open.
+    // rebind the underlying current session, or the stale Member current later
+    // masks to undefined when the Host disposes that session (rollover) and
+    // the conversation seat remounts. Takeover is conditional — only when the
+    // current still IS the departed Member session — so a selection someone
+    // else made in the meantime survives. A dead return target clears instead
+    // of opening an unknown id.
     ctx.effect(() => {
         let previous = navigation.getSnapshot();
         const restore = () => {
@@ -162,10 +170,13 @@ function applyUi(ctx) {
             previous = snapshot;
             if (departed === undefined || snapshot.memberSessionId !== undefined)
                 return;
-            if (currentMainSessionId(ctx) !== departed)
+            const sessions = ctx.sessions;
+            if (sessions.list.getSnapshot().current !== departed)
                 return;
-            if (returnTo !== undefined && ctx.sessions.list.getSnapshot().byId[returnTo] !== undefined)
-                ctx.uiWorkspace.openSession(returnTo);
+            if (returnTo !== undefined && sessions.list.getSnapshot().byId[returnTo] !== undefined)
+                sessions.open(returnTo);
+            else
+                sessions.clear();
         };
         const unsubscribe = navigation.subscribe(restore);
         return () => {
@@ -202,7 +213,7 @@ function applyUi(ctx) {
             navigation,
             ...navigation.actions(),
             // The footer is the only surface that leaves Team mode; closing the
-            // embedded Member Session view rebinds the underlying selection through
+            // embedded Member Session view rebinds the underlying current through
             // the same root-scope restore owner, so there is exactly one restore
             // path and no double open.
             leaveTeam: () => {
@@ -211,9 +222,69 @@ function applyUi(ctx) {
             },
         }),
     }, TeamFooterAction));
-    registerModeShadow(ctx, navigation, changes, reads, drafts, 'sidebar.workspaces', TeamWorkspaceBrowser);
-    registerModeShadow(ctx, navigation, changes, reads, drafts, 'main', TeamConversation, undefined, 'conversation');
-    registerModeShadow(ctx, navigation, changes, reads, drafts, 'sidebar.settings', TeamMembersAction, () => ({ loadMemberGroups }));
+    registerModeShadow(ctx, navigation, changes, reads, drafts, humanIdentity, 'sidebar.workspaces', TeamWorkspaceBrowser);
+    registerModeShadow(ctx, navigation, changes, reads, drafts, humanIdentity, 'main', TeamConversation, undefined, 'conversation');
+    registerModeShadow(ctx, navigation, changes, reads, drafts, humanIdentity, 'sidebar.settings', TeamMembersAction, () => ({ loadMemberGroups }));
+    // The Human profile page: one settings section over the `agent-team-human`
+    // namespace, ordered between General (0) and Models (10) so identity sits
+    // near the top. Writes go through the settings controller, which answers
+    // with the Host's own rejection reason (a name collides, an empty one), and
+    // the shared identity re-reads afterwards, so a rename lands in the timeline
+    // and the member refs at the same moment the page shows it.
+    ctx.slots.inject('settings.section', () => ctx.slots.register({
+        name: 'settings.section',
+        id: 'team-human',
+        order: 5,
+        label: () => ctx.locale.bind(NS)('humanSettingsNav'),
+        locale: NS,
+        inject: () => ({
+            identity: humanIdentity,
+            saveName: async (name) => {
+                const settings = settingsTransport;
+                if (settings === undefined)
+                    return 'the settings service is unavailable';
+                const saved = await settings.update(HUMAN_PROFILE_NAMESPACE, { name }, undefined);
+                if (!saved.ok)
+                    return saved.error.message;
+                await humanIdentity.refresh();
+                return undefined;
+            },
+            uploadAvatar: async (file) => {
+                const put = await ctx.remote.agentTeam.putHumanAvatar({
+                    name: file.name,
+                    ...(file.type === '' ? {} : { mediaType: file.type }),
+                    bytesBase64: bytesToBase64(new Uint8Array(await file.arrayBuffer())),
+                });
+                if (!put.ok)
+                    return put.error.message;
+                const settings = settingsTransport;
+                if (settings === undefined)
+                    return 'the settings service is unavailable';
+                const saved = await settings.update(HUMAN_PROFILE_NAMESPACE, { avatarRef: put.value.avatarRef }, undefined);
+                if (!saved.ok)
+                    return saved.error.message;
+                await humanIdentity.refresh();
+                return undefined;
+            },
+            removeAvatar: async () => {
+                const { avatarRef } = humanIdentity.getSnapshot();
+                if (avatarRef === undefined)
+                    return undefined;
+                const settings = settingsTransport;
+                if (settings === undefined)
+                    return 'the settings service is unavailable';
+                // Bytes first, then the reference: a failed clear leaves a readable
+                // avatar instead of a reference to bytes nobody can load. Clearing one
+                // field is a path op — a merge patch cannot express removal.
+                await ctx.remote.agentTeam.removeHumanAvatar({ avatarRef });
+                const cleared = await settings.mutate(HUMAN_PROFILE_NAMESPACE, [{ op: 'unset', path: ['avatarRef'] }], undefined);
+                if (!cleared.ok)
+                    return cleared.error.message;
+                await humanIdentity.refresh();
+                return undefined;
+            },
+        }),
+    }, HumanSettingsSection));
 }
 export async function apply(ctx) {
     const disposeRemote = await ctx.remote.$mount(agentTeamRemote);

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

@@ -111,6 +111,28 @@ export declare const zh: {
     readonly timelineLabel: "消息时间线";
     readonly taskClosedNotice: "任务已关闭，重新打开后可继续讨论";
     readonly human: "Human";
+    readonly humanSettingsNav: "我的资料";
+    readonly humanSettingsTitle: "我的资料";
+    readonly humanSettingsIntro: "这是 Agent Team 的资料页：名字用在 Team 的消息与成员列表里，头像出现在你发出的消息旁。";
+    readonly humanSettingsName: "名字";
+    readonly humanSettingsNameHint: "Agents 用这个名字 @ 到你；改名只对之后的消息生效。";
+    readonly humanSettingsNameEmpty: "名字不能为空。";
+    readonly humanSettingsNameFailed: "名字没保存上：{message}";
+    readonly humanSettingsAvatar: "头像";
+    readonly humanSettingsAvatarHint: "只收图片，最大 10MB；移除或损坏时回退为默认头像。";
+    readonly humanSettingsSave: "保存";
+    readonly humanSettingsSaving: "正在保存…";
+    readonly humanSettingsUpload: "上传头像";
+    readonly humanSettingsUploading: "正在上传…";
+    readonly humanSettingsReplace: "更换头像";
+    readonly humanSettingsRemoveAvatar: "移除头像";
+    readonly humanSettingsAvatarNotImage: "只收图片文件。";
+    readonly humanSettingsAvatarTooLarge: "图片不能超过 10MB。";
+    readonly humanSettingsAvatarFailed: "头像没能保存：{message}";
+    readonly humanSettingsLoading: "正在载入资料…";
+    readonly humanSettingsUnavailable: "资料读不出来：{message}";
+    readonly humanSettingsVersion: "版本 {version}";
+    readonly humanSettingsUpdateAvailable: "有新版本 {version}，去查看发布说明";
     readonly taskStatusTodo: "待处理";
     readonly taskStatusInProgress: "进行中";
     readonly taskStatusInReview: "待验收";
@@ -123,6 +145,8 @@ export declare const zh: {
     readonly openTaskUnread: "打开 Task #{number}（{count} 条新动态）";
     readonly openThreadUnread: "打开讨论（{count} 条新动态）";
     readonly threadLabel: "讨论";
+    readonly channelLabel: "频道 · {name}";
+    readonly memberLabel: "成员 · @{name}";
     readonly recentActivity: "最近活动 {time}";
     readonly replyAction: "回复";
     readonly claimers: "由 {names} 处理";
@@ -147,7 +171,18 @@ export declare const zh: {
     readonly autoReadIncomplete: "仍有未读更新未能自动读取";
     readonly olderHistory: "更早历史";
     readonly runtimeRisk: "当前运行风险";
-    readonly runtimeRiskDetail: "@{member} 当前不可用：{diagnostic}";
+    readonly riskClassSessionRefused: "会话被拒绝";
+    readonly riskClassSessionUnreadable: "会话不可读";
+    readonly riskClassPresetComposition: "预设装配失败";
+    readonly riskClassRollover: "上下文交接中";
+    readonly riskClassRuntime: "运行时故障";
+    readonly riskClassActivation: "激活失败";
+    readonly riskSessionRefused: "{member} 当前不可用";
+    readonly riskSessionUnreadable: "{member} 的会话无法读取";
+    readonly riskPresetComposition: "{member} 的预设无法装配";
+    readonly riskRollover: "{member} 正在交接上下文";
+    readonly riskRuntime: "{member} 遇到运行时故障";
+    readonly riskActivation: "{member} 激活失败";
     readonly acceptTask: "验收";
     readonly closeTask: "关闭任务";
     readonly reopenTask: "重新打开";
@@ -288,6 +323,28 @@ export declare const en: {
     readonly timelineLabel: "Message timeline";
     readonly taskClosedNotice: "This task is closed; reopen it to continue the discussion";
     readonly human: "Human";
+    readonly humanSettingsNav: "Profile";
+    readonly humanSettingsTitle: "Profile";
+    readonly humanSettingsIntro: "This is your Agent Team profile: the name applies to Team messages and member lists, and the avatar appears beside your messages.";
+    readonly humanSettingsName: "Name";
+    readonly humanSettingsNameHint: "Agents @ you by this name; a rename applies to later messages only.";
+    readonly humanSettingsNameEmpty: "A name is required.";
+    readonly humanSettingsNameFailed: "The name was not saved: {message}";
+    readonly humanSettingsAvatar: "Avatar";
+    readonly humanSettingsAvatarHint: "Images only, up to 10MB; removing it — or unreadable bytes — falls back to the default avatar.";
+    readonly humanSettingsSave: "Save";
+    readonly humanSettingsSaving: "Saving…";
+    readonly humanSettingsUpload: "Upload avatar";
+    readonly humanSettingsUploading: "Uploading…";
+    readonly humanSettingsReplace: "Replace avatar";
+    readonly humanSettingsRemoveAvatar: "Remove avatar";
+    readonly humanSettingsAvatarNotImage: "Images only.";
+    readonly humanSettingsAvatarTooLarge: "The image must be 10MB or smaller.";
+    readonly humanSettingsAvatarFailed: "The avatar was not saved: {message}";
+    readonly humanSettingsLoading: "Loading profile…";
+    readonly humanSettingsUnavailable: "The profile could not be read: {message}";
+    readonly humanSettingsVersion: "Version {version}";
+    readonly humanSettingsUpdateAvailable: "New version {version} available — see the release notes";
     readonly taskStatusTodo: "To do";
     readonly taskStatusInProgress: "In progress";
     readonly taskStatusInReview: "In review";
@@ -300,6 +357,8 @@ export declare const en: {
     readonly openTaskUnread: "Open Task #{number} ({count} new updates)";
     readonly openThreadUnread: "Open thread ({count} new updates)";
     readonly threadLabel: "Thread";
+    readonly channelLabel: "Channel · {name}";
+    readonly memberLabel: "Member · @{name}";
     readonly recentActivity: "Last activity {time}";
     readonly replyAction: "Reply";
     readonly claimers: "Handled by {names}";
@@ -324,7 +383,18 @@ export declare const en: {
     readonly autoReadIncomplete: "Some unread updates could not be read automatically";
     readonly olderHistory: "Older history";
     readonly runtimeRisk: "Current runtime risk";
-    readonly runtimeRiskDetail: "@{member} is unavailable: {diagnostic}";
+    readonly riskClassSessionRefused: "Session refused";
+    readonly riskClassSessionUnreadable: "Session unreadable";
+    readonly riskClassPresetComposition: "Preset composition failed";
+    readonly riskClassRollover: "Context rollover";
+    readonly riskClassRuntime: "Runtime failure";
+    readonly riskClassActivation: "Activation failed";
+    readonly riskSessionRefused: "{member} is unavailable";
+    readonly riskSessionUnreadable: "{member} has an unreadable Session";
+    readonly riskPresetComposition: "{member} has an uncomposable preset";
+    readonly riskRollover: "{member} is rolling over its context";
+    readonly riskRuntime: "{member} hit a runtime failure";
+    readonly riskActivation: "{member} failed to activate";
     readonly acceptTask: "Accept";
     readonly closeTask: "Close task";
     readonly reopenTask: "Reopen";

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

@@ -1 +1 @@
-{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgLL,CAAA;AAEV,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgLL,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAA"}
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuNL,CAAA;AAEV,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqNL,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAA"}

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

@@ -111,6 +111,28 @@ export const zh = {
     timelineLabel: '消息时间线',
     taskClosedNotice: '任务已关闭，重新打开后可继续讨论',
     human: 'Human',
+    humanSettingsNav: '我的资料',
+    humanSettingsTitle: '我的资料',
+    humanSettingsIntro: '这是 Agent Team 的资料页：名字用在 Team 的消息与成员列表里，头像出现在你发出的消息旁。',
+    humanSettingsName: '名字',
+    humanSettingsNameHint: 'Agents 用这个名字 @ 到你；改名只对之后的消息生效。',
+    humanSettingsNameEmpty: '名字不能为空。',
+    humanSettingsNameFailed: '名字没保存上：{message}',
+    humanSettingsAvatar: '头像',
+    humanSettingsAvatarHint: '只收图片，最大 10MB；移除或损坏时回退为默认头像。',
+    humanSettingsSave: '保存',
+    humanSettingsSaving: '正在保存…',
+    humanSettingsUpload: '上传头像',
+    humanSettingsUploading: '正在上传…',
+    humanSettingsReplace: '更换头像',
+    humanSettingsRemoveAvatar: '移除头像',
+    humanSettingsAvatarNotImage: '只收图片文件。',
+    humanSettingsAvatarTooLarge: '图片不能超过 10MB。',
+    humanSettingsAvatarFailed: '头像没能保存：{message}',
+    humanSettingsLoading: '正在载入资料…',
+    humanSettingsUnavailable: '资料读不出来：{message}',
+    humanSettingsVersion: '版本 {version}',
+    humanSettingsUpdateAvailable: '有新版本 {version}，去查看发布说明',
     taskStatusTodo: '待处理',
     taskStatusInProgress: '进行中',
     taskStatusInReview: '待验收',
@@ -123,6 +145,8 @@ export const zh = {
     openTaskUnread: '打开 Task #{number}（{count} 条新动态）',
     openThreadUnread: '打开讨论（{count} 条新动态）',
     threadLabel: '讨论',
+    channelLabel: '频道 · {name}',
+    memberLabel: '成员 · @{name}',
     recentActivity: '最近活动 {time}',
     replyAction: '回复',
     claimers: '由 {names} 处理',
@@ -147,7 +171,22 @@ export const zh = {
     autoReadIncomplete: '仍有未读更新未能自动读取',
     olderHistory: '更早历史',
     runtimeRisk: '当前运行风险',
-    runtimeRiskDetail: '@{member} 当前不可用：{diagnostic}',
+    // The diagnostic's structured class is the localizable axis: it names what
+    // kind of problem this is, while the Host detail stays English and moves to
+    // the row's title. One label names the class, one sentence states it of the
+    // Member.
+    riskClassSessionRefused: '会话被拒绝',
+    riskClassSessionUnreadable: '会话不可读',
+    riskClassPresetComposition: '预设装配失败',
+    riskClassRollover: '上下文交接中',
+    riskClassRuntime: '运行时故障',
+    riskClassActivation: '激活失败',
+    riskSessionRefused: '{member} 当前不可用',
+    riskSessionUnreadable: '{member} 的会话无法读取',
+    riskPresetComposition: '{member} 的预设无法装配',
+    riskRollover: '{member} 正在交接上下文',
+    riskRuntime: '{member} 遇到运行时故障',
+    riskActivation: '{member} 激活失败',
     acceptTask: '验收',
     closeTask: '关闭任务',
     reopenTask: '重新打开',
@@ -288,6 +327,28 @@ export const en = {
     timelineLabel: 'Message timeline',
     taskClosedNotice: 'This task is closed; reopen it to continue the discussion',
     human: 'Human',
+    humanSettingsNav: 'Profile',
+    humanSettingsTitle: 'Profile',
+    humanSettingsIntro: 'This is your Agent Team profile: the name applies to Team messages and member lists, and the avatar appears beside your messages.',
+    humanSettingsName: 'Name',
+    humanSettingsNameHint: 'Agents @ you by this name; a rename applies to later messages only.',
+    humanSettingsNameEmpty: 'A name is required.',
+    humanSettingsNameFailed: 'The name was not saved: {message}',
+    humanSettingsAvatar: 'Avatar',
+    humanSettingsAvatarHint: 'Images only, up to 10MB; removing it — or unreadable bytes — falls back to the default avatar.',
+    humanSettingsSave: 'Save',
+    humanSettingsSaving: 'Saving…',
+    humanSettingsUpload: 'Upload avatar',
+    humanSettingsUploading: 'Uploading…',
+    humanSettingsReplace: 'Replace avatar',
+    humanSettingsRemoveAvatar: 'Remove avatar',
+    humanSettingsAvatarNotImage: 'Images only.',
+    humanSettingsAvatarTooLarge: 'The image must be 10MB or smaller.',
+    humanSettingsAvatarFailed: 'The avatar was not saved: {message}',
+    humanSettingsLoading: 'Loading profile…',
+    humanSettingsUnavailable: 'The profile could not be read: {message}',
+    humanSettingsVersion: 'Version {version}',
+    humanSettingsUpdateAvailable: 'New version {version} available — see the release notes',
     taskStatusTodo: 'To do',
     taskStatusInProgress: 'In progress',
     taskStatusInReview: 'In review',
@@ -300,6 +361,8 @@ export const en = {
     openTaskUnread: 'Open Task #{number} ({count} new updates)',
     openThreadUnread: 'Open thread ({count} new updates)',
     threadLabel: 'Thread',
+    channelLabel: 'Channel · {name}',
+    memberLabel: 'Member · @{name}',
     recentActivity: 'Last activity {time}',
     replyAction: 'Reply',
     claimers: 'Handled by {names}',
@@ -324,7 +387,20 @@ export const en = {
     autoReadIncomplete: 'Some unread updates could not be read automatically',
     olderHistory: 'Older history',
     runtimeRisk: 'Current runtime risk',
-    runtimeRiskDetail: '@{member} is unavailable: {diagnostic}',
+    // See the zh block: the structured class names the kind of problem, the
+    // sentence states it of the Member, and the Host detail rides the title.
+    riskClassSessionRefused: 'Session refused',
+    riskClassSessionUnreadable: 'Session unreadable',
+    riskClassPresetComposition: 'Preset composition failed',
+    riskClassRollover: 'Context rollover',
+    riskClassRuntime: 'Runtime failure',
+    riskClassActivation: 'Activation failed',
+    riskSessionRefused: '{member} is unavailable',
+    riskSessionUnreadable: '{member} has an unreadable Session',
+    riskPresetComposition: '{member} has an uncomposable preset',
+    riskRollover: '{member} is rolling over its context',
+    riskRuntime: '{member} hit a runtime failure',
+    riskActivation: '{member} failed to activate',
     acceptTask: 'Accept',
     closeTask: 'Close task',
     reopenTask: 'Reopen',

package/packages/client-agent-team/lib/types/client/multi-menu-field.js

@@ -4,7 +4,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 // without closing the list so several entries can be picked in one pass; the
 // capped card scrolls internally through long catalogs.
 import { useState } from 'react';
-import { IconChevronDownOutlineRegular, Menu } from '@deepseek-ai/dsh-client-ui-primitives';
+import { IconChevronDownOutline14, Menu } from '@deepseek-ai/dsh-client-ui-primitives';
 import createCss from './create.module.css';
 import css from './sidebar.module.css';
 /**
@@ -26,5 +26,5 @@ export function MultiMenuField({ label, options, selected, onToggle, disabled =
         ...(option.disabled === true ? { disabled: true } : {}),
         ...(option.icon === undefined ? {} : { icon: option.icon }),
     }));
-    return (_jsxs("div", { className: createCss.field, children: [_jsx("span", { children: label }), options.length === 0 && emptyText !== undefined ? _jsx("small", { className: css.editHint, children: emptyText }) : (_jsx(Menu, { open: open, portal: true, className: createCss.menuCap, items: items, selectedIds: selected, onSelect: id => { onToggle(id); }, onClose: () => { setOpen(false); }, anchor: _jsxs("button", { type: "button", className: createCss.selectTrigger, "aria-label": label, "aria-haspopup": "menu", "aria-expanded": open, disabled: disabled, onClick: () => { setOpen(value => !value); }, children: [_jsx("span", { className: createCss.selectValue, children: selected.length === 0 ? triggerEmptyLabel : formatCount(selected.length) }), _jsx("span", { className: `${createCss.chevron} ${open ? createCss.chevronOpen : ''}`, "aria-hidden": true, children: _jsx(IconChevronDownOutlineRegular, {}) })] }) }))] }));
+    return (_jsxs("div", { className: createCss.field, children: [_jsx("span", { children: label }), options.length === 0 && emptyText !== undefined ? _jsx("small", { className: css.editHint, children: emptyText }) : (_jsx(Menu, { open: open, portal: true, className: createCss.menuCap, items: items, selectedIds: selected, onSelect: id => { onToggle(id); }, onClose: () => { setOpen(false); }, anchor: _jsxs("button", { type: "button", className: createCss.selectTrigger, "aria-label": label, "aria-haspopup": "menu", "aria-expanded": open, disabled: disabled, onClick: () => { setOpen(value => !value); }, children: [_jsx("span", { className: createCss.selectValue, children: selected.length === 0 ? triggerEmptyLabel : formatCount(selected.length) }), _jsx("span", { className: `${createCss.chevron} ${open ? createCss.chevronOpen : ''}`, "aria-hidden": true, children: _jsx(IconChevronDownOutline14, {}) })] }) }))] }));
 }

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

@@ -0,0 +1,71 @@
+import type { SessionId } from '@deepseek-ai/dsh-session';
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { AgentTeamChannel, AgentTeamChannelRef, AgentTeamClientMemberStatus, AgentTeamMemberId, AgentTeamResolveTaskRefsRequest, AgentTeamResolveTaskRefsResult, AgentTeamResolveThreadRefsRequest, AgentTeamResolveThreadRefsResult, AgentTeamTaskRef, AgentTeamThreadRef } from '@wowyuarm/dsh-agent-team/types';
+/** Navigation facts for one branded Task ref, resolved once per session. */
+export interface ResolvedTaskRef {
+    readonly taskRef: AgentTeamTaskRef;
+    readonly channelRef: AgentTeamChannelRef;
+    readonly threadRef: AgentTeamThreadRef;
+    readonly taskNumber: number;
+}
+/** Navigation facts for one branded Thread ref, resolved once per session. */
+export interface ResolvedThreadRef {
+    readonly threadRef: AgentTeamThreadRef;
+    readonly channelRef: AgentTeamChannelRef;
+    readonly taskRef?: AgentTeamTaskRef;
+    readonly taskNumber?: number;
+    /** Opening-line gist distinguishing one Thread chip from another. */
+    readonly title: string;
+}
+/** One roster-resolved Member behind a `member:` chip. */
+export interface ResolvedMemberRef {
+    readonly memberId: AgentTeamMemberId;
+    /** Bare handle without the `@`; the chip renders it. */
+    readonly handle: string;
+    /** Present for agent Members; absent for the Human (no session to open). */
+    readonly sessionId?: SessionId;
+    /** Only active agent Members open a session — mirrors the agent card rule. */
+    readonly openable: boolean;
+}
+/** Compare refs by branded prefix plus hyphen-stripped UUID, so abbreviated spellings line up with their full form. */
+export declare function refKeyOf(ref: string): string;
+/** React binding: re-renders the caller when any Task ref resolution lands. */
+export declare const useResolvedTaskRefVersion: () => number;
+export declare const cachedResolvedTaskRef: (ref: AgentTeamTaskRef) => ResolvedTaskRef | undefined;
+/** Store one Task resolution (click path) and wake every rendered link. */
+export declare const rememberResolvedTaskRef: (entry: ResolvedTaskRef) => void;
+export declare const resolveUnknownTaskRefs: (refs: readonly AgentTeamTaskRef[], lookup: (refs: readonly AgentTeamTaskRef[]) => Promise<readonly ResolvedTaskRef[]>) => Promise<void>;
+/** React binding: re-renders the caller when any Thread ref resolution lands. */
+export declare const useResolvedThreadRefVersion: () => number;
+export declare const cachedResolvedThreadRef: (ref: AgentTeamThreadRef) => ResolvedThreadRef | undefined;
+/** Store one Thread resolution (click path) and wake every rendered link. */
+export declare const rememberResolvedThreadRef: (entry: ResolvedThreadRef) => void;
+export declare const resolveUnknownThreadRefs: (refs: readonly AgentTeamThreadRef[], lookup: (refs: readonly AgentTeamThreadRef[]) => Promise<readonly ResolvedThreadRef[]>) => Promise<void>;
+/**
+ * Click-path Task lookup: remember every resolved entry and hand them back
+ * for immediate navigation (see hostRefLookup for the ordering contract).
+ */
+export declare const hostTaskRefLookup: (resolveTaskRefs: (request: AgentTeamResolveTaskRefsRequest) => Promise<RemoteResult<AgentTeamResolveTaskRefsResult>>, workspaceId: AgentTeamResolveTaskRefsRequest["workspaceId"]) => ((taskRefs: readonly AgentTeamTaskRef[]) => Promise<readonly ResolvedTaskRef[]>);
+/**
+ * Click-path Thread lookup: remember every resolved entry and hand them back
+ * for immediate navigation (see hostRefLookup for the ordering contract).
+ */
+export declare const hostThreadRefLookup: (resolveThreadRefs: (request: AgentTeamResolveThreadRefsRequest) => Promise<RemoteResult<AgentTeamResolveThreadRefsResult>>, workspaceId: AgentTeamResolveThreadRefsRequest["workspaceId"]) => ((threadRefs: readonly AgentTeamThreadRef[]) => Promise<readonly ResolvedThreadRef[]>);
+/** Resolve one Task ref through the Host and jump to its home Channel Thread. */
+export declare const jumpToTaskThread: (resolveTaskRefs: (request: AgentTeamResolveTaskRefsRequest) => Promise<RemoteResult<AgentTeamResolveTaskRefsResult>>, workspaceId: AgentTeamResolveTaskRefsRequest["workspaceId"], taskRef: AgentTeamTaskRef, selectThread: (threadRef: AgentTeamThreadRef, channelRef?: AgentTeamChannelRef, taskRef?: AgentTeamTaskRef, taskNumber?: number) => void) => void;
+/** Resolve one Thread ref through the Host and jump to its home Channel Thread. */
+export declare const jumpToThread: (resolveThreadRefs: (request: AgentTeamResolveThreadRefsRequest) => Promise<RemoteResult<AgentTeamResolveThreadRefsResult>>, workspaceId: AgentTeamResolveThreadRefsRequest["workspaceId"], threadRef: AgentTeamThreadRef, selectThread: (threadRef: AgentTeamThreadRef, channelRef?: AgentTeamChannelRef, taskRef?: AgentTeamTaskRef, taskNumber?: number) => void) => void;
+/**
+ * Display name for one authored channel ref, or undefined when the loaded
+ * roster does not know it — the caller keeps plain text. Archived Channels
+ * never resolve: they are gone from every Team surface, so their refs are
+ * not links either.
+ */
+export declare const rosterChannelName: (channels: readonly AgentTeamChannel[], channelRef: AgentTeamChannelRef) => string | undefined;
+/**
+ * Roster facts for one authored member ref, or undefined when nobody on the
+ * roster answers to it — the caller keeps plain text. The Human resolves to
+ * a handle with no session: informative, never a link.
+ */
+export declare const rosterMember: (members: readonly AgentTeamClientMemberStatus[], humanMemberId: AgentTeamMemberId | undefined, humanHandle: string, memberRef: AgentTeamMemberId) => ResolvedMemberRef | undefined;
+//# sourceMappingURL=refs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../../src/client/refs.ts"],"names":[],"mappings":"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"}