@prjct.app/pi-activity 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.1.0
+
+- Set the npm package identity to `@prjct.app/pi-activity`.
+- Clarify installation, project scope, updates, removal, usage, and limitations.
+- Document resource discovery and dependencies against the official Pi 0.85.1 guides.
+- Include contribution and package documentation in the release file list.
+
+Initial npm release. The documentation and naming changes preserve the existing extension runtime behavior.

package/CONTRIBUTING.md

@@ -0,0 +1,14 @@
+# Contributing
+
+- Integration branch: `main`. Create a feature branch from `main`.
+- Deliver changes through a pull request using `.github/pull_request_template.md`.
+- Use English for code, documentation, tests, issues, and pull requests.
+- Use strict TypeScript and only APIs documented by Pi 0.85.1.
+- Do not import host internals, monkey-patch prototypes, or access real credentials, sessions, or user configuration in tests.
+- Keep runtime dependencies in `dependencies`; list Pi-provided packages in `peerDependencies` with a `*` range.
+- Run `npm run check`, `npm test`, and `npm pack --dry-run` before review.
+- Never push, open or merge a pull request, publish, or deploy without explicit authorization.
+
+## Package documentation
+
+Follow [docs/package.md](docs/package.md) and its versioned official references. Keep README examples consistent with registered commands, distinguish tested behavior from unverified compatibility, and verify `npm run check:package` before release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 prjct
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# pi-activity
+
+Compact, expandable tool activity and run summaries for Pi.
+
+`@prjct.app/pi-activity` · Tool renderers and activity summaries; one extension.
+
+## Install
+
+Requires Pi installed separately and Node.js **22.19 or later**. Compatibility is tested with **Pi 0.85.1**; newer versions are not yet verified. This is an independent community package.
+
+Install with Pi's package manager:
+
+```sh
+pi install npm:@prjct.app/pi-activity
+```
+
+For project-only installation, add `-l`: `pi install -l npm:@prjct.app/pi-activity`. Restart Pi after installation. Do not install the same extension from both GitHub and npm: Pi treats those as different package identities.
+
+## Usage
+
+Start Pi and ask it to inspect a file or run a command. Tool calls appear as compact rows. Use Pi's tool-output expansion shortcut (Ctrl+O by default) to inspect details. An activity summary is added after the agent settles.
+
+The extension retains the native execution functions for the built-in tools it overrides. It changes their presentation and tracks actions, errors, and modified-file evidence. It does not remove thinking transcript rows. Avoid enabling another extension that overrides the same built-in tool renderers.
+
+
+## Manage the package
+
+For an npm installation:
+
+```sh
+pi list
+pi update npm:@prjct.app/pi-activity
+pi remove npm:@prjct.app/pi-activity
+```
+
+Use `pi config` to enable or disable individual resources. Use `pi config -l` for project settings and add `-l` to removal when you installed locally.
+
+To pin version 0.1.0, use `pi install npm:@prjct.app/pi-activity@0.1.0`. Pi skips pinned npm versions during package updates. For a Git installation, update or remove using the same `git:github.com/prjct-app/pi-minimalist-activity` source instead of the npm source.
+
+When switching from GitHub to npm, remove the Git installation first, then install the npm package and restart Pi.
+
+## Troubleshooting
+
+If the compact rows are missing, inspect enabled resources with `pi config` and check for another extension registering the same tool names. Terminal UI changes require TUI mode.
+
+## Package and API documentation
+
+Uses documented `registerTool()` overrides, working-message and working-indicator APIs, lifecycle events, and persisted summary entries.
+
+See [Package structure and compatibility](docs/package.md) for the manifest, dependency policy, shipped resources, and official references. This package follows the [official Pi package guide](https://github.com/earendil-works/pi/blob/v0.85.1/packages/coding-agent/docs/packages.md) and [extension API guide](https://github.com/earendil-works/pi/blob/v0.85.1/packages/coding-agent/docs/extensions.md) for the tested version.
+
+## Development
+
+From a repository checkout:
+
+```sh
+npm ci --ignore-scripts
+npm run check
+npm test
+npm run check:package
+```
+
+Pi loads the TypeScript entry point directly; no build step is required. To try this checkout for one run, use `pi -e .`. Tests use isolated temporary state and do not call model APIs. See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution rules and [CHANGELOG.md](CHANGELOG.md) for release notes.
+
+## License
+
+[MIT](LICENSE).

package/docs/package.md

@@ -0,0 +1,54 @@
+# Package structure and compatibility
+
+## Identity
+
+- npm name: `@prjct.app/pi-activity`.
+- Initial version: `0.1.0`.
+- Source repository: [prjct-app/pi-minimalist-activity](https://github.com/prjct-app/pi-minimalist-activity).
+- Tested host: Pi `0.85.1`; Node.js `22.19+`.
+
+The npm name and repository name may differ. Repository URLs remain unchanged. Existing runtime command names, event names, persisted entry types, and settings keys are unchanged by the package rename.
+
+## Resource manifest
+
+```json
+{
+  "name": "@prjct.app/pi-activity",
+  "keywords": [
+    "pi-package"
+  ],
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}
+```
+
+The `pi-package` keyword makes the package discoverable. Manifest paths are relative to the package root. The extension entry point is shipped as TypeScript because Pi loads it directly. There is no CLI binary or JavaScript build artifact to install separately.
+
+## Dependencies
+
+Pi-provided libraries imported by this package are declared in `peerDependencies` with `*`, as required by Pi's package guide. They are not bundled. Exact Pi 0.85.1 development dependencies establish the tested baseline; the peer wildcard is not a claim that every Pi release is supported.
+
+Third-party runtime dependencies belong in `dependencies`. Companion extensions are installed separately only when communication uses Pi's event bus; this package does not import code from a separately installed companion. A package that directly imports another Pi package's resources must instead bundle it following the official guide.
+
+## Public interfaces
+
+Uses documented `registerTool()` overrides, working-message and working-indicator APIs, lifecycle events, and persisted summary entries.
+
+## Published contents
+
+The `files` allowlist includes runtime resources, user documentation, and license files. Development tests, dependency folders, repository settings, and Git history are excluded. npm also includes `package.json` automatically. The npm lockfile remains in the repository for repeatable development installs.
+
+Run `npm run check:package` to inspect the exact prospective tarball before release. Check that each manifest entry and each referenced local document exists in the packed file list. Only claim npm availability after verifying a successful registry publication.
+
+## Official references
+
+These links are pinned to the tested Pi version rather than the moving main branch:
+
+- [Packages: manifest, sources, dependencies, filtering, and deduplication](https://github.com/earendil-works/pi/blob/v0.85.1/packages/coding-agent/docs/packages.md).
+- [Extensions: lifecycle, commands, tools, messages, and UI APIs](https://github.com/earendil-works/pi/blob/v0.85.1/packages/coding-agent/docs/extensions.md).
+- [TUI: components, rendering, terminal widths, and image support](https://github.com/earendil-works/pi/blob/v0.85.1/packages/coding-agent/docs/tui.md).
+
+The installed `@earendil-works/pi-coding-agent@0.85.1` package ships the same guides under `docs/`. The [current official guide](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/packages.md) may describe changes beyond this tested baseline.

package/index.ts

@@ -0,0 +1,183 @@
+import {
+	createBashTool,
+	createEditTool,
+	createFindTool,
+	createGrepTool,
+	createLsTool,
+	createReadTool,
+	createWriteTool,
+	type ExtensionAPI,
+	type ExtensionContext,
+} from "@earendil-works/pi-coding-agent";
+import { Container, Text, TruncatedText, truncateToWidth } from "@earendil-works/pi-tui";
+import { stripVTControlCharacters } from "node:util";
+import { homedir } from "node:os";
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { TSchema } from "typebox";
+
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+
+function actionTarget(name: string, args: Record<string, unknown>): string {
+	const value = name === "bash" ? args.command
+		: name === "grep" || name === "find" ? `${args.pattern ?? ""}${args.path ? ` · ${args.path}` : ""}`
+		: args.path;
+	if (typeof value !== "string" || !value) return ".";
+	const home = homedir();
+	const target = value.startsWith(`${home}/`) ? `~/${value.slice(home.length + 1)}` : value;
+	return stripVTControlCharacters(target).replace(/\r?\n/g, " ↵ ").replace(/\t/g, " ").replace(/[\x00-\x1f\x7f]/g, "");
+}
+
+function detailText(result: { content: Array<{ type: string; text?: string }> }): string {
+	const text = result.content
+		.filter((item) => item.type === "text" && item.text)
+		.map((item) => item.text)
+		.join("\n")
+		.trim();
+	return text || "No additional details.";
+}
+
+export default function activityMode(pi: ExtensionAPI) {
+	const modifiedFiles = new Set<string>();
+	const completedActions = new Set<string>();
+	const failedActions = new Set<string>();
+	let actionCount = 0;
+	let errorCount = 0;
+	const activeTools = new Map<string, string>();
+	let lastWorkingMessage: string | undefined;
+
+	function refreshWorkingMessage(ctx: ExtensionContext, settled = false) {
+		if (ctx.mode !== "tui") return;
+		const first = activeTools.values().next().value;
+		const message = settled ? undefined : activeTools.size > 1
+			? `${activeTools.size} tools running · ${first}`
+			: first ?? "Thinking…";
+		if (message === lastWorkingMessage) return;
+		lastWorkingMessage = message;
+		ctx.ui.setWorkingMessage(message);
+	}
+
+	pi.registerEntryRenderer("activity-summary", (entry, options, theme) => {
+		const data = entry.data as {
+			modifiedFiles?: string[];
+			failedActions?: string[];
+			actionCount?: number;
+			errorCount?: number;
+		} | undefined;
+		const files = data?.modifiedFiles ?? [];
+		const failures = data?.failedActions ?? [];
+		const count = (n: number, label: string) => `${n} ${label}${n === 1 ? "" : "s"}`;
+		// Legacy summaries stored categories, not counts; do not invent action totals.
+		const total = data?.actionCount === undefined ? "previous run" : count(data.actionCount, "action");
+		const errors = data?.errorCount === undefined ? count(failures.length, "error category") : count(data.errorCount, "error");
+		const title = `Activity · ${total} · ${count(files.length, "file")} · ${errors}`;
+		if (!options.expanded) return new TruncatedText(theme.fg(failures.length ? "error" : "muted", title), 0, 0);
+		const lines = [title, ...files.map((path) => `  • ${actionTarget("read", { path })}`)];
+		if (failures.length) lines.push(`Errors: ${failures.join(" · ")}`);
+		return new Text(lines.join("\n"), 0, 0);
+	});
+
+	function registerCompactTool<T extends TSchema, D>(createTool: (cwd: string) => AgentTool<T, D>) {
+		const initialTool = createTool(process.cwd());
+		const name = initialTool.name;
+
+		pi.registerTool({
+			...initialTool,
+			name,
+			renderShell: "self",
+			async execute(toolCallId, params, signal, onUpdate, ctx) {
+				return createTool(ctx.cwd).execute(toolCallId, params, signal, onUpdate);
+			},
+			renderCall(args, theme, context) {
+				const target = actionTarget(name, args as Record<string, unknown>);
+				const symbol = context.isPartial ? "·" : context.isError ? "✗" : "✓";
+				const color = context.isPartial ? "muted" : context.isError ? "error" : "success";
+				const title = `${theme.fg(color, symbol)} ${theme.fg("toolTitle", name)} · ${theme.fg("toolOutput", target)}`;
+				if (context.expanded) {
+					const text = context.lastComponent instanceof Text ? context.lastComponent : new Text("", 0, 0);
+					text.setText(title);
+					return text;
+				}
+				return new TruncatedText(title, 0, 0);
+			},
+			renderResult(result, { expanded }, _theme, context) {
+				if (!expanded) return new Container();
+				const text = context.lastComponent instanceof Text ? context.lastComponent : new Text("", 0, 0);
+				text.setText(detailText(result));
+				return text;
+			},
+		});
+	}
+
+	registerCompactTool(createReadTool);
+	registerCompactTool(createBashTool);
+	registerCompactTool(createEditTool);
+	registerCompactTool(createWriteTool);
+	registerCompactTool(createFindTool);
+	registerCompactTool(createGrepTool);
+	registerCompactTool(createLsTool);
+
+	pi.on("session_start", (_event, ctx) => {
+		activeTools.clear();
+		lastWorkingMessage = undefined;
+		if (ctx.mode !== "tui") return;
+		ctx.ui.setToolsExpanded(false);
+		ctx.ui.setWorkingIndicator({ frames: SPINNER_FRAMES, intervalMs: 160 });
+	});
+
+	pi.on("session_shutdown", (_event, ctx) => {
+		activeTools.clear();
+		refreshWorkingMessage(ctx, true);
+		if (ctx.mode !== "tui") return;
+		ctx.ui.setWorkingIndicator();
+	});
+
+	pi.on("agent_start", (_event, ctx) => {
+		// A retry can emit another agent_start before the overall run settles.
+		activeTools.clear();
+		refreshWorkingMessage(ctx);
+	});
+
+	pi.on("tool_execution_start", (event, ctx) => {
+		const target = actionTarget(event.toolName, event.args ?? {});
+		activeTools.set(event.toolCallId, truncateToWidth(`${event.toolName} · ${target}`, 72));
+		refreshWorkingMessage(ctx);
+	});
+
+	pi.on("tool_execution_end", (event, ctx) => {
+		activeTools.delete(event.toolCallId);
+		refreshWorkingMessage(ctx);
+		actionCount++;
+		if (event.isError) {
+			errorCount++;
+			failedActions.add(event.toolName);
+			return;
+		}
+		completedActions.add(event.toolName);
+
+	});
+
+	pi.on("tool_result", (event) => {
+		if (!event.isError && (event.toolName === "edit" || event.toolName === "write") && typeof event.input.path === "string") {
+			modifiedFiles.add(event.input.path);
+		}
+	});
+
+	pi.on("turn_start", (_event, ctx) => refreshWorkingMessage(ctx));
+
+	pi.on("agent_settled", (_event, ctx) => {
+		activeTools.clear();
+		refreshWorkingMessage(ctx, true);
+		if (ctx.mode === "tui" && actionCount > 0) pi.appendEntry("activity-summary", {
+			actionCount,
+			errorCount,
+			modifiedFiles: [...modifiedFiles],
+			completedActions: [...completedActions],
+			failedActions: [...failedActions],
+		});
+		actionCount = 0;
+		errorCount = 0;
+		modifiedFiles.clear();
+		completedActions.clear();
+		failedActions.clear();
+	});
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@prjct.app/pi-activity",
+  "version": "0.1.0",
+  "description": "Compact, expandable tool activity and run summaries for Pi.",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "activity",
+    "terminal",
+    "tui"
+  ],
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "scripts": {
+    "check": "tsc --noEmit",
+    "test": "node --import tsx --test tests/*.test.ts tests/*.test.mjs",
+    "check:package": "npm pack --dry-run --ignore-scripts"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-agent-core": "0.85.1",
+    "@earendil-works/pi-coding-agent": "0.85.1",
+    "@earendil-works/pi-tui": "0.85.1",
+    "@types/node": "^22.19.0",
+    "tsx": "^4.20.0",
+    "typebox": "1.3.7",
+    "typescript": "^5.9.3"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prjct-app/pi-minimalist-activity.git"
+  },
+  "homepage": "https://github.com/prjct-app/pi-minimalist-activity#readme",
+  "bugs": {
+    "url": "https://github.com/prjct-app/pi-minimalist-activity/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "index.ts",
+    "README.md",
+    "LICENSE",
+    "CONTRIBUTING.md",
+    "CHANGELOG.md",
+    "docs/package.md"
+  ]
+}