@gaosh3n/pi-package-manager 0.1.1 → 0.1.2

package/README.md

@@ -8,6 +8,7 @@
 - a visible progress UI while Pi checks or updates packages
 - `/package-manager status` to see whether updates are available
 - `/package-manager update` to run the update flow on demand
+- `/package-manager install` to install a Pi package from an entered source
 - a final result card in Pi so you can review the latest outcome
 - automatic Pi reload after a successful startup update
 
@@ -44,3 +45,13 @@ Run:
 ```
 
 Pi will run the update flow for you, show live progress, and record the final result in the transcript.
+
+### Install a package
+
+Run:
+
+```text
+/package-manager install
+```
+
+Pi will prompt you for a package source such as `npm:@foo/bar` or `git:github.com/user/repo`, run the native `pi install ...` flow, and show a final result card. After a successful install, run `/reload` to activate the installed package resources.

package/index.ts

@@ -25,6 +25,7 @@ import {
 import {
     createAutomaticUpdateWidgetLines,
     createAutoUpdateResultReport,
+    createInstallResultReport,
     createReportEntryRenderer,
     createStatusReport,
     formatStatusLines,
@@ -50,9 +51,9 @@ export default function initPackageManager(
 
     pi.registerCommand("package-manager", {
         description:
-            "Manage Pi package updates (usage: /package-manager [status|update])",
+            "Manage Pi packages (usage: /package-manager [status|update|install])",
         getArgumentCompletions: (prefix: string): AutocompleteItem[] | null => {
-            const items = ["status", "update"].map((value) => ({
+            const items = ["status", "update", "install"].map((value) => ({
                 value,
                 label: value,
             }))
@@ -78,7 +79,12 @@ export default function initPackageManager(
                 return
             }
 
-            ctx.ui.notify("Usage: /package-manager [status|update]", "warning")
+            if (subcommand === "install") {
+                await controller.handleInstall(ctx)
+                return
+            }
+
+            ctx.ui.notify("Usage: /package-manager [status|update|install]", "warning")
         },
     })
 }
@@ -90,6 +96,7 @@ export {
     createAutomaticUpdateWidgetLines,
     createAutoUpdateRecord,
     createAutoUpdateResultReport,
+    createInstallResultReport,
     createStatusReport,
     formatStatusLines,
     formatUtcTimestamp,

package/internal/controller.ts

@@ -14,6 +14,7 @@ import {
 import {
     clearPackageManagerWidget,
     createAutoUpdateResultReport,
+    createInstallResultReport,
     createStatusErrorReport,
     createStatusReport,
     getExecDisplayOutput,
@@ -30,6 +31,7 @@ export function createPackageManagerController(
         onSessionStart,
         handleStatus,
         handleUpdate,
+        handleInstall,
     }
 
     async function onSessionStart(
@@ -165,6 +167,79 @@ export function createPackageManagerController(
         }
     }
 
+    async function handleInstall(ctx: ExtensionCommandContext): Promise<void> {
+        if (!ctx.hasUI) {
+            ctx.ui.notify(
+                "/package-manager install requires dialog-capable UI.",
+                "warning",
+            )
+            return
+        }
+
+        const source = (
+            await ctx.ui.input(
+                "Install Pi Package",
+                "npm:@scope/pkg or git:github.com/user/repo",
+            )
+        )?.trim()
+
+        if (source === undefined) {
+            return
+        }
+
+        if (!source) {
+            ctx.ui.notify("Package source is required.", "warning")
+            return
+        }
+
+        const startedAtUtc = deps.nowIso()
+        setPackageManagerWidget(ctx, { mode: "package-installing", source })
+
+        try {
+            const result = await deps.runNativeInstall(pi, ctx, source)
+            const output = getExecDisplayOutput(result)
+
+            if (result.code === 0) {
+                pi.appendEntry(
+                    REPORT_ENTRY_TYPE,
+                    createInstallResultReport({
+                        startedAtUtc,
+                        endedAtUtc: deps.nowIso(),
+                        source,
+                        outcome: "succeeded",
+                        output,
+                    }),
+                )
+                return
+            }
+
+            pi.appendEntry(
+                REPORT_ENTRY_TYPE,
+                createInstallResultReport({
+                    startedAtUtc,
+                    endedAtUtc: deps.nowIso(),
+                    source,
+                    outcome: "failed",
+                    output,
+                    reason: getExecFailureDetail(result),
+                }),
+            )
+        } catch (error) {
+            pi.appendEntry(
+                REPORT_ENTRY_TYPE,
+                createInstallResultReport({
+                    startedAtUtc,
+                    endedAtUtc: deps.nowIso(),
+                    source,
+                    outcome: "failed",
+                    reason: getErrorMessage(error),
+                }),
+            )
+        } finally {
+            clearPackageManagerWidget(ctx)
+        }
+    }
+
     function appendSkippedResult(startedAtUtc: string, reason: string): void {
         const record = createAutoUpdateRecord({
             startedAtUtc,

package/internal/model.ts

@@ -5,8 +5,10 @@ export const PACKAGE_MANAGER_WIDGET_KEY = "pi-package-manager"
 export const RELOAD_COUNTDOWN_SECONDS = 5
 export const OUTPUT_PREVIEW_LINE_COUNT = 8
 export const UPDATE_COMMAND = ["update", "--extensions"] as const
+export const INSTALL_COMMAND = ["install"] as const
 
 export type AutoUpdateOutcome = "succeeded" | "failed" | "skipped"
+export type InstallOutcome = "succeeded" | "failed"
 export type ReportTone = "info" | "success" | "warning" | "error"
 
 export type WidgetState =
@@ -14,6 +16,7 @@ export type WidgetState =
     | { mode: "checking" }
     | { mode: "installing"; packages: number }
     | { mode: "countdown"; secondsRemaining: number }
+    | { mode: "package-installing"; source: string }
 
 export interface AutoUpdateRecord {
     startedAtUtc: string
@@ -31,6 +34,7 @@ export interface PackageManagerReport {
     lineTone?: "default" | "dim"
     output?: string
     outputLabel?: string
+    outputDescription?: string
     outputTone?: "default" | "dim"
     hideOutputWhenCollapsed?: boolean
 }

package/internal/reports.ts

@@ -11,6 +11,7 @@ import {
     PACKAGE_MANAGER_WIDGET_KEY,
     type AutoUpdateOutcome,
     type AutoUpdateRecord,
+    type InstallOutcome,
     type PackageManagerReport,
     type PackageStatusSnapshot,
     type WidgetState,
@@ -73,7 +74,10 @@ export function createReportEntryRenderer() {
             if (!expanded && report.hideOutputWhenCollapsed) {
                 box.addChild(
                     new Text(
-                        formatExpandHint(theme, "to expand to see update output."),
+                        formatExpandHint(
+                            theme,
+                            `to expand to see ${report.outputDescription ?? "output"}.`,
+                        ),
                         0,
                         0,
                     ),
@@ -83,10 +87,7 @@ export function createReportEntryRenderer() {
 
                 box.addChild(
                     new Text(
-                        theme.fg(
-                            outputTextTone,
-                            report.outputLabel ?? "Update output:",
-                        ),
+                        theme.fg(outputTextTone, report.outputLabel ?? "Output:"),
                         0,
                         0,
                     ),
@@ -98,7 +99,7 @@ export function createReportEntryRenderer() {
                         new Text(
                             formatExpandHint(
                                 theme,
-                                "to expand to view the full update output.",
+                                `to expand to view the full ${report.outputDescription ?? "output"}.`,
                             ),
                             0,
                             0,
@@ -203,6 +204,43 @@ export function createAutoUpdateResultReport(input: {
         lines,
         lineTone: "dim",
         output: input.output ?? input.record.reason,
+        outputLabel: "Update output:",
+        outputDescription: "update output",
+        outputTone: "dim",
+        hideOutputWhenCollapsed: true,
+    }
+}
+
+export function createInstallResultReport(input: {
+    startedAtUtc: string
+    endedAtUtc: string
+    source: string
+    outcome: InstallOutcome
+    output?: string
+    reason?: string
+}): PackageManagerReport {
+    return {
+        title: PACKAGE_MANAGER_TITLE,
+        headline:
+            input.outcome === "succeeded"
+                ? "Pi package install completed."
+                : "Pi package install failed.",
+        tone: input.outcome === "succeeded" ? "success" : "error",
+        lines: [
+            `Start: ${formatUtcTimestamp(input.startedAtUtc)}`,
+            `End: ${formatUtcTimestamp(input.endedAtUtc)}`,
+            `Result: ${input.outcome}`,
+            `Package source: ${input.source}`,
+            ...(input.outcome === "succeeded"
+                ? ["Run /reload to activate installed package resources."]
+                : []),
+        ],
+        lineTone: "dim",
+        output: input.output ?? input.reason,
+        outputLabel:
+            input.outcome === "succeeded" ? "Install output:" : "Error detail:",
+        outputDescription:
+            input.outcome === "succeeded" ? "install output" : "error detail",
         outputTone: "dim",
         hideOutputWhenCollapsed: true,
     }
@@ -227,6 +265,13 @@ export function createAutomaticUpdateWidgetLines(state: WidgetState): string[] {
         ]
     }
 
+    if (state.mode === "package-installing") {
+        return [
+            "Pi package install in progress.",
+            `Installing package from ${state.source}...`,
+        ]
+    }
+
     return [
         formatAutomaticUpdateHeadline("succeeded"),
         `Reloading in ${state.secondsRemaining} second${state.secondsRemaining === 1 ? "" : "s"} to activate updated package resources.`,

package/internal/runtime.ts

@@ -8,7 +8,7 @@ import {
     type ExtensionContext,
 } from "@earendil-works/pi-coding-agent"
 
-import { UPDATE_COMMAND } from "./model.ts"
+import { INSTALL_COMMAND, UPDATE_COMMAND } from "./model.ts"
 
 export interface PackageManagerDeps {
     nowIso(): string
@@ -19,6 +19,11 @@ export interface PackageManagerDeps {
         pi: Pick<ExtensionAPI, "exec">,
         ctx: ExtensionCommandContext,
     ): Promise<ExecResult>
+    runNativeInstall(
+        pi: Pick<ExtensionAPI, "exec">,
+        ctx: ExtensionCommandContext,
+        source: string,
+    ): Promise<ExecResult>
 }
 
 export const defaultPackageManagerDeps: PackageManagerDeps = {
@@ -51,4 +56,14 @@ export const defaultPackageManagerDeps: PackageManagerDeps = {
             signal: ctx.signal,
         })
     },
+    runNativeInstall(
+        pi: Pick<ExtensionAPI, "exec">,
+        ctx: ExtensionCommandContext,
+        source: string,
+    ) {
+        return pi.exec("pi", [...INSTALL_COMMAND, source], {
+            cwd: ctx.cwd,
+            signal: ctx.signal,
+        })
+    },
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gaosh3n/pi-package-manager",
-    "version": "0.1.1",
+    "version": "0.1.2",
     "description": "Package Manager for Pi",
     "type": "module",
     "packageManager": "pnpm@11.23.0",