@roackb2/heddle 0.0.2

package/dist/src/tools/update-plan.js

@@ -0,0 +1,85 @@
+// ---------------------------------------------------------------------------
+// Tool: update_plan
+// Record a concise working plan with item statuses for substantial tasks.
+// ---------------------------------------------------------------------------
+export const updatePlanTool = {
+    name: 'update_plan',
+    description: 'Record or revise a short working plan for substantial multi-step tasks. Use this when the task has multiple concrete steps, when you need to show progress explicitly, or when you want the operator to see what remains. Keep the plan short and practical. Each item must have a step string and a status of pending, in_progress, or completed. At most one item may be in_progress at a time. Returns the saved plan back.',
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            explanation: {
+                type: 'string',
+                description: 'Optional one-line note about why the plan changed or what you are doing now.',
+            },
+            plan: {
+                type: 'array',
+                description: 'Short checklist of concrete plan items.',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        step: {
+                            type: 'string',
+                            description: 'Concrete plan item.',
+                        },
+                        status: {
+                            type: 'string',
+                            enum: ['pending', 'in_progress', 'completed'],
+                            description: 'Current status for this plan item.',
+                        },
+                    },
+                    required: ['step', 'status'],
+                },
+                minItems: 1,
+            },
+        },
+        required: ['plan'],
+    },
+    async execute(raw) {
+        if (!isUpdatePlanInput(raw)) {
+            return {
+                ok: false,
+                error: 'Invalid input for update_plan. Required field: plan. Optional field: explanation. Each plan item must have step and status (pending, in_progress, completed), with at most one in_progress item.',
+            };
+        }
+        return { ok: true, output: raw };
+    },
+};
+function isUpdatePlanInput(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return false;
+    }
+    const input = raw;
+    const keys = Object.keys(input);
+    if (keys.some((key) => key !== 'explanation' && key !== 'plan')) {
+        return false;
+    }
+    if (input.explanation !== undefined && typeof input.explanation !== 'string') {
+        return false;
+    }
+    if (!Array.isArray(input.plan) || input.plan.length === 0) {
+        return false;
+    }
+    let inProgressCount = 0;
+    for (const item of input.plan) {
+        if (!item || typeof item !== 'object' || Array.isArray(item)) {
+            return false;
+        }
+        const candidate = item;
+        if (typeof candidate.step !== 'string') {
+            return false;
+        }
+        if (candidate.status !== 'pending' &&
+            candidate.status !== 'in_progress' &&
+            candidate.status !== 'completed') {
+            return false;
+        }
+        if (candidate.status === 'in_progress') {
+            inProgressCount++;
+        }
+    }
+    return inProgressCount <= 1;
+}
+//# sourceMappingURL=update-plan.js.map

package/dist/src/tools/update-plan.js.map

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

package/dist/src/trace/format.d.ts

@@ -0,0 +1,6 @@
+import type { TraceEvent } from '../types.js';
+/**
+ * Format a trace for console display.
+ */
+export declare function formatTraceForConsole(trace: TraceEvent[]): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/src/trace/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/trace/format.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAa9C;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAqGjE"}

package/dist/src/trace/format.js

@@ -0,0 +1,94 @@
+// ---------------------------------------------------------------------------
+// Trace Formatter — human-readable console output
+// ---------------------------------------------------------------------------
+const COLORS = {
+    reset: '\x1b[0m',
+    dim: '\x1b[2m',
+    bold: '\x1b[1m',
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    magenta: '\x1b[35m',
+};
+/**
+ * Format a trace for console display.
+ */
+export function formatTraceForConsole(trace) {
+    const lines = [];
+    for (const event of trace) {
+        switch (event.type) {
+            case 'run.started':
+                lines.push(`${COLORS.bold}${COLORS.cyan}▶ RUN STARTED${COLORS.reset}  ${COLORS.dim}${event.timestamp}${COLORS.reset}`, `  Goal: ${event.goal}`, '');
+                break;
+            case 'assistant.turn': {
+                const requestedToolNames = event.toolCalls?.map((call) => call.tool) ?? [];
+                lines.push(`${COLORS.magenta}  [step ${event.step}]${COLORS.reset} ${COLORS.bold}Assistant:${COLORS.reset}`);
+                if (event.content) {
+                    lines.push(`  ${truncate(event.content, 500)}`);
+                }
+                else if (event.requestedTools) {
+                    lines.push(`  (no text content; requested ${requestedToolNames.length} tool call${requestedToolNames.length === 1 ? '' : 's'})`);
+                }
+                if (event.requestedTools) {
+                    lines.push(`  Requested Tools: ${requestedToolNames.join(', ')} (${requestedToolNames.length})`);
+                }
+                if (event.diagnostics?.missing?.length) {
+                    lines.push(`  Missing: ${event.diagnostics.missing.join('; ')}`);
+                }
+                if (event.diagnostics?.wantedTools?.length) {
+                    lines.push(`  Wanted Tools: ${event.diagnostics.wantedTools.join(', ')}`);
+                }
+                if (event.diagnostics?.wantedInputs?.length) {
+                    lines.push(`  Wanted Inputs: ${event.diagnostics.wantedInputs.join('; ')}`);
+                }
+                lines.push('');
+                break;
+            }
+            case 'tool.call':
+                lines.push(`${COLORS.yellow}  [step ${event.step}]${COLORS.reset} ${COLORS.bold}Tool Call:${COLORS.reset} ${event.call.tool}`, `  Input: ${truncate(JSON.stringify(event.call.input), 200)}`);
+                break;
+            case 'tool.approval_requested':
+                lines.push(`${COLORS.yellow}  [step ${event.step}]${COLORS.reset} ${COLORS.bold}Approval Required:${COLORS.reset} ${event.call.tool}`, `  Input: ${truncate(JSON.stringify(event.call.input), 200)}`);
+                break;
+            case 'tool.approval_resolved':
+                lines.push(`${event.approved ? COLORS.green : COLORS.red}  [step ${event.step}]${COLORS.reset} ${COLORS.bold}Approval ${event.approved ? 'Granted' : 'Denied'}:${COLORS.reset} ${event.call.tool}`, `  Reason: ${event.reason ?? (event.approved ? 'approved' : 'no reason provided')}`);
+                break;
+            case 'tool.fallback':
+                lines.push(`${COLORS.yellow}  [step ${event.step}]${COLORS.reset} ${COLORS.bold}Tool Fallback:${COLORS.reset} ${event.fromCall.tool} → ${event.toCall.tool}`, `  Reason: ${event.reason}`, `  Command: ${truncate(JSON.stringify(event.toCall.input), 200)}`);
+                break;
+            case 'tool.result': {
+                const color = event.result.ok ? COLORS.green : COLORS.red;
+                const status = event.result.ok ? '✓' : '✗';
+                const content = event.result.ok
+                    ? formatToolResultOutput(event.result.output)
+                    : `ERROR: ${event.result.error}`;
+                lines.push(`${color}  ${status} ${event.tool}${COLORS.reset}: ${content}`, '');
+                break;
+            }
+            case 'run.finished': {
+                const outcomeColor = event.outcome === 'done' ? COLORS.green
+                    : event.outcome === 'max_steps' ? COLORS.yellow
+                        : COLORS.red;
+                lines.push(`${COLORS.bold}${outcomeColor}■ RUN FINISHED${COLORS.reset}  outcome=${event.outcome}  ${COLORS.dim}${event.timestamp}${COLORS.reset}`, `  Summary: ${event.summary}`, '');
+                break;
+            }
+        }
+    }
+    return lines.join('\n');
+}
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen) + '…';
+}
+function formatToolResultOutput(output) {
+    if (output == null) {
+        return '';
+    }
+    if (typeof output === 'string') {
+        return truncate(output, 300);
+    }
+    return truncate(JSON.stringify(output, null, 2), 300);
+}
+//# sourceMappingURL=format.js.map

package/dist/src/trace/format.js.map

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

package/dist/src/trace/recorder.d.ts

@@ -0,0 +1,11 @@
+import type { TraceEvent } from '../types.js';
+export type TraceRecorder = {
+    record(event: TraceEvent): void;
+    getTrace(): TraceEvent[];
+    toJSON(): string;
+};
+/**
+ * Create a trace recorder that accumulates events in memory.
+ */
+export declare function createTraceRecorder(): TraceRecorder;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/src/trace/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../../src/trace/recorder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,QAAQ,IAAI,UAAU,EAAE,CAAC;IACzB,MAAM,IAAI,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAcnD"}

package/dist/src/trace/recorder.js

@@ -0,0 +1,21 @@
+// ---------------------------------------------------------------------------
+// Trace Recorder
+// ---------------------------------------------------------------------------
+/**
+ * Create a trace recorder that accumulates events in memory.
+ */
+export function createTraceRecorder() {
+    const events = [];
+    return {
+        record(event) {
+            events.push(event);
+        },
+        getTrace() {
+            return [...events];
+        },
+        toJSON() {
+            return JSON.stringify(events, null, 2);
+        },
+    };
+}
+//# sourceMappingURL=recorder.js.map

package/dist/src/trace/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../../src/trace/recorder.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAU9E;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,OAAO;QACL,MAAM,CAAC,KAAiB;YACtB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,QAAQ;YACN,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;QACrB,CAAC;QACD,MAAM;YACJ,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,110 @@
+import type { ChatMessage, LlmUsage } from './llm/types.js';
+/**
+ * Input to the agent loop.
+ */
+export type RunInput = {
+    goal: string;
+    maxSteps?: number;
+};
+/**
+ * A tool the agent can invoke.
+ */
+export type ToolDefinition = {
+    name: string;
+    description: string;
+    requiresApproval?: boolean;
+    parameters: Record<string, unknown>;
+    execute: (input: unknown) => Promise<ToolResult>;
+};
+/**
+ * What the model asked the runtime to do.
+ */
+export type ToolCall = {
+    id: string;
+    tool: string;
+    input: unknown;
+};
+/**
+ * Optional self-reported assistant diagnostics for observability.
+ */
+export type AssistantDiagnostics = {
+    rationale?: string;
+    missing?: string[];
+    wantedTools?: string[];
+    wantedInputs?: string[];
+};
+/**
+ * What came back from executing a tool.
+ */
+export type ToolResult = {
+    ok: boolean;
+    output?: unknown;
+    error?: string;
+};
+/**
+ * Why the run stopped.
+ */
+export type StopReason = 'done' | 'max_steps' | 'error' | 'interrupted';
+/**
+ * A single event in the run trace. Discriminated union on `type`.
+ */
+export type TraceEvent = {
+    type: 'run.started';
+    goal: string;
+    timestamp: string;
+} | {
+    type: 'assistant.turn';
+    content: string;
+    requestedTools: boolean;
+    diagnostics?: AssistantDiagnostics;
+    toolCalls?: ToolCall[];
+    step: number;
+    timestamp: string;
+} | {
+    type: 'tool.approval_requested';
+    call: ToolCall;
+    step: number;
+    timestamp: string;
+} | {
+    type: 'tool.approval_resolved';
+    call: ToolCall;
+    approved: boolean;
+    reason?: string;
+    step: number;
+    timestamp: string;
+} | {
+    type: 'tool.fallback';
+    fromCall: ToolCall;
+    toCall: ToolCall;
+    reason: string;
+    step: number;
+    timestamp: string;
+} | {
+    type: 'tool.call';
+    call: ToolCall;
+    step: number;
+    timestamp: string;
+} | {
+    type: 'tool.result';
+    tool: string;
+    result: ToolResult;
+    step: number;
+    timestamp: string;
+} | {
+    type: 'run.finished';
+    outcome: StopReason;
+    summary: string;
+    step: number;
+    timestamp: string;
+};
+/**
+ * The result returned from `runAgent`.
+ */
+export type RunResult = {
+    outcome: StopReason;
+    summary: string;
+    trace: TraceEvent[];
+    transcript: ChatMessage[];
+    usage?: LlmUsage;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,6 @@
+// ---------------------------------------------------------------------------
+// Heddle v0 — Core Types
+// Minimal types only. No premature abstractions.
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yBAAyB;AACzB,iDAAiD;AACjD,8EAA8E"}

package/dist/src/utils/budget.d.ts

@@ -0,0 +1,13 @@
+export type Budget = {
+    /** Consume one step. Returns the new remaining count. */
+    step(): number;
+    /** How many steps remain. */
+    remaining(): number;
+    /** Whether the budget has been exhausted. */
+    exhausted(): boolean;
+};
+/**
+ * Create a budget that allows up to `maxSteps` iterations.
+ */
+export declare function createBudget(maxSteps: number): Budget;
+//# sourceMappingURL=budget.d.ts.map

package/dist/src/utils/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/utils/budget.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,MAAM,GAAG;IACnB,yDAAyD;IACzD,IAAI,IAAI,MAAM,CAAC;IACf,6BAA6B;IAC7B,SAAS,IAAI,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,IAAI,OAAO,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAerD"}

package/dist/src/utils/budget.js

@@ -0,0 +1,22 @@
+// ---------------------------------------------------------------------------
+// Budget — simple step counter
+// ---------------------------------------------------------------------------
+/**
+ * Create a budget that allows up to `maxSteps` iterations.
+ */
+export function createBudget(maxSteps) {
+    let used = 0;
+    return {
+        step() {
+            used++;
+            return maxSteps - used;
+        },
+        remaining() {
+            return maxSteps - used;
+        },
+        exhausted() {
+            return used >= maxSteps;
+        },
+    };
+}
+//# sourceMappingURL=budget.js.map

package/dist/src/utils/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../../src/utils/budget.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAW9E;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,OAAO;QACL,IAAI;YACF,IAAI,EAAE,CAAC;YACP,OAAO,QAAQ,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,SAAS;YACP,OAAO,QAAQ,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,SAAS;YACP,OAAO,IAAI,IAAI,QAAQ,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class HeddleError extends Error {
+    constructor(message: string);
+}
+export declare class ToolExecutionError extends HeddleError {
+    readonly toolName: string;
+    constructor(toolName: string, message: string);
+}
+export declare class LlmError extends HeddleError {
+    constructor(message: string);
+}
+export declare class BudgetExhaustedError extends HeddleError {
+    constructor(maxSteps: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAKA,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,WAAW;aAE/B,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM;CAKlB;AAED,qBAAa,QAAS,SAAQ,WAAW;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,QAAQ,EAAE,MAAM;CAI7B"}

package/dist/src/utils/errors.js

@@ -0,0 +1,31 @@
+// ---------------------------------------------------------------------------
+// Error Types
+// Minimal — just enough for the loop to distinguish error kinds.
+// ---------------------------------------------------------------------------
+export class HeddleError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HeddleError';
+    }
+}
+export class ToolExecutionError extends HeddleError {
+    toolName;
+    constructor(toolName, message) {
+        super(`Tool "${toolName}": ${message}`);
+        this.toolName = toolName;
+        this.name = 'ToolExecutionError';
+    }
+}
+export class LlmError extends HeddleError {
+    constructor(message) {
+        super(message);
+        this.name = 'LlmError';
+    }
+}
+export class BudgetExhaustedError extends HeddleError {
+    constructor(maxSteps) {
+        super(`Budget exhausted after ${maxSteps} steps`);
+        this.name = 'BudgetExhaustedError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,cAAc;AACd,iEAAiE;AACjE,8EAA8E;AAE9E,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IAE/B;IADlB,YACkB,QAAgB,EAChC,OAAe;QAEf,KAAK,CAAC,SAAS,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;QAHxB,aAAQ,GAAR,QAAQ,CAAQ;QAIhC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,QAAgB;QAC1B,KAAK,CAAC,0BAA0B,QAAQ,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,17 @@
+import pino from 'pino';
+export type CreateLoggerOptions = {
+    pretty?: boolean;
+    level?: string;
+    logFilePath?: string;
+    console?: boolean;
+};
+/**
+ * Create a Heddle logger.
+ * Uses pino-pretty transport when `pretty` is true (intended for local dev).
+ */
+export declare function createLogger(options?: CreateLoggerOptions): pino.Logger;
+/**
+ * Default logger instance.
+ */
+export declare const logger: pino.Logger<never, boolean>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAMA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,IAAI,CAAC,MAAM,CAoC3E;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,6BAAiB,CAAC"}

package/dist/src/utils/logger.js

@@ -0,0 +1,50 @@
+// ---------------------------------------------------------------------------
+// Logger — pino-based, with pino-pretty for local development
+// ---------------------------------------------------------------------------
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import pino from 'pino';
+import pinoPretty from 'pino-pretty';
+/**
+ * Create a Heddle logger.
+ * Uses pino-pretty transport when `pretty` is true (intended for local dev).
+ */
+export function createLogger(options = {}) {
+    const level = options.level ?? 'info';
+    const prettyOutput = options.pretty ?? process.env.NODE_ENV !== 'production';
+    const consoleOutput = options.console ?? true;
+    const streams = [];
+    if (consoleOutput) {
+        if (prettyOutput) {
+            streams.push({
+                stream: pinoPretty({
+                    colorize: true,
+                    translateTime: 'HH:MM:ss.l',
+                    ignore: 'pid,hostname',
+                }),
+            });
+        }
+        else {
+            streams.push({ stream: process.stdout });
+        }
+    }
+    if (options.logFilePath) {
+        mkdirSync(dirname(options.logFilePath), { recursive: true });
+        streams.push({
+            stream: pino.destination({
+                dest: options.logFilePath,
+                sync: false,
+                mkdir: true,
+            }),
+        });
+    }
+    if (streams.length === 0) {
+        return pino({ level }, pino.destination('/dev/null'));
+    }
+    return pino({ level }, pino.multistream(streams));
+}
+/**
+ * Default logger instance.
+ */
+export const logger = createLogger();
+//# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,UAAU,MAAM,aAAa,CAAC;AASrC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IACtC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IAC7E,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IAC9C,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,UAAU,CAAC;oBACjB,QAAQ,EAAE,IAAI;oBACd,aAAa,EAAE,YAAY;oBAC3B,MAAM,EAAE,cAAc;iBACvB,CAAC;aACH,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC;gBACvB,IAAI,EAAE,OAAO,CAAC,WAAW;gBACzB,IAAI,EAAE,KAAK;gBACX,KAAK,EAAE,IAAI;aACZ,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@roackb2/heddle",
+  "version": "0.0.2",
+  "description": "A minimal TypeScript runtime for tool-using agents",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "heddle": "dist/src/cli/main.js"
+  },
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx --no-cache examples/repo-investigator.ts",
+    "chat": "tsx --no-cache examples/conversation.tsx",
+    "chat:light": "OPENAI_MODEL=gpt-5.1-codex-mini tsx --no-cache examples/conversation.tsx",
+    "repo-investigator:dev": "OPENAI_API_KEY=\"$PERSONAL_OPENAI_API_KEY\" tsx --no-cache examples/repo-investigator.ts",
+    "chat:dev": "tsx --no-cache examples/conversation.tsx",
+    "chat:dev:openai": "OPENAI_API_KEY=\"$PERSONAL_OPENAI_API_KEY\" tsx --no-cache examples/conversation.tsx",
+    "chat:dev:openai:light": "OPENAI_API_KEY=\"$PERSONAL_OPENAI_API_KEY\" OPENAI_MODEL=gpt-5.1-codex-mini tsx --no-cache examples/conversation.tsx",
+    "chat:dev:anthropic": "ANTHROPIC_API_KEY=\"$PERSONAL_ANTHROPIC_API_KEY\" tsx --no-cache examples/conversation.tsx",
+    "test": "vitest run src/__tests__",
+    "prepare": "yarn build"
+  },
+  "keywords": [
+    "agent",
+    "llm",
+    "tools",
+    "runtime",
+    "trace"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.54.0",
+    "@inkjs/ui": "^2.0.0",
+    "ink": "^6.8.0",
+    "openai": "^4.86.2",
+    "pino": "^10.3.1",
+    "react": "^19.2.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "@types/react": "^19.2.14",
+    "@vitest/coverage-v8": "^4.1.2",
+    "pino-pretty": "^13.1.3",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "vitest": "4.1.2"
+  }
+}