@xopcai/xopc 0.0.210 → 0.0.213

package/dist/src/providers/xopc-cloud-model-source.js

@@ -1,11 +1,6 @@
-import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
-import { getModelRegistry, init_model_registry } from "./model-registry.js";
 import { init_xopc_cloud_config, resolveXopcModelRouterUrl } from "./xopc-cloud-config.js";
 import { getProviderAuthService, init_provider_auth_service } from "./provider-auth-service.js";
-import { reloadImageGenerationProviders } from "../agent/image/generation/provider-registry.js";
 //#region src/providers/xopc-cloud-model-source.ts
-init_model_catalog_store();
-init_model_registry();
 init_provider_auth_service();
 init_xopc_cloud_config();
 var XopcCloudModelError = class extends Error {
@@ -20,17 +15,14 @@ var XopcCloudModelSource = class {
 	fetchImpl;
 	routerUrl;
 	credentials;
-	catalogStore;
-	refreshModels;
 	constructor(options = {}) {
 		this.fetchImpl = options.fetchImpl ?? fetch;
 		this.routerUrl = resolveXopcModelRouterUrl(options.routerUrl);
 		this.credentials = options.credentials ?? getProviderAuthService();
-		this.catalogStore = options.catalogStore ?? getModelCatalogStore();
-		this.refreshModels = options.refreshModels ?? (() => getModelRegistry().refresh());
 	}
-	async refresh() {
-		const accessToken = await this.credentials.resolveApiKey("xopc-cloud");
+	async fetch(signal) {
+		const requestSignal = signal ? AbortSignal.any([signal, AbortSignal.timeout(3e4)]) : AbortSignal.timeout(3e4);
+		const accessToken = await this.credentials.resolveApiKey("xopc-cloud", requestSignal);
 		if (!accessToken) return {
 			status: "skipped",
 			reason: "not_configured"
@@ -40,7 +32,7 @@ var XopcCloudModelSource = class {
 				authorization: `Bearer ${accessToken}`,
 				accept: "application/json"
 			},
-			signal: AbortSignal.timeout(3e4)
+			signal: requestSignal
 		});
 		const body = await response.json().catch(() => null);
 		if (!response.ok) throw new XopcCloudModelError(typeof body?.error?.message === "string" ? body.error.message : `XOPC model discovery failed (${response.status})`, response.status, typeof body?.error?.code === "string" ? body.error.code : void 0);
@@ -58,7 +50,7 @@ var XopcCloudModelSource = class {
 			const generation = parseImageGenerationCapabilities(model.xopc?.capabilities?.imageGeneration);
 			const stt = kind === "stt" ? parseSttCapabilities(model.xopc?.capabilities) : void 0;
 			const tts = kind === "tts" ? parseTtsCapabilities(model.xopc?.capabilities, model.xopc?.defaultVoice) : void 0;
-			return [model.id, {
+			const catalogModel = {
 				id: model.id,
 				name: model.id,
 				kind,
@@ -68,28 +60,58 @@ var XopcCloudModelSource = class {
 				reasoning: model.xopc?.capabilities?.reasoning === true,
 				contextWindow: 128e3,
 				maxOutputTokens: typeof maxOutputTokens === "number" && Number.isSafeInteger(maxOutputTokens) ? maxOutputTokens : null,
+				...model.xopc?.stability === "stable" || model.xopc?.stability === "preview" || model.xopc?.stability === "deprecated" ? { stability: model.xopc.stability } : {},
+				...typeof model.xopc?.priority === "number" && Number.isFinite(model.xopc.priority) ? { priority: model.xopc.priority } : {},
+				...typeof model.xopc?.tier === "string" && model.xopc.tier ? { tier: model.xopc.tier } : {},
+				...typeof model.xopc?.bestEffort === "boolean" ? { bestEffort: model.xopc.bestEffort } : {},
 				...generation ? { imageGeneration: generation } : {},
 				...stt ? { stt } : {},
 				...tts ? { tts } : {}
-			}];
+			};
+			return [model.id, catalogModel];
 		})).values()];
-		this.catalogStore.replaceSourceModels("xopc-cloud", {
-			providerId: "xopc-cloud",
-			baseUrl: this.routerUrl,
-			api: "openai-completions",
-			etag: response.headers.get("x-xopc-model-catalog-version"),
-			recommendedModel: models[0]?.id ?? null,
-			lastSuccessAt: Date.now()
-		}, models);
-		this.refreshModels();
-		reloadImageGenerationProviders();
+		const recommended = parseRecommendations(body.xopc?.defaults, models);
 		return {
-			status: "updated",
-			modelCount: models.length,
-			models: models.map((model) => model.id)
+			status: "fetched",
+			source: {
+				providerId: "xopc-cloud",
+				baseUrl: this.routerUrl,
+				api: "openai-completions",
+				etag: response.headers.get("x-xopc-model-catalog-version"),
+				recommendedModel: models[0]?.id ?? null,
+				...Object.keys(recommended).length > 0 ? { recommended } : {},
+				lastSuccessAt: Date.now()
+			},
+			models
 		};
 	}
 };
+function parseRecommendations(value, models) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+	const raw = value;
+	const capabilities = [
+		"vision",
+		"image-generation",
+		"stt",
+		"tts"
+	];
+	const recommended = {};
+	for (const capability of capabilities) {
+		const modelId = raw[capability];
+		if (typeof modelId !== "string") continue;
+		const model = models.find((entry) => entry.id === modelId);
+		if (model && modelMatchesRecommendation(model, capability)) recommended[capability] = modelId;
+	}
+	return recommended;
+}
+function modelMatchesRecommendation(model, capability) {
+	switch (capability) {
+		case "vision": return model.kind === "language" && model.input.includes("image");
+		case "image-generation": return model.kind === "image" && model.operations.includes("images.generate");
+		case "stt": return model.kind === "stt" && model.operations.includes("audio.transcription");
+		case "tts": return model.kind === "tts" && model.operations.includes("audio.speech");
+	}
+}
 function parseSttCapabilities(value) {
 	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
 	const raw = value;

package/dist/src/storage/sqlite/knowledge-repository.d.ts

@@ -40,6 +40,7 @@ export declare function getKnowledgeConsumerWatermark(consumerId: string, source
 export declare function setKnowledgeConsumerWatermark(consumerId: string, sourceInstanceId: string, sequence: number, nowMs?: number): void;
 export declare function listKnowledgeSourceItems(options?: {
     sourceInstanceId?: string;
+    agentId?: string;
     collectionScope?: string;
     itemType?: string;
     synthesisStatus?: KnowledgeSynthesisStatus;

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

@@ -240,6 +240,10 @@ function listKnowledgeSourceItems(options = {}) {
 		where.push("source_instance_id = ?");
 		params.push(options.sourceInstanceId);
 	}
+	if (options.agentId) {
+		where.push("json_extract(metadata_json, '$.agentId') = ?");
+		params.push(options.agentId);
+	}
 	if (options.collectionScope) {
 		where.push("collection_scope = ?");
 		params.push(options.collectionScope);

package/dist/src/storage/sqlite/migrations/124_workflow_context_snapshots.sql

@@ -0,0 +1,15 @@
+CREATE TABLE workflow_context_snapshots (
+  snapshot_id TEXT PRIMARY KEY,
+  trace_id TEXT NOT NULL UNIQUE,
+  run_id TEXT NOT NULL,
+  project_id TEXT,
+  selected_items_json TEXT NOT NULL,
+  estimated_tokens INTEGER NOT NULL DEFAULT 0,
+  content_hash TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX idx_workflow_context_snapshots_run
+  ON workflow_context_snapshots(run_id, created_at DESC);
+CREATE INDEX idx_workflow_context_snapshots_project
+  ON workflow_context_snapshots(project_id, created_at DESC);

package/dist/src/storage/sqlite/migrations/125_project_workflow_presets.sql

@@ -0,0 +1,12 @@
+CREATE TABLE project_workflow_presets (
+  project_id TEXT NOT NULL,
+  definition_id TEXT NOT NULL,
+  context_refs_json TEXT NOT NULL DEFAULT '[]',
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY (project_id, definition_id),
+  FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE
+);
+
+CREATE INDEX idx_project_workflow_presets_updated
+  ON project_workflow_presets(project_id, updated_at DESC);

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

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 123;
+export declare const XOPC_DB_SCHEMA_VERSION = 125;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

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

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 123;
+const XOPC_DB_SCHEMA_VERSION = 125;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function backupBeforeTaskCutover(db, databasePath) {
 	db.exec("PRAGMA wal_checkpoint(FULL)");
@@ -57,7 +57,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 123;
+	const targetVersion = options.targetVersion ?? 125;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -94,7 +94,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 123;
+	const appVersion = options.targetVersion ?? 125;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

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 = 123;
+export const XOPC_DB_SCHEMA_VERSION = 125;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

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

@@ -32,7 +32,7 @@ function ensureXopcDatabaseSchema(db, options = {}) {
 		currentVersion = 11;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 123,
+		targetVersion: 125,
 		databasePath: options.databasePath
 	});
 }

package/dist/src/storage/sqlite/user-context-quality-repository.d.ts

@@ -26,6 +26,14 @@ export type UserUnderstandingQualityMetrics = {
         irrelevant: number;
         helpfulRate: number | null;
     };
+    quickUnderstanding: {
+        sourcesAuthorized: number;
+        sourcesCollected: number;
+        sourceCoverage: number | null;
+        bootstrapJobs: number;
+        successfulBootstrapRate: number | null;
+        medianBootstrapDurationMs: number | null;
+    };
 };
 export type UnderstandingFeedbackSummary = {
     understandingId: string;

package/dist/src/storage/sqlite/user-context-quality-repository.js

@@ -28,6 +28,12 @@ function summarizeUnderstandingFeedback(understandingIds) {
 function rate(numerator, denominator) {
 	return denominator > 0 ? Math.round(numerator / denominator * 1e4) / 1e4 : null;
 }
+function median(values) {
+	if (!values.length) return null;
+	const sorted = values.toSorted((left, right) => left - right);
+	const middle = Math.floor(sorted.length / 2);
+	return sorted.length % 2 ? sorted[middle] : Math.round((sorted[middle - 1] + sorted[middle]) / 2);
+}
 function summarizeUserUnderstandingQuality(options = {}) {
 	const nowMs = options.nowMs ?? Date.now();
 	const windowDays = Math.max(1, Math.min(365, Math.floor(options.windowDays ?? 30)));
@@ -83,6 +89,12 @@ function summarizeUserUnderstandingQuality(options = {}) {
 		helpfulRate: null
 	};
 	recall.helpfulRate = rate(recall.helpful, recall.total);
+	const sourceRows = db.prepare(`SELECT last_collected_at
+    FROM understanding_source_grants WHERE status = 'active'`).all();
+	const bootstrapRows = db.prepare(`SELECT status, started_at, finished_at
+    FROM connector_learning_jobs WHERE mode = 'bootstrap' AND created_at >= ?`).all(sinceMs);
+	const completedBootstraps = bootstrapRows.filter((row) => row.status === "completed");
+	const bootstrapDurations = completedBootstraps.flatMap((row) => row.started_at !== null && row.finished_at !== null && row.finished_at >= row.started_at ? [row.finished_at - row.started_at] : []);
 	return {
 		windowDays,
 		since: new Date(sinceMs).toISOString(),
@@ -91,7 +103,15 @@ function summarizeUserUnderstandingQuality(options = {}) {
 			total: recentDecisions.length,
 			acceptanceRate: rate(accepted, recentDecisions.length)
 		},
-		recall
+		recall,
+		quickUnderstanding: {
+			sourcesAuthorized: sourceRows.length,
+			sourcesCollected: sourceRows.filter((row) => row.last_collected_at !== null).length,
+			sourceCoverage: rate(sourceRows.filter((row) => row.last_collected_at !== null).length, sourceRows.length),
+			bootstrapJobs: bootstrapRows.length,
+			successfulBootstrapRate: rate(completedBootstraps.length, bootstrapRows.length),
+			medianBootstrapDurationMs: median(bootstrapDurations)
+		}
 	};
 }
 //#endregion

package/dist/src/tasks/home-query-service.d.ts

@@ -1,20 +1,12 @@
-import type { HomeResponse } from '@xopcai/gateway-contract';
-import { type AutomationRun } from '../automations/index.js';
+import type { HomeAttention, HomeDecision, HomeResponse } from '@xopcai/gateway-contract';
 import type { AutomationService } from '../automations/service/automation-service.js';
 import type { Config } from '../config/schema.js';
-import type { NotesService } from '../notes/service.js';
 import type { ProactiveInboxService } from '../proactive/inbox/service.js';
 import type { ProjectService } from '../projects/project-service.js';
-import type { SessionIndex } from '../session/manager.js';
 import type { WorkflowRunSummary } from '../workflows/domain/index.js';
 import type { WorkflowRunService } from '../workflows/service/workflow-run-service.js';
+import { type TaskAggregate } from './task-repository.js';
 import { type TaskReadModel } from './task-read-model-projector.js';
-type HomeDecision = HomeResponse['decisions'][number];
-type HomeAttention = HomeResponse['attention'][number];
-type HomeBriefingWin = HomeResponse['briefing']['wins'][number];
-type HomeAutomation = HomeResponse['upcomingAutomations'][number];
-type HomeFocusItem = HomeResponse['focusItems'][number];
-type HomeRecentTask = HomeResponse['recentTasks'][number];
 type HomeWorkflowRun = {
     id: string;
     definitionId: string;
@@ -26,141 +18,34 @@ type HomeWorkflowRun = {
     completedAtMs?: number;
     metrics: WorkflowRunSummary['metrics'];
 };
-type HomeAutomationRun = {
+type HomeAutomation = {
     id: string;
-    automationId: string;
-    automationName?: string;
-    status: AutomationRun['status'];
-    createdAtMs: number;
-    startedAtMs?: number;
-    endedAtMs?: number;
-    error?: string;
-    summary?: string;
-    sessionKey?: string;
-    workflowRunId?: string;
-};
-type HomeSnapshot = HomeResponse & {
-    recentlyOpened: unknown[];
-    inboxCount: number;
-    pendingTasks: unknown[];
-    pendingTaskCount: number;
-    recentSessions: unknown[];
-    activeAgent: {
-        id: string;
-        name?: string;
-        description?: string;
-    };
-    gateway: Record<string, unknown>;
-    recentAutomationRuns: HomeAutomationRun[];
+    name?: string;
+    trigger: string;
+    action: string;
+    nextRunAt: string;
 };
 interface HomeGatewayPort {
-    readonly notesServiceInstance: NotesService;
-    readonly sessions: Pick<SessionIndex, 'listSessions'> & {
-        getActiveRun(sessionKey: string): {
-            active: boolean;
-            runId?: string;
-        };
-    };
     readonly currentConfig: Config;
     readonly automationServiceInstance: AutomationService;
     readonly projects: ProjectService;
     readonly proactiveInbox: ProactiveInboxService;
     createWorkflowRunService(): WorkflowRunService;
-    getHealth(): {
-        status: string;
-        ready: boolean;
-        httpListening: boolean;
-        version: string;
-        uptime: number;
-    };
 }
-export declare function decisionFromTask(model: TaskReadModel, projectName?: string): HomeDecision | null;
-export declare function buildHomeBriefing(input: {
-    locale?: string;
-    decisions: HomeDecision[];
-    attention: HomeAttention[];
-    activeWorkflowCount: number;
-    activeTaskCount: number;
-    wins: HomeBriefingWin[];
-    nextScheduled?: HomeAutomation;
-    nowMs: number;
-}): {
-    generatedAt: number;
-    summary: string;
-    focus: {
-        id: string;
-        kind: "task" | "agent_judgment" | "connector_approval";
-        title: string;
-        reason: "external" | "paused" | "blocked" | "dependency" | "user_input" | "approval_required" | "overdue" | "needs_input" | "user_approval" | "scheduled" | "retry" | "due_soon" | "decision_needed";
-        urgency: "now" | "soon";
-        href: string;
-        updatedAt: number;
-        detail?: string;
-        projectId?: string;
-        projectName?: string;
-        judgment?: {
-            inboxItemId: string;
-            whyNow: string;
-            impact: string;
-            workDone: string;
-            recommendation: string;
-            confidence: number;
-            valueScore?: number;
-            disposition?: "show_in_work" | "request_approval" | "auto_execute";
-            dispositionReason?: string;
-            actionStatus?: "failed" | "completed" | "rejected" | "pending" | "approval_required" | "not_authorized" | "executing";
-            proposedActionTitle?: string;
-            actionError?: string;
-            decision?: {
-                question: string;
-                options: {
-                    id: string;
-                    label: string;
-                    consequence: string;
-                }[];
-            };
-        };
-        response?: {
-            kind: "connector_approval";
-            approvalId: string;
-        };
-    }[];
-    progress: {
-        activeWorkflowCount: number;
-        activeTaskCount: number;
-        movingCount: number;
-    };
-    wins: {
-        id: string;
-        kind: "task" | "workflow_run" | "automation_run";
-        title: string;
-        href: string;
-        completedAt: number;
-    }[];
-    nextScheduled: {
-        id: string;
-        trigger: string;
-        action: string;
-        nextRunAt: string;
-        name?: string;
-    };
-};
-export declare function buildHomeFocusItems(input: {
+export declare function decisionFromTask(model: TaskReadModel, projectName?: string, locale?: string): HomeDecision | null;
+export declare function buildHomeWorkbench(input: {
     locale?: string;
     decisions: HomeDecision[];
     attention: HomeAttention[];
     activeWorkflowRuns: HomeWorkflowRun[];
-    runningTasks: HomeResponse['tasks']['running'];
-    wins: HomeBriefingWin[];
+    runningTasks: TaskAggregate[];
     scheduled: HomeAutomation[];
-    recentTasks: HomeRecentTask[];
-    inboxCount: number;
     nowMs: number;
-}): HomeFocusItem[];
+}): Pick<HomeResponse, 'needsUser' | 'background' | 'backgroundCount'>;
 export declare class HomeQueryService {
     #private;
     private readonly service;
     constructor(service: HomeGatewayPort);
-    getSnapshot(locale?: string): Promise<HomeSnapshot>;
+    getSnapshot(locale?: string): Promise<HomeResponse>;
 }
 export {};