@guidify-ai/vapi-studio 0.1.0

package/dist/integrations/integration-client.js

@@ -0,0 +1,152 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationClient = void 0;
+const common_1 = require("@nestjs/common");
+const event_service_1 = require("../events/event.service");
+const studio_event_1 = require("../events/studio-event");
+const jwt_hmac_1 = require("./jwt-hmac");
+const MAX_STORED_BODY_CHARS = 8_192;
+function clipBody(value) {
+    if (value == null)
+        return value;
+    const raw = typeof value === 'string' ? value : JSON.stringify(value);
+    if (raw.length <= MAX_STORED_BODY_CHARS)
+        return value;
+    return `${raw.slice(0, MAX_STORED_BODY_CHARS)}…`;
+}
+function responseHeaders(headers) {
+    const out = {};
+    headers.forEach((value, key) => {
+        out[key] = value;
+    });
+    return out;
+}
+async function parseBody(res) {
+    const text = await res.text();
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+/**
+ * Pre-baked outbound HTTP client: JWT HS256 over the body, `x-signature` header.
+ * Every attempt emits INTEGRATION_REQUEST / RESPONSE / ERROR for listeners.
+ */
+let IntegrationClient = class IntegrationClient {
+    events;
+    constructor(events) {
+        this.events = events;
+    }
+    async request(input) {
+        const method = (input.method ?? 'POST').toUpperCase();
+        const rawBody = method === 'GET' ? '' : (0, jwt_hmac_1.canonicalRequestBody)(input.body);
+        const secret = (0, jwt_hmac_1.readSecretEnv)(input.secretEnvKey);
+        const signed = (0, jwt_hmac_1.signIntegrationRequest)({
+            secret,
+            method,
+            url: input.url,
+            body: rawBody,
+            ttlSeconds: input.ttlSeconds,
+        });
+        const headers = {
+            accept: 'application/json',
+            ...(input.headers ?? {}),
+            [jwt_hmac_1.INTEGRATION_SIGNATURE_HEADER]: signed.token,
+        };
+        if (rawBody && !headers['content-type']) {
+            headers['content-type'] = 'application/json';
+        }
+        const started = Date.now();
+        await this.events.emit({
+            type: studio_event_1.STUDIO_EVENTS.INTEGRATION_REQUEST,
+            conversationId: input.meta?.conversationId,
+            runtimeInstanceId: input.meta?.runtimeInstanceId,
+            providerCallId: input.meta?.providerCallId,
+            payload: {
+                name: input.name,
+                method,
+                url: input.url,
+                secretEnvKey: input.secretEnvKey,
+                headers: { ...headers },
+                body: clipBody(method === 'GET' ? undefined : input.body ?? rawBody),
+                bodySha256: signed.bodySha256,
+                signatureHeader: jwt_hmac_1.INTEGRATION_SIGNATURE_HEADER,
+            },
+        });
+        try {
+            const res = await fetch(input.url, {
+                method,
+                headers,
+                body: rawBody && method !== 'GET' ? rawBody : undefined,
+                signal: AbortSignal.timeout(input.timeoutMs ?? 15_000),
+            });
+            const parsed = await parseBody(res);
+            const durationMs = Date.now() - started;
+            const result = {
+                ok: res.ok,
+                status: res.status,
+                body: parsed,
+                headers: responseHeaders(res.headers),
+                durationMs,
+                bodySha256: signed.bodySha256,
+            };
+            await this.events.emit({
+                type: studio_event_1.STUDIO_EVENTS.INTEGRATION_RESPONSE,
+                level: res.ok ? 'info' : 'warn',
+                conversationId: input.meta?.conversationId,
+                runtimeInstanceId: input.meta?.runtimeInstanceId,
+                providerCallId: input.meta?.providerCallId,
+                payload: {
+                    name: input.name,
+                    method,
+                    url: input.url,
+                    status: result.status,
+                    ok: result.ok,
+                    durationMs,
+                    body: clipBody(result.body),
+                    responseHeaders: result.headers,
+                },
+            });
+            return result;
+        }
+        catch (error) {
+            const durationMs = Date.now() - started;
+            const message = error instanceof Error ? error.message : String(error);
+            await this.events.emit({
+                type: studio_event_1.STUDIO_EVENTS.INTEGRATION_ERROR,
+                level: 'error',
+                conversationId: input.meta?.conversationId,
+                runtimeInstanceId: input.meta?.runtimeInstanceId,
+                providerCallId: input.meta?.providerCallId,
+                payload: {
+                    name: input.name,
+                    method,
+                    url: input.url,
+                    durationMs,
+                    error: message,
+                    bodySha256: signed.bodySha256,
+                },
+            });
+            throw error;
+        }
+    }
+};
+exports.IntegrationClient = IntegrationClient;
+exports.IntegrationClient = IntegrationClient = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [event_service_1.EventService])
+], IntegrationClient);
+//# sourceMappingURL=integration-client.js.map

package/dist/integrations/integration-client.js.map

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

package/dist/integrations/jwt-hmac.d.ts

@@ -0,0 +1,33 @@
+/**
+ * JWT HS256 (HMAC) helpers for outbound integration auth.
+ * No extra dependency — Node crypto only.
+ */
+export declare const INTEGRATION_SIGNATURE_HEADER = "x-signature";
+export interface IntegrationJwtClaims {
+    iat: number;
+    exp: number;
+    method: string;
+    url: string;
+    bodySha256: string;
+}
+export declare function sha256Hex(body: string): string;
+export declare function canonicalRequestBody(body: unknown): string;
+export declare function readSecretEnv(secretEnvKey: string): string;
+export declare function signHs256Jwt(claims: Record<string, unknown>, secret: string): string;
+export declare function verifyHs256Jwt(token: string, secret: string): IntegrationJwtClaims;
+/**
+ * Sign the exact body bytes that will be sent.
+ * JWT is placed on `x-signature` by the integration client.
+ */
+export declare function signIntegrationRequest(input: {
+    secret: string;
+    method: string;
+    url: string;
+    body: string;
+    ttlSeconds?: number;
+}): {
+    token: string;
+    bodySha256: string;
+    claims: IntegrationJwtClaims;
+};
+//# sourceMappingURL=jwt-hmac.d.ts.map

package/dist/integrations/jwt-hmac.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt-hmac.d.ts","sourceRoot":"","sources":["../../src/integrations/jwt-hmac.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,4BAA4B,gBAAgB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAiBD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAK1D;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAa1D;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,GACb,MAAM,CASR;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,oBAAoB,CAsBtB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAiBtE"}

package/dist/integrations/jwt-hmac.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * JWT HS256 (HMAC) helpers for outbound integration auth.
+ * No extra dependency — Node crypto only.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INTEGRATION_SIGNATURE_HEADER = void 0;
+exports.sha256Hex = sha256Hex;
+exports.canonicalRequestBody = canonicalRequestBody;
+exports.readSecretEnv = readSecretEnv;
+exports.signHs256Jwt = signHs256Jwt;
+exports.verifyHs256Jwt = verifyHs256Jwt;
+exports.signIntegrationRequest = signIntegrationRequest;
+const crypto_1 = require("crypto");
+exports.INTEGRATION_SIGNATURE_HEADER = 'x-signature';
+function base64UrlEncode(input) {
+    const buf = typeof input === 'string' ? Buffer.from(input, 'utf8') : input;
+    return buf
+        .toString('base64')
+        .replace(/=/g, '')
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_');
+}
+function base64UrlDecode(input) {
+    const padded = input.replace(/-/g, '+').replace(/_/g, '/');
+    const pad = padded.length % 4 === 0 ? '' : '='.repeat(4 - (padded.length % 4));
+    return Buffer.from(padded + pad, 'base64');
+}
+function sha256Hex(body) {
+    return (0, crypto_1.createHash)('sha256').update(body, 'utf8').digest('hex');
+}
+function canonicalRequestBody(body) {
+    if (body === undefined || body === null)
+        return '';
+    if (typeof body === 'string')
+        return body;
+    if (Buffer.isBuffer(body))
+        return body.toString('utf8');
+    return JSON.stringify(body);
+}
+function readSecretEnv(secretEnvKey) {
+    const key = secretEnvKey.trim();
+    if (!key) {
+        throw new Error('Integration secretEnvKey must be a non-empty .env key name');
+    }
+    const secret = process.env[key];
+    if (!secret) {
+        throw new Error(`Integration HMAC secret missing: process.env.${key} is empty. ` +
+            `Set that .env key for this integration.`);
+    }
+    return secret;
+}
+function signHs256Jwt(claims, secret) {
+    const header = { alg: 'HS256', typ: 'JWT' };
+    const encodedHeader = base64UrlEncode(JSON.stringify(header));
+    const encodedPayload = base64UrlEncode(JSON.stringify(claims));
+    const signingInput = `${encodedHeader}.${encodedPayload}`;
+    const sig = (0, crypto_1.createHmac)('sha256', secret)
+        .update(signingInput)
+        .digest();
+    return `${signingInput}.${base64UrlEncode(sig)}`;
+}
+function verifyHs256Jwt(token, secret) {
+    const parts = token.split('.');
+    if (parts.length !== 3) {
+        throw new Error('Invalid JWT: expected header.payload.signature');
+    }
+    const [encodedHeader, encodedPayload, encodedSig] = parts;
+    const signingInput = `${encodedHeader}.${encodedPayload}`;
+    const expected = (0, crypto_1.createHmac)('sha256', secret).update(signingInput).digest();
+    const actual = base64UrlDecode(encodedSig);
+    if (expected.length !== actual.length || !(0, crypto_1.timingSafeEqual)(expected, actual)) {
+        throw new Error('Invalid JWT HMAC signature');
+    }
+    const payload = JSON.parse(base64UrlDecode(encodedPayload).toString('utf8'));
+    if (!payload || typeof payload !== 'object') {
+        throw new Error('Invalid JWT payload');
+    }
+    const claims = payload;
+    const now = Math.floor(Date.now() / 1000);
+    if (typeof claims.exp === 'number' && now > claims.exp) {
+        throw new Error('JWT expired');
+    }
+    return claims;
+}
+/**
+ * Sign the exact body bytes that will be sent.
+ * JWT is placed on `x-signature` by the integration client.
+ */
+function signIntegrationRequest(input) {
+    const now = Math.floor(Date.now() / 1000);
+    const ttl = input.ttlSeconds ?? 60;
+    const method = input.method.toUpperCase();
+    const bodySha256 = sha256Hex(input.body);
+    const claims = {
+        iat: now,
+        exp: now + ttl,
+        method,
+        url: input.url,
+        bodySha256,
+    };
+    return {
+        token: signHs256Jwt({ ...claims }, input.secret),
+        bodySha256,
+        claims,
+    };
+}
+//# sourceMappingURL=jwt-hmac.js.map

package/dist/integrations/jwt-hmac.js.map

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

package/dist/intention/code-intention.d.ts

@@ -0,0 +1,94 @@
+import type { SupervisedConversation } from '../conversation/supervised-conversation';
+import type { ConversationHistory } from '../conversation/conversation-history';
+import type { ConversationSchema, DefaultConversationSchema, SchemaMemory } from '../conversation/conversation-schema';
+import type { EventService } from '../events/event.service';
+import type { ConversationView } from '../node/agent-node';
+import { INTENTION_RUN_KIND } from './intention-constants';
+import type { IntentionCascadePhase } from './intention-constants';
+export { INTENTION_CASCADE_PHASE, INTENTION_RUN_KIND, ROUTE_RESOLVED_VIA, DEFAULT_FORCE_INTENTION_PRIORITY, } from './intention-constants';
+export type { IntentionCascadePhase, IntentionRunKind, RouteResolvedVia, } from './intention-constants';
+/**
+ * When this intention participates in Supervisor cascade.
+ *
+ * - `force` — evaluate `before()` **before** listen_resolve + Brain; if true, route
+ *   immediately (`resolvedVia: intention_force`). Absolute code freedom for gates.
+ * - `match` — after force cascade / with listen resolve: `match()` may return a
+ *   local confidence and skip Brain for this name.
+ * - `scan` — default; name is a Brain/listen candidate only (lifecycle optional).
+ *
+ * Prefer `INTENTION_CASCADE_PHASE` over raw strings in app code.
+ */
+/**
+ * Optional result of `run()` after this intention is selected.
+ * Prefer `goto` when the intention owns the destination (DRY breach OK).
+ */
+export type IntentionRunResult = {
+    kind: typeof INTENTION_RUN_KIND.Goto;
+    nodeId: string;
+    reason?: string;
+} | {
+    kind: typeof INTENTION_RUN_KIND.Score;
+    confidence: number;
+    priority?: number;
+    reason?: string;
+};
+export interface IntentionContext<TSchema extends ConversationSchema = DefaultConversationSchema> {
+    runtime: SupervisedConversation;
+    conversation: ConversationView<TSchema>;
+    userText: string;
+    events: EventService;
+    memory: SchemaMemory<TSchema>;
+    history: ConversationHistory;
+    visitCount: (nodeId: string) => number;
+    previousNodeId: string | null;
+    /** Active listen intention names (empty when none). */
+    listenIntentionNames: string[];
+}
+/**
+ * Intention = code, like a Node — free to read memory/history/regex and decide.
+ *
+ * Meta (`phase`, `boost`, `priority`, `toNodeId`) lives on the class so cascade
+ * and Brain hints are declared next to the logic, not only in YAML.
+ *
+ * Lifecycle (force / match phases):
+ *   before() → authorize gate (false = skip)
+ *   match()  → optional local confidence (null = defer to Brain)
+ *   run()    → optional goto / score rewrite before Node walk
+ *   after()  → teardown after selection
+ */
+export declare abstract class CodeIntention<TSchema extends ConversationSchema = DefaultConversationSchema> {
+    /** Stable id — same string flow.yaml / listen lists / Brain candidates use. */
+    abstract readonly name: string;
+    /**
+     * Cascade phase. Default `scan` preserves today’s string-only intentions.
+     * Set `force` for Brain-free gates (phone missing, consent gap, …).
+     */
+    phase: IntentionCascadePhase;
+    /** Brain scoring hint (listen/Brain). Does not by itself change walk order. */
+    boost: number;
+    /** Supervisor walk priority when this intention is ranked (default 1). */
+    priority: number;
+    /**
+     * Optional hard destination when force/match wins.
+     * Overridden if `run()` returns `{ kind: INTENTION_RUN_KIND.Goto, nodeId }`.
+     */
+    toNodeId?: string;
+    /** Forensic / diagram label (optional). */
+    reason?: string;
+    before(_ctx: IntentionContext<TSchema>): Promise<boolean>;
+    /**
+     * Local confidence in `[0, 1]`, or `null` to leave scoring to Brain / listen.
+     * Force phase defaults to `1` when `before()` passed and this is not overridden.
+     */
+    match(_ctx: IntentionContext<TSchema>): Promise<number | null>;
+    run(_ctx: IntentionContext<TSchema>): Promise<IntentionRunResult | null>;
+    after(_ctx: IntentionContext<TSchema>): Promise<void>;
+}
+export declare const STUDIO_INTENTION_REGISTRY: unique symbol;
+export type CodeIntentionRegistry = Map<string, CodeIntention<any>>;
+export declare function intentionContextFromRuntime(input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    events: EventService;
+}): IntentionContext;
+//# sourceMappingURL=code-intention.d.ts.map

package/dist/intention/code-intention.d.ts.map

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

package/dist/intention/code-intention.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STUDIO_INTENTION_REGISTRY = exports.CodeIntention = exports.DEFAULT_FORCE_INTENTION_PRIORITY = exports.ROUTE_RESOLVED_VIA = exports.INTENTION_RUN_KIND = exports.INTENTION_CASCADE_PHASE = void 0;
+exports.intentionContextFromRuntime = intentionContextFromRuntime;
+const conversation_history_1 = require("../conversation/conversation-history");
+const intention_constants_1 = require("./intention-constants");
+var intention_constants_2 = require("./intention-constants");
+Object.defineProperty(exports, "INTENTION_CASCADE_PHASE", { enumerable: true, get: function () { return intention_constants_2.INTENTION_CASCADE_PHASE; } });
+Object.defineProperty(exports, "INTENTION_RUN_KIND", { enumerable: true, get: function () { return intention_constants_2.INTENTION_RUN_KIND; } });
+Object.defineProperty(exports, "ROUTE_RESOLVED_VIA", { enumerable: true, get: function () { return intention_constants_2.ROUTE_RESOLVED_VIA; } });
+Object.defineProperty(exports, "DEFAULT_FORCE_INTENTION_PRIORITY", { enumerable: true, get: function () { return intention_constants_2.DEFAULT_FORCE_INTENTION_PRIORITY; } });
+/**
+ * Intention = code, like a Node — free to read memory/history/regex and decide.
+ *
+ * Meta (`phase`, `boost`, `priority`, `toNodeId`) lives on the class so cascade
+ * and Brain hints are declared next to the logic, not only in YAML.
+ *
+ * Lifecycle (force / match phases):
+ *   before() → authorize gate (false = skip)
+ *   match()  → optional local confidence (null = defer to Brain)
+ *   run()    → optional goto / score rewrite before Node walk
+ *   after()  → teardown after selection
+ */
+class CodeIntention {
+    /**
+     * Cascade phase. Default `scan` preserves today’s string-only intentions.
+     * Set `force` for Brain-free gates (phone missing, consent gap, …).
+     */
+    phase = intention_constants_1.INTENTION_CASCADE_PHASE.Scan;
+    /** Brain scoring hint (listen/Brain). Does not by itself change walk order. */
+    boost = 0;
+    /** Supervisor walk priority when this intention is ranked (default 1). */
+    priority = 1;
+    /**
+     * Optional hard destination when force/match wins.
+     * Overridden if `run()` returns `{ kind: INTENTION_RUN_KIND.Goto, nodeId }`.
+     */
+    toNodeId;
+    /** Forensic / diagram label (optional). */
+    reason;
+    async before(_ctx) {
+        return true;
+    }
+    /**
+     * Local confidence in `[0, 1]`, or `null` to leave scoring to Brain / listen.
+     * Force phase defaults to `1` when `before()` passed and this is not overridden.
+     */
+    async match(_ctx) {
+        return this.phase === intention_constants_1.INTENTION_CASCADE_PHASE.Force ? 1 : null;
+    }
+    async run(_ctx) {
+        if (this.toNodeId) {
+            return {
+                kind: intention_constants_1.INTENTION_RUN_KIND.Goto,
+                nodeId: this.toNodeId,
+                reason: this.reason,
+            };
+        }
+        return null;
+    }
+    async after(_ctx) {
+        // no-op
+    }
+}
+exports.CodeIntention = CodeIntention;
+exports.STUDIO_INTENTION_REGISTRY = Symbol('STUDIO_INTENTION_REGISTRY');
+function intentionContextFromRuntime(input) {
+    const { runtime, userText, events } = input;
+    const memory = runtime.memory;
+    const variables = runtime.variables;
+    return {
+        runtime,
+        conversation: {
+            id: runtime.conversationId ?? '',
+            providerCallId: runtime.providerCallId,
+            flowId: runtime.flowId,
+            variables,
+            memory,
+        },
+        userText,
+        events,
+        memory,
+        history: runtime.history,
+        visitCount: (nodeId) => (0, conversation_history_1.countNodeVisits)(runtime.history, nodeId),
+        previousNodeId: (0, conversation_history_1.lastVisitedNodeId)(runtime.history),
+        listenIntentionNames: (runtime.listenExpectation?.intentions ?? []).map((i) => i.name),
+    };
+}
+//# sourceMappingURL=code-intention.js.map

package/dist/intention/code-intention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-intention.js","sourceRoot":"","sources":["../../src/intention/code-intention.ts"],"names":[],"mappings":";;;AAuJA,kEA2BC;AAhLD,+EAG8C;AAS9C,+DAG+B;AAK/B,6DAK+B;AAJ7B,8HAAA,uBAAuB,OAAA;AACvB,yHAAA,kBAAkB,OAAA;AAClB,yHAAA,kBAAkB,OAAA;AAClB,uIAAA,gCAAgC,OAAA;AAoDlC;;;;;;;;;;;GAWG;AACH,MAAsB,aAAa;IAMjC;;;OAGG;IACI,KAAK,GAA0B,6CAAuB,CAAC,IAAI,CAAC;IAEnE,+EAA+E;IACxE,KAAK,GAAW,CAAC,CAAC;IAEzB,0EAA0E;IACnE,QAAQ,GAAW,CAAC,CAAC;IAE5B;;;OAGG;IACI,QAAQ,CAAU;IAEzB,2CAA2C;IACpC,MAAM,CAAU;IAEhB,KAAK,CAAC,MAAM,CAAC,IAA+B;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,KAAK,CAAC,IAA+B;QAChD,OAAO,IAAI,CAAC,KAAK,KAAK,6CAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,CAAC;IAEM,KAAK,CAAC,GAAG,CACd,IAA+B;QAE/B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,IAAI,EAAE,wCAAkB,CAAC,IAAI;gBAC7B,MAAM,EAAE,IAAI,CAAC,QAAQ;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,IAA+B;QAChD,QAAQ;IACV,CAAC;CACF;AAvDD,sCAuDC;AAEY,QAAA,yBAAyB,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAI7E,SAAgB,2BAA2B,CAAC,KAI3C;IACC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAiD,CAAC;IACzE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAuD,CAAC;IAClF,OAAO;QACL,OAAO;QACP,YAAY,EAAE;YACZ,EAAE,EAAE,OAAO,CAAC,cAAc,IAAI,EAAE;YAChC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS;YACT,MAAM;SACP;QACD,QAAQ;QACR,MAAM;QACN,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,sCAAe,EAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC;QAChE,cAAc,EAAE,IAAA,wCAAiB,EAAC,OAAO,CAAC,OAAO,CAAC;QAClD,oBAAoB,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CACrE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CACd;KACF,CAAC;AACJ,CAAC"}

package/dist/intention/intention-constants.d.ts

@@ -0,0 +1,37 @@
+/** Supervisor cascade phase for a code intention class. */
+export declare const INTENTION_CASCADE_PHASE: {
+    /** Evaluate before listen resolve + Brain; route on `before()` / `run()`. */
+    readonly Force: "force";
+    /** Local `match()` confidence; may skip Brain for this name. */
+    readonly Match: "match";
+    /** Default — name is a Brain / listen candidate only. */
+    readonly Scan: "scan";
+};
+export type IntentionCascadePhase = (typeof INTENTION_CASCADE_PHASE)[keyof typeof INTENTION_CASCADE_PHASE];
+/** Result discriminator from `CodeIntention.run()`. */
+export declare const INTENTION_RUN_KIND: {
+    readonly Goto: "goto";
+    readonly Score: "score";
+};
+export type IntentionRunKind = (typeof INTENTION_RUN_KIND)[keyof typeof INTENTION_RUN_KIND];
+/**
+ * `ROUTE_DECISION` / turn forensics — how the supervisor picked the next node.
+ * Apps may emit additional strings; these are the framework-defined values.
+ */
+export declare const ROUTE_RESOLVED_VIA: {
+    readonly ConditionForce: "condition_force";
+    readonly ConditionBoost: "condition_boost";
+    readonly IntentionForce: "intention_force";
+    readonly IntentionMatch: "intention_match";
+    readonly ListenResolve: "listen_resolve";
+    readonly Brain: "brain";
+    readonly ForceIntention: "force_intention";
+    readonly Continue: "continue";
+    /** Unknown portal restatement accepted against the origin listen. */
+    readonly UnknownOriginConsume: "unknown_origin_consume";
+    readonly RouteFallbackUnknown: "route_fallback_unknown";
+};
+export type RouteResolvedVia = (typeof ROUTE_RESOLVED_VIA)[keyof typeof ROUTE_RESOLVED_VIA];
+/** Walk priority for force gates that must beat normal flow (phone missing, consent gap, …). */
+export declare const DEFAULT_FORCE_INTENTION_PRIORITY = 1000000;
+//# sourceMappingURL=intention-constants.d.ts.map

package/dist/intention/intention-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intention-constants.d.ts","sourceRoot":"","sources":["../../src/intention/intention-constants.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB;IAClC,6EAA6E;;IAE7E,gEAAgE;;IAEhE,yDAAyD;;CAEjD,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC;AAEzE,uDAAuD;AACvD,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;IAS7B,qEAAqE;;;CAG7D,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,gGAAgG;AAChG,eAAO,MAAM,gCAAgC,UAAY,CAAC"}

package/dist/intention/intention-constants.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_FORCE_INTENTION_PRIORITY = exports.ROUTE_RESOLVED_VIA = exports.INTENTION_RUN_KIND = exports.INTENTION_CASCADE_PHASE = void 0;
+/** Supervisor cascade phase for a code intention class. */
+exports.INTENTION_CASCADE_PHASE = {
+    /** Evaluate before listen resolve + Brain; route on `before()` / `run()`. */
+    Force: 'force',
+    /** Local `match()` confidence; may skip Brain for this name. */
+    Match: 'match',
+    /** Default — name is a Brain / listen candidate only. */
+    Scan: 'scan',
+};
+/** Result discriminator from `CodeIntention.run()`. */
+exports.INTENTION_RUN_KIND = {
+    Goto: 'goto',
+    Score: 'score',
+};
+/**
+ * `ROUTE_DECISION` / turn forensics — how the supervisor picked the next node.
+ * Apps may emit additional strings; these are the framework-defined values.
+ */
+exports.ROUTE_RESOLVED_VIA = {
+    ConditionForce: 'condition_force',
+    ConditionBoost: 'condition_boost',
+    IntentionForce: 'intention_force',
+    IntentionMatch: 'intention_match',
+    ListenResolve: 'listen_resolve',
+    Brain: 'brain',
+    ForceIntention: 'force_intention',
+    Continue: 'continue',
+    /** Unknown portal restatement accepted against the origin listen. */
+    UnknownOriginConsume: 'unknown_origin_consume',
+    RouteFallbackUnknown: 'route_fallback_unknown',
+};
+/** Walk priority for force gates that must beat normal flow (phone missing, consent gap, …). */
+exports.DEFAULT_FORCE_INTENTION_PRIORITY = 1_000_000;
+//# sourceMappingURL=intention-constants.js.map

package/dist/intention/intention-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intention-constants.js","sourceRoot":"","sources":["../../src/intention/intention-constants.ts"],"names":[],"mappings":";;;AAAA,2DAA2D;AAC9C,QAAA,uBAAuB,GAAG;IACrC,6EAA6E;IAC7E,KAAK,EAAE,OAAO;IACd,gEAAgE;IAChE,KAAK,EAAE,OAAO;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM;CACJ,CAAC;AAKX,uDAAuD;AAC1C,QAAA,kBAAkB,GAAG;IAChC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACN,CAAC;AAKX;;;GAGG;AACU,QAAA,kBAAkB,GAAG;IAChC,cAAc,EAAE,iBAAiB;IACjC,cAAc,EAAE,iBAAiB;IACjC,cAAc,EAAE,iBAAiB;IACjC,cAAc,EAAE,iBAAiB;IACjC,aAAa,EAAE,gBAAgB;IAC/B,KAAK,EAAE,OAAO;IACd,cAAc,EAAE,iBAAiB;IACjC,QAAQ,EAAE,UAAU;IACpB,qEAAqE;IACrE,oBAAoB,EAAE,wBAAwB;IAC9C,oBAAoB,EAAE,wBAAwB;CACtC,CAAC;AAKX,gGAAgG;AACnF,QAAA,gCAAgC,GAAG,SAAS,CAAC"}

package/dist/intentions/standard-intentions.d.ts

@@ -0,0 +1,26 @@
+/** Framework-standard intention ids (use in flow.yaml and portal nodes). */
+export declare const STANDARD_INTENTIONS: {
+    readonly isGoodbye: "studio.isGoodbye";
+    readonly isTransferToHuman: "studio.isTransferToHuman";
+    readonly isPause: "studio.isPause";
+    /** Caller is angry / mad — handle as a standalone portal, not normal flow. */
+    readonly isMad: "studio.isMad";
+    /**
+     * No candidate intention cleared the confidence threshold.
+     * Standalone portal — ask to clarify / recover.
+     */
+    readonly isUnknownTransition: "studio.isUnknownTransition";
+    /** Affirmative answer (yes / correct / sure / okay). */
+    readonly isPositive: "studio.isPositive";
+    /** Negative answer (no / incorrect / decline). */
+    readonly isNegative: "studio.isNegative";
+    /**
+     * Caller went silent — Vapi idle hook / Studio timer injects this portal.
+     * Ask “still there?” twice, then endCall.
+     */
+    readonly isStillThere: "studio.isStillThere";
+    /** Synthetic: channel delivered tool results for the pending toolCall. */
+    readonly isToolResult: "studio.isToolResult";
+};
+export type StandardIntention = (typeof STANDARD_INTENTIONS)[keyof typeof STANDARD_INTENTIONS];
+//# sourceMappingURL=standard-intentions.d.ts.map

package/dist/intentions/standard-intentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-intentions.d.ts","sourceRoot":"","sources":["../../src/intentions/standard-intentions.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB;;;;IAI9B,8EAA8E;;IAE9E;;;OAGG;;IAEH,wDAAwD;;IAExD,kDAAkD;;IAElD;;;OAGG;;IAEH,0EAA0E;;CAElE,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAC3B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC"}