longer-agent 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for LongerAgent.
+ *
+ * Usage:
+ *
+ *   longeragent                       # auto-detect config
+ *   longeragent init                  # run initialization wizard
+ *   longeragent --config my.yaml      # explicit config path
+ *   longeragent --templates ./tpls    # explicit templates path
+ *   longeragent --verbose             # enable debug logging
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}

package/dist/cli.js

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for LongerAgent.
+ *
+ * Usage:
+ *
+ *   longeragent                       # auto-detect config
+ *   longeragent init                  # run initialization wizard
+ *   longeragent --config my.yaml      # explicit config path
+ *   longeragent --templates ./tpls    # explicit templates path
+ *   longeragent --verbose             # enable debug logging
+ */
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { Command } from "commander";
+import { Config, resolveConfigPaths, getBundledAssetsDir } from "./config.js";
+import { Session } from "./session.js";
+import { loadTemplates } from "./templates/loader.js";
+import { loadSkillsMulti } from "./skills/loader.js";
+import { SessionStore } from "./persistence.js";
+import { loadSettingsFile, resolveSettings } from "./settings.js";
+import { buildDefaultRegistry, registerSkillCommands, resolveModelSelection, } from "./commands.js";
+import { setAccent } from "./tui/theme.js";
+// ------------------------------------------------------------------
+// Primary agent resolution
+// ------------------------------------------------------------------
+function identifyPrimaryAgent(agents, name = "main") {
+    const agent = agents[name];
+    if (agent)
+        return agent;
+    // Fallback: first agent alphabetically
+    const names = Object.keys(agents).sort();
+    if (names.length > 0) {
+        const firstName = names[0];
+        console.warn(`Warning: '${name}' agent not found, using '${firstName}' instead.`);
+        return agents[firstName];
+    }
+    console.error("Error: no agent templates found.");
+    process.exit(1);
+}
+// ------------------------------------------------------------------
+// Main
+// ------------------------------------------------------------------
+async function main() {
+    const program = new Command();
+    program
+        .name("longeragent")
+        .description("A terminal AI coding agent built for long sessions")
+        .option("--config <path>", "Path to config.yaml")
+        .option("--templates <path>", "Path to agent_templates directory")
+        .option("--verbose", "Enable debug logging");
+    // Subcommands
+    let ranSubcommand = false;
+    program
+        .command("init")
+        .description("Initialize LongerAgent configuration")
+        .action(async () => {
+        ranSubcommand = true;
+        const { runInitWizard } = await import("./init-wizard.js");
+        await runInitWizard();
+    });
+    program
+        .command("oauth [action]")
+        .description("Manage OpenAI ChatGPT OAuth login (login/status/logout)")
+        .action(async (action) => {
+        ranSubcommand = true;
+        const { oauthCommand } = await import("./auth/openai-oauth.js");
+        await oauthCommand(action);
+    });
+    // Default action — prevents Commander from showing help and exiting
+    // when no subcommand is provided.
+    program.action(() => { });
+    await program.parseAsync(process.argv);
+    // If a subcommand ran, exit — don't continue into TUI
+    if (ranSubcommand)
+        return;
+    const opts = program.opts();
+    // Logging
+    if (opts.verbose) {
+        const origDebug = console.debug;
+        console.debug = (...args) => origDebug("[DEBUG]", ...args);
+    }
+    // Resolve paths with discovery chain: CLI flags → ~/.longeragent/ → cwd/
+    let paths = resolveConfigPaths({
+        configFlag: opts.config,
+        templatesFlag: opts.templates,
+    });
+    // If no config found, run the initialization wizard
+    if (!paths.configPath) {
+        console.log("No configuration found. Starting setup wizard...\n");
+        try {
+            const { runInitWizard } = await import("./init-wizard.js");
+            await runInitWizard();
+            // Re-resolve paths after wizard completes
+            paths = resolveConfigPaths({
+                configFlag: opts.config,
+                templatesFlag: opts.templates,
+            });
+        }
+        catch {
+            console.error("Error: no config.yaml found.\n" +
+                "  Run 'longeragent init' to set up, or use --config to specify the path.");
+            process.exit(1);
+        }
+    }
+    if (!paths.configPath) {
+        console.error("Error: no config.yaml found after setup.\n" +
+            "  Run 'longeragent init' to set up, or use --config to specify the path.");
+        process.exit(1);
+    }
+    const configPath = paths.configPath;
+    // Load config
+    const config = new Config({ path: configPath });
+    // Refresh OAuth tokens if any model uses them (before building providers)
+    const oauthEntries = config.listModelEntries().filter((e) => e.apiKeyRaw === "oauth:openai-codex");
+    if (oauthEntries.length > 0) {
+        try {
+            const { ensureFreshToken } = await import("./auth/openai-oauth.js");
+            await ensureFreshToken();
+        }
+        catch (err) {
+            console.warn(`Warning: OAuth token refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+            console.warn("Run 'longeragent oauth' to re-authenticate.\n");
+        }
+    }
+    // Load user settings (~/.longeragent/settings.json)
+    const rawSettings = loadSettingsFile(paths.homeDir);
+    const settings = resolveSettings(rawSettings);
+    // Display settings warnings (invalid thresholds, clamped values, etc.)
+    for (const warning of settings.warnings) {
+        console.warn(`Warning: ${warning}`);
+    }
+    // Initialise MCP client manager (if mcp_servers configured)
+    let mcpManager = null;
+    if (config.mcpServerConfigs.length > 0) {
+        try {
+            // Dynamic import to keep MCP optional
+            const { MCPClientManager } = await import("./mcp-client.js");
+            mcpManager = new MCPClientManager(config.mcpServerConfigs);
+        }
+        catch {
+            console.warn("Warning: mcp_servers configured but MCP client module not available. " +
+                "Install with: npm install @modelcontextprotocol/sdk");
+        }
+    }
+    // Bundled assets (always available from the installed package)
+    const bundledDir = getBundledAssetsDir();
+    const bundledTemplates = join(bundledDir, "agent_templates");
+    const bundledPrompts = join(bundledDir, "prompts");
+    // Build ordered prompts dirs: user override first, bundled second
+    const promptsDirs = [];
+    if (paths.promptsPath)
+        promptsDirs.push(paths.promptsPath);
+    promptsDirs.push(bundledPrompts);
+    // Load agent templates (bundled + user override, with layered prompt assembly)
+    const agents = loadTemplates(bundledTemplates, config, mcpManager, promptsDirs, paths.templatesPath ?? undefined);
+    const primary = identifyPrimaryAgent(agents);
+    // Load skills (user overrides layered on top of bundled defaults).
+    const bundledSkills = join(bundledDir, "skills");
+    const skillRoots = [];
+    if (existsSync(bundledSkills) && statSync(bundledSkills).isDirectory()) {
+        skillRoots.push(bundledSkills);
+    }
+    const userSkillsPath = paths.skillsPath;
+    if (userSkillsPath &&
+        userSkillsPath !== bundledSkills &&
+        existsSync(userSkillsPath) &&
+        statSync(userSkillsPath).isDirectory()) {
+        skillRoots.push(userSkillsPath);
+    }
+    const skills = loadSkillsMulti(skillRoots);
+    // Session store (session directory is created lazily on the first turn)
+    let store;
+    try {
+        store = new SessionStore({ projectPath: process.cwd() });
+    }
+    catch (e) {
+        console.error(`Error: Failed to initialize session storage.\n` +
+            `Reason: ${e}\n` +
+            `Possible causes:\n` +
+            `  - Invalid LONGERAGENT_HOME configuration\n` +
+            `  - File permission issues`);
+        process.exit(1);
+    }
+    // Build Session with store attached from the start
+    const session = new Session({
+        primaryAgent: primary,
+        config,
+        agentTemplates: agents,
+        skills: skills,
+        skillRoots,
+        progress: undefined,
+        mcpManager: mcpManager,
+        promptsDirs,
+        store: store,
+        settings,
+    });
+    const globalPreferences = store.loadGlobalPreferences();
+    try {
+        if (globalPreferences.modelConfigName) {
+            try {
+                session.switchModel(globalPreferences.modelConfigName);
+                session.setPersistedModelSelection?.({
+                    modelConfigName: globalPreferences.modelConfigName,
+                    modelProvider: globalPreferences.modelProvider,
+                    modelSelectionKey: globalPreferences.modelSelectionKey,
+                    modelId: globalPreferences.modelId,
+                });
+            }
+            catch {
+                if (globalPreferences.modelProvider && (globalPreferences.modelSelectionKey || globalPreferences.modelId)) {
+                    const restored = resolveModelSelection(session, `${globalPreferences.modelProvider}:${globalPreferences.modelSelectionKey ?? globalPreferences.modelId}`);
+                    session.switchModel(restored.selectedConfigName);
+                    session.setPersistedModelSelection?.({
+                        modelConfigName: restored.selectedConfigName,
+                        modelProvider: restored.modelProvider,
+                        modelSelectionKey: restored.modelSelectionKey,
+                        modelId: restored.modelId,
+                    });
+                }
+            }
+        }
+        else if (globalPreferences.modelProvider && (globalPreferences.modelSelectionKey || globalPreferences.modelId)) {
+            const restored = resolveModelSelection(session, `${globalPreferences.modelProvider}:${globalPreferences.modelSelectionKey ?? globalPreferences.modelId}`);
+            session.switchModel(restored.selectedConfigName);
+            session.setPersistedModelSelection?.({
+                modelConfigName: restored.selectedConfigName,
+                modelProvider: restored.modelProvider,
+                modelSelectionKey: restored.modelSelectionKey,
+                modelId: restored.modelId,
+            });
+        }
+    }
+    catch (err) {
+        console.warn(`Warning: failed to restore saved model preference: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    session.applyGlobalPreferences(globalPreferences);
+    if (globalPreferences.accentColor) {
+        setAccent(globalPreferences.accentColor);
+    }
+    // Commands
+    const commandRegistry = buildDefaultRegistry();
+    registerSkillCommands(commandRegistry, session.skills);
+    // Launch TUI
+    const { launchTui } = await import("./tui/launch.js");
+    await launchTui(session, commandRegistry, store, {
+        verbose: opts.verbose,
+    });
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Extensible slash-command system.
+ *
+ * Usage:
+ *
+ *   const registry = buildDefaultRegistry();
+ *   const cmd = registry.lookup("/help");
+ *   if (cmd) {
+ *     await cmd.handler(ctx, "");
+ *   }
+ */
+import type { SessionStore } from "./persistence.js";
+import { type SkillMeta } from "./skills/loader.js";
+/**
+ * Callback used by command handlers to display a message to the user.
+ * The TUI layer supplies the concrete implementation.
+ */
+export type ShowMessageFn = (text: string) => void;
+/**
+ * Context passed to every command handler.
+ *
+ * Uses a generic interface so command handlers don't need direct TUI imports.
+ */
+export interface CommandContext {
+    /** The active Session instance (typed as `any` to avoid circular deps). */
+    session: any;
+    /** Display a message in the conversation area. */
+    showMessage: ShowMessageFn;
+    /** The SessionStore for persistence (may be undefined). */
+    store?: SessionStore;
+    /** Auto-save the current session (TUI provides the implementation). */
+    autoSave: () => void;
+    /** Reset TUI state (cancel workers, clear spinners, etc.). */
+    resetUiState: () => void;
+    /** The command registry itself, so /help can enumerate commands. */
+    commandRegistry: CommandRegistry;
+    /** Request TUI-layer graceful exit. */
+    exit?: () => Promise<void> | void;
+    /** Inject content as a user message and trigger a new turn. */
+    onTurnRequested?: (content: string) => void;
+    /** Trigger a manual summarize request through the TUI turn pipeline. */
+    onManualSummarizeRequested?: (instruction: string) => void;
+    /** Trigger a manual compact request through the TUI execution pipeline. */
+    onManualCompactRequested?: (instruction: string) => void;
+}
+/**
+ * An option entry for command overlays.
+ */
+export interface CommandOption {
+    /** Display label shown in the overlay. */
+    label: string;
+    /** Value submitted as the command argument when selected. */
+    value: string;
+    /** Child options for hierarchical selection (e.g., provider → model). */
+    children?: CommandOption[];
+    /** Checked state for checkbox picker mode. */
+    checked?: boolean;
+}
+/** Context available when building dynamic picker options for a slash command. */
+export interface CommandOptionsContext {
+    session: any;
+    store?: SessionStore;
+}
+/**
+ * A single slash command.
+ */
+export interface SlashCommand {
+    /** The command name, e.g. "/resume". */
+    name: string;
+    /** Short description shown in /help output. */
+    description: string;
+    /** Async handler invoked when the command is executed. */
+    handler: (ctx: CommandContext, args: string) => Promise<void>;
+    /**
+     * Optional callback that returns dynamic overlay options for this command.
+     * When present, typing the command shows an option picker overlay.
+     * Receives session/store context so it can compute dynamic picker options.
+     */
+    options?: (ctx: CommandOptionsContext) => CommandOption[];
+    /** When true, TUI uses a checkbox multi-select picker instead of single-select. */
+    checkboxMode?: boolean;
+}
+export declare class CommandExitSignal extends Error {
+    code: number;
+    constructor(code?: number);
+}
+export declare function isCommandExitSignal(err: unknown): err is CommandExitSignal;
+export declare class CommandRegistry {
+    private _commands;
+    /** Register a command. Overwrites any existing command with the same name. */
+    register(cmd: SlashCommand): void;
+    /** Remove a command by its exact name. Returns true if it existed. */
+    unregister(name: string): boolean;
+    /** Look up a command by its exact name. */
+    lookup(name: string): SlashCommand | undefined;
+    /** Return all registered commands sorted alphabetically by name. */
+    getAll(): SlashCommand[];
+    /** Return command names that start with the given prefix (for completion). */
+    getCompletions(prefix: string): string[];
+}
+export declare function resolveModelSelection(session: any, target: string, apiKey?: string): import("./model-selection.js").ResolvedModelSelection;
+/**
+ * Build the default command registry with all built-in commands.
+ */
+export declare function buildDefaultRegistry(): CommandRegistry;
+/**
+ * Register slash commands for user-invocable skills.
+ *
+ * Each skill with `userInvocable === true` gets a `/skill-name` command.
+ * When invoked, the skill content is injected and a turn is triggered.
+ */
+export declare function registerSkillCommands(registry: CommandRegistry, skills: ReadonlyMap<string, SkillMeta>): void;
+/**
+ * Unregister old skill commands, then register new ones.
+ * Used after reloadSkills() to keep slash commands in sync.
+ */
+export declare function reRegisterSkillCommands(registry: CommandRegistry, oldSkills: ReadonlyMap<string, SkillMeta>, newSkills: ReadonlyMap<string, SkillMeta>): void;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

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