@provos/ironcurtain 0.1.0

package/dist/config/user-config.d.ts

@@ -0,0 +1,93 @@
+/**
+ * User configuration file management.
+ *
+ * Loads, validates, and provides defaults for ~/.ironcurtain/config.json.
+ * All fields are optional in the file; missing fields use defaults.
+ * Environment variables override config file values.
+ */
+import { z } from 'zod';
+export declare const USER_CONFIG_DEFAULTS: {
+    readonly agentModelId: "anthropic:claude-sonnet-4-6";
+    readonly policyModelId: "anthropic:claude-sonnet-4-6";
+    readonly escalationTimeoutSeconds: 300;
+    readonly resourceBudget: {
+        readonly maxTotalTokens: 1000000;
+        readonly maxSteps: 200;
+        readonly maxSessionSeconds: 1800;
+        readonly maxEstimatedCostUsd: 5;
+        readonly warnThresholdPercent: 80;
+    };
+    readonly autoCompact: {
+        readonly enabled: true;
+        readonly thresholdTokens: 160000;
+        readonly keepRecentMessages: 10;
+        readonly summaryModelId: "anthropic:claude-haiku-4-5";
+    };
+};
+/**
+ * Zod schema for validating user config. All fields optional.
+ * Validates types and constraints without applying defaults --
+ * defaults are merged separately so we can distinguish "missing" from "present".
+ */
+declare const userConfigSchema: z.ZodObject<{
+    agentModelId: z.ZodOptional<z.ZodString>;
+    policyModelId: z.ZodOptional<z.ZodString>;
+    anthropicApiKey: z.ZodOptional<z.ZodString>;
+    googleApiKey: z.ZodOptional<z.ZodString>;
+    openaiApiKey: z.ZodOptional<z.ZodString>;
+    escalationTimeoutSeconds: z.ZodOptional<z.ZodNumber>;
+    resourceBudget: z.ZodOptional<z.ZodObject<{
+        maxTotalTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        maxSteps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        maxSessionSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        maxEstimatedCostUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        warnThresholdPercent: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    autoCompact: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        thresholdTokens: z.ZodOptional<z.ZodNumber>;
+        keepRecentMessages: z.ZodOptional<z.ZodNumber>;
+        summaryModelId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Parsed config from ~/.ironcurtain/config.json. All fields optional. */
+export type UserConfig = z.infer<typeof userConfigSchema>;
+/** Resolved resource budget with all fields present. */
+export interface ResolvedResourceBudgetConfig {
+    readonly maxTotalTokens: number | null;
+    readonly maxSteps: number | null;
+    readonly maxSessionSeconds: number | null;
+    readonly maxEstimatedCostUsd: number | null;
+    readonly warnThresholdPercent: number;
+}
+/** Resolved auto-compaction config with all fields present. */
+export interface ResolvedAutoCompactConfig {
+    readonly enabled: boolean;
+    readonly thresholdTokens: number;
+    readonly keepRecentMessages: number;
+    readonly summaryModelId: string;
+}
+/** Validated, defaults-applied configuration. All fields present. */
+export interface ResolvedUserConfig {
+    readonly agentModelId: string;
+    readonly policyModelId: string;
+    readonly anthropicApiKey: string;
+    readonly googleApiKey: string;
+    readonly openaiApiKey: string;
+    readonly escalationTimeoutSeconds: number;
+    readonly resourceBudget: ResolvedResourceBudgetConfig;
+    readonly autoCompact: ResolvedAutoCompactConfig;
+}
+/**
+ * Loads user configuration from ~/.ironcurtain/config.json.
+ *
+ * Behavior:
+ * 1. If file does not exist: create with defaults, log to stderr
+ * 2. If file exists: parse JSON, validate with Zod, merge with defaults
+ * 3. Apply env var overrides (ANTHROPIC_API_KEY overrides anthropicApiKey)
+ * 4. Return ResolvedUserConfig with all fields present
+ *
+ * @throws Error on invalid JSON or schema validation failure
+ */
+export declare function loadUserConfig(): ResolvedUserConfig;
+export {};

package/dist/config/user-config.js

@@ -0,0 +1,309 @@
+/**
+ * User configuration file management.
+ *
+ * Loads, validates, and provides defaults for ~/.ironcurtain/config.json.
+ * All fields are optional in the file; missing fields use defaults.
+ * Environment variables override config file values.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { z } from 'zod';
+import { getUserConfigPath } from './paths.js';
+import { parseModelId } from './model-provider.js';
+export const USER_CONFIG_DEFAULTS = {
+    agentModelId: 'anthropic:claude-sonnet-4-6',
+    policyModelId: 'anthropic:claude-sonnet-4-6',
+    escalationTimeoutSeconds: 300,
+    resourceBudget: {
+        maxTotalTokens: 1_000_000,
+        maxSteps: 200,
+        maxSessionSeconds: 1800,
+        maxEstimatedCostUsd: 5.00,
+        warnThresholdPercent: 80,
+    },
+    autoCompact: {
+        enabled: true,
+        thresholdTokens: 160_000,
+        keepRecentMessages: 10,
+        summaryModelId: 'anthropic:claude-haiku-4-5',
+    },
+};
+const ESCALATION_TIMEOUT_MIN = 30;
+const ESCALATION_TIMEOUT_MAX = 600;
+const resourceBudgetSchema = z.object({
+    maxTotalTokens: z.number().int().positive().nullable().optional(),
+    maxSteps: z.number().int().positive().nullable().optional(),
+    maxSessionSeconds: z.number().positive().nullable().optional(),
+    maxEstimatedCostUsd: z.number().positive().nullable().optional(),
+    warnThresholdPercent: z.number().min(1).max(99).optional(),
+}).optional();
+/**
+ * Validates a qualified model ID string: either a bare model name
+ * or "provider:model-name" where provider is a known provider.
+ * Delegates to parseModelId() so validation logic is not duplicated.
+ */
+const qualifiedModelId = z.string().min(1).refine((val) => {
+    try {
+        parseModelId(val);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, {
+    message: 'Model ID must be "model-name" or "provider:model-name" ' +
+        'where provider is one of: anthropic, google, openai',
+});
+const autoCompactSchema = z.object({
+    enabled: z.boolean().optional(),
+    thresholdTokens: z.number().int().positive().optional(),
+    keepRecentMessages: z.number().int().positive().optional(),
+    summaryModelId: qualifiedModelId.optional(),
+}).optional();
+/**
+ * Zod schema for validating user config. All fields optional.
+ * Validates types and constraints without applying defaults --
+ * defaults are merged separately so we can distinguish "missing" from "present".
+ */
+const userConfigSchema = z.object({
+    agentModelId: qualifiedModelId.optional(),
+    policyModelId: qualifiedModelId.optional(),
+    anthropicApiKey: z.string().min(1, 'anthropicApiKey must be non-empty').optional(),
+    googleApiKey: z.string().min(1, 'googleApiKey must be non-empty').optional(),
+    openaiApiKey: z.string().min(1, 'openaiApiKey must be non-empty').optional(),
+    escalationTimeoutSeconds: z
+        .number()
+        .int('escalationTimeoutSeconds must be an integer')
+        .min(ESCALATION_TIMEOUT_MIN, `escalationTimeoutSeconds must be at least ${ESCALATION_TIMEOUT_MIN}`)
+        .max(ESCALATION_TIMEOUT_MAX, `escalationTimeoutSeconds must be at most ${ESCALATION_TIMEOUT_MAX}`)
+        .optional(),
+    resourceBudget: resourceBudgetSchema,
+    autoCompact: autoCompactSchema,
+});
+/** Known fields derived from the schema. Used for unknown-field detection. */
+const KNOWN_FIELDS = new Set(Object.keys(userConfigSchema.shape));
+/** Fields that must never be backfilled into the config file. */
+const SENSITIVE_FIELDS = new Set(['anthropicApiKey', 'googleApiKey', 'openaiApiKey']);
+/** Type guard for non-null, non-array objects. */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Default config file content (anthropicApiKey intentionally omitted). */
+const DEFAULT_CONFIG_CONTENT = JSON.stringify({
+    agentModelId: USER_CONFIG_DEFAULTS.agentModelId,
+    policyModelId: USER_CONFIG_DEFAULTS.policyModelId,
+    escalationTimeoutSeconds: USER_CONFIG_DEFAULTS.escalationTimeoutSeconds,
+    resourceBudget: USER_CONFIG_DEFAULTS.resourceBudget,
+    autoCompact: USER_CONFIG_DEFAULTS.autoCompact,
+}, null, 2) + '\n';
+/**
+ * Loads user configuration from ~/.ironcurtain/config.json.
+ *
+ * Behavior:
+ * 1. If file does not exist: create with defaults, log to stderr
+ * 2. If file exists: parse JSON, validate with Zod, merge with defaults
+ * 3. Apply env var overrides (ANTHROPIC_API_KEY overrides anthropicApiKey)
+ * 4. Return ResolvedUserConfig with all fields present
+ *
+ * @throws Error on invalid JSON or schema validation failure
+ */
+export function loadUserConfig() {
+    const configPath = getUserConfigPath();
+    let raw = readOrCreateConfigFile(configPath);
+    raw = backfillMissingFields(configPath, raw);
+    const parsed = parseConfigJson(raw, configPath);
+    warnUnknownFields(parsed, configPath);
+    const validated = validateConfig(parsed, configPath);
+    return applyEnvOverrides(mergeWithDefaults(validated));
+}
+/**
+ * Detects fields present in USER_CONFIG_DEFAULTS but missing from the file,
+ * writes them back with default values, and logs what was added.
+ * Returns raw unchanged on parse failure (validation catches this later).
+ */
+function backfillMissingFields(configPath, raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+    if (!isPlainObject(parsed))
+        return raw;
+    const fileContent = parsed;
+    const patch = computeMissingDefaults(fileContent);
+    if (patch === null)
+        return raw;
+    const updated = applyPatchToFileContent(fileContent, patch);
+    const newRaw = JSON.stringify(updated, null, 2) + '\n';
+    writeFileSync(configPath, newRaw);
+    process.stderr.write(`Backfilled config fields: ${describeAddedFields(patch)}\n`);
+    return newRaw;
+}
+/**
+ * Computes a patch of default values for fields missing from the config file.
+ * Skips sensitive fields. One level deep for nested objects.
+ * Returns null when nothing is missing.
+ */
+function computeMissingDefaults(fileContent) {
+    const patch = {};
+    for (const [key, defaultValue] of Object.entries(USER_CONFIG_DEFAULTS)) {
+        if (SENSITIVE_FIELDS.has(key))
+            continue;
+        if (!(key in fileContent)) {
+            patch[key] = defaultValue;
+            continue;
+        }
+        // For nested objects, check for missing sub-fields one level deep
+        if (!isPlainObject(defaultValue) || !isPlainObject(fileContent[key]))
+            continue;
+        const existing = fileContent[key];
+        const subPatch = {};
+        for (const [subKey, subDefault] of Object.entries(defaultValue)) {
+            if (!(subKey in existing)) {
+                subPatch[subKey] = subDefault;
+            }
+        }
+        if (Object.keys(subPatch).length > 0) {
+            patch[key] = subPatch;
+        }
+    }
+    return Object.keys(patch).length > 0 ? patch : null;
+}
+/**
+ * Merges a patch of missing defaults into the file content.
+ * Preserves all user values; only adds missing fields.
+ */
+function applyPatchToFileContent(fileContent, patch) {
+    const result = { ...fileContent };
+    for (const [key, patchValue] of Object.entries(patch)) {
+        if (key in result && isPlainObject(result[key])) {
+            const existing = result[key];
+            result[key] = { ...existing, ...patchValue };
+        }
+        else {
+            result[key] = patchValue;
+        }
+    }
+    return result;
+}
+/**
+ * Produces a human-readable list of added fields for the log message.
+ * Sub-field patches (partial nested objects) are listed as "parent.child".
+ * Whole new top-level objects are listed by their key name alone.
+ */
+function describeAddedFields(patch) {
+    const fields = [];
+    for (const [key, value] of Object.entries(patch)) {
+        const defaultValue = USER_CONFIG_DEFAULTS[key];
+        const isSubFieldPatch = isPlainObject(value) && isPlainObject(defaultValue) &&
+            Object.keys(value).length < Object.keys(defaultValue).length;
+        if (isSubFieldPatch) {
+            for (const subKey of Object.keys(value)) {
+                fields.push(`${key}.${subKey}`);
+            }
+        }
+        else {
+            fields.push(key);
+        }
+    }
+    return fields.join(', ');
+}
+/**
+ * Reads the config file, creating it with defaults if it does not exist.
+ */
+function readOrCreateConfigFile(configPath) {
+    if (!existsSync(configPath)) {
+        mkdirSync(dirname(configPath), { recursive: true });
+        writeFileSync(configPath, DEFAULT_CONFIG_CONTENT);
+        process.stderr.write(`Created default config at ${configPath}\n`);
+        return DEFAULT_CONFIG_CONTENT;
+    }
+    return readFileSync(configPath, 'utf-8');
+}
+/**
+ * Parses raw JSON string. Throws a descriptive error on invalid JSON.
+ */
+function parseConfigJson(raw, configPath) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Invalid JSON in ${configPath}: ${message}`);
+    }
+}
+/**
+ * Warns about unknown fields in the parsed config.
+ */
+function warnUnknownFields(parsed, configPath) {
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return;
+    const keys = Object.keys(parsed);
+    for (const key of keys) {
+        if (!KNOWN_FIELDS.has(key)) {
+            process.stderr.write(`Warning: unknown field "${key}" in ${configPath}\n`);
+        }
+    }
+}
+/**
+ * Validates parsed config against the Zod schema.
+ * Throws a descriptive error listing invalid fields.
+ */
+function validateConfig(parsed, configPath) {
+    const result = userConfigSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((issue) => `  ${issue.path.join('.')}: ${issue.message}`)
+            .join('\n');
+        throw new Error(`Invalid config in ${configPath}:\n${issues}`);
+    }
+    return result.data;
+}
+/**
+ * Merges validated (partial) config with defaults.
+ * API key fields default to empty string when not provided.
+ */
+function mergeWithDefaults(config) {
+    const budgetDefaults = USER_CONFIG_DEFAULTS.resourceBudget;
+    const compactDefaults = USER_CONFIG_DEFAULTS.autoCompact;
+    const b = config.resourceBudget;
+    const c = config.autoCompact;
+    return {
+        agentModelId: config.agentModelId ?? USER_CONFIG_DEFAULTS.agentModelId,
+        policyModelId: config.policyModelId ?? USER_CONFIG_DEFAULTS.policyModelId,
+        anthropicApiKey: config.anthropicApiKey ?? '',
+        googleApiKey: config.googleApiKey ?? '',
+        openaiApiKey: config.openaiApiKey ?? '',
+        escalationTimeoutSeconds: config.escalationTimeoutSeconds ?? USER_CONFIG_DEFAULTS.escalationTimeoutSeconds,
+        resourceBudget: {
+            // Nullable fields: null means "disabled", undefined means "use default".
+            // Must use !== undefined (not ??) so explicit null is preserved.
+            maxTotalTokens: b?.maxTotalTokens !== undefined ? b.maxTotalTokens : budgetDefaults.maxTotalTokens,
+            maxSteps: b?.maxSteps !== undefined ? b.maxSteps : budgetDefaults.maxSteps,
+            maxSessionSeconds: b?.maxSessionSeconds !== undefined ? b.maxSessionSeconds : budgetDefaults.maxSessionSeconds,
+            maxEstimatedCostUsd: b?.maxEstimatedCostUsd !== undefined ? b.maxEstimatedCostUsd : budgetDefaults.maxEstimatedCostUsd,
+            warnThresholdPercent: b?.warnThresholdPercent ?? budgetDefaults.warnThresholdPercent,
+        },
+        autoCompact: {
+            enabled: c?.enabled ?? compactDefaults.enabled,
+            thresholdTokens: c?.thresholdTokens ?? compactDefaults.thresholdTokens,
+            keepRecentMessages: c?.keepRecentMessages ?? compactDefaults.keepRecentMessages,
+            summaryModelId: c?.summaryModelId ?? compactDefaults.summaryModelId,
+        },
+    };
+}
+/**
+ * Applies environment variable overrides for all provider API keys.
+ * Each provider's standard env var takes precedence over config file values.
+ */
+function applyEnvOverrides(config) {
+    return {
+        ...config,
+        anthropicApiKey: process.env.ANTHROPIC_API_KEY || config.anthropicApiKey,
+        googleApiKey: process.env.GOOGLE_GENERATIVE_AI_API_KEY || config.googleApiKey,
+        openaiApiKey: process.env.OPENAI_API_KEY || config.openaiApiKey,
+    };
+}
+//# sourceMappingURL=user-config.js.map

package/dist/config/user-config.js.map

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

package/dist/hash.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared hashing utilities for loop detection.
+ *
+ * Provides deterministic JSON serialization and SHA-256 hashing
+ * used by both the StepLoopDetector (agent level) and the
+ * CallCircuitBreaker (proxy level).
+ */
+/**
+ * Deterministic JSON serialization with sorted keys.
+ * Ensures `{a:1, b:2}` and `{b:2, a:1}` produce identical strings.
+ */
+export declare function stableStringify(value: unknown): string | undefined;
+/**
+ * SHA-256 hash of a deterministically serialized value.
+ * Returns a hex-encoded digest.
+ */
+export declare function computeHash(value: unknown): string;

package/dist/hash.js

@@ -0,0 +1,34 @@
+/**
+ * Shared hashing utilities for loop detection.
+ *
+ * Provides deterministic JSON serialization and SHA-256 hashing
+ * used by both the StepLoopDetector (agent level) and the
+ * CallCircuitBreaker (proxy level).
+ */
+import { createHash } from 'node:crypto';
+/**
+ * Deterministic JSON serialization with sorted keys.
+ * Ensures `{a:1, b:2}` and `{b:2, a:1}` produce identical strings.
+ */
+export function stableStringify(value) {
+    if (value === undefined)
+        return undefined;
+    if (value === null)
+        return 'null';
+    if (typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return '[' + value.map(stableStringify).join(',') + ']';
+    }
+    const keys = Object.keys(value).sort();
+    const pairs = keys.map((k) => JSON.stringify(k) + ':' + stableStringify(value[k]));
+    return '{' + pairs.join(',') + '}';
+}
+/**
+ * SHA-256 hash of a deterministically serialized value.
+ * Returns a hex-encoded digest.
+ */
+export function computeHash(value) {
+    return createHash('sha256').update(stableStringify(value) ?? '').digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,eAAe,CAAE,KAAiC,CAAC,CAAC,CAAC,CAAC,CACxF,CAAC;IACF,OAAO,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare function main(args?: string[]): Promise<void>;

package/dist/index.js

@@ -0,0 +1,61 @@
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseArgs } from 'node:util';
+import chalk from 'chalk';
+import ora from 'ora';
+import { loadConfig } from './config/index.js';
+import * as logger from './logger.js';
+import { CliTransport } from './session/cli-transport.js';
+import { createSession } from './session/index.js';
+export async function main(args) {
+    const { values, positionals } = parseArgs({
+        args: args ?? process.argv.slice(2),
+        options: {
+            resume: { type: 'string', short: 'r' },
+        },
+        allowPositionals: true,
+        strict: false,
+    });
+    const task = positionals.join(' ');
+    const resumeSessionId = values.resume;
+    const config = loadConfig();
+    // Create the transport first so we can wire its callbacks into the session.
+    const transport = new CliTransport({ initialMessage: task || undefined });
+    const initSpinner = ora({
+        text: 'Initializing session...',
+        stream: process.stderr,
+        discardStdin: false,
+    }).start();
+    let session;
+    try {
+        session = await createSession({
+            config,
+            resumeSessionId,
+            onEscalation: transport.createEscalationHandler(),
+            onDiagnostic: transport.createDiagnosticHandler(),
+        });
+    }
+    catch (error) {
+        initSpinner.fail(chalk.red('Session initialization failed'));
+        throw error;
+    }
+    initSpinner.succeed(chalk.dim('Session ready'));
+    process.stderr.write('\n');
+    try {
+        await transport.run(session);
+    }
+    finally {
+        await session.close();
+        logger.teardown();
+        process.exit(0);
+    }
+}
+// Only run when executed directly (not when imported by cli.ts)
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+    await import('dotenv/config');
+    main().catch((err) => {
+        process.stderr.write(chalk.red(`Fatal error: ${err}\n`));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LoggerOptions {
+    readonly logFilePath: string;
+}
+export declare function setup(options: LoggerOptions): void;
+export declare function teardown(): void;
+export declare function isActive(): boolean;
+export declare function debug(message: string): void;
+export declare function info(message: string): void;
+export declare function warn(message: string): void;
+export declare function error(message: string): void;

package/dist/logger.js

@@ -0,0 +1,93 @@
+// src/logger.ts
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+// --- Module state ---
+let logFilePath = null;
+/** Saved originals for restoration on teardown. */
+let originalConsole = null;
+// --- Lifecycle ---
+export function setup(options) {
+    if (logFilePath !== null) {
+        throw new Error('Logger already set up. Call teardown() first.');
+    }
+    logFilePath = options.logFilePath;
+    // Ensure parent directory exists
+    mkdirSync(dirname(logFilePath), { recursive: true });
+    // Save originals before patching
+    originalConsole = {
+        log: console.log,
+        error: console.error,
+        warn: console.warn,
+        debug: console.debug,
+    };
+    // Intercept console methods -- redirect to log file
+    console.log = (...args) => {
+        writeEntry('info', `[console.log] ${formatArgs(args)}`);
+    };
+    console.error = (...args) => {
+        writeEntry('error', `[console.error] ${formatArgs(args)}`);
+    };
+    console.warn = (...args) => {
+        writeEntry('warn', `[console.warn] ${formatArgs(args)}`);
+    };
+    console.debug = (...args) => {
+        writeEntry('debug', `[console.debug] ${formatArgs(args)}`);
+    };
+    writeEntry('info', 'Logger initialized');
+}
+export function teardown() {
+    if (originalConsole) {
+        console.log = originalConsole.log;
+        console.error = originalConsole.error;
+        console.warn = originalConsole.warn;
+        console.debug = originalConsole.debug;
+        originalConsole = null;
+    }
+    logFilePath = null;
+}
+export function isActive() {
+    return logFilePath !== null;
+}
+// --- Logging functions ---
+export function debug(message) {
+    writeEntry('debug', message);
+}
+export function info(message) {
+    writeEntry('info', message);
+}
+export function warn(message) {
+    writeEntry('warn', message);
+}
+export function error(message) {
+    writeEntry('error', message);
+}
+// --- Internal helpers ---
+const LEVEL_PAD = {
+    debug: 'DEBUG',
+    info: 'INFO ',
+    warn: 'WARN ',
+    error: 'ERROR',
+};
+function writeEntry(level, message) {
+    if (!logFilePath)
+        return; // no-op when not set up
+    const timestamp = new Date().toISOString();
+    const line = `${timestamp} ${LEVEL_PAD[level]} ${message}\n`;
+    try {
+        appendFileSync(logFilePath, line);
+    }
+    catch {
+        // Cannot log if the file is gone or disk is full.
+        // Swallow to avoid crashing the agent over a logging failure.
+    }
+}
+/**
+ * Formats console.* arguments into a single string, mimicking
+ * Node's util.format behavior for the common cases.
+ */
+function formatArgs(args) {
+    return args
+        .map((a) => (typeof a === 'string' ? a : JSON.stringify(a)))
+        .join(' ');
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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