@timurproko/a1 0.1.8-dev.b449b5c → 0.1.8-dev.c64be0e

package/README.md

@@ -9,10 +9,11 @@ npm install --global @timurproko/a1@latest
 ## Commands
 
 ```sh
-a1              # A1-owned UI and profile: ~/.a1/agent
-a1 version      # show Installed, Release (latest), and Next versions
-a1 update       # update to npm latest
-a1 update:next  # update to npm next (or a1 update:<commit> for a specific preview)
+a1                      # A1-owned UI and profile: ~/.a1/agent
+a1 version              # show Installed, Release (latest), and Next versions
+a1 update               # update to npm latest
+a1 update:next          # update to npm next (or a1 update:<commit> for a specific preview)
+a1 update --models      # refresh A1's model catalogs
 ```
 
 Prerelease builds — what `a1 update:next` installs — add two development profiles
@@ -30,16 +31,19 @@ Pi extension packages install into A1's own profile, so bare `a1` loads them and
 `a1 pi` and `a1 sandbox` do not. Sources are Pi's: `npm:`, git, or a local path.
 
 ```sh
-a1 install npm:pi-mcp-adapter   # install a package into ~/.a1/agent
-a1 remove npm:pi-mcp-adapter    # remove it again (alias: a1 uninstall)
-a1 list                         # list packages installed for a1
-a1 update --extensions          # update every installed package
-a1 update npm:pi-mcp-adapter    # update one of them
-a1 update --models              # refresh model catalogs
+a1 pi install npm:pi-mcp-adapter   # install a package into ~/.a1/agent
+a1 pi remove npm:pi-mcp-adapter    # remove it again (alias: a1 pi uninstall)
+a1 pi list                         # list packages installed for a1
+a1 pi update --extensions          # update every installed package
+a1 pi update npm:pi-mcp-adapter    # update one of them
 ```
 
 A running session loads a newly installed package after a restart. Pi's own
-profile at `~/.pi/agent` is managed by Pi itself.
+profile at `~/.pi/agent` is managed by Pi itself. Extension configuration is
+isolated too: for example, MCP configuration for bare `a1` belongs under
+`~/.a1/agent` (or the project), so `~/.pi/agent/mcp.json` is not read. Run
+`/mcp setup` inside bare `a1` to configure it; the MCP footer status appears
+when that A1 configuration contains a server.
 
 ## Develop
 
@@ -68,14 +72,15 @@ time and never committed, so previews cost no commits and need no command, and a
 installed preview says exactly which source produced it.
 
 ```sh
-a1 update:next          # install the newest preview
-a1 update:7eabe9e       # install the preview built from that commit
-a1 update:0.1.8-dev.7eabe9e   # or name the version outright
+a1 update:next      # install the newest preview
+a1 update:7eabe9e   # install the preview built from that commit
 ```
 
 Naming a commit is what the version suffix is for: read it off `a1 version`, a
-pull request, or a commit list, and install exactly that build. A commit that was
-never published is refused rather than guessed at.
+pull request, or a commit list, and install exactly that build — you never need to
+know which version it went out under. A commit that was never published is refused
+rather than guessed at. A full preview version works in the same place, so a string
+pasted back from `a1 version` is understood too.
 
 ### Stable — npm `latest`
 
@@ -92,7 +97,7 @@ It lands the version on `develop` through a pull request that merges itself.
 **Landing it is what publishes** — the workflow builds, validates the packed release
 on Windows, Linux, and macOS, publishes to npm `latest` with provenance, and only
 then writes the `v<version>` tag and records the GitHub Release. The command waits
-for that to succeed, then lands the next `-dev.0` version so previews resume
+for that to succeed, then opens the next `-dev` line so previews resume
 immediately.
 
 ```sh

package/dist/native/darwin-arm64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "unsupported",
-  "builtAt": "2026-08-24T06:35:58.522Z",
+  "builtAt": "2026-08-25T08:31:32.388Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "7524bf568992517f50ed53196c861c5edeba0d7275633bb4735ab45bd5963a28",

package/dist/native/linux-x64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-08-24T06:35:49.229Z",
+  "builtAt": "2026-08-25T08:31:49.348Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "29e22fe29de2828982bc67ef418c4adcaab1490281477b7bea592ec6fe621bcd",

package/dist/native/win32-x64/manifest.json

@@ -5,10 +5,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-08-24T06:36:28.685Z",
+  "builtAt": "2026-08-25T08:32:11.007Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "1d535ec647852d21736769e0d418b80f9a99d02a9721609a13f251300986b9b9",
+    "sha256": "b22997c85da32360cdb382f568e618757654c746cccb825b7c771d011cca9ba6",
     "size": 172544
   },
   "provenance": {

package/dist/src/cli/dispatch.js

@@ -5,12 +5,13 @@ export function cliUsage(capabilities) {
         "",
         ...(capabilities.developmentProfiles ? ["pi", "sandbox"] : []),
         "version",
-        "update [self|<source>|--extensions|--models]",
+        "update [self|--models]",
         "update:next",
         "update:<commit>",
-        "install <source>",
-        "remove <source>",
-        "list",
+        "pi install <source>",
+        "pi remove <source>",
+        "pi list",
+        "pi update [--extensions|<source>]",
     ]);
 }
 const PROFILE_WORDS = new Set(["pi", "sandbox"]);
@@ -32,7 +33,13 @@ export function parseCliCommand(arguments_, capabilities) {
     if (arguments_.length === 0)
         return { kind: "launch", profileId: "a1" };
     const [command, ...rest] = arguments_;
-    if (capabilities.developmentProfiles && (command === "pi" || command === "sandbox")) {
+    if (command === "pi") {
+        if (rest.length > 0)
+            return parsePiPackageCommand(rest);
+        if (capabilities.developmentProfiles)
+            return { kind: "launch", profileId: "pi" };
+    }
+    if (capabilities.developmentProfiles && command === "sandbox") {
         return withoutArguments(rest, { kind: "launch", profileId: command });
     }
     if (command === "version")
@@ -41,11 +48,9 @@ export function parseCliCommand(arguments_, capabilities) {
         return parseColonUpdate(command.slice("update:".length), rest);
     if (command === "update")
         return parseUpdate(rest);
-    if (command === "install" || command === "remove" || command === "uninstall") {
-        return parseSourceCommand(command === "install" ? "install" : "remove", rest);
+    if (command === "install" || command === "remove" || command === "uninstall" || command === "list") {
+        return packageNamespaceRejection(command, rest.join(" ") || undefined);
     }
-    if (command === "list")
-        return withoutArguments(rest, { kind: "packages", request: { verb: "list", source: null } });
     if (command === "ui")
         return { kind: "error", message: `The ui subcommand was removed; run bare ${PRODUCT_TEXT.commandName} for the owned UI.` };
     if (command === "agent")
@@ -71,10 +76,9 @@ function parseColonUpdate(suffix, rest) {
     return { kind: "update", channel: "next", target: suffix };
 }
 /**
- * `update` carries both meanings pinned Pi gives it: itself by default, and the
- * profile's packages when a target says so. Pi is refused as a target because A1
- * certifies each release against one pinned Pi, so moving Pi underneath it would
- * invalidate what was certified.
+ * Top-level `update` owns A1 itself and A1's model catalogs. Extension package
+ * maintenance lives under the `pi` compatibility namespace, while updating the
+ * pinned Pi runtime remains impossible.
  */
 function parseUpdate(rest) {
     if (rest.length === 0)
@@ -90,18 +94,42 @@ function parseUpdate(rest) {
             message: PRODUCT_TEXT.diagnostic(`pins the Pi version it was certified against; run ${PRODUCT_TEXT.commandName} update to move ${PRODUCT_TEXT.displayName} itself.`),
         };
     }
-    // A release channel is spelled with the colon. Taking the bare word as a package
-    // source would turn a near miss into a confident search for a package nobody has.
     if (target === "next" || target === "stable") {
         const form = target === "next" ? `${PRODUCT_TEXT.commandName} update:next` : `${PRODUCT_TEXT.commandName} update`;
         return { kind: "error", message: PRODUCT_TEXT.diagnostic(`selects a release channel with a colon; run ${form}.`) };
     }
-    if (target === "--extensions")
-        return { kind: "packages", request: { verb: "update", source: null } };
     if (target === "--models")
         return { kind: "packages", request: { verb: "refresh-models", source: null } };
+    if (target === "--extensions" || (target !== undefined && !target.startsWith("-"))) {
+        return packageNamespaceRejection("update", target === "--extensions" ? "--extensions" : target);
+    }
+    return unknownOption(target ?? "", "update");
+}
+function parsePiPackageCommand(arguments_) {
+    const [verb, ...rest] = arguments_;
+    if (verb === "install" || verb === "remove" || verb === "uninstall") {
+        return parseSourceCommand(verb === "install" ? "install" : "remove", rest);
+    }
+    if (verb === "list")
+        return withoutArguments(rest, { kind: "packages", request: { verb: "list", source: null } });
+    if (verb === "update")
+        return parsePiPackageUpdate(rest);
+    return { kind: "error", message: PRODUCT_TEXT.diagnostic(`received an unknown pi package command: ${verb ?? ""}`) };
+}
+function parsePiPackageUpdate(rest) {
+    if (rest.length === 0) {
+        return { kind: "error", message: PRODUCT_TEXT.diagnostic(`pi update needs --extensions or a package source.`) };
+    }
+    if (rest.length > 1)
+        return { kind: "error", message: PRODUCT_TEXT.diagnostic("pi update accepts one target.") };
+    const [target] = rest;
+    if (target === "--extensions")
+        return { kind: "packages", request: { verb: "update", source: null } };
+    if (target === "--models") {
+        return { kind: "error", message: PRODUCT_TEXT.diagnostic(`refreshes its model catalogs at the top level; run ${PRODUCT_TEXT.commandName} update --models.`) };
+    }
     if (target === undefined || target.startsWith("-"))
-        return unknownOption(target ?? "", "update");
+        return unknownOption(target ?? "", "pi update");
     if (PROFILE_WORDS.has(target))
         return profileRejection("update");
     return { kind: "packages", request: { verb: "update", source: target } };
@@ -129,6 +157,13 @@ function withoutArguments(rest, command) {
         return profileRejection("list");
     return { kind: "error", message: PRODUCT_TEXT.diagnostic("commands do not accept additional arguments.") };
 }
+function packageNamespaceRejection(verb, target) {
+    const suffix = target === undefined ? "" : ` ${target}`;
+    return {
+        kind: "error",
+        message: PRODUCT_TEXT.diagnostic(`manages extension packages under its pi namespace; run ${PRODUCT_TEXT.commandName} pi ${verb}${suffix}.`),
+    };
+}
 function profileRejection(verb) {
     return {
         kind: "error",

package/dist/src/cli/packages.d.ts

@@ -11,6 +11,12 @@ export interface PackageCommandRequest {
     readonly verb: PackageCommandVerb;
     readonly source: string | null;
 }
+export interface PackageCommandStyle {
+    readonly dim: (message: string) => string;
+    readonly bold: (message: string) => string;
+    readonly green: (message: string) => string;
+    readonly red: (message: string) => string;
+}
 export interface PackageCommandEnvironment {
     readonly createPort: (input: AgentPackagesPortInput) => AgentPackagesPort;
     readonly cwd?: string;
@@ -18,6 +24,8 @@ export interface PackageCommandEnvironment {
     readonly stdout?: (message: string) => void;
     readonly stderr?: (message: string) => void;
     readonly initializeProfile?: typeof initializeProductProfile;
+    /** Defaults to Chalk's terminal-aware styles; injectable for transcript tests. */
+    readonly style?: PackageCommandStyle;
 }
 export declare function runPackageCommand(request: PackageCommandRequest, environment: PackageCommandEnvironment): Promise<number>;
-export declare function renderPackageOutcome(outcome: AgentPackageOutcome, profileRoot: string): string;
+export declare function renderPackageOutcome(outcome: AgentPackageOutcome, profileRoot: string, style?: PackageCommandStyle): string;

package/dist/src/cli/packages.js

@@ -1,3 +1,4 @@
+import chalk from "chalk";
 import { configurationRootForProfile, initializeProductProfile, resolveLaunchProfilePaths } from "../features/launch/index.js";
 import { PRODUCT_TEXT } from "../product-identity.js";
 export async function runPackageCommand(request, environment) {
@@ -5,6 +6,7 @@ export async function runPackageCommand(request, environment) {
     const stderr = environment.stderr ?? (message => process.stderr.write(message));
     const cwd = environment.cwd ?? process.cwd();
     const processEnvironment = environment.environment ?? process.env;
+    const style = environment.style ?? chalk;
     const paths = resolveLaunchProfilePaths({ environment: processEnvironment });
     const profileRoot = configurationRootForProfile("a1", paths);
     if (profileRoot === null)
@@ -19,10 +21,10 @@ export async function runPackageCommand(request, environment) {
     const port = environment.createPort({
         profileRoot,
         cwd,
-        onProgress: progress => stdout(`${progress.message}\n`),
+        onProgress: progress => stdout(`${style.dim(progress.message)}\n`),
     });
     const outcome = await runVerb(port, request);
-    const rendered = renderPackageOutcome(outcome, profileRoot);
+    const rendered = renderPackageOutcome(outcome, profileRoot, style);
     (outcome.status === "completed" ? stdout : stderr)(rendered);
     return outcome.status === "completed" ? 0 : 1;
 }
@@ -37,38 +39,40 @@ async function runVerb(port, request) {
         throw new Error(PRODUCT_TEXT.diagnostic(`requires a source for ${request.verb}`));
     return request.verb === "install" ? await port.install(request.source) : await port.remove(request.source);
 }
-export function renderPackageOutcome(outcome, profileRoot) {
-    const name = PRODUCT_TEXT.displayName;
+export function renderPackageOutcome(outcome, profileRoot, style = chalk) {
+    // Model refresh remains an A1 top-level command. The `a1 pi` compatibility
+    // transcript applies to package operations only.
+    if (outcome.operation === "refresh-models") {
+        if (outcome.status === "failed") {
+            return `${PRODUCT_TEXT.diagnostic(`could not ${describeOperation(outcome.operation)}: ${outcome.detail ?? "unknown failure"}`)}\n`;
+        }
+        return `${PRODUCT_TEXT.displayName} refreshed the model catalogs in ${profileRoot}.\n`;
+    }
     if (outcome.status === "failed") {
-        return `${PRODUCT_TEXT.diagnostic(`could not ${describeOperation(outcome.operation)}: ${outcome.detail ?? "unknown failure"}`)}\n`;
+        return `${style.red(`Error: ${outcome.detail ?? "Unknown package command error"}`)}\n`;
     }
     if (outcome.status === "not-found") {
-        return `${PRODUCT_TEXT.diagnostic(`found no package matching ${outcome.source ?? "that source"} in ${profileRoot}.`)}\n`;
+        return `${style.red(`No matching package found for ${outcome.source ?? "that source"}`)}\n`;
     }
     switch (outcome.operation) {
         case "install":
-            return `${name} installed ${outcome.source} into ${profileRoot}.\n`
-                + `Restart ${PRODUCT_TEXT.commandName} for a running session to load it.\n`;
+            return `${style.green(`Installed ${outcome.source}`)}\n`;
         case "remove":
-            return `${name} removed ${outcome.source} from ${profileRoot}.\n`;
+            return `${style.green(`Removed ${outcome.source}`)}\n`;
         case "update":
-            return outcome.source === null
-                ? `${name} updated the packages in ${profileRoot}.\n`
-                : `${name} updated ${outcome.source}.\n`;
-        case "refresh-models":
-            return `${name} refreshed the model catalogs in ${profileRoot}.\n`;
+            return `${style.green(outcome.source === null ? "Updated packages" : `Updated ${outcome.source}`)}\n`;
         case "list":
-            return renderPackageList(outcome, profileRoot);
+            return renderPackageList(outcome, style);
     }
 }
-function renderPackageList(outcome, profileRoot) {
+function renderPackageList(outcome, style) {
     if (outcome.packages.length === 0)
-        return `${PRODUCT_TEXT.displayName} has no packages installed in ${profileRoot}.\n`;
-    const lines = [`Packages installed for ${PRODUCT_TEXT.commandName} in ${profileRoot}:`];
+        return `${style.dim("No packages installed.")}\n`;
+    const lines = [style.bold("User packages:")];
     for (const entry of outcome.packages) {
-        lines.push(`  ${entry.source}${entry.filtered ? " (partly enabled)" : ""}`);
+        lines.push(`  ${entry.source}${entry.filtered ? " (filtered)" : ""}`);
         if (entry.installedPath !== null)
-            lines.push(`    ${entry.installedPath}`);
+            lines.push(style.dim(`    ${entry.installedPath}`));
     }
     return `${lines.join("\n")}\n`;
 }

package/dist/src/foundation/pi-component-adapter/index.d.ts

@@ -3,7 +3,7 @@ export * from "./conformance.js";
 export * from "./shell-components.js";
 export * from "./theme.js";
 export * from "./upstream/theme/theme-controller.js";
-export { applyConfiguredPiTheme, getAvailablePiThemes } from "./upstream/theme/theme.js";
+export { applyConfiguredPiTheme, getAvailablePiThemes, onPiThemeChange } from "./upstream/theme/theme.js";
 export * from "./upstream/components/countdown-timer.js";
 export * from "./upstream/components/extension-editor.js";
 export * from "./upstream/components/session-selector.js";

package/dist/src/foundation/pi-component-adapter/index.js

@@ -3,7 +3,7 @@ export * from "./conformance.js";
 export * from "./shell-components.js";
 export * from "./theme.js";
 export * from "./upstream/theme/theme-controller.js";
-export { applyConfiguredPiTheme, getAvailablePiThemes } from "./upstream/theme/theme.js";
+export { applyConfiguredPiTheme, getAvailablePiThemes, onPiThemeChange } from "./upstream/theme/theme.js";
 export * from "./upstream/components/countdown-timer.js";
 export * from "./upstream/components/extension-editor.js";
 export * from "./upstream/components/session-selector.js";

package/dist/src/foundation/pi-component-adapter/shell-presenters-transcript.js

@@ -1,6 +1,7 @@
 import { AssistantMessageComponent, BashExecutionComponent, CompactionSummaryMessageComponent, CustomMessageComponent, DynamicBorder, getMarkdownTheme, parseSkillBlock, ToolExecutionComponent, UserMessageComponent, } from "@earendil-works/pi-coding-agent";
 import { SkillInvocationMessageComponent, } from "./upstream/components/skill-invocation-message.js";
 import { Container, Markdown, Spacer, Text, } from "#pi-tui";
+import { PRODUCT_TEXT } from "../../product-identity.js";
 import { KeybindingsManager, } from "./upstream/adjacent/core/keybindings.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
 import { componentPort, createTuiFacade, ensureTheme, formatSessionTokens, isRecord, } from "./shell-shared-facade.js";
@@ -168,7 +169,7 @@ export function renderPiShellPackageUpdateNotice(packages, width) {
     container.addChild(new Spacer(1));
     container.addChild(new DynamicBorder(text => theme.fg("warning", text)));
     container.addChild(new Text(`${theme.bold(theme.fg("warning", "Package Updates Available"))}\n`
-        + `${theme.fg("muted", "Package updates are available. Run ")}${theme.fg("accent", "pi update --extensions")}\n`
+        + `${theme.fg("muted", "Package updates are available. Run ")}${theme.fg("accent", `${PRODUCT_TEXT.commandName} pi update --extensions`)}\n`
         + `${theme.fg("muted", "Packages:")}\n`
         + packages.map(name => `- ${name}`).join("\n"), 1, 0));
     container.addChild(new DynamicBorder(text => theme.fg("warning", text)));

package/dist/src/foundation/pi-engine-adapter/adapter.d.ts

@@ -60,11 +60,18 @@ export interface OwnedPiResourceSummary {
     readonly sourcePath: string | null;
     readonly diagnostic: string | null;
 }
+export interface OwnedPiExtensionSourceSummary {
+    readonly source: string;
+    readonly scope: "user" | "project" | "temporary";
+    readonly origin: "package" | "top-level";
+    readonly baseDir: string | null;
+}
 export interface OwnedPiExtensionResourceSummary {
     readonly kind: "extension";
     readonly id: string;
     readonly sourcePath: string | null;
     readonly resolvedPath: string | null;
+    readonly sourceInfo: OwnedPiExtensionSourceSummary | null;
     readonly loaded: boolean;
     readonly hidden: boolean;
     readonly diagnostic: string | null;