@rubytech/create-realagent-code 0.1.446 → 0.1.447

package/payload/platform/plugins/voice-mirror/mcp/dist/tools/voice-tag-content.js

@@ -0,0 +1,127 @@
+/**
+ * voice-tag-content — set `authorshipMode` and `format` on one or many
+ * content nodes.
+ *
+ * The tool routes through neo4j directly with an account-scoped MERGE so
+ * the operator can only mutate their own nodes. We do not go through
+ * `memory-update` because that tool re-embeds and re-validates on every
+ * call — overkill for a single-property authorship stamp.
+ *
+ * `format` is an editorial classification only the operator can set; it is
+ * therefore required. The sole hard-coded exception lives in
+ * `voice-ingest-session-text`, which stamps `format='text'` on auto-ingested
+ * `:Message` rows where the operator is not in the loop (Task 471).
+ */
+import { getSession } from "../lib/neo4j.js";
+import { TAGGABLE_PRIMARY_LABELS, FORMAT_VALUES, } from "../lib/voice-corpus.js";
+export const AUTHORSHIP_MODES = new Set([
+    "human-only",
+    "human-led-agent-assisted",
+    "agent-led-human-reviewed",
+    "agent-only",
+    "unknown",
+]);
+/**
+ * Resolve the corpus author for a tag write (Task 676). An explicit, non-blank
+ * `author` wins; otherwise the tagging operator's `userId`. Throws when neither
+ * is available (no `author` argument and no `ADMIN_USER_ID` in spawn env), so a
+ * tag can never silently land with a null author.
+ *
+ * This is why single-operator accounts get personal attribution for free: with
+ * `author` omitted, the sole operator is the implicit author, so their personal
+ * corpus equals the account-wide corpus and prior behaviour is reproduced.
+ */
+export function resolveVoiceAuthor(author, operatorUserId) {
+    const explicit = (author ?? "").trim();
+    if (explicit)
+        return explicit;
+    if (operatorUserId)
+        return operatorUserId;
+    throw new Error("voice-tag-content: author required — no ADMIN_USER_ID in spawn env and no author given.");
+}
+export async function voiceTagContent(params) {
+    const { nodeIds, mode, accountId, format, voiceAuthor } = params;
+    if (!AUTHORSHIP_MODES.has(mode)) {
+        throw new Error(`voice-tag-content: invalid authorshipMode '${mode}'. Valid values: ${[
+            ...AUTHORSHIP_MODES,
+        ].join(", ")}`);
+    }
+    if (!accountId) {
+        throw new Error("voice-tag-content: accountId is required");
+    }
+    if (format === undefined || format === null) {
+        throw new Error("voice-tag-content: format is required");
+    }
+    if (!FORMAT_VALUES.includes(format)) {
+        throw new Error(`voice-tag-content: invalid format '${format}'. Valid values: ${FORMAT_VALUES.join(", ")}`);
+    }
+    if (!Array.isArray(nodeIds) || nodeIds.length === 0) {
+        return { updated: 0, skipped: 0, skippedReasons: {} };
+    }
+    // voiceAuthor is checked after the empty-nodeIds early return: an empty tag is
+    // a no-op, so there is nothing to attribute. With nodes to tag, the author
+    // must be resolved (index.ts always supplies it via resolveVoiceAuthor).
+    if (!voiceAuthor) {
+        throw new Error("voice-tag-content: voiceAuthor is required (resolve via resolveVoiceAuthor before calling).");
+    }
+    const session = getSession();
+    const now = new Date().toISOString();
+    const skippedReasons = {};
+    let updated = 0;
+    try {
+        // Bulk update in batches of 50 to keep transaction latency bounded.
+        const BATCH = 50;
+        for (let i = 0; i < nodeIds.length; i += BATCH) {
+            const batch = nodeIds.slice(i, i + BATCH);
+            const result = await session.run(
+            // Tag any of the three primary content labels, or a conversation-
+            // document :Section chunk (parent :KnowledgeDocument carries
+            // `conversationIdentity`). The EXISTS sub-pattern guards against
+            // accidentally tagging document-path :Section rows AND parent
+            // `:Conversation` / `:AdminConversation` nodes (which are not
+            // body-bearing content).
+            `UNWIND $ids AS id
+         MATCH (n) WHERE elementId(n) = id AND n.accountId = $accountId
+         WITH n
+         WHERE any(lbl IN labels(n) WHERE lbl IN $primaryLabels)
+            OR ('Section' IN labels(n) AND EXISTS {
+                 MATCH (parent:KnowledgeDocument)-[:HAS_SECTION]->(n)
+                 WHERE parent.conversationIdentity IS NOT NULL
+               })
+         SET n.authorshipMode = $mode,
+             n.authorshipTaggedAt = $now,
+             n.format = $format,
+             n.voiceAuthor = $voiceAuthor
+         RETURN elementId(n) AS id`, {
+                ids: batch,
+                accountId,
+                mode,
+                now,
+                format,
+                voiceAuthor,
+                primaryLabels: [...TAGGABLE_PRIMARY_LABELS],
+            });
+            const matched = new Set(result.records.map((r) => r.get("id")));
+            updated += matched.size;
+            for (const id of batch) {
+                if (matched.has(id))
+                    continue;
+                const reason = "not-found-or-not-content-label";
+                skippedReasons[reason] = (skippedReasons[reason] ?? 0) + 1;
+            }
+        }
+    }
+    finally {
+        await session.close();
+    }
+    // Tagging is always a personal-attribution act: every tagged node carries an
+    // author and feeds both that author's personal walk and the account-wide org
+    // walk. There is no org-only corpus node, so scope is constant `personal`.
+    process.stderr.write(`[voice-tag] mode=${mode} format=${format} scope=personal author=${voiceAuthor} accountId=${accountId} updated=${updated} skipped=${nodeIds.length - updated}\n`);
+    return {
+        updated,
+        skipped: nodeIds.length - updated,
+        skippedReasons,
+    };
+}
+//# sourceMappingURL=voice-tag-content.js.map

package/payload/platform/plugins/voice-mirror/mcp/dist/tools/voice-tag-content.js.map

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