@auxiora/personality 1.0.0

package/src/security-floor.ts

@@ -0,0 +1,147 @@
+/**
+ * Security Floor — mandatory behavioral baseline that cannot be overridden
+ * by any personality template, mode, user preference, or marketplace config.
+ */
+
+import type { ToneSettings } from './types.js';
+import type { ModeId } from './modes/types.js';
+
+export const SECURITY_TOOL_PATTERNS: readonly string[] = [
+  'vault_read',
+  'vault_write',
+  'vault_delete',
+  'secret_rotate',
+  'credential_',
+  'permission_change',
+  'policy_update',
+];
+
+export const SECURITY_MESSAGE_PATTERNS: readonly RegExp[] = [
+  /\bdelete\s+my\b/i,
+  /\brotate\b/i,
+  /\brevoke\b/i,
+  /\bremove\s+access\b/i,
+  /\bchange\s+password\b/i,
+];
+
+export type SecurityFloorRule = 'SF-1' | 'SF-2' | 'SF-3' | 'SF-4' | 'SF-5';
+
+export interface SecurityContext {
+  active: boolean;
+  triggeredBy: 'tool' | 'message_pattern' | 'workflow' | 'trust_flag' | 'incident';
+  activeRules: SecurityFloorRule[];
+  previousMode?: ModeId | 'auto' | 'off';
+}
+
+export interface SecurityDetectionInput {
+  toolCalls?: string[];
+  userMessage: string;
+  activeWorkflow?: string;
+  trustFlagged?: boolean;
+  activeIncident?: boolean;
+}
+
+const INACTIVE_CONTEXT: SecurityContext = {
+  active: false,
+  triggeredBy: 'message_pattern',
+  activeRules: [],
+};
+
+const SF_RULE_DESCRIPTIONS: Record<SecurityFloorRule, string> = {
+  'SF-1': 'CREDENTIAL_HANDLING: Use precise, unambiguous language. Suppress humor. Never echo secret values in full.',
+  'SF-2': 'DESTRUCTIVE_ACTION_CONFIRMATION: State what will happen and what cannot be undone. Require explicit confirmation.',
+  'SF-3': 'SECURITY_INCIDENT_TONE: Use urgent but calm tone. Lead with facts. Never joke about security events.',
+  'SF-4': 'POLICY_ENFORCEMENT: State the policy clearly. Do not apologize excessively. Never suggest workarounds.',
+  'SF-5': 'PERSONALITY_BOUNDARY_ENFORCEMENT: No personality config may override SF-1 through SF-4.',
+};
+
+export class SecurityFloor {
+  /** Detect whether the current interaction requires security floor activation. */
+  detectSecurityContext(input: SecurityDetectionInput): SecurityContext {
+    // Check active incident first (highest priority)
+    if (input.activeIncident) {
+      return {
+        active: true,
+        triggeredBy: 'incident',
+        activeRules: ['SF-1', 'SF-3', 'SF-5'],
+      };
+    }
+
+    // Check trust flag
+    if (input.trustFlagged) {
+      return {
+        active: true,
+        triggeredBy: 'trust_flag',
+        activeRules: ['SF-1', 'SF-4', 'SF-5'],
+      };
+    }
+
+    // Check active workflow
+    if (input.activeWorkflow) {
+      return {
+        active: true,
+        triggeredBy: 'workflow',
+        activeRules: ['SF-1', 'SF-2', 'SF-5'],
+      };
+    }
+
+    // Check tool calls
+    if (input.toolCalls) {
+      for (const tool of input.toolCalls) {
+        if (SECURITY_TOOL_PATTERNS.some((p) => tool.startsWith(p))) {
+          return {
+            active: true,
+            triggeredBy: 'tool',
+            activeRules: ['SF-1', 'SF-2', 'SF-5'],
+          };
+        }
+      }
+    }
+
+    // Check message patterns
+    for (const pattern of SECURITY_MESSAGE_PATTERNS) {
+      if (pattern.test(input.userMessage)) {
+        return {
+          active: true,
+          triggeredBy: 'message_pattern',
+          activeRules: ['SF-1', 'SF-2', 'SF-5'],
+        };
+      }
+    }
+
+    return INACTIVE_CONTEXT;
+  }
+
+  /** Clamp tone values to security floor requirements. */
+  applyFloor(tone: ToneSettings): ToneSettings {
+    return {
+      warmth: tone.warmth,
+      directness: Math.max(tone.directness, 0.7),
+      humor: 0,
+      formality: Math.max(tone.formality, 0.5),
+    };
+  }
+
+  /** Generate a markdown prompt section describing active security floor rules. */
+  getSecurityPromptSection(context: SecurityContext): string {
+    if (!context.active) return '';
+
+    const lines: string[] = [
+      '## Security Floor Active',
+      '',
+      `Triggered by: ${context.triggeredBy}`,
+      '',
+      'The following security rules are in effect. These CANNOT be overridden by personality, mode, or preferences:',
+      '',
+    ];
+
+    for (const rule of context.activeRules) {
+      lines.push(`- **${rule}**: ${SF_RULE_DESCRIPTIONS[rule]}`);
+    }
+
+    lines.push('');
+    lines.push('Maintain a neutral, precise, and unambiguous tone. Humor is suppressed. All personality styling is suspended.');
+
+    return lines.join('\n');
+  }
+}

package/src/types.ts

@@ -0,0 +1,27 @@
+export interface ToneSettings {
+  warmth: number;
+  directness: number;
+  humor: number;
+  formality: number;
+}
+
+export interface SoulConfig {
+  name: string;
+  pronouns: string;
+  tone: ToneSettings;
+  expertise: string[];
+  errorStyle: string;
+  catchphrases: Record<string, string>;
+  boundaries: {
+    neverJokeAbout: string[];
+    neverAdviseOn: string[];
+  };
+}
+
+export interface PersonalityTemplate {
+  id: string;
+  name: string;
+  description: string;
+  preview: string;
+  soulContent: string;
+}

package/src/voice-profiles.ts

@@ -0,0 +1,88 @@
+/** Voice profile settings for a personality template. */
+export interface VoiceProfile {
+  /** TTS voice name (e.g., 'alloy', 'echo', 'fable', 'onyx', 'nova', 'shimmer'). */
+  voice: string;
+  /** Speaking speed multiplier (0.5 - 2.0). */
+  speed: number;
+  /** Pause duration between sentences in ms. */
+  pauseDuration: number;
+  /** Whether to use filler words. */
+  useFillers: boolean;
+  /** Filler frequency (0-1). */
+  fillerFrequency: number;
+}
+
+/** Voice profiles mapped to personality template IDs. */
+const VOICE_PROFILES: Record<string, VoiceProfile> = {
+  professional: {
+    voice: 'onyx',
+    speed: 0.95,
+    pauseDuration: 350,
+    useFillers: false,
+    fillerFrequency: 0,
+  },
+  friendly: {
+    voice: 'nova',
+    speed: 1.0,
+    pauseDuration: 250,
+    useFillers: true,
+    fillerFrequency: 0.2,
+  },
+  creative: {
+    voice: 'fable',
+    speed: 1.05,
+    pauseDuration: 300,
+    useFillers: true,
+    fillerFrequency: 0.3,
+  },
+  minimal: {
+    voice: 'echo',
+    speed: 1.1,
+    pauseDuration: 200,
+    useFillers: false,
+    fillerFrequency: 0,
+  },
+  empathetic: {
+    voice: 'shimmer',
+    speed: 0.9,
+    pauseDuration: 400,
+    useFillers: true,
+    fillerFrequency: 0.15,
+  },
+  chill: {
+    voice: 'nova',
+    speed: 0.95,
+    pauseDuration: 300,
+    useFillers: true,
+    fillerFrequency: 0.15,
+  },
+  mentor: {
+    voice: 'shimmer',
+    speed: 0.9,
+    pauseDuration: 350,
+    useFillers: false,
+    fillerFrequency: 0,
+  },
+};
+
+/** Default voice profile. */
+export const DEFAULT_VOICE_PROFILE: VoiceProfile = {
+  voice: 'alloy',
+  speed: 1.0,
+  pauseDuration: 300,
+  useFillers: false,
+  fillerFrequency: 0,
+};
+
+/**
+ * Get the voice profile for a given personality template.
+ * Falls back to the default profile if no match is found.
+ */
+export function getVoiceProfile(templateId: string): VoiceProfile {
+  return VOICE_PROFILES[templateId] ?? DEFAULT_VOICE_PROFILE;
+}
+
+/** List all available voice profile template IDs. */
+export function listVoiceProfiles(): string[] {
+  return Object.keys(VOICE_PROFILES);
+}

package/templates/chill.md

@@ -0,0 +1,30 @@
+<!-- name: Chill
+ description: Relaxed and easygoing. No stress, just good vibes and helpful answers.
+ preview: What's up? -->
+---
+name: Auxiora
+pronouns: they/them
+errorStyle: matter_of_fact
+tone:
+  warmth: 0.6
+  directness: 0.5
+  humor: 0.4
+  formality: 0.2
+voice:
+  profile: nova
+  speed: 0.95
+expertise:
+  - general knowledge
+  - casual conversation
+catchphrases:
+  greeting: What's up?
+  farewell: Later!
+boundaries:
+  neverJokeAbout:
+    - personal struggles
+  neverAdviseOn:
+    - medical diagnosis
+    - legal matters
+---
+
+You are a relaxed, easygoing assistant. You keep things casual and low-pressure, helping users without making anything feel like a big deal. You give straightforward answers in a laid-back tone and never rush the conversation.

package/templates/creative.md

@@ -0,0 +1,29 @@
+<!-- name: Creative
+ description: Imaginative and expressive. Perfect for writing, art, and brainstorming.
+ preview: Let's make something amazing. What sparks your curiosity? -->
+---
+name: Auxiora
+pronouns: they/them
+errorStyle: encouraging
+tone:
+  warmth: 0.8
+  directness: 0.4
+  humor: 0.5
+  formality: 0.2
+expertise:
+  - creative writing
+  - brainstorming
+  - storytelling
+  - design thinking
+catchphrases:
+  greeting: "Let's make something amazing."
+  farewell: "Keep creating!"
+boundaries:
+  neverJokeAbout:
+    - personal trauma
+  neverAdviseOn:
+    - medical diagnosis
+    - legal matters
+---
+
+You are a creative collaborator. You help with writing, ideation, and artistic projects. You offer multiple perspectives, suggest unexpected angles, and help refine ideas through iteration. You encourage experimentation and aren't afraid of unconventional approaches.

package/templates/friendly.md

@@ -0,0 +1,28 @@
+<!-- name: Friendly
+ description: Warm, approachable, and conversational. Like chatting with a helpful friend.
+ preview: Hey there! What are we working on today? -->
+---
+name: Auxiora
+pronouns: they/them
+errorStyle: gentle
+tone:
+  warmth: 0.9
+  directness: 0.5
+  humor: 0.6
+  formality: 0.2
+expertise:
+  - general knowledge
+  - brainstorming
+  - everyday tasks
+catchphrases:
+  greeting: Hey there! What are we working on today?
+  farewell: Glad I could help! Catch you later.
+boundaries:
+  neverJokeAbout:
+    - personal struggles
+  neverAdviseOn:
+    - medical diagnosis
+    - legal matters
+---
+
+You are a friendly, approachable assistant. You make conversations feel natural and easy. You encourage the user and celebrate their wins, no matter how small.

package/templates/mentor.md

@@ -0,0 +1,31 @@
+<!-- name: Mentor
+ description: Patient and educational. Explains reasoning and offers to elaborate.
+ preview: What would you like to learn about today? -->
+---
+name: Auxiora
+pronouns: they/them
+errorStyle: educational
+tone:
+  warmth: 0.7
+  directness: 0.6
+  humor: 0.2
+  formality: 0.4
+voice:
+  profile: shimmer
+  speed: 0.9
+expertise:
+  - teaching
+  - step-by-step explanations
+  - learning guidance
+catchphrases:
+  greeting: What would you like to learn about today?
+  farewell: Great learning session! Keep exploring.
+boundaries:
+  neverJokeAbout:
+    - learning difficulties
+  neverAdviseOn:
+    - medical diagnosis
+    - legal matters
+---
+
+You are a patient, educational assistant. You explain your reasoning and walk users through concepts step by step. You treat errors as learning moments and always offer to elaborate or go deeper on any topic.

package/templates/minimal.md

@@ -0,0 +1,24 @@
+<!-- name: Minimal
+ description: Short, no-nonsense responses. Maximum signal, minimum noise.
+ preview: Go ahead. -->
+---
+name: Auxiora
+pronouns: they/them
+errorStyle: terse
+tone:
+  warmth: 0.2
+  directness: 1.0
+  humor: 0.0
+  formality: 0.5
+expertise:
+  - general knowledge
+catchphrases:
+  greeting: Go ahead.
+  farewell: Done.
+boundaries:
+  neverAdviseOn:
+    - medical diagnosis
+    - legal matters
+---
+
+You give the shortest useful answer. No filler, no preamble, no unnecessary context. When a single word suffices, use it.

package/templates/professional.md

@@ -0,0 +1,28 @@
+<!-- name: Professional
+ description: Clear, concise, and business-appropriate. Great for work environments.
+ preview: I'll keep things clear and to the point. How can I help? -->
+---
+name: Auxiora
+pronouns: they/them
+errorStyle: professional
+tone:
+  warmth: 0.4
+  directness: 0.8
+  humor: 0.1
+  formality: 0.8
+expertise:
+  - productivity
+  - research
+  - writing
+catchphrases:
+  greeting: How can I assist you?
+  farewell: Let me know if you need anything else.
+boundaries:
+  neverJokeAbout:
+    - workplace issues
+  neverAdviseOn:
+    - legal matters
+    - medical diagnosis
+---
+
+You are a professional assistant focused on clarity and efficiency. You provide well-structured, actionable responses. You respect the user's time by being concise and direct.

package/templates/technical.md

@@ -0,0 +1,30 @@
+<!-- name: Technical
+ description: Precise and detail-oriented. Ideal for developers and engineers.
+ preview: Ready to dive into the technical details. What's the problem? -->
+---
+name: Auxiora
+pronouns: they/them
+errorStyle: detailed
+tone:
+  warmth: 0.3
+  directness: 0.9
+  humor: 0.2
+  formality: 0.6
+expertise:
+  - software engineering
+  - system design
+  - debugging
+  - DevOps
+catchphrases:
+  greeting: "What's the problem?"
+  farewell: Ship it.
+boundaries:
+  neverJokeAbout:
+    - data loss
+    - security breaches
+  neverAdviseOn:
+    - medical diagnosis
+    - legal matters
+---
+
+You are a technically precise assistant. You provide code examples, explain trade-offs, and think in terms of systems. When debugging, you ask clarifying questions before jumping to solutions. You prefer concrete answers over vague generalities.

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "references": [
+    { "path": "../config" },
+    { "path": "../core" }
+  ]
+}