@aria-cli/tools 1.0.10 → 1.0.11

package/dist-cjs/executors/session-history.js

@@ -0,0 +1,321 @@
+"use strict";
+/**
+ * @aria/tools - Session History tool executor
+ *
+ * Implementation of session history operations for ARIA tool system.
+ * Provides list, search, get, current, stats, delete, and set_title actions
+ * against the SessionHistory SQLite database.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionHistory = getSessionHistory;
+exports.executeSessionHistory = executeSessionHistory;
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const utils_js_1 = require("./utils.js");
+// ============================================================================
+// Helpers
+// ============================================================================
+/** Max content length per message in 'get' output to prevent context blowout */
+const MAX_MESSAGE_CONTENT_LENGTH = 2000;
+/**
+ * Cached fallback SessionHistory instance — created once per process via
+ * dynamic import of @aria/cli's SessionHistory class.  This avoids a hard
+ * package dependency (tools → cli) while still giving the tool access to
+ * the real SQLite history DB when ctx.sessionHistory isn't wired through.
+ */
+/** Cached fallback SessionHistory — resolved once per process via dynamic import. */
+let _fallbackSessionHistory;
+let _fallbackPromise = null;
+async function resolveFallbackSessionHistory() {
+    if (_fallbackSessionHistory !== undefined)
+        return _fallbackSessionHistory;
+    if (_fallbackPromise)
+        return _fallbackPromise;
+    _fallbackPromise = (async () => {
+        try {
+            // Dynamic import of @aria/cli (optionalDependency, ESM-only).
+            // Using a variable prevents TS from resolving the specifier statically
+            // and from downleveling to require() in CJS output.
+            const _specifier = "@aria-cli/cli";
+            const mod = (await Promise.resolve(`${_specifier}`).then(s => __importStar(require(s))));
+            const SessionHistory = mod.SessionHistory;
+            const ariaHome = process.env.ARIA_HOME ?? path.join(os.homedir(), ".aria");
+            // Determine active arion from config or default to "ARIA"
+            let arionName = "ARIA";
+            try {
+                const { readFileSync, existsSync } = await Promise.resolve().then(() => __importStar(require("node:fs")));
+                const configPath = path.join(ariaHome, "config.json");
+                if (existsSync(configPath)) {
+                    const raw = JSON.parse(readFileSync(configPath, "utf-8"));
+                    if (raw.activeArion)
+                        arionName = raw.activeArion;
+                }
+            }
+            catch {
+                // Ignore config read errors
+            }
+            const dbPath = SessionHistory.resolvePerArionPath(ariaHome, arionName);
+            _fallbackSessionHistory = new SessionHistory(dbPath);
+            return _fallbackSessionHistory;
+        }
+        catch {
+            // @aria/cli not available (e.g. isolated worker) — no fallback
+            _fallbackSessionHistory = null;
+            return null;
+        }
+    })();
+    return _fallbackPromise;
+}
+/**
+ * Get the SessionHistoryRef — from ToolContext if wired, otherwise create
+ * a fallback instance by dynamically importing @aria/cli's SessionHistory.
+ */
+async function getSessionHistory(ctx) {
+    if (ctx.sessionHistory)
+        return ctx.sessionHistory;
+    return resolveFallbackSessionHistory();
+}
+function formatSessions(sessions) {
+    return sessions.map((s) => ({
+        id: s.id,
+        title: s.title,
+        arion: s.arion,
+        model: s.model,
+        messageCount: s.messageCount,
+        updatedAt: s.updatedAt.toISOString(),
+        completedAt: s.completedAt?.toISOString(),
+        preview: s.preview,
+    }));
+}
+function truncateContent(content, max) {
+    if (content.length <= max)
+        return content;
+    return content.slice(0, max - 3) + "...";
+}
+function resolveSessionId(sh, rawId) {
+    // Try exact match first (full UUID), then prefix
+    if (rawId.length === 36) {
+        const session = sh.getSession(rawId);
+        return session ? rawId : null;
+    }
+    return sh.findSessionByPrefix(rawId);
+}
+// ============================================================================
+// Main Executor
+// ============================================================================
+/**
+ * Execute a session_history action.
+ */
+async function executeSessionHistory(input, ctx) {
+    if (ctx.abortSignal?.aborted)
+        return (0, utils_js_1.fail)("Operation cancelled");
+    if (!input.action) {
+        return (0, utils_js_1.fail)("action is required. Valid actions: list, search, get, current, stats, delete, set_title");
+    }
+    const sh = await getSessionHistory(ctx);
+    if (!sh) {
+        return (0, utils_js_1.fail)("Session history is not available in this context");
+    }
+    try {
+        switch (input.action) {
+            case "list":
+                return executeList(input, sh);
+            case "search":
+                return executeSearch(input, sh);
+            case "get":
+                return executeGet(input, sh);
+            case "current":
+                return executeCurrent(ctx, sh);
+            case "stats":
+                return executeStats(sh);
+            case "delete":
+                return executeDelete(input, sh);
+            case "set_title":
+                return executeSetTitle(input, sh);
+            default:
+                return (0, utils_js_1.fail)(`Unknown action "${input.action}". Valid actions: list, search, get, current, stats, delete, set_title`);
+        }
+    }
+    catch (err) {
+        return (0, utils_js_1.fail)((0, utils_js_1.getErrorMessage)(err));
+    }
+}
+// ============================================================================
+// Action Implementations
+// ============================================================================
+function executeList(input, sh) {
+    const limit = input.limit ?? 20;
+    const offset = input.offset ?? 0;
+    const sessions = sh.listSessions(limit, offset);
+    const formatted = formatSessions(sessions);
+    const output = {
+        sessions: formatted,
+        total: formatted.length,
+        limit,
+        offset,
+    };
+    if (formatted.length === 0) {
+        return (0, utils_js_1.success)("No sessions found", output);
+    }
+    const summaryLines = formatted.map((s) => `• ${s.id.slice(0, 8)}… | ${s.title || "(untitled)"} | ${s.messageCount} msgs | ${s.arion} | ${s.updatedAt.slice(0, 10)}`);
+    return (0, utils_js_1.success)(`Found ${formatted.length} session(s):\n${summaryLines.join("\n")}`, output);
+}
+function executeSearch(input, sh) {
+    if (!input.query || input.query.trim() === "") {
+        return (0, utils_js_1.fail)("query is required for 'search' action");
+    }
+    const limit = input.limit ?? 20;
+    const offset = input.offset ?? 0;
+    const sessions = sh.searchSessionsFts(input.query, limit, offset);
+    const formatted = formatSessions(sessions);
+    const output = {
+        sessions: formatted,
+        total: formatted.length,
+        limit,
+        offset,
+    };
+    if (formatted.length === 0) {
+        return (0, utils_js_1.success)(`No sessions found matching "${input.query}"`, output);
+    }
+    const summaryLines = formatted.map((s) => `• ${s.id.slice(0, 8)}… | ${s.title || "(untitled)"} | ${s.messageCount} msgs | ${s.arion} | ${s.updatedAt.slice(0, 10)}`);
+    return (0, utils_js_1.success)(`Found ${formatted.length} session(s) matching "${input.query}":\n${summaryLines.join("\n")}`, output);
+}
+function executeGet(input, sh) {
+    if (!input.sessionId || input.sessionId.trim() === "") {
+        return (0, utils_js_1.fail)("sessionId is required for 'get' action");
+    }
+    const resolvedId = resolveSessionId(sh, input.sessionId);
+    if (!resolvedId) {
+        return (0, utils_js_1.fail)(`Session not found for ID/prefix "${input.sessionId}"`);
+    }
+    const session = sh.getSession(resolvedId);
+    if (!session) {
+        return (0, utils_js_1.fail)(`Session ${resolvedId} not found`);
+    }
+    const messageLimit = input.messageLimit ?? 50;
+    // Take the last N messages to avoid context blowout
+    const messagesSlice = session.messages.slice(-messageLimit);
+    const formattedMessages = messagesSlice.map((m) => ({
+        role: m.role,
+        content: truncateContent(m.content, MAX_MESSAGE_CONTENT_LENGTH),
+        createdAt: m.createdAt.toISOString(),
+        toolCallId: m.toolCallId,
+    }));
+    // Also fetch metrics if available (getRunMetrics may not exist on all impls)
+    let metrics;
+    try {
+        const rawMetrics = sh.getRunMetrics?.(resolvedId) ?? [];
+        metrics =
+            rawMetrics.length > 0
+                ? rawMetrics.map((rm) => ({
+                    turnCount: rm.turnCount,
+                    inputTokens: rm.inputTokens,
+                    outputTokens: rm.outputTokens,
+                    estimatedCost: rm.estimatedCost,
+                    wallTimeMs: rm.wallTimeMs,
+                }))
+                : undefined;
+    }
+    catch {
+        // Non-critical — metrics may not be available
+    }
+    const output = {
+        id: session.id,
+        arion: session.arion,
+        model: session.model,
+        messageCount: session.messages.length,
+        messages: formattedMessages,
+        metrics,
+    };
+    const truncNote = session.messages.length > messageLimit
+        ? ` (showing last ${messageLimit} of ${session.messages.length})`
+        : "";
+    return (0, utils_js_1.success)(`Session ${session.id.slice(0, 8)}… | ${session.arion} | ${session.model} | ${session.messages.length} messages${truncNote}`, output);
+}
+function executeCurrent(ctx, sh) {
+    if (!ctx.currentSessionId) {
+        return (0, utils_js_1.fail)("No current session ID available");
+    }
+    const output = {
+        sessionId: ctx.currentSessionId,
+    };
+    // Try to get session details if available
+    const session = sh.getSession(ctx.currentSessionId);
+    if (session) {
+        return (0, utils_js_1.success)(`Current session: ${session.id.slice(0, 8)}… | ${session.arion} | ${session.model} | ${session.messages.length} messages`, {
+            ...output,
+            arion: session.arion,
+            model: session.model,
+            messageCount: session.messages.length,
+        });
+    }
+    return (0, utils_js_1.success)(`Current session: ${ctx.currentSessionId}`, output);
+}
+function executeStats(sh) {
+    const totalSessions = sh.getSessionCount?.() ?? 0;
+    const incompleteSessions = (sh.getIncompleteSessions?.(1000) ?? []).length;
+    const output = {
+        totalSessions,
+        incompleteSessions,
+    };
+    return (0, utils_js_1.success)(`Session stats: ${totalSessions} total, ${incompleteSessions} incomplete, ${totalSessions - incompleteSessions} completed`, output);
+}
+function executeDelete(input, sh) {
+    if (!input.sessionId || input.sessionId.trim() === "") {
+        return (0, utils_js_1.fail)("sessionId is required for 'delete' action");
+    }
+    const resolvedId = resolveSessionId(sh, input.sessionId);
+    if (!resolvedId) {
+        return (0, utils_js_1.fail)(`Session not found for ID/prefix "${input.sessionId}"`);
+    }
+    sh.deleteSession(resolvedId);
+    return (0, utils_js_1.success)(`Deleted session ${resolvedId}`);
+}
+function executeSetTitle(input, sh) {
+    if (!input.sessionId || input.sessionId.trim() === "") {
+        return (0, utils_js_1.fail)("sessionId is required for 'set_title' action");
+    }
+    if (!input.title || input.title.trim() === "") {
+        return (0, utils_js_1.fail)("title is required for 'set_title' action");
+    }
+    const resolvedId = resolveSessionId(sh, input.sessionId);
+    if (!resolvedId) {
+        return (0, utils_js_1.fail)(`Session not found for ID/prefix "${input.sessionId}"`);
+    }
+    sh.setSessionTitle(resolvedId, input.title);
+    return (0, utils_js_1.success)(`Set title of session ${resolvedId.slice(0, 8)}… to "${input.title}"`);
+}
+//# sourceMappingURL=session-history.js.map

package/dist-cjs/executors/session-history.js.map

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

package/dist-cjs/executors/shell-safety.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @aria/tools - Shell command risk classifier
+ *
+ * Statically classifies shell commands into risk tiers to gate execution:
+ * - "safe"     : read-only, execute immediately without approval
+ * - "moderate" : requires runtime policy handling (approval, allowlist, or autorun)
+ * - "blocked"  : catastrophic, hard-denied — never execute
+ */
+export type ShellRisk = "safe" | "moderate" | "blocked";
+/** Patterns that are unconditionally blocked — catastrophic risk. */
+export declare const BLOCKED_PATTERNS: RegExp[];
+/**
+ * Classify a shell command's risk level.
+ *
+ * - "safe"     — skip approval, execute immediately
+ * - "moderate" — handle via runtime policy (approval, allowlist, or autorun)
+ * - "blocked"  — never execute, return error immediately
+ */
+export declare function classifyCommand(command: string): ShellRisk;
+/**
+ * Classify argv-based process execution (spawn/exec) with shell-aware behavior.
+ *
+ * When callers explicitly invoke a shell interpreter with `-c`, classify the
+ * payload command text itself. This preserves catastrophic-command blocking
+ * while avoiding false positives that would block every `bash -c ...` call.
+ */
+export declare function classifyExecInvocation(program: string, args?: string[]): ShellRisk;