@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/knowledge/procedural/config.js

@@ -1,125 +1 @@
-function asObject(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 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;
-}
-function asBoolean(value) {
-    return typeof value === "boolean" ? value : undefined;
-}
-function asPositiveInteger(value) {
-    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : undefined;
-}
-function asNumber(value) {
-    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
-}
-function readProceduralMemoryRuntimeSpec(source) {
-    const typed = asObject(source);
-    if (!typed) {
-        return undefined;
-    }
-    const kind = typeof typed.kind === "string" ? typed.kind : undefined;
-    const hasTypedEnvelope = typeof typed.apiVersion === "string" || !!asObject(typed.metadata);
-    if (kind === "ProceduralMemoryRuntime") {
-        return asObject(typed.spec);
-    }
-    if (hasTypedEnvelope && asObject(typed.spec)) {
-        return asObject(typed.spec);
-    }
-    return typed;
-}
-export function readProceduralMemoryRuntimeConfig(proceduralMemory) {
-    const spec = readProceduralMemoryRuntimeSpec(proceduralMemory);
-    const enabled = spec?.enabled === true;
-    const provider = asObject(spec?.provider);
-    const mode = asObject(spec?.mode);
-    const trigger = asObject(spec?.trigger);
-    const extraction = asObject(spec?.extraction);
-    const retrieval = asObject(spec?.retrieval);
-    const maintenance = asObject(spec?.maintenance);
-    const onWrite = asObject(maintenance?.onWrite);
-    const schedule = asObject(maintenance?.schedule);
-    const idle = asObject(maintenance?.idle);
-    const limits = asObject(maintenance?.limits);
-    const decay = asObject(maintenance?.decay);
-    const pruning = asObject(maintenance?.pruning);
-    return {
-        enabled,
-        provider: provider
-            ? {
-                kind: asString(provider.kind) ?? "reme",
-                options: Object.keys(provider).filter((key) => key !== "kind").length > 0
-                    ? Object.fromEntries(Object.entries(provider).filter(([key]) => key !== "kind"))
-                    : null,
-            }
-            : null,
-        store: asObject(spec?.store) ?? null,
-        vectorStore: asObject(spec?.vectorStore) ?? null,
-        embeddingModel: asObject(spec?.embeddingModel) ?? null,
-        formation: enabled
-            ? {
-                backgroundOnly: mode?.backgroundOnly !== false,
-                background: {
-                    enabled: true,
-                    scopeHints: asStringArray(extraction?.focus) ?? ["coding_patterns", "workflow_patterns", "debugging_lessons"],
-                    maxMessagesPerRequest: asPositiveInteger(extraction?.maxMessagesPerRequest) ?? 60,
-                    writeOnApprovalResolution: trigger?.onApprovalResolved === true,
-                    writeOnRequestCompletion: trigger?.onRequestCompleted !== false,
-                    stateStorePath: asString(asObject(spec?.state)?.cursorPath) ?? "knowledge/procedural-memory-state.json",
-                },
-            }
-            : null,
-        retrieval: enabled
-            ? {
-                enabled: retrieval?.enabled !== false,
-                defaultTopK: asPositiveInteger(retrieval?.defaultTopK) ?? 5,
-                maxPromptItems: asPositiveInteger(retrieval?.maxPromptItems) ?? 4,
-            }
-            : null,
-        maintenance: enabled
-            ? {
-                enabled: maintenance?.enabled !== false,
-                onWrite: {
-                    dedupeNearby: onWrite?.dedupeNearby !== false,
-                    updateFrequency: onWrite?.updateFrequency !== false,
-                },
-                schedule: schedule
-                    ? {
-                        enabled: schedule.enabled !== false,
-                        everyMinutes: asPositiveInteger(schedule.everyMinutes) ?? 60,
-                    }
-                    : null,
-                idle: idle
-                    ? {
-                        enabled: idle.enabled !== false,
-                        minIdleMinutes: asPositiveInteger(idle.minIdleMinutes) ?? 20,
-                        maxRunsPerIdleWindow: asPositiveInteger(idle.maxRunsPerIdleWindow) ?? 1,
-                    }
-                    : null,
-                tasks: asStringArray(maintenance?.tasks) ?? ["dedupe", "merge_similar", "decay_stale", "prune_low_value"],
-                limits: {
-                    maxRecordsPerRun: asPositiveInteger(limits?.maxRecordsPerRun) ?? 200,
-                    maxClustersPerRun: asPositiveInteger(limits?.maxClustersPerRun) ?? 50,
-                },
-                decay: {
-                    enabled: decay?.enabled !== false,
-                    ...(asPositiveInteger(decay?.maxAgeDays) ? { maxAgeDays: asPositiveInteger(decay?.maxAgeDays) } : {}),
-                },
-                pruning: {
-                    ...(asNumber(pruning?.minScore) !== undefined ? { minScore: asNumber(pruning?.minScore) } : {}),
-                    ...(asPositiveInteger(pruning?.minFrequency) ? { minFrequency: asPositiveInteger(pruning?.minFrequency) } : {}),
-                },
-            }
-            : null,
-    };
-}
+function r(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}function b(e){return typeof e=="string"&&e.trim().length>0?e.trim():void 0}function R(e){if(!Array.isArray(e))return;const n=e.filter(t=>typeof t=="string").map(t=>t.trim()).filter(t=>t.length>0);return n.length>0?Array.from(new Set(n)):void 0}function A(e){return typeof e=="boolean"?e:void 0}function i(e){return typeof e=="number"&&Number.isInteger(e)&&e>0?e:void 0}function x(e){return typeof e=="number"&&Number.isFinite(e)?e:void 0}function k(e){const n=r(e);if(!n)return;const t=typeof n.kind=="string"?n.kind:void 0,s=typeof n.apiVersion=="string"||!!r(n.metadata);return t==="ProceduralMemoryRuntime"||s&&r(n.spec)?r(n.spec):n}function M(e){const n=k(e),t=n?.enabled===!0,s=r(n?.provider),P=r(n?.mode),f=r(n?.trigger),p=r(n?.extraction),u=r(n?.retrieval),o=r(n?.maintenance),y=r(o?.onWrite),l=r(o?.schedule),d=r(o?.idle),g=r(o?.limits),c=r(o?.decay),a=r(o?.pruning);return{enabled:t,provider:s?{kind:b(s.kind)??"reme",options:Object.keys(s).filter(m=>m!=="kind").length>0?Object.fromEntries(Object.entries(s).filter(([m])=>m!=="kind")):null}:null,store:r(n?.store)??null,vectorStore:r(n?.vectorStore)??null,embeddingModel:r(n?.embeddingModel)??null,formation:t?{backgroundOnly:P?.backgroundOnly!==!1,background:{enabled:!0,scopeHints:R(p?.focus)??["coding_patterns","workflow_patterns","debugging_lessons"],maxMessagesPerRequest:i(p?.maxMessagesPerRequest)??60,writeOnApprovalResolution:f?.onApprovalResolved===!0,writeOnRequestCompletion:f?.onRequestCompleted!==!1,stateStorePath:b(r(n?.state)?.cursorPath)??"knowledge/procedural-memory-state.json"}}:null,retrieval:t?{enabled:u?.enabled!==!1,defaultTopK:i(u?.defaultTopK)??5,maxPromptItems:i(u?.maxPromptItems)??4}:null,maintenance:t?{enabled:o?.enabled!==!1,onWrite:{dedupeNearby:y?.dedupeNearby!==!1,updateFrequency:y?.updateFrequency!==!1},schedule:l?{enabled:l.enabled!==!1,everyMinutes:i(l.everyMinutes)??60}:null,idle:d?{enabled:d.enabled!==!1,minIdleMinutes:i(d.minIdleMinutes)??20,maxRunsPerIdleWindow:i(d.maxRunsPerIdleWindow)??1}:null,tasks:R(o?.tasks)??["dedupe","merge_similar","decay_stale","prune_low_value"],limits:{maxRecordsPerRun:i(g?.maxRecordsPerRun)??200,maxClustersPerRun:i(g?.maxClustersPerRun)??50},decay:{enabled:c?.enabled!==!1,...i(c?.maxAgeDays)?{maxAgeDays:i(c?.maxAgeDays)}:{}},pruning:{...x(a?.minScore)!==void 0?{minScore:x(a?.minScore)}:{},...i(a?.minFrequency)?{minFrequency:i(a?.minFrequency)}:{}}}:null}}export{M as readProceduralMemoryRuntimeConfig};

package/dist/knowledge/procedural/index.js

@@ -1,2 +1 @@
-export { readProceduralMemoryRuntimeConfig } from "./config.js";
-export { createBackgroundProceduralCandidates, createProceduralMemoryManager, ProceduralMemoryFormationSync, } from "./manager.js";
+import{readProceduralMemoryRuntimeConfig as o}from"./config.js";import{createBackgroundProceduralCandidates as c,createProceduralMemoryManager as d,ProceduralMemoryFormationSync as m}from"./manager.js";export{m as ProceduralMemoryFormationSync,c as createBackgroundProceduralCandidates,d as createProceduralMemoryManager,o as readProceduralMemoryRuntimeConfig};

package/dist/knowledge/procedural/manager.js

@@ -1,345 +1,9 @@
-import path from "node:path";
-import { extractMessageText } from "../../utils/message-content.js";
-import { createResolvedModel } from "../../runtime/adapter/model/model-providers.js";
-import { FileBackedStore } from "../../runtime/harness/system/store.js";
-import { compileModel } from "../../workspace/resource-compilers.js";
-import { resolveRefId } from "../../workspace/support/workspace-ref-utils.js";
-import { renderProceduralMemoryManagerPrompt } from "../../runtime/prompts/runtime-prompts.js";
-const FORMATION_EVENT_TYPES = new Set([
-    "request.state.changed",
-    "approval.resolved",
-]);
-function excerpt(message) {
-    if (!message?.content) {
-        return undefined;
-    }
-    const normalized = extractMessageText(message.content).replace(/\s+/g, " ").trim();
-    if (!normalized) {
-        return undefined;
-    }
-    return normalized.length > 240 ? `${normalized.slice(0, 237)}...` : normalized;
-}
-function summarizeApprovals(approvals) {
-    if (approvals.length === 0) {
-        return "No approvals were recorded in this run.";
-    }
-    return approvals
-        .map((approval) => `${approval.toolName} (${approval.status})`)
-        .join(", ");
-}
-function fingerprintMessages(messages, focus) {
-    const serialized = messages
-        .map((message) => `${message.role}\n${message.createdAt}\n${extractMessageText(message.content)}`)
-        .join("\n---\n");
-    return `${focus.join(",")}::${serialized}`;
-}
-function selectRelatedContextRecords(candidate, existingRecords, maxRecords) {
-    const candidateText = `${candidate.summary ?? ""}\n${candidate.content}`.toLowerCase().trim();
-    if (!candidateText) {
-        return existingRecords.slice(0, maxRecords);
-    }
-    return existingRecords
-        .filter((record) => record.status === "active")
-        .map((record) => {
-        let score = 0;
-        const recordText = `${record.summary}\n${record.content}`.toLowerCase();
-        if (candidate.scope && record.scope === candidate.scope) {
-            score += 2;
-        }
-        if (recordText.includes(candidateText) || candidateText.includes(recordText)) {
-            score += 4;
-        }
-        const candidateTokens = new Set(candidateText.split(/[^a-z0-9_\u4e00-\u9fff]+/iu).filter((token) => token.length > 1));
-        const recordTokens = new Set(recordText.split(/[^a-z0-9_\u4e00-\u9fff]+/iu).filter((token) => token.length > 1));
-        let shared = 0;
-        for (const token of candidateTokens) {
-            if (recordTokens.has(token)) {
-                shared += 1;
-            }
-        }
-        score += shared;
-        return { record, score };
-    })
-        .filter((item) => item.score > 0)
-        .sort((left, right) => right.score - left.score || right.record.lastConfirmedAt.localeCompare(left.record.lastConfirmedAt))
-        .slice(0, maxRecords)
-        .map((item) => item.record);
-}
-function extractText(value) {
-    if (typeof value === "string") {
-        return value;
-    }
-    if (typeof value !== "object" || value === null) {
-        return undefined;
-    }
-    if ("content" in value && typeof value.content === "string") {
-        return String(value.content);
-    }
-    const kwargs = "kwargs" in value && typeof value.kwargs === "object" && value.kwargs !== null
-        ? value.kwargs
-        : undefined;
-    if (typeof kwargs?.content === "string") {
-        return kwargs.content;
-    }
-    return undefined;
-}
-function tryParseJsonObject(text) {
-    try {
-        const parsed = JSON.parse(text);
-        return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null;
-    }
-    catch {
-        const match = text.match(/\{[\s\S]*\}/);
-        if (!match) {
-            return null;
-        }
-        try {
-            const parsed = JSON.parse(match[0]);
-            return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null;
-        }
-        catch {
-            return null;
-        }
-    }
-}
-function asString(value) {
-    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
-}
-function asNumber(value) {
-    return typeof value === "number" && Number.isFinite(value) ? 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;
-}
-function normalizeScope(value) {
-    return value === "session" || value === "agent" || value === "workspace" || value === "user" || value === "project"
-        ? value
-        : undefined;
-}
-function normalizeCandidateOutputs(parsed, candidate) {
-    const rawOutputs = Array.isArray(parsed.mutations)
-        ? parsed.mutations.filter((item) => typeof item === "object" && item !== null && !Array.isArray(item))
-        : [parsed];
-    return rawOutputs.map((output) => ({
-        ...candidate,
-        kind: "procedural",
-        scope: normalizeScope(output.scope) ?? candidate.scope ?? "workspace",
-        summary: asString(output.summary) ?? candidate.summary,
-        content: asString(output.content) ?? candidate.content,
-        confidence: asNumber(output.confidence) ?? candidate.confidence ?? 0.72,
-        tags: asStringArray(output.tags) ?? candidate.tags,
-    })).filter((item) => typeof item.content === "string" && item.content.trim().length > 0);
-}
-export function createBackgroundProceduralCandidates(input) {
-    const latestUser = excerpt(input.messages.filter((message) => message.role === "user").at(-1));
-    const latestAssistant = excerpt(input.messages.filter((message) => message.role === "assistant").at(-1));
-    const transcriptPreview = input.messages
-        .slice(-6)
-        .map((message) => `${message.role}: ${excerpt(message) ?? "(empty)"}`)
-        .join("\n");
-    const approvals = summarizeApprovals(input.approvals);
-    const sourceRef = `runtime://sessions/${input.session.sessionId}/requests/${input.requestId}/procedural-reflection`;
-    return [{
-            kind: "procedural",
-            scope: "workspace",
-            sourceType: "runtime-transcript",
-            sourceRef,
-            summary: latestUser ?? latestAssistant ?? `Procedural reflection for ${input.requestId}`,
-            content: [
-                "Completed run transcript evidence for procedural memory extraction.",
-                `Trigger: ${input.trigger}`,
-                `Focus: ${input.focus.join(", ")}`,
-                "",
-                "Latest user message:",
-                latestUser ?? "(none)",
-                "",
-                "Latest assistant response:",
-                latestAssistant ?? "(none)",
-                "",
-                "Recent transcript excerpt:",
-                transcriptPreview || "(none)",
-                "",
-                "Approval snapshot:",
-                approvals,
-            ].join("\n"),
-            confidence: 0.64,
-            observedAt: input.recordedAt,
-            tags: ["procedural-background-extraction", input.trigger, ...input.focus],
-        }];
-}
-async function runProceduralMemoryManager(input) {
-    let resolvedModel;
-    try {
-        resolvedModel = await createResolvedModel(input.model, input.modelResolver);
-    }
-    catch {
-        return input.candidates;
-    }
-    const invoker = resolvedModel;
-    if (typeof invoker.invoke !== "function") {
-        return input.candidates;
-    }
-    const transformed = [];
-    for (const candidate of input.candidates) {
-        const prompt = renderProceduralMemoryManagerPrompt({
-            candidate,
-            sessionId: input.sessionId,
-            requestId: input.requestId,
-            focus: input.focus,
-            existingRecords: selectRelatedContextRecords(candidate, input.existingRecords, input.maxContextRecords ?? input.existingRecords.length),
-        });
-        let response;
-        try {
-            response = await invoker.invoke(prompt, {});
-        }
-        catch {
-            continue;
-        }
-        const parsed = tryParseJsonObject(extractText(response) ?? "");
-        if (!parsed || parsed.store === false) {
-            continue;
-        }
-        transformed.push(...normalizeCandidateOutputs(parsed, candidate));
-    }
-    return transformed;
-}
-export function createProceduralMemoryManager(input) {
-    return {
-        async transform({ candidates, binding, sessionId, requestId, recordedAt, existingRecords }) {
-            if (input.config.enabled !== true || candidates.length === 0) {
-                return candidates;
-            }
-            if (!binding.langchainAgentParams?.model) {
-                return candidates;
-            }
-            const providerModelRef = asString(input.config.provider?.options?.modelRef);
-            const primaryModel = (() => {
-                if (!providerModelRef) {
-                    return binding.langchainAgentParams.model;
-                }
-                const configured = input.workspace.models.get(resolveRefId(providerModelRef));
-                return configured ? compileModel(configured) : binding.langchainAgentParams.model;
-            })();
-            return runProceduralMemoryManager({
-                workspace: input.workspace,
-                binding,
-                model: primaryModel,
-                candidates,
-                sessionId,
-                requestId,
-                recordedAt,
-                existingRecords: existingRecords.filter((record) => record.status === "active"),
-                focus: input.config.formation?.background?.scopeHints ?? ["workflow_patterns", "debugging_lessons", "reusable_procedures"],
-                maxContextRecords: 8,
-                modelResolver: input.modelResolver,
-            });
-        },
-    };
-}
-export class ProceduralMemoryFormationSync {
-    persistence;
-    config;
-    writer;
-    stateStore;
-    options;
-    pending = new Set();
-    syncChain = Promise.resolve();
-    name = "procedural-memory-formation-sync";
-    constructor(persistence, config, writer, runtimeRoot, stateStore = new FileBackedStore(path.join(runtimeRoot, config.formation?.background?.stateStorePath ?? "knowledge/procedural-memory-state.json")), options = {}) {
-        this.persistence = persistence;
-        this.config = config;
-        this.writer = writer;
-        this.stateStore = stateStore;
-        this.options = options;
-    }
-    shouldHandle(event) {
-        const background = this.config.formation?.background;
-        if (!background?.enabled || !FORMATION_EVENT_TYPES.has(event.eventType)) {
-            return false;
-        }
-        if (event.eventType === "approval.resolved") {
-            return background.writeOnApprovalResolution;
-        }
-        return background.writeOnRequestCompletion && event.payload.state === "completed";
-    }
-    async handleEvent(event) {
-        if (!this.shouldHandle(event)) {
-            return;
-        }
-        const trigger = event.eventType === "approval.resolved" ? "approval.resolved" : "request.completed";
-        const task = this.syncChain
-            .then(() => this.reflectRun(event.sessionId, event.requestId, trigger, event.timestamp))
-            .catch(() => {
-            // Fail open: procedural reflection should not block runtime progress.
-        });
-        this.syncChain = task
-            .catch(() => {
-            // Fail open: procedural reflection should not block runtime progress.
-        })
-            .finally(() => {
-            this.pending.delete(task);
-        });
-        this.pending.add(task);
-    }
-    async reflectRun(sessionId, requestId, trigger, recordedAt) {
-        const background = this.config.formation?.background;
-        if (!background) {
-            return;
-        }
-        const [session, run, allMessages, approvals] = await Promise.all([
-            this.persistence.getSession(sessionId),
-            this.persistence.getRequest(requestId),
-            this.persistence.listSessionMessages(sessionId, background.maxMessagesPerRequest),
-            this.persistence.getRequestApprovals(sessionId, requestId),
-        ]);
-        if (!session || !run) {
-            return;
-        }
-        const messages = allMessages.filter((message) => message.requestId === requestId);
-        if (messages.length === 0) {
-            return;
-        }
-        const fingerprint = fingerprintMessages(messages, background.scopeHints);
-        const namespace = ["memories", "formation", "sessions", sessionId, "requests"];
-        const cursor = await this.stateStore.get(namespace, requestId);
-        const existing = cursor?.value;
-        if (existing?.fingerprint === fingerprint && existing.trigger === trigger) {
-            return;
-        }
-        const candidates = createBackgroundProceduralCandidates({
-            session,
-            requestId,
-            agentId: run.agentId ?? session.agentId,
-            trigger,
-            recordedAt,
-            messages,
-            approvals,
-            focus: background.scopeHints,
-        });
-        await this.writer({
-            candidates,
-            sessionId,
-            requestId,
-            agentId: run.agentId ?? session.agentId,
-            userId: this.options.userId,
-            projectId: this.options.projectId,
-            recordedAt,
-        });
-        await this.stateStore.put(namespace, requestId, {
-            fingerprint,
-            candidateCount: candidates.length,
-            syncedAt: new Date().toISOString(),
-            trigger,
-        });
-    }
-    async close() {
-        await Promise.allSettled(Array.from(this.pending));
-    }
-}
+import k from"node:path";import{extractMessageText as h}from"../../utils/message-content.js";import{createResolvedModel as A}from"../../runtime/adapter/model/model-providers.js";import{FileBackedStore as S}from"../../runtime/harness/system/store.js";import{compileModel as R}from"../../workspace/resource-compilers.js";import{resolveRefId as x}from"../../workspace/support/workspace-ref-utils.js";import{renderProceduralMemoryManagerPrompt as $}from"../../runtime/prompts/runtime-prompts.js";const b=new Set(["request.state.changed","approval.resolved"]);function d(e){if(!e?.content)return;const t=h(e.content).replace(/\s+/g," ").trim();if(t)return t.length>240?`${t.slice(0,237)}...`:t}function M(e){return e.length===0?"No approvals were recorded in this run.":e.map(t=>`${t.toolName} (${t.status})`).join(", ")}function P(e,t){const r=e.map(n=>`${n.role}
+${n.createdAt}
+${h(n.content)}`).join(`
+---
+`);return`${t.join(",")}::${r}`}function j(e,t,r){const n=`${e.summary??""}
+${e.content}`.toLowerCase().trim();return n?t.filter(o=>o.status==="active").map(o=>{let c=0;const s=`${o.summary}
+${o.content}`.toLowerCase();e.scope&&o.scope===e.scope&&(c+=2),(s.includes(n)||n.includes(s))&&(c+=4);const i=new Set(n.split(/[^a-z0-9_\u4e00-\u9fff]+/iu).filter(l=>l.length>1)),f=new Set(s.split(/[^a-z0-9_\u4e00-\u9fff]+/iu).filter(l=>l.length>1));let a=0;for(const l of i)f.has(l)&&(a+=1);return c+=a,{record:o,score:c}}).filter(o=>o.score>0).sort((o,c)=>c.score-o.score||c.record.lastConfirmedAt.localeCompare(o.record.lastConfirmedAt)).slice(0,r).map(o=>o.record):t.slice(0,r)}function C(e){if(typeof e=="string")return e;if(typeof e!="object"||e===null)return;if("content"in e&&typeof e.content=="string")return String(e.content);const t="kwargs"in e&&typeof e.kwargs=="object"&&e.kwargs!==null?e.kwargs:void 0;if(typeof t?.content=="string")return t.content}function T(e){try{const t=JSON.parse(e);return typeof t=="object"&&t!==null&&!Array.isArray(t)?t:null}catch{const t=e.match(/\{[\s\S]*\}/);if(!t)return null;try{const r=JSON.parse(t[0]);return typeof r=="object"&&r!==null&&!Array.isArray(r)?r:null}catch{return null}}}function u(e){return typeof e=="string"&&e.trim().length>0?e.trim():void 0}function I(e){return typeof e=="number"&&Number.isFinite(e)?e:void 0}function O(e){if(!Array.isArray(e))return;const t=e.filter(r=>typeof r=="string").map(r=>r.trim()).filter(r=>r.length>0);return t.length>0?Array.from(new Set(t)):void 0}function v(e){return e==="session"||e==="agent"||e==="workspace"||e==="user"||e==="project"?e:void 0}function q(e,t){return(Array.isArray(e.mutations)?e.mutations.filter(n=>typeof n=="object"&&n!==null&&!Array.isArray(n)):[e]).map(n=>({...t,kind:"procedural",scope:v(n.scope)??t.scope??"workspace",summary:u(n.summary)??t.summary,content:u(n.content)??t.content,confidence:I(n.confidence)??t.confidence??.72,tags:O(n.tags)??t.tags})).filter(n=>typeof n.content=="string"&&n.content.trim().length>0)}function N(e){const t=d(e.messages.filter(s=>s.role==="user").at(-1)),r=d(e.messages.filter(s=>s.role==="assistant").at(-1)),n=e.messages.slice(-6).map(s=>`${s.role}: ${d(s)??"(empty)"}`).join(`
+`),o=M(e.approvals);return[{kind:"procedural",scope:"workspace",sourceType:"runtime-transcript",sourceRef:`runtime://sessions/${e.session.sessionId}/requests/${e.requestId}/procedural-reflection`,summary:t??r??`Procedural reflection for ${e.requestId}`,content:["Completed run transcript evidence for procedural memory extraction.",`Trigger: ${e.trigger}`,`Focus: ${e.focus.join(", ")}`,"","Latest user message:",t??"(none)","","Latest assistant response:",r??"(none)","","Recent transcript excerpt:",n||"(none)","","Approval snapshot:",o].join(`
+`),confidence:.64,observedAt:e.recordedAt,tags:["procedural-background-extraction",e.trigger,...e.focus]}]}async function z(e){let t;try{t=await A(e.model,e.modelResolver)}catch{return e.candidates}const r=t;if(typeof r.invoke!="function")return e.candidates;const n=[];for(const o of e.candidates){const c=$({candidate:o,sessionId:e.sessionId,requestId:e.requestId,focus:e.focus,existingRecords:j(o,e.existingRecords,e.maxContextRecords??e.existingRecords.length)});let s;try{s=await r.invoke(c,{})}catch{continue}const i=T(C(s)??"");!i||i.store===!1||n.push(...q(i,o))}return n}function U(e){return{async transform({candidates:t,binding:r,sessionId:n,requestId:o,recordedAt:c,existingRecords:s}){if(e.config.enabled!==!0||t.length===0||!r.langchainAgentParams?.model)return t;const i=u(e.config.provider?.options?.modelRef),f=(()=>{if(!i)return r.langchainAgentParams.model;const a=e.workspace.models.get(x(i));return a?R(a):r.langchainAgentParams.model})();return z({workspace:e.workspace,binding:r,model:f,candidates:t,sessionId:n,requestId:o,recordedAt:c,existingRecords:s.filter(a=>a.status==="active"),focus:e.config.formation?.background?.scopeHints??["workflow_patterns","debugging_lessons","reusable_procedures"],maxContextRecords:8,modelResolver:e.modelResolver})}}}class V{persistence;config;writer;stateStore;options;pending=new Set;syncChain=Promise.resolve();name="procedural-memory-formation-sync";constructor(t,r,n,o,c=new S(k.join(o,r.formation?.background?.stateStorePath??"knowledge/procedural-memory-state.json")),s={}){this.persistence=t,this.config=r,this.writer=n,this.stateStore=c,this.options=s}shouldHandle(t){const r=this.config.formation?.background;return!r?.enabled||!b.has(t.eventType)?!1:t.eventType==="approval.resolved"?r.writeOnApprovalResolution:r.writeOnRequestCompletion&&t.payload.state==="completed"}async handleEvent(t){if(!this.shouldHandle(t))return;const r=t.eventType==="approval.resolved"?"approval.resolved":"request.completed",n=this.syncChain.then(()=>this.reflectRun(t.sessionId,t.requestId,r,t.timestamp)).catch(()=>{});this.syncChain=n.catch(()=>{}).finally(()=>{this.pending.delete(n)}),this.pending.add(n)}async reflectRun(t,r,n,o){const c=this.config.formation?.background;if(!c)return;const[s,i,f,a]=await Promise.all([this.persistence.getSession(t),this.persistence.getRequest(r),this.persistence.listSessionMessages(t,c.maxMessagesPerRequest),this.persistence.getRequestApprovals(t,r)]);if(!s||!i)return;const l=f.filter(w=>w.requestId===r);if(l.length===0)return;const m=P(l,c.scopeHints),p=["memories","formation","sessions",t,"requests"],g=(await this.stateStore.get(p,r))?.value;if(g?.fingerprint===m&&g.trigger===n)return;const y=N({session:s,requestId:r,agentId:i.agentId??s.agentId,trigger:n,recordedAt:o,messages:l,approvals:a,focus:c.scopeHints});await this.writer({candidates:y,sessionId:t,requestId:r,agentId:i.agentId??s.agentId,userId:this.options.userId,projectId:this.options.projectId,recordedAt:o}),await this.stateStore.put(p,r,{fingerprint:m,candidateCount:y.length,syncedAt:new Date().toISOString(),trigger:n})}async close(){await Promise.allSettled(Array.from(this.pending))}}export{V as ProceduralMemoryFormationSync,N as createBackgroundProceduralCandidates,U as createProceduralMemoryManager};

package/dist/mcp.js

@@ -1,2 +1 @@
-export { AGENT_HARNESS_VERSION } from "./package-version.js";
-export * from "./protocol/mcp/server.js";
+import{AGENT_HARNESS_VERSION as E}from"./package-version.js";export*from"./protocol/mcp/server.js";export{E as AGENT_HARNESS_VERSION};

package/dist/package-version.d.ts

@@ -1,2 +1,2 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.475";
+export declare const AGENT_HARNESS_VERSION = "0.0.476";
 export declare const AGENT_HARNESS_RELEASE_DATE = "2026-05-08";

package/dist/package-version.js

@@ -1,2 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.475";
-export const AGENT_HARNESS_RELEASE_DATE = "2026-05-08";
+const E="0.0.476",A="2026-05-08";export{A as AGENT_HARNESS_RELEASE_DATE,E as AGENT_HARNESS_VERSION};