adaria-ai 0.1.0

package/dist/cli/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,YAAY,yBAAyB,CAAC;AACnD,eAAO,MAAM,YAAY,yBAAyB,CAAC;AACnD,eAAO,MAAM,aAAa,0BAA0B,CAAC;AAErD,qDAAqD;AACrD,eAAO,MAAM,UAAU,oFAAuD,CAAC;AAQ/E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AA+BD,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAEvD;AAwBD,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CA0B9C"}

package/dist/cli/start.js

@@ -0,0 +1,103 @@
+/**
+ * `adaria-ai start` — load the daemon launchd plist.
+ *
+ * M1 only loads the reactive daemon. M6 will extend this to additionally
+ * load `com.adaria-ai.weekly` (cron Sun 23:00) and `com.adaria-ai.monitor`
+ * (cron daily 23:00). Each label is a separate plist; launchctl handles
+ * the three independently.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { configExists } from "../config/store.js";
+import { ADARIA_HOME, BUNDLED_LAUNCHD_DIR, LOGS_DIR, } from "../utils/paths.js";
+const execFileAsync = promisify(execFile);
+export const DAEMON_LABEL = "com.adaria-ai.daemon";
+export const WEEKLY_LABEL = "com.adaria-ai.weekly";
+export const MONITOR_LABEL = "com.adaria-ai.monitor";
+/** All three launchd labels managed by adaria-ai. */
+export const ALL_LABELS = [DAEMON_LABEL, WEEKLY_LABEL, MONITOR_LABEL];
+const LAUNCH_AGENTS_DIR = path.join(process.env["HOME"] ?? "", "Library", "LaunchAgents");
+export function getPlistPath(label) {
+    return path.join(LAUNCH_AGENTS_DIR, `${label}.plist`);
+}
+export function getDaemonPlistPath() {
+    return getPlistPath(DAEMON_LABEL);
+}
+function getDaemonEntryScriptPath() {
+    // src/cli/start.ts at runtime lives at dist/cli/start.js. The CLI entry
+    // is dist/index.js, one directory up.
+    const thisFile = fileURLToPath(import.meta.url);
+    return path.resolve(path.dirname(thisFile), "..", "index.js");
+}
+async function renderPlist(label = DAEMON_LABEL) {
+    const templatePath = path.join(BUNDLED_LAUNCHD_DIR, `${label}.plist.template`);
+    const template = await fs.readFile(templatePath, "utf-8");
+    // launchd inherits a near-empty PATH, so we set an explicit one that
+    // matches a typical interactive shell. claude-cli usually lives in
+    // /opt/homebrew/bin (Apple Silicon) or /usr/local/bin (Intel).
+    const pathValue = "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:" +
+        path.join(process.env["HOME"] ?? "", ".local", "bin");
+    return template
+        .replaceAll("__NODE_BIN__", process.execPath)
+        .replaceAll("__SCRIPT_PATH__", getDaemonEntryScriptPath())
+        .replaceAll("__ADARIA_HOME__", ADARIA_HOME)
+        .replaceAll("__LOG_DIR__", LOGS_DIR)
+        .replaceAll("__PATH__", pathValue);
+}
+export async function isLabelLoaded(label) {
+    try {
+        const { stdout } = await execFileAsync("launchctl", ["list"]);
+        return stdout.split("\n").some((l) => l.trim().split(/\s+/)[2] === label);
+    }
+    catch {
+        return false;
+    }
+}
+export async function isDaemonLoaded() {
+    return isLabelLoaded(DAEMON_LABEL);
+}
+async function loadLabel(label) {
+    if (await isLabelLoaded(label)) {
+        console.log(`  ${label}: already loaded (skipped)`);
+        return true;
+    }
+    const plistContent = await renderPlist(label);
+    const plistPath = getPlistPath(label);
+    await fs.writeFile(plistPath, plistContent, { mode: 0o644 });
+    try {
+        await execFileAsync("launchctl", ["load", plistPath]);
+        console.log(`  ${label}: loaded`);
+        return true;
+    }
+    catch (err) {
+        console.error(`  ${label}: launchctl load failed: ${err instanceof Error ? err.message : String(err)}`);
+        return false;
+    }
+}
+export async function runStart() {
+    if (!(await configExists())) {
+        console.error('No configuration found. Run "adaria-ai init" first to create ~/.adaria/config.yaml.');
+        process.exitCode = 1;
+        return;
+    }
+    await fs.mkdir(LOGS_DIR, { recursive: true, mode: 0o700 });
+    await fs.mkdir(LAUNCH_AGENTS_DIR, { recursive: true });
+    console.log("Loading adaria-ai launchd agents...");
+    let allOk = true;
+    for (const label of ALL_LABELS) {
+        const ok = await loadLabel(label);
+        if (!ok)
+            allOk = false;
+    }
+    if (allOk) {
+        console.log(`\nAll 3 agents loaded. Logs: ${LOGS_DIR}/`);
+    }
+    else {
+        console.error("\nSome agents failed to load. Check errors above.");
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/cli/start.js.map

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

package/dist/cli/status.d.ts

@@ -0,0 +1,9 @@
+export interface JobStatus {
+    label: string;
+    running: boolean;
+    pid: number | null;
+    lastExitStatus: number | null;
+}
+export declare function getJobStatus(label: string): Promise<JobStatus>;
+export declare function runStatus(): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA6BpE;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAe/C"}

package/dist/cli/status.js

@@ -0,0 +1,49 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { ALL_LABELS } from "./start.js";
+const execFileAsync = promisify(execFile);
+export async function getJobStatus(label) {
+    try {
+        const { stdout } = await execFileAsync("launchctl", ["list"]);
+        // `launchctl list` is tab-separated: `<pid>\t<exit>\t<label>`. Use
+        // exact field match on column 3 so `com.adaria-ai.daemon` can't be
+        // substring-matched against a longer future label like
+        // `com.adaria-ai.daemon-replica` (M1 CLI review MED #2).
+        const line = stdout
+            .split("\n")
+            .find((l) => l.trim().split(/\s+/)[2] === label);
+        if (!line) {
+            return { label, running: false, pid: null, lastExitStatus: null };
+        }
+        const parts = line.trim().split(/\s+/);
+        const pidStr = parts[0];
+        const exitStr = parts[1];
+        const pid = pidStr === "-" || pidStr === undefined ? null : parseInt(pidStr, 10);
+        const lastExitStatus = exitStr === "-" || exitStr === undefined ? null : parseInt(exitStr, 10);
+        return {
+            label,
+            running: pid !== null,
+            pid,
+            lastExitStatus,
+        };
+    }
+    catch {
+        return { label, running: false, pid: null, lastExitStatus: null };
+    }
+}
+export async function runStatus() {
+    const labels = ALL_LABELS;
+    for (const label of labels) {
+        const status = await getJobStatus(label);
+        if (status.running) {
+            console.log(`${label}: running (PID ${String(status.pid)})`);
+        }
+        else if (status.lastExitStatus !== null) {
+            console.log(`${label}: stopped (last exit ${String(status.lastExitStatus)})`);
+        }
+        else {
+            console.log(`${label}: not loaded`);
+        }
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAS1C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa;IAC9C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9D,mEAAmE;QACnE,mEAAmE;QACnE,uDAAuD;QACvD,yDAAyD;QACzD,MAAM,IAAI,GAAG,MAAM;aAChB,KAAK,CAAC,IAAI,CAAC;aACX,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QACpE,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,GAAG,GACP,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,cAAc,GAClB,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1E,OAAO;YACL,KAAK;YACL,OAAO,EAAE,GAAG,KAAK,IAAI;YACrB,GAAG;YACH,cAAc;SACf,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IACpE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAG,UAAU,CAAC;IAE1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,kBAAkB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/D,CAAC;aAAM,IAAI,MAAM,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CACT,GAAG,KAAK,wBAAwB,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CACjE,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cli/stop.d.ts

@@ -0,0 +1,2 @@
+export declare function runStop(): Promise<void>;
+//# sourceMappingURL=stop.d.ts.map

package/dist/cli/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/cli/stop.ts"],"names":[],"mappings":"AAiCA,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ7C"}

package/dist/cli/stop.js

@@ -0,0 +1,34 @@
+import fs from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { ALL_LABELS, getPlistPath, isLabelLoaded } from "./start.js";
+const execFileAsync = promisify(execFile);
+async function unloadLabel(label) {
+    if (!(await isLabelLoaded(label))) {
+        console.log(`  ${label}: not loaded (skipped)`);
+        return;
+    }
+    const plistPath = getPlistPath(label);
+    try {
+        await execFileAsync("launchctl", ["unload", plistPath]);
+    }
+    catch (err) {
+        console.error(`  ${label}: launchctl unload failed: ${err instanceof Error ? err.message : String(err)}`);
+        return;
+    }
+    try {
+        await fs.unlink(plistPath);
+    }
+    catch {
+        // Plist already removed, ok.
+    }
+    console.log(`  ${label}: unloaded`);
+}
+export async function runStop() {
+    console.log("Unloading adaria-ai launchd agents...");
+    for (const label of ALL_LABELS) {
+        await unloadLabel(label);
+    }
+    console.log("\nDone.");
+}
+//# sourceMappingURL=stop.js.map

package/dist/cli/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/cli/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,KAAK,UAAU,WAAW,CAAC,KAAa;IACtC,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,wBAAwB,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,KAAK,KAAK,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC3F,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IAErD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACzB,CAAC"}

package/dist/collectors/appstore.d.ts

@@ -0,0 +1,51 @@
+import type { AppStoreLocalization, AppStoreLocalizationUpdate, StoreReview } from "../types/collectors.js";
+/**
+ * App Store Connect API collector.
+ *
+ * @see https://developer.apple.com/documentation/appstoreconnectapi
+ */
+export interface AppStoreCollectorOptions {
+    keyId: string;
+    issuerId: string;
+    /** PEM-encoded private key (PKCS#8) for ES256 JWT signing. */
+    privateKey: string;
+}
+/**
+ * Test-only overrides. Deliberately kept off {@link AppStoreCollectorOptions}
+ * so that production config loaders (M3) cannot introduce a user-controlled
+ * base URL into the SSRF surface. Only passed from unit tests.
+ */
+export interface AppStoreCollectorTestHooks {
+    baseUrl?: string;
+}
+interface AppStoreInfoResponse {
+    data: {
+        id: string;
+    }[];
+}
+export declare class AppStoreCollector {
+    private readonly keyId;
+    private readonly issuerId;
+    private readonly privateKey;
+    private readonly baseUrl;
+    private cachedToken;
+    private tokenExpiresAt;
+    constructor(options: AppStoreCollectorOptions, testHooks?: AppStoreCollectorTestHooks);
+    private generateToken;
+    private request;
+    getAppInfo(appStoreId: string): Promise<AppStoreInfoResponse>;
+    getAppLocalizations(appStoreId: string, locale?: string): Promise<AppStoreLocalization | null>;
+    /**
+     * Update app localization metadata (title, subtitle, keywords, description).
+     * Requires App Store Connect API write permission and should only be
+     * called from an approval-gated write path.
+     */
+    updateLocalization(localizationId: string, update: AppStoreLocalizationUpdate): Promise<unknown>;
+    /**
+     * Reply to a customer review. Approval-gated write path.
+     */
+    replyToReview(reviewId: string, responseBody: string): Promise<unknown>;
+    getReviews(appStoreId: string, limit?: number): Promise<StoreReview[]>;
+}
+export {};
+//# sourceMappingURL=appstore.d.ts.map

package/dist/collectors/appstore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appstore.d.ts","sourceRoot":"","sources":["../../src/collectors/appstore.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAEhC;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4BD,UAAU,oBAAoB;IAC5B,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxB;AAaD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,cAAc,CAAK;gBAGzB,OAAO,EAAE,wBAAwB,EACjC,SAAS,CAAC,EAAE,0BAA0B;YAa1B,aAAa;YAmBb,OAAO;IAmCf,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI7D,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,MAAM,SAAO,GACZ,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAyBvC;;;;OAIG;IACG,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,OAAO,CAAC;IAgDnB;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBvE,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,KAAK,SAAK,GACT,OAAO,CAAC,WAAW,EAAE,CAAC;CAW1B"}

package/dist/collectors/appstore.js

@@ -0,0 +1,166 @@
+import { SignJWT, importPKCS8 } from "jose";
+import { ExternalApiError, RateLimitError } from "../utils/errors.js";
+import { parseRetryAfter } from "../utils/retry.js";
+const DEFAULT_BASE_URL = "https://api.appstoreconnect.apple.com/v1";
+const TOKEN_LIFETIME_MS = 19 * 60 * 1000;
+const NAME_LIMIT = 30;
+const SUBTITLE_LIMIT = 30;
+const KEYWORDS_LIMIT = 100;
+const REVIEW_RESPONSE_LIMIT = 5970;
+export class AppStoreCollector {
+    keyId;
+    issuerId;
+    privateKey;
+    baseUrl;
+    cachedToken = null;
+    tokenExpiresAt = 0;
+    constructor(options, testHooks) {
+        if (!options.keyId || !options.issuerId || !options.privateKey) {
+            throw new Error("AppStoreCollector requires keyId, issuerId, and privateKey");
+        }
+        this.keyId = options.keyId;
+        this.issuerId = options.issuerId;
+        this.privateKey = options.privateKey;
+        this.baseUrl = testHooks?.baseUrl ?? DEFAULT_BASE_URL;
+    }
+    async generateToken() {
+        if (this.cachedToken && Date.now() < this.tokenExpiresAt) {
+            return this.cachedToken;
+        }
+        const key = await importPKCS8(this.privateKey, "ES256");
+        const token = await new SignJWT({})
+            .setProtectedHeader({ alg: "ES256", kid: this.keyId, typ: "JWT" })
+            .setIssuer(this.issuerId)
+            .setIssuedAt()
+            .setExpirationTime("20m")
+            .setAudience("appstoreconnect-v1")
+            .sign(key);
+        this.cachedToken = token;
+        this.tokenExpiresAt = Date.now() + TOKEN_LIFETIME_MS;
+        return token;
+    }
+    async request(path, init) {
+        const token = await this.generateToken();
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+            ...(init?.headers ?? {}),
+        };
+        const fetchInit = { headers };
+        if (init?.method !== undefined)
+            fetchInit.method = init.method;
+        if (init?.body !== undefined)
+            fetchInit.body = init.body;
+        const response = await fetch(url, fetchInit);
+        if (response.status === 429) {
+            throw new RateLimitError("App Store API rate limited", {
+                retryAfterSeconds: parseRetryAfter(response.headers.get("Retry-After")),
+            });
+        }
+        if (!response.ok) {
+            const body = await response.text();
+            throw new ExternalApiError(`App Store API ${String(response.status)}: ${body}`, { statusCode: response.status });
+        }
+        return (await response.json());
+    }
+    async getAppInfo(appStoreId) {
+        return this.request(`/apps/${appStoreId}/appInfos`);
+    }
+    async getAppLocalizations(appStoreId, locale = "ko") {
+        const infos = await this.getAppInfo(appStoreId);
+        const infoId = infos.data[0]?.id;
+        if (!infoId)
+            return null;
+        const localizations = await this.request(`/appInfos/${infoId}/appInfoLocalizations`);
+        const match = localizations.data.find((l) => l.attributes?.locale === locale);
+        if (!match)
+            return null;
+        const attrs = match.attributes ?? {};
+        return {
+            id: match.id,
+            locale: attrs.locale ?? locale,
+            name: attrs.name ?? "",
+            subtitle: attrs.subtitle ?? "",
+            keywords: attrs.keywords ?? "",
+            description: attrs.description ?? "",
+        };
+    }
+    /**
+     * Update app localization metadata (title, subtitle, keywords, description).
+     * Requires App Store Connect API write permission and should only be
+     * called from an approval-gated write path.
+     */
+    async updateLocalization(localizationId, update) {
+        if (!localizationId) {
+            throw new Error("updateLocalization: localizationId is required");
+        }
+        if (update.name === undefined &&
+            update.subtitle === undefined &&
+            update.keywords === undefined &&
+            update.description === undefined) {
+            throw new Error("updateLocalization: at least one field must be provided");
+        }
+        if (update.name !== undefined && update.name.length > NAME_LIMIT) {
+            throw new Error(`updateLocalization: name exceeds ${String(NAME_LIMIT)} char limit (${String(update.name.length)})`);
+        }
+        if (update.subtitle !== undefined && update.subtitle.length > SUBTITLE_LIMIT) {
+            throw new Error(`updateLocalization: subtitle exceeds ${String(SUBTITLE_LIMIT)} char limit (${String(update.subtitle.length)})`);
+        }
+        if (update.keywords !== undefined && update.keywords.length > KEYWORDS_LIMIT) {
+            throw new Error(`updateLocalization: keywords exceeds ${String(KEYWORDS_LIMIT)} char limit (${String(update.keywords.length)})`);
+        }
+        const attributes = {};
+        if (update.name !== undefined)
+            attributes.name = update.name;
+        if (update.subtitle !== undefined)
+            attributes.subtitle = update.subtitle;
+        if (update.keywords !== undefined)
+            attributes.keywords = update.keywords;
+        if (update.description !== undefined)
+            attributes.description = update.description;
+        return this.request(`/appInfoLocalizations/${localizationId}`, {
+            method: "PATCH",
+            body: JSON.stringify({
+                data: {
+                    type: "appInfoLocalizations",
+                    id: localizationId,
+                    attributes,
+                },
+            }),
+        });
+    }
+    /**
+     * Reply to a customer review. Approval-gated write path.
+     */
+    async replyToReview(reviewId, responseBody) {
+        if (typeof responseBody !== "string" || responseBody.trim().length === 0) {
+            throw new Error("replyToReview: responseBody must be a non-empty string");
+        }
+        if (responseBody.length > REVIEW_RESPONSE_LIMIT) {
+            throw new Error(`replyToReview: responseBody exceeds App Store ${String(REVIEW_RESPONSE_LIMIT)} char limit (${String(responseBody.length)})`);
+        }
+        return this.request(`/customerReviewResponses`, {
+            method: "POST",
+            body: JSON.stringify({
+                data: {
+                    type: "customerReviewResponses",
+                    attributes: { responseBody },
+                    relationships: {
+                        review: { data: { type: "customerReviews", id: reviewId } },
+                    },
+                },
+            }),
+        });
+    }
+    async getReviews(appStoreId, limit = 50) {
+        const data = await this.request(`/apps/${appStoreId}/customerReviews?limit=${String(limit)}&sort=-createdDate`);
+        return (data.data ?? []).map((r) => ({
+            reviewId: r.id,
+            rating: r.attributes.rating,
+            body: r.attributes.body,
+            createdAt: r.attributes.createdDate,
+        }));
+    }
+}
+//# sourceMappingURL=appstore.js.map

package/dist/collectors/appstore.js.map

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

package/dist/collectors/arden-tts.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Arden TTS API client.
+ *
+ * Converts short-form scripts to voiceover MP3 buffers. This is an
+ * **internal** service owned by the same operator that runs adaria-ai,
+ * so unlike the external collectors (App Store / Play Store / ASOMobile)
+ * the endpoint is fully config-driven — there is no public production
+ * hostname to allowlist. Trust derives from config ownership, not from
+ * a baked-in allowlist. `config.yaml` is the source of truth.
+ *
+ * Cost: $0 (Eodin's own TTS service; cross-promotion effect).
+ */
+export interface ArdenTtsClientOptions {
+    /** Base endpoint URL from `config.yaml` (trusted source). */
+    endpoint: string;
+}
+export interface SynthesizeOptions {
+    /** Voice identifier. Defaults to `default`. */
+    voice?: string;
+    /** Playback speed multiplier. Defaults to 1.0. */
+    speed?: number;
+    /** BCP-47 locale tag. Defaults to `ko`. */
+    locale?: string;
+}
+export interface SynthesizeScript {
+    title: string;
+    script: string;
+}
+export interface SynthesizeResult {
+    title: string;
+    audio: Buffer;
+}
+export interface SynthesizeFailure {
+    title: string;
+    error: string;
+    statusCode?: number;
+}
+export interface SynthesizeBatchResult {
+    successes: SynthesizeResult[];
+    failures: SynthesizeFailure[];
+}
+export declare class ArdenTtsClient {
+    private readonly endpoint;
+    constructor(options: ArdenTtsClientOptions);
+    /**
+     * Generate voiceover audio from a script.
+     *
+     * @returns an MP3 audio buffer.
+     */
+    synthesize(text: string, options?: SynthesizeOptions): Promise<Buffer>;
+    /**
+     * Generate voiceovers for multiple scripts sequentially. Per-script
+     * failures are logged with the structured status code (so
+     * `ShortFormSkill` can tell a 429 from a 500) and collected in the
+     * `failures` array; the overall call never rejects, so one bad script
+     * cannot take down a whole short-form batch.
+     */
+    synthesizeBatch(scripts: SynthesizeScript[], options?: SynthesizeOptions): Promise<SynthesizeBatchResult>;
+}
+//# sourceMappingURL=arden-tts.d.ts.map

package/dist/collectors/arden-tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arden-tts.d.ts","sourceRoot":"","sources":["../../src/collectors/arden-tts.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,qBAAqB;IA4B1C;;;;OAIG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC;IAwBlB;;;;;;OAMG;IACG,eAAe,CACnB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC;CAwBlC"}

package/dist/collectors/arden-tts.js

@@ -0,0 +1,83 @@
+import { ExternalApiError } from "../utils/errors.js";
+import { error as logError } from "../utils/logger.js";
+export class ArdenTtsClient {
+    endpoint;
+    constructor(options) {
+        if (!options.endpoint) {
+            throw new Error("ArdenTtsClient requires endpoint");
+        }
+        // Arden TTS is user-hosted so we cannot pin a host allowlist (see
+        // the file header). Enforce at least the scheme + parseability
+        // contract so mis-typed config.yaml values fail loudly at
+        // construction instead of deep inside undici with an opaque
+        // TypeError. javascript:, file:, etc. all get rejected here.
+        let parsed;
+        try {
+            parsed = new URL(options.endpoint.trim());
+        }
+        catch {
+            throw new Error(`ArdenTtsClient endpoint must be a valid URL, got: ${options.endpoint}`);
+        }
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            throw new Error(`ArdenTtsClient endpoint must use http(s), got: ${parsed.protocol}`);
+        }
+        // Trim trailing slashes on the base URL only. A user-provided
+        // subpath (e.g. `/api/v2`) is preserved intact — `synthesize` appends
+        // `/synthesize` to whatever path the caller configured.
+        this.endpoint = parsed.toString().replace(/\/+$/, "");
+    }
+    /**
+     * Generate voiceover audio from a script.
+     *
+     * @returns an MP3 audio buffer.
+     */
+    async synthesize(text, options = {}) {
+        const response = await fetch(`${this.endpoint}/synthesize`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                text,
+                voice: options.voice ?? "default",
+                speed: options.speed ?? 1.0,
+                locale: options.locale ?? "ko",
+            }),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new ExternalApiError(`Arden TTS API ${String(response.status)}: ${body.slice(0, 512)}`, { statusCode: response.status });
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
+    /**
+     * Generate voiceovers for multiple scripts sequentially. Per-script
+     * failures are logged with the structured status code (so
+     * `ShortFormSkill` can tell a 429 from a 500) and collected in the
+     * `failures` array; the overall call never rejects, so one bad script
+     * cannot take down a whole short-form batch.
+     */
+    async synthesizeBatch(scripts, options = {}) {
+        const successes = [];
+        const failures = [];
+        for (const { title, script } of scripts) {
+            try {
+                const audio = await this.synthesize(script, options);
+                successes.push({ title, audio });
+            }
+            catch (err) {
+                const statusCode = err instanceof ExternalApiError ? err.statusCode : undefined;
+                const message = err instanceof Error ? err.message : String(err);
+                const failure = { title, error: message };
+                if (statusCode !== undefined)
+                    failure.statusCode = statusCode;
+                failures.push(failure);
+                logError(`[arden-tts] Failed to synthesize "${title}"`, {
+                    statusCode,
+                    error: message,
+                });
+            }
+        }
+        return { successes, failures };
+    }
+}
+//# sourceMappingURL=arden-tts.js.map

package/dist/collectors/arden-tts.js.map

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