@olares/lares-core 0.15.5 → 0.15.7

package/files/draft-images.js

@@ -0,0 +1,25 @@
+export function createDraftImageEntry(file) {
+  return {
+    id: globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random()}`,
+    file,
+    previewUrl: URL.createObjectURL(file),
+    status: "uploading",
+    path: "",
+  };
+}
+
+export function draftImageStatus(row) {
+  return row?.status ?? "ready";
+}
+
+export function draftImagesUploading(images) {
+  return (images ?? []).some((row) => draftImageStatus(row) === "uploading");
+}
+
+export function draftImagesSendable(images) {
+  return (images ?? []).some((row) => draftImageStatus(row) === "ready");
+}
+
+export function draftHasSendableContent(draft, images) {
+  return Boolean(String(draft ?? "").trim()) || draftImagesSendable(images);
+}

package/files/filename.js

@@ -1,3 +1,9 @@
+/** Display name of a workspace path, which may arrive with either separator. */
+export function fileName(path) {
+  const parts = String(path).split(/[/\\]/);
+  return parts.at(-1) || path;
+}
+
 export function posixBasename(path) {
   const raw = String(path ?? "");
   const trimmed = raw.replace(/\/+$/, "");

package/files/preview-tabs.js

@@ -0,0 +1,51 @@
+/**
+ * Tab-strip rules for workspace file previews. The dsh web overlay and the
+ * LarePass PC shell fetch through different transports but must open, evict and
+ * close tabs the same way, so the rules live here and each surface keeps only
+ * its own content cache.
+ */
+import { fileName } from "./filename.js";
+
+export const MAX_PREVIEW_TABS = 8;
+
+/** Least-recently-used order, oldest first. */
+export function touchTab(lru, path) {
+  return [...lru.filter((item) => item !== path), path];
+}
+
+/**
+ * @returns tabs, the new LRU order, and the tab an over-full strip dropped so
+ * the caller can release whatever it cached for it.
+ */
+export function openTab({ tabs, lru }, path) {
+  if (tabs.some((tab) => tab.path === path)) {
+    return { tabs, lru: touchTab(lru, path), evicted: null };
+  }
+  let kept = tabs;
+  let evicted = null;
+  if (kept.length >= MAX_PREVIEW_TABS) {
+    evicted = kept.find((tab) => tab.path === lru[0]) ?? kept[0];
+    kept = kept.filter((tab) => tab.path !== evicted.path);
+  }
+  return {
+    tabs: [...kept, { path, name: fileName(path) }],
+    lru: touchTab(evicted ? lru.filter((item) => item !== evicted.path) : lru, path),
+    evicted,
+  };
+}
+
+/**
+ * @returns null when the path owns no tab, otherwise the strip without it. The
+ * reader lands on the tab they read last; an empty strip reports no active path.
+ */
+export function closeTab({ tabs, lru, activePath }, path) {
+  if (!tabs.some((tab) => tab.path === path)) return null;
+  const kept = tabs.filter((tab) => tab.path !== path);
+  const order = lru.filter((item) => item !== path);
+  if (kept.length === 0) return { tabs: kept, lru: order, activePath: null };
+  return {
+    tabs: kept,
+    lru: order,
+    activePath: activePath === path ? order.at(-1) ?? kept.at(-1).path : activePath,
+  };
+}

package/files/preview-workspace.js

@@ -1,3 +1,5 @@
+import { closeTab, openTab, touchTab } from "./preview-tabs.js";
+
 export class NullScrollport {
   offset() {
     return null;
@@ -6,13 +8,6 @@ export class NullScrollport {
   scrollTo() {}
 }
 
-const MAX_TABS = 8;
-
-export function fileName(path) {
-  const parts = String(path).split(/[/\\]/);
-  return parts.at(-1) || path;
-}
-
 function initialSnapshot() {
   return {
     mode: "chat",
@@ -174,33 +169,23 @@ export class FilePreviewWorkspace {
   open(sessionId, path, resolved) {
     if (resolved?.status === "ready" && resolved.data?.path) path = resolved.data.path;
     const state = this.session(sessionId);
-    const existing = state.snapshot.tabs.find((tab) => tab.path === path);
-    let tabs = state.snapshot.tabs;
-    let evictedName = null;
-    if (!existing) {
-      if (tabs.length >= MAX_TABS) {
-        const victim = state.lru[0];
-        const evicted = tabs.find((tab) => tab.path === victim);
-        tabs = tabs.filter((tab) => tab.path !== victim);
-        state.lru = state.lru.filter((item) => item !== victim);
-        state.contents.delete(victim);
-        state.offsets.delete(victim);
-        state.requestVersions.delete(victim);
-        evictedName = evicted?.name ?? null;
-      }
-      tabs = [...tabs, { path, name: fileName(path) }];
+    const { tabs, lru, evicted } = openTab({ tabs: state.snapshot.tabs, lru: state.lru }, path);
+    state.lru = lru;
+    if (evicted) {
+      state.contents.delete(evicted.path);
+      state.offsets.delete(evicted.path);
+      state.requestVersions.delete(evicted.path);
     }
     if (resolved !== undefined) {
       state.contents.set(path, resolved);
       state.requestVersions.set(path, (state.requestVersions.get(path) ?? 0) + 1);
     }
-    this.touch(state, path);
     this.emit(sessionId, {
       mode: "preview",
       tabs,
       activePath: path,
       content: state.contents.get(path) ?? { status: "idle" },
-      evictedName,
+      evictedName: evicted?.name ?? null,
     });
     if (resolved === undefined) void this.load(sessionId, path, true);
   }
@@ -220,9 +205,13 @@ export class FilePreviewWorkspace {
 
   close(sessionId, path) {
     const state = this.session(sessionId);
-    if (!state.snapshot.tabs.some((tab) => tab.path === path)) return;
-    const tabs = state.snapshot.tabs.filter((tab) => tab.path !== path);
-    state.lru = state.lru.filter((item) => item !== path);
+    const closed = closeTab(
+      { tabs: state.snapshot.tabs, lru: state.lru, activePath: state.snapshot.activePath },
+      path,
+    );
+    if (!closed) return;
+    const { tabs, activePath } = closed;
+    state.lru = closed.lru;
     state.contents.delete(path);
     state.offsets.delete(path);
     state.requestVersions.set(path, (state.requestVersions.get(path) ?? 0) + 1);
@@ -236,11 +225,10 @@ export class FilePreviewWorkspace {
       });
       return;
     }
-    if (state.snapshot.activePath !== path) {
+    if (activePath === state.snapshot.activePath) {
       this.emit(sessionId, { tabs, evictedName: null });
       return;
     }
-    const activePath = state.lru.at(-1) ?? tabs.at(-1).path;
     this.emit(sessionId, {
       tabs,
       activePath,
@@ -261,8 +249,7 @@ export class FilePreviewWorkspace {
   }
 
   touch(state, path) {
-    state.lru = state.lru.filter((item) => item !== path);
-    state.lru.push(path);
+    state.lru = touchTab(state.lru, path);
   }
 
   /**

package/i18n/mobile.js

@@ -12,7 +12,56 @@ export const ZH = {
   "probe.entrance": "入口 {origin}",
   "chat.empty": "发一条消息开始对话",
   "chat.placeholder": "发消息或按住说话",
+  "chat.placeholderDesktop": "给智能体发送消息",
+  "chat.placeholderNewSession": "描述你想构建的内容",
+  "chat.placeholderPlan": "描述要规划的任务",
+  "chat.placeholderNoModel": "请选择一个可用模型",
+  "chat.placeholderSteerQueue": "按 {shortcut} 立即发送全部排队消息",
   "chat.send": "发送",
+  "chat.stop": "停止生成",
+  "queue.count": "{n} 条排队消息",
+  "queue.edit": "编辑",
+  "queue.save": "保存",
+  "queue.cancelEdit": "取消编辑",
+  "queue.remove": "移除",
+  "queue.steer": "立即发送",
+  "access.confirm.title": "确认启用 Full access？",
+  "access.confirm.description": "启用 Full access 后，智能体将减少确认步骤，并且可以直接执行更多操作，包括敏感操作、文件修改或外部命令。仅建议在你信任当前任务时使用。",
+  "access.confirm.acknowledge": "我已了解风险，并愿意继续",
+  "access.confirm.cancel": "取消",
+  "access.confirm.enable": "启用 Full access",
+  "plan.active": "规划模式",
+  "plan.disable": "退出规划模式",
+  "context.title": "上下文占用",
+  "context.used": "{percent}% · 约 {used} / {total} tokens",
+  "context.system": "系统提示",
+  "context.tools": "工具定义",
+  "context.conversation": "对话",
+  "todo.progress": "任务 {done}/{total}",
+  "goal.edit": "编辑目标",
+  "goal.pause": "暂停目标",
+  "goal.resume": "继续目标",
+  "goal.clear": "清除目标",
+  "approval.waiting": "等待确认",
+  "approval.escalation": "{toolName} 请求执行权限",
+  "approval.reject": "拒绝",
+  "approval.allowOnce": "允许一次",
+  "question.waiting": "需要你的选择",
+  "question.other": "其他",
+  "question.back": "上一步",
+  "question.next": "下一步",
+  "question.submit": "提交",
+  "settings.input.title": "输入",
+  "settings.input.busyEnter.hint": "智能体运行时，普通 Enter 的发送方式；Cmd/Ctrl+Enter 使用相反方式。",
+  "settings.input.busyEnter.queue": "Enter 加入队列",
+  "settings.input.busyEnter.steer": "Enter 立即插队",
+  "references.empty": "没有匹配的文件或会话",
+  // Section and kind words are dsh's `reference` dictionary; keep them in step.
+  "references.section.files": "文件与文件夹",
+  "references.section.sessions": "Session 对话",
+  "references.file": "文件",
+  "references.directory": "文件夹",
+  "references.session": "Session",
   "chat.sending": "正在回复…",
   "action.copy": "复制",
   "action.copied": "已复制",
@@ -21,6 +70,8 @@ export const ZH = {
   "action.share": "转发",
   "action.bar": "回复操作",
   "composer.attach": "添加文件",
+  "composer.removeAttachment": "移除 {name}",
+  "composer.previewAttachment": "查看 {name}",
   "composer.voice": "语音输入",
   "composer.think": "深度思考",
   "composer.search": "智能搜索",
@@ -38,6 +89,13 @@ export const ZH = {
   "message.retry.status": "{label} ({retry}/{maximum}) · {seconds}s",
   "message.retry.delay": "Retry delay: ",
   "message.retry.failure": "Failure reason: ",
+  "message.ranFor": "用时 {duration}",
+  "message.ttft": "首 token {seconds}秒",
+  "message.tokensPerSecond": "{tps} tok/s",
+  "duration.seconds": "{seconds}秒",
+  "duration.minutes": "{minutes}分{seconds}秒",
+  "clock.md": "{m}月{d}日",
+  "clock.ymd": "{y}年{m}月{d}日",
   "bar.history": "历史",
   "bar.menu": "菜单",
   "bar.new": "新对话",
@@ -45,10 +103,66 @@ export const ZH = {
   "history.empty": "还没有其他对话",
   "history.untitled": "新对话",
   "history.loading": "正在加载对话列表…",
+  "history.noMoveTargets": "没有其他工作区可移动",
   "chat.loading": "正在加载对话…",
   "history.today": "今天",
   "history.week": "之前 7 天",
   "history.older": "更早",
+  "desktop.newSession": "新会话",
+  "desktop.workspaces": "工作区",
+  "desktop.sessions": "会话",
+  "desktop.ungrouped": "未分组",
+  "desktop.searchSessions": "搜索会话",
+  "desktop.clearSearch": "清除搜索",
+  "desktop.viewOptions": "视图选项",
+  "desktop.addWorkspace": "添加工作区",
+  "desktop.addingWorkspace": "正在添加…",
+  "desktop.open": "打开",
+  "desktop.cancel": "取消",
+  "desktop.close": "关闭",
+  "desktop.groupBy": "分组方式",
+  "desktop.byWorkspace": "按工作区",
+  "desktop.oneList": "单列表",
+  "desktop.orderBy": "排序方式",
+  "desktop.recent": "最近更新",
+  "desktop.manual": "手动排序",
+  "desktop.commands": "命令",
+  "desktop.noCommands": "这个会话没有可用命令",
+  // Preset keys arrive from the host as kebab ids; the words live here.
+  "permission.read-only": "只读",
+  "permission.read-only.hint": "只读文件；写入和风险命令需要确认。",
+  "permission.workspace-write": "工作区可写",
+  "permission.workspace-write.hint": "可在工作区内写入；超出范围需要确认。",
+  "permission.danger-full-access": "完全访问",
+  "permission.danger-full-access.hint": "没有文件沙箱，也不再询问。",
+  "desktop.selectWorkspaceDirectory": "选择工作区目录",
+  "desktop.chooseFolder": "选择 Olares Host 文件夹",
+  "desktop.newFolder": "新建文件夹",
+  "desktop.newFolderIn": "在「{name}」中新建",
+  "desktop.untitledFolder": "未命名文件夹",
+  "desktop.createFolder": "创建",
+  "desktop.showHiddenFiles": "显示隐藏文件",
+  "desktop.folderPath": "文件夹路径",
+  "desktop.home": "主目录",
+  "desktop.loadingFolders": "正在读取文件夹…",
+  "desktop.noFolders": "这里没有子文件夹",
+  "desktop.rename": "重命名",
+  "desktop.renameWorkspace": "重命名工作区",
+  "desktop.renameSession": "重命名会话",
+  "desktop.deleteWorkspace": "删除工作区",
+  "desktop.forkSession": "复刻会话",
+  "desktop.archiveSession": "归档会话",
+  "desktop.moveSession": "移动到工作区",
+  "desktop.showMoreSessions": "展开其余 {n} 个会话",
+  "desktop.showLessSessions": "收起",
+  "desktop.sessionActions": "会话操作",
+  "desktop.workspaceActions": "工作区操作",
+  "desktop.save": "保存",
+  "desktop.deleteWorkspaceConfirm": "从列表移除“{name}”？文件和会话记录会保留。",
+  "desktop.archiveSessionConfirm": "归档这个会话？",
+  "desktop.minutesAgo": "{n}分钟",
+  "desktop.hoursAgo": "{n}小时",
+  "desktop.daysAgo": "{n}天",
   "agent.refresh": "刷新",
   "agent.loading": "正在读取配置…",
   "question.title": "需要你选一项",
@@ -70,7 +184,55 @@ export const EN = {
   "probe.entrance": "Entrance {origin}",
   "chat.empty": "Send a message to start chatting",
   "chat.placeholder": "Message or hold to speak",
+  "chat.placeholderDesktop": "Send a message to the agent",
+  "chat.placeholderNewSession": "Describe what you want to build",
+  "chat.placeholderPlan": "Describe the task to plan",
+  "chat.placeholderNoModel": "Choose an available model",
+  "chat.placeholderSteerQueue": "Press {shortcut} to send all queued messages now",
   "chat.send": "Send",
+  "chat.stop": "Stop",
+  "queue.count": "{n} queued messages",
+  "queue.edit": "Edit",
+  "queue.save": "Save",
+  "queue.cancelEdit": "Cancel edit",
+  "queue.remove": "Remove",
+  "queue.steer": "Send now",
+  "access.confirm.title": "Enable Full access?",
+  "access.confirm.description": "Full access reduces confirmation steps and lets the agent perform more actions directly, including sensitive operations, file changes, or external commands. Only use it when you trust the current task.",
+  "access.confirm.acknowledge": "I understand the risks and want to continue",
+  "access.confirm.cancel": "Cancel",
+  "access.confirm.enable": "Enable Full access",
+  "plan.active": "Plan",
+  "plan.disable": "Exit plan mode",
+  "context.title": "Context usage",
+  "context.used": "{percent}% · ~{used} / {total} tokens",
+  "context.system": "System prompt",
+  "context.tools": "Tool definitions",
+  "context.conversation": "Conversation",
+  "todo.progress": "Tasks {done}/{total}",
+  "goal.edit": "Edit goal",
+  "goal.pause": "Pause goal",
+  "goal.resume": "Resume goal",
+  "goal.clear": "Clear goal",
+  "approval.waiting": "Waiting for approval",
+  "approval.escalation": "{toolName} requests permission to run",
+  "approval.reject": "Reject",
+  "approval.allowOnce": "Allow once",
+  "question.waiting": "Your input is needed",
+  "question.other": "Other",
+  "question.back": "Back",
+  "question.next": "Next",
+  "question.submit": "Submit",
+  "settings.input.title": "Input",
+  "settings.input.busyEnter.hint": "While the agent is running, plain Enter uses this mode; Cmd/Ctrl+Enter uses the opposite.",
+  "settings.input.busyEnter.queue": "Enter queues",
+  "settings.input.busyEnter.steer": "Enter steers",
+  "references.empty": "No matching files or sessions",
+  "references.section.files": "Files & folders",
+  "references.section.sessions": "Session conversations",
+  "references.file": "File",
+  "references.directory": "Folder",
+  "references.session": "Session",
   "chat.sending": "Replying…",
   "action.copy": "Copy",
   "action.copied": "Copied",
@@ -79,6 +241,8 @@ export const EN = {
   "action.share": "Share",
   "action.bar": "Reply actions",
   "composer.attach": "Add file",
+  "composer.removeAttachment": "Remove {name}",
+  "composer.previewAttachment": "View {name}",
   "composer.voice": "Voice input",
   "composer.think": "Deep think",
   "composer.search": "Search",
@@ -96,6 +260,13 @@ export const EN = {
   "message.retry.status": "{label} ({retry}/{maximum}) · {seconds}s",
   "message.retry.delay": "Retry delay: ",
   "message.retry.failure": "Failure reason: ",
+  "message.ranFor": "Ran for {duration}",
+  "message.ttft": "TTFT {seconds}s",
+  "message.tokensPerSecond": "{tps} tok/s",
+  "duration.seconds": "{seconds}s",
+  "duration.minutes": "{minutes}m {seconds}s",
+  "clock.md": "{m}/{d}",
+  "clock.ymd": "{y}/{m}/{d}",
   "bar.history": "History",
   "bar.menu": "Menu",
   "bar.new": "New chat",
@@ -103,10 +274,65 @@ export const EN = {
   "history.empty": "No other chats yet",
   "history.untitled": "New chat",
   "history.loading": "Loading chats…",
+  "history.noMoveTargets": "No other workspaces to move to",
   "chat.loading": "Loading conversation…",
   "history.today": "Today",
   "history.week": "Previous 7 days",
   "history.older": "Older",
+  "desktop.newSession": "New Session",
+  "desktop.workspaces": "Workspaces",
+  "desktop.sessions": "Sessions",
+  "desktop.ungrouped": "Ungrouped",
+  "desktop.searchSessions": "Search sessions",
+  "desktop.clearSearch": "Clear search",
+  "desktop.viewOptions": "View options",
+  "desktop.addWorkspace": "Add workspace",
+  "desktop.addingWorkspace": "Adding…",
+  "desktop.open": "Open",
+  "desktop.cancel": "Cancel",
+  "desktop.close": "Close",
+  "desktop.groupBy": "Group by",
+  "desktop.byWorkspace": "By workspace",
+  "desktop.oneList": "In one list",
+  "desktop.orderBy": "Order by",
+  "desktop.recent": "Last updated",
+  "desktop.manual": "Manual",
+  "desktop.commands": "Commands",
+  "desktop.noCommands": "No commands for this session",
+  "permission.read-only": "Read Only",
+  "permission.read-only.hint": "Read files only; writes and risky commands require approval.",
+  "permission.workspace-write": "Workspace Write",
+  "permission.workspace-write.hint": "Write inside the workspace; anything wider requires approval.",
+  "permission.danger-full-access": "Full access",
+  "permission.danger-full-access.hint": "No file sandbox and no approval prompts.",
+  "desktop.selectWorkspaceDirectory": "Select Workspace Directory",
+  "desktop.chooseFolder": "Choose an Olares Host folder",
+  "desktop.newFolder": "New folder",
+  "desktop.newFolderIn": "New folder in \"{name}\"",
+  "desktop.untitledFolder": "Untitled folder",
+  "desktop.createFolder": "Create",
+  "desktop.showHiddenFiles": "Show hidden files",
+  "desktop.folderPath": "Folder path",
+  "desktop.home": "Home",
+  "desktop.loadingFolders": "Loading folders…",
+  "desktop.noFolders": "No subfolders here",
+  "desktop.rename": "Rename",
+  "desktop.renameWorkspace": "Rename workspace",
+  "desktop.renameSession": "Rename session",
+  "desktop.deleteWorkspace": "Delete workspace",
+  "desktop.forkSession": "Fork session",
+  "desktop.archiveSession": "Archive session",
+  "desktop.moveSession": "Move to workspace",
+  "desktop.showMoreSessions": "Show {n} more sessions",
+  "desktop.showLessSessions": "Show less",
+  "desktop.sessionActions": "Session actions",
+  "desktop.workspaceActions": "Workspace actions",
+  "desktop.save": "Save",
+  "desktop.deleteWorkspaceConfirm": "Remove “{name}”? Files and session logs will be kept.",
+  "desktop.archiveSessionConfirm": "Archive this session?",
+  "desktop.minutesAgo": "{n}min",
+  "desktop.hoursAgo": "{n}h",
+  "desktop.daysAgo": "{n}d",
   "agent.refresh": "Refresh",
   "agent.loading": "Loading settings…",
   "question.title": "Choose an option",

package/i18n/preview.js

@@ -2,6 +2,7 @@ export const ZH = {
   hierarchy: "会话层级",
   tabs: "工作区标签页",
   chat: "对话",
+  back: "返回",
   preview: "文件预览",
   produced: "产物",
   mediaLoading: "正在准备媒体预览…",
@@ -32,6 +33,7 @@ export const EN = {
   hierarchy: "Session hierarchy",
   tabs: "Workspace tabs",
   chat: "Chat",
+  back: "Back",
   preview: "File preview",
   produced: "Produced",
   mediaLoading: "Preparing media preview…",

package/larepass/chat.js

@@ -1,5 +1,6 @@
 import { isAuthFailure } from "./host.js";
 import { consumeMux, MUX_PATH } from "./mux.js";
+import { permissionSelect } from "./permissions.js";
 import { foldTranscript, mergeEvents } from "./transcript.js";
 import { promptPayload, rpcPath, unwrapServerResponse, wrapClientRequest } from "./rpc.js";
 
@@ -31,18 +32,18 @@ export async function callRpc(request, method, payload = {}) {
   return { ...parsed, status: "ok", http };
 }
 
-export async function listRootSessions(rpc) {
+export async function listNavigableSessions(rpc) {
   const listed = await rpc("session.list", {});
   if (!listed.ok) return listed;
   return {
     ok: true,
     status: listed.status || "ok",
-    value: { items: rootSessions(listed.value?.items).map(summarizeSession) },
+    value: { items: navigableSessions(listed.value?.items).map(summarizeSession) },
   };
 }
 
 export async function ensureSession(rpc) {
-  const listed = await listRootSessions(rpc);
+  const listed = await listNavigableSessions(rpc);
   if (!listed.ok) return listed;
   const existing = listed.value.items[0];
   if (existing) {
@@ -54,9 +55,13 @@ export async function ensureSession(rpc) {
   return { ok: true, status: "ok", value: { sessionId: row.sessionId, sessions: [row] } };
 }
 
-export function rootSessions(items) {
+/**
+ * Sessions a person can open. `parentSessionId` is lineage, not a hide signal:
+ * forked children carry it too, and only subagent runs are off-list.
+ */
+export function navigableSessions(items) {
   return (Array.isArray(items) ? items : []).filter(
-    (row) => row?.sessionId && !row.parentSessionId && row.origin !== "subagent",
+    (row) => row?.sessionId && row.origin !== "subagent",
   );
 }
 
@@ -75,11 +80,22 @@ export function sessionTitleOf(row) {
 }
 
 export function summarizeSession(row) {
+  const permissions = permissionSelect(row);
+  const projections = row?.projections?.values ?? {};
   return {
     sessionId: row.sessionId,
     title: sessionTitleOf(row),
     updatedAt: Number(row.updatedAt || row.mtime || row.createdAt || 0) || 0,
     blank: Boolean(row.blank),
+    ...(typeof row.cwd === "string" ? { cwd: row.cwd } : {}),
+    // The composer's permission chip reads its preset from here, so the one
+    // projection this summary keeps is the one a session row can answer for.
+    ...(permissions ? { permissions } : {}),
+    ...(projections.plan ? { plan: projections.plan } : {}),
+    ...(projections.contextPressure ? { contextPressure: projections.contextPressure } : {}),
+    ...(projections.contextBreakdown ? { contextBreakdown: projections.contextBreakdown } : {}),
+    ...(projections.goal ? { goal: projections.goal } : {}),
+    ...(Array.isArray(projections.todos) ? { todos: projections.todos } : {}),
   };
 }
 
@@ -127,8 +143,8 @@ export function clientTimeZone() {
   }
 }
 
-export function sendPrompt(rpc, sessionId, text) {
-  return rpc("session.prompt", promptPayload(sessionId, text, clientTimeZone()));
+export function sendPrompt(rpc, sessionId, textOrContent, mode = "queue") {
+  return rpc("session.prompt", promptPayload(sessionId, textOrContent, clientTimeZone(), mode));
 }
 
 export { consumeMux, mergeEvents, MUX_PATH };

package/larepass/commands.js

@@ -0,0 +1,49 @@
+/**
+ * The host's slash commands, for a composer that offers them instead of making
+ * people remember the names.
+ *
+ * dsh keeps its command registry behind a Typert remote, which this client's
+ * plain `POST /api/<method>` transport cannot reach, so the Lares Host exposes
+ * the registry over `/api/lares/commands` instead. Running one stays ordinary:
+ * a prompt whose single text block starts with `/` is dispatched by the host to
+ * the registry and never reaches the model.
+ */
+
+export const COMMANDS_PATH = "/api/lares/commands";
+
+export function commandsUrl(sessionId) {
+  return sessionId ? `${COMMANDS_PATH}?sessionId=${encodeURIComponent(sessionId)}` : COMMANDS_PATH;
+}
+
+/**
+ * @param {unknown} body - the endpoint's payload.
+ * @returns {Array<{ name: string, description: string, hint: string }>}
+ */
+export function normalizeCommands(body) {
+  const rows = Array.isArray(body?.commands) ? body.commands : [];
+  return rows
+    .filter((row) => typeof row?.name === "string" && row.name.trim())
+    .map((row) => ({
+      name: row.name.trim(),
+      description: String(row.description || ""),
+      hint: String(row.input?.hint ?? row.hint ?? ""),
+    }));
+}
+
+/** A command that takes input is handed over with the cursor past the space. */
+export function commandLine(command) {
+  return command?.hint ? `/${command.name} ` : `/${command?.name ?? ""}`;
+}
+
+/**
+ * Put a chosen command on the composer. The host reads a command only as the
+ * whole message, so the line replaces any command already typed there while
+ * keeping the words after it — picking `goal` over `plan` keeps the input the
+ * person had already written for it.
+ */
+export function applyCommand(draft, command) {
+  const line = commandLine(command);
+  const rest = String(draft ?? "").replace(/^\s*\/\S*\s*/, "").trimStart();
+  if (!rest) return line;
+  return line.endsWith(" ") ? `${line}${rest}` : `${line} ${rest}`;
+}

package/larepass/context-occupancy.js

@@ -0,0 +1,30 @@
+const BREAKDOWN = [
+  ["system", "systemTokens"],
+  ["tools", "toolsTokens"],
+  ["conversation", "messageTokens"],
+];
+
+export function compactTokens(value) {
+  const n = Number(value) || 0;
+  if (n >= 1_000_000) return `${Math.round(n / 100_000) / 10}M`;
+  if (n >= 1_000) return `${Math.round(n / 100) / 10}K`;
+  return String(Math.round(n));
+}
+
+export function occupancyFromPressure(pressure) {
+  const used = Number(pressure?.projectedTokens ?? pressure?.pressureTokens);
+  const total = Number(pressure?.contextWindow);
+  if (!(used >= 0) || !(total > 0)) return null;
+  return {
+    percent: Math.min(100, Math.max(0, Math.round((used / total) * 100))),
+    used: compactTokens(used),
+    total: compactTokens(total),
+  };
+}
+
+export function occupancyBreakdown(breakdown) {
+  return BREAKDOWN.map(([key, field]) => ({
+    key,
+    compact: compactTokens(Number(breakdown?.[field]) || 0),
+  }));
+}