@fenixforce/kernel 0.1.0

package/dist/voice/turn-detection.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Turn Detection Presets — configurable turn detection strategies
+ * for the realtime voice pipeline.
+ *
+ * Preset      Mode       Silence   Use Case
+ * ─────────   ────────   ───────   ────────────────────────────────
+ * fast        fixed      0.2s      Real-time captions, minimal delay
+ * fixed       fixed      0.5s      General conversation
+ * adaptive    adaptive   varies    Voice assistants, adjusts to patterns
+ * smart_turn  ML-based   varies    Multi-speaker, best accuracy
+ * scribe      fixed      1.5s      Dictation, long pauses OK
+ * captions    fixed      0.3s      Live captioning
+ * external    manual     N/A       App controls turn boundaries
+ *
+ * Per-edition defaults:
+ *   Pro    → adaptive    (general-purpose voice assistant)
+ *   Voices → smart_turn  (multi-speaker classroom, ML-based accuracy)
+ *   Mobile → fast        (low-latency mobile interaction)
+ */
+export type TurnDetectionPreset = "fast" | "fixed" | "adaptive" | "smart_turn" | "scribe" | "captions" | "external";
+export type TurnDetectionMode = "fixed" | "adaptive" | "smart" | "external";
+export interface TurnDetectionConfig {
+    /** Use a named preset (overrides mode/silenceTrigger) */
+    preset?: TurnDetectionPreset;
+    /** Manual mode selection */
+    mode?: TurnDetectionMode;
+    /** Seconds of silence before turn ends (0.1 - 2.0) */
+    silenceTrigger?: number;
+    /** Maximum seconds before forcing turn end */
+    maxDelay?: number;
+}
+/**
+ * External turn control interface.
+ * When preset: "external", the application decides when a turn ends.
+ */
+export interface VoiceSessionControl {
+    /** Signal turn end manually (push-to-talk, button press, etc.) */
+    forceEndOfUtterance(): Promise<void>;
+}
+interface ResolvedTurnDetection {
+    mode: TurnDetectionMode;
+    silenceTrigger: number | null;
+    maxDelay: number | null;
+}
+export declare const EDITION_TURN_DEFAULTS: Record<string, TurnDetectionPreset>;
+/**
+ * Resolve a TurnDetectionConfig into concrete parameters.
+ * Preset takes priority over manual mode/silenceTrigger.
+ */
+export declare function resolveTurnDetection(config?: TurnDetectionConfig, edition?: string): ResolvedTurnDetection;
+/** List all available preset names. */
+export declare function listTurnDetectionPresets(): TurnDetectionPreset[];
+export {};

package/dist/wrapup.d.ts

@@ -0,0 +1,15 @@
+import type { AgentEvent, TaskTracker } from "./events/types.js";
+import type { BrainArtifactManager } from "./memory/brain-artifacts.js";
+export interface WrapupInput {
+    sessionId: string;
+    tracker: TaskTracker;
+    toolLog: Array<{
+        tool: string;
+        ok: boolean;
+    }>;
+    /** If provided, open tasks are persisted to brain artifacts */
+    brainArtifacts?: BrainArtifactManager;
+    conversationId?: string;
+    userId?: string;
+}
+export declare function wrapup(input: WrapupInput): AsyncGenerator<AgentEvent>;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@fenixforce/kernel",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ejiogbevoices/projectfenix.git",
+    "directory": "packages/kernel"
+  },
+  "bin": {
+    "fenix": "dist/sdk/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --format=esm --platform=node --target=es2022 --minify --outfile=dist/index.js --external:pg && tsc --emitDeclarationOnly --project tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "pg": "^8.13.0"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.0"
+  }
+}