A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.
import { countCards, heldCardKey } from './sources.js'
import { noteClientError } from './diagnostics.js'
// The actions every window that draws the Bot views shares: dialogs and panels (the `ui`
// source), requests to the host, and the notes the transcript keeps. The shell around the
// views adds navigation and its own panels. `after` reads the team again once a request
// is done; `partFor` maps a Bot id, or any part of its chat, to its current part.
export function teamActions({ call, after, partFor, roster, ui, live, cards, heldCards, turnClock, panelFolded }) {
// A memory is a Bot's or a group chat's; both are opened by id.
const memoryOf = id => (roster.getSnapshot().roomsById[id] ? { roomId: id } : { botId: id })
// An action that shows the panel lands the yield with it: when a folded
// panel's explicit opener fires, the column gives way in the same set.
// `view` is the next view, since its minimum decides what fits; a yield already
// given stays.
const yieldTo = (state, view) => state.panelYield === true || panelFolded?.(view) === true
// The panel on a side chat's view, on the chat the strip tab or menu named.
const openSideChat = (sessionId, chatId) => {
ui.set(state => ({ ...state, details: sessionId, view: 'side', side: chatId ?? null, renaming: false, tab: null, panelYield: yieldTo(state, 'side') }))
}
// `id` opens one Bot (page 'bots') or one group chat (page 'groups').
const openSettings = (page = 'general', id = null) => { ui.set(state => ({ ...state, settings: { page, id }, menu: null, palette: null, newChat: null })) }
return {
openNewChat: (mode) => { ui.set(state => ({ ...state, newChat: mode, menu: null, palette: null })) },
openPalette: (query = '') => { ui.set(state => ({ ...state, palette: { query, token: Date.now() }, newChat: null, menu: null })) },
// The token keeps a late exit timer from closing a palette opened again since.
closePalette: (token) => { ui.set(state => (state.palette && (token === undefined || state.palette.token === token) ? { ...state, palette: null } : state)) },
openExchange: (a, b) => { if (a && b) ui.set(state => ({ ...state, exchange: [a, b] })) },
openVoice: (id) => { if (id) ui.set(state => ({ ...state, voice: id, menu: null })) },
closeVoice: () => { ui.set(state => (state.voice ? { ...state, voice: null } : state)) },
toggleDetails: (id, force) => {
ui.set((state) => {
const details = force || state.details !== id || state.view !== 'details' ? id : null
// A folded panel is open but not shown: its opener then means "show it"
// (the column yields it room), not "close it".
if (details === null && panelFolded?.('details') === true) return { ...state, renaming: false, tab: null, details: id, view: 'details', panelYield: true }
return { ...state, renaming: false, tab: null, details, view: 'details' }
})
},
// The open panel follows the main view; a subject with no browser (a group
// chat, an outside Session) settles on the details view. So does one that
// does not own the open side chat.
followPanel: (id) => {
ui.set((state) => {
if (!state.details || state.details === id) return state
const snap = roster.getSnapshot()
const view = state.view === 'browser' && snap.byId[id] === undefined ? 'details'
: state.view === 'side' && !(snap.sideChats?.[snap.byId[id]?.id] ?? []).some(chat => chat?.id === state.side) ? 'details'
: state.view
return { ...state, details: id, view, renaming: false, tab: null }
})
},
showDetails: (id, tab = null) => { ui.set(state => ({ ...state, details: id, view: 'details', renaming: false, tab, panelYield: yieldTo(state, 'details') })) },
// Opening the conversation would move focus to its composer and blur the name field.
renameBot: (id) => { ui.set(state => ({ ...state, details: id, view: 'details', renaming: true, tab: null, panelYield: yieldTo(state, 'details') })) },
openSettings,
// DS Bot's own Models page: the providers DSH serves, their keys and models.
openModels: () => openSettings('models'),
closeSettings: () => { ui.set(state => (state.settings ? { ...state, settings: null } : state)) },
openMemory: (id) => { ui.set(state => ({ ...state, memory: id, menu: null, palette: null })) },
closeMemory: () => { ui.set(state => (state.memory ? { ...state, memory: null } : state)) },
openConnectors: () => { ui.set(state => ({ ...state, settings: { page: 'connectors', id: null }, menu: null, palette: null, newChat: null })) },
setPanelView: (view) => {
if (view !== 'details' && view !== 'browser' && view !== 'side') return
ui.set(state => (state.details && state.view !== view ? { ...state, view, panelYield: yieldTo(state, view) } : state))
},
// A side chat on the panel's own view, opened from the strip, the `···`
// menus or `/side`. Closing the panel keeps the chats; only a tab's × deletes.
openSideChat,
// The roster is pulled before the panel opens on a new chat: a view on a chat
// the roster does not hold yet folds back into details.
newSideChat: async (sessionId) => {
const value = await after(call('side-new', { sessionId }))
openSideChat(sessionId, value?.chatId)
return value
},
sideCall: (name, body) => after(call(name, body)),
askSide: (sessionId, chatId, text) => after(call('side-ask', { sessionId, chatId, text })),
cancelSide: (chatId, entryId) => after(call('side-cancel', { chatId, entryId })),
closeSideChat: (chatId) => {
ui.set(state => (state.details && state.view === 'side' && state.side === chatId ? { ...state, view: 'details', side: null } : state))
return after(call('side-close', { chatId }))
},
closePanel: () => { ui.set(state => (state.details ? { ...state, details: null, view: 'details', renaming: false, tab: null, side: null } : state)) },
quote: (sessionId, text) => ui.set(state => ({ ...state, quote: { sessionId, text, token: Date.now() } })),
clearQuote: token => ui.set(state => (state.quote?.token === token ? { ...state, quote: null } : state)),
setFlags: (id, flags) => after(call('set-flags', { id, ...flags })),
deleteRoom: id => after(call('delete-room', { id })),
openMenu: (menu) => { ui.set(state => ({ ...state, menu, palette: null })) },
closeMenu: () => { ui.set(state => (state.menu ? { ...state, menu: null } : state)) },
closeOverlay: () => { ui.set(state => ({ ...state, newChat: null, exchange: null, details: state.newChat || state.exchange ? state.details : null })) },
createBot: payload => after(call('create-bot', payload)),
// The avatar library: photos the user imported once, kept by the host.
avatarLibrary: (options = {}) => call('avatar-library', options),
importAvatars: items => call('avatar-import', { items }),
deleteAvatar: id => call('avatar-delete', { id }),
createRoom: (members, options = {}) => after(call('create-room', { members, ...options })),
updateBot: (id, patch) => after(call('update-bot', { id, ...patch })),
refreshModels: () => after(call('models')).catch(() => {}),
efforts: ref => call('efforts', { ref }),
// Model providers and their API keys; DSH keeps them, and a key only travels to the host.
providers: () => call('providers'),
setProviderKey: (provider, value) => after(call('provider-key', { provider, value })),
addProvider: body => after(call('provider-add', body)),
providerModels: body => call('provider-models', body),
removeProvider: provider => after(call('provider-remove', { provider })),
// After a failed turn: the Bot answers the user's last unanswered message, which is never sent again.
resume: botId => after(call('resume', { botId })),
folders: () => call('folders'),
folderPick: () => call('folder-pick'),
folderList: path => call('folder-list', { path: path ?? '' }),
setTeamWorkspace: path => after(call('team-workspace', { path })),
deleteBot: id => after(call('delete-bot', { id })),
releasePrivate: id => after(call('private-release', { id })),
duplicateBot: id => after(call('duplicate-bot', { id })),
setPrefs: prefs => after(call('set-prefs', prefs)),
setMain: (id, main = true, options = {}) => after(call('set-main', { id, main, ...options })),
updateRoom: (id, patch) => after(call('update-room', { id, ...patch })),
send: (sessionId, text) => after(call('send', { sessionId: partFor(sessionId), text })),
answerQuestion: (sessionId, questionId, answer) => after(call('answer-question', { sessionId: partFor(sessionId), questionId, answer })),
dismissQuestion: sessionId => after(call('dismiss-question', { sessionId })),
answerView: (sessionId, viewId, action, values) => after(call('view-reply', { sessionId: partFor(sessionId), viewId, action, values })),
dismissView: sessionId => after(call('dismiss-view', { sessionId: partFor(sessionId) })),
deleteBtw: (sessionId, cardId) => after(call('btw-delete', { sessionId, cardId })),
answerApproval: (id, choice) => after(call('approval-answer', { id, choice })),
computerSetEnabled: enabled => after(call('computer-set-enabled', { enabled })),
computerSetLevel: (botId, level) => after(call('computer-set-level', { botId, level })),
computerRevokeApp: (botId, appKey) => after(call('computer-revoke-app', { botId, appKey })),
computerProviderRetry: () => after(call('computer-provider-retry', {})),
computerSystemStatus: () => call('computer-system-status', {}),
computerPermission: permission => call('computer-permission', { permission }),
computerStop: (botId, all = false) => after(call('computer-stop', all ? { all: true } : { botId })),
computerTakeover: botId => after(call('computer-takeover', { botId })),
computerHandback: botId => after(call('computer-handback', { botId })),
computerAllowForeground: botId => call('computer-allow-foreground', { botId }),
computerAppAnswer: (id, answer) => call('computer-app-answer', { id, answer }),
computerHoldAnswer: (botId, { callId, outcome } = {}) => after(call('computer-hold-answer', { botId, ...(callId !== undefined ? { callId } : {}), outcome })),
computerShot: attachmentId => call('computer-shot', { attachmentId }),
computerUserActive: idleSeconds => call('computer-user-active', { idleSeconds }),
stopMemberWork: (roomId, botId) => after(call('stop-member-work', { roomId, botId })),
stopRoomWork: roomId => after(call('stop-room-work', { roomId })),
goalDraft: (roomId, text) => after(call('goal-draft', { roomId, text })),
goalControl: (roomId, goalId, action, stopWork) => after(call('goal-control', { roomId, goalId, action, ...(stopWork ? { stopWork: true } : {}) })),
// The goal island: `goalCompose` holds the room whose draft form is open,
// `goalOpen` the room whose panel is open.
composeGoal: roomId => ui.set(state => ({ ...state, goalCompose: roomId, goalOpen: roomId })),
closeGoalCompose: () => ui.set(state => (state.goalCompose ? { ...state, goalCompose: null } : state)),
toggleGoal: roomId => ui.set(state => ({ ...state, goalOpen: state.goalOpen === roomId ? null : roomId })),
closeGoal: () => ui.set(state => (state.goalOpen ? { ...state, goalOpen: null } : state)),
// Values go out in these requests and never come back in a response.
secretSet: payload => after(call('secret-set', payload)),
secretAllow: requestId => after(call('secret-allow', { requestId })),
secretCancel: requestId => after(call('secret-cancel', { requestId })),
secretUpdate: (name, { scope, purpose } = {}) => after(call('secret-update', { name, scope, purpose })),
secretDelete: name => after(call('secret-delete', { name })),
connectorConnect: (id, payload = {}) => after(call('connector-connect', { id, ...payload })),
connectorDisconnect: id => after(call('connector-disconnect', { id })),
connectorRetry: id => after(call('connector-retry', { id })),
connectorSignInCode: (id, input) => after(call('connector-sign-in-code', { id, input })),
connectorCancel: id => after(call('connector-cancel', { id })),
connectorClient: (id, clientId, clientSecret) => after(call('connector-client', { id, clientId, clientSecret })),
connectorSet: (id, patch) => after(call('connector-set', { id, ...patch })),
connectorAdd: spec => after(call('connector-add', spec)),
connectorRemove: id => after(call('connector-remove', { id })),
connectorImportScan: () => call('connector-import-scan', {}),
connectorImport: items => after(call('connector-import', { items })),
connectorRequestCancel: requestId => after(call('connector-request-cancel', { requestId })),
mailAccountAdd: payload => after(call('mail-account-add', payload)),
mailAccountRemove: id => after(call('mail-account-remove', { id })),
mailRuleSet: payload => after(call('mail-rule-set', payload)),
mailSendAnswer: (requestId, choice, extra = {}) => after(call('mail-send-answer', { requestId, choice, ...extra })),
mailSignInCode: payload => after(call('mail-sign-in-code', payload)),
imAdd: payload => after(call('im-add', payload)),
imUpdate: (id, patch) => after(call('im-update', { id, ...patch })),
imRemove: id => after(call('im-remove', { id })),
imPair: (id, senderId, allow) => after(call('im-pair', { id, senderId, allow })),
imUnpair: (id, senderId) => after(call('im-unpair', { id, senderId })),
imChat: (id, body) => after(call('im-chat', { id, ...body })),
imRetry: id => after(call('im-retry', { id })),
imLoginStart: payload => call('im-login-start', payload),
imLoginWait: payload => call('im-login-wait', payload),
saveCapability: capability => after(call('capability-save', capability)),
deleteCapability: name => after(call('capability-delete', { name })),
approveCapability: name => after(call('capability-approve', { name })),
setBotCapability: (botId, name, attached) => after(call('bot-capability', { botId, name, attached })),
schedules: () => call('schedules'),
scheduleCreate: task => call('schedule-create', task),
scheduleDelete: (sessionId, id) => call('schedule-delete', { sessionId, id }),
exchange: (a, b) => call('exchange', { a, b }).catch(() => []),
exchangeText: id => call('exchange-text', { id }).catch(() => undefined),
fileText: file => call('file-text', { file }).catch(() => undefined),
roomProgress: roomId => call('room-progress', { roomId }).catch(() => []),
earlier: (sessionId, cursor) => call('earlier', { sessionId, cursor: cursor ?? null }),
// Hours come back in this browser's time zone, so days start at local midnight.
usage: () => call('usage', { timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone }),
// `summarize` starts a summary when the entries changed; `regenerate` always does.
memoryView: (id, flags = {}) => call('memory-view', { ...memoryOf(id), ...flags }),
memoryAsk: (id, text) => call('memory-ask', { ...memoryOf(id), text }),
memoryForget: (id, entry) => call('memory-forget', { ...memoryOf(id), scope: entry.scope, topic: entry.topic, text: entry.text }),
memoryHistory: (id, before) => call('memory-history', { ...memoryOf(id), ...(before === undefined ? {} : { before }) }),
memoryRestore: (id, rowId) => call('memory-restore', { ...memoryOf(id), id: rowId }),
diagnostics: payload => call('diagnostics', payload),
diagnosticsLog: () => call('diagnostics-log'),
diagnosticsClear: () => call('diagnostics-clear'),
repoStars: () => call('repo-stars'),
// A failed action away from any form (a menu, the palette) shows as a toast.
reportError: (error, where = 'action') => {
noteClientError(where, error)
ui.set(state => ({ ...state, toast: { text: error?.message ?? String(error), token: Date.now() } }))
},
dismissToast: token => ui.set(state => (state.toast && (token === undefined || state.toast.token === token) ? { ...state, toast: null } : state)),
noteTurnTime: (sessionId, turn, key, time) => {
if (sessionId === undefined || !Number.isFinite(turn) || !Number.isFinite(time)) return
turnClock.set((state) => {
const turns = state[sessionId] ?? {}
const entry = turns[turn] ?? {}
const next = key === 'first' && entry.first !== undefined ? Math.min(entry.first, time) : time
if (entry[key] === next) return state
return { ...state, [sessionId]: { ...turns, [turn]: { ...entry, [key]: next } } }
})
},
noteTurnPeer: (sessionId, turn, peerId) => {
if (sessionId === undefined || !Number.isFinite(turn)) return
turnClock.set((state) => {
const turns = state[sessionId] ?? {}
const entry = turns[turn] ?? {}
if (entry.peer === peerId) return state
return { ...state, [sessionId]: { ...turns, [turn]: { ...entry, peer: peerId } } }
})
},
noteLive: (sessionId, id, entry) => {
if (sessionId === undefined) return
live.set((state) => {
const own = state[sessionId] ?? {}
const prev = own[id]
if (entry === null ? prev === undefined : prev !== undefined && JSON.stringify({ ...prev, at: 0 }) === JSON.stringify({ ...entry, at: 0 })) return state
const next = { ...own }
if (entry === null) delete next[id]
else next[id] = { ...entry, at: prev?.at ?? Date.now() }
return { ...state, [sessionId]: next }
})
},
noteCards: (sessionId, callIds, delta) => {
if (sessionId !== undefined) cards.set(state => countCards(state, sessionId, callIds, delta))
},
noteHeldCard: (sessionId, kind, requestId, delta) => {
if (sessionId !== undefined) heldCards.set(state => countCards(state, sessionId, [heldCardKey(kind, requestId)], delta))
},
clearLive: sessionId => live.set((state) => {
if (!state[sessionId]) return state
const next = { ...state }
delete next[sessionId]
return next
}),
}
}