copilot-flow 0.3.0

package/dist/core/error-handler.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Error classification for GitHub Copilot SDK errors.
+ * Maps raw errors into structured CopilotFlowError with category and retryability.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyError = classifyError;
+exports.formatError = formatError;
+exports.asCopilotFlowError = asCopilotFlowError;
+exports.isCopilotFlowError = isCopilotFlowError;
+/** Patterns used to classify raw error messages. */
+const PATTERNS = [
+    {
+        test: msg => msg.includes('copilot: command not found') ||
+            msg.includes('enoent') ||
+            msg.includes('cannot find') ||
+            msg.includes('not installed') ||
+            msg.includes('spawn') && msg.includes('enoent'),
+        category: 'copilot_not_installed',
+        retryable: false,
+    },
+    {
+        test: msg => msg.includes('401') ||
+            msg.includes('unauthorized') ||
+            msg.includes('authentication') ||
+            msg.includes('not authenticated') ||
+            msg.includes('login required'),
+        category: 'authentication',
+        retryable: false,
+    },
+    {
+        test: msg => msg.includes('403') ||
+            msg.includes('forbidden') ||
+            msg.includes('permission denied') ||
+            msg.includes('access denied'),
+        category: 'authorization',
+        retryable: false,
+    },
+    {
+        test: msg => msg.includes('404') ||
+            msg.includes('not found') ||
+            msg.includes('unknown model'),
+        category: 'not_found',
+        retryable: false,
+    },
+    {
+        test: msg => msg.includes('429') ||
+            msg.includes('rate limit') ||
+            msg.includes('too many requests'),
+        category: 'rate_limit',
+        retryable: true,
+        retryAfterMs: 5_000,
+    },
+    {
+        test: msg => msg.toLowerCase().includes('timeout') ||
+            msg.toLowerCase().includes('timed out'),
+        category: 'timeout',
+        retryable: true,
+        retryAfterMs: 1_000,
+    },
+    {
+        test: msg => msg.includes('session') && (msg.includes('closed') ||
+            msg.includes('disconnect') ||
+            msg.includes('crashed') ||
+            msg.includes('terminated')),
+        category: 'session_error',
+        retryable: true,
+        retryAfterMs: 2_000,
+    },
+    {
+        test: msg => ['econnreset', 'etimedout', 'econnrefused', 'enotfound', 'epipe'].some(c => msg.includes(c)),
+        category: 'network',
+        retryable: true,
+        retryAfterMs: 1_000,
+    },
+    {
+        test: msg => msg.includes('invalid') ||
+            msg.includes('validation') ||
+            msg.includes('bad request') ||
+            msg.includes('400'),
+        category: 'validation',
+        retryable: false,
+    },
+];
+/** Classify an unknown thrown value into a structured CopilotFlowError. */
+function classifyError(error) {
+    const raw = error instanceof Error ? error : new Error(String(error));
+    const msg = raw.message.toLowerCase();
+    for (const pattern of PATTERNS) {
+        if (pattern.test(msg, error)) {
+            return {
+                category: pattern.category,
+                message: raw.message,
+                retryable: pattern.retryable,
+                retryAfterMs: pattern.retryAfterMs,
+                originalError: error,
+            };
+        }
+    }
+    return {
+        category: 'unknown',
+        message: raw.message,
+        retryable: false,
+        originalError: error,
+    };
+}
+/** Format a CopilotFlowError for display in the terminal. */
+function formatError(error) {
+    const prefix = `[${error.category.toUpperCase()}]`;
+    let msg = `${prefix} ${error.message}`;
+    if (error.retryable && error.retryAfterMs) {
+        msg += ` (retryable, suggested delay: ${error.retryAfterMs}ms)`;
+    }
+    else if (!error.retryable) {
+        msg += ` (not retryable)`;
+    }
+    return msg;
+}
+/**
+ * Wraps an unknown error as a CopilotFlowError and re-throws it.
+ * Useful for catch blocks that need structured error info.
+ */
+function asCopilotFlowError(error) {
+    if (isCopilotFlowError(error))
+        return error;
+    return classifyError(error);
+}
+function isCopilotFlowError(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'category' in value &&
+        'message' in value &&
+        'retryable' in value);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/core/error-handler.js.map

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

package/dist/core/retry.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Retry engine with configurable backoff strategies, jitter, and intervals.
+ * Supports exponential, linear, constant, and fibonacci backoff.
+ */
+export type BackoffStrategy = 'exponential' | 'linear' | 'constant' | 'fibonacci';
+export interface RetryConfig {
+    /** Maximum number of attempts (including the first). Default: 3 */
+    maxAttempts: number;
+    /** Initial delay in milliseconds before first retry. Default: 1000 */
+    initialDelayMs: number;
+    /** Maximum delay cap in milliseconds. Default: 30000 */
+    maxDelayMs: number;
+    /** Backoff strategy. Default: 'exponential' */
+    backoffStrategy: BackoffStrategy;
+    /** Multiplier for exponential/linear strategies. Default: 2 */
+    multiplier: number;
+    /** Apply ±10% random jitter to prevent thundering herd. Default: true */
+    jitter: boolean;
+    /**
+     * Custom predicate — return true to retry on this error.
+     * Defaults to RetryPredicates.copilotErrors.
+     */
+    retryOn?: (error: Error, attempt: number) => boolean;
+    /** Called before each retry with error, attempt number, and next delay. */
+    onRetry?: (error: Error, attempt: number, nextDelayMs: number) => void;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/** Calculate the base delay (before jitter) for a given attempt (1-indexed). */
+export declare function calculateDelay(attempt: number, config: RetryConfig): number;
+/** Built-in retry predicates for common error categories. */
+export declare const RetryPredicates: {
+    networkErrors: (e: Error) => boolean;
+    rateLimitErrors: (e: Error) => boolean;
+    serverErrors: (e: Error) => boolean;
+    timeoutErrors: (e: Error) => boolean;
+    /** Retries on all transient Copilot/network errors. */
+    copilotErrors: (e: Error) => boolean;
+    /** Retry on any error. Use with caution. */
+    all: (_e: Error) => boolean;
+};
+export interface RetryResult<T> {
+    value: T;
+    attempts: number;
+    totalDurationMs: number;
+}
+/**
+ * Execute `fn` with automatic retries on failure.
+ *
+ * @example
+ * const result = await withRetry(
+ *   () => session.sendAndWait({ prompt: task }),
+ *   { maxAttempts: 3, backoffStrategy: 'exponential', onRetry: (err, n) => console.log(`Retry ${n}: ${err.message}`) }
+ * );
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/core/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/core/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAElF,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,eAAe,EAAE,eAAe,CAAC;IACjC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACxE;AAED,eAAO,MAAM,oBAAoB,EAAE,WAOlC,CAAC;AAWF,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CA4B3E;AAED,6DAA6D;AAC7D,eAAO,MAAM,eAAe;uBACP,KAAK,KAAG,OAAO;yBAKb,KAAK,KAAG,OAAO;sBAKlB,KAAK,KAAG,OAAO;uBAKd,KAAK,KAAG,OAAO;IAIlC,uDAAuD;uBACpC,KAAK,KAAG,OAAO;IAMlC,4CAA4C;cAClC,KAAK,KAAG,OAAO;CAC1B,CAAC;AAEF,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC,CA2BZ"}

package/dist/core/retry.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Retry engine with configurable backoff strategies, jitter, and intervals.
+ * Supports exponential, linear, constant, and fibonacci backoff.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryPredicates = exports.DEFAULT_RETRY_CONFIG = void 0;
+exports.calculateDelay = calculateDelay;
+exports.withRetry = withRetry;
+exports.DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30_000,
+    backoffStrategy: 'exponential',
+    multiplier: 2,
+    jitter: true,
+};
+// Pre-cached fibonacci values to avoid recomputation
+const FIB_CACHE = [1, 1];
+function fib(n) {
+    while (FIB_CACHE.length <= n) {
+        FIB_CACHE.push(FIB_CACHE[FIB_CACHE.length - 1] + FIB_CACHE[FIB_CACHE.length - 2]);
+    }
+    return FIB_CACHE[n];
+}
+/** Calculate the base delay (before jitter) for a given attempt (1-indexed). */
+function calculateDelay(attempt, config) {
+    const { initialDelayMs, maxDelayMs, backoffStrategy, multiplier } = config;
+    let delay;
+    switch (backoffStrategy) {
+        case 'exponential':
+            delay = initialDelayMs * Math.pow(multiplier, attempt - 1);
+            break;
+        case 'linear':
+            delay = initialDelayMs * attempt;
+            break;
+        case 'constant':
+            delay = initialDelayMs;
+            break;
+        case 'fibonacci':
+            delay = initialDelayMs * fib(attempt - 1);
+            break;
+        default:
+            delay = initialDelayMs;
+    }
+    if (config.jitter) {
+        // Apply ±10% random jitter
+        const jitterAmount = (Math.random() - 0.5) * 0.2 * delay;
+        delay += jitterAmount;
+    }
+    return Math.min(Math.max(delay, 0), maxDelayMs);
+}
+/** Built-in retry predicates for common error categories. */
+exports.RetryPredicates = {
+    networkErrors: (e) => ['ECONNRESET', 'ETIMEDOUT', 'ECONNREFUSED', 'ENOTFOUND', 'EPIPE', 'EHOSTUNREACH'].some(code => e.message.includes(code) || e.code === code),
+    rateLimitErrors: (e) => e.message.includes('429') ||
+        e.message.toLowerCase().includes('rate limit') ||
+        e.message.toLowerCase().includes('too many requests'),
+    serverErrors: (e) => /\b5[0-9]{2}\b/.test(e.message) ||
+        e.message.toLowerCase().includes('internal server error') ||
+        e.message.toLowerCase().includes('service unavailable'),
+    timeoutErrors: (e) => e.message.toLowerCase().includes('timeout') ||
+        e.message.toLowerCase().includes('timed out'),
+    /** Retries on all transient Copilot/network errors. */
+    copilotErrors: (e) => exports.RetryPredicates.networkErrors(e) ||
+        exports.RetryPredicates.rateLimitErrors(e) ||
+        exports.RetryPredicates.serverErrors(e) ||
+        exports.RetryPredicates.timeoutErrors(e),
+    /** Retry on any error. Use with caution. */
+    all: (_e) => true,
+};
+/**
+ * Execute `fn` with automatic retries on failure.
+ *
+ * @example
+ * const result = await withRetry(
+ *   () => session.sendAndWait({ prompt: task }),
+ *   { maxAttempts: 3, backoffStrategy: 'exponential', onRetry: (err, n) => console.log(`Retry ${n}: ${err.message}`) }
+ * );
+ */
+async function withRetry(fn, config = {}) {
+    const cfg = { ...exports.DEFAULT_RETRY_CONFIG, ...config };
+    const retryOn = cfg.retryOn ?? exports.RetryPredicates.copilotErrors;
+    const startTime = Date.now();
+    let lastError = new Error('Unknown error');
+    for (let attempt = 1; attempt <= cfg.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            const isLastAttempt = attempt >= cfg.maxAttempts;
+            if (isLastAttempt || !retryOn(lastError, attempt)) {
+                throw lastError;
+            }
+            const delayMs = calculateDelay(attempt, cfg);
+            cfg.onRetry?.(lastError, attempt, delayMs);
+            await sleep(delayMs);
+        }
+    }
+    // Should never reach here, but TypeScript needs a return path
+    throw lastError;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/core/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/core/retry.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA6CH,wCA4BC;AAiDD,8BA8BC;AA9HY,QAAA,oBAAoB,GAAgB;IAC/C,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,MAAM;IAClB,eAAe,EAAE,aAAa;IAC9B,UAAU,EAAE,CAAC;IACb,MAAM,EAAE,IAAI;CACb,CAAC;AAEF,qDAAqD;AACrD,MAAM,SAAS,GAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACnC,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAED,gFAAgF;AAChF,SAAgB,cAAc,CAAC,OAAe,EAAE,MAAmB;IACjE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC3E,IAAI,KAAa,CAAC;IAElB,QAAQ,eAAe,EAAE,CAAC;QACxB,KAAK,aAAa;YAChB,KAAK,GAAG,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAC3D,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,GAAG,cAAc,GAAG,OAAO,CAAC;YACjC,MAAM;QACR,KAAK,UAAU;YACb,KAAK,GAAG,cAAc,CAAC;YACvB,MAAM;QACR,KAAK,WAAW;YACd,KAAK,GAAG,cAAc,GAAG,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAC1C,MAAM;QACR;YACE,KAAK,GAAG,cAAc,CAAC;IAC3B,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,2BAA2B;QAC3B,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC;QACzD,KAAK,IAAI,YAAY,CAAC;IACxB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,6DAA6D;AAChD,QAAA,eAAe,GAAG;IAC7B,aAAa,EAAE,CAAC,CAAQ,EAAW,EAAE,CACnC,CAAC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,IAAI,CACpF,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAK,CAA2B,CAAC,IAAI,KAAK,IAAI,CAC/E;IAEH,eAAe,EAAE,CAAC,CAAQ,EAAW,EAAE,CACrC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC9C,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAEvD,YAAY,EAAE,CAAC,CAAQ,EAAW,EAAE,CAClC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAC/B,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACzD,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAEzD,aAAa,EAAE,CAAC,CAAQ,EAAW,EAAE,CACnC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3C,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;IAE/C,uDAAuD;IACvD,aAAa,EAAE,CAAC,CAAQ,EAAW,EAAE,CACnC,uBAAe,CAAC,aAAa,CAAC,CAAC,CAAC;QAChC,uBAAe,CAAC,eAAe,CAAC,CAAC,CAAC;QAClC,uBAAe,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/B,uBAAe,CAAC,aAAa,CAAC,CAAC,CAAC;IAElC,4CAA4C;IAC5C,GAAG,EAAE,CAAC,EAAS,EAAW,EAAE,CAAC,IAAI;CAClC,CAAC;AAQF;;;;;;;;GAQG;AACI,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,SAA+B,EAAE;IAEjC,MAAM,GAAG,GAAgB,EAAE,GAAG,4BAAoB,EAAE,GAAG,MAAM,EAAE,CAAC;IAChE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,uBAAe,CAAC,aAAa,CAAC;IAE7D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,SAAS,GAAU,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IAElD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAEhE,MAAM,aAAa,GAAG,OAAO,IAAI,GAAG,CAAC,WAAW,CAAC;YACjD,IAAI,aAAa,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;gBAClD,MAAM,SAAS,CAAC;YAClB,CAAC;YAED,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC7C,GAAG,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAE3C,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/hooks/executor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Hook executor — runs all handlers for an event with timeout protection.
+ */
+import type { HookEvent } from '../types.js';
+/**
+ * Emit a hook event and run all registered handlers.
+ * Handlers that exceed the timeout or throw are logged but do not block execution.
+ *
+ * @param continueOnError - If false, the first handler error aborts remaining handlers. Default: true.
+ */
+export declare function emit<T = unknown>(event: HookEvent, data?: T, options?: {
+    timeoutMs?: number;
+    continueOnError?: boolean;
+}): Promise<void>;
+export declare const hooks: {
+    preTask: (data?: unknown) => Promise<void>;
+    postTask: (data?: unknown) => Promise<void>;
+    sessionStart: (data?: unknown) => Promise<void>;
+    sessionEnd: (data?: unknown) => Promise<void>;
+    agentSpawn: (data?: unknown) => Promise<void>;
+    agentTerminate: (data?: unknown) => Promise<void>;
+    swarmStart: (data?: unknown) => Promise<void>;
+    swarmEnd: (data?: unknown) => Promise<void>;
+};
+//# sourceMappingURL=executor.d.ts.map

package/dist/hooks/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/hooks/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAa1D;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,CAAC,GAAG,OAAO,EACpC,KAAK,EAAE,SAAS,EAChB,IAAI,CAAC,EAAE,CAAC,EACR,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9D,OAAO,CAAC,IAAI,CAAC,CAsBf;AAGD,eAAO,MAAM,KAAK;qBACC,OAAO;sBACN,OAAO;0BACH,OAAO;wBACT,OAAO;wBACP,OAAO;4BACH,OAAO;wBACX,OAAO;sBACT,OAAO;CAC1B,CAAC"}

package/dist/hooks/executor.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Hook executor — runs all handlers for an event with timeout protection.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hooks = void 0;
+exports.emit = emit;
+const registry_js_1 = require("./registry.js");
+const output_js_1 = require("../output.js");
+const DEFAULT_TIMEOUT_MS = 5_000;
+function withTimeout(promise, ms) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`Hook timed out after ${ms}ms`)), ms)),
+    ]);
+}
+/**
+ * Emit a hook event and run all registered handlers.
+ * Handlers that exceed the timeout or throw are logged but do not block execution.
+ *
+ * @param continueOnError - If false, the first handler error aborts remaining handlers. Default: true.
+ */
+async function emit(event, data, options = {}) {
+    const handlers = registry_js_1.globalHooks.getHandlers(event);
+    if (handlers.length === 0)
+        return;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const continueOnError = options.continueOnError ?? true;
+    const ctx = {
+        event,
+        timestamp: Date.now(),
+        data,
+    };
+    for (const handler of handlers) {
+        try {
+            await withTimeout(handler(ctx), timeoutMs);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            output_js_1.output.warn(`Hook [${event}] handler error: ${msg}`);
+            if (!continueOnError)
+                throw err;
+        }
+    }
+}
+// Convenience wrappers
+exports.hooks = {
+    preTask: (data) => emit('pre-task', data),
+    postTask: (data) => emit('post-task', data),
+    sessionStart: (data) => emit('session-start', data),
+    sessionEnd: (data) => emit('session-end', data),
+    agentSpawn: (data) => emit('agent-spawn', data),
+    agentTerminate: (data) => emit('agent-terminate', data),
+    swarmStart: (data) => emit('swarm-start', data),
+    swarmEnd: (data) => emit('swarm-end', data),
+};
+//# sourceMappingURL=executor.js.map

package/dist/hooks/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/hooks/executor.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAuBH,oBA0BC;AA/CD,+CAA4C;AAC5C,4CAAsC;AAGtC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAEjC,SAAS,WAAW,CAAI,OAAmB,EAAE,EAAU;IACrD,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,OAAO;QACP,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC3B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CACxE;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,IAAI,CACxB,KAAgB,EAChB,IAAQ,EACR,UAA6D,EAAE;IAE/D,MAAM,QAAQ,GAAG,yBAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAElC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC1D,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IAExD,MAAM,GAAG,GAAmB;QAC1B,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,IAAI;KACL,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,kBAAM,CAAC,IAAI,CAAC,SAAS,KAAK,oBAAoB,GAAG,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,eAAe;gBAAE,MAAM,GAAG,CAAC;QAClC,CAAC;IACH,CAAC;AACH,CAAC;AAED,uBAAuB;AACV,QAAA,KAAK,GAAG;IACnB,OAAO,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;IACnD,QAAQ,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC;IACrD,YAAY,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC;IAC7D,UAAU,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC;IACzD,UAAU,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC;IACzD,cAAc,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC;IACjE,UAAU,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC;IACzD,QAAQ,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC;CACtD,CAAC"}

package/dist/hooks/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Hook registry — priority-ordered pub/sub for lifecycle events.
+ */
+import type { HookEvent, HookHandler } from '../types.js';
+export declare class HookRegistry {
+    private hooks;
+    /** Register a handler for an event. Higher priority runs first. Default: 50. */
+    on(event: HookEvent, handler: HookHandler, priority?: number): () => void;
+    /** Unregister a handler. */
+    off(event: HookEvent, handler: HookHandler): void;
+    /** Get handlers registered for an event, sorted by priority. */
+    getHandlers(event: HookEvent): HookHandler[];
+    /** Return all registered hooks (for inspection). */
+    list(): Array<{
+        id: string;
+        event: HookEvent;
+        priority: number;
+    }>;
+    clear(): void;
+}
+export declare const globalHooks: HookRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/hooks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAe,MAAM,aAAa,CAAC;AAWvE,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAmB;IAEhC,gFAAgF;IAChF,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,SAAK,GAAG,MAAM,IAAI;IAQrE,4BAA4B;IAC5B,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIjD,gEAAgE;IAChE,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,EAAE;IAI5C,oDAAoD;IACpD,IAAI,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAIjE,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,WAAW,cAAqB,CAAC"}

package/dist/hooks/registry.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Hook registry — priority-ordered pub/sub for lifecycle events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalHooks = exports.HookRegistry = void 0;
+let _nextId = 0;
+class HookRegistry {
+    hooks = [];
+    /** Register a handler for an event. Higher priority runs first. Default: 50. */
+    on(event, handler, priority = 50) {
+        const entry = { id: String(_nextId++), event, handler, priority };
+        this.hooks.push(entry);
+        this.hooks.sort((a, b) => b.priority - a.priority);
+        // Return unsubscribe function
+        return () => this.off(event, handler);
+    }
+    /** Unregister a handler. */
+    off(event, handler) {
+        this.hooks = this.hooks.filter(h => !(h.event === event && h.handler === handler));
+    }
+    /** Get handlers registered for an event, sorted by priority. */
+    getHandlers(event) {
+        return this.hooks.filter(h => h.event === event).map(h => h.handler);
+    }
+    /** Return all registered hooks (for inspection). */
+    list() {
+        return this.hooks.map(({ id, event, priority }) => ({ id, event, priority }));
+    }
+    clear() {
+        this.hooks = [];
+    }
+}
+exports.HookRegistry = HookRegistry;
+exports.globalHooks = new HookRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/hooks/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAWH,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB,MAAa,YAAY;IACf,KAAK,GAAgB,EAAE,CAAC;IAEhC,gFAAgF;IAChF,EAAE,CAAC,KAAgB,EAAE,OAAoB,EAAE,QAAQ,GAAG,EAAE;QACtD,MAAM,KAAK,GAAc,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAC7E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QACnD,8BAA8B;QAC9B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,4BAA4B;IAC5B,GAAG,CAAC,KAAgB,EAAE,OAAoB;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,gEAAgE;IAChE,WAAW,CAAC,KAAgB;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACvE,CAAC;IAED,oDAAoD;IACpD,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;CACF;AA9BD,oCA8BC;AAEY,QAAA,WAAW,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * copilot-flow — public package API.
+ *
+ * Import these when using copilot-flow as a library inside your own scripts.
+ */
+export { withRetry, calculateDelay, RetryPredicates, DEFAULT_RETRY_CONFIG } from './core/retry.js';
+export type { RetryConfig, BackoffStrategy } from './core/retry.js';
+export { classifyError, formatError, asCopilotFlowError, isCopilotFlowError } from './core/error-handler.js';
+export type { CopilotFlowError, CopilotFlowErrorCategory } from './core/error-handler.js';
+export { clientManager, ClientManager } from './core/client-manager.js';
+export { runAgentTask } from './agents/executor.js';
+export { AGENT_REGISTRY, getAgentDefinition, listAgentTypes, routeTask } from './agents/registry.js';
+export { agentPool } from './agents/pool.js';
+export { runSwarm } from './swarm/coordinator.js';
+export { MemoryStore, getMemoryStore } from './memory/store.js';
+export { globalHooks, HookRegistry } from './hooks/registry.js';
+export { emit, hooks } from './hooks/executor.js';
+export { loadConfig, saveConfig, DEFAULT_CONFIG } from './config.js';
+export type { AgentType, AgentDefinition, AgentState, AgentResult, SwarmTask, SwarmTopology, MemoryEntry, StoreOptions, HookEvent, HookHandler, HookContext, CopilotFlowConfig, CommandContext, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACnG,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7G,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGrE,YAAY,EACV,SAAS,EACT,eAAe,EACf,UAAU,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,WAAW,EACX,YAAY,EACZ,SAAS,EACT,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * copilot-flow — public package API.
+ *
+ * Import these when using copilot-flow as a library inside your own scripts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = exports.saveConfig = exports.loadConfig = exports.hooks = exports.emit = exports.HookRegistry = exports.globalHooks = exports.getMemoryStore = exports.MemoryStore = exports.runSwarm = exports.agentPool = exports.routeTask = exports.listAgentTypes = exports.getAgentDefinition = exports.AGENT_REGISTRY = exports.runAgentTask = exports.ClientManager = exports.clientManager = exports.isCopilotFlowError = exports.asCopilotFlowError = exports.formatError = exports.classifyError = exports.DEFAULT_RETRY_CONFIG = exports.RetryPredicates = exports.calculateDelay = exports.withRetry = void 0;
+// Core
+var retry_js_1 = require("./core/retry.js");
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return retry_js_1.withRetry; } });
+Object.defineProperty(exports, "calculateDelay", { enumerable: true, get: function () { return retry_js_1.calculateDelay; } });
+Object.defineProperty(exports, "RetryPredicates", { enumerable: true, get: function () { return retry_js_1.RetryPredicates; } });
+Object.defineProperty(exports, "DEFAULT_RETRY_CONFIG", { enumerable: true, get: function () { return retry_js_1.DEFAULT_RETRY_CONFIG; } });
+var error_handler_js_1 = require("./core/error-handler.js");
+Object.defineProperty(exports, "classifyError", { enumerable: true, get: function () { return error_handler_js_1.classifyError; } });
+Object.defineProperty(exports, "formatError", { enumerable: true, get: function () { return error_handler_js_1.formatError; } });
+Object.defineProperty(exports, "asCopilotFlowError", { enumerable: true, get: function () { return error_handler_js_1.asCopilotFlowError; } });
+Object.defineProperty(exports, "isCopilotFlowError", { enumerable: true, get: function () { return error_handler_js_1.isCopilotFlowError; } });
+var client_manager_js_1 = require("./core/client-manager.js");
+Object.defineProperty(exports, "clientManager", { enumerable: true, get: function () { return client_manager_js_1.clientManager; } });
+Object.defineProperty(exports, "ClientManager", { enumerable: true, get: function () { return client_manager_js_1.ClientManager; } });
+// Agents
+var executor_js_1 = require("./agents/executor.js");
+Object.defineProperty(exports, "runAgentTask", { enumerable: true, get: function () { return executor_js_1.runAgentTask; } });
+var registry_js_1 = require("./agents/registry.js");
+Object.defineProperty(exports, "AGENT_REGISTRY", { enumerable: true, get: function () { return registry_js_1.AGENT_REGISTRY; } });
+Object.defineProperty(exports, "getAgentDefinition", { enumerable: true, get: function () { return registry_js_1.getAgentDefinition; } });
+Object.defineProperty(exports, "listAgentTypes", { enumerable: true, get: function () { return registry_js_1.listAgentTypes; } });
+Object.defineProperty(exports, "routeTask", { enumerable: true, get: function () { return registry_js_1.routeTask; } });
+var pool_js_1 = require("./agents/pool.js");
+Object.defineProperty(exports, "agentPool", { enumerable: true, get: function () { return pool_js_1.agentPool; } });
+// Swarm
+var coordinator_js_1 = require("./swarm/coordinator.js");
+Object.defineProperty(exports, "runSwarm", { enumerable: true, get: function () { return coordinator_js_1.runSwarm; } });
+// Memory
+var store_js_1 = require("./memory/store.js");
+Object.defineProperty(exports, "MemoryStore", { enumerable: true, get: function () { return store_js_1.MemoryStore; } });
+Object.defineProperty(exports, "getMemoryStore", { enumerable: true, get: function () { return store_js_1.getMemoryStore; } });
+// Hooks
+var registry_js_2 = require("./hooks/registry.js");
+Object.defineProperty(exports, "globalHooks", { enumerable: true, get: function () { return registry_js_2.globalHooks; } });
+Object.defineProperty(exports, "HookRegistry", { enumerable: true, get: function () { return registry_js_2.HookRegistry; } });
+var executor_js_2 = require("./hooks/executor.js");
+Object.defineProperty(exports, "emit", { enumerable: true, get: function () { return executor_js_2.emit; } });
+Object.defineProperty(exports, "hooks", { enumerable: true, get: function () { return executor_js_2.hooks; } });
+// Config
+var config_js_1 = require("./config.js");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_js_1.loadConfig; } });
+Object.defineProperty(exports, "saveConfig", { enumerable: true, get: function () { return config_js_1.saveConfig; } });
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return config_js_1.DEFAULT_CONFIG; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,OAAO;AACP,4CAAmG;AAA1F,qGAAA,SAAS,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AAEzE,4DAA6G;AAApG,iHAAA,aAAa,OAAA;AAAE,+GAAA,WAAW,OAAA;AAAE,sHAAA,kBAAkB,OAAA;AAAE,sHAAA,kBAAkB,OAAA;AAE3E,8DAAwE;AAA/D,kHAAA,aAAa,OAAA;AAAE,kHAAA,aAAa,OAAA;AAErC,SAAS;AACT,oDAAoD;AAA3C,2GAAA,YAAY,OAAA;AACrB,oDAAqG;AAA5F,6GAAA,cAAc,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAAE,6GAAA,cAAc,OAAA;AAAE,wGAAA,SAAS,OAAA;AACtE,4CAA6C;AAApC,oGAAA,SAAS,OAAA;AAElB,QAAQ;AACR,yDAAkD;AAAzC,0GAAA,QAAQ,OAAA;AAEjB,SAAS;AACT,8CAAgE;AAAvD,uGAAA,WAAW,OAAA;AAAE,0GAAA,cAAc,OAAA;AAEpC,QAAQ;AACR,mDAAgE;AAAvD,0GAAA,WAAW,OAAA;AAAE,2GAAA,YAAY,OAAA;AAClC,mDAAkD;AAAzC,mGAAA,IAAI,OAAA;AAAE,oGAAA,KAAK,OAAA;AAEpB,SAAS;AACT,yCAAqE;AAA5D,uGAAA,UAAU,OAAA;AAAE,uGAAA,UAAU,OAAA;AAAE,2GAAA,cAAc,OAAA"}

package/dist/memory/store.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SQLite-backed namespaced key-value memory store.
+ * Used by agents to share state and by the CLI to persist data between runs.
+ *
+ * Uses Node.js built-in `node:sqlite` (available since Node 22.5) to avoid
+ * native addon compilation requirements.
+ */
+import type { MemoryEntry, StoreOptions } from '../types.js';
+export declare class MemoryStore {
+    private db;
+    constructor(dbPath?: string);
+    /** Store a value under namespace/key. Upserts if key already exists. */
+    store(namespace: string, key: string, value: string, opts?: StoreOptions): void;
+    /** Retrieve a value by namespace and key. Returns null if not found or expired. */
+    retrieve(namespace: string, key: string): string | null;
+    /**
+     * Search entries in a namespace by substring match on key or value.
+     * Returns up to `limit` results (default 20).
+     */
+    search(namespace: string, query: string, limit?: number): MemoryEntry[];
+    /** List all non-expired entries in a namespace. */
+    list(namespace: string): MemoryEntry[];
+    /** Delete a specific key from a namespace. */
+    delete(namespace: string, key: string): boolean;
+    /** Delete all entries in a namespace. Returns the number of deleted entries. */
+    clear(namespace: string): number;
+    /** Close the database connection. */
+    close(): void;
+    private _pruneExpired;
+}
+export declare function getMemoryStore(dbPath?: string): MemoryStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/memory/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiB7D,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAe;gBAEb,MAAM,SAA0C;IAa5D,wEAAwE;IACxE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI;IAoBnF,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAYvD;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,WAAW,EAAE;IAkCnE,mDAAmD;IACnD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;IA8BtC,8CAA8C;IAC9C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAO/C,gFAAgF;IAChF,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAOhC,qCAAqC;IACrC,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,aAAa;CAKtB;AAKD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAK3D"}