@xopcai/xopc 0.0.161 → 0.0.163

package/dist/src/gateway/hono/routes/lazy-bundles.js

@@ -43,6 +43,14 @@ const AUTHENTICATED_LAZY_ROUTE_BUNDLES = [
 			return { register: registerBrowserInstallRoutes };
 		}
 	},
+	{
+		id: "browser-workflows",
+		match: (path) => startsWithAny(path, ["/api/browser/workflows", "/api/browser/workflow-runs"]),
+		load: async () => {
+			const { registerBrowserWorkflowRoutes } = await import("./browser-workflows.js");
+			return { register: registerBrowserWorkflowRoutes };
+		}
+	},
 	{
 		id: "browser",
 		match: (path) => startsWithAny(path, ["/api/browser"]),
@@ -84,6 +92,14 @@ const AUTHENTICATED_LAZY_ROUTE_BUNDLES = [
 			return { register: registerDreamingRoutes };
 		}
 	},
+	{
+		id: "image-generation",
+		match: (path) => startsWithAny(path, ["/api/image-generation"]) || /^\/api\/agents\/[^/]+\/image-generation(?:\/setup)?$/.test(path),
+		load: async () => {
+			const { registerModelsRoutes } = await import("./models.js");
+			return { register: registerModelsRoutes };
+		}
+	},
 	{
 		id: "agents",
 		match: (path) => startsWithAny(path, [
@@ -127,8 +143,7 @@ const AUTHENTICATED_LAZY_ROUTE_BUNDLES = [
 		match: (path) => startsWithAny(path, [
 			"/api/models",
 			"/api/models-json",
-			"/api/providers",
-			"/api/image"
+			"/api/providers"
 		]),
 		load: async () => {
 			const { registerModelsRoutes } = await import("./models.js");

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

@@ -1,4 +1,6 @@
+import { setInteractionState } from "../../../storage/sqlite/interaction-state-repository.js";
 import { LOCAL_USER_ID } from "../../../user-context/owner.js";
+import { findTaskOutcomeForAssistant, setTaskOutcomeFeedback } from "../../../storage/sqlite/task-outcome-repository.js";
 import { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, findLatestMemoryInjectTrace, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, setLatestMemoryInjectFeedback, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, upsertMemoryRecord } from "../../../storage/sqlite/memory-records-repository.js";
 import { listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns } from "../../../storage/sqlite/knowledge-repository.js";
 import "../../../storage/sqlite/index.js";
@@ -10,6 +12,7 @@ import { discoverMemoryPlugins } from "../../../agent/memory/plugin-discovery.js
 import { createMemoryManagerFromConfig } from "../../../agent/memory/create-memory-manager.js";
 import { resolveAdaptiveUnderstandingCadence } from "../../../agent/memory/understanding/quality.js";
 import { isUserContextRecord, projectUserContextRecord } from "../../../user-context/projection.js";
+import { summarizeMemoryUseAudit } from "../../../user-context/memory-use-audit.js";
 //#region src/gateway/hono/routes/memory.ts
 init_agent_scope();
 init_config();
@@ -310,6 +313,13 @@ function registerMemoryRoutes(authenticated, deps) {
 		});
 		return c.json({ traces });
 	});
+	authenticated.get("/api/user-context/memory-use-audit", (c) => {
+		const traces = listMemoryTraceEvents({
+			sessionKey: c.req.query("sessionKey") || void 0,
+			limit: parseLimit(c.req.query("limit"))
+		});
+		return c.json({ audit: summarizeMemoryUseAudit(traces) });
+	});
 	authenticated.patch("/api/user-context/traces/:traceId/feedback", async (c) => {
 		const body = await c.req.json().catch(() => ({}));
 		const outcome = typeof body.outcome === "string" && MEMORY_TRACE_FEEDBACK_OUTCOMES.has(body.outcome) ? body.outcome : void 0;
@@ -353,6 +363,24 @@ function registerMemoryRoutes(authenticated, deps) {
 		const outcome = body.outcome === "helpful" || body.outcome === "not_helpful" ? body.outcome : void 0;
 		const reason = typeof body.reason === "string" ? body.reason.trim().slice(0, 160) : "";
 		if (!sessionKey || !Number.isFinite(assistantTimestamp) || assistantTimestamp <= 0 || !outcome) return c.json({ error: "sessionKey, assistantTimestamp, and a valid outcome are required" }, 400);
+		const taskOutcome = setTaskOutcomeFeedback({
+			sessionKey,
+			assistantTimestamp,
+			outcome,
+			reason: reason || void 0,
+			needsCorrection: outcome === "not_helpful",
+			...outcome === "helpful" ? { supportFit: true } : reason.includes("tone_mismatch") ? { supportFit: false } : {}
+		});
+		if (outcome === "not_helpful" && reason.includes("tone_mismatch")) setInteractionState({
+			sessionKey,
+			signal: {
+				supportNeed: "unknown",
+				confidence: 1,
+				source: "explicit",
+				repairStatus: "needed",
+				repairReason: reason
+			}
+		});
 		const trace = setLatestMemoryInjectFeedback({
 			sessionKey,
 			beforeMs: assistantTimestamp,
@@ -363,10 +391,10 @@ function registerMemoryRoutes(authenticated, deps) {
 			}
 		});
 		return c.json({
-			matched: Boolean(trace),
+			matched: Boolean(taskOutcome),
 			attributedRecordCount: trace?.selectedRecordIds.length ?? 0,
 			personalContext: personalContextForTrace(trace),
-			feedback: trace?.feedback ?? null,
+			feedback: taskOutcome?.feedback ?? null,
 			remediation: trace?.remediation ?? null
 		});
 	});
@@ -374,15 +402,16 @@ function registerMemoryRoutes(authenticated, deps) {
 		const sessionKey = c.req.query("sessionKey")?.trim() ?? "";
 		const assistantTimestamp = Number(c.req.query("assistantTimestamp"));
 		if (!sessionKey || !Number.isFinite(assistantTimestamp) || assistantTimestamp <= 0) return c.json({ error: "sessionKey and assistantTimestamp are required" }, 400);
+		const taskOutcome = findTaskOutcomeForAssistant(sessionKey, assistantTimestamp);
 		const trace = findLatestMemoryInjectTrace({
 			sessionKey,
 			beforeMs: assistantTimestamp
 		});
 		return c.json({
-			matched: Boolean(trace),
+			matched: Boolean(taskOutcome),
 			attributedRecordCount: trace?.selectedRecordIds.length ?? 0,
 			personalContext: personalContextForTrace(trace),
-			feedback: trace?.feedback ?? null
+			feedback: taskOutcome?.feedback ?? null
 		});
 	});
 	authenticated.post("/api/user-context/signals", async (c) => {

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

@@ -1,25 +1,26 @@
-import { init_schema, parseModelRef } from "../../../config/schema.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { init_resolve_config_value, testApiKeyResolution } from "../../../config/resolve-config-value.js";
 import { init_models_json, loadModelsJson, saveModelsJson, validateModelsConfig } from "../../../config/models-json.js";
+import { getModelCatalogStore, init_model_catalog_store } from "../../../providers/model-catalog-store.js";
 import { getModelRegistry } from "../../../providers/model-registry.js";
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";
 import "../../../providers/constants.js";
 import { getProviderRegistry, init_plugin_registry } from "../../../providers/plugin-registry.js";
-import { PROVIDER_META, getAllModels, getAllProviders, getAvailableModels, getProviderAuthState, init_providers, isProviderConfigured, resolveModel } from "../../../providers/index.js";
-import { getImageGenerationProvider } from "../../../agent/image/generation/provider-registry.js";
-import { listImageGenerationProvidersSummary } from "../../../agent/image/generation/runtime.js";
+import { PROVIDER_META, getAllModels, getAllProviders, getAvailableModels, getProviderAuthState, init_providers, isProviderConfigured } from "../../../providers/index.js";
+import { SessionConfigStore } from "../../../session/config-store.js";
 import { getDomesticProviderPreset, getDomesticProviderPresetIds } from "../../../providers/domestic-presets.js";
 import { getOnboardingFeaturedProviders, getProviderHint, getRecommendedModelsForProvider, isRecommendedModel, sortModelsForPicker, sortProvidersForPicker } from "../../../providers/presentation.js";
-import { resolveCurrentImageModelCapabilities, resolveImageGenerationCapabilities, resolveImageUnderstandingCapabilities } from "../../image-capabilities.js";
-import { respondStartupUnavailable } from "../lib/startup-unavailable.js";
+import { getAgentImageGenerationConfig, getImageGenerationCatalog, prepareImageGenerationSetup, verifyImageGenerationCredential } from "../../image-generation-setup.js";
 import { discoverProviderModels, isProviderApiDiscoverable } from "../../../providers/model-discovery.js";
+import { XopcCloudHttpError } from "../../../providers/xopc-cloud-connection.js";
+import { respondStartupUnavailable } from "../lib/startup-unavailable.js";
+import { auditModelReferences } from "../../../providers/model-reference-auditor.js";
 //#region src/gateway/hono/routes/models.ts
 init_models_json();
-init_schema();
 init_resolve_config_value();
 init_providers();
 init_credentials();
+init_model_catalog_store();
 init_plugin_registry();
 function readModelsJsonProviderApiKey(providerId) {
 	const { config } = loadModelsJson(resolveModelsJsonPath());
@@ -31,14 +32,6 @@ function readStringRecord(value) {
 	const entries = Object.entries(value).filter((entry) => typeof entry[1] === "string");
 	return entries.length > 0 ? Object.fromEntries(entries) : void 0;
 }
-/** Plaintext key only when persisted under `cfg.providers.<id>.apiKey` (not env / credential store). */
-function readProviderApiKeyFromConfigFileOnly(cfg, providerId) {
-	const id = providerId.trim().toLowerCase();
-	const bucket = cfg.providers?.[id];
-	if (!bucket || typeof bucket !== "object" || Array.isArray(bucket)) return void 0;
-	const k = bucket.apiKey;
-	return typeof k === "string" && k.trim() ? k.trim() : void 0;
-}
 /** Extension id from manifest `providers[]` (e.g. provider `demo` → extension `demo-provider`). */
 function resolveExtensionIdForProvider(service, providerId) {
 	const loader = service.getExtensionLoader();
@@ -70,7 +63,85 @@ function mapPluginModel(providerId, model, available) {
 	};
 }
 function registerModelsRoutes(authenticated, deps) {
-	const { service, strictRateLimitMiddleware } = deps;
+	const { service, strictRateLimitMiddleware, xopcCloudPollRateLimitMiddleware } = deps;
+	const catalogSync = service.getModelCatalogSync();
+	const xopcCloud = catalogSync.getXopcCloudConnection();
+	authenticated.post("/api/models/xopc-cloud/connect", strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => ({}));
+		const clientType = body.clientType === "electron" || body.clientType === "cli" ? body.clientType : "web";
+		try {
+			return c.json({
+				ok: true,
+				payload: await xopcCloud.start(clientType)
+			}, 201);
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: { message: error instanceof Error ? error.message : "Connection failed" }
+			}, 502);
+		}
+	});
+	authenticated.post("/api/models/xopc-cloud/connect/:requestId/poll", xopcCloudPollRateLimitMiddleware, async (c) => {
+		try {
+			const result = await xopcCloud.poll(c.req.param("requestId"));
+			if (result.status === "pending") return c.json({
+				ok: true,
+				payload: result
+			}, 202);
+			service.emit("model-catalog.updated", { modelCount: getModelRegistry().getAll().length });
+			return c.json({
+				ok: true,
+				payload: result
+			});
+		} catch (error) {
+			return c.json({
+				ok: false,
+				error: { message: error instanceof Error ? error.message : "Connection failed" }
+			}, 400);
+		}
+	});
+	authenticated.post("/api/models/xopc-cloud/refresh", strictRateLimitMiddleware, async (c) => {
+		try {
+			const result = await catalogSync.refreshNow();
+			return c.json({
+				ok: true,
+				payload: result
+			});
+		} catch (error) {
+			const status = error instanceof XopcCloudHttpError && error.status === 401 ? 401 : error instanceof XopcCloudHttpError && error.status === 403 ? 403 : 502;
+			return c.json({
+				ok: false,
+				error: {
+					message: error instanceof Error ? error.message : "Refresh failed",
+					...error instanceof XopcCloudHttpError && error.code ? { code: error.code } : {}
+				}
+			}, status);
+		}
+	});
+	authenticated.get("/api/models/catalog/status", (c) => c.json({
+		ok: true,
+		payload: catalogSync.getStatus()
+	}));
+	authenticated.get("/api/models/catalog", async (c) => {
+		const catalog = getModelCatalogStore().load();
+		const sessionConfigs = await new SessionConfigStore("").getAll();
+		const references = auditModelReferences(service.currentConfig, sessionConfigs, { catalog });
+		return c.json({
+			ok: true,
+			payload: {
+				sources: catalog.sources,
+				sync: catalogSync.getStatus(),
+				references
+			}
+		});
+	});
+	authenticated.post("/api/models/catalog/refresh", strictRateLimitMiddleware, async (c) => {
+		const result = await catalogSync.refreshAll();
+		return c.json({
+			ok: true,
+			payload: result
+		});
+	});
 	authenticated.get("/api/models-json", async (c) => {
 		const path = resolveModelsJsonPath();
 		const { config, error } = loadModelsJson(path);
@@ -216,142 +287,93 @@ function registerModelsRoutes(authenticated, deps) {
 			payload: { models }
 		});
 	});
-	authenticated.get("/api/image/capabilities", async (c) => {
-		const config = service.currentConfig;
-		const agentId = c.req.query("agentId")?.trim() || void 0;
-		const imageGenerationProviders = await resolveImageGenerationCapabilities(config);
-		const imageUnderstandingProviders = await resolveImageUnderstandingCapabilities(config);
+	authenticated.get("/api/image-generation/catalog", (c) => {
 		return c.json({
 			ok: true,
-			payload: {
-				current: resolveCurrentImageModelCapabilities(config, agentId),
-				imageGeneration: { providers: imageGenerationProviders },
-				imageUnderstanding: { providers: imageUnderstandingProviders }
-			}
+			payload: { providers: getImageGenerationCatalog(service.currentConfig) }
 		});
 	});
-	authenticated.post("/api/image/validate-model", strictRateLimitMiddleware, async (c) => {
-		let body;
+	authenticated.get("/api/agents/:agentId/image-generation", (c) => {
 		try {
-			body = await c.req.json();
-		} catch {
+			return c.json({
+				ok: true,
+				payload: getAgentImageGenerationConfig(service.currentConfig, c.req.param("agentId"))
+			});
+		} catch (error) {
 			return c.json({
 				ok: false,
-				error: "Invalid JSON"
-			}, 400);
+				error: { message: error instanceof Error ? error.message : String(error) }
+			}, 404);
 		}
-		const modelRef = body.modelRef;
-		if (!modelRef || typeof modelRef !== "string") return c.json({
+	});
+	authenticated.post("/api/agents/:agentId/image-generation/setup", strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => null);
+		if (!body || typeof body.providerId !== "string") return c.json({
 			ok: false,
-			error: "modelRef is required"
+			error: { message: "providerId is required" }
 		}, 400);
-		const parsed = parseModelRef(modelRef);
-		if (!parsed) return c.json({
-			ok: true,
-			payload: {
-				valid: false,
-				reason: "invalid_format",
-				message: "Model reference must be in \"provider/model\" format"
-			}
-		});
-		if (!await isProviderConfigured(parsed.provider)) return c.json({
-			ok: true,
-			payload: {
-				valid: false,
-				reason: "provider_not_configured",
-				message: `Provider "${parsed.provider}" is not configured. Set the API key first.`,
-				provider: parsed.provider
-			}
+		const prepared = prepareImageGenerationSetup(service.currentConfig, c.req.param("agentId"), {
+			providerId: body.providerId,
+			...typeof body.modelId === "string" ? { modelId: body.modelId } : {},
+			...body.region === "cn" || body.region === "intl" ? { region: body.region } : {},
+			...typeof body.baseUrl === "string" ? { baseUrl: body.baseUrl } : {}
 		});
-		try {
-			resolveModel(modelRef);
-		} catch {
+		if (prepared.ok === false) return c.json({
+			ok: false,
+			error: { message: prepared.error }
+		}, 400);
+		const resolver = new CredentialResolver();
+		const previousKey = await resolver.revealGatewayStoredApiKey(prepared.providerId);
+		const suppliedKey = typeof body.apiKey === "string" ? body.apiKey.trim() : "";
+		if (!(suppliedKey || await resolver.resolveApiKey(prepared.providerId))) return c.json({
+			ok: false,
+			error: { message: "API key is required" }
+		}, 400);
+		const verification = suppliedKey ? await verifyImageGenerationCredential({
+			providerId: prepared.providerId,
+			apiKey: suppliedKey,
+			baseUrl: typeof body.baseUrl === "string" ? body.baseUrl : void 0
+		}) : {
+			verified: false,
+			supported: false
+		};
+		if (verification.supported && !verification.verified) return c.json({
+			ok: false,
+			error: { message: verification.message ?? "Credential verification failed" }
+		}, 400);
+		if (suppliedKey) await resolver.saveApiKey(prepared.providerId, suppliedKey, { profileName: "default" });
+		const saved = await service.saveConfig(prepared.config);
+		if (!saved.saved) {
+			if (suppliedKey) if (previousKey) await resolver.saveApiKey(prepared.providerId, previousKey, { profileName: "default" });
+			else await resolver.deleteProfile(`${prepared.providerId}:default`);
 			return c.json({
-				ok: true,
-				payload: {
-					valid: false,
-					reason: "model_not_found",
-					message: `Model not found in registry: ${modelRef}`,
-					provider: parsed.provider,
-					model: parsed.model
-				}
-			});
+				ok: false,
+				error: { message: saved.error ?? "Failed to save configuration" }
+			}, 500);
 		}
 		return c.json({
 			ok: true,
 			payload: {
-				valid: true,
-				provider: parsed.provider,
-				model: parsed.model
-			}
-		});
-	});
-	authenticated.get("/api/image/providers", (c) => {
-		const cfg = deps.service.currentConfig;
-		const providers = listImageGenerationProvidersSummary(cfg).map((p) => {
-			const provider = getImageGenerationProvider(p.id, cfg);
-			let configured = false;
-			try {
-				configured = provider?.isConfigured?.({ cfg }) === true;
-			} catch {
-				configured = false;
+				agent: getAgentImageGenerationConfig(service.currentConfig, c.req.param("agentId")),
+				providers: getImageGenerationCatalog(service.currentConfig),
+				verification
 			}
-			return {
-				...p,
-				configured
-			};
-		});
-		return c.json({
-			ok: true,
-			payload: { providers }
 		});
 	});
-	authenticated.post("/api/image/providers/:id/test", (c) => {
-		const id = c.req.param("id");
-		const cfg = deps.service.currentConfig;
-		const provider = getImageGenerationProvider(id, cfg);
-		if (!provider) return c.json({
+	authenticated.post("/api/image-generation/providers/:providerId/verify", strictRateLimitMiddleware, async (c) => {
+		const body = await c.req.json().catch(() => null);
+		if (!body || typeof body.apiKey !== "string") return c.json({
 			ok: false,
-			error: { message: `Image generation provider not found: ${id}` }
-		}, 404);
-		let configured = false;
-		let reason;
-		try {
-			configured = provider.isConfigured?.({ cfg }) === true;
-			if (!configured) reason = "Missing API key (set via config or environment).";
-		} catch (err) {
-			reason = err instanceof Error ? err.message : String(err);
-		}
-		return c.json({
-			ok: true,
-			payload: {
-				id: provider.id,
-				configured,
-				...reason ? { reason } : {},
-				defaultModel: provider.defaultModel ?? null
-			}
+			error: { message: "apiKey is required" }
+		}, 400);
+		const result = await verifyImageGenerationCredential({
+			providerId: c.req.param("providerId"),
+			apiKey: body.apiKey,
+			baseUrl: typeof body.baseUrl === "string" ? body.baseUrl : void 0
 		});
-	});
-	/**
-	* POST /api/image/providers/:id/reveal-api-key — return `cfg.providers.<id>.apiKey` plaintext for the
-	* gateway console (same auth as PATCH /api/config). Does not resolve env vars or credential files.
-	*/
-	authenticated.post("/api/image/providers/:id/reveal-api-key", strictRateLimitMiddleware, async (c) => {
-		const rawId = c.req.param("id");
-		const cfg = deps.service.currentConfig;
-		const provider = getImageGenerationProvider(rawId, cfg);
-		if (!provider) return c.json({
-			ok: false,
-			error: { message: `Image generation provider not found: ${rawId}` }
-		}, 404);
-		const apiKey = readProviderApiKeyFromConfigFileOnly(cfg, provider.id);
 		return c.json({
 			ok: true,
-			payload: {
-				id: provider.id,
-				apiKey: apiKey ?? null,
-				source: apiKey ? "config" : "none"
-			}
+			payload: result
 		});
 	});
 	authenticated.get("/api/providers", async (c) => {

package/dist/src/gateway/hono/routes/task-outcomes.d.ts

@@ -0,0 +1,3 @@
+import type { Hono } from 'hono';
+import type { AuthenticatedRouteDeps } from './deps.js';
+export declare function registerTaskOutcomeRoutes(authenticated: Hono, _deps: AuthenticatedRouteDeps): void;

package/dist/src/gateway/hono/routes/task-outcomes.js

@@ -0,0 +1,109 @@
+import { findTaskOutcomeForAssistant, getTaskOutcome, listTaskOutcomes, summarizeTaskOutcomes, updateTaskOutcome } from "../../../storage/sqlite/task-outcome-repository.js";
+import "../../../storage/sqlite/index.js";
+import { replayTaskEvaluation } from "../../../agent/outcomes/task-evaluation.js";
+//#region src/gateway/hono/routes/task-outcomes.ts
+function parseLimit(raw) {
+	if (!raw) return void 0;
+	const value = Number.parseInt(raw, 10);
+	return Number.isFinite(value) ? value : void 0;
+}
+function isStringArray(value) {
+	return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function isTaskContract(value) {
+	if (!value || typeof value !== "object") return false;
+	const contract = value;
+	return typeof contract.objective === "string" && isStringArray(contract.deliverables) && isStringArray(contract.acceptanceCriteria) && isStringArray(contract.constraints) && isStringArray(contract.approvalRequired);
+}
+function isTaskEvidence(value) {
+	return Array.isArray(value) && value.every((item) => {
+		if (!item || typeof item !== "object") return false;
+		const evidence = item;
+		return (evidence.kind === "artifact" || evidence.kind === "test" || evidence.kind === "state" || evidence.kind === "source") && typeof evidence.title === "string" && typeof evidence.summary === "string" && (evidence.uri === void 0 || typeof evidence.uri === "string") && (evidence.verifies === void 0 || isStringArray(evidence.verifies));
+	});
+}
+function registerTaskOutcomeRoutes(authenticated, _deps) {
+	authenticated.get("/api/task-outcomes", (c) => {
+		const items = listTaskOutcomes({
+			sessionKey: c.req.query("sessionKey")?.trim() || void 0,
+			limit: parseLimit(c.req.query("limit"))
+		});
+		return c.json({
+			ok: true,
+			items
+		});
+	});
+	authenticated.get("/api/task-outcomes/metrics", (c) => {
+		return c.json({
+			ok: true,
+			metrics: summarizeTaskOutcomes()
+		});
+	});
+	authenticated.get("/api/task-outcomes/evaluation", (c) => {
+		const items = listTaskOutcomes({ limit: parseLimit(c.req.query("limit")) ?? 100 });
+		return c.json({
+			ok: true,
+			evaluation: replayTaskEvaluation(items)
+		});
+	});
+	authenticated.get("/api/task-outcomes/for-assistant", (c) => {
+		const sessionKey = c.req.query("sessionKey")?.trim() ?? "";
+		const assistantTimestamp = Number(c.req.query("assistantTimestamp"));
+		if (!sessionKey || !Number.isFinite(assistantTimestamp) || assistantTimestamp <= 0) return c.json({
+			ok: false,
+			error: "sessionKey and assistantTimestamp are required"
+		}, 400);
+		const outcome = findTaskOutcomeForAssistant(sessionKey, assistantTimestamp);
+		return outcome ? c.json({
+			ok: true,
+			outcome
+		}) : c.json({
+			ok: false,
+			error: "Task outcome not found"
+		}, 404);
+	});
+	authenticated.get("/api/task-outcomes/:runId", (c) => {
+		const outcome = getTaskOutcome(c.req.param("runId"));
+		return outcome ? c.json({
+			ok: true,
+			outcome
+		}) : c.json({
+			ok: false,
+			error: "Task outcome not found"
+		}, 404);
+	});
+	authenticated.patch("/api/task-outcomes/:runId", async (c) => {
+		const body = await c.req.json().catch(() => null);
+		if (!body || typeof body !== "object") return c.json({
+			ok: false,
+			error: "Invalid JSON body"
+		}, 400);
+		if (body.contract !== void 0 && !isTaskContract(body.contract)) return c.json({
+			ok: false,
+			error: "Invalid task contract"
+		}, 400);
+		if (body.evidence !== void 0 && !isTaskEvidence(body.evidence)) return c.json({
+			ok: false,
+			error: "Invalid task evidence"
+		}, 400);
+		if (body.summary !== void 0 && typeof body.summary !== "string") return c.json({
+			ok: false,
+			error: "Invalid task summary"
+		}, 400);
+		const outcome = updateTaskOutcome({
+			runId: c.req.param("runId"),
+			...body.contract === void 0 ? {} : { contract: body.contract },
+			...body.evidence === void 0 ? {} : { evidence: body.evidence },
+			...body.summary === void 0 ? {} : { summary: body.summary }
+		});
+		return outcome ? c.json({
+			ok: true,
+			outcome
+		}) : c.json({
+			ok: false,
+			error: "Task outcome not found"
+		}, 404);
+	});
+}
+//#endregion
+export { registerTaskOutcomeRoutes };

package/dist/src/gateway/hono/routes/you.d.ts

@@ -1,8 +1,9 @@
 import type { Hono } from 'hono';
 import type { MemoryRecord } from '../../../agent/memory/types.js';
+import { type PersonalPlaybookContext } from '../../../user-context/personal-playbook.js';
 import type { AuthenticatedRouteDeps } from './deps.js';
 export declare function buildPersonalPlaybooks(records: MemoryRecord[]): {
-    id: "communication" | "execution" | "routines";
+    id: "execution" | "communication" | "routines";
     enabled: boolean;
     rules: {
         id: string;
@@ -10,6 +11,13 @@ export declare function buildPersonalPlaybooks(records: MemoryRecord[]): {
         origin: import("../../../agent/memory/types.js").MemoryExplicitness;
         enabled: boolean;
         order: number;
+        context: PersonalPlaybookContext;
+        versions: {
+            id: string;
+            statement: string;
+            updatedAt: string;
+            current: boolean;
+        }[];
     }[];
     updatedAt: string;
 }[];
@@ -17,7 +25,7 @@ export declare function buildInsightSuggestions(records: MemoryRecord[]): {
     id: string;
     insight: string;
     kind: import("../../../agent/memory/types.js").MemoryKind;
-    action: "make_repeatable" | "start_progress";
+    action: "make_repeatable" | "add_playbook" | "start_progress";
     evidenceCount: number;
     confidence: number;
     sourceName: string;