visionclaw 0.1.213-beta.13 → 0.1.213-beta.16

package/dist/agent/applied-credential-signature.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Applied-credential signature manifest.
+ *
+ * Persisted alongside materialised tunnel credentials at
+ * `<profileTunnelDir>/.applied-signature.json`. Records the signature
+ * the server handed us with the last bundle we successfully applied.
+ *
+ * The manifest is the *only* piece of state the agent has to remember
+ * across process restarts about credential bundles — everything else
+ * (creds JSON, config.yml) is reconstructable from a fresh server
+ * delivery. The signature is opaque to us; we just echo it back on the
+ * next heartbeat so the server can decide whether to re-ship the body.
+ *
+ * Self-healing properties (intentional):
+ *   - Manifest missing on disk → no signature sent → server sends
+ *     bundle → we re-apply and rewrite the manifest. Recovers any
+ *     install where the manifest was deleted but credentials weren't,
+ *     or vice versa.
+ *   - Manifest present but probe says no live tunnel files → we treat
+ *     the manifest as unusable (return null from `loadIfValid`), the
+ *     next heartbeat goes signature-free, the server re-ships the
+ *     bundle, and we land back in a coherent state.
+ *   - Process restart with everything intact → manifest signature is
+ *     sent on the startup heartbeat, server replies with no
+ *     `credentialBundle`, no disk writes, no tunnel restart.
+ */
+/**
+ * Read the persisted signature, if any. Returns `null` when the file
+ * does not exist, fails to parse, has the wrong shape, or refers to a
+ * tunnel state that no longer matches what's on disk.
+ *
+ * The on-disk-coherence check (`probeLocalTunnelCredential()`) is what
+ * gives us self-healing: a stranded manifest from a wiped tunnel dir
+ * gets ignored, forcing a fresh bundle on the next heartbeat.
+ */
+export declare function loadAppliedSignatureIfValid(): string | null;
+/**
+ * Persist the signature for the most recently applied bundle. Best-
+ * effort: a write failure is logged but does not throw, since the
+ * worst case is just an extra full-bundle delivery on the next
+ * heartbeat.
+ *
+ * The file is written with 0o600 to match the credentials sitting next
+ * to it; the directory itself is already 0o700 from
+ * `runtime-credentials.ts`.
+ */
+export declare function writeAppliedSignature(signature: string): void;
+/**
+ * Forget the persisted signature. Used by tests; production code never
+ * needs to delete it explicitly because writes overwrite in place.
+ */
+export declare function __clearAppliedSignatureForTests(): void;
+//# sourceMappingURL=applied-credential-signature.d.ts.map

package/dist/agent/applied-credential-signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applied-credential-signature.d.ts","sourceRoot":"","sources":["../../src/agent/applied-credential-signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAwBH;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,GAAG,IAAI,CA2C3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAgC7D;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAMtD"}

package/dist/agent/applied-credential-signature.js

@@ -0,0 +1,137 @@
+/**
+ * Applied-credential signature manifest.
+ *
+ * Persisted alongside materialised tunnel credentials at
+ * `<profileTunnelDir>/.applied-signature.json`. Records the signature
+ * the server handed us with the last bundle we successfully applied.
+ *
+ * The manifest is the *only* piece of state the agent has to remember
+ * across process restarts about credential bundles — everything else
+ * (creds JSON, config.yml) is reconstructable from a fresh server
+ * delivery. The signature is opaque to us; we just echo it back on the
+ * next heartbeat so the server can decide whether to re-ship the body.
+ *
+ * Self-healing properties (intentional):
+ *   - Manifest missing on disk → no signature sent → server sends
+ *     bundle → we re-apply and rewrite the manifest. Recovers any
+ *     install where the manifest was deleted but credentials weren't,
+ *     or vice versa.
+ *   - Manifest present but probe says no live tunnel files → we treat
+ *     the manifest as unusable (return null from `loadIfValid`), the
+ *     next heartbeat goes signature-free, the server re-ships the
+ *     bundle, and we land back in a coherent state.
+ *   - Process restart with everything intact → manifest signature is
+ *     sent on the startup heartbeat, server replies with no
+ *     `credentialBundle`, no disk writes, no tunnel restart.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { getProfileTunnelDir } from "../config/index.js";
+import { probeLocalTunnelCredential } from "./runtime-credentials.js";
+import { logger } from "../logger.js";
+const MANIFEST_FILENAME = ".applied-signature.json";
+const MANIFEST_VERSION = 1;
+function getManifestPath() {
+    return path.join(getProfileTunnelDir(), MANIFEST_FILENAME);
+}
+/**
+ * Read the persisted signature, if any. Returns `null` when the file
+ * does not exist, fails to parse, has the wrong shape, or refers to a
+ * tunnel state that no longer matches what's on disk.
+ *
+ * The on-disk-coherence check (`probeLocalTunnelCredential()`) is what
+ * gives us self-healing: a stranded manifest from a wiped tunnel dir
+ * gets ignored, forcing a fresh bundle on the next heartbeat.
+ */
+export function loadAppliedSignatureIfValid() {
+    const manifestPath = getManifestPath();
+    if (!fs.existsSync(manifestPath))
+        return null;
+    let raw;
+    try {
+        raw = fs.readFileSync(manifestPath, "utf-8");
+    }
+    catch (err) {
+        logger.warn(`Applied-signature manifest unreadable: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        logger.warn(`Applied-signature manifest malformed; ignoring`);
+        return null;
+    }
+    if (!parsed ||
+        typeof parsed !== "object" ||
+        !("signature" in parsed) ||
+        typeof parsed.signature !== "string" ||
+        parsed.signature.trim() === "") {
+        return null;
+    }
+    const signature = parsed.signature.trim();
+    // Coherence: a manifest is only meaningful when the credentials it
+    // refers to actually still exist on disk. If the tunnel files were
+    // wiped (e.g. operator deleted `~/.visionclaw/profiles/default/tunnel`)
+    // the stored signature lies about our state, so pretend we have none
+    // and let the server reissue the bundle.
+    if (probeLocalTunnelCredential() === null) {
+        return null;
+    }
+    return signature;
+}
+/**
+ * Persist the signature for the most recently applied bundle. Best-
+ * effort: a write failure is logged but does not throw, since the
+ * worst case is just an extra full-bundle delivery on the next
+ * heartbeat.
+ *
+ * The file is written with 0o600 to match the credentials sitting next
+ * to it; the directory itself is already 0o700 from
+ * `runtime-credentials.ts`.
+ */
+export function writeAppliedSignature(signature) {
+    if (typeof signature !== "string" || signature.trim() === "")
+        return;
+    const manifestPath = getManifestPath();
+    const dir = path.dirname(manifestPath);
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    catch {
+        // best-effort; the credential apply path will have created it
+    }
+    const payload = {
+        version: MANIFEST_VERSION,
+        signature: signature.trim(),
+        appliedAt: new Date().toISOString(),
+    };
+    try {
+        fs.writeFileSync(manifestPath, JSON.stringify(payload, null, 2), "utf-8");
+        if (process.platform !== "win32") {
+            try {
+                fs.chmodSync(manifestPath, 0o600);
+            }
+            catch {
+                // best-effort; directory perms still protect
+            }
+        }
+    }
+    catch (err) {
+        logger.warn(`Failed to persist applied-signature manifest: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Forget the persisted signature. Used by tests; production code never
+ * needs to delete it explicitly because writes overwrite in place.
+ */
+export function __clearAppliedSignatureForTests() {
+    try {
+        fs.rmSync(getManifestPath(), { force: true });
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=applied-credential-signature.js.map

package/dist/agent/applied-credential-signature.js.map

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

package/dist/agent/capabilities.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Versioned, server-authoritative optional runtime surfaces.
+ *
+ * Core model routing, local execution, localhost health/status, and the TUI
+ * control channel are deliberately not switches: every Agent needs them to be
+ * operable. Everything in this list may be omitted by an explicit setup.
+ */
+export declare const AGENT_CAPABILITIES: readonly ["managed_workspace", "messaging_channels", "interactive_onboarding", "heartbeat", "tunnel", "gemini", "computer_use", "memory", "skills", "dynamic_mcp", "upgrade", "event_trigger", "external_integrations"];
+export type AgentCapability = (typeof AGENT_CAPABILITIES)[number];
+export interface AgentCapabilitySetData {
+    schemaVersion: 1;
+    enabled: AgentCapability[];
+}
+interface CapabilityCredentialBody {
+    tunnel?: unknown;
+    tunnelRotation?: unknown;
+    google?: unknown;
+    zoho?: unknown;
+    serpapi?: unknown;
+    gemini?: unknown;
+    llmGateway?: unknown;
+    eventTrigger?: unknown;
+    finApp?: unknown;
+    financialTool?: unknown;
+}
+interface CapabilityConfigShape {
+    capabilitySet?: AgentCapabilitySetData;
+    workspaceEnabled?: boolean;
+}
+/**
+ * Central capability policy object. Call sites ask a positive question
+ * (`capabilities.has("gemini")`) instead of re-implementing legacy defaults or
+ * decoding the wire object themselves.
+ */
+export declare class CapabilitySet {
+    private readonly enabled;
+    private readonly legacyMode;
+    private constructor();
+    /** Today's behavior. Only the pre-existing Workspace flag can narrow it. */
+    static legacy(options?: {
+        workspaceEnabled?: boolean;
+    }): CapabilitySet;
+    static explicit(data: AgentCapabilitySetData): CapabilitySet;
+    static parse(value: unknown): CapabilitySet;
+    /** Missing capability data is the compatibility contract, never an empty set. */
+    static fromConfig(config: CapabilityConfigShape): CapabilitySet;
+    has(capability: AgentCapability): boolean;
+    /** Client-side defense in depth for a mistakenly over-broad bundle. */
+    filterCredentialBody<T extends CapabilityCredentialBody>(body: T): Partial<T>;
+    /** Unknown admin commands remain compatible only for legacy/full Agents. */
+    allowsPendingCommand(command: string): boolean;
+    toJSON(): AgentCapabilitySetData;
+}
+export declare function hasAgentCapability(config: CapabilityConfigShape, capability: AgentCapability): boolean;
+export {};
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/agent/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/agent/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,yNAcrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,UAAU,wBAAwB;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,qBAAqB;IAC7B,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AASD;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAErC,OAAO;IAKP,4EAA4E;IAC5E,MAAM,CAAC,MAAM,CAAC,OAAO,GAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,aAAa;IAO1E,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,aAAa;IAI5D,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IAkB3C,iFAAiF;IACjF,MAAM,CAAC,UAAU,CACf,MAAM,EAAE,qBAAqB,GAC5B,aAAa;IAMhB,GAAG,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO;IAIzC,uEAAuE;IACvE,oBAAoB,CAAC,CAAC,SAAS,wBAAwB,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqB7E,4EAA4E;IAC5E,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAY9C,MAAM,IAAI,sBAAsB;CAMjC;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,qBAAqB,EAC7B,UAAU,EAAE,eAAe,GAC1B,OAAO,CAET"}

package/dist/agent/capabilities.js

@@ -0,0 +1,121 @@
+/**
+ * Versioned, server-authoritative optional runtime surfaces.
+ *
+ * Core model routing, local execution, localhost health/status, and the TUI
+ * control channel are deliberately not switches: every Agent needs them to be
+ * operable. Everything in this list may be omitted by an explicit setup.
+ */
+export const AGENT_CAPABILITIES = [
+    "managed_workspace",
+    "messaging_channels",
+    "interactive_onboarding",
+    "heartbeat",
+    "tunnel",
+    "gemini",
+    "computer_use",
+    "memory",
+    "skills",
+    "dynamic_mcp",
+    "upgrade",
+    "event_trigger",
+    "external_integrations",
+];
+const KNOWN_CAPABILITIES = new Set(AGENT_CAPABILITIES);
+function canonicalCapabilities(values) {
+    const selected = new Set(values);
+    return AGENT_CAPABILITIES.filter((capability) => selected.has(capability));
+}
+/**
+ * Central capability policy object. Call sites ask a positive question
+ * (`capabilities.has("gemini")`) instead of re-implementing legacy defaults or
+ * decoding the wire object themselves.
+ */
+export class CapabilitySet {
+    enabled;
+    legacyMode;
+    constructor(enabled, legacyMode = false) {
+        this.enabled = new Set(canonicalCapabilities(enabled));
+        this.legacyMode = legacyMode;
+    }
+    /** Today's behavior. Only the pre-existing Workspace flag can narrow it. */
+    static legacy(options = {}) {
+        const enabled = options.workspaceEnabled === false
+            ? AGENT_CAPABILITIES.filter((capability) => capability !== "managed_workspace")
+            : AGENT_CAPABILITIES;
+        return new CapabilitySet(enabled, true);
+    }
+    static explicit(data) {
+        return CapabilitySet.parse(data);
+    }
+    static parse(value) {
+        if (!value || typeof value !== "object" || Array.isArray(value)) {
+            throw new Error("Agent capability set must be an object");
+        }
+        const data = value;
+        if (data.schemaVersion !== 1 || !Array.isArray(data.enabled)) {
+            throw new Error("Unsupported Agent capability schema");
+        }
+        const enabled = [];
+        for (const rawCapability of data.enabled) {
+            if (typeof rawCapability !== "string" || !KNOWN_CAPABILITIES.has(rawCapability)) {
+                throw new Error(`Unknown Agent capability: ${String(rawCapability)}`);
+            }
+            enabled.push(rawCapability);
+        }
+        return new CapabilitySet(enabled);
+    }
+    /** Missing capability data is the compatibility contract, never an empty set. */
+    static fromConfig(config) {
+        return config.capabilitySet
+            ? CapabilitySet.explicit(config.capabilitySet)
+            : CapabilitySet.legacy({ workspaceEnabled: config.workspaceEnabled });
+    }
+    has(capability) {
+        return this.enabled.has(capability);
+    }
+    /** Client-side defense in depth for a mistakenly over-broad bundle. */
+    filterCredentialBody(body) {
+        return {
+            ...(this.has("tunnel") && body.tunnel !== undefined ? { tunnel: body.tunnel } : {}),
+            ...(this.has("tunnel") && body.tunnelRotation !== undefined
+                ? { tunnelRotation: body.tunnelRotation }
+                : {}),
+            ...(this.has("managed_workspace") && body.google !== undefined ? { google: body.google } : {}),
+            ...(this.has("managed_workspace") && body.zoho !== undefined ? { zoho: body.zoho } : {}),
+            ...(this.has("external_integrations") && body.serpapi !== undefined ? { serpapi: body.serpapi } : {}),
+            ...(this.has("gemini") && body.gemini !== undefined ? { gemini: body.gemini } : {}),
+            ...(body.llmGateway !== undefined ? { llmGateway: body.llmGateway } : {}),
+            ...(this.has("event_trigger") && body.eventTrigger !== undefined
+                ? { eventTrigger: body.eventTrigger }
+                : {}),
+            ...(this.has("messaging_channels") && body.finApp !== undefined ? { finApp: body.finApp } : {}),
+            ...(this.has("external_integrations") && body.financialTool !== undefined
+                ? { financialTool: body.financialTool }
+                : {}),
+        };
+    }
+    /** Unknown admin commands remain compatible only for legacy/full Agents. */
+    allowsPendingCommand(command) {
+        if (command === "upgrade" || command === "upgrade_beta")
+            return this.has("upgrade");
+        if (command === "create_rdp_session") {
+            return this.has("computer_use") && this.has("tunnel");
+        }
+        if (command === "notify")
+            return this.has("messaging_channels");
+        if (["collect_data", "usage", "usage_backfill", "switch_engine"].includes(command)) {
+            return true;
+        }
+        return this.legacyMode;
+    }
+    toJSON() {
+        return {
+            schemaVersion: 1,
+            enabled: canonicalCapabilities([...this.enabled]),
+        };
+    }
+}
+export function hasAgentCapability(config, capability) {
+    return CapabilitySet.fromConfig(config).has(capability);
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/agent/capabilities.js.map

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

package/dist/agent/compaction-failure.d.ts

@@ -0,0 +1,9 @@
+export declare class CompactionFailureError extends Error {
+    readonly errorCode: string;
+    readonly sessionId: string | null;
+    constructor(message: string, options: {
+        errorCode: string;
+        sessionId: string | null;
+    });
+}
+//# sourceMappingURL=compaction-failure.d.ts.map

package/dist/agent/compaction-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-failure.d.ts","sourceRoot":"","sources":["../../src/agent/compaction-failure.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAMtF"}

package/dist/agent/compaction-failure.js

@@ -0,0 +1,11 @@
+export class CompactionFailureError extends Error {
+    errorCode;
+    sessionId;
+    constructor(message, options) {
+        super(message);
+        this.name = "CompactionFailureError";
+        this.errorCode = options.errorCode;
+        this.sessionId = options.sessionId;
+    }
+}
+//# sourceMappingURL=compaction-failure.js.map

package/dist/agent/compaction-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-failure.js","sourceRoot":"","sources":["../../src/agent/compaction-failure.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,SAAS,CAAS;IAClB,SAAS,CAAgB;IAElC,YAAY,OAAe,EAAE,OAAwD;QACnF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;CACF"}

package/dist/agent/compaction-policy.d.ts

@@ -34,6 +34,8 @@ export declare const CONTEXT_REFRESH_RESTART_TIMEOUT_MS = 420000;
 export declare const AUTO_REFRESH_ENABLED: boolean;
 /** Consecutive compaction timeouts required before forcing a refresh. */
 export declare const AUTO_REFRESH_TIMEOUT_STREAK = 2;
+/** Error codes that identify a failed Pi auto-compaction worth recovering. */
+export declare const COMPACTION_FAILURE_ERROR_CODES: Set<string>;
 /** Minimum gap between two automatic refreshes. */
 export declare const AUTO_REFRESH_COOLDOWN_MS = 1800000;
 /**

package/dist/agent/compaction-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-policy.d.ts","sourceRoot":"","sources":["../../src/agent/compaction-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,QAAS,CAAC;AAExD,2EAA2E;AAC3E,eAAO,MAAM,kCAAkC,SAAU,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAW,OAAO,CAAC;AAEpD,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,mDAAmD;AACnD,eAAO,MAAM,wBAAwB,UAAY,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAW,OAAO,CAAC"}
+{"version":3,"file":"compaction-policy.d.ts","sourceRoot":"","sources":["../../src/agent/compaction-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,QAAS,CAAC;AAExD,2EAA2E;AAC3E,eAAO,MAAM,kCAAkC,SAAU,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAW,OAAO,CAAC;AAEpD,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,8EAA8E;AAC9E,eAAO,MAAM,8BAA8B,aAAiC,CAAC;AAE7E,mDAAmD;AACnD,eAAO,MAAM,wBAAwB,UAAY,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAW,OAAO,CAAC"}

package/dist/agent/compaction-policy.js

@@ -34,6 +34,8 @@ export const CONTEXT_REFRESH_RESTART_TIMEOUT_MS = 420_000; // 7 minutes
 export const AUTO_REFRESH_ENABLED = true;
 /** Consecutive compaction timeouts required before forcing a refresh. */
 export const AUTO_REFRESH_TIMEOUT_STREAK = 2;
+/** Error codes that identify a failed Pi auto-compaction worth recovering. */
+export const COMPACTION_FAILURE_ERROR_CODES = new Set(["400", "413", "504"]);
 /** Minimum gap between two automatic refreshes. */
 export const AUTO_REFRESH_COOLDOWN_MS = 1_800_000; // 30 minutes
 /**

package/dist/agent/compaction-policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-policy.js","sourceRoot":"","sources":["../../src/agent/compaction-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,OAAO,CAAC,CAAC,YAAY;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC;AAExD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAAG,OAAO,CAAC,CAAC,YAAY;AAEvE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAe,CAAC;AAEpD,yEAAyE;AACzE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAE7C,mDAAmD;AACnD,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC,CAAC,aAAa;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAe,CAAC"}
+{"version":3,"file":"compaction-policy.js","sourceRoot":"","sources":["../../src/agent/compaction-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,OAAO,CAAC,CAAC,YAAY;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC;AAExD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAAG,OAAO,CAAC,CAAC,YAAY;AAEvE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAe,CAAC;AAEpD,yEAAyE;AACzE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAE7C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAE7E,mDAAmD;AACnD,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC,CAAC,aAAa;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAe,CAAC"}

package/dist/agent/context-refresh.d.ts

@@ -11,6 +11,8 @@ export interface PerformContextRefreshDeps {
 export interface PerformContextRefreshOptions {
     /** Short reason for logs (e.g. "manual" or "compaction-timeout-streak"). */
     reason: string;
+    /** Bound the summarizer input after a provider payload overflow. */
+    compactInput?: boolean;
     /**
      * System message enqueued for the next wake cycle so the new session knows
      * a refresh happened. Defaults to the manual-refresh wording.

package/dist/agent/context-refresh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-refresh.d.ts","sourceRoot":"","sources":["../../src/agent/context-refresh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,CAAC,EAAE,UAAU,CAAC,wBAAwB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C;uCACmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EACpE,aAAa,EAAE,MAAM,EACrB,mBAAmB,EAAE,MAAM,EAC3B,KAAK,EAAE,MAAM,GACZ,OAAO,CAKT;AAOD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,EAC/B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAgDtC;AAED,MAAM,WAAW,qBAAsB,SAAQ,yBAAyB;IACtE;6EACyE;IACzE,UAAU,EAAE,IAAI,CACd,UAAU,EACV,YAAY,GAAG,MAAM,GAAG,eAAe,GAAG,aAAa,GAAG,wBAAwB,CACnF,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5C,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,gFAAgF;IAChF,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,2BAA2B,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7E;AAED,MAAM,WAAW,wBAAyB,SAAQ,4BAA4B;IAC5E;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAoB/B;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CA8CnC"}
+{"version":3,"file":"context-refresh.d.ts","sourceRoot":"","sources":["../../src/agent/context-refresh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,CAAC,EAAE,UAAU,CAAC,wBAAwB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C;uCACmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EACpE,aAAa,EAAE,MAAM,EACrB,mBAAmB,EAAE,MAAM,EAC3B,KAAK,EAAE,MAAM,GACZ,OAAO,CAKT;AAOD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,EAC/B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAkDtC;AAED,MAAM,WAAW,qBAAsB,SAAQ,yBAAyB;IACtE;6EACyE;IACzE,UAAU,EAAE,IAAI,CACd,UAAU,EACV,YAAY,GAAG,MAAM,GAAG,eAAe,GAAG,aAAa,GAAG,wBAAwB,CACnF,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5C,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,gFAAgF;IAChF,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,2BAA2B,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7E;AAED,MAAM,WAAW,wBAAyB,SAAQ,4BAA4B;IAC5E;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAoB/B;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CAkDnC"}

package/dist/agent/context-refresh.js

@@ -44,7 +44,9 @@ export async function performContextRefresh(deps, options) {
         ? transcriptInfo.sessionFilePath ?? activeSession.getTranscriptPath()
         : null;
     const { summarizeWithFallback } = await import("./transcript-summarizer.js");
-    const finalSummary = await summarizeWithFallback(transcriptPath, config);
+    const finalSummary = options.compactInput
+        ? await summarizeWithFallback(transcriptPath, config, { compactInput: true })
+        : await summarizeWithFallback(transcriptPath, config);
     // Persist critical working state to /memories before the reset so the next
     // session can rehydrate it. Self-gated on the memory feature flag. Wrapped so
     // that neither the dynamic import nor the flush can block the refresh.
@@ -126,7 +128,11 @@ export async function runContextRefresh(deps, options) {
             config,
             messageQueue,
             taskReplyTarget: agentState.currentTaskReplyTarget,
-        }, { reason, systemMessage });
+        }, {
+            reason,
+            systemMessage,
+            ...(options.compactInput ? { compactInput: true } : {}),
+        });
         if (!result.refreshed) {
             return { status: "no_session" };
         }

package/dist/agent/context-refresh.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-refresh.js","sourceRoot":"","sources":["../../src/agent/context-refresh.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AA0B5D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAoE,EACpE,aAAqB,EACrB,mBAA2B,EAC3B,KAAa;IAEb,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/B,IAAI,aAAa,GAAG,GAAG,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,KAAK,GAAG,mBAAmB,GAAG,GAAG,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,sBAAsB,GAC1B,uFAAuF;IACvF,2EAA2E;IAC3E,8EAA8E,CAAC;AAEjF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAA+B,EAC/B,OAAqC;IAErC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAChE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC5C,MAAM,SAAS,GAAG,aAAa,CAAC,YAAY,EAAE,CAAC;IAE/C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,0EAA0E;IAC1E,mEAAmE;IACnE,MAAM,cAAc,GAAG,aAAa,CAAC,iBAAiB,EAAE,CAAC;IACzD,MAAM,cAAc,GAClB,cAAc,CAAC,IAAI,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,KAAK,iBAAiB;QAC3E,CAAC,CAAC,cAAc,CAAC,eAAe,IAAI,aAAa,CAAC,iBAAiB,EAAE;QACrE,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAC7E,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAEzE,2EAA2E;IAC3E,8EAA8E;IAC9E,uEAAuE;IACvE,wBAAwB;IACxB,IAAI,CAAC;QACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACzE,MAAM,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,kDAAkD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACrG,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAEzC,2EAA2E;IAC3E,YAAY,CAAC,OAAO,CAAC;QACnB,EAAE,EAAE,WAAW,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;QAC7C,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,OAAO,CAAC,aAAa,IAAI,sBAAsB;QACrD,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,uBAAuB,CAAC,eAAe,CAAC;KAC5C,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,oCAAoC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACrE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACpD,CAAC;AAsCD,KAAK,UAAU,WAAW,CACxB,UAAoC,EACpC,SAAiB;IAEjB,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;gBACrB,aAAa,CAAC,IAAI,CAAC,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;iBAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAClC,aAAa,CAAC,IAAI,CAAC,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC,EAAE,GAAG,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAA2B,EAC3B,OAAiC;IAEjC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC3D,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACzF,MAAM,qBAAqB,GAAG,+BAA+B,CAC3D,oBAAoB,MAAM,GAAG,EAC7B,kCAAkC,CACnC,CAAC;IAEF,8EAA8E;IAC9E,oDAAoD;IACpD,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,cAAc,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;gBAC9B,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3B,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;YACpC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,YAAY,EAAE,EAAE,CAAC;YAC1C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CACxC;YACE,OAAO;YACP,MAAM;YACN,YAAY;YACZ,eAAe,EAAE,UAAU,CAAC,sBAAsB;SACnD,EACD,EAAE,MAAM,EAAE,aAAa,EAAE,CAC1B,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,KAAK,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAC1D,CAAC;YAAS,CAAC;QACT,qBAAqB,EAAE,CAAC;QACxB,UAAU,CAAC,UAAU,GAAG,KAAK,CAAC;IAChC,CAAC;AACH,CAAC"}
+{"version":3,"file":"context-refresh.js","sourceRoot":"","sources":["../../src/agent/context-refresh.ts"],"names":[],"mappings":"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"}

package/dist/agent/deep-night-dreaming.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Client-side deep-night dreaming decision.
+ *
+ * The agent decides for itself when to dream. Everything the decision needs is
+ * local: its own wall clock (the deep-night window), its own `.dream_log`
+ * state (has it already dreamed today), and its own transcripts (whether there
+ * is anything worth dreaming — that gate lives downstream in
+ * `runMemoryDreaming`). The server contributes nothing: dreaming is a default
+ * agent capability with no feature gate, so there is no delivery ordering, no
+ * ack and no server-side latch to keep in sync.
+ *
+ * This replaces the earlier server-dispatched `do_dreaming` command. Four of
+ * the defects found in review of that design (handler-registration race,
+ * ack-before-drain, the supervisor-free dispatch failure, and the swallowed
+ * dispatch error) were failure shapes of the distribution itself, not of the
+ * scheduling rule — a local `if` cannot have them.
+ */
+import type { VisionClawConfig } from "../config/types.js";
+import type { ThreadSupervisor } from "../threads/supervisor.js";
+/**
+ * Deep-night window, half-open `[start, end)`, in the agent's own local time.
+ * Inherited unchanged from the deleted server-side dispatcher.
+ */
+export declare const DREAM_WINDOW_START_HOUR = 2;
+export declare const DREAM_WINDOW_END_HOUR = 6;
+/** `YYYYMMDD` for a local date — the granularity of the once-a-day latch. */
+export declare function localDayNumber(now: Date): number;
+/** Why a deep-night check declined to run, for logging and tests. */
+export type DeepNightSkipReason = "outside-window" | "already-dreamed-today";
+export type DeepNightDecision = {
+    run: true;
+    localDay: number;
+} | {
+    run: false;
+    reason: DeepNightSkipReason;
+};
+/**
+ * Pure scheduling rule: inside the local deep-night window, at most once per
+ * local natural day.
+ *
+ * `lastDreamedDay` is the `YYYYMMDD` latch read from `.dream_log/state.json`.
+ * Comparing for equality rather than ordering means a backwards clock jump (or
+ * a state file copied from another machine) costs at most one extra sweep,
+ * where `>=` could latch the agent out of dreaming until the stored day passes.
+ */
+export declare function decideDeepNightDreaming(input: {
+    now: Date;
+    lastDreamedDay: number | null;
+}): DeepNightDecision;
+/**
+ * Evaluate the rule and, when it says yes, run the sweep. Called from the idle
+ * heartbeat tick (every 5 minutes while asleep), so it must be cheap in the
+ * overwhelmingly common "not 2am" case — reading the latch file only happens
+ * once the window check has already passed.
+ *
+ * The day latch is written BEFORE the sweep starts. That makes "one sweep per
+ * local day" hold even if the sweep throws or the process dies mid-way: the
+ * cost of a failed night is one skipped night, whereas latching afterwards
+ * would let a reproducible failure retry every five minutes for four hours.
+ * Per-transcript progress is not lost either way — `runMemoryDreaming` keeps
+ * its own mtime watermark and only latches transcripts it actually dreamed.
+ *
+ * Never throws: this is fire-and-forget from the heartbeat tick.
+ */
+export declare function maybeRunDeepNightDreaming(config: VisionClawConfig, getSupervisor: () => ThreadSupervisor | null, options?: {
+    now?: Date;
+}): Promise<DeepNightDecision>;
+//# sourceMappingURL=deep-night-dreaming.d.ts.map

package/dist/agent/deep-night-dreaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-night-dreaming.d.ts","sourceRoot":"","sources":["../../src/agent/deep-night-dreaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAEhD;AAED,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;AAE7E,MAAM,MAAM,iBAAiB,GACzB;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,GAAG,EAAE,IAAI,CAAC;IACV,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GAAG,iBAAiB,CAUpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,MAAM,gBAAgB,GAAG,IAAI,EAC5C,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAA;CAAO,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAqC5B"}