@xopcai/xopc 0.0.178 → 0.0.179

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 74;
+export const XOPC_DB_SCHEMA_VERSION = 87;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/notes-repository.js

@@ -177,6 +177,15 @@ function listNoteRecords(query = {}) {
 		params.push(query.groupId);
 	}
 	if (query.pendingTasksOnly) conditions.push(`kind = 'task' AND (task_done IS NULL OR task_done = 0)`);
+	if (query.projectId) {
+		conditions.push(`EXISTS (
+        SELECT 1 FROM object_links
+        WHERE relation = 'belongs_to'
+          AND from_kind = 'note' AND from_id = notes.note_id
+          AND to_kind = 'project' AND to_id = ?
+      )`);
+		params.push(query.projectId);
+	}
 	const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
 	const rows = db.prepare(`SELECT note_id, title, kind, status, payload_json, created_at, updated_at,
               pinned, tags_json, snippet, cover_attachment_id, voice_attachment_id,

package/dist/src/storage/sqlite/schema.js

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 11;
 	}
-	applyPendingMigrations(db, { targetVersion: 74 });
+	applyPendingMigrations(db, { targetVersion: 87 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };

package/dist/src/storage/sqlite/schema.sql

@@ -536,6 +536,95 @@ CREATE TABLE IF NOT EXISTS activity_related_projects (
 CREATE INDEX IF NOT EXISTS idx_activity_related_projects_project
   ON activity_related_projects(project_id, activity_id);
 
+CREATE TABLE IF NOT EXISTS discussion_captures (
+  id                         TEXT PRIMARY KEY,
+  client_request_id          TEXT NOT NULL UNIQUE,
+  note_id                    TEXT NOT NULL UNIQUE,
+  project_id                 TEXT,
+  audio_attachment_id        TEXT,
+  source                     TEXT NOT NULL CHECK (source IN ('web', 'electron')),
+  status                     TEXT NOT NULL CHECK (status IN (
+    'recording',
+    'finalizing',
+    'completed',
+    'failed',
+    'cancelled'
+  )),
+  processing_stage           TEXT CHECK (processing_stage IN (
+    'original_upload',
+    'final_transcription',
+    'analysis',
+    'note_write'
+  )),
+  duration_ms                INTEGER,
+  expected_last_sequence     INTEGER,
+  mime_type                  TEXT,
+  audio_size_bytes           INTEGER,
+  audio_sha256               TEXT,
+  transcript_raw             TEXT,
+  transcript_sha256          TEXT,
+  transcript_language        TEXT,
+  stt_provider               TEXT,
+  analysis_json              TEXT,
+  analysis_input_hash        TEXT,
+  analyzer_model_ref         TEXT,
+  generated_title            TEXT,
+  project_inference_score    REAL,
+  project_inference_source   TEXT,
+  finalization_revision      INTEGER NOT NULL DEFAULT 0,
+  attempt_count              INTEGER NOT NULL DEFAULT 0,
+  next_attempt_at            INTEGER,
+  lease_owner                TEXT,
+  lease_expires_at           INTEGER,
+  last_error_code            TEXT,
+  last_error_message         TEXT,
+  recording_started_at       INTEGER NOT NULL,
+  recording_finished_at      INTEGER,
+  created_at                 INTEGER NOT NULL,
+  updated_at                 INTEGER NOT NULL,
+  completed_at               INTEGER,
+  audio_deleted_at           INTEGER,
+  FOREIGN KEY (note_id) REFERENCES notes(note_id) ON DELETE CASCADE,
+  FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_discussion_captures_queue
+  ON discussion_captures(status, next_attempt_at, created_at);
+
+CREATE INDEX IF NOT EXISTS idx_discussion_captures_project
+  ON discussion_captures(project_id, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS discussion_transcript_segments (
+  discussion_id    TEXT NOT NULL,
+  sequence         INTEGER NOT NULL,
+  audio_sha256     TEXT NOT NULL,
+  audio_blob       BLOB,
+  started_at_ms    INTEGER NOT NULL,
+  ended_at_ms      INTEGER NOT NULL,
+  status           TEXT NOT NULL CHECK (status IN ('uploaded', 'transcribing', 'completed', 'failed')),
+  transcript       TEXT,
+  provider         TEXT,
+  attempt_count    INTEGER NOT NULL DEFAULT 0,
+  next_attempt_at  INTEGER,
+  lease_owner      TEXT,
+  lease_expires_at INTEGER,
+  last_error       TEXT,
+  created_at       INTEGER NOT NULL,
+  updated_at       INTEGER NOT NULL,
+  PRIMARY KEY (discussion_id, sequence),
+  FOREIGN KEY (discussion_id) REFERENCES discussion_captures(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_discussion_segments_queue
+  ON discussion_transcript_segments(status, next_attempt_at, created_at);
+
+CREATE TABLE IF NOT EXISTS discussion_capture_settings (
+  workspace_id               TEXT PRIMARY KEY,
+  consent_policy_version     INTEGER NOT NULL,
+  consent_acknowledged_at    INTEGER,
+  updated_at                 INTEGER NOT NULL
+);
+
 CREATE TABLE IF NOT EXISTS goal_context_messages (
   goal_id           TEXT PRIMARY KEY,
   text              TEXT NOT NULL DEFAULT '',
@@ -545,17 +634,6 @@ CREATE TABLE IF NOT EXISTS goal_context_messages (
   FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
 );
 
-CREATE TABLE IF NOT EXISTS goal_contracts (
-  goal_id              TEXT PRIMARY KEY,
-  version              INTEGER NOT NULL DEFAULT 1,
-  objective            TEXT NOT NULL,
-  scope_boundary       TEXT,
-  evidence_plan_json   TEXT NOT NULL DEFAULT '[]',
-  created_at           INTEGER NOT NULL,
-  updated_at           INTEGER NOT NULL,
-  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
-);
-
 CREATE TABLE IF NOT EXISTS goal_queue (
   queue_id       TEXT PRIMARY KEY,
   goal_id        TEXT NOT NULL,
@@ -652,39 +730,6 @@ CREATE TABLE IF NOT EXISTS goal_evidence (
 CREATE INDEX IF NOT EXISTS idx_goal_evidence_goal_created
   ON goal_evidence(goal_id, created_at DESC);
 
-CREATE TABLE IF NOT EXISTS goal_evidence_requirements (
-  requirement_id              TEXT PRIMARY KEY,
-  goal_id                     TEXT NOT NULL,
-  text                        TEXT NOT NULL,
-  status                      TEXT NOT NULL DEFAULT 'pending',
-  review_reason               TEXT,
-  review_confidence           REAL,
-  reviewed_by                 TEXT,
-  reviewed_at                 INTEGER,
-  requires_human_approval     INTEGER NOT NULL DEFAULT 1,
-  created_at                  INTEGER NOT NULL,
-  updated_at                  INTEGER NOT NULL,
-  sort_order                  INTEGER NOT NULL,
-  UNIQUE(goal_id, text),
-  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
-);
-
-CREATE INDEX IF NOT EXISTS idx_goal_evidence_requirements_goal_order
-  ON goal_evidence_requirements(goal_id, sort_order ASC);
-
-CREATE TABLE IF NOT EXISTS goal_evidence_requirement_links (
-  requirement_id TEXT NOT NULL,
-  evidence_id    TEXT NOT NULL,
-  linked_by      TEXT NOT NULL,
-  created_at     INTEGER NOT NULL,
-  PRIMARY KEY (requirement_id, evidence_id),
-  FOREIGN KEY (requirement_id) REFERENCES goal_evidence_requirements(requirement_id) ON DELETE CASCADE,
-  FOREIGN KEY (evidence_id) REFERENCES goal_evidence(evidence_id) ON DELETE CASCADE
-);
-
-CREATE INDEX IF NOT EXISTS idx_goal_evidence_requirement_links_evidence
-  ON goal_evidence_requirement_links(evidence_id);
-
 CREATE TABLE IF NOT EXISTS goal_session_links (
   goal_id       TEXT NOT NULL,
   session_key   TEXT NOT NULL,

package/dist/src/storage/sqlite/session-repository.js

@@ -1,7 +1,7 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { validateSessionId } from "../../session/session-id.js";
 import { buildDefaultSessionMetadata } from "./session-metadata.js";
 import { buildGlobalSessionStats, metadataToSessionInsert, sessionRowToMetadata } from "./row-mappers.js";
-import { validateSessionId } from "../../session/session-id.js";
 import { escapeFts5Query } from "./fts.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/session-repository.ts

package/dist/src/storage/sqlite/session-task-plan-repository.d.ts

@@ -0,0 +1,20 @@
+export type SessionTaskPlanItemStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled';
+export type SessionTaskPlanItem = {
+    id: string;
+    content: string;
+    status: SessionTaskPlanItemStatus;
+};
+export type SessionTaskPlan = {
+    sessionId: string;
+    planId: string;
+    items: SessionTaskPlanItem[];
+    revision: number;
+    updatedAt: number;
+};
+export declare function getSessionTaskPlan(sessionKey: string, planId?: string): SessionTaskPlan | undefined;
+export declare function setSessionTaskPlan(input: {
+    sessionKey: string;
+    planId?: string;
+    items: SessionTaskPlanItem[];
+    now?: number;
+}): SessionTaskPlan | undefined;

package/dist/src/storage/sqlite/session-task-plan-repository.js

@@ -0,0 +1,77 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getCurrentSessionId } from "./session-repository.js";
+//#region src/storage/sqlite/session-task-plan-repository.ts
+const VALID_STATUSES = new Set([
+	"pending",
+	"in_progress",
+	"completed",
+	"cancelled"
+]);
+function parseItems(value) {
+	try {
+		const raw = JSON.parse(value);
+		if (!Array.isArray(raw)) return [];
+		return raw.flatMap((value) => {
+			if (!value || typeof value !== "object" || Array.isArray(value)) return [];
+			const item = value;
+			const id = typeof item.id === "string" ? item.id.trim() : "";
+			const content = typeof item.content === "string" ? item.content.trim() : "";
+			const status = item.status;
+			return id && content && VALID_STATUSES.has(status) ? [{
+				id,
+				content,
+				status
+			}] : [];
+		});
+	} catch {
+		return [];
+	}
+}
+function fromRow(row) {
+	return {
+		sessionId: row.session_id,
+		planId: row.plan_id,
+		items: parseItems(row.items_json),
+		revision: row.revision,
+		updatedAt: row.updated_at
+	};
+}
+function getSessionTaskPlan(sessionKey, planId = "todo") {
+	const sessionId = getCurrentSessionId(sessionKey);
+	if (!sessionId) return void 0;
+	const row = getSqliteDatabase().prepare(`SELECT session_id, plan_id, items_json, revision, updated_at
+     FROM session_task_plans
+     WHERE session_id = ? AND plan_id = ?`).get(sessionId, planId);
+	return row ? fromRow(row) : void 0;
+}
+function setSessionTaskPlan(input) {
+	const planId = input.planId?.trim() || "todo";
+	if (!input.items.some((item) => item.status === "pending" || item.status === "in_progress")) {
+		deleteSessionTaskPlan(input.sessionKey, planId);
+		return;
+	}
+	const sessionId = getCurrentSessionId(input.sessionKey);
+	if (!sessionId) return void 0;
+	const now = input.now ?? Date.now();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO session_task_plans (session_id, plan_id, items_json, revision, updated_at)
+       VALUES (?, ?, ?, 1, ?)
+       ON CONFLICT(session_id, plan_id) DO UPDATE SET
+         items_json = excluded.items_json,
+         revision = session_task_plans.revision + 1,
+         updated_at = excluded.updated_at`).run(sessionId, planId, JSON.stringify(input.items), now);
+	});
+	return getSessionTaskPlan(input.sessionKey, planId);
+}
+function deleteSessionTaskPlan(sessionKey, planId = "todo") {
+	const sessionId = getCurrentSessionId(sessionKey);
+	if (!sessionId) return false;
+	let deleted = false;
+	runSqliteWriteTransaction((db) => {
+		deleted = db.prepare(`DELETE FROM session_task_plans
+       WHERE session_id = ? AND plan_id = ?`).run(sessionId, planId).changes > 0;
+	});
+	return deleted;
+}
+//#endregion
+export { getSessionTaskPlan, setSessionTaskPlan };

package/dist/src/tui/backends/embedded-backend.js

@@ -10,6 +10,7 @@ import { init_agent_scope, listAgentEntries, normalizeAgentId } from "../../agen
 import { loadConfig, saveConfig } from "../../config/loader.js";
 import { effectiveWorkspacePathForSession } from "../../session/session-workspace.js";
 import { createCreateShareTool, isShareToolAvailable } from "../../agent/tools/create-share-tool.js";
+import { setTuiDefaultAgentConfig } from "../../commands/agents.config.js";
 import { ProjectService } from "../../projects/project-service.js";
 import { inferSuggestedProjectDefaultAgentId } from "../../projects/project-agent-suggestion.js";
 import "../../projects/index.js";
@@ -23,7 +24,6 @@ import { parseModelRef } from "../../agent/models/selection.js";
 import { buildReviewContext, resolveGitRoot } from "../../review/review-git.js";
 import { MessageBus, MessageBusShutdownError } from "../../infra/bus/queue.js";
 import "../../infra/bus/index.js";
-import { setTuiDefaultAgentConfig } from "../../commands/agents.config.js";
 import { getWorkspacePath } from "../../config/workspace-path-helpers.js";
 import "../../config/index.js";
 import { buildWorkflowChildTools } from "../../agent/workflow/workflow-child-tools.js";

package/dist/src/tunnel/frpc-binary.js

@@ -6,8 +6,8 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { chmodSync, createWriteStream, existsSync, mkdirSync, rmSync } from "node:fs";
 import { randomBytes } from "node:crypto";
-import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
 //#region src/tunnel/frpc-binary.ts
 init_paths();
 init_logger();

package/dist/src/tunnel/frpc-extract.js

@@ -3,8 +3,8 @@ import { init_logger } from "../utils/logger.js";
 import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { spawn } from "node:child_process";
-import AdmZip from "adm-zip";
 import { gunzipSync } from "node:zlib";
+import AdmZip from "adm-zip";
 //#region src/tunnel/frpc-extract.ts
 init_logger();
 const log = createLogger("TunnelFrpcExtract");

package/dist/src/tunnel/index.js

@@ -1,8 +1,9 @@
 import { loadTunnelState, resolveTunnelStatePath, saveTunnelState } from "./tunnel-state.js";
 import { buildMobileConnectQrPayload, resolveLanGatewayUrl } from "./tunnel-qr.js";
 import { CURRENT_TUNNEL_CONSENT_VERSION, TUNNEL_CONSENT_REQUIRED_CODE, TUNNEL_RISK_SUMMARY_LINES, TunnelConsentError, assertTunnelMayStart, getTunnelConsentState, hasValidTunnelConsent } from "./consent.js";
-import { getTunnelRegistrationSecretMeta, isMaskedTunnelSecretPatchValue, isProductionTunnelBroker, resolveTunnelBrokerUrl, resolveTunnelRegistrationSecret } from "./env.js";
 import { TunnelBrokerClient, resolveBrokerApiBase } from "./broker-client.js";
+import { getTunnelRegistrationSecretMeta, isMaskedTunnelSecretPatchValue, isProductionTunnelBroker, resolveTunnelBrokerUrl, resolveTunnelRegistrationSecret } from "./env.js";
+import { applyTunnelConsentToConfig, mergeTunnelConfigPatch, sanitizeTunnelConfig, setTunnelEnabledInConfig } from "./tunnel-config.js";
 import { FRPC_VERSION, clearFrpcPathForProcess, ensureFrpcBinary, publishFrpcPathForProcess } from "./frpc-binary.js";
 import { consumePairingSecret, createPairingSecret, resetPairingSessionsForTests } from "./pairing.js";
 import { logTunnelAudit } from "./tunnel-audit.js";
@@ -10,6 +11,5 @@ import { TunnelService, getTunnelService, hashGatewayToken } from "./tunnel-serv
 import { resolveFrpSubdomainHost } from "./frp-subdomain-host.js";
 import { clearTunnelWellKnownCache, fetchTunnelWellKnown } from "./well-known.js";
 import { configureTunnelFromGatewayConfig, maybeAutoStartTunnelFromConfig, wireTunnelEventsToGateway } from "./gateway-lifecycle.js";
-import { applyTunnelConsentToConfig, mergeTunnelConfigPatch, sanitizeTunnelConfig, setTunnelEnabledInConfig } from "./tunnel-config.js";
 import { consumeTunnelMutationLimit, resetTunnelMutationLimitsForTests } from "./tunnel-rate-limit.js";
 export { CURRENT_TUNNEL_CONSENT_VERSION, FRPC_VERSION, TUNNEL_CONSENT_REQUIRED_CODE, TUNNEL_RISK_SUMMARY_LINES, TunnelBrokerClient, TunnelConsentError, TunnelService, applyTunnelConsentToConfig, assertTunnelMayStart, buildMobileConnectQrPayload, clearFrpcPathForProcess, clearTunnelWellKnownCache, configureTunnelFromGatewayConfig, consumePairingSecret, consumeTunnelMutationLimit, createPairingSecret, ensureFrpcBinary, fetchTunnelWellKnown, getTunnelConsentState, getTunnelRegistrationSecretMeta, getTunnelService, hasValidTunnelConsent, hashGatewayToken, isMaskedTunnelSecretPatchValue, isProductionTunnelBroker, loadTunnelState, logTunnelAudit, maybeAutoStartTunnelFromConfig, mergeTunnelConfigPatch, publishFrpcPathForProcess, resetPairingSessionsForTests, resetTunnelMutationLimitsForTests, resolveBrokerApiBase, resolveFrpSubdomainHost, resolveLanGatewayUrl, resolveTunnelBrokerUrl, resolveTunnelRegistrationSecret, resolveTunnelStatePath, sanitizeTunnelConfig, saveTunnelState, setTunnelEnabledInConfig, wireTunnelEventsToGateway };

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

@@ -0,0 +1,31 @@
+import type { UserContextPlan } from '../agent/memory/context/types.js';
+import { type RelationshipSettings } from '../storage/sqlite/index.js';
+export interface ContextSnapshot {
+    id: string;
+    traceId: string;
+    sessionKey: string;
+    query: string;
+    selectedItems: UserContextPlan['items'];
+    rejectedItems: UserContextPlan['rejected'];
+    consentRequests: UserContextPlan['consentRequests'];
+    relationshipPolicy: RelationshipSettings;
+    estimatedTokens: number;
+    outcomeId?: string;
+    runId?: string;
+    createdAt: number;
+}
+export declare class ContextCompiler {
+    capture(input: {
+        sessionKey: string;
+        query: string;
+        plan: UserContextPlan;
+        now?: number;
+    }): ContextSnapshot;
+    get(id: string): ContextSnapshot | undefined;
+    latestForSession(sessionKey: string, since?: number): ContextSnapshot | undefined;
+    linkToRun(input: {
+        snapshotId: string;
+        outcomeId?: string;
+        runId: string;
+    }): ContextSnapshot | undefined;
+}

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

@@ -0,0 +1,51 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { getRelationshipSettings } from "../storage/sqlite/relationship-settings-repository.js";
+import "../storage/sqlite/index.js";
+import { randomUUID } from "node:crypto";
+//#region src/user-context/context-compiler.ts
+function fromRow(row) {
+	return {
+		id: row.snapshot_id,
+		traceId: row.trace_id,
+		sessionKey: row.session_key,
+		query: row.query,
+		selectedItems: JSON.parse(row.selected_items_json),
+		rejectedItems: JSON.parse(row.rejected_items_json),
+		consentRequests: JSON.parse(row.consent_requests_json),
+		relationshipPolicy: JSON.parse(row.relationship_policy_json),
+		estimatedTokens: row.estimated_tokens,
+		...row.outcome_id ? { outcomeId: row.outcome_id } : {},
+		...row.run_id ? { runId: row.run_id } : {},
+		createdAt: row.created_at
+	};
+}
+var ContextCompiler = class {
+	capture(input) {
+		const now = input.now ?? Date.now();
+		const id = randomUUID();
+		runSqliteWriteTransaction((db) => {
+			db.prepare(`INSERT INTO context_snapshots (
+          snapshot_id, trace_id, session_key, query, selected_items_json,
+          rejected_items_json, consent_requests_json, relationship_policy_json,
+          estimated_tokens, created_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, input.plan.traceId, input.sessionKey, input.query.trim(), JSON.stringify(input.plan.items), JSON.stringify(input.plan.rejected), JSON.stringify(input.plan.consentRequests), JSON.stringify(getRelationshipSettings()), input.plan.estimatedTokens, now);
+		});
+		return this.get(id);
+	}
+	get(id) {
+		const row = getSqliteDatabase().prepare("SELECT * FROM context_snapshots WHERE snapshot_id = ?").get(id);
+		return row ? fromRow(row) : void 0;
+	}
+	latestForSession(sessionKey, since = 0) {
+		const row = getSqliteDatabase().prepare(`SELECT * FROM context_snapshots
+       WHERE session_key = ? AND created_at >= ?
+       ORDER BY created_at DESC LIMIT 1`).get(sessionKey, since);
+		return row ? fromRow(row) : void 0;
+	}
+	linkToRun(input) {
+		getSqliteDatabase().prepare(`UPDATE context_snapshots SET outcome_id = ?, run_id = ? WHERE snapshot_id = ?`).run(input.outcomeId ?? null, input.runId, input.snapshotId);
+		return this.get(input.snapshotId);
+	}
+};
+//#endregion
+export { ContextCompiler };

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/stt/config.d.ts

@@ -0,0 +1,4 @@
+import type { STTConfig } from './types.js';
+export declare function mergeSttConfigFromAppConfig(stt: Partial<STTConfig> | undefined, toolsMedia?: {
+    models?: STTConfig['sharedModels'];
+}): STTConfig;

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

@@ -0,0 +1,26 @@
+import { DEFAULT_STT_CONFIG } from "./types.js";
+//#region src/voice/stt/config.ts
+function mergeSttProviders(base, patch) {
+	if (!base && !patch) return void 0;
+	const merged = { ...base ?? {} };
+	for (const [id, slice] of Object.entries(patch ?? {})) merged[id] = {
+		...merged[id] ?? {},
+		...slice
+	};
+	return merged;
+}
+function mergeSttConfigFromAppConfig(stt, toolsMedia) {
+	const patch = stt ?? {};
+	return {
+		...DEFAULT_STT_CONFIG,
+		...patch,
+		providers: mergeSttProviders(DEFAULT_STT_CONFIG.providers, patch.providers),
+		fallback: {
+			...DEFAULT_STT_CONFIG.fallback,
+			...patch.fallback
+		},
+		...toolsMedia?.models?.length ? { sharedModels: toolsMedia.models } : {}
+	};
+}
+//#endregion
+export { mergeSttConfigFromAppConfig };

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

@@ -9,6 +9,7 @@ import './providers/index.js';
 import type { STTConfig, STTOptions, STTResult } from './types.js';
 export { transcribe } from './transcribe-core.js';
 export { isSTTAvailable } from './availability.js';
+export { mergeSttConfigFromAppConfig } from './config.js';
 /**
  * Single-provider transcription helper. Used by chat-commands /stt so a user
  * can force a specific provider regardless of fallback config.

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

@@ -4,6 +4,7 @@ import "./providers/index.js";
 import { resolveSTTProviderChain, resolveSTTProviderConfig, resolveSTTProviderOrder } from "./factory.js";
 import { transcribe } from "./transcribe-core.js";
 import { isSTTAvailable } from "./availability.js";
+import { mergeSttConfigFromAppConfig } from "./config.js";
 import { checkMentionInTranscription } from "./mention.js";
 import { audioPreflightTranscribe } from "./preflight.js";
 //#region src/voice/stt/index.ts
@@ -28,4 +29,4 @@ async function transcribeWithProvider(audioBuffer, providerName, config, options
 	};
 }
 //#endregion
-export { alibabaTranscriptionProvider, audioPreflightTranscribe, checkMentionInTranscription, isSTTAvailable, openAiTranscriptionProvider, resolveSTTProviderChain, resolveSTTProviderConfig, resolveSTTProviderOrder, transcribe, transcribeWithProvider };
+export { alibabaTranscriptionProvider, audioPreflightTranscribe, checkMentionInTranscription, isSTTAvailable, mergeSttConfigFromAppConfig, openAiTranscriptionProvider, resolveSTTProviderChain, resolveSTTProviderConfig, resolveSTTProviderOrder, transcribe, transcribeWithProvider };

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

@@ -1,6 +1,6 @@
 import { listMediaUnderstandingProviders } from "../../media-understanding/registry.js";
 import { resolveSTTProviderConfig } from "./factory.js";
-import { mergeSttConfigFromAppConfig } from "../../channels/attachments/voice-stt-webchat.js";
+import { mergeSttConfigFromAppConfig } from "./config.js";
 import { getVoiceProviderMetadata } from "../metadata/registry.js";
 import "../metadata/index.js";
 //#region src/voice/stt/list-providers.ts

package/dist/src/work/attention-governor.d.ts

@@ -0,0 +1,20 @@
+import type { WorkHomeAttention, WorkHomeDecision } from '@xopcai/gateway-contract';
+export interface AttentionProjection {
+    decisions: WorkHomeDecision[];
+    attention: WorkHomeAttention[];
+    policy: {
+        visibleDecisionCount: number;
+        suppressedDecisionCount: number;
+        visibleAttentionCount: number;
+        suppressedAttentionCount: number;
+    };
+}
+export declare class AttentionGovernor {
+    project(input: {
+        decisions: WorkHomeDecision[];
+        attention: WorkHomeAttention[];
+        proactiveEnabled: boolean;
+        maxDecisions?: number;
+        maxAttention?: number;
+    }): AttentionProjection;
+}

package/dist/src/work/attention-governor.js

@@ -0,0 +1,46 @@
+//#region src/work/attention-governor.ts
+function decisionScore(item) {
+	if (item.reason === "approval_required") return 100;
+	if (item.reason === "needs_input") return 95;
+	if (item.reason === "blocked") return 85;
+	if (item.reason === "in_review") return 80;
+	if (item.kind === "agent_judgment") return Math.round((item.judgment?.valueScore ?? 0) * 70) + (item.urgency === "now" ? 20 : 0);
+	if (item.reason === "overdue") return 70;
+	return 50;
+}
+function decisionKey(item) {
+	const title = item.title.trim().toLocaleLowerCase();
+	return item.response ? item.id : `${item.projectId ?? "global"}:${title}:${item.reason === "approval_required" ? item.id : ""}`;
+}
+function keepDecision(item, proactiveEnabled) {
+	if (item.kind !== "agent_judgment") return true;
+	if (!proactiveEnabled) return false;
+	return (item.judgment?.confidence ?? 0) >= .65 && (item.judgment?.valueScore ?? 0) >= .6;
+}
+var AttentionGovernor = class {
+	project(input) {
+		const maxDecisions = Math.max(1, Math.min(20, input.maxDecisions ?? 7));
+		const maxAttention = Math.max(1, Math.min(10, input.maxAttention ?? 5));
+		const seen = /* @__PURE__ */ new Set();
+		const eligible = [...input.decisions].filter((item) => keepDecision(item, input.proactiveEnabled)).sort((left, right) => decisionScore(right) - decisionScore(left) || right.updatedAt - left.updatedAt).filter((item) => {
+			const key = decisionKey(item);
+			if (seen.has(key)) return false;
+			seen.add(key);
+			return true;
+		});
+		const attention = [...input.attention].sort((left, right) => right.updatedAt - left.updatedAt).slice(0, maxAttention);
+		const decisions = eligible.slice(0, maxDecisions);
+		return {
+			decisions,
+			attention,
+			policy: {
+				visibleDecisionCount: decisions.length,
+				suppressedDecisionCount: Math.max(0, input.decisions.length - decisions.length),
+				visibleAttentionCount: attention.length,
+				suppressedAttentionCount: Math.max(0, input.attention.length - attention.length)
+			}
+		};
+	}
+};
+//#endregion
+export { AttentionGovernor };

package/dist/src/work/execution-context.d.ts

@@ -0,0 +1,16 @@
+import type { SessionMetadata } from '../session/types.js';
+import type { ExecutionReceiptContext } from '../storage/sqlite/execution-receipt-repository.js';
+export interface ExecutionContext extends ExecutionReceiptContext {
+    runId: string;
+    sessionKey: string;
+    channel: string;
+    agentId?: string;
+}
+export declare function resolveExecutionContext(input: {
+    runId: string;
+    sessionKey: string;
+    channel: string;
+    metadata: SessionMetadata;
+    agentId?: string;
+}): ExecutionContext;
+export declare function executionReceiptContext(context: ExecutionContext): ExecutionReceiptContext;