@alisio/alisio-code 0.1.0 → 0.2.0

package/dist/main.js

@@ -156,7 +156,7 @@ async function run(cmd, prompt, sessionId) {
     let activeRunOptions = {};
     try {
         const reported = app.plugins.pluginState("subagents", "mainAgents");
-        activeRunOptions = agentRunOptions(resolveActiveAgent(agentCatalogFromState(reported), app.config.agents.active));
+        activeRunOptions = agentRunOptions(resolveActiveAgent(agentCatalogFromState(reported), app.config.agents.active), { plan: app.config.plan });
     }
     catch {
         /* agent resolution is best-effort */

package/dist/tui/app.js

@@ -18,7 +18,7 @@ import { formatGoalStatus, GoalBar, goalPickerItems, goalPickerPrefill, goalStop
 import { agentCycleHint, isPermissionMode, modeDisplay, permissionMenuRows, permissionTransition, reloadGuard, shiftTabDecision, } from "./modes.js";
 import { cannotOpenMessage, openPath, revealPath } from "./open-path.js";
 import { initialPanelState, reducePanel, visibleRows } from "./panel.js";
-import { planTranscriptMarkdown } from "./plan-review.js";
+import { planDiagramsMarkdown, planTranscriptMarkdown } from "./plan-review.js";
 import { summarizeAnswers } from "./questions.js";
 import { InteractiveQueue } from "./queue.js";
 import { settingsMenuRows } from "./settings.js";
@@ -729,6 +729,23 @@ export async function runTui(options) {
                     reasoning: "",
                     done: true,
                 });
+                if (plan.diagrams?.length) {
+                    // The folder is resolved from the store, never from the model.
+                    const record = plan.artifact ? app.artifacts.get(plan.artifact.id) : undefined;
+                    const folder = record?.status === "ready"
+                        ? shortenPath(join(app.artifacts.folder(record), "files"), homedir(), 96)
+                        : undefined;
+                    push({
+                        kind: "assistant",
+                        text: planDiagramsMarkdown({
+                            revision: plan.revision,
+                            diagrams: plan.diagrams,
+                            ...(folder ? { folder } : {}),
+                        }),
+                        reasoning: "",
+                        done: true,
+                    });
+                }
                 showPicker(new PlanReviewPanel(options, {
                     title: plan.title,
                     revision: plan.revision,
@@ -1430,7 +1447,7 @@ export async function runTui(options) {
         // An explicit /effort wins; otherwise the agent's own default effort (agentRunOptions) is kept.
         const effort = app.config.agents.effort || !agent.effort ? currentEffort() : undefined;
         // The goal tools are offered while the session has an ACTIVE goal (never to the plan agent).
-        const agentOptions = agentRunOptions(agent);
+        const agentOptions = agentRunOptions(agent, { plan: app.config.plan });
         const goalTools = goalOptInTools(app.goals.get(app.store.rootOf(session)), agent.id === "plan");
         const optInTools = [...(agentOptions.optInTools ?? []), ...goalTools];
         const runId = crypto.randomUUID();

package/dist/tui/plan-review.d.ts

@@ -4,6 +4,7 @@
  * {state, effect}, fully testable without a terminal. Esc means "Skip for now" while choosing and
  * "back to the choices" while typing; Enter submits; an empty text never submits.
  */
+import type { PlanDiagramInfo } from "@alisio/sdk";
 import { type ConnectInputState } from "./connect-input.ts";
 export interface PlanReviewOption {
     value: string;
@@ -46,3 +47,17 @@ export declare function planTranscriptMarkdown(plan: {
     revision: number;
     markdown: string;
 }): string;
+/** Lines of Mermaid source the terminal shows per diagram (the full source is in the folder). */
+export declare const DIAGRAM_SOURCE_LINES = 8;
+/**
+ * What the terminal shows for a plan's diagrams, as Markdown for the transcript: per diagram its
+ * title, purpose, the plan section it illustrates, its explanation and the Mermaid source capped
+ * to a few lines (no attempt to draw it), then where the plan folder is and how to open it.
+ * Empty when the plan has no diagrams.
+ */
+export declare function planDiagramsMarkdown(plan: {
+    revision: number;
+    diagrams?: PlanDiagramInfo[];
+    /** Display path of the plan folder on disk (absent when the plan could not be saved). */
+    folder?: string;
+}): string;

package/dist/tui/plan-review.js

@@ -1,9 +1,3 @@
-/**
- * Pure, pi-tui-free reducer of the plan review panel (`exit_plan`): three decisions and, for "Add
- * context", a one-line text field. Same convention as `questions.ts`: state + action ->
- * {state, effect}, fully testable without a terminal. Esc means "Skip for now" while choosing and
- * "back to the choices" while typing; Enter submits; an empty text never submits.
- */
 import { printableInput, reduceConnectInput } from "./connect-input.js";
 export const SKIP_VALUE = "skip";
 export function initialPlanReviewState(options) {
@@ -74,3 +68,43 @@ export function reducePlanReview(state, action) {
 export function planTranscriptMarkdown(plan) {
     return `**Plan: ${plan.title}**${plan.revision > 1 ? ` (revision ${plan.revision})` : ""}\n\n${plan.markdown}`;
 }
+/** Lines of Mermaid source the terminal shows per diagram (the full source is in the folder). */
+export const DIAGRAM_SOURCE_LINES = 8;
+/**
+ * What the terminal shows for a plan's diagrams, as Markdown for the transcript: per diagram its
+ * title, purpose, the plan section it illustrates, its explanation and the Mermaid source capped
+ * to a few lines (no attempt to draw it), then where the plan folder is and how to open it.
+ * Empty when the plan has no diagrams.
+ */
+export function planDiagramsMarkdown(plan) {
+    const diagrams = plan.diagrams ?? [];
+    if (!diagrams.length)
+        return "";
+    const blocks = diagrams.map((diagram, index) => {
+        const lines = diagram.mermaid.split("\n");
+        const shown = lines.slice(0, DIAGRAM_SOURCE_LINES);
+        const more = lines.length - shown.length;
+        const change = plan.revision > 1 && diagram.status !== "unchanged"
+            ? ` · ${diagram.status === "new" ? "new" : "updated"} in revision ${plan.revision}`
+            : "";
+        const section = diagram.section ? ` · section: ${diagram.section}` : "";
+        return [
+            `**${index + 1}. ${diagram.title}** · ${diagram.type}${section}${change}`,
+            diagram.explanation,
+            "",
+            "```mermaid",
+            ...shown,
+            "```",
+            ...(more > 0
+                ? [`_… ${more} more line${more === 1 ? "" : "s"} in diagrams/${diagram.id}.mmd_`]
+                : []),
+        ].join("\n");
+    });
+    return [
+        `**Diagrams (${diagrams.length})** · drawn in the web plan viewer; the terminal shows their source`,
+        ...blocks,
+        plan.folder
+            ? `Plan folder: \`${plan.folder}\` (plan.md, plan.json, diagrams/*.mmd). Open it from /artifacts.`
+            : "The plan folder could not be saved, so these diagrams are only shown here.",
+    ].join("\n\n");
+}

package/dist/tui/settings.d.ts

@@ -93,6 +93,10 @@ export interface SettingsConfigView {
         noToolTurnsLimit: number;
         blockedRepeats: number;
     };
+    plan: {
+        diagrams: boolean;
+        maxDiagrams: number;
+    };
 }
 export interface SettingsMenuInput {
     config: SettingsConfigView;

package/dist/tui/settings.js

@@ -31,6 +31,7 @@ export const defaultConfig = {
         noToolTurnsLimit: 3,
         blockedRepeats: 2,
     },
+    plan: { diagrams: true, maxDiagrams: 5 },
 };
 /** Strictly ascending number sequence with exact step arithmetic (0.85 stays 0.85). */
 function stepValues(start, end, step) {
@@ -294,6 +295,24 @@ export const SETTINGS_DEFINITIONS = [
         read: (config) => config.goal.blockedRepeats,
         description: "How many consecutive turns the agent must report the same blocker (with evidence) before the goal stops as blocked. A permission denial blocks at once.",
     },
+    {
+        id: "plan.diagrams",
+        label: "Plan diagrams",
+        category: "Plan",
+        valueType: "boolean",
+        values: [false, true],
+        read: (config) => config.plan.diagrams,
+        description: "The plan agent may add Mermaid diagrams to a plan (exit_plan). The terminal shows each diagram's title, explanation and source; the web draws them in the plan viewer. Off removes them from the tool and from the agent's instructions.",
+    },
+    {
+        id: "plan.maxDiagrams",
+        label: "Most diagrams per plan",
+        category: "Plan",
+        valueType: "number",
+        values: [0, 1, 2, 3, 4, 5, 6, 7, 8],
+        read: (config) => config.plan.maxDiagrams,
+        description: "Diagrams beyond this number are dropped (the tool result says so). 0 behaves like turning plan diagrams off.",
+    },
     {
         id: "tui.paddingX",
         label: "Editor padding",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisio/alisio-code",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "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,12 +45,12 @@
     "alisio": "./dist/main.js"
   },
   "dependencies": {
-    "@alisio/core": "0.1.0",
-    "@alisio/plugin-memory": "0.1.0",
-    "@alisio/plugin-openai-compatible": "0.1.0",
-    "@alisio/plugin-subagents": "0.1.0",
-    "@alisio/sdk": "0.1.0",
-    "@alisio/server": "0.1.0",
+    "@alisio/core": "0.2.0",
+    "@alisio/plugin-memory": "0.2.0",
+    "@alisio/plugin-openai-compatible": "0.2.0",
+    "@alisio/plugin-subagents": "0.2.0",
+    "@alisio/sdk": "0.2.0",
+    "@alisio/server": "0.2.0",
     "@earendil-works/pi-tui": "0.87.1",
     "commander": "15.0.0"
   },