@a3t/rapid-core 0.1.12 → 0.1.14

package/dist/index.d.ts

@@ -10,6 +10,14 @@ interface RapidConfig {
     agents: AgentsConfig;
     context?: ContextConfig;
     mcp?: McpConfig;
+    lima?: LimaConfig;
+}
+/**
+ * Lima VM configuration
+ */
+interface LimaConfig {
+    /** Install GitHub CLI (gh) in the VM (default: true) */
+    installGh?: boolean;
 }
 interface ContainerConfig {
     devcontainer?: string;
@@ -90,14 +98,26 @@ interface McpConfig {
     configFile?: string;
     servers?: Record<string, McpServerConfig>;
 }
+/**
+ * MCP transport types following the MCP specification.
+ * - 'stdio': Local subprocess communication (MCP spec standard)
+ * - 'streamable-http': Remote HTTP communication (MCP spec standard, replaces deprecated SSE)
+ * - 'remote': Alias for 'streamable-http' (user-friendly, backwards compatible)
+ */
+type McpTransportType = 'stdio' | 'streamable-http' | 'remote';
 interface McpServerConfig {
     /** Enable this MCP server (default: true) */
     enabled?: boolean;
-    /** Server type: remote HTTP or local stdio */
-    type?: 'remote' | 'stdio';
-    /** URL for remote servers */
+    /**
+     * Server transport type (MCP spec naming):
+     * - 'stdio': Local subprocess (command + args)
+     * - 'streamable-http': Remote HTTP server (url + headers)
+     * - 'remote': Alias for 'streamable-http' (backwards compatible)
+     */
+    type?: McpTransportType;
+    /** URL for remote/streamable-http servers */
     url?: string;
-    /** HTTP headers for remote servers */
+    /** HTTP headers for remote/streamable-http servers */
     headers?: Record<string, string>;
     /** Command for stdio servers */
     command?: string;
@@ -212,6 +232,8 @@ declare function buildAgentArgs(agent: AgentDefinition, options?: {
     compactPrompt?: boolean;
     /** Custom system prompt to use instead of default RAPID methodology */
     customPrompt?: string;
+    /** Additional context content to append to the system prompt */
+    contextContent?: string;
 }): string[];
 /**
  * Check if an agent reads instruction files from the filesystem.
@@ -639,7 +661,7 @@ declare function getSecretReferences(templateNames: string[]): Record<string, st
  */
 interface McpServerDefinition extends McpServerConfig {
     enabled?: boolean;
-    type?: 'remote' | 'stdio';
+    type?: 'remote' | 'stdio' | 'streamable-http';
     url?: string;
     headers?: Record<string, string>;
     command?: string;
@@ -648,6 +670,7 @@ interface McpServerDefinition extends McpServerConfig {
 }
 /**
  * MCP server info for display
+ * Note: 'streamable-http' is normalized to 'remote' for display purposes
  */
 interface McpServerInfo {
     name: string;
@@ -691,10 +714,11 @@ interface OpenCodeConfig {
     instructions?: string[];
 }
 /**
- * OpenCode MCP entry format
+ * OpenCode MCP entry format.
+ * OpenCode uses 'local' for stdio and 'remote' for HTTP servers.
  */
 interface OpenCodeMcpEntry {
-    type: 'remote' | 'stdio';
+    type: 'local' | 'remote';
     url?: string | undefined;
     headers?: Record<string, string> | undefined;
     command?: string | undefined;
@@ -730,11 +754,22 @@ declare function enableMcpServer(config: RapidConfig, name: string): RapidConfig
  */
 declare function disableMcpServer(config: RapidConfig, name: string): RapidConfig;
 /**
- * Generate .mcp.json config from rapid.json mcp section
+ * Generate .mcp.json config from rapid.json mcp section.
+ *
+ * Output format follows Claude Code conventions:
+ * - 'stdio' servers use type: 'stdio' with command/args/env
+ * - Remote servers (type: 'remote' or 'streamable-http') use type: 'http' with url/headers
+ *
+ * Note: Claude Code uses 'http' instead of MCP spec's 'streamable-http' for simplicity.
  */
 declare function generateMcpConfig(config: RapidConfig): GeneratedMcpConfig;
 /**
- * Generate opencode.json config format
+ * Generate opencode.json config format.
+ *
+ * Output format follows OpenCode conventions:
+ * - 'stdio' servers use type: 'local' with command/args/env
+ * - Remote servers (type: 'remote' or 'streamable-http') use type: 'remote' with url/headers
+ * - Environment variables use {env:VAR} format instead of ${VAR}
  */
 declare function generateOpenCodeConfig(config: RapidConfig): OpenCodeConfig;
 /**
@@ -758,4 +793,97 @@ declare function readMcpConfig(rootDir: string, config?: RapidConfig): Promise<G
  */
 declare function getMcpConfigPath(rootDir: string, config?: RapidConfig): string;
 
-export { type AgentDefinition, type AgentStatus, type AgentsConfig, type AuthStatus, CODE_EDITING_GUIDELINES, COMMUNICATION_GUIDELINES, type ContainerConfig, type ContainerStatus, type ContextConfig, DEBUGGING_GUIDELINES, type DetectedCredential, type DevcontainerConfig, type DotenvConfig, type EnvironmentStatus, type EnvrcConfig, type ExternalAuthConfig, type ExternalAuthSource, GIT_GUIDELINES, type GeneratedMcpConfig, type LoadedConfig, type LogLevel, MCP_SERVER_TEMPLATES, MCP_USAGE_GUIDELINES, type McpConfig, type McpServerConfig, type McpServerDefinition, type McpServerEntry, type McpServerInfo, type McpServerStatus, type McpServerTemplate, type OpAuthStatus, type OpenCodeConfig, type OpenCodeMcpEntry, RAPID_METHODOLOGY, RAPID_METHODOLOGY_COMPACT, RAPID_PHASES, type RapidConfig, type RapidPhase, type SecretStatus, type SecretsConfig, type SecretsStatus, addMcpServer, addMcpServerFromTemplate, agentReadsInstructionFiles, agentSupportsRuntimeInjection, buildAgentArgs, checkAgentAvailable, checkAllAgents, detectAiderAuth, detectAllCredentials, detectClaudeCodeAuth, detectCodexAuth, detectEnvAuth, detectGeminiAuth, disableMcpServer, enableMcpServer, execInContainer, formatAuthStatus, generateEnvrc, generateFullSystemPrompt, generateMcpConfig, generateOpenCodeConfig, generateRapidMethodology, getAgent, getAuthEnvironment, getAuthStatus, getContainerName, getContainerStatus, getCredentialsForProvider, getDefaultAgent, getDefaultConfig, getDevcontainerPath, getEasySetupTemplates, getLogLevel, getMcpConfigPath, getMcpServerStatus, getMcpServers, getMcpTemplate, getMcpTemplateNames, getOpAuthStatus, getProviderInfo, getRequiredSecrets, getSecretReferences, getStandardAgentInstructions, hasDevcontainerCli, hasDocker, hasEnvrc, hasMcpConfig, hasOpCli, hasOpServiceAccountToken, hasVaultCli, isOpAuthenticated, isVaultAuthenticated, launchAgent, loadConfig, loadConfigFromFile, loadDevcontainerConfig, loadSecrets, logger, mergeWithDefaults, readEnvrc, readMcpConfig, readOpSecret, readVaultSecret, removeMcpServer, setLogLevel, startContainer, stopContainer, verifySecret, verifySecrets, writeEnvrc, writeMcpConfig, writeOpenCodeConfig };
+/**
+ * JSON formatting utilities using Prettier
+ */
+/**
+ * Format JSON using Prettier for consistent output
+ * @param data - The data to format as JSON
+ * @returns Formatted JSON string with trailing newline
+ */
+declare function formatJson(data: unknown): Promise<string>;
+/**
+ * Synchronous JSON formatting (fallback to JSON.stringify if prettier fails)
+ * @param data - The data to format as JSON
+ * @returns Formatted JSON string with trailing newline
+ */
+declare function formatJsonSync(data: unknown): string;
+
+/**
+ * Context file assembly for AI agents
+ *
+ * Reads and assembles context from files and directories specified in rapid.json,
+ * then formats it for injection into agent system prompts.
+ */
+
+/**
+ * Result of reading a context file
+ */
+interface ContextFileResult {
+    path: string;
+    relativePath: string;
+    content: string;
+    size: number;
+    truncated: boolean;
+}
+/**
+ * Information about a skipped file
+ */
+interface SkippedFile {
+    path: string;
+    reason: 'missing' | 'binary' | 'too-large' | 'excluded' | 'directory' | 'error';
+    error?: string;
+}
+/**
+ * Result of assembling all context files
+ */
+interface AssembledContext {
+    files: ContextFileResult[];
+    totalSize: number;
+    skippedFiles: SkippedFile[];
+    content: string;
+}
+/**
+ * Options for context assembly
+ */
+interface ContextAssemblyOptions {
+    /** Maximum size per file in bytes (default: 100KB) */
+    maxFileSize?: number;
+    /** Maximum total size in bytes (default: 500KB) */
+    maxTotalSize?: number;
+    /** Whether to include file headers with paths (default: true) */
+    includeHeaders?: boolean;
+    /** File extensions to treat as binary (in addition to built-in list) */
+    binaryExtensions?: string[];
+}
+/**
+ * Check if a file path matches any exclude patterns
+ */
+declare function matchesExcludePattern(relativePath: string, excludePatterns: string[]): boolean;
+/**
+ * Check if a file is likely binary based on extension
+ */
+declare function isBinaryFile(filepath: string, additionalExtensions?: string[]): boolean;
+/**
+ * Read a single context file with safety checks
+ */
+declare function readContextFile(filepath: string, rootDir: string, options?: ContextAssemblyOptions): Promise<ContextFileResult | SkippedFile>;
+/**
+ * Recursively read files from a directory
+ */
+declare function readContextDirectory(dirPath: string, rootDir: string, excludePatterns: string[], options?: ContextAssemblyOptions): Promise<{
+    files: ContextFileResult[];
+    skipped: SkippedFile[];
+}>;
+/**
+ * Assemble all context files from configuration
+ */
+declare function assembleContext(rootDir: string, config: ContextConfig, options?: ContextAssemblyOptions): Promise<AssembledContext>;
+/**
+ * Format assembled context as a string for injection
+ */
+declare function formatContextContent(files: ContextFileResult[], options?: {
+    includeHeaders?: boolean;
+}): string;
+
+export { type AgentDefinition, type AgentStatus, type AgentsConfig, type AssembledContext, type AuthStatus, CODE_EDITING_GUIDELINES, COMMUNICATION_GUIDELINES, type ContainerConfig, type ContainerStatus, type ContextAssemblyOptions, type ContextConfig, type ContextFileResult, DEBUGGING_GUIDELINES, type DetectedCredential, type DevcontainerConfig, type DotenvConfig, type EnvironmentStatus, type EnvrcConfig, type ExternalAuthConfig, type ExternalAuthSource, GIT_GUIDELINES, type GeneratedMcpConfig, type LoadedConfig, type LogLevel, MCP_SERVER_TEMPLATES, MCP_USAGE_GUIDELINES, type McpConfig, type McpServerConfig, type McpServerDefinition, type McpServerEntry, type McpServerInfo, type McpServerStatus, type McpServerTemplate, type McpTransportType, type OpAuthStatus, type OpenCodeConfig, type OpenCodeMcpEntry, RAPID_METHODOLOGY, RAPID_METHODOLOGY_COMPACT, RAPID_PHASES, type RapidConfig, type RapidPhase, type SecretStatus, type SecretsConfig, type SecretsStatus, type SkippedFile, addMcpServer, addMcpServerFromTemplate, agentReadsInstructionFiles, agentSupportsRuntimeInjection, assembleContext, buildAgentArgs, checkAgentAvailable, checkAllAgents, detectAiderAuth, detectAllCredentials, detectClaudeCodeAuth, detectCodexAuth, detectEnvAuth, detectGeminiAuth, disableMcpServer, enableMcpServer, execInContainer, formatAuthStatus, formatContextContent, formatJson, formatJsonSync, generateEnvrc, generateFullSystemPrompt, generateMcpConfig, generateOpenCodeConfig, generateRapidMethodology, getAgent, getAuthEnvironment, getAuthStatus, getContainerName, getContainerStatus, getCredentialsForProvider, getDefaultAgent, getDefaultConfig, getDevcontainerPath, getEasySetupTemplates, getLogLevel, getMcpConfigPath, getMcpServerStatus, getMcpServers, getMcpTemplate, getMcpTemplateNames, getOpAuthStatus, getProviderInfo, getRequiredSecrets, getSecretReferences, getStandardAgentInstructions, hasDevcontainerCli, hasDocker, hasEnvrc, hasMcpConfig, hasOpCli, hasOpServiceAccountToken, hasVaultCli, isBinaryFile, isOpAuthenticated, isVaultAuthenticated, launchAgent, loadConfig, loadConfigFromFile, loadDevcontainerConfig, loadSecrets, logger, matchesExcludePattern, mergeWithDefaults, readContextDirectory, readContextFile, readEnvrc, readMcpConfig, readOpSecret, readVaultSecret, removeMcpServer, setLogLevel, startContainer, stopContainer, verifySecret, verifySecrets, writeEnvrc, writeMcpConfig, writeOpenCodeConfig };

package/dist/index.js

@@ -74,6 +74,9 @@ function getDefaultConfig() {
       files: ["README.md"],
       dirs: ["docs/"],
       generateAgentFiles: true
+    },
+    lima: {
+      installGh: true
     }
   };
 }
@@ -97,6 +100,10 @@ function mergeWithDefaults(config) {
     context: {
       ...defaults.context,
       ...config.context
+    },
+    lima: {
+      ...defaults.lima,
+      ...config.lima
     }
   };
 }
@@ -1003,7 +1010,10 @@ function buildAgentArgs(agent, options) {
   if (options?.compactPrompt) {
     instructionOptions.compact = true;
   }
-  const promptContent = options?.customPrompt ?? getStandardAgentInstructions(instructionOptions);
+  let promptContent = options?.customPrompt ?? getStandardAgentInstructions(instructionOptions);
+  if (options?.contextContent) {
+    promptContent = promptContent + "\n\n" + options.contextContent;
+  }
   const pattern = agent.systemPromptArg;
   if (pattern.includes("{prompt}")) {
     const parts = pattern.split(/\s+/);
@@ -1675,7 +1685,24 @@ function getSecretReferences(templateNames) {
   return refs;
 }
 
+// src/format.ts
+import prettier from "prettier";
+async function formatJson(data) {
+  const json = JSON.stringify(data);
+  return prettier.format(json, {
+    parser: "json",
+    printWidth: 80,
+    tabWidth: 2
+  });
+}
+function formatJsonSync(data) {
+  return JSON.stringify(data, null, 2) + "\n";
+}
+
 // src/mcp.ts
+function isRemoteType(type) {
+  return type === "remote" || type === "streamable-http";
+}
 function getMcpServers(config) {
   const servers = [];
   if (!config.mcp?.servers) {
@@ -1687,10 +1714,12 @@ function getMcpServers(config) {
     }
     const def = serverConfig;
     const template = getMcpTemplate(name);
+    const rawType = def.type ?? template?.type ?? "stdio";
+    const displayType = isRemoteType(rawType) ? "remote" : "stdio";
     servers.push({
       name,
       enabled: def.enabled !== false,
-      type: def.type ?? template?.type ?? "stdio",
+      type: displayType,
       url: def.url ?? template?.url,
       command: def.command ?? template?.command,
       template: template ? name : void 0
@@ -1812,7 +1841,7 @@ function generateMcpConfig(config) {
     const template = getMcpTemplate(name);
     const entry = {};
     const type = def.type ?? template?.type ?? "stdio";
-    if (type === "remote") {
+    if (isRemoteType(type)) {
       entry.type = "http";
       entry.url = def.url ?? template?.url;
       entry.headers = def.headers ?? template?.headers;
@@ -1850,10 +1879,11 @@ function generateOpenCodeConfig(config) {
     }
     const template = getMcpTemplate(name);
     const type = def.type ?? template?.type ?? "stdio";
+    const openCodeType = isRemoteType(type) ? "remote" : "local";
     const entry = {
-      type
+      type: openCodeType
     };
-    if (type === "remote") {
+    if (isRemoteType(type)) {
       entry.url = def.url ?? template?.url;
       const headers = def.headers ?? template?.headers;
       if (headers) {
@@ -1878,12 +1908,12 @@ async function writeMcpConfig(rootDir, config) {
   const mcpConfig = generateMcpConfig(config);
   const configFile = config.mcp?.configFile ?? ".mcp.json";
   const configPath = isAbsolute(configFile) ? configFile : join4(rootDir, configFile);
-  await writeFile2(configPath, JSON.stringify(mcpConfig, null, 2) + "\n", "utf-8");
+  await writeFile2(configPath, await formatJson(mcpConfig), "utf-8");
 }
 async function writeOpenCodeConfig(rootDir, config) {
   const openCodeConfig = generateOpenCodeConfig(config);
   const configPath = join4(rootDir, "opencode.json");
-  await writeFile2(configPath, JSON.stringify(openCodeConfig, null, 2) + "\n", "utf-8");
+  await writeFile2(configPath, await formatJson(openCodeConfig), "utf-8");
 }
 async function hasMcpConfig(rootDir, config) {
   const configFile = config?.mcp?.configFile ?? ".mcp.json";
@@ -1909,6 +1939,286 @@ function getMcpConfigPath(rootDir, config) {
   const configFile = config?.mcp?.configFile ?? ".mcp.json";
   return isAbsolute(configFile) ? configFile : join4(rootDir, configFile);
 }
+
+// src/context.ts
+import { readFile as readFile6, readdir, access as access4, stat } from "fs/promises";
+import { join as join5, relative, extname } from "path";
+import { minimatch } from "minimatch";
+var DEFAULT_MAX_FILE_SIZE = 100 * 1024;
+var DEFAULT_MAX_TOTAL_SIZE = 500 * 1024;
+var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
+  // Images
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".bmp",
+  ".ico",
+  ".webp",
+  ".svg",
+  ".tiff",
+  ".tif",
+  // Documents
+  ".pdf",
+  ".doc",
+  ".docx",
+  ".xls",
+  ".xlsx",
+  ".ppt",
+  ".pptx",
+  ".odt",
+  ".ods",
+  ".odp",
+  // Archives
+  ".zip",
+  ".tar",
+  ".gz",
+  ".bz2",
+  ".7z",
+  ".rar",
+  ".xz",
+  // Executables
+  ".exe",
+  ".dll",
+  ".so",
+  ".dylib",
+  ".bin",
+  ".app",
+  // Fonts
+  ".woff",
+  ".woff2",
+  ".ttf",
+  ".eot",
+  ".otf",
+  // Media
+  ".mp3",
+  ".mp4",
+  ".wav",
+  ".avi",
+  ".mov",
+  ".mkv",
+  ".webm",
+  ".ogg",
+  ".flac",
+  // Data
+  ".db",
+  ".sqlite",
+  ".sqlite3",
+  // Compiled
+  ".wasm",
+  ".pyc",
+  ".pyo",
+  ".class",
+  ".o",
+  ".obj",
+  // Lock files (often binary-ish)
+  ".lock",
+  // Package manager
+  "package-lock.json",
+  "pnpm-lock.yaml",
+  "yarn.lock"
+]);
+function matchesExcludePattern(relativePath, excludePatterns) {
+  for (const pattern of excludePatterns) {
+    if (minimatch(relativePath, pattern, { dot: true })) {
+      return true;
+    }
+  }
+  return false;
+}
+function isBinaryFile(filepath, additionalExtensions) {
+  const ext = extname(filepath).toLowerCase();
+  const filename = filepath.split("/").pop() ?? "";
+  if (BINARY_EXTENSIONS.has(ext)) {
+    return true;
+  }
+  if (BINARY_EXTENSIONS.has(filename)) {
+    return true;
+  }
+  if (additionalExtensions) {
+    for (const addExt of additionalExtensions) {
+      if (ext === addExt || filename === addExt) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+async function readContextFile(filepath, rootDir, options = {}) {
+  const maxFileSize = options.maxFileSize ?? DEFAULT_MAX_FILE_SIZE;
+  const absolutePath = filepath.startsWith("/") ? filepath : join5(rootDir, filepath);
+  const relativePath = relative(rootDir, absolutePath);
+  try {
+    await access4(absolutePath);
+    const stats = await stat(absolutePath);
+    if (stats.isDirectory()) {
+      return { path: absolutePath, reason: "directory" };
+    }
+    if (stats.size > maxFileSize) {
+      logger.debug(
+        `Skipping ${relativePath}: exceeds max file size (${stats.size} > ${maxFileSize})`
+      );
+      return { path: absolutePath, reason: "too-large" };
+    }
+    if (isBinaryFile(absolutePath, options.binaryExtensions)) {
+      logger.debug(`Skipping ${relativePath}: binary file extension`);
+      return { path: absolutePath, reason: "binary" };
+    }
+    const content = await readFile6(absolutePath, "utf-8");
+    if (content.includes("\0")) {
+      logger.debug(`Skipping ${relativePath}: contains null bytes`);
+      return { path: absolutePath, reason: "binary" };
+    }
+    return {
+      path: absolutePath,
+      relativePath,
+      content,
+      size: stats.size,
+      truncated: false
+    };
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      logger.debug(`Skipping ${relativePath}: file not found`);
+      return { path: absolutePath, reason: "missing" };
+    }
+    logger.debug(
+      `Skipping ${relativePath}: ${error instanceof Error ? error.message : String(error)}`
+    );
+    return {
+      path: absolutePath,
+      reason: "error",
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function readContextDirectory(dirPath, rootDir, excludePatterns, options = {}) {
+  const files = [];
+  const skipped = [];
+  const absolutePath = dirPath.startsWith("/") ? dirPath : join5(rootDir, dirPath);
+  try {
+    await access4(absolutePath);
+    const stats = await stat(absolutePath);
+    if (!stats.isDirectory()) {
+      const result = await readContextFile(absolutePath, rootDir, options);
+      if ("content" in result) {
+        files.push(result);
+      } else {
+        skipped.push(result);
+      }
+      return { files, skipped };
+    }
+    const entries = await readdir(absolutePath, { withFileTypes: true });
+    for (const entry of entries) {
+      const entryPath = join5(absolutePath, entry.name);
+      const relativePath = relative(rootDir, entryPath);
+      if (matchesExcludePattern(relativePath, excludePatterns)) {
+        skipped.push({ path: entryPath, reason: "excluded" });
+        continue;
+      }
+      if (entry.isDirectory()) {
+        const subResult = await readContextDirectory(entryPath, rootDir, excludePatterns, options);
+        files.push(...subResult.files);
+        skipped.push(...subResult.skipped);
+      } else if (entry.isFile()) {
+        const result = await readContextFile(entryPath, rootDir, options);
+        if ("content" in result) {
+          files.push(result);
+        } else {
+          skipped.push(result);
+        }
+      }
+    }
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      logger.debug(`Directory not found: ${absolutePath}`);
+    } else {
+      logger.debug(
+        `Error reading directory ${absolutePath}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  return { files, skipped };
+}
+async function assembleContext(rootDir, config, options = {}) {
+  const maxTotalSize = options.maxTotalSize ?? DEFAULT_MAX_TOTAL_SIZE;
+  const excludePatterns = config.exclude ?? [];
+  const allFiles = [];
+  const skippedFiles = [];
+  let totalSize = 0;
+  if (config.files && config.files.length > 0) {
+    for (const filePath of config.files) {
+      const relativePath = filePath;
+      if (matchesExcludePattern(relativePath, excludePatterns)) {
+        skippedFiles.push({ path: filePath, reason: "excluded" });
+        continue;
+      }
+      const result = await readContextFile(filePath, rootDir, options);
+      if ("content" in result) {
+        if (totalSize + result.size > maxTotalSize) {
+          logger.debug(`Skipping ${filePath}: would exceed total size limit`);
+          skippedFiles.push({ path: filePath, reason: "too-large" });
+          continue;
+        }
+        totalSize += result.size;
+        allFiles.push(result);
+      } else {
+        skippedFiles.push(result);
+      }
+    }
+  }
+  if (config.dirs && config.dirs.length > 0) {
+    for (const dirPath of config.dirs) {
+      const { files, skipped } = await readContextDirectory(
+        dirPath,
+        rootDir,
+        excludePatterns,
+        options
+      );
+      for (const file of files) {
+        if (totalSize + file.size > maxTotalSize) {
+          logger.debug(`Skipping ${file.relativePath}: would exceed total size limit`);
+          skippedFiles.push({ path: file.path, reason: "too-large" });
+          continue;
+        }
+        totalSize += file.size;
+        allFiles.push(file);
+      }
+      skippedFiles.push(...skipped);
+    }
+  }
+  const content = formatContextContent(allFiles, options);
+  return {
+    files: allFiles,
+    totalSize,
+    skippedFiles,
+    content
+  };
+}
+function formatContextContent(files, options = {}) {
+  const includeHeaders = options.includeHeaders ?? true;
+  if (files.length === 0) {
+    return "";
+  }
+  const sections = [
+    "## Project Context Files",
+    "",
+    "The following files provide additional context about the project:",
+    ""
+  ];
+  for (const file of files) {
+    if (includeHeaders) {
+      sections.push(`### ${file.relativePath}`);
+      sections.push("```");
+      sections.push(file.content.trim());
+      sections.push("```");
+      sections.push("");
+    } else {
+      sections.push(file.content.trim());
+      sections.push("");
+    }
+  }
+  return sections.join("\n");
+}
 export {
   CODE_EDITING_GUIDELINES,
   COMMUNICATION_GUIDELINES,
@@ -1923,6 +2233,7 @@ export {
   addMcpServerFromTemplate,
   agentReadsInstructionFiles,
   agentSupportsRuntimeInjection,
+  assembleContext,
   buildAgentArgs,
   checkAgentAvailable,
   checkAllAgents,
@@ -1936,6 +2247,9 @@ export {
   enableMcpServer,
   execInContainer,
   formatAuthStatus,
+  formatContextContent,
+  formatJson,
+  formatJsonSync,
   generateEnvrc,
   generateFullSystemPrompt,
   generateMcpConfig,
@@ -1969,6 +2283,7 @@ export {
   hasOpCli,
   hasOpServiceAccountToken,
   hasVaultCli,
+  isBinaryFile,
   isOpAuthenticated,
   isVaultAuthenticated,
   launchAgent,
@@ -1977,7 +2292,10 @@ export {
   loadDevcontainerConfig,
   loadSecrets,
   logger,
+  matchesExcludePattern,
   mergeWithDefaults,
+  readContextDirectory,
+  readContextFile,
   readEnvrc,
   readMcpConfig,
   readOpSecret,