@xopcai/xopc 0.0.323 → 0.0.324

package/dist/packages/gateway-contract/src/home.js

@@ -1,15 +1,11 @@
 import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { z } from "zod";
 //#region packages/gateway-contract/src/home.ts
-var HomeDecisionSchema, HomeActionSchema, HomeWorkbenchItemSchema, HomeRunningConversationSchema, TaskValueMetricsSchema;
+var HomeDecisionSchema, HomeActionSchema, HomeWorkbenchItemSchema, HomeRunningConversationSchema, HomeEvidenceSchema, HomeCapabilityReadinessSchema, HomeCapabilityBlockerSchema, HomeCapabilityPreflightSchema, HomeOpportunitySchema, HomeClarificationSchema, HomeAdvisorSchema, HomeAdvisorRefreshRequestSchema, HomeOpportunityFeedbackRequestSchema, HomeOpportunityFeedbackUndoRequestSchema, HomeOpportunityHistoryItemSchema, HomeOpportunityHistoryResponseSchema, HomeOpportunityActionRequestSchema, HomeAdviceMetricsSchema, TaskValueMetricsSchema;
 var init_home = __esmMin((() => {
 	HomeDecisionSchema = z.object({
 		id: z.string(),
-		kind: z.enum([
-			"agent_judgment",
-			"task",
-			"connector_approval"
-		]),
+		kind: z.enum(["task", "connector_approval"]),
 		title: z.string(),
 		detail: z.string().optional(),
 		reason: z.enum([
@@ -25,7 +21,6 @@ var init_home = __esmMin((() => {
 			"overdue",
 			"due_soon",
 			"decision_needed",
-			"insight_available",
 			"approval_required"
 		]),
 		urgency: z.enum(["now", "soon"]),
@@ -34,46 +29,6 @@ var init_home = __esmMin((() => {
 		projectName: z.string().optional(),
 		dueAt: z.number().int().nonnegative().optional(),
 		updatedAt: z.number(),
-		judgment: z.object({
-			inboxItemId: z.string(),
-			whyNow: z.string(),
-			impact: z.string(),
-			workDone: z.string(),
-			recommendation: z.string(),
-			confidence: z.number(),
-			valueScore: z.number().min(0).max(1).optional(),
-			evidenceIds: z.array(z.string()).max(20),
-			attentionKind: z.enum([
-				"information",
-				"decision",
-				"receipt"
-			]),
-			disposition: z.enum([
-				"show_in_work",
-				"request_approval",
-				"auto_execute"
-			]).optional(),
-			dispositionReason: z.string().optional(),
-			actionStatus: z.enum([
-				"not_authorized",
-				"approval_required",
-				"pending",
-				"executing",
-				"completed",
-				"rejected",
-				"failed"
-			]).optional(),
-			proposedActionTitle: z.string().optional(),
-			actionError: z.string().optional(),
-			decision: z.object({
-				question: z.string(),
-				options: z.array(z.object({
-					id: z.string(),
-					label: z.string(),
-					consequence: z.string()
-				}))
-			}).optional()
-		}).optional(),
 		response: z.discriminatedUnion("kind", [z.object({
 			kind: z.literal("connector_approval"),
 			approvalId: z.string()
@@ -96,11 +51,6 @@ var init_home = __esmMin((() => {
 			label: z.string(),
 			href: z.string()
 		}),
-		z.object({
-			type: z.literal("review_judgment"),
-			label: z.string(),
-			itemId: z.string()
-		}),
 		z.object({
 			type: z.literal("connector_decision"),
 			label: z.string(),
@@ -126,8 +76,7 @@ var init_home = __esmMin((() => {
 			"decision",
 			"failure",
 			"running",
-			"scheduled",
-			"insight"
+			"scheduled"
 		]),
 		title: z.string(),
 		summary: z.string(),
@@ -146,12 +95,251 @@ var init_home = __esmMin((() => {
 		agentId: z.string().optional(),
 		updatedAt: z.number()
 	});
+	HomeEvidenceSchema = z.strictObject({
+		id: z.string().trim().min(1).max(300),
+		sourceType: z.enum([
+			"project",
+			"task",
+			"conversation",
+			"scene",
+			"calendar",
+			"mail",
+			"communication",
+			"file",
+			"user_model"
+		]),
+		sourceRef: z.string().trim().min(1).max(1e3),
+		revision: z.string().trim().min(1).max(300),
+		observation: z.string().trim().min(1).max(1e3),
+		observedAt: z.number().int().nonnegative(),
+		freshUntil: z.number().int().nonnegative(),
+		href: z.string().trim().min(1).max(2e3).optional()
+	});
+	HomeCapabilityReadinessSchema = z.strictObject({
+		kind: z.enum([
+			"connector",
+			"skill",
+			"agent"
+		]),
+		capability: z.string().trim().min(1).max(200),
+		resolvedId: z.string().trim().min(1).max(300).optional(),
+		readiness: z.enum([
+			"ready",
+			"needs_setup",
+			"unavailable"
+		]),
+		required: z.boolean(),
+		recoveryPath: z.string().trim().min(1).max(2e3).optional(),
+		reason: z.string().trim().min(1).max(500).optional()
+	});
+	HomeCapabilityBlockerSchema = z.strictObject({
+		kind: z.enum([
+			"connector",
+			"skill",
+			"agent"
+		]),
+		capability: z.string().trim().min(1).max(200),
+		code: z.enum([
+			"not_installed",
+			"disabled",
+			"agent_not_allowed",
+			"scope_too_narrow",
+			"connection_missing",
+			"account_selection_required",
+			"reauthorization_required",
+			"requirements_unmet",
+			"model_invocation_disabled",
+			"tool_gated",
+			"agent_unavailable"
+		]),
+		message: z.string().trim().min(1).max(500),
+		recoveryPath: z.string().trim().min(1).max(2e3)
+	});
+	HomeCapabilityPreflightSchema = z.discriminatedUnion("state", [z.strictObject({ state: z.literal("ready") }), z.strictObject({
+		state: z.literal("needs_setup"),
+		blockers: z.array(HomeCapabilityBlockerSchema).min(1).max(12),
+		recoveryActions: z.array(z.strictObject({
+			capability: z.string().trim().min(1).max(200),
+			href: z.string().trim().min(1).max(2e3)
+		})).min(1).max(12),
+		degradedAction: z.strictObject({ mode: z.literal("degraded_start") }).optional()
+	})]);
+	HomeOpportunitySchema = z.strictObject({
+		id: z.string().trim().min(1).max(200),
+		revision: z.number().int().positive(),
+		kind: z.enum([
+			"project_next_step",
+			"delivery_risk",
+			"meeting_prep",
+			"commitment_follow_up",
+			"automation_candidate"
+		]),
+		projectId: z.string().trim().min(1).max(200).optional(),
+		title: z.string().trim().min(1).max(160),
+		outcome: z.string().trim().min(1).max(1e3),
+		rationale: z.string().trim().min(1).max(1500),
+		evidence: z.array(HomeEvidenceSchema).min(1).max(8),
+		confidence: z.enum([
+			"high",
+			"medium",
+			"low"
+		]),
+		urgency: z.enum([
+			"now",
+			"today",
+			"this_week"
+		]),
+		estimatedMinutes: z.number().int().min(1).max(480).optional(),
+		risk: z.enum([
+			"analysis",
+			"external_read",
+			"file_write",
+			"external_write"
+		]),
+		proposedSteps: z.array(z.string().trim().min(1).max(500)).min(1).max(6),
+		capabilities: z.array(HomeCapabilityReadinessSchema).max(12),
+		verification: z.array(z.string().trim().min(1).max(500)).max(8),
+		actionPrompt: z.string().trim().min(1).max(4e3),
+		degradedActionPrompt: z.string().trim().min(1).max(4e3).optional(),
+		continuation: z.discriminatedUnion("kind", [z.strictObject({
+			kind: z.literal("scene"),
+			reason: z.literal("prior_success"),
+			href: z.string().trim().min(1).max(2e3)
+		}), z.strictObject({
+			kind: z.literal("automation"),
+			reason: z.literal("repeated_success"),
+			href: z.string().trim().min(1).max(4e3),
+			successCount: z.number().int().min(2)
+		})]).optional(),
+		actions: z.strictObject({
+			canStart: z.boolean(),
+			canDiscuss: z.boolean(),
+			degradedStartAvailable: z.boolean()
+		}),
+		generatedAt: z.number().int().nonnegative(),
+		expiresAt: z.number().int().nonnegative()
+	});
+	HomeClarificationSchema = z.strictObject({
+		id: z.string().trim().min(1).max(200),
+		revision: z.number().int().positive(),
+		question: z.string().trim().min(1).max(500),
+		options: z.array(z.strictObject({
+			id: z.string().trim().min(1).max(100),
+			label: z.string().trim().min(1).max(200)
+		})).min(2).max(3),
+		evidenceIds: z.array(z.string().trim().min(1).max(300)).min(1).max(8)
+	});
+	HomeAdvisorSchema = z.discriminatedUnion("state", [
+		z.strictObject({ state: z.literal("disabled") }),
+		z.strictObject({
+			state: z.literal("quiet"),
+			reason: z.enum([
+				"no_change",
+				"insufficient_value",
+				"model_unavailable",
+				"generation_failed",
+				"budget_exhausted"
+			])
+		}),
+		z.strictObject({
+			state: z.literal("refreshing"),
+			previous: HomeOpportunitySchema.optional(),
+			requestedAt: z.number().int().nonnegative()
+		}),
+		z.strictObject({
+			state: z.literal("clarification"),
+			question: HomeClarificationSchema,
+			generatedAt: z.number().int().nonnegative(),
+			expiresAt: z.number().int().nonnegative()
+		}),
+		z.strictObject({
+			state: z.literal("ready"),
+			primary: HomeOpportunitySchema,
+			alternatives: z.array(HomeOpportunitySchema).max(2),
+			placement: z.enum(["primary", "compact"]),
+			generatedAt: z.number().int().nonnegative(),
+			expiresAt: z.number().int().nonnegative(),
+			stale: z.boolean()
+		})
+	]);
+	HomeAdvisorRefreshRequestSchema = z.strictObject({
+		idempotencyKey: z.string().trim().min(1).max(200),
+		locale: z.string().trim().max(30).optional()
+	});
+	HomeOpportunityFeedbackRequestSchema = z.strictObject({
+		idempotencyKey: z.string().trim().min(1).max(200),
+		expectedRevision: z.number().int().positive(),
+		kind: z.enum([
+			"already_done",
+			"irrelevant",
+			"too_early",
+			"source_incorrect",
+			"less_like_this",
+			"snoozed"
+		]),
+		reasonCode: z.string().trim().min(1).max(100).optional(),
+		note: z.string().trim().min(1).max(1e3).optional(),
+		snoozedUntil: z.number().int().nonnegative().optional()
+	});
+	HomeOpportunityFeedbackUndoRequestSchema = z.strictObject({ idempotencyKey: z.string().trim().min(1).max(200) });
+	HomeOpportunityHistoryItemSchema = z.strictObject({
+		opportunity: HomeOpportunitySchema,
+		status: z.enum([
+			"available",
+			"started",
+			"discussing",
+			"completed",
+			"snoozed",
+			"dismissed",
+			"expired",
+			"superseded"
+		]),
+		feedbackKind: z.enum([
+			"started",
+			"discussed",
+			"already_done",
+			"irrelevant",
+			"too_early",
+			"source_incorrect",
+			"less_like_this",
+			"snoozed"
+		]).optional(),
+		updatedAt: z.number().int().nonnegative(),
+		snoozedUntil: z.number().int().nonnegative().optional(),
+		href: z.string().trim().min(1).max(2e3).optional()
+	});
+	HomeOpportunityHistoryResponseSchema = z.strictObject({ items: z.array(HomeOpportunityHistoryItemSchema).max(100) });
+	HomeOpportunityActionRequestSchema = z.strictObject({
+		idempotencyKey: z.string().trim().min(1).max(200),
+		expectedRevision: z.number().int().positive(),
+		mode: z.enum([
+			"start",
+			"degraded_start",
+			"discuss"
+		])
+	});
+	z.discriminatedUnion("outcome", [
+		z.strictObject({
+			outcome: z.literal("task"),
+			taskId: z.string(),
+			href: z.string()
+		}),
+		z.strictObject({
+			outcome: z.literal("chat_draft"),
+			href: z.string()
+		}),
+		z.strictObject({
+			outcome: z.literal("needs_setup"),
+			preflight: HomeCapabilityPreflightSchema
+		})
+	]);
 	z.object({
 		runningConversations: z.array(HomeRunningConversationSchema).default([]),
 		needsUser: z.array(HomeWorkbenchItemSchema),
 		background: z.array(HomeWorkbenchItemSchema),
 		backgroundCount: z.number().int().nonnegative(),
 		decisions: z.array(HomeDecisionSchema),
+		advisor: HomeAdvisorSchema,
 		attentionPolicy: z.object({
 			visibleDecisionCount: z.number().int().nonnegative(),
 			suppressedDecisionCount: z.number().int().nonnegative(),
@@ -164,6 +352,47 @@ var init_home = __esmMin((() => {
 			suppressedAttentionCount: 0
 		})
 	});
+	HomeAdviceMetricsSchema = z.strictObject({
+		window: z.strictObject({
+			since: z.number().int().nonnegative(),
+			until: z.number().int().nonnegative()
+		}),
+		currentStrategyVersion: z.string().trim().min(1).max(100),
+		generations: z.strictObject({
+			total: z.number().int().nonnegative(),
+			succeeded: z.number().int().nonnegative(),
+			quiet: z.number().int().nonnegative(),
+			failed: z.number().int().nonnegative(),
+			estimatedCostUsd: z.number().nonnegative()
+		}),
+		outcomes: z.strictObject({
+			opportunities: z.number().int().nonnegative(),
+			started: z.number().int().nonnegative(),
+			discussed: z.number().int().nonnegative(),
+			completed: z.number().int().nonnegative(),
+			corrected: z.number().int().nonnegative(),
+			expired: z.number().int().nonnegative()
+		}),
+		rates: z.strictObject({
+			start: z.number().min(0).max(1),
+			completionFromStarted: z.number().min(0).max(1),
+			correction: z.number().min(0).max(1)
+		}),
+		feedback: z.strictObject({
+			alreadyDone: z.number().int().nonnegative(),
+			irrelevant: z.number().int().nonnegative(),
+			tooEarly: z.number().int().nonnegative(),
+			sourceIncorrect: z.number().int().nonnegative(),
+			lessLikeThis: z.number().int().nonnegative()
+		}),
+		strategies: z.array(z.strictObject({
+			version: z.string().trim().min(1).max(100),
+			generations: z.number().int().nonnegative(),
+			opportunities: z.number().int().nonnegative(),
+			started: z.number().int().nonnegative(),
+			completed: z.number().int().nonnegative()
+		}))
+	});
 	TaskValueMetricsSchema = z.object({
 		northStar: z.object({
 			weeklyTrustedProgress: z.number(),
@@ -185,4 +414,4 @@ var init_home = __esmMin((() => {
 }));
 //#endregion
 init_home();
-export { HomeActionSchema, HomeDecisionSchema, HomeRunningConversationSchema, HomeWorkbenchItemSchema, TaskValueMetricsSchema, init_home };
+export { HomeActionSchema, HomeAdviceMetricsSchema, HomeAdvisorRefreshRequestSchema, HomeAdvisorSchema, HomeCapabilityBlockerSchema, HomeCapabilityPreflightSchema, HomeCapabilityReadinessSchema, HomeClarificationSchema, HomeDecisionSchema, HomeEvidenceSchema, HomeOpportunityActionRequestSchema, HomeOpportunityFeedbackRequestSchema, HomeOpportunityFeedbackUndoRequestSchema, HomeOpportunityHistoryItemSchema, HomeOpportunityHistoryResponseSchema, HomeOpportunitySchema, HomeRunningConversationSchema, HomeWorkbenchItemSchema, TaskValueMetricsSchema, init_home };

package/dist/packages/gateway-contract/src/index.js

@@ -30,7 +30,6 @@ import { init_browser_tab_binding } from "./browser-tab-binding.js";
 import { init_model_selection } from "./model-selection.js";
 import { init_connection_waits } from "./connection-waits.js";
 import { init_clarifications } from "./clarifications.js";
-import { init_proactive } from "./proactive.js";
 import { init_discussions } from "./discussions.js";
 import { init_app_context } from "./app-context.js";
 import { init_scenes } from "./scenes.js";
@@ -67,7 +66,6 @@ var init_src = __esmMin((() => {
 	init_model_selection();
 	init_connection_waits();
 	init_clarifications();
-	init_proactive();
 	init_discussions();
 	init_capabilities();
 	init_scenes();

package/dist/packages/gateway-contract/src/notifications.js

@@ -28,19 +28,12 @@ var init_notifications = __esmMin((() => {
 			kind: z.literal("task"),
 			taskId: z.string().min(1)
 		}),
+		z.object({ kind: z.literal("home") }),
 		z.object({
 			kind: z.literal("automation_run"),
 			automationId: z.string().min(1),
 			runId: z.string().min(1)
 		}),
-		z.object({
-			kind: z.literal("proactive_digest"),
-			digestId: z.string().min(1)
-		}),
-		z.object({
-			kind: z.literal("insight"),
-			inboxItemId: z.string().min(1)
-		}),
 		z.object({
 			kind: z.literal("work_discovery"),
 			runId: z.string().min(1),
@@ -58,9 +51,9 @@ var init_notifications = __esmMin((() => {
 		"task.completed",
 		"automation.completed",
 		"automation.failed",
-		"proactive.insight",
 		"work_discovery.completed",
-		"work_discovery.failed"
+		"work_discovery.failed",
+		"home.opportunity"
 	]);
 	NotificationLocalizedTextSchema = z.object({
 		en: z.string().min(1).max(500),

package/dist/src/activity/emitter.js

@@ -2,9 +2,10 @@ import { currentActivityActor, currentActivityInitiator, currentActivitySource }
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 import { ActivityService } from "./service.js";
 //#region src/activity/emitter.ts
+init_sqlite();
 init_logger();
 const log = createLogger("ActivityEmitter");
 const activityService = new ActivityService();

package/dist/src/activity/service.js

@@ -1,7 +1,8 @@
 import { createObjectLinkRecord, deleteObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent } from "../storage/sqlite/activity-repository.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 import { randomUUID } from "node:crypto";
 //#region src/activity/service.ts
+init_sqlite();
 function normalizeLimit(limit) {
 	return Math.max(1, Math.min(100, Math.floor(limit ?? 50)));
 }

package/dist/src/agent/agent-manager.d.ts

@@ -101,6 +101,7 @@ export interface AgentManagerConfig {
     getChatPreviewService?: () => import('../chat-previews/index.js').ChatPreviewService | undefined;
     dispatchTaskEvents?: () => void;
     dispatchTaskRuns?: () => void;
+    onAgentCatalogMutate?: () => void;
     /** Gateway: starts persisted workflow runs (dedicated chat session per run). */
     getWorkflowRunService?: () => import('../workflows/service/workflow-run-service.types.js').WorkflowRunServiceLike | undefined;
     /** Runtime notification for UI/CLI shells that cache skill catalogs. */
@@ -181,7 +182,7 @@ export declare class AgentManager implements AgentInstanceGateway {
     private pickDefaultModelRef;
     private resolveModelStringToModel;
     /**
-     * Keep defaults in sync when config is hot-reloaded or saved from the UI.
+     * Refresh config-backed services and SQLite-backed Agent defaults after a settings change.
      *
      * The previous implementation rebuilt the entire `AgentToolsFactory` (80+ lines
      * of dependency wiring) on every reload. The factory's deps are now built from
@@ -190,7 +191,7 @@ export declare class AgentManager implements AgentInstanceGateway {
      * reconstruction. The browser is still shut down because its cached settings
      * (headless mode, backend choice) come from the config snapshot at connect time.
      */
-    updateAgentDefaults(config: Config): void;
+    updateRuntimeConfiguration(config: Config): void;
     /**
      * Construct the dep bag passed to `AgentToolsFactory`. Closures reference
      * `this.*` so they remain valid across hot reloads (no rebuild needed).