adaria-ai 0.1.0

package/dist/utils/logger.js

@@ -0,0 +1,93 @@
+/**
+ * Structured JSON logger with correlation IDs, log levels, and file output.
+ * Writes to $ADARIA_HOME/logs/adaria-YYYY-MM-DD.log.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { LOGS_DIR } from "./paths.js";
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let currentCorrelationId;
+let minLevel = "info";
+const metrics = {
+    requestCount: 0,
+    errorCount: 0,
+    totalResponseTimeMs: 0,
+};
+export function setLogLevel(level) {
+    minLevel = level;
+}
+export function setCorrelationId(id) {
+    currentCorrelationId = id;
+}
+export function generateCorrelationId() {
+    const id = `req-${String(Date.now())}-${Math.random().toString(36).slice(2, 8)}`;
+    currentCorrelationId = id;
+    return id;
+}
+export function getCorrelationId() {
+    return currentCorrelationId;
+}
+function getLogFilePath() {
+    const today = new Date().toISOString().slice(0, 10);
+    return path.join(LOGS_DIR, `adaria-${today}.log`);
+}
+function writeLog(entry) {
+    if (LEVEL_PRIORITY[entry.level] < LEVEL_PRIORITY[minLevel])
+        return;
+    const line = JSON.stringify(entry);
+    try {
+        fs.mkdirSync(LOGS_DIR, { recursive: true });
+        fs.appendFileSync(getLogFilePath(), line + "\n");
+    }
+    catch {
+        // Best-effort logging — do not crash the caller
+    }
+    if (entry.level === "error") {
+        console.error(`[${entry.timestamp}] ERROR: ${entry.message}`);
+    }
+}
+export function log(level, message, extra) {
+    writeLog({
+        timestamp: new Date().toISOString(),
+        level,
+        message,
+        correlationId: currentCorrelationId,
+        ...extra,
+    });
+}
+export function debug(message, extra) {
+    log("debug", message, extra);
+}
+export function info(message, extra) {
+    log("info", message, extra);
+}
+export function warn(message, extra) {
+    log("warn", message, extra);
+}
+export function error(message, extra) {
+    log("error", message, extra);
+}
+export function recordRequest() {
+    metrics.requestCount++;
+}
+export function recordError() {
+    metrics.errorCount++;
+}
+export function recordResponseTime(ms) {
+    metrics.totalResponseTimeMs += ms;
+}
+export function getMetrics() {
+    return {
+        requestCount: metrics.requestCount,
+        errorCount: metrics.errorCount,
+        avgResponseTimeMs: metrics.requestCount > 0
+            ? Math.round(metrics.totalResponseTimeMs / metrics.requestCount)
+            : 0,
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/parse-json.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Safely extract and parse JSON from Claude text responses.
+ * Uses bracket-matching instead of greedy regex to handle nested structures.
+ *
+ * Returns `unknown` — callers must narrow via type guards or schema validation.
+ *
+ * Complexity note: the extraction path is O(n * k) where n is text length and
+ * k is the cost of rescanning after a failed JSON.parse inside the nested loop.
+ * Fine for typical Claude responses (<10KB) but revisit in M1e if we start
+ * piping long agent transcripts through this (add max length guard first).
+ */
+export declare function parseJsonResponse(text: string | null | undefined, fallback?: unknown): unknown;
+//# sourceMappingURL=parse-json.d.ts.map

package/dist/utils/parse-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json.d.ts","sourceRoot":"","sources":["../../src/utils/parse-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,QAAQ,GAAE,OAAc,GACvB,OAAO,CAoDT"}

package/dist/utils/parse-json.js

@@ -0,0 +1,61 @@
+/**
+ * Safely extract and parse JSON from Claude text responses.
+ * Uses bracket-matching instead of greedy regex to handle nested structures.
+ *
+ * Returns `unknown` — callers must narrow via type guards or schema validation.
+ *
+ * Complexity note: the extraction path is O(n * k) where n is text length and
+ * k is the cost of rescanning after a failed JSON.parse inside the nested loop.
+ * Fine for typical Claude responses (<10KB) but revisit in M1e if we start
+ * piping long agent transcripts through this (add max length guard first).
+ */
+export function parseJsonResponse(text, fallback = null) {
+    if (!text)
+        return fallback;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        // Fall through to extraction
+    }
+    for (let i = 0; i < text.length; i++) {
+        const ch = text.charAt(i);
+        if (ch !== "{" && ch !== "[")
+            continue;
+        const endCh = ch === "{" ? "}" : "]";
+        let depth = 0;
+        let inString = false;
+        let escape = false;
+        for (let j = i; j < text.length; j++) {
+            const c = text.charAt(j);
+            if (escape) {
+                escape = false;
+                continue;
+            }
+            if (c === "\\" && inString) {
+                escape = true;
+                continue;
+            }
+            if (c === '"') {
+                inString = !inString;
+                continue;
+            }
+            if (inString)
+                continue;
+            if (c === ch)
+                depth++;
+            if (c === endCh)
+                depth--;
+            if (depth === 0) {
+                try {
+                    return JSON.parse(text.slice(i, j + 1));
+                }
+                catch {
+                    break;
+                }
+            }
+        }
+    }
+    return fallback;
+}
+//# sourceMappingURL=parse-json.js.map

package/dist/utils/parse-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json.js","sourceRoot":"","sources":["../../src/utils/parse-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAA+B,EAC/B,WAAoB,IAAI;IAExB,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAE3B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG;YAAE,SAAS;QAEvC,MAAM,KAAK,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACrC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,MAAM,GAAG,KAAK,CAAC;QAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAEzB,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,GAAG,KAAK,CAAC;gBACf,SAAS;YACX,CAAC;YAED,IAAI,CAAC,KAAK,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,GAAG,IAAI,CAAC;gBACd,SAAS;YACX,CAAC;YAED,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;gBACd,QAAQ,GAAG,CAAC,QAAQ,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,IAAI,QAAQ;gBAAE,SAAS;YAEvB,IAAI,CAAC,KAAK,EAAE;gBAAE,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,KAAK;gBAAE,KAAK,EAAE,CAAC;YAEzB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAY,CAAC;gBACrD,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,14 @@
+export declare const BUNDLED_PROMPTS_DIR: string;
+export declare const BUNDLED_LAUNCHD_DIR: string;
+export declare const PACKAGE_JSON_PATH: string;
+export declare const ADARIA_HOME: string;
+export declare const CONFIG_PATH: string;
+export declare const APPS_PATH: string;
+export declare const SESSIONS_PATH: string;
+export declare const AUDIT_PATH: string;
+export declare const DATA_DIR: string;
+export declare const DB_PATH: string;
+export declare const LOGS_DIR: string;
+export declare const MEMORY_DIR: string;
+export declare const CONVERSATIONS_DIR: string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,mBAAmB,QAAoC,CAAC;AACrE,eAAO,MAAM,mBAAmB,QAAoC,CAAC;AACrE,eAAO,MAAM,iBAAiB,QAAyC,CAAC;AAExE,eAAO,MAAM,WAAW,QAC0C,CAAC;AAEnE,eAAO,MAAM,WAAW,QAAwC,CAAC;AACjE,eAAO,MAAM,SAAS,QAAsC,CAAC;AAC7D,eAAO,MAAM,aAAa,QAA0C,CAAC;AACrE,eAAO,MAAM,UAAU,QAAwC,CAAC;AAChE,eAAO,MAAM,QAAQ,QAAiC,CAAC;AACvD,eAAO,MAAM,OAAO,QAAmC,CAAC;AACxD,eAAO,MAAM,QAAQ,QAAiC,CAAC;AACvD,eAAO,MAAM,UAAU,QAAmC,CAAC;AAC3D,eAAO,MAAM,iBAAiB,QAA0C,CAAC"}

package/dist/utils/paths.js

@@ -0,0 +1,19 @@
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import os from "node:os";
+const thisFile = fileURLToPath(import.meta.url);
+const packageRoot = path.resolve(path.dirname(thisFile), "..", "..");
+export const BUNDLED_PROMPTS_DIR = path.join(packageRoot, "prompts");
+export const BUNDLED_LAUNCHD_DIR = path.join(packageRoot, "launchd");
+export const PACKAGE_JSON_PATH = path.join(packageRoot, "package.json");
+export const ADARIA_HOME = process.env["ADARIA_HOME"] ?? path.join(os.homedir(), ".adaria");
+export const CONFIG_PATH = path.join(ADARIA_HOME, "config.yaml");
+export const APPS_PATH = path.join(ADARIA_HOME, "apps.yaml");
+export const SESSIONS_PATH = path.join(ADARIA_HOME, "sessions.json");
+export const AUDIT_PATH = path.join(ADARIA_HOME, "audit.jsonl");
+export const DATA_DIR = path.join(ADARIA_HOME, "data");
+export const DB_PATH = path.join(DATA_DIR, "adaria.db");
+export const LOGS_DIR = path.join(ADARIA_HOME, "logs");
+export const MEMORY_DIR = path.join(ADARIA_HOME, "memory");
+export const CONVERSATIONS_DIR = path.join(ADARIA_HOME, "conversations");
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,WAAW,GACtB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC"}

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Token bucket rate limiter for outbound message throttling.
+ */
+export declare class RateLimiter {
+    private tokens;
+    private readonly maxTokens;
+    private readonly refillRate;
+    private lastRefill;
+    /**
+     * @param maxTokens Maximum burst capacity
+     * @param refillRate Tokens added per second
+     */
+    constructor(maxTokens: number, refillRate: number);
+    /** Waits until a token is available, then consumes it. */
+    acquire(): Promise<void>;
+    /** Tries to consume a token without waiting. Returns false if none available. */
+    tryAcquire(): boolean;
+    private refill;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;gBACS,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAOjD,0DAA0D;IACpD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,iFAAiF;IACjF,UAAU,IAAI,OAAO;IASrB,OAAO,CAAC,MAAM;CASf"}

package/dist/utils/rate-limiter.js

@@ -0,0 +1,47 @@
+/**
+ * Token bucket rate limiter for outbound message throttling.
+ */
+export class RateLimiter {
+    tokens;
+    maxTokens;
+    refillRate;
+    lastRefill;
+    /**
+     * @param maxTokens Maximum burst capacity
+     * @param refillRate Tokens added per second
+     */
+    constructor(maxTokens, refillRate) {
+        this.maxTokens = maxTokens;
+        this.tokens = maxTokens;
+        this.refillRate = refillRate;
+        this.lastRefill = Date.now();
+    }
+    /** Waits until a token is available, then consumes it. */
+    async acquire() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return;
+        }
+        const waitMs = ((1 - this.tokens) / this.refillRate) * 1000;
+        await new Promise((resolve) => setTimeout(resolve, Math.ceil(waitMs)));
+        this.refill();
+        this.tokens -= 1;
+    }
+    /** Tries to consume a token without waiting. Returns false if none available. */
+    tryAcquire() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return true;
+        }
+        return false;
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = (now - this.lastRefill) / 1000;
+        this.tokens = Math.min(this.maxTokens, this.tokens + elapsed * this.refillRate);
+        this.lastRefill = now;
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAS;IACN,SAAS,CAAS;IAClB,UAAU,CAAS;IAC5B,UAAU,CAAS;IAE3B;;;OAGG;IACH,YAAY,SAAiB,EAAE,UAAkB;QAC/C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;QAC5D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,iFAAiF;IACjF,UAAU;QACR,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CACpB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,UAAU,CACxC,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IACxB,CAAC;CACF"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,26 @@
+export interface RetryOptions {
+    /** Maximum number of attempts (default: 3) */
+    maxAttempts?: number;
+    /** Base delay in ms (default: 1000) */
+    baseDelay?: number;
+    /** Maximum delay in ms (default: 30000) */
+    maxDelay?: number;
+    /** Whether to add jitter (default: true) */
+    jitter?: boolean;
+    /** Optional predicate to determine if the error is retryable */
+    isRetryable?: (error: unknown) => boolean;
+}
+/**
+ * Executes a function with retry logic using exponential backoff.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Parse an HTTP `Retry-After` header value into seconds.
+ *
+ * RFC 7231 allows both a delta-seconds integer ("120") and an HTTP-date
+ * ("Fri, 31 Dec 2026 23:59:59 GMT"). The growth-agent JS collectors only
+ * handled the former; here we handle both and fall back to the caller's
+ * default on anything unparseable or negative.
+ */
+export declare function parseRetryAfter(header: string | null | undefined, fallbackSeconds?: number): number;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3C;AAUD;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAoBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,eAAe,SAAK,GACnB,MAAM,CAcR"}

package/dist/utils/retry.js

@@ -0,0 +1,61 @@
+const DEFAULT_OPTIONS = {
+    maxAttempts: 3,
+    baseDelay: 1000,
+    maxDelay: 30_000,
+    jitter: true,
+    isRetryable: () => true,
+};
+/**
+ * Executes a function with retry logic using exponential backoff.
+ */
+export async function withRetry(fn, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    let lastError;
+    for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= opts.maxAttempts || !opts.isRetryable(error)) {
+                throw error;
+            }
+            const delay = calculateDelay(attempt, opts.baseDelay, opts.maxDelay, opts.jitter);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+function calculateDelay(attempt, baseDelay, maxDelay, jitter) {
+    let delay = baseDelay * Math.pow(2, attempt - 1);
+    delay = Math.min(delay, maxDelay);
+    if (jitter) {
+        delay = Math.random() * delay;
+    }
+    return delay;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Parse an HTTP `Retry-After` header value into seconds.
+ *
+ * RFC 7231 allows both a delta-seconds integer ("120") and an HTTP-date
+ * ("Fri, 31 Dec 2026 23:59:59 GMT"). The growth-agent JS collectors only
+ * handled the former; here we handle both and fall back to the caller's
+ * default on anything unparseable or negative.
+ */
+export function parseRetryAfter(header, fallbackSeconds = 60) {
+    if (!header)
+        return fallbackSeconds;
+    const asSeconds = Number(header);
+    if (Number.isFinite(asSeconds)) {
+        return asSeconds >= 0 ? asSeconds : fallbackSeconds;
+    }
+    const asDateMs = Date.parse(header);
+    if (Number.isFinite(asDateMs)) {
+        return Math.max(0, Math.ceil((asDateMs - Date.now()) / 1000));
+    }
+    return fallbackSeconds;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAaA,MAAM,eAAe,GAA2B;IAC9C,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,OAAsB;IAEtB,MAAM,IAAI,GAA2B,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IACxE,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAElB,IAAI,OAAO,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,KAAK,GAAG,cAAc,CAC1B,OAAO,EACP,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,MAAM,CACZ,CAAC;YACF,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CACrB,OAAe,EACf,SAAiB,EACjB,QAAgB,EAChB,MAAe;IAEf,IAAI,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IACjD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAClC,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiC,EACjC,eAAe,GAAG,EAAE;IAEpB,IAAI,CAAC,MAAM;QAAE,OAAO,eAAe,CAAC;IAEpC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC;IACtD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/launchd/com.adaria-ai.daemon.plist.template

@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  launchd template for adaria-ai (reactive Slack daemon).
+
+  Placeholders are substituted by `src/cli/start.ts` at install time:
+    __NODE_BIN__     — absolute path to the Node binary running adaria-ai
+    __SCRIPT_PATH__  — absolute path to adaria-ai's dist/index.js entry
+    __ADARIA_HOME__  — $ADARIA_HOME (defaults to ~/.adaria)
+    __LOG_DIR__      — $ADARIA_HOME/logs
+    __PATH__         — value to use as $PATH (launchd's default is near-empty)
+
+  Do NOT edit the installed plist directly — re-run `adaria-ai start`.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.adaria-ai.daemon</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>__NODE_BIN__</string>
+        <string>__SCRIPT_PATH__</string>
+        <string>daemon</string>
+    </array>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>__PATH__</string>
+        <key>ADARIA_HOME</key>
+        <string>__ADARIA_HOME__</string>
+    </dict>
+
+    <key>RunAtLoad</key>
+    <true/>
+
+    <!--
+      Respawn only on actual crashes, not on clean exit. When
+      `src/cli/daemon.ts` can't load config, it logs the reason and
+      exits(0) — `SuccessfulExit=false` keeps launchd from restarting
+      the daemon in that case, avoiding a 30-second respawn loop that
+      would spam ~/.adaria/logs/daemon.err.log (M1 CLI review HIGH #1).
+    -->
+    <key>KeepAlive</key>
+    <dict>
+        <key>SuccessfulExit</key>
+        <false/>
+        <key>Crashed</key>
+        <true/>
+    </dict>
+
+    <key>StandardOutPath</key>
+    <string>__LOG_DIR__/daemon.out.log</string>
+
+    <key>StandardErrorPath</key>
+    <string>__LOG_DIR__/daemon.err.log</string>
+
+    <key>ThrottleInterval</key>
+    <integer>30</integer>
+</dict>
+</plist>

package/launchd/com.adaria-ai.monitor.plist.template

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>Label</key>
+	<string>com.adaria-ai.monitor</string>
+
+	<key>ProgramArguments</key>
+	<array>
+		<string>__NODE_BIN__</string>
+		<string>__SCRIPT_PATH__</string>
+		<string>monitor</string>
+	</array>
+
+	<key>EnvironmentVariables</key>
+	<dict>
+		<key>ADARIA_HOME</key>
+		<string>__ADARIA_HOME__</string>
+		<key>PATH</key>
+		<string>__PATH__</string>
+	</dict>
+
+	<!-- Daily 23:00 UTC -->
+	<key>StartCalendarInterval</key>
+	<dict>
+		<key>Hour</key>
+		<integer>23</integer>
+		<key>Minute</key>
+		<integer>0</integer>
+	</dict>
+
+	<key>StandardOutPath</key>
+	<string>__LOG_DIR__/monitor.out.log</string>
+	<key>StandardErrorPath</key>
+	<string>__LOG_DIR__/monitor.err.log</string>
+
+	<!-- One-shot: do NOT restart on exit. -->
+	<key>KeepAlive</key>
+	<false/>
+</dict>
+</plist>

package/launchd/com.adaria-ai.weekly.plist.template

@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>Label</key>
+	<string>com.adaria-ai.weekly</string>
+
+	<key>ProgramArguments</key>
+	<array>
+		<string>__NODE_BIN__</string>
+		<string>__SCRIPT_PATH__</string>
+		<string>analyze</string>
+	</array>
+
+	<key>EnvironmentVariables</key>
+	<dict>
+		<key>ADARIA_HOME</key>
+		<string>__ADARIA_HOME__</string>
+		<key>PATH</key>
+		<string>__PATH__</string>
+	</dict>
+
+	<!-- Sunday 23:00 UTC -->
+	<key>StartCalendarInterval</key>
+	<dict>
+		<key>Weekday</key>
+		<integer>0</integer>
+		<key>Hour</key>
+		<integer>23</integer>
+		<key>Minute</key>
+		<integer>0</integer>
+	</dict>
+
+	<key>StandardOutPath</key>
+	<string>__LOG_DIR__/weekly.out.log</string>
+	<key>StandardErrorPath</key>
+	<string>__LOG_DIR__/weekly.err.log</string>
+
+	<!-- One-shot: do NOT restart on exit. -->
+	<key>KeepAlive</key>
+	<false/>
+</dict>
+</plist>

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "adaria-ai",
+  "version": "0.1.0",
+  "description": "Single-user marketing operations agent for the Adaria.ai app portfolio, running as a macOS launchd daemon with Slack interface",
+  "type": "module",
+  "bin": {
+    "adaria-ai": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "prompts/",
+    "launchd/",
+    "apps.example.yaml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/ tests/ scripts/",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "smoke:collectors": "tsx scripts/smoke-collectors.ts",
+    "smoke:collectors:dev": "ADARIA_HOME=$HOME/.adaria-dev tsx scripts/smoke-collectors.ts",
+    "smoke:social": "ADARIA_DRY_RUN=1 tsx scripts/smoke-social.ts",
+    "smoke:social:dev": "ADARIA_HOME=$HOME/.adaria-dev ADARIA_DRY_RUN=1 tsx scripts/smoke-social.ts",
+    "snapshot:briefing": "ADARIA_DRY_RUN=1 tsx scripts/snapshot-briefing.ts",
+    "snapshot:briefing:dev": "ADARIA_HOME=$HOME/.adaria-dev ADARIA_DRY_RUN=1 tsx scripts/snapshot-briefing.ts",
+    "init:dev": "ADARIA_HOME=$HOME/.adaria-dev tsx src/index.ts init",
+    "check:tarball-secrets": "tsx scripts/check-tarball-secrets.ts",
+    "prepublishOnly": "npm run build && npm run lint && npm test && npm run check:tarball-secrets"
+  },
+  "keywords": [
+    "marketing",
+    "aso",
+    "slack",
+    "claude",
+    "agent",
+    "macos"
+  ],
+  "author": "Woojin Ahn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ahnwoojin/adaria-ai.git"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/inquirer": "^9.0.9",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.6.0",
+    "eslint": "^9.39.4",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.58.1",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@slack/bolt": "^4.7.0",
+    "better-sqlite3": "^12.8.0",
+    "commander": "^14.0.3",
+    "inquirer": "^13.4.1",
+    "jose": "^6.2.2",
+    "js-yaml": "^4.1.1",
+    "zod": "^4.3.6"
+  }
+}