@iinm/plain-agent 1.8.3 → 1.8.4

package/src/agentState.mjs

@@ -1,41 +0,0 @@
-/**
- * @import { Message } from "./model"
- */
-
-/**
- * @typedef {ReturnType<typeof createStateManager>} StateManager
- */
-
-/**
- * @typedef {Object} StateEventHandlers
- * @property {(messages: Message[]) => void} onMessagesAppended
- */
-
-/**
- * Creates a state manager for message handling.
- * @param {Message[]} initialMessages
- * @param {StateEventHandlers} handlers
- */
-export function createStateManager(initialMessages, handlers) {
-  /** @type {Message[]} */
-  let messages = [...initialMessages];
-
-  return {
-    /** Get all messages (immutable copy) */
-    getMessages: () => [...messages],
-
-    /** Get message at specific index (supports -1 for last) */
-    getMessageAt: /** @param {number} index */ (index) => messages.at(index),
-
-    /** Append messages */
-    appendMessages: /** @param {Message[]} newMessages */ (newMessages) => {
-      messages = [...messages, ...newMessages];
-      handlers.onMessagesAppended(newMessages);
-    },
-
-    /** Replace all messages */
-    setMessages: /** @param {Message[]} newMessages */ (newMessages) => {
-      messages = [...newMessages];
-    },
-  };
-}

package/src/claudeCodePlugin.mjs

@@ -1,164 +0,0 @@
-import { execFile } from "node:child_process";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { loadAppConfig } from "./config.mjs";
-import { CLAUDE_CODE_PLUGIN_DIR } from "./env.mjs";
-
-/**
- * @typedef {Object} ClaudeCodePluginRepo
- * @property {string} source
- * @property {Array<{name: string, path: string, only?: string}>} plugins
- */
-
-/**
- * @typedef {Object} ClaudeCodePlugin
- * @property {string} name
- * @property {string} path
- * @property {RegExp} [only]
- */
-
-/**
- * Resolve plugin paths from hierarchical config structure.
- * Converts {source, plugins} to flat {name, path, only} with full paths.
- * @param {ClaudeCodePluginRepo[]} repos
- * @returns {ClaudeCodePlugin[]}
- */
-export function resolvePluginPaths(repos) {
-  if (!repos) return [];
-
-  /** @type {ClaudeCodePlugin[]} */
-  const result = [];
-
-  for (const repo of repos) {
-    const ownerRepo = extractOwnerRepo(repo.source);
-    if (!ownerRepo) {
-      console.warn(`Invalid source URL: ${repo.source}`);
-      continue;
-    }
-
-    for (const plugin of repo.plugins) {
-      // Compile only pattern to RegExp
-      let only;
-      if (plugin.only) {
-        try {
-          only = new RegExp(plugin.only);
-        } catch (err) {
-          console.warn(
-            `Invalid regex pattern "${plugin.only}" for plugin "${plugin.name}":`,
-            err instanceof Error ? err.message : String(err),
-          );
-        }
-      }
-
-      result.push({
-        name: plugin.name,
-        path: path.join(CLAUDE_CODE_PLUGIN_DIR, ownerRepo, plugin.path),
-        only,
-      });
-    }
-  }
-
-  return result;
-}
-
-/**
- * Install Claude Code plugins by cloning repositories.
- */
-export async function installClaudeCodePlugins() {
-  const { appConfig } = await loadAppConfig({ skipTrustCheck: true });
-  const repos = appConfig.claudeCodePlugins ?? [];
-
-  if (repos.length === 0) {
-    console.log("No plugins configured.");
-    return;
-  }
-
-  let installed = 0;
-  let skipped = 0;
-  let failed = 0;
-
-  // Track paths for summary
-  /** @type {string[]} */
-  const installedPaths = [];
-  /** @type {string[]} */
-  const skippedPaths = [];
-
-  // Ensure plugin directory exists
-  await fs.mkdir(CLAUDE_CODE_PLUGIN_DIR, { recursive: true });
-
-  for (const repo of repos) {
-    const ownerRepo = extractOwnerRepo(repo.source);
-    if (!ownerRepo) {
-      console.error(`❌ Invalid source URL: ${repo.source}`);
-      failed++;
-      continue;
-    }
-
-    const destPath = path.join(CLAUDE_CODE_PLUGIN_DIR, ownerRepo);
-
-    // Check if already exists
-    const exists = await fs
-      .access(destPath)
-      .then(() => true)
-      .catch(() => false);
-    if (exists) {
-      console.log(`⏭️ Skipping ${repo.source} → ${destPath}: already installed`);
-      skippedPaths.push(destPath);
-      skipped++;
-      continue;
-    }
-
-    // Clone the repository
-    console.log(`📥 Installing ${repo.source}...`);
-    try {
-      await new Promise((resolve, reject) => {
-        execFile(
-          "git",
-          ["clone", "--depth", "1", repo.source, destPath],
-          (err) => {
-            if (err) reject(err);
-            else resolve(undefined);
-          },
-        );
-      });
-      console.log(`✅ Installed to ${destPath}`);
-      installedPaths.push(destPath);
-      installed++;
-    } catch (error) {
-      console.error(
-        `❌ Failed to install: ${error instanceof Error ? error.message : String(error)}`,
-      );
-      failed++;
-    }
-  }
-
-  console.log(
-    `\n📊 Summary: ${installed} installed, ${skipped} skipped, ${failed} failed`,
-  );
-
-  if (installedPaths.length > 0) {
-    console.log("\nInstalled:");
-    for (const p of installedPaths) {
-      console.log(`  • ${p}`);
-    }
-  }
-
-  if (skippedPaths.length > 0) {
-    console.log("\nSkipped:");
-    for (const p of skippedPaths) {
-      console.log(`  • ${p}`);
-    }
-  }
-}
-
-/**
- * Extract owner/repo from source URL.
- * @param {string} source
- * @returns {string|null}
- */
-function extractOwnerRepo(source) {
-  // Handle: https://github.com/owner/repo
-  // Handle: git@github.com:owner/repo.git
-  const match = source.match(/[:/]([^/]+\/[^/]+?)(?:\.git)?$/);
-  return match ? match[1] : null;
-}

package/src/cliArgs.mjs

@@ -1,175 +0,0 @@
-/**
- * @typedef {HelpSubcommand | InteractiveSubcommand | BatchSubcommand | ListModelsSubcommand | InstallClaudeCodePluginsSubcommand | CostSubcommand} Subcommand
- */
-
-/**
- * @typedef {{ type: 'help' }} HelpSubcommand
- */
-
-/**
- * @typedef {{ type: 'interactive', config: string[], model: string | null }} InteractiveSubcommand
- */
-
-/**
- * @typedef {{ type: 'batch', task: string, config: string[], model: string | null }} BatchSubcommand
- */
-
-/**
- * @typedef {{ type: 'list-models' }} ListModelsSubcommand
- */
-
-/**
- * @typedef {{ type: 'install-claude-code-plugins' }} InstallClaudeCodePluginsSubcommand
- */
-
-/**
- * @typedef {{ type: 'cost', from: string | null, to: string | null }} CostSubcommand
- */
-
-/**
- * @typedef {Object} CliArgs
- * @property {Subcommand} subcommand - The subcommand to execute
- */
-
-/**
- * Parse command-line arguments.
- * @param {string[]} argv - process.argv or similar
- * @returns {CliArgs}
- */
-export function parseCliArgs(argv) {
-  const args = argv.slice(2);
-  const subcommandName = args[0];
-
-  if (["-h", "--help", "help"].includes(subcommandName)) {
-    return {
-      subcommand: { type: "help" },
-    };
-  }
-
-  if (!subcommandName || subcommandName.startsWith("-")) {
-    // Interactive mode (default)
-    const config = [];
-    let model = null;
-
-    for (let i = 0; i < args.length; i++) {
-      if (args[i] === "-m" || args[i] === "--model") {
-        if (args[i + 1]) {
-          model = args[i + 1];
-          i++;
-        }
-      } else if (args[i] === "-c" || args[i] === "--config") {
-        if (args[i + 1]) {
-          config.push(args[i + 1]);
-          i++;
-        }
-      }
-    }
-
-    return {
-      subcommand: { type: "interactive", config, model },
-    };
-  }
-
-  if (subcommandName === "batch") {
-    const batchArgs = args.slice(1);
-
-    let task = null;
-    let model = null;
-    const config = [];
-
-    for (let i = 0; i < batchArgs.length; i++) {
-      if (batchArgs[i] === "-m" || batchArgs[i] === "--model") {
-        if (batchArgs[i + 1]) {
-          model = batchArgs[i + 1];
-          i++;
-        }
-      } else if (batchArgs[i] === "-c" || batchArgs[i] === "--config") {
-        if (batchArgs[i + 1]) {
-          config.push(batchArgs[i + 1]);
-          i++;
-        }
-      } else if (!batchArgs[i].startsWith("-") && !task) {
-        task = batchArgs[i];
-      }
-    }
-
-    return {
-      subcommand: { type: "batch", task: task || "", config, model },
-    };
-  }
-
-  if (subcommandName === "list-models") {
-    return {
-      subcommand: { type: "list-models" },
-    };
-  }
-
-  if (subcommandName === "install-claude-code-plugins") {
-    return {
-      subcommand: { type: "install-claude-code-plugins" },
-    };
-  }
-
-  if (subcommandName === "cost") {
-    const costArgs = args.slice(1);
-    let from = null;
-    let to = null;
-    for (let i = 0; i < costArgs.length; i++) {
-      if (costArgs[i] === "--from") {
-        if (costArgs[i + 1]) {
-          from = costArgs[i + 1];
-          i++;
-        }
-      } else if (costArgs[i] === "--to") {
-        if (costArgs[i + 1]) {
-          to = costArgs[i + 1];
-          i++;
-        }
-      }
-    }
-    return {
-      subcommand: { type: "cost", from, to },
-    };
-  }
-
-  return {
-    subcommand: { type: "help" },
-  };
-}
-
-/**
- * Print help message and exit.
- * @param {number} [exitCode] - Exit code (default: 0)
- */
-export function printHelp(exitCode = 0) {
-  console.log(`
-Usage: plain [options]
-       plain batch [options] <task>
-       plain cost [--from YYYY-MM-DD] [--to YYYY-MM-DD]
-       plain list-models
-       plain install-claude-code-plugins
-
-Options:
-  -m, --model <model+variant>  Model to use
-  -h, --help                   Show this help message
-  -c, --config <file>          Config file to load (repeatable)
-
-Subcommands:
-  batch <task>                 Run in batch mode with the given task instruction.
-                               Config files are NOT auto-loaded in batch mode;
-                               use -c to specify config files explicitly.
-  cost                         Show aggregated token cost per day for a period.
-                               Defaults to the first day of the current month
-                               through today.
-  list-models                  List available models
-  install-claude-code-plugins  Install Claude Code plugins
-
-Examples:
-  plain -m gpt-5.4+thinking-medium
-  plain batch \\
-        -c ~/.config/plain-agent/config.local.json \\
-        -c .plain-agent/config.json \\
-        "Add tests for ..."
-`);
-  process.exit(exitCode);
-}

package/src/cliBatch.mjs

@@ -1,147 +0,0 @@
-/**
- * @import { UserEventEmitter, AgentEventEmitter, AgentCommands } from "./agent"
- */
-
-import { formatCostForBatch } from "./cliFormatter.mjs";
-import { appendUsageRecord, buildUsageRecord } from "./usageStore.mjs";
-
-/**
- * @typedef {object} BatchSessionOptions
- * @property {UserEventEmitter} userEventEmitter
- * @property {AgentEventEmitter} agentEventEmitter
- * @property {AgentCommands} agentCommands
- * @property {string} task - Task instruction to execute
- * @property {string} sessionId
- * @property {string} modelName
- * @property {boolean} sandbox
- * @property {Date} startTime
- * @property {() => Promise<void>} onStop
- */
-
-/**
- * Start a batch session and execute the task.
- * Events are output as JSON Lines (1 line = 1 JSON object).
- *
- * @param {BatchSessionOptions} options
- * @returns {Promise<void>}
- */
-export async function startBatchSession({
-  userEventEmitter,
-  agentEventEmitter,
-  agentCommands,
-  task,
-  sessionId,
-  modelName,
-  sandbox,
-  startTime,
-  onStop,
-}) {
-  setupEventHandlers(agentEventEmitter, { sessionId, modelName, sandbox });
-
-  userEventEmitter.emit("userInput", [{ type: "text", text: task }]);
-
-  await new Promise((/** @type {(value?: void) => void} */ resolve) => {
-    agentEventEmitter.on("turnEnd", async () => {
-      const costSummary = agentCommands.getCostSummary();
-
-      outputEvent({
-        type: "session_end",
-        timestamp: new Date().toISOString(),
-        cost: formatCostForBatch(costSummary),
-      });
-
-      try {
-        const record = buildUsageRecord({
-          sessionId,
-          mode: "batch",
-          modelName,
-          workingDir: process.cwd(),
-          costSummary,
-          now: startTime,
-        });
-        if (record) {
-          await appendUsageRecord(record);
-        }
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        outputEvent({
-          type: "error",
-          error: { message: `failed to record usage: ${message}` },
-          timestamp: new Date().toISOString(),
-        });
-      }
-
-      await onStop();
-      resolve();
-    });
-  });
-
-  process.exit(0);
-}
-
-/**
- * Setup event handlers for batch mode.
- * Output events as JSON Lines.
- *
- * @param {AgentEventEmitter} agentEventEmitter
- * @param {{ sessionId: string, modelName: string, sandbox: boolean }} meta
- */
-function setupEventHandlers(
-  agentEventEmitter,
-  { sessionId, modelName, sandbox },
-) {
-  outputEvent({
-    type: "session_start",
-    sessionId,
-    modelName,
-    sandbox,
-    timestamp: new Date().toISOString(),
-  });
-
-  agentEventEmitter.on("message", (message) => {
-    outputEvent({
-      type: "message",
-      message,
-      timestamp: new Date().toISOString(),
-    });
-  });
-
-  agentEventEmitter.on("error", (error) => {
-    outputEvent({
-      type: "error",
-      error: {
-        message: error.message,
-        stack: error.stack,
-      },
-      timestamp: new Date().toISOString(),
-    });
-
-    process.exit(1);
-  });
-
-  agentEventEmitter.on("subagentSwitched", (subagent) => {
-    outputEvent({
-      type: "subagent_switched",
-      subagent,
-      timestamp: new Date().toISOString(),
-    });
-  });
-
-  agentEventEmitter.on("providerTokenUsage", (usage) => {
-    outputEvent({
-      type: "token_usage",
-      usage,
-      timestamp: new Date().toISOString(),
-    });
-  });
-}
-
-/**
- * Output an event as JSON Lines format.
- * Each event is a single line of JSON.
- *
- * @param {object} event
- */
-function outputEvent(event) {
-  console.log(JSON.stringify(event));
-}