@alisio/core 0.1.0-alpha.9 → 0.1.1

package/dist/background/store.js

@@ -0,0 +1,195 @@
+/**
+ * Persistence of background tasks (table `background_tasks`, schema v7). Every state change is a
+ * compare-and-set in SQL (`UPDATE … WHERE status IN (…)`), so two actors racing for the same task
+ * (the exit of the process, a stop from the user, the watchdog, another Alisio process on the same
+ * database) can never move it out of a terminal state or back.
+ *
+ *   queued ──▶ running ──▶ stopping ──▶ cancelled | failed(timeout)
+ *                 └────────▶ succeeded | failed        (the process ended by itself)
+ *   queued | running | stopping ──▶ lost                (the owner process is gone: startup only)
+ */
+import { relative } from "node:path";
+import { inside } from "../runtime/paths.js";
+import { isProcessAlive } from "../runtime/process.js";
+export const LIVE_STATES = [
+    "queued",
+    "running",
+    "stopping",
+];
+export const TERMINAL_STATES = [
+    "succeeded",
+    "failed",
+    "cancelled",
+    "lost",
+];
+export const isLive = (status) => LIVE_STATES.includes(status);
+export const isTerminal = (status) => !isLive(status);
+const sqlList = (values) => values.map((v) => `'${v}'`).join(",");
+const num = (value) => value === null || value === undefined ? undefined : Number(value);
+const text = (value) => value === null || value === undefined ? undefined : String(value);
+export function toRow(r) {
+    return {
+        id: String(r.id),
+        session: String(r.session),
+        rootSession: String(r.root_session),
+        workspace: String(r.workspace),
+        kind: r.kind,
+        label: String(r.label),
+        ...(text(r.command) !== undefined ? { command: text(r.command) } : {}),
+        ...(text(r.cwd) !== undefined ? { cwd: text(r.cwd) } : {}),
+        status: r.status,
+        ...(num(r.exit_code) !== undefined ? { exitCode: num(r.exit_code) } : {}),
+        ...(text(r.signal) !== undefined ? { signal: text(r.signal) } : {}),
+        ...(text(r.error_code) !== undefined ? { errorCode: text(r.error_code) } : {}),
+        ...(text(r.abort_origin) !== undefined
+            ? { abortOrigin: r.abort_origin }
+            : {}),
+        ...(num(r.pid) !== undefined ? { pid: num(r.pid) } : {}),
+        ownerPid: Number(r.owner_pid),
+        ...(num(r.timeout_ms) !== undefined ? { timeoutMs: num(r.timeout_ms) } : {}),
+        logPath: String(r.log_path),
+        bytes: Number(r.bytes ?? 0),
+        truncated: Number(r.truncated ?? 0) === 1,
+        createdAt: Number(r.created_at),
+        ...(num(r.started_at) !== undefined ? { startedAt: num(r.started_at) } : {}),
+        ...(num(r.ended_at) !== undefined ? { endedAt: num(r.ended_at) } : {}),
+        ...(num(r.delivered_at) !== undefined ? { deliveredAt: num(r.delivered_at) } : {}),
+    };
+}
+/** The wire view of a row: no log path, the working directory relative to the workspace. */
+export function toInfo(row, live) {
+    const cwd = row.cwd
+        ? inside(row.workspace, row.cwd)
+            ? relative(row.workspace, row.cwd) || "."
+            : row.cwd
+        : undefined;
+    const truncated = live?.truncated ?? row.truncated;
+    return {
+        id: row.id,
+        kind: row.kind,
+        label: row.label,
+        status: row.status,
+        ...(row.command !== undefined ? { command: row.command } : {}),
+        ...(cwd !== undefined ? { cwd } : {}),
+        ...(row.exitCode !== undefined ? { exitCode: row.exitCode } : {}),
+        ...(row.signal !== undefined ? { signal: row.signal } : {}),
+        ...(row.errorCode !== undefined ? { errorCode: row.errorCode } : {}),
+        ...(row.abortOrigin !== undefined ? { abortOrigin: row.abortOrigin } : {}),
+        sessionId: row.session,
+        bytes: live?.bytes ?? row.bytes,
+        ...(truncated ? { truncated: true } : {}),
+        ...(row.pid !== undefined ? { pid: row.pid } : {}),
+        ...(row.timeoutMs !== undefined ? { timeoutMs: row.timeoutMs } : {}),
+        createdAt: row.createdAt,
+        ...(row.startedAt !== undefined ? { startedAt: row.startedAt } : {}),
+        ...(row.endedAt !== undefined ? { endedAt: row.endedAt } : {}),
+        ...(row.deliveredAt !== undefined ? { delivered: true } : {}),
+    };
+}
+export class BackgroundTaskStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    insert(task) {
+        this.db
+            .prepare(`INSERT INTO background_tasks(id,session,root_session,workspace,kind,label,command,cwd,status,
+           owner_pid,timeout_ms,log_path,bytes,truncated,created_at)
+         VALUES(?,?,?,?,'shell',?,?,?,'queued',?,?,?,0,0,?)`)
+            .run(task.id, task.session, task.rootSession, task.workspace, task.label, task.command, task.cwd, task.ownerPid, task.timeoutMs, task.logPath, task.createdAt);
+        return this.get(task.id);
+    }
+    get(id) {
+        const row = this.db.prepare("SELECT * FROM background_tasks WHERE id=?").get(id);
+        return row ? toRow(row) : undefined;
+    }
+    /** Newest first. */
+    list(rootSession, options = {}) {
+        const where = options.status?.length ? ` AND status IN (${sqlList(options.status)})` : "";
+        return this.db
+            .prepare(`SELECT * FROM background_tasks WHERE root_session=?${where}
+         ORDER BY created_at DESC, rowid DESC LIMIT ?`)
+            .all(rootSession, Math.max(1, Math.min(options.limit ?? 100, 500)))
+            .map(toRow);
+    }
+    /**
+     * Compare-and-set: moves the task to `to` only while its status is one of `from`. Returns
+     * whether this call made the change (a lost race returns false and changes nothing).
+     */
+    transition(id, from, to, patch = {}) {
+        const sets = ["status=?"];
+        const params = [to];
+        const set = (column, value) => {
+            if (value === undefined)
+                return;
+            sets.push(`${column}=?`);
+            params.push(typeof value === "boolean" ? (value ? 1 : 0) : value);
+        };
+        set("exit_code", patch.exitCode);
+        set("signal", patch.signal);
+        set("error_code", patch.errorCode);
+        set("abort_origin", patch.abortOrigin);
+        set("started_at", patch.startedAt);
+        set("ended_at", patch.endedAt);
+        set("bytes", patch.bytes);
+        set("truncated", patch.truncated);
+        const result = this.db
+            .prepare(`UPDATE background_tasks SET ${sets.join(",")} WHERE id=? AND status IN (${sqlList(from)})`)
+            .run(...params, id);
+        return Number(result.changes) > 0;
+    }
+    setPid(id, pid) {
+        this.db.prepare("UPDATE background_tasks SET pid=? WHERE id=?").run(pid, id);
+    }
+    /** Progress of a live task (bytes written so far); never touches a terminal row's state. */
+    setProgress(id, bytes, truncated) {
+        this.db
+            .prepare("UPDATE background_tasks SET bytes=?, truncated=? WHERE id=?")
+            .run(bytes, truncated ? 1 : 0, id);
+    }
+    /** Marks the end of a task as told to its owner agent; true only for the first claim. */
+    claimDelivery(id, now) {
+        const result = this.db
+            .prepare("UPDATE background_tasks SET delivered_at=? WHERE id=? AND delivered_at IS NULL")
+            .run(now, id);
+        return Number(result.changes) > 0;
+    }
+    /** Undoes a claim whose wake-up did not start (only the claim of `now`). */
+    releaseDelivery(id, now) {
+        this.db
+            .prepare("UPDATE background_tasks SET delivered_at=NULL WHERE id=? AND delivered_at=?")
+            .run(id, now);
+    }
+    /**
+     * Startup recovery: tasks left queued, running or stopping by an owner process that no longer
+     * exists become `lost`. A task of this process (another application of the same server) or of
+     * another LIVE Alisio process is never touched.
+     */
+    markLost(now, ownPid = process.pid) {
+        const rows = this.db
+            .prepare(`SELECT * FROM background_tasks WHERE status IN (${sqlList(LIVE_STATES)})`)
+            .all()
+            .map(toRow);
+        const lost = [];
+        for (const row of rows) {
+            if (row.ownerPid === ownPid || isProcessAlive(row.ownerPid))
+                continue;
+            if (this.transition(row.id, LIVE_STATES, "lost", { endedAt: now }))
+                lost.push(this.get(row.id));
+        }
+        return lost;
+    }
+    /** Terminal tasks that ended before `cutoff`. */
+    endedBefore(cutoff) {
+        return this.db
+            .prepare(`SELECT * FROM background_tasks WHERE status IN (${sqlList(TERMINAL_STATES)})
+         AND COALESCE(ended_at, created_at) < ?`)
+            .all(cutoff)
+            .map(toRow);
+    }
+    delete(id) {
+        this.db
+            .prepare(`DELETE FROM background_tasks WHERE id=? AND status IN (${sqlList(TERMINAL_STATES)})`)
+            .run(id);
+    }
+}

package/dist/changelog/data.d.ts

@@ -0,0 +1,6 @@
+import type { ChangelogEntry } from "@alisio/sdk";
+/** The parsed `CHANGELOG.md` shipped with the package (newest entry first). */
+export declare const CHANGELOG_DATA: {
+    schema: 1;
+    entries: ChangelogEntry[];
+};

package/dist/changelog/data.js

@@ -0,0 +1,306 @@
+/** The parsed `CHANGELOG.md` shipped with the package (newest entry first). */
+export const CHANGELOG_DATA = {
+    schema: 1,
+    entries: [
+        {
+            version: "0.1.1",
+            date: "2026-10-03",
+            sections: [
+                {
+                    title: "Fixed",
+                    items: [
+                        "The web UI no longer scrolls the page and leaves a blank gap under the interface while a reply is streaming: the app now always fills the window exactly and only its inner panels scroll.",
+                        "The Alisio version is shown in the web UI: **Settings → About** and, discreetly, the bottom of the sidebar.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0",
+            date: "2026-10-02",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "The terminal UI and `alisio serve`, a local web UI with several sessions and workspaces at once, streaming, approvals, themes and English/Spanish; both run the same agent core.",
+                        "Agents: define your own in `.agents/agents`, manage them with `/agents` (terminal and web) and switch with `/agent:<id>`; Shift+Tab cycles the main agents (build, plan and your own) in the terminal and the web composer.",
+                        "Plan mode with plan review: the agent proposes a plan with `exit_plan` and you approve or revise it before anything changes.",
+                        "`/permission` (also `/permissions`) switches between ask, auto and full-access modes, and saved permissions are reviewed and revoked from the same menu.",
+                        "Python analysis: the agent writes and runs a script and publishes its outputs as artifacts (dashboards, reports, charts, spreadsheets); `/artifacts` lists them and the web shows them in an artifact panel.",
+                        "Tabular datasets: attach CSV, TSV or XLSX files and the agent inspects and queries them; the web has a table viewer.",
+                        "Background tasks: long commands keep running while you work; `/tasks` lists, inspects and stops them.",
+                        "`/goal <objective>` keeps the agent working on one objective, turn after turn, with a token budget (`budget=50k`), turn and time limits, and breakers for repeated replies; it never runs in plan mode and waits for approvals, questions and background tasks.",
+                        "`/reload` reloads the configuration, agents, skills, prompt templates and MCP servers between turns; a broken configuration leaves your session untouched.",
+                        "`/changelog [version]` shows what changed in each release, and Alisio mentions the news once after an upgrade.",
+                        "A Memory tab in the web UI and plugin-provided data views.",
+                        "`/btw` asks a side question about the session without adding it to the conversation.",
+                        "Approved access to directories outside the workspace (`--add-dir`, or an approval per directory).",
+                    ],
+                },
+                {
+                    title: "Improved",
+                    items: [
+                        "Live run progress in the terminal and the web: what the run is doing, how long it has been quiet and the last activity.",
+                        "A request that stays silent until the first-token limit is retried once and then ends with a readable error.",
+                        "The output limit of each request comes from the maximum the model declares in its catalog, when the provider reports it.",
+                        "Rich renderers for code, diffs, terminal output, JSON, test results, Mermaid diagrams and formulas.",
+                    ],
+                },
+                {
+                    title: "Fixed",
+                    items: [
+                        "A model reply that is cut off at the output limit is continued automatically instead of failing the turn.",
+                        "Project plugins, skills and MCP servers are merged with your global configuration instead of replacing it.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.28",
+            date: "2026-10-01",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "A model reply that is cut off at the output limit is continued automatically instead of failing the turn.",
+                        "A model request that stays silent until the first-token limit is retried once before it fails.",
+                    ],
+                },
+                {
+                    title: "Changed",
+                    items: [
+                        "The output limit of each request now comes from the maximum the model declares, when the provider reports it.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.27",
+            date: "2026-10-01",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "Live run progress in the terminal and the web: what the run is doing, how long it has been quiet and the last activity.",
+                    ],
+                },
+                {
+                    title: "Changed",
+                    items: [
+                        "A silent model request now ends with a readable error, and the timeout defaults were adjusted.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.26",
+            date: "2026-10-01",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "Python analysis: the agent can write and run a script and publish its outputs as downloadable artifacts (dashboards, reports, charts, spreadsheets).",
+                        "`/artifacts` lists and opens a session's artifacts; the web shows them as cards with a side panel.",
+                        "`/permissions` reviews and revokes the permissions you saved for a session.",
+                        "Tabular data in the web: attach CSV, TSV or XLSX files and the agent inspects and queries them.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.25",
+            date: "2026-09-30",
+            sections: [
+                {
+                    title: "Changed",
+                    items: [
+                        "The Agents window of the web UI can be maximized and keeps its scrollbar inside the corners.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.24",
+            date: "2026-09-30",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "Manage agents without leaving Alisio: `/agents` creates, edits and deletes agent files from templates, in the terminal and in the web Agents window.",
+                        "`/agent:<id>` activates an agent from the slash menu.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.23",
+            date: "2026-09-30",
+            sections: [
+                {
+                    title: "Changed",
+                    items: [
+                        "Refreshed branding across the terminal and the web, with an About page in the web settings.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.22",
+            date: "2026-09-30",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "`/btw` asks a side question about the session without adding it to the conversation, in the terminal and in the web.",
+                        "Archive workspaces in the web sidebar and pick a folder with the native folder dialog.",
+                        "A redesigned stop control in the web composer and the official logo and favicon.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.21",
+            date: "2026-09-30",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "`alisio serve` starts a local web UI with several sessions and workspaces at once, streaming, approvals, themes and English/Spanish.",
+                        "Rich renderers for code, diffs, terminal output, JSON, test results, Mermaid diagrams and formulas, plus a files panel and a trajectory tab.",
+                        "Image attachments in the web composer.",
+                        "Manage plugins, skills, MCP servers, agent presets, providers and models from the web settings.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.20",
+            date: "2026-09-30",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "Approved access to directories outside the workspace (`--add-dir`, or an approval per directory).",
+                        "A configurable inset for the transcript in the terminal (`/settings`).",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.19",
+            date: "2026-09-29",
+            sections: [
+                {
+                    title: "Changed",
+                    items: [
+                        "External provider plugins moved to the separate alisio-plugins repository; `@alisio/plugin-openai-compatible` stays built in.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.18",
+            date: "2026-09-28",
+            sections: [
+                {
+                    title: "Fixed",
+                    items: [
+                        "Project plugins, skills and MCP servers are merged with your global configuration instead of replacing it.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.17",
+            date: "2026-09-28",
+            sections: [
+                {
+                    title: "Added",
+                    items: ["Plugins declare categories, and the plugin picker groups them under headers."],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.16",
+            date: "2026-09-27",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "Rich MCP results, syntax highlighting in Markdown and clearer presentation of tool calls.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.15",
+            date: "2026-09-27",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "Active agents: `/agents` switches the main agent, and `/effort` sets the reasoning effort.",
+                        "The status line below the editor shows the agent, model, provider and effort.",
+                    ],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.14",
+            date: "2026-09-27",
+            sections: [
+                {
+                    title: "Added",
+                    items: ["A DuckDuckGo web search provider that needs no API key."],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.13",
+            date: "2026-09-26",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "A soft turn limit that lets the agent finish gracefully, and richer package READMEs.",
+                    ],
+                },
+                {
+                    title: "Changed",
+                    items: ["The header shows the model, provider and workspace identity."],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.12",
+            date: "2026-09-26",
+            sections: [
+                {
+                    title: "Fixed",
+                    items: [
+                        "Output-budget defaults, a cap on the context sent to the model and faster exit.",
+                    ],
+                },
+                {
+                    title: "Added",
+                    items: ["The header shows the Git branch of the workspace."],
+                },
+            ],
+        },
+        {
+            version: "0.1.0-alpha.1",
+            date: "2026-09-25",
+            sections: [
+                {
+                    title: "Added",
+                    items: [
+                        "Terminal UI for any OpenAI-compatible endpoint, with permissioned local tools, context compaction and persistent memory.",
+                        "Subagents, `ask_user_question`, web tools, per-directory project trust and pasting text or images into the editor.",
+                        "Providers, MCP servers and skills managers, `/settings`, slash completion for skills and an npm plugin installer.",
+                        "A context bar that follows the model's real window, with per-profile overrides for local servers.",
+                    ],
+                },
+            ],
+        },
+    ],
+};

package/dist/changelog/index.d.ts

@@ -0,0 +1,5 @@
+/** The shipped changelog: parsed from `CHANGELOG.md` at build time, available offline. */
+import type { ChangelogEntry } from "@alisio/sdk";
+export { changelogNews, compareVersions, formatChangelogMarkdown, isVersion, type NewsDecision, parseChangelog, type SelectedEntries, selectEntries, UNRELEASED, } from "./parse.ts";
+/** Every entry of the shipped changelog, newest first as written in the file. */
+export declare function loadChangelog(): ChangelogEntry[];

package/dist/changelog/index.js

@@ -0,0 +1,7 @@
+import { CHANGELOG_DATA } from "./data.js";
+export { changelogNews, compareVersions, formatChangelogMarkdown, isVersion, parseChangelog, selectEntries, UNRELEASED, } from "./parse.js";
+/** Every entry of the shipped changelog, newest first as written in the file. */
+export function loadChangelog() {
+    const data = CHANGELOG_DATA;
+    return data.schema === 1 && Array.isArray(data.entries) ? data.entries : [];
+}

package/dist/changelog/parse.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Pure parser and version helpers of `CHANGELOG.md` (Keep a Changelog, reduced). No I/O and no
+ * runtime imports, so the build script can load it with `node --experimental-strip-types`.
+ *
+ * Format: `## [Unreleased]` or `## [<version>] - <date>`, then `### Added|Changed|Fixed`
+ * sections of `- ` bullets (a continuation line indented under a bullet extends it). Anything
+ * outside an entry (the title, the introduction) is ignored; entries keep the file order.
+ */
+import type { ChangelogEntry } from "@alisio/sdk";
+export declare const UNRELEASED = "Unreleased";
+export declare function parseChangelog(markdown: string): ChangelogEntry[];
+/** Whether `text` is a semantic version (`1.2.3-alpha.4`, with an optional leading `v`). */
+export declare const isVersion: (text: string) => boolean;
+/**
+ * Semver order with numeric prerelease identifiers (`alpha.9` < `alpha.10`; a release is above its
+ * prereleases). `Unreleased` is above every version; an unparseable text sorts below all of them.
+ */
+export declare function compareVersions(a: string, b: string): number;
+export interface SelectedEntries {
+    entries: ChangelogEntry[];
+    /** `false` when a version was asked for and no entry has it. */
+    found: boolean;
+}
+/**
+ * The entries to show: the `limit` newest (default 5), or the one named by `version` (`alpha.4`,
+ * `1.2.3-alpha.4` and `v1.2.3-alpha.4` all match). Entries come back newest first.
+ */
+export declare function selectEntries(entries: ChangelogEntry[], options?: {
+    version?: string;
+    limit?: number;
+}): SelectedEntries;
+export interface NewsDecision {
+    /** Show the one-line "updated" notice. */
+    show: boolean;
+    /** Versions newer than `lastSeen` up to `current`, newest first. */
+    versions: string[];
+    latest?: string;
+    /** The viewer should now store `current` as its last seen version. */
+    record: boolean;
+}
+/**
+ * Decides the discreet "Alisio updated" line. A first run (no `lastSeen`) stays silent and records;
+ * the same version does nothing; a downgrade or an upgrade without entries records silently;
+ * an upgrade with entries in `(lastSeen, current]` shows. `Unreleased` never counts as news and an
+ * unparseable `current` (a development build) does nothing.
+ */
+export declare function changelogNews(input: {
+    entries: ChangelogEntry[];
+    current: string;
+    lastSeen?: string | undefined;
+}): NewsDecision;
+/** Markdown for the entries (one `##` heading per version, bold section titles, bullets). */
+export declare function formatChangelogMarkdown(entries: ChangelogEntry[]): string;