Skip to content

armgit / Orkas

Public Imported from GitHub
0

Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander turns your goal into to-dos and coordinates 16 built-in specialist agents plus Claude Code, Codex, OpenCode, OpenClaw and Hermes, with projects, scheduled automations and connectors. Free app for macOS & Windows; built-in models or your own keys.

2.7 KB
Raw Blame
import { describe, it, expect } from "vitest";
import {
  RUN_CONVERGENCE_ELAPSED_MS,
  RUN_CONVERGENCE_MIN_TOOL_LOOPS,
  SLOW_COMPACTION_CONVERGENCE_MS,
  shouldNudgeElapsedConvergence,
  shouldNudgeSpinConvergence,
  SPIN_CONVERGENCE_MIN_COMPACTIONS,
  SPIN_CONVERGENCE_TOOL_LOOP_RATIO,
} from "../src/agent/runner.js";

// The compound "spinning after context loss" signal must require BOTH repeated
// compaction AND heavy tool use — never either alone — and must not fire at/after
// the hard round limit (where the cap + near-limit nudge take over).
describe("shouldNudgeSpinConvergence", () => {
  it("pins the thresholds", () => {
    expect(SPIN_CONVERGENCE_MIN_COMPACTIONS).toBe(2);
    expect(SPIN_CONVERGENCE_TOOL_LOOP_RATIO).toBe(0.75);
  });

  it("fires only when both signals cross the threshold (max=80 → 0.75 ratio = 60 rounds)", () => {
    expect(shouldNudgeSpinConvergence(2, 60, 80)).toBe(true); // at both thresholds
    expect(shouldNudgeSpinConvergence(3, 72, 80)).toBe(true);
  });

  it("does not fire on tool loops alone (compaction below the minimum)", () => {
    expect(shouldNudgeSpinConvergence(1, 79, 80)).toBe(false);
    expect(shouldNudgeSpinConvergence(0, 80, 80)).toBe(false);
  });

  it("does not fire on fast compaction alone (tool loops below the ratio)", () => {
    expect(shouldNudgeSpinConvergence(2, 59, 80)).toBe(false); // one round short of 60
    expect(shouldNudgeSpinConvergence(5, 10, 80)).toBe(false);
  });

  it("fires earlier when repeated compaction itself has already consumed two minutes", () => {
    expect(shouldNudgeSpinConvergence(2, 8, 80, SLOW_COMPACTION_CONVERGENCE_MS)).toBe(true);
    expect(shouldNudgeSpinConvergence(2, 7, 80, SLOW_COMPACTION_CONVERGENCE_MS)).toBe(false);
    expect(shouldNudgeSpinConvergence(1, 20, 80, SLOW_COMPACTION_CONVERGENCE_MS)).toBe(false);
  });

  it("stops firing at/after the hard round limit (cap + near-limit nudge own that zone)", () => {
    expect(shouldNudgeSpinConvergence(2, 80, 80)).toBe(false);
    expect(shouldNudgeSpinConvergence(4, 81, 80)).toBe(false);
  });

  it("scales the ratio with the actual budget (max=18 → 0.75 ratio = 13 rounds)", () => {
    expect(shouldNudgeSpinConvergence(2, 13, 18)).toBe(true);
    expect(shouldNudgeSpinConvergence(2, 12, 18)).toBe(false);
  });
});

describe("shouldNudgeElapsedConvergence", () => {
  it("requires both prolonged execution and meaningful tool work", () => {
    expect(shouldNudgeElapsedConvergence(RUN_CONVERGENCE_ELAPSED_MS, RUN_CONVERGENCE_MIN_TOOL_LOOPS)).toBe(true);
    expect(shouldNudgeElapsedConvergence(RUN_CONVERGENCE_ELAPSED_MS - 1, RUN_CONVERGENCE_MIN_TOOL_LOOPS)).toBe(false);
    expect(shouldNudgeElapsedConvergence(RUN_CONVERGENCE_ELAPSED_MS, RUN_CONVERGENCE_MIN_TOOL_LOOPS - 1)).toBe(false);
  });

});