@pythonluvr/openwar 0.4.0

package/dist/coordinator/cost-tracker.js

@@ -0,0 +1,63 @@
+// Cost ledger for one coordinator run. Tracks tokens, wall-clock, and tool
+// calls per sub-task. Pure data structure + small helpers; the driver
+// updates it after each role invocation.
+//
+// Tokenization fidelity: when an adapter surfaces token usage in its done
+// event we use that count; otherwise we fall back to chars/4. This is an
+// approximation, called out in CHANGELOG; not a real tokenizer. Brief
+// explicitly allows it.
+export function newCostUsage(now = () => new Date()) {
+    return {
+        tokens_used: 0,
+        wall_clock_ms: 0,
+        tool_calls: 0,
+        tool_calls_by_subtask: {},
+        started_at: now().toISOString(),
+    };
+}
+export function estimateTokens(text) {
+    // chars/4 heuristic. Documented in CHANGELOG.
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+export function addTokens(usage, tokens) {
+    if (!Number.isFinite(tokens) || tokens <= 0)
+        return;
+    usage.tokens_used += tokens;
+}
+export function setWallClock(usage, ms) {
+    usage.wall_clock_ms = Math.max(usage.wall_clock_ms, ms);
+}
+export function recordToolCall(usage, subtaskId) {
+    usage.tool_calls += 1;
+    if (subtaskId) {
+        usage.tool_calls_by_subtask[subtaskId] =
+            (usage.tool_calls_by_subtask[subtaskId] ?? 0) + 1;
+    }
+}
+// Check every budget dimension. Returns the first metric that exceeded its
+// limit (deterministic ordering: tokens, then wall_clock_ms, then tool calls
+// for the current sub-task). Tool-call budget is per-sub-task; tokens and
+// wall-clock are run-wide.
+export function checkBudgets(usage, budgets, current_subtask_id) {
+    if (usage.tokens_used > budgets.max_tokens) {
+        return { exceeded: "tokens", used: usage.tokens_used, limit: budgets.max_tokens };
+    }
+    const wallLimit = budgets.max_wall_clock_minutes * 60 * 1000;
+    if (usage.wall_clock_ms > wallLimit) {
+        return { exceeded: "wall_clock_ms", used: usage.wall_clock_ms, limit: wallLimit };
+    }
+    if (current_subtask_id) {
+        const used = usage.tool_calls_by_subtask[current_subtask_id] ?? 0;
+        if (used > budgets.max_tool_calls_per_subtask) {
+            return {
+                exceeded: "tool_calls",
+                used,
+                limit: budgets.max_tool_calls_per_subtask,
+            };
+        }
+    }
+    return { exceeded: null, used: 0, limit: 0 };
+}
+//# sourceMappingURL=cost-tracker.js.map

package/dist/coordinator/cost-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.js","sourceRoot":"","sources":["../../src/coordinator/cost-tracker.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,sEAAsE;AACtE,yCAAyC;AACzC,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,sEAAsE;AACtE,wBAAwB;AAIxB,MAAM,UAAU,YAAY,CAAC,MAAkB,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;IAC7D,OAAO;QACL,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,qBAAqB,EAAE,EAAE;QACzB,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,8CAA8C;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,MAAc;IACxD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO;IACpD,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAgB,EAAE,EAAU;IACvD,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAgB,EAAE,SAAwB;IACvE,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;IACtB,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,qBAAqB,CAAC,SAAS,CAAC;YACpC,CAAC,KAAK,CAAC,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAUD,2EAA2E;AAC3E,6EAA6E;AAC7E,0EAA0E;AAC1E,2BAA2B;AAC3B,MAAM,UAAU,YAAY,CAC1B,KAAgB,EAChB,OAAgB,EAChB,kBAAiC;IAEjC,IAAI,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QAC3C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;IACpF,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,sBAAsB,GAAG,EAAE,GAAG,IAAI,CAAC;IAC7D,IAAI,KAAK,CAAC,aAAa,GAAG,SAAS,EAAE,CAAC;QACpC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACpF,CAAC;IACD,IAAI,kBAAkB,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,IAAI,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;YAC9C,OAAO;gBACL,QAAQ,EAAE,YAAY;gBACtB,IAAI;gBACJ,KAAK,EAAE,OAAO,CAAC,0BAA0B;aAC1C,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/coordinator/driver.d.ts

@@ -0,0 +1,37 @@
+import type { AgentAdapter, Brief, Budgets, CoordinatorEvent, CoordinatorState, CostUsage, Message, RoleId, RunnerIO, RunResult, SubTaskState, ToolDefinition } from "../types.js";
+import { type MachineSnapshot } from "./state-machine.js";
+import type { SandboxContext } from "../sandbox/types.js";
+import type { ToolExecutor } from "../tools/types.js";
+export interface RunCoordinatorOptions {
+    brief: Brief;
+    framework: string;
+    adapter: AgentAdapter;
+    io: RunnerIO;
+    roleIds: RoleId[];
+    budgets: Budgets;
+    toolDefinitions: ToolDefinition[];
+    toolExecutors: Map<string, ToolExecutor>;
+    sandbox: SandboxContext;
+    onSnapshot: (s: MachineSnapshot, ev: CoordinatorEvent[]) => void;
+    sessionApproved: string[];
+    onMessage: (m: Message) => void;
+    initialSnapshot?: MachineSnapshot;
+    signal?: AbortSignal;
+    sessionId: string;
+    onApproval: (a: {
+        action: string;
+        approved: boolean;
+        session_categories?: string[];
+    }) => void;
+}
+export interface CoordinatorRunResult extends Omit<RunResult, "session_id"> {
+    session_id: string;
+    final_state: CoordinatorState;
+    snapshot: MachineSnapshot;
+    cost: CostUsage;
+    events: CoordinatorEvent[];
+}
+export declare function runCoordinator(opts: RunCoordinatorOptions): Promise<CoordinatorRunResult>;
+export declare function newSubtaskState(id: string): SubTaskState;
+export declare function resolveBudgets(brief: Brief): Budgets;
+//# sourceMappingURL=driver.d.ts.map

package/dist/coordinator/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/coordinator/driver.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,YAAY,EACZ,KAAK,EACL,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EAET,OAAO,EAIP,MAAM,EACN,QAAQ,EACR,SAAS,EAET,YAAY,EAEZ,cAAc,EAEf,MAAM,aAAa,CAAC;AAOrB,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,oBAAoB,CAAC;AAW5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,EAAE,EAAE,QAAQ,CAAC;IAEb,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,OAAO,EAAE,OAAO,CAAC;IAEjB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,OAAO,EAAE,cAAc,CAAC;IAGxB,UAAU,EAAE,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;IAEjE,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAGhC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,SAAS,EAAE,MAAM,CAAC;IAElB,UAAU,EAAE,CAAC,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/F;AAED,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAID,wBAAsB,cAAc,CAClC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CA6P/B;AAkfD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAExD;AAGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAWpD"}