@rubytech/create-siteoffice-code 0.1.256

package/payload/platform/plugins/memory/mcp/dist/tools/memory-ingest-web.js

@@ -0,0 +1,116 @@
+import { randomUUID } from "node:crypto";
+import { writeFile, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { getSession } from "../lib/neo4j.js";
+import { memoryIngestExtract } from "./memory-ingest-extract.js";
+import { withWriteEvent } from "../lib/log-ingest.js";
+const TITLE_MAX = 200;
+function cap(s) {
+    return s.length > TITLE_MAX ? s.slice(0, TITLE_MAX) : s;
+}
+export function extractTitle(content, url, callerTitle) {
+    if (callerTitle) {
+        const trimmed = callerTitle.trim();
+        if (trimmed.length > 0)
+            return { title: cap(trimmed), source: "caller" };
+    }
+    const h1Match = content.match(/^#\s+(.+)$/m);
+    if (h1Match) {
+        const t = h1Match[1].trim();
+        if (t.length > 0)
+            return { title: cap(t), source: "h1" };
+    }
+    const slug = urlSlug(url);
+    if (slug)
+        return { title: cap(slug), source: "url-slug" };
+    return { title: url, source: "url" };
+}
+function urlSlug(url) {
+    let pathname;
+    try {
+        pathname = new URL(url).pathname;
+    }
+    catch {
+        return null;
+    }
+    const segments = pathname.split("/").filter((s) => s.length > 0);
+    if (segments.length === 0)
+        return null;
+    const last = segments[segments.length - 1];
+    const cleaned = last
+        .replace(/\.[a-zA-Z0-9]{1,5}$/, "")
+        .replace(/[-_]+/g, " ")
+        .trim();
+    return cleaned.length > 0 ? cleaned : null;
+}
+async function checkExistingDocument(url, accountId) {
+    const session = getSession();
+    try {
+        const result = await session.run(`MATCH (d:KnowledgeDocument { sourceUrl: $url, accountId: $accountId })
+       RETURN elementId(d) AS nodeId, d.name AS name, d.summary AS summary, d.createdAt AS createdAt
+       LIMIT 1`, { url, accountId });
+        if (result.records.length === 0)
+            return undefined;
+        const r = result.records[0];
+        return {
+            nodeId: r.get("nodeId"),
+            name: r.get("name"),
+            summary: r.get("summary"),
+            ingestedAt: r.get("createdAt"),
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[memory-ingest-web] dedup check failed (skipping): ${msg}`);
+        return undefined;
+    }
+    finally {
+        await session.close();
+    }
+}
+export async function memoryIngestWeb(params) {
+    return withWriteEvent({ tool: "memory-ingest-web", accountId: params.accountId, name: params.url }, () => memoryIngestWebImpl(params), (r) => ({ elementId: r.attachmentId, name: r.title }));
+}
+async function memoryIngestWebImpl(params) {
+    const { accountId, url, content, scope, title: callerTitle } = params;
+    const t0 = Date.now();
+    const log = (stage, detail) => console.error(`[memory-ingest-web] [${url.slice(0, 60)}] ${stage}${detail ? ` — ${detail}` : ""} (${Date.now() - t0}ms)`);
+    log("start", `${content.length} chars, scope=${scope ?? "public"}`);
+    const trimmed = content.trim();
+    if (trimmed.length === 0) {
+        throw new Error("Web content is empty. The page may not have readable text, " +
+            "or WebFetch may have failed to extract content from this URL.");
+    }
+    log("dedup-check");
+    const existingDocument = await checkExistingDocument(url, accountId);
+    if (existingDocument) {
+        log("dedup-found", `existing: ${existingDocument.nodeId.slice(0, 12)}, ingested ${existingDocument.ingestedAt}`);
+    }
+    const { title, source: titleSource } = extractTitle(trimmed, url, callerTitle);
+    log("title", `${title.slice(0, 80)} (title-source=${titleSource})`);
+    const attachmentId = randomUUID();
+    const tempPath = join(tmpdir(), `maxy-web-${attachmentId}.md`);
+    try {
+        log("temp-write", tempPath);
+        await writeFile(tempPath, trimmed, "utf-8");
+        log("extract-start");
+        const extract = await memoryIngestExtract({
+            storagePath: tempPath,
+            filename: title,
+            mimeType: "text/markdown",
+            attachmentId,
+        });
+        log("extract-done", `${extract.textLength} chars cached`);
+        return { attachmentId, title, titleSource, extract, existingDocument };
+    }
+    finally {
+        try {
+            await unlink(tempPath);
+        }
+        catch {
+            // Best-effort cleanup — tmp dir is periodically cleaned by OS
+        }
+    }
+}
+//# sourceMappingURL=memory-ingest-web.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-ingest-web.js.map

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

package/payload/platform/plugins/memory/mcp/dist/tools/memory-ingest.d.ts

@@ -0,0 +1,194 @@
+import type { ClassifiedSection, ClassifierOutput, OrphanCandidate } from "../lib/section-types.js";
+import { type ConversationSource } from "../lib/conversation-normalisers/types.js";
+import type { InlineRewriteCandidate, InlineRewriteDeferred } from "../lib/compiled-truth-revision.js";
+export declare function deriveSectionBodies(sections: ReadonlyArray<Pick<ClassifiedSection, "sourceStart" | "sourceEnd" | "body">>, cachedText: string, sourceKey?: string): string[];
+export declare const RESERVED_SECTION_PROPERTY_KEYS: ReadonlySet<string>;
+/**
+ * Drop reserved writer-owned keys from an agent-supplied `section.properties`
+ * bag. When any keys are stripped, emit one grep-able log line naming the
+ * keys and the context (attachmentId or conversationIdentity:archiveSha256)
+ * so the operator can attribute the smuggle attempt to a specific ingest.
+ *
+ * Mirrors the Task 465 `agent body suppressed` log shape — a quiet strip
+ * with a loud trail. Returns a new object; never mutates the input.
+ */
+export declare function stripReservedSectionProperties(properties: Record<string, unknown>, ctx: {
+    kind: string;
+    identity: string;
+}): Record<string, unknown>;
+export interface IngestParams {
+    accountId: string;
+    /**
+     * Document-path identity. Set when the parent is a file/URL/obsidian page —
+     * the writer takes the document path (anchor edges, related entities,
+     * extract cache, first-ingest semantics).
+     *
+     * Exactly one of `attachmentId` or `conversationIdentity` must be set.
+     */
+    attachmentId?: string;
+    /**
+     * Conversation-path identity. Set when the parent is a chat transcript —
+     * the writer takes the conversation-document path (delta-append after
+     * cursor lookup, :PARTICIPANT_IN edges, archiveSha256 cleanup-on-rebuild,
+     * no anchor / related discovery).
+     *
+     * Exactly one of `attachmentId` or `conversationIdentity` must be set.
+     * The presence of `conversationIdentity` selects the conversation path,
+     * which MERGEs the parent under `:ConversationArchive` (Task 397). The
+     * `attachmentId` path MERGEs under `:KnowledgeDocument`.
+     */
+    conversationIdentity?: string;
+    documentSummary: string;
+    /**
+     * Element ID of the anchor node (UserProfile / LocalBusiness / Person /
+     * Organization). Anchor identity is parameter input — never inferred.
+     * Unused on the conversation-document path (chat participants attach via
+     * :PARTICIPANT_IN, not via anchor edges) — pass any non-empty string.
+     */
+    anchorNodeId: string;
+    /** Anchor's primary label, used in the per-section MATCH for edge creation. */
+    anchorLabel: string;
+    /** Sections returned by memory-classify, in reading order. */
+    sections: ClassifiedSection[];
+    /** Document-level edges (e.g. PARTY edges off KnowledgeDocument). */
+    documentEdges?: ClassifierOutput["documentEdges"];
+    /** Orphan candidates: nodes the classifier could not edge naturally. */
+    orphanCandidates?: OrphanCandidate[];
+    /** Visibility scope for all created nodes. Required. */
+    scope: string;
+    /** Original URL for web-sourced documents. Absent for file uploads. */
+    sourceUrl?: string;
+    /** Provenance discriminator: "upload" (default) or "web". */
+    sourceType?: string;
+    /** LLM-extracted topic keywords (from memory-classify). */
+    documentKeywords?: string[];
+    /** User-supplied keywords (verbatim, normalised, deduplicated with documentKeywords). */
+    userKeywords?: string[];
+    /** Session UUID for provenance stamping. */
+    sessionId?: string;
+    /** SHA-256 of THIS export's transcript bytes. Cleanup discriminator: only
+     *  chunks stamped with this sha256 are dropped on re-ingest, so delta
+     *  re-imports of newer exports leave prior chunks untouched. */
+    archiveSha256?: string;
+    /** Original archive filename (basename, e.g. `_chat.txt`). Stamped on the
+     *  parent + every chunk for operator audit. */
+    archiveSourceFile?: string;
+    /** Content hash of the LAST message ingested in this run (cursor advance).
+     *  Stamped on the :ConversationArchive parent so the next delta-append run
+     *  finds the cursor. */
+    lastIngestedMessageHash?: string;
+    /** ISO 8601 dateSent of the last message ingested. Stamped on the parent
+     *  for the noop-reason message ("no new messages since <lastIngestedMessageAt>"). */
+    lastIngestedMessageAt?: string;
+    /** Operator-confirmed participant elementIds (:Person / :AdminUser) for
+     *  this conversation. Used to MERGE :PARTICIPANT_IN edges off the parent
+     *  on every ingest (idempotent). */
+    participantElementIds?: string[];
+    /** Conversation source enum. Required when `conversationIdentity` is set;
+     *  ignored on the document path. Stamped on the :ConversationArchive parent
+     *  and every :Section chunk so downstream queries can filter by source
+     *  without inferring from archiveSourceFile. The set is closed — see
+     *  `CONVERSATION_SOURCES`. */
+    source?: ConversationSource;
+    /** sub-scope E — per-session checkpointing.
+     *
+     *  When the bin calls `memoryIngest` once per session (instead of once per
+     *  archive), the cleanup-by-archiveSha256 step must run only on the FIRST
+     *  session of a run. Otherwise session N+1's call would delete session N's
+     *  just-written chunks (same conversationIdentity + same archiveSha256).
+     *
+     *  sub-scope B — additionally gated on the bin's `--rebuild`
+     *  flag. Without `--rebuild`, re-issuing the bin on the same export bytes
+     *  is a no-op; the bin sets `cleanupPriorChunks=false` for every session.
+     *  With `--rebuild`, the bin sets `cleanupPriorChunks=true` only on the
+     *  first session. Ignored on the document path. */
+    cleanupPriorChunks?: boolean;
+    /** Task 468 — per-session index used by the conversation-archive path to
+     *  locate the per-session turnText tempfile written by the bin
+     *  (`conversation-archive-ingest.mjs`). The writer constructs the file path
+     *  via `turnTextCachePath({ conversationIdentity, archiveSha256,
+     *  sessionIndex })`, reads it, and slices `:Section.body` server-side from
+     *  the loaded text. Required on the conversation-document path; ignored on
+     *  the document path. Integer >= 1. */
+    sessionIndex?: number;
+    /** sub-scope A — stable title for the conversation-document parent.
+     *  Computed once per ingest by the bin from `(source, ownerName,
+     *  otherParticipantNames, firstMessageAt, lastMessageAt)`. Written ON
+     *  CREATE; on MATCH the existing `title` is preserved (COALESCE) so
+     *  re-ingests never overwrite a stable label. UI display-helpers prefer
+     *  `title` over `summary` for conversation-document rows — the per-session
+     *  counter strings that used to lock `summary` to "Session 1/N: …" are
+     *  gone. Ignored on the document path. */
+    archiveTitle?: string;
+    /**
+     * When true, after writing sections and edges, run the inline
+     * compiled-truth reconciliation gate: count MENTIONS/REFERENCES edges
+     * from the new document (KD and its sections) to existing entities
+     * that have `compiledTruth`. Entities above `inlineRewriteThreshold`
+     * and outside the 7-day cooldown are returned as `inlineRewriteCandidates`
+     * in the result. Disabled by default.
+     */
+    inlineRewrite?: boolean;
+    /**
+     * When `inlineRewrite` is true, bypass the 7-day per-entity cooldown on
+     * `compiledTruthUpdatedAt`. All entities above threshold are returned as
+     * candidates regardless of when their truth was last rewritten.
+     */
+    forceRewrite?: boolean;
+    /**
+     * Minimum count of MENTIONS or REFERENCES edges from the new source
+     * (KnowledgeDocument + its sections) to an existing entity for that
+     * entity to qualify as an inline-rewrite candidate. Default: 2.
+     */
+    inlineRewriteThreshold?: number;
+}
+/** Per-kind count breakdown the writer returns to the skill. */
+export interface KindBreakdown {
+    /** Section kind → count (e.g. {"Position": 4, "Chapter": 12, "Other": 1}). */
+    [kind: string]: number;
+}
+/** Per-edge-type count breakdown for anchor edges. */
+export interface EdgeBreakdown {
+    /** Edge type → count (e.g. {"HAS_POSITION": 4, "ATTENDED": 1, "PARTY": 2}). */
+    [edgeType: string]: number;
+}
+export interface IngestResult {
+    documentNodeId: string;
+    /** Total :Section nodes written. */
+    sectionCount: number;
+    /** Per-section-kind count breakdown — drives the post-write chat narrative. */
+    kindBreakdown: KindBreakdown;
+    /** Per-anchor-edge-type count breakdown — drives the post-write chat narrative. */
+    edgeBreakdown: EdgeBreakdown;
+    /** Related entities created or merged (Organization, Person, DefinedTerm). */
+    relatedCount: number;
+    /** Standalone nodes created (Project). */
+    standaloneCount: number;
+    /** Orphan candidates surfaced from the classifier — NOT written, just relayed. */
+    orphanCandidates: OrphanCandidate[];
+    documentSummary: string;
+    keywords?: string[];
+    /** sub-scope E — count of prior conversation-document :Section chunks
+     *  deleted by the cleanup-by-archiveSha256 step. Always 0 unless the
+     *  caller passed `cleanupPriorChunks=true`. The bin surfaces this as a
+     *  heartbeat WARN line so a destructive `--rebuild` is operator-visible
+     *  (defence-in-depth — `--rebuild` is the only legitimate trigger). */
+    cleanedPriorChunks?: number;
+    /**
+     * Entities above the MENTIONS/REFERENCES threshold that qualify for
+     * inline compiled-truth rewrite. Populated only when `inlineRewrite=true`.
+     * Dispatch the `compiled-truth-rewriter` specialist for each entity
+     * before the calling skill returns — pass `nodeId` and optionally
+     * an `operatorHint` if the document suggests a correction.
+     */
+    inlineRewriteCandidates?: InlineRewriteCandidate[];
+    /**
+     * Entities above threshold that were skipped because their
+     * `compiledTruthUpdatedAt` is within the 7-day cooldown and
+     * `forceRewrite` was not set. These remain candidates for the next
+     * dream-cycle run.
+     */
+    inlineRewriteDeferred?: InlineRewriteDeferred[];
+}
+export declare function memoryIngest(params: IngestParams): Promise<IngestResult>;
+//# sourceMappingURL=memory-ingest.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-ingest.d.ts.map

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