agent-afk 5.295.9 → 5.296.0

package/dist/agent/hooks/command-executor.d.ts

@@ -9,6 +9,8 @@ export interface ExecuteCommandOptions {
     pluginName?: string;
     pluginHookEnv?: Record<string, string[]>;
     transcriptPath?: string | null;
+    pluginOptions?: Record<string, string>;
+    pluginKey?: string;
 }
 export interface CommandExecutorResult {
     decision: HookDecision;

package/dist/agent/hooks/config-loader.d.ts

@@ -19,6 +19,7 @@ export interface ResolvedCommandHook {
     timeoutMs: number;
     pluginRoot?: string;
     pluginName?: string;
+    pluginKey?: string;
 }
 export interface ResolvedMatcherGroup {
     matcher?: string;
@@ -46,11 +47,12 @@ interface SingleFileResult {
     sources: string[];
     warnings: string[];
 }
-export declare function loadHooksConfigFile(path: string, tier: 'user-global' | 'project-local' | 'plugin', pluginRoot?: string, pluginName?: string | null): SingleFileResult;
+export declare function loadHooksConfigFile(path: string, tier: 'user-global' | 'project-local' | 'plugin', pluginRoot?: string, pluginName?: string | null, pluginKey?: string | null): SingleFileResult;
 export declare function discoverPluginHooksConfigs(pluginsRoot?: string): Array<{
     path: string;
     pluginRoot: string;
     pluginName: string | null;
+    pluginKey: string | null;
 }>;
 export interface LoadHooksConfigOptions {
     cwd?: string;

package/dist/agent/hooks/config-loader.plugin-hooks.d.ts

@@ -0,0 +1,17 @@
+import type { HarnessHookEvent } from '../hooks.js';
+import type { ResolvedHooksConfig } from './config-loader.js';
+interface LoadPluginHookConfigsOptions {
+    pluginConfigs: Array<{
+        path: string;
+        pluginRoot: string;
+        pluginName: string | null;
+        pluginKey: string | null;
+    }>;
+    pluginHooksEnabled: boolean;
+    validEvents: HarnessHookEvent[];
+    merged: ResolvedHooksConfig;
+    allSources: string[];
+    allWarnings: string[];
+}
+export declare function loadPluginHookConfigs(opts: LoadPluginHookConfigsOptions): void;
+export {};

package/dist/agent/memory/memory-gc-sweep.d.ts

@@ -0,0 +1,19 @@
+import type { FactCategory } from './types.js';
+export declare const MEMORY_GC_MIN_AGE_DAYS_DEFAULT = 90;
+export declare const MEMORY_GC_SWEEP_MIN_INTERVAL_MS: number;
+export declare const MEMORY_GC_SWEEP_START_DELAY_MS = 7000;
+export declare const MEMORY_ACCESS_TRACKING_STARTED_AT = "2026-09-23T00:00:00.000Z";
+export declare const GC_EXCLUDED_CATEGORIES: ReadonlySet<FactCategory>;
+export interface MemoryGcSweepOptions {
+    memoryDir?: string;
+    minAgeDays?: number;
+    force?: boolean;
+}
+export interface MemoryGcSweepResult {
+    skipped: boolean;
+    skipReason?: 'disabled' | 'too-soon' | 'no-db';
+    candidates: number;
+    archived: number;
+    error?: string;
+}
+export declare function sweepMemoryGc(options?: MemoryGcSweepOptions): Promise<MemoryGcSweepResult>;

package/dist/agent/plugins/index-store.d.ts

@@ -10,6 +10,7 @@ export interface PluginIndexEntry {
     updatedAt: string;
     manifestName?: string;
     marketplace?: string;
+    options?: Record<string, string>;
 }
 export interface MarketplaceIndexEntry {
     source: string;
@@ -34,3 +35,5 @@ export declare function upsertMarketplace(name: string, entry: MarketplaceIndexE
 export declare function removeMarketplace(name: string, path?: string): PluginIndex;
 export declare function isPinnedRef(entry: Pick<PluginIndexEntry, 'ref' | 'pinnedRef'>, defaultBranch: string): boolean;
 export declare function isMarketplacePinnedRef(entry: Pick<MarketplaceIndexEntry, 'ref' | 'pinnedRef'>, defaultBranch: string): boolean;
+export declare function setPluginOption(name: string, key: string, value: string, path?: string): PluginIndex;
+export declare function unsetPluginOption(name: string, key: string, path?: string): PluginIndex;

package/dist/agent/plugins/plugin-user-config.d.ts

@@ -0,0 +1,12 @@
+export interface UserConfigField {
+    type?: string;
+    description?: string;
+    default?: string;
+    sensitive?: boolean;
+}
+export type UserConfigSchema = Record<string, UserConfigField>;
+export type PluginOptionEnv = Record<string, string>;
+export declare function normaliseOptionKey(key: string): string;
+export declare function readUserConfigSchema(dir: string): UserConfigSchema;
+export declare function buildOptionEnv(schema: UserConfigSchema, stored: Record<string, string> | undefined): PluginOptionEnv;
+export declare function validateOptionKey(key: string, schema: UserConfigSchema): 'ok' | string;

package/dist/agent/tools/types.d.ts

@@ -9,6 +9,7 @@ import type { UserAttention } from './user-yield.js';
 import type { DetachableToolRegistry } from './detach-registry.js';
 export interface ToolHandlerContext {
     resolveBase?: string;
+    cwd?: string;
     readRoots?: string[];
     writeRoots?: string[];
     env?: Record<string, string>;

package/dist/agent/usage/burn-rate.d.ts

@@ -0,0 +1,14 @@
+export interface WindowObservationSample {
+    readonly observedAt: number;
+    readonly utilization: number;
+    readonly resetsAt?: number;
+}
+export declare const MIN_SAMPLES = 3;
+export declare const MAX_SAMPLE_AGE_MS: number;
+export interface BurnRateProjection {
+    readonly capsAtMs: number;
+    readonly ratePerMs: number;
+}
+export declare function computeBurnRate(samples: readonly WindowObservationSample[], now: number, resetsAt?: number): BurnRateProjection | null;
+export declare const RING_SIZE: number;
+export declare function appendSample(ring: readonly WindowObservationSample[], sample: WindowObservationSample): WindowObservationSample[];

package/dist/agent/usage/usage-ledger.d.ts

@@ -1,8 +1,9 @@
-import { type PerMinuteObservation, type UsageRecord, type WindowsObservation } from './usage-record.js';
+import { type PerMinuteObservation, type UsageRecord, type WindowHistorySample, type WindowsObservation } from './usage-record.js';
 import type { QuotaSnapshot } from '../quota-cache.js';
 import type { RateLimitSnapshot } from '../providers/shared/rate-limit-bucket.js';
 import type { RateLimitGate } from '../providers/shared/tracing-fetch-utils.js';
 import type { UsageResult } from '../subscription-usage.js';
+export declare function bindingSampleFromWindows(w: WindowsObservation): WindowHistorySample | undefined;
 export declare function resetUsageLedgerForTests(): void;
 export declare function publishUsage(rec: UsageRecord, now?: number): void;
 export declare function readLedgerRecords(): UsageRecord[];

package/dist/agent/usage/usage-record.d.ts

@@ -12,12 +12,18 @@ export interface WindowObservation {
     utilization: number;
     resetsAt?: number;
 }
+export interface WindowHistorySample {
+    readonly observedAt: number;
+    readonly utilization: number;
+    readonly resetsAt?: number;
+}
 export interface WindowsObservation {
     fiveHour?: WindowObservation;
     sevenDay?: WindowObservation;
     sevenDaySonnet?: WindowObservation;
     sevenDayOpus?: WindowObservation;
     observedAt: number;
+    history?: WindowHistorySample[];
 }
 export declare const WINDOW_KEYS: readonly ["fiveHour", "sevenDay", "sevenDaySonnet", "sevenDayOpus"];
 export type WindowKey = (typeof WINDOW_KEYS)[number];
@@ -32,6 +38,8 @@ export interface UsageRecord {
     windows?: WindowsObservation;
 }
 export declare function mergePerMinute(a: PerMinuteObservation | undefined, b: PerMinuteObservation | undefined): PerMinuteObservation | undefined;
+export declare const WINDOWS_HISTORY_MAX = 12;
+export declare function mergeWindowHistory(a: WindowHistorySample[] | undefined, b: WindowHistorySample[] | undefined): WindowHistorySample[] | undefined;
 export declare function mergeWindows(a: WindowsObservation | undefined, b: WindowsObservation | undefined): WindowsObservation | undefined;
 export declare function mergeUsageRecords(existing: UsageRecord | undefined, incoming: UsageRecord): UsageRecord;
 export declare function parseUsageRecord(raw: unknown): UsageRecord | undefined;

package/dist/cli/quota-indicator.d.ts

@@ -1,7 +1,10 @@
 import type { QuotaSnapshot } from '../agent/quota-cache.js';
+import { type UsageRecord } from '../agent/usage/usage-record.js';
+import { type WindowObservationSample } from '../agent/usage/burn-rate.js';
 export interface QuotaWindowState {
     readonly utilization: number;
     readonly resetsAt?: Date;
+    readonly history?: readonly WindowObservationSample[];
 }
 export interface QuotaWindows {
     readonly fiveHour?: QuotaWindowState;
@@ -9,6 +12,7 @@ export interface QuotaWindows {
     readonly observedAt?: Date;
 }
 export declare function quotaWindowsFromSnapshot(snapshot: QuotaSnapshot | undefined): QuotaWindows | undefined;
+export declare function quotaWindowsFromRecord(record: UsageRecord | undefined): QuotaWindows | undefined;
 export type QuotaSeverity = 'calm' | 'caution' | 'critical';
 export interface QuotaIndicator {
     readonly text: string;