nemoris 0.1.0

package/src/tools/tool-result-contract.js

@@ -0,0 +1,36 @@
+/**
+ * Typed tool result contract — tools that support this return
+ * { brief, raw, index_terms } instead of a plain string.
+ *
+ * brief (≤200 tokens) goes into the prompt.
+ * raw is cached in tool_results table keyed by call hash.
+ * index_terms are for future retrieval indexing.
+ */
+
+import { createHash } from "node:crypto";
+
+const CONTRACT_MARKER = "__toolResultContract";
+
+export function createToolResult(brief, raw, indexTerms = []) {
+  return {
+    [CONTRACT_MARKER]: true,
+    brief,
+    raw,
+    index_terms: indexTerms,
+  };
+}
+
+export function isToolResultContract(result) {
+  return (
+    result != null &&
+    typeof result === "object" &&
+    result[CONTRACT_MARKER] === true &&
+    "brief" in result &&
+    "raw" in result
+  );
+}
+
+export function hashToolCall(toolId, input) {
+  const payload = toolId + "\0" + JSON.stringify(input);
+  return createHash("sha256").update(payload).digest("hex");
+}