@guidify-ai/vapi-studio 0.1.0

package/dist/conversation/conversation-bootstrap.service.js

@@ -0,0 +1,383 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationBootstrapService = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const supervised_conversation_1 = require("./supervised-conversation");
+const supervised_conversation_registry_1 = require("./supervised-conversation.registry");
+const call_turn_queue_1 = require("./call-turn-queue");
+const conversation_repository_1 = require("../persistence/conversation.repository");
+const conversation_repository_2 = require("../persistence/conversation.repository");
+const event_service_1 = require("../events/event.service");
+const daily_log_driver_1 = require("../events/daily-log.driver");
+const brain_usage_tracker_1 = require("../brain/brain-usage.tracker");
+const flow_loader_1 = require("../flow/flow-loader");
+const conversation_entry_1 = require("./conversation-entry");
+function isUniqueViolation(error) {
+    if (!error || typeof error !== 'object')
+        return false;
+    const e = error;
+    return e.code === '23505' || e.driverError?.code === '23505';
+}
+let ConversationBootstrapService = class ConversationBootstrapService {
+    conversations;
+    registry;
+    flowLoader;
+    events;
+    turnQueues;
+    brainUsage;
+    entry;
+    /** Serialize concurrent bootstrap for the same Vapi call (assistant.started ∥ Custom LLM). */
+    bootstrapping = new Map();
+    constructor(conversations, registry, flowLoader, events, turnQueues, brainUsage, entryPoint) {
+        this.conversations = conversations;
+        this.registry = registry;
+        this.flowLoader = flowLoader;
+        this.events = events;
+        this.turnQueues = turnQueues;
+        this.brainUsage = brainUsage;
+        this.entry = entryPoint ?? new conversation_entry_1.DefaultConversationEntry();
+    }
+    async bootstrap(input) {
+        const existing = this.registry.getByProviderCallId(input.providerCallId);
+        if (existing) {
+            this.openCallLog(existing, input.metadata);
+            this.events.log('warn', 'BOOTSTRAP_REUSE', {
+                providerCallId: input.providerCallId,
+                runtimeInstanceId: existing.runtimeInstanceId,
+                conversationId: existing.conversationId,
+            });
+            return existing;
+        }
+        const inflight = this.bootstrapping.get(input.providerCallId);
+        if (inflight) {
+            this.events.log('info', 'BOOTSTRAP_WAIT', {
+                providerCallId: input.providerCallId,
+            });
+            return inflight;
+        }
+        const pending = this.bootstrapExclusive(input).finally(() => {
+            this.bootstrapping.delete(input.providerCallId);
+        });
+        this.bootstrapping.set(input.providerCallId, pending);
+        return pending;
+    }
+    async bootstrapExclusive(input) {
+        const raced = this.registry.getByProviderCallId(input.providerCallId);
+        if (raced) {
+            this.openCallLog(raced, input.metadata);
+            return raced;
+        }
+        const flow = this.flowLoader.getFlow();
+        const runtimeInstanceId = (0, crypto_1.randomUUID)();
+        const seeded = await this.entry.createVariables({
+            providerCallId: input.providerCallId,
+            metadata: input.metadata,
+        });
+        const variables = {
+            ...seeded,
+            ...(input.variables ?? {}),
+        };
+        let row;
+        try {
+            row = await this.conversations.createActive({
+                projectId: input.projectId,
+                providerCallId: input.providerCallId,
+                runtimeInstanceId,
+                metadata: {
+                    ...(input.metadata ?? {}),
+                    projectId: input.projectId,
+                    variables,
+                },
+                callerId: (0, conversation_repository_2.extractCallerIdFromBags)(input.metadata, variables),
+                provider: input.metadata?.channel === 'web'
+                    ? 'studio'
+                    : input.metadata?.channel === 'phone'
+                        ? 'vapi'
+                        : undefined,
+            });
+        }
+        catch (error) {
+            if (!isUniqueViolation(error)) {
+                throw error;
+            }
+            // Parallel webhook + Custom LLM both inserted — attach to the winner.
+            const existingRow = await this.conversations.findByProviderCallId(input.providerCallId, input.projectId);
+            if (!existingRow) {
+                throw error;
+            }
+            const attached = this.registry.getByProviderCallId(input.providerCallId);
+            if (attached) {
+                this.openCallLog(attached, input.metadata);
+                this.events.log('warn', 'BOOTSTRAP_REUSE_AFTER_RACE', {
+                    providerCallId: input.providerCallId,
+                    conversationId: attached.conversationId,
+                    runtimeInstanceId: attached.runtimeInstanceId,
+                });
+                return attached;
+            }
+            const runtime = new supervised_conversation_1.SupervisedConversation({
+                conversationId: existingRow.id,
+                providerCallId: input.providerCallId,
+                flowId: flow.id,
+                brainProfileId: input.brainProfileId,
+                startNodeId: flow.start,
+                runtimeInstanceId: existingRow.runtimeInstanceId ?? runtimeInstanceId,
+                metadata: input.metadata,
+                variables: {
+                    ...(existingRow.metadata?.variables ??
+                        {}),
+                    ...variables,
+                },
+            });
+            this.registry.set(runtime);
+            this.openCallLog(runtime, input.metadata);
+            this.events.log('warn', 'BOOTSTRAP_ATTACH_EXISTING_ROW', {
+                providerCallId: input.providerCallId,
+                conversationId: runtime.conversationId,
+                runtimeInstanceId: runtime.runtimeInstanceId,
+            });
+            return runtime;
+        }
+        const runtime = new supervised_conversation_1.SupervisedConversation({
+            conversationId: row.id,
+            providerCallId: input.providerCallId,
+            flowId: flow.id,
+            brainProfileId: input.brainProfileId,
+            startNodeId: flow.start,
+            runtimeInstanceId,
+            metadata: {
+                ...(input.metadata ?? {}),
+                projectId: input.projectId,
+            },
+            variables,
+        });
+        this.registry.set(runtime);
+        this.openCallLog(runtime, input.metadata);
+        await this.events.persist(runtime.conversationId, 'BOOTSTRAP', {
+            projectId: input.projectId,
+            providerCallId: runtime.providerCallId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            flowId: runtime.flowId,
+            brainProfileId: runtime.brainProfileId,
+            variables: runtime.variables,
+        });
+        if (this.entry.beforeEach) {
+            await this.entry.beforeEach({
+                runtime,
+                variables: runtime.variables,
+            });
+            await this.events.persist(runtime.conversationId, 'CONVERSATION_BEFORE_EACH', {
+                providerCallId: runtime.providerCallId,
+                runtimeInstanceId: runtime.runtimeInstanceId,
+                variables: runtime.variables,
+            });
+        }
+        await this.checkpoint(runtime);
+        return runtime;
+    }
+    openCallLog(runtime, metadata) {
+        const fromMeta = metadata?.callerPhoneNumber;
+        const phone = (typeof fromMeta === 'string' && fromMeta.trim()
+            ? fromMeta.trim()
+            : null) ??
+            (typeof runtime.metadata.callerPhoneNumber === 'string'
+                ? runtime.metadata.callerPhoneNumber
+                : null);
+        if (phone) {
+            runtime.metadata.callerPhoneNumber = phone;
+        }
+        (0, daily_log_driver_1.beginCallLog)({
+            callId: runtime.providerCallId,
+            callerPhone: phone,
+        });
+    }
+    async finalizeEnded(providerCallId) {
+        const runtime = this.registry.getByProviderCallId(providerCallId);
+        if (!runtime) {
+            this.events.log('warn', 'FINALIZE_MISSING_RUNTIME', { providerCallId });
+            return;
+        }
+        runtime.status = 'FINALIZING';
+        if (this.entry.afterEach) {
+            await this.entry.afterEach({
+                runtime,
+                variables: runtime.variables,
+            });
+            await this.events.persist(runtime.conversationId, 'CONVERSATION_AFTER_EACH', {
+                providerCallId,
+                runtimeInstanceId: runtime.runtimeInstanceId,
+                variables: runtime.variables,
+            });
+        }
+        const finalState = runtime.snapshot();
+        await this.conversations.markEnded({
+            conversationId: runtime.conversationId,
+            finalState,
+            callerId: (0, conversation_repository_2.extractCallerIdFromBags)(runtime.variables, runtime.metadata),
+        });
+        await this.events.persist(runtime.conversationId, 'FINALIZE', {
+            projectId: typeof runtime.metadata.projectId === 'string'
+                ? runtime.metadata.projectId
+                : undefined,
+            providerCallId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            finalState,
+        });
+        runtime.status = 'ENDED';
+        this.registry.delete(providerCallId);
+        this.turnQueues.delete(providerCallId);
+        const cost = this.brainUsage.summary(providerCallId);
+        if (cost && cost.calls > 0) {
+            this.events.log('info', 'BRAIN_COST_SUMMARY', {
+                providerCallId,
+                conversationId: runtime.conversationId,
+                runtimeInstanceId: runtime.runtimeInstanceId,
+                calls: cost.calls,
+                promptTokens: cost.promptTokens,
+                completionTokens: cost.completionTokens,
+                totalTokens: cost.totalTokens,
+                estimatedUsd: cost.estimatedUsd,
+                money: this.brainUsage.formatMoney(cost.estimatedUsd),
+                byModel: cost.byModel,
+            });
+        }
+        this.brainUsage.clear(providerCallId);
+        this.events.log('info', 'RUNTIME_REMOVED', {
+            providerCallId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            conversationId: runtime.conversationId,
+            registrySize: this.registry.size(),
+        });
+    }
+    /** Persist live runtime so a process crash can restore ACTIVE conversations. */
+    async checkpoint(runtime) {
+        if (runtime.status !== 'ACTIVE')
+            return;
+        const runtimeState = runtime.snapshot();
+        await this.conversations.saveRuntimeCheckpoint({
+            conversationId: runtime.conversationId,
+            runtimeState,
+            callerId: (0, conversation_repository_2.extractCallerIdFromBags)(runtime.variables, runtime.metadata),
+        });
+        this.events.log('info', 'RUNTIME_CHECKPOINT', {
+            conversationId: runtime.conversationId,
+            providerCallId: runtime.providerCallId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            turnNumber: runtime.turn.turnNumber,
+            currentNodeId: runtime.currentNodeId,
+        });
+    }
+    /**
+     * Simulate process memory loss: drop all in-memory runtimes without ending DB rows.
+     * Checkpoints already in Postgres remain ACTIVE for restore.
+     */
+    simulateCrash() {
+        const providerCallIds = [];
+        // Registry has no list API — snapshot via size + known map through delete loop.
+        // Collect by scanning provider ids from active DB would race; use registry internals via size.
+        const before = this.registry.size();
+        for (const runtime of this.listRegistryRuntimes()) {
+            providerCallIds.push(runtime.providerCallId);
+            this.registry.delete(runtime.providerCallId);
+            this.turnQueues.delete(runtime.providerCallId);
+        }
+        this.events.log('warn', 'DISASTER_SIMULATE_CRASH', {
+            dropped: providerCallIds.length,
+            providerCallIds,
+            registrySizeBefore: before,
+            registrySizeAfter: this.registry.size(),
+        });
+        return { dropped: providerCallIds.length, providerCallIds };
+    }
+    /** Reload every ACTIVE conversation that has a runtime_state checkpoint. */
+    async restoreAllActive() {
+        const rows = await this.conversations.listActiveWithState();
+        let restored = 0;
+        let skipped = 0;
+        const conversationIds = [];
+        for (const row of rows) {
+            if (this.registry.getByConversationId(row.id)) {
+                skipped += 1;
+                continue;
+            }
+            if (!row.runtimeState) {
+                skipped += 1;
+                continue;
+            }
+            const runtime = supervised_conversation_1.SupervisedConversation.fromSnapshot(row.runtimeState);
+            // Ensure DB identity wins if snapshot drifted.
+            if (runtime.conversationId !== row.id) {
+                skipped += 1;
+                this.events.log('warn', 'DISASTER_RESTORE_SKIP_ID_MISMATCH', {
+                    rowId: row.id,
+                    snapshotConversationId: runtime.conversationId,
+                });
+                continue;
+            }
+            runtime.status = 'ACTIVE';
+            this.registry.set(runtime);
+            this.openCallLog(runtime, runtime.metadata);
+            conversationIds.push(runtime.conversationId);
+            restored += 1;
+            await this.events.persist(runtime.conversationId, 'DISASTER_RESTORED', {
+                providerCallId: runtime.providerCallId,
+                runtimeInstanceId: runtime.runtimeInstanceId,
+                currentNodeId: runtime.currentNodeId,
+                turnNumber: runtime.turn.turnNumber,
+            });
+        }
+        this.events.log('info', 'DISASTER_RESTORE_ALL', {
+            restored,
+            skipped,
+            conversationIds,
+            registrySize: this.registry.size(),
+        });
+        return { restored, skipped, conversationIds };
+    }
+    async disasterStatus() {
+        const memory = this.listRegistryRuntimes().map((r) => ({
+            conversationId: r.conversationId,
+            providerCallId: r.providerCallId,
+            currentNodeId: r.currentNodeId,
+            turnNumber: r.turn.turnNumber,
+        }));
+        const active = await this.conversations.listActive();
+        const withState = await this.conversations.listActiveWithState();
+        return {
+            memoryCount: memory.length,
+            dbActiveCount: active.length,
+            dbCheckpointCount: withState.length,
+            memory,
+        };
+    }
+    /** Registry has no public iterator — poke via provider ids we track on restore/bootstrap. */
+    listRegistryRuntimes() {
+        return this.registry.list();
+    }
+};
+exports.ConversationBootstrapService = ConversationBootstrapService;
+exports.ConversationBootstrapService = ConversationBootstrapService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(6, (0, common_1.Optional)()),
+    __param(6, (0, common_1.Inject)(conversation_entry_1.CONVERSATION_ENTRY_POINT)),
+    __metadata("design:paramtypes", [conversation_repository_1.ConversationRepository,
+        supervised_conversation_registry_1.SupervisedConversationRegistry,
+        flow_loader_1.FlowLoader,
+        event_service_1.EventService,
+        call_turn_queue_1.CallTurnQueueRegistry,
+        brain_usage_tracker_1.BrainUsageTracker, Object])
+], ConversationBootstrapService);
+//# sourceMappingURL=conversation-bootstrap.service.js.map

package/dist/conversation/conversation-bootstrap.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-bootstrap.service.js","sourceRoot":"","sources":["../../src/conversation/conversation-bootstrap.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA8D;AAC9D,mCAAoC;AACpC,uEAAmE;AACnE,yFAAoF;AACpF,uDAA0D;AAC1D,oFAAgF;AAChF,oFAAiF;AACjF,2DAAuD;AACvD,iEAA0D;AAC1D,sEAAiE;AACjE,qDAAiD;AACjD,6DAI8B;AAE9B,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAA2D,CAAC;IACtE,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,KAAK,OAAO,CAAC;AAC/D,CAAC;AAGM,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IASpB;IACA;IACA;IACA;IACA;IACA;IAbF,KAAK,CAAyB;IAC/C,8FAA8F;IAC7E,aAAa,GAAiD,IAAI,GAAG,EAGnF,CAAC;IAEJ,YACmB,aAAqC,EACrC,QAAwC,EACxC,UAAsB,EACtB,MAAoB,EACpB,UAAiC,EACjC,UAA6B,EAG9C,UAAmC;QARlB,kBAAa,GAAb,aAAa,CAAwB;QACrC,aAAQ,GAAR,QAAQ,CAAgC;QACxC,eAAU,GAAV,UAAU,CAAY;QACtB,WAAM,GAAN,MAAM,CAAc;QACpB,eAAU,GAAV,UAAU,CAAuB;QACjC,eAAU,GAAV,UAAU,CAAmB;QAK9C,IAAI,CAAC,KAAK,GAAG,UAAU,IAAI,IAAI,6CAAwB,EAAE,CAAC;IAC5D,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,KAMtB;QACC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACzE,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE;gBACzC,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;gBAC7C,cAAc,EAAE,QAAQ,CAAC,cAAc;aACxC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC9D,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE;gBACxC,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YAC1D,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,KAMhC;QACC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACtE,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACvC,MAAM,iBAAiB,GAAG,IAAA,mBAAU,GAAE,CAAC;QAEvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;YAC9C,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,MAAM,SAAS,GAAG;YAChB,GAAI,MAAkC;YACtC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;SAC3B,CAAC;QAEF,IAAI,GAAG,CAAC;QACR,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC;gBAC1C,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,iBAAiB;gBACjB,QAAQ,EAAE;oBACR,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;oBACzB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,SAAS;iBACV;gBACD,QAAQ,EAAE,IAAA,iDAAuB,EAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC5D,QAAQ,EACN,KAAK,CAAC,QAAQ,EAAE,OAAO,KAAK,KAAK;oBAC/B,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO;wBACnC,CAAC,CAAC,MAAM;wBACR,CAAC,CAAC,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,sEAAsE;YACtE,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAC/D,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,SAAS,CAChB,CAAC;YACF,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACzE,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC3C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,4BAA4B,EAAE;oBACpD,cAAc,EAAE,KAAK,CAAC,cAAc;oBACpC,cAAc,EAAE,QAAQ,CAAC,cAAc;oBACvC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;iBAC9C,CAAC,CAAC;gBACH,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,gDAAsB,CAAC;gBACzC,cAAc,EAAE,WAAW,CAAC,EAAE;gBAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,WAAW,EAAE,IAAI,CAAC,KAAK;gBACvB,iBAAiB,EAAE,WAAW,CAAC,iBAAiB,IAAI,iBAAiB;gBACrE,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,SAAS,EAAE;oBACT,GAAG,CAAE,WAAW,CAAC,QAAQ,EAAE,SAAqC;wBAC9D,EAAE,CAAC;oBACL,GAAG,SAAS;iBACb;aACF,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,+BAA+B,EAAE;gBACvD,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;aAC7C,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,gDAAsB,CAAC;YACzC,cAAc,EAAE,GAAG,CAAC,EAAE;YACtB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,iBAAiB;YACjB,QAAQ,EAAE;gBACR,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;gBACzB,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B;YACD,SAAS;SACV,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,WAAW,EAAE;YAC7D,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC1B,OAAO;gBACP,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,0BAA0B,EAAE;gBAC5E,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAE/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,WAAW,CACjB,OAA+B,EAC/B,QAAkC;QAElC,MAAM,QAAQ,GAAG,QAAQ,EAAE,iBAAiB,CAAC;QAC7C,MAAM,KAAK,GACT,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE;YAC9C,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE;YACjB,CAAC,CAAC,IAAI,CAAC;YACT,CAAC,OAAO,OAAO,CAAC,QAAQ,CAAC,iBAAiB,KAAK,QAAQ;gBACrD,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBACpC,CAAC,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,QAAQ,CAAC,iBAAiB,GAAG,KAAK,CAAC;QAC7C,CAAC;QACD,IAAA,+BAAY,EAAC;YACX,MAAM,EAAE,OAAO,CAAC,cAAc;YAC9B,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,cAAsB;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,0BAA0B,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC;QAE9B,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;gBACzB,OAAO;gBACP,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,yBAAyB,EAAE;gBAC3E,cAAc;gBACd,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;YACjC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,UAAU;YACV,QAAQ,EAAE,IAAA,iDAAuB,EAC/B,OAAO,CAAC,SAAoC,EAC5C,OAAO,CAAC,QAAQ,CACjB;SACF,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,UAAU,EAAE;YAC5D,SAAS,EACP,OAAO,OAAO,CAAC,QAAQ,CAAC,SAAS,KAAK,QAAQ;gBAC5C,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAC5B,CAAC,CAAC,SAAS;YACf,cAAc;YACd,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,UAAU;SACX,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAEvC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE;gBAC5C,cAAc;gBACd,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC;gBACrD,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE;YACzC,cAAc;YACd,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;SACnC,CAAC,CAAC;IACL,CAAC;IAED,gFAAgF;IACzE,KAAK,CAAC,UAAU,CAAC,OAA+B;QACrD,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO;QACxC,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,CAAC,aAAa,CAAC,qBAAqB,CAAC;YAC7C,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,YAAY;YACZ,QAAQ,EAAE,IAAA,iDAAuB,EAC/B,OAAO,CAAC,SAAoC,EAC5C,OAAO,CAAC,QAAQ,CACjB;SACF,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE;YAC5C,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU;YACnC,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,aAAa;QAIlB,MAAM,eAAe,GAAa,EAAE,CAAC;QACrC,gFAAgF;QAChF,+FAA+F;QAC/F,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;YAClD,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC7C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC7C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,EAAE;YACjD,OAAO,EAAE,eAAe,CAAC,MAAM;YAC/B,eAAe;YACf,kBAAkB,EAAE,MAAM;YAC1B,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;SACxC,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC9D,CAAC;IAED,4EAA4E;IACrE,KAAK,CAAC,gBAAgB;QAK3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,mBAAmB,EAAE,CAAC;QAC5D,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC9C,OAAO,IAAI,CAAC,CAAC;gBACb,SAAS;YACX,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC,CAAC;gBACb,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,gDAAsB,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACtE,+CAA+C;YAC/C,IAAI,OAAO,CAAC,cAAc,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC;gBACtC,OAAO,IAAI,CAAC,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,mCAAmC,EAAE;oBAC3D,KAAK,EAAE,GAAG,CAAC,EAAE;oBACb,sBAAsB,EAAE,OAAO,CAAC,cAAc;iBAC/C,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC5C,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC7C,QAAQ,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,mBAAmB,EAAE;gBACrE,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU;aACpC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE;YAC9C,QAAQ;YACR,OAAO;YACP,eAAe;YACf,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;SACnC,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,cAAc;QAWzB,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrD,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU;SAC9B,CAAC,CAAC,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,mBAAmB,EAAE,CAAC;QACjE,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,aAAa,EAAE,MAAM,CAAC,MAAM;YAC5B,iBAAiB,EAAE,SAAS,CAAC,MAAM;YACnC,MAAM;SACP,CAAC;IACJ,CAAC;IAED,6FAA6F;IACrF,oBAAoB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;CACF,CAAA;AArZY,oEAA4B;uCAA5B,4BAA4B;IADxC,IAAA,mBAAU,GAAE;IAgBR,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,eAAM,EAAC,6CAAwB,CAAC,CAAA;qCAPD,gDAAsB;QAC3B,iEAA8B;QAC5B,wBAAU;QACd,4BAAY;QACR,uCAAqB;QACrB,uCAAiB;GAdrC,4BAA4B,CAqZxC"}

package/dist/conversation/conversation-entry.d.ts

@@ -0,0 +1,38 @@
+import type { SupervisedConversation } from './supervised-conversation';
+/**
+ * App-defined conversation variables, typed at the application boundary.
+ *
+ * @example
+ * export interface AppVariables {
+ *   companyName: string;
+ * }
+ * type Vars = Variables<AppVariables>;
+ */
+export type Variables<T extends object = object> = T;
+export interface ConversationEntryInput {
+    providerCallId: string;
+    metadata?: Record<string, unknown>;
+}
+/** Context passed to conversation setup/teardown hooks. */
+export interface ConversationHookContext<TVars extends object = object> {
+    runtime: SupervisedConversation;
+    variables: Variables<TVars>;
+}
+/**
+ * Conversation entry point — seeds typed variables and optional setup/teardown hooks.
+ * Nodes read variables via `ctx.conversation.variables`.
+ */
+export interface ConversationEntryPoint<TVars extends object = object> {
+    createVariables(input: ConversationEntryInput): Variables<TVars> | Promise<Variables<TVars>>;
+    /** Setup hook — runs once when a Conversation is created (after variables are seeded). */
+    beforeEach?(ctx: ConversationHookContext<TVars>): void | Promise<void>;
+    /** Teardown hook — runs once when a Conversation is finalized/ended. */
+    afterEach?(ctx: ConversationHookContext<TVars>): void | Promise<void>;
+}
+export declare const CONVERSATION_ENTRY_POINT: unique symbol;
+export declare class DefaultConversationEntry implements ConversationEntryPoint<object> {
+    createVariables(): object;
+    beforeEach(_ctx: ConversationHookContext<object>): Promise<void>;
+    afterEach(_ctx: ConversationHookContext<object>): Promise<void>;
+}
+//# sourceMappingURL=conversation-entry.d.ts.map

package/dist/conversation/conversation-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-entry.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,2DAA2D;AAC3D,MAAM,WAAW,uBAAuB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACpE,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACnE,eAAe,CACb,KAAK,EAAE,sBAAsB,GAC5B,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAEhD,0FAA0F;IAC1F,UAAU,CAAC,CACT,GAAG,EAAE,uBAAuB,CAAC,KAAK,CAAC,GAClC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB,wEAAwE;IACxE,SAAS,CAAC,CACR,GAAG,EAAE,uBAAuB,CAAC,KAAK,CAAC,GAClC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,eAAO,MAAM,wBAAwB,eAAqC,CAAC;AAE3E,qBAAa,wBAAyB,YAAW,sBAAsB,CAAC,MAAM,CAAC;IACtE,eAAe,IAAI,MAAM;IAInB,UAAU,CAAC,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,SAAS,CAAC,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7E"}

package/dist/conversation/conversation-entry.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultConversationEntry = exports.CONVERSATION_ENTRY_POINT = void 0;
+exports.CONVERSATION_ENTRY_POINT = Symbol('CONVERSATION_ENTRY_POINT');
+class DefaultConversationEntry {
+    createVariables() {
+        return {};
+    }
+    async beforeEach(_ctx) {
+        // no-op
+    }
+    async afterEach(_ctx) {
+        // no-op
+    }
+}
+exports.DefaultConversationEntry = DefaultConversationEntry;
+//# sourceMappingURL=conversation-entry.js.map

package/dist/conversation/conversation-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-entry.js","sourceRoot":"","sources":["../../src/conversation/conversation-entry.ts"],"names":[],"mappings":";;;AA4Ca,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAE3E,MAAa,wBAAwB;IAC5B,eAAe;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,IAAqC;QAC3D,QAAQ;IACV,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,IAAqC;QAC1D,QAAQ;IACV,CAAC;CACF;AAZD,4DAYC"}

package/dist/conversation/conversation-history.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Compact conversation history for Brain scan + Node.before().
+ * Lives on the in-memory SupervisedConversation for the active call.
+ */
+export declare const DEFAULT_INTENTION_PRIORITY = 1;
+export declare const MAX_COMPACT_CHAT_MESSAGES = 24;
+export declare const MAX_COMPACT_CHAT_CHARS = 280;
+export declare const MAX_NODE_PATH = 40;
+export interface CompactChatMessage {
+    role: 'user' | 'assistant';
+    text: string;
+}
+export interface NodeVisit {
+    nodeId: string;
+    intention: string;
+    turnNumber: number;
+    at: string;
+}
+export interface ConversationHistory {
+    /** Rolling compact transcript (user + bot). */
+    chat: CompactChatMessage[];
+    /** Node path for before() (where we have been). */
+    nodes: NodeVisit[];
+}
+export declare function emptyConversationHistory(): ConversationHistory;
+export declare function compactText(text: string, max?: number): string;
+export declare function appendChat(history: ConversationHistory, role: 'user' | 'assistant', text: string): void;
+export declare function appendNodeVisit(history: ConversationHistory, visit: NodeVisit): void;
+export declare function countNodeVisits(history: ConversationHistory, nodeId: string): number;
+export declare function lastVisitedNodeId(history: ConversationHistory): string | null;
+//# sourceMappingURL=conversation-history.d.ts.map

package/dist/conversation/conversation-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation-history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,mDAAmD;IACnD,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,wBAAgB,wBAAwB,IAAI,mBAAmB,CAE9D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAyB,GAAG,MAAM,CAI9E;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,IAAI,EAAE,MAAM,GACX,IAAI,CAUN;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,SAAS,GACf,IAAI,CAKN;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,MAAM,GACb,MAAM,CAER;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,mBAAmB,GAC3B,MAAM,GAAG,IAAI,CAIf"}

package/dist/conversation/conversation-history.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Compact conversation history for Brain scan + Node.before().
+ * Lives on the in-memory SupervisedConversation for the active call.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_NODE_PATH = exports.MAX_COMPACT_CHAT_CHARS = exports.MAX_COMPACT_CHAT_MESSAGES = exports.DEFAULT_INTENTION_PRIORITY = void 0;
+exports.emptyConversationHistory = emptyConversationHistory;
+exports.compactText = compactText;
+exports.appendChat = appendChat;
+exports.appendNodeVisit = appendNodeVisit;
+exports.countNodeVisits = countNodeVisits;
+exports.lastVisitedNodeId = lastVisitedNodeId;
+exports.DEFAULT_INTENTION_PRIORITY = 1;
+exports.MAX_COMPACT_CHAT_MESSAGES = 24;
+exports.MAX_COMPACT_CHAT_CHARS = 280;
+exports.MAX_NODE_PATH = 40;
+function emptyConversationHistory() {
+    return { chat: [], nodes: [] };
+}
+function compactText(text, max = exports.MAX_COMPACT_CHAT_CHARS) {
+    const t = text.replace(/\s+/g, ' ').trim();
+    if (t.length <= max)
+        return t;
+    return `${t.slice(0, max)}…`;
+}
+function appendChat(history, role, text) {
+    const compact = compactText(text);
+    if (!compact && role === 'user') {
+        return;
+    }
+    if (!compact)
+        return;
+    history.chat.push({ role, text: compact });
+    if (history.chat.length > exports.MAX_COMPACT_CHAT_MESSAGES) {
+        history.chat.splice(0, history.chat.length - exports.MAX_COMPACT_CHAT_MESSAGES);
+    }
+}
+function appendNodeVisit(history, visit) {
+    history.nodes.push(visit);
+    if (history.nodes.length > exports.MAX_NODE_PATH) {
+        history.nodes.splice(0, history.nodes.length - exports.MAX_NODE_PATH);
+    }
+}
+function countNodeVisits(history, nodeId) {
+    return history.nodes.filter((n) => n.nodeId === nodeId).length;
+}
+function lastVisitedNodeId(history) {
+    return history.nodes.length
+        ? history.nodes[history.nodes.length - 1].nodeId
+        : null;
+}
+//# sourceMappingURL=conversation-history.js.map

package/dist/conversation/conversation-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.js","sourceRoot":"","sources":["../../src/conversation/conversation-history.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA0BH,4DAEC;AAED,kCAIC;AAED,gCAcC;AAED,0CAQC;AAED,0CAKC;AAED,8CAMC;AAzEY,QAAA,0BAA0B,GAAG,CAAC,CAAC;AAC/B,QAAA,yBAAyB,GAAG,EAAE,CAAC;AAC/B,QAAA,sBAAsB,GAAG,GAAG,CAAC;AAC7B,QAAA,aAAa,GAAG,EAAE,CAAC;AAqBhC,SAAgB,wBAAwB;IACtC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACjC,CAAC;AAED,SAAgB,WAAW,CAAC,IAAY,EAAE,GAAG,GAAG,8BAAsB;IACpE,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;AAC/B,CAAC;AAED,SAAgB,UAAU,CACxB,OAA4B,EAC5B,IAA0B,EAC1B,IAAY;IAEZ,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAChC,OAAO;IACT,CAAC;IACD,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,iCAAyB,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,iCAAyB,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAC7B,OAA4B,EAC5B,KAAgB;IAEhB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,qBAAa,EAAE,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,qBAAa,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAC7B,OAA4B,EAC5B,MAAc;IAEd,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;AACjE,CAAC;AAED,SAAgB,iBAAiB,CAC/B,OAA4B;IAE5B,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM;QACzB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM;QAChD,CAAC,CAAC,IAAI,CAAC;AACX,CAAC"}

package/dist/conversation/conversation-limits.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Hard caps on conversation length — fail-closed goodbye + endCall.
+ * Every call must have finite turn and wall-clock bounds.
+ */
+export declare const STUDIO_CONVERSATION_LIMITS: unique symbol;
+/** Default: 40 Supervisor turns (opening + user/tool/force/entry-speak). */
+export declare const DEFAULT_MAX_CONVERSATION_TURNS = 40;
+/** Default: 20 minutes from runtime `createdAt`. */
+export declare const DEFAULT_MAX_CONVERSATION_DURATION_MS: number;
+/** Soft ceiling — apps may raise, not beyond. */
+export declare const HARD_MAX_CONVERSATION_TURNS = 150;
+/** Soft ceiling — apps may raise, not beyond (60 minutes). */
+export declare const HARD_MAX_CONVERSATION_DURATION_MS: number;
+export declare const DEFAULT_CONVERSATION_LIMIT_MESSAGE = "We've been talking for a while, so I'm going to end this call now. Please call back if you still need help.";
+export type ConversationLimitReason = 'max_turns' | 'max_duration';
+export interface ConversationLimitsConfig {
+    /**
+     * Max Supervisor turns (each `handleTurn` bumps `turn.turnNumber`).
+     * Default 40. Clamped to 1…150.
+     */
+    maxTurns?: number;
+    /**
+     * Max wall-clock ms from `SupervisedConversation.createdAt`.
+     * Default 20 minutes. Clamped to 1s…60 minutes.
+     */
+    maxDurationMs?: number;
+    /** Spoken text before endCall when a limit fires. */
+    endMessage?: string;
+}
+export interface ResolvedConversationLimits {
+    maxTurns: number;
+    maxDurationMs: number;
+    endMessage: string;
+}
+export declare function resolveConversationLimits(input?: ConversationLimitsConfig): ResolvedConversationLimits;
+export declare function evaluateConversationLimits(input: {
+    turnNumber: number;
+    createdAt: Date;
+    now?: Date;
+    limits: ResolvedConversationLimits;
+}): {
+    exceeded: true;
+    reason: ConversationLimitReason;
+    elapsedMs: number;
+} | {
+    exceeded: false;
+    elapsedMs: number;
+};
+//# sourceMappingURL=conversation-limits.d.ts.map

package/dist/conversation/conversation-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-limits.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation-limits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,0BAA0B,eAAuC,CAAC;AAE/E,4EAA4E;AAC5E,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,oDAAoD;AACpD,eAAO,MAAM,oCAAoC,QAAiB,CAAC;AAEnE,iDAAiD;AACjD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,8DAA8D;AAC9D,eAAO,MAAM,iCAAiC,QAAiB,CAAC;AAEhE,eAAO,MAAM,kCAAkC,gHACgE,CAAC;AAEhH,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,cAAc,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,CAAC,EAAE,wBAAwB,GAC/B,0BAA0B,CAkB5B;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,0BAA0B,CAAC;CACpC,GAAG;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAC3E,QAAQ,EAAE,KAAK,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAUA"}