agent-afk 5.1.0 → 5.2.0

package/dist/telemetry/schemas.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export declare const ForgeTelemEntrySchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    surface: z.ZodEnum<{
+        afk: "afk";
+        plugin: "plugin";
+    }>;
+    event: z.ZodString;
+}, z.core.$catchall<z.ZodUnknown>>;
+export type ForgeTelemEntry = z.infer<typeof ForgeTelemEntrySchema>;

package/dist/utils/CircularBuffer.d.ts

@@ -0,0 +1,13 @@
+export declare class CircularBuffer<T> {
+    private capacity;
+    private buffer;
+    private head;
+    private size;
+    constructor(capacity: number);
+    add(item: T): void;
+    addAll(items: T[]): void;
+    getRecent(count: number): T[];
+    toArray(): T[];
+    clear(): void;
+    length(): number;
+}

package/dist/utils/cd-on-exit.d.ts

@@ -0,0 +1,5 @@
+export declare function getCdIntentPath(): string;
+export declare function clearCdIntent(): void;
+export declare function recordCdIntent(target: string): void;
+export declare const SHELL_WRAPPER_ENV_VAR = "AFK_SHELL_WRAPPER";
+export declare function shellWrapperActive(): boolean;

package/dist/utils/cleanupRegistry.d.ts

@@ -0,0 +1,2 @@
+export declare function registerCleanup(cleanupFn: () => Promise<void>): () => void;
+export declare function runCleanupFunctions(): Promise<void>;

package/dist/utils/debug.d.ts

@@ -0,0 +1,2 @@
+export declare function isDebugEnabled(): boolean;
+export declare function debugLog(...args: unknown[]): void;

package/dist/utils/diff.d.ts

@@ -0,0 +1,17 @@
+export interface DiffLine {
+    kind: ' ' | '+' | '-';
+    text: string;
+}
+export interface DiffHunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: DiffLine[];
+}
+export interface DiffPayload {
+    hunks: DiffHunk[];
+    addedLines: number;
+    removedLines: number;
+}
+export declare function computeLineDiff(before: string, after: string): DiffPayload | null;

package/dist/utils/envFile.d.ts

@@ -0,0 +1,5 @@
+export declare function atomicWriteFile(filePath: string, contents: string, mode?: number): void;
+export declare function upsertEnvVar(filePath: string, key: string, value: string, keysToRemove?: string[]): void;
+export declare function removeEnvVar(filePath: string, key: string): boolean;
+export declare function readEnvVarFromFile(filePath: string, key: string): string | undefined;
+export declare function readEnvFile(filePath: string): Record<string, string>;

package/dist/utils/envUtils.d.ts

@@ -0,0 +1,2 @@
+export declare function isEnvTruthy(envVar: string | boolean | undefined): boolean;
+export declare function isEnvDefinedFalsy(envVar: string | boolean | undefined): boolean;

package/dist/utils/error-classifiers.d.ts

@@ -0,0 +1,2 @@
+export declare function isRateLimitError(error: unknown): boolean;
+export declare function isNetworkError(error: unknown): boolean;

package/dist/utils/errors.d.ts

@@ -0,0 +1,38 @@
+export declare class ClaudeError extends Error {
+    constructor(message: string);
+}
+export declare class AbortError extends Error {
+    constructor(message?: string);
+}
+export declare class TimeoutError extends Error {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number);
+}
+export declare class HookBlockedError extends Error {
+    readonly event: string;
+    readonly reason?: string | undefined;
+    readonly cause?: unknown;
+    constructor(message: string, event: string, reason?: string | undefined, options?: {
+        cause?: unknown;
+    });
+}
+export declare class ShellError extends Error {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly code: number;
+    readonly interrupted: boolean;
+    constructor(stdout: string, stderr: string, code: number, interrupted: boolean);
+}
+export declare function isAbortError(e: unknown): boolean;
+export declare class BudgetExceededError extends Error {
+    readonly runningCostUsd: number;
+    readonly maxBudgetUsd: number;
+    constructor(runningCostUsd: number, maxBudgetUsd: number, message?: string);
+}
+export declare class UnsupportedProviderConfigError extends Error {
+    readonly provider: string;
+    readonly field: string;
+    constructor(provider: string, field: string, message?: string);
+}
+export declare function toError(e: unknown): Error;
+export declare function errorMessage(e: unknown): string;

package/dist/utils/json.d.ts

@@ -0,0 +1 @@
+export declare function safeParseJSON(text: string): unknown;

package/dist/utils/memoize.d.ts

@@ -0,0 +1,9 @@
+type MemoizedFunction<Args extends unknown[], Result> = {
+    (...args: Args): Result;
+    cache: {
+        clear: () => void;
+    };
+};
+export declare function memoizeSimple<T>(fn: () => T): () => T;
+export declare function memoizeWithTTL<Args extends unknown[], Result>(fn: (...args: Args) => Result, ttlMs?: number): MemoizedFunction<Args, Result>;
+export {};

package/dist/utils/prompt-secret.d.ts

@@ -0,0 +1 @@
+export declare function promptSecret(question: string): Promise<string>;

package/dist/utils/terminal-sanitize.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizeForDisplay(s: string): string;
+export declare function stripEscapeSequences(s: string): string;

package/dist/web/extract.d.ts

@@ -0,0 +1,3 @@
+import type { ExtractedContent } from './types.js';
+export declare const THIN_CONTENT_CHARS = 200;
+export declare function extractReadableMarkdown(html: string, url: string): ExtractedContent;

package/dist/web/index.d.ts

@@ -0,0 +1,6 @@
+export { extractReadableMarkdown, THIN_CONTENT_CHARS } from './extract.js';
+export { scrapeToMarkdown } from './scrape.js';
+export type { ScrapeOptions, ScrapeResult } from './scrape.js';
+export { createExaSearchBackend, resolveSearchBackend, formatSearchResults, } from './search.js';
+export type { ExaBackendOptions, ResolveSearchOptions } from './search.js';
+export type { ExtractedContent, FetchFn, RenderFn, RenderedPage, SearchBackend, SearchResult, } from './types.js';

package/dist/web/scrape.d.ts

@@ -0,0 +1,14 @@
+import type { FetchFn, RenderFn } from './types.js';
+export interface ScrapeOptions {
+    fetchFn?: FetchFn;
+    renderFn?: RenderFn;
+    timeoutMs: number;
+    signal: AbortSignal;
+}
+export interface ScrapeResult {
+    title: string;
+    markdown: string;
+    finalUrl: string;
+    usedRender: boolean;
+}
+export declare function scrapeToMarkdown(url: string, opts: ScrapeOptions): Promise<ScrapeResult>;

package/dist/web/search.d.ts

@@ -0,0 +1,14 @@
+import type { FetchFn, SearchBackend, SearchResult } from './types.js';
+export interface ExaBackendOptions {
+    apiKey: string;
+    fetchFn?: FetchFn;
+}
+export declare function createExaSearchBackend(opts: ExaBackendOptions): SearchBackend;
+export interface ResolveSearchOptions {
+    exaApiKey?: string | undefined;
+    fetchFn?: FetchFn;
+}
+export declare function resolveSearchBackend(opts: ResolveSearchOptions): SearchBackend | {
+    error: string;
+};
+export declare function formatSearchResults(query: string, results: SearchResult[]): string;

package/dist/web/types.d.ts

@@ -0,0 +1,29 @@
+export type FetchFn = typeof fetch;
+export type RenderFn = (url: string, opts: {
+    timeoutMs: number;
+    signal: AbortSignal;
+}) => Promise<RenderedPage>;
+export interface RenderedPage {
+    html: string;
+    finalUrl: string;
+    httpStatus: number | null;
+}
+export interface ExtractedContent {
+    title: string;
+    markdown: string;
+    textLength: number;
+    usedFallback: boolean;
+}
+export interface SearchResult {
+    title: string;
+    url: string;
+    description: string;
+}
+export interface SearchBackend {
+    readonly name: string;
+    search(query: string, opts: {
+        limit: number;
+        timeoutMs: number;
+        signal: AbortSignal;
+    }): Promise<SearchResult[]>;
+}

package/package.json

@@ -1,9 +1,18 @@
 {
   "name": "agent-afk",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "Open-source coding-agent harness you can actually change — own the loop (prompts, gates, routing, skills, terminal states), use any model, run long tasks while you're away.",
   "main": "dist/index.mjs",
+  "types": "dist/index.d.ts",
   "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
   "bin": {
     "afk": "dist/cli.mjs"
   },