@xopcai/xopc 0.0.217 → 0.0.219

package/dist/src/gateway/hono/routes/understanding-sources.js

@@ -1,8 +1,8 @@
-import { deleteUnderstanding, listUnderstandingEvidence, listUnderstandings } from "../../../storage/sqlite/user-context-repository.js";
+import { deleteUnderstanding, listUnderstandingEvidence, listUnderstandings, setUnderstandingStatus } from "../../../storage/sqlite/user-context-repository.js";
 import { getConnectorAccount } from "../../../storage/sqlite/connector-account-repository.js";
 import "../../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
-import { deleteUserFocus, getUnderstandingSourceGrant, listUnderstandingSourceGrants, listUserFocuses, revokeUnderstandingSourceGrant, setUserFocusStatus } from "../../../user-context/sources/repository.js";
+import { deleteUserFocus, getUnderstandingSourceGrant, getUnderstandingSourceRun, listUnderstandingSourceGrants, listUnderstandingSourceRuns, listUserFocusEvidence, listUserFocuses, revokeUnderstandingSourceGrant, updateUnderstandingSourceGrantPolicies, updateUserFocus } from "../../../user-context/sources/repository.js";
 import { listConnectedContentCandidates, readConnectedContent } from "../../../connectors/content-enrichment.js";
 import { getWorkDiscoveryService } from "./work-discovery.js";
 import { listUnderstandingSourceDefinitions } from "../../../user-context/sources/catalog.js";
@@ -27,6 +27,33 @@ function decisionsFrom(body) {
 		}];
 	}).slice(0, 20);
 }
+function sourceRevocationImpact(grantId) {
+	const grant = getUnderstandingSourceGrant(grantId);
+	if (!grant) return null;
+	const accountId = typeof grant.config.accountId === "string" ? grant.config.accountId : void 0;
+	const connectorId = typeof grant.config.connectorId === "string" ? grant.config.connectorId : void 0;
+	const sourceInstanceId = accountId && connectorId ? `composio:${connectorId}:${accountId}` : void 0;
+	const belongs = (evidence) => evidence.sourceRef.startsWith(`understanding-source-grant:${grantId}:`) || Boolean(sourceInstanceId && evidence.sourceInstanceId === sourceInstanceId);
+	const understandings = listUnderstandings().flatMap((item) => {
+		if (item.explicitness === "explicit") return [];
+		const evidence = listUnderstandingEvidence(item.id);
+		return evidence.some(belongs) && !evidence.some((entry) => !belongs(entry)) ? [item] : [];
+	});
+	const focuses = listUserFocuses().flatMap((focus) => {
+		if (focus.explicitness === "explicit") return [];
+		if ((focus.sourceRunId ? getUnderstandingSourceRun(focus.sourceRunId) : null)?.grantId !== grantId) return [];
+		return listUserFocusEvidence(focus.id).some((entry) => !belongs(entry)) ? [] : [focus];
+	});
+	return {
+		grant,
+		understandingIds: understandings.map((item) => item.id),
+		focusIds: focuses.map((item) => item.id),
+		derivedCount: understandings.length + focuses.length,
+		understandingCount: understandings.length,
+		focusCount: focuses.length,
+		boundedRawCount: 0
+	};
+}
 function registerUnderstandingSourceRoutes(authenticated, deps) {
 	const service = getWorkDiscoveryService(deps);
 	const limited = deps.strictRateLimitMiddleware;
@@ -38,10 +65,65 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 			sources: listUnderstandingSourceDefinitions(platform)
 		});
 	});
-	authenticated.get("/api/understanding/sources/grants", (c) => c.json({
-		ok: true,
-		grants: listUnderstandingSourceGrants({ includeRevoked: c.req.query("includeRevoked") === "true" })
-	}));
+	authenticated.get("/api/understanding/sources/grants", (c) => {
+		const grants = listUnderstandingSourceGrants({ includeRevoked: c.req.query("includeRevoked") === "true" });
+		return c.json({
+			ok: true,
+			grants,
+			latestRuns: Object.fromEntries(grants.flatMap((grant) => {
+				const run = listUnderstandingSourceRuns(grant.id, 1)[0];
+				return run ? [[grant.id, run]] : [];
+			}))
+		});
+	});
+	authenticated.patch("/api/understanding/sources/grants/:grantId", limited, async (c) => {
+		const body = await c.req.json().catch(() => null);
+		if (!body) return c.json({
+			ok: false,
+			error: "Invalid JSON"
+		}, 400);
+		const accessMode = body.accessMode;
+		const retentionPolicy = body.retentionPolicy;
+		const processingPolicy = body.processingPolicy;
+		if (accessMode !== void 0 && accessMode !== "once" && accessMode !== "continuous") return c.json({
+			ok: false,
+			error: "Invalid access mode"
+		}, 400);
+		if (retentionPolicy !== void 0 && retentionPolicy !== "metadata_only" && retentionPolicy !== "derived_only" && retentionPolicy !== "bounded_raw") return c.json({
+			ok: false,
+			error: "Invalid retention policy"
+		}, 400);
+		if (processingPolicy !== void 0 && processingPolicy !== "local_only" && processingPolicy !== "remote_allowed") return c.json({
+			ok: false,
+			error: "Invalid processing policy"
+		}, 400);
+		if (accessMode === void 0 && retentionPolicy === void 0 && processingPolicy === void 0) return c.json({
+			ok: false,
+			error: "At least one policy change is required"
+		}, 400);
+		const grant = updateUnderstandingSourceGrantPolicies(c.req.param("grantId"), {
+			...accessMode ? { accessMode } : {},
+			...retentionPolicy ? { retentionPolicy } : {},
+			...processingPolicy ? { processingPolicy } : {}
+		});
+		return grant ? c.json({
+			ok: true,
+			grant
+		}) : c.json({
+			ok: false,
+			error: "Source grant not found"
+		}, 404);
+	});
+	authenticated.get("/api/understanding/sources/grants/:grantId/impact", (c) => {
+		const impact = sourceRevocationImpact(c.req.param("grantId"));
+		return impact ? c.json({
+			ok: true,
+			impact
+		}) : c.json({
+			ok: false,
+			error: "Source grant not found"
+		}, 404);
+	});
 	authenticated.get("/api/understanding/sources/content-candidates", (c) => {
 		const agentId = resolveDefaultAgentId(deps.service.currentConfig);
 		return c.json({
@@ -69,21 +151,34 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 		}
 	});
 	authenticated.delete("/api/understanding/sources/grants/:grantId", limited, (c) => {
-		const current = getUnderstandingSourceGrant(c.req.param("grantId"));
+		const grantId = c.req.param("grantId");
+		const impact = sourceRevocationImpact(grantId);
+		const derived = c.req.query("derived");
+		const raw = c.req.query("raw");
+		if (derived !== "delete" && derived !== "retain") return c.json({
+			ok: false,
+			error: "derived must be delete or retain"
+		}, 400);
+		if (raw !== "delete" && raw !== "retain") return c.json({
+			ok: false,
+			error: "raw must be delete or retain"
+		}, 400);
+		const current = impact?.grant;
 		const accountId = typeof current?.config.accountId === "string" ? current.config.accountId : void 0;
 		const connectionId = accountId ? getConnectorAccount(accountId)?.currentConnectionId : void 0;
 		if (connectionId) deps.service.setConnectorLearningPaused(connectionId, true);
-		const grant = revokeUnderstandingSourceGrant(c.req.param("grantId"));
-		if (grant && c.req.query("deleteDerived") === "true") {
-			const activeGrantIds = new Set(listUnderstandingSourceGrants().map((item) => item.id));
-			for (const understanding of listUnderstandings()) {
-				const grantEvidence = listUnderstandingEvidence(understanding.id).map((evidence) => /^understanding-source-grant:([^:]+):/.exec(evidence.sourceRef)?.[1]).filter((id) => Boolean(id));
-				if (grantEvidence.includes(grant.id) && !grantEvidence.some((id) => id !== grant.id && activeGrantIds.has(id))) deleteUnderstanding(understanding.id);
-			}
+		const grant = revokeUnderstandingSourceGrant(grantId);
+		if (grant && impact) {
+			for (const id of impact.focusIds) if (derived === "delete") deleteUserFocus(id);
+			else updateUserFocus(id, { status: "paused" });
+			for (const id of impact.understandingIds) if (derived === "delete") deleteUnderstanding(id);
+			else setUnderstandingStatus(id, "needs_review");
 		}
 		return grant ? c.json({
 			ok: true,
-			grant
+			grant,
+			impact,
+			rawDeleted: 0
 		}) : c.json({
 			ok: false,
 			error: "Source grant not found"
@@ -208,18 +303,41 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 		focuses: listUserFocuses()
 	}));
 	authenticated.patch("/api/understanding/focuses/:focusId", limited, async (c) => {
-		const requested = stringField(await c.req.json().catch(() => null), "status");
-		if (!new Set([
+		const body = await c.req.json().catch(() => null);
+		const requestedStatus = stringField(body, "status");
+		const title = stringField(body, "title");
+		const summary = stringField(body, "summary");
+		if (requestedStatus && !new Set([
 			"candidate",
 			"active",
 			"paused",
 			"completed",
 			"rejected"
-		]).has(requested)) return c.json({
+		]).has(requestedStatus)) return c.json({
 			ok: false,
 			error: "Invalid focus status"
 		}, 400);
-		const focus = setUserFocusStatus(c.req.param("focusId"), requested);
+		if (body?.title !== void 0 && !title) return c.json({
+			ok: false,
+			error: "Focus title cannot be empty"
+		}, 400);
+		if (body?.summary !== void 0 && !summary) return c.json({
+			ok: false,
+			error: "Focus summary cannot be empty"
+		}, 400);
+		if (title.length > 300 || summary.length > 2e3) return c.json({
+			ok: false,
+			error: "Focus title or summary is too long"
+		}, 400);
+		if (!requestedStatus && !title && !summary) return c.json({
+			ok: false,
+			error: "At least one focus change is required"
+		}, 400);
+		const focus = updateUserFocus(c.req.param("focusId"), {
+			...requestedStatus ? { status: requestedStatus } : {},
+			...title ? { title } : {},
+			...summary ? { summary } : {}
+		});
 		return focus ? c.json({
 			ok: true,
 			focus
@@ -228,10 +346,6 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 			error: "Focus not found"
 		}, 404);
 	});
-	authenticated.delete("/api/understanding/focuses/:focusId", limited, (c) => deleteUserFocus(c.req.param("focusId")) ? c.json({ ok: true }) : c.json({
-		ok: false,
-		error: "Focus not found"
-	}, 404));
 }
 //#endregion
-export { registerUnderstandingSourceRoutes };
+export { registerUnderstandingSourceRoutes, sourceRevocationImpact };

package/dist/src/gateway/hono/routes/you.js

@@ -1,9 +1,12 @@
-import { listContextConsolidationRuns } from "../../../storage/sqlite/context-consolidation-repository.js";
 import { UNDERSTANDING_KINDS } from "../../../user-context/domain.js";
-import { summarizeUserUnderstandingQuality } from "../../../storage/sqlite/user-context-quality-repository.js";
+import { listContextExtractionRuns } from "../../../storage/sqlite/context-extraction-repository.js";
+import { listContextConsolidationRuns } from "../../../storage/sqlite/context-consolidation-repository.js";
 import { createCollaborationRule, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, recordContextFeedback, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "../../../storage/sqlite/user-context-repository.js";
 import "../../../storage/sqlite/index.js";
+import { listUserFocuses, updateUserFocus } from "../../../user-context/sources/repository.js";
 import { canonicalUnderstandingKey, findDuplicateUnderstanding } from "../../../user-context/understanding.js";
+import { listContextObjects } from "../../../user-context/context-objects.js";
+import { repairExtractedContext } from "../../../user-context/extraction/repair.js";
 import { userInfo } from "node:os";
 //#region src/gateway/hono/routes/you.ts
 const UNDERSTANDING_KIND_SET = new Set(UNDERSTANDING_KINDS);
@@ -34,6 +37,11 @@ const FEEDBACK_RATINGS = new Set([
 	"stale",
 	"sensitive"
 ]);
+const CONTEXT_OBJECT_VIEWS = new Set([
+	"current",
+	"review",
+	"history"
+]);
 function asRecord(value) {
 	return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
@@ -87,10 +95,64 @@ function registerYouRoutes(authenticated, deps) {
 	authenticated.get("/api/you", (c) => c.json({
 		profile: getUserProfile(),
 		understandings: listUnderstandings(),
+		focuses: listUserFocuses(),
 		rules: listCollaborationRules(),
-		consolidation: { lastRun: listContextConsolidationRuns(1)[0] ?? null },
-		quality: summarizeUserUnderstandingQuality()
+		consolidation: { lastRun: listContextConsolidationRuns(1)[0] ?? null }
 	}));
+	authenticated.get("/api/you/context-objects", (c) => {
+		const view = c.req.query("view") ?? "current";
+		if (!CONTEXT_OBJECT_VIEWS.has(view)) return c.json({ error: "Invalid context object view" }, 400);
+		return c.json({ objects: listContextObjects(view) });
+	});
+	authenticated.get("/api/you/extraction-runs", (c) => c.json({ runs: listContextExtractionRuns({
+		...c.req.query("sourceRef") ? { sourceRef: c.req.query("sourceRef") } : {},
+		...c.req.query("extractorId") ? { extractorId: c.req.query("extractorId") } : {},
+		...c.req.query("extractorVersion") ? { extractorVersion: c.req.query("extractorVersion") } : {},
+		limit: 100
+	}) }));
+	authenticated.post("/api/you/context-repair", write, async (c) => {
+		const body = await readBody(c);
+		if (!body) return c.json({ error: "Invalid JSON" }, 400);
+		const filter = Object.fromEntries([
+			"runId",
+			"sourceRef",
+			"extractorId",
+			"extractorVersion",
+			"objectVersionId"
+		].flatMap((field) => typeof body[field] === "string" && body[field].trim() ? [[field, body[field].trim()]] : []));
+		if (!Object.keys(filter).length) return c.json({ error: "At least one repair filter is required" }, 400);
+		return c.json({ result: repairExtractedContext(filter) });
+	});
+	authenticated.post("/api/you/context-objects/batch-review", write, async (c) => {
+		const decisions = (await readBody(c))?.decisions;
+		if (!Array.isArray(decisions) || decisions.length < 1 || decisions.length > 50) return c.json({ error: "decisions must contain 1-50 items" }, 400);
+		const normalized = [];
+		const targets = /* @__PURE__ */ new Set();
+		for (const value of decisions) {
+			const item = asRecord(value);
+			const objectType = item?.objectType;
+			const objectId = nonEmptyString(item?.objectId, 200);
+			const action = item?.action;
+			if (objectType !== "focus" && objectType !== "understanding" || !objectId || action !== "accept" && action !== "reject" && action !== "pause") return c.json({ error: "Each decision must contain a valid objectType, objectId, and action" }, 400);
+			if (!(objectType === "understanding" ? Boolean(getUnderstanding(objectId)) : listUserFocuses().some((focus) => focus.id === objectId))) return c.json({ error: `Context object not found: ${objectId}` }, 404);
+			const target = `${objectType}:${objectId}`;
+			if (targets.has(target)) return c.json({ error: `Duplicate context object decision: ${objectId}` }, 400);
+			targets.add(target);
+			normalized.push({
+				objectType,
+				objectId,
+				action
+			});
+		}
+		const objects = normalized.map(({ objectType, objectId, action }) => {
+			if (objectType === "understanding") return action === "accept" ? setUnderstandingStatus(objectId, "active", {
+				explicitness: "explicit",
+				confidence: 1
+			}) : action === "reject" ? rejectUnderstanding(objectId, "Rejected during context review") : setUnderstandingStatus(objectId, "needs_review");
+			return updateUserFocus(objectId, { status: action === "accept" ? "active" : action === "reject" ? "rejected" : "paused" });
+		});
+		return c.json({ objects });
+	});
 	authenticated.get("/api/you/profile", (c) => {
 		const profile = getUserProfile();
 		return c.json({
@@ -244,6 +306,7 @@ function registerYouRoutes(authenticated, deps) {
 		if (objectType === void 0 !== (objectId === void 0) || objectType !== void 0 && ![
 			"profile",
 			"rule",
+			"focus",
 			"understanding"
 		].includes(String(objectType)) || objectId !== void 0 && typeof objectId !== "string") return c.json({ error: "objectType and objectId must be valid and provided together" }, 400);
 		if (objectType !== void 0 && !run.items.some((item) => item.objectType === objectType && item.objectId === objectId)) return c.json({ error: "The context object was not part of this turn" }, 400);
@@ -263,6 +326,10 @@ function registerYouRoutes(authenticated, deps) {
 			if (rating === "stale") setUnderstandingStatus(objectId, "stale");
 			if (rating === "sensitive") setUnderstandingStatus(objectId, "needs_review");
 		}
+		if (objectType === "focus" && typeof objectId === "string") {
+			if (rating === "wrong") updateUserFocus(objectId, { status: "rejected" });
+			if (rating === "stale" || rating === "sensitive") updateUserFocus(objectId, { status: "paused" });
+		}
 		return c.json({ ok: true });
 	});
 	authenticated.patch("/api/you/consents/:id", write, async (c) => {

package/dist/src/gateway/rate-limit/buckets.d.ts

@@ -50,7 +50,7 @@ declare class BucketRegistry {
      * config read.
      */
     authFailure(cfg: ResolvedAuthRateLimitConfig): FailureLimiter;
-    /** Sensitive admin / mutation endpoints — 15 req / 60 s per client IP. */
+    /** Authenticated admin / mutation endpoints — 150 req / 60 s per client IP. */
     strictApi(): RateLimiter;
     /** Interactive chat actions — 180 req / 60 s per client IP. */
     chatApi(): RateLimiter;

package/dist/src/gateway/rate-limit/buckets.js

@@ -75,10 +75,10 @@ var BucketRegistry = class {
 		}
 		return this.authFailureLimiter;
 	}
-	/** Sensitive admin / mutation endpoints — 15 req / 60 s per client IP. */
+	/** Authenticated admin / mutation endpoints — 150 req / 60 s per client IP. */
 	strictApi() {
 		if (!this.strictApiLimiter) this.strictApiLimiter = new RateLimiter({
-			maxRequests: 15,
+			maxRequests: 150,
 			windowMs: 6e4
 		});
 		return this.strictApiLimiter;

package/dist/src/gateway/service/agent-runner.d.ts

@@ -27,6 +27,7 @@ import type { SessionIndex } from '../../session/index.js';
 import type { ClarifyStreamEvent } from '../clarify-bridge.js';
 import { ClarifyBridge, type ClarifyBridgeRequest } from '../clarify-bridge.js';
 import type { UserTurnAttachment, UserTurnInput } from '../user-turn-input.js';
+import type { AgentSourceContext, TurnContextRef } from '../../agent/source-context/types.js';
 import { SessionInputCoordinator, type ReplaceLatestTurnInput, type SubmitSessionInput } from './session-input-coordinator.js';
 export interface GatewayAgentRunnerOptions {
     bus: MessageBus;
@@ -39,6 +40,7 @@ export interface GatewayAgentRunnerOptions {
     emit: (type: string, payload: unknown) => void;
     publishRealtime: (topic: string, event: string, data: unknown) => void;
     completeRealtimeTopic: (topic: string) => void;
+    resolveTurnContext: (ref: TurnContextRef) => Promise<AgentSourceContext | null>;
 }
 export declare class GatewayAgentRunner {
     private readonly opts;
@@ -64,6 +66,7 @@ export declare class GatewayAgentRunner {
     runAgent(message: string, channel: string, chatId: string, origin: TurnOrigin, attachments?: UserTurnAttachment[], thinking?: string, runOptions?: {
         signal?: AbortSignal;
         runId?: string;
+        sourceContexts?: AgentSourceContext[];
     }): AsyncGenerator<{
         type: string;
         [key: string]: unknown;
@@ -77,7 +80,7 @@ export declare class GatewayAgentRunner {
         state: import("../../storage/sqlite/session-input-repository.js").SessionInputState;
     } | {
         ok: false;
-        code: "BAD_REQUEST" | "QUEUE_FULL";
+        code: "BAD_REQUEST" | "QUEUE_FULL" | "CONTEXT_UNAVAILABLE";
     }>;
     replaceLatestSessionTurn(input: ReplaceLatestTurnInput): Promise<{
         ok: true;
@@ -85,18 +88,20 @@ export declare class GatewayAgentRunner {
         state: import("../../storage/sqlite/session-input-repository.js").SessionInputState;
     } | {
         ok: false;
-        code: "BAD_REQUEST" | "TARGET_NOT_FOUND" | "NOT_LATEST" | "SESSION_BUSY";
+        code: "BAD_REQUEST" | "TARGET_NOT_FOUND" | "NOT_LATEST" | "SESSION_BUSY" | "CONTEXT_UNAVAILABLE";
     }>;
     getSessionInputState(sessionKey: string): import("../../storage/sqlite/session-input-repository.js").SessionInputState;
     updateSessionInput(sessionKey: string, id: string, body: {
         version: number;
         content?: string;
         attachments?: UserTurnAttachment[];
+        contextRefs?: TurnContextRef[];
         thinking?: string;
         position?: number;
     }): Promise<{
         ok: boolean;
         state: import("../../storage/sqlite/session-input-repository.js").SessionInputState;
+        contextUnavailable?: boolean;
     }>;
     removeSessionInput(sessionKey: string, id: string, version: number): {
         ok: boolean;

package/dist/src/gateway/service/agent-runner.js

@@ -2,11 +2,13 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { ClarifyBridge } from "../clarify-bridge.js";
 import { runGatewayAgent } from "./run-gateway-agent.js";
+import { fitSourceContextsToBudget } from "../../agent/source-context/budget.js";
 import { SessionInputCoordinator } from "./session-input-coordinator.js";
 import crypto from "node:crypto";
 //#region src/gateway/service/agent-runner.ts
 init_logger();
 const log = createLogger("Gateway:AgentRunner");
+const MAX_TURN_CONTEXTS = 5;
 var GatewayAgentRunner = class {
 	opts;
 	/** Per-run abort for webchat (POST /api/agent/abort or client disconnect). */
@@ -23,7 +25,10 @@ var GatewayAgentRunner = class {
 		this.inputs = new SessionInputCoordinator({
 			sessionExists: async (sessionKey) => Boolean(await opts.sessionIndex.getSessionMetadata(sessionKey)),
 			execute: async (input) => {
-				const generator = this.runAgent(input.content, "webchat", input.sessionKey, input.origin, input.attachments, input.thinking, { runId: input.runId });
+				const generator = this.runAgent(input.content, "webchat", input.sessionKey, input.origin, input.attachments, input.thinking, {
+					runId: input.runId,
+					sourceContexts: input.sourceContexts
+				});
 				let result;
 				while (true) {
 					const step = await generator.next();
@@ -46,6 +51,21 @@ var GatewayAgentRunner = class {
 					size: ref.size
 				}));
 			},
+			prepareContexts: async (refs) => {
+				if (!refs?.length) return void 0;
+				const unique = /* @__PURE__ */ new Map();
+				for (const ref of refs) {
+					const sourceId = ref.sourceId.trim();
+					if (sourceId) unique.set(`${ref.kind}:${sourceId}`, {
+						...ref,
+						sourceId
+					});
+				}
+				if (unique.size > MAX_TURN_CONTEXTS) throw new Error(`A message can reference at most ${MAX_TURN_CONTEXTS} notes`);
+				const contexts = await Promise.all([...unique.values()].map((ref) => opts.resolveTurnContext(ref)));
+				if (contexts.some((context) => context === null)) throw new Error("A referenced note is no longer available");
+				return fitSourceContextsToBudget(contexts.filter((context) => context !== null));
+			},
 			steer: (sessionKey, content) => opts.getAgentService().turnDispatcher.steerWebchatSession(sessionKey, content),
 			emit: opts.emit
 		});

package/dist/src/gateway/service/config-coordinator.js

@@ -8,8 +8,8 @@ import { reloadImageGenerationProviders } from "../../agent/image/generation/pro
 import "../../agent/mcp/bundle-mcp-tools.js";
 import { ConfigHotReloader } from "../../config/reload.js";
 import "../../config/index.js";
-import { computeBundledExtensionExtensionsPatch } from "../../extensions/bundled-extension-activation.js";
 import { sanitizeTunnelConfig } from "../../tunnel/tunnel-config.js";
+import { computeBundledExtensionExtensionsPatch } from "../../extensions/bundled-extension-activation.js";
 //#region src/gateway/service/config-coordinator.ts
 init_providers();
 init_logger();

package/dist/src/gateway/service/run-gateway-agent.d.ts

@@ -5,6 +5,7 @@ import type { MessageBus } from '../../infra/bus/index.js';
 import type { SessionIndex } from '../../session/index.js';
 import type { ChatStreamEvent } from '../chat-stream/protocol.js';
 import type { UserTurnAttachment } from '../user-turn-input.js';
+import type { AgentSourceContext } from '../../agent/source-context/types.js';
 export type RunGatewayAgentYield = ChatStreamEvent;
 export type RunGatewayAgentDeps = {
     config: Config;
@@ -23,6 +24,7 @@ export type RunGatewayAgentDeps = {
 export declare function runGatewayAgent(deps: RunGatewayAgentDeps, message: string, channel: string, chatId: string, origin: TurnOrigin, attachments?: UserTurnAttachment[], thinking?: string, runOptions?: {
     signal?: AbortSignal;
     runId?: string;
+    sourceContexts?: AgentSourceContext[];
 }): AsyncGenerator<RunGatewayAgentYield, {
     status: string;
     summary: string;

package/dist/src/gateway/service/run-gateway-agent.js

@@ -131,7 +131,8 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 			try {
 				const eventStream = agentService.turnDispatcher.processDirectStreaming(stampedMessage, sessionKey, origin, prepared, thinking, {
 					signal: mergedSignal,
-					runId
+					runId,
+					sourceContexts: runOptions?.sourceContexts
 				});
 				const mappedEvents = (async function* () {
 					for await (const event of eventStream) yield* mapper.map(event);

package/dist/src/gateway/service/session-input-coordinator.d.ts

@@ -1,5 +1,6 @@
 import type { TurnOrigin } from '@xopcai/endpoint-tools-protocol';
 import type { UserTurnAttachment } from '../user-turn-input.js';
+import { type AgentSourceContext, type TurnContextRef } from '../../agent/source-context/types.js';
 import { type SessionInputDelivery, type SessionInputState } from '../../storage/sqlite/index.js';
 export type SubmitSessionInput = {
     sessionKey: string;
@@ -7,6 +8,7 @@ export type SubmitSessionInput = {
     delivery: SessionInputDelivery;
     content: string;
     attachments?: UserTurnAttachment[];
+    contextRefs?: TurnContextRef[];
     thinking?: string;
     origin: TurnOrigin;
 };
@@ -24,6 +26,7 @@ export declare class SessionInputCoordinator {
             sessionKey: string;
             content: string;
             attachments?: UserTurnAttachment[];
+            sourceContexts?: AgentSourceContext[];
             thinking?: string;
             origin: TurnOrigin;
         }) => Promise<{
@@ -31,6 +34,7 @@ export declare class SessionInputCoordinator {
             summary: string;
         }>;
         prepareAttachments: (sessionKey: string, attachments?: UserTurnAttachment[]) => Promise<UserTurnAttachment[] | undefined>;
+        prepareContexts: (contextRefs?: TurnContextRef[]) => Promise<AgentSourceContext[] | undefined>;
         steer: (sessionKey: string, content: string) => Promise<boolean>;
         emit: (type: string, payload: unknown) => void;
     });
@@ -43,7 +47,7 @@ export declare class SessionInputCoordinator {
         state: SessionInputState;
     } | {
         ok: false;
-        code: 'BAD_REQUEST' | 'QUEUE_FULL';
+        code: 'BAD_REQUEST' | 'QUEUE_FULL' | 'CONTEXT_UNAVAILABLE';
     }>;
     replaceLatestTurn(input: ReplaceLatestTurnInput, beforeReplace: () => Promise<void>): Promise<{
         ok: true;
@@ -51,7 +55,7 @@ export declare class SessionInputCoordinator {
         state: SessionInputState;
     } | {
         ok: false;
-        code: 'BAD_REQUEST' | 'TARGET_NOT_FOUND' | 'NOT_LATEST' | 'SESSION_BUSY';
+        code: 'BAD_REQUEST' | 'TARGET_NOT_FOUND' | 'NOT_LATEST' | 'SESSION_BUSY' | 'CONTEXT_UNAVAILABLE';
     }>;
     private submitLocked;
     drain(sessionKey: string): Promise<void>;
@@ -59,11 +63,13 @@ export declare class SessionInputCoordinator {
         version: number;
         content?: string;
         attachments?: UserTurnAttachment[];
+        contextRefs?: TurnContextRef[];
         thinking?: string;
         position?: number;
     }): Promise<{
         ok: boolean;
         state: SessionInputState;
+        contextUnavailable?: boolean;
     }>;
     remove(sessionKey: string, id: string, version: number): {
         ok: boolean;