chat-recall 0.5.4 → 0.5.6

package/dist/mcp-diagnostics.d.ts

@@ -0,0 +1,45 @@
+/**
+ * What the MCP tells an agent when something is refused or stale.
+ *
+ * Pure functions, in their own module so they are testable without importing
+ * mcp.ts — which registers handlers and starts a server on import.
+ *
+ * Both exist because of the same class of bug: an answer that looks fine and
+ * isn't. A 402 that read "request rejected" told an agent nothing, and a search
+ * over a history that stopped growing three weeks ago looked exactly like a
+ * search over a current one.
+ */
+/** The tenant's entitlement, as the server reports it. */
+export interface SyncState {
+    /** The server's OWN answer. Never re-derived here from status and dates: that
+     *  is a second copy of the gate's decision, and a second copy drifts. */
+    entitled: boolean;
+    status: string;
+    periodEnd: number | null;
+}
+/**
+ * Turn a failed response into something an agent can act on.
+ *
+ * The status alone is not enough, and 402 proved it: every payment and
+ * entitlement refusal fell through to "request rejected", so an agent whose sync
+ * had stopped learned nothing, retried, and reported a vague failure. The server
+ * already answers precisely — `error`, `detail`, `checkoutHint`, `resendHint`,
+ * and for a feature gate `feature` / `requires` / `upgradeUrl` — and all of it
+ * was being discarded in favour of the number.
+ */
+export declare function buildHttpError(path: string, res: Response): Promise<Error>;
+/**
+ * The line prepended to every successful read while sync is paused.
+ *
+ * A lapsed tenant keeps read access, so searches keep answering — from data that
+ * stopped growing when the subscription ended. The agent cannot see that, so it
+ * will state that work does not exist when it simply was not indexed. The banner
+ * therefore does three things: says sync stopped, says when, and tells the agent
+ * what conclusion NOT to draw.
+ *
+ * Returns null when entitled, and when the state is unknown — an unreachable
+ * billing endpoint must not decorate every answer with a warning it cannot
+ * substantiate.
+ */
+export declare function stalenessBanner(state: SyncState | null): string | null;
+//# sourceMappingURL=mcp-diagnostics.d.ts.map

package/dist/mcp-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-diagnostics.d.ts","sourceRoot":"","sources":["../src/mcp-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB;6EACyE;IACzE,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAgChF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAwBtE"}

package/dist/mcp-diagnostics.js

@@ -0,0 +1,98 @@
+/**
+ * What the MCP tells an agent when something is refused or stale.
+ *
+ * Pure functions, in their own module so they are testable without importing
+ * mcp.ts — which registers handlers and starts a server on import.
+ *
+ * Both exist because of the same class of bug: an answer that looks fine and
+ * isn't. A 402 that read "request rejected" told an agent nothing, and a search
+ * over a history that stopped growing three weeks ago looked exactly like a
+ * search over a current one.
+ */
+/**
+ * Turn a failed response into something an agent can act on.
+ *
+ * The status alone is not enough, and 402 proved it: every payment and
+ * entitlement refusal fell through to "request rejected", so an agent whose sync
+ * had stopped learned nothing, retried, and reported a vague failure. The server
+ * already answers precisely — `error`, `detail`, `checkoutHint`, `resendHint`,
+ * and for a feature gate `feature` / `requires` / `upgradeUrl` — and all of it
+ * was being discarded in favour of the number.
+ */
+export async function buildHttpError(path, res) {
+    const status = res.status;
+    let body = null;
+    try {
+        body = await res.clone().json();
+    }
+    catch { /* not JSON */ }
+    const str = (k) => (typeof body?.[k] === 'string' ? body[k] : '');
+    if (status === 402) {
+        // Three distinct reasons with three distinct fixes. Telling someone to
+        // subscribe when they need to click a link in their inbox is a wrong
+        // message, not a terse one.
+        const parts = [str('error') || 'payment required'];
+        if (str('detail'))
+            parts.push(str('detail'));
+        if (str('feature')) {
+            parts.push(`This is the "${str('feature')}" capability${str('requires') ? `, on the ${str('requires')} plan` : ''}.`);
+        }
+        if (str('upgradeUrl'))
+            parts.push(`Upgrade: ${str('upgradeUrl')}`);
+        if (str('checkoutHint'))
+            parts.push(str('checkoutHint'));
+        if (str('resendHint'))
+            parts.push(str('resendHint'));
+        // "Reads still work" was the OLD lapse contract (blanket read-only). The
+        // free tier replaced it: feature-level 402s refuse READS of paid tools too,
+        // so promising reads on the error a failed read raised gaslights the agent.
+        parts.push('Nothing has been deleted. The free plan keeps sync and recent-history search working.');
+        return new Error(`server ${path}: ${parts.join(' ')}`);
+    }
+    const hint = status === 401 || status === 403 ? 'auth failed — re-run `chat-recall login <server-url>`' :
+        status === 404 ? 'not found — the id may be wrong, or the server is older than this CLI' :
+            status === 429 ? 'rate limited — retry in a moment' :
+                status >= 500 ? 'server error — check the chat-recall server logs' :
+                    str('error') || str('detail') || 'request rejected';
+    return new Error(`server ${path}: HTTP ${status} (${hint})`);
+}
+/**
+ * The line prepended to every successful read while sync is paused.
+ *
+ * A lapsed tenant keeps read access, so searches keep answering — from data that
+ * stopped growing when the subscription ended. The agent cannot see that, so it
+ * will state that work does not exist when it simply was not indexed. The banner
+ * therefore does three things: says sync stopped, says when, and tells the agent
+ * what conclusion NOT to draw.
+ *
+ * Returns null when entitled, and when the state is unknown — an unreachable
+ * billing endpoint must not decorate every answer with a warning it cannot
+ * substantiate.
+ */
+export function stalenessBanner(state) {
+    if (!state || state.entitled)
+        return null;
+    const since = state.periodEnd ? new Date(state.periodEnd).toISOString().slice(0, 10) : null;
+    const days = state.periodEnd
+        ? Math.max(0, Math.floor((Date.now() - state.periodEnd) / 86_400_000))
+        : null;
+    const reason = state.status === 'trialing'
+        ? 'the trial has ended'
+        : state.status === 'past_due'
+            ? 'a payment has not gone through'
+            : 'the subscription has lapsed';
+    // What the agent must get right about a dormant account: READS are complete.
+    // Two earlier versions of this text were wrong in opposite directions —
+    // "sync is paused, search is read-only", then "sync continues under a monthly
+    // quota, search covers the recent window". Since 2026-08-22 exactly one thing
+    // stops, and it is ingest.
+    return [
+        `⚠ SYNCING IS OFF — ${reason}.`,
+        'Search and lists cover the WHOLE synced history; nothing is windowed or locked.',
+        since ? `The plan lapsed ${since}${days !== null ? ` (${days} days ago)` : ''}.` : '',
+        'What is missing is only work done SINCE the lapse, because new sessions stopped uploading.',
+        'Do not tell the user their history is gone or locked. Say new sessions are not syncing, and that '
+            + 'subscribing plus one `chat-recall sync --full` brings everything current. Export always works.',
+    ].filter(Boolean).join(' ');
+}
+//# sourceMappingURL=mcp-diagnostics.js.map

package/dist/mcp-diagnostics.js.map

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

package/dist/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";AACA;;;;GAIG;AA0BH,OAAO,4CAA4C,CAAC"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";AACA;;;;GAIG;AA4BH,OAAO,4CAA4C,CAAC"}