@husk-ai/core 0.1.1

package/dist/types/model.d.ts

@@ -0,0 +1,197 @@
+/**
+ * The model contract.
+ *
+ * One surface over Anthropic, OpenAI, Google, Groq, OpenRouter, Ollama, LM Studio
+ * and anything else that speaks tool-calling chat. Providers translate; callers do not.
+ */
+export type Role = 'system' | 'user' | 'assistant' | 'tool';
+export interface TextPart {
+    type: 'text';
+    text: string;
+}
+export interface ImagePart {
+    type: 'image';
+    mimeType: string;
+    /** base64, with no data: prefix. */
+    data: string;
+}
+export interface ToolCallPart {
+    type: 'tool_call';
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+export interface ToolResultPart {
+    type: 'tool_result';
+    toolCallId: string;
+    content: string;
+    isError?: boolean;
+}
+export interface ThinkingPart {
+    type: 'thinking';
+    text: string;
+    signature?: string;
+}
+export type ContentPart = TextPart | ImagePart | ToolCallPart | ToolResultPart | ThinkingPart;
+export interface ModelMessage {
+    role: Role;
+    content: string | ContentPart[];
+    /** Present on tool messages so providers that need it can round-trip. */
+    name?: string;
+}
+/** JSON Schema draft-07 subset. Kept loose on purpose, because providers vary. */
+export type JSONSchema = Record<string, unknown>;
+export interface ToolSchema {
+    name: string;
+    description: string;
+    parameters: JSONSchema;
+}
+export type ToolChoice = 'auto' | 'none' | 'required' | {
+    name: string;
+};
+export interface ChatRequest {
+    /** An alias (sonnet, gemma) or a fully-qualified id (anthropic/claude-sonnet-5). */
+    model: string;
+    messages: ModelMessage[];
+    system?: string;
+    tools?: ToolSchema[];
+    toolChoice?: ToolChoice;
+    temperature?: number;
+    topP?: number;
+    maxTokens?: number;
+    stop?: string[];
+    /** Ask for extended reasoning where the provider supports it. */
+    thinking?: {
+        enabled: boolean;
+        budgetTokens?: number;
+    };
+    responseFormat?: {
+        type: 'text';
+    } | {
+        type: 'json';
+        schema?: JSONSchema;
+    };
+    signal?: AbortSignal;
+    metadata?: Record<string, string>;
+}
+export interface Usage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    /** Zero for local models. Estimated from the price table otherwise. */
+    costUsd?: number;
+}
+export type FinishReason = 'stop' | 'length' | 'tool_calls' | 'content_filter' | 'error' | 'aborted';
+export interface ChatResponse {
+    /** Resolved fully-qualified model id. */
+    model: string;
+    text: string;
+    thinking?: string;
+    toolCalls: ToolCallPart[];
+    finishReason: FinishReason;
+    usage: Usage;
+    latencyMs: number;
+    raw?: unknown;
+    /**
+     * Things the caller must know that did not stop the call -- above all, a
+     * fallback to a different model than the one requested.
+     *
+     * The streaming path can emit a `warning` event mid-flight; a single-shot
+     * `chat()` has nowhere else to put one, and without this a request for Opus
+     * that quietly ran on a 1.5B local model comes back as a plain 200. The
+     * substitution is visible in `model`, but only to someone who thought to
+     * compare it against what they asked for.
+     */
+    warnings?: Array<{
+        message: string;
+        code?: string;
+        detail?: Record<string, unknown>;
+    }>;
+}
+export type StreamEvent = {
+    type: 'start';
+    model: string;
+} | {
+    type: 'thinking_delta';
+    text: string;
+} | {
+    type: 'text_delta';
+    text: string;
+} | {
+    type: 'tool_call';
+    call: ToolCallPart;
+} | {
+    type: 'usage';
+    usage: Usage;
+}
+/**
+ * Something the caller must know that did not stop the stream -- most often a
+ * fallback to a different model. Silently answering with a weaker model than
+ * the one that was asked for is worse than failing, so a router that falls
+ * back is required to emit this.
+ */
+ | {
+    type: 'warning';
+    message: string;
+    code?: string;
+    detail?: Record<string, unknown>;
+} | {
+    type: 'done';
+    response: ChatResponse;
+} | {
+    type: 'error';
+    error: {
+        message: string;
+        code?: string;
+        retryable?: boolean;
+    };
+};
+export interface ModelInfo {
+    /** Fully-qualified, as provider slash model. */
+    id: string;
+    provider: string;
+    /** The bare model name the provider expects on the wire. */
+    name: string;
+    displayName: string;
+    contextWindow: number;
+    maxOutputTokens: number;
+    supportsTools: boolean;
+    supportsVision: boolean;
+    supportsStreaming: boolean;
+    supportsThinking?: boolean;
+    /**
+     * USD per million tokens. Absent or zero for local models.
+     *
+     * `cacheWritePerMTok` is separate because writing a cache entry is not priced
+     * as a fraction of input everywhere -- Anthropic charges 1.25x input, others
+     * charge nothing. Deriving it from a single global multiplier is wrong for
+     * every provider but one.
+     */
+    pricing?: {
+        inputPerMTok: number;
+        outputPerMTok: number;
+        cacheReadPerMTok?: number;
+        cacheWritePerMTok?: number;
+    };
+    /** True when the model can be run at no cost, whether local or on a provider free tier. */
+    free?: boolean;
+    tags?: string[];
+}
+export interface ModelProvider {
+    readonly id: string;
+    readonly displayName: string;
+    /** Ordered fallback preference; higher is tried first when a model is ambiguous. */
+    readonly priority: number;
+    isAvailable(): Promise<{
+        available: boolean;
+        reason?: string;
+        hint?: string;
+    }>;
+    listModels(): Promise<ModelInfo[]>;
+    chat(req: ChatRequest): Promise<ChatResponse>;
+    stream(req: ChatRequest): AsyncIterable<StreamEvent>;
+}
+/** Flatten any message content down to plain text. */
+export declare function messageText(m: ModelMessage): string;
+//# sourceMappingURL=model.d.ts.map

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

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

package/dist/types/model.js

@@ -0,0 +1,16 @@
+/**
+ * The model contract.
+ *
+ * One surface over Anthropic, OpenAI, Google, Groq, OpenRouter, Ollama, LM Studio
+ * and anything else that speaks tool-calling chat. Providers translate; callers do not.
+ */
+/** Flatten any message content down to plain text. */
+export function messageText(m) {
+    if (typeof m.content === 'string')
+        return m.content;
+    return m.content
+        .map((p) => (p.type === 'text' ? p.text : p.type === 'tool_result' ? p.content : ''))
+        .filter(Boolean)
+        .join('\n');
+}
+//# sourceMappingURL=model.js.map

package/dist/types/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/types/model.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoKH,sDAAsD;AACtD,MAAM,UAAU,WAAW,CAAC,CAAe;IACzC,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC;IACpD,OAAO,CAAC,CAAC,OAAO;SACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACpF,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/types/transcript.d.ts

@@ -0,0 +1,64 @@
+/** Normalised conversation history, whatever it was exported from. */
+export type TranscriptSource = 'claude-code' | 'claude-web' | 'chatgpt' | 'cursor' | 'openai-api' | 'anthropic-api' | 'markdown' | 'jsonl' | 'gemini' | 'universal' | 'unknown';
+export interface TranscriptMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    ts?: string;
+    /** Present when the message is a tool call or a tool result. */
+    toolName?: string;
+    toolInput?: unknown;
+    meta?: Record<string, unknown>;
+}
+export interface Transcript {
+    id: string;
+    source: TranscriptSource;
+    title?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    /** Where it came from: a file path, an export id, a URL. */
+    origin?: string;
+    messages: TranscriptMessage[];
+    meta?: Record<string, unknown>;
+}
+export interface ImportInput {
+    /** A file or directory path. */
+    path?: string;
+    /** Raw content, when the caller already has it. */
+    content?: string;
+    /** Hint the importer, skipping detection. */
+    source?: TranscriptSource;
+}
+export interface TranscriptImporter {
+    readonly id: TranscriptSource;
+    readonly displayName: string;
+    /** Cheap sniff returning a 0..1 confidence. Must not throw. */
+    detect(input: {
+        path?: string;
+        content?: string;
+    }): Promise<number>;
+    parse(input: ImportInput): Promise<Transcript[]>;
+    /** Where this tool usually keeps its history, for zero-argument discovery. */
+    defaultLocations?(): string[];
+}
+/** What the distiller pulls out of a transcript before it becomes a husk. */
+export interface DistilledAgent {
+    name: string;
+    description: string;
+    persona: string;
+    knowledge: Array<{
+        title: string;
+        content: string;
+        source?: string;
+    }>;
+    examples: Array<{
+        user: string;
+        assistant: string;
+    }>;
+    suggestedTools: string[];
+    suggestedModel?: string;
+    needsComputer: boolean;
+    /** 0..1, how much signal the distiller actually found. */
+    confidence: number;
+    notes: string[];
+}
+//# sourceMappingURL=transcript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/types/transcript.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,eAAe,GACf,UAAU,GACV,OAAO,GACP,QAAQ,GACR,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACjD,8EAA8E;IAC9E,gBAAgB,CAAC,IAAI,MAAM,EAAE,CAAC;CAC/B;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/types/transcript.js

@@ -0,0 +1,3 @@
+/** Normalised conversation history, whatever it was exported from. */
+export {};
+//# sourceMappingURL=transcript.js.map

package/dist/types/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../src/types/transcript.ts"],"names":[],"mappings":"AAAA,sEAAsE"}

package/dist/util.d.ts

@@ -0,0 +1,69 @@
+import { Buffer } from 'node:buffer';
+/**
+ * Where a UTF-8 character actually starts, at or before `i`.
+ *
+ * Slicing a byte buffer at an arbitrary offset lands in the middle of a
+ * multi-byte character about as often as not, and `toString('utf8')` renders
+ * the orphaned halves as U+FFFD. Cutting a 200 KB log used to leave a few of
+ * those at each seam -- rare enough to look like the program's own output was
+ * corrupt rather than like husk's scissors, which is the worse failure.
+ */
+export declare function startOfChar(buf: Buffer, i: number): number;
+/** The end of the last whole character at or before `i`. */
+export declare function endOfChar(buf: Buffer, i: number): number;
+/**
+ * The length of the buffer with any trailing *incomplete* character removed.
+ *
+ * Distinct from {@link endOfChar}, which answers "where is the boundary at or
+ * before offset i". Here the offset is the end of the buffer, and the question
+ * is whether the last character finished -- a lead byte announces its own
+ * length, so a sequence that runs off the end is detectable.
+ */
+export declare function completeCharEnd(buf: Buffer): number;
+/**
+ * The next character boundary at or after `i`.
+ *
+ * Used for the *start* of a kept tail, where {@link startOfChar} would be
+ * wrong: rounding backwards keeps more bytes than the budget allowed, which is
+ * how a cap of 38 came back as 39.
+ */
+export declare function nextCharBoundary(buf: Buffer, i: number): number;
+/**
+ * Cut oversized text down to `maxBytes`, keeping both ends.
+ *
+ * The middle is where a long log is least interesting -- the command line and
+ * the first errors are at the top, the failure and the exit are at the bottom.
+ * What is dropped is always said, inline, in bytes.
+ *
+ * Two things it now gets right that it did not: the seams land on character
+ * boundaries, and the result honours the cap. The marker and newlines are
+ * counted against the budget rather than added on top, so `clampText(s, 10)`
+ * no longer returns 38 bytes -- a cap the caller chose for a token budget was
+ * being exceeded by the very code enforcing it.
+ */
+export declare function clampText(input: string, maxBytes: number): {
+    text: string;
+    truncated: boolean;
+};
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+export interface RetryOptions {
+    attempts?: number;
+    baseMs?: number;
+    maxMs?: number;
+    signal?: AbortSignal;
+    shouldRetry?: (err: unknown, attempt: number) => boolean;
+    onRetry?: (err: unknown, attempt: number, delayMs: number) => void;
+}
+/** Exponential backoff with full jitter. */
+export declare function retry<T>(fn: (attempt: number) => Promise<T>, opts?: RetryOptions): Promise<T>;
+/** Race a promise against a timeout without leaking the timer. */
+export declare function withTimeout<T>(p: Promise<T>, ms: number, message?: string): Promise<T>;
+export declare function redact(input: string): string;
+/** Approximate token count. Good enough for budgeting; never for billing. */
+export declare function estimateTokens(text: string): number;
+export declare function formatBytes(n: number): string;
+export declare function formatDuration(ms: number): string;
+export declare function deepMerge<T>(base: T, patch: unknown): T;
+/** Bounded-concurrency map that preserves input order. */
+export declare function mapLimit<T, R>(items: T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAwB/F;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAarE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAED,4CAA4C;AAC5C,wBAAsB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAmBvG;AAED,kEAAkE;AAClE,wBAAsB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,SAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAYjG;AA2BD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5C;AAcD,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7C;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CASvD;AAED,0DAA0D;AAC1D,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAYxH"}

package/dist/util.js

@@ -0,0 +1,236 @@
+import { Buffer } from 'node:buffer';
+/**
+ * Where a UTF-8 character actually starts, at or before `i`.
+ *
+ * Slicing a byte buffer at an arbitrary offset lands in the middle of a
+ * multi-byte character about as often as not, and `toString('utf8')` renders
+ * the orphaned halves as U+FFFD. Cutting a 200 KB log used to leave a few of
+ * those at each seam -- rare enough to look like the program's own output was
+ * corrupt rather than like husk's scissors, which is the worse failure.
+ */
+export function startOfChar(buf, i) {
+    let at = i;
+    // Continuation bytes are 10xxxxxx. Walk back to the lead byte. Four is the
+    // longest a legal sequence gets, so a bounded walk cannot loop on bad input.
+    for (let steps = 0; at > 0 && steps < 4 && (buf[at] & 0xc0) === 0x80; steps++)
+        at--;
+    return at;
+}
+/** The end of the last whole character at or before `i`. */
+export function endOfChar(buf, i) {
+    if (i >= buf.byteLength)
+        return buf.byteLength;
+    return startOfChar(buf, i);
+}
+/**
+ * The length of the buffer with any trailing *incomplete* character removed.
+ *
+ * Distinct from {@link endOfChar}, which answers "where is the boundary at or
+ * before offset i". Here the offset is the end of the buffer, and the question
+ * is whether the last character finished -- a lead byte announces its own
+ * length, so a sequence that runs off the end is detectable.
+ */
+export function completeCharEnd(buf) {
+    const start = startOfChar(buf, buf.byteLength - 1);
+    if (start < 0)
+        return 0;
+    const lead = buf[start];
+    const len = lead < 0x80 ? 1 : lead >= 0xf0 ? 4 : lead >= 0xe0 ? 3 : lead >= 0xc0 ? 2 : 1;
+    return start + len <= buf.byteLength ? buf.byteLength : start;
+}
+/**
+ * The next character boundary at or after `i`.
+ *
+ * Used for the *start* of a kept tail, where {@link startOfChar} would be
+ * wrong: rounding backwards keeps more bytes than the budget allowed, which is
+ * how a cap of 38 came back as 39.
+ */
+export function nextCharBoundary(buf, i) {
+    let at = Math.max(0, i);
+    while (at < buf.byteLength && (buf[at] & 0xc0) === 0x80)
+        at++;
+    return at;
+}
+/**
+ * Cut oversized text down to `maxBytes`, keeping both ends.
+ *
+ * The middle is where a long log is least interesting -- the command line and
+ * the first errors are at the top, the failure and the exit are at the bottom.
+ * What is dropped is always said, inline, in bytes.
+ *
+ * Two things it now gets right that it did not: the seams land on character
+ * boundaries, and the result honours the cap. The marker and newlines are
+ * counted against the budget rather than added on top, so `clampText(s, 10)`
+ * no longer returns 38 bytes -- a cap the caller chose for a token budget was
+ * being exceeded by the very code enforcing it.
+ */
+export function clampText(input, maxBytes) {
+    const buf = Buffer.from(input, 'utf8');
+    const marker = (omitted) => `\n... [${omitted} bytes elided by husk] ...\n`;
+    if (buf.byteLength <= maxBytes)
+        return { text: input, truncated: false };
+    // The marker's own length depends on the number printed inside it, which
+    // depends on how much we keep. Budgeting against the largest that number can
+    // be -- the whole input -- settles it in one pass and can only leave slack.
+    const budget = Math.max(0, maxBytes - Buffer.byteLength(marker(buf.byteLength)));
+    const half = Math.floor(budget / 2);
+    if (half < 1) {
+        // No room for both ends plus an honest marker. Say what happened and keep
+        // nothing rather than emit something longer than the cap we were given.
+        const text = marker(buf.byteLength).trim();
+        return { text: Buffer.byteLength(text) <= maxBytes ? text : '', truncated: true };
+    }
+    const headEnd = endOfChar(buf, half);
+    const tailStart = nextCharBoundary(buf, buf.byteLength - half);
+    const head = buf.subarray(0, headEnd).toString('utf8');
+    const tail = buf.subarray(tailStart).toString('utf8');
+    const omitted = tailStart - headEnd;
+    return { text: `${head}${marker(omitted)}${tail}`, truncated: true };
+}
+export function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(new Error('aborted'));
+        const t = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(t);
+            reject(new Error('aborted'));
+        }, { once: true });
+    });
+}
+/** Exponential backoff with full jitter. */
+export async function retry(fn, opts = {}) {
+    const attempts = opts.attempts ?? 3;
+    const base = opts.baseMs ?? 250;
+    const max = opts.maxMs ?? 8000;
+    let lastErr;
+    for (let a = 1; a <= attempts; a++) {
+        try {
+            return await fn(a);
+        }
+        catch (err) {
+            lastErr = err;
+            if (a === attempts)
+                break;
+            if (opts.shouldRetry && !opts.shouldRetry(err, a))
+                break;
+            const ceiling = Math.min(max, base * 2 ** (a - 1));
+            const delay = Math.floor(Math.random() * ceiling);
+            opts.onRetry?.(err, a, delay);
+            await sleep(delay, opts.signal);
+        }
+    }
+    throw lastErr;
+}
+/** Race a promise against a timeout without leaking the timer. */
+export async function withTimeout(p, ms, message = 'timed out') {
+    let timer;
+    try {
+        return await Promise.race([
+            p,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(message)), ms);
+            }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/** Anything that looks like a credential, before it reaches a log or a model. */
+const SECRET_PATTERNS = [
+    /\b(sk-ant-[A-Za-z0-9_-]{20,})/g,
+    // The class must include `-` and `_`: OpenAI project keys are `sk-proj-...`,
+    // and [A-Za-z0-9] stops at the second dash, leaving 7 characters that never
+    // reach the 20-char minimum. Measured: a full sk-proj- key passed through
+    // redact() completely untouched.
+    /\b(sk-[A-Za-z0-9_-]{20,})/g,
+    /\b(gsk_[A-Za-z0-9]{20,})/g,
+    /\b(AIza[0-9A-Za-z_-]{30,})/g,
+    /\b(ghp_[A-Za-z0-9]{30,})/g,
+    /\b(github_pat_[A-Za-z0-9_]{30,})/g,
+    /\b(xox[baprs]-[A-Za-z0-9-]{10,})/g,
+    /\b(AKIA[0-9A-Z]{16})\b/g,
+    /\b(npm_[A-Za-z0-9]{30,})/g,
+    /\b(fo1_[A-Za-z0-9_-]{20,})/g,
+    /\b(xai-[A-Za-z0-9]{20,})/g,
+    // A bearer token has no prefix of its own -- the only thing marking it is
+    // the header it arrives in. Without this, any provider husk has no pattern
+    // for leaks in full the moment a request is logged or an error echoes its
+    // headers back.
+    /((?:Authorization|Proxy-Authorization)\s*:\s*(?:Bearer|Basic|Token)\s+)[A-Za-z0-9._~+/=-]{16,}/gi,
+    /(-----BEGIN (?:RSA |EC |OPENSSH |PGP )?PRIVATE KEY-----)[\s\S]*?(-----END [^-]*-----)/g,
+];
+export function redact(input) {
+    let out = input;
+    for (const re of SECRET_PATTERNS)
+        out = out.replace(re, (m) => mask(m));
+    return out;
+}
+function mask(s) {
+    if (s.includes('PRIVATE KEY'))
+        return '[redacted private key]';
+    // For a header match the name and scheme are not the secret, and keeping
+    // them is the difference between "Authorization: Bearer [redacted]" and a
+    // bare "[redacted]" that leaves a reader guessing which header leaked.
+    const header = /^((?:Authorization|Proxy-Authorization)\s*:\s*(?:Bearer|Basic|Token)\s+)/i.exec(s);
+    if (header)
+        return `${header[1]}[redacted]`;
+    const keep = Math.min(6, Math.floor(s.length / 4));
+    return `${s.slice(0, keep)}...[redacted]`;
+}
+/** Approximate token count. Good enough for budgeting; never for billing. */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 3.6);
+}
+export function formatBytes(n) {
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let i = 0;
+    let v = n;
+    while (v >= 1024 && i < units.length - 1) {
+        v /= 1024;
+        i++;
+    }
+    return `${v < 10 && i > 0 ? v.toFixed(1) : Math.round(v)}${units[i]}`;
+}
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    const m = Math.floor(ms / 60_000);
+    const s = Math.round((ms % 60_000) / 1000);
+    return `${m}m${s.toString().padStart(2, '0')}s`;
+}
+export function deepMerge(base, patch) {
+    if (patch === undefined || patch === null)
+        return base;
+    if (Array.isArray(patch) || typeof patch !== 'object')
+        return patch;
+    if (typeof base !== 'object' || base === null || Array.isArray(base))
+        return patch;
+    const out = { ...base };
+    for (const [k, v] of Object.entries(patch)) {
+        out[k] = deepMerge(base[k], v);
+    }
+    return out;
+}
+/** Bounded-concurrency map that preserves input order. */
+export async function mapLimit(items, limit, fn) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+        for (;;) {
+            const i = cursor++;
+            if (i >= items.length)
+                return;
+            results[i] = await fn(items[i], i);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@husk-ai/core",
+  "version": "0.1.1",
+  "description": "Shared contracts, types and primitives for Husk.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  }
+}