@compass-ai/nova 1.0.74 → 1.0.76

package/dist/types/swarm.d.ts

@@ -1,132 +0,0 @@
-/**
- * Type definitions for the Swarm/Agent Teams system.
- *
- * A swarm is a coordinated group of agents that can communicate via
- * a shared message queue and shared state store, with dependency-based
- * execution ordering and result routing.
- */
-import type { AgentProcessResult, AgentProcessStatus, BudgetAllocationOptions } from './agent-process.js';
-/**
- * Role an agent plays within a team.
- *
- * - `lead`: Coordinates the team, receives all results, synthesizes output
- * - `worker`: Executes assigned tasks, reports results back
- * - `reviewer`: Reviews other agents' work, provides feedback
- */
-export type TeamRole = 'lead' | 'worker' | 'reviewer';
-/**
- * Status of a team/swarm execution.
- */
-export type TeamStatus = 'pending' | 'running' | 'completed' | 'partial' | 'failed' | 'cancelled';
-/**
- * A message in the team's shared message queue.
- * Agents use these to communicate findings, requests, and results.
- */
-export interface TeamMessage {
-    /** Unique message ID */
-    id: string;
-    /** Team this message belongs to */
-    teamId: string;
-    /** Process ID of the sending agent (or 'system' for system messages) */
-    fromProcessId: string;
-    /** Human-readable sender name */
-    fromAgentName: string;
-    /** Target process ID, or '*' for broadcast, or specific processId */
-    toProcessId: string;
-    /** Message type for filtering */
-    type: 'result' | 'finding' | 'request' | 'status' | 'error';
-    /** Message content */
-    content: string;
-    /** Optional structured data payload */
-    data?: Record<string, unknown>;
-    /** ISO-8601 timestamp */
-    timestamp: string;
-}
-/**
- * A member of a team — maps an agent spawn config to a team role.
- */
-export interface TeamMember {
-    /** Agent type to spawn (e.g., 'explore', 'debugger', 'default') */
-    agentType: string;
-    /** Role within the team */
-    role: TeamRole;
-    /** Task for this specific agent */
-    task: string;
-    /** Additional context to provide */
-    context?: string;
-    /** Process IDs this agent depends on (waits for completion before starting) */
-    dependsOn?: string[];
-    /** Budget overrides */
-    budget?: BudgetAllocationOptions;
-    /** Model override */
-    model?: string;
-    /** Process ID assigned after spawning */
-    processId?: string;
-    /** Current status */
-    status?: AgentProcessStatus;
-    /** Result after completion */
-    result?: AgentProcessResult;
-}
-/**
- * Options for spawning a new team/swarm.
- */
-export interface TeamSpawnOptions {
-    /** Human-readable team goal/objective */
-    goal: string;
-    /** Members to spawn */
-    members: TeamMember[];
-    /** Project root directory */
-    projectRoot?: string;
-    /** Parent tool call ID for UI status */
-    parentToolCallId?: string;
-}
-/**
- * Full team state — tracks all members, messages, and shared state.
- */
-export interface TeamState {
-    /** Unique team ID (UUID) */
-    teamId: string;
-    /** Team goal/objective */
-    goal: string;
-    /** Current team status */
-    status: TeamStatus;
-    /** Team members with their runtime state */
-    members: TeamMember[];
-    /** Message queue */
-    messages: TeamMessage[];
-    /** Shared key-value state store accessible by all agents */
-    sharedState: Record<string, unknown>;
-    /** ISO-8601 creation timestamp */
-    createdAt: string;
-    /** ISO-8601 completion timestamp */
-    completedAt?: string;
-    /** Aggregated results from all members */
-    results: TeamMemberResult[];
-}
-/**
- * Result from a single team member.
- */
-export interface TeamMemberResult {
-    /** Process ID */
-    processId: string;
-    /** Agent type */
-    agentType: string;
-    /** Role in the team */
-    role: TeamRole;
-    /** The agent's response */
-    content: string;
-    /** Whether it succeeded */
-    success: boolean;
-    /** Error if failed */
-    error?: string;
-    /** Token usage */
-    tokensUsed: number;
-    /** Turn count */
-    turnsUsed: number;
-    /** Duration in ms */
-    durationMs: number;
-}
-export declare function isTeamRole(value: unknown): value is TeamRole;
-export declare function isTeamStatus(value: unknown): value is TeamStatus;
-export declare function isTerminalTeamStatus(status: TeamStatus): boolean;
-//# sourceMappingURL=swarm.d.ts.map

package/dist/types/swarm.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/types/swarm.ts"],"names":[],"mappings":"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"}

package/dist/types/swarm.js

@@ -1,21 +0,0 @@
-/**
- * Type definitions for the Swarm/Agent Teams system.
- *
- * A swarm is a coordinated group of agents that can communicate via
- * a shared message queue and shared state store, with dependency-based
- * execution ordering and result routing.
- */
-// =============================================================================
-// Type Guards
-// =============================================================================
-export function isTeamRole(value) {
-    return typeof value === 'string' && ['lead', 'worker', 'reviewer'].includes(value);
-}
-export function isTeamStatus(value) {
-    return (typeof value === 'string' &&
-        ['pending', 'running', 'completed', 'partial', 'failed', 'cancelled'].includes(value));
-}
-export function isTerminalTeamStatus(status) {
-    return ['completed', 'partial', 'failed', 'cancelled'].includes(status);
-}
-//# sourceMappingURL=swarm.js.map

package/dist/types/swarm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"swarm.js","sourceRoot":"","sources":["../../src/types/swarm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuMH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CACtF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1E,CAAC"}

package/dist/types/token-limits.d.ts

@@ -1,107 +0,0 @@
-/**
- * Type definitions for per-model and per-provider token limit system.
- *
- * This module defines all interfaces and error types used by the granular
- * daily token limit feature. Limits are opt-in — when `tokenLimits` is
- * absent from config all enforcement is a no-op and existing behaviour is
- * preserved.
- *
- * Limit hierarchy (first non-zero limit that applies wins):
- *   model-level → provider-level → (global fallback in token-tracker)
- *
- * A value of 0 (or undefined) at any level means "no limit at this level".
- */
-/**
- * Per-model token limit configuration.
- * Applied to a specific model ID within a provider's model map.
- */
-export interface ModelTokenLimits {
-    /**
-     * Maximum tokens allowed per reset window for this model.
-     * 0 or undefined = no limit at model level (falls through to provider limit).
-     */
-    dailyLimit?: number;
-}
-/**
- * Per-provider token limit configuration.
- * Aggregates across all models under the provider.
- */
-export interface ProviderTokenLimits {
-    /**
-     * Maximum aggregate tokens allowed per reset window across all models
-     * for this provider. 0 or undefined = no provider-level limit.
-     */
-    dailyLimit?: number;
-    /**
-     * Per-model overrides within this provider.
-     * Keys are model IDs (normalized to lowercase).
-     */
-    models?: Record<string, ModelTokenLimits>;
-}
-/**
- * Top-level token limit configuration stored in CompassConfig.
- * All fields are optional — omitting the entire block disables the feature.
- */
-export interface TokenLimitConfig {
-    /**
-     * Per-provider limit definitions.
-     * Keys are provider names (e.g. 'anthropic', 'ollama') normalized to lowercase.
-     */
-    providers?: Record<string, ProviderTokenLimits>;
-    /**
-     * Length of the rolling usage window in hours.
-     * Defaults to ROLLING_WINDOW_HOURS (6) from constants/token-limits.
-     * The window starts at first usage and resets after this many hours.
-     */
-    resetWindowHours?: number;
-}
-/**
- * Which limit scope was responsible for a check result.
- */
-export type LimitScope = 'provider' | 'model';
-/**
- * Result of a token limit pre-flight check.
- * Returned when a check passes; errors are thrown as TokenLimitExceededError.
- */
-export interface TokenLimitCheckResult {
-    /** Whether the call is allowed to proceed */
-    allowed: boolean;
-    /** Which limit scope was evaluated (provider or model) */
-    scope: LimitScope;
-    /** The configured limit value that was checked */
-    limitValue: number;
-    /** Current usage within the window at time of check */
-    currentUsage: number;
-    /** Unix timestamp (ms) when the current window resets */
-    resetAt: number;
-}
-/**
- * Thrown by TokenLimitEnforcer when a configured daily limit would be exceeded.
- *
- * Callers should catch this error and surface a human-readable message to the
- * user that includes the reset time. The error carries all context needed to
- * build that message without additional store lookups.
- */
-export declare class TokenLimitExceededError extends Error {
-    /** Which limit scope was exceeded */
-    readonly scope: LimitScope;
-    /** Provider name (lowercase) */
-    readonly provider: string;
-    /** Model ID (lowercase) */
-    readonly model: string;
-    /** The configured limit that was exceeded */
-    readonly limitValue: number;
-    /** Current usage at the time the limit was hit */
-    readonly currentUsage: number;
-    /** Unix timestamp (ms) when the window resets and usage clears */
-    readonly resetAt: number;
-    constructor(params: {
-        scope: LimitScope;
-        provider: string;
-        model: string;
-        limitValue: number;
-        currentUsage: number;
-        resetAt: number;
-    });
-}
-//# sourceMappingURL=token-limits.d.ts.map

package/dist/types/token-limits.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token-limits.d.ts","sourceRoot":"","sources":["../../src/types/token-limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAEhD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAUD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IAEjB,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC;IAElB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IAEnB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IAErB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE;QAClB,KAAK,EAAE,UAAU,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB;CAwBF"}

package/dist/types/token-limits.js

@@ -1,57 +0,0 @@
-/**
- * Type definitions for per-model and per-provider token limit system.
- *
- * This module defines all interfaces and error types used by the granular
- * daily token limit feature. Limits are opt-in — when `tokenLimits` is
- * absent from config all enforcement is a no-op and existing behaviour is
- * preserved.
- *
- * Limit hierarchy (first non-zero limit that applies wins):
- *   model-level → provider-level → (global fallback in token-tracker)
- *
- * A value of 0 (or undefined) at any level means "no limit at this level".
- */
-// =============================================================================
-// Error class
-// =============================================================================
-/**
- * Thrown by TokenLimitEnforcer when a configured daily limit would be exceeded.
- *
- * Callers should catch this error and surface a human-readable message to the
- * user that includes the reset time. The error carries all context needed to
- * build that message without additional store lookups.
- */
-export class TokenLimitExceededError extends Error {
-    /** Which limit scope was exceeded */
-    scope;
-    /** Provider name (lowercase) */
-    provider;
-    /** Model ID (lowercase) */
-    model;
-    /** The configured limit that was exceeded */
-    limitValue;
-    /** Current usage at the time the limit was hit */
-    currentUsage;
-    /** Unix timestamp (ms) when the window resets and usage clears */
-    resetAt;
-    constructor(params) {
-        const resetDate = new Date(params.resetAt);
-        const resetStr = resetDate.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
-        const scopeLabel = params.scope === 'model'
-            ? `model "${params.model}"`
-            : `provider "${params.provider}"`;
-        super(`Daily token limit exceeded for ${scopeLabel}. ` +
-            `Used ${params.currentUsage.toLocaleString()} / ${params.limitValue.toLocaleString()} tokens. ` +
-            `Resets at ${resetStr}.`);
-        this.name = 'TokenLimitExceededError';
-        this.scope = params.scope;
-        this.provider = params.provider;
-        this.model = params.model;
-        this.limitValue = params.limitValue;
-        this.currentUsage = params.currentUsage;
-        this.resetAt = params.resetAt;
-        // Maintain proper prototype chain for instanceof checks
-        Object.setPrototypeOf(this, TokenLimitExceededError.prototype);
-    }
-}
-//# sourceMappingURL=token-limits.js.map

package/dist/types/token-limits.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"token-limits.js","sourceRoot":"","sources":["../../src/types/token-limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAyFH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,qCAAqC;IAC5B,KAAK,CAAa;IAE3B,gCAAgC;IACvB,QAAQ,CAAS;IAE1B,2BAA2B;IAClB,KAAK,CAAS;IAEvB,6CAA6C;IACpC,UAAU,CAAS;IAE5B,kDAAkD;IACzC,YAAY,CAAS;IAE9B,kEAAkE;IACzD,OAAO,CAAS;IAEzB,YAAY,MAOX;QACC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,SAAS,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1F,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,KAAK,OAAO;YACzC,CAAC,CAAC,UAAU,MAAM,CAAC,KAAK,GAAG;YAC3B,CAAC,CAAC,aAAa,MAAM,CAAC,QAAQ,GAAG,CAAC;QAEpC,KAAK,CACH,kCAAkC,UAAU,IAAI;YAChD,QAAQ,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,WAAW;YAC/F,aAAa,QAAQ,GAAG,CACzB,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAE9B,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/types/token.d.ts

@@ -1,329 +0,0 @@
-/**
- * Type definitions for token tracking and cost estimation
- *
- * This module defines all TypeScript interfaces and types used for tracking
- * API token usage, calculating costs, and managing usage warnings throughout
- * the Compass CLI application.
- */
-/**
- * Token usage statistics from a single API call or aggregated session.
- * Represents the breakdown of input and output tokens consumed.
- */
-export interface TokenUsage {
-    /** Number of tokens in the input/prompt */
-    inputTokens: number;
-    /** Number of tokens in the output/response */
-    outputTokens: number;
-    /** Total tokens (input + output) */
-    totalTokens: number;
-    /** Optional tokens used for cache creation */
-    cacheCreationInputTokens?: number;
-    /** Optional tokens read from cache */
-    cacheReadInputTokens?: number;
-}
-/**
- * Token usage tracking for an entire session.
- * Aggregates multiple API calls with their individual usage statistics.
- */
-export interface SessionTokenUsage {
-    /** Unique identifier for the session */
-    sessionId: string;
-    /** ISO-8601 timestamp when the session started */
-    startTime: string;
-    /** ISO-8601 timestamp when the session ended (if completed) */
-    endTime?: string;
-    /** Array of individual API call usage records */
-    calls: APICallTokenUsage[];
-    /** Aggregated totals for the entire session */
-    totals: TokenUsage;
-    /** Estimated cost for the entire session */
-    estimatedCost: CostEstimate;
-}
-/**
- * Token usage record for a single API call.
- * Includes metadata about the call for tracking and analysis.
- */
-export interface APICallTokenUsage {
-    /** Unique identifier for this API call */
-    id: string;
-    /** ISO-8601 timestamp when the call was made */
-    timestamp: string;
-    /** Model ID used for the API call */
-    model: string;
-    /** Token usage statistics for this call */
-    usage: TokenUsage;
-    /** Cost estimate for this call */
-    cost: CostEstimate;
-    /** Optional description of the call's purpose */
-    purpose?: string;
-}
-/**
- * Aggregated metrics for token usage analysis.
- * Provides statistical summaries for reporting and monitoring.
- */
-export interface TokenMetrics {
-    /** Average input tokens per API call */
-    averageInputTokens: number;
-    /** Average output tokens per API call */
-    averageOutputTokens: number;
-    /** Maximum input tokens in a single call */
-    peakInputTokens: number;
-    /** Maximum output tokens in a single call */
-    peakOutputTokens: number;
-    /** Total number of API calls */
-    totalCalls: number;
-    /** Total tokens across all calls */
-    totalTokens: number;
-    /** Total cost across all calls in USD */
-    totalCost: number;
-}
-/**
- * Cost estimate breakdown for token usage.
- * Separates input and output costs for detailed analysis.
- */
-export interface CostEstimate {
-    /** Cost for input tokens in the specified currency */
-    inputCost: number;
-    /** Cost for output tokens in the specified currency */
-    outputCost: number;
-    /** Total cost (input + output) */
-    totalCost: number;
-    /** Currency code (e.g., 'USD') */
-    currency: string;
-}
-/**
- * Calculated cost payload sent to backend for usage tracking.
- * Contains pre-calculated costs for all token types including cache operations.
- */
-export interface CalculatedCost {
-    /** Cost for regular input tokens (non-cached) */
-    inputCost: number;
-    /** Cost for output tokens */
-    outputCost: number;
-    /** Cost for cache creation (writing to cache) */
-    cacheCreationCost: number;
-    /** Cost for cache read (reading from cache - typically 10% of input cost) */
-    cacheReadCost: number;
-    /** Total cost (input + output + cache creation + cache read) */
-    totalCost: number;
-    /** Currency code (e.g., 'USD') */
-    currency: string;
-    /** ISO-8601 timestamp when cost was calculated */
-    calculatedAt: string;
-}
-/**
- * Full usage tracking payload sent to backend.
- * Includes both raw token counts and pre-calculated costs.
- */
-export interface UsageTrackingPayload {
-    /** Number of input tokens */
-    input_tokens: number;
-    /** Number of cache write tokens */
-    cache_write_input_tokens: number;
-    /** Number of cache read tokens */
-    cache_read_input_tokens: number;
-    /** Number of output tokens */
-    output_tokens: number;
-    /** LLM provider name */
-    provider: string;
-    /** Model identifier */
-    model: string;
-    /** Pre-calculated costs */
-    cost: CalculatedCost;
-}
-/**
- * Warning generated when token usage exceeds thresholds.
- * Used to alert users about high usage or costs.
- */
-export interface TokenWarning {
-    /** Type of warning condition */
-    type: 'approaching_limit' | 'exceeded_threshold' | 'high_cost';
-    /** Human-readable warning message */
-    message: string;
-    /** Current value that triggered the warning */
-    currentValue: number;
-    /** Threshold value that was approached or exceeded */
-    threshold: number;
-    /** Severity level of the warning */
-    severity: 'info' | 'warning' | 'critical';
-}
-/**
- * Pricing information for a specific model.
- * Used to calculate costs based on token usage.
- */
-export interface ModelPricing {
-    /** Cost per million input tokens in USD */
-    inputPricePerMillion: number;
-    /** Cost per million output tokens in USD */
-    outputPricePerMillion: number;
-    /** Optional cost per million cache creation tokens */
-    cacheCreationPricePerMillion?: number;
-    /** Optional cost per million cache read tokens */
-    cacheReadPricePerMillion?: number;
-}
-/**
- * Budget configuration for token usage limits.
- * Allows users to set spending and usage caps.
- */
-export interface TokenBudget {
-    /** Maximum tokens allowed per session */
-    maxTokensPerSession: number;
-    /** Maximum cost allowed per session in USD */
-    maxCostPerSession: number;
-    /** Percentage of budget at which to show warnings (0-100) */
-    warningThresholdPercent: number;
-}
-/**
- * Daily token usage summary for historical tracking.
- * Used for generating usage reports and trends.
- */
-export interface DailyTokenUsage {
-    /** Date in YYYY-MM-DD format */
-    date: string;
-    /** Total tokens used on this date */
-    totalTokens: number;
-    /** Total cost on this date */
-    totalCost: number;
-    /** Number of API calls on this date */
-    callCount: number;
-    /** Breakdown by model */
-    byModel: Record<string, {
-        tokens: number;
-        cost: number;
-        calls: number;
-    }>;
-}
-/**
- * Monthly token usage summary for billing and reporting.
- */
-export interface MonthlyTokenUsage {
-    /** Month in YYYY-MM format */
-    month: string;
-    /** Total tokens used in the month */
-    totalTokens: number;
-    /** Total cost for the month */
-    totalCost: number;
-    /** Number of API calls in the month */
-    callCount: number;
-    /** Number of active sessions in the month */
-    sessionCount: number;
-    /** Daily breakdown */
-    dailyUsage: DailyTokenUsage[];
-}
-/**
- * Context window usage breakdown by category.
- * Used for detailed context window analysis and optimization.
- */
-export interface ContextBreakdown {
-    /** Tokens used by the system prompt */
-    systemPrompt: number;
-    /** Tokens used by conversation history */
-    conversationHistory: number;
-    /** Tokens used by file context */
-    fileContext: number;
-    /** Tokens reserved for output generation */
-    reservedForOutput: number;
-    /** Any other tokens not categorized */
-    other: number;
-}
-/**
- * Result of a context health check.
- * Provides status and recommendations for context usage.
- */
-export interface ContextHealthStatus {
-    /** Whether context usage is within healthy limits */
-    healthy: boolean;
-    /** Current usage percentage of context window */
-    usagePercent: number;
-    /** Warning message if applicable */
-    warning: string | null;
-    /** Number of tokens available for new content */
-    availableTokens: number;
-    /** Recommended action if usage is high */
-    recommendation?: string;
-}
-/**
- * Token usage export format for data portability.
- * Contains all usage data in a portable format.
- */
-export interface TokenUsageExport {
-    /** Export format version */
-    version: string;
-    /** ISO-8601 timestamp of export */
-    exportedAt: string;
-    /** All session usage data */
-    sessions: SessionTokenUsage[];
-    /** Aggregated all-time metrics */
-    allTimeMetrics: TokenMetrics;
-    /** Monthly summaries */
-    monthlySummaries?: MonthlyTokenUsage[];
-}
-/**
- * Persisted state for the unified token tracking system (v1 schema).
- * Stored in `token-limits-usage.json` in the global data directory.
- *
- * All usage is tracked as flat counters per model. When the 6-hour
- * window expires (Date.now() − windowStart ≥ ROLLING_WINDOW_MS), the
- * entire state is atomically reset — all counters zeroed, windowStart
- * set to now.
- *
- * On-disk shape:
- * ```json
- * {
- *   "version": 1,
- *   "windowStart": 1709500000000,
- *   "providers": {
- *     "anthropic": { "claude-sonnet-4-6": 42000 },
- *     "ollama": { "glm-5:cloud": 18000 }
- *   }
- * }
- * ```
- */
-export interface UnifiedTokenState {
-    /** File format version (must be 1) */
-    version: 1;
-    /** Unix timestamp (ms) when the current 6-hour window started */
-    windowStart: number;
-    /**
-     * Nested usage counters: providers[providerKey][modelId] = tokensUsed.
-     * Both keys are normalised to lowercase.
-     */
-    providers: Record<string, Record<string, number>>;
-}
-/**
- * Per-plan token limit configuration for a single plan status.
- * Defines both the aggregate (general) limit and per-model limits.
- */
-export interface PlanTokenLimits {
-    /** Aggregate token limit across all models within the rolling window */
-    generalLimit: number;
-    /** Default per-model limit when no model-specific override exists */
-    defaultPerModelLimit: number;
-    /** Model-specific limit overrides, keyed by model ID */
-    perModelLimits: Record<string, number>;
-}
-/**
- * Result of a unified token limit check.
- * Returned by the unified TokenTracker before an API call proceeds.
- */
-export interface UnifiedLimitCheckResult {
-    /** Whether the API call is allowed to proceed */
-    allowed: boolean;
-    /** Remaining tokens in the general (aggregate) bucket */
-    generalRemaining: number;
-    /** Remaining tokens for the specific model */
-    modelRemaining: number;
-    /** Human-readable reason if the call is blocked */
-    reason?: string;
-}
-/**
- * Configuration for models that should be disabled (unavailable for selection)
- * under certain plan statuses.
- */
-export interface DisabledModelRule {
-    /** Regex pattern matching model IDs to disable */
-    pattern: RegExp;
-    /** Regex patterns for exceptions (models that match pattern but should stay enabled) */
-    exceptions: RegExp[];
-}
-//# sourceMappingURL=token.d.ts.map

package/dist/types/token.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/types/token.ts"],"names":[],"mappings":"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"}