@runcore-sh/runcore 0.1.2

package/dist/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/notifications/index.js

@@ -0,0 +1,12 @@
+/**
+ * Notification channels for the Core alerting system.
+ *
+ * Provides email, SMS, and webhook delivery channels plus a
+ * dispatcher that routes alerts to the appropriate channels.
+ */
+export { NotificationDispatcher } from "./channel.js";
+export { EmailChannel } from "./email.js";
+export { SmsChannel } from "./sms.js";
+export { WebhookChannel } from "./webhook.js";
+export { PhoneChannel } from "./phone.js";
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/notifications/phone.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Phone (voice call) notification channel.
+ *
+ * Places a Twilio voice call for critical alerts using the existing
+ * makeCall() function. Designed for last-resort escalation only.
+ */
+import type { Alert, NotificationChannel } from "../health/alert-types.js";
+export declare class PhoneChannel implements NotificationChannel {
+    readonly name = "phone";
+    enabled: boolean;
+    constructor(opts?: {
+        enabled?: boolean;
+    });
+    send(alert: Alert): Promise<boolean>;
+}
+//# sourceMappingURL=phone.d.ts.map

package/dist/notifications/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../src/notifications/phone.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAO3E,qBAAa,YAAa,YAAW,mBAAmB;IACtD,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,EAAE,OAAO,CAAC;gBAEL,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;IAIlC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;CAmB3C"}

package/dist/notifications/phone.js

@@ -0,0 +1,48 @@
+/**
+ * Phone (voice call) notification channel.
+ *
+ * Places a Twilio voice call for critical alerts using the existing
+ * makeCall() function. Designed for last-resort escalation only.
+ */
+import { getInstanceName } from "../instance.js";
+import { makeCall } from "../twilio/call.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("notifications.phone");
+export class PhoneChannel {
+    name = "phone";
+    enabled;
+    constructor(opts) {
+        this.enabled = opts?.enabled ?? true;
+    }
+    async send(alert) {
+        const message = formatAlertVoice(alert);
+        log.info("placing critical alert voice call", {
+            alertId: alert.id,
+            severity: alert.severity,
+            checkName: alert.checkName,
+        });
+        const result = await makeCall({ message });
+        if (result.ok) {
+            log.info("voice call initiated", { alertId: alert.id, sid: result.sid });
+        }
+        else {
+            log.error("voice call failed", { alertId: alert.id, error: result.message });
+        }
+        return result.ok;
+    }
+}
+function formatAlertVoice(alert) {
+    // Parse dollar amounts from the detail string for richer speech
+    const remainingMatch = alert.message.match(/\$(\d+\.?\d*)\s+remaining/);
+    const remaining = remainingMatch ? remainingMatch[1] : null;
+    const parts = [
+        `${getInstanceName()} critical alert.`,
+        `${alert.checkName.replace(/_/g, " ")} at ${alert.value} percent used.`,
+    ];
+    if (remaining) {
+        parts.push(`Only $${remaining} remaining.`);
+    }
+    parts.push(`Please take action immediately.`);
+    return parts.join(" ");
+}
+//# sourceMappingURL=phone.js.map

package/dist/notifications/phone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.js","sourceRoot":"","sources":["../../src/notifications/phone.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAEhD,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,OAAO,CAAC;IACxB,OAAO,CAAU;IAEjB,YAAY,IAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAY;QACrB,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAExC,GAAG,CAAC,IAAI,CAAC,mCAAmC,EAAE;YAC5C,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAE3C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3E,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,KAAY;IACpC,gEAAgE;IAChE,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5D,MAAM,KAAK,GAAG;QACZ,GAAG,eAAe,EAAE,kBAAkB;QACtC,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,KAAK,CAAC,KAAK,gBAAgB;KACxE,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,SAAS,SAAS,aAAa,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAE9C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/notifications/sms.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SMS notification channel.
+ *
+ * Sends alert notifications via Twilio SMS API.
+ */
+import type { Alert, NotificationChannel } from "../health/alert-types.js";
+export interface SmsChannelConfig {
+    /** Twilio Account SID. */
+    accountSid: string;
+    /** Twilio Auth Token. */
+    authToken: string;
+    /** Twilio phone number (sender). */
+    from: string;
+    /** Recipient phone numbers. */
+    to: string[];
+    /** Whether this channel is enabled. Default: true. */
+    enabled?: boolean;
+}
+export declare class SmsChannel implements NotificationChannel {
+    readonly name = "sms";
+    enabled: boolean;
+    private config;
+    constructor(config: SmsChannelConfig);
+    send(alert: Alert): Promise<boolean>;
+}
+//# sourceMappingURL=sms.d.ts.map

package/dist/notifications/sms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms.d.ts","sourceRoot":"","sources":["../../src/notifications/sms.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAM3E,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,UAAW,YAAW,mBAAmB;IACpD,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAK9B,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;CA8C3C"}

package/dist/notifications/sms.js

@@ -0,0 +1,65 @@
+/**
+ * SMS notification channel.
+ *
+ * Sends alert notifications via Twilio SMS API.
+ */
+import { getInstanceName } from "../instance.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("notifications.sms");
+export class SmsChannel {
+    name = "sms";
+    enabled;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.enabled = config.enabled ?? true;
+    }
+    async send(alert) {
+        const message = formatAlertSms(alert);
+        const url = `https://api.twilio.com/2010-04-01/Accounts/${this.config.accountSid}/Messages.json`;
+        const auth = Buffer.from(`${this.config.accountSid}:${this.config.authToken}`).toString("base64");
+        log.info("sending SMS notification", {
+            alertId: alert.id,
+            severity: alert.severity,
+            recipientCount: this.config.to.length,
+        });
+        const results = await Promise.allSettled(this.config.to.map(async (to) => {
+            log.debug("sending SMS to recipient", { alertId: alert.id, to });
+            const body = new URLSearchParams({
+                From: this.config.from,
+                To: to,
+                Body: message,
+            });
+            const res = await fetch(url, {
+                method: "POST",
+                headers: {
+                    Authorization: `Basic ${auth}`,
+                    "Content-Type": "application/x-www-form-urlencoded",
+                },
+                body: body.toString(),
+            });
+            if (res.ok) {
+                log.info("SMS sent successfully", { alertId: alert.id, to });
+            }
+            else {
+                log.error("Twilio SMS API error", { alertId: alert.id, to, status: res.status });
+            }
+            return res.ok;
+        }));
+        const anySuccess = results.some((r) => r.status === "fulfilled" && r.value === true);
+        if (!anySuccess) {
+            log.warn("all SMS sends failed", { alertId: alert.id, recipientCount: this.config.to.length });
+        }
+        return anySuccess;
+    }
+}
+function formatAlertSms(alert) {
+    const icon = alert.severity === "critical" ? "🚨" : "⚠️";
+    return [
+        `${icon} ${getInstanceName()} ${alert.severity.toUpperCase()}`,
+        `${alert.checkName}: ${alert.message}`,
+        `Value: ${alert.value} (limit: ${alert.threshold})`,
+        `At: ${alert.firedAt}`,
+    ].join("\n");
+}
+//# sourceMappingURL=sms.js.map

package/dist/notifications/sms.js.map

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

package/dist/notifications/webhook.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Webhook notification channel.
+ *
+ * Sends alert notifications as JSON payloads to configurable HTTP endpoints.
+ * Compatible with Slack incoming webhooks, Discord webhooks, or custom endpoints.
+ */
+import type { Alert, NotificationChannel } from "../health/alert-types.js";
+export interface WebhookChannelConfig {
+    /** Webhook endpoint URL. */
+    url: string;
+    /** Optional secret for HMAC signing of payloads. */
+    secret?: string;
+    /** Optional custom headers to include. */
+    headers?: Record<string, string>;
+    /** Request timeout in ms. Default: 10_000. */
+    timeoutMs?: number;
+    /** Whether this channel is enabled. Default: true. */
+    enabled?: boolean;
+}
+export declare class WebhookChannel implements NotificationChannel {
+    readonly name = "webhook";
+    enabled: boolean;
+    private config;
+    constructor(config: WebhookChannelConfig);
+    send(alert: Alert): Promise<boolean>;
+    private sign;
+}
+//# sourceMappingURL=webhook.d.ts.map

package/dist/notifications/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/notifications/webhook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,cAAe,YAAW,mBAAmB;IACxD,QAAQ,CAAC,IAAI,aAAa;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,EAAE,oBAAoB;IAKlC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;YAkD5B,IAAI;CASnB"}

package/dist/notifications/webhook.js

@@ -0,0 +1,65 @@
+/**
+ * Webhook notification channel.
+ *
+ * Sends alert notifications as JSON payloads to configurable HTTP endpoints.
+ * Compatible with Slack incoming webhooks, Discord webhooks, or custom endpoints.
+ */
+export class WebhookChannel {
+    name = "webhook";
+    enabled;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.enabled = config.enabled ?? true;
+    }
+    async send(alert) {
+        const payload = {
+            event: "alert",
+            timestamp: new Date().toISOString(),
+            alert: {
+                id: alert.id,
+                checkName: alert.checkName,
+                metric: alert.metric,
+                severity: alert.severity,
+                state: alert.state,
+                value: alert.value,
+                threshold: alert.threshold,
+                message: alert.message,
+                firedAt: alert.firedAt,
+                acknowledgedAt: alert.acknowledgedAt,
+                resolvedAt: alert.resolvedAt,
+            },
+        };
+        const headers = {
+            "Content-Type": "application/json",
+            ...this.config.headers,
+        };
+        if (this.config.secret) {
+            const signature = await this.sign(JSON.stringify(payload));
+            headers["X-Signature-256"] = signature;
+        }
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.config.timeoutMs ?? 10_000);
+            const res = await fetch(this.config.url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    async sign(payload) {
+        const { createHmac } = await import("node:crypto");
+        return ("sha256=" +
+            createHmac("sha256", this.config.secret)
+                .update(payload)
+                .digest("hex"));
+    }
+}
+//# sourceMappingURL=webhook.js.map

package/dist/notifications/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/notifications/webhook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAU;IACT,MAAM,CAAuB;IAErC,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAY;QACrB,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,OAAO;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE;gBACL,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B;SACF,CAAC;QAEF,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;SACvB,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAC;QACzC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,UAAU,CACxB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAChC,CAAC;YAEF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;gBACvC,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,OAAe;QAChC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACnD,OAAO,CACL,SAAS;YACT,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAO,CAAC;iBACtC,MAAM,CAAC,OAAO,CAAC;iBACf,MAAM,CAAC,KAAK,CAAC,CACjB,CAAC;IACJ,CAAC;CACF"}

package/dist/openloop/foldback.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Open Loop Protocol — branch fold-back.
+ * Compresses a conversation into a Triad + OpenLoopPackets.
+ * Called once per session when a conversation reaches sufficient depth.
+ */
+import type { ContextMessage } from "../types.js";
+import type { OpenLoopPacket, Triad } from "./types.js";
+export interface FoldBackInput {
+    history: ContextMessage[];
+    historySummary?: string;
+    sourceTraceId?: string;
+    sessionId?: string;
+}
+export interface FoldBackResult {
+    triad: Triad;
+    openLoops: OpenLoopPacket[];
+}
+/**
+ * Fold a conversation back into the vertical stream.
+ * Creates a Triad + OpenLoopPackets for each residual tension.
+ * Returns null for trivial conversations (< 3 user messages or < 200 chars).
+ */
+export declare function foldBack(input: FoldBackInput): Promise<FoldBackResult | null>;
+//# sourceMappingURL=foldback.d.ts.map

package/dist/openloop/foldback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foldback.d.ts","sourceRoot":"","sources":["../../src/openloop/foldback.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AA0BxD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA2GnF"}

package/dist/openloop/foldback.js

@@ -0,0 +1,127 @@
+/**
+ * Open Loop Protocol — branch fold-back.
+ * Compresses a conversation into a Triad + OpenLoopPackets.
+ * Called once per session when a conversation reaches sufficient depth.
+ */
+import { completeChat } from "../llm/complete.js";
+import { resolveProvider, resolveUtilityModel } from "../settings.js";
+import { logActivity } from "../activity/log.js";
+import { createLogger } from "../utils/logger.js";
+import { createLoop, createTriad } from "./store.js";
+import { getInstanceName } from "../instance.js";
+const log = createLogger("open-loop-foldback");
+const FOLDBACK_SYSTEM_PROMPT = `You are a semantic compressor for ${getInstanceName()}'s Open Loop Protocol.
+You receive a conversation transcript and must extract:
+
+1. **anchor** — The core subject/entity discussed (who/what). Short noun phrase.
+2. **vectorShift** — How understanding changed during the conversation. Not what was said — what moved. One sentence.
+3. **residualTensions** — Array of unresolved questions/contradictions. Each has:
+   - **dissonance**: The specific question or tension (1 sentence)
+   - **searchHeuristic**: Array of 2-5 keyword/phrase "magnets" for ambient scanning
+
+Only include genuine residual tensions — things that were raised but NOT resolved.
+If the conversation fully resolved everything, return an empty residualTensions array.
+
+Respond with ONLY a JSON object:
+{
+  "anchor": "string",
+  "vectorShift": "string",
+  "residualTensions": [
+    { "dissonance": "string", "searchHeuristic": ["keyword1", "keyword2"] }
+  ]
+}`;
+/**
+ * Fold a conversation back into the vertical stream.
+ * Creates a Triad + OpenLoopPackets for each residual tension.
+ * Returns null for trivial conversations (< 3 user messages or < 200 chars).
+ */
+export async function foldBack(input) {
+    const { history, historySummary, sourceTraceId, sessionId } = input;
+    // Gate: skip trivial conversations
+    const userMessages = history.filter((m) => m.role === "user");
+    if (userMessages.length < 3) {
+        log.info("Skipping fold-back: fewer than 3 user messages");
+        return null;
+    }
+    const transcriptText = history
+        .map((m) => {
+        const content = typeof m.content === "string" ? m.content : m.content.map((b) => b.type === "text" ? b.text : "[image]").join(" ");
+        return `${m.role}: ${content}`;
+    })
+        .join("\n");
+    if (transcriptText.length < 200) {
+        log.info("Skipping fold-back: transcript < 200 chars");
+        return null;
+    }
+    // Build the prompt — include summary if available for context
+    const userContent = historySummary
+        ? `## Conversation summary\n${historySummary}\n\n## Full transcript\n${transcriptText}`
+        : transcriptText;
+    try {
+        const provider = resolveProvider();
+        const model = resolveUtilityModel();
+        const response = await completeChat({
+            messages: [
+                { role: "system", content: FOLDBACK_SYSTEM_PROMPT },
+                { role: "user", content: userContent },
+            ],
+            model,
+            provider,
+            noCache: true,
+        });
+        // Parse JSON from response
+        let jsonStr = response.trim();
+        const fenceMatch = jsonStr.match(/```(?:json)?\s*([\s\S]*?)```/);
+        if (fenceMatch)
+            jsonStr = fenceMatch[1].trim();
+        const objMatch = jsonStr.match(/\{[\s\S]*\}/);
+        if (!objMatch) {
+            log.warn("Failed to extract JSON from fold-back response");
+            return null;
+        }
+        const parsed = JSON.parse(objMatch[0]);
+        if (!parsed.anchor || !parsed.vectorShift) {
+            log.warn("Invalid fold-back response: missing anchor or vectorShift");
+            return null;
+        }
+        // Create open loops for each residual tension (7-day TTL)
+        const openLoops = [];
+        const tensions = parsed.residualTensions ?? [];
+        // Create a placeholder triad ID so loops can reference it
+        // (we'll create the triad after the loops to get their IDs)
+        for (const tension of tensions) {
+            if (!tension.dissonance || !tension.searchHeuristic?.length)
+                continue;
+            const loop = await createLoop({
+                anchor: parsed.anchor,
+                dissonance: tension.dissonance,
+                searchHeuristic: tension.searchHeuristic,
+            });
+            openLoops.push(loop);
+        }
+        // Create the triad
+        const triad = await createTriad({
+            anchor: parsed.anchor,
+            vectorShift: parsed.vectorShift,
+            residualTensions: tensions.map((t) => t.dissonance),
+            openLoopIds: openLoops.map((l) => l.id),
+            sourceTraceId,
+            sessionId,
+        });
+        // Update loop triadIds (append updated state lines)
+        // Note: we skip this to avoid extra JSONL lines — the triad already references the loop IDs
+        // Log activity
+        logActivity({
+            source: "open-loop",
+            summary: `Branch fold-back: "${parsed.anchor}" — ${openLoops.length} open loop(s), shift: "${parsed.vectorShift}"`,
+        });
+        log.info(`Fold-back complete: triad=${triad.id}, loops=${openLoops.length}`);
+        return { triad, openLoops };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.error(`Fold-back failed: ${msg}`);
+        return null;
+    }
+}
+//# sourceMappingURL=foldback.js.map

package/dist/openloop/foldback.js.map

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

package/dist/openloop/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Open Loop Protocol — barrel re-exports.
+ */
+export type { OpenLoopState, OpenLoopPacket, Triad, ResonanceMatch, ScanRunSummary, ResolutionMatch, ResolutionScanSummary, LoopImpactAction, LifecycleAction, LifecycleConfig, LifecycleRunSummary, } from "./types.js";
+export { createLoop, loadLoops, loadLoopsByState, transitionLoop, createTriad, loadTriads, } from "./store.js";
+export { startOpenLoopScanner, stopOpenLoopScanner, getResonances, getLastScanRun, triggerOpenLoopScan, } from "./scanner.js";
+export { triggerResolutionScan, getResolutions, getLastResolutionScanRun, } from "./resolution-scanner.js";
+export { foldBack } from "./foldback.js";
+export type { FoldBackInput, FoldBackResult } from "./foldback.js";
+export { runLoopLifecycle, triggerLoopLifecycle } from "./lifecycle.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/openloop/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openloop/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,aAAa,EACb,cAAc,EACd,KAAK,EACL,cAAc,EACd,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/openloop/index.js

@@ -0,0 +1,9 @@
+/**
+ * Open Loop Protocol — barrel re-exports.
+ */
+export { createLoop, loadLoops, loadLoopsByState, transitionLoop, createTriad, loadTriads, } from "./store.js";
+export { startOpenLoopScanner, stopOpenLoopScanner, getResonances, getLastScanRun, triggerOpenLoopScan, } from "./scanner.js";
+export { triggerResolutionScan, getResolutions, getLastResolutionScanRun, } from "./resolution-scanner.js";
+export { foldBack } from "./foldback.js";
+export { runLoopLifecycle, triggerLoopLifecycle } from "./lifecycle.js";
+//# sourceMappingURL=index.js.map

package/dist/openloop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openloop/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,OAAO,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/openloop/lifecycle.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Open Loop Protocol — lifecycle automation.
+ * Handles reflection-driven closures, staleness archival, and duplicate merging.
+ * Triggered after resolution scans and after session reflections.
+ */
+import type { LifecycleConfig, LifecycleRunSummary, LoopImpactAction } from "./types.js";
+/**
+ * Run the full loop lifecycle: process reflection actions, archive stale loops, merge duplicates.
+ */
+export declare function runLoopLifecycle(reflectionActions?: LoopImpactAction[], config?: Partial<LifecycleConfig>): Promise<LifecycleRunSummary>;
+/**
+ * Convenience wrapper for triggering lifecycle from the scanner.
+ * Runs without reflection actions (automated maintenance only).
+ */
+export declare function triggerLoopLifecycle(): Promise<LifecycleRunSummary>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/openloop/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/openloop/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAEV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAkPpB;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,EACtC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAyH9B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAEzE"}