@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/runtime/harness/system/runtime-memory-policy.js

@@ -1,155 +1 @@
-import path from "node:path";
-function asRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
-}
-function asString(value) {
-    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
-}
-function asPositiveInteger(value) {
-    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : undefined;
-}
-function asStringArray(value) {
-    if (!Array.isArray(value)) {
-        return undefined;
-    }
-    const items = value
-        .filter((item) => typeof item === "string")
-        .map((item) => item.trim())
-        .filter((item) => item.length > 0);
-    return items.length > 0 ? Array.from(new Set(items)) : undefined;
-}
-export function normalizeLangMemMemoryKind(kind) {
-    const normalized = kind?.trim().toLowerCase();
-    if (!normalized) {
-        return "semantic";
-    }
-    if (["episode", "episodic", "summary", "experience", "reflection"].includes(normalized)) {
-        return "episodic";
-    }
-    if (["procedural", "workflow", "procedure", "runbook", "playbook"].includes(normalized)) {
-        return "procedural";
-    }
-    return "semantic";
-}
-export function readRuntimeMemoryPolicyConfig(runtimeMemory, workspaceRoot) {
-    if (runtimeMemory?.enabled !== true) {
-        return undefined;
-    }
-    const retrieval = asRecord(runtimeMemory.retrieval);
-    const writePolicy = asRecord(runtimeMemory.writePolicy);
-    const namespaces = asRecord(runtimeMemory.namespaces);
-    const workspaceId = path.basename(workspaceRoot) || "default";
-    const writePolicyMode = writePolicy?.mode === "all" || writePolicy?.mode === "selective" || writePolicy?.mode === "disabled"
-        ? writePolicy.mode
-        : "all";
-    return {
-        enabled: true,
-        retrieval: {
-            defaultTopK: asPositiveInteger(retrieval?.defaultTopK) ?? 5,
-            maxPromptMemories: asPositiveInteger(retrieval?.maxPromptMemories) ?? 8,
-        },
-        writePolicy: {
-            mode: writePolicyMode,
-            allow: asStringArray(writePolicy?.allow) ?? [],
-            deny: asStringArray(writePolicy?.deny) ?? [],
-        },
-        namespaces: {
-            session: asString(namespaces?.sessions) ?? "memories/sessions/{sessionId}",
-            workspace: asString(namespaces?.workspaces) ?? `memories/workspaces/${workspaceId}`,
-            agent: asString(namespaces?.agents) ?? "memories/agents/{agentId}",
-            user: asString(namespaces?.users) ?? "memories/users/{userId}",
-            project: asString(namespaces?.projects) ?? "memories/projects/{projectId}",
-        },
-    };
-}
-export function readRuntimeMemoryMaintenanceConfig(runtimeMemory) {
-    if (runtimeMemory?.enabled !== true) {
-        return undefined;
-    }
-    const consolidation = asRecord(runtimeMemory.consolidation);
-    const decay = asRecord(consolidation?.decay);
-    return {
-        enabled: true,
-        dedupe: consolidation?.dedupe !== false,
-        ...(asBoolean(decay?.enabled) !== false && asPositiveInteger(decay?.maxAgeDays) ? { maxAgeDays: asPositiveInteger(decay?.maxAgeDays) } : {}),
-    };
-}
-function asBoolean(value) {
-    return typeof value === "boolean" ? value : undefined;
-}
-export function resolveMemoryNamespace(template, values) {
-    const rendered = template.replace(/\{([a-zA-Z0-9_]+)\}/g, (_match, key) => values[key] ?? key);
-    return rendered
-        .split("/")
-        .map((part) => part.trim())
-        .filter((part) => part.length > 0);
-}
-export function hasExplicitResourceReference(text) {
-    const normalized = text.trim();
-    if (!normalized) {
-        return false;
-    }
-    return /(https?:\/\/|www\.)/iu.test(normalized);
-}
-export function extractExplicitResourceReferences(text) {
-    const normalized = text.trim();
-    if (!normalized) {
-        return [];
-    }
-    const matches = normalized.match(/https?:\/\/\S+/giu) ?? [];
-    return Array.from(new Set(matches.map((item) => item.trim().replace(/[),.;:!?]+$/u, ""))))
-        .filter((item) => item.length > 0);
-}
-export function shouldRecallDurableMemory(text) {
-    const normalized = text.trim();
-    if (!normalized) {
-        return false;
-    }
-    return !hasExplicitResourceReference(normalized);
-}
-function normalizePolicyLabel(value) {
-    return value.trim().toLowerCase().replace(/[\s-]+/g, "_");
-}
-function normalizeMemoryText(value) {
-    return typeof value === "string" ? value.trim().toLowerCase() : "";
-}
-function hasTranscriptReflectionSource(input) {
-    const sourceType = normalizeMemoryText(input.sourceType);
-    void input.tags;
-    return sourceType === "runtime-transcript" || sourceType === "runtime-reflection";
-}
-export function isNonDurableTranscriptWorkflowMemory(input, sourceCandidate) {
-    if (!hasTranscriptReflectionSource({
-        sourceType: input.sourceType ?? sourceCandidate?.sourceType,
-        tags: [...(input.tags ?? []), ...(sourceCandidate?.tags ?? [])],
-    })) {
-        return false;
-    }
-    const kind = normalizeMemoryText(input.kind);
-    const scope = normalizeMemoryText(input.scope ?? sourceCandidate?.scope);
-    return kind === "procedural" || scope === "user" || scope === "workspace" || scope === "project";
-}
-export function collectMemoryCandidateLabels(candidate) {
-    return Array.from(new Set([
-        ...(candidate.kind ? [normalizePolicyLabel(candidate.kind)] : []),
-        ...(candidate.scope ? [normalizePolicyLabel(candidate.scope)] : []),
-        ...(candidate.sourceType ? [normalizePolicyLabel(candidate.sourceType)] : []),
-        ...((candidate.tags ?? []).map((tag) => normalizePolicyLabel(tag))),
-    ]));
-}
-export function shouldStoreMemoryCandidate(policy, candidate) {
-    if (!policy || policy.writePolicy.mode === "all") {
-        return true;
-    }
-    if (policy.writePolicy.mode === "disabled") {
-        return false;
-    }
-    const labels = new Set(collectMemoryCandidateLabels(candidate));
-    if (policy.writePolicy.deny.some((label) => labels.has(normalizePolicyLabel(label)))) {
-        return false;
-    }
-    if (policy.writePolicy.allow.length === 0) {
-        return true;
-    }
-    return policy.writePolicy.allow.some((label) => labels.has(normalizePolicyLabel(label)));
-}
+import d from"node:path";function i(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}function a(e){return typeof e=="string"&&e.trim().length>0?e.trim():void 0}function c(e){return typeof e=="number"&&Number.isInteger(e)&&e>0?e:void 0}function l(e){if(!Array.isArray(e))return;const r=e.filter(o=>typeof o=="string").map(o=>o.trim()).filter(o=>o.length>0);return r.length>0?Array.from(new Set(r)):void 0}function b(e){const r=e?.trim().toLowerCase();return r?["episode","episodic","summary","experience","reflection"].includes(r)?"episodic":["procedural","workflow","procedure","runbook","playbook"].includes(r)?"procedural":"semantic":"semantic"}function h(e,r){if(e?.enabled!==!0)return;const o=i(e.retrieval),t=i(e.writePolicy),n=i(e.namespaces),m=d.basename(r)||"default",f=t?.mode==="all"||t?.mode==="selective"||t?.mode==="disabled"?t.mode:"all";return{enabled:!0,retrieval:{defaultTopK:c(o?.defaultTopK)??5,maxPromptMemories:c(o?.maxPromptMemories)??8},writePolicy:{mode:f,allow:l(t?.allow)??[],deny:l(t?.deny)??[]},namespaces:{session:a(n?.sessions)??"memories/sessions/{sessionId}",workspace:a(n?.workspaces)??`memories/workspaces/${m}`,agent:a(n?.agents)??"memories/agents/{agentId}",user:a(n?.users)??"memories/users/{userId}",project:a(n?.projects)??"memories/projects/{projectId}"}}}function P(e){if(e?.enabled!==!0)return;const r=i(e.consolidation),o=i(r?.decay);return{enabled:!0,dedupe:r?.dedupe!==!1,...p(o?.enabled)!==!1&&c(o?.maxAgeDays)?{maxAgeDays:c(o?.maxAgeDays)}:{}}}function p(e){return typeof e=="boolean"?e:void 0}function k(e,r){return e.replace(/\{([a-zA-Z0-9_]+)\}/g,(t,n)=>r[n]??n).split("/").map(t=>t.trim()).filter(t=>t.length>0)}function y(e){const r=e.trim();return r?/(https?:\/\/|www\.)/iu.test(r):!1}function A(e){const r=e.trim();if(!r)return[];const o=r.match(/https?:\/\/\S+/giu)??[];return Array.from(new Set(o.map(t=>t.trim().replace(/[),.;:!?]+$/u,"")))).filter(t=>t.length>0)}function T(e){const r=e.trim();return r?!y(r):!1}function s(e){return e.trim().toLowerCase().replace(/[\s-]+/g,"_")}function u(e){return typeof e=="string"?e.trim().toLowerCase():""}function g(e){const r=u(e.sourceType);return e.tags,r==="runtime-transcript"||r==="runtime-reflection"}function M(e,r){if(!g({sourceType:e.sourceType??r?.sourceType,tags:[...e.tags??[],...r?.tags??[]]}))return!1;const o=u(e.kind),t=u(e.scope??r?.scope);return o==="procedural"||t==="user"||t==="workspace"||t==="project"}function w(e){return Array.from(new Set([...e.kind?[s(e.kind)]:[],...e.scope?[s(e.scope)]:[],...e.sourceType?[s(e.sourceType)]:[],...(e.tags??[]).map(r=>s(r))]))}function R(e,r){if(!e||e.writePolicy.mode==="all")return!0;if(e.writePolicy.mode==="disabled")return!1;const o=new Set(w(r));return e.writePolicy.deny.some(t=>o.has(s(t)))?!1:e.writePolicy.allow.length===0?!0:e.writePolicy.allow.some(t=>o.has(s(t)))}export{w as collectMemoryCandidateLabels,A as extractExplicitResourceReferences,y as hasExplicitResourceReference,M as isNonDurableTranscriptWorkflowMemory,b as normalizeLangMemMemoryKind,P as readRuntimeMemoryMaintenanceConfig,h as readRuntimeMemoryPolicyConfig,k as resolveMemoryNamespace,T as shouldRecallDurableMemory,R as shouldStoreMemoryCandidate};