mini-coder 0.5.14 → 0.6.1

package/assets/icon-4-filled-bold.svg

@@ -1,54 +0,0 @@
-<!-- Mini Coder Icon v4: Filled Bold
-     Chunky solid brackets form a unified shape. Bolt cuts through like a slash.
-     Inspired by: "accurate and reliable", sturdy and trustworthy feel -->
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" width="100" height="100">
-  <!-- Left bracket { — filled, bold, warm off-white bg -->
-  <rect x="0" y="0" width="100" height="100" rx="0" fill="#f7f3ee"/>
-
-  <!-- Left brace as thick filled path -->
-  <path
-    d="M40 10
-       C32 10 28 15 28 23
-       L28 39
-       C28 45 24 48 19 50
-       C24 52 28 55 28 61
-       L28 77
-       C28 85 32 90 40 90
-       L40 83
-       C35 83 35 79 35 75
-       L35 62
-       C35 55 31 52 28 50
-       C31 48 35 45 35 38
-       L35 25
-       C35 21 35 17 40 17
-       Z"
-    fill="#1a1a2e"
-  />
-  <!-- Right brace as thick filled path -->
-  <path
-    d="M60 10
-       C68 10 72 15 72 23
-       L72 39
-       C72 45 76 48 81 50
-       C76 52 72 55 72 61
-       L72 77
-       C72 85 68 90 60 90
-       L60 83
-       C65 83 65 79 65 75
-       L65 62
-       C65 55 69 52 72 50
-       C69 48 65 45 65 38
-       L65 25
-       C65 21 65 17 60 17
-       Z"
-    fill="#1a1a2e"
-  />
-  <!-- Lightning bolt — punchy orange-red -->
-  <path
-    d="M58 16 L41 51 L52 51 L42 84 L64 47 L53 47 Z"
-    fill="#e8390e"
-    stroke="#f7f3ee"
-    stroke-width="1.5"
-    stroke-linejoin="round"
-  />
-</svg>

package/assets/icon-5-community-badge.svg

@@ -1,63 +0,0 @@
-<!-- Mini Coder Icon v5: Community Badge
-     Hexagonal badge shape (nod to community/open-source), teal + amber palette.
-     Bolt doubles as a "play / run" symbol. Inspired by: "community oriented",
-     open source tools like Codex & opencode. -->
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" width="100" height="100">
-  <defs>
-    <linearGradient id="hexGrad" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" stop-color="#0a3d62"/>
-      <stop offset="100%" stop-color="#0c6e6e"/>
-    </linearGradient>
-    <filter id="shadow" x="-10%" y="-10%" width="120%" height="120%">
-      <feDropShadow dx="0" dy="2" stdDeviation="3" flood-color="rgba(0,0,0,0.35)"/>
-    </filter>
-  </defs>
-
-  <!-- Hexagon background -->
-  <polygon
-    points="50,4 93,27 93,73 50,96 7,73 7,27"
-    fill="url(#hexGrad)"
-    filter="url(#shadow)"
-  />
-  <!-- Subtle inner hex ring -->
-  <polygon
-    points="50,10 88,30 88,70 50,90 12,70 12,30"
-    fill="none"
-    stroke="rgba(255,255,255,0.1)"
-    stroke-width="1.5"
-  />
-
-  <!-- Left bracket { — teal/white -->
-  <path
-    d="M37 18 C29 18 26 23 26 30 L26 43 C26 48 22 51 18 52 C22 53 26 56 26 61 L26 71 C26 78 29 83 37 83"
-    fill="none"
-    stroke="#7fffd4"
-    stroke-width="4"
-    stroke-linecap="round"
-    stroke-linejoin="round"
-  />
-  <!-- Right bracket } — teal/white -->
-  <path
-    d="M63 18 C71 18 74 23 74 30 L74 43 C74 48 78 51 82 52 C78 53 74 56 74 61 L74 71 C74 78 71 83 63 83"
-    fill="none"
-    stroke="#7fffd4"
-    stroke-width="4"
-    stroke-linecap="round"
-    stroke-linejoin="round"
-  />
-
-  <!-- Lightning bolt — amber gold -->
-  <path
-    d="M56 22 L42 52 L52 52 L44 78 L62 46 L51 46 Z"
-    fill="#ffc107"
-    stroke="#fff8e1"
-    stroke-width="1"
-    stroke-linejoin="round"
-  />
-  <!-- Tiny speed lines left of bolt -->
-  <line x1="28" y1="46" x2="36" y2="46" stroke="#7fffd4" stroke-width="1.5" stroke-linecap="round" opacity="0.5"/>
-  <line x1="30" y1="51" x2="36" y2="51" stroke="#7fffd4" stroke-width="1.5" stroke-linecap="round" opacity="0.35"/>
-  <!-- Tiny speed lines right of bolt -->
-  <line x1="64" y1="46" x2="72" y2="46" stroke="#7fffd4" stroke-width="1.5" stroke-linecap="round" opacity="0.5"/>
-  <line x1="64" y1="51" x2="70" y2="51" stroke="#7fffd4" stroke-width="1.5" stroke-linecap="round" opacity="0.35"/>
-</svg>

package/benchmark-baseline.sh

@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-cd -- "$(dirname -- "${BASH_SOURCE[0]}")"
-
-PYTHONPATH="$PWD/terminal-bench" harbor run -y \
-  --job-name benchmark-baseline-full-$(date +%F__%H-%M-%S) \
-  --jobs-dir "$PWD/terminal-bench/jobs" \
-  --agent-import-path mini_coder_agent:MiniCoderAgent \
-  --ak version=0.5.12 \
-  --model openai-codex/gpt-5.4 \
-  --dataset terminal-bench@2.0 \
-  --n-attempts 2 \
-  --n-concurrent 2 \
-  --max-retries 0

package/benchmark-loop.sh

@@ -1,19 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-stop() {
-  echo "stopping loop"
-  exit 0
-}
-
-trap stop INT TERM
-
-while :; do
-  echo ""
-  echo "> Running step"
-  echo ""
-  mc -p "See BENCHMARK.md and PROGRESS.md first. Do the next step in the process. Once the step is complete update PROGRESS.md"
-
-  sleep 60
-done
-

package/skills-lock.json

@@ -1,15 +0,0 @@
-{
-  "version": 1,
-  "skills": {
-    "bun-development": {
-      "source": "sickn33/antigravity-awesome-skills",
-      "sourceType": "github",
-      "computedHash": "87e59a1e7f7fe512333aad64022955501a4e36be6e65487196dfc311e5b786b7"
-    },
-    "typescript-advanced-types": {
-      "source": "wshobson/agents",
-      "sourceType": "github",
-      "computedHash": "3a3be8c925f96ac4e1280db28a01677e7ca5197f3792de2bbf35ab3bb324b6dd"
-    }
-  }
-}

package/src/assistant-output.ts

@@ -1,73 +0,0 @@
-/**
- * Shared helpers for extracting user-visible assistant output.
- *
- * @module
- */
-
-import type { AssistantMessage } from "@mariozechner/pi-ai";
-import {
-  collapseWhitespaceToNull,
-  joinTextBlocks,
-  truncateText,
-} from "./text.ts";
-
-const ASSISTANT_ACTIVITY_MAX_CHARS = 160;
-
-/**
- * Extract concatenated text blocks from an assistant message.
- *
- * @param message - Assistant message to inspect.
- * @returns The combined text content, or an empty string when none exists.
- */
-export function extractAssistantText(message: AssistantMessage | null): string {
-  if (!message) {
-    return "";
-  }
-
-  return message.content
-    .filter(
-      (
-        block,
-      ): block is Extract<
-        AssistantMessage["content"][number],
-        { type: "text" }
-      > => {
-        return block.type === "text";
-      },
-    )
-    .map((block) => block.text)
-    .join("");
-}
-
-/**
- * Extract a short assistant activity snippet from a tool-using message.
- *
- * @param message - Assistant message to inspect.
- * @returns A collapsed activity snippet, or `null` when no snippet applies.
- */
-export function extractAssistantActivitySnippet(
-  message: AssistantMessage,
-): string | null {
-  if (!message.content.some((block) => block.type === "toolCall")) {
-    return null;
-  }
-
-  const text = collapseWhitespaceToNull(joinTextBlocks(message.content));
-  return text ? truncateText(text, ASSISTANT_ACTIVITY_MAX_CHARS) : null;
-}
-
-/**
- * Extract terminal assistant error text from a failed assistant message.
- *
- * @param message - Assistant message to inspect.
- * @returns Collapsed error text, or `null` when the message is not terminally errored.
- */
-export function extractAssistantErrorText(
-  message: AssistantMessage | null,
-): string | null {
-  if (!message || message.stopReason !== "error" || !message.errorMessage) {
-    return null;
-  }
-
-  return collapseWhitespaceToNull(message.errorMessage) ?? null;
-}

package/src/cli.ts

@@ -1,134 +0,0 @@
-/**
- * CLI argument parsing and launch-mode selection.
- *
- * @module
- */
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-/** Parsed CLI options for the current launch. */
-export interface CliOptions {
-  /** One-shot prompt text, or `null` when not provided. */
-  prompt: string | null;
-  /** Whether to stream headless output as NDJSON instead of final text. */
-  json: boolean;
-}
-
-/** TTY availability for stdin/stdout. */
-export interface TtyState {
-  /** Whether stdin is attached to a TTY. */
-  stdinIsTTY: boolean;
-  /** Whether stdout is attached to a TTY. */
-  stdoutIsTTY: boolean;
-}
-
-// ---------------------------------------------------------------------------
-// Argument parsing
-// ---------------------------------------------------------------------------
-
-/**
- * Parse supported CLI arguments.
- *
- * Supports `-p, --prompt <text>` for headless one-shot mode and `--json`
- * to stream NDJSON events instead of the default final-text mode
- * (stdout final answer plus stderr activity snippets).
- * Unknown flags and positional arguments fail eagerly.
- *
- * @param argv - Process arguments excluding the Bun executable and script path.
- * @returns The parsed CLI options.
- */
-export function parseCliArgs(argv: readonly string[]): CliOptions {
-  let prompt: string | null = null;
-  let json = false;
-
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (!arg) {
-      continue;
-    }
-
-    if (arg === "-p" || arg === "--prompt") {
-      const value = argv[index + 1];
-      if (value == null) {
-        throw new Error("Missing value for -p/--prompt.");
-      }
-      prompt = value;
-      index += 1;
-      continue;
-    }
-
-    if (arg.startsWith("--prompt=")) {
-      prompt = arg.slice("--prompt=".length);
-      continue;
-    }
-
-    if (arg === "--json") {
-      json = true;
-      continue;
-    }
-
-    if (arg.startsWith("-")) {
-      throw new Error(`Unknown argument: ${arg}`);
-    }
-
-    throw new Error(`Unexpected positional argument: ${arg}`);
-  }
-
-  return { prompt, json };
-}
-
-// ---------------------------------------------------------------------------
-// Mode selection
-// ---------------------------------------------------------------------------
-
-/**
- * Return whether the current launch should run in headless mode.
- *
- * Headless mode is selected when a one-shot prompt was provided or when
- * either stdin or stdout is not attached to a TTY.
- *
- * @param options - Parsed CLI options.
- * @param tty - Current TTY availability.
- * @returns `true` when headless mode should be used.
- */
-export function shouldUseHeadlessMode(
-  options: CliOptions,
-  tty: TtyState,
-): boolean {
-  return options.prompt !== null || !tty.stdinIsTTY || !tty.stdoutIsTTY;
-}
-
-/**
- * Resolve the raw prompt text for headless mode.
- *
- * Prefers the explicit CLI prompt. Otherwise reads all of stdin. Empty or
- * whitespace-only input is rejected.
- *
- * @param options - Parsed CLI options.
- * @param tty - Current TTY availability.
- * @param readStdin - Callback that returns the full stdin contents.
- * @returns The raw prompt text to submit.
- */
-export async function resolveHeadlessPrompt(
-  options: CliOptions,
-  tty: TtyState,
-  readStdin: () => Promise<string>,
-): Promise<string> {
-  const rawPrompt =
-    options.prompt !== null
-      ? options.prompt
-      : tty.stdinIsTTY
-        ? null
-        : await readStdin();
-
-  if (rawPrompt === null) {
-    throw new Error("Headless mode requires -p/--prompt or piped stdin.");
-  }
-  if (rawPrompt.trim().length === 0) {
-    throw new Error("Headless input is empty.");
-  }
-
-  return rawPrompt;
-}

package/src/delegation.ts

@@ -1,238 +0,0 @@
-/**
- * Subagent delegation safeguards.
- *
- * Tracks a shallow delegation depth plus a small per-run delegation budget so
- * first-class `delegate` tool runs and shell-authored `mc -p` child processes
- * cannot recurse forever.
- *
- * @module
- */
-
-const SHELL_DELEGATION_COMMAND =
-  /(?:^|[;&|()\s])(?:[^\s;&|()]+\/)?mc\s+(?:-p\b|--prompt(?:\b|=))/g;
-
-/** Environment variable carrying the current subagent-delegation depth. */
-export const SHELL_DELEGATION_DEPTH_ENV = "MC_SUBAGENT_DEPTH";
-
-/** Environment variable carrying the remaining subagent-delegation budget. */
-export const SHELL_DELEGATION_BUDGET_ENV = "MC_SUBAGENT_BUDGET";
-
-/** Maximum allowed subagent delegation depth. */
-export const MAX_SHELL_DELEGATION_DEPTH = 1;
-
-/** Default number of delegated subagent launches allowed per agent run. */
-export const DEFAULT_SHELL_DELEGATION_BUDGET = 4;
-
-/** Current subagent-delegation context for one app run. */
-export interface ShellDelegationContext {
-  /** Current subagent-delegation depth for this app process. */
-  depth: number;
-  /** Remaining delegated-subagent launches available in the active run. */
-  remainingBudget: number;
-}
-
-/** Result of reserving subagent-delegation budget for one launch. */
-export interface ShellDelegationReservation {
-  /** Number of delegated-subagent launches reserved by the request. */
-  launchCount: number;
-  /** Updated parent-run context after reserving any delegated launches. */
-  updatedContext: ShellDelegationContext;
-  /** Context that delegated child runs should inherit for this request. */
-  childContext: ShellDelegationContext;
-}
-
-/** Successful or blocked delegation-reservation outcome. */
-export type ReserveShellDelegationResult =
-  | {
-      /** Whether the delegation request may proceed. */
-      ok: true;
-      /** Reserved delegation details for the request. */
-      reservation: ShellDelegationReservation;
-    }
-  | {
-      /** Whether the delegation request may proceed. */
-      ok: false;
-      /** Human-readable tool error for the blocked delegation attempt. */
-      error: string;
-    };
-
-type DelegationReservationError = "nested" | "exhausted" | "over_budget";
-
-function readNonNegativeInteger(
-  value: string | undefined,
-  fallback: number,
-): number {
-  if (value == null || value === "") {
-    return fallback;
-  }
-
-  const parsed = Number.parseInt(value, 10);
-  return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
-}
-
-function reserveDelegationBudget(
-  context: ShellDelegationContext,
-  launchCount: number,
-):
-  | {
-      ok: true;
-      reservation: ShellDelegationReservation;
-    }
-  | {
-      ok: false;
-      reason: DelegationReservationError;
-    } {
-  if (launchCount === 0) {
-    const unchanged = { ...context };
-    return {
-      ok: true,
-      reservation: {
-        launchCount,
-        updatedContext: unchanged,
-        childContext: unchanged,
-      },
-    };
-  }
-
-  if (context.depth >= MAX_SHELL_DELEGATION_DEPTH) {
-    return {
-      ok: false,
-      reason: "nested",
-    };
-  }
-
-  if (context.remainingBudget === 0) {
-    return {
-      ok: false,
-      reason: "exhausted",
-    };
-  }
-
-  if (launchCount > context.remainingBudget) {
-    return {
-      ok: false,
-      reason: "over_budget",
-    };
-  }
-
-  const remainingBudget = context.remainingBudget - launchCount;
-  return {
-    ok: true,
-    reservation: {
-      launchCount,
-      updatedContext: {
-        depth: context.depth,
-        remainingBudget,
-      },
-      childContext: {
-        depth: context.depth + 1,
-        remainingBudget,
-      },
-    },
-  };
-}
-
-/**
- * Read the current subagent-delegation context from environment variables.
- *
- * Missing or invalid values fall back to the safe root-run defaults.
- *
- * @param env - Environment variables to inspect.
- * @returns The parsed subagent-delegation context.
- */
-export function readShellDelegationContext(
-  env: Readonly<Record<string, string | undefined>>,
-): ShellDelegationContext {
-  return {
-    depth: readNonNegativeInteger(env[SHELL_DELEGATION_DEPTH_ENV], 0),
-    remainingBudget: readNonNegativeInteger(
-      env[SHELL_DELEGATION_BUDGET_ENV],
-      DEFAULT_SHELL_DELEGATION_BUDGET,
-    ),
-  };
-}
-
-/**
- * Build the environment-variable overrides for a subagent-delegation context.
- *
- * @param context - Subagent-delegation context to serialize.
- * @returns Environment overrides for child shell processes.
- */
-export function buildShellDelegationEnv(
-  context: ShellDelegationContext,
-): Record<string, string> {
-  return {
-    [SHELL_DELEGATION_DEPTH_ENV]: String(context.depth),
-    [SHELL_DELEGATION_BUDGET_ENV]: String(context.remainingBudget),
-  };
-}
-
-/**
- * Count likely shell-authored `mc -p` / `mc --prompt` launches in one command.
- *
- * The detector is intentionally narrow and optimized for the prompt-guided
- * `mc -p "subtask"` pattern mini-coder still supports for CLI-level testing.
- *
- * @param command - Raw shell command.
- * @returns Number of likely `mc -p` launches in the command.
- */
-export function countShellDelegationLaunches(command: string): number {
-  return command.match(SHELL_DELEGATION_COMMAND)?.length ?? 0;
-}
-
-/**
- * Reserve first-class `delegate` tool budget for one delegated subagent run.
- *
- * @param context - Current subagent-delegation context for the active run.
- * @returns Reservation details, or a blocking error when this delegation would
- *          exceed the allowed subagent-delegation policy.
- */
-export function reserveToolDelegation(
-  context: ShellDelegationContext,
-): ReserveShellDelegationResult {
-  const reservation = reserveDelegationBudget(context, 1);
-  if (!reservation.ok) {
-    return {
-      ok: false,
-      error:
-        reservation.reason === "nested"
-          ? "Tool delegation blocked: delegated `delegate` tool runs may not delegate again."
-          : "Tool delegation blocked: this run has no remaining `delegate` delegation budget.",
-    };
-  }
-
-  return reservation;
-}
-
-/**
- * Reserve shell-level delegation budget for a command before execution.
- *
- * Non-delegating commands pass through unchanged. Commands that would exceed
- * the per-run delegation budget or the maximum allowed depth are rejected with
- * a user-visible tool error.
- *
- * @param command - Raw shell command to inspect.
- * @param context - Current subagent-delegation context for the active run.
- * @returns Reservation details, or a blocking error when the command would
- *          exceed the allowed shell-level delegation policy.
- */
-export function reserveShellDelegation(
-  command: string,
-  context: ShellDelegationContext,
-): ReserveShellDelegationResult {
-  const launchCount = countShellDelegationLaunches(command);
-  const reservation = reserveDelegationBudget(context, launchCount);
-  if (!reservation.ok) {
-    return {
-      ok: false,
-      error:
-        reservation.reason === "nested"
-          ? "Shell delegation blocked: delegated `mc -p` runs may not launch more `mc -p` subagents."
-          : reservation.reason === "exhausted"
-            ? "Shell delegation blocked: this run has no remaining `mc -p` delegation budget."
-            : "Shell delegation blocked: this command appears to launch more `mc -p` subagents than the remaining delegation budget allows.",
-    };
-  }
-
-  return reservation;
-}

package/src/errors.ts

@@ -1,15 +0,0 @@
-/**
- * Shared error-formatting helpers.
- *
- * @module
- */
-
-/**
- * Convert an unknown thrown value into a readable message string.
- *
- * @param error - The thrown value to format.
- * @returns The error message when available, otherwise the stringified value.
- */
-export function getErrorMessage(error: unknown): string {
-  return error instanceof Error ? error.message : String(error);
-}