@aria-cli/cli 1.0.54 → 1.0.55

package/dist/session.js

@@ -0,0 +1,203 @@
+/**
+ * Arion Session Manager
+ * Manages the primary arion, active arions, and shared conversation history.
+ */
+import { log } from "@aria-cli/types";
+import { Room, parseMessage, ContributionGate, } from "@aria-cli/aria";
+export class ArionSession {
+    room;
+    history = [];
+    manager;
+    router;
+    memoria;
+    contributionGate;
+    initialized = false;
+    constructor(config) {
+        this.manager = config.manager;
+        this.router = config.router;
+        this.memoria = config.memoria;
+        this.contributionGate = new ContributionGate(config.router);
+        this.room = new Room({
+            onRest: async (arion) => {
+                await this.manager.rest(arion.name);
+                if (config.onArionRest) {
+                    await config.onArionRest(arion);
+                }
+            },
+        });
+    }
+    /**
+     * Initialize the session with the default or specified arion as primary.
+     */
+    async initialize(activeArionName) {
+        if (this.initialized)
+            return;
+        const arions = await this.manager.list();
+        const target = activeArionName
+            ? arions.find((a) => a.name.toLowerCase() === activeArionName.toLowerCase())
+            : arions.find((a) => a.isDefault);
+        if (target) {
+            // Auto-wake resting arions (matches become() behavior)
+            if (target.status === "resting") {
+                await this.manager.wake(target.name);
+                const woken = await this.manager.get(target.name);
+                if (woken) {
+                    this.room.setPrimary(woken);
+                }
+            }
+            else {
+                this.room.setPrimary(target);
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * Switch to a different arion as primary.
+     * Wakes resting arions automatically.
+     */
+    async become(name) {
+        let arion = await this.manager.get(name);
+        if (!arion) {
+            throw new Error(`Arion not found: ${name}`);
+        }
+        if (arion.status === "retired") {
+            throw new Error(`Cannot become retired arion: ${name}`);
+        }
+        if (arion.status === "resting") {
+            await this.manager.wake(name);
+            // Re-fetch to get updated status
+            arion = await this.manager.get(name);
+            if (!arion) {
+                throw new Error(`Arion not found after wake: ${name}`);
+            }
+        }
+        this.room.setPrimary(arion);
+        return arion;
+    }
+    /**
+     * Activate an arion (add to room without making primary).
+     * Wakes resting arions automatically.
+     */
+    async activate(name) {
+        let arion = await this.manager.get(name);
+        if (!arion) {
+            throw new Error(`Arion not found: ${name}`);
+        }
+        if (arion.status === "resting") {
+            await this.manager.wake(name);
+            // Re-fetch to get updated status
+            arion = await this.manager.get(name);
+            if (!arion) {
+                throw new Error(`Arion not found after wake: ${name}`);
+            }
+        }
+        this.room.enter(arion);
+        return arion;
+    }
+    /**
+     * Dismiss an arion from the room (send to rest).
+     * Cannot dismiss the primary arion.
+     */
+    async dismiss(name) {
+        const arion = this.room.get(name);
+        if (arion && arion !== this.room.getPrimary()) {
+            await this.room.exit(arion);
+        }
+    }
+    /**
+     * Get the current primary arion.
+     */
+    getPrimary() {
+        return this.room.getPrimary();
+    }
+    /**
+     * Get the backing room instance for handoff-aware RunSession wiring.
+     */
+    getRoom() {
+        return this.room;
+    }
+    /**
+     * Get all active arions in the room.
+     */
+    getActiveArions() {
+        return this.room.getActive();
+    }
+    /**
+     * Check if an arion is currently active in the room.
+     */
+    isActive(name) {
+        return this.room.isInRoom(name);
+    }
+    /**
+     * Add a message to the conversation history.
+     */
+    addToHistory(message) {
+        this.history.push(message);
+    }
+    /**
+     * Get a copy of the conversation history.
+     */
+    getHistory() {
+        return [...this.history];
+    }
+    /**
+     * Clear the conversation history.
+     */
+    clearHistory() {
+        this.history = [];
+    }
+    /**
+     * Parse a message for @mentions and dismissals.
+     */
+    parseMessage(input) {
+        return parseMessage(input);
+    }
+    /**
+     * Determine which arions should respond to a message.
+     * Includes addressed arions and evaluates volunteers from other active arions.
+     * Returns assessment info for volunteers to display contribution type.
+     */
+    async getRespondingArions(input, addressedArions, previousResponses) {
+        const startMs = Date.now();
+        const responding = addressedArions.map((arion) => ({
+            arion,
+            isAddressed: true,
+        }));
+        const others = this.room
+            .getActive()
+            .filter((a) => !addressedArions.some((addr) => addr.name === a.name));
+        if (others.length > 0) {
+            const volunteers = await this.contributionGate.evaluateAll(others, {
+                message: input,
+                previousResponses,
+                conversationHistory: this.history.map((m) => ({
+                    role: m.role,
+                    content: m.content,
+                })),
+            }, { maxVolunteers: 2 });
+            for (const { arion, assessment } of volunteers) {
+                responding.push({
+                    arion,
+                    isAddressed: false,
+                    assessment: {
+                        confidence: assessment.confidence,
+                        contributionType: assessment.contributionType || "addition",
+                    },
+                });
+            }
+        }
+        const durationMs = Date.now() - startMs;
+        if (durationMs > 100 || others.length > 0) {
+            log.debug(`[cli.responding_arions] ${durationMs}ms — evaluated ${others.length} non-addressed arions, ${responding.length - addressedArions.length} volunteered`);
+        }
+        return responding;
+    }
+    /**
+     * Get the Memoria instance for a specific arion.
+     * Returns null if arion has no Memoria configured.
+     */
+    async getArionMemoria(arion) {
+        return this.manager.getMemoria(arion);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/dist/slash-commands.js

@@ -0,0 +1,80 @@
+/**
+ * Slash command parsing utilities.
+ *
+ * Pure functions for extracting command names and arguments from
+ * user input like "/remember my note" or "/help".
+ *
+ * These are intentionally kept separate from React components
+ * so they can be easily tested and reused.
+ */
+function normalizeCommandName(command) {
+    return command.trim().toLowerCase();
+}
+/**
+ * Parse a slash command from user input.
+ * Returns null if the input is not a slash command.
+ *
+ * Examples:
+ *   "/remember my note" -> { command: "remember", args: "my note" }
+ *   "/help"             -> { command: "help", args: "" }
+ *   "hello world"       -> null
+ *   ""                  -> null
+ */
+export function parseSlashCommand(input) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith("/"))
+        return null;
+    const spaceIndex = trimmed.indexOf(" ");
+    if (spaceIndex === -1) {
+        const rawCommand = trimmed.slice(1);
+        const canonical = canonicalizeBuiltinCommand(rawCommand);
+        return { command: canonical ?? normalizeCommandName(rawCommand), args: "" };
+    }
+    const rawCommand = trimmed.slice(1, spaceIndex);
+    const canonical = canonicalizeBuiltinCommand(rawCommand);
+    return {
+        command: canonical ?? normalizeCommandName(rawCommand),
+        args: trimmed.slice(spaceIndex + 1).trim(),
+    };
+}
+/** List of built-in slash commands recognized by handleCommand */
+export const BUILTIN_COMMANDS = [
+    "help",
+    "arions",
+    "exit",
+    "hatch",
+    "remember",
+    "recall",
+    "recall_knowledge",
+    "send",
+    "model",
+    "become",
+    "rest",
+    "wake",
+    "memories",
+    "forget",
+    "clear",
+    "autonomy",
+    "resume",
+    "fork",
+    "daemon",
+    "sound",
+    "login",
+    "logout",
+    "terminal-setup",
+    "theme",
+    "invite",
+    "join",
+];
+const BUILTIN_COMMAND_MAP = new Map(BUILTIN_COMMANDS.map((command) => [command.toLowerCase(), command]));
+export function canonicalizeBuiltinCommand(command) {
+    const canonical = BUILTIN_COMMAND_MAP.get(normalizeCommandName(command));
+    return canonical ?? null;
+}
+/**
+ * Check whether a parsed command name is a known built-in command.
+ */
+export function isBuiltinCommand(command) {
+    return canonicalizeBuiltinCommand(command) !== null;
+}
+//# sourceMappingURL=slash-commands.js.map

package/dist/slash-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.js","sourceRoot":"","sources":["../src/slash-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,SAAS,oBAAoB,CAAC,OAAe;IAC3C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;QACzD,OAAO,EAAE,OAAO,EAAE,SAAS,IAAI,oBAAoB,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC9E,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;IACzD,OAAO;QACL,OAAO,EAAE,SAAS,IAAI,oBAAoB,CAAC,UAAU,CAAC;QACtD,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;KAC3C,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM;IACN,QAAQ;IACR,MAAM;IACN,OAAO;IACP,UAAU;IACV,QAAQ;IACR,kBAAkB;IAClB,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;IACN,MAAM;IACN,UAAU;IACV,QAAQ;IACR,OAAO;IACP,UAAU;IACV,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,OAAO;IACP,OAAO;IACP,QAAQ;IACR,gBAAgB;IAChB,OAAO;IACP,QAAQ;IACR,MAAM;CACE,CAAC;AAIX,MAAM,mBAAmB,GAA4C,IAAI,GAAG,CAC1E,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,OAAO,CAAU,CAAC,CAC7E,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACxD,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IACzE,OAAO,SAAS,IAAI,IAAI,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,0BAA0B,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;AACtD,CAAC"}

package/dist/sounds.js

@@ -0,0 +1,210 @@
+/**
+ * Warcraft II sound notifications for ARIA.
+ *
+ * Maps RunEvent lifecycle events to thematic Warcraft II sounds.
+ * User-configurable via /sound and persisted in config.
+ *
+ * Sound files live in `.comms/sounds/wav/` (repo root).
+ * Playback currently uses macOS `afplay` when available.
+ */
+import { execFile } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+// ---------------------------------------------------------------------------
+// Sound file resolution
+// ---------------------------------------------------------------------------
+function findWavDir() {
+    // Walk up from this file to find .comms/sounds/wav/
+    let dir = MODULE_DIR;
+    for (let i = 0; i < 10; i++) {
+        const candidate = join(dir, ".comms", "sounds", "wav");
+        if (existsSync(candidate))
+            return candidate;
+        const parent = resolve(dir, "..");
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+const WAV_DIR = findWavDir();
+function wavFiles(pattern) {
+    if (!WAV_DIR)
+        return [];
+    try {
+        return readdirSync(WAV_DIR)
+            .filter((f) => new RegExp(pattern).test(f))
+            .map((f) => join(WAV_DIR, f));
+    }
+    catch {
+        return [];
+    }
+}
+function clonedFiles(pattern) {
+    if (!WAV_DIR)
+        return [];
+    const clonedDir = join(WAV_DIR, "cloned");
+    try {
+        return readdirSync(clonedDir)
+            .filter((f) => new RegExp(pattern).test(f))
+            .map((f) => join(clonedDir, f));
+    }
+    catch {
+        return [];
+    }
+}
+function pickRandom(files) {
+    if (files.length === 0)
+        return null;
+    return files[Math.floor(Math.random() * files.length)];
+}
+// ---------------------------------------------------------------------------
+// Enable/disable toggle (persisted in config)
+// ---------------------------------------------------------------------------
+let enabled = true;
+let playbackChecked = false;
+let playbackSupported = false;
+export function setEnabled(value) {
+    enabled = value;
+}
+export function isEnabled() {
+    return enabled;
+}
+export function getPlaybackEngineLabel() {
+    if (process.platform !== "darwin")
+        return "unsupported on this platform";
+    return isPlaybackSupported() ? "afplay (macOS)" : "afplay unavailable";
+}
+export function isPlaybackSupported() {
+    if (playbackChecked)
+        return playbackSupported;
+    playbackChecked = true;
+    playbackSupported = process.platform === "darwin" && existsSync("/usr/bin/afplay");
+    return playbackSupported;
+}
+function play(file) {
+    if (!enabled || !file || !existsSync(file) || !isPlaybackSupported())
+        return false;
+    try {
+        execFile("afplay", [file], () => { });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Sound pools (cached at module load)
+// ---------------------------------------------------------------------------
+const POOLS = {
+    acknowledge: () => wavFiles("^(peasant|orc|human|dwarf|elf|troll)_acknowledge"),
+    annoyed: () => wavFiles("^(peasant|orc|goblin_sapper|human|troll|ogre)_selected"),
+    grumpy: () => wavFiles("^(goblin_sapper|ogre|ogre_mage)_selected"),
+    dark: () => [
+        ...wavFiles("^ogre_mage_selected"),
+        ...wavFiles("^ogre_selected"),
+        ...wavFiles("^troll_selected"),
+    ],
+    defeat: () => clonedFiles("^defeat_"),
+    error: () => clonedFiles("^error_"),
+    readyToWork: () => [
+        ...wavFiles("^peasant_selected"),
+        ...wavFiles("^orc_selected"),
+        ...wavFiles("^human_selected"),
+        ...wavFiles("^dwarf_selected"),
+    ],
+    fleetUp: () => [
+        ...wavFiles("^orc_acknowledge"),
+        ...wavFiles("^troll_acknowledge"),
+        ...wavFiles("^ogre_acknowledge"),
+        ...wavFiles("^human_acknowledge"),
+        ...wavFiles("^knight_acknowledge"),
+    ],
+    fleetDown: () => [
+        ...wavFiles("^ogre_mage_acknowledge"),
+        ...wavFiles("^ship_acknowledge"),
+        ...wavFiles("^horde_ship_acknowledge"),
+    ],
+    questDone: () => [
+        ...wavFiles("^jobs_done"),
+        ...wavFiles("^orc_work_completed"),
+        ...wavFiles("^peasant_selected"),
+        ...wavFiles("^orc_selected"),
+        ...wavFiles("^human_selected"),
+        ...wavFiles("^peasant_acknowledge"),
+        ...wavFiles("^orc_acknowledge"),
+    ],
+};
+// ---------------------------------------------------------------------------
+// Annoyance escalation
+// ---------------------------------------------------------------------------
+let lastPromptTime = 0;
+let annoyanceLevel = 0;
+const ANNOYANCE_COOLDOWN_MS = 15_000;
+function playAnnoyance() {
+    const now = Date.now();
+    if (now - lastPromptTime > ANNOYANCE_COOLDOWN_MS) {
+        annoyanceLevel = 1;
+    }
+    else {
+        annoyanceLevel++;
+    }
+    lastPromptTime = now;
+    if (annoyanceLevel <= 1) {
+        play(pickRandom(POOLS.acknowledge()));
+    }
+    else if (annoyanceLevel === 2) {
+        play(pickRandom(POOLS.annoyed()));
+    }
+    else if (annoyanceLevel === 3) {
+        play(pickRandom(POOLS.grumpy()));
+    }
+    else {
+        play(pickRandom(POOLS.dark()));
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Call once when the CLI session starts. "Ready to work!" */
+export function onSessionStart() {
+    play(pickRandom(POOLS.readyToWork()));
+}
+/** Call once when the CLI session ends. */
+export function onSessionEnd() {
+    play(pickRandom(POOLS.fleetDown()));
+}
+/** Call when the user submits a prompt. Plays annoyance escalation. */
+export function onPromptSubmit() {
+    playAnnoyance();
+}
+/** Call when the runner finishes responding. Plays completion sound. */
+export function onResponseComplete() {
+    play(pickRandom(POOLS.questDone()));
+}
+/** Call for every RunEvent during streaming. Handles tool sounds. */
+export function onRunEvent(event) {
+    switch (event.type) {
+        case "error":
+            play(pickRandom(POOLS.error()));
+            break;
+        case "guardrail_rejected":
+            play(pickRandom(POOLS.defeat()));
+            break;
+    }
+}
+/** Check if sound assets and playback are available. */
+export function isSoundAvailable() {
+    return WAV_DIR !== null && isPlaybackSupported();
+}
+/** Check if sound assets exist, even if playback is unsupported on this host. */
+export function hasSoundAssets() {
+    return WAV_DIR !== null;
+}
+/** Play a representative preview sound. Returns true if playback was attempted. */
+export function previewSound() {
+    return play(pickRandom(POOLS.readyToWork()));
+}
+//# sourceMappingURL=sounds.js.map

package/dist/sounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sounds.js","sourceRoot":"","sources":["../src/sounds.ts"],"names":[],"mappings":"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"}