@rol1n/pi-kit 0.1.0 → 0.1.2

package/extensions/memory-log/README.md

@@ -1,54 +0,0 @@
-# memory-log
-
-Observational memory for long Pi sessions: background observers distill conversation chunks, a ledger records observations, and a consolidator writes durable project memory. Compaction rebuilds context from the recorded memory and recent conversation.
-
-## Install
-
-```sh
-pi install npm:@rol1n/memory-log
-```
-
-Also included in `@rol1n/pi-kit`. The extension loads with new-session memory disabled by default.
-
-## Commands
-
-| Command | Action |
-|---|---|
-| `/mem-log on` / `/mem-log off` | Set the current session's memory gate |
-| `/mem-log status` or `/mem-log:status` | Inspect observation progress, workers, memory, and costs |
-| `/mem-log compact` or `/mem-log:compact` | Request compaction |
-| `/mem-log consolidate` or `/mem-log:consolidate` | Consolidate the observation pool |
-
-## Settings
-
-Add `memoryLog` to personal or project Pi settings. Project values override personal values:
-
-```json
-{
-  "memoryLog": {
-    "defaultEnabled": false,
-    "chunkTokens": 10000,
-    "poolTargetTokens": 10000,
-    "consolidateAtPoolTokens": 15000,
-    "compactAtContextTokens": 150000,
-    "tailTokens": 20000,
-    "journeyTargetTokens": 1000,
-    "observerConcurrency": 4,
-    "resumeAfterMidRunCompaction": true,
-    "passive": false,
-    "debugLog": false,
-    "models": {
-      "observer": { "thinking": "low" },
-      "consolidator": { "thinking": "medium" }
-    }
-  }
-}
-```
-
-Observer and consolidator model objects accept `provider`, `id`, and `thinking`. An explicitly configured model takes priority over the session model, followed by Pi's configured default model. `chunkOverlapTokens` defaults to zero.
-
-Environment overrides are `PI_OM_PASSIVE`, `PI_OM_OBSERVER_PROVIDER`, `PI_OM_OBSERVER_MODEL`, `PI_OM_OBSERVER_THINKING`, and the corresponding `PI_OM_CONSOLIDATOR_*` values. Passive mode disables automatic triggers separately from the session gate.
-
-## Storage and requirements
-
-Durable files live under `.memory/<session-id>/` in the working project, including topic files and `JOURNEY.md`. Gate changes and observation history are recorded in the Pi session ledger. Observer and consolidator workers require the `pi` executable and model credentials; they make additional model requests. Disabling memory aborts active background workers.

package/extensions/memory-log/hooks/compaction-trigger.ts

@@ -1,160 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import {
-  findLastCompactionIndex,
-  rawTokensAfterIndex,
-  rawTokensSinceLastCompaction,
-  type Entry,
-} from "../ledger/index.ts";
-import type { Runtime } from "../runtime.ts";
-
-export const RESUME_PROMPT =
-  "[automatic] Your context was just compacted to free space; no user message was sent. " +
-  "Continue exactly where you left off, as if the compaction had not happened.";
-
-export const RETRYABLE_ERROR_RE =
-  /overloaded|provider.?returned.?error|rate.?limit|too many requests|429|500|502|503|504|service.?unavailable|server.?error|internal.?error|network.?error|connection.?error|connection.?refused|connection.?lost|websocket.?closed|websocket.?error|other side closed|fetch failed|upstream.?connect|reset before headers|socket hang up|ended without|http2 request did not get a response|timed? out|timeout|terminated|retry delay/i;
-
-export function contextPressureTokens(
-  ctx: { getContextUsage?: () => { tokens: number | null } | undefined; sessionManager: { getBranch: () => Entry[] } },
-  threshold: number,
-): { tokens: number; due: boolean } {
-  const branch = ctx.sessionManager.getBranch();
-  if (branch.length === 0) return { tokens: 0, due: false };
-
-  // If the last entry on the branch is already a compaction, context was just compacted on this branch.
-  const lastEntry = branch[branch.length - 1];
-  if (lastEntry.type === "compaction") {
-    return { tokens: 0, due: false };
-  }
-
-  const lastCompactionIdx = findLastCompactionIndex(branch);
-  if (lastCompactionIdx !== -1) {
-    // If no new source entries exist after compaction, context has not grown since compaction.
-    const tokensSinceCompaction = rawTokensAfterIndex(branch, lastCompactionIdx);
-    if (tokensSinceCompaction === 0) {
-      return { tokens: 0, due: false };
-    }
-
-    // Check if any assistant message has responded after the compaction.
-    // In Pi, getContextUsage() returns tokens: null until an assistant message responds post-compaction.
-    let hasAssistantAfterCompaction = false;
-    for (let i = branch.length - 1; i > lastCompactionIdx; i--) {
-      const entry = branch[i];
-      if (entry.type === "message" && (entry.message as any)?.role === "assistant") {
-        hasAssistantAfterCompaction = true;
-        break;
-      }
-    }
-    if (!hasAssistantAfterCompaction) {
-      return { tokens: 0, due: false };
-    }
-  }
-
-  const live = ctx.getContextUsage?.()?.tokens;
-  if (live != null) {
-    return { tokens: live, due: live >= threshold };
-  }
-
-  const raw = rawTokensSinceLastCompaction(branch);
-  return { tokens: raw, due: raw >= threshold };
-}
-
-export function turnWillContinue(event: any): boolean {
-  const toolResults = event?.toolResults;
-  if (Array.isArray(toolResults) && toolResults.length > 0) return true;
-  const stop = event?.message?.stopReason;
-  return stop === "tool_use" || stop === "tool_calls";
-}
-
-/**
- * Register the automatic compaction trigger.
- *
- * NOTE on safe triggering vs mid-run aborts:
- * In Pi, `AgentSession.compact()` immediately calls `await this.abort()`, which calls
- * `this.agent.abort()`. Calling `ctx.compact()` during an active multi-turn tool chain
- * (`turn_end` while tool calls are executing or turn will continue) violently aborts the agent run.
- * This marks the active assistant message with `stopReason: "error"` and `errorMessage: "This operation was aborted"`,
- * which renders as a red error in the TUI.
- *
- * To trigger compaction safely without aborting active turns, automatic compaction is evaluated on `agent_end`
- * and deferred until the session is truly idle (`ctx.isIdle() === true`).
- */
-export function registerCompactionTrigger(pi: ExtensionAPI, runtime: Runtime): void {
-  pi.on("agent_start", () => {
-    // A new turn is starting — abort any pending deferred auto-compaction wait
-    if (runtime.autoCompactionController) {
-      runtime.autoCompactionController.abort();
-      runtime.autoCompactionController = undefined;
-      runtime.compactInFlight = false;
-    }
-  });
-
-  pi.on("agent_end", (event: any, ctx: any) => {
-    if (!runtime.enabled || runtime.config.passive) return;
-    if (runtime.compactInFlight) return;
-
-    // Check if the run ended with a retryable error (Pi will auto-retry)
-    const lastAssistant = [...(event?.messages ?? [])]
-      .reverse()
-      .find((m): m is Extract<typeof m, { role: "assistant" }> => m?.role === "assistant");
-    if (
-      lastAssistant &&
-      lastAssistant.stopReason === "error" &&
-      lastAssistant.errorMessage &&
-      RETRYABLE_ERROR_RE.test(lastAssistant.errorMessage)
-    ) {
-      return;
-    }
-
-    if (!contextPressureTokens(ctx, runtime.config.compactAtContextTokens).due) return;
-
-    const hasUI = ctx.hasUI;
-    const ui = ctx.ui;
-    runtime.compactInFlight = true;
-    const controller = new AbortController();
-    runtime.autoCompactionController = controller;
-    const signal = controller.signal;
-
-    void (async () => {
-      try {
-        // Yield to the event loop first so agent_end handlers settle
-        await new Promise((resolve) => setTimeout(resolve, 0));
-
-        // Poll isIdle() until the agent is truly idle so ctx.compact() does not abort an active run
-        while (typeof ctx.isIdle === "function" && !ctx.isIdle()) {
-          if (signal.aborted) return;
-          await new Promise((resolve) => setTimeout(resolve, 50));
-        }
-
-        if (signal.aborted) return;
-
-        // Re-check pressure after settling
-        if (!contextPressureTokens(ctx, runtime.config.compactAtContextTokens).due) {
-          runtime.compactInFlight = false;
-          runtime.autoCompactionController = undefined;
-          return;
-        }
-
-        if (hasUI) ui?.notify("memory-log: context threshold reached — compacting memory (waiting for pending observers)...", "info");
-
-        runtime.autoCompactionController = undefined;
-        ctx.compact({
-          onComplete: () => {
-            runtime.compactInFlight = false;
-            if (hasUI) ui?.notify("memory-log: memory compaction completed", "info");
-          },
-          onError: (error: { message: string }) => {
-            runtime.compactInFlight = false;
-            if (error.message === "Compaction cancelled") return;
-            if (hasUI) ui?.notify(`memory-log: ${error.message}`, "error");
-          },
-        });
-      } catch (error) {
-        runtime.compactInFlight = false;
-        runtime.autoCompactionController = undefined;
-        const msg = error instanceof Error ? error.message : String(error);
-        if (hasUI) ui?.notify(`memory-log: compaction trigger failed — ${msg}`, "error");
-      }
-    })();
-  });
-}

package/extensions/model-vision/README.md

@@ -1,28 +0,0 @@
-# model-vision
-
-Analyze a local image or public image URL with a vision model. Registers the `model_vision` tool for OCR, UI inspection, and image questions.
-
-## Install
-
-```sh
-pi install npm:@rol1n/model-vision
-```
-
-Available independently; it is not enabled in the aggregate package by default. The extension entrypoint is `extensions/model-vision/index.ts`; `analysis.ts` coordinates image loading (`image.ts`), network validation (`network.ts`), and model requests (`requests.ts`).
-
-## Use
-
-```json
-{
-  "image": "./screenshots/error.png",
-  "prompt": "Read the error message and describe the relevant UI."
-}
-```
-
-Supported image formats are PNG, JPEG, WebP, GIF, and BMP. Local paths resolve from the working directory. Remote images must use public HTTP(S) addresses; private-network targets are rejected. Images are limited to 10 MiB and requests have a 90-second timeout.
-
-## Model configuration
-
-The current fallback chain is declared in `DEFAULT_VISION_MODELS` in `extensions/model-vision/models.ts`: Antigravity `gemini-3.8-flash` through Pi's native API, followed by SHUAI API `gpt-6-luna` through OpenAI completions. Change that source list to choose a different chain; there is currently no settings key or tool argument for choosing the vision model.
-
-Install and authenticate the provider integrations you select. Antigravity is an external integration; SHUAI registration is available in [custom-providers](https://github.com/RolinShmily/pi-kit/tree/main/extensions/custom-providers). The tool returns extracted text and the provider/model used.

package/extensions/oai-subquota/README.md

@@ -1,30 +0,0 @@
-# oai-subquota
-
-Display OpenAI Codex subscription quota, reset windows, and a compact status line using the authenticated `openai-codex` provider.
-
-## Install
-
-```sh
-pi install npm:@rol1n/oai-subquota
-```
-
-Also included in `@rol1n/pi-kit`.
-
-## Commands
-
-| Command | Action |
-|---|---|
-| `/oai-subquota codex` | Show the Codex quota summary |
-| `/oai-subquota refresh` | Force a new quota query |
-| `/oai-subquota statusline` | Print compact quota text |
-| `/oai-subquota chatgpt` | Report the parked ChatGPT OAuth integration's status |
-
-## Authentication and cache
-
-Authenticate through `/login openai-codex`. The extension uses Pi's provider authentication rather than a separate API-key setting. Cached snapshots are stored at `$XDG_CACHE_HOME/oai-subquota/usage.json`, falling back to `~/.cache/oai-subquota/usage.json`. The normal cache lifetime is 60 seconds.
-
-The current implementation supports the Codex usage endpoint. General ChatGPT subscription quota lookup is explicitly parked and does not provide a working second quota source. Backend availability and subscription eligibility determine whether fresh quota data can be retrieved.
-
-## Source layout
-
-`index.ts` registers the command and lifecycle hooks and coordinates refreshes. `auth.ts` reads account claims from the provider token; `api.ts` handles usage requests; `cache.ts` handles snapshot persistence; `snapshot.ts` normalizes API responses and captured headers and merges snapshots. `types.ts` defines the shared data model, and `ui.ts` formats and renders quota output. The entrypoint re-exports the existing public types and formatting helpers.

package/extensions/oai-subquota/api.ts

@@ -1,27 +0,0 @@
-import { isRecord } from "./snapshot.ts";
-
-const USAGE_ENDPOINT = "https://chatgpt.com/backend-api/wham/usage";
-const REQUEST_TIMEOUT_MS = 15_000;
-
-export async function queryUsage(accessToken: string, accountId?: string): Promise<Record<string, unknown>> {
-  const headers: Record<string, string> = {
-    Authorization: `Bearer ${accessToken}`,
-    "User-Agent": "codex-cli",
-    Accept: "application/json",
-  };
-  if (accountId) headers["ChatGPT-Account-Id"] = accountId;
-
-  const res = await fetch(USAGE_ENDPOINT, {
-    method: "GET",
-    headers,
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-  });
-
-  if (res.status === 401 || res.status === 403) throw new Error(`Authentication rejected (HTTP ${res.status}). Please run /login openai-codex.`);
-  if (res.status === 429) throw new Error("Rate limit exceeded for usage endpoint (HTTP 429). Please try again later.");
-  if (!res.ok) throw new Error(`Usage request failed (HTTP ${res.status}).`);
-
-  const body = await res.json();
-  if (!isRecord(body)) throw new Error("Invalid JSON received from usage endpoint.");
-  return body;
-}

package/extensions/oai-subquota/auth.ts

@@ -1,34 +0,0 @@
-import { Buffer } from "node:buffer";
-import { isRecord } from "./snapshot.ts";
-import type { AccountSnapshot } from "./types.ts";
-
-const JWT_AUTH_CLAIM = "https://api.openai.com/auth";
-const JWT_PROFILE_CLAIM = "https://api.openai.com/profile";
-
-function decodeJwtPayload(token: string): Record<string, unknown> | undefined {
-  const part = token.split(".")[1];
-  if (!part) return undefined;
-  try {
-    const json = JSON.parse(Buffer.from(part, "base64url").toString("utf8"));
-    return isRecord(json) ? json : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-export function extractAccountFromToken(token: string): AccountSnapshot {
-  const payload = decodeJwtPayload(token);
-  if (!payload) return {};
-
-  const auth = isRecord(payload[JWT_AUTH_CLAIM]) ? payload[JWT_AUTH_CLAIM] : undefined;
-  const profile = isRecord(payload[JWT_PROFILE_CLAIM]) ? payload[JWT_PROFILE_CLAIM] : undefined;
-
-  const accountId = typeof auth?.chatgpt_account_id === "string" ? auth.chatgpt_account_id : undefined;
-  const plan = typeof auth?.chatgpt_plan_type === "string" ? auth.chatgpt_plan_type : undefined;
-  const email =
-    (typeof profile?.email === "string" && profile.email) ||
-    (typeof payload.email === "string" && payload.email) ||
-    undefined;
-
-  return { accountId, plan, email };
-}

package/extensions/oai-subquota/cache.ts

@@ -1,30 +0,0 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { isRecord } from "./snapshot.ts";
-import type { CodexUsageSnapshot } from "./types.ts";
-
-function getCachePath(): string {
-  const base = process.env.XDG_CACHE_HOME || join(homedir() || ".", ".cache");
-  return join(base, "oai-subquota", "usage.json");
-}
-
-export async function readCachedSnapshot(): Promise<CodexUsageSnapshot | undefined> {
-  try {
-    const raw = await readFile(getCachePath(), "utf8");
-    const parsed = JSON.parse(raw);
-    return isRecord(parsed) ? (parsed as unknown as CodexUsageSnapshot) : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-export async function writeCachedSnapshot(snapshot: CodexUsageSnapshot): Promise<void> {
-  try {
-    const file = getCachePath();
-    await mkdir(dirname(file), { recursive: true });
-    await writeFile(file, `${JSON.stringify(snapshot, null, 2)}\n`, { mode: 0o600 });
-  } catch {
-    // Non-fatal if filesystem is read-only
-  }
-}

package/extensions/oai-subquota/types.ts

@@ -1,40 +0,0 @@
-export interface LimitWindow {
-  usedPercent: number;
-  leftPercent: number;
-  windowSeconds?: number;
-  resetAt?: number;
-  resetAfterSeconds?: number;
-}
-
-export interface RateLimit {
-  id: string;
-  name: string;
-  primary?: LimitWindow;
-  secondary?: LimitWindow;
-}
-
-export interface CreditsSnapshot {
-  hasCredits?: boolean;
-  unlimited?: boolean;
-  balance?: number | string;
-}
-
-export interface ResetsSnapshot {
-  availableCount?: number;
-  applicableCount?: number;
-}
-
-export interface AccountSnapshot {
-  email?: string;
-  plan?: string;
-  accountId?: string;
-}
-
-export interface CodexUsageSnapshot {
-  source: "api" | "headers" | "cache";
-  fetchedAt: string;
-  account: AccountSnapshot;
-  defaultLimit?: RateLimit;
-  credits?: CreditsSnapshot;
-  resets?: ResetsSnapshot;
-}

package/extensions/prompt-snipaste/README.md

@@ -1,33 +0,0 @@
-# prompt-snipaste
-
-Choose prompt snippets to prepend or append to the next user message, with a terminal preview and a session transcript card.
-
-## Install
-
-```sh
-pi install npm:@rol1n/prompt-snipaste
-```
-
-Also included in `@rol1n/pi-kit`.
-
-## Use
-
-Open `/snipaste` or press Alt+S. Use the arrow keys to navigate, Space to toggle snippets, Tab to preview, Enter to confirm, and Escape to cancel. Selected snippets apply once to the next user input; they are then cleared.
-
-## Prompt configuration
-
-The picker uses Pi's resolved prompt commands, including prompts installed through packages. Package resource filters and disabled prompts are respected; a top-level `prompts: []` does not hide enabled package prompts. Personal and project prompt directories or explicit prompt paths can still be configured through Pi normally.
-
-Markdown frontmatter controls each snippet:
-
-```markdown
----
-name: Review checklist
-description: Add the review criteria to the next message
-placement: append
-order: 100
----
-Check correctness, error handling, and missing validation.
-```
-
-`placement` accepts `prepend` or `append`; append is the default. Lower `order` values come first within a placement. Without frontmatter, the file name becomes the snippet name and the body is used directly. The extension's fallback loader, when used without a Pi runtime, reads conventional prompt directories and explicit prompt paths.

package/extensions/screenshot/README.md

@@ -1,25 +0,0 @@
-# screenshot
-
-Insert the path of the newest Windows system screenshot into Pi's editor. It references an existing image rather than taking a new screenshot.
-
-## Install
-
-```sh
-pi install npm:@rol1n/screenshot
-```
-
-Available independently; it is not enabled in the aggregate package by default.
-
-## Use
-
-Take a screenshot with the system screenshot tool, then run `/screenshot` in Pi. The extension finds the newest supported image by modification time and pastes its path into the editor.
-
-## Platform support
-
-Native Windows checks standard and localized `Pictures/Screenshots` folders, including supported OneDrive locations, under `USERPROFILE`. WSL searches Windows profiles under the standard `/mnt/c/Users` mount. PNG, JPEG, GIF, BMP, and WebP files are supported.
-
-On other platforms the command reports that Windows screenshots are unavailable. There is no screenshot-folder setting; a nonstandard Windows drive mount or screenshot location requires a source change. No model credentials are needed.
-
-## Source layout
-
-`index.ts` registers the editor command. `discovery.ts` contains platform detection, screenshot-folder discovery, and newest-image selection.

package/extensions/srp-theme/README.md

@@ -1,24 +0,0 @@
-# srp-theme
-
-A Pi terminal presentation extension with a custom footer, prompt preview, agent-loop timing, and a tokens-per-second meter. It is an extension rather than a JSON theme package.
-
-## Install
-
-```sh
-pi install npm:@rol1n/srp-theme
-```
-
-Also included in `@rol1n/pi-kit`.
-
-## Commands
-
-```text
-/srp-theme on
-/srp-theme off
-```
-
-These commands enable or disable the extension's footer/prompt presentation and TPS meter for the running session. The extension observes agent and turn events to update timing and throughput information.
-
-## Requirements and customization
-
-Use Pi's interactive terminal mode for the custom widgets. The extension uses the active Pi theme's colors and does not replace your selected JSON theme. Appearance and layout constants live in `extensions/srp-theme/footer.ts` and `extensions/srp-theme/tps-meter.ts`; lifecycle hooks and the command are wired in `extensions/srp-theme/index.ts`. There is currently no package-specific settings section. No credentials or system binaries are required by the presentation layer itself.

package/extensions/subagent/skills/subagent/SKILL.md

@@ -1,70 +0,0 @@
----
-name: subagent
-description: Dispatch, message, and collaborate with parallel, full-powered Pi subagent workers running in split terminal panes or silent background processes.
----
-
-# Subagent
-
-Use the native `subagent` tool to delegate tasks to independent, full-powered Pi instances ("workers"). Workers run in dedicated split terminal panes (inside tmux or Zellij) or run silently as background processes (in standard terminals, VSCode, CI/CD, or headless environments). Every worker inherits all standard tools, skills, and extensions, and operates completely asynchronously.
-
-## Spawning Workers
-
-Call the `subagent` tool directly. The tool returns **immediately** with an acknowledgement. You do **not** need to wait or poll:
-
-```json
-subagent({
-  "task": "Investigate the authentication middleware in src/auth.ts and propose fixes.",
-  "name": "auth-audit"
-})
-```
-
-- `task`: Clear, comprehensive instructions for the worker.
-- `name`: Short, descriptive identifier (e.g. `frontend`, `db-migration`, `tester`).
-- `model`: (Optional) Model override (e.g. a faster model for simple exploration).
-- `cwd`: (Optional) Working directory for the worker.
-
-### Parallel Workers
-
-You can dispatch **multiple workers in parallel in a single turn**:
-
-```json
-[
-  { "name": "subagent", "arguments": { "task": "Audit frontend router in src/routes/", "name": "frontend" } },
-  { "name": "subagent", "arguments": { "task": "Audit database models in src/db/", "name": "backend" } }
-]
-```
-
-All workers run concurrently in separate split panes. As each worker finishes, the system automatically injects its final result into your conversation as a **steer message**, waking you up to review the findings.
-
-## Non-Blocking Principle
-
-- **DO NOT** write bash scripts, `sleep` commands, `tail` logs, or polling loops to check on a worker.
-- **DO NOT** fabricate or assume worker results before receiving the steer message.
-- After calling `subagent`, either end your turn immediately or work on other independent tasks. The harness will wake you with the result as soon as it is ready.
-
-## Answering Worker Questions
-
-Workers have an `ask_question` tool. When a worker encounters ambiguity or needs a decision:
-1. The worker pauses its work and marks itself as `waiting: ask`.
-2. You receive a steer notification: `[Subagent "<name>" question] ...`.
-3. Answer the worker by targeting its name:
-
-```json
-subagent({
-  "target": "auth-audit",
-  "task": "Use the JWT verification method rather than session cookies."
-})
-```
-
-The worker absorbs your guidance, resumes execution, and reports back when done.
-
-## Stopping a Worker
-
-If a worker is no longer needed or is off-track, terminate it:
-
-```json
-subagent({
-  "target": "auth-audit",
-  "action": "stop"
-})
-```

package/extensions/tui-asr/README.md

@@ -1,28 +0,0 @@
-# tui-asr
-
-Streaming voice dictation for Pi's terminal editor using Aliyun DashScope Paraformer. Includes a live audio-level meter and a searchable ASR model selector.
-
-## Install
-
-```sh
-pi install npm:@rol1n/tui-asr
-```
-
-Also included in `@rol1n/pi-kit`. The extension entrypoint is `extensions/tui-asr/index.ts`; `dictation.ts` owns the recording lifecycle, with separate audio, provider/auth, clipboard, input insertion, status animation, and model-selector helpers.
-
-## Commands and shortcuts
-
-| Action | Command or shortcut |
-|---|---|
-| Start or stop dictation | `/asr` or Alt+M |
-| Cancel dictation | Alt+N |
-| Choose a model | `/asr model` |
-| Select by model ID | `/asr model paraformer-realtime-v2` |
-
-The startup model is `paraformer-realtime-v2`. Final transcripts are inserted into the focused editor/input target, with a system clipboard fallback when direct insertion is unavailable.
-
-## Requirements and authentication
-
-Install SoX and ensure the recorder is on PATH: Windows uses `sox` with the `waveaudio` input, while POSIX uses `rec` / `sox` with the default audio device. A usable microphone and OS recording permission are required. Clipboard fallback uses the platform's clipboard utility, such as `clip`, `pbcopy`, or Wayland/X11 tools.
-
-Supply `DASHSCOPE_API_KEY` or `ALIYUN_API_KEY`, or authenticate through `/login dashscope` when [custom-providers](https://github.com/RolinShmily/pi-kit/tree/main/extensions/custom-providers) is loaded. Shared ASR helpers ship in this package; provider registration remains a separate extension entrypoint. Model selection is session-local.

package/extensions/tui-asr/audio.ts

@@ -1,40 +0,0 @@
-import { spawn, type ChildProcessByStdio } from "node:child_process";
-import type { Readable } from "node:stream";
-
-export function rmsFromPcm16(buf: Buffer): number {
-  if (buf.length < 2) return 0;
-  const sampleCount = Math.floor(buf.length / 2);
-  let sumSquares = 0;
-  for (let i = 0; i < sampleCount; i++) {
-    const sample = buf.readInt16LE(i * 2);
-    sumSquares += sample * sample;
-  }
-  const meanSquare = sumSquares / sampleCount;
-  return Math.sqrt(meanSquare);
-}
-
-/** Spawn the existing 16 kHz mono PCM recorder for the current platform. */
-export function spawnRecorder(): ChildProcessByStdio<null, Readable, Readable> {
-  const commonAudioArgs = [
-    "-q",
-    "--buffer", "512",
-    "-r", "16000",
-    "-c", "1",
-    "-b", "16",
-    "-e", "signed-integer",
-    "-t", "raw",
-    "-",
-  ];
-
-  let proc: ChildProcessByStdio<null, Readable, Readable>;
-  if (process.platform === "win32") {
-    proc = spawn("sox", ["-t", "waveaudio", "default", ...commonAudioArgs], { stdio: ["ignore", "pipe", "pipe"] });
-  } else {
-    try {
-      proc = spawn("rec", commonAudioArgs, { stdio: ["ignore", "pipe", "pipe"] });
-    } catch {
-      proc = spawn("sox", ["-d", ...commonAudioArgs], { stdio: ["ignore", "pipe", "pipe"] });
-    }
-  }
-  return proc;
-}

package/extensions/tui-asr/clipboard.ts

@@ -1,30 +0,0 @@
-import { spawn, type ChildProcessByStdio } from "node:child_process";
-
-export function copyToClipboard(text: string): boolean {
-  try {
-    const isWsl =
-      process.platform === "linux" &&
-      typeof process.env.WSL_DISTRO_NAME === "string";
-
-    let proc: ChildProcessByStdio<any, any, any>;
-    if (isWsl) {
-      proc = spawn("clip.exe", [], { stdio: ["pipe", "ignore", "ignore"] });
-    } else if (process.platform === "win32") {
-      proc = spawn("clip", [], { stdio: ["pipe", "ignore", "ignore"] });
-    } else if (process.platform === "darwin") {
-      proc = spawn("pbcopy", [], { stdio: ["pipe", "ignore", "ignore"] });
-    } else {
-      try {
-        proc = spawn("wl-copy", [], { stdio: ["pipe", "ignore", "ignore"] });
-      } catch {
-        proc = spawn("xclip", ["-selection", "clipboard"], { stdio: ["pipe", "ignore", "ignore"] });
-      }
-    }
-
-    proc.stdin.write(text);
-    proc.stdin.end();
-    return true;
-  } catch {
-    return false;
-  }
-}