@runcore-sh/runcore 0.3.1 → 0.4.0

package/dist/onboarding/conversation.js.map

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

package/dist/onboarding/flow.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Onboarding Flow — the main orchestrator.
+ *
+ * Under 5 minutes, zero forms. Conversational state machine that walks
+ * a new human through: greeting → safe word → calibration → bootstrap → nerve link.
+ *
+ * Portable: identity pairing and nerve spawning are injectable interfaces.
+ */
+import { CalibrationRunner } from "../calibration/runner.js";
+import { type OnboardingState, type OnboardingPhase, type OnboardingMessage, type OnboardingListener } from "./types.js";
+import { type IdentityPairer } from "./bootstrap.js";
+import { type NerveLinkManager } from "./nerve-link.js";
+export declare class OnboardingFlow {
+    private state;
+    private listeners;
+    private calibrationRunner;
+    private nerveLinkManager;
+    private identityPairer;
+    /** Sub-phase state for multi-step phases */
+    private safeWordStep;
+    private pendingSafeWord;
+    /** Recovery question sub-flow state */
+    private recoveryStep;
+    private pendingRecoveryQuestion;
+    private pendingRecoveryAnswer;
+    /** Conversation log */
+    private messages;
+    /** Pairing code from server startup (needed for identity creation) */
+    private pairingCode;
+    constructor(options?: {
+        pairingCode?: string;
+        calibrationRunner?: CalibrationRunner;
+        nerveLinkManager?: NerveLinkManager | null;
+        identityPairer?: IdentityPairer;
+    });
+    onEvent(listener: OnboardingListener): void;
+    private emit;
+    private agentMessage;
+    private recordHuman;
+    private advanceTo;
+    /**
+     * Start the onboarding flow. Returns the first agent message (greeting).
+     */
+    start(): string;
+    /**
+     * Process a human response. Returns the agent's reply.
+     * Drives the state machine forward through phases.
+     */
+    respond(input: string): Promise<string>;
+    private handleGreeting;
+    private handleSafeWord;
+    private handleRecoveryQuestion;
+    private startCalibration;
+    private handleCalibration;
+    private finishCalibrationAndBootstrap;
+    private handleNerveLink;
+    private completeOnboarding;
+    getState(): OnboardingState;
+    getMessages(): OnboardingMessage[];
+    isComplete(): boolean;
+    currentPhase(): OnboardingPhase;
+}
+//# sourceMappingURL=flow.d.ts.map

package/dist/onboarding/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/onboarding/flow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAEtB,KAAK,kBAAkB,EAGxB,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AA2CxE,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,cAAc,CAA6B;IAEnD,4CAA4C;IAC5C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,eAAe,CAAuB;IAE9C,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,qBAAqB,CAAuB;IAEpD,uBAAuB;IACvB,OAAO,CAAC,QAAQ,CAA2B;IAE3C,sEAAsE;IACtE,OAAO,CAAC,WAAW,CAAgB;gBAEvB,OAAO,GAAE;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAC3C,cAAc,CAAC,EAAE,cAAc,CAAC;KAC5B;IAUN,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAI3C,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,KAAK,IAAI,MAAM;IAKf;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB7C,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,sBAAsB;IA+C9B,OAAO,CAAC,gBAAgB;YAKV,iBAAiB;YA4BjB,6BAA6B;YAsB7B,eAAe;IAgC7B,OAAO,CAAC,kBAAkB;IAkB1B,QAAQ,IAAI,eAAe;IAC3B,WAAW,IAAI,iBAAiB,EAAE;IAClC,UAAU,IAAI,OAAO;IACrB,YAAY,IAAI,eAAe;CAChC"}

package/dist/onboarding/flow.js

@@ -0,0 +1,287 @@
+/**
+ * Onboarding Flow — the main orchestrator.
+ *
+ * Under 5 minutes, zero forms. Conversational state machine that walks
+ * a new human through: greeting → safe word → calibration → bootstrap → nerve link.
+ *
+ * Portable: identity pairing and nerve spawning are injectable interfaces.
+ */
+import { createLogger } from "../utils/logger.js";
+import { CalibrationRunner } from "../calibration/runner.js";
+import { createInitialState, } from "./types.js";
+import { validateSafeWord, safeWordsMatch, assessStrength, strengthMessage, } from "./safe-word.js";
+import { bootstrapAgent } from "./bootstrap.js";
+import { offerNerveLink } from "./nerve-link.js";
+import { extractName as extractNameFromModule } from "./name-extraction.js";
+const log = createLogger("onboarding:flow");
+// ── Agent messages ─────────────────────────────────────────────────────────
+const GREETING = `Hey — I'm your agent. I don't have a name yet; you'll give me one later if you want. Right now I just need to learn a few things about you so I can start working.\n\nWhat should I call you?`;
+const SAFE_WORD_ASK = (name) => `Nice to meet you, ${name}. Next I need a safe word — a phrase only you know. This is how you'll prove it's you on any device. No passwords, no accounts, just this word.\n\nPick something memorable. What's your safe word?`;
+const SAFE_WORD_CONFIRM = "Say it one more time to confirm.";
+const SAFE_WORD_MISMATCH = "Those didn't match. Let's try again — what's your safe word?";
+const RECOVERY_ASK_QUESTION = "One more security step. Pick a recovery question — something only you'd know the answer to. If you ever forget your safe word, this is how you'll get back in.\n\nWhat's your question? (Or say \"skip\" to set this up later.)";
+const RECOVERY_ASK_ANSWER = (question) => `Got it: "${question}"\n\nWhat's the answer?`;
+const RECOVERY_CONFIRM_ANSWER = "Say the answer one more time to confirm.";
+const RECOVERY_MISMATCH = "Those didn't match. What's your answer?";
+const RECOVERY_SET = "Locked. If you forget your safe word, that question will get you back in.\n\n";
+const RECOVERY_SKIPPED = "No problem — you can set one up later.\n\n";
+const CALIBRATION_INTRO = "Now I need to learn how you like to work. I'll ask a few quick questions — just answer naturally.\n\n";
+const NERVE_LINK_OFFER = "Your brain is live on this device. Want to connect another device right now? I'll generate a link you can open on your phone, tablet, or watch. Just say yes or skip.";
+const COMPLETE_MESSAGE = (name) => `You're set, ${name}. Your brain is live, your safe word is locked, and I know how you like to work. Three dots — sense, work, joy — are running. I'll start quiet and ramp up as I learn.\n\nSay anything when you're ready.`;
+// ── Flow class ─────────────────────────────────────────────────────────────
+export class OnboardingFlow {
+    state;
+    listeners = [];
+    calibrationRunner;
+    nerveLinkManager;
+    identityPairer;
+    /** Sub-phase state for multi-step phases */
+    safeWordStep = "ask";
+    pendingSafeWord = null;
+    /** Recovery question sub-flow state */
+    recoveryStep = "ask_question";
+    pendingRecoveryQuestion = null;
+    pendingRecoveryAnswer = null;
+    /** Conversation log */
+    messages = [];
+    /** Pairing code from server startup (needed for identity creation) */
+    pairingCode;
+    constructor(options = {}) {
+        this.state = createInitialState();
+        this.pairingCode = options.pairingCode ?? null;
+        this.calibrationRunner = options.calibrationRunner ?? new CalibrationRunner();
+        this.nerveLinkManager = options.nerveLinkManager ?? null;
+        this.identityPairer = options.identityPairer;
+    }
+    // ── Event system ──────────────────────────────────────────────────────
+    onEvent(listener) {
+        this.listeners.push(listener);
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            listener(event);
+        }
+    }
+    // ── Message tracking ──────────────────────────────────────────────────
+    agentMessage(content) {
+        this.messages.push({
+            role: "agent",
+            content,
+            phase: this.state.phase,
+            ts: new Date().toISOString(),
+        });
+        return content;
+    }
+    recordHuman(content) {
+        this.messages.push({
+            role: "human",
+            content,
+            phase: this.state.phase,
+            ts: new Date().toISOString(),
+        });
+    }
+    // ── Phase transitions ─────────────────────────────────────────────────
+    advanceTo(phase) {
+        this.state.phase = phase;
+        this.emit({ type: "phase_entered", phase });
+        log.info("Phase entered", { phase });
+    }
+    // ── Public API ────────────────────────────────────────────────────────
+    /**
+     * Start the onboarding flow. Returns the first agent message (greeting).
+     */
+    start() {
+        this.advanceTo("greeting");
+        return this.agentMessage(GREETING);
+    }
+    /**
+     * Process a human response. Returns the agent's reply.
+     * Drives the state machine forward through phases.
+     */
+    async respond(input) {
+        const trimmed = input.trim();
+        this.recordHuman(trimmed);
+        switch (this.state.phase) {
+            case "greeting":
+                return this.handleGreeting(trimmed);
+            case "safe_word":
+                return this.handleSafeWord(trimmed);
+            case "recovery_question":
+                return this.handleRecoveryQuestion(trimmed);
+            case "calibration":
+                return this.handleCalibration(trimmed);
+            case "nerve_link":
+                return this.handleNerveLink(trimmed);
+            case "complete":
+                return this.agentMessage("Onboarding is already complete.");
+            default:
+                return this.agentMessage("Something went wrong. Let's start over.");
+        }
+    }
+    // ── Phase handlers ────────────────────────────────────────────────────
+    handleGreeting(input) {
+        if (!input) {
+            return this.agentMessage("I didn't catch that. What's your name?");
+        }
+        const name = extractName(input);
+        this.state.name = name;
+        this.emit({ type: "name_captured", name });
+        this.advanceTo("safe_word");
+        this.safeWordStep = "ask";
+        return this.agentMessage(SAFE_WORD_ASK(name));
+    }
+    handleSafeWord(input) {
+        if (this.safeWordStep === "ask") {
+            const validation = validateSafeWord(input);
+            if (!validation.valid) {
+                return this.agentMessage(validation.reason);
+            }
+            this.pendingSafeWord = input;
+            this.safeWordStep = "confirm";
+            return this.agentMessage(SAFE_WORD_CONFIRM);
+        }
+        // Confirm step
+        if (!this.pendingSafeWord || !safeWordsMatch(this.pendingSafeWord, input)) {
+            this.pendingSafeWord = null;
+            this.safeWordStep = "ask";
+            return this.agentMessage(SAFE_WORD_MISMATCH);
+        }
+        // Safe word confirmed
+        const strength = assessStrength(this.pendingSafeWord);
+        this.state.safeWordConfirmed = true;
+        this.emit({ type: "safe_word_created" });
+        const msg = strengthMessage(strength);
+        this.advanceTo("recovery_question");
+        this.recoveryStep = "ask_question";
+        return this.agentMessage(msg + "\n\n" + RECOVERY_ASK_QUESTION);
+    }
+    handleRecoveryQuestion(input) {
+        const lower = input.toLowerCase();
+        if (lower === "skip" || lower === "skip it" || lower === "later") {
+            this.emit({ type: "recovery_question_skipped" });
+            this.advanceTo("calibration");
+            return this.startCalibration(RECOVERY_SKIPPED);
+        }
+        switch (this.recoveryStep) {
+            case "ask_question": {
+                if (!input || input.length < 3) {
+                    return this.agentMessage("That's too short for a question. Try something like \"What was my first pet's name?\"");
+                }
+                this.pendingRecoveryQuestion = input;
+                this.recoveryStep = "ask_answer";
+                return this.agentMessage(RECOVERY_ASK_ANSWER(input));
+            }
+            case "ask_answer": {
+                if (!input || input.length < 1) {
+                    return this.agentMessage("I need an answer to lock in. What's the answer to your question?");
+                }
+                this.pendingRecoveryAnswer = input;
+                this.recoveryStep = "confirm_answer";
+                return this.agentMessage(RECOVERY_CONFIRM_ANSWER);
+            }
+            case "confirm_answer": {
+                if (!this.pendingRecoveryAnswer || input.trim().toLowerCase() !== this.pendingRecoveryAnswer.trim().toLowerCase()) {
+                    this.pendingRecoveryAnswer = null;
+                    this.recoveryStep = "ask_answer";
+                    return this.agentMessage(RECOVERY_MISMATCH);
+                }
+                this.state.recoveryQuestionSet = true;
+                this.emit({ type: "recovery_question_set" });
+                this.advanceTo("calibration");
+                return this.startCalibration(RECOVERY_SET);
+            }
+            default:
+                return this.agentMessage("Something went wrong. Let's move on.");
+        }
+    }
+    startCalibration(prefix) {
+        this.emit({ type: "calibration_started" });
+        return this.agentMessage(prefix + "\n\n" + CALIBRATION_INTRO + "Let me know when you're ready and I'll start the questions.");
+    }
+    async handleCalibration(input) {
+        if (!this.calibrationRunner.isActive()) {
+            const firstQuestion = await this.calibrationRunner.start("onboarding");
+            if (!firstQuestion) {
+                return this.finishCalibrationAndBootstrap();
+            }
+            const progress = this.calibrationRunner.progress();
+            return this.agentMessage(`(${progress.current + 1}/${progress.total}) ${firstQuestion.prompt}`);
+        }
+        const result = await this.calibrationRunner.respond(input);
+        if (result.completed) {
+            this.state.calibrated = true;
+            this.emit({ type: "calibration_completed" });
+            const confirmMsg = result.confirmation ? result.confirmation + "\n\n" : "";
+            return this.finishCalibrationAndBootstrap(confirmMsg);
+        }
+        if (result.next) {
+            const progress = this.calibrationRunner.progress();
+            const confirmPrefix = result.confirmation ? result.confirmation + "\n\n" : "";
+            return this.agentMessage(`${confirmPrefix}(${progress.current + 1}/${progress.total}) ${result.next.prompt}`);
+        }
+        return this.agentMessage("I didn't quite get that. Could you try again?");
+    }
+    async finishCalibrationAndBootstrap(prefix) {
+        this.advanceTo("bootstrap");
+        const bootstrapResult = await bootstrapAgent({
+            name: this.state.name,
+            safeWord: this.pendingSafeWord,
+            pairingCode: this.pairingCode,
+            recoveryQuestion: this.pendingRecoveryQuestion,
+            recoveryAnswer: this.pendingRecoveryAnswer,
+            identityPairer: this.identityPairer,
+        });
+        this.state.bootstrapped = true;
+        this.emit({ type: "bootstrap_completed", result: bootstrapResult });
+        this.advanceTo("nerve_link");
+        this.state.nerveLinkOffered = true;
+        const bootstrapMsg = (prefix ?? "") + NERVE_LINK_OFFER;
+        return this.agentMessage(bootstrapMsg);
+    }
+    async handleNerveLink(input) {
+        const lower = input.toLowerCase();
+        if (lower.includes("skip") || lower.includes("no") || lower.includes("later") || lower.includes("nah")) {
+            this.emit({ type: "nerve_link_skipped" });
+            return this.completeOnboarding();
+        }
+        if (lower.includes("yes") || lower.includes("yeah") || lower.includes("sure") || lower.includes("ok")) {
+            if (!this.nerveLinkManager) {
+                this.emit({ type: "nerve_link_skipped" });
+                return this.completeOnboarding();
+            }
+            const offer = offerNerveLink(this.nerveLinkManager);
+            this.emit({ type: "nerve_link_offered", offer });
+            const minutes = Math.round((offer.expiresAt - Date.now()) / 60_000);
+            return this.agentMessage(`Open this link on your other device:\n\n${offer.url}\n\nIt's good for ${minutes} minutes. Enter your safe word when prompted. Say "done" when you've connected, or "skip" to move on.`);
+        }
+        if (lower.includes("done") || lower.includes("connected")) {
+            this.state.nerveLinkCompleted = true;
+            this.emit({ type: "nerve_link_completed", nerveId: "pending-verification" });
+            return this.completeOnboarding();
+        }
+        return this.agentMessage("Just say yes to connect another device, or skip to finish up.");
+    }
+    completeOnboarding() {
+        this.advanceTo("complete");
+        this.state.completedAt = new Date().toISOString();
+        const durationMs = Date.now() - new Date(this.state.startedAt).getTime();
+        this.emit({ type: "onboarding_completed", durationMs });
+        log.info("Onboarding complete", {
+            name: this.state.name,
+            durationMs,
+            nerveLinkCompleted: this.state.nerveLinkCompleted,
+        });
+        return this.agentMessage(COMPLETE_MESSAGE(this.state.name));
+    }
+    // ── State queries ─────────────────────────────────────────────────────
+    getState() { return { ...this.state }; }
+    getMessages() { return [...this.messages]; }
+    isComplete() { return this.state.phase === "complete"; }
+    currentPhase() { return this.state.phase; }
+}
+// ── Helpers ────────────────────────────────────────────────────────────────
+function extractName(input) {
+    const result = extractNameFromModule(input);
+    return result.name ?? input.trim();
+}
+//# sourceMappingURL=flow.js.map

package/dist/onboarding/flow.js.map

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

package/dist/onboarding/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Onboarding module — under 5 minutes, zero forms.
+ *
+ * Conversational flow: greeting → safe word → calibration → bootstrap → nerve link.
+ * Produces a paired human identity, calibrated thresholds, Founder archetype,
+ * initialized pulse dots, and optional cross-device nerve link.
+ */
+export { OnboardingFlow } from "./flow.js";
+export { OnboardingConversation, extractName, type SafeWordStep, type SafeWordResult, type SafeWordResponse, } from "./conversation.js";
+export { extractName as extractNameFull, validateName, type NameExtractionResult, type NameValidationResult, } from "./name-extraction.js";
+export { validateSafeWord, safeWordsMatch, hashSafeWord, generateSalt, assessStrength, strengthMessage, type SafeWordStrength, } from "./safe-word.js";
+export { bootstrapAgent, type BootstrapInput, type IdentityPairer, type PairResult } from "./bootstrap.js";
+export { offerNerveLink, type NerveLinkManager, } from "./nerve-link.js";
+export { PhaseManager, PHASE_SEQUENCE, PHASE_DEFINITIONS, phaseIndex, isValidPhase, isValidTransition, nextPhase, isFirstPhase, isFinalPhase, phasesBefore, phasesAfter, type PhaseDefinition, type PhaseEvent, type PhaseEventListener, } from "./phases.js";
+export type { OnboardingPhase, OnboardingState, OnboardingMessage, MessageRole, SafeWordRules, SafeWordValidation, BootstrapResult, PulseDotInit, NerveLinkOffer, OnboardingEvent, OnboardingListener, Archetype, NerveProfile, } from "./types.js";
+export { PHASE_ORDER, SAFE_WORD_RULES, INITIAL_PULSE_DOTS, createInitialState, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/onboarding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,WAAW,IAAI,eAAe,EAC9B,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG3G,OAAO,EACL,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/onboarding/index.js

@@ -0,0 +1,23 @@
+/**
+ * Onboarding module — under 5 minutes, zero forms.
+ *
+ * Conversational flow: greeting → safe word → calibration → bootstrap → nerve link.
+ * Produces a paired human identity, calibrated thresholds, Founder archetype,
+ * initialized pulse dots, and optional cross-device nerve link.
+ */
+// ── Flow orchestrator ──────────────────────────────────────────────────────
+export { OnboardingFlow } from "./flow.js";
+// ── Conversation engine ──────────────────────────────────────────────────
+export { OnboardingConversation, extractName, } from "./conversation.js";
+// ── Name extraction ──────────────────────────────────────────────────────
+export { extractName as extractNameFull, validateName, } from "./name-extraction.js";
+// ── Safe word ──────────────────────────────────────────────────────────────
+export { validateSafeWord, safeWordsMatch, hashSafeWord, generateSalt, assessStrength, strengthMessage, } from "./safe-word.js";
+// ── Bootstrap ──────────────────────────────────────────────────────────────
+export { bootstrapAgent } from "./bootstrap.js";
+// ── Nerve link ─────────────────────────────────────────────────────────────
+export { offerNerveLink, } from "./nerve-link.js";
+// ── Phases ──────────────────────────────────────────────────────────────────
+export { PhaseManager, PHASE_SEQUENCE, PHASE_DEFINITIONS, phaseIndex, isValidPhase, isValidTransition, nextPhase, isFirstPhase, isFinalPhase, phasesBefore, phasesAfter, } from "./phases.js";
+export { PHASE_ORDER, SAFE_WORD_RULES, INITIAL_PULSE_DOTS, createInitialState, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/onboarding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,4EAA4E;AAC5E,OAAO,EACL,sBAAsB,EACtB,WAAW,GAIZ,MAAM,mBAAmB,CAAC;AAE3B,4EAA4E;AAC5E,OAAO,EACL,WAAW,IAAI,eAAe,EAC9B,YAAY,GAGb,MAAM,sBAAsB,CAAC;AAE9B,8EAA8E;AAC9E,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,GAEhB,MAAM,gBAAgB,CAAC;AAExB,8EAA8E;AAC9E,OAAO,EAAE,cAAc,EAA6D,MAAM,gBAAgB,CAAC;AAE3G,8EAA8E;AAC9E,OAAO,EACL,cAAc,GAEf,MAAM,iBAAiB,CAAC;AAEzB,+EAA+E;AAC/E,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,GAIZ,MAAM,aAAa,CAAC;AAmBrB,OAAO,EACL,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/onboarding/name-extraction.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Onboarding — Name extraction and validation.
+ *
+ * Handles the greeting phase: extract a human name from free-text input,
+ * validate it, and return a confidence-scored result.
+ */
+export interface NameExtractionResult {
+    name: string | null;
+    confidence: "high" | "medium" | "low";
+    source: "explicit" | "bare" | "context";
+}
+export interface NameValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Extract a name from free-text input.
+ *
+ * Handles:
+ * - "My name is Bryant" → high confidence, explicit
+ * - "I'm Bryant" → high confidence, explicit
+ * - "Call me B" → high confidence, explicit
+ * - "Everyone calls me B" → medium confidence, explicit
+ * - "Dr. Sarah Chen" → medium confidence, bare (title stripped)
+ * - "Bryant" → medium confidence, bare
+ * - "Bryant Herrman" → medium confidence, bare (multi-word)
+ * - "hey there, Bryant here" → low confidence, context
+ * - Empty/garbage → null, low confidence
+ */
+export declare function extractName(message: string): NameExtractionResult;
+/**
+ * Validate an extracted name.
+ *
+ * Rules:
+ * - Length between 1 and 50 characters
+ * - Contains at least one letter
+ * - Only contains letters, spaces, hyphens, apostrophes, and periods
+ * - No offensive content
+ * - Not a single common non-name word
+ */
+export declare function validateName(name: string): NameValidationResult;
+//# sourceMappingURL=name-extraction.d.ts.map

package/dist/onboarding/name-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-extraction.d.ts","sourceRoot":"","sources":["../../src/onboarding/name-extraction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyFD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAwDjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAuB/D"}