@framers/agentos-ext-endpoint-semantic 0.2.0

package/dist/TurnCompletenessClassifier.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @file TurnCompletenessClassifier.ts
+ * @description LLM-backed binary classifier that decides whether an utterance
+ * is a complete conversational turn (COMPLETE) or likely to continue
+ * (INCOMPLETE). Results are LRU-cached to avoid redundant LLM round-trips for
+ * repeated short phrases.
+ *
+ * @module endpoint-semantic/TurnCompletenessClassifier
+ */
+/**
+ * The three possible results from {@link TurnCompletenessClassifier.classify}.
+ *
+ * - `COMPLETE`   — The utterance is a self-contained thought expecting a reply.
+ * - `INCOMPLETE` — The speaker is likely to continue before yielding the floor.
+ * - `TIMEOUT`    — The LLM did not respond within the configured time budget;
+ *                  the caller should fall back to silence-timeout behaviour.
+ */
+export type ClassifyResult = 'COMPLETE' | 'INCOMPLETE' | 'TIMEOUT';
+/**
+ * Classifies a transcript as {@link ClassifyResult.COMPLETE} or
+ * {@link ClassifyResult.INCOMPLETE} using an LLM prompt.
+ *
+ * ### Caching
+ * Results are stored in a fixed-capacity LRU cache keyed on the first 100
+ * characters of the transcript.  When the cache is full, the oldest entry is
+ * evicted (insertion-order eviction via `Map` iteration order, which is
+ * guaranteed by the ES2015 spec).
+ *
+ * ### Prompt format
+ * The LLM is asked to respond with exactly `COMPLETE` or `INCOMPLETE` as the
+ * first word, followed by one sentence of reasoning.  Only the first word is
+ * examined — anything after the first space is treated as explanatory text and
+ * discarded.
+ *
+ * @example
+ * ```ts
+ * const classifier = new TurnCompletenessClassifier(
+ *   async (prompt) => openai.chat.completions.create({ ... }).then(r => r.choices[0].message.content ?? ''),
+ *   400,
+ * );
+ * const result = await classifier.classify('Tell me about your', 'User: Hello\nAgent: Hi there!');
+ * // → 'INCOMPLETE'  (sentence is unfinished)
+ * ```
+ */
+export declare class TurnCompletenessClassifier {
+    private readonly llmCall;
+    private readonly timeoutMs;
+    /**
+     * LRU result cache. Keys are the first 100 chars of the transcript; values
+     * are the cached classification.  `Map` preserves insertion order, so
+     * eviction iterates from the oldest entry (`.keys().next().value`).
+     */
+    private readonly cache;
+    /**
+     * Maximum number of entries to keep in {@link cache} before evicting the
+     * oldest one.
+     */
+    private readonly maxCacheSize;
+    /**
+     * @param llmCall   — Async function that sends a prompt string to an LLM and
+     *                    resolves with the raw response text.
+     * @param timeoutMs — Maximum milliseconds to wait for the LLM before
+     *                    returning `TIMEOUT`. Defaults to 500 ms.
+     */
+    constructor(llmCall: (prompt: string) => Promise<string>, timeoutMs?: number);
+    /**
+     * Classify `transcript` as `COMPLETE`, `INCOMPLETE`, or `TIMEOUT`.
+     *
+     * The result is cached on the first 100 characters of `transcript` so that
+     * repeated short phrases (common in voice interaction) never hit the LLM
+     * twice.
+     *
+     * @param transcript — The utterance text to evaluate.
+     * @param context    — Optional string containing the last 2 conversation turns,
+     *                     formatted as `"Speaker: text\n..."`.  When omitted, the
+     *                     prompt uses `'N/A'`.
+     * @returns A {@link ClassifyResult} resolving to `COMPLETE`, `INCOMPLETE`,
+     *          or `TIMEOUT`.
+     */
+    classify(transcript: string, context?: string): Promise<ClassifyResult>;
+}
+//# sourceMappingURL=TurnCompletenessClassifier.d.ts.map

package/dist/TurnCompletenessClassifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnCompletenessClassifier.d.ts","sourceRoot":"","sources":["../src/TurnCompletenessClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;AAMnE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,0BAA0B;IAqBnC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IArB5B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgD;IAEtE;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAO;IAEpC;;;;;OAKG;gBAEgB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC5C,SAAS,GAAE,MAAY;IAO1C;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CA2D9E"}

package/dist/TurnCompletenessClassifier.js

@@ -0,0 +1,130 @@
+/**
+ * @file TurnCompletenessClassifier.ts
+ * @description LLM-backed binary classifier that decides whether an utterance
+ * is a complete conversational turn (COMPLETE) or likely to continue
+ * (INCOMPLETE). Results are LRU-cached to avoid redundant LLM round-trips for
+ * repeated short phrases.
+ *
+ * @module endpoint-semantic/TurnCompletenessClassifier
+ */
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * Classifies a transcript as {@link ClassifyResult.COMPLETE} or
+ * {@link ClassifyResult.INCOMPLETE} using an LLM prompt.
+ *
+ * ### Caching
+ * Results are stored in a fixed-capacity LRU cache keyed on the first 100
+ * characters of the transcript.  When the cache is full, the oldest entry is
+ * evicted (insertion-order eviction via `Map` iteration order, which is
+ * guaranteed by the ES2015 spec).
+ *
+ * ### Prompt format
+ * The LLM is asked to respond with exactly `COMPLETE` or `INCOMPLETE` as the
+ * first word, followed by one sentence of reasoning.  Only the first word is
+ * examined — anything after the first space is treated as explanatory text and
+ * discarded.
+ *
+ * @example
+ * ```ts
+ * const classifier = new TurnCompletenessClassifier(
+ *   async (prompt) => openai.chat.completions.create({ ... }).then(r => r.choices[0].message.content ?? ''),
+ *   400,
+ * );
+ * const result = await classifier.classify('Tell me about your', 'User: Hello\nAgent: Hi there!');
+ * // → 'INCOMPLETE'  (sentence is unfinished)
+ * ```
+ */
+export class TurnCompletenessClassifier {
+    llmCall;
+    timeoutMs;
+    /**
+     * LRU result cache. Keys are the first 100 chars of the transcript; values
+     * are the cached classification.  `Map` preserves insertion order, so
+     * eviction iterates from the oldest entry (`.keys().next().value`).
+     */
+    cache = new Map();
+    /**
+     * Maximum number of entries to keep in {@link cache} before evicting the
+     * oldest one.
+     */
+    maxCacheSize = 100;
+    /**
+     * @param llmCall   — Async function that sends a prompt string to an LLM and
+     *                    resolves with the raw response text.
+     * @param timeoutMs — Maximum milliseconds to wait for the LLM before
+     *                    returning `TIMEOUT`. Defaults to 500 ms.
+     */
+    constructor(llmCall, timeoutMs = 500) {
+        this.llmCall = llmCall;
+        this.timeoutMs = timeoutMs;
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    /**
+     * Classify `transcript` as `COMPLETE`, `INCOMPLETE`, or `TIMEOUT`.
+     *
+     * The result is cached on the first 100 characters of `transcript` so that
+     * repeated short phrases (common in voice interaction) never hit the LLM
+     * twice.
+     *
+     * @param transcript — The utterance text to evaluate.
+     * @param context    — Optional string containing the last 2 conversation turns,
+     *                     formatted as `"Speaker: text\n..."`.  When omitted, the
+     *                     prompt uses `'N/A'`.
+     * @returns A {@link ClassifyResult} resolving to `COMPLETE`, `INCOMPLETE`,
+     *          or `TIMEOUT`.
+     */
+    async classify(transcript, context) {
+        // -----------------------------------------------------------------------
+        // Cache lookup
+        // -----------------------------------------------------------------------
+        const cacheKey = transcript.slice(0, 100);
+        if (this.cache.has(cacheKey)) {
+            return this.cache.get(cacheKey);
+        }
+        // -----------------------------------------------------------------------
+        // Build prompt
+        // -----------------------------------------------------------------------
+        const prompt = `Is the following utterance a complete thought that expects a response, ` +
+            `or is the speaker likely to continue?\n\n` +
+            `Context (last 2 turns):\n${context ?? 'N/A'}\n\n` +
+            `Current utterance: "${transcript}"\n\n` +
+            `Respond with exactly COMPLETE or INCOMPLETE, then one sentence of reasoning.`;
+        // -----------------------------------------------------------------------
+        // LLM call with timeout race
+        // -----------------------------------------------------------------------
+        let rawResult;
+        try {
+            rawResult = await Promise.race([
+                this.llmCall(prompt),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), this.timeoutMs)),
+            ]);
+        }
+        catch {
+            // Either the LLM threw or the timeout won — return TIMEOUT without
+            // caching so the next call re-attempts the LLM.
+            return 'TIMEOUT';
+        }
+        // -----------------------------------------------------------------------
+        // Parse response — only the first word matters
+        // -----------------------------------------------------------------------
+        const classification = rawResult.trim().startsWith('COMPLETE')
+            ? 'COMPLETE'
+            : 'INCOMPLETE';
+        // -----------------------------------------------------------------------
+        // LRU eviction + cache write
+        // -----------------------------------------------------------------------
+        if (this.cache.size >= this.maxCacheSize) {
+            // Map.keys() returns an iterator in insertion order; the first key is the
+            // oldest entry.
+            const firstKey = this.cache.keys().next().value;
+            this.cache.delete(firstKey);
+        }
+        this.cache.set(cacheKey, classification);
+        return classification;
+    }
+}
+//# sourceMappingURL=TurnCompletenessClassifier.js.map

package/dist/TurnCompletenessClassifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnCompletenessClassifier.js","sourceRoot":"","sources":["../src/TurnCompletenessClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,0BAA0B;IAqBlB;IACA;IArBnB;;;;OAIG;IACc,KAAK,GAAG,IAAI,GAAG,EAAqC,CAAC;IAEtE;;;OAGG;IACc,YAAY,GAAG,GAAG,CAAC;IAEpC;;;;;OAKG;IACH,YACmB,OAA4C,EAC5C,YAAoB,GAAG;QADvB,YAAO,GAAP,OAAO,CAAqC;QAC5C,cAAS,GAAT,SAAS,CAAc;IACvC,CAAC;IAEJ,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,QAAQ,CAAC,UAAkB,EAAE,OAAgB;QACjD,0EAA0E;QAC1E,eAAe;QACf,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAE1C,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;QACnC,CAAC;QAED,0EAA0E;QAC1E,eAAe;QACf,0EAA0E;QAC1E,MAAM,MAAM,GACV,yEAAyE;YACzE,2CAA2C;YAC3C,4BAA4B,OAAO,IAAI,KAAK,MAAM;YAClD,uBAAuB,UAAU,OAAO;YACxC,8EAA8E,CAAC;QAEjF,0EAA0E;QAC1E,6BAA6B;QAC7B,0EAA0E;QAC1E,IAAI,SAAiB,CAAC;QAEtB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAC7B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;gBACpB,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC/B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAC/D;aACF,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;YACnE,gDAAgD;YAChD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,0EAA0E;QAC1E,+CAA+C;QAC/C,0EAA0E;QAC1E,MAAM,cAAc,GAA8B,SAAS,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YACvF,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,YAAY,CAAC;QAEjB,0EAA0E;QAC1E,6BAA6B;QAC7B,0EAA0E;QAC1E,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACzC,0EAA0E;YAC1E,gBAAgB;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC;YAC1D,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAEzC,OAAO,cAAc,CAAC;IACxB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @file index.ts
+ * @description Pack factory for the Semantic Endpoint Detector extension pack.
+ *
+ * ### Usage (direct)
+ * ```ts
+ * import { createSemanticEndpointDetector } from '@framers/agentos-ext-endpoint-semantic';
+ *
+ * const detector = createSemanticEndpointDetector(
+ *   async (prompt) => myLlm(prompt),
+ *   { timeoutMs: 400, minSilenceBeforeCheckMs: 600 }
+ * );
+ * detector.on('turn_complete', (evt) => console.log('Turn done:', evt.reason));
+ * ```
+ *
+ * ### Usage (manifest-driven)
+ * ```json
+ * { "packs": [{ "module": "@framers/agentos-ext-endpoint-semantic" }] }
+ * ```
+ *
+ * @module endpoint-semantic
+ */
+import { SemanticEndpointDetector } from './SemanticEndpointDetector.js';
+import type { SemanticEndpointConfig } from './types.js';
+/** Subset of ExtensionDescriptor required by this pack. */
+interface ExtensionDescriptor {
+    id: string;
+    kind: string;
+    payload: unknown;
+    enableByDefault?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/** Subset of ExtensionPack required by this pack. */
+interface ExtensionPack {
+    id: string;
+    descriptors: ExtensionDescriptor[];
+}
+/** Subset of ExtensionPackContext required by this pack. */
+interface ExtensionPackContext {
+    getSecret?: (id: string) => string | undefined;
+    options?: Record<string, unknown>;
+    /** Runtime LLM call function supplied by the AgentOS extension manager. */
+    llmCall?: (prompt: string) => Promise<string>;
+}
+/**
+ * Create a standalone {@link SemanticEndpointDetector} instance.
+ *
+ * Use this when composing the detector programmatically outside of the
+ * AgentOS extension system.
+ *
+ * @param llmCall — Async function that sends a prompt string to an LLM and
+ *                  resolves with the raw response text.
+ * @param config  — Optional configuration overrides.
+ * @returns A configured {@link SemanticEndpointDetector}.
+ */
+export declare function createSemanticEndpointDetector(llmCall: (prompt: string) => Promise<string>, config?: SemanticEndpointConfig): SemanticEndpointDetector;
+/**
+ * AgentOS manifest factory function.
+ *
+ * Returns an {@link ExtensionPack} containing a single `endpoint-detector`
+ * descriptor backed by {@link SemanticEndpointDetector}.
+ *
+ * The `llmCall` function must be provided via `context.llmCall`. When it is
+ * absent a no-op stub is used (the detector will always time out and fall back
+ * to silence-timeout behaviour).
+ *
+ * @param context — Pack context supplied by the extension manager.
+ * @returns A fully configured {@link ExtensionPack}.
+ */
+export declare function createExtensionPack(context: ExtensionPackContext): ExtensionPack;
+export * from './types.js';
+export { SemanticEndpointDetector } from './SemanticEndpointDetector.js';
+export { TurnCompletenessClassifier } from './TurnCompletenessClassifier.js';
+export type { ClassifyResult } from './TurnCompletenessClassifier.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAMzD,2DAA2D;AAC3D,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qDAAqD;AACrD,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC;AAED,4DAA4D;AAC5D,UAAU,oBAAoB;IAC5B,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/C;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC5C,MAAM,CAAC,EAAE,sBAAsB,GAC9B,wBAAwB,CAE1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAwBhF;AAMD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,83 @@
+/**
+ * @file index.ts
+ * @description Pack factory for the Semantic Endpoint Detector extension pack.
+ *
+ * ### Usage (direct)
+ * ```ts
+ * import { createSemanticEndpointDetector } from '@framers/agentos-ext-endpoint-semantic';
+ *
+ * const detector = createSemanticEndpointDetector(
+ *   async (prompt) => myLlm(prompt),
+ *   { timeoutMs: 400, minSilenceBeforeCheckMs: 600 }
+ * );
+ * detector.on('turn_complete', (evt) => console.log('Turn done:', evt.reason));
+ * ```
+ *
+ * ### Usage (manifest-driven)
+ * ```json
+ * { "packs": [{ "module": "@framers/agentos-ext-endpoint-semantic" }] }
+ * ```
+ *
+ * @module endpoint-semantic
+ */
+import { SemanticEndpointDetector } from './SemanticEndpointDetector.js';
+/** Kind constant matching packages/agentos/src/extensions/types.ts. */
+const EXTENSION_KIND_ENDPOINT_DETECTOR = 'endpoint-detector';
+// ---------------------------------------------------------------------------
+// Factory helpers
+// ---------------------------------------------------------------------------
+/**
+ * Create a standalone {@link SemanticEndpointDetector} instance.
+ *
+ * Use this when composing the detector programmatically outside of the
+ * AgentOS extension system.
+ *
+ * @param llmCall — Async function that sends a prompt string to an LLM and
+ *                  resolves with the raw response text.
+ * @param config  — Optional configuration overrides.
+ * @returns A configured {@link SemanticEndpointDetector}.
+ */
+export function createSemanticEndpointDetector(llmCall, config) {
+    return new SemanticEndpointDetector(llmCall, config);
+}
+/**
+ * AgentOS manifest factory function.
+ *
+ * Returns an {@link ExtensionPack} containing a single `endpoint-detector`
+ * descriptor backed by {@link SemanticEndpointDetector}.
+ *
+ * The `llmCall` function must be provided via `context.llmCall`. When it is
+ * absent a no-op stub is used (the detector will always time out and fall back
+ * to silence-timeout behaviour).
+ *
+ * @param context — Pack context supplied by the extension manager.
+ * @returns A fully configured {@link ExtensionPack}.
+ */
+export function createExtensionPack(context) {
+    const llmCall = context.llmCall ??
+        // Stub: always resolves to INCOMPLETE so the silence timeout takes over.
+        (() => Promise.resolve('INCOMPLETE (no llmCall provided)'));
+    const config = {
+        ...context.options,
+    };
+    const detector = new SemanticEndpointDetector(llmCall, config);
+    return {
+        id: 'endpoint-semantic',
+        descriptors: [
+            {
+                id: 'endpoint-detector-semantic',
+                kind: EXTENSION_KIND_ENDPOINT_DETECTOR,
+                payload: detector,
+                enableByDefault: true,
+                metadata: { mode: 'semantic' },
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// Re-exports
+// ---------------------------------------------------------------------------
+export * from './types.js';
+export { SemanticEndpointDetector } from './SemanticEndpointDetector.js';
+export { TurnCompletenessClassifier } from './TurnCompletenessClassifier.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AA8BzE,uEAAuE;AACvE,MAAM,gCAAgC,GAAG,mBAAmB,CAAC;AAE7D,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAA4C,EAC5C,MAA+B;IAE/B,OAAO,IAAI,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,MAAM,OAAO,GACX,OAAO,CAAC,OAAO;QACf,yEAAyE;QACzE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC,CAAC;IAE9D,MAAM,MAAM,GAA2B;QACrC,GAAI,OAAO,CAAC,OAA8C;KAC3D,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAE/D,OAAO;QACL,EAAE,EAAE,mBAAmB;QACvB,WAAW,EAAE;YACX;gBACE,EAAE,EAAE,4BAA4B;gBAChC,IAAI,EAAE,gCAAgC;gBACtC,OAAO,EAAE,QAAQ;gBACjB,eAAe,EAAE,IAAI;gBACrB,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;aAC/B;SACF;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @file types.ts
+ * @description Public configuration types for the Semantic Endpoint Detector
+ * extension pack.
+ *
+ * @module endpoint-semantic/types
+ */
+/**
+ * Configuration options for the {@link SemanticEndpointDetector}.
+ *
+ * All fields are optional — reasonable defaults are applied when omitted.
+ */
+export interface SemanticEndpointConfig {
+    /**
+     * LLM model identifier forwarded to the runtime LLM provider when performing
+     * turn-completeness classification. The exact string is passed through
+     * verbatim; its meaning is determined by whichever provider the caller
+     * supplies via the `llmCall` constructor argument.
+     *
+     * @example 'gpt-4o-mini'
+     * @example 'claude-haiku-3-5'
+     */
+    model?: string;
+    /**
+     * Maximum number of milliseconds to wait for the LLM to return a
+     * classification before treating the result as a {@link ClassifyResult.TIMEOUT}.
+     * On timeout the detector falls back to the normal silence timeout behaviour.
+     *
+     * @defaultValue 500
+     */
+    timeoutMs?: number;
+    /**
+     * Duration of silence (in ms) after a `speech_end` VAD event before the
+     * LLM classifier is invoked. Introducing a small delay avoids calling the
+     * LLM on micro-pauses that are immediately followed by resumed speech.
+     *
+     * @defaultValue 500
+     */
+    minSilenceBeforeCheckMs?: number;
+    /**
+     * Duration (in ms) of silence after `speech_end` before the detector emits
+     * `turn_complete` with reason `'silence_timeout'` regardless of classifier
+     * output. Acts as a hard fallback when the LLM returns `INCOMPLETE` or times
+     * out.
+     *
+     * @defaultValue 1500
+     */
+    silenceTimeoutMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * @file types.ts
+ * @description Public configuration types for the Semantic Endpoint Detector
+ * extension pack.
+ *
+ * @module endpoint-semantic/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/manifest.json

@@ -0,0 +1,8 @@
+{
+  "name": "@framers/agentos-ext-endpoint-semantic",
+  "version": "0.1.0",
+  "description": "Semantic endpoint detector with LLM turn-completeness classification",
+  "kind": "endpoint-detector",
+  "extensionId": "endpoint-semantic",
+  "entryPoint": "./dist/index.js"
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@framers/agentos-ext-endpoint-semantic",
+  "version": "0.2.0",
+  "description": "Semantic endpoint detection extension pack for AgentOS voice pipeline — LLM-based turn-completeness classification",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "SKILL.md",
+    "manifest.json"
+  ],
+  "peerDependencies": {
+    "@framers/agentos": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^1.6.0",
+    "@framers/agentos": "0.1.94"
+  },
+  "license": "MIT",
+  "author": "Frame.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions.git",
+    "directory": "registry/curated/voice/endpoint-semantic"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
+}