@goondan/openharness-base 0.0.1-alpha1

package/README.md

@@ -0,0 +1,11 @@
+# @goondan/openharness-base
+
+OpenHarness에 바로 붙일 수 있는 reference tool, extension, manifest 번들을 제공합니다.
+
+## Install
+
+```bash
+npm install @goondan/openharness-base
+```
+
+manifest 산출물과 기본 확장 정책은 [`packages/base/AGENTS.md`](./AGENTS.md)를 참고하세요.

package/dist/extensions/compaction.d.ts

@@ -0,0 +1,12 @@
+import type { ExtensionApi } from '../types.js';
+export interface CompactionExtensionConfig {
+    maxMessages?: number;
+    maxCharacters?: number;
+    retainLastMessages?: number;
+    mode?: 'remove' | 'truncate';
+    appendSummary?: boolean;
+    summaryPrefix?: string;
+}
+export declare function registerCompactionExtension(api: ExtensionApi, config?: CompactionExtensionConfig): void;
+export declare function register(api: ExtensionApi, config?: CompactionExtensionConfig): void;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/extensions/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/extensions/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwKD,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,YAAY,EACjB,MAAM,CAAC,EAAE,yBAAyB,GACjC,IAAI,CA6BN;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAEpF"}

package/dist/extensions/compaction.js

@@ -0,0 +1,162 @@
+import { createId, estimateMessageLength } from '../utils.js';
+import { normalizeRemovalTargets } from './message-integrity.js';
+const DEFAULT_CONFIG = {
+    maxMessages: 40,
+    maxCharacters: 12_000,
+    retainLastMessages: 8,
+    mode: 'remove',
+    appendSummary: true,
+    summaryPrefix: '[message-compaction]',
+};
+function isPinned(message) {
+    return message.metadata.pinned === true;
+}
+function createSummaryMessage(config, result) {
+    const summaryText = `${config.summaryPrefix} mode=${result.mode} removed=${result.removedCount} chars=${result.removedCharacters}`;
+    return {
+        id: createId('msg'),
+        data: {
+            role: 'user',
+            content: summaryText,
+        },
+        metadata: {
+            'compaction.summary': true,
+            'compaction.mode': result.mode,
+            'compaction.removedCount': result.removedCount,
+            'compaction.removedCharacters': result.removedCharacters,
+        },
+        createdAt: new Date(),
+        source: {
+            type: 'extension',
+            extensionName: 'message-compaction',
+        },
+    };
+}
+function emitEvents(ctx, events) {
+    for (const event of events) {
+        ctx.emitMessageEvent(event);
+    }
+}
+function compactByRemoval(messages, config) {
+    const candidateRemovedIds = new Set();
+    const protectedIds = new Set();
+    const keepFrom = Math.max(0, messages.length - config.retainLastMessages);
+    for (let index = keepFrom; index < messages.length; index += 1) {
+        const protectedMessage = messages[index];
+        if (!protectedMessage) {
+            continue;
+        }
+        protectedIds.add(protectedMessage.id);
+    }
+    let remainingCount = messages.length;
+    let remainingCharacters = messages.reduce((sum, message) => sum + estimateMessageLength(message), 0);
+    for (const message of messages) {
+        const overMessageLimit = remainingCount > config.maxMessages;
+        const overCharacterLimit = remainingCharacters > config.maxCharacters;
+        if (!overMessageLimit && !overCharacterLimit) {
+            break;
+        }
+        if (protectedIds.has(message.id) || isPinned(message)) {
+            continue;
+        }
+        const messageSize = estimateMessageLength(message);
+        remainingCount -= 1;
+        remainingCharacters -= messageSize;
+        candidateRemovedIds.add(message.id);
+    }
+    const finalRemovedIds = normalizeRemovalTargets(messages, candidateRemovedIds);
+    const events = [];
+    let finalRemainingCount = 0;
+    let finalRemainingCharacters = 0;
+    let finalRemovedCount = 0;
+    let finalRemovedCharacters = 0;
+    for (const message of messages) {
+        const messageSize = estimateMessageLength(message);
+        if (finalRemovedIds.has(message.id)) {
+            finalRemovedCount += 1;
+            finalRemovedCharacters += messageSize;
+            events.push({
+                type: 'remove',
+                targetId: message.id,
+            });
+            continue;
+        }
+        finalRemainingCount += 1;
+        finalRemainingCharacters += messageSize;
+    }
+    const overflow = finalRemainingCount > config.maxMessages || finalRemainingCharacters > config.maxCharacters;
+    return {
+        events,
+        result: {
+            mode: 'remove',
+            removedCount: finalRemovedCount,
+            removedCharacters: finalRemovedCharacters,
+        },
+        overflow,
+    };
+}
+function compactByTruncate() {
+    return {
+        events: [{ type: 'truncate' }],
+        result: {
+            mode: 'truncate',
+            removedCount: 0,
+            removedCharacters: 0,
+        },
+    };
+}
+function shouldCompact(messages, config) {
+    if (messages.length > config.maxMessages) {
+        return true;
+    }
+    const totalCharacters = messages.reduce((sum, message) => sum + estimateMessageLength(message), 0);
+    return totalCharacters > config.maxCharacters;
+}
+function mergeConfig(config) {
+    return {
+        maxMessages: config?.maxMessages ?? DEFAULT_CONFIG.maxMessages,
+        maxCharacters: config?.maxCharacters ?? DEFAULT_CONFIG.maxCharacters,
+        retainLastMessages: config?.retainLastMessages ?? DEFAULT_CONFIG.retainLastMessages,
+        mode: config?.mode ?? DEFAULT_CONFIG.mode,
+        appendSummary: config?.appendSummary ?? DEFAULT_CONFIG.appendSummary,
+        summaryPrefix: config?.summaryPrefix ?? DEFAULT_CONFIG.summaryPrefix,
+    };
+}
+function maybeAppendSummary(events, config, result) {
+    if (!config.appendSummary) {
+        return;
+    }
+    events.push({
+        type: 'append',
+        message: createSummaryMessage(config, result),
+    });
+}
+export function registerCompactionExtension(api, config) {
+    const settings = mergeConfig(config);
+    api.pipeline.register('turn', async (ctx) => {
+        const messages = ctx.conversationState.nextMessages;
+        if (!shouldCompact(messages, settings)) {
+            return ctx.next();
+        }
+        if (settings.mode === 'truncate') {
+            const { events, result } = compactByTruncate();
+            maybeAppendSummary(events, settings, result);
+            emitEvents(ctx, events);
+            return ctx.next();
+        }
+        const removal = compactByRemoval(messages, settings);
+        if (removal.overflow) {
+            const truncate = compactByTruncate();
+            maybeAppendSummary(truncate.events, settings, truncate.result);
+            emitEvents(ctx, truncate.events);
+            return ctx.next();
+        }
+        maybeAppendSummary(removal.events, settings, removal.result);
+        emitEvents(ctx, removal.events);
+        return ctx.next();
+    });
+}
+export function register(api, config) {
+    registerCompactionExtension(api, config);
+}
+//# sourceMappingURL=compaction.js.map

package/dist/extensions/compaction.js.map

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

package/dist/extensions/context-message.d.ts

@@ -0,0 +1,9 @@
+import type { ExtensionApi } from '../types.js';
+export interface ContextMessageExtensionConfig {
+    includeAgentPrompt?: boolean;
+    includeInboundContext?: boolean;
+    includeRouteSummary?: boolean;
+    includeInboundInput?: boolean;
+}
+export declare function register(api: ExtensionApi, rawConfig?: unknown): void;
+//# sourceMappingURL=context-message.d.ts.map

package/dist/extensions/context-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-message.d.ts","sourceRoot":"","sources":["../../src/extensions/context-message.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAA6E,MAAM,aAAa,CAAC;AAmC3H,MAAM,WAAW,6BAA6B;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAgiBD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAOrE"}

package/dist/extensions/context-message.js

@@ -0,0 +1,451 @@
+import { createHash } from 'node:crypto';
+import { createId, isJsonObject } from '../utils.js';
+const EXTENSION_NAME = 'context-message';
+const EXTENSION_EVENTS_METADATA_KEY = 'extension.events';
+const CONTEXT_MESSAGE_MARKER_KEY = '__goondanContextMessage';
+const INBOUND_MESSAGE_METADATA_KEY = '__goondanInbound';
+const DEFAULT_CONFIG = {
+    includeAgentPrompt: true,
+    includeInboundContext: false,
+    includeRouteSummary: false,
+    includeInboundInput: true,
+};
+function readConfig(raw) {
+    if (!isJsonObject(raw)) {
+        return { ...DEFAULT_CONFIG };
+    }
+    const config = { ...DEFAULT_CONFIG };
+    if (typeof raw.includeAgentPrompt === 'boolean') {
+        config.includeAgentPrompt = raw.includeAgentPrompt;
+    }
+    if (typeof raw.includeInboundContext === 'boolean') {
+        config.includeInboundContext = raw.includeInboundContext;
+    }
+    if (typeof raw.includeRouteSummary === 'boolean') {
+        config.includeRouteSummary = raw.includeRouteSummary;
+    }
+    if (typeof raw.includeInboundInput === 'boolean') {
+        config.includeInboundInput = raw.includeInboundInput;
+    }
+    return config;
+}
+function createPromptHash(input) {
+    return createHash('sha256').update(`${input.role}\n${input.content}`).digest('hex');
+}
+function readPromptHashMarker(message) {
+    const marker = readContextMessageMarker(message);
+    return marker?.promptHash;
+}
+function readContextMessageMarker(message) {
+    if (!isJsonObject(message.metadata)) {
+        return undefined;
+    }
+    const rawMarker = message.metadata[CONTEXT_MESSAGE_MARKER_KEY];
+    if (!isJsonObject(rawMarker)) {
+        return undefined;
+    }
+    const promptHash = rawMarker.promptHash;
+    if (typeof promptHash !== 'string' || promptHash.length === 0) {
+        return undefined;
+    }
+    const marker = {
+        promptHash,
+    };
+    if (rawMarker.role === 'system' || rawMarker.role === 'user') {
+        marker.role = rawMarker.role;
+    }
+    if (Array.isArray(rawMarker.segmentIds)) {
+        marker.segmentIds = rawMarker.segmentIds
+            .filter((segmentId) => typeof segmentId === 'string' && segmentId.length > 0);
+    }
+    return marker;
+}
+function markerIncludesSegment(marker, segmentId) {
+    if (!marker || !Array.isArray(marker.segmentIds)) {
+        return false;
+    }
+    return marker.segmentIds.includes(segmentId);
+}
+function hasPromptHashMarker(messages, promptHash, role, content) {
+    for (const message of messages) {
+        const existingHash = readPromptHashMarker(message);
+        if (existingHash === promptHash) {
+            return true;
+        }
+        if (message.source.type === 'extension'
+            && message.source.extensionName === EXTENSION_NAME
+            && message.data.role === role
+            && message.data.content === content) {
+            return true;
+        }
+    }
+    return false;
+}
+function createMessageMarker(promptHash, role, segmentIds) {
+    const marker = {
+        promptHash,
+        role,
+        segmentIds,
+    };
+    return marker;
+}
+function createContextMessage(promptHash, role, content, segmentIds) {
+    const metadata = {
+        [CONTEXT_MESSAGE_MARKER_KEY]: createMessageMarker(promptHash, role, segmentIds),
+    };
+    if (role === 'system') {
+        metadata.pinned = true;
+    }
+    return {
+        id: createId('msg'),
+        data: {
+            role,
+            content,
+        },
+        metadata,
+        createdAt: new Date(),
+        source: {
+            type: 'extension',
+            extensionName: EXTENSION_NAME,
+        },
+    };
+}
+function createInboundInputMetadata(ctx) {
+    const inbound = ctx.runtime.inbound;
+    const payload = {
+        sourceKind: inbound.kind,
+        sourceName: inbound.sourceName,
+        eventName: inbound.eventType,
+    };
+    if (typeof inbound.connectionName === 'string' && inbound.connectionName.length > 0) {
+        payload.connectionName = inbound.connectionName;
+    }
+    if (typeof inbound.conversationId === 'string' && inbound.conversationId.length > 0) {
+        payload.conversationId = inbound.conversationId;
+    }
+    if (inbound.kind === 'connector') {
+        if (Object.keys(inbound.properties).length > 0) {
+            payload.properties = inbound.properties;
+        }
+        if (ctx.inputEvent.rawPayload !== undefined) {
+            payload.rawPayload = ctx.inputEvent.rawPayload;
+        }
+    }
+    return {
+        [INBOUND_MESSAGE_METADATA_KEY]: payload,
+    };
+}
+function createInboundInputMessage(ctx, content) {
+    return {
+        id: createId('msg'),
+        data: {
+            role: 'user',
+            content,
+        },
+        metadata: createInboundInputMetadata(ctx),
+        createdAt: new Date(),
+        source: {
+            type: 'user',
+        },
+    };
+}
+function renderInboundParts(parts) {
+    const textBlocks = [];
+    const attachmentBlocks = [];
+    for (const part of parts) {
+        if (part.type === 'text') {
+            const trimmed = part.text.trim();
+            if (trimmed.length > 0) {
+                textBlocks.push(trimmed);
+            }
+            continue;
+        }
+        if (part.type === 'image') {
+            const label = typeof part.alt === 'string' && part.alt.trim().length > 0 ? ` ${part.alt.trim()}` : '';
+            attachmentBlocks.push(`[image]${label} ${part.url}`.trim());
+            continue;
+        }
+        const mimeLabel = typeof part.mimeType === 'string' && part.mimeType.trim().length > 0
+            ? ` (${part.mimeType.trim()})`
+            : '';
+        attachmentBlocks.push(`[file] ${part.name}${mimeLabel}: ${part.url}`);
+    }
+    return [...textBlocks, ...attachmentBlocks].join('\n\n').trim();
+}
+function appendRuntimeEvent(ctx, name, data = undefined) {
+    const entries = Array.isArray(ctx.metadata[EXTENSION_EVENTS_METADATA_KEY])
+        ? [...ctx.metadata[EXTENSION_EVENTS_METADATA_KEY]]
+        : [];
+    const entry = {
+        name,
+        actor: EXTENSION_NAME,
+        at: new Date().toISOString(),
+    };
+    if (data !== undefined && Object.keys(data).length > 0) {
+        entry.data = data;
+    }
+    entries.push(entry);
+    ctx.metadata[EXTENSION_EVENTS_METADATA_KEY] = entries;
+}
+function resolveAgentPrompt(metadata) {
+    const prompt = metadata.prompt;
+    if (!prompt) {
+        return null;
+    }
+    const inlinePrompt = typeof prompt.system === 'string' && prompt.system.trim().length > 0
+        ? prompt.system
+        : undefined;
+    if (!inlinePrompt) {
+        return null;
+    }
+    return inlinePrompt;
+}
+function stringOrUndefined(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return undefined;
+    }
+    return trimmed;
+}
+function resolveInboundContextSegment(ctx) {
+    const inbound = ctx.runtime.inbound;
+    const lines = [
+        '[runtime_inbound]',
+        `eventId=${inbound.eventId}`,
+        `eventType=${inbound.eventType}`,
+        `kind=${inbound.kind}`,
+        `sourceName=${inbound.sourceName}`,
+        `createdAt=${inbound.createdAt}`,
+    ];
+    if (typeof inbound.connectionName === 'string' && inbound.connectionName.length > 0) {
+        lines.push(`connectionName=${inbound.connectionName}`);
+    }
+    if (typeof inbound.conversationId === 'string' && inbound.conversationId.length > 0) {
+        lines.push(`conversationId=${inbound.conversationId}`);
+    }
+    if (Object.keys(inbound.properties).length > 0) {
+        lines.push(`properties=${JSON.stringify(inbound.properties)}`);
+    }
+    if (inbound.content.length > 0) {
+        lines.push(`content=${JSON.stringify(inbound.content)}`);
+    }
+    if (inbound.rawPayload !== undefined) {
+        lines.push(`rawPayload=${JSON.stringify(inbound.rawPayload)}`);
+    }
+    lines.push('[/runtime_inbound]');
+    return {
+        id: 'runtime.inbound',
+        role: 'user',
+        content: lines.join('\n'),
+    };
+}
+function resolveRouteSummarySegment(ctx) {
+    const inbound = ctx.runtime.inbound;
+    const inboundConversationId = stringOrUndefined(inbound.conversationId);
+    const lines = [
+        '[runtime_route]',
+        'precedence=inbound',
+        `senderKind=${inbound.kind}`,
+        `senderName=${inbound.sourceName}`,
+        `eventType=${inbound.eventType}`,
+        `eventId=${inbound.eventId}`,
+    ];
+    if (inboundConversationId) {
+        lines.push(`senderConversationId=${inboundConversationId}`);
+    }
+    lines.push('[/runtime_route]');
+    return {
+        id: 'runtime.route.summary',
+        role: 'user',
+        content: lines.join('\n'),
+    };
+}
+const SEGMENT_ORDER = [
+    'agent.prompt.system',
+    'runtime.inbound',
+    'runtime.route.summary',
+];
+function sortSegmentsByOrder(segments) {
+    const order = new Map();
+    SEGMENT_ORDER.forEach((id, index) => {
+        order.set(id, index);
+    });
+    return [...segments].sort((left, right) => {
+        const leftOrder = order.get(left.id) ?? Number.MAX_SAFE_INTEGER;
+        const rightOrder = order.get(right.id) ?? Number.MAX_SAFE_INTEGER;
+        if (leftOrder !== rightOrder) {
+            return leftOrder - rightOrder;
+        }
+        return left.id.localeCompare(right.id);
+    });
+}
+function resolveContextSegments(ctx, config) {
+    const resolutions = [];
+    const segments = [];
+    if (config.includeAgentPrompt) {
+        const system = resolveAgentPrompt({ prompt: ctx.runtime.agent.prompt });
+        if (system && system.trim().length > 0) {
+            segments.push({
+                id: 'agent.prompt.system',
+                role: 'system',
+                content: system,
+            });
+            resolutions.push({ id: 'agent.prompt.system', included: true });
+        }
+        else {
+            resolutions.push({ id: 'agent.prompt.system', included: false });
+        }
+    }
+    if (config.includeInboundContext) {
+        segments.push(resolveInboundContextSegment(ctx));
+        resolutions.push({ id: 'runtime.inbound', included: true });
+    }
+    if (config.includeRouteSummary && config.includeInboundContext) {
+        segments.push(resolveRouteSummarySegment(ctx));
+        resolutions.push({ id: 'runtime.route.summary', included: true });
+    }
+    return {
+        resolutions,
+        segments: sortSegmentsByOrder(segments),
+    };
+}
+function composeMessageGroups(segments) {
+    const groups = [];
+    for (const segment of segments) {
+        const last = groups[groups.length - 1];
+        if (last && last.role === segment.role) {
+            last.content = `${last.content}\n\n${segment.content}`;
+            last.segmentIds.push(segment.id);
+            continue;
+        }
+        groups.push({
+            role: segment.role,
+            content: segment.content,
+            segmentIds: [segment.id],
+        });
+    }
+    return groups;
+}
+async function emitContextMessages(ctx, config) {
+    const composed = resolveContextSegments(ctx, config);
+    for (const resolution of composed.resolutions) {
+        appendRuntimeEvent(ctx, 'context.segment.resolved', {
+            id: resolution.id,
+            included: resolution.included,
+        });
+    }
+    if (composed.segments.length === 0) {
+        appendRuntimeEvent(ctx, 'context.message.empty');
+        return;
+    }
+    const existingMessages = ctx.conversationState.nextMessages;
+    const groups = composeMessageGroups(composed.segments);
+    const desiredSystemGroup = groups.find((group) => group.role === 'system' && group.segmentIds.includes('agent.prompt.system'));
+    const desiredSystemHash = desiredSystemGroup
+        ? createPromptHash({ role: desiredSystemGroup.role, content: desiredSystemGroup.content })
+        : undefined;
+    const pendingGroups = [];
+    for (const group of groups) {
+        const promptHash = createPromptHash({ role: group.role, content: group.content });
+        if (hasPromptHashMarker(existingMessages, promptHash, group.role, group.content)) {
+            appendRuntimeEvent(ctx, 'context.message.duplicate', {
+                promptHash,
+                role: group.role,
+            });
+            continue;
+        }
+        pendingGroups.push({ group, promptHash });
+    }
+    let emittedContextMutation = false;
+    if (desiredSystemGroup && desiredSystemHash) {
+        const existingSystems = existingMessages
+            .filter((message) => message.data.role === 'system')
+            .map((message) => ({
+            message,
+            marker: readContextMessageMarker(message),
+        }));
+        if (existingSystems.length > 0) {
+            const preferred = existingSystems.find((entry) => entry.marker?.promptHash === desiredSystemHash)
+                ?? existingSystems.find((entry) => markerIncludesSegment(entry.marker, 'agent.prompt.system'))
+                ?? existingSystems[0];
+            if (preferred) {
+                const targetMessage = preferred.message;
+                const targetMarker = preferred.marker;
+                const targetMatchesDesired = targetMarker?.promptHash === desiredSystemHash
+                    || targetMessage.data.content === desiredSystemGroup.content;
+                if (!targetMatchesDesired) {
+                    ctx.emitMessageEvent({
+                        type: 'replace',
+                        targetId: targetMessage.id,
+                        message: createContextMessage(desiredSystemHash, 'system', desiredSystemGroup.content, desiredSystemGroup.segmentIds),
+                    });
+                    appendRuntimeEvent(ctx, 'context.message.replaced', {
+                        targetId: targetMessage.id,
+                        promptHash: desiredSystemHash,
+                        role: 'system',
+                        segmentIds: desiredSystemGroup.segmentIds,
+                    });
+                    emittedContextMutation = true;
+                }
+                for (const entry of existingSystems) {
+                    if (entry.message.id === targetMessage.id) {
+                        continue;
+                    }
+                    ctx.emitMessageEvent({
+                        type: 'remove',
+                        targetId: entry.message.id,
+                    });
+                    appendRuntimeEvent(ctx, 'context.message.removed', {
+                        targetId: entry.message.id,
+                        role: 'system',
+                    });
+                    emittedContextMutation = true;
+                }
+                const duplicateSystemIndex = pendingGroups.findIndex((pending) => pending.group.role === 'system' && pending.group.segmentIds.includes('agent.prompt.system'));
+                if (duplicateSystemIndex >= 0) {
+                    pendingGroups.splice(duplicateSystemIndex, 1);
+                }
+            }
+        }
+    }
+    for (const pending of pendingGroups) {
+        const group = pending.group;
+        ctx.emitMessageEvent({
+            type: 'append',
+            message: createContextMessage(pending.promptHash, group.role, group.content, group.segmentIds),
+        });
+        appendRuntimeEvent(ctx, 'context.message.appended', {
+            promptHash: pending.promptHash,
+            role: group.role,
+            segmentIds: group.segmentIds,
+        });
+        emittedContextMutation = true;
+    }
+    const renderedInboundInput = ctx.runtime.inbound.kind === 'connector'
+        ? renderInboundParts(ctx.runtime.inbound.content)
+        : '';
+    const inboundInput = renderedInboundInput.trim().length > 0
+        ? renderedInboundInput
+        : (typeof ctx.inputEvent.input === 'string' ? ctx.inputEvent.input : '');
+    if (config.includeInboundInput && inboundInput.trim().length > 0) {
+        ctx.emitMessageEvent({
+            type: 'append',
+            message: createInboundInputMessage(ctx, inboundInput),
+        });
+        appendRuntimeEvent(ctx, 'context.inbound.appended');
+    }
+    if (!emittedContextMutation) {
+        appendRuntimeEvent(ctx, 'context.message.empty');
+    }
+}
+export function register(api, rawConfig) {
+    const config = readConfig(rawConfig);
+    api.pipeline.register('turn', async (ctx) => {
+        await emitContextMessages(ctx, config);
+        return ctx.next();
+    });
+}
+//# sourceMappingURL=context-message.js.map