@roackb2/heddle 1.2.0 → 1.4.0

package/dist/src/core/chat/engine/turns/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,YAAY,EAAE,uBAAuB,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/core/chat/engine/turns/context/index.js

@@ -0,0 +1,2 @@
+export { ConversationTurnContextBuilder } from './turn-context-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/chat/engine/turns/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/core/chat/engine/turns/context/turn-context-builder.d.ts

@@ -0,0 +1,8 @@
+import type { ConversationTurnContext, PrepareConversationTurnContextArgs } from './types.js';
+/**
+ * Builds the concrete runtime context needed before a persisted turn can run.
+ */
+export declare class ConversationTurnContextBuilder {
+    static build(args: PrepareConversationTurnContextArgs): ConversationTurnContext;
+}
+//# sourceMappingURL=turn-context-builder.d.ts.map

package/dist/src/core/chat/engine/turns/context/turn-context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-context-builder.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/context/turn-context-builder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EAGvB,kCAAkC,EACnC,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,qBAAa,8BAA8B;IACzC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,kCAAkC,GAAG,uBAAuB;CA6BhF"}

package/dist/src/core/chat/engine/turns/context/turn-context-builder.js

@@ -0,0 +1,36 @@
+import { createDefaultAgentTools } from '../../../../../core/runtime/default-tools.js';
+import { FileChatSessionRepository } from '../../../../../core/chat/engine/sessions/repository/index.js';
+import { ConversationTurnRuntimeResolver } from '../runtime/index.js';
+/**
+ * Builds the concrete runtime context needed before a persisted turn can run.
+ */
+export class ConversationTurnContextBuilder {
+    static build(args) {
+        const sessions = new FileChatSessionRepository({ sessionStoragePath: args.sessionStoragePath }).list(true);
+        const session = sessions.find((candidate) => candidate.id === args.sessionId);
+        if (!session) {
+            throw new Error(`Chat session not found: ${args.sessionId}`);
+        }
+        const runtimeConfig = args;
+        const runtime = ConversationTurnRuntimeResolver.resolve({ config: runtimeConfig, session });
+        const toolContext = args;
+        const toolRuntime = runtime;
+        const tools = createDefaultAgentTools({
+            ...toolContext,
+            ...toolRuntime,
+        });
+        return {
+            sessions,
+            session,
+            runtime,
+            tools,
+            toolNames: tools.map((tool) => tool.name),
+            leaseOwner: args.leaseOwner ?? {
+                ownerKind: 'ask',
+                ownerId: `submit-${process.pid}`,
+                clientLabel: 'another Heddle client',
+            },
+        };
+    }
+}
+//# sourceMappingURL=turn-context-builder.js.map

package/dist/src/core/chat/engine/turns/context/turn-context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-context-builder.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/context/turn-context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAStE;;GAEG;AACH,MAAM,OAAO,8BAA8B;IACzC,MAAM,CAAC,KAAK,CAAC,IAAwC;QACnD,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3G,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,aAAa,GAAkC,IAAI,CAAC;QAC1D,MAAM,OAAO,GAAG,+BAA+B,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5F,MAAM,WAAW,GAAoC,IAAI,CAAC;QAC1D,MAAM,WAAW,GAAoC,OAAO,CAAC;QAC7D,MAAM,KAAK,GAAG,uBAAuB,CAAC;YACpC,GAAG,WAAW;YACd,GAAG,WAAW;SACf,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ;YACR,OAAO;YACP,OAAO;YACP,KAAK;YACL,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;YACzC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI;gBAC7B,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,UAAU,OAAO,CAAC,GAAG,EAAE;gBAChC,WAAW,EAAE,uBAAuB;aACrC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/chat/engine/turns/context/types.d.ts

@@ -0,0 +1,28 @@
+import type { ToolDefinition } from '../../../../../core/types.js';
+import type { ChatSession } from '../../../../../core/chat/types.js';
+import type { ChatSessionLeaseOwner } from '../../../../../core/chat/engine/sessions/leases/index.js';
+import type { ChatTurnRuntime } from '../runtime/index.js';
+export type PrepareConversationTurnContextArgs = {
+    workspaceRoot: string;
+    stateRoot: string;
+    sessionStoragePath: string;
+    sessionId: string;
+    apiKey?: string;
+    preferApiKey?: boolean;
+    credentialStorePath?: string;
+    systemContext?: string;
+    searchIgnoreDirs?: string[];
+    includePlanTool?: boolean;
+    leaseOwner?: ChatSessionLeaseOwner;
+};
+export type ConversationTurnToolContextArgs = Pick<PrepareConversationTurnContextArgs, 'workspaceRoot' | 'credentialStorePath' | 'searchIgnoreDirs' | 'includePlanTool'>;
+export type ConversationTurnToolRuntimeArgs = Pick<ChatTurnRuntime, 'model' | 'apiKey' | 'providerCredentialSource' | 'memoryDir'>;
+export type ConversationTurnContext = {
+    sessions: ChatSession[];
+    session: ChatSession;
+    runtime: ChatTurnRuntime;
+    tools: ToolDefinition[];
+    toolNames: string[];
+    leaseOwner: ChatSessionLeaseOwner;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/chat/engine/turns/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/context/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,kCAAkC,GAAG;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,IAAI,CAChD,kCAAkC,EAClC,eAAe,GAAG,qBAAqB,GAAG,kBAAkB,GAAG,iBAAiB,CACjF,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,IAAI,CAChD,eAAe,EACf,OAAO,GAAG,QAAQ,GAAG,0BAA0B,GAAG,WAAW,CAC9D,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,qBAAqB,CAAC;CACnC,CAAC"}

package/dist/src/core/chat/engine/turns/context/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/chat/engine/turns/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/context/types.ts"],"names":[],"mappings":""}

package/dist/src/core/chat/engine/turns/failure/failure-message-formatter.d.ts

@@ -0,0 +1,10 @@
+import type { ConversationTurnFailureHintOptions } from './types.js';
+/**
+ * Formats model/provider failures with turn-specific recovery hints.
+ */
+export declare class ConversationTurnFailureMessages {
+    static format(message: string, options: ConversationTurnFailureHintOptions): string;
+    private static looksLikeAnthropicInputRateLimit;
+    private static looksLikeOpenAiQuotaError;
+}
+//# sourceMappingURL=failure-message-formatter.d.ts.map

package/dist/src/core/chat/engine/turns/failure/failure-message-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-message-formatter.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/failure/failure-message-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAErE;;GAEG;AACH,qBAAa,+BAA+B;IAC1C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kCAAkC,GAAG,MAAM;IAgBnF,OAAO,CAAC,MAAM,CAAC,gCAAgC;IAS/C,OAAO,CAAC,MAAM,CAAC,yBAAyB;CAOzC"}

package/dist/src/core/chat/engine/turns/failure/failure-message-formatter.js

@@ -0,0 +1,29 @@
+/**
+ * Formats model/provider failures with turn-specific recovery hints.
+ */
+export class ConversationTurnFailureMessages {
+    static format(message, options) {
+        if (ConversationTurnFailureMessages.looksLikeAnthropicInputRateLimit(message)) {
+            const sizeHint = typeof options.estimatedHistoryTokens === 'number' ?
+                ` Current session history is estimated at about ${options.estimatedHistoryTokens.toLocaleString()} tokens before the next request.`
+                : '';
+            return `${message}\n\nThis likely failed because the current prompt plus session history are too large for ${options.model}'s input-token-per-minute limit.${sizeHint} Try /compact, /clear, or /session new, then retry.`;
+        }
+        if (ConversationTurnFailureMessages.looksLikeOpenAiQuotaError(message)) {
+            return `${message}\n\nThis looks like an OpenAI quota or billing limit for the active key, not a transient prompt-size issue. Switch providers or check the OpenAI account quota and billing state.`;
+        }
+        return message;
+    }
+    static looksLikeAnthropicInputRateLimit(message) {
+        const normalized = message.toLowerCase();
+        return (normalized.includes('input tokens per minute')
+            || (normalized.includes('reduce the prompt length') && normalized.includes('maximum tokens requested'))
+            || (normalized.includes('rate_limit_error') && normalized.includes('tokens per minute')));
+    }
+    static looksLikeOpenAiQuotaError(message) {
+        const normalized = message.toLowerCase();
+        return (normalized.includes('exceeded your current quota')
+            || (normalized.includes('billing details') && normalized.includes('quota')));
+    }
+}
+//# sourceMappingURL=failure-message-formatter.js.map

package/dist/src/core/chat/engine/turns/failure/failure-message-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-message-formatter.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/failure/failure-message-formatter.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,+BAA+B;IAC1C,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,OAA2C;QACxE,IAAI,+BAA+B,CAAC,gCAAgC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9E,MAAM,QAAQ,GACZ,OAAO,OAAO,CAAC,sBAAsB,KAAK,QAAQ,CAAC,CAAC;gBAClD,kDAAkD,OAAO,CAAC,sBAAsB,CAAC,cAAc,EAAE,kCAAkC;gBACrI,CAAC,CAAC,EAAE,CAAC;YACP,OAAO,GAAG,OAAO,4FAA4F,OAAO,CAAC,KAAK,mCAAmC,QAAQ,qDAAqD,CAAC;QAC7N,CAAC;QAED,IAAI,+BAA+B,CAAC,yBAAyB,CAAC,OAAO,CAAC,EAAE,CAAC;YACvE,OAAO,GAAG,OAAO,mLAAmL,CAAC;QACvM,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,MAAM,CAAC,gCAAgC,CAAC,OAAe;QAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACzC,OAAO,CACL,UAAU,CAAC,QAAQ,CAAC,yBAAyB,CAAC;eAC3C,CAAC,UAAU,CAAC,QAAQ,CAAC,0BAA0B,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;eACpG,CAAC,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CACzF,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,yBAAyB,CAAC,OAAe;QACtD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACzC,OAAO,CACL,UAAU,CAAC,QAAQ,CAAC,6BAA6B,CAAC;eAC/C,CAAC,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAC5E,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/chat/engine/turns/failure/index.d.ts

@@ -0,0 +1,3 @@
+export { ConversationTurnFailureMessages } from './failure-message-formatter.js';
+export type { ConversationTurnFailureHintOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/chat/engine/turns/failure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/failure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AACjF,YAAY,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/core/chat/engine/turns/failure/index.js

@@ -0,0 +1,2 @@
+export { ConversationTurnFailureMessages } from './failure-message-formatter.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/chat/engine/turns/failure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/failure/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/src/core/chat/engine/turns/failure/types.d.ts

@@ -0,0 +1,5 @@
+export type ConversationTurnFailureHintOptions = {
+    model: string;
+    estimatedHistoryTokens?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/chat/engine/turns/failure/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/failure/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kCAAkC,GAAG;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC"}

package/dist/src/core/chat/engine/turns/failure/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/chat/engine/turns/failure/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/failure/types.ts"],"names":[],"mappings":""}

package/dist/src/core/chat/engine/turns/host/host-normalizer.d.ts

@@ -0,0 +1,9 @@
+import type { ConversationEngineHost } from '../../../../../core/chat/engine/types.js';
+import type { ConversationEngineHostAdapterResult } from './types.js';
+/**
+ * Normalizes host-facing engine callbacks into turn-runtime ports.
+ */
+export declare class ConversationEngineHostNormalizer {
+    static normalize(host?: ConversationEngineHost): ConversationEngineHostAdapterResult;
+}
+//# sourceMappingURL=host-normalizer.d.ts.map

package/dist/src/core/chat/engine/turns/host/host-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-normalizer.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/host/host-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAM1E,OAAO,KAAK,EAAoB,mCAAmC,EAAE,MAAM,YAAY,CAAC;AAExF;;GAEG;AACH,qBAAa,gCAAgC;IAC3C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,mCAAmC;CA6CrF"}

package/dist/src/core/chat/engine/turns/host/host-normalizer.js

@@ -0,0 +1,51 @@
+import { projectAgentLoopEventToConversationActivities, projectCompactionStatusToConversationActivities, projectTraceEventToConversationActivities, } from '../../../../../core/observability/conversation-activity.js';
+/**
+ * Normalizes host-facing engine callbacks into turn-runtime ports.
+ */
+export class ConversationEngineHostNormalizer {
+    static normalize(host) {
+        const onActivity = host?.events?.onActivity;
+        const onAgentLoopEvent = host?.events?.onAgentLoopEvent;
+        const onTraceEvent = host?.trace?.onEvent;
+        const requestToolApproval = host?.approvals?.requestToolApproval;
+        const turnHost = {
+            onAgentLoopEvent: (event) => {
+                onAgentLoopEvent?.(event);
+                for (const activity of projectAgentLoopEventToConversationActivities(event)) {
+                    onActivity?.(activity);
+                }
+            },
+            approveToolCall: requestToolApproval
+                ? ((call, tool) => requestToolApproval({ call, tool }))
+                : undefined,
+            onCompactionStatus: (event, phase) => {
+                host?.compaction?.onStatus?.(event);
+                if (phase === 'preflight') {
+                    host?.compaction?.onPreflightCompactionStatus?.(event);
+                }
+                else {
+                    host?.compaction?.onFinalCompactionStatus?.(event);
+                }
+                for (const activity of projectCompactionStatusToConversationActivities(event)) {
+                    onActivity?.(activity);
+                }
+            },
+        };
+        return {
+            turnHost,
+            onAssistantStream: host?.assistant?.onStream
+                ?? (host?.assistant?.onText
+                    ? ((update) => {
+                        host.assistant?.onText?.(update.text);
+                    })
+                    : undefined),
+            onTraceEvent: (event) => {
+                onTraceEvent?.(event);
+                for (const activity of projectTraceEventToConversationActivities(event)) {
+                    onActivity?.(activity);
+                }
+            },
+        };
+    }
+}
+//# sourceMappingURL=host-normalizer.js.map

package/dist/src/core/chat/engine/turns/host/host-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-normalizer.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/host/host-normalizer.ts"],"names":[],"mappings":"AACA,OAAO,EACL,6CAA6C,EAC7C,+CAA+C,EAC/C,yCAAyC,GAC1C,MAAM,+CAA+C,CAAC;AAGvD;;GAEG;AACH,MAAM,OAAO,gCAAgC;IAC3C,MAAM,CAAC,SAAS,CAAC,IAA6B;QAC5C,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC;QAC5C,MAAM,gBAAgB,GAAG,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC;QACxD,MAAM,YAAY,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;QAC1C,MAAM,mBAAmB,GAAG,IAAI,EAAE,SAAS,EAAE,mBAAmB,CAAC;QAEjE,MAAM,QAAQ,GAAqB;YACjC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC1B,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC1B,KAAK,MAAM,QAAQ,IAAI,6CAA6C,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5E,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;YACD,eAAe,EAAE,mBAAmB;gBAClC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvD,CAAC,CAAC,SAAS;YACb,kBAAkB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBACnC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;gBACpC,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;oBAC1B,IAAI,EAAE,UAAU,EAAE,2BAA2B,EAAE,CAAC,KAAK,CAAC,CAAC;gBACzD,CAAC;qBAAM,CAAC;oBACN,IAAI,EAAE,UAAU,EAAE,uBAAuB,EAAE,CAAC,KAAK,CAAC,CAAC;gBACrD,CAAC;gBACD,KAAK,MAAM,QAAQ,IAAI,+CAA+C,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC9E,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;SACF,CAAC;QAEF,OAAO;YACL,QAAQ;YACR,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ;mBACvC,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM;oBACzB,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE;wBACV,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACxC,CAAC,CAAC;oBACJ,CAAC,CAAC,SAAS,CAAC;YAChB,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;gBACtB,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC;gBACtB,KAAK,MAAM,QAAQ,IAAI,yCAAyC,CAAC,KAAK,CAAC,EAAE,CAAC;oBACxE,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/chat/engine/turns/host/index.d.ts

@@ -0,0 +1,3 @@
+export { ConversationEngineHostNormalizer } from './host-normalizer.js';
+export type { ChatTurnCompactionPhase, ChatTurnCompactionStatus, ChatTurnHostPort, ConversationEngineHostAdapterResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/chat/engine/turns/host/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,mCAAmC,GACpC,MAAM,YAAY,CAAC"}

package/dist/src/core/chat/engine/turns/host/index.js

@@ -0,0 +1,2 @@
+export { ConversationEngineHostNormalizer } from './host-normalizer.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/chat/engine/turns/host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/core/chat/engine/turns/host/types.d.ts

@@ -0,0 +1,17 @@
+import type { RunAgentLoopOptions } from '../../../../../core/runtime/agent-loop.js';
+import type { AgentLoopEvent } from '../../../../../core/runtime/events.js';
+import type { PersistChatTurnCompactionStatus } from '../persistence/index.js';
+import type { ChatTurnPreflightCompactionStatus } from '../preflight/index.js';
+export type ChatTurnCompactionPhase = 'preflight' | 'final';
+export type ChatTurnCompactionStatus = ChatTurnPreflightCompactionStatus | PersistChatTurnCompactionStatus;
+export type ChatTurnHostPort = {
+    onAgentLoopEvent?: (event: AgentLoopEvent) => void;
+    approveToolCall?: RunAgentLoopOptions['approveToolCall'];
+    onCompactionStatus?: (event: ChatTurnCompactionStatus, phase: ChatTurnCompactionPhase) => void;
+};
+export type ConversationEngineHostAdapterResult = {
+    turnHost?: ChatTurnHostPort;
+    onAssistantStream?: RunAgentLoopOptions['onAssistantStream'];
+    onTraceEvent?: RunAgentLoopOptions['onTraceEvent'];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/chat/engine/turns/host/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/host/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,OAAO,CAAC;AAE5D,MAAM,MAAM,wBAAwB,GAAG,iCAAiC,GAAG,+BAA+B,CAAC;AAE3G,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACnD,eAAe,CAAC,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACzD,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAChG,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,mBAAmB,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,mBAAmB,CAAC,cAAc,CAAC,CAAC;CACpD,CAAC"}

package/dist/src/core/chat/engine/turns/host/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/chat/engine/turns/host/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/host/types.ts"],"names":[],"mappings":""}

package/dist/src/core/chat/engine/turns/memory/index.d.ts

@@ -0,0 +1,3 @@
+export { ConversationTurnMemoryMaintenance } from './turn-memory-maintenance.js';
+export type { RunInlineTurnMemoryMaintenanceArgs, ScheduleBackgroundTurnMemoryMaintenanceArgs, TurnMemoryMaintenanceRuntimeInput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/chat/engine/turns/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AACjF,YAAY,EACV,kCAAkC,EAClC,2CAA2C,EAC3C,iCAAiC,GAClC,MAAM,YAAY,CAAC"}

package/dist/src/core/chat/engine/turns/memory/index.js

@@ -0,0 +1,2 @@
+export { ConversationTurnMemoryMaintenance } from './turn-memory-maintenance.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/chat/engine/turns/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/src/core/chat/engine/turns/memory/turn-memory-maintenance.d.ts

@@ -0,0 +1,17 @@
+import type { AgentLoopResult } from '../../../../../core/runtime/agent-loop.js';
+import type { TraceEvent } from '../../../../../core/types.js';
+import type { AppendTurnMemoryMaintenanceEventsArgs, RunInlineTurnMemoryMaintenanceArgs, ScheduleBackgroundTurnMemoryMaintenanceArgs } from './types.js';
+/**
+ * Runs and records memory maintenance associated with a completed turn.
+ */
+export declare class ConversationTurnMemoryMaintenance {
+    static runInline(args: RunInlineTurnMemoryMaintenanceArgs): Promise<AgentLoopResult>;
+    static scheduleBackground(args: ScheduleBackgroundTurnMemoryMaintenanceArgs): void;
+    static runBackground(args: ScheduleBackgroundTurnMemoryMaintenanceArgs): Promise<void>;
+    static appendEvents(args: AppendTurnMemoryMaintenanceEventsArgs): void;
+    static appendAgentLoopTrace(result: AgentLoopResult, events: TraceEvent[]): AgentLoopResult;
+    private static readTraceEvents;
+    private static createFailureEvent;
+    private static nextTraceStep;
+}
+//# sourceMappingURL=turn-memory-maintenance.d.ts.map

package/dist/src/core/chat/engine/turns/memory/turn-memory-maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-memory-maintenance.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/memory/turn-memory-maintenance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKlD,OAAO,KAAK,EACV,qCAAqC,EAErC,kCAAkC,EAClC,2CAA2C,EAC5C,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,iCAAiC;WAC/B,SAAS,CAAC,IAAI,EAAE,kCAAkC,GAAG,OAAO,CAAC,eAAe,CAAC;IAsB1F,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,2CAA2C;WAc9D,aAAa,CAAC,IAAI,EAAE,2CAA2C;IAuB5E,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,qCAAqC;IA0B/D,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe;IAsB3F,OAAO,CAAC,MAAM,CAAC,eAAe;IAS9B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAcjC,OAAO,CAAC,MAAM,CAAC,aAAa;CAG7B"}

package/dist/src/core/chat/engine/turns/memory/turn-memory-maintenance.js

@@ -0,0 +1,126 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { runMaintenanceForRecordedCandidates } from '../../../../../core/memory/maintenance-integration.js';
+import { summarizeTrace } from '../../../../../core/observability/trace-summarizers.js';
+import { ChatSessionRecords } from '../../../../../core/chat/engine/sessions/records/index.js';
+import { FileChatSessionRepository } from '../../../../../core/chat/engine/sessions/repository/index.js';
+/**
+ * Runs and records memory maintenance associated with a completed turn.
+ */
+export class ConversationTurnMemoryMaintenance {
+    static async runInline(args) {
+        const maintenanceInput = {
+            memoryRoot: args.memoryRoot,
+            llm: args.llm,
+            source: args.source,
+            trace: args.result.trace,
+        };
+        const maintenance = await runMaintenanceForRecordedCandidates({
+            ...maintenanceInput,
+            maxSteps: 20,
+            onTraceEvent: (event) => args.onEvent?.({
+                type: 'trace',
+                runId: args.result.state.runId,
+                event,
+                timestamp: new Date().toISOString(),
+            }),
+        });
+        return ConversationTurnMemoryMaintenance.appendAgentLoopTrace(args.result, maintenance.events);
+    }
+    static scheduleBackground(args) {
+        void ConversationTurnMemoryMaintenance.runBackground(args).catch((error) => {
+            args.onEvent?.({
+                type: 'trace',
+                runId: args.runId,
+                event: ConversationTurnMemoryMaintenance.createFailureEvent({
+                    error,
+                    trace: args.trace,
+                }),
+                timestamp: new Date().toISOString(),
+            });
+        });
+    }
+    static async runBackground(args) {
+        const maintenanceInput = args;
+        const maintenance = await runMaintenanceForRecordedCandidates({
+            ...maintenanceInput,
+            maxSteps: 20,
+            onTraceEvent: (event) => args.onEvent?.({
+                type: 'trace',
+                runId: args.runId,
+                event,
+                timestamp: new Date().toISOString(),
+            }),
+        });
+        if (maintenance.events.length === 0) {
+            return;
+        }
+        ConversationTurnMemoryMaintenance.appendEvents({
+            ...args,
+            events: maintenance.events,
+        });
+    }
+    static appendEvents(args) {
+        const nextTrace = [...ConversationTurnMemoryMaintenance.readTraceEvents(args.traceFile), ...args.events];
+        writeFileSync(args.traceFile, `${JSON.stringify(nextTrace, null, 2)}\n`, 'utf8');
+        const repository = new FileChatSessionRepository({ sessionStoragePath: args.sessionStoragePath });
+        const sessions = repository.list(true);
+        const nextSessions = sessions.map((session) => {
+            if (session.id !== args.sessionId) {
+                return session;
+            }
+            return ChatSessionRecords.touch({
+                ...session,
+                turns: session.turns.map((turn, index) => index === session.turns.length - 1
+                    ? {
+                        ...turn,
+                        events: summarizeTrace(nextTrace),
+                    }
+                    : turn),
+            });
+        });
+        repository.save(nextSessions);
+    }
+    static appendAgentLoopTrace(result, events) {
+        if (events.length === 0) {
+            return {
+                ...result,
+                state: {
+                    ...result.state,
+                    trace: result.trace,
+                },
+            };
+        }
+        const trace = [...result.trace, ...events];
+        return {
+            ...result,
+            trace,
+            state: {
+                ...result.state,
+                trace,
+            },
+        };
+    }
+    static readTraceEvents(path) {
+        try {
+            const parsed = JSON.parse(readFileSync(path, 'utf8'));
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    static createFailureEvent(args) {
+        return {
+            type: 'memory.maintenance_failed',
+            runId: `memory-run-${Date.now()}`,
+            error: args.error instanceof Error ? args.error.message : String(args.error),
+            candidateIds: [],
+            step: ConversationTurnMemoryMaintenance.nextTraceStep(args.trace),
+            timestamp: new Date().toISOString(),
+        };
+    }
+    static nextTraceStep(trace) {
+        return trace.reduce((max, event) => ('step' in event ? Math.max(max, event.step) : max), 0) + 1;
+    }
+}
+//# sourceMappingURL=turn-memory-maintenance.js.map

package/dist/src/core/chat/engine/turns/memory/turn-memory-maintenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-memory-maintenance.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/memory/turn-memory-maintenance.ts"],"names":[],"mappings":"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"}

package/dist/src/core/chat/engine/turns/memory/types.d.ts

@@ -0,0 +1,29 @@
+import type { LlmAdapter } from '../../../../../core/llm/types.js';
+import type { AgentLoopResult } from '../../../../../core/runtime/agent-loop.js';
+import type { AgentLoopEvent } from '../../../../../core/runtime/events.js';
+export type RunInlineTurnMemoryMaintenanceArgs = {
+    memoryRoot: string;
+    llm: LlmAdapter;
+    source: string;
+    result: AgentLoopResult;
+    onEvent?: (event: AgentLoopEvent) => void;
+};
+export type ScheduleBackgroundTurnMemoryMaintenanceArgs = {
+    memoryRoot: string;
+    llm: LlmAdapter;
+    source: string;
+    trace: AgentLoopResult['trace'];
+    traceFile: string;
+    sessionStoragePath: string;
+    sessionId: string;
+    runId: string;
+    onEvent?: (event: AgentLoopEvent) => void;
+};
+export type RunMemoryMaintenanceCoreArgs = Pick<RunInlineTurnMemoryMaintenanceArgs, 'memoryRoot' | 'llm' | 'source'> & {
+    trace: AgentLoopResult['trace'];
+};
+export type TurnMemoryMaintenanceRuntimeInput = Pick<RunInlineTurnMemoryMaintenanceArgs, 'memoryRoot' | 'llm' | 'source' | 'onEvent'>;
+export type AppendTurnMemoryMaintenanceEventsArgs = Pick<ScheduleBackgroundTurnMemoryMaintenanceArgs, 'traceFile' | 'sessionStoragePath' | 'sessionId'> & {
+    events: AgentLoopResult['trace'];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/chat/engine/turns/memory/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,MAAM,kCAAkC,GAAG;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAC7C,kCAAkC,EAClC,YAAY,GAAG,KAAK,GAAG,QAAQ,CAChC,GAAG;IACF,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAClD,kCAAkC,EAClC,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAC5C,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG,IAAI,CACtD,2CAA2C,EAC3C,WAAW,GAAG,oBAAoB,GAAG,WAAW,CACjD,GAAG;IACF,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CAClC,CAAC"}

package/dist/src/core/chat/engine/turns/memory/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/chat/engine/turns/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/memory/types.ts"],"names":[],"mappings":""}

package/dist/src/core/chat/engine/turns/persistence/index.d.ts

@@ -0,0 +1,4 @@
+export { ConversationTurnArtifacts } from './turn-artifacts.js';
+export { ConversationTurnPersistenceService } from './turn-persistence-service.js';
+export type { PersistChatTurnArtifacts, PersistChatTurnCompactionStatus, PersistChatTurnResult, PersistChatTurnResultArgs, PersistCompletedChatTurnArgs, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/chat/engine/turns/persistence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/persistence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,YAAY,EACV,wBAAwB,EACxB,+BAA+B,EAC/B,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}

package/dist/src/core/chat/engine/turns/persistence/index.js

@@ -0,0 +1,3 @@
+export { ConversationTurnArtifacts } from './turn-artifacts.js';
+export { ConversationTurnPersistenceService } from './turn-persistence-service.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/chat/engine/turns/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/persistence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/src/core/chat/engine/turns/persistence/turn-artifacts.d.ts

@@ -0,0 +1,9 @@
+import type { PersistChatTurnArtifacts, PersistChatTurnResult, PersistChatTurnResultArgs } from './types.js';
+/**
+ * Builds persisted artifacts for a completed turn without owning storage.
+ */
+export declare class ConversationTurnArtifacts {
+    static build(args: PersistChatTurnResultArgs): Promise<PersistChatTurnArtifacts>;
+    static persist(args: PersistChatTurnResultArgs): Promise<PersistChatTurnResult>;
+}
+//# sourceMappingURL=turn-artifacts.d.ts.map

package/dist/src/core/chat/engine/turns/persistence/turn-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-artifacts.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/chat/engine/turns/persistence/turn-artifacts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EAG1B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,yBAAyB;WACvB,KAAK,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;WAwCzE,OAAO,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CActF"}