indusagi-coding-agent 0.2.8 → 0.2.10

package/src/launch/index.ts

@@ -0,0 +1,98 @@
+// @ts-nocheck
+// Type declarations recovered from dist/types (no runtime body)
+/**
+ * Launch subsystem — public barrel.
+ *
+ * Re-exports the frozen Phase-10 contract surface: the parsed
+ * {@link Invocation} and its {@link OutputMode} / {@link ThinkingEffort} /
+ * {@link ToolName} vocabularies, the declarative {@link FlagSpec} table types,
+ * the gathered {@link Attachments} shape, the typed {@link CredentialFault}
+ * union and its {@link AuthVault} seam, the model-catalog filter, and the resume
+ * / settings-browser option shapes. Behavior modules (the reader, the usage
+ * renderer, the credential command, the attachment gatherer, the catalog
+ * printer, the resume picker, the settings browser) attach their exports here as
+ * they land, so consumers import the launch surface from `src/launch` rather
+ * than reaching into individual modules.
+ */
+export type {
+  OutputMode,
+  ThinkingEffort,
+  ToolName,
+  FlagKind,
+  FlagDefault,
+  FlagSpec,
+  Invocation,
+  FlagValue,
+  Attachments,
+  AttachmentOptions,
+  CredentialVerb,
+  ProviderEntry,
+  CredentialFaultKind,
+  CredentialFault,
+  AuthVault,
+  CredentialCommandOptions,
+  CatalogFilter,
+  SessionLoader,
+  ResumeFault,
+  SettingsBrowseOptions,
+  ResumeRef,
+  ThinkingLevel,
+  SessionListProgress,
+  ImageContent,
+  KnownProvider,
+  ModelRegistry,
+  OAuthCredentials,
+  Settings,
+  RunnerId,
+} from "./contract.js";
+export {
+  THINKING_EFFORTS,
+  TOOL_NAMES,
+  isThinkingEffort,
+  isOutputMode,
+  isToolName,
+  credentialFault,
+} from "./contract.js";
+export {
+  FLAG_SPECS,
+  FLAG_GROUPS,
+  readInvocation,
+  readFileReferences,
+  renderUsage,
+  gatherAttachments,
+  AttachmentError,
+} from "./invocation/index.js";
+export type { FlagGroup, GroupedFlagSpec, AttachmentErrorKind } from "./invocation/index.js";
+export { runPackageCommand, defaultPackageIo, PACKAGE_COMMANDS } from "./packages.js";
+export type { PackageCommand, PackageIo, PackageCommandOptions, PackageResult } from "./packages.js";
+export {
+  runCredentialCommand,
+  defaultCredentialIo,
+  formatCredentialFault,
+  validateApiKey,
+  validateAccountName,
+  findProvider,
+  isOAuthCapable,
+  asSigninMethod,
+  PROVIDER_DIRECTORY,
+} from "./credentials.js";
+export type { CredentialIo, CredentialResult, SigninMethod } from "./credentials.js";
+export {
+  registerBuiltInOAuthProviders,
+  listLoginProviders,
+  startOAuthLogin,
+  openLoginUrl,
+  hasRegisteredOAuthClientId,
+} from "./oauth.js";
+export type { AuthKind, LoginProvider, OAuthLoginResult } from "./oauth.js";
+export { printModelCatalog, defaultCatalogIo, registrySource } from "./catalog.js";
+export type { CatalogIo, CatalogModelSource } from "./catalog/index.js";
+export {
+  pickResumeTarget,
+  browseSettings,
+  mergeSessions,
+  renderSettingsListing,
+  defaultResumeDeps,
+  defaultSettingsBrowseIo,
+} from "./pickers.js";
+export type { ResumeDeps, ResumeOutcome, SettingsBrowseIo } from "./pickers.js";

package/src/launch/invocation/attachments.ts

@@ -0,0 +1,179 @@
+/**
+ * The attachment gatherer — expands `@file` references into one
+ * {@link Attachments} value.
+ */
+import { readFile, stat } from "node:fs/promises";
+import { extname } from "node:path";
+import type { ImageContent } from "indusagi/ai";
+import { resolveReadPath } from "indusagi/agent";
+import type { Attachments, AttachmentOptions } from "../contract.js";
+
+const MAX_TEXT_BYTES = 10 * 1024 * 1024;
+const MAX_IMAGE_BYTES = 20 * 1024 * 1024;
+
+const TEXT_EXTENSIONS: ReadonlySet<string> = new Set([
+  ".txt",
+  ".md",
+  ".markdown",
+  ".json",
+  ".jsonc",
+  ".yaml",
+  ".yml",
+  ".toml",
+  ".ini",
+  ".csv",
+  ".tsv",
+  ".xml",
+  ".html",
+  ".htm",
+  ".css",
+  ".scss",
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".mjs",
+  ".cjs",
+  ".py",
+  ".rb",
+  ".go",
+  ".rs",
+  ".java",
+  ".kt",
+  ".c",
+  ".h",
+  ".cc",
+  ".cpp",
+  ".hpp",
+  ".cs",
+  ".php",
+  ".sh",
+  ".bash",
+  ".zsh",
+  ".sql",
+  ".log",
+  ".env",
+  ".gitignore",
+  ".dockerfile",
+]);
+
+const IMAGE_MIME_BY_EXT: ReadonlyMap<string, string> = new Map([
+  [".png", "image/png"],
+  [".jpg", "image/jpeg"],
+  [".jpeg", "image/jpeg"],
+  [".gif", "image/gif"],
+  [".webp", "image/webp"],
+  [".bmp", "image/bmp"],
+  [".svg", "image/svg+xml"],
+]);
+
+export type AttachmentErrorKind = "unsupported" | "too-large" | "not-found" | "read-failed";
+
+export class AttachmentError extends Error {
+  readonly kind: AttachmentErrorKind;
+  readonly reference: string;
+  readonly resolvedPath?: string;
+  readonly cause?: unknown;
+
+  constructor(
+    kind: AttachmentErrorKind,
+    message: string,
+    detail: { reference: string; resolvedPath?: string; cause?: unknown },
+  ) {
+    super(message);
+    this.name = "AttachmentError";
+    this.kind = kind;
+    this.reference = detail.reference;
+    if (detail.resolvedPath !== undefined) this.resolvedPath = detail.resolvedPath;
+    if (detail.cause !== undefined) this.cause = detail.cause;
+  }
+}
+
+function extensionOf(path: string): string {
+  return extname(path).toLowerCase();
+}
+
+function isMissing(error: unknown): boolean {
+  return (
+    typeof error === "object" &&
+    error !== null &&
+    "code" in error &&
+    (error as { code?: unknown }).code === "ENOENT"
+  );
+}
+
+async function sizeOf(resolvedPath: string, reference: string): Promise<number> {
+  try {
+    const info = await stat(resolvedPath);
+    return info.size;
+  } catch (error) {
+    if (isMissing(error)) {
+      throw new AttachmentError("not-found", `No such file: ${reference}`, {
+        reference,
+        resolvedPath,
+        cause: error,
+      });
+    }
+    throw new AttachmentError("read-failed", `Could not access file: ${reference}`, {
+      reference,
+      resolvedPath,
+      cause: error,
+    });
+  }
+}
+
+function wrapTextBlock(resolvedPath: string, body: string): string {
+  return `<file path="${resolvedPath}">\n${body}\n</file>`;
+}
+
+/**
+ * Expand the `@file` references into a single {@link Attachments} value.
+ */
+export async function gatherAttachments(
+  references: readonly string[],
+  options: AttachmentOptions,
+): Promise<Attachments> {
+  const blocks: string[] = [];
+  const media: ImageContent[] = [];
+  for (const reference of references) {
+    const resolvedPath = resolveReadPath(reference, options.cwd);
+    const ext = extensionOf(resolvedPath);
+    const imageMime = IMAGE_MIME_BY_EXT.get(ext);
+    const isText = TEXT_EXTENSIONS.has(ext);
+    if (imageMime === undefined && !isText) {
+      throw new AttachmentError("unsupported", `Unsupported attachment type: ${reference}`, {
+        reference,
+        resolvedPath,
+      });
+    }
+    const size = await sizeOf(resolvedPath, reference);
+    if (size === 0) continue;
+    const cap = imageMime !== undefined ? MAX_IMAGE_BYTES : MAX_TEXT_BYTES;
+    if (size > cap) {
+      throw new AttachmentError("too-large", `Attachment exceeds the size limit: ${reference}`, {
+        reference,
+        resolvedPath,
+      });
+    }
+    try {
+      if (imageMime !== undefined) {
+        const bytes = await readFile(resolvedPath);
+        media.push({
+          type: "image",
+          data: bytes.toString("base64"),
+          mimeType: imageMime,
+        });
+      } else {
+        const body = await readFile(resolvedPath, "utf8");
+        if (body.length > 0) blocks.push(wrapTextBlock(resolvedPath, body));
+      }
+    } catch (error) {
+      throw new AttachmentError("read-failed", `Could not read file: ${reference}`, {
+        reference,
+        resolvedPath,
+        cause: error,
+      });
+    }
+  }
+  return { prose: blocks.join("\n\n"), media };
+}

package/src/launch/invocation/flags.ts

@@ -0,0 +1,196 @@
+/**
+ * The single declarative flag table.
+ *
+ * Every recognised command-line option is described here exactly once, as one
+ * {@link FlagSpec} row.
+ */
+import type { FlagSpec } from "../contract.js";
+
+export type FlagGroup = "output" | "model" | "context" | "tools" | "meta";
+
+export interface GroupedFlagSpec extends FlagSpec {
+  readonly group: FlagGroup;
+}
+
+export const FLAG_GROUPS: readonly { readonly id: FlagGroup; readonly title: string }[] = [
+  { id: "output", title: "Output" },
+  { id: "model", title: "Model" },
+  { id: "context", title: "Context" },
+  { id: "tools", title: "Tools" },
+  { id: "meta", title: "Meta" },
+];
+
+const THINKING_CHOICES = ["off", "minimal", "low", "medium", "high", "xhigh"];
+
+export const FLAG_SPECS: readonly GroupedFlagSpec[] = [
+  /* ---- Output ---------------------------------------------------------- */
+  {
+    name: "--print",
+    aliases: ["-p"],
+    kind: "boolean",
+    group: "output",
+    describe: "Run a single request, print only the result, and exit.",
+  },
+  {
+    name: "--json",
+    aliases: ["--rpc"],
+    kind: "boolean",
+    group: "output",
+    describe: "Speak the headless line protocol for a driving parent process.",
+  },
+  {
+    name: "--interactive",
+    aliases: ["-i"],
+    kind: "boolean",
+    group: "output",
+    describe: "Force the interactive session even when a prompt is supplied.",
+  },
+  /* ---- Model ----------------------------------------------------------- */
+  {
+    name: "--model",
+    aliases: ["-m"],
+    kind: "string",
+    group: "model",
+    describe: "Select the model, provider-qualified or bare (e.g. provider/name).",
+  },
+  {
+    name: "--fallback-model",
+    kind: "string",
+    group: "model",
+    describe: "Model to switch to mid-turn when the selected model is overloaded (HTTP 529).",
+  },
+  {
+    name: "--account",
+    kind: "string",
+    group: "model",
+    describe: "Authenticate the run with a named stored credential account.",
+  },
+  {
+    name: "--thinking",
+    kind: "string",
+    group: "model",
+    describe: `Set the reasoning effort (one of: ${THINKING_CHOICES.join(", ")}).`,
+  },
+  {
+    name: "--list-models",
+    kind: "string",
+    group: "model",
+    describe: "List the available models (optionally filtered by a substring) and exit.",
+  },
+  /* ---- Context --------------------------------------------------------- */
+  {
+    name: "--cwd",
+    kind: "string",
+    group: "context",
+    describe: "Scope the run to a working directory (default: the current directory).",
+  },
+  {
+    name: "--system",
+    kind: "string",
+    group: "context",
+    describe: "Replace the built-in system prompt with the given text.",
+  },
+  {
+    name: "--append-system",
+    kind: "string",
+    group: "context",
+    describe: "Append extra text after the system prompt.",
+  },
+  {
+    name: "--resume",
+    aliases: ["-r"],
+    kind: "boolean",
+    group: "context",
+    describe: "Pick a previous session to resume.",
+  },
+  {
+    name: "--continue",
+    aliases: ["-c"],
+    kind: "boolean",
+    group: "context",
+    describe: "Continue the most recent session in this directory.",
+  },
+  /* ---- Tools ----------------------------------------------------------- */
+  {
+    name: "--tools",
+    kind: "list",
+    group: "tools",
+    describe: "Allow only the named built-in tools (comma-separated or repeated).",
+  },
+  {
+    name: "--no-tools",
+    kind: "boolean",
+    group: "tools",
+    describe: "Disable every built-in tool for this run.",
+  },
+  {
+    name: "--mcp",
+    kind: "list",
+    group: "tools",
+    describe: "Attach an external MCP server endpoint (comma-separated or repeated).",
+  },
+  {
+    name: "--zoho-url",
+    kind: "string",
+    group: "tools",
+    describe: "Zoho MCP server URL (from Zoho Connect tab). Enables native Zoho CRM tools.",
+  },
+  {
+    name: "--zoho",
+    kind: "boolean",
+    group: "tools",
+    describe: "Force-enable Zoho tools when ZOHO_MCP_URL or zoho.json is configured.",
+  },
+  {
+    name: "--no-zoho",
+    kind: "boolean",
+    group: "tools",
+    describe: "Disable Zoho MCP tools for this run.",
+  },
+  {
+    name: "--sarvam",
+    kind: "boolean",
+    group: "tools",
+    describe: "Force-enable Sarvam MCP tools when SARVAM_API_KEY is configured.",
+  },
+  {
+    name: "--no-sarvam",
+    kind: "boolean",
+    group: "tools",
+    describe: "Disable Sarvam MCP tools for this run.",
+  },
+  {
+    name: "--sarvam-key",
+    kind: "string",
+    group: "tools",
+    describe: "Sarvam API key for this run (prefer SARVAM_API_KEY env).",
+  },
+  {
+    name: "--sarvam-base-path",
+    kind: "string",
+    group: "tools",
+    describe: "Directory for Sarvam TTS/docs output (default ~/Desktop).",
+  },
+  {
+    name: "--permission-mode",
+    kind: "string",
+    group: "tools",
+    describe:
+      "Open in the given permission mode: default, acceptEdits, plan, or bypass. On headless runs (--print/--json) `default` denies tools that would prompt.",
+  },
+  /* ---- Meta ------------------------------------------------------------ */
+  {
+    name: "--help",
+    aliases: ["-h"],
+    kind: "boolean",
+    group: "meta",
+    describe: "Show this usage and exit.",
+  },
+  {
+    name: "--version",
+    aliases: ["-v"],
+    kind: "boolean",
+    group: "meta",
+    describe: "Show the version and exit.",
+  },
+];

package/src/launch/invocation/index.ts

@@ -0,0 +1,25 @@
+// @ts-nocheck
+// Type declarations recovered from dist/types (no runtime body)
+/**
+ * Invocation subsystem — public barrel.
+ *
+ * Bundles the command-line behavior modules that all read the single
+ * declarative {@link FLAG_SPECS} table:
+ *
+ *   - {@link readInvocation} — the generic, table-driven argv parser that folds
+ *     a sliced argument vector into a typed {@link Invocation};
+ *   - {@link renderUsage} — the `--help` banner generated from that same table,
+ *     so help and parsing share one source of truth;
+ *   - {@link gatherAttachments} — the `@file` expander that resolves references
+ *     through the framework path resolver into inlined prose plus base64 media,
+ *     raising a typed {@link AttachmentError} on failure.
+ *
+ * Consumers import the invocation surface from `src/launch/invocation` rather
+ * than reaching into the individual modules.
+ */
+export { FLAG_SPECS, FLAG_GROUPS } from "./flags.js";
+export type { FlagGroup, GroupedFlagSpec } from "./flags.js";
+export { readInvocation, readFileReferences } from "./read.js";
+export { renderUsage } from "./usage.js";
+export { gatherAttachments, AttachmentError } from "./attachments.js";
+export type { AttachmentErrorKind } from "./attachments.js";