@guidify-ai/vapi-studio 0.1.0

package/dist/brain/adapters/mock-brain.adapter.js

@@ -0,0 +1,201 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockBrainService = exports.MockBrainAdapter = void 0;
+const fs_1 = require("fs");
+const common_1 = require("@nestjs/common");
+const yaml_1 = require("yaml");
+const listen_expectation_1 = require("../../conversation/listen-expectation");
+const conversation_history_1 = require("../../conversation/conversation-history");
+const brain_ranking_1 = require("../brain-ranking");
+const brain_clarify_1 = require("../brain-clarify");
+const brain_judge_1 = require("../brain-judge");
+/**
+ * Deterministic Brain adapter for PoC / tests.
+ * No network, no ChatGPT — sequence-driven intentions + listen boosts/hints + mock extract.
+ */
+let MockBrainAdapter = class MockBrainAdapter {
+    profiles = new Map();
+    activeProfileId = 'state-machine';
+    loadProfile(profileId, path) {
+        const raw = (0, yaml_1.parse)((0, fs_1.readFileSync)(path, 'utf8'));
+        if (!raw?.sequence?.length) {
+            throw new Error(`Invalid brain profile at ${path}`);
+        }
+        this.setSequence(profileId, raw.sequence);
+    }
+    setSequence(profileId, sequence) {
+        if (!sequence.length) {
+            throw new Error(`Brain sequence empty for profile ${profileId}`);
+        }
+        this.profiles.set(profileId, sequence);
+    }
+    setActiveProfile(profileId) {
+        if (!this.profiles.has(profileId)) {
+            throw new Error(`Unknown brain profile: ${profileId}`);
+        }
+        this.activeProfileId = profileId;
+    }
+    getActiveProfileId() {
+        return this.activeProfileId;
+    }
+    async scan(input) {
+        const profileId = input.runtime.brainProfileId || this.activeProfileId;
+        const sequence = this.profiles.get(profileId);
+        if (!sequence) {
+            throw new Error(`Brain profile not loaded: ${profileId}`);
+        }
+        const listen = input.listen ?? input.runtime.listenExpectation;
+        const index = input.runtime.brainSequenceIndex;
+        const mk = (name, confidence, priority, payload) => ({
+            name,
+            confidence: (0, brain_ranking_1.roundConfidence)(confidence),
+            priority,
+            rank: Math.round((1 - (0, brain_ranking_1.roundConfidence)(confidence)) * 1_000_000),
+            payload: { ...payload, confidence: (0, brain_ranking_1.roundConfidence)(confidence), priority },
+        });
+        let candidates;
+        if (index >= sequence.length) {
+            candidates = [
+                mk(sequence[sequence.length - 1], 1, 1_000_000, {
+                    userText: input.userText,
+                    exhausted: true,
+                    hints: listen?.hints,
+                    adapter: 'mock',
+                }),
+            ];
+        }
+        else {
+            const name = sequence[index];
+            input.runtime.brainSequenceIndex = index + 1;
+            candidates = [
+                mk(name, 1, 1_000_000, {
+                    userText: input.userText,
+                    sequenceIndex: index,
+                    hints: listen?.hints,
+                    adapter: 'mock',
+                }),
+            ];
+        }
+        if (listen?.intentions?.length) {
+            for (const intent of listen.intentions) {
+                if (candidates.some((c) => c.name === intent.name)) {
+                    continue;
+                }
+                candidates.push(mk(intent.name, 0.15, intent.priority ?? conversation_history_1.DEFAULT_INTENTION_PRIORITY, {
+                    userText: input.userText,
+                    fromListenHint: true,
+                    hints: listen.hints,
+                    adapter: 'mock',
+                    listenBoost: intent.boost,
+                }));
+            }
+        }
+        const extracted = (0, listen_expectation_1.mockExtractFromUserText)(input.userText, listen?.extract?.fields);
+        return {
+            intentions: candidates,
+            extracted: Object.keys(extracted).length ? extracted : undefined,
+        };
+    }
+    /**
+     * Deterministic clarify for tests — fills required string fields from input text.
+     * Empty / reserved marker input → studio.clarify.cannotAnswer.
+     */
+    async clarify(request) {
+        const text = (0, brain_clarify_1.clarifiableInputToString)(request.input).trim();
+        if (!text ||
+            /^studio\.clarify\.cannotAnswer$/i.test(text) ||
+            /\bcannot\s*answer\b/i.test(text)) {
+            (0, brain_clarify_1.throwClarifyCannotAnswer)(!text ? 'empty_input' : 'explicit_cannot_answer');
+        }
+        const answer = {};
+        for (const field of request.answer.fields ?? []) {
+            if (field.type === 'boolean') {
+                answer[field.key] = /\b(yes|true|yep)\b/i.test(text);
+                continue;
+            }
+            if (field.type === 'number') {
+                const n = text.match(/-?\d+(?:\.\d+)?/);
+                answer[field.key] = n ? Number(n[0]) : null;
+                continue;
+            }
+            if (field.type === 'object' || field.type === 'array') {
+                answer[field.key] = null;
+                continue;
+            }
+            const named = text.match(/(?:my name is|i(?:'| a)?m|call me|it(?:'| i)?s)\s+([A-Za-z][A-Za-z'-]*)/i) ?? text.match(/^([A-Za-z][A-Za-z'-]*)$/);
+            answer[field.key] = named?.[1] ?? (text ? text.split(/\s+/)[0] : null);
+        }
+        return (0, brain_clarify_1.normalizeClarifyResult)({ answer }, request.answer);
+    }
+    /**
+     * Deterministic judge for tests — no network.
+     * Markers in context: `studio.judge.pass` / `studio.judge.fail`.
+     * Otherwise: any matching failureCondition → fail; all successConditions
+     * present (or none given) → pass.
+     */
+    async judge(request) {
+        const text = (0, brain_judge_1.judgeContextToString)(request.context).trim();
+        const success = request.successConditions ?? [];
+        const failure = request.failureConditions ?? [];
+        const haystack = text.toLowerCase();
+        if (!text || /^studio\.judge\.fail$/i.test(text)) {
+            return (0, brain_judge_1.normalizeJudgeResult)({
+                passed: false,
+                confidence: text ? 1 : 0,
+                reasoning: [text ? 'explicit_fail_marker' : 'empty_context'],
+            }, request.options);
+        }
+        if (/studio\.judge\.fail\b/i.test(text)) {
+            return (0, brain_judge_1.normalizeJudgeResult)({
+                passed: false,
+                confidence: 1,
+                reasoning: ['explicit_fail_marker'],
+            }, request.options);
+        }
+        if (/studio\.judge\.pass\b/i.test(text)) {
+            return (0, brain_judge_1.normalizeJudgeResult)({
+                passed: true,
+                confidence: 1,
+                reasoning: ['explicit_pass_marker'],
+            }, request.options);
+        }
+        const hitFailure = failure.filter((c) => haystack.includes(c.trim().toLowerCase()));
+        if (hitFailure.length) {
+            return (0, brain_judge_1.normalizeJudgeResult)({
+                passed: false,
+                confidence: 0.95,
+                reasoning: hitFailure.map((c) => `failure_condition: ${c}`),
+            }, request.options);
+        }
+        const missedSuccess = success.filter((c) => !haystack.includes(c.trim().toLowerCase()));
+        if (missedSuccess.length) {
+            return (0, brain_judge_1.normalizeJudgeResult)({
+                passed: false,
+                confidence: 0.8,
+                reasoning: missedSuccess.map((c) => `missing_success_condition: ${c}`),
+            }, request.options);
+        }
+        return (0, brain_judge_1.normalizeJudgeResult)({
+            passed: true,
+            confidence: 0.9,
+            reasoning: success.length
+                ? success.map((c) => `success_condition: ${c}`)
+                : ['goals_assumed_met'],
+        }, request.options);
+    }
+};
+exports.MockBrainAdapter = MockBrainAdapter;
+exports.MockBrainAdapter = MockBrainAdapter = __decorate([
+    (0, common_1.Injectable)()
+], MockBrainAdapter);
+/** @deprecated Prefer MockBrainAdapter — kept for existing imports. */
+class MockBrainService extends MockBrainAdapter {
+}
+exports.MockBrainService = MockBrainService;
+//# sourceMappingURL=mock-brain.adapter.js.map

package/dist/brain/adapters/mock-brain.adapter.js.map

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

package/dist/brain/adapters/mock-provider-brains.adapter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Named mock Brain adapters — same deterministic sequence engine as
+ * {@link MockBrainAdapter}, tagged by intended live provider for app wiring.
+ *
+ * Use these when you want `brainConfig.adapter: 'mock-claude'` (etc.) without
+ * calling Anthropic/Google/xAI/OpenAI. Behavior is identical across mocks;
+ * only the class identity / `mockProvider` label differs.
+ */
+import { MockBrainAdapter } from './mock-brain.adapter';
+export declare class MockChatGptBrainAdapter extends MockBrainAdapter {
+    readonly mockProvider: 'chatgpt';
+}
+export declare class MockClaudeBrainAdapter extends MockBrainAdapter {
+    readonly mockProvider: 'claude';
+}
+export declare class MockGeminiBrainAdapter extends MockBrainAdapter {
+    readonly mockProvider: 'gemini';
+}
+export declare class MockGrokBrainAdapter extends MockBrainAdapter {
+    readonly mockProvider: 'grok';
+}
+//# sourceMappingURL=mock-provider-brains.adapter.d.ts.map

package/dist/brain/adapters/mock-provider-brains.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-provider-brains.adapter.d.ts","sourceRoot":"","sources":["../../../src/brain/adapters/mock-provider-brains.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,qBACa,uBAAwB,SAAQ,gBAAgB;IAC3D,SAAgB,YAAY,EAAE,SAAS,CAAa;CACrD;AAED,qBACa,sBAAuB,SAAQ,gBAAgB;IAC1D,SAAgB,YAAY,EAAE,QAAQ,CAAY;CACnD;AAED,qBACa,sBAAuB,SAAQ,gBAAgB;IAC1D,SAAgB,YAAY,EAAE,QAAQ,CAAY;CACnD;AAED,qBACa,oBAAqB,SAAQ,gBAAgB;IACxD,SAAgB,YAAY,EAAE,MAAM,CAAU;CAC/C"}

package/dist/brain/adapters/mock-provider-brains.adapter.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Named mock Brain adapters — same deterministic sequence engine as
+ * {@link MockBrainAdapter}, tagged by intended live provider for app wiring.
+ *
+ * Use these when you want `brainConfig.adapter: 'mock-claude'` (etc.) without
+ * calling Anthropic/Google/xAI/OpenAI. Behavior is identical across mocks;
+ * only the class identity / `mockProvider` label differs.
+ */
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockGrokBrainAdapter = exports.MockGeminiBrainAdapter = exports.MockClaudeBrainAdapter = exports.MockChatGptBrainAdapter = void 0;
+const common_1 = require("@nestjs/common");
+const mock_brain_adapter_1 = require("./mock-brain.adapter");
+let MockChatGptBrainAdapter = class MockChatGptBrainAdapter extends mock_brain_adapter_1.MockBrainAdapter {
+    mockProvider = 'chatgpt';
+};
+exports.MockChatGptBrainAdapter = MockChatGptBrainAdapter;
+exports.MockChatGptBrainAdapter = MockChatGptBrainAdapter = __decorate([
+    (0, common_1.Injectable)()
+], MockChatGptBrainAdapter);
+let MockClaudeBrainAdapter = class MockClaudeBrainAdapter extends mock_brain_adapter_1.MockBrainAdapter {
+    mockProvider = 'claude';
+};
+exports.MockClaudeBrainAdapter = MockClaudeBrainAdapter;
+exports.MockClaudeBrainAdapter = MockClaudeBrainAdapter = __decorate([
+    (0, common_1.Injectable)()
+], MockClaudeBrainAdapter);
+let MockGeminiBrainAdapter = class MockGeminiBrainAdapter extends mock_brain_adapter_1.MockBrainAdapter {
+    mockProvider = 'gemini';
+};
+exports.MockGeminiBrainAdapter = MockGeminiBrainAdapter;
+exports.MockGeminiBrainAdapter = MockGeminiBrainAdapter = __decorate([
+    (0, common_1.Injectable)()
+], MockGeminiBrainAdapter);
+let MockGrokBrainAdapter = class MockGrokBrainAdapter extends mock_brain_adapter_1.MockBrainAdapter {
+    mockProvider = 'grok';
+};
+exports.MockGrokBrainAdapter = MockGrokBrainAdapter;
+exports.MockGrokBrainAdapter = MockGrokBrainAdapter = __decorate([
+    (0, common_1.Injectable)()
+], MockGrokBrainAdapter);
+//# sourceMappingURL=mock-provider-brains.adapter.js.map

package/dist/brain/adapters/mock-provider-brains.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-provider-brains.adapter.js","sourceRoot":"","sources":["../../../src/brain/adapters/mock-provider-brains.adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;AAEH,2CAA4C;AAC5C,6DAAwD;AAGjD,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,qCAAgB;IAC3C,YAAY,GAAc,SAAS,CAAC;CACrD,CAAA;AAFY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,mBAAU,GAAE;GACA,uBAAuB,CAEnC;AAGM,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,qCAAgB;IAC1C,YAAY,GAAa,QAAQ,CAAC;CACnD,CAAA;AAFY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;GACA,sBAAsB,CAElC;AAGM,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,qCAAgB;IAC1C,YAAY,GAAa,QAAQ,CAAC;CACnD,CAAA;AAFY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;GACA,sBAAsB,CAElC;AAGM,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,qCAAgB;IACxC,YAAY,GAAW,MAAM,CAAC;CAC/C,CAAA;AAFY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;GACA,oBAAoB,CAEhC"}

package/dist/brain/brain-clarify.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Brain clarify — ask a free-form question with a required object answer shape.
+ * Used when the flow has an ambiguous / incomplete answer and needs a Brain judgment.
+ *
+ * Reserved failure: throws ClarifyCannotAnswerError (`studio.clarify.cannotAnswer`).
+ */
+/** Anything the runtime can stringify for Brain context. */
+export type ClarifiableInput = string | number | boolean | bigint | Date | null | undefined | {
+    toString(): string;
+};
+export interface BrainAnswerField {
+    key: string;
+    description?: string;
+    type?: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    required?: boolean;
+}
+/**
+ * Declares the object interface Brain must return.
+ * On success, `answer` is always an object keyed by these fields.
+ */
+export interface BrainAnswerInterface {
+    fields: BrainAnswerField[];
+    /** Optional overall description of the answer object. */
+    description?: string;
+}
+export interface BrainClarifyRequest {
+    /** Arbitrary context convertible to string (user text, extracted blob, JSON, …). */
+    input: ClarifiableInput;
+    /** Question posed to Brain. */
+    question: string;
+    /** Required object answer shape. */
+    answer: BrainAnswerInterface;
+    /** Optional correlation for usage / console (filled by NodeContext). */
+    meta?: {
+        providerCallId?: string;
+        conversationId?: string;
+    };
+}
+/** Reserved clarify exception code — Brain cannot produce a reliable answer. */
+export declare const STUDIO_CLARIFY_CANNOT_ANSWER: "studio.clarify.cannotAnswer";
+/**
+ * Reserved exception thrown by Brain.clarify when it cannot answer.
+ * Catch this in Node.run / Node.catch to recover (restartNode, forceIntention, …).
+ */
+export declare class ClarifyCannotAnswerError extends Error {
+    readonly code: "studio.clarify.cannotAnswer";
+    readonly reason?: string;
+    readonly details?: Record<string, unknown>;
+    constructor(reason?: string, details?: Record<string, unknown>);
+}
+export declare function isClarifyCannotAnswerError(error: unknown): error is ClarifyCannotAnswerError;
+/** Throw the reserved cannot-answer exception. */
+export declare function throwClarifyCannotAnswer(reason?: string, details?: Record<string, unknown>): never;
+/**
+ * Successful clarify result — always an object answer.
+ * Failure is never returned here; adapters throw ClarifyCannotAnswerError.
+ */
+export interface BrainClarifyResult<TAnswer extends Record<string, unknown> = Record<string, unknown>> {
+    answer: TAnswer;
+}
+/**
+ * Normalize raw Brain JSON into a successful clarify result,
+ * or throw ClarifyCannotAnswerError (reserved).
+ *
+ * Accepts:
+ * - `{ outcome: "studio.clarify.cannotAnswer", reason? }` → throw
+ * - `{ cannotAnswer: true, reason? }` → throw
+ * - `{ answer: {...} }` / `{ outcome: "answered", answer: {...} }`
+ */
+export declare function normalizeClarifyResult<TAnswer extends Record<string, unknown> = Record<string, unknown>>(raw: unknown, answerInterface: BrainAnswerInterface): BrainClarifyResult<TAnswer>;
+export declare function clarifiableInputToString(input: ClarifiableInput): string;
+export declare function emptyAnswerFromInterface(answer: BrainAnswerInterface): Record<string, unknown>;
+/** Keep only keys declared on the answer interface; sanitize string values fail-closed. */
+export declare function filterClarifyAnswer(raw: Record<string, unknown> | null | undefined, answer: BrainAnswerInterface): Record<string, unknown>;
+//# sourceMappingURL=brain-clarify.d.ts.map

package/dist/brain/brain-clarify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-clarify.d.ts","sourceRoot":"","sources":["../../src/brain/brain-clarify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,IAAI,GACJ,IAAI,GACJ,SAAS,GACT;IAAE,QAAQ,IAAI,MAAM,CAAA;CAAE,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,KAAK,EAAE,gBAAgB,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,wEAAwE;IACxE,IAAI,CAAC,EAAE;QACL,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,gFAAgF;AAChF,eAAO,MAAM,4BAA4B,EAAG,6BAAsC,CAAC;AACnF;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAgB,IAAI,EAAE,6BAA6B,CAAgC;IACnF,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUtE;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,wBAAwB,CAOnC;AAED,kDAAkD;AAClD,wBAAgB,wBAAwB,CACtC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,KAAK,CAEP;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CACjC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjE,MAAM,EAAE,OAAO,CAAC;CACjB;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEjE,GAAG,EAAE,OAAO,EACZ,eAAe,EAAE,oBAAoB,GACpC,kBAAkB,CAAC,OAAO,CAAC,CAsC7B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAsBxE;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,oBAAoB,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/C,MAAM,EAAE,oBAAoB,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB"}

package/dist/brain/brain-clarify.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Brain clarify — ask a free-form question with a required object answer shape.
+ * Used when the flow has an ambiguous / incomplete answer and needs a Brain judgment.
+ *
+ * Reserved failure: throws ClarifyCannotAnswerError (`studio.clarify.cannotAnswer`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClarifyCannotAnswerError = exports.STUDIO_CLARIFY_CANNOT_ANSWER = void 0;
+exports.isClarifyCannotAnswerError = isClarifyCannotAnswerError;
+exports.throwClarifyCannotAnswer = throwClarifyCannotAnswer;
+exports.normalizeClarifyResult = normalizeClarifyResult;
+exports.clarifiableInputToString = clarifiableInputToString;
+exports.emptyAnswerFromInterface = emptyAnswerFromInterface;
+exports.filterClarifyAnswer = filterClarifyAnswer;
+const prompt_injection_guard_1 = require("./prompt-injection-guard");
+/** Reserved clarify exception code — Brain cannot produce a reliable answer. */
+exports.STUDIO_CLARIFY_CANNOT_ANSWER = 'studio.clarify.cannotAnswer';
+/**
+ * Reserved exception thrown by Brain.clarify when it cannot answer.
+ * Catch this in Node.run / Node.catch to recover (restartNode, forceIntention, …).
+ */
+class ClarifyCannotAnswerError extends Error {
+    code = exports.STUDIO_CLARIFY_CANNOT_ANSWER;
+    reason;
+    details;
+    constructor(reason, details) {
+        super(reason
+            ? `${exports.STUDIO_CLARIFY_CANNOT_ANSWER}: ${reason}`
+            : exports.STUDIO_CLARIFY_CANNOT_ANSWER);
+        this.name = 'ClarifyCannotAnswerError';
+        this.reason = reason;
+        this.details = details;
+    }
+}
+exports.ClarifyCannotAnswerError = ClarifyCannotAnswerError;
+function isClarifyCannotAnswerError(error) {
+    return (error instanceof ClarifyCannotAnswerError ||
+        (typeof error === 'object' &&
+            error !== null &&
+            error.code === exports.STUDIO_CLARIFY_CANNOT_ANSWER));
+}
+/** Throw the reserved cannot-answer exception. */
+function throwClarifyCannotAnswer(reason, details) {
+    throw new ClarifyCannotAnswerError(reason, details);
+}
+function requiredFieldsMissing(answer, answerInterface) {
+    const required = (answerInterface.fields ?? []).filter((f) => f.required);
+    if (!required.length) {
+        return false;
+    }
+    return required.every((f) => {
+        const v = answer[f.key];
+        return v === undefined || v === null || v === '';
+    });
+}
+/**
+ * Normalize raw Brain JSON into a successful clarify result,
+ * or throw ClarifyCannotAnswerError (reserved).
+ *
+ * Accepts:
+ * - `{ outcome: "studio.clarify.cannotAnswer", reason? }` → throw
+ * - `{ cannotAnswer: true, reason? }` → throw
+ * - `{ answer: {...} }` / `{ outcome: "answered", answer: {...} }`
+ */
+function normalizeClarifyResult(raw, answerInterface) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throwClarifyCannotAnswer('invalid_clarify_payload');
+    }
+    const obj = raw;
+    if (obj.outcome === exports.STUDIO_CLARIFY_CANNOT_ANSWER ||
+        obj.outcome === 'studio.clarify.cannotAnswer' ||
+        obj.cannotAnswer === true) {
+        throwClarifyCannotAnswer(typeof obj.reason === 'string' ? obj.reason : undefined);
+    }
+    let answerRaw;
+    if (obj.answer &&
+        typeof obj.answer === 'object' &&
+        !Array.isArray(obj.answer)) {
+        answerRaw = obj.answer;
+    }
+    else if ('outcome' in obj || 'cannotAnswer' in obj) {
+        throwClarifyCannotAnswer(typeof obj.reason === 'string' ? obj.reason : 'missing_answer');
+    }
+    else {
+        answerRaw = obj;
+    }
+    const filtered = filterClarifyAnswer(answerRaw, answerInterface);
+    if (requiredFieldsMissing(filtered, answerInterface)) {
+        throwClarifyCannotAnswer('required_fields_missing', {
+            answer: filtered,
+        });
+    }
+    return { answer: filtered };
+}
+function clarifiableInputToString(input) {
+    if (input === null || input === undefined) {
+        return '';
+    }
+    if (typeof input === 'string') {
+        return input;
+    }
+    if (typeof input === 'number' ||
+        typeof input === 'boolean' ||
+        typeof input === 'bigint') {
+        return String(input);
+    }
+    if (input instanceof Date) {
+        return input.toISOString();
+    }
+    try {
+        return String(input);
+    }
+    catch {
+        return '';
+    }
+}
+function emptyAnswerFromInterface(answer) {
+    const out = {};
+    for (const field of answer.fields ?? []) {
+        out[field.key] = null;
+    }
+    return out;
+}
+/** Keep only keys declared on the answer interface; sanitize string values fail-closed. */
+function filterClarifyAnswer(raw, answer) {
+    const out = {};
+    const allowed = new Set((answer.fields ?? []).map((f) => f.key));
+    if (!raw || typeof raw !== 'object') {
+        return out;
+    }
+    for (const [key, value] of Object.entries(raw)) {
+        if (!allowed.has(key))
+            continue;
+        if (typeof value === 'string') {
+            const sanitized = (0, prompt_injection_guard_1.sanitizeExtractedFieldValue)(value);
+            if (sanitized === undefined)
+                continue;
+            out[key] = sanitized;
+            continue;
+        }
+        out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=brain-clarify.js.map

package/dist/brain/brain-clarify.js.map

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

package/dist/brain/brain-config.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Application-supplied Brain settings (code layer, not .env).
+ * Secrets (OPENAI_API_KEY / ANTHROPIC_API_KEY / GOOGLE_API_KEY / XAI_API_KEY) stay in the environment.
+ */
+export declare const STUDIO_BRAIN_CONFIG: unique symbol;
+export interface StudioBrainConfig {
+    /**
+     * Adapter-specific cheap whitelist model id.
+     * Omit to use the selected adapter's default (e.g. gpt-4.1-nano, claude-haiku-4-5-…).
+     */
+    model?: string;
+    /** Scan floor (0..1). Below for all candidates → unknown transition. Default 0.4. */
+    confidenceThreshold?: number;
+}
+export type ResolvedStudioBrainConfig = {
+    model?: string;
+    confidenceThreshold: number;
+};
+export declare function resolveStudioBrainConfig(input?: StudioBrainConfig): ResolvedStudioBrainConfig;
+//# sourceMappingURL=brain-config.d.ts.map

package/dist/brain/brain-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-config.d.ts","sourceRoot":"","sources":["../../src/brain/brain-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,KAAK,CAAC,EAAE,iBAAiB,GACxB,yBAAyB,CAS3B"}

package/dist/brain/brain-config.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Application-supplied Brain settings (code layer, not .env).
+ * Secrets (OPENAI_API_KEY / ANTHROPIC_API_KEY / GOOGLE_API_KEY / XAI_API_KEY) stay in the environment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STUDIO_BRAIN_CONFIG = void 0;
+exports.resolveStudioBrainConfig = resolveStudioBrainConfig;
+const brain_ranking_1 = require("./brain-ranking");
+exports.STUDIO_BRAIN_CONFIG = Symbol('STUDIO_BRAIN_CONFIG');
+function resolveStudioBrainConfig(input) {
+    return {
+        model: input?.model?.trim() || undefined,
+        confidenceThreshold: typeof input?.confidenceThreshold === 'number' &&
+            Number.isFinite(input.confidenceThreshold)
+            ? input.confidenceThreshold
+            : brain_ranking_1.DEFAULT_BRAIN_CONFIDENCE_THRESHOLD,
+    };
+}
+//# sourceMappingURL=brain-config.js.map

package/dist/brain/brain-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-config.js","sourceRoot":"","sources":["../../src/brain/brain-config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAqBH,4DAWC;AA9BD,mDAAqE;AAExD,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAiBjE,SAAgB,wBAAwB,CACtC,KAAyB;IAEzB,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,SAAS;QACxC,mBAAmB,EACjB,OAAO,KAAK,EAAE,mBAAmB,KAAK,QAAQ;YAC9C,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC;YACxC,CAAC,CAAC,KAAK,CAAC,mBAAmB;YAC3B,CAAC,CAAC,kDAAkC;KACzC,CAAC;AACJ,CAAC"}

package/dist/brain/brain-judge.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Brain judge — LLM-as-a-judge.
+ * Rare on the live call path; the primary consumer is eval tests.
+ *
+ * Given stringifiable context + a plain-language goal + success/failure
+ * criteria, adapters return pass/fail, reasoning bullets, and confidence.
+ */
+/** Default: no confidence floor — callers opt in via options.confidenceThreshold. */
+export declare const DEFAULT_BRAIN_JUDGE_CONFIDENCE_THRESHOLD = 0;
+/** Confidence as a fixed 6-decimal string, e.g. "0.850000". Always matches /^\d\.\d{6}$/. */
+export declare const CONFIDENCE_6_PATTERN: RegExp;
+export type Confidence6 = string;
+export interface BrainJudgeOptions {
+    /**
+     * 0..1. Does not change `passed` (that is the model judgment).
+     * Sets `belowThreshold` when formatted confidence is below this floor.
+     * Trusted pass = `passed && !belowThreshold`.
+     */
+    confidenceThreshold?: number;
+    /**
+     * OpenAI model id for this call (studio-chatgpt cheap whitelist).
+     * Ignored by mock. Falls back to VapiStudioModule brain.model.
+     */
+    model?: string;
+}
+export interface BrainJudgeRequest<TContext = unknown> {
+    /** Transcript, memory snapshot, or any JSON-serializable eval fixture. */
+    context: TContext;
+    /** What “good” means, in plain language. */
+    goals: string;
+    /** Criteria that must hold for a pass. */
+    successConditions: string[];
+    /** Criteria that force a fail if observed. */
+    failureConditions: string[];
+    options?: BrainJudgeOptions;
+    /** Optional correlation for usage / console (filled by NodeContext). */
+    meta?: {
+        providerCallId?: string;
+        conversationId?: string;
+    };
+}
+export interface BrainJudgeResult {
+    /** Model pass/fail. Threshold is not mixed in; see `belowThreshold`. */
+    passed: boolean;
+    /** Short reasons for why it passed or failed. */
+    reasoning: string[];
+    /** Certainty in [0,1], always 6 decimal places: "0.850000". */
+    confidence: Confidence6;
+    /** True when confidence is below options.confidenceThreshold. */
+    belowThreshold: boolean;
+}
+export declare function resolveJudgeConfidenceThreshold(value: number | undefined): number;
+export declare function clampConfidence(value: unknown): number;
+/** Clamp to [0, 1] and format as `\d.\d\d\d\d\d\d`. */
+export declare function formatConfidence6(value: unknown): Confidence6;
+export declare function isConfidence6(value: string): value is Confidence6;
+export declare function normalizeReasoning(raw: unknown): string[];
+/**
+ * JSON-stringify objects; pass strings through.
+ * Prefer this over clarifiableInputToString so `{foo:1}` is not `[object Object]`.
+ */
+export declare function judgeContextToString(context: unknown): string;
+/**
+ * Normalize raw Brain JSON into a judge result.
+ * `passed` is the model judgment; threshold only sets `belowThreshold`.
+ */
+export declare function normalizeJudgeResult(raw: unknown, options?: BrainJudgeOptions): BrainJudgeResult;
+//# sourceMappingURL=brain-judge.d.ts.map

package/dist/brain/brain-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-judge.d.ts","sourceRoot":"","sources":["../../src/brain/brain-judge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,qFAAqF;AACrF,eAAO,MAAM,wCAAwC,IAAI,CAAC;AAE1D,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,QAAgB,CAAC;AAElD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IACnD,0EAA0E;IAC1E,OAAO,EAAE,QAAQ,CAAC;IAClB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,wEAAwE;IACxE,IAAI,CAAC,EAAE;QACL,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,+DAA+D;IAC/D,UAAU,EAAE,WAAW,CAAC;IACxB,iEAAiE;IACjE,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,CAKR;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAItD;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAE7D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAQzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAsB7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAC1B,gBAAgB,CAmClB"}