@n8n/agents 0.6.0 → 0.8.0

package/dist/runtime/observation-log-observer.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseObservationLogMarkdown = parseObservationLogMarkdown;
+exports.renderObserverTranscript = renderObserverTranscript;
+exports.runObservationLogObserver = runObservationLogObserver;
+const observation_log_renderer_1 = require("./observation-log-renderer");
+const observation_log_1 = require("../types/sdk/observation-log");
+const MARKER_BY_TOKEN = {
+    CRITICAL: 'critical',
+    IMPORTANT: 'important',
+    INFO: 'info',
+    COMPLETION: 'completion',
+};
+const BULLET_PATTERN = /^(\s*)[*-]\s+(CRITICAL|IMPORTANT|INFO|COMPLETION)(?:\s+\(\d{2}:\d{2}\))?\s+(.+)$/iu;
+const DEFAULT_MAX_SERIALIZED_CHARS = 2_000;
+const DEFAULT_MAX_STRING_CHARS = 500;
+const DEFAULT_MAX_ARRAY_ITEMS = 20;
+const DEFAULT_MAX_OBJECT_KEYS = 40;
+const REDACTED_VALUE = '[redacted]';
+const SENSITIVE_KEY_PATTERN = /(?:^|[_-])(?:api[-_]?key|authorization|credential|password|secret|token|access[-_]?token|refresh[-_]?token|private[-_]?key|client[-_]?secret|session[-_]?cookie)(?:$|[_-])/i;
+const INLINE_AUTHORIZATION_PATTERN = /\b(authorization\s*[:=]\s*)(?:[a-z][\w.-]*\s+)?[^\s"',&;]+/gi;
+const INLINE_SECRET_ASSIGNMENT_PATTERN = /\b((?:api[-_]?key|password|secret|token|access[-_]?token|refresh[-_]?token|client[-_]?secret)\s*[:=]\s*)[^\s"',&;]+/gi;
+function parseObservationLogMarkdown(markdown) {
+    const entries = [];
+    const skippedLines = [];
+    let currentParentIndex = null;
+    for (const rawLine of markdown.split(/\r?\n/)) {
+        const trimmed = rawLine.trim();
+        if (!trimmed)
+            continue;
+        const match = BULLET_PATTERN.exec(rawLine);
+        if (!match) {
+            skippedLines.push(rawLine);
+            continue;
+        }
+        const [, indentation, markerToken, text] = match;
+        const marker = MARKER_BY_TOKEN[markerToken.toUpperCase()];
+        const isChild = indentation.length > 0;
+        if (isChild && currentParentIndex === null) {
+            skippedLines.push(rawLine);
+            continue;
+        }
+        const parentIndex = isChild ? currentParentIndex : null;
+        entries.push({ marker, text: text.trim(), parentIndex });
+        if (!isChild) {
+            currentParentIndex = entries.length - 1;
+        }
+    }
+    return { entries, skippedLines };
+}
+function renderObserverTranscript(messages, options = {}) {
+    const lines = [];
+    for (const message of messages) {
+        if (!isLlmMessage(message))
+            continue;
+        const timestamp = message.createdAt.toISOString();
+        const text = message.content
+            .filter((content) => content.type === 'text')
+            .map((content) => content.text)
+            .join('\n');
+        if (text) {
+            lines.push(`[${timestamp}] ${message.role}:`);
+            lines.push(text);
+        }
+        for (const toolCall of message.content.filter(isToolCallContent)) {
+            lines.push(`[${timestamp}] tool_call ${toolCall.toolName} input=${serializeForObserver(toolCall.input, options)}`);
+            if (toolCall.state === 'resolved') {
+                lines.push(`[${timestamp}] tool_result ${toolCall.toolName} output=${serializeForObserver(toolCall.output, options)}`);
+            }
+            else if (toolCall.state === 'rejected') {
+                lines.push(`[${timestamp}] tool_result ${toolCall.toolName} error=${serializeErrorForObserver(toolCall.error, options)}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+async function runObservationLogObserver(opts) {
+    const { memory, scopeKind, scopeId } = opts;
+    const cursor = await memory.getCursor(scopeKind, scopeId);
+    const messageScopeKind = opts.messageSource ? 'thread' : scopeKind;
+    const messageScopeId = opts.messageSource?.threadId ?? scopeId;
+    const deltaMessages = await memory.getMessagesForScope(messageScopeKind, messageScopeId, cursor
+        ? {
+            ...(opts.messageSource?.resourceId !== undefined && {
+                resourceId: opts.messageSource.resourceId,
+            }),
+            since: {
+                sinceCreatedAt: cursor.lastObservedAt,
+                sinceMessageId: cursor.lastObservedMessageId,
+            },
+        }
+        : opts.messageSource?.resourceId !== undefined
+            ? { resourceId: opts.messageSource.resourceId }
+            : undefined);
+    if (deltaMessages.length === 0)
+        return { status: 'skipped', reason: 'no-delta' };
+    const tokenCounter = opts.tokenCounter ?? observation_log_1.estimateObservationTokens;
+    const transcript = renderObserverTranscript(deltaMessages);
+    const tokenCount = tokenCounter(transcript);
+    if (tokenCount < opts.observerThresholdTokens) {
+        return { status: 'skipped', reason: 'below-threshold', tokenCount };
+    }
+    const observationLogTail = (await memory.getActiveObservationLog({
+        scopeKind,
+        scopeId,
+        limit: opts.observationLogTailLimit,
+        order: 'desc',
+    })).reverse();
+    const now = opts.now ?? new Date();
+    const renderedObservationLogTail = (0, observation_log_renderer_1.renderObservationLog)(observationLogTail);
+    const markdown = await opts.observe({
+        scopeKind,
+        scopeId,
+        now,
+        deltaMessages,
+        transcript,
+        transcriptTokenCount: tokenCount,
+        observationLogTail,
+        renderedObservationLogTail,
+    });
+    const parsed = parseObservationLogMarkdown(markdown);
+    for (const line of parsed.skippedLines) {
+        opts.onMalformedLine?.(line);
+    }
+    const inserted = [];
+    for (const entry of parsed.entries) {
+        const parentId = entry.parentIndex === null ? null : (inserted[entry.parentIndex]?.id ?? null);
+        const [row] = await memory.appendObservationLogEntries([
+            {
+                scopeKind,
+                scopeId,
+                marker: entry.marker,
+                text: entry.text,
+                parentId,
+                createdAt: new Date(now.getTime() + inserted.length),
+            },
+        ]);
+        inserted.push(row);
+    }
+    await advanceObserverCursor(memory, scopeKind, scopeId, deltaMessages[deltaMessages.length - 1], now);
+    return {
+        status: 'ran',
+        observationsWritten: inserted.length,
+        tokenCount,
+        skippedLines: parsed.skippedLines,
+    };
+}
+function isLlmMessage(message) {
+    return 'role' in message && Array.isArray(message.content);
+}
+function isToolCallContent(content) {
+    return content.type === 'tool-call';
+}
+function serializeForObserver(value, options) {
+    const compacted = compactForObserver(value, options);
+    const serialized = safeJsonStringify(compacted);
+    return truncateString(serialized, options.maxSerializedChars ?? DEFAULT_MAX_SERIALIZED_CHARS, 'serialized');
+}
+function serializeErrorForObserver(error, options) {
+    return truncateString(redactSensitiveString(error), options.maxStringChars ?? DEFAULT_MAX_STRING_CHARS, 'string');
+}
+function compactForObserver(value, options) {
+    const maxStringChars = options.maxStringChars ?? DEFAULT_MAX_STRING_CHARS;
+    const maxArrayItems = options.maxArrayItems ?? DEFAULT_MAX_ARRAY_ITEMS;
+    const maxObjectKeys = options.maxObjectKeys ?? DEFAULT_MAX_OBJECT_KEYS;
+    if (typeof value === 'string') {
+        return truncateString(redactSensitiveString(value), maxStringChars, 'string');
+    }
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value)) {
+        const compacted = value
+            .slice(0, maxArrayItems)
+            .map((item) => compactForObserver(item, options));
+        if (value.length > maxArrayItems) {
+            compacted.push({ __truncatedItems: value.length - maxArrayItems });
+        }
+        return compacted;
+    }
+    const result = {};
+    const entries = Object.entries(value);
+    for (const [key, entryValue] of entries.slice(0, maxObjectKeys)) {
+        if (isSensitiveKey(key)) {
+            result[key] = REDACTED_VALUE;
+        }
+        else if (shouldStripBlob(key, entryValue)) {
+            result[key] = '[omitted large blob]';
+        }
+        else {
+            result[key] = compactForObserver(entryValue, options);
+        }
+    }
+    if (entries.length > maxObjectKeys) {
+        result.__truncatedKeys = entries.length - maxObjectKeys;
+    }
+    return result;
+}
+function isSensitiveKey(key) {
+    return SENSITIVE_KEY_PATTERN.test(key);
+}
+function redactSensitiveString(value) {
+    return value
+        .replace(INLINE_AUTHORIZATION_PATTERN, (_match, prefix) => `${prefix}${REDACTED_VALUE}`)
+        .replace(INLINE_SECRET_ASSIGNMENT_PATTERN, (_match, prefix) => `${prefix}${REDACTED_VALUE}`);
+}
+function shouldStripBlob(key, value) {
+    if (typeof value !== 'string')
+        return false;
+    if (value.length <= DEFAULT_MAX_STRING_CHARS)
+        return false;
+    return /blob|base64|data|file|image/i.test(key);
+}
+function truncateString(value, maxChars, label) {
+    if (value.length <= maxChars)
+        return value;
+    return `${value.slice(0, maxChars)}...[truncated ${value.length - maxChars} ${label} chars]`;
+}
+function safeJsonStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return JSON.stringify('[unserializable]');
+    }
+}
+async function advanceObserverCursor(memory, scopeKind, scopeId, lastMessage, now) {
+    await memory.setCursor({
+        scopeKind,
+        scopeId,
+        lastObservedMessageId: lastMessage.id,
+        lastObservedAt: lastMessage.createdAt,
+        updatedAt: now,
+    });
+}
+//# sourceMappingURL=observation-log-observer.js.map

package/dist/runtime/observation-log-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-log-observer.js","sourceRoot":"","sources":["../../src/runtime/observation-log-observer.ts"],"names":[],"mappings":"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"}

package/dist/runtime/observation-log-reflector.d.ts

@@ -0,0 +1,36 @@
+import type { BuiltObservationLogStore, ObservationLogEntry, ObservationLogReflectFn, ObservationLogReflectorInput, ObservationLogReflection, ObservationLogReflectionResult, ObservationLogScopeKind, TokenCounter } from '../types/sdk/observation-log';
+export type { ObservationLogReflectFn, ObservationLogReflectorInput };
+export type ObservationLogReflectorMemory = BuiltObservationLogStore;
+export interface ObservationLogReflectorWarning {
+    message: string;
+    scopeKind: ObservationLogScopeKind;
+    scopeId: string;
+    tokenCount: number;
+    tokenBudget: number;
+}
+export interface RunObservationLogReflectorOpts {
+    memory: ObservationLogReflectorMemory;
+    scopeKind: ObservationLogScopeKind;
+    scopeId: string;
+    reflectorThresholdTokens: number;
+    reflect: ObservationLogReflectFn;
+    tokenCounter?: TokenCounter;
+    now?: Date;
+    onWarning?: (warning: ObservationLogReflectorWarning) => void;
+}
+export type RunObservationLogReflectorResult = {
+    status: 'skipped';
+    reason: 'below-threshold';
+    tokenCount: number;
+} | {
+    status: 'ran';
+    tokenCount: number;
+    remainingTokenCount: number;
+    overBudgetAfterReflection: boolean;
+    reflection: ObservationLogReflection;
+    result: ObservationLogReflectionResult;
+};
+export declare function parseObservationLogReflectionJson(output: string): ObservationLogReflection;
+export declare function renderObservationLogForReflection(entries: ObservationLogEntry[]): string;
+export declare function normalizeObservationLogReflection(activeObservationLog: ObservationLogEntry[], reflection: ObservationLogReflection): ObservationLogReflection;
+export declare function runObservationLogReflector(opts: RunObservationLogReflectorOpts): Promise<RunObservationLogReflectorResult>;

package/dist/runtime/observation-log-reflector.js

@@ -0,0 +1,292 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseObservationLogReflectionJson = parseObservationLogReflectionJson;
+exports.renderObservationLogForReflection = renderObservationLogForReflection;
+exports.normalizeObservationLogReflection = normalizeObservationLogReflection;
+exports.runObservationLogReflector = runObservationLogReflector;
+const observation_log_1 = require("../types/sdk/observation-log");
+const MARKER_LABELS = {
+    critical: 'CRITICAL',
+    important: 'IMPORTANT',
+    info: 'INFO',
+    completion: 'COMPLETION',
+};
+const REFLECTOR_OVER_BUDGET_WARNING = 'Observation log remains over reflector budget after reflection';
+function parseObservationLogReflectionJson(output) {
+    let parsed;
+    try {
+        parsed = JSON.parse(extractJsonObject(output));
+    }
+    catch {
+        throw new Error('Reflector output must be valid JSON');
+    }
+    if (!isRecord(parsed))
+        throw new Error('Reflector output must be a JSON object');
+    return {
+        drop: readStringArray(parsed.drop ?? [], 'drop'),
+        merge: readMergeArray(parsed.merge ?? []),
+    };
+}
+function renderObservationLogForReflection(entries) {
+    const activeEntries = entries.filter((entry) => entry.status === 'active').sort(compareEntries);
+    const activeIds = new Set(activeEntries.map((entry) => entry.id));
+    const childrenByParent = new Map();
+    const roots = [];
+    for (const entry of activeEntries) {
+        if (entry.parentId && activeIds.has(entry.parentId)) {
+            const children = childrenByParent.get(entry.parentId) ?? [];
+            children.push(entry);
+            childrenByParent.set(entry.parentId, children);
+        }
+        else {
+            roots.push(entry);
+        }
+    }
+    const lines = [];
+    for (const root of roots) {
+        lines.push(renderReflectionBullet(root));
+        for (const child of childrenByParent.get(root.id) ?? []) {
+            lines.push(renderReflectionBullet(child, '  '));
+        }
+    }
+    return lines.join('\n');
+}
+function normalizeObservationLogReflection(activeObservationLog, reflection) {
+    const activeEntries = activeObservationLog.filter((entry) => entry.status === 'active');
+    const activeById = new Map(activeEntries.map((entry) => [entry.id, entry]));
+    const childrenByParent = new Map();
+    for (const entry of activeEntries) {
+        if (!entry.parentId)
+            continue;
+        const children = childrenByParent.get(entry.parentId) ?? [];
+        children.push(entry);
+        childrenByParent.set(entry.parentId, children);
+    }
+    const dropSeeds = new Set(reflection.drop.filter((id) => activeById.has(id)));
+    const allMergeSeeds = new Set(reflection.merge.flatMap((merge) => merge.supersedes).filter((id) => activeById.has(id)));
+    const claimedMergeIds = new Set();
+    const merge = reflection.merge
+        .map((entry) => {
+        const ownSeeds = new Set(entry.supersedes.filter((id) => activeById.has(id)));
+        const supersedes = uniqueObservationIds(entry.supersedes
+            .filter((id) => activeById.has(id))
+            .filter((id) => !isChildOnlyRemoval(id, ownSeeds, allMergeSeeds, dropSeeds, activeById))
+            .flatMap((id) => [id, ...descendantIds(id, childrenByParent)])).filter((id) => !claimedMergeIds.has(id));
+        for (const id of supersedes)
+            claimedMergeIds.add(id);
+        if (supersedes.length === 0)
+            return null;
+        return {
+            ...entry,
+            supersedes,
+        };
+    })
+        .filter((entry) => entry !== null);
+    const droppedIds = new Set();
+    for (const id of reflection.drop) {
+        if (!activeById.has(id) || claimedMergeIds.has(id))
+            continue;
+        if (hasAncestorIn(id, dropSeeds, activeById))
+            continue;
+        if (isChildOnlyRemoval(id, dropSeeds, dropSeeds, claimedMergeIds, activeById))
+            continue;
+        for (const candidateId of [id, ...descendantIds(id, childrenByParent)]) {
+            if (!claimedMergeIds.has(candidateId))
+                droppedIds.add(candidateId);
+        }
+    }
+    const removedIds = new Set([...droppedIds, ...claimedMergeIds]);
+    return {
+        drop: [...droppedIds],
+        merge: merge.map((entry) => ({
+            ...entry,
+            parentId: normalizeReplacementParentId(entry.parentId, activeById, removedIds),
+        })),
+    };
+}
+async function runObservationLogReflector(opts) {
+    const { memory, scopeKind, scopeId, reflectorThresholdTokens } = opts;
+    const tokenCounter = opts.tokenCounter ?? observation_log_1.estimateObservationTokens;
+    const activeObservationLog = await memory.getActiveObservationLog({
+        scopeKind,
+        scopeId,
+        order: 'asc',
+    });
+    const tokenCount = countObservationTokens(activeObservationLog, tokenCounter);
+    if (tokenCount <= reflectorThresholdTokens) {
+        return { status: 'skipped', reason: 'below-threshold', tokenCount };
+    }
+    const now = opts.now ?? new Date();
+    const renderedObservationLog = renderObservationLogForReflection(activeObservationLog);
+    const output = await opts.reflect({
+        scopeKind,
+        scopeId,
+        now,
+        activeObservationLog,
+        renderedObservationLog,
+        tokenCount,
+        tokenBudget: reflectorThresholdTokens,
+    });
+    const reflection = normalizeObservationLogReflection(activeObservationLog, withCreatedAt(parseObservationLogReflectionJson(output), now));
+    const result = await memory.applyObservationLogReflection({ scopeKind, scopeId }, reflection);
+    const remainingTokenCount = countObservationTokens(await memory.getActiveObservationLog({ scopeKind, scopeId }), tokenCounter);
+    const overBudgetAfterReflection = remainingTokenCount > reflectorThresholdTokens;
+    if (overBudgetAfterReflection) {
+        opts.onWarning?.({
+            message: REFLECTOR_OVER_BUDGET_WARNING,
+            scopeKind,
+            scopeId,
+            tokenCount: remainingTokenCount,
+            tokenBudget: reflectorThresholdTokens,
+        });
+    }
+    return {
+        status: 'ran',
+        tokenCount,
+        remainingTokenCount,
+        overBudgetAfterReflection,
+        reflection,
+        result,
+    };
+}
+function uniqueObservationIds(ids) {
+    const seen = new Set();
+    const unique = [];
+    for (const id of ids) {
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        unique.push(id);
+    }
+    return unique;
+}
+function descendantIds(id, childrenByParent) {
+    const descendants = [];
+    const visit = (parentId) => {
+        for (const child of childrenByParent.get(parentId) ?? []) {
+            descendants.push(child.id);
+            visit(child.id);
+        }
+    };
+    visit(id);
+    return descendants;
+}
+function hasAncestorIn(id, ids, activeById) {
+    let parentId = activeById.get(id)?.parentId ?? null;
+    while (parentId) {
+        if (ids.has(parentId))
+            return true;
+        parentId = activeById.get(parentId)?.parentId ?? null;
+    }
+    return false;
+}
+function isChildOnlyRemoval(id, ownActionIds, allSameKindActionIds, otherRemovalIds, activeById) {
+    const parentId = activeById.get(id)?.parentId;
+    if (!parentId)
+        return false;
+    if (hasAncestorIn(id, ownActionIds, activeById))
+        return false;
+    if (hasAncestorIn(id, allSameKindActionIds, activeById))
+        return true;
+    return !hasAncestorIn(id, otherRemovalIds, activeById);
+}
+function normalizeReplacementParentId(parentId, activeById, removedIds) {
+    if (parentId === undefined || parentId === null)
+        return parentId;
+    return activeById.has(parentId) && !removedIds.has(parentId) ? parentId : null;
+}
+function extractJsonObject(output) {
+    const start = output.indexOf('{');
+    const end = output.lastIndexOf('}');
+    if (start === -1 || end === -1 || end < start) {
+        throw new Error('Reflector output did not contain a JSON object');
+    }
+    return output.slice(start, end + 1);
+}
+function readStringArray(value, fieldName) {
+    if (!Array.isArray(value))
+        throw new Error(`Reflector field "${fieldName}" must be an array`);
+    const strings = [];
+    for (const item of value) {
+        if (typeof item !== 'string') {
+            throw new Error(`Reflector field "${fieldName}" must contain only strings`);
+        }
+        strings.push(item);
+    }
+    return strings;
+}
+function readMergeArray(value) {
+    if (!Array.isArray(value))
+        throw new Error('Reflector field "merge" must be an array');
+    return value.map(readMerge);
+}
+function readMerge(value, index) {
+    if (!isRecord(value))
+        throw new Error(`Reflector merge[${index}] must be an object`);
+    const supersedes = readStringArray(value.supersedes, `merge[${index}].supersedes`);
+    const marker = readMarker(value.marker, index);
+    if (typeof value.text !== 'string') {
+        throw new Error(`Reflector merge[${index}].text must be a string`);
+    }
+    const parentId = readOptionalParentId(value.parentId, index);
+    return {
+        supersedes,
+        marker,
+        text: value.text,
+        ...(parentId !== undefined && { parentId }),
+    };
+}
+function readMarker(value, index) {
+    if (typeof value !== 'string') {
+        throw new Error(`Reflector merge[${index}].marker must be a known observation marker`);
+    }
+    switch (value.toUpperCase()) {
+        case 'CRITICAL':
+            return 'critical';
+        case 'IMPORTANT':
+            return 'important';
+        case 'INFO':
+            return 'info';
+        case 'COMPLETION':
+            return 'completion';
+        default:
+            throw new Error(`Reflector merge[${index}].marker must be a known observation marker`);
+    }
+}
+function readOptionalParentId(value, index) {
+    if (value === undefined)
+        return undefined;
+    if (value === null || typeof value === 'string')
+        return value;
+    throw new Error(`Reflector merge[${index}].parentId must be a string or null`);
+}
+function withCreatedAt(reflection, now) {
+    return {
+        drop: reflection.drop,
+        merge: reflection.merge.map((merge, index) => ({
+            ...merge,
+            createdAt: merge.createdAt ?? new Date(now.getTime() + index),
+        })),
+    };
+}
+function countObservationTokens(entries, tokenCounter) {
+    return entries.reduce((total, entry) => total + observationTokenCount(entry, tokenCounter), 0);
+}
+function observationTokenCount(entry, tokenCounter) {
+    if (Number.isFinite(entry.tokenCount) && entry.tokenCount > 0)
+        return entry.tokenCount;
+    return tokenCounter(entry.text);
+}
+function compareEntries(a, b) {
+    const timeDiff = a.createdAt.getTime() - b.createdAt.getTime();
+    if (timeDiff !== 0)
+        return timeDiff;
+    return a.id.localeCompare(b.id);
+}
+function renderReflectionBullet(entry, indent = '') {
+    return `${indent}* [${entry.id}] ${MARKER_LABELS[entry.marker]} ${entry.createdAt.toISOString()} ${entry.text}`;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=observation-log-reflector.js.map

package/dist/runtime/observation-log-reflector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-log-reflector.js","sourceRoot":"","sources":["../../src/runtime/observation-log-reflector.ts"],"names":[],"mappings":"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"}

package/dist/runtime/observation-log-renderer.d.ts

@@ -0,0 +1,6 @@
+import type { ObservationLogEntry, TokenCounter } from '../types/sdk/observation-log';
+export interface RenderObservationLogOptions {
+    renderTokenBudget?: number;
+    tokenCounter?: TokenCounter;
+}
+export declare function renderObservationLog(entries: ObservationLogEntry[], options?: RenderObservationLogOptions): string | null;