Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander turns your goal into to-dos and coordinates 16 built-in specialist agents plus Claude Code, Codex, OpenCode, OpenClaw and Hermes, with projects, scheduled automations and connectors. Free app for macOS & Windows; built-in models or your own keys.
JavaScript agent-collaborationagent-harnessagent-orchestrationagent-teamagent-workflowai-assistantai-automationai-employeeai-productivityai-teamai-workflowautonomous-agentsclaude-code-guiclaude-coworkdesktop-agentlocal-firstmulti-agentmulti-agent-systemself-evolving-agentstask-automation
// ─── Sidebar Projects section ────────────────────────────────────────────
// Renders the "Projects" group above the conversation list. Each project
// row supports collapse/expand, a ⋯ menu (invite guide / rename / delete), and inline
// rename. Conversations with a `project_id` field are nested under their
// project; conversations without `project_id` stay in the existing
// "Conversations" section (rendered by `conversation.js::renderConversationList`).
//
// Storage layout (cloud-synced): `<uid>/cloud/projects/<pid>/{project.json,
// bindings.json}` — no aggregate index, list = directory scan. See
// `features/projects.ts`. The renderer never persists projects state directly —
// every mutation goes through `projects.*` IPC channels.
//
// Depends on: ipc-shim.js (apiFetch), conversation.js (escapeHtml /
// renderConversationList / _refreshAllConvBadges), dialogs.js (uiConfirmDanger).
const _projectsLog = createLogger('projects');
function _projectsLogFailure(action, data) {
_projectsLog.warn('project operation failed', { action, ...(data || {}) });
}
const _PROJECTS_STABLE_ERROR_CODES = new Set([
'name_dup',
'name_empty',
'has_running_conv',
'recycle_archive_failed',
'cascade_failed',
'cascade_recovery_incomplete',
'not_found',
]);
function _projectsFailureCode(errLike, fallback) {
const rawMessage = String((errLike && (errLike.error || errLike.message)) || '').trim();
if (_PROJECTS_STABLE_ERROR_CODES.has(rawMessage)) return rawMessage;
const rawCode = errLike && (errLike.error_code || errLike.code);
if (typeof rawCode === 'string' && /^E_[A-Z0-9_]{1,64}$/.test(rawCode) && rawCode !== 'E_UNKNOWN') {
return rawCode;
}
return fallback;
}
function _projectsFailureType(errLike, code) {
const text = `${code || ''} ${String((errLike && (errLike.error || errLike.message)) || '')}`.toLowerCase();
if (/name_dup|name_empty|invalid/.test(text)) return 'validation';
if (/has_running_conv|conflict|target_exists/.test(text)) return 'conflict';
if (/recycle_archive_failed|storage|disk|enospc/.test(text)) return 'storage';
if (/timeout|timed out/.test(text)) return 'timeout';
if (/network|fetch failed|econnreset|econnrefused|eai_again|enotfound/.test(text)) return 'network';
if (/auth|not_logged_in|unauthor/.test(text)) return 'auth';
return 'exception';
}
function _projectsFailureDetail(errLike, fallback) {
const errorCode = _projectsFailureCode(errLike, fallback);
return { error_code: errorCode, error_type: _projectsFailureType(errLike, errorCode) };
}
function _projectUiIconHtml(name, className) {
if (typeof window !== 'undefined' && typeof window.uiIconHtml === 'function') {
return window.uiIconHtml(name, className);
}
return '';
}
// Live cache of projects fetched from the backend. Mirrors `_agentsCache` /
// `_skillsCache` patterns. `null` = not yet fetched.
let _projectsCache = null;
let _projectsLoadRequestId = 0;
// Navigation is eager; the detail module may still be loading or showing the
// previous project. Keep sidebar selection independent of its loaded data.
let _projectSidebarPid = '';
let _projectSidebarRevealPid = '';
// Per-project expand/collapse state, persisted across sessions so the user's
// layout sticks. Default: collapsed.
const _PROJECTS_EXPANDED_KEY = 'sidebar.projectExpanded';
let _projectsExpanded = {};
function _loadProjectsExpanded() {
try {
const raw = localStorage.getItem(_PROJECTS_EXPANDED_KEY);
if (raw) _projectsExpanded = JSON.parse(raw) || {};
} catch (_) { _projectsExpanded = {}; }
}
function _saveProjectsExpanded() {
try { localStorage.setItem(_PROJECTS_EXPANDED_KEY, JSON.stringify(_projectsExpanded)); } catch (_) {}
}
_loadProjectsExpanded();
// In-flight inline-create / inline-rename state. Only one editing row at a
// time across the whole sidebar.
let _projectsInlineCreate = false;
let _projectsInlineCreateDraft = '';
let _projectsInlineCreateError = '';
let _projectsInlineCreateSubmitting = false;
let _projectsInlineCreateRequestId = 0;
let _projectsInlineCreateRerendering = false;
let _projectsInlineRenamePid = null;
let _projectsInlineRenameOriginal = '';
let _projectsInlineRenameDraft = '';
let _projectsInlineRenameError = '';
let _projectsInlineRenameSubmitting = false;
let _projectsInlineRenameRequestId = 0;
let _projectsInlineRenameRerendering = false;
// ── Public API: cache + render ──────────────────────────────────────────
async function loadProjects(forceRefresh, requireFresh = false) {
if (_projectsCache && !forceRefresh) {
renderProjectsSection();
return _projectsCache;
}
const requestId = ++_projectsLoadRequestId;
const previousProjects = Array.isArray(_projectsCache) ? _projectsCache : [];
let refreshed = false;
try {
const res = await window.orkas.invoke('projects.list', {});
if (requestId !== _projectsLoadRequestId) {
return requireFresh ? null : Array.isArray(_projectsCache) ? _projectsCache : previousProjects;
}
if (res && res.ok && Array.isArray(res.projects)) {
_projectsCache = res.projects;
refreshed = true;
} else {
_projectsLog.warn('load projects rejected', { error: res && res.error });
_projectsCache = previousProjects;
}
} catch (err) {
if (requestId !== _projectsLoadRequestId) {
return requireFresh ? null : Array.isArray(_projectsCache) ? _projectsCache : previousProjects;
}
_projectsLog.warn('load projects failed', err);
_projectsCache = previousProjects;
}
renderProjectsSection();
if (typeof window.refreshAutoProjectGroups === 'function') window.refreshAutoProjectGroups();
return requireFresh && !refreshed ? null : _projectsCache;
}
/** One-shot: ensure the project owning the active cid is expanded so the
* user can see their open conversation. **Does not run on every render**
* — that would defeat manual collapse. Call this from boot + setView
* ('conversation', cid) only. Manual user collapse always wins on the
* next render. */
function autoExpandActiveConvProject() {
if (!currentCid || !Array.isArray(conversations)) return;
const owner = conversations.find((c) => c && c.conversation_id === currentCid);
const pid = owner && owner.project_id;
if (!pid) return;
if (_projectsExpanded[pid]) return;
_projectsExpanded[pid] = true;
_saveProjectsExpanded();
renderProjectsSection();
}
/** Map cid → projectId from the live `conversations` global, used by
* `conversation.js::renderConversationList` to filter unprojected items
* and by us to group projected items by project. */
function _convsByProject() {
const byPid = new Map();
if (!Array.isArray(conversations)) return byPid;
for (const c of conversations) {
const pid = c && c.project_id;
if (!pid) continue;
if (!byPid.has(pid)) byPid.set(pid, []);
byPid.get(pid).push(c);
}
return byPid;
}
/** Project list at the top of the sidebar. Auto-expands the project that
* owns the active conversation so the live row is visible. */
function renderProjectsSection() {
if (currentView !== 'project') _projectSidebarRevealPid = '';
const container = document.getElementById('projects-list');
if (!container) return;
if (typeof _conversationInlineRenameBlocksRender === 'function'
&& _conversationInlineRenameBlocksRender(container)) {
if (typeof _refreshAllConvBadges === 'function') _refreshAllConvBadges();
if (typeof _refreshUnreadTaskIndicators === 'function') _refreshUnreadTaskIndicators();
return;
}
const currentCreateInput = _projectsInlineCreate
? document.getElementById('project-create-input')
: null;
const restoreCreateFocus = !!currentCreateInput
&& document.activeElement === currentCreateInput;
const createSelectionStart = restoreCreateFocus ? currentCreateInput.selectionStart : null;
const createSelectionEnd = restoreCreateFocus ? currentCreateInput.selectionEnd : null;
const currentRenameInput = _projectsInlineRenamePid
? document.querySelector('input.project-rename-input[data-rename-pid]')
: null;
const restoreRenameFocus = !!currentRenameInput
&& document.activeElement === currentRenameInput;
const renameSelectionStart = restoreRenameFocus ? currentRenameInput.selectionStart : null;
const renameSelectionEnd = restoreRenameFocus ? currentRenameInput.selectionEnd : null;
const projects = Array.isArray(_projectsCache) ? _projectsCache : [];
if (!projects.length && !_projectsInlineCreate) {
// No projects + not creating — render nothing (the `+` button at the
// section header is the entry point). Avoid an empty-state row to keep
// the sidebar compact when the user hasn't adopted the feature.
container.innerHTML = '';
if (typeof _refreshUnreadTaskIndicators === 'function') _refreshUnreadTaskIndicators();
return;
}
const byPid = _convsByProject();
// **Auto-expand is intentionally NOT done here.** Earlier this lived
// inline (force `_projectsExpanded[pid]=true` whenever currentCid belonged
// to a project) and that meant clicking the row to collapse a project
// whose conv was active immediately re-expanded on the very next render
// — user perceived it as "can't collapse projects that have convs". Now
// auto-expand is a one-shot side effect of explicit
// `autoExpandActiveConvProject()` calls (boot + view-change to a
// conversation), so manual collapse always wins.
const rows = [];
// Inline-create row at the top.
if (_projectsInlineCreate) {
rows.push(_renderInlineCreateRow());
}
for (const p of projects) {
rows.push(_renderProjectRow(p, byPid.get(p.project_id) || []));
}
// Replacing the focused input can emit `blur` in Electron. That is a
// renderer-owned refresh, not user intent to submit the draft.
_projectsInlineCreateRerendering = !!currentCreateInput;
_projectsInlineRenameRerendering = !!currentRenameInput;
try {
container.innerHTML = rows.join('');
} finally {
_projectsInlineCreateRerendering = false;
_projectsInlineRenameRerendering = false;
}
_bindProjectsHandlers(container);
if (restoreCreateFocus) {
const nextCreateInput = document.getElementById('project-create-input');
if (nextCreateInput) {
nextCreateInput.focus();
if (createSelectionStart !== null && createSelectionEnd !== null) {
try { nextCreateInput.setSelectionRange(createSelectionStart, createSelectionEnd); } catch (_) {}
}
}
}
if (restoreRenameFocus) {
const nextRenameInput = document.querySelector('input.project-rename-input[data-rename-pid]');
if (nextRenameInput) {
nextRenameInput.focus();
if (renameSelectionStart !== null && renameSelectionEnd !== null) {
try { nextRenameInput.setSelectionRange(renameSelectionStart, renameSelectionEnd); } catch (_) {}
}
}
}
// Re-paint pending / queued badges on the conv items we just (re)rendered.
if (typeof _refreshAllConvBadges === 'function') _refreshAllConvBadges();
if (_projectSidebarRevealPid && _isProjectSelected(_projectSidebarRevealPid)) {
const row = container.querySelector('.project-row.active');
if (row) {
// Reveal once per navigation, including when the project list arrives
// later. Background refreshes must respect subsequent manual scrolling.
_projectSidebarRevealPid = '';
const toggle = document.getElementById('projects-section-toggle');
if (toggle?.getAttribute('aria-expanded') === 'false') toggle.click();
row.scrollIntoView?.({ block: 'nearest', inline: 'nearest' });
}
}
}
function _renderInlineCreateRow() {
const placeholder = escapeHtml(t('sidebar.project_create_placeholder'));
const draft = escapeHtml(_projectsInlineCreateDraft);
const errorClass = _projectsInlineCreateError ? ' is-error' : '';
const errorHint = _projectsInlineCreateError
? `<div class="project-inline-error">${escapeHtml(_projectInlineErrorText(_projectsInlineCreateError))}</div>`
: '';
const submittingState = _projectsInlineCreateSubmitting
? ' disabled aria-busy="true"'
: '';
// Match the same icon-only chrome as the regular project rows (no caret,
// KB-style folder SVG) so the create row reads as "a project being born"
// rather than a separate widget shape.
return `
<div class="project-row project-row-create" data-create>
<span class="project-icon">${_projectUiIconHtml('folder', 'project-folder-icon')}</span>
<input type="text" class="project-rename-input${errorClass}" id="project-create-input"
value="${draft}" placeholder="${placeholder}" autocomplete="off" spellcheck="false"${submittingState} />
${errorHint}
</div>
`;
}
function _renderProjectRow(p, convs) {
const expanded = !!_projectsExpanded[p.project_id];
const selected = _isProjectSelected(p.project_id);
const editing = _projectsInlineRenamePid === p.project_id;
const folderIcon = _projectUiIconHtml('folder', 'project-folder-icon');
const moreTitle = escapeHtml(t('project.menu.more_actions'));
const safeName = escapeHtml(p.name || '');
const renameErrorClass = editing && _projectsInlineRenameError ? ' is-error' : '';
const renameSubmittingState = editing && _projectsInlineRenameSubmitting
? ' disabled aria-busy="true"'
: '';
const renameErrorHint = editing && _projectsInlineRenameError
? `<div class="project-inline-error">${escapeHtml(_projectInlineErrorText(_projectsInlineRenameError))}</div>`
: '';
const nameNode = editing
? `<input type="text" class="project-rename-input${renameErrorClass}" data-rename-pid="${escapeHtml(p.project_id)}"
value="${escapeHtml(_projectsInlineRenameDraft)}" autocomplete="off" spellcheck="false"${renameSubmittingState} />
${renameErrorHint}`
: `<span class="project-name" title="${safeName}">${safeName}</span>`;
// Runtime counts are painted by conversation.js from the same live state
// that drives task-row streaming badges. Keep the mount present while idle
// so starting a task does not need to rebuild the project tree.
const runningChip = editing
? ''
: `<span class="sidebar-btn-running-chip project-running-chip"
data-project-running-chip="${escapeHtml(p.project_id)}" hidden></span>`;
const unreadDot = `<span class="task-unread-dot project-unread-dot"
data-project-unread-dot="${escapeHtml(p.project_id)}" hidden aria-hidden="true"></span>`;
const nameWithUnread = `<span class="project-name-unread-group">
${nameNode}
${unreadDot}
</span>`;
let html = `
<div class="project-row${selected ? ' active' : ''}" data-pid="${escapeHtml(p.project_id)}">
<span class="project-icon">${folderIcon}</span>
${nameWithUnread}
${runningChip}
<button type="button" class="ctx-row-menu-btn project-row-menu-btn" data-project-menu
data-pid="${escapeHtml(p.project_id)}"
title="${moreTitle}" aria-label="${moreTitle}">⋯</button>
</div>
`;
if (expanded) {
html += `<div class="project-conv-list" data-pid-children="${escapeHtml(p.project_id)}">`;
if (!convs.length) {
html += `<div class="project-conv-empty">${escapeHtml(t('sidebar.project_conv_empty'))}</div>`;
} else if (typeof _renderConversationTimeBucketList === 'function') {
html += _renderConversationTimeBucketList(convs, { nested: true, listId: 'projects-list' });
} else {
for (const c of convs) {
html += (typeof _renderConversationSidebarItem === 'function')
? _renderConversationSidebarItem(c, { nested: true })
: `<div class="conv-item conv-item-nested" data-cid="${escapeHtml(c.conversation_id)}"><div class="conv-item-title" title="${escapeHtml(c.title || t('chat.new_conv_title'))}">${escapeHtml(c.title || t('chat.new_conv_title'))}</div></div>`;
}
}
if (typeof _projectConversationHasMore === 'function' && _projectConversationHasMore(p.project_id)) {
html += `<button type="button" class="conversation-list-load-more" data-project-conv-more="${escapeHtml(p.project_id)}">
${escapeHtml(t('sidebar.load_more_conversations'))}</button>`;
}
html += '</div>';
}
return html;
}
function _isProjectSelected(pid) {
return currentView === 'project' && _projectSidebarPid === pid;
}
/** Paint cached identity before the deferred project-detail script is parsed.
* The panel markup is already eager, so first click can acknowledge the target
* in the same frame instead of showing an anonymous blank surface. */
function primeProjectDetailShell(pid) {
_projectSidebarPid = pid;
_projectSidebarRevealPid = pid;
const project = Array.isArray(_projectsCache)
? _projectsCache.find((item) => item && item.project_id === pid)
: null;
const title = document.getElementById('project-detail-title');
const content = document.getElementById('project-detail-content');
if (title) title.textContent = project?.name || '';
if (typeof _refreshUnreadTaskIndicators === 'function') _refreshUnreadTaskIndicators(pid);
if (content) {
content.setAttribute('aria-busy', 'true');
}
}
// ── Event wiring ────────────────────────────────────────────────────────
function _bindProjectsHandlers(container) {
// Inline-create input.
const createInput = container.querySelector('#project-create-input');
if (createInput) _bindInlineCreateInput(createInput);
// Inline-rename inputs (at most one).
container.querySelectorAll('input.project-rename-input[data-rename-pid]').forEach((input) => {
_bindInlineRenameInput(input);
});
container.querySelectorAll('[data-project-conv-more]').forEach((button) => {
button.addEventListener('click', async (e) => {
e.preventDefault();
e.stopPropagation();
const pid = button.dataset.projectConvMore || '';
if (!pid || button.disabled) return;
button.disabled = true;
button.setAttribute('aria-busy', 'true');
try { await loadConversationProject(pid, { append: true }); }
catch (err) { _projectsLog.warn('load more project conversations failed', err); }
finally {
if (button.isConnected) {
button.disabled = false;
button.removeAttribute('aria-busy');
}
}
});
});
// Project rows: first click selects/opens the project detail. Once that
// project is already selected, clicking the row toggles its nested
// conversations.
container.querySelectorAll('.project-row[data-pid]').forEach((row) => {
const pid = row.dataset.pid;
row.addEventListener('click', (e) => {
if (e.target.closest('.project-rename-input')) {
e.stopPropagation();
return;
}
if (e.target.closest('[data-project-menu]')) {
e.stopPropagation();
_openProjectRowMenu(e.target.closest('[data-project-menu]'), pid);
return;
}
if (!_isProjectSelected(pid)) {
if (typeof setView === 'function') setView('project', pid);
renderProjectsSection();
return;
}
_toggleProjectExpand(pid);
});
});
if (typeof _bindConversationSidebarItems === 'function') {
_bindConversationSidebarItems(container, {
selector: '.conv-item-nested',
async afterDelete() {
// Project conv counts changed → refresh project cache so future reads
// (delete confirm body, etc.) see the right number.
await loadProjects(true);
},
});
} else {
// Nested conv items.
container.querySelectorAll('.conv-item-nested').forEach((el) => {
el.addEventListener('click', () => setView('conversation', el.dataset.cid));
});
}
}
async function _toggleProjectExpand(pid) {
const expanding = !_projectsExpanded[pid];
_projectsExpanded[pid] = expanding;
_saveProjectsExpanded();
if (expanding && typeof loadConversationProject === 'function') {
try {
await loadConversationProject(pid, { reset: true });
} catch (err) {
_projectsLog.warn('load project conversations failed', err);
}
}
renderProjectsSection();
}
window.addEventListener('sidebar-section-toggle', (event) => {
if (event?.detail?.name !== 'projects' || event.detail.collapsed !== false) return;
const expandedProjectIds = Object.keys(_projectsExpanded).filter((pid) => _projectsExpanded[pid]);
Promise.all(expandedProjectIds.map((pid) => loadConversationProject(pid, {
reset: true,
render: false,
}))).catch((err) => {
_projectsLog.warn('reset expanded project conversations failed', err);
}).finally(() => renderProjectsSection());
});
// ── Inline create ───────────────────────────────────────────────────────
function _startProjectInlineCreate() {
if (_projectsInlineCreate) return;
if (_projectsInlineRenameSubmitting) return;
_projectsInlineRenamePid = null;
_projectsInlineRenameOriginal = '';
_projectsInlineRenameDraft = '';
_projectsInlineRenameError = '';
_projectsInlineRenameRequestId += 1;
_projectsInlineCreate = true;
_projectsInlineCreateDraft = '';
_projectsInlineCreateError = '';
_projectsInlineCreateSubmitting = false;
_projectsInlineCreateRequestId += 1;
renderProjectsSection();
setTimeout(() => {
const input = document.getElementById('project-create-input');
if (input) input.focus();
}, 0);
}
function _cancelProjectInlineCreate() {
if (!_projectsInlineCreate) return;
_projectsInlineCreate = false;
_projectsInlineCreateDraft = '';
_projectsInlineCreateError = '';
_projectsInlineCreateSubmitting = false;
_projectsInlineCreateRequestId += 1;
renderProjectsSection();
}
function _bindInlineCreateInput(input) {
input.addEventListener('click', (e) => e.stopPropagation());
if (typeof window.bindNameLimitControl === 'function') window.bindNameLimitControl(input);
let consumed = false;
const commit = async (accept) => {
if (consumed || _projectsInlineCreateSubmitting) return;
consumed = true;
_projectsInlineCreateDraft = input.value;
const name = _normaliseProjectNameFinal(input.value);
if (!accept || !name) {
_cancelProjectInlineCreate();
return;
}
_projectsInlineCreateSubmitting = true;
input.disabled = true;
_projectsInlineCreateError = '';
const requestId = ++_projectsInlineCreateRequestId;
const startedAt = performance.now();
try {
const res = await window.orkas.invoke('projects.create', { name });
if (requestId !== _projectsInlineCreateRequestId || !_projectsInlineCreate) return;
if (!res || !res.ok) {
const failure = _projectsFailureDetail(res, 'create_failed');
_projectsLogFailure('project_create', failure);
_projectsInlineCreateSubmitting = false;
_showProjectInlineCreateError(res && res.error);
return;
}
// Auto-expand the freshly created project, then select it below so the
// successful create lands on the project detail instead of leaving the
// user on the previous page with only an empty sidebar row.
const pid = res.project && res.project.project_id;
if (pid) {
_projectsExpanded[pid] = true;
_saveProjectsExpanded();
}
_projectsInlineCreate = false;
_projectsInlineCreateDraft = '';
_projectsInlineCreateError = '';
_projectsInlineCreateSubmitting = false;
await loadProjects(true);
if (pid && typeof setView === 'function') {
setView('project', pid, { entryPoint: 'project_create' });
}
} catch (err) {
if (requestId !== _projectsInlineCreateRequestId || !_projectsInlineCreate) return;
const failure = _projectsFailureDetail(err, 'create_exception');
_projectsLogFailure('project_create', failure);
_projectsInlineCreateSubmitting = false;
_showProjectInlineCreateError(err && err.message);
}
};
input.addEventListener('keydown', (e) => {
if (e.isComposing || e.keyCode === 229) return;
if (e.key === 'Enter') { e.preventDefault(); commit(true); }
else if (e.key === 'Escape') { e.preventDefault(); commit(false); }
});
input.addEventListener('blur', () => {
if (_projectsInlineCreateRerendering || input.isConnected === false) return;
return commit(true);
});
input.addEventListener('input', () => {
_projectsInlineCreateDraft = input.value;
_projectsInlineCreateError = '';
_clearProjectInlineError(input);
});
}
// ── Inline rename ───────────────────────────────────────────────────────
function _startProjectInlineRename(pid) {
// Once create has reached Main, keep its UI ownership until the response
// arrives. Hiding the editor here would make a successful response fail the
// request-id guard and leave the user with an apparently missing project.
if (_projectsInlineCreateSubmitting || _projectsInlineRenameSubmitting) return;
const project = Array.isArray(_projectsCache)
? _projectsCache.find((item) => item && item.project_id === pid)
: null;
if (!project) return;
_projectsInlineCreate = false;
_projectsInlineCreateDraft = '';
_projectsInlineCreateError = '';
_projectsInlineCreateRequestId += 1;
_projectsInlineRenamePid = pid;
_projectsInlineRenameOriginal = String(project.name || '');
_projectsInlineRenameDraft = _projectsInlineRenameOriginal;
_projectsInlineRenameError = '';
_projectsInlineRenameSubmitting = false;
_projectsInlineRenameRequestId += 1;
renderProjectsSection();
setTimeout(() => {
const input = document.querySelector(`input.project-rename-input[data-rename-pid="${CSS.escape(pid)}"]`);
if (input) {
input.focus();
input.select();
}
}, 0);
}
function _cancelProjectInlineRename() {
if (!_projectsInlineRenamePid) return;
_projectsInlineRenamePid = null;
_projectsInlineRenameOriginal = '';
_projectsInlineRenameDraft = '';
_projectsInlineRenameError = '';
_projectsInlineRenameSubmitting = false;
_projectsInlineRenameRequestId += 1;
renderProjectsSection();
}
function _bindInlineRenameInput(input) {
input.addEventListener('click', (e) => e.stopPropagation());
if (typeof window.bindNameLimitControl === 'function') window.bindNameLimitControl(input);
const pid = input.dataset.renamePid;
const original = _projectsInlineRenameOriginal;
let consumed = false;
const commit = async (accept) => {
if (consumed || _projectsInlineRenameSubmitting) return;
consumed = true;
_projectsInlineRenameDraft = input.value;
const next = _normaliseProjectNameFinal(input.value);
if (!accept || !next || next === original) {
_cancelProjectInlineRename();
return;
}
_projectsInlineRenameSubmitting = true;
input.disabled = true;
_projectsInlineRenameError = '';
const requestId = ++_projectsInlineRenameRequestId;
const startedAt = performance.now();
try {
const res = await window.orkas.invoke('projects.rename', { projectId: pid, name: next });
if (
requestId !== _projectsInlineRenameRequestId
|| _projectsInlineRenamePid !== pid
) return;
if (!res || !res.ok) {
const failure = _projectsFailureDetail(res, 'rename_failed');
_projectsLogFailure('project_rename', { source: 'sidebar', ...failure });
_projectsInlineRenameSubmitting = false;
_showProjectInlineRenameError(res && res.error);
return;
}
_projectsInlineRenamePid = null;
_projectsInlineRenameOriginal = '';
_projectsInlineRenameDraft = '';
_projectsInlineRenameError = '';
_projectsInlineRenameSubmitting = false;
_applyProjectRename(pid, res.project.name);
await loadProjects(true);
} catch (err) {
if (
requestId !== _projectsInlineRenameRequestId
|| _projectsInlineRenamePid !== pid
) return;
const failure = _projectsFailureDetail(err, 'rename_exception');
_projectsLogFailure('project_rename', { source: 'sidebar', ...failure });
_projectsInlineRenameSubmitting = false;
_showProjectInlineRenameError(err && err.message);
}
};
input.addEventListener('keydown', (e) => {
if (e.isComposing || e.keyCode === 229) return;
if (e.key === 'Enter') { e.preventDefault(); commit(true); }
else if (e.key === 'Escape') { e.preventDefault(); commit(false); }
});
input.addEventListener('blur', () => {
if (_projectsInlineRenameRerendering || input.isConnected === false) return;
return commit(true);
});
input.addEventListener('input', () => {
_projectsInlineRenameDraft = input.value;
_projectsInlineRenameError = '';
_clearProjectInlineError(input);
});
}
function _normaliseProjectNameFinal(raw) {
let name = String(raw || '').trim();
if (typeof window.limitNameDisplayText === 'function') name = window.limitNameDisplayText(name);
return name;
}
function _projectInlineErrorText(code) {
let key = 'project.error.generic';
if (code === 'name_dup') key = 'project.name_dup_inline';
else if (code === 'name_empty') key = 'project.name_empty';
return t(key);
}
function _showProjectInlineCreateError(code) {
if (!_projectsInlineCreate) return;
_projectsInlineCreateError = code || 'generic';
renderProjectsSection();
setTimeout(() => {
const input = document.getElementById('project-create-input');
if (input) input.focus();
}, 0);
}
function _showProjectInlineRenameError(code) {
if (!_projectsInlineRenamePid) return;
_projectsInlineRenameError = code || 'generic';
renderProjectsSection();
setTimeout(() => {
const input = document.querySelector('input.project-rename-input[data-rename-pid]');
if (input) input.focus();
}, 0);
}
function _clearProjectInlineError(input) {
if (!input) return;
input.classList.remove('is-error');
const hint = input.parentElement?.querySelector('.project-inline-error');
if (hint) hint.remove();
}
// ── ⋯ menu ──────────────────────────────────────────────────────────────
function _openProjectRowMenu(anchorBtn, pid) {
let menu = document.getElementById('project-row-menu');
if (!menu) {
menu = document.createElement('div');
menu.id = 'project-row-menu';
menu.className = 'ctx-row-menu'; // reuse KB menu styling
menu.style.display = 'none';
document.body.appendChild(menu);
}
const sameAnchor = menu.dataset.pid === pid && menu.style.display !== 'none';
if (sameAnchor) { _closeProjectRowMenu(); return; }
_closeProjectRowMenu();
const items = [
{ action: 'invite-members', label: t('project.menu.invite_members') },
{ action: 'rename', label: t('project.menu.rename') },
{ action: 'delete', label: t('project.menu.delete'), danger: true },
];
menu.innerHTML = items.map((it) =>
`<div class="ctx-row-menu-item${it.danger ? ' is-danger' : ''}" data-action="${escapeHtml(it.action)}">${escapeHtml(it.label)}</div>`
).join('');
menu.dataset.pid = pid;
const srcRow = anchorBtn.closest('.project-row');
for (const r of document.querySelectorAll('.is-menu-open')) r.classList.remove('is-menu-open');
if (srcRow) srcRow.classList.add('is-menu-open');
// Position above-or-below, mirroring KB.
menu.style.display = 'block';
menu.style.left = '-9999px';
menu.style.top = '-9999px';
const rect = anchorBtn.getBoundingClientRect();
const menuRect = menu.getBoundingClientRect();
const margin = 8;
const gap = 4;
let left = rect.right - menuRect.width;
if (left < margin) left = margin;
if (left + menuRect.width > window.innerWidth - margin) {
left = window.innerWidth - menuRect.width - margin;
}
const below = rect.bottom + gap + menuRect.height <= window.innerHeight - margin;
const top = below ? rect.bottom + gap : Math.max(margin, rect.top - menuRect.height - gap);
menu.style.left = left + 'px';
menu.style.top = top + 'px';
for (const item of menu.querySelectorAll('.ctx-row-menu-item')) {
item.addEventListener('click', async (e) => {
e.stopPropagation();
const action = item.dataset.action;
_closeProjectRowMenu();
await _runProjectMenuAction(action, pid);
});
}
}
function _closeProjectRowMenu() {
const menu = document.getElementById('project-row-menu');
if (menu) {
menu.style.display = 'none';
delete menu.dataset.pid;
}
for (const r of document.querySelectorAll('.project-row.is-menu-open')) r.classList.remove('is-menu-open');
}
async function _runProjectMenuAction(action, pid) {
if (action === 'invite-members') return _showProjectMemberInviteGate();
if (action === 'rename') return _startProjectInlineRename(pid);
if (action === 'delete') return _confirmDeleteProject(pid);
}
// ── Delete flow ─────────────────────────────────────────────────────────
function _pickProjectDeleteFallback(deletedPid, projectsBeforeDelete, projectsAfterDelete, conversationsAfterDelete) {
const projects = Array.isArray(projectsAfterDelete)
? projectsAfterDelete.filter((p) => p && p.project_id && p.project_id !== deletedPid)
: [];
if (projects.length) {
const before = Array.isArray(projectsBeforeDelete)
? projectsBeforeDelete.filter((p) => p && p.project_id)
: [];
const projectIds = new Set(projects.map((p) => p.project_id));
const deletedIdx = before.findIndex((p) => p.project_id === deletedPid);
if (deletedIdx >= 0) {
for (let i = deletedIdx + 1; i < before.length; i += 1) {
const nextId = before[i]?.project_id;
if (nextId && projectIds.has(nextId)) return { view: 'project', id: nextId };
}
for (let i = deletedIdx - 1; i >= 0; i -= 1) {
const prevId = before[i]?.project_id;
if (prevId && projectIds.has(prevId)) return { view: 'project', id: prevId };
}
}
return { view: 'project', id: projects[0].project_id };
}
const conv = Array.isArray(conversationsAfterDelete)
? conversationsAfterDelete.find((c) => c && c.conversation_id && c.project_id !== deletedPid)
: null;
if (conv) return { view: 'conversation', id: conv.conversation_id };
return { view: 'new-chat', id: '' };
}
function _goToProjectDeleteFallback(target) {
if (!target || typeof setView !== 'function') return;
const opts = { entryPoint: 'project_delete_fallback' };
if (target.view === 'project' && target.id) setView('project', target.id, opts);
else if (target.view === 'conversation' && target.id) setView('conversation', target.id, opts);
else setView('new-chat', null, opts);
}
async function _confirmDeleteProject(pid, source = 'sidebar') {
const project = (_projectsCache || []).find((p) => p.project_id === pid);
if (!project) return;
const name = project.name || '';
const count = Number(project.conv_count || 0);
const projectsBeforeDelete = Array.isArray(_projectsCache) ? _projectsCache.slice() : [];
const wasViewingDeletedProject = currentView === 'project'
&& typeof _projectDetailPid !== 'undefined'
&& _projectDetailPid === pid;
const activeConversationWasDeleted = !!currentCid
&& Array.isArray(conversations)
&& conversations.some((c) => c && c.conversation_id === currentCid && c.project_id === pid);
// Look up project-scoped auto tasks BEFORE confirm so the body can warn
// the user they'll be cascade-deleted too. Best-effort: a transient IPC
// failure falls through to the no-auto-tasks message; the backend's
// cascade in `projects.deleteProject` still cleans them up either way.
let autoCount = 0;
try {
const r = await window.orkas.invoke('autoTasks.list', { projectId: pid });
if (r && Array.isArray(r.tasks)) autoCount = r.tasks.length;
} catch (_) { /* ignore — fall through with autoCount = 0 */ }
// Build the confirm dialog. When N > 0 we surface the destructive scope on
// the danger button itself so the user has to read N before clicking;
// when N = 0 it's just a simple confirm. Auto-task suffix appended
// whenever the project owns at least one task.
let message;
let dangerLabel;
if (count > 0) {
message = t('project.delete_confirm_body', { count });
dangerLabel = t('project.delete_danger_label', { count });
} else {
message = t('project.delete_confirm_body_empty', { name });
dangerLabel = t('project.delete_danger_label_empty');
}
if (autoCount > 0) {
message += ' ' + t('project.delete_confirm_auto_suffix', { n: autoCount });
}
const ok = await uiConfirmDanger({
title: t('project.delete_confirm_title', { name }),
message,
dangerLabel,
});
if (!ok) return;
const startedAt = performance.now();
let deleted = false;
try {
const res = await window.orkas.invoke('projects.delete', { projectId: pid });
if (!res || !res.ok) {
const failure = _projectsFailureDetail(res, 'delete_failed');
_projectsLogFailure('project_delete', { source, ...failure });
const code = res && res.error;
if (code === 'has_running_conv') {
await uiAlert(t('project.has_running_conv'));
} else if (code === 'recycle_archive_failed' || res?.code === 'recycle_archive_failed') {
await uiAlert(t('project.delete_archive_failed'));
} else {
await uiAlert(t('project.delete_failed_generic'));
}
return;
}
deleted = true;
} catch (err) {
const failure = _projectsFailureDetail(err, 'delete_exception');
_projectsLogFailure('project_delete', { source, ...failure });
_projectsLog.error('delete project failed', err);
await uiAlert(t('project.delete_failed_generic'));
return;
}
if (!deleted) return;
if (typeof _forgetUnreadProject === 'function') _forgetUnreadProject(pid);
try {
// Drop expanded entry.
if (_projectsExpanded[pid]) {
delete _projectsExpanded[pid];
_saveProjectsExpanded();
}
await loadConversations();
const projectsAfterDelete = await loadProjects(true);
if (typeof window.refreshAutoProjectOptions === 'function') {
try { window.refreshAutoProjectOptions(pid); } catch (_) { /* auto dialog may be unmounted */ }
}
if (wasViewingDeletedProject || activeConversationWasDeleted) {
_goToProjectDeleteFallback(_pickProjectDeleteFallback(
pid,
projectsBeforeDelete,
projectsAfterDelete,
conversations,
));
}
} catch (err) {
// The delete already committed and its terminal success was emitted. A presentation refresh
// failure is local diagnostics only and must not turn the mutation into a second failure row.
_projectsLog.warn('refresh after project delete failed', err);
}
}
// ── Project name resolver ──────────────────────────────────────────────
// Empty-state composer no longer carries a project chip — new conversations
// from the commander tab are always orphan. Project membership is bound
// only via the per-project page. This resolver is kept because the
// conversation header + workspace chip tooltip still need a pid → name
// lookup for already-bound conversations.
/** Resolve a project id to its display name from the cache. Returns empty
* string when the pid is unknown (e.g. just deleted). */
function getCommanderProjectIdName(pid) {
if (!pid || !Array.isArray(_projectsCache)) return '';
const p = _projectsCache.find((x) => x && x.project_id === pid);
return (p && p.name) || '';
}
// Commander navigation uses the same sidebar/create/detail workflows as a
// manual click. The helper resolves business ids before opening a detail so a
// stale conversation card cannot leave the user on an empty Project shell.
window.openProjectsSurface = async function openProjectsSurface(request) {
request = request || {};
const action = String(request.action || 'open');
const toggle = document.getElementById('projects-section-toggle');
if (!toggle) return false;
if (toggle.getAttribute('aria-expanded') === 'false') toggle.click();
if (action === 'open') {
toggle.scrollIntoView?.({ block: 'nearest' });
toggle.focus?.();
return true;
}
if (action === 'create') {
_startProjectInlineCreate();
return _projectsInlineCreate === true;
}
if (action === 'configure') {
const projectId = String(request.target_id || '').trim();
if (!projectId) return false;
const projects = await loadProjects(true, true);
const exists = Array.isArray(projects)
&& projects.some((project) => project && project.project_id === projectId);
if (!exists || typeof setView !== 'function') return false;
setView('project', projectId);
return true;
}
return false;
};
function _applyProjectRename(projectId, name) {
const cached = Array.isArray(_projectsCache)
? _projectsCache.find((project) => project?.project_id === projectId) : null;
if (cached) cached.name = name;
// Update only the title; reloading the detail would replace active editors.
if (typeof _projectDetailPid !== 'undefined' && _projectDetailPid === projectId
&& typeof _projectDetailMeta !== 'undefined' && _projectDetailMeta?.project) {
_projectDetailMeta.project.name = name;
const title = document.getElementById('project-detail-title');
if (title) title.textContent = name;
}
renderProjectsSection();
}
// ── Init ────────────────────────────────────────────────────────────────
function _applyProjectRename(projectId, name) {
const cached = Array.isArray(_projectsCache)
? _projectsCache.find((project) => project?.project_id === projectId) : null;
if (cached) cached.name = name;
// Update only the title; reloading the detail would replace active editors.
if (typeof _projectDetailPid !== 'undefined' && _projectDetailPid === projectId
&& typeof _projectDetailMeta !== 'undefined' && _projectDetailMeta?.project) {
_projectDetailMeta.project.name = name;
const title = document.getElementById('project-detail-title');
if (title) title.textContent = name;
}
renderProjectsSection();
}
async function _applyHostProjectRename(payload) {
if (!payload || typeof currentUserId === 'undefined' || payload.userId !== currentUserId
|| typeof payload.projectId !== 'string' || !payload.projectId
|| typeof payload.name !== 'string' || !payload.name) return;
_applyProjectRename(payload.projectId, payload.name);
// The normal loader fences older list requests and preserves sidebar edits.
await loadProjects(true);
}
document.addEventListener('DOMContentLoaded', () => {
if (window.orkas && typeof window.orkas.onPushEvent === 'function') {
window.orkas.onPushEvent('projects:renamed', _applyHostProjectRename);
}
// `+` button on the section header.
const addBtn = document.getElementById('projects-add-btn');
if (addBtn) {
addBtn.addEventListener('click', (e) => {
e.stopPropagation();
_startProjectInlineCreate();
});
}
// Outside-click closes the ⋯ menu (mirrors KB).
document.addEventListener('click', (e) => {
const menu = document.getElementById('project-row-menu');
if (!menu || menu.style.display === 'none') return;
if (menu.contains(e.target)) return;
if (e.target.closest('[data-project-menu]')) return;
_closeProjectRowMenu();
});
window.addEventListener('scroll', _closeProjectRowMenu, true);
window.addEventListener('resize', _closeProjectRowMenu);
window.addEventListener('i18n-change', () => {
_closeProjectRowMenu();
if (_projectsCache) {
renderProjectsSection();
}
});
});
if (typeof window !== 'undefined') window.primeProjectDetailShell = primeProjectDetailShell;
async function _showProjectMemberInviteGate() {
const download = await uiConfirm({
message: t('project.invite_members.commercial_only'),
okLabel: t('project.invite_members.download'),
cancelLabel: t('common.cancel'),
});
if (!download) return;
const lang = getLang();
const url = `https://orkas.ai/download/?lang=${encodeURIComponent(lang)}`;
try {
const result = await window.orkas.invoke('auth.openExternal', { url });
if (!result?.ok) throw new Error('open rejected');
} catch (_) {
await uiAlert(t('project.invite_members.open_failed'));
}
}