@xopcai/xopc 0.0.190 → 0.0.192

package/dist/src/user-context/manual-understanding.js

@@ -1,18 +1,16 @@
 import { createUnderstanding, listUnderstandings } from "../storage/sqlite/user-context-repository.js";
 import "../storage/sqlite/index.js";
-import { createHash } from "node:crypto";
+import { canonicalUnderstandingKey, findDuplicateUnderstanding } from "./understanding.js";
 //#region src/user-context/manual-understanding.ts
-function canonicalKey(kind, statement) {
-	const normalized = statement.toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
-	return `${kind}:${createHash("sha256").update(normalized).digest("hex").slice(0, 20)}`;
-}
-function sameScope(left, right) {
-	return left.type === right.type && left.id === right.id;
-}
 function createManualUnderstanding(input) {
 	const statement = input.content.trim();
-	const key = canonicalKey(input.kind, statement);
-	const duplicate = listUnderstandings().find((item) => item.canonicalKey === key && item.status !== "archived" && item.status !== "rejected" && sameScope(item.scope, input.scope));
+	const key = canonicalUnderstandingKey(input.kind, statement);
+	const duplicate = findDuplicateUnderstanding(listUnderstandings(), {
+		kind: input.kind,
+		statement,
+		canonicalKey: key,
+		scope: input.scope
+	});
 	if (duplicate) return {
 		understanding: duplicate,
 		created: false

package/dist/src/user-context/planner.js

@@ -176,12 +176,7 @@ var UserContextPlanner = class {
 				injectedChars: rule.statement.length
 			});
 		}
-		const ranked = listUnderstandings([
-			"active",
-			"candidate",
-			"needs_review",
-			"stale"
-		]).filter((item) => !excluded.has(item.id)).map((item) => ({
+		const ranked = listUnderstandings(["active"]).filter((item) => !excluded.has(item.id)).map((item) => ({
 			item,
 			score: relevance(query, item)
 		})).sort((left, right) => right.score - left.score).slice(0, Math.max(maxResults * 5, 50));

package/dist/src/user-context/sources/activity-clustering.d.ts

@@ -0,0 +1,5 @@
+import type { UnderstandingSourceItem, UserFocus } from './types.js';
+export type ActivityTopic = Pick<UserFocus, 'canonicalKey' | 'title' | 'summary' | 'horizon' | 'confidence' | 'evidenceRefs'> & {
+    sourceIds: string[];
+};
+export declare function clusterActivityTopics(items: UnderstandingSourceItem[], now?: number): ActivityTopic[];

package/dist/src/user-context/sources/activity-clustering.js

@@ -0,0 +1,130 @@
+import { createHash } from "node:crypto";
+//#region src/user-context/sources/activity-clustering.ts
+const STOP_WORDS = new Set([
+	"about",
+	"and",
+	"bookmark",
+	"bookmarks",
+	"desktop",
+	"document",
+	"documents",
+	"download",
+	"downloads",
+	"file",
+	"files",
+	"from",
+	"guide",
+	"home",
+	"index",
+	"into",
+	"latest",
+	"new",
+	"notes",
+	"official",
+	"overview",
+	"page",
+	"plan",
+	"profile",
+	"project",
+	"recent",
+	"roadmap",
+	"the",
+	"this",
+	"with",
+	"www"
+]);
+function activityTimestamp(item) {
+	return item.modifiedAt ?? item.occurredAt ?? item.startsAt ?? 0;
+}
+function tokenize(value) {
+	const normalized = value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLocaleLowerCase().replace(/\.[a-z0-9]{1,8}$/i, "").replace(/https?:\/\//g, " ");
+	const tokens = /* @__PURE__ */ new Set();
+	for (const token of normalized.match(/[a-z0-9][a-z0-9-]{2,}|[\p{Script=Han}]{2,}/gu) ?? []) {
+		if (/^[\p{Script=Han}]+$/u.test(token)) {
+			if (token.length <= 4) tokens.add(token);
+			else for (let index = 0; index < token.length - 1; index += 1) tokens.add(token.slice(index, index + 2));
+			continue;
+		}
+		const clean = token.replace(/^-+|-+$/g, "");
+		if (clean.length >= 3 && !STOP_WORDS.has(clean) && !/^\d+$/.test(clean)) tokens.add(clean);
+	}
+	return tokens;
+}
+function itemTokens(item) {
+	let host = "";
+	if (item.resourceUri) try {
+		host = new URL(item.resourceUri).hostname.replace(/^www\./, "");
+	} catch {}
+	return tokenize([
+		item.title,
+		item.group ?? "",
+		host
+	].join(" "));
+}
+function overlap(left, right) {
+	let count = 0;
+	for (const token of left) if (right.has(token)) count += 1;
+	return count;
+}
+function related(left, right) {
+	const shared = overlap(left.tokens, right.tokens);
+	if (shared >= 2) return true;
+	const smallest = Math.min(left.tokens.size, right.tokens.size);
+	if (shared === 1 && smallest <= 2) return true;
+	return Boolean(shared === 1 && left.item.group && left.item.group === right.item.group);
+}
+function displayTitle(cluster) {
+	const frequency = /* @__PURE__ */ new Map();
+	for (const entry of cluster) for (const token of entry.tokens) frequency.set(token, (frequency.get(token) ?? 0) + 1);
+	const shared = [...frequency.entries()].filter(([, count]) => count >= 2).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).slice(0, 3).map(([token]) => token);
+	if (shared.length && shared.every((token) => /^[\p{Script=Han}]+$/u.test(token))) return cluster[0].item.title.replace(/\.[a-z0-9]{1,8}$/i, "").slice(0, 80);
+	if (shared.length) return shared.map((token) => token.charAt(0).toUpperCase() + token.slice(1)).join(" ");
+	return cluster[0].item.title.replace(/\.[a-z0-9]{1,8}$/i, "").slice(0, 80);
+}
+function clusterActivityTopics(items, now = Date.now()) {
+	const prepared = items.filter((item) => item.type === "document" || item.type === "bookmark").map((item) => ({
+		item,
+		tokens: itemTokens(item),
+		timestamp: activityTimestamp(item)
+	})).filter((entry) => entry.tokens.size > 0);
+	const parent = prepared.map((_, index) => index);
+	const find = (index) => parent[index] === index ? index : parent[index] = find(parent[index]);
+	const union = (left, right) => {
+		const leftRoot = find(left);
+		const rightRoot = find(right);
+		if (leftRoot !== rightRoot) parent[rightRoot] = leftRoot;
+	};
+	for (let left = 0; left < prepared.length; left += 1) for (let right = left + 1; right < prepared.length; right += 1) if (related(prepared[left], prepared[right])) union(left, right);
+	const clusters = /* @__PURE__ */ new Map();
+	prepared.forEach((entry, index) => clusters.set(find(index), [...clusters.get(find(index)) ?? [], entry]));
+	return [...clusters.values()].flatMap((cluster) => {
+		if (cluster.length < 2) return [];
+		const sourceIds = [...new Set(cluster.map(({ item }) => item.sourceId))];
+		const types = new Set(cluster.map(({ item }) => item.type));
+		if (types.size === 1 && types.has("bookmark") && cluster.length < 3) return [];
+		const newestAt = Math.max(...cluster.map(({ timestamp }) => timestamp));
+		const ageDays = newestAt ? Math.max(0, (now - newestAt) / 864e5) : 90;
+		const recency = Math.max(0, 1 - ageDays / 90);
+		const confidence = Math.min(.92, .48 + Math.min(cluster.length, 5) * .06 + Math.min(sourceIds.length, 3) * .09 + recency * .08);
+		const title = displayTitle(cluster);
+		const fileCount = cluster.filter(({ item }) => item.type === "document").length;
+		const bookmarkCount = cluster.length - fileCount;
+		const evidenceRefs = cluster.map(({ item }) => item.evidenceRef);
+		const sharedTokens = /* @__PURE__ */ new Map();
+		for (const entry of cluster) for (const token of entry.tokens) sharedTokens.set(token, (sharedTokens.get(token) ?? 0) + 1);
+		const stableTopicTokens = [...sharedTokens.entries()].filter(([, count]) => count >= 2).map(([token]) => token).sort();
+		const key = createHash("sha256").update(stableTopicTokens.join("|")).digest("hex").slice(0, 16);
+		const signals = [fileCount ? `${fileCount} recent file${fileCount === 1 ? "" : "s"}` : "", bookmarkCount ? `${bookmarkCount} bookmark${bookmarkCount === 1 ? "" : "s"}` : ""].filter(Boolean).join(" and ");
+		return [{
+			canonicalKey: `activity-focus:${key}`,
+			title,
+			summary: `${signals} suggest sustained attention to ${title}.`,
+			horizon: ageDays <= 14 ? "current" : "ongoing",
+			confidence,
+			evidenceRefs,
+			sourceIds
+		}];
+	}).sort((left, right) => right.confidence - left.confidence).slice(0, 5);
+}
+//#endregion
+export { clusterActivityTopics };

package/dist/src/user-context/sources/catalog.js

@@ -13,6 +13,32 @@ const COMMON = [
 		recommended: true,
 		sensitive: false
 	},
+	{
+		id: "local-recent-files",
+		category: "recent_documents",
+		platform: "all",
+		displayName: "Recent files",
+		description: "Read-only metadata for recent documents on Desktop, Documents, and Downloads.",
+		availability: "available",
+		permission: "not_requested",
+		defaultAccessMode: "once",
+		supportedAccessModes: ["once"],
+		recommended: true,
+		sensitive: true
+	},
+	{
+		id: "chromium-bookmarks",
+		category: "recent_documents",
+		platform: "all",
+		displayName: "Recent bookmarks",
+		description: "Titles, folders, and sanitized domains for recently added Chromium bookmarks.",
+		availability: "available",
+		permission: "not_requested",
+		defaultAccessMode: "once",
+		supportedAccessModes: ["once"],
+		recommended: true,
+		sensitive: true
+	},
 	{
 		id: "connector-github",
 		category: "code_activity",

package/dist/src/user-context/sources/local-source-contract.d.ts

@@ -0,0 +1,3 @@
+export declare const LOCAL_UNDERSTANDING_SOURCE_IDS: readonly ["local-recent-files", "chromium-bookmarks", "apple-notes", "apple-calendar", "apple-reminders", "windows-recent-documents", "linux-recent-documents"];
+export type LocalUnderstandingSourceId = typeof LOCAL_UNDERSTANDING_SOURCE_IDS[number];
+export declare function isLocalUnderstandingSourceId(value: string): value is LocalUnderstandingSourceId;

package/dist/src/user-context/sources/local-source-contract.js

@@ -0,0 +1,15 @@
+//#region src/user-context/sources/local-source-contract.ts
+const LOCAL_UNDERSTANDING_SOURCE_IDS = [
+	"local-recent-files",
+	"chromium-bookmarks",
+	"apple-notes",
+	"apple-calendar",
+	"apple-reminders",
+	"windows-recent-documents",
+	"linux-recent-documents"
+];
+function isLocalUnderstandingSourceId(value) {
+	return LOCAL_UNDERSTANDING_SOURCE_IDS.includes(value);
+}
+//#endregion
+export { LOCAL_UNDERSTANDING_SOURCE_IDS, isLocalUnderstandingSourceId };

package/dist/src/user-context/sources/repository.js

@@ -144,7 +144,13 @@ function upsertUserFocus(input) {
       evidence_refs_json, source_run_id, created_at, updated_at
     ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     ON CONFLICT(canonical_key) DO UPDATE SET title = excluded.title, summary = excluded.summary,
-      horizon = excluded.horizon, status = excluded.status, confidence = excluded.confidence,
+      horizon = excluded.horizon,
+      status = CASE
+        WHEN user_focuses.status IN ('active', 'paused', 'completed', 'rejected') AND excluded.status = 'candidate'
+          THEN user_focuses.status
+        ELSE excluded.status
+      END,
+      confidence = excluded.confidence,
       project_id = excluded.project_id, evidence_refs_json = excluded.evidence_refs_json,
       source_run_id = excluded.source_run_id, updated_at = excluded.updated_at
   `).run(id, input.canonicalKey, input.title, input.summary, input.horizon, input.status, input.confidence, input.projectId ?? null, JSON.stringify(input.evidenceRefs), input.sourceRunId ?? null, now, now));

package/dist/src/user-context/sources/types.d.ts

@@ -36,10 +36,12 @@ export interface UnderstandingSourceGrant {
 export interface UnderstandingSourceItem {
     id: string;
     sourceId: string;
-    type: 'document' | 'calendar_event' | 'task' | 'note' | 'mail' | 'message' | 'code_activity';
+    type: 'document' | 'calendar_event' | 'task' | 'note' | 'mail' | 'message' | 'code_activity' | 'bookmark';
     title: string;
     text?: string;
     group?: string;
+    /** Sanitized locator. It must not contain credentials, query parameters, or fragments. */
+    resourceUri?: string;
     occurredAt?: number;
     modifiedAt?: number;
     startsAt?: number;
@@ -52,6 +54,10 @@ export interface UnderstandingSourceCollectionResult {
     sourceId: string;
     status: 'completed' | 'denied' | 'failed';
     items: UnderstandingSourceItem[];
+    checkpoint?: {
+        fingerprint: string;
+        collectedAt: number;
+    };
     error?: string;
 }
 export interface UnderstandingSourceRun {

package/dist/src/user-context/understanding.d.ts

@@ -0,0 +1,15 @@
+import type { UnderstandingKind, UserContextScope, UserUnderstanding } from './domain.js';
+export declare function canonicalUnderstandingKey(kind: UnderstandingKind, statement: string): string;
+export declare function isSameUserContextScope(left: UserContextScope, right: UserContextScope): boolean;
+export declare function findDuplicateUnderstanding(understandings: UserUnderstanding[], input: {
+    kind: UnderstandingKind;
+    statement: string;
+    canonicalKey: string;
+    scope: UserContextScope;
+    excludeId?: string;
+}): UserUnderstanding | undefined;
+export declare function findContradictoryUnderstanding(understandings: UserUnderstanding[], input: {
+    kind: UnderstandingKind;
+    statement: string;
+    scope: UserContextScope;
+}): UserUnderstanding | undefined;

package/dist/src/user-context/understanding.js

@@ -0,0 +1,24 @@
+import { isNearDuplicateUnderstanding } from "./understandingQuality.js";
+import { createHash } from "node:crypto";
+//#region src/user-context/understanding.ts
+function canonicalUnderstandingKey(kind, statement) {
+	const normalized = statement.normalize("NFKC").toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
+	return `${kind}:${createHash("sha256").update(normalized).digest("hex").slice(0, 20)}`;
+}
+function isSameUserContextScope(left, right) {
+	return left.type === right.type && left.id === right.id;
+}
+const NEGATION = /\b(?:do not|don't|never|avoid|without)\b|(?:不要|不用|无需|从不|避免|禁止)/i;
+function withoutNegation(statement) {
+	return statement.replace(NEGATION, "").replace(/\s+/g, " ").trim();
+}
+function findDuplicateUnderstanding(understandings, input) {
+	const inputIsNegative = NEGATION.test(input.statement);
+	return understandings.find((item) => item.id !== input.excludeId && item.kind === input.kind && item.status !== "archived" && item.status !== "rejected" && isSameUserContextScope(item.scope, input.scope) && (item.canonicalKey === input.canonicalKey || NEGATION.test(item.statement) === inputIsNegative && isNearDuplicateUnderstanding(item.statement, input.statement)));
+}
+function findContradictoryUnderstanding(understandings, input) {
+	const inputIsNegative = NEGATION.test(input.statement);
+	return understandings.find((item) => item.kind === input.kind && item.status === "active" && isSameUserContextScope(item.scope, input.scope) && NEGATION.test(item.statement) !== inputIsNegative && isNearDuplicateUnderstanding(withoutNegation(item.statement), withoutNegation(input.statement)));
+}
+//#endregion
+export { canonicalUnderstandingKey, findContradictoryUnderstanding, findDuplicateUnderstanding, isSameUserContextScope };

package/dist/src/voice/local/model-files.js

@@ -2,8 +2,8 @@ import { dirname, join } from "node:path";
 import { createReadStream, createWriteStream } from "node:fs";
 import { createHash } from "node:crypto";
 import { mkdir, rm, stat } from "node:fs/promises";
-import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
 //#region src/voice/local/model-files.ts
 function resolveModelFileUrl(remoteHost, model, file) {
 	const base = remoteHost.endsWith("/") ? remoteHost : `${remoteHost}/`;

package/dist/src/voice/metadata/builtin.js

@@ -12,24 +12,10 @@ function options(values, names) {
 		name: names?.[id] ?? titleCase(id)
 	}));
 }
-const alibabaSttModels = [
-	{
-		id: "paraformer-v2",
-		name: "Paraformer v2 (Recommended)"
-	},
-	{
-		id: "paraformer-v1",
-		name: "Paraformer v1"
-	},
-	{
-		id: "paraformer-8k-v1",
-		name: "Paraformer 8k v1 (Phone)"
-	},
-	{
-		id: "paraformer-mtl-v1",
-		name: "Paraformer MTL v1 (Multilingual)"
-	}
-];
+const alibabaSttModels = [{
+	id: "qwen-audio-3.0-asr-flash",
+	name: "Qwen Audio 3.0 ASR Flash"
+}];
 const localSttModels = [
 	{
 		id: "sensevoice-small",
@@ -179,12 +165,33 @@ const builtinVoiceProviderMetadata = [
 			configPath: "tools.media.audio.providers.xopc-local"
 		}
 	},
+	{
+		id: "xopc-cloud",
+		capability: "stt",
+		displayName: "XOPC Cloud",
+		description: "OAuth-based speech recognition using models published by XOPC Cloud.",
+		models: [],
+		fields: [{
+			key: "model",
+			label: "Public model ID",
+			type: "string"
+		}, {
+			key: "language",
+			label: "Language hint",
+			type: "string",
+			placeholder: "zh"
+		}],
+		diagnostics: {
+			requiresApiKey: false,
+			configPath: "tools.media.audio.providers.xopc-cloud"
+		}
+	},
 	{
 		id: "alibaba",
 		capability: "stt",
 		displayName: "Alibaba DashScope",
-		description: "DashScope Paraformer speech-to-text, strong Chinese recognition.",
-		aliases: ["dashscope", "paraformer"],
+		description: "DashScope Qwen Audio speech-to-text for Chinese and multilingual recognition.",
+		aliases: ["dashscope"],
 		models: alibabaSttModels,
 		fields: [
 			{
@@ -200,7 +207,7 @@ const builtinVoiceProviderMetadata = [
 				label: "Model",
 				type: "select",
 				options: alibabaSttModels,
-				defaultValue: "paraformer-v2"
+				defaultValue: "qwen-audio-3.0-asr-flash"
 			},
 			{
 				key: "language",
@@ -218,12 +225,22 @@ const builtinVoiceProviderMetadata = [
 	{
 		id: "openai",
 		capability: "stt",
-		displayName: "OpenAI Whisper",
-		description: "OpenAI Whisper transcription endpoint.",
-		models: [{
-			id: "whisper-1",
-			name: "Whisper-1"
-		}],
+		displayName: "OpenAI",
+		description: "OpenAI transcription endpoint.",
+		models: [
+			{
+				id: "gpt-transcribe",
+				name: "GPT Transcribe"
+			},
+			{
+				id: "gpt-4o-transcribe",
+				name: "GPT-4o Transcribe"
+			},
+			{
+				id: "gpt-4o-mini-transcribe",
+				name: "GPT-4o Mini Transcribe"
+			}
+		],
 		fields: [
 			{
 				key: "apiKey",
@@ -237,11 +254,21 @@ const builtinVoiceProviderMetadata = [
 				key: "model",
 				label: "Model",
 				type: "select",
-				options: [{
-					id: "whisper-1",
-					name: "Whisper-1"
-				}],
-				defaultValue: "whisper-1"
+				options: [
+					{
+						id: "gpt-transcribe",
+						name: "GPT Transcribe"
+					},
+					{
+						id: "gpt-4o-transcribe",
+						name: "GPT-4o Transcribe"
+					},
+					{
+						id: "gpt-4o-mini-transcribe",
+						name: "GPT-4o Mini Transcribe"
+					}
+				],
+				defaultValue: "gpt-transcribe"
 			},
 			{
 				key: "baseUrl",
@@ -267,6 +294,46 @@ const builtinVoiceProviderMetadata = [
 			configPath: "tools.media.audio.providers.openai"
 		}
 	},
+	{
+		id: "xopc-cloud",
+		capability: "tts",
+		displayName: "XOPC Cloud",
+		description: "OAuth-based speech synthesis using models and voices published by XOPC Cloud.",
+		models: [],
+		voices: [],
+		fields: [
+			{
+				key: "model",
+				label: "Public model ID",
+				type: "string"
+			},
+			{
+				key: "voice",
+				label: "Voice ID",
+				type: "string"
+			},
+			{
+				key: "speed",
+				label: "Speed",
+				type: "number",
+				defaultValue: 1,
+				min: .25,
+				max: 4,
+				step: .05,
+				description: "Speech speed from 0.25× to 4×."
+			},
+			{
+				key: "instructions",
+				label: "Speaking instructions",
+				type: "textarea",
+				placeholder: "Speak warmly and clearly."
+			}
+		],
+		diagnostics: {
+			requiresApiKey: false,
+			configPath: "messages.tts.providers.xopc-cloud"
+		}
+	},
 	{
 		id: "openai",
 		capability: "tts",

package/dist/src/voice/metadata/types.d.ts

@@ -15,6 +15,9 @@ export interface VoiceConfigFieldMetadata {
     description?: string;
     options?: VoiceOptionMetadata[];
     defaultValue?: string | number | boolean;
+    min?: number;
+    max?: number;
+    step?: number;
 }
 export interface VoiceProviderDiagnosticMetadata {
     requiresApiKey: boolean;

package/dist/src/voice/stt/availability.js

@@ -1,8 +1,11 @@
+import { getVoiceProviderMetadata } from "../metadata/registry.js";
+import "../metadata/index.js";
 //#region src/voice/stt/availability.ts
 function providerHasConfig(config, providerId) {
 	const provider = config.providers?.[providerId];
 	if (provider && Object.keys(provider).length > 0) return true;
-	return [...config.models ?? [], ...config.sharedModels ?? []].some((entry) => entry.provider === providerId && entry.capabilities?.includes("audio"));
+	if ([...config.models ?? [], ...config.sharedModels ?? []].some((entry) => entry.provider === providerId && entry.capabilities?.includes("audio"))) return true;
+	return getVoiceProviderMetadata("stt", providerId)?.diagnostics.requiresApiKey === false;
 }
 /**
 * Lightweight availability check for channel routing. Do not import the STT

package/dist/src/voice/stt/config-slice.d.ts

@@ -4,8 +4,6 @@
  * Reads `tools.media.audio.providers.<id>` only — there is no legacy flat-key form.
  */
 import type { STTConfig } from './types.js';
-/** Built-in env fallbacks when config slice has no apiKey. */
-export declare const STT_LEGACY_ENV_KEYS: Record<string, string>;
 /** Collect provider-id → raw config entries from the `providers` map. */
 export declare function collectSttProviderConfigEntries(config: Partial<STTConfig> | Record<string, unknown> | undefined): Record<string, Record<string, unknown>>;
 /** Resolve the raw config slice for one provider id. */

package/dist/src/voice/stt/config-slice.js

@@ -1,9 +1,4 @@
 //#region src/voice/stt/config-slice.ts
-/** Built-in env fallbacks when config slice has no apiKey. */
-const STT_LEGACY_ENV_KEYS = {
-	openai: "OPENAI_API_KEY",
-	alibaba: "DASHSCOPE_API_KEY"
-};
 function asRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
 }
@@ -50,4 +45,4 @@ function readSttProviderFields(slice, entryOverride) {
 	};
 }
 //#endregion
-export { STT_LEGACY_ENV_KEYS, collectSttProviderConfigEntries, readSttProviderFields, resolveSttProviderConfigSlice };
+export { collectSttProviderConfigEntries, readSttProviderFields, resolveSttProviderConfigSlice };

package/dist/src/voice/stt/factory.js

@@ -3,12 +3,12 @@ import { init_logger } from "../../utils/logger.js";
 import { getMediaUnderstandingProvider, listMediaUnderstandingProviders } from "../../media-understanding/registry.js";
 import "./providers/index.js";
 import { resolveModelEntries } from "../../media-understanding/resolve-entries.js";
-import { STT_LEGACY_ENV_KEYS, readSttProviderFields, resolveSttProviderConfigSlice } from "./config-slice.js";
+import { readSttProviderFields, resolveSttProviderConfigSlice } from "./config-slice.js";
 //#region src/voice/stt/factory.ts
 init_logger();
 const log = createLogger("STT:Factory");
 function resolveApiKey(providerId, fields, envKey) {
-	return fields.apiKey ?? (envKey ? process.env[envKey] : void 0) ?? process.env[STT_LEGACY_ENV_KEYS[providerId] ?? ""];
+	return fields.apiKey ?? (envKey ? process.env[envKey] : void 0);
 }
 /** Resolve a single STT provider config slice → runner-shaped resolved config, or null when unavailable. */
 function resolveSTTProviderConfig(providerId, config, entry) {

package/dist/src/voice/stt/index.d.ts

@@ -1,9 +1,8 @@
 /**
  * STT (Speech-to-Text) Module
  *
- * v2.0: providers implement MediaUnderstandingProvider; orchestration goes
- * through the media-understanding runner. The legacy `transcribe()` /
- * `isSTTAvailable()` API surface is preserved for channel adapters.
+ * Providers implement MediaUnderstandingProvider; orchestration goes through
+ * the media-understanding runner. Channel adapters use the public helpers below.
  */
 import './providers/index.js';
 import type { STTConfig, STTOptions, STTResult } from './types.js';

package/dist/src/voice/stt/list-providers.js

@@ -1,8 +1,8 @@
 import { listMediaUnderstandingProviders } from "../../media-understanding/registry.js";
 import { resolveSTTProviderConfig } from "./factory.js";
-import { mergeSttConfigFromAppConfig } from "./config.js";
 import { getVoiceProviderMetadata } from "../metadata/registry.js";
 import "../metadata/index.js";
+import { mergeSttConfigFromAppConfig } from "./config.js";
 //#region src/voice/stt/list-providers.ts
 function fallbackMetadata(providerId, aliases) {
 	return {

package/dist/src/voice/stt/providers/alibaba-transcription.d.ts

@@ -1,21 +1,2 @@
-/**
- * Alibaba DashScope Paraformer STT — implements MediaUnderstandingProvider.transcribeAudio.
- *
- * DashScope's async API is a 4-step dance:
- *   1. POST /api/v1/services/audio/asr/transcription with `X-DashScope-Async: enable`
- *      and `input.file_urls = [data:audio/ogg;base64,...]` → returns task_id
- *   2. Poll GET /api/v1/tasks/{task_id} until task_status === 'SUCCEEDED'
- *   3. The success result contains `transcription_url` pointing at a JSON document
- *   4. Fetch that JSON to extract the actual `transcripts[].text`
- *
- * All HTTP calls go through `fetchWithTimeoutGuarded` so the SSRF guard catches
- * malicious config injection. The transcription_url is a public OSS URL
- * (CDN-hosted); we keep `allowPrivateNetwork: false` so a malicious tenant
- * cannot redirect to an internal address.
- *
- * Polling caps at 60s by default (60 * 1s). The runner's `timeoutMs` controls
- * HTTP timeouts on each individual submit/poll/fetch call, not the overall
- * poll loop ceiling.
- */
 import type { MediaUnderstandingProvider } from '../../../media-understanding/types.js';
 export declare const alibabaTranscriptionProvider: MediaUnderstandingProvider;