@alisio/alisio-code 0.1.0-alpha.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gustavo Gutiérrez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# alisio
+
+**Alisio is an extensible, provider-agnostic coding-agent harness for your terminal.** It pairs a
+fast TUI with any OpenAI-compatible model, runs local tools behind explicit permissions, compacts
+long conversations into structured checkpoints, remembers decisions across sessions with an
+Engram-style memory plugin, and exposes a typed plugin SDK.
+
+```sh
+npm install -g @alisio/alisio-code        # or: pnpm add -g @alisio/alisio-code · bun add -g @alisio/alisio-code
+alisio                                      # the CLI binary is installed as `alisio`
+export DEEPSEEK_API_KEY=...  # keys are read from environment variables only
+alisio --config ./alisio.json
+```
+
+- Terminal UI: streaming Markdown, tool blocks with diffs, context/token bar, slash commands, copy-on-select.
+- Headless: `alisio run "prompt" --json` emits versioned JSONL events.
+- Permissions: reads by default; `--allow-write`, `--allow-process` or interactive approval; `--read-only`.
+- Built-in memory plugin (disable with `--disable-plugin memory`); npm plugins via `--plugin <package>`.
+- Runs on Node.js >= 22.16 or Bun; standalone binaries are attached to GitHub releases.
+
+Documentation: [English](https://gustavogutierrez.github.io/alisio/) · [Español](https://gustavogutierrez.github.io/alisio/es/)
+
+Maintainer: Gustavo Gutiérrez · License: MIT

package/dist/banner.d.ts

@@ -0,0 +1,56 @@
+import type { StartupInput, StartupResult, TerminalCapabilities } from "@alisio/core";
+type Env = Record<string, string | undefined>;
+export interface BannerPolicyInput {
+    mode: "tui" | "readline" | "run";
+    json?: boolean;
+    quiet?: boolean;
+    /** `false` when --no-banner is given. */
+    banner?: boolean;
+    stdoutTTY: boolean;
+    stderrTTY: boolean;
+    env: Env;
+}
+/**
+ * Banner only for interactive sessions: never for run/resume-with-prompt, --json, --quiet,
+ * --no-banner, CI, or when the target stream is not a terminal.
+ */
+export declare function bannerPolicy(input: BannerPolicyInput): boolean;
+export declare function terminalCapabilities(input: {
+    env: Env;
+    columns: number;
+    tty: boolean;
+}): TerminalCapabilities;
+interface AppLike {
+    workspace: string;
+    config: {
+        provider: {
+            baseURL: string;
+        };
+    };
+    provider: {
+        model: string;
+    };
+    providerInfo?: {
+        id: string;
+        profile: Record<string, string | number | boolean>;
+        persisted: boolean;
+    };
+    plugins: Parameters<typeof import("@alisio/core").renderStartup>[0] & {
+        builtins: Set<string>;
+    };
+    runner: {
+        policy: {
+            write: boolean;
+            process: boolean;
+        };
+        approvals: boolean;
+    };
+}
+/** Startup input from an application: provider host only, never keys or full URLs. */
+export declare function startupInput(app: AppLike, options: {
+    version: string;
+    model?: string;
+    readOnly?: boolean;
+    terminal: TerminalCapabilities;
+}): StartupInput;
+export type { StartupResult };

package/dist/banner.js

@@ -0,0 +1,69 @@
+/**
+ * Startup banner policy and terminal capability detection (pure), plus the glue that builds
+ * the startup context from an application. Rendering itself lives in @alisio/core.
+ */
+import { homedir, userInfo } from "node:os";
+/**
+ * Banner only for interactive sessions: never for run/resume-with-prompt, --json, --quiet,
+ * --no-banner, CI, or when the target stream is not a terminal.
+ */
+export function bannerPolicy(input) {
+    if (input.mode === "run" || input.json || input.quiet || input.banner === false)
+        return false;
+    if (input.env.CI && input.env.CI !== "false" && input.env.CI !== "0")
+        return false;
+    // The TUI draws on stdout; readline mode prints the banner to stderr.
+    return input.mode === "tui" ? input.stdoutTTY : input.stderrTTY;
+}
+export function terminalCapabilities(input) {
+    const { env } = input;
+    const dumb = env.TERM === "dumb";
+    const locale = env.LC_ALL || env.LC_CTYPE || env.LANG || "";
+    return {
+        color: input.tty && !dumb && env.NO_COLOR === undefined,
+        unicode: !dumb && !/^(C|POSIX)(\.|$)/i.test(locale),
+        columns: input.columns > 0 ? input.columns : 80,
+        interactive: input.tty,
+    };
+}
+/** Startup input from an application: provider host only, never keys or full URLs. */
+export function startupInput(app, options) {
+    let host = "unknown";
+    try {
+        host = new URL(String(app.providerInfo?.profile.baseURL ?? app.config.provider.baseURL)).host;
+    }
+    catch {
+        /* keep unknown */
+    }
+    const state = (on) => (on ? "on" : app.runner.approvals ? "ask" : "off");
+    let user;
+    try {
+        user = userInfo().username;
+    }
+    catch {
+        user = undefined;
+    }
+    return {
+        version: options.version,
+        cwd: app.workspace,
+        home: homedir(),
+        model: options.model ?? app.provider.model,
+        provider: host,
+        ...(user ? { userName: user } : {}),
+        terminal: options.terminal,
+        facts: [
+            {
+                label: "access",
+                value: options.readOnly
+                    ? "read-only"
+                    : `write:${state(app.runner.policy.write)} process:${state(app.runner.policy.process)}`,
+            },
+            { label: "memory", value: app.plugins.builtins.has("memory") ? "on" : "off" },
+            ...(!(options.model ?? app.provider.model)
+                ? [{ label: "model", value: "⚠ not configured — use /connect" }]
+                : (options.model ?? app.provider.model) === "YOUR_MODEL_ID"
+                    ? [{ label: "model", value: "⚠ placeholder — edit .alisio/config.json" }]
+                    : []),
+        ],
+    };
+}

package/dist/builtin.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Built-in plugin registry wired by the CLI. Built-ins load through the trusted path of the
+ * plugin host (unprefixed names, `internal` effect) and can be disabled by configuration
+ * (`builtinPlugins.<id>.enabled: false`) or `--disable-plugin <id>`. Add a built-in by
+ * appending an entry here.
+ */
+import type { BuiltinPlugin } from "@alisio/core";
+export declare const BUILTIN_PLUGINS: BuiltinPlugin[];

package/dist/builtin.js

@@ -0,0 +1,49 @@
+import { createDeepSeekPlugin } from "@alisio/plugin-deepseek";
+import { createMemoryPlugin } from "@alisio/plugin-memory";
+import { createOpenAICompatiblePlugin } from "@alisio/plugin-openai-compatible";
+import { createOpenCodePlugin } from "@alisio/plugin-opencode";
+import { createOpenCodeGoPlugin } from "@alisio/plugin-opencode-go";
+import { createSubagentsPlugin } from "@alisio/plugin-subagents";
+export const BUILTIN_PLUGINS = [
+    {
+        id: "deepseek",
+        name: "DeepSeek",
+        description: "Dedicated DeepSeek Chat Completions and Responses provider",
+        categories: ["model-provider"],
+        create: createDeepSeekPlugin,
+    },
+    {
+        id: "opencode",
+        name: "OpenCode Console (Zen)",
+        description: "Dedicated OpenCode Console (Zen) multi-protocol provider",
+        categories: ["model-provider"],
+        create: createOpenCodePlugin,
+    },
+    {
+        id: "opencode-go",
+        name: "OpenCode Go",
+        description: "Dedicated OpenCode Go multi-protocol provider",
+        categories: ["model-provider"],
+        create: createOpenCodeGoPlugin,
+    },
+    {
+        id: "openai-compatible",
+        name: "OpenAI compatible",
+        description: "OpenAI-compatible Chat Completions and Responses model provider",
+        categories: ["model-provider"],
+        defaultProvider: true,
+        create: createOpenAICompatiblePlugin,
+    },
+    {
+        id: "memory",
+        name: "Memory",
+        description: "Engram-style persistent memory (SQLite + FTS5), memory-aware compaction",
+        create: createMemoryPlugin,
+    },
+    {
+        id: "subagents",
+        name: "Subagents",
+        description: "Delegation to specialized subagents in child sessions (task tool, agent tree)",
+        create: createSubagentsPlugin,
+    },
+];

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};