@rol1n/pi-kit 0.1.0 → 0.1.1

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;
-  }
-}

package/extensions/tui-asr/providers.ts

@@ -1,25 +0,0 @@
-import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-
-export { ALL_ASR_MODELS, createAsrProvider, type AsrModelDefinition, type StreamingAsrProvider } from "../custom-providers/asr/index.ts";
-
-export async function resolveProviderApiKey(provider: string, ctx?: ExtensionContext | null): Promise<string> {
-  if (ctx?.modelRegistry) {
-    const candidates = provider === "dashscope" ? ["dashscope", "aliyun"] : [provider];
-    for (const id of candidates) {
-      try {
-        const key = await ctx.modelRegistry.getApiKeyForProvider(id);
-        if (key?.trim()) return key.trim();
-      } catch {}
-      try {
-        const auth = await ctx.modelRegistry.getProviderAuth(id);
-        if (auth?.auth?.apiKey?.trim()) return auth.auth.apiKey.trim();
-      } catch {}
-    }
-  }
-  const envKey = process.env[`${provider.toUpperCase()}_API_KEY`];
-  if (envKey?.trim()) return envKey.trim();
-  if (provider === "dashscope") {
-    return process.env.ALIYUN_API_KEY?.trim() || "";
-  }
-  return "";
-}

package/extensions/web-reach/README.md

@@ -1,37 +0,0 @@
-# web-reach
-
-Web search and page extraction tools for Pi. Registers `web_search` through Exa's public MCP endpoint and `web_fetch` for readable Markdown or raw responses.
-
-## Install
-
-```sh
-pi install npm:@rol1n/web-reach
-```
-
-Also included in `@rol1n/pi-kit`. Avoid enabling another extension that registers the same tool names unless overriding them is intentional.
-
-## Use
-
-```json
-{"query":"Pi coding agent package resource filtering"}
-```
-
-```json
-{"url":"https://example.com/docs","mode":"readable"}
-```
-
-The first object is for `web_search`; the second is for `web_fetch`. Fetch mode defaults to `readable` and also accepts `raw`. Extraction includes HTML-to-Markdown, JSON formatting, PDF handling, and a Jina Reader fallback for pages that need it. Returned text is limited to 35,000 characters.
-
-## Configuration
-
-| Environment variable | Default |
-|---|---|
-| `SRP_WEB_SEARCH_TIMEOUT_MS` | 60000 |
-| `SRP_WEB_FETCH_TIMEOUT_MS` | 20000 |
-| `SRP_WEB_FETCH_MAX_BYTES` | 4194304 (4 MiB) |
-
-No separate search API key is configured; availability and rate limits depend on the public Exa and Jina services. PDF extraction optionally imports `unpdf` if it is available. Without that package the implementation falls back to a basic text extraction path, with lower PDF text quality.
-
-## Source layout
-
-`index.ts` registers the tools and re-exports `searchWeb` and `fetchUrl`. `search.ts` handles Exa MCP requests and response parsing; `transport.ts` shares timeout, cancellation, environment, and truncation helpers. `page.ts` coordinates page fetching and extraction, using `rsc.ts` for Next.js data, `html.ts` for semantic Markdown, `pdf.ts` for optional PDF extraction, and `reader.ts` for the Jina Reader fallback.

package/extensions/web-reach/pdf.ts

@@ -1,42 +0,0 @@
-export function isPdfUrl(url: string, contentType?: string): boolean {
-  if (contentType?.includes("application/pdf")) return true;
-  try {
-    return new URL(url).pathname.toLowerCase().endsWith(".pdf");
-  } catch {
-    return false;
-  }
-}
-
-export async function extractPdfBuffer(
-  buffer: ArrayBuffer,
-  url: string,
-): Promise<{ text: string; title: string }> {
-  try {
-    const { getDocumentProxy } = await import("unpdf");
-    const pdf = await getDocumentProxy(new Uint8Array(buffer));
-    const maxPages = Math.min(pdf.numPages, 80);
-    const pages: string[] = [];
-
-    for (let i = 1; i <= maxPages; i++) {
-      const page = await pdf.getPage(i);
-      const textContent = await page.getTextContent();
-      const pageText = textContent.items
-        .map((item: unknown) => (item as { str?: string }).str || "")
-        .join(" ")
-        .replace(/\s+/g, " ")
-        .trim();
-      if (pageText) pages.push(`--- Page ${i} ---\n${pageText}`);
-    }
-
-    const title = new URL(url).pathname.split("/").pop() || "PDF Document";
-    const text = `# ${title}\n\nPages: ${pdf.numPages}\n\n${pages.join("\n\n")}`;
-    return { text, title };
-  } catch {
-    // Fallback plain text extraction
-    const text = Buffer.from(buffer).toString("latin1").replace(/[^\x20-\x7E\n\r\t]/g, " ");
-    return {
-      text: `# PDF Document\n\n${text.slice(0, 8000)}`,
-      title: "PDF Document",
-    };
-  }
-}

package/extensions/web-reach/reader.ts

@@ -1,42 +0,0 @@
-import { DEFAULT_USER_AGENT, withTimeout } from "./transport.ts";
-
-const JINA_READER_BASE = "https://r.jina.ai/";
-
-export async function fetchViaJinaReader(
-  url: string,
-  signal?: AbortSignal,
-): Promise<{ text: string; title: string } | null> {
-  const { ac, done } = withTimeout(30_000, "Jina Reader timed out", signal);
-  try {
-    const res = await fetch(`${JINA_READER_BASE}${url}`, {
-      headers: {
-        Accept: "text/markdown",
-        "X-No-Cache": "true",
-        "User-Agent": DEFAULT_USER_AGENT,
-      },
-      signal: ac.signal,
-    });
-    if (!res.ok) return null;
-
-    const raw = await res.text();
-    const contentIndex = raw.indexOf("Markdown Content:");
-    const markdown = contentIndex >= 0 ? raw.slice(contentIndex + 17).trim() : raw.trim();
-
-    if (
-      markdown.length < 80 ||
-      markdown.startsWith("Loading...") ||
-      markdown.startsWith("Please enable JavaScript")
-    ) {
-      return null;
-    }
-
-    const titleMatch = markdown.match(/^#+\s+(.+)$/m);
-    const title = titleMatch?.[1]?.trim() || "";
-
-    return { text: markdown, title };
-  } catch {
-    return null;
-  } finally {
-    done();
-  }
-}

package/extensions/windows-wheel-fix/README.md

@@ -1,21 +0,0 @@
-# windows-wheel-fix
-
-Restore mouse-wheel reporting for Pi running under Windows ConPTY/Zellij when terminal initialization causes wheel events to be translated into prompt-history navigation.
-
-## Install
-
-```sh
-pi install npm:@rol1n/windows-wheel-fix
-```
-
-Also included in `@rol1n/pi-kit`. The entrypoint returns immediately outside native Windows, so an aggregate installation does not apply this terminal patch on Linux, WSL, or macOS.
-
-## Behavior
-
-The extension re-emits mouse-reporting control sequences after session startup and whenever stdin returns to raw mode. It has no slash command, settings section, credentials, or external binary requirement.
-
-The targeted upstream issue is [earendil-works/pi#9656](https://github.com/earendil-works/pi/issues/9656). If your installed Pi/terminal versions already resolve that issue, disable the extension through Pi's package resource configuration.
-
-## Source layout
-
-The small, platform-specific patch stays in one `index.ts` beside this README.