@xopcai/xopc 0.0.177 → 0.0.179

package/dist/src/agent/outcomes/{task-verifier.js → execution-verifier.js}

@@ -1,5 +1,5 @@
-//#region src/agent/outcomes/task-verifier.ts
-function verifyTaskCompletion(input) {
+//#region src/agent/outcomes/execution-verifier.ts
+function verifyExecutionCompletion(input) {
 	const checks = input.acceptanceCriteria.map((criterion) => {
 		const evidenceTitles = input.evidence.filter((evidence) => evidence.verifies?.includes(criterion)).map((evidence) => evidence.title);
 		return {
@@ -24,7 +24,7 @@ function verifyTaskCompletion(input) {
 		checks
 	};
 }
-function diagnoseTaskFailure(input) {
+function diagnoseExecutionFailure(input) {
 	const text = input.summary.toLocaleLowerCase();
 	if (input.status === "cancelled") return {
 		code: "cancelled",
@@ -68,4 +68,4 @@ function diagnoseTaskFailure(input) {
 	};
 }
 //#endregion
-export { diagnoseTaskFailure, verifyTaskCompletion };
+export { diagnoseExecutionFailure, verifyExecutionCompletion };

package/dist/src/agent/service/process-direct-streaming.js

@@ -4,8 +4,10 @@ import { formatAgentRunErrorForClient } from "../client-error-format.js";
 import { resolveConfiguredActivityDetailDefault, resolveEffectiveReasoningLevel } from "../../session/thinking-resolve.js";
 import { initSessionTurn } from "../../session/init-session-turn.js";
 import "../../session/index.js";
-import { isVoiceLikeAttachment, mergeSttConfigFromAppConfig, mergeVoiceTranscriptsIntoUserText } from "../../channels/attachments/voice-stt-webchat.js";
+import { mergeSttConfigFromAppConfig } from "../../voice/stt/config.js";
+import "../../voice/stt/index.js";
 import { abortEmbeddedRun } from "../embedded/runs.js";
+import { isVoiceLikeAttachment, mergeVoiceTranscriptsIntoUserText } from "../../channels/attachments/voice-stt-webchat.js";
 import { applyReasoningVisibilityToSseEvent } from "../streaming/reasoning-visibility-sse.js";
 import { injectSourceContextIntoUserMessage } from "../source-context/injector.js";
 import { isSessionSourceBinding } from "../source-context/types.js";

package/dist/src/agent/tools/factory.js

@@ -1,5 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
+import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/session-task-plan-repository.js";
+import "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
@@ -217,7 +220,19 @@ var AgentToolsFactory = class {
 				if (!CLARIFY_SUPPORTED_CHANNELS.has(ctx.channel)) return null;
 				return (r) => req(ctx.sessionKey, r);
 			} }),
-			createTodoTool({ getSessionKey: () => this.deps.getCurrentContext()?.sessionKey }),
+			createTodoTool({
+				getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
+				repository: {
+					isAvailable: isXopcDatabaseOpen,
+					read: (sessionKey) => getSessionTaskPlan(sessionKey)?.items ?? [],
+					write: (sessionKey, items) => {
+						setSessionTaskPlan({
+							sessionKey,
+							items
+						});
+					}
+				}
+			}),
 			createUpdatePlanTool(),
 			...getSkillMgr ? [
 				createSkillsListTool({

package/dist/src/agent/tools/goal-tool.js

@@ -3,6 +3,8 @@ import "../../storage/sqlite/index.js";
 import { GoalService } from "../../goals/goal-service.js";
 import "../../goals/index.js";
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
+import { OutcomeExecutionService } from "../../work/outcome-execution-service.js";
+import "../../work/index.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/goal-tool.ts
 const GoalToolSchema = Type.Object({
@@ -92,8 +94,8 @@ function createGoalTool(options = {}) {
 				if (!title) return textResult("Error: title is required.");
 				const sessionKey = params.sessionKey?.trim() || options.getCurrentSessionKey?.()?.trim();
 				const projectId = params.projectId?.trim() || (sessionKey ? getSessionMetadata(sessionKey)?.projectId : void 0);
-				const goal = goals.create({
-					title,
+				const goal = new OutcomeExecutionService().create({
+					objective: title,
 					description: params.description,
 					agentId: params.agentId,
 					sessionKey,
@@ -103,7 +105,7 @@ function createGoalTool(options = {}) {
 					judgeModelRef: params.judgeModelRef,
 					maxTurns: params.maxTurns,
 					source: "workflow"
-				});
+				}).goal;
 				return textResult(`Created goal ${goal.id}\n${goal.title}`, {
 					goal,
 					delivery: goalDelivery(goal, "created")

package/dist/src/agent/tools/todo-tool.d.ts

@@ -16,6 +16,11 @@ export declare class TodoStore {
 export interface CreateTodoToolOptions {
     /** Resolve session key for isolated lists; defaults to a single in-memory list. */
     getSessionKey?: () => string | null | undefined;
+    repository?: {
+        isAvailable?: () => boolean;
+        read: (sessionKey: string) => TodoItem[];
+        write: (sessionKey: string, items: TodoItem[]) => void;
+    };
 }
 /**
  * In-session task list for multi-step work. One {@link TodoStore} per session key.

package/dist/src/agent/tools/todo-tool.js

@@ -97,8 +97,17 @@ function resolveSessionKey(getSessionKey) {
 function createTodoTool(options) {
 	const getSessionKey = options?.getSessionKey ?? (() => "default");
 	const stores = /* @__PURE__ */ new Map();
-	const getStore = () => {
-		const key = resolveSessionKey(getSessionKey);
+	const activeRepository = () => {
+		const repository = options?.repository;
+		return repository && (repository.isAvailable?.() ?? true) ? repository : void 0;
+	};
+	const getStore = (key) => {
+		const repository = activeRepository();
+		if (repository) {
+			const store = new TodoStore();
+			store.write(repository.read(key), false);
+			return store;
+		}
 		let s = stores.get(key);
 		if (!s) {
 			s = new TodoStore();
@@ -112,8 +121,10 @@ function createTodoTool(options) {
 		description: "Plan and track tasks for complex multi-step work.\n\nUSAGE:\n- Provide `todos` array to write/update tasks\n- Omit `todos` to read the current list\n- Set `merge: true` to update existing items by id without replacing the whole list\n- Each item needs: id (unique string), content (task description), status\n- Valid statuses: pending, in_progress, completed, cancelled\n\nWHEN TO USE:\n- At the start of complex tasks (3+ steps) to plan your approach\n- After completing each step to update progress\n- When the user asks about progress or remaining work\n\nBEST PRACTICES:\n- Keep only one item in_progress at a time\n- Use merge=true to update status without rewriting the whole list\n- Create concrete, actionable items (not vague goals)",
 		parameters: TodoSchema,
 		async execute(_toolCallId, params, _signal) {
-			const store = getStore();
+			let store;
 			try {
+				const key = resolveSessionKey(getSessionKey);
+				store = getStore(key);
 				if (params.todos === void 0) {
 					const items = store.read();
 					return {
@@ -126,6 +137,7 @@ function createTodoTool(options) {
 				}
 				const p = params;
 				const items = store.write(p.todos, p.merge ?? false);
+				activeRepository()?.write(key, items);
 				return {
 					content: [{
 						type: "text",
@@ -139,7 +151,7 @@ function createTodoTool(options) {
 						type: "text",
 						text: `Error: ${error instanceof Error ? error.message : String(error)}`
 					}],
-					details: { items: store.read() }
+					details: { items: store?.read() ?? [] }
 				};
 			}
 		}

package/dist/src/agent/tools/update-plan-tool.d.ts

@@ -1,6 +1,7 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 export type TurnPlanStatus = 'pending' | 'in_progress' | 'completed';
 export interface TurnPlanStep {
+    id?: string;
     step: string;
     status: TurnPlanStatus;
 }

package/dist/src/agent/tools/update-plan-tool.js

@@ -6,6 +6,10 @@ const VALID_STATUSES = new Set([
 	"completed"
 ]);
 const PlanStepSchema = Type.Object({
+	id: Type.Optional(Type.String({
+		minLength: 1,
+		description: "Stable identifier for this step"
+	})),
 	step: Type.String({
 		minLength: 1,
 		description: "Short task step"
@@ -28,11 +32,13 @@ function normalizePlan(raw) {
 	if (!Array.isArray(raw)) throw new Error("plan must be an array");
 	const plan = raw.map((item) => {
 		const rec = item && typeof item === "object" ? item : {};
+		const id = typeof rec.id === "string" && rec.id.trim() ? rec.id.trim() : void 0;
 		const step = String(rec.step ?? "").trim();
 		const statusRaw = String(rec.status ?? "").trim();
 		if (!step) throw new Error("each plan item must include a non-empty step");
 		if (!VALID_STATUSES.has(statusRaw)) throw new Error(`invalid plan status: ${statusRaw || "(empty)"}`);
 		return {
+			...id ? { id } : {},
 			step,
 			status: statusRaw
 		};

package/dist/src/browser/providers/cloakbrowser.js

@@ -11,9 +11,9 @@ import { createReadStream, createWriteStream } from "node:fs";
 import { spawn } from "node:child_process";
 import { createHash } from "node:crypto";
 import { mkdir, mkdtemp, rm, stat } from "node:fs/promises";
-import AdmZip from "adm-zip";
-import { Readable, Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
+import { Readable, Transform } from "node:stream";
+import AdmZip from "adm-zip";
 //#region src/browser/providers/cloakbrowser.ts
 /**
 * CloakBrowser provider — anti-fingerprint Chromium with stealth capabilities.

package/dist/src/channels/attachments/voice-stt-webchat.d.ts

@@ -3,9 +3,6 @@
  */
 import type { STTConfig } from '../../voice/stt/types.js';
 import { type InboundAttachmentInput, type MediaRef } from './inbound-persist.js';
-export declare function mergeSttConfigFromAppConfig(stt: Partial<STTConfig> | undefined, toolsMedia?: {
-    models?: STTConfig['sharedModels'];
-}): STTConfig;
 export declare function isVoiceLikeAttachment(att: InboundAttachmentInput | MediaRef): boolean;
 export declare function mergeVoiceTranscriptsIntoUserText(prepared: (InboundAttachmentInput | MediaRef)[] | undefined, userText: string, sttConfig: STTConfig, opts?: {
     skipVoiceTranscription?: boolean;

package/dist/src/channels/attachments/voice-stt-webchat.js

@@ -1,32 +1,9 @@
 import { decodeInboundAttachmentBase64, readInboundAttachmentBuffer } from "./inbound-persist.js";
-import { DEFAULT_STT_CONFIG } from "../../voice/stt/types.js";
 import { transcribe } from "../../voice/stt/transcribe-core.js";
 import { isSTTAvailable } from "../../voice/stt/availability.js";
 import "../../voice/stt/index.js";
 //#region src/channels/attachments/voice-stt-webchat.ts
 const STT_MAX_BYTES = 25 * 1024 * 1024;
-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 p = stt ?? {};
-	return {
-		...DEFAULT_STT_CONFIG,
-		...p,
-		providers: mergeSttProviders(DEFAULT_STT_CONFIG.providers, p.providers),
-		fallback: {
-			...DEFAULT_STT_CONFIG.fallback,
-			...p.fallback
-		},
-		...toolsMedia?.models?.length ? { sharedModels: toolsMedia.models } : {}
-	};
-}
 function isVoiceLikeAttachment(att) {
 	if (att.type === "voice") return true;
 	return (att.mimeType?.toLowerCase() ?? "").startsWith("audio/");
@@ -88,4 +65,4 @@ async function mergeVoiceTranscriptsIntoUserText(prepared, userText, sttConfig,
 	};
 }
 //#endregion
-export { isVoiceLikeAttachment, mergeSttConfigFromAppConfig, mergeVoiceTranscriptsIntoUserText };
+export { isVoiceLikeAttachment, mergeVoiceTranscriptsIntoUserText };

package/dist/src/chat-commands/builtins/goal.js

@@ -3,6 +3,8 @@ import "../../storage/sqlite/index.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
 import { GoalService } from "../../goals/goal-service.js";
 import "../../goals/index.js";
+import { OutcomeExecutionService } from "../../work/outcome-execution-service.js";
+import "../../work/index.js";
 import { commandRegistry } from "../registry.js";
 //#region src/chat-commands/builtins/goal.ts
 init_resolve_route();
@@ -98,14 +100,13 @@ const goalCommand = {
 			content: "Agent is running — use /goal status / pause / clear mid-run, or wait for the current turn to finish before setting a new goal.",
 			success: false
 		};
-		const goal = goals.create({
-			title: t,
+		const goal = new OutcomeExecutionService().create({
+			objective: t,
 			sessionKey: ctx.sessionKey,
 			agentId: getDefaultAgentId(ctx.config),
-			config: ctx.config,
 			source: ctx.source === "cli" ? "cli" : ctx.source === "api" ? "api" : "channel",
 			projectId: getSessionMetadata(ctx.sessionKey)?.projectId
-		});
+		}).goal;
 		ctx.persistentGoalApis?.scheduleContinuation(ctx.sessionKey, goal.title);
 		return {
 			content: `⊙ Goal set (${goal.maxTurns}-turn budget): ${goal.title}\nI'll keep working until the goal is done, you pause/archive it, or the budget is exhausted.

package/dist/src/cli/commands/agents.js

@@ -1,8 +1,8 @@
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, validateAgentIdForNewAgent } from "../../agent/agent-scope.js";
 import { init_paths, resolveConfigPath } from "../../config/paths.js";
 import { init_loader, loadConfig, saveConfig } from "../../config/loader.js";
-import { applyAgentConfig, findAgentEntryIndex, getAgentDeleteBlocker, pruneAgentConfig, removeAgentDirsFromDisk } from "../../commands/agents.config.js";
 import { seedAgentProfileMarkdownFiles } from "../../agent/context/workspace-seed.js";
+import { applyAgentConfig, findAgentEntryIndex, getAgentDeleteBlocker, pruneAgentConfig, removeAgentDirsFromDisk } from "../../commands/agents.config.js";
 import { colors } from "../utils/colors.js";
 import { mkdir } from "node:fs/promises";
 //#region src/cli/commands/agents.ts

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v74).`,
+		message: `SQLite schema v${status.dbVersion} (current release v87).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/goal.js

@@ -3,9 +3,11 @@ import "../../storage/sqlite/index.js";
 import { init_loader, loadConfig } from "../../config/loader.js";
 import { GoalService } from "../../goals/goal-service.js";
 import "../../goals/index.js";
+import { OutcomeExecutionService } from "../../work/outcome-execution-service.js";
 import { ProjectService } from "../../projects/project-service.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
+import "../../work/index.js";
 import { formatExamples, register } from "../registry.js";
 import { Command } from "commander";
 //#region src/cli/commands/goal.ts
@@ -81,7 +83,7 @@ function createGoalCommand(ctx) {
 	}));
 	cmd.addCommand(new Command("new").description("Create a goal").argument("<title>", "Goal title").option("--session-key <key>", "Link to a session key").option("--agent-id <id>", "Agent id").option("--max-turns <n>", "Turn budget").option("--priority <level>", "low, normal, or high", "normal").option("--project <id-or-slug>", "Attach the goal to a project").action(async (title, options) => {
 		const cfg = loadConfig(ctx.configPath);
-		await withGoals(ctx, async (goals) => {
+		await withGoals(ctx, async (_goals) => {
 			const projectId = resolveProjectId(options.project);
 			const agentId = options.sessionKey && !options.agentId ? void 0 : resolveProjectAgentId({
 				config: cfg,
@@ -89,16 +91,15 @@ function createGoalCommand(ctx) {
 				explicitAgentId: options.agentId,
 				projectId
 			});
-			const goal = goals.create({
-				title,
+			const goal = new OutcomeExecutionService().create({
+				objective: title,
 				sessionKey: options.sessionKey,
 				agentId,
 				priority: options.priority === "low" || options.priority === "high" ? options.priority : "normal",
 				maxTurns: options.maxTurns ? Number(options.maxTurns) : void 0,
-				config: cfg,
 				source: "cli",
 				projectId
-			});
+			}).goal;
 			console.log(`Created goal ${goal.id}`);
 			console.log(`  ${goal.title}`);
 		});

package/dist/src/cli/commands/tunnel.js

@@ -3,15 +3,15 @@ import { init_logger } from "../../utils/logger.js";
 import { loadConfig, saveConfig } from "../../config/loader.js";
 import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
 import { loadTunnelState } from "../../tunnel/tunnel-state.js";
-import { formatExamples, register } from "../registry.js";
-import "../../config/index.js";
 import { TUNNEL_RISK_SUMMARY_LINES, TunnelConsentError, assertTunnelMayStart, hasValidTunnelConsent } from "../../tunnel/consent.js";
 import { resolveTunnelBrokerUrl, resolveTunnelRegistrationSecret } from "../../tunnel/env.js";
+import { applyTunnelConsentToConfig, mergeTunnelConfigPatch, setTunnelEnabledInConfig } from "../../tunnel/tunnel-config.js";
 import { ensureFrpcBinary } from "../../tunnel/frpc-binary.js";
 import { getTunnelService } from "../../tunnel/tunnel-service.js";
 import { resolveFrpSubdomainHost } from "../../tunnel/frp-subdomain-host.js";
-import { applyTunnelConsentToConfig, mergeTunnelConfigPatch, setTunnelEnabledInConfig } from "../../tunnel/tunnel-config.js";
 import "../../tunnel/index.js";
+import { formatExamples, register } from "../registry.js";
+import "../../config/index.js";
 import { Command } from "commander";
 //#region src/cli/commands/tunnel.ts
 init_logger();

package/dist/src/config/agent-profile.js

@@ -1,6 +1,6 @@
+import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import "../agent-manifest/index.js";
-import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/config/agent-profile.ts

package/dist/src/connectors/composio-sessions.js

@@ -76,7 +76,7 @@ var ComposioSessionsAdapter = class {
 			try {
 				[{Composio}, {PiProvider}] = await Promise.all([import("@composio/core"), import("@composio/experimental")]);
 			} catch (cause) {
-				throw new Error("Composio support requires @composio/core and @composio/experimental. Install them alongside @xopcai/xopc; use npm install -g when xopc is installed globally.", { cause });
+				throw new Error("The xopc installation is missing the bundled Composio runtime. Reinstall @xopcai/xopc and restart the gateway.", { cause });
 			}
 			return new Composio({
 				apiKey,

package/dist/src/connectors/learning-coordinator.js

@@ -3,6 +3,7 @@ import { init_logger } from "../utils/logger.js";
 import { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob } from "../storage/sqlite/connector-learning-repository.js";
 import { pruneBoundedKnowledgeSourceItems } from "../storage/sqlite/knowledge-repository.js";
 import { getConnectorInstallation, listConnectorConnections, upsertConnectorConnection } from "../storage/sqlite/connector-repository.js";
+import { getConnectorSyncPolicy } from "../storage/sqlite/connector-sync-policy-repository.js";
 import "../storage/sqlite/index.js";
 import { ComposioSessionsAdapter } from "./composio-sessions.js";
 import { getConnectorDefinition } from "./catalog.js";
@@ -34,6 +35,8 @@ function startConnectorLearningCoordinator(options) {
 		if (!learningEnabled(options.getConfig())) return null;
 		const connection = listConnectorConnections().find((item) => item.id === connectionId && item.status === "active");
 		if (!connection) return null;
+		const syncPolicy = getConnectorSyncPolicy(connection.id);
+		if (request.reason !== "manual" && syncPolicy?.scanEnabled === false) return null;
 		const definition = getConnectorDefinition(connection.connectorId);
 		if (definition?.runtime.type !== "composio" || definition.runtime.role !== "toolkit") return null;
 		if (!getConnectorLearningPlan(definition.runtime.toolkit)) return null;
@@ -141,7 +144,10 @@ function startConnectorLearningCoordinator(options) {
 			finished: true
 		}));
 		pruneBoundedKnowledgeSourceItems(job.sourceInstanceId, Date.now() - plan.bootstrapWindowDays * 24 * 60 * 6e4);
-		const nextRunAt = Date.now() + plan.intervalMinutes * 6e4;
+		const syncPolicy = getConnectorSyncPolicy(job.connectionId);
+		if (syncPolicy?.scanEnabled === false) return;
+		const intervalMinutes = syncPolicy?.intervalMinutes ?? plan.intervalMinutes;
+		const nextRunAt = Date.now() + intervalMinutes * 6e4;
 		enqueueConnection(job.connectionId, {
 			mode: "incremental",
 			reason: "schedule",

package/dist/src/connectors/source-change-publisher.d.ts

@@ -0,0 +1,17 @@
+import { ProactiveEventService } from '../proactive/service.js';
+export type SourceChangePublishResult = {
+    published: number;
+    skipped: number;
+    sources: number;
+};
+export declare class ConnectedSourceChangePublisher {
+    private readonly eventService;
+    private readonly intervalMs;
+    private timer;
+    private running;
+    constructor(eventService: ProactiveEventService, intervalMs?: number);
+    start(): void;
+    stop(): void;
+    runNow(): Promise<SourceChangePublishResult>;
+    private publishSource;
+}

package/dist/src/connectors/source-change-publisher.js

@@ -0,0 +1,148 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { getKnowledgeConsumerWatermark, getKnowledgeSourceItem, listKnowledgeSourceChanges, setKnowledgeConsumerWatermark } from "../storage/sqlite/knowledge-repository.js";
+import { listConnectorConnections } from "../storage/sqlite/connector-repository.js";
+import { getConnectorSyncPolicy } from "../storage/sqlite/connector-sync-policy-repository.js";
+//#region src/connectors/source-change-publisher.ts
+init_logger();
+const log = createLogger("Connector:SourceChanges");
+const CONSUMER_ID = "proactive-connected-source-v1";
+function sensitivity(value) {
+	if (value === "regulated") return "restricted";
+	if (value === "secret") return "confidential";
+	return "personal";
+}
+function metadataString(metadata, key) {
+	const value = metadata[key];
+	return typeof value === "string" && value.trim() ? value : void 0;
+}
+var ConnectedSourceChangePublisher = class {
+	timer = null;
+	running = false;
+	constructor(eventService, intervalMs = 1e4) {
+		this.eventService = eventService;
+		this.intervalMs = intervalMs;
+	}
+	start() {
+		if (this.timer) return;
+		this.runNow();
+		this.timer = setInterval(() => void this.runNow(), Math.max(2e3, this.intervalMs));
+		this.timer.unref?.();
+	}
+	stop() {
+		if (this.timer) clearInterval(this.timer);
+		this.timer = null;
+	}
+	async runNow() {
+		if (this.running) return {
+			published: 0,
+			skipped: 0,
+			sources: 0
+		};
+		this.running = true;
+		const total = {
+			published: 0,
+			skipped: 0,
+			sources: 0
+		};
+		try {
+			const connections = listConnectorConnections({ principalId: "local-owner" }).filter((connection) => connection.status === "active");
+			for (const connection of connections) {
+				const sourceInstanceId = `composio:${connection.connectorId}:${connection.id}`;
+				try {
+					const result = this.publishSource(sourceInstanceId, connection.id);
+					total.published += result.published;
+					total.skipped += result.skipped;
+					total.sources += 1;
+				} catch (err) {
+					const em = err instanceof Error ? err.message : String(err);
+					log.warn({
+						err,
+						connectionId: connection.id,
+						sourceInstanceId
+					}, `Connected source change publication failed: ${em}`);
+				}
+			}
+			return total;
+		} finally {
+			this.running = false;
+		}
+	}
+	publishSource(sourceInstanceId, connectionId) {
+		const policy = getConnectorSyncPolicy(connectionId);
+		let watermark = getKnowledgeConsumerWatermark(CONSUMER_ID, sourceInstanceId);
+		const changes = listKnowledgeSourceChanges({
+			sourceInstanceId,
+			afterSequence: watermark,
+			limit: 250
+		});
+		let published = 0;
+		let skipped = 0;
+		for (const change of changes) {
+			const item = getKnowledgeSourceItem(change.sourceItemId);
+			if (!policy?.scanEnabled || !policy.proactiveEnabled || !item || item.sensitivity === "secret" || item.sensitivity === "regulated") {
+				skipped += 1;
+				watermark = change.sequence;
+				setKnowledgeConsumerWatermark(CONSUMER_ID, sourceInstanceId, watermark);
+				continue;
+			}
+			const workspaceId = metadataString(item.metadata, "workspaceId");
+			const connectorId = metadataString(item.metadata, "connectorId");
+			if (!workspaceId || !connectorId) {
+				skipped += 1;
+				watermark = change.sequence;
+				setKnowledgeConsumerWatermark(CONSUMER_ID, sourceInstanceId, watermark);
+				continue;
+			}
+			const eventType = change.kind === "added" ? "connected_source.item_created.v1" : change.kind === "deleted" ? "connected_source.item_deleted.v1" : "connected_source.item_updated.v1";
+			const agentId = metadataString(item.metadata, "agentId");
+			this.eventService.publish({
+				type: eventType,
+				schemaVersion: 1,
+				source: {
+					kind: "connector",
+					id: connectionId
+				},
+				subject: {
+					kind: "knowledge_source_item",
+					id: item.id
+				},
+				actor: {
+					kind: "integration",
+					id: connectorId
+				},
+				scope: {
+					workspaceId,
+					...agentId ? { agentId } : {}
+				},
+				occurredAt: item.sourceUpdatedAt ?? item.occurredAt ?? change.changedAt,
+				dedupeKey: `knowledge-change:${change.sequence}`,
+				sensitivity: sensitivity(item.sensitivity),
+				payload: {
+					sourceInstanceId,
+					sourceItemId: item.id,
+					collectionScope: item.collectionScope,
+					itemType: item.itemType,
+					changeKind: change.kind,
+					contentHash: item.contentHash
+				}
+			});
+			published += 1;
+			watermark = change.sequence;
+			setKnowledgeConsumerWatermark(CONSUMER_ID, sourceInstanceId, watermark);
+		}
+		if (published > 0) log.info({
+			connectionId,
+			sourceInstanceId,
+			published,
+			skipped
+		}, "Connected source changes published");
+		return {
+			published,
+			skipped,
+			sources: 1
+		};
+	}
+};
+//#endregion
+export { ConnectedSourceChangePublisher };

package/dist/src/discussions/analyzer.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import type { Config } from '../config/schema.js';
+import type { DiscussionAnalysis } from './types.js';
+declare const LiveEnrichmentSchema: z.ZodObject<{
+    title: z.ZodString;
+    projectCandidateId: z.ZodOptional<z.ZodString>;
+    projectConfidence: z.ZodOptional<z.ZodNumber>;
+    projectAlternativeConfidence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function normalizeDiscussionAnalysis(value: unknown): DiscussionAnalysis;
+export declare function analyzeDiscussion(input: {
+    config: Config;
+    transcript: string;
+    languageHint?: string;
+    projects?: Array<{
+        id: string;
+        name: string;
+    }>;
+    signal?: AbortSignal;
+}): Promise<{
+    analysis: DiscussionAnalysis;
+    modelRef: string;
+}>;
+export declare function enrichLiveDiscussion(input: {
+    config: Config;
+    transcript: string;
+    projects: Array<{
+        id: string;
+        name: string;
+    }>;
+    signal?: AbortSignal;
+}): Promise<z.infer<typeof LiveEnrichmentSchema> & {
+    modelRef: string;
+}>;
+export {};