@open330/oac 2026.2.5

package/dist/budget/index.d.ts

@@ -0,0 +1,117 @@
+import { E as Epic } from '../types-Ck7IucqK.js';
+
+type AgentProviderId = "claude-code" | "codex" | "opencode" | string;
+type TaskSource = "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "custom";
+type TaskComplexity = "trivial" | "simple" | "moderate" | "complex";
+type ExecutionMode = "new-pr" | "update-pr" | "direct-commit";
+interface Task {
+    id: string;
+    source: TaskSource;
+    title: string;
+    description: string;
+    targetFiles: string[];
+    priority: number;
+    complexity: TaskComplexity;
+    executionMode: ExecutionMode;
+    linkedIssue?: {
+        number: number;
+        url: string;
+        labels: string[];
+    };
+    metadata: Record<string, unknown>;
+    discoveredAt: string;
+}
+interface TokenEstimate {
+    taskId: string;
+    providerId: AgentProviderId;
+    contextTokens: number;
+    promptTokens: number;
+    expectedOutputTokens: number;
+    totalEstimatedTokens: number;
+    confidence: number;
+    feasible: boolean;
+    estimatedCostUsd?: number;
+}
+interface TokenCounter {
+    countTokens(text: string): number;
+    readonly invocationOverhead: number;
+    readonly maxContextTokens: number;
+    /** Free any cached resources (e.g. tiktoken encoders). Optional. */
+    reset?(): void;
+}
+/**
+ * Free cached tiktoken encoders held by the module-level counter singletons.
+ * Useful for reclaiming memory in long-lived processes or between test runs.
+ */
+declare function resetCounters(): void;
+declare function estimateTokens(task: Task, provider: AgentProviderId): Promise<TokenEstimate>;
+/**
+ * Estimate tokens for an entire epic by summing subtask estimates
+ * plus a 20% context overhead for shared module understanding.
+ */
+declare function estimateEpicTokens(epic: Epic, provider: AgentProviderId): Promise<number>;
+
+declare function estimateLocChanges(task: Task): number;
+declare function analyzeTaskComplexity(task: Task): TaskComplexity;
+
+type DeferredReason = "budget_exceeded" | "low_confidence" | "too_complex";
+interface ExecutionPlan {
+    totalBudget: number;
+    selectedTasks: Array<{
+        task: Task;
+        estimate: TokenEstimate;
+        cumulativeBudgetUsed: number;
+    }>;
+    deferredTasks: Array<{
+        task: Task;
+        estimate: TokenEstimate;
+        reason: DeferredReason;
+    }>;
+    reserveTokens: number;
+    remainingTokens: number;
+}
+declare function buildExecutionPlan(tasks: Task[], estimates: Map<string, TokenEstimate>, budget: number): ExecutionPlan;
+interface EpicExecutionPlan {
+    totalBudget: number;
+    selectedEpics: Array<{
+        epic: Epic;
+        estimatedTokens: number;
+        cumulativeBudgetUsed: number;
+    }>;
+    deferredEpics: Array<{
+        epic: Epic;
+        estimatedTokens: number;
+        reason: "budget_exceeded";
+    }>;
+    reserveTokens: number;
+    remainingTokens: number;
+}
+/**
+ * Build an execution plan for epics. Unlike task-level planning, epics are
+ * sorted purely by priority (not priority/tokens ratio) since they are
+ * already coherent units of work.
+ */
+declare function buildEpicExecutionPlan(epics: Epic[], budget: number): EpicExecutionPlan;
+
+declare class ClaudeTokenCounter {
+    readonly invocationOverhead = 1500;
+    readonly maxContextTokens = 200000;
+    readonly encoding = "cl100k_base";
+    countTokens(text: string): number;
+    /** Free the cached tiktoken encoder so it can be re-created on next use. */
+    reset(): void;
+}
+
+declare const PRIMARY_ENCODING = "o200k_base";
+declare const FALLBACK_ENCODING = "cl100k_base";
+type SupportedCodexEncoding = typeof PRIMARY_ENCODING | typeof FALLBACK_ENCODING;
+declare class CodexTokenCounter {
+    readonly invocationOverhead = 1000;
+    readonly maxContextTokens = 200000;
+    get encoding(): SupportedCodexEncoding;
+    countTokens(text: string): number;
+    /** Free the cached tiktoken encoder so it can be re-created on next use. */
+    reset(): void;
+}
+
+export { type AgentProviderId, ClaudeTokenCounter, CodexTokenCounter, type EpicExecutionPlan, type ExecutionMode, type ExecutionPlan, type Task, type TaskComplexity, type TaskSource, type TokenCounter, type TokenEstimate, analyzeTaskComplexity, buildEpicExecutionPlan, buildExecutionPlan, estimateEpicTokens, estimateLocChanges, estimateTokens, resetCounters };

package/dist/budget/index.js

@@ -0,0 +1,23 @@
+import {
+  ClaudeTokenCounter,
+  CodexTokenCounter,
+  analyzeTaskComplexity,
+  buildEpicExecutionPlan,
+  buildExecutionPlan,
+  estimateEpicTokens,
+  estimateLocChanges,
+  estimateTokens,
+  resetCounters
+} from "../chunk-5GAUWC3L.js";
+export {
+  ClaudeTokenCounter,
+  CodexTokenCounter,
+  analyzeTaskComplexity,
+  buildEpicExecutionPlan,
+  buildExecutionPlan,
+  estimateEpicTokens,
+  estimateLocChanges,
+  estimateTokens,
+  resetCounters
+};
+//# sourceMappingURL=index.js.map

package/dist/budget/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}