repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

feat(tldr): add live summaries

38538ba9b567430bfad55dd27bc7f9577b17f3e4

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (7)

README.md

Modified
88 88 | `terminal-notifier` | Terminal notification bridge for Pi completion and extension events. | [README](extensions/terminal-notifier/README.md) |
89 89 | `terminal-signals` | Terminal lifecycle signals for Pi. | [README](extensions/terminal-signals/README.md) |
90 90 | `terse` | Terse response protocol injector for Pi. | [README](extensions/terse/README.md) |
91 +| `tldr` | Live TLDR widget above the Pi editor. | [README](extensions/tldr/README.md) |
91 92 | `tps` | Tokens-per-second footer telemetry. | [README](extensions/tps/README.md) |
92 93 | `usage` | Local usage statistics dashboard for Pi. | [README](extensions/usage/README.md) |
93 94 | `vcs-status` | Pi workspace VCS telemetry for Git and Jujutsu. | [README](extensions/vcs-status/README.md) |

extensions/tldr/README.md

Added
new file mode 100644
1 +# tldr
3 +Live TLDR widget above Pi editor.
5 +## Install / load
7 +Loaded through root pi-ext package. See [root README](../../README.md).
9 +## Commands / tools / settings
11 +Commands:
13 +- `/tldr` — toggle widget.
14 +- `/tldr on` — enable widget.
15 +- `/tldr off` — disable widget and clear display.
16 +- `/tldr status` — show enabled state and configured model.
17 +- `/tldr help` — show command syntax.
19 +Tools: none.
21 +Settings:
23 +```json
25 + "tldr": {
26 + "model": "provider/model"
27 + }
29 +```
31 +If `tldr.model` is missing, invalid, unavailable, or unauthenticated, tldr uses the current Pi model. If that has no API key, the widget shows `tldr unavailable`.
33 +## Behavior
35 +- Records prompt, assistant, tool, result, and final-response activity.
36 +- Sends bounded snippets to the TLDR model.
37 +- Uses one in-flight TLDR request at a time.
38 +- Coalesces noisy normal activity before requesting a checkpoint.
39 +- Drops stale model results after new runs/session changes.
40 +- Keeps recent generated checkpoints as compact context.
41 +- Uses upstream-style prompt constraints: one sentence, under 80 chars, no tool names.
42 +- Uses in-progress vs completed tense instructions.
43 +- Disables prompt caching for TLDR requests.
44 +- Does not scan or redact secrets.
46 +## Demo
48 +None.

extensions/tldr/__tests__/harness.test.ts

Added
new file mode 100644
1 +import { afterEach, describe, expect, it } from "bun:test";
2 +import path from "node:path";
3 +import { createTestSession, type TestSession } from "@marcfargas/pi-test-harness";
5 +describe("tldr pi-test-harness", () => {
6 + let t: TestSession | undefined;
8 + afterEach(() => {
9 + t?.dispose();
10 + t = undefined;
11 + });
13 + it("loads in real Pi extension runtime", async () => {
14 + const extensionPath = path.resolve(import.meta.dir, "../index.ts");
15 + t = await createTestSession({ extensions: [extensionPath] });
17 + expect(t.session.extensionRunner.extensions).toHaveLength(1);
18 + expect(t.session.extensionRunner.extensions[0].path).toBe(extensionPath);
19 + });
20 +});

extensions/tldr/__tests__/tldr.test.ts

Added
new file mode 100644
1 +import { describe, expect, it } from "bun:test";
2 +import { __test } from "../index.ts";
4 +const {
5 + FactCollector,
6 + sanitizeTldrText,
7 + buildTldrPrompt,
8 + parseModelRef,
9 + resolveTldrModel,
10 + TldrEngine,
11 + boxLines,
12 +} = __test;
14 +function textResponse(text: string) {
15 + return { stopReason: "stop", content: [{ type: "text", text }] };
18 +function fakeCtx(overrides: Record<string, unknown> = {}) {
19 + const widgets: Record<string, unknown> = {};
20 + const notifications: Array<{ message: string; level: string }> = [];
21 + const currentModel = { provider: "current", id: "model" };
22 + const configuredModel = { provider: "fast", id: "mini" };
23 + return {
24 + hasUI: true,
25 + model: currentModel,
26 + signal: undefined,
27 + ui: {
28 + setWidget(key: string, value: unknown) { widgets[key] = value; },
29 + notify(message: string, level: string) { notifications.push({ message, level }); },
30 + },
31 + modelRegistry: {
32 + find(provider: string, id: string) {
33 + return provider === "fast" && id === "mini" ? configuredModel : undefined;
34 + },
35 + async getApiKeyAndHeaders(model: { provider: string; id: string }) {
36 + if (model.provider === "none") return { ok: true, apiKey: undefined };
37 + return { ok: true, apiKey: `${model.provider}-key`, headers: { "x-model": model.id } };
38 + },
39 + },
40 + widgets,
41 + notifications,
42 + ...overrides,
43 + } as any;
46 +async function settle() {
47 + await new Promise((resolve) => setTimeout(resolve, 0));
50 +function fakeScheduler() {
51 + const timers: Array<() => void> = [];
52 + return {
53 + scheduler: {
54 + setTimeout(callback: () => void) { timers.push(callback); return callback; },
55 + clearTimeout(handle: () => void) {
56 + const i = timers.indexOf(handle);
57 + if (i >= 0) timers.splice(i, 1);
58 + },
59 + },
60 + flush() {
61 + const run = timers.splice(0);
62 + for (const timer of run) timer();
63 + },
64 + get size() { return timers.length; },
65 + };
68 +describe("tldr core", () => {
69 + it("sanitizes terminal junk and caps display text", () => {
70 + expect(sanitizeTldrText("\u001b[31mhello\u001b[0m\nworld\u0007", 20)).toBe("hello world");
71 + expect(sanitizeTldrText("x".repeat(20), 8)).toBe("xxxxxxx…");
72 + });
74 + it("collects bounded activities and discards accepted raw facts", () => {
75 + const facts = new FactCollector(3, 20);
76 + facts.recordUser("inspect the package");
77 + facts.recordToolStart("grep", { pattern: "needle" });
78 + facts.recordToolResult("grep", false, "found needle");
79 + facts.recordFinal("done researching");
81 + expect(facts.activitiesAfter(0, 99).map((a: any) => a.type)).toEqual(["tool_start", "tool_result", "assistant_final"]);
82 + expect(facts.activitiesAfter(0, 99)[0].text.length).toBeLessThanOrEqual(20);
84 + facts.discardThrough(3);
85 + expect(facts.activitiesAfter(0, 99).map((a: any) => a.index)).toEqual([4]);
86 + });
88 + it("builds strict checkpoint prompts with previous TLDR context", () => {
89 + const facts = new FactCollector();
90 + facts.recordUser("make a tiny extension");
91 + facts.recordToolStart("read", { path: "package.json" });
93 + const prompt = buildTldrPrompt(facts.activitiesAfter(0, 2), [{ index: 1, text: "Starting extension work." }], 2);
95 + expect(prompt.systemPrompt).toContain("Summarize only activity up to the requested index");
96 + expect(prompt.systemPrompt).toContain("Never ask for more information");
97 + expect(prompt.systemPrompt).toContain("Return exactly one complete sentence under 80 characters");
98 + expect(prompt.systemPrompt).toContain("Start with a present-tense -ing verb.");
99 + expect(prompt.systemPrompt).toContain("Plain text only");
100 + expect(prompt.message.content[0].text).toContain("Previous generated TLDR checkpoints");
101 + expect(prompt.message.content[0].text).toContain("Through activity 1: Starting extension work.");
102 + expect(prompt.message.content[0].text).toContain("[2] tool_start:");
103 + });
105 + it("uses completed-tense instruction for final activity", () => {
106 + const facts = new FactCollector();
107 + facts.recordUser("make a tiny extension");
108 + facts.recordFinal("done");
110 + const prompt = buildTldrPrompt(facts.activitiesAfter(0, 2), [], 2);
112 + expect(prompt.systemPrompt).toContain("Start with a past-tense verb.");
113 + expect(prompt.systemPrompt).not.toContain("Start with a present-tense -ing verb.");
114 + });
116 + it("wraps long boxes to multiple equal-width content lines", () => {
117 + const text = "They confirmed the standing objective is not an active goal, so the judge cannot run.";
118 + const lines = boxLines(text);
119 + const widths = lines.map((line: string) => Array.from(line).length);
121 + expect(new Set(widths).size).toBe(1);
122 + expect(lines.length).toBeGreaterThan(3);
123 + expect(lines.join("\n")).not.toContain("…");
124 + expect(lines[1]).toContain("They confirmed the standing objective");
125 + expect(lines[2]).toContain("run.");
126 + expect(widths[1]).toBeLessThanOrEqual(80);
127 + });
129 + it("parses configured provider/model refs and rejects junk", () => {
130 + expect(parseModelRef("fast/mini")).toEqual({ provider: "fast", id: "mini" });
131 + expect(parseModelRef(" nope ")).toBeUndefined();
132 + expect(parseModelRef("/nope")).toBeUndefined();
133 + });
135 + it("uses configured settings model, then falls back to current model", async () => {
136 + const ctx = fakeCtx();
137 + await expect(resolveTldrModel(ctx, "fast/mini")).resolves.toMatchObject({ model: { provider: "fast", id: "mini" }, apiKey: "fast-key" });
138 + await expect(resolveTldrModel(ctx, "missing/model")).resolves.toMatchObject({ model: { provider: "current", id: "model" }, apiKey: "current-key" });
139 + });
141 + it("generates TLDR with cache disabled and renders sanitized result", async () => {
142 + const calls: any[] = [];
143 + const scheduler = fakeScheduler();
144 + const facts = new FactCollector();
145 + const engine = new TldrEngine({
146 + facts,
147 + scheduler: scheduler.scheduler,
148 + generate: async (...args: any[]) => {
149 + calls.push(args);
150 + return textResponse("\u001b[31mReading package metadata.\u001b[0m");
151 + },
152 + configuredModelRef: "fast/mini",
153 + });
154 + const ctx = fakeCtx();
156 + engine.enqueue(ctx, facts.recordUser("read package"));
157 + await settle();
159 + expect(calls).toHaveLength(1);
160 + expect(calls[0][0]).toEqual({ provider: "fast", id: "mini" });
161 + expect(calls[0][2]).toMatchObject({ apiKey: "fast-key", maxRetries: 0, cacheRetention: "none" });
162 + expect(ctx.widgets["tldr"]).toContain("│ Reading package metadata. │");
163 + });
165 + it("coalesces normal activity until the scheduler flushes", async () => {
166 + const scheduler = fakeScheduler();
167 + const facts = new FactCollector();
168 + let calls = 0;
169 + const engine = new TldrEngine({
170 + facts,
171 + scheduler: scheduler.scheduler,
172 + generate: async () => { calls++; return textResponse(`Update ${calls}.`); },
173 + });
174 + const ctx = fakeCtx();
176 + engine.enqueue(ctx, facts.recordToolStart("grep", {}));
177 + engine.enqueue(ctx, facts.recordToolResult("grep", false, "ok"));
178 + await Promise.resolve();
179 + expect(calls).toBe(0);
181 + scheduler.flush();
182 + await settle();
183 + expect(calls).toBe(1);
184 + expect(ctx.widgets["tldr"]).toContain("│ Update 1. │");
185 + });
187 + it("drops stale model results after a fresh run starts", async () => {
188 + let release!: (value: unknown) => void;
189 + const facts = new FactCollector();
190 + const engine = new TldrEngine({
191 + facts,
192 + generate: async () => new Promise((resolve) => { release = resolve; }) as any,
193 + });
194 + const ctx = fakeCtx();
196 + engine.enqueue(ctx, facts.recordUser("first"));
197 + await settle();
198 + engine.startFreshRun(ctx);
199 + release(textResponse("Old stale work."));
200 + await settle();
202 + expect(ctx.widgets["tldr"]).toBeUndefined();
203 + });
204 +});

extensions/tldr/bun.lock

Added
new file mode 100644
1 +{
2 + "lockfileVersion": 1,
3 + "configVersion": 1,
4 + "workspaces": {
5 + "": {
6 + "name": "@bugabinga/pi-ext-tldr",
7 + "devDependencies": {
8 + "@marcfargas/pi-test-harness": "^0.6.1",
9 + },
10 + "peerDependencies": {
11 + "@earendil-works/pi-ai": "*",
12 + "@earendil-works/pi-coding-agent": "*",
13 + "@earendil-works/pi-tui": "*",
14 + },
15 + },
16 + },
17 + "packages": {
18 + "@anthropic-ai/sdk": ["@anthropic-ai/sdk@0.91.1", "", { "dependencies": { "json-schema-to-ts": "^3.1.1" }, "peerDependencies": { "zod": "^3.25.0 || ^4.0.0" }, "optionalPeers": ["zod"], "bin": { "anthropic-ai-sdk": "bin/cli" } }, "sha512-LAmu761tSN9r66ixvmciswUj/ZC+1Q4iAfpedTfSVLeswRwnY3n2Nb6Tsk+cLPP28aLOPWeMgIuTuCcMC6W/iw=="],
20 + "@aws-crypto/crc32": ["@aws-crypto/crc32@5.2.0", "", { "dependencies": { "@aws-crypto/util": "^5.2.0", "@aws-sdk/types": "^3.222.0", "tslib": "^2.6.2" } }, "sha512-nLbCWqQNgUiwwtFsen1AdzAtvuLRsQS8rYgMuxCrdKf9kOssamGLuPwyTY9wyYblNr9+1XM8v6zoDTPPSIeANg=="],
22 + "@aws-crypto/sha256-browser": ["@aws-crypto/sha256-browser@5.2.0", "", { "dependencies": { "@aws-crypto/sha256-js": "^5.2.0", "@aws-crypto/supports-web-crypto": "^5.2.0", "@aws-crypto/util": "^5.2.0", "@aws-sdk/types": "^3.222.0", "@aws-sdk/util-locate-window": "^3.0.0", "@smithy/util-utf8": "^2.0.0", "tslib": "^2.6.2" } }, "sha512-AXfN/lGotSQwu6HNcEsIASo7kWXZ5HYWvfOmSNKDsEqC4OashTp8alTmaz+F7TC2L083SFv5RdB+qU3Vs1kZqw=="],
24 + "@aws-crypto/sha256-js": ["@aws-crypto/sha256-js@5.2.0", "", { "dependencies": { "@aws-crypto/util": "^5.2.0", "@aws-sdk/types": "^3.222.0", "tslib": "^2.6.2" } }, "sha512-FFQQyu7edu4ufvIZ+OadFpHHOt+eSTBaYaki44c+akjg7qZg9oOQeLlk77F6tSYqjDAFClrHJk9tMf0HdVyOvA=="],
26 + "@aws-crypto/supports-web-crypto": ["@aws-crypto/supports-web-crypto@5.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-iAvUotm021kM33eCdNfwIN//F77/IADDSs58i+MDaOqFrVjZo9bAal0NK7HurRuWLLpF1iLX7gbWrjHjeo+YFg=="],
28 + "@aws-crypto/util": ["@aws-crypto/util@5.2.0", "", { "dependencies": { "@aws-sdk/types": "^3.222.0", "@smithy/util-utf8": "^2.0.0", "tslib": "^2.6.2" } }, "sha512-4RkU9EsI6ZpBve5fseQlGNUWKMa1RLPQ1dnjnQoe07ldfIzcsGb5hC5W0Dm7u423KWzawlrpbjXBrXCEv9zazQ=="],
30 + "@aws-sdk/client-bedrock-runtime": ["@aws-sdk/client-bedrock-runtime@3.1048.0", "", { "dependencies": { "@aws-crypto/sha256-browser": "5.2.0", "@aws-crypto/sha256-js": "5.2.0", "@aws-sdk/core": "^3.974.11", "@aws-sdk/credential-provider-node": "^3.972.42", "@aws-sdk/eventstream-handler-node": "^3.972.16", "@aws-sdk/middleware-eventstream": "^3.972.12", "@aws-sdk/middleware-websocket": "^3.972.19", "@aws-sdk/token-providers": "3.1048.0", "@aws-sdk/types": "^3.973.8", "@smithy/core": "^3.24.2", "@smithy/fetch-http-handler": "^5.4.2", "@smithy/node-http-handler": "^4.7.2", "@smithy/types": "^4.14.1", "tslib": "^2.6.2" } }, "sha512-u+NT61JZEkRFtpL0CAw1N1dwxnaLgwVXQl/zjJxTGgLyS/jTIdg2SdoEoCTHxgDyCnqa1HEi9QOoE9/pYRNpOQ=="],
32 + "@aws-sdk/core": ["@aws-sdk/core@3.974.13", "", { "dependencies": { "@aws-sdk/types": "^3.973.9", "@aws-sdk/xml-builder": "^3.972.25", "@aws/lambda-invoke-store": "^0.2.2", "@smithy/core": "^3.24.3", "@smithy/signature-v4": "^5.4.2", "@smithy/types": "^4.14.2", "bowser": "^2.11.0", "tslib": "^2.6.2" } }, "sha512-+Y5/4tHki0uYgyx8eun146DegRVQBpdKGK5RbV0FTKJPpaKTchvqVxrrRFK6Wk0JksO4iAZKw3eqxGEIwtO98w=="],
34 + "@aws-sdk/credential-provider-env": ["@aws-sdk/credential-provider-env@3.972.39", "", { "dependencies": { "@aws-sdk/core": "^3.974.13", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-29wX9zpAvEt1vcj0psha+y6ygBHy2V/S72mp6e7q0KARLWXq+pwE/lR6qGkwknQvruh52lXvlqZIga8Hdxkucw=="],
36 + "@aws-sdk/credential-provider-http": ["@aws-sdk/credential-provider-http@3.972.41", "", { "dependencies": { "@aws-sdk/core": "^3.974.13", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/fetch-http-handler": "^5.4.3", "@smithy/node-http-handler": "^4.7.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-IA3CQTjtJkb6u1H4mE4936c8OPBMa9Jggtwe8U2Mqw/vvb/tZ5Ebd0mcZcX0uKWQhOyYo/+qNIwkV5Xh+FeJJA=="],
38 + "@aws-sdk/credential-provider-ini": ["@aws-sdk/credential-provider-ini@3.972.43", "", { "dependencies": { "@aws-sdk/core": "^3.974.13", "@aws-sdk/credential-provider-env": "^3.972.39", "@aws-sdk/credential-provider-http": "^3.972.41", "@aws-sdk/credential-provider-login": "^3.972.43", "@aws-sdk/credential-provider-process": "^3.972.39", "@aws-sdk/credential-provider-sso": "^3.972.43", "@aws-sdk/credential-provider-web-identity": "^3.972.43", "@aws-sdk/nested-clients": "^3.997.11", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/credential-provider-imds": "^4.3.2", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-4mzII+3mZEVXXE1xzrLQrCJL7/r62A63bA6SVzZoNL5rqCJghpf+xgGltVrIBBs0n+mOZBKrQl2tRREtvZ5l6A=="],
40 + "@aws-sdk/credential-provider-login": ["@aws-sdk/credential-provider-login@3.972.43", "", { "dependencies": { "@aws-sdk/core": "^3.974.13", "@aws-sdk/nested-clients": "^3.997.11", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-HG7kQCwXtbv3oBV61Ins0oNX8KKyvrMqqRkb6ZiAfQHbMuHaiNaEb2KnpKLPkNpqImSBK82UkVE/kaY6IfWikA=="],
42 + "@aws-sdk/credential-provider-node": ["@aws-sdk/credential-provider-node@3.972.44", "", { "dependencies": { "@aws-sdk/credential-provider-env": "^3.972.39", "@aws-sdk/credential-provider-http": "^3.972.41", "@aws-sdk/credential-provider-ini": "^3.972.43", "@aws-sdk/credential-provider-process": "^3.972.39", "@aws-sdk/credential-provider-sso": "^3.972.43", "@aws-sdk/credential-provider-web-identity": "^3.972.43", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/credential-provider-imds": "^4.3.2", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-sDaBIT0yrNNIPfvlsiTCmANm07zKju+ipWODjEXgZlsjMeIJR3LVp7RDyAOzUoAsTbDfYKDWp+i5WrFiQP6rmQ=="],
44 + "@aws-sdk/credential-provider-process": ["@aws-sdk/credential-provider-process@3.972.39", "", { "dependencies": { "@aws-sdk/core": "^3.974.13", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-2k/amBifLd75eXNwgvPw/2lKYSQ3NhvHQgkVKVjfUq13/eJ3JRtHmznuFenn74OK3sSfp4SMy1YB2w+UVXoKqA=="],
46 + "@aws-sdk/credential-provider-sso": ["@aws-sdk/credential-provider-sso@3.972.43", "", { "dependencies": { "@aws-sdk/core": "^3.974.13", "@aws-sdk/nested-clients": "^3.997.11", "@aws-sdk/token-providers": "3.1052.0", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-LPc3+Y4vhH1T4x6CMqwCM6hk5+SRf/Lwmgm8INm95wxTtIRHcMwQUVkDzWu4Iw/RSncxYM2BC01OrYbxOPZvyg=="],
48 + "@aws-sdk/credential-provider-web-identity": ["@aws-sdk/credential-provider-web-identity@3.972.43", "", { "dependencies": { "@aws-sdk/core": "^3.974.13", "@aws-sdk/nested-clients": "^3.997.11", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-wQtL34lUD/09VXjwAUo2T+I3aEXRDxMB3DKmTJL/Zj0Gi6sLDTrVhae1XVt01yzkquOWajI/sZW72JGDZ1ciTw=="],
50 + "@aws-sdk/eventstream-handler-node": ["@aws-sdk/eventstream-handler-node@3.972.17", "", { "dependencies": { "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-WFwdNcjchKZr7jKYgGimUZO8sSKQF/le7GGqgeCzz/lHozInE6b0gFJ1YMr8NaIeAoWJwgtrF7RE4/qMgosAdQ=="],
52 + "@aws-sdk/middleware-eventstream": ["@aws-sdk/middleware-eventstream@3.972.13", "", { "dependencies": { "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-ECfsw7mf6G/sxNbKbGE3/h1xeIArY/yRI1IjDGYkLgDIankh+aDOtDRSr40LVlIHGL9+jEH1cVuxmbJ8NLL/1A=="],
54 + "@aws-sdk/middleware-websocket": ["@aws-sdk/middleware-websocket@3.972.21", "", { "dependencies": { "@aws-sdk/core": "^3.974.13", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/fetch-http-handler": "^5.4.3", "@smithy/signature-v4": "^5.4.2", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-yr+5+C7v9R55sAJ89A55Wrm7wIKPVn5cm6J3Hztnd5s/iwEUKxyJqCnIxJu4fVXgG9XBQD1Jc4rsWC1ozahJjA=="],
56 + "@aws-sdk/nested-clients": ["@aws-sdk/nested-clients@3.997.11", "", { "dependencies": { "@aws-crypto/sha256-browser": "5.2.0", "@aws-crypto/sha256-js": "5.2.0", "@aws-sdk/core": "^3.974.13", "@aws-sdk/signature-v4-multi-region": "^3.996.28", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/fetch-http-handler": "^5.4.3", "@smithy/node-http-handler": "^4.7.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-nWXXJ1r/r8N2Gw1pWolRgED38/A9A8DHR2ETWIv220zh4PZHcybbR4hUVWWktmNXTRHzDJwRluapHn0rZxuoqA=="],
58 + "@aws-sdk/signature-v4-multi-region": ["@aws-sdk/signature-v4-multi-region@3.996.28", "", { "dependencies": { "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/signature-v4": "^5.4.2", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-qs9z5LqXO/CZC2Lg9SGKpoLU8Rhi+m2pFKZqfO9pytX1clc0katqtsDNupJxFy0xT9wsZSPzM2v1y+/H/zfp5Q=="],
60 + "@aws-sdk/token-providers": ["@aws-sdk/token-providers@3.1048.0", "", { "dependencies": { "@aws-sdk/core": "^3.974.11", "@aws-sdk/nested-clients": "^3.997.9", "@aws-sdk/types": "^3.973.8", "@smithy/core": "^3.24.2", "@smithy/types": "^4.14.1", "tslib": "^2.6.2" } }, "sha512-k0y/GcuesuSfWyUM0WamrGyeZmltRYaPbHO82UDA6mZ/doB+FOHKutikPAtSXMn/hDz970cF+iRuuiYO9VEbAA=="],
62 + "@aws-sdk/types": ["@aws-sdk/types@3.973.9", "", { "dependencies": { "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-kuBfgQVdcz5Bmapc4A13YbpVw/pXkesfhetcFYwbntqas8sF41OHyd4o28+/TG2ZQdHBsv90Lsu5y6oitvYCdg=="],
64 + "@aws-sdk/util-locate-window": ["@aws-sdk/util-locate-window@3.965.5", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-WhlJNNINQB+9qtLtZJcpQdgZw3SCDCpXdUJP7cToGwHbCWCnRckGlc6Bx/OhWwIYFNAn+FIydY8SZ0QmVu3xTQ=="],
66 + "@aws-sdk/xml-builder": ["@aws-sdk/xml-builder@3.972.25", "", { "dependencies": { "@nodable/entities": "2.1.0", "@smithy/types": "^4.14.2", "fast-xml-parser": "5.7.3", "tslib": "^2.6.2" } }, "sha512-GH+Kjz4nPKWKHnsiQpnhP1MJdTGIcK4rAka6tzakgjjUkVgNsmPeEbbRAf09SzS1hjGu6duGHCBsxYke0BhHjQ=="],
68 + "@aws/lambda-invoke-store": ["@aws/lambda-invoke-store@0.2.4", "", {}, "sha512-iY8yvjE0y651BixKNPgmv1WrQc+GZ142sb0z4gYnChDDY2YqI4P/jsSopBWrKfAt7LOJAkOXt7rC/hms+WclQQ=="],
70 + "@babel/runtime": ["@babel/runtime@7.29.7", "", {}, "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw=="],
72 + "@earendil-works/pi-agent-core": ["@earendil-works/pi-agent-core@0.75.5", "", { "dependencies": { "@earendil-works/pi-ai": "^0.75.5", "ignore": "7.0.5", "typebox": "1.1.38", "yaml": "2.9.0" } }, "sha512-LHygOgsW2pgXKb3IkXkOAeZPovHr9VF+EixgXVsDNuB4jmhEOXgshy/zksZ7slkUAx10OQ9W1Ed/2jsnhd1NqA=="],
74 + "@earendil-works/pi-ai": ["@earendil-works/pi-ai@0.75.5", "", { "dependencies": { "@anthropic-ai/sdk": "0.91.1", "@aws-sdk/client-bedrock-runtime": "3.1048.0", "@google/genai": "1.52.0", "@mistralai/mistralai": "2.2.1", "@smithy/node-http-handler": "4.7.3", "http-proxy-agent": "7.0.2", "https-proxy-agent": "7.0.6", "openai": "6.26.0", "partial-json": "0.1.7", "typebox": "1.1.38" }, "bin": { "pi-ai": "dist/cli.js" } }, "sha512-zf1F5kXk1pqZeFShXOqq9ibUk8QdtRoLCDPAjO+hj44e3EUs9/GFO2qnhTC5+JA2uwVCx+WCNe1PiCjlBYWm5w=="],
76 + "@earendil-works/pi-coding-agent": ["@earendil-works/pi-coding-agent@0.75.5", "", { "dependencies": { "@earendil-works/pi-agent-core": "^0.75.5", "@earendil-works/pi-ai": "^0.75.5", "@earendil-works/pi-tui": "^0.75.5", "@silvia-odwyer/photon-node": "0.3.4", "chalk": "5.6.2", "cross-spawn": "7.0.6", "diff": "8.0.4", "glob": "13.0.6", "highlight.js": "10.7.3", "hosted-git-info": "9.0.3", "ignore": "7.0.5", "jiti": "2.7.0", "minimatch": "10.2.5", "proper-lockfile": "4.1.2", "typebox": "1.1.38", "undici": "8.3.0", "yaml": "2.9.0" }, "optionalDependencies": { "@mariozechner/clipboard": "0.3.6" }, "bin": { "pi": "dist/cli.js" } }, "sha512-O3CCQDYy28D4uwtP6zZkdEwzHN6X22v49Sb0+SZTC7x37V/YfmogrWPiaFoWeoc2hmdKhSATI7ZAK5bQbJG5NA=="],
78 + "@earendil-works/pi-tui": ["@earendil-works/pi-tui@0.75.5", "", { "dependencies": { "get-east-asian-width": "1.6.0", "marked": "15.0.12" } }, "sha512-LkXUM1/49pvzzeI39Y5wjBMlgafcCf67HCLhB9Z7yuXHy4XgT+VqxWcZVW5hBdhQsHZd0znjJotfGH1BzxMfiA=="],
80 + "@google/genai": ["@google/genai@1.52.0", "", { "dependencies": { "google-auth-library": "^10.3.0", "p-retry": "^4.6.2", "protobufjs": "^7.5.4", "ws": "^8.18.0" }, "peerDependencies": { "@modelcontextprotocol/sdk": "^1.25.2" }, "optionalPeers": ["@modelcontextprotocol/sdk"] }, "sha512-gwSvbpiN/17O9TbsqSsE/OzZcpv5Fo4RQjdngGgogtuB9RsyJ8ZHhX5KjHj1bp5N9snN2eK8LDGXSaWW2hof8Q=="],
82 + "@marcfargas/pi-test-harness": ["@marcfargas/pi-test-harness@0.6.1", "", { "peerDependencies": { "@earendil-works/pi-agent-core": ">=0.74.0", "@earendil-works/pi-ai": ">=0.74.0", "@earendil-works/pi-coding-agent": ">=0.74.0" } }, "sha512-FiiBMP8W21yFuyY5KD6M3I9+KARgmOn8ZVeMFAjx2dUhEV6jeFI98wCUb6dujstkuGHbf91HeyE1vaUZDQd0nw=="],
84 + "@mariozechner/clipboard": ["@mariozechner/clipboard@0.3.6", "", { "optionalDependencies": { "@mariozechner/clipboard-darwin-arm64": "0.3.6", "@mariozechner/clipboard-darwin-universal": "0.3.6", "@mariozechner/clipboard-darwin-x64": "0.3.6", "@mariozechner/clipboard-linux-arm64-gnu": "0.3.6", "@mariozechner/clipboard-linux-arm64-musl": "0.3.6", "@mariozechner/clipboard-linux-riscv64-gnu": "0.3.6", "@mariozechner/clipboard-linux-x64-gnu": "0.3.6", "@mariozechner/clipboard-linux-x64-musl": "0.3.6", "@mariozechner/clipboard-win32-arm64-msvc": "0.3.6", "@mariozechner/clipboard-win32-x64-msvc": "0.3.6" } }, "sha512-MXdtr+6+ntlIVHdrZYuZNQydu6o8yZswFJ2Ln81j2O/Y9B/LDHvEaIm95xWNPkjGTWriSOeLnQJRFs6dYb60bg=="],
86 + "@mariozechner/clipboard-darwin-arm64": ["@mariozechner/clipboard-darwin-arm64@0.3.6", "", { "os": "darwin", "cpu": "arm64" }, "sha512-HjaisYCAbHi/1+N1yDAQHc8ZXGffufIUT5NSOSVR3f3AuMDusxTtnbK8tZ7JFDkShua1oNGZoNwQHsc8MPtE0Q=="],
88 + "@mariozechner/clipboard-darwin-universal": ["@mariozechner/clipboard-darwin-universal@0.3.6", "", { "os": "darwin" }, "sha512-8BWtPjOtJOJoykml3w0fx0zRrfWP31mXrJwfoA7xzNprkZw1uolCNfgmjDiVBseoKjp16EGITz7bN+61qn8dWA=="],
90 + "@mariozechner/clipboard-darwin-x64": ["@mariozechner/clipboard-darwin-x64@0.3.6", "", { "os": "darwin", "cpu": "x64" }, "sha512-p9syiZD1kU4I+1ya7f7g+zD1GiUvR8fdlRlNmgsZNWlyjtc8rlV2EjTLd/35x1LsdBq020GVvtzp0ZmPgBI09Q=="],
92 + "@mariozechner/clipboard-linux-arm64-gnu": ["@mariozechner/clipboard-linux-arm64-gnu@0.3.6", "", { "os": "linux", "cpu": "arm64" }, "sha512-5JFf5rGofrm+V29HNF+wLthXphHdQpMbKDUYJ5tML6/Z5DLlLOV/9Ak4kDPtYyZ+Dzf+kAusE0VsFg4+tfP1IA=="],
94 + "@mariozechner/clipboard-linux-arm64-musl": ["@mariozechner/clipboard-linux-arm64-musl@0.3.6", "", { "os": "linux", "cpu": "arm64" }, "sha512-JlVjxxw0GbGC0djXYWRIqyteO3J1KZ/QG3udlEFaOD5TLOM1FnmXXAPDQBqr+aBVr720ef9K00dirYnJ0LDCtw=="],
96 + "@mariozechner/clipboard-linux-riscv64-gnu": ["@mariozechner/clipboard-linux-riscv64-gnu@0.3.6", "", { "os": "linux", "cpu": "none" }, "sha512-4t8BUi5zZ+L77otFQVnVSlaTyAX4TVk9EqQm4syMrEQp96trFEHEwwNHcNEBGzYv5+K7mxay50TthYkz47OWzQ=="],
98 + "@mariozechner/clipboard-linux-x64-gnu": ["@mariozechner/clipboard-linux-x64-gnu@0.3.6", "", { "os": "linux", "cpu": "x64" }, "sha512-trtPwcNLW37irwQCJLtCxLw757jjJZk3TSnY/MU9bhtWtA3K9b/eLW0e4RGhUXDoFRds9opNWWaUDuFLa8dm0w=="],
100 + "@mariozechner/clipboard-linux-x64-musl": ["@mariozechner/clipboard-linux-x64-musl@0.3.6", "", { "os": "linux", "cpu": "x64" }, "sha512-WfnzIvOCCWQiN0MmltCEo6cLceUDbYe+I7xyFZjaps5A+2Op/M2CY7Rey+C4ucQhrvmpoHmTSFgY9ODWk7snoA=="],
102 + "@mariozechner/clipboard-win32-arm64-msvc": ["@mariozechner/clipboard-win32-arm64-msvc@0.3.6", "", { "os": "win32", "cpu": "arm64" }, "sha512-+8+1aHYsBPUjmW3otmWlg+Hijt0iJvoBBs5e0mxFeUd4gDaKMB8Bn6x7c6KVtscg7E5j5NFXnwQqNSIAO4p8zQ=="],
104 + "@mariozechner/clipboard-win32-x64-msvc": ["@mariozechner/clipboard-win32-x64-msvc@0.3.6", "", { "os": "win32", "cpu": "x64" }, "sha512-S4xfPmERC8ZkiLHe3vekZCjdDwNEETCuvCgQK2kP6/TnvmUkq1y2Pk+DjM4t8uh9KMX9bH4zs5ePcKa8GTXmfg=="],
106 + "@mistralai/mistralai": ["@mistralai/mistralai@2.2.1", "", { "dependencies": { "ws": "^8.18.0", "zod": "^3.25.0 || ^4.0.0", "zod-to-json-schema": "^3.25.0" } }, "sha512-uKU8CZmL2RzYKmplsU01hii4p3pe4HqJefpWNRWXm1Tcm0Sm4xXfwSLIy4k7ZCPlbETCGcp69E7hZs+WOJ5itQ=="],
108 + "@nodable/entities": ["@nodable/entities@2.1.0", "", {}, "sha512-nyT7T3nbMyBI/lvr6L5TyWbFJAI9FTgVRakNoBqCD+PmID8DzFrrNdLLtHMwMszOtqZa8PAOV24ZqDnQrhQINA=="],
110 + "@protobufjs/aspromise": ["@protobufjs/aspromise@1.1.2", "", {}, "sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ=="],
112 + "@protobufjs/base64": ["@protobufjs/base64@1.1.2", "", {}, "sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg=="],
114 + "@protobufjs/codegen": ["@protobufjs/codegen@2.0.5", "", {}, "sha512-zgXFLzW3Ap33e6d0Wlj4MGIm6Ce8O89n/apUaGNB/jx+hw+ruWEp7EwGUshdLKVRCxZW12fp9r40E1mQrf/34g=="],
116 + "@protobufjs/eventemitter": ["@protobufjs/eventemitter@1.1.1", "", {}, "sha512-vW1GmwMZNnL+gMRaovlh9yZX74kc+TTU3FObkkurpMaRtBfLP3ldjS9KQWlwZgraRE0+dheEEoAxdzcJQ8eXZg=="],
118 + "@protobufjs/fetch": ["@protobufjs/fetch@1.1.1", "", { "dependencies": { "@protobufjs/aspromise": "^1.1.1" } }, "sha512-GpptLrs57adMSuHi3VNj0mAF8dwh36LMaYF6XyJ6JMWlVsc+t42tm1HSEDmOs3A8fC9yyeisgLhsTVQokOZ0zw=="],
120 + "@protobufjs/float": ["@protobufjs/float@1.0.2", "", {}, "sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ=="],
122 + "@protobufjs/inquire": ["@protobufjs/inquire@1.1.2", "", {}, "sha512-pa0vFRuws4wkvaXKK1uXZMAwAX4/t8ANaJo45iw/oQHNQ9q5xUzwgFmVJGXiga2BeN+zpX7Vf9vmsiIa2J+MUw=="],
124 + "@protobufjs/path": ["@protobufjs/path@1.1.2", "", {}, "sha512-6JOcJ5Tm08dOHAbdR3GrvP+yUUfkjG5ePsHYczMFLq3ZmMkAD98cDgcT2iA1lJ9NVwFd4tH/iSSoe44YWkltEA=="],
126 + "@protobufjs/pool": ["@protobufjs/pool@1.1.0", "", {}, "sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw=="],
128 + "@protobufjs/utf8": ["@protobufjs/utf8@1.1.1", "", {}, "sha512-oOAWABowe8EAbMyWKM0tYDKi8Yaox52D+HWZhAIJqQXbqe0xI/GV7FhLWqlEKreMkfDjshR5FKgi3mnle0h6Eg=="],
130 + "@silvia-odwyer/photon-node": ["@silvia-odwyer/photon-node@0.3.4", "", {}, "sha512-bnly4BKB3KDTFxrUIcgCLbaeVVS8lrAkri1pEzskpmxu9MdfGQTy8b8EgcD83ywD3RPMsIulY8xJH5Awa+t9fA=="],
132 + "@smithy/core": ["@smithy/core@3.24.4", "", { "dependencies": { "@aws-crypto/crc32": "5.2.0", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-3UNRKEyQyAgVgM0LGlerCLm+ChZWZ1GPfde+jBEW6bm6bSBGU1p0EbblaUV3unbhwvidjLA5Zs3sOs7mnZwvAw=="],
134 + "@smithy/credential-provider-imds": ["@smithy/credential-provider-imds@4.3.4", "", { "dependencies": { "@smithy/core": "^3.24.4", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-vKW0MEFRU4Y3MkVZUkpJm+g9qyPGLCXhc0YLggUdSdBB4g7IaSSsCE75P9rBXyWHrXY1UYSQUl8/DwsTR7QciA=="],
136 + "@smithy/fetch-http-handler": ["@smithy/fetch-http-handler@5.4.4", "", { "dependencies": { "@smithy/core": "^3.24.4", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-qM7AUKI4G6d7lNgaZD3lA1tWSolh5r6gcixfTZAPstVURfjIbvreVTPz+994M0yC3HbX4YYhDRgr31Xy3XwWOQ=="],
138 + "@smithy/is-array-buffer": ["@smithy/is-array-buffer@2.2.0", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-GGP3O9QFD24uGeAXYUjwSTXARoqpZykHadOmA8G5vfJPK0/DC67qa//0qvqrJzL1xc8WQWX7/yc7fwudjPHPhA=="],
140 + "@smithy/node-http-handler": ["@smithy/node-http-handler@4.7.3", "", { "dependencies": { "@smithy/core": "^3.24.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-/jPhevcTFPMVl6KNjbaI47iOg1zxC7IsnX4PQDGVZKMFceOXtB8IEYaB7a9VvkP/3oC60WzTeKocvSI7vLT0vA=="],
142 + "@smithy/signature-v4": ["@smithy/signature-v4@5.4.4", "", { "dependencies": { "@smithy/core": "^3.24.4", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-e5UtkMvsatzBfbeBZjEOt0k0Z3BEsjTFL/n6fdO5vtBLe67tdy0dX7xw2DU7uZ3acwoHyeCqpU2Fzb7pxwHb6Q=="],
144 + "@smithy/types": ["@smithy/types@4.14.2", "", { "dependencies": { "tslib": "^2.6.2" } }, "sha512-P+otAxbV4CqBybp7EkcJCrig63yE2E7PuNVOmilVMRcx/O+QDzGULTrKsq4DV13gSfak9ObPrWaHl/9bL5YcWw=="],
146 + "@smithy/util-buffer-from": ["@smithy/util-buffer-from@2.2.0", "", { "dependencies": { "@smithy/is-array-buffer": "^2.2.0", "tslib": "^2.6.2" } }, "sha512-IJdWBbTcMQ6DA0gdNhh/BwrLkDR+ADW5Kr1aZmd4k3DIF6ezMV4R2NIAmT08wQJ3yUK82thHWmC/TnK/wpMMIA=="],
148 + "@smithy/util-utf8": ["@smithy/util-utf8@2.3.0", "", { "dependencies": { "@smithy/util-buffer-from": "^2.2.0", "tslib": "^2.6.2" } }, "sha512-R8Rdn8Hy72KKcebgLiv8jQcQkXoLMOGGv5uI1/k0l+snqkOzQ1R0ChUBCxWMlBsFMekWjq0wRudIweFs7sKT5A=="],
150 + "@types/node": ["@types/node@25.9.1", "", { "dependencies": { "undici-types": ">=7.24.0 <7.24.7" } }, "sha512-xfrlY7UD5rMJk3ZVJP8BNzS28J36YJg+xp+LPXV1TdWxr8uMH5A860QNxYDGQe/ylDSgjxE52Q9VnO7p75tJxg=="],
152 + "@types/retry": ["@types/retry@0.12.0", "", {}, "sha512-wWKOClTTiizcZhXnPY4wikVAwmdYHp8q6DmC+EJUzAMsycb7HB32Kh9RN4+0gExjmPmZSAQjgURXIGATPegAvA=="],
154 + "agent-base": ["agent-base@7.1.4", "", {}, "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ=="],
156 + "balanced-match": ["balanced-match@4.0.4", "", {}, "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA=="],
158 + "base64-js": ["base64-js@1.5.1", "", {}, "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA=="],
160 + "bignumber.js": ["bignumber.js@9.3.1", "", {}, "sha512-Ko0uX15oIUS7wJ3Rb30Fs6SkVbLmPBAKdlm7q9+ak9bbIeFf0MwuBsQV6z7+X768/cHsfg+WlysDWJcmthjsjQ=="],
162 + "bowser": ["bowser@2.14.1", "", {}, "sha512-tzPjzCxygAKWFOJP011oxFHs57HzIhOEracIgAePE4pqB3LikALKnSzUyU4MGs9/iCEUuHlAJTjTc5M+u7YEGg=="],
164 + "brace-expansion": ["brace-expansion@5.0.6", "", { "dependencies": { "balanced-match": "^4.0.2" } }, "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g=="],
166 + "buffer-equal-constant-time": ["buffer-equal-constant-time@1.0.1", "", {}, "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA=="],
168 + "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
170 + "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
172 + "data-uri-to-buffer": ["data-uri-to-buffer@4.0.1", "", {}, "sha512-0R9ikRb668HB7QDxT1vkpuUBtqc53YyAwMwGeUFKRojY/NWKvdZ+9UYtRfGmhqNbRkTSVpMbmyhXipFFv2cb/A=="],
174 + "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" }, "peerDependencies": { "supports-color": "*" }, "optionalPeers": ["supports-color"] }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
176 + "diff": ["diff@8.0.4", "", {}, "sha512-DPi0FmjiSU5EvQV0++GFDOJ9ASQUVFh5kD+OzOnYdi7n3Wpm9hWWGfB/O2blfHcMVTL5WkQXSnRiK9makhrcnw=="],
178 + "ecdsa-sig-formatter": ["ecdsa-sig-formatter@1.0.11", "", { "dependencies": { "safe-buffer": "^5.0.1" } }, "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ=="],
180 + "extend": ["extend@3.0.2", "", {}, "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g=="],
182 + "fast-xml-builder": ["fast-xml-builder@1.2.0", "", { "dependencies": { "path-expression-matcher": "^1.5.0", "xml-naming": "^0.1.0" } }, "sha512-00aAWieqff+ZJhsXA4g1g7M8k+7AYoMUUHF+/zFb5U6Uv/P0Vl4QZo84/IcufzYalLuEj9928bXN9PbbFzMF0Q=="],
184 + "fast-xml-parser": ["fast-xml-parser@5.7.3", "", { "dependencies": { "@nodable/entities": "^2.1.0", "fast-xml-builder": "^1.1.7", "path-expression-matcher": "^1.5.0", "strnum": "^2.2.3" }, "bin": { "fxparser": "src/cli/cli.js" } }, "sha512-C0AaNuC+mscy6vrAQKAc/rMq+zAPHodfHGZu4sGVehvAQt/JLG1O5zEcYcXSY5zSqr4YVgxsB+pHXTq0i7eDlg=="],
186 + "fetch-blob": ["fetch-blob@3.2.0", "", { "dependencies": { "node-domexception": "^1.0.0", "web-streams-polyfill": "^3.0.3" } }, "sha512-7yAQpD2UMJzLi1Dqv7qFYnPbaPx7ZfFK6PiIxQ4PfkGPyNyl2Ugx+a/umUonmKqjhM4DnfbMvdX6otXq83soQQ=="],
188 + "formdata-polyfill": ["formdata-polyfill@4.0.10", "", { "dependencies": { "fetch-blob": "^3.1.2" } }, "sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g=="],
190 + "gaxios": ["gaxios@7.1.4", "", { "dependencies": { "extend": "^3.0.2", "https-proxy-agent": "^7.0.1", "node-fetch": "^3.3.2" } }, "sha512-bTIgTsM2bWn3XklZISBTQX7ZSddGW+IO3bMdGaemHZ3tbqExMENHLx6kKZ/KlejgrMtj8q7wBItt51yegqalrA=="],
192 + "gcp-metadata": ["gcp-metadata@8.1.2", "", { "dependencies": { "gaxios": "^7.0.0", "google-logging-utils": "^1.0.0", "json-bigint": "^1.0.0" } }, "sha512-zV/5HKTfCeKWnxG0Dmrw51hEWFGfcF2xiXqcA3+J90WDuP0SvoiSO5ORvcBsifmx/FoIjgQN3oNOGaQ5PhLFkg=="],
194 + "get-east-asian-width": ["get-east-asian-width@1.6.0", "", {}, "sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA=="],
196 + "glob": ["glob@13.0.6", "", { "dependencies": { "minimatch": "^10.2.2", "minipass": "^7.1.3", "path-scurry": "^2.0.2" } }, "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw=="],
198 + "google-auth-library": ["google-auth-library@10.6.2", "", { "dependencies": { "base64-js": "^1.3.0", "ecdsa-sig-formatter": "^1.0.11", "gaxios": "^7.1.4", "gcp-metadata": "8.1.2", "google-logging-utils": "1.1.3", "jws": "^4.0.0" } }, "sha512-e27Z6EThmVNNvtYASwQxose/G57rkRuaRbQyxM2bvYLLX/GqWZ5chWq2EBoUchJbCc57eC9ArzO5wMsEmWftCw=="],
200 + "google-logging-utils": ["google-logging-utils@1.1.3", "", {}, "sha512-eAmLkjDjAFCVXg7A1unxHsLf961m6y17QFqXqAXGj/gVkKFrEICfStRfwUlGNfeCEjNRa32JEWOUTlYXPyyKvA=="],
202 + "graceful-fs": ["graceful-fs@4.2.11", "", {}, "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ=="],
204 + "highlight.js": ["highlight.js@10.7.3", "", {}, "sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A=="],
206 + "hosted-git-info": ["hosted-git-info@9.0.3", "", { "dependencies": { "lru-cache": "^11.1.0" } }, "sha512-Hc+ghLoSt6QaYZUv0WBiIvmMDZuZZ7oaDvdH8MbfOO4lOsxdXLEvuC6ePoGs9H1X9oCLyq6+NVN0MKqD+ydxyg=="],
208 + "http-proxy-agent": ["http-proxy-agent@7.0.2", "", { "dependencies": { "agent-base": "^7.1.0", "debug": "^4.3.4" } }, "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig=="],
210 + "https-proxy-agent": ["https-proxy-agent@7.0.6", "", { "dependencies": { "agent-base": "^7.1.2", "debug": "4" } }, "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw=="],
212 + "ignore": ["ignore@7.0.5", "", {}, "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg=="],
214 + "isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
216 + "jiti": ["jiti@2.7.0", "", { "bin": { "jiti": "lib/jiti-cli.mjs" } }, "sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ=="],
218 + "json-bigint": ["json-bigint@1.0.0", "", { "dependencies": { "bignumber.js": "^9.0.0" } }, "sha512-SiPv/8VpZuWbvLSMtTDU8hEfrZWg/mH/nV/b4o0CYbSxu1UIQPLdwKOCIyLQX+VIPO5vrLX3i8qtqFyhdPSUSQ=="],
220 + "json-schema-to-ts": ["json-schema-to-ts@3.1.1", "", { "dependencies": { "@babel/runtime": "^7.18.3", "ts-algebra": "^2.0.0" } }, "sha512-+DWg8jCJG2TEnpy7kOm/7/AxaYoaRbjVB4LFZLySZlWn8exGs3A4OLJR966cVvU26N7X9TWxl+Jsw7dzAqKT6g=="],
222 + "jwa": ["jwa@2.0.1", "", { "dependencies": { "buffer-equal-constant-time": "^1.0.1", "ecdsa-sig-formatter": "1.0.11", "safe-buffer": "^5.0.1" } }, "sha512-hRF04fqJIP8Abbkq5NKGN0Bbr3JxlQ+qhZufXVr0DvujKy93ZCbXZMHDL4EOtodSbCWxOqR8MS1tXA5hwqCXDg=="],
224 + "jws": ["jws@4.0.1", "", { "dependencies": { "jwa": "^2.0.1", "safe-buffer": "^5.0.1" } }, "sha512-EKI/M/yqPncGUUh44xz0PxSidXFr/+r0pA70+gIYhjv+et7yxM+s29Y+VGDkovRofQem0fs7Uvf4+YmAdyRduA=="],
226 + "long": ["long@5.3.2", "", {}, "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA=="],
228 + "lru-cache": ["lru-cache@11.5.0", "", {}, "sha512-5YgH9UJd7wVb9hIouI2adWpgqrrICkt070Dnj8EUY1+B4B2P9eRLPAkAAo6NICA7CEhOIeBHl46u9zSNpNu7zA=="],
230 + "marked": ["marked@15.0.12", "", { "bin": { "marked": "bin/marked.js" } }, "sha512-8dD6FusOQSrpv9Z1rdNMdlSgQOIP880DHqnohobOmYLElGEqAL/JvxvuxZO16r4HtjTlfPRDC1hbvxC9dPN2nA=="],
232 + "minimatch": ["minimatch@10.2.5", "", { "dependencies": { "brace-expansion": "^5.0.5" } }, "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg=="],
234 + "minipass": ["minipass@7.1.3", "", {}, "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A=="],
236 + "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
238 + "node-domexception": ["node-domexception@1.0.0", "", {}, "sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ=="],
240 + "node-fetch": ["node-fetch@3.3.2", "", { "dependencies": { "data-uri-to-buffer": "^4.0.0", "fetch-blob": "^3.1.4", "formdata-polyfill": "^4.0.10" } }, "sha512-dRB78srN/l6gqWulah9SrxeYnxeddIG30+GOqK/9OlLVyLg3HPnr6SqOWTWOXKRwC2eGYCkZ59NNuSgvSrpgOA=="],
242 + "openai": ["openai@6.26.0", "", { "peerDependencies": { "ws": "^8.18.0", "zod": "^3.25 || ^4.0" }, "optionalPeers": ["ws", "zod"], "bin": { "openai": "bin/cli" } }, "sha512-zd23dbWTjiJ6sSAX6s0HrCZi41JwTA1bQVs0wLQPZ2/5o2gxOJA5wh7yOAUgwYybfhDXyhwlpeQf7Mlgx8EOCA=="],
244 + "p-retry": ["p-retry@4.6.2", "", { "dependencies": { "@types/retry": "0.12.0", "retry": "^0.13.1" } }, "sha512-312Id396EbJdvRONlngUx0NydfrIQ5lsYu0znKVUzVvArzEIt08V1qhtyESbGVd1FGX7UKtiFp5uwKZdM8wIuQ=="],
246 + "partial-json": ["partial-json@0.1.7", "", {}, "sha512-Njv/59hHaokb/hRUjce3Hdv12wd60MtM9Z5Olmn+nehe0QDAsRtRbJPvJ0Z91TusF0SuZRIvnM+S4l6EIP8leA=="],
248 + "path-expression-matcher": ["path-expression-matcher@1.5.0", "", {}, "sha512-cbrerZV+6rvdQrrD+iGMcZFEiiSrbv9Tfdkvnusy6y0x0GKBXREFg/Y65GhIfm0tnLntThhzCnfKwp1WRjeCyQ=="],
250 + "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
252 + "path-scurry": ["path-scurry@2.0.2", "", { "dependencies": { "lru-cache": "^11.0.0", "minipass": "^7.1.2" } }, "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg=="],
254 + "proper-lockfile": ["proper-lockfile@4.1.2", "", { "dependencies": { "graceful-fs": "^4.2.4", "retry": "^0.12.0", "signal-exit": "^3.0.2" } }, "sha512-TjNPblN4BwAWMXU8s9AEz4JmQxnD1NNL7bNOY/AKUzyamc379FWASUhc/K1pL2noVb+XmZKLL68cjzLsiOAMaA=="],
256 + "protobufjs": ["protobufjs@7.6.1", "", { "dependencies": { "@protobufjs/aspromise": "^1.1.2", "@protobufjs/base64": "^1.1.2", "@protobufjs/codegen": "^2.0.5", "@protobufjs/eventemitter": "^1.1.1", "@protobufjs/fetch": "^1.1.1", "@protobufjs/float": "^1.0.2", "@protobufjs/inquire": "^1.1.2", "@protobufjs/path": "^1.1.2", "@protobufjs/pool": "^1.1.0", "@protobufjs/utf8": "^1.1.1", "@types/node": ">=13.7.0", "long": "^5.3.2" } }, "sha512-4K0myLaWL5EteuSAro91EGFgcfVgxb64Jx+7oDAY6GOkXD4M69yuSEljNcInGVCA5sOPxmZ/EqDLj2x0Q0+Ygg=="],
258 + "retry": ["retry@0.12.0", "", {}, "sha512-9LkiTwjUh6rT555DtE9rTX+BKByPfrMzEAtnlEtdEwr3Nkffwiihqe2bWADg+OQRjt9gl6ICdmB/ZFDCGAtSow=="],
260 + "safe-buffer": ["safe-buffer@5.2.1", "", {}, "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ=="],
262 + "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
264 + "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
266 + "signal-exit": ["signal-exit@3.0.7", "", {}, "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ=="],
268 + "strnum": ["strnum@2.3.0", "", {}, "sha512-ums3KNd42PGyx5xaoVTO1mjU1bH3NpY4vsrVlnv9PNGqQj8wd7rJ6nEypLrJ7z5vxK5RP0yMLo6J/Gsm62DI5Q=="],
270 + "ts-algebra": ["ts-algebra@2.0.0", "", {}, "sha512-FPAhNPFMrkwz76P7cdjdmiShwMynZYN6SgOujD1urY4oNm80Ou9oMdmbR45LotcKOXoy7wSmHkRFE6Mxbrhefw=="],
272 + "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
274 + "typebox": ["typebox@1.1.38", "", {}, "sha512-pZ0aQPmMmXoUvSbeuWf/Hzsc+avNw/Zd6VeE8CFgkVGWyuHPJvqeJJDeJqLve+K70LvjYIoleGcoJHPT17cWoA=="],
276 + "undici": ["undici@8.3.0", "", {}, "sha512-TkUDgb6tl7KOGZ+7e8E3d2FYgUQgF6z5YypqjWmixVQSQERFcVrVg0ySADm2LVLRh5ljAaHTCR5Fmz3Q34rB7Q=="],
278 + "undici-types": ["undici-types@7.24.6", "", {}, "sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg=="],
280 + "web-streams-polyfill": ["web-streams-polyfill@3.3.3", "", {}, "sha512-d2JWLCivmZYTSIoge9MsgFCZrt571BikcWGYkjC1khllbTeDlGqZ2D8vD8E/lJa8WGWbb7Plm8/XJYV7IJHZZw=="],
282 + "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
284 + "ws": ["ws@8.21.0", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-Vsp28b7DRcimFQvrqu2Wek3z1iYxDCWqHYB8Qsnk/S4RfaCQzPGPyBNuVjJV3cd6UiKtUtp6sNM77gWvzcCH+g=="],
286 + "xml-naming": ["xml-naming@0.1.0", "", {}, "sha512-k8KO9hrMyNk6tUWqUfkTEZbezRRpONVOzUTnc97VnCvyj6Tf9lyUR9EDAIeiVLv56jsMcoXEwjW8Kv5yPY52lw=="],
288 + "yaml": ["yaml@2.9.0", "", { "bin": { "yaml": "bin.mjs" } }, "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA=="],
290 + "zod": ["zod@4.4.3", "", {}, "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ=="],
292 + "zod-to-json-schema": ["zod-to-json-schema@3.25.2", "", { "peerDependencies": { "zod": "^3.25.28 || ^4" } }, "sha512-O/PgfnpT1xKSDeQYSCfRI5Gy3hPf91mKVDuYLUHZJMiDFptvP41MSnWofm8dnCm0256ZNfZIM7DSzuSMAFnjHA=="],
294 + "@aws-sdk/credential-provider-sso/@aws-sdk/token-providers": ["@aws-sdk/token-providers@3.1052.0", "", { "dependencies": { "@aws-sdk/core": "^3.974.13", "@aws-sdk/nested-clients": "^3.997.11", "@aws-sdk/types": "^3.973.9", "@smithy/core": "^3.24.3", "@smithy/types": "^4.14.2", "tslib": "^2.6.2" } }, "sha512-QqZNB3so7UIDxZtroc85TQaLVxdZRFm0eWM1CSR2N+b06as9TOrilvrlTZuj3guYlxMs6yLOgGxnklJ5qMYtTw=="],
296 + "p-retry/retry": ["retry@0.13.1", "", {}, "sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg=="],

extensions/tldr/index.ts

Added
new file mode 100644
1 +import { complete } from "@earendil-works/pi-ai";
2 +import type { Model, UserMessage } from "@earendil-works/pi-ai";
3 +import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
5 +type SettingsAPI = ExtensionAPI & {
6 + settingsManager?: { getSettings(): Record<string, unknown> | undefined };
7 +};
9 +type TldrSettings = {
10 + model?: string;
11 +};
13 +type TimerScheduler = {
14 + setTimeout(callback: () => void, delayMs: number): unknown;
15 + clearTimeout(handle: unknown): void;
16 +};
18 +type GenerateTldr = typeof complete;
20 +type TldrPriority = "immediate" | "normal" | "final";
22 +type TldrActivityType =
23 + | "user"
24 + | "assistant_update"
25 + | "tool_call"
26 + | "tool_start"
27 + | "tool_update"
28 + | "tool_end"
29 + | "tool_result"
30 + | "assistant_final"
31 + | "assistant_failure";
33 +type TldrActivity = {
34 + index: number;
35 + type: TldrActivityType;
36 + priority: TldrPriority;
37 + text: string;
38 +};
40 +type TldrCheckpoint = {
41 + index: number;
42 + text: string;
43 +};
45 +type TldrModelRef = {
46 + provider: string;
47 + id: string;
48 +};
50 +type TldrAuth = {
51 + model: Model<any>;
52 + apiKey: string;
53 + headers?: Record<string, string>;
54 +};
56 +type TldrEngineOptions = {
57 + facts: FactCollector;
58 + generate?: GenerateTldr;
59 + scheduler?: TimerScheduler;
60 + configuredModelRef?: string;
61 +};
63 +const WIDGET_KEY = "tldr";
64 +const STATUS_UNAVAILABLE = "tldr unavailable";
65 +const DEFAULT_MAX_ACTIVITIES = 128;
66 +const DEFAULT_MAX_ACTIVITY_CHARS = 1_500;
67 +const MAX_TLDR_CHARS = 160;
68 +const MAX_CONTEXT_CHECKPOINTS = 6;
69 +const NORMAL_COALESCE_MS = 350;
70 +const TLDR_MAX_TOKENS = 120;
71 +const TLDR_TIMEOUT_MS = 2_000;
72 +const IN_PROGRESS_TENSE = "Start with a present-tense -ing verb.";
73 +const COMPLETED_TENSE = "Start with a past-tense verb.";
75 +function tldrSystemPrompt(tenseInstruction: string): string {
76 + return `Write one plain-English TLDR for a Pi coding agent.
77 +Use the prior TLDRs for context and the new activity for the update.
78 +Describe the work progress as if a human developer were doing it.
79 +Focus on the task activity and current outcome, not agent mechanics.
80 +Do not mention tools, tool calls, prompts, messages, model output, or implementation details.
81 +Summarize only activity up to the requested index.
82 +If context is sparse, still summarize the available activity.
83 +Never ask for more information or say there is not enough context.
84 +Return exactly one complete sentence under 80 characters.
85 +Use third person. Do not address the user.
86 +Plain text only; no markdown, JSON, code, bullets, quotes, or file/tool names.
87 +${tenseInstruction}`;
90 +const ANSI_RE = /\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~]|\][^\x07]*(?:\x07|\x1B\\))/g;
91 +const CONTROL_RE = /[\x00-\x1F\x7F-\x9F]/g;
93 +const defaultScheduler: TimerScheduler = {
94 + setTimeout(callback, delayMs) { return setTimeout(callback, delayMs); },
95 + clearTimeout(handle) { clearTimeout(handle as ReturnType<typeof setTimeout>); },
96 +};
98 +function isRecord(value: unknown): value is Record<string, unknown> {
99 + return value !== null && typeof value === "object" && !Array.isArray(value);
102 +function textFromContent(content: unknown): string {
103 + if (typeof content === "string") return content;
104 + if (!Array.isArray(content)) return "";
105 + return content
106 + .map((part) => isRecord(part) && part.type === "text" && typeof part.text === "string" ? part.text : "")
107 + .filter(Boolean)
108 + .join("\n");
111 +function formatPayload(value: unknown): string {
112 + if (value === undefined || value === null) return "";
113 + if (typeof value === "string") return value;
114 + if (isRecord(value)) {
115 + const content = textFromContent(value.content);
116 + if (content) return content;
117 + if (typeof value.text === "string") return value.text;
119 + try { return JSON.stringify(value) ?? String(value); }
120 + catch { return String(value); }
123 +function truncateChars(text: string, maxChars: number): string {
124 + const chars = Array.from(text);
125 + if (chars.length <= maxChars) return text;
126 + if (maxChars <= 1) return "…";
127 + return `${chars.slice(0, maxChars - 1).join("")}…`;
130 +function sanitizeTldrText(text: string, maxChars = MAX_TLDR_CHARS): string {
131 + return truncateChars(
132 + text
133 + .replace(ANSI_RE, "")
134 + .replace(CONTROL_RE, " ")
135 + .replace(/\s+/g, " ")
136 + .trim(),
137 + maxChars,
138 + );
141 +function wrapText(text: string, width: number): string[] {
142 + const lines: string[] = [];
143 + let current = "";
145 + for (const word of text.split(" ")) {
146 + let rest = word;
147 + while (Array.from(rest).length > width) {
148 + if (current) {
149 + lines.push(current);
150 + current = "";
152 + const chars = Array.from(rest);
153 + lines.push(chars.slice(0, width).join(""));
154 + rest = chars.slice(width).join("");
156 + if (!rest) continue;
158 + const candidate = current ? `${current} ${rest}` : rest;
159 + if (Array.from(candidate).length <= width) {
160 + current = candidate;
161 + } else {
162 + if (current) lines.push(current);
163 + current = rest;
167 + if (current) lines.push(current);
168 + return lines.length ? lines : [""];
171 +function boxLines(text: string): string[] {
172 + const safe = sanitizeTldrText(text);
173 + if (!safe) return [];
174 + const title = " tldr ";
175 + const contentWidth = Math.max(10, Math.min(76, Array.from(safe).length));
176 + const width = contentWidth + 4;
177 + const contentLines = wrapText(safe, contentWidth).map((line) => {
178 + const lineLength = Array.from(line).length;
179 + return line + " ".repeat(Math.max(0, contentWidth - lineLength));
180 + });
181 + return [
182 + `╭${title}${"─".repeat(Math.max(1, width - Array.from(title).length - 2))}╮`,
183 + ...contentLines.map((line) => `│ ${line} │`),
184 + `╰${"─".repeat(width - 2)}╯`,
185 + ];
188 +function showTldr(ctx: ExtensionContext, text: string): void {
189 + if (!ctx.hasUI) return;
190 + const safe = sanitizeTldrText(text);
191 + if (!safe) return clearTldr(ctx);
192 + ctx.ui.setWidget(WIDGET_KEY, boxLines(safe));
195 +function clearTldr(ctx: ExtensionContext): void {
196 + if (!ctx.hasUI) return;
197 + ctx.ui.setWidget(WIDGET_KEY, undefined);
200 +function settingsFrom(pi: ExtensionAPI): TldrSettings {
201 + const raw = (pi as SettingsAPI).settingsManager?.getSettings?.();
202 + const tldr = isRecord(raw?.tldr) ? raw.tldr : {};
203 + return {
204 + model: typeof tldr.model === "string" && tldr.model.trim() ? tldr.model.trim() : undefined,
205 + };
208 +function parseModelRef(value: string | undefined): TldrModelRef | undefined {
209 + const trimmed = value?.trim() ?? "";
210 + const separator = trimmed.indexOf("/");
211 + if (separator <= 0 || separator === trimmed.length - 1) return undefined;
212 + return { provider: trimmed.slice(0, separator), id: trimmed.slice(separator + 1) };
215 +async function authForModel(ctx: ExtensionContext, model: Model<any> | undefined): Promise<TldrAuth | undefined> {
216 + if (!model) return undefined;
217 + const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
218 + return auth.ok && auth.apiKey ? { model, apiKey: auth.apiKey, headers: auth.headers } : undefined;
221 +async function resolveTldrModel(ctx: ExtensionContext, modelRef: string | undefined): Promise<TldrAuth | undefined> {
222 + const parsed = parseModelRef(modelRef);
223 + if (parsed) {
224 + const configured = ctx.modelRegistry.find(parsed.provider, parsed.id);
225 + const configuredAuth = await authForModel(ctx, configured);
226 + if (configuredAuth) return configuredAuth;
228 + return authForModel(ctx, ctx.model);
231 +class FactCollector {
232 + private nextIndex = 1;
233 + private readonly activities: TldrActivity[] = [];
234 + constructor(private readonly maxActivities = DEFAULT_MAX_ACTIVITIES, private readonly maxActivityChars = DEFAULT_MAX_ACTIVITY_CHARS) {}
236 + private add(type: TldrActivityType, priority: TldrPriority, text: string): TldrActivity {
237 + const activity = { index: this.nextIndex++, type, priority, text: truncateChars(sanitizeTldrText(text, this.maxActivityChars), this.maxActivityChars) };
238 + this.activities.push(activity);
239 + if (this.activities.length > this.maxActivities) this.activities.splice(0, this.activities.length - this.maxActivities);
240 + return activity;
243 + reset(): void {
244 + this.nextIndex = 1;
245 + this.activities.splice(0);
248 + recordUser(prompt: string): TldrActivity { return this.add("user", "immediate", `User asked: ${prompt}`); }
249 + recordAssistantUpdate(message: unknown): TldrActivity | undefined {
250 + const text = textFromContent(isRecord(message) ? message.content : undefined);
251 + return text ? this.add("assistant_update", "normal", `Assistant draft: ${text}`) : undefined;
253 + recordToolCall(toolName: string, input: unknown): TldrActivity { return this.add("tool_call", "normal", `Preparing ${toolName}: ${formatPayload(input)}`); }
254 + recordToolStart(toolName: string, input: unknown): TldrActivity { return this.add("tool_start", "normal", `Running ${toolName}: ${formatPayload(input)}`); }
255 + recordToolUpdate(toolName: string, update: unknown): TldrActivity { return this.add("tool_update", "normal", `Still running ${toolName}: ${formatPayload(update)}`); }
256 + recordToolEnd(toolName: string, isError: boolean, result: unknown): TldrActivity { return this.add("tool_end", "normal", `${toolName} ${isError ? "failed" : "finished"}: ${formatPayload(result)}`); }
257 + recordToolResult(toolName: string, isError: boolean, content: unknown): TldrActivity { return this.add("tool_result", "normal", `${toolName} ${isError ? "errored" : "returned"}: ${textFromContent(content) || formatPayload(content)}`); }
258 + recordFinal(text: string): TldrActivity { return this.add("assistant_final", "final", `Assistant final response: ${text}`); }
259 + recordFailure(reason: string): TldrActivity { return this.add("assistant_failure", "final", `Assistant failed: ${reason}`); }
261 + activitiesAfter(previousIndex: number, throughIndex: number): readonly TldrActivity[] {
262 + return this.activities.filter((activity) => activity.index > previousIndex && activity.index <= throughIndex);
265 + discardThrough(index: number): void {
266 + const keepFrom = this.activities.findIndex((activity) => activity.index > index);
267 + if (keepFrom === -1) this.activities.splice(0);
268 + else if (keepFrom > 0) this.activities.splice(0, keepFrom);
272 +function usesCompletedTense(type: TldrActivityType): boolean {
273 + return type === "tool_end" || type === "tool_result" || type === "assistant_final" || type === "assistant_failure";
276 +function buildTldrPrompt(activities: readonly TldrActivity[], checkpoints: readonly TldrCheckpoint[], throughIndex: number): { systemPrompt: string; message: UserMessage } {
277 + const previous = checkpoints.length
278 + ? checkpoints.slice(-MAX_CONTEXT_CHECKPOINTS).map((checkpoint) => `- Through activity ${checkpoint.index}: ${checkpoint.text}`).join("\n")
279 + : "none";
280 + const raw = activities.map((activity) => `[${activity.index}] ${activity.type}: ${activity.text}`).join("\n");
281 + const lastActivity = activities.at(-1);
282 + const tense = lastActivity && usesCompletedTense(lastActivity.type) ? COMPLETED_TENSE : IN_PROGRESS_TENSE;
283 + return {
284 + systemPrompt: tldrSystemPrompt(tense),
285 + message: {
286 + role: "user",
287 + content: [{ type: "text", text: [
288 + "Previous generated TLDR checkpoints:",
289 + previous,
290 + "",
291 + "New raw activity since the latest accepted checkpoint:",
292 + raw,
293 + "",
294 + `Write the next TLDR through activity ${throughIndex}.`,
295 + ].join("\n") }],
296 + timestamp: Date.now(),
297 + },
298 + };
301 +class TldrEngine {
302 + private runId = 0;
303 + private latestAcceptedIndex = 0;
304 + private inFlight: { index: number; runId: number } | undefined;
305 + private readonly queue: Array<{ index: number; priority: TldrPriority; runId: number }> = [];
306 + private readonly checkpoints: TldrCheckpoint[] = [];
307 + private pendingNormal: { index: number; priority: TldrPriority; runId: number } | undefined;
308 + private normalTimer: unknown;
309 + private readonly facts: FactCollector;
310 + private readonly generate: GenerateTldr;
311 + private readonly scheduler: TimerScheduler;
312 + private readonly configuredModelRef?: string;
314 + constructor(options: TldrEngineOptions) {
315 + this.facts = options.facts;
316 + this.generate = options.generate ?? complete;
317 + this.scheduler = options.scheduler ?? defaultScheduler;
318 + this.configuredModelRef = options.configuredModelRef;
321 + startFreshRun(ctx?: ExtensionContext): void {
322 + this.runId++;
323 + this.latestAcceptedIndex = 0;
324 + this.queue.splice(0);
325 + this.checkpoints.splice(0);
326 + this.inFlight = undefined;
327 + this.clearNormalTimer();
328 + if (ctx) clearTldr(ctx);
331 + enqueue(ctx: ExtensionContext, activity: TldrActivity): void {
332 + if (!ctx.hasUI) return;
333 + const job = { index: activity.index, priority: activity.priority, runId: this.runId };
334 + if (activity.priority === "normal") {
335 + this.pendingNormal = job;
336 + this.clearNormalTimer();
337 + this.normalTimer = this.scheduler.setTimeout(() => {
338 + this.normalTimer = undefined;
339 + const pending = this.pendingNormal;
340 + this.pendingNormal = undefined;
341 + if (!pending || pending.runId !== this.runId) return;
342 + this.queue.splice(0, this.queue.length, pending);
343 + this.pump(ctx);
344 + }, NORMAL_COALESCE_MS);
345 + return;
347 + this.clearNormalTimer();
348 + this.pendingNormal = undefined;
349 + if (activity.priority === "immediate") this.queue.splice(0);
350 + this.queue.push(job);
351 + this.pump(ctx);
354 + private clearNormalTimer(): void {
355 + if (this.normalTimer === undefined) return;
356 + this.scheduler.clearTimeout(this.normalTimer);
357 + this.normalTimer = undefined;
360 + private pump(ctx: ExtensionContext): void {
361 + if (this.inFlight) return;
362 + const job = this.queue.shift();
363 + if (!job) return;
364 + if (job.runId !== this.runId || job.index <= this.latestAcceptedIndex) return this.pump(ctx);
365 + this.inFlight = { index: job.index, runId: job.runId };
366 + void this.generateCheckpoint(ctx, job);
369 + private async generateCheckpoint(ctx: ExtensionContext, job: { index: number; priority: TldrPriority; runId: number }): Promise<void> {
370 + try {
371 + const activities = this.facts.activitiesAfter(this.latestAcceptedIndex, job.index);
372 + if (activities.length === 0) return;
373 + const auth = await resolveTldrModel(ctx, this.configuredModelRef);
374 + if (!this.isCurrent(job)) return;
375 + if (!auth) {
376 + showTldr(ctx, STATUS_UNAVAILABLE);
377 + return;
379 + const prompt = buildTldrPrompt(activities, this.checkpoints, job.index);
380 + const response = await this.generate(auth.model, { systemPrompt: prompt.systemPrompt, messages: [prompt.message] }, {
381 + apiKey: auth.apiKey,
382 + headers: auth.headers,
383 + maxTokens: TLDR_MAX_TOKENS,
384 + maxRetries: 0,
385 + cacheRetention: "none",
386 + timeoutMs: TLDR_TIMEOUT_MS,
387 + signal: ctx.signal,
388 + });
389 + if (!this.isCurrent(job)) return;
390 + if (response.stopReason !== "stop") return;
391 + const text = sanitizeTldrText(textFromContent(response.content));
392 + if (!text) return;
393 + this.latestAcceptedIndex = job.index;
394 + this.checkpoints.push({ index: job.index, text });
395 + if (this.checkpoints.length > MAX_CONTEXT_CHECKPOINTS) this.checkpoints.splice(0, this.checkpoints.length - MAX_CONTEXT_CHECKPOINTS);
396 + this.facts.discardThrough(job.index);
397 + showTldr(ctx, text);
398 + } catch {
399 + // Best effort. Later activity can recover.
400 + } finally {
401 + if (this.inFlight?.index === job.index && this.inFlight.runId === job.runId) this.inFlight = undefined;
402 + this.pump(ctx);
406 + private isCurrent(job: { index: number; runId: number }): boolean {
407 + return this.inFlight?.index === job.index && this.inFlight.runId === job.runId && job.runId === this.runId;
411 +function assistantEndActivity(facts: FactCollector, message: unknown): TldrActivity | undefined {
412 + if (!isRecord(message)) return undefined;
413 + const stopReason = typeof message.stopReason === "string" ? message.stopReason : "";
414 + if (stopReason === "toolUse") return undefined;
415 + if (stopReason === "stop") {
416 + const text = textFromContent(message.content);
417 + return text ? facts.recordFinal(text) : undefined;
419 + return stopReason ? facts.recordFailure(typeof message.errorMessage === "string" ? message.errorMessage : stopReason) : undefined;
422 +function registerTldrCommand(pi: ExtensionAPI, state: { enabled: boolean; settings: TldrSettings; engine: TldrEngine }): void {
423 + pi.registerCommand("tldr", {
424 + description: "Toggle live TLDR widget",
425 + handler: async (args, ctx) => {
426 + const action = args.trim().toLowerCase();
427 + if (action === "status") {
428 + ctx.ui.notify(`tldr ${state.enabled ? "on" : "off"}\nmodel: ${state.settings.model ?? "current"}`, "info");
429 + return;
431 + if (action === "help") {
432 + ctx.ui.notify("/tldr [on|off|toggle|status|help]", "info");
433 + return;
435 + if (action === "on") state.enabled = true;
436 + else if (action === "off") state.enabled = false;
437 + else state.enabled = !state.enabled;
438 + if (!state.enabled) clearTldr(ctx);
439 + ctx.ui.notify(`tldr ${state.enabled ? "on" : "off"}`, "info");
440 + },
441 + });
444 +function createTldrExtension(deps: { generate?: GenerateTldr; scheduler?: TimerScheduler } = {}) {
445 + return function tldrExtension(pi: ExtensionAPI) {
446 + const facts = new FactCollector();
447 + const settings = settingsFrom(pi);
448 + const engine = new TldrEngine({ facts, generate: deps.generate, scheduler: deps.scheduler, configuredModelRef: settings.model });
449 + const state = { enabled: true, settings, engine };
451 + const maybe = (ctx: ExtensionContext, activity: TldrActivity | undefined) => {
452 + if (!state.enabled || !activity) return;
453 + engine.enqueue(ctx, activity);
454 + };
456 + registerTldrCommand(pi, state);
458 + pi.on("session_start", (_event, ctx) => {
459 + facts.reset();
460 + engine.startFreshRun(ctx);
461 + });
462 + pi.on("session_shutdown", (_event, ctx) => {
463 + facts.reset();
464 + engine.startFreshRun(ctx);
465 + });
466 + pi.on("before_agent_start", (event, ctx) => {
467 + facts.reset();
468 + engine.startFreshRun(ctx);
469 + maybe(ctx, facts.recordUser(event.prompt));
470 + });
471 + pi.on("message_update", (event, ctx) => maybe(ctx, facts.recordAssistantUpdate(event.message)));
472 + pi.on("tool_call", (event, ctx) => maybe(ctx, facts.recordToolCall(event.toolName, event.input)));
473 + pi.on("tool_execution_start", (event, ctx) => maybe(ctx, facts.recordToolStart(event.toolName, event.args)));
474 + pi.on("tool_execution_update", (event, ctx) => maybe(ctx, facts.recordToolUpdate(event.toolName, event.partialResult)));
475 + pi.on("tool_execution_end", (event, ctx) => maybe(ctx, facts.recordToolEnd(event.toolName, event.isError, event.result)));
476 + pi.on("tool_result", (event, ctx) => maybe(ctx, facts.recordToolResult(event.toolName, event.isError, event.content)));
477 + pi.on("message_end", (event, ctx) => maybe(ctx, assistantEndActivity(facts, event.message)));
478 + };
481 +export { createTldrExtension };
482 +export const __test = { FactCollector, TldrEngine, sanitizeTldrText, buildTldrPrompt, parseModelRef, resolveTldrModel, boxLines, settingsFrom };
483 +export default createTldrExtension();

extensions/tldr/package.json

Added
new file mode 100644
1 +{
2 + "name": "@bugabinga/pi-ext-tldr",
3 + "type": "module",
4 + "main": "index.ts",
5 + "peerDependencies": {
6 + "@earendil-works/pi-ai": "*",
7 + "@earendil-works/pi-coding-agent": "*",
8 + "@earendil-works/pi-tui": "*"
9 + },
10 + "license": "MIT",
11 + "description": "Live TLDR widget for Pi.",
12 + "keywords": [
13 + "pi",
14 + "pi-extension"
15 + ],
16 + "devDependencies": {
17 + "@marcfargas/pi-test-harness": "^0.6.1"
18 + },
19 + "scripts": {
20 + "test:harness": "bun test ./__tests__/harness.test.ts",
21 + "test": "bun test ./__tests__/*.test.ts"
22 + },
23 + "private": true