@mneme-ai/core 2.9.4 → 2.10.0

package/dist/nexus_lock/stargate.d.ts

@@ -0,0 +1,42 @@
+/**
+ * v2.10.0 -- STARGATE: Mneme posts current state to a public paste
+ * URL so fetch-capable AIs (ChatGPT browse / Claude with web /
+ * Cursor / Copilot) can pull live updates between turns.
+ *
+ * Provider: dpaste.com (no auth, anonymous, configurable expiry).
+ * Caller can substitute any provider via `postOverride`.
+ *
+ * Privacy: the paste is PUBLIC and unauthenticated. Mneme posts
+ * version + commit SHAs only — no secrets, no source content. Users
+ * who want stricter privacy should DISABLE Stargate (it's optional in
+ * the soul prompt).
+ */
+export interface StargateState {
+    mnemeVersion: string;
+    npmLatest: string | null;
+    recentCommits: Array<{
+        sha: string;
+        subject: string;
+    }>;
+    generatedAt: string;
+    /** Identifier of the parent that posted this state. */
+    originator: string;
+}
+export interface StargatePost {
+    url: string;
+    expiresAt: number;
+    state: StargateState;
+}
+export interface PublishInput {
+    state: StargateState;
+    /** Expiry in seconds. Default 86_400 (1 day). */
+    ttlSeconds?: number;
+    /** Test seam — replace the actual fetch with a mock. */
+    fetchOverride?: typeof fetch;
+}
+/** Post the state to dpaste.com. Returns null on network failure so
+ *  the caller can fall back to PIGEON-POST round-trip. */
+export declare function publishToStargate(input: PublishInput): Promise<StargatePost | null>;
+/** Compute a tight one-liner for the soul prompt. */
+export declare function formatStargatePulseLine(post: StargatePost | null): string;
+//# sourceMappingURL=stargate.d.ts.map

package/dist/nexus_lock/stargate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stargate.d.ts","sourceRoot":"","sources":["../../src/nexus_lock/stargate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,aAAa,CAAC,EAAE,OAAO,KAAK,CAAC;CAC9B;AAED;0DAC0D;AAC1D,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAyBzF;AAED,qDAAqD;AACrD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CAIzE"}

package/dist/nexus_lock/stargate.js

@@ -0,0 +1,53 @@
+/**
+ * v2.10.0 -- STARGATE: Mneme posts current state to a public paste
+ * URL so fetch-capable AIs (ChatGPT browse / Claude with web /
+ * Cursor / Copilot) can pull live updates between turns.
+ *
+ * Provider: dpaste.com (no auth, anonymous, configurable expiry).
+ * Caller can substitute any provider via `postOverride`.
+ *
+ * Privacy: the paste is PUBLIC and unauthenticated. Mneme posts
+ * version + commit SHAs only — no secrets, no source content. Users
+ * who want stricter privacy should DISABLE Stargate (it's optional in
+ * the soul prompt).
+ */
+/** Post the state to dpaste.com. Returns null on network failure so
+ *  the caller can fall back to PIGEON-POST round-trip. */
+export async function publishToStargate(input) {
+    const fetchFn = input.fetchOverride ?? globalThis.fetch;
+    if (typeof fetchFn !== "function")
+        return null;
+    const ttl = input.ttlSeconds ?? 86_400;
+    const body = new URLSearchParams({
+        content: JSON.stringify(input.state, null, 2),
+        expiry_days: String(Math.max(1, Math.min(365, Math.ceil(ttl / 86_400)))),
+        syntax: "json",
+        title: `Mneme STARGATE state — v${input.state.mnemeVersion}`,
+    });
+    try {
+        const r = await fetchFn("https://dpaste.com/api/v2/", {
+            method: "POST",
+            headers: { "content-type": "application/x-www-form-urlencoded", "user-agent": "mneme-stargate/2.10" },
+            body: body.toString(),
+        });
+        if (!r.ok)
+            return null;
+        const url = (await r.text()).trim();
+        if (!/^https?:\/\//.test(url))
+            return null;
+        // dpaste returns the HTML page URL; append `.txt` to get raw content.
+        const rawUrl = /\.txt$/.test(url) ? url : `${url}.txt`;
+        return { url: rawUrl, expiresAt: Date.now() + ttl * 1000, state: input.state };
+    }
+    catch {
+        return null;
+    }
+}
+/** Compute a tight one-liner for the soul prompt. */
+export function formatStargatePulseLine(post) {
+    if (!post)
+        return "STARGATE · OFFLINE (no public paste)";
+    const ageMin = Math.floor((Date.now() - Date.parse(post.state.generatedAt)) / 60_000);
+    return `STARGATE · ${post.url} · age=${ageMin}min · expires=${new Date(post.expiresAt).toISOString()}`;
+}
+//# sourceMappingURL=stargate.js.map

package/dist/nexus_lock/stargate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stargate.js","sourceRoot":"","sources":["../../src/nexus_lock/stargate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAyBH;0DAC0D;AAC1D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAmB;IACzD,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,IAAI,UAAU,CAAC,KAAK,CAAC;IACxD,IAAI,OAAO,OAAO,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;QAC/B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,2BAA2B,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE;KAC7D,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,4BAA4B,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE,YAAY,EAAE,qBAAqB,EAAE;YACrG,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACvB,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,sEAAsE;QACtE,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC;QACvD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACjF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,uBAAuB,CAAC,IAAyB;IAC/D,IAAI,CAAC,IAAI;QAAE,OAAO,sCAAsC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IACtF,OAAO,cAAc,IAAI,CAAC,GAAG,UAAU,MAAM,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AACzG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mneme-ai/core",
-  "version": "2.9.4",
+  "version": "2.10.0",
   "description": "Core indexing, retrieval, and graph engine for Mneme",
   "type": "module",
   "main": "./dist/index.js",