@narumitw/pi-subagents 3.2.0 → 3.3.0

package/README.md

@@ -16,6 +16,7 @@ Pi Subagents runs Pi jobs in separate child processes and supports authenticated
 - Gives every child `subagent_wait` for an answer to a child-originated request.
 - Lets the main agent question a queued or running job through Pi RPC steering without retaining the child after completion.
 - Publishes one asynchronous terminal completion and shows active-job progress above the editor.
+- Provides a job manager with confirmed cancellation and immediate widget display settings.
 - Exposes privacy-filtered metadata without task text, output, prompts, selected tools, or broker credentials.
 - Cancels session-owned work and closes the broker during replacement, reload, or shutdown.
 
@@ -62,17 +63,36 @@ Call `subagent_spawn` with a self-contained task and only the work tools that ta
 The call returns a `jobId` immediately, and the job continues in the background.
 Continue useful main-agent work until the result is required or a completion arrives.
 
+In TUI mode, each active-job row shows a preview of its existing `task` after the job ID by default; no new parameter is required.
+The preview removes terminal controls, collapses whitespace, and uses at most 40 terminal columns, including an ellipsis when shortened.
+It describes the assigned task, not live child activity; the full task sent to the child is unchanged.
+Task text is visible in this local widget, but `subagent_inspect` continues to omit it.
+Rows are clipped to the available terminal width, so trailing state, timing, or tools can be hidden on narrow terminals.
+
 Use messaging only when needed:
 
 - Call `subagent_send` with `recipient: jobId` to ask an active child a question.
 - If `subagent_wait` returns `reason: "subagent_message"`, handle the visible request or response and wait for the job again only when needed.
 - Answer a child-originated request by calling `subagent_send` with its `requestId`.
 
-Completion messages follow Pi's global tool-output expansion state and the `app.tools.expand` binding (`Ctrl+O` by default).
+Completion messages and child requests and responses follow Pi's global tool-output expansion state and the `app.tools.expand` binding (`Ctrl+O` by default).
+Collapsed messages show a summary and the configured expansion key; expanded messages show the full content.
+This display state does not change the content sent to the model.
 
 In TUI mode, the above-editor widget shows each queued or running job's ID, state, elapsed time, timeout, and selected core and extension tool names.
 It omits fixed communication tools, attachment paths, and resource totals, disappears when no jobs remain active, and clears when the session ends.
 
+## 💬 Commands
+
+`/subagents` opens a manager for current-session job metadata, confirmed cancellation of active jobs, display settings, status, and help.
+`/subagents settings` opens the same settings screen directly.
+These are the only accepted routes; unknown arguments and trailing input are rejected.
+
+The manager supports TUI and RPC modes. RPC uses dialogs and reports the settings file path instead of opening a settings editor.
+Print and JSON modes reject these interactive commands with an error; the model tools remain available.
+Job lists and details always show job IDs, regardless of widget preferences, and omit task text and child output.
+Jobs do not survive reload or session replacement.
+
 ## 🛠️ Tools
 
 The main Pi session exposes five fixed tools:
@@ -113,6 +133,30 @@ The terminal states are `completed`, `partial`, `failed`, `timed_out`, and `canc
 
 See [`docs/tools.md`](./docs/tools.md) for the concise schema reference, [`docs/attachments.md`](./docs/attachments.md) for attachment validation, and [`docs/messaging.md`](./docs/messaging.md) for messaging behavior.
 
+## ⚙️ Settings
+
+Use `/subagents settings` or the manager's Settings action to edit user display preferences.
+All four fields accept JSON booleans and default to `true`:
+
+| Field | Effect |
+| --- | --- |
+| `showWidget` | Show the above-editor widget. |
+| `showJobId` | Show job IDs in widget rows. |
+| `showTools` | Show selected tool names in widget rows. |
+| `showTiming` | Show elapsed time and timeout in widget rows. |
+
+Successful UI saves apply immediately. Hiding the widget does not stop jobs, change model tools, or suppress completion messages.
+Showing it again displays currently active jobs with the other saved preferences. Job state and the task preview remain visible when the widget is enabled.
+Escape returns or closes without undoing completed saves; Ctrl+C closes the entire flow.
+Settings uses Pi's configured selection keys. Its footer shows only the hard-cancel key to avoid displaying fixed keys that do not match your bindings.
+
+Preferences are saved in `<getAgentDir()>/pi-subagents.json`, normally `~/.pi/agent/pi-subagents.json`.
+Only user settings are supported; project files and legacy settings are not read. User fields override code defaults.
+Manual file edits are re-read on `session_start`, including `/reload`, and before each UI save.
+Reading defaults creates no file. Invalid values produce diagnostics and use their defaults; malformed documents block saves until repaired.
+Saves preserve unknown fields, publish atomically, and keep reads and writes ordered within one Pi process. Separate Pi processes are not locked.
+A failed save keeps the previous effective preference and reports the error.
+
 ## ⚙️ Job configuration
 
 The task should state the child's role, objective, scope, constraints, and expected result.
@@ -188,7 +232,8 @@ Use these replacements where the new job model supports the previous intent:
 | Running main-to-child questions | Main and child `subagent_send` |
 
 The version 3 `subagent_send` contracts are not compatible with the legacy retained-agent follow-up tool of the same name.
-The `/subagents` command, extension settings, legacy retained follow-ups, `subagent_mailbox`, `subagent_consult`, custom agent catalogs, advanced orchestration, alternate transports, trust-aware cwd policy, and extension-owned worktrees have no direct replacement.
+The current `/subagents` manager provides job metadata, cancellation, and widget preferences; it does not restore the legacy management workflows or settings.
+Legacy retained follow-ups, `subagent_mailbox`, `subagent_consult`, custom agent catalogs, advanced orchestration, alternate transports, trust-aware cwd policy, and extension-owned worktrees have no direct replacement.
 Describe the child's specialization in `task` and grant only the required work tools through `tools`.
 
 ## 🔒 Security and privacy
@@ -236,7 +281,10 @@ Parallel writers require disjoint ownership or workspace isolation outside this
 packages/pi-subagents/
 ├── src/                               # Authoritative implementation and helpers
 │   ├── index.ts                       # Thin Pi entrypoint
-│   └── subagents.ts                   # Job, broker, and child lifecycle
+│   ├── subagents.ts                   # Commands and session lifecycle
+│   ├── menu.ts                        # Job manager
+│   ├── settings.ts                    # User preferences and atomic storage
+│   └── settings-ui.ts                 # Native settings editor
 ├── dist/                              # Generated Jiti runtime, child bridge, and readiness probe
 ├── scripts/build-runtime.mjs          # Runtime builder
 ├── docs/                              # Published reference documentation

package/dist/chunks/chunk-FY5HIU6Y.ts

@@ -0,0 +1,42 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated entries use .ts extensions for Pi's Jiti loader.
+
+// src/types.ts
+var JOB_STATES = ["queued", "running", "completed", "partial", "failed", "timed_out", "cancelled"];
+var TERMINAL_JOB_STATES = /* @__PURE__ */ new Set([
+  "completed",
+  "partial",
+  "failed",
+  "timed_out",
+  "cancelled"
+]);
+var CHILD_CORE_TOOL_NAMES = [
+  "read",
+  "bash",
+  "powershell",
+  "edit",
+  "write",
+  "grep",
+  "find",
+  "ls",
+  "codemode"
+];
+var DEFAULT_SUBAGENT_TOOLS = ["read", "grep", "find", "ls"];
+var SUBAGENT_THINKING_LEVELS = [
+  "off",
+  "minimal",
+  "low",
+  "medium",
+  "high",
+  "xhigh",
+  "max"
+];
+
+export {
+  JOB_STATES,
+  TERMINAL_JOB_STATES,
+  CHILD_CORE_TOOL_NAMES,
+  DEFAULT_SUBAGENT_TOOLS,
+  SUBAGENT_THINKING_LEVELS
+};
+//# sourceMappingURL=chunk-FY5HIU6Y.ts.map

package/dist/chunks/chunk-FY5HIU6Y.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/types.ts"],
+  "sourcesContent": ["import type { ModelThinkingLevel } from \"@earendil-works/pi-ai\";\nimport type { ExtensionAttachment } from \"./resource-attachments.js\";\n\nexport const JOB_STATES = [\"queued\", \"running\", \"completed\", \"partial\", \"failed\", \"timed_out\", \"cancelled\"] as const;\n\nexport type SubagentJobState = (typeof JOB_STATES)[number];\n\nexport const TERMINAL_JOB_STATES = new Set<SubagentJobState>([\n  \"completed\",\n  \"partial\",\n  \"failed\",\n  \"timed_out\",\n  \"cancelled\",\n]);\n\nexport const CHILD_CORE_TOOL_NAMES = [\n  \"read\",\n  \"bash\",\n  \"powershell\",\n  \"edit\",\n  \"write\",\n  \"grep\",\n  \"find\",\n  \"ls\",\n  \"codemode\",\n] as const;\nexport const DEFAULT_SUBAGENT_TOOLS = [\"read\", \"grep\", \"find\", \"ls\"] as const;\nexport const SUBAGENT_THINKING_LEVELS = [\n  \"off\",\n  \"minimal\",\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n  \"max\",\n] as const satisfies readonly ModelThinkingLevel[];\nexport type SubagentThinkingLevel = (typeof SUBAGENT_THINKING_LEVELS)[number];\n\nexport interface ChildResult {\n  state: Extract<SubagentJobState, \"completed\" | \"partial\" | \"failed\" | \"timed_out\" | \"cancelled\">;\n  result?: string;\n  error?: string;\n  limitations: string[];\n  truncated: boolean;\n}\n\nexport interface BrokerCredentials {\n  host: \"127.0.0.1\";\n  port: number;\n  token: string;\n}\n\nexport interface ChildControl {\n  send(message: string, signal?: AbortSignal): Promise<void>;\n}\n\nexport interface ChildRequest {\n  task: string;\n  tools: string[];\n  skills: string[];\n  extensions: ExtensionAttachment[];\n  toolSources: Record<string, string[]>;\n  model: string;\n  thinkingLevel: SubagentThinkingLevel;\n  cwd: string;\n  timeout?: number;\n  projectTrusted: boolean;\n  communication: BrokerCredentials;\n  signal: AbortSignal;\n  onControl?: (control: ChildControl) => void;\n}\n\nexport interface JobSummary {\n  jobId: string;\n  state: SubagentJobState;\n  createdAt: number;\n  startedAt?: number;\n  finishedAt?: number;\n  timeout?: number;\n  resultSummary?: string;\n  errorSummary?: string;\n}\n"],
+  "mappings": ";;;;AAGO,IAAM,aAAa,CAAC,UAAU,WAAW,aAAa,WAAW,UAAU,aAAa,WAAW;AAInG,IAAM,sBAAsB,oBAAI,IAAsB;AAAA,EAC3D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AACO,IAAM,yBAAyB,CAAC,QAAQ,QAAQ,QAAQ,IAAI;AAC5D,IAAM,2BAA2B;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;",
+  "names": []
+}

package/dist/chunks/menu-KAIUEWL7.ts

@@ -0,0 +1,171 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated entries use .ts extensions for Pi's Jiti loader.
+import {
+  JOB_STATES
+} from "./chunk-FY5HIU6Y.ts";
+
+// src/menu.ts
+import { defineMenu, runConfirmation, runMenu, runTask, sanitizeTerminalText } from "@narumitw/pi-tui-kit";
+async function showSubagentsMenu(ctx, options) {
+  if (options.signal.aborted || !options.isCurrent()) return;
+  let selectedJobId;
+  const current = (signal) => !signal.aborted && options.isCurrent();
+  const menu = defineMenu({
+    start: "main",
+    screens: {
+      main: ({ state }) => ({
+        kind: "actions",
+        title: "Subagents",
+        lines: [jobCounts(state)],
+        items: [
+          { id: "jobs", label: "Jobs", to: "jobs" },
+          { id: "settings", label: "Settings", action: "settings" },
+          { id: "status", label: "Status", to: "status" },
+          { id: "help", label: "Help", to: "help" },
+          { id: "close", label: "Close", close: true }
+        ],
+        hint: "close"
+      }),
+      jobs: ({ state }) => ({
+        kind: "choice",
+        title: "Subagent Jobs",
+        lines: [jobCounts(state), ...state.jobs.length === 0 ? ["No jobs in this session."] : []],
+        items: state.jobs.map((job) => ({
+          id: job.jobId,
+          label: sanitizeTerminalText(job.jobId),
+          description: sanitizeTerminalText(job.state)
+        })),
+        action: "selectJob",
+        hint: "back"
+      }),
+      job: ({ state }) => {
+        const job = state.jobs.find((candidate) => candidate.jobId === selectedJobId);
+        return {
+          kind: "actions",
+          title: "Subagent Job",
+          lines: job ? jobLines(job) : ["This job is no longer available."],
+          items: job && isActive(job) ? [{ id: "cancel", label: "Cancel job\u2026", action: "cancelJob" }] : [],
+          hint: "back"
+        };
+      },
+      status: ({ state }) => ({
+        kind: "detail",
+        title: "Subagents Status",
+        lines: [
+          "Runtime: active for this session",
+          `Retained jobs: ${state.jobs.length}`,
+          `Active jobs: ${state.jobs.filter(isActive).length}`,
+          `Omitted jobs: ${state.omitted}`,
+          ...JOB_STATES.map((status) => `${status}: ${state.jobs.filter((job) => job.state === status).length}`),
+          `Show widget: ${state.settings.showWidget}`,
+          `Show job ID: ${state.settings.showJobId}`,
+          `Show tools: ${state.settings.showTools}`,
+          `Show timing: ${state.settings.showTiming}`,
+          `User settings: ${sanitizeTerminalText(state.settingsPath)}`
+        ],
+        hint: "back"
+      }),
+      help: () => ({
+        kind: "detail",
+        title: "Subagents Help",
+        lines: [
+          "/subagents opens the job manager.",
+          "/subagents settings opens the same settings screen directly.",
+          "Jobs shows this session's job summaries. Only queued or running jobs can be cancelled, after confirmation.",
+          "The model uses subagent_spawn to start jobs, subagent_inspect to check them, and subagent_wait to wait for results.",
+          "subagent_send sends a message; subagent_cancel cancels a job.",
+          "Jobs are session-only. The runtime retains up to 32 terminal jobs for up to 24 hours.",
+          "Settings changes display preferences only. All four settings default to true.",
+          "Successful saves apply immediately. Use /reload after manual settings edits.",
+          "In RPC mode, Settings reports the user settings file path."
+        ],
+        hint: "back"
+      })
+    },
+    actions: {
+      selectJob: ({ itemId, signal }) => {
+        if (!current(signal)) return { kind: "close" };
+        if (!options.getState().jobs.some((job) => job.jobId === itemId)) return { kind: "stay" };
+        selectedJobId = itemId;
+        return { kind: "to", screen: "job" };
+      },
+      settings: async ({ signal }) => {
+        if (!current(signal)) return { kind: "close" };
+        const reason = await options.showSettings(signal);
+        return { kind: current(signal) && reason === "back" ? "stay" : "close" };
+      },
+      cancelJob: async ({ signal }) => {
+        if (!current(signal)) return { kind: "close" };
+        const jobId = selectedJobId;
+        const job = options.getState().jobs.find((candidate) => candidate.jobId === jobId);
+        if (!job || !isActive(job)) return { kind: "stay" };
+        const confirmation = await runConfirmation(ctx, {
+          title: "Cancel subagent job?",
+          message: `Cancel job ${sanitizeTerminalText(job.jobId)} (${sanitizeTerminalText(job.state)})?`,
+          confirmLabel: "Cancel job",
+          cancelLabel: "Keep job",
+          signal,
+          isCurrent: options.isCurrent,
+          onError: () => void 0
+        });
+        if (!current(signal)) return { kind: "close" };
+        if (confirmation.kind === "closed") {
+          return { kind: confirmation.reason === "close" ? "close" : "stay" };
+        }
+        if (confirmation.kind === "error") throw confirmation.error;
+        if (confirmation.kind !== "confirmed") return { kind: "close" };
+        const latest = options.getState().jobs.find((candidate) => candidate.jobId === jobId);
+        if (selectedJobId !== jobId || !latest || !isActive(latest)) return { kind: "stay" };
+        const result = await runTask(ctx, {
+          label: "Cancelling subagent job\u2026",
+          signal,
+          isCurrent: options.isCurrent,
+          task: ({ signal: taskSignal }) => options.cancelJob(latest.jobId, taskSignal),
+          onError: () => void 0
+        });
+        if (!current(signal)) return { kind: "close" };
+        if (result.kind === "error") throw result.error;
+        if (result.kind === "stale") return { kind: "close" };
+        if (result.kind === "cancelled") return { kind: "close" };
+        return { kind: "stay" };
+      }
+    }
+  });
+  await runMenu(ctx, menu, {
+    signal: options.signal,
+    isCurrent: options.isCurrent,
+    getState: options.getState,
+    onError: (_ctx, error) => {
+      if (!options.signal.aborted && options.isCurrent() && ctx.hasUI) {
+        ctx.ui.notify(
+          sanitizeTerminalText(`Subagents menu failed: ${error instanceof Error ? error.message : String(error)}`),
+          "error"
+        );
+      }
+    }
+  });
+}
+function isActive(job) {
+  return job.state === "queued" || job.state === "running";
+}
+function jobCounts(state) {
+  return `Jobs: ${state.jobs.length} shown, ${state.jobs.filter(isActive).length} active, ${state.omitted} omitted`;
+}
+function jobLines(job) {
+  return [
+    `Job ID: ${sanitizeTerminalText(job.jobId)}`,
+    `State: ${sanitizeTerminalText(job.state)}`,
+    `Created: ${timestamp(job.createdAt)}`,
+    ...job.startedAt === void 0 ? [] : [`Started: ${timestamp(job.startedAt)}`],
+    ...job.finishedAt === void 0 ? [] : [`Finished: ${timestamp(job.finishedAt)}`],
+    ...job.timeout === void 0 ? [] : [`Timeout: ${job.timeout} seconds`]
+  ];
+}
+function timestamp(value) {
+  const date = new Date(value);
+  return Number.isFinite(date.getTime()) ? date.toISOString() : "unknown";
+}
+export {
+  showSubagentsMenu
+};
+//# sourceMappingURL=menu-KAIUEWL7.ts.map

package/dist/chunks/menu-KAIUEWL7.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/menu.ts"],
+  "sourcesContent": ["import type { ExtensionCommandContext } from \"@earendil-works/pi-coding-agent\";\nimport { defineMenu, runConfirmation, runMenu, runTask, sanitizeTerminalText } from \"@narumitw/pi-tui-kit\";\nimport type { SubagentSettings } from \"./settings.js\";\nimport { JOB_STATES, type JobSummary } from \"./types.js\";\n\ninterface SubagentsMenuState {\n  settings: SubagentSettings;\n  settingsPath: string;\n  jobs: JobSummary[];\n  omitted: number;\n}\n\ninterface SubagentsMenuOptions {\n  signal: AbortSignal;\n  isCurrent(): boolean;\n  getState(): SubagentsMenuState;\n  cancelJob(jobId: string, signal: AbortSignal): Promise<void>;\n  showSettings(signal: AbortSignal): Promise<\"back\" | \"close\" | \"stale\">;\n}\n\nexport async function showSubagentsMenu(ctx: ExtensionCommandContext, options: SubagentsMenuOptions): Promise<void> {\n  if (options.signal.aborted || !options.isCurrent()) return;\n  let selectedJobId: string | undefined;\n  const current = (signal: AbortSignal) => !signal.aborted && options.isCurrent();\n  const menu = defineMenu<\n    SubagentsMenuState,\n    \"main\" | \"jobs\" | \"job\" | \"status\" | \"help\",\n    \"selectJob\" | \"cancelJob\" | \"settings\"\n  >({\n    start: \"main\",\n    screens: {\n      main: ({ state }) => ({\n        kind: \"actions\",\n        title: \"Subagents\",\n        lines: [jobCounts(state)],\n        items: [\n          { id: \"jobs\", label: \"Jobs\", to: \"jobs\" },\n          { id: \"settings\", label: \"Settings\", action: \"settings\" },\n          { id: \"status\", label: \"Status\", to: \"status\" },\n          { id: \"help\", label: \"Help\", to: \"help\" },\n          { id: \"close\", label: \"Close\", close: true },\n        ],\n        hint: \"close\",\n      }),\n      jobs: ({ state }) => ({\n        kind: \"choice\",\n        title: \"Subagent Jobs\",\n        lines: [jobCounts(state), ...(state.jobs.length === 0 ? [\"No jobs in this session.\"] : [])],\n        items: state.jobs.map((job) => ({\n          id: job.jobId,\n          label: sanitizeTerminalText(job.jobId),\n          description: sanitizeTerminalText(job.state),\n        })),\n        action: \"selectJob\",\n        hint: \"back\",\n      }),\n      job: ({ state }) => {\n        const job = state.jobs.find((candidate) => candidate.jobId === selectedJobId);\n        return {\n          kind: \"actions\",\n          title: \"Subagent Job\",\n          lines: job ? jobLines(job) : [\"This job is no longer available.\"],\n          items: job && isActive(job) ? [{ id: \"cancel\", label: \"Cancel job\u2026\", action: \"cancelJob\" }] : [],\n          hint: \"back\",\n        };\n      },\n      status: ({ state }) => ({\n        kind: \"detail\",\n        title: \"Subagents Status\",\n        lines: [\n          \"Runtime: active for this session\",\n          `Retained jobs: ${state.jobs.length}`,\n          `Active jobs: ${state.jobs.filter(isActive).length}`,\n          `Omitted jobs: ${state.omitted}`,\n          ...JOB_STATES.map((status) => `${status}: ${state.jobs.filter((job) => job.state === status).length}`),\n          `Show widget: ${state.settings.showWidget}`,\n          `Show job ID: ${state.settings.showJobId}`,\n          `Show tools: ${state.settings.showTools}`,\n          `Show timing: ${state.settings.showTiming}`,\n          `User settings: ${sanitizeTerminalText(state.settingsPath)}`,\n        ],\n        hint: \"back\",\n      }),\n      help: () => ({\n        kind: \"detail\",\n        title: \"Subagents Help\",\n        lines: [\n          \"/subagents opens the job manager.\",\n          \"/subagents settings opens the same settings screen directly.\",\n          \"Jobs shows this session's job summaries. Only queued or running jobs can be cancelled, after confirmation.\",\n          \"The model uses subagent_spawn to start jobs, subagent_inspect to check them, and subagent_wait to wait for results.\",\n          \"subagent_send sends a message; subagent_cancel cancels a job.\",\n          \"Jobs are session-only. The runtime retains up to 32 terminal jobs for up to 24 hours.\",\n          \"Settings changes display preferences only. All four settings default to true.\",\n          \"Successful saves apply immediately. Use /reload after manual settings edits.\",\n          \"In RPC mode, Settings reports the user settings file path.\",\n        ],\n        hint: \"back\",\n      }),\n    },\n    actions: {\n      selectJob: ({ itemId, signal }) => {\n        if (!current(signal)) return { kind: \"close\" };\n        if (!options.getState().jobs.some((job) => job.jobId === itemId)) return { kind: \"stay\" };\n        selectedJobId = itemId;\n        return { kind: \"to\", screen: \"job\" };\n      },\n      settings: async ({ signal }) => {\n        if (!current(signal)) return { kind: \"close\" };\n        const reason = await options.showSettings(signal);\n        return { kind: current(signal) && reason === \"back\" ? \"stay\" : \"close\" };\n      },\n      cancelJob: async ({ signal }) => {\n        if (!current(signal)) return { kind: \"close\" };\n        const jobId = selectedJobId;\n        const job = options.getState().jobs.find((candidate) => candidate.jobId === jobId);\n        if (!job || !isActive(job)) return { kind: \"stay\" };\n        const confirmation = await runConfirmation(ctx, {\n          title: \"Cancel subagent job?\",\n          message: `Cancel job ${sanitizeTerminalText(job.jobId)} (${sanitizeTerminalText(job.state)})?`,\n          confirmLabel: \"Cancel job\",\n          cancelLabel: \"Keep job\",\n          signal,\n          isCurrent: options.isCurrent,\n          onError: () => undefined,\n        });\n        if (!current(signal)) return { kind: \"close\" };\n        if (confirmation.kind === \"closed\") {\n          return { kind: confirmation.reason === \"close\" ? \"close\" : \"stay\" };\n        }\n        if (confirmation.kind === \"error\") throw confirmation.error;\n        if (confirmation.kind !== \"confirmed\") return { kind: \"close\" };\n        // The runtime can finish or remove a job while its confirmation is open.\n        const latest = options.getState().jobs.find((candidate) => candidate.jobId === jobId);\n        if (selectedJobId !== jobId || !latest || !isActive(latest)) return { kind: \"stay\" };\n        const result = await runTask(ctx, {\n          label: \"Cancelling subagent job\u2026\",\n          signal,\n          isCurrent: options.isCurrent,\n          task: ({ signal: taskSignal }) => options.cancelJob(latest.jobId, taskSignal),\n          onError: () => undefined,\n        });\n        if (!current(signal)) return { kind: \"close\" };\n        if (result.kind === \"error\") throw result.error;\n        if (result.kind === \"stale\") return { kind: \"close\" };\n        if (result.kind === \"cancelled\") return { kind: \"close\" };\n        return { kind: \"stay\" };\n      },\n    },\n  });\n  await runMenu(ctx, menu, {\n    signal: options.signal,\n    isCurrent: options.isCurrent,\n    getState: options.getState,\n    onError: (_ctx, error) => {\n      if (!options.signal.aborted && options.isCurrent() && ctx.hasUI) {\n        ctx.ui.notify(\n          sanitizeTerminalText(`Subagents menu failed: ${error instanceof Error ? error.message : String(error)}`),\n          \"error\",\n        );\n      }\n    },\n  });\n}\n\nfunction isActive(job: JobSummary): boolean {\n  return job.state === \"queued\" || job.state === \"running\";\n}\n\nfunction jobCounts(state: SubagentsMenuState): string {\n  return `Jobs: ${state.jobs.length} shown, ${state.jobs.filter(isActive).length} active, ${state.omitted} omitted`;\n}\n\nfunction jobLines(job: JobSummary): string[] {\n  return [\n    `Job ID: ${sanitizeTerminalText(job.jobId)}`,\n    `State: ${sanitizeTerminalText(job.state)}`,\n    `Created: ${timestamp(job.createdAt)}`,\n    ...(job.startedAt === undefined ? [] : [`Started: ${timestamp(job.startedAt)}`]),\n    ...(job.finishedAt === undefined ? [] : [`Finished: ${timestamp(job.finishedAt)}`]),\n    ...(job.timeout === undefined ? [] : [`Timeout: ${job.timeout} seconds`]),\n  ];\n}\n\nfunction timestamp(value: number): string {\n  const date = new Date(value);\n  return Number.isFinite(date.getTime()) ? date.toISOString() : \"unknown\";\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunks/settings-ui-PSEYB6JX.ts

@@ -0,0 +1,196 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated entries use .ts extensions for Pi's Jiti loader.
+
+// src/settings-ui.ts
+import { stripVTControlCharacters } from "node:util";
+import { getSettingsListTheme } from "@earendil-works/pi-coding-agent";
+import {
+  Key,
+  matchesKey,
+  SettingsList,
+  Text,
+  truncateToWidth
+} from "@earendil-works/pi-tui";
+import { HorizontalRule, renderBoundedFrame, runCustomInteraction, sanitizeTerminalText } from "@narumitw/pi-tui-kit";
+var SETTINGS = [
+  { key: "showWidget", label: "Show widget", description: "Show subagent jobs above the editor." },
+  { key: "showJobId", label: "Show job ID", description: "Show job IDs in the widget." },
+  { key: "showTools", label: "Show tools", description: "Show active tools in the widget." },
+  { key: "showTiming", label: "Show timing", description: "Show job timing in the widget." }
+];
+async function showSubagentSettings(ctx, options) {
+  const result = await runCustomInteraction(ctx, {
+    signal: options.signal,
+    isCurrent: options.isCurrent,
+    // The command owner reports interaction failures and non-TUI settings paths.
+    onError: () => {
+    },
+    create({ tui, theme, signal, complete }) {
+      let queue = Promise.resolve();
+      const current = () => !signal.aborted && options.isCurrent();
+      const revisions = /* @__PURE__ */ new Map();
+      const pending = /* @__PURE__ */ new Map();
+      const mouseRows = /* @__PURE__ */ new Map();
+      let renderedWidth = 0;
+      let contentHeight = 0;
+      let mousePressed = false;
+      const reportFailure = (message) => {
+        if (!current()) return;
+        try {
+          ctx.ui.notify(sanitizeTerminalText(`Could not save pi-subagents.json: ${message}`), "error");
+        } catch {
+        }
+      };
+      const rule = new HorizontalRule({ ruleStyle: (text) => theme.fg("border", text) });
+      const listTheme = {
+        ...getSettingsListTheme(),
+        label: (text, selected) => selected ? theme.fg("accent", text) : text,
+        value: (text, selected) => theme.fg(selected ? "accent" : "muted", text),
+        description: (text) => theme.fg("dim", text),
+        cursor: theme.fg("accent", "\u2192 "),
+        hint: (text) => theme.fg("dim", text)
+      };
+      const initial = options.get();
+      const items = SETTINGS.map(({ key, label, description }) => ({
+        id: key,
+        label,
+        description,
+        currentValue: String(initial[key]),
+        values: ["true", "false"]
+      }));
+      const list = new SettingsList(
+        items,
+        items.length,
+        listTheme,
+        (id, value) => {
+          if (!current()) return;
+          const key = id;
+          const revision = (revisions.get(id) ?? 0) + 1;
+          revisions.set(id, revision);
+          pending.set(id, revision);
+          queue = queue.then(async () => {
+            if (!current()) {
+              complete("stale");
+              return;
+            }
+            const before = { ...options.get() };
+            let effective = before;
+            try {
+              const settings = await options.save(key, value === "true", signal);
+              if (!options.isCurrent()) {
+                complete("stale");
+                return;
+              }
+              options.apply(settings);
+              effective = options.get();
+            } catch (error) {
+              if (!options.isCurrent()) {
+                complete("stale");
+                return;
+              }
+              let message = error instanceof Error ? error.message : String(error);
+              try {
+                options.apply(before);
+              } catch (rollbackError) {
+                message += `; could not restore effective settings: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`;
+              }
+              reportFailure(message);
+            }
+            if (!current()) return;
+            if (pending.get(id) === revision) pending.delete(id);
+            for (const { key: settingKey } of SETTINGS) {
+              if (!pending.has(settingKey)) list.updateValue(settingKey, String(effective[settingKey]));
+            }
+            tui.requestRender();
+          }).catch((error) => {
+            reportFailure(error instanceof Error ? error.message : String(error));
+          });
+        },
+        () => complete("back")
+      );
+      return {
+        render(width) {
+          if (!current()) complete("stale");
+          renderedWidth = Number.isFinite(width) ? Math.max(0, Math.floor(width)) : 0;
+          listTheme.cursor = theme.fg("accent", "\u2192 ");
+          const content = list.render(Math.max(4, renderedWidth)).slice(0, -2);
+          contentHeight = content.length;
+          const focusedRow = content.findIndex((line) => stripVTControlCharacters(line).startsWith("\u2192"));
+          mouseRows.clear();
+          const tokens = /* @__PURE__ */ new Map();
+          const layout = content.map((line, index) => {
+            if (!stripVTControlCharacters(line).trim()) return line;
+            const token = `content:${index}`;
+            tokens.set(token, index);
+            return token;
+          });
+          const terminalRows = Number.isFinite(tui.terminal.rows) ? Math.floor(tui.terminal.rows) : 24;
+          const frame = renderBoundedFrame({
+            width: Math.max(renderedWidth, `content:${content.length}`.length),
+            maxRows: Math.max(1, terminalRows - 3),
+            rule: rule.render(renderedWidth)[0] ?? "",
+            title: new Text(theme.fg("accent", theme.bold("Subagents Settings")), 0, 0).render(renderedWidth),
+            context: [theme.fg("muted", "Saved changes apply immediately.")],
+            content: layout,
+            hints: new Text(theme.fg("muted", "Ctrl+C close"), 0, 0).render(renderedWidth),
+            priorityRows: focusedRow < 0 ? [] : [focusedRow],
+            focusedRow
+          });
+          return frame.map((line, row) => {
+            const nativeRow = tokens.get(line);
+            if (nativeRow !== void 0) mouseRows.set(row, nativeRow);
+            return truncateToWidth(nativeRow === void 0 ? line : content[nativeRow] ?? "", renderedWidth, "");
+          });
+        },
+        invalidate() {
+          mouseRows.clear();
+          mousePressed = false;
+          list.invalidate();
+        },
+        handleInput(data) {
+          if (!current()) return complete("stale");
+          mouseRows.clear();
+          mousePressed = false;
+          if (matchesKey(data, Key.ctrl("c"))) complete("close");
+          else {
+            list.handleInput(data);
+          }
+          tui.requestRender();
+        },
+        handleMouse(event) {
+          if (!current()) {
+            complete("stale");
+            return;
+          }
+          const nativeRow = mouseRows.get(event.y);
+          if (nativeRow === void 0 || event.x < 0 || event.x >= renderedWidth) {
+            if (event.button === "left" && (event.type === "press" || event.type === "click")) mousePressed = false;
+            return;
+          }
+          const nativeEvent = { ...event, y: nativeRow, width: renderedWidth, height: contentHeight };
+          if (event.type === "click" && event.button === "left" && !mousePressed) {
+            list.handleMouse({ ...nativeEvent, type: "press" });
+          }
+          const result2 = list.handleMouse(nativeEvent);
+          if (event.type === "press" && event.button === "left") mousePressed = result2?.handled === true;
+          if (event.type === "click" || event.type === "wheel") mousePressed = false;
+          if (result2?.handled && result2.render !== false) tui.requestRender();
+          return result2;
+        },
+        waitForPending() {
+          return queue;
+        },
+        dispose() {
+          mouseRows.clear();
+          mousePressed = false;
+        }
+      };
+    }
+  });
+  if (result.kind === "error") throw result.error;
+  return result.kind === "completed" ? result.value : result.kind === "unsupported" ? "back" : "stale";
+}
+export {
+  showSubagentSettings
+};
+//# sourceMappingURL=settings-ui-PSEYB6JX.ts.map

package/dist/chunks/settings-ui-PSEYB6JX.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/settings-ui.ts"],
+  "sourcesContent": ["import { stripVTControlCharacters } from \"node:util\";\nimport { type ExtensionCommandContext, getSettingsListTheme } from \"@earendil-works/pi-coding-agent\";\nimport {\n  Key,\n  matchesKey,\n  type SettingItem,\n  SettingsList,\n  Text,\n  type TuiMouseEvent,\n  truncateToWidth,\n} from \"@earendil-works/pi-tui\";\nimport { HorizontalRule, renderBoundedFrame, runCustomInteraction, sanitizeTerminalText } from \"@narumitw/pi-tui-kit\";\nimport type { SubagentSettings } from \"./settings.js\";\n\ninterface SubagentSettingsUIOptions {\n  signal: AbortSignal;\n  isCurrent(): boolean;\n  get(): SubagentSettings;\n  save(key: keyof SubagentSettings, value: boolean, signal: AbortSignal): Promise<SubagentSettings>;\n  apply(settings: SubagentSettings): void;\n}\n\ntype CloseReason = \"back\" | \"close\" | \"stale\";\n\nconst SETTINGS: { key: keyof SubagentSettings; label: string; description: string }[] = [\n  { key: \"showWidget\", label: \"Show widget\", description: \"Show subagent jobs above the editor.\" },\n  { key: \"showJobId\", label: \"Show job ID\", description: \"Show job IDs in the widget.\" },\n  { key: \"showTools\", label: \"Show tools\", description: \"Show active tools in the widget.\" },\n  { key: \"showTiming\", label: \"Show timing\", description: \"Show job timing in the widget.\" },\n];\n\nexport async function showSubagentSettings(\n  ctx: ExtensionCommandContext,\n  options: SubagentSettingsUIOptions,\n): Promise<CloseReason> {\n  const result = await runCustomInteraction<CloseReason>(ctx, {\n    signal: options.signal,\n    isCurrent: options.isCurrent,\n    // The command owner reports interaction failures and non-TUI settings paths.\n    onError: () => {},\n    create({ tui, theme, signal, complete }) {\n      let queue = Promise.resolve();\n      const current = () => !signal.aborted && options.isCurrent();\n      const revisions = new Map<string, number>();\n      const pending = new Map<string, number>();\n      const mouseRows = new Map<number, number>();\n      let renderedWidth = 0;\n      let contentHeight = 0;\n      let mousePressed = false;\n      const reportFailure = (message: string) => {\n        if (!current()) return;\n        try {\n          ctx.ui.notify(sanitizeTerminalText(`Could not save pi-subagents.json: ${message}`), \"error\");\n        } catch {\n          // The host can dispose its notifier after the ownership check.\n        }\n      };\n      const rule = new HorizontalRule({ ruleStyle: (text) => theme.fg(\"border\", text) });\n      // Keep native SettingsList semantics, but use this screen's callback theme.\n      const listTheme = {\n        ...getSettingsListTheme(),\n        label: (text: string, selected: boolean) => (selected ? theme.fg(\"accent\", text) : text),\n        value: (text: string, selected: boolean) => theme.fg(selected ? \"accent\" : \"muted\", text),\n        description: (text: string) => theme.fg(\"dim\", text),\n        cursor: theme.fg(\"accent\", \"\u2192 \"),\n        hint: (text: string) => theme.fg(\"dim\", text),\n      };\n      const initial = options.get();\n      const items: SettingItem[] = SETTINGS.map(({ key, label, description }) => ({\n        id: key,\n        label,\n        description,\n        currentValue: String(initial[key]),\n        values: [\"true\", \"false\"],\n      }));\n      const list = new SettingsList(\n        items,\n        items.length,\n        listTheme,\n        (id, value) => {\n          if (!current()) return;\n          const key = id as keyof SubagentSettings;\n          const revision = (revisions.get(id) ?? 0) + 1;\n          revisions.set(id, revision);\n          pending.set(id, revision);\n          queue = queue\n            .then(async () => {\n              if (!current()) {\n                complete(\"stale\");\n                return;\n              }\n              const before = { ...options.get() };\n              let effective = before;\n              try {\n                const settings = await options.save(key, value === \"true\", signal);\n                // A successful rename is durable, even when closing aborted the save signal.\n                if (!options.isCurrent()) {\n                  complete(\"stale\");\n                  return;\n                }\n                options.apply(settings);\n                effective = options.get();\n              } catch (error) {\n                if (!options.isCurrent()) {\n                  complete(\"stale\");\n                  return;\n                }\n                let message = error instanceof Error ? error.message : String(error);\n                try {\n                  options.apply(before);\n                } catch (rollbackError) {\n                  message += `; could not restore effective settings: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`;\n                }\n                reportFailure(message);\n              }\n              if (!current()) return;\n              if (pending.get(id) === revision) pending.delete(id);\n              // Saving rereads the full document, including unrelated manual edits. Keep newer\n              // optimistic choices, but refresh every row with no outstanding user change.\n              for (const { key: settingKey } of SETTINGS) {\n                if (!pending.has(settingKey)) list.updateValue(settingKey, String(effective[settingKey]));\n              }\n              tui.requestRender();\n            })\n            .catch((error: unknown) => {\n              // A failed action must not prevent later requests from entering the queue.\n              reportFailure(error instanceof Error ? error.message : String(error));\n            });\n        },\n        () => complete(\"back\"),\n      );\n      return {\n        render(width: number) {\n          if (!current()) complete(\"stale\");\n          renderedWidth = Number.isFinite(width) ? Math.max(0, Math.floor(width)) : 0;\n          listTheme.cursor = theme.fg(\"accent\", \"\u2192 \");\n          // The native footer hardcodes keys. Advertise only the hard-cancel key owned here;\n          // configured native navigation, change, and Back actions remain unchanged.\n          const content = list.render(Math.max(4, renderedWidth)).slice(0, -2);\n          contentHeight = content.length;\n          const focusedRow = content.findIndex((line) => stripVTControlCharacters(line).startsWith(\"\u2192\"));\n          mouseRows.clear();\n          const tokens = new Map<string, number>();\n          const layout = content.map((line, index) => {\n            if (!stripVTControlCharacters(line).trim()) return line;\n            const token = `content:${index}`;\n            tokens.set(token, index);\n            return token;\n          });\n          const terminalRows = Number.isFinite(tui.terminal.rows) ? Math.floor(tui.terminal.rows) : 24;\n          const frame = renderBoundedFrame({\n            width: Math.max(renderedWidth, `content:${content.length}`.length),\n            maxRows: Math.max(1, terminalRows - 3),\n            rule: rule.render(renderedWidth)[0] ?? \"\",\n            title: new Text(theme.fg(\"accent\", theme.bold(\"Subagents Settings\")), 0, 0).render(renderedWidth),\n            context: [theme.fg(\"muted\", \"Saved changes apply immediately.\")],\n            content: layout,\n            hints: new Text(theme.fg(\"muted\", \"Ctrl+C close\"), 0, 0).render(renderedWidth),\n            priorityRows: focusedRow < 0 ? [] : [focusedRow],\n            focusedRow,\n          });\n          return frame.map((line, row) => {\n            const nativeRow = tokens.get(line);\n            if (nativeRow !== undefined) mouseRows.set(row, nativeRow);\n            return truncateToWidth(nativeRow === undefined ? line : (content[nativeRow] ?? \"\"), renderedWidth, \"\");\n          });\n        },\n        invalidate() {\n          mouseRows.clear();\n          mousePressed = false;\n          list.invalidate();\n        },\n        handleInput(data: string) {\n          if (!current()) return complete(\"stale\");\n          mouseRows.clear();\n          mousePressed = false;\n          if (matchesKey(data, Key.ctrl(\"c\"))) complete(\"close\");\n          else {\n            // SettingsList uses Pi's effective native keybindings for standard actions.\n            list.handleInput(data);\n          }\n          tui.requestRender();\n        },\n        handleMouse(event: TuiMouseEvent) {\n          if (!current()) {\n            complete(\"stale\");\n            return;\n          }\n          const nativeRow = mouseRows.get(event.y);\n          if (nativeRow === undefined || event.x < 0 || event.x >= renderedWidth) {\n            if (event.button === \"left\" && (event.type === \"press\" || event.type === \"click\")) mousePressed = false;\n            return;\n          }\n          const nativeEvent = { ...event, y: nativeRow, width: renderedWidth, height: contentHeight };\n          if (event.type === \"click\" && event.button === \"left\" && !mousePressed) {\n            list.handleMouse({ ...nativeEvent, type: \"press\" });\n          }\n          const result = list.handleMouse(nativeEvent);\n          if (event.type === \"press\" && event.button === \"left\") mousePressed = result?.handled === true;\n          if (event.type === \"click\" || event.type === \"wheel\") mousePressed = false;\n          if (result?.handled && result.render !== false) tui.requestRender();\n          return result;\n        },\n        waitForPending() {\n          return queue;\n        },\n        dispose() {\n          mouseRows.clear();\n          mousePressed = false;\n        },\n      };\n    },\n  });\n  if (result.kind === \"error\") throw result.error;\n  return result.kind === \"completed\" ? result.value : result.kind === \"unsupported\" ? \"back\" : \"stale\";\n}\n"],
+  "mappings": ";;;;AAAA,SAAS,gCAAgC;AACzC,SAAuC,4BAA4B;AACnE;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AACP,SAAS,gBAAgB,oBAAoB,sBAAsB,4BAA4B;AAa/F,IAAM,WAAkF;AAAA,EACtF,EAAE,KAAK,cAAc,OAAO,eAAe,aAAa,uCAAuC;AAAA,EAC/F,EAAE,KAAK,aAAa,OAAO,eAAe,aAAa,8BAA8B;AAAA,EACrF,EAAE,KAAK,aAAa,OAAO,cAAc,aAAa,mCAAmC;AAAA,EACzF,EAAE,KAAK,cAAc,OAAO,eAAe,aAAa,iCAAiC;AAC3F;AAEA,eAAsB,qBACpB,KACA,SACsB;AACtB,QAAM,SAAS,MAAM,qBAAkC,KAAK;AAAA,IAC1D,QAAQ,QAAQ;AAAA,IAChB,WAAW,QAAQ;AAAA;AAAA,IAEnB,SAAS,MAAM;AAAA,IAAC;AAAA,IAChB,OAAO,EAAE,KAAK,OAAO,QAAQ,SAAS,GAAG;AACvC,UAAI,QAAQ,QAAQ,QAAQ;AAC5B,YAAM,UAAU,MAAM,CAAC,OAAO,WAAW,QAAQ,UAAU;AAC3D,YAAM,YAAY,oBAAI,IAAoB;AAC1C,YAAM,UAAU,oBAAI,IAAoB;AACxC,YAAM,YAAY,oBAAI,IAAoB;AAC1C,UAAI,gBAAgB;AACpB,UAAI,gBAAgB;AACpB,UAAI,eAAe;AACnB,YAAM,gBAAgB,CAAC,YAAoB;AACzC,YAAI,CAAC,QAAQ,EAAG;AAChB,YAAI;AACF,cAAI,GAAG,OAAO,qBAAqB,qCAAqC,OAAO,EAAE,GAAG,OAAO;AAAA,QAC7F,QAAQ;AAAA,QAER;AAAA,MACF;AACA,YAAM,OAAO,IAAI,eAAe,EAAE,WAAW,CAAC,SAAS,MAAM,GAAG,UAAU,IAAI,EAAE,CAAC;AAEjF,YAAM,YAAY;AAAA,QAChB,GAAG,qBAAqB;AAAA,QACxB,OAAO,CAAC,MAAc,aAAuB,WAAW,MAAM,GAAG,UAAU,IAAI,IAAI;AAAA,QACnF,OAAO,CAAC,MAAc,aAAsB,MAAM,GAAG,WAAW,WAAW,SAAS,IAAI;AAAA,QACxF,aAAa,CAAC,SAAiB,MAAM,GAAG,OAAO,IAAI;AAAA,QACnD,QAAQ,MAAM,GAAG,UAAU,SAAI;AAAA,QAC/B,MAAM,CAAC,SAAiB,MAAM,GAAG,OAAO,IAAI;AAAA,MAC9C;AACA,YAAM,UAAU,QAAQ,IAAI;AAC5B,YAAM,QAAuB,SAAS,IAAI,CAAC,EAAE,KAAK,OAAO,YAAY,OAAO;AAAA,QAC1E,IAAI;AAAA,QACJ;AAAA,QACA;AAAA,QACA,cAAc,OAAO,QAAQ,GAAG,CAAC;AAAA,QACjC,QAAQ,CAAC,QAAQ,OAAO;AAAA,MAC1B,EAAE;AACF,YAAM,OAAO,IAAI;AAAA,QACf;AAAA,QACA,MAAM;AAAA,QACN;AAAA,QACA,CAAC,IAAI,UAAU;AACb,cAAI,CAAC,QAAQ,EAAG;AAChB,gBAAM,MAAM;AACZ,gBAAM,YAAY,UAAU,IAAI,EAAE,KAAK,KAAK;AAC5C,oBAAU,IAAI,IAAI,QAAQ;AAC1B,kBAAQ,IAAI,IAAI,QAAQ;AACxB,kBAAQ,MACL,KAAK,YAAY;AAChB,gBAAI,CAAC,QAAQ,GAAG;AACd,uBAAS,OAAO;AAChB;AAAA,YACF;AACA,kBAAM,SAAS,EAAE,GAAG,QAAQ,IAAI,EAAE;AAClC,gBAAI,YAAY;AAChB,gBAAI;AACF,oBAAM,WAAW,MAAM,QAAQ,KAAK,KAAK,UAAU,QAAQ,MAAM;AAEjE,kBAAI,CAAC,QAAQ,UAAU,GAAG;AACxB,yBAAS,OAAO;AAChB;AAAA,cACF;AACA,sBAAQ,MAAM,QAAQ;AACtB,0BAAY,QAAQ,IAAI;AAAA,YAC1B,SAAS,OAAO;AACd,kBAAI,CAAC,QAAQ,UAAU,GAAG;AACxB,yBAAS,OAAO;AAChB;AAAA,cACF;AACA,kBAAI,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACnE,kBAAI;AACF,wBAAQ,MAAM,MAAM;AAAA,cACtB,SAAS,eAAe;AACtB,2BAAW,2CAA2C,yBAAyB,QAAQ,cAAc,UAAU,OAAO,aAAa,CAAC;AAAA,cACtI;AACA,4BAAc,OAAO;AAAA,YACvB;AACA,gBAAI,CAAC,QAAQ,EAAG;AAChB,gBAAI,QAAQ,IAAI,EAAE,MAAM,SAAU,SAAQ,OAAO,EAAE;AAGnD,uBAAW,EAAE,KAAK,WAAW,KAAK,UAAU;AAC1C,kBAAI,CAAC,QAAQ,IAAI,UAAU,EAAG,MAAK,YAAY,YAAY,OAAO,UAAU,UAAU,CAAC,CAAC;AAAA,YAC1F;AACA,gBAAI,cAAc;AAAA,UACpB,CAAC,EACA,MAAM,CAAC,UAAmB;AAEzB,0BAAc,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,UACtE,CAAC;AAAA,QACL;AAAA,QACA,MAAM,SAAS,MAAM;AAAA,MACvB;AACA,aAAO;AAAA,QACL,OAAO,OAAe;AACpB,cAAI,CAAC,QAAQ,EAAG,UAAS,OAAO;AAChC,0BAAgB,OAAO,SAAS,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC,IAAI;AAC1E,oBAAU,SAAS,MAAM,GAAG,UAAU,SAAI;AAG1C,gBAAM,UAAU,KAAK,OAAO,KAAK,IAAI,GAAG,aAAa,CAAC,EAAE,MAAM,GAAG,EAAE;AACnE,0BAAgB,QAAQ;AACxB,gBAAM,aAAa,QAAQ,UAAU,CAAC,SAAS,yBAAyB,IAAI,EAAE,WAAW,QAAG,CAAC;AAC7F,oBAAU,MAAM;AAChB,gBAAM,SAAS,oBAAI,IAAoB;AACvC,gBAAM,SAAS,QAAQ,IAAI,CAAC,MAAM,UAAU;AAC1C,gBAAI,CAAC,yBAAyB,IAAI,EAAE,KAAK,EAAG,QAAO;AACnD,kBAAM,QAAQ,WAAW,KAAK;AAC9B,mBAAO,IAAI,OAAO,KAAK;AACvB,mBAAO;AAAA,UACT,CAAC;AACD,gBAAM,eAAe,OAAO,SAAS,IAAI,SAAS,IAAI,IAAI,KAAK,MAAM,IAAI,SAAS,IAAI,IAAI;AAC1F,gBAAM,QAAQ,mBAAmB;AAAA,YAC/B,OAAO,KAAK,IAAI,eAAe,WAAW,QAAQ,MAAM,GAAG,MAAM;AAAA,YACjE,SAAS,KAAK,IAAI,GAAG,eAAe,CAAC;AAAA,YACrC,MAAM,KAAK,OAAO,aAAa,EAAE,CAAC,KAAK;AAAA,YACvC,OAAO,IAAI,KAAK,MAAM,GAAG,UAAU,MAAM,KAAK,oBAAoB,CAAC,GAAG,GAAG,CAAC,EAAE,OAAO,aAAa;AAAA,YAChG,SAAS,CAAC,MAAM,GAAG,SAAS,kCAAkC,CAAC;AAAA,YAC/D,SAAS;AAAA,YACT,OAAO,IAAI,KAAK,MAAM,GAAG,SAAS,cAAc,GAAG,GAAG,CAAC,EAAE,OAAO,aAAa;AAAA,YAC7E,cAAc,aAAa,IAAI,CAAC,IAAI,CAAC,UAAU;AAAA,YAC/C;AAAA,UACF,CAAC;AACD,iBAAO,MAAM,IAAI,CAAC,MAAM,QAAQ;AAC9B,kBAAM,YAAY,OAAO,IAAI,IAAI;AACjC,gBAAI,cAAc,OAAW,WAAU,IAAI,KAAK,SAAS;AACzD,mBAAO,gBAAgB,cAAc,SAAY,OAAQ,QAAQ,SAAS,KAAK,IAAK,eAAe,EAAE;AAAA,UACvG,CAAC;AAAA,QACH;AAAA,QACA,aAAa;AACX,oBAAU,MAAM;AAChB,yBAAe;AACf,eAAK,WAAW;AAAA,QAClB;AAAA,QACA,YAAY,MAAc;AACxB,cAAI,CAAC,QAAQ,EAAG,QAAO,SAAS,OAAO;AACvC,oBAAU,MAAM;AAChB,yBAAe;AACf,cAAI,WAAW,MAAM,IAAI,KAAK,GAAG,CAAC,EAAG,UAAS,OAAO;AAAA,eAChD;AAEH,iBAAK,YAAY,IAAI;AAAA,UACvB;AACA,cAAI,cAAc;AAAA,QACpB;AAAA,QACA,YAAY,OAAsB;AAChC,cAAI,CAAC,QAAQ,GAAG;AACd,qBAAS,OAAO;AAChB;AAAA,UACF;AACA,gBAAM,YAAY,UAAU,IAAI,MAAM,CAAC;AACvC,cAAI,cAAc,UAAa,MAAM,IAAI,KAAK,MAAM,KAAK,eAAe;AACtE,gBAAI,MAAM,WAAW,WAAW,MAAM,SAAS,WAAW,MAAM,SAAS,SAAU,gBAAe;AAClG;AAAA,UACF;AACA,gBAAM,cAAc,EAAE,GAAG,OAAO,GAAG,WAAW,OAAO,eAAe,QAAQ,cAAc;AAC1F,cAAI,MAAM,SAAS,WAAW,MAAM,WAAW,UAAU,CAAC,cAAc;AACtE,iBAAK,YAAY,EAAE,GAAG,aAAa,MAAM,QAAQ,CAAC;AAAA,UACpD;AACA,gBAAMA,UAAS,KAAK,YAAY,WAAW;AAC3C,cAAI,MAAM,SAAS,WAAW,MAAM,WAAW,OAAQ,gBAAeA,SAAQ,YAAY;AAC1F,cAAI,MAAM,SAAS,WAAW,MAAM,SAAS,QAAS,gBAAe;AACrE,cAAIA,SAAQ,WAAWA,QAAO,WAAW,MAAO,KAAI,cAAc;AAClE,iBAAOA;AAAA,QACT;AAAA,QACA,iBAAiB;AACf,iBAAO;AAAA,QACT;AAAA,QACA,UAAU;AACR,oBAAU,MAAM;AAChB,yBAAe;AAAA,QACjB;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AACD,MAAI,OAAO,SAAS,QAAS,OAAM,OAAO;AAC1C,SAAO,OAAO,SAAS,cAAc,OAAO,QAAQ,OAAO,SAAS,gBAAgB,SAAS;AAC/F;",
+  "names": ["result"]
+}