@baique/pi-web-sky 0.1.55 → 0.1.56

package/lib/file-types.ts

@@ -26,7 +26,14 @@ export const AUDIO_EXT_TO_MIME: Record<string, string> = {
   aac: "audio/aac",
   flac: "audio/flac",
   weba: "audio/webm",
-  webm: "audio/webm",
+};
+
+export const VIDEO_EXT_TO_MIME: Record<string, string> = {
+  mp4: "video/mp4",
+  m4v: "video/mp4",
+  webm: "video/webm",
+  mov: "video/quicktime",
+  ogv: "video/ogg",
 };
 
 export const DOCUMENT_EXT_TO_MIME: Record<DocumentPreviewKind, string> = {
@@ -50,6 +57,10 @@ export function getAudioMime(filePath: string): string | null {
   return AUDIO_EXT_TO_MIME[getFileExt(filePath)] ?? null;
 }
 
+export function getVideoMime(filePath: string): string | null {
+  return VIDEO_EXT_TO_MIME[getFileExt(filePath)] ?? null;
+}
+
 export function getDocumentMime(filePath: string): string | null {
   return DOCUMENT_EXT_TO_MIME[getFileExt(filePath) as DocumentPreviewKind] ?? null;
 }
@@ -68,6 +79,10 @@ export function isAudioPath(filePath: string): boolean {
   return getAudioMime(filePath) !== null;
 }
 
+export function isVideoPath(filePath: string): boolean {
+  return getVideoMime(filePath) !== null;
+}
+
 export function isDocumentPreviewPath(filePath: string): boolean {
   return documentPreviewKind(filePath) !== null;
 }

package/lib/i18n/messages/en.ts

@@ -10,6 +10,8 @@ export const enLocale: LocalePlugin = {
     "common.models": "Models",
     "common.skills": "Skills",
     "common.plugins": "Plugins",
+    "common.settings": "Settings",
+    "common.agents": "Agents",
     "appUpdate.releaseNotes": "Pi Web v{version} is available. View release notes",
     "sidebar.hide": "Hide sidebar",
     "sidebar.show": "Show sidebar",
@@ -146,6 +148,11 @@ export const enLocale: LocalePlugin = {
     "sidebar.filesTab": "Files",
     "sidebar.tasks": "Tasks",
     "sidebar.tempSessions": "Chat",
+    "sidebar.timeToday": "Today",
+    "sidebar.timeYesterday": "Yesterday",
+    "sidebar.timeThisWeek": "This week",
+    "sidebar.timeThisMonth": "Last 30 days",
+    "sidebar.timeOlder": "Older",
     "sidebar.newTask": "New task…",
     "sidebar.taskName": "Task name",
     "sidebar.newTaskSession": "New task session",
@@ -300,6 +307,17 @@ export const enLocale: LocalePlugin = {
     "chat.steer": "Steer",
     "chat.followUp": "Follow-up",
     "chat.send": "Send",
+    "chat.askSelection": "Ask about selected text",
+    "chat.askInCurrent": "Ask here",
+    "chat.askInNewChat": "Ask in new chat",
+    "chat.newQuoteChat": "New chat about selected text",
+    "chat.quoteIntro": "About this passage:",
+    "chat.quoteQuestion": "My question:",
+    "chat.quoteForkFailed": "Failed to create quoted chat",
+    "chat.quoteSelectionToggle": "Show an ask menu after selecting text",
+    "chat.sendQuestion": "Send question",
+    "chat.imageNotSupportedTitle": "The selected model does not support images",
+    "chat.imageNotSupportedBody": "Model {model} accepts text input only; attached images will not be sent. Switch to a vision-capable model or remove the attachments.",
     "chat.attachImage": "Attach image",
     "chat.previewImage": "Preview image",
     "chat.filterModels": "Filter models…",
@@ -360,6 +378,79 @@ export const enLocale: LocalePlugin = {
     "chat.commandCopy": "Copy the last assistant message",
     "chat.compacted": "Compacted",
     "chat.tokensSaved": "{saved} saved",
+    "settings.chatContentWidth": "Chat content width",
+    "settings.chatContentWidthDescription": "Set the maximum width of message content and the input box.",
+    "settings.chatContentFontSize": "Chat font size",
+    "settings.preferences": "Preferences",
+    "settings.title": "Settings",
+    "settings.general": "General",
+    "settings.appearance": "Appearance",
+    "settings.chat": "Chat",
+    "settings.quoteSelection": "Ask about selected text",
+    "settings.resetChatContentWidth": "Reset chat width",
+    "settings.resetChatContentFontSize": "Reset chat font size",
+    "settings.projectRequired": "Project required",
+    "settings.themeLight": "Light",
+    "settings.themeDark": "Dark",
+    "tools.title": "Tools enabled in the current session",
+    "tools.details": "Tool definition details",
+    "tools.load": "Tool definitions have not loaded yet",
+    "tools.loading": "Loading tool definitions…",
+    "tools.noTools": "No active tools",
+    "tools.description": "Description",
+    "tools.parameters": "Parameters",
+    "tools.parameterCount": "{count} parameters",
+    "tools.noParameters": "No parameters",
+    "tools.required": "Required",
+    "tools.optional": "Optional",
+    "tools.allowedValues": "Allowed",
+    "tools.defaultValue": "Default",
+    "tools.guidelines": "Prompt guidelines",
+
+    "tools.label": "Tools",
+    "agents.close": "Close",
+    "agents.builtInTitle": "Enable Pi Web built-in sub-agents",
+    "agents.builtInDescription": "Provides Pi Web's integrated Agent tools and disables a conflicting pi-subagents extension.",
+    "agents.reloadRequired": "Reload the current session to apply this change.",
+    "agents.reloadSession": "Reload session",
+    "agents.maxConcurrent": "Concurrent sub-agents",
+    "agents.maxConcurrentDescription": "Maximum prompts running at once per parent session.",
+    "agents.reloading": "Reloading...",
+    "agents.loading": "Loading sub-agents...",
+    "agents.new": "New sub-agent",
+    "agents.empty": "Select or create a sub-agent profile",
+    "agents.saveScope": "Save to",
+    "agents.name": "Sub-agent ID",
+    "agents.displayName": "Display name",
+    "agents.description": "Description",
+    "agents.prompt": "System instructions",
+    "agents.tools": "Tools",
+    "agents.resources": "Resources",
+    "agents.loadSkills": "Load skills",
+    "agents.loadExtensions": "Load extensions",
+    "agents.model": "Model override",
+    "agents.modelsLoading": "Loading models...",
+    "agents.modelUnavailable": "{model} (unavailable)",
+    "agents.thinking": "Thinking",
+    "agents.maxTurns": "Max turns",
+    "agents.inherit": "Parent default",
+    "agents.enable": "Enable sub-agent",
+    "agents.disable": "Disable sub-agent",
+    "agents.builtinPath": "Built-in profile",
+    "agents.inheritContext": "Inherit parent context",
+    "agents.background": "Run in background by default",
+    "agents.duplicate": "Duplicate",
+    "agents.copyName": "{name} copy",
+    "agents.delete": "Delete",
+    "agents.deleteConfirm": "Delete {name}?",
+    "agents.save": "Save",
+    "agents.saving": "Saving...",
+    "agents.scope.builtin": "built-in",
+    "agents.scope.global": "global",
+    "agents.scope.workspace": "workspace",
+    "agents.scope.project": "project",
+    "agents.overridden": "Overridden",
+
     "i18n.close": "Close",
     "i18n.copy": "Copy",
     "i18n.pin": "Pin",

package/lib/i18n/messages/zh-CN.ts

@@ -11,6 +11,8 @@ export const zhCNLocale: LocalePlugin = {
     "common.models": "模型",
     "common.skills": "技能",
     "common.plugins": "插件",
+    "common.settings": "设置",
+    "common.agents": "代理",
     "appUpdate.releaseNotes": "Pi Web v{version} 可用，查看更新说明",
     "sidebar.hide": "隐藏侧边栏",
     "sidebar.show": "显示侧边栏",
@@ -147,6 +149,11 @@ export const zhCNLocale: LocalePlugin = {
     "sidebar.filesTab": "文件",
     "sidebar.tasks": "任务",
     "sidebar.tempSessions": "聊天",
+    "sidebar.timeToday": "今天",
+    "sidebar.timeYesterday": "昨天",
+    "sidebar.timeThisWeek": "本周",
+    "sidebar.timeThisMonth": "近一月",
+    "sidebar.timeOlder": "更久之前",
     "sidebar.newTask": "新建任务…",
     "sidebar.taskName": "任务名称",
     "sidebar.newTaskSession": "新建任务会话",
@@ -301,6 +308,17 @@ export const zhCNLocale: LocalePlugin = {
     "chat.steer": "引导",
     "chat.followUp": "后续消息",
     "chat.send": "发送",
+    "chat.askSelection": "询问选中的文字",
+    "chat.askInCurrent": "在当前对话询问",
+    "chat.askInNewChat": "在新对话询问",
+    "chat.newQuoteChat": "关于选中文字的新对话",
+    "chat.quoteIntro": "关于这段内容：",
+    "chat.quoteQuestion": "我的问题是：",
+    "chat.quoteForkFailed": "无法创建引用对话",
+    "chat.quoteSelectionToggle": "选中文字后显示询问菜单",
+    "chat.sendQuestion": "发送问题",
+    "chat.imageNotSupportedTitle": "当前模型不支持图片",
+    "chat.imageNotSupportedBody": "模型 {model} 的输入只支持文本，图片不会被发送。请更换支持图片的模型或移除附件。",
     "chat.attachImage": "附加图片",
     "chat.previewImage": "预览图片",
     "chat.filterModels": "筛选模型…",
@@ -361,6 +379,79 @@ export const zhCNLocale: LocalePlugin = {
     "chat.commandCopy": "复制最后一条助手消息",
     "chat.compacted": "已压缩",
     "chat.tokensSaved": "节省 {saved}",
+    "settings.chatContentWidth": "聊天内容宽度",
+    "settings.chatContentWidthDescription": "设置消息内容和输入框的最大宽度。",
+    "settings.chatContentFontSize": "聊天字体大小",
+    "settings.preferences": "偏好",
+    "settings.title": "设置",
+    "settings.general": "通用",
+    "settings.appearance": "外观",
+    "settings.chat": "聊天",
+    "settings.quoteSelection": "选中文字后询问",
+    "settings.resetChatContentWidth": "重置聊天宽度",
+    "settings.resetChatContentFontSize": "重置聊天字号",
+    "settings.projectRequired": "需要项目",
+    "settings.themeLight": "浅色",
+    "settings.themeDark": "深色",
+    "tools.title": "当前会话启用的工具",
+    "tools.details": "工具定义详情",
+    "tools.load": "工具定义尚未加载",
+    "tools.loading": "正在加载工具定义…",
+    "tools.noTools": "没有启用的工具",
+    "tools.description": "描述",
+    "tools.parameters": "参数",
+    "tools.parameterCount": "{count} 个参数",
+    "tools.noParameters": "无参数",
+    "tools.required": "必填",
+    "tools.optional": "可选",
+    "tools.allowedValues": "可选值",
+    "tools.defaultValue": "默认值",
+    "tools.guidelines": "提示词规则",
+
+    "tools.label": "工具",
+    "agents.close": "关闭",
+    "agents.builtInTitle": "启用 Pi Web 内置子代理",
+    "agents.builtInDescription": "提供 Pi Web 集成的 Agent 工具，并停用发生冲突的 pi-subagents 扩展。",
+    "agents.reloadRequired": "重新加载当前会话后生效。",
+    "agents.reloadSession": "重新加载会话",
+    "agents.maxConcurrent": "并发子代理数",
+    "agents.maxConcurrentDescription": "每个父会话同时运行的最大任务数。",
+    "agents.reloading": "正在重新加载...",
+    "agents.loading": "正在加载子代理...",
+    "agents.new": "新建子代理",
+    "agents.empty": "选择或创建一个子代理配置",
+    "agents.saveScope": "保存到",
+    "agents.name": "子代理 ID",
+    "agents.displayName": "显示名称",
+    "agents.description": "描述",
+    "agents.prompt": "系统指令",
+    "agents.tools": "工具",
+    "agents.resources": "资源",
+    "agents.loadSkills": "加载技能",
+    "agents.loadExtensions": "加载扩展",
+    "agents.model": "指定模型",
+    "agents.modelsLoading": "正在加载模型...",
+    "agents.modelUnavailable": "{model}（不可用）",
+    "agents.thinking": "思考级别",
+    "agents.maxTurns": "最大轮次",
+    "agents.inherit": "跟随父会话",
+    "agents.enable": "启用子代理",
+    "agents.disable": "停用子代理",
+    "agents.builtinPath": "内置配置",
+    "agents.inheritContext": "继承父会话上下文",
+    "agents.background": "默认在后台运行",
+    "agents.duplicate": "创建副本",
+    "agents.copyName": "{name} 副本",
+    "agents.delete": "删除",
+    "agents.deleteConfirm": "删除 {name}？",
+    "agents.save": "保存",
+    "agents.saving": "正在保存...",
+    "agents.scope.builtin": "内置",
+    "agents.scope.global": "全局",
+    "agents.scope.workspace": "工作区",
+    "agents.scope.project": "项目",
+    "agents.overridden": "被覆盖",
+
     "i18n.close": "关闭",
     "i18n.copy": "复制",
     "i18n.pin": "钉",

package/lib/id.test.mjs

@@ -0,0 +1,38 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { createJiti } from "jiti";
+
+const jiti = createJiti(import.meta.url, { tsconfigPaths: true });
+const { newId } = await jiti.import("./id.ts");
+
+// 服务端 /api/agent/new 的会话 id 校验（SESSION_ID_RE）：兜底 id 必须也能当会话 id 用
+const SESSION_ID_RE = /^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/;
+
+const realCrypto = globalThis.crypto;
+
+test.afterEach(() => {
+  Object.defineProperty(globalThis, "crypto", { value: realCrypto, configurable: true, writable: true });
+});
+
+test("prefers crypto.randomUUID when the secure-context API exists", () => {
+  Object.defineProperty(globalThis, "crypto", { value: { randomUUID: () => "0b6f2f2e-1111-2222-3333-444455556666" }, configurable: true, writable: true });
+  assert.equal(newId(), "0b6f2f2e-1111-2222-3333-444455556666");
+});
+
+test("falls back on insecure origins where randomUUID is missing", () => {
+  // http://<LAN-IP>:30143 → crypto 在、randomUUID 不在（裸调会 TypeError）
+  Object.defineProperty(globalThis, "crypto", { value: { getRandomValues: (a) => a }, configurable: true, writable: true });
+  const id = newId();
+  assert.match(id, SESSION_ID_RE, `fallback id must be a valid session id, got ${id}`);
+});
+
+test("falls back when crypto itself is unavailable", () => {
+  Object.defineProperty(globalThis, "crypto", { value: undefined, configurable: true, writable: true });
+  assert.match(newId(), SESSION_ID_RE);
+});
+
+test("fallback ids stay unique across rapid calls", () => {
+  Object.defineProperty(globalThis, "crypto", { value: {}, configurable: true, writable: true });
+  const ids = new Set(Array.from({ length: 200 }, () => newId()));
+  assert.equal(ids.size, 200);
+});

package/lib/id.ts

@@ -0,0 +1,17 @@
+/**
+ * 前端 id 生成（会话 id / 画布节点 id / 草稿 id / 通知 id 等）。
+ *
+ * **一律用它，别裸调 `crypto.randomUUID()`**：该方法只在**安全上下文**存在
+ * （https / localhost）。局域网访问（`npm run dev:lan` → `http://192.168.x.x:30143`）
+ * 或老浏览器里它是 undefined，裸调直接抛 “crypto.randomUUID is not a function”
+ * —— 任务行「新建会话」2026-09-14 就栽在这里（同一批调用里有的做了兜底、有的漏了）。
+ *
+ * 退化实现产出的 id 仍是 `[A-Za-z0-9-]`，满足服务端会话 id 校验
+ * （`SESSION_ID_RE`，见 `app/api/agent/new/route.ts`），可直接当会话 id 用。
+ */
+export function newId(): string {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}

package/lib/message-text.ts

@@ -0,0 +1,24 @@
+import type { AgentMessage } from "@/lib/types";
+
+/**
+ * 从消息中提取可渲染的 markdown 文本（钉卡快照用）。
+ * 只取 text 块，忽略 thinking / 工具调用 / 图片等结构 —— 钉卡只渲染内容，与消息气泡解耦。
+ */
+export function extractMessageMarkdown(message: AgentMessage): string {
+  const content = (message as unknown as { content?: unknown }).content;
+  const parts: string[] = [];
+  const push = (c: unknown): void => {
+    if (typeof c === "string") {
+      parts.push(c);
+    } else if (Array.isArray(c)) {
+      for (const b of c) {
+        if (b && typeof b === "object") {
+          const t = b as { type?: string; text?: string };
+          if (t.type === "text" && typeof t.text === "string") parts.push(t.text);
+        }
+      }
+    }
+  };
+  push(content);
+  return parts.join("\n\n").trim();
+}

package/lib/models-cache.ts

@@ -1,6 +1,6 @@
 export interface ModelsData {
   models: Record<string, string>;
-  modelList: { id: string; name: string; provider: string }[];
+  modelList: { id: string; name: string; provider: string; input?: string[] }[];
   defaultModel: { provider: string; modelId: string } | null;
   thinkingLevels: Record<string, string[]>;
   thinkingLevelMaps: Record<string, Record<string, string | null>>;

package/lib/pi-types.ts

@@ -6,7 +6,12 @@ import type {
   SlashCommandInfo,
   Theme,
 } from "@earendil-works/pi-coding-agent";
-import type { AgentMessage as PiAgentMessage } from "@earendil-works/pi-agent-core";
+import type {
+  AgentLoopTurnUpdate,
+  AgentMessage as PiAgentMessage,
+  PrepareNextTurnContext,
+} from "@earendil-works/pi-agent-core";
+import type { ImageContent, TextContent } from "@earendil-works/pi-ai";
 
 export interface ContextUsage {
   percent: number | null;
@@ -138,6 +143,10 @@ export interface AgentSessionLike {
       thinkingLevel?: string;
       streamingMessage?: PiAgentMessage;
     };
+    prepareNextTurnWithContext?: (
+      context: PrepareNextTurnContext,
+      signal?: AbortSignal,
+    ) => Promise<AgentLoopTurnUpdate | undefined> | AgentLoopTurnUpdate | undefined;
   };
   readonly extensionRunner: ExtensionRunnerLike;
   readonly promptTemplates: readonly PromptTemplateLike[];
@@ -153,6 +162,15 @@ export interface AgentSessionLike {
     source?: "interactive" | "rpc";
     preflightResult?: (success: boolean) => void;
   }): Promise<void>;
+  sendCustomMessage<T = unknown>(message: {
+    customType: string;
+    content: string | (TextContent | ImageContent)[];
+    display: boolean;
+    details?: T;
+  }, options?: {
+    triggerTurn?: boolean;
+    deliverAs?: "steer" | "followUp" | "nextTurn";
+  }): Promise<void>;
   abort(): Promise<void>;
   executeBash(command: string, onChunk?: (chunk: string) => void, options?: {
     excludeFromContext?: boolean;

package/lib/pin-store.ts

@@ -0,0 +1,85 @@
+"use client";
+
+import { useSyncExternalStore } from "react";
+
+export interface PinnedMessageItem {
+  id: string;
+  /** 快照内容（markdown 文本）——钉卡只渲染内容，与消息气泡/会话解耦 */
+  content: string;
+  x: number;
+  y: number;
+  w: number;
+  /** 高度：undefined = 初始随内容自适应；缩放/resize 后变为固定值 */
+  h?: number;
+}
+
+type Listener = () => void;
+
+/**
+ * 全局钉 store：pins 存活在模块级（与任何会话组件无关）。
+ * 跨会话/看板切换保留；刷新页面不持久化（内存态，符合设计）。
+ */
+let pins: PinnedMessageItem[] = [];
+const listeners = new Set<Listener>();
+
+function emit() {
+  for (const l of listeners) l();
+}
+
+function subscribe(listener: Listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+function getSnapshot() {
+  return pins;
+}
+
+let pinCount = 0;
+
+/** 钉住内容：卡片出现在鼠标下方，多张级联偏移，clamp 视口内 */
+export function pin(content: string, clientX: number, clientY: number) {
+  const vw = window.innerWidth;
+  const vh = window.innerHeight;
+  const w = Math.min(340, Math.max(240, vw - 40));
+  const offset = (pinCount % 8) * 22;
+  pinCount += 1;
+  const item: PinnedMessageItem = {
+    id: `pin-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+    content,
+    x: Math.min(Math.max(0, clientX + offset), Math.max(0, vw - w - 4)),
+    y: Math.min(Math.max(0, clientY + 14 + offset), Math.max(0, vh - 48)),
+    w,
+  };
+  pins = [...pins, item];
+  emit();
+}
+
+export function closePin(id: string) {
+  pins = pins.filter((p) => p.id !== id);
+  emit();
+}
+
+export function movePin(id: string, patch: Partial<Pick<PinnedMessageItem, "x" | "y" | "w" | "h">>) {
+  pins = pins.map((p) => (p.id === id ? { ...p, ...patch } : p));
+  emit();
+}
+
+/** 激活置顶：把卡片移到数组末尾（zIndex 最高） */
+export function activatePin(id: string) {
+  if (pins.length <= 1) return;
+  const idx = pins.findIndex((p) => p.id === id);
+  if (idx === -1 || idx === pins.length - 1) return;
+  const next = [...pins];
+  const [item] = next.splice(idx, 1);
+  next.push(item);
+  pins = next;
+  emit();
+}
+
+/** 订阅 pins 快照（组件用） */
+export function usePins(): PinnedMessageItem[] {
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}

package/lib/powershell-settings.ts

@@ -0,0 +1,106 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import lockfile from "proper-lockfile";
+
+const DEFAULT_TOOLS = ["read", "bash", "edit", "write"];
+const SHELL_TOOLS = new Set(["bash", "powershell"]);
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export function isPowerShellToolEnabled(
+  defaultTools: readonly string[] | undefined,
+  platform: NodeJS.Platform = process.platform,
+): boolean {
+  return platform === "win32"
+    && defaultTools?.includes("powershell") === true
+    && !defaultTools.includes("bash");
+}
+
+export function replaceShellTool(
+  toolNames: readonly string[],
+  usePowerShell: boolean,
+): string[] {
+  const shell = usePowerShell ? "powershell" : "bash";
+  const result: string[] = [];
+  for (const name of toolNames) {
+    const next = SHELL_TOOLS.has(name) ? shell : name;
+    if (!result.includes(next)) result.push(next);
+  }
+  return result;
+}
+
+export function resolveShellTools(
+  toolNames: readonly string[],
+  defaultTools: readonly string[] | undefined,
+  platform: NodeJS.Platform = process.platform,
+): string[] {
+  return replaceShellTool(toolNames, isPowerShellToolEnabled(defaultTools, platform));
+}
+
+export function getPowerShellSettingsPath(agentDir = getAgentDir()): string {
+  return join(agentDir, "settings.json");
+}
+
+function parseSettings(path: string): Record<string, unknown> {
+  if (!existsSync(path)) return {};
+  const parsed: unknown = JSON.parse(readFileSync(path, "utf8"));
+  if (!isRecord(parsed)) throw new Error("Invalid settings.json: expected an object");
+  return parsed;
+}
+
+function configuredTools(settings: Record<string, unknown>): string[] | undefined {
+  if (settings.defaultTools === undefined) return undefined;
+  if (
+    !Array.isArray(settings.defaultTools)
+    || settings.defaultTools.some((name) => typeof name !== "string")
+  ) {
+    throw new Error("Invalid settings.json: defaultTools must be an array of strings");
+  }
+  return settings.defaultTools as string[];
+}
+
+export async function readPowerShellToolEnabled(
+  settingsPath = getPowerShellSettingsPath(),
+  platform: NodeJS.Platform = process.platform,
+): Promise<boolean> {
+  if (!existsSync(settingsPath)) return false;
+  const release = await lockfile.lock(settingsPath, { realpath: false, retries: 10 });
+  try {
+    return isPowerShellToolEnabled(configuredTools(parseSettings(settingsPath)), platform);
+  } finally {
+    await release();
+  }
+}
+
+export async function writePowerShellToolEnabled(
+  enabled: boolean,
+  settingsPath = getPowerShellSettingsPath(),
+  platform: NodeJS.Platform = process.platform,
+): Promise<boolean> {
+  if (platform !== "win32") throw new Error("PowerShell tool settings are only available on Windows");
+
+  mkdirSync(dirname(settingsPath), { recursive: true });
+  try {
+    writeFileSync(settingsPath, "{}", { flag: "wx", mode: 0o600 });
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
+  }
+  const release = await lockfile.lock(settingsPath, { realpath: false, retries: 10 });
+  try {
+    const settings = parseSettings(settingsPath);
+    const currentTools = configuredTools(settings) ?? DEFAULT_TOOLS;
+    const nextTools = replaceShellTool(currentTools, enabled);
+    if (!currentTools.some((name) => SHELL_TOOLS.has(name))) {
+      nextTools.push(enabled ? "powershell" : "bash");
+    }
+    settings.defaultTools = nextTools;
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2), "utf8");
+    chmodSync(settingsPath, 0o600);
+  } finally {
+    await release();
+  }
+  return enabled;
+}

package/lib/quoted-selection.ts

@@ -0,0 +1,4 @@
+export function buildQuotedSelection(text: string, intro: string, question: string): string {
+  const quote = text.trim().split("\n").map((line) => `> ${line}`).join("\n");
+  return `${intro}\n\n${quote}\n\n${question}`;
+}