@alisio/alisio-code 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/main.js

@@ -389,11 +389,12 @@ for (const name of ["list", "validate"]) {
 }
 const plugins = program.command("plugins");
 plugins.command("list").action(async (_opts, cmd) => {
-    const { discoverPlugins } = await import("@alisio/core");
+    const { discoverPlugins, installedNpmPlugins } = await import("@alisio/core");
     const { configHome } = await import("@alisio/core");
     const { join, resolve } = await import("node:path");
+    const global = join(configHome(), "plugins");
     console.log(JSON.stringify({
-        global: await discoverPlugins(join(configHome(), "plugins")),
+        global: [...(await discoverPlugins(global)), ...(await installedNpmPlugins(global))],
         project: await discoverPlugins(join(resolve(options(cmd).cwd ?? process.cwd()), ".alisio", "plugins")),
         explicit: options(cmd).plugin ?? [],
     }, null, 2));
@@ -468,6 +469,26 @@ mcp
         await app.close();
     }
 });
+program
+    .command("install")
+    .description("Install an npm plugin package into the global plugins directory (~/.config/alisio/plugins)")
+    .argument("<spec>", 'npm package spec, e.g. "npm:plugin-openrouter" or "plugin-openrouter@1.2.3"')
+    .option("-y, --yes", "Skip the pre-install confirmation (npm may run lifecycle scripts)")
+    .option("--trust-plugin", "Explicit trust for this global install (same as --yes)")
+    .option("--update", "Refresh an already-installed plugin to the latest version, keeping its name")
+    .action(async (spec, _options, cmd) => {
+    const { cliInstall, configHome } = await import("@alisio/core");
+    const o = options(cmd);
+    await cliInstall({
+        spec,
+        configHome: configHome(),
+        yes: !!o.yes || !!o.trustPlugin,
+        update: !!o.update,
+        readOnly: !!o.readOnly,
+        json: !!o.json,
+        interactive: !!process.stdin.isTTY && !!process.stdout.isTTY && !o.json,
+    });
+});
 try {
     await program.parseAsync();
 }

package/dist/tui/app.js

@@ -183,8 +183,10 @@ export async function runTui(options) {
             path.unshift(cur.label);
         const siblings = nodes.filter((n) => n.parentId === node.parentId);
         const child = viewedState();
-        const window = app.contextWindow(child?.model ?? view.model);
-        const pct = child?.context && window ? ` · ctx ${Math.round((child.context.used / window) * 100)}%` : "";
+        const budget = app.contextBudget(child?.model ?? view.model);
+        const pct = child?.context && budget
+            ? ` · ctx ${Math.round((child.context.used / budget.total) * 100)}%`
+            : "";
         const tokens = child
             ? ` · ↑${formatTokens(child.stats.input)} ↓${formatTokens(child.stats.output)}`
             : "";
@@ -195,7 +197,7 @@ export async function runTui(options) {
         : panelState.focus === "view"
             ? viewHint()
             : undefined;
-    const footer = new Footer(() => viewedState() ?? view, () => app.contextWindow((viewedState() ?? view).model), () => panelHint() ?? hint, () => [...app.plugins.status.values()].map((s) => s.text));
+    const footer = new Footer(() => viewedState() ?? view, () => app.contextBudget((viewedState() ?? view).model), () => panelHint() ?? hint, () => [...app.plugins.status.values()].map((s) => s.text));
     const treePanel = new TreePanel(() => {
         const entry = panelEntry();
         if (!entry)
@@ -866,7 +868,7 @@ export async function runTui(options) {
     };
     const statsReport = () => {
         const s = view.stats;
-        const window = app.contextWindow(view.model);
+        const budget = app.contextBudget(view.model);
         const tools = Object.entries(s.tools)
             .map(([name, t]) => `| \`${name}\` | ${t.calls} | ${t.errors} |`)
             .join("\n");
@@ -878,7 +880,7 @@ export async function runTui(options) {
             `- Tokens: in ${formatTokens(s.input)} · out ${formatTokens(s.output)} · cached ${formatTokens(s.cached)}`,
             `- Runs: ${s.runs} · turns: ${s.turns}${s.lastRunMs !== undefined ? ` · last run ${formatDuration(s.lastRunMs)}` : ""}`,
             `- Duration: ${formatDuration(Date.now() - s.startedAt)}`,
-            `- Context: ${formatContext(view.context?.used ?? 0, window, view.context?.estimated ?? true)}`,
+            `- Context: ${formatContext(view.context?.used ?? 0, budget?.total, view.context?.estimated ?? true, budget?.basis)}`,
             "",
             tools ? `| Tool | Calls | Errors |\n| --- | --- | --- |\n${tools}` : "No tool calls yet.",
             "",

package/dist/tui/components.d.ts

@@ -2,7 +2,7 @@ import type { PanelNode } from "@alisio/sdk";
 import { type Component, Container } from "@earendil-works/pi-tui";
 import { type PendingAttachment } from "./attachments.ts";
 import { type QuestionPanelState, type QuestionSpec } from "./questions.ts";
-import { type TranscriptItem, type ViewState } from "./state.ts";
+import { type ContextBudget, type TranscriptItem, type ViewState } from "./state.ts";
 export declare const SPINNER: string[];
 /** Shared animation clock advanced by the app while work is running. */
 export declare const clock: {
@@ -31,10 +31,10 @@ export declare class Header implements Component {
 }
 export declare class Footer implements Component {
     private view;
-    private window;
+    private budget;
     private hint;
     private statuses;
-    constructor(view: () => ViewState, window: () => number | undefined, hint: () => string | undefined, statuses?: () => string[]);
+    constructor(view: () => ViewState, budget: () => ContextBudget | undefined, hint: () => string | undefined, statuses?: () => string[]);
     invalidate(): void;
     render(width: number): string[];
 }

package/dist/tui/components.js

@@ -60,20 +60,20 @@ export class Header {
 }
 export class Footer {
     view;
-    window;
+    budget;
     hint;
     statuses;
-    constructor(view, window, hint, statuses = () => []) {
+    constructor(view, budget, hint, statuses = () => []) {
         this.view = view;
-        this.window = window;
+        this.budget = budget;
         this.hint = hint;
         this.statuses = statuses;
     }
     invalidate() { }
     render(width) {
-        const v = this.view(), total = this.window(), used = v.context?.used ?? 0, estimated = v.context?.estimated ?? true;
+        const v = this.view(), budget = this.budget(), total = budget?.total, used = v.context?.used ?? 0, estimated = v.context?.estimated ?? true;
         const pct = contextPercent(used, total);
-        const level = contextLevel(pct ?? 0);
+        const level = contextLevel(pct ?? 0, budget?.compactionAt ?? 85);
         const cells = 10, filled = pct === undefined ? 0 : Math.min(cells, Math.round((pct / 100) * cells));
         const bar = pct === undefined
             ? style.gray("░".repeat(cells))
@@ -86,7 +86,7 @@ export class Footer {
         const s = v.stats;
         const segments = [
             {
-                text: `ctx ${formatContext(used, total, estimated)}`,
+                text: `ctx ${formatContext(used, total, estimated, budget?.basis)}`,
                 priority: 10,
                 paint: pct === undefined ? style.gray : levelColor(level),
             },

package/dist/tui/state.d.ts

@@ -38,6 +38,7 @@ export interface PluginCatalogView {
     diagnostic?: string;
 }
 /** Text markers remain meaningful without color: [x] active, [ ] inactive, [!] failed, [*] pending. */
+/** Group headings are derived from the primary category (or "General") of each plugin. */
 export declare function pluginCatalogItems(entries: PluginCatalogView[]): {
     value: string;
     label: string;
@@ -84,9 +85,18 @@ export declare function configuredProviderModelItems(catalogs: ProviderCatalogVi
     provider: string;
     model: string;
 }): ConfiguredProviderModelItem[];
-export declare function contextLevel(pct: number): Level;
+export declare function contextLevel(pct: number, compactionAt?: number): Level;
 export declare function contextPercent(used: number, total: number | undefined): number | undefined;
-export declare function formatContext(used: number, total: number | undefined, estimated: boolean): string;
+/** The effective total the context bar measures against, and what it is derived from. */
+export interface ContextBudget {
+    /** Effective total in tokens (model window, or the char budget converted to tokens). */
+    total: number;
+    /** Basis of the total: the model's context window, or the char-budget fallback. */
+    basis: "window" | "chars";
+    /** Percentage of `total` at which the engine auto-compacts; the bar turns red there. */
+    compactionAt: number;
+}
+export declare function formatContext(used: number, total: number | undefined, estimated: boolean, basis?: "window" | "chars"): string;
 export declare function formatDuration(ms: number): string;
 export declare const textWidth: (text: string) => number;
 export declare function truncatePlain(text: string, width: number): string;

package/dist/tui/state.js

@@ -23,6 +23,7 @@ export function providerModelItems(provider, models, current) {
     }));
 }
 /** Text markers remain meaningful without color: [x] active, [ ] inactive, [!] failed, [*] pending. */
+/** Group headings are derived from the primary category (or "General") of each plugin. */
 export function pluginCatalogItems(entries) {
     const marker = (entry) => entry.status === "active"
         ? "[x]"
@@ -31,11 +32,16 @@ export function pluginCatalogItems(entries) {
             : entry.status === "failed"
                 ? "[!]"
                 : "[*]";
-    return entries.map((entry) => ({
+    const grouped = new Map();
+    for (const entry of entries) {
+        const primary = entry.categories[0] ?? "General";
+        grouped.set(primary, [...(grouped.get(primary) ?? []), entry]);
+    }
+    return [...grouped].flatMap(([title, group]) => group.map((entry, index) => ({
         value: entry.id,
-        label: `${marker(entry)} ${entry.name} · ${entry.builtin ? "built-in" : entry.source}`,
+        label: `${index === 0 ? `${title} · ` : ""}${marker(entry)} ${entry.name} · ${entry.builtin ? "built-in" : entry.source}`,
         description: `${entry.status}${entry.categories.length ? ` · ${entry.categories.join(", ")}` : ""} · ${entry.description}`,
-    }));
+    })));
 }
 export const pluginToggleNeedsConfirmation = (entry) => !entry.builtin;
 const mcpSourceTitle = (kind) => ({
@@ -117,18 +123,23 @@ export function configuredProviderModelItems(catalogs, current) {
     }
     return items;
 }
-export function contextLevel(pct) {
-    return pct < 60 ? "ok" : pct < 85 ? "warn" : "danger";
+export function contextLevel(pct, compactionAt = 85) {
+    // Warning band starts a quarter below the auto-compaction point; danger is exactly there.
+    const warn = Math.max(0, compactionAt - 25);
+    return pct < warn ? "ok" : pct < compactionAt ? "warn" : "danger";
 }
 export function contextPercent(used, total) {
     return total && total > 0 ? (used / total) * 100 : undefined;
 }
-export function formatContext(used, total, estimated) {
+export function formatContext(used, total, estimated, basis) {
     const prefix = `${estimated ? "~" : ""}${formatTokens(used)} / `;
     const pct = contextPercent(used, total);
-    return pct === undefined || !total
-        ? `${prefix}unknown`
-        : `${prefix}${formatTokens(total)} (${Math.round(pct)}%)`;
+    if (pct === undefined || !total)
+        return `${prefix}unknown`;
+    // The `~` marks an estimate; the "char budget" suffix tells the user the bar is measured
+    // against the fallback (est. tokens from limits.maxContextChars), not a model window.
+    const basisSuffix = basis === "chars" ? " char budget" : "";
+    return `${prefix}${formatTokens(total)} (${Math.round(pct)}%)${basisSuffix}`;
 }
 export function formatDuration(ms) {
     if (ms < 1000)
@@ -461,6 +472,9 @@ export function reduceEvent(state, event) {
             const checkpoint = typeof d.summarizedTokens === "number" && typeof d.checkpointTokens === "number"
                 ? ` · checkpoint ~${formatTokens(d.summarizedTokens)} → ~${formatTokens(d.checkpointTokens)} tokens`
                 : "";
+            const partial = d.partial
+                ? " · partial: the summary was cut by max output tokens; consider raising compaction.maxOutputTokens"
+                : "";
             return addItem({
                 ...state,
                 compacting: false,
@@ -468,7 +482,7 @@ export function reduceEvent(state, event) {
             }, {
                 kind: "notice",
                 text: [
-                    `Context compacted (${String(d.reason ?? "manual")}): ${String(d.replaced ?? 0)} messages summarized, ~${formatTokens(Number(d.before ?? 0))} → ~${formatTokens(Number(d.after ?? 0))} tokens${checkpoint}`,
+                    `Context compacted (${String(d.reason ?? "manual")}): ${String(d.replaced ?? 0)} messages summarized, ~${formatTokens(Number(d.before ?? 0))} → ~${formatTokens(Number(d.after ?? 0))} tokens${checkpoint}${partial}`,
                     ...reports,
                 ].join("\n"),
             });
@@ -487,6 +501,11 @@ export function reduceEvent(state, event) {
             return addItem({ ...state, compacting: false }, { kind: "notice", text: `Compaction skipped: ${String(d.detail ?? "nothing to compact")}` });
         case "compaction_failed":
             return addItem({ ...state, compacting: false }, { kind: "error", text: `Compaction failed: ${String(d.error ?? "unknown error")}` });
+        case "response_truncated":
+            return addItem(state, {
+                kind: "notice",
+                text: "Response cut by max output tokens — the answer may be incomplete. Raise limits.maxOutputTokens to allow longer answers.",
+            });
         case "model_changed":
             return {
                 ...state,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisio/alisio-code",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.6",
   "description": "Alisio: an extensible, provider-agnostic coding-agent harness for your terminal. TUI, OpenAI-compatible providers, permissioned local tools, context compaction, persistent memory and a typed plugin SDK.",
   "author": "Gustavo Gutiérrez",
   "license": "MIT",
@@ -45,14 +45,14 @@
     "alisio": "./dist/main.js"
   },
   "dependencies": {
-    "@alisio/core": "0.1.0-alpha.3",
-    "@alisio/plugin-deepseek": "0.1.0-alpha.2",
-    "@alisio/plugin-memory": "0.1.0-alpha.3",
-    "@alisio/plugin-openai-compatible": "0.1.0-alpha.3",
-    "@alisio/plugin-opencode": "0.1.0-alpha.2",
-    "@alisio/plugin-opencode-go": "0.1.0-alpha.2",
-    "@alisio/plugin-subagents": "0.1.0-alpha.3",
-    "@alisio/sdk": "0.1.0-alpha.2",
+    "@alisio/core": "0.1.0-alpha.5",
+    "@alisio/plugin-deepseek": "0.1.0-alpha.5",
+    "@alisio/plugin-memory": "0.1.0-alpha.5",
+    "@alisio/plugin-openai-compatible": "0.1.0-alpha.5",
+    "@alisio/plugin-opencode": "0.1.0-alpha.5",
+    "@alisio/plugin-opencode-go": "0.1.0-alpha.5",
+    "@alisio/plugin-subagents": "0.1.0-alpha.5",
+    "@alisio/sdk": "0.1.0-alpha.5",
     "@earendil-works/pi-tui": "0.87.1",
     "commander": "15.0.0"
   },