@xopcai/xopc 0.0.366 → 0.0.367

package/dist/src/agent/tools/image-generate-tool.js

@@ -19,6 +19,8 @@ const ALLOWED_QUALITIES = [
 	"low",
 	"medium",
 	"high",
+	"xhigh",
+	"max",
 	"auto"
 ];
 const ALLOWED_OUTPUT_FORMATS = [
@@ -39,7 +41,7 @@ const ALLOWED_RESOLUTIONS = [
 const ImageGenerateToolSchema = Type.Object({
 	action: Type.Optional(Type.String({ description: "Optional: \"generate\" (default) or \"list\" available image-generation providers." })),
 	prompt: Type.Optional(Type.String({ description: "Image generation prompt." })),
-	model: Type.Optional(Type.String({ description: "Optional provider/model override, e.g. openai/gpt-image-2 / dashscope/wan2.7-image-pro / minimax/image-01." })),
+	model: Type.Optional(Type.String({ description: "Optional provider/model override, e.g. openai/gpt-image-2.5-flare / dashscope/wan2.7-image-pro / minimax/image-01." })),
 	filename: Type.Optional(Type.String({ description: "Optional basename hint for saved files." })),
 	size: Type.Optional(Type.String({ description: "Optional pixel size, e.g. 1024x1024." })),
 	aspectRatio: Type.Optional(Type.String({ description: "Optional aspect ratio, e.g. 16:9 / 9:16 / 1:1." })),
@@ -49,7 +51,7 @@ const ImageGenerateToolSchema = Type.Object({
 		maximum: MAX_COUNT,
 		description: `Number of images (1–${MAX_COUNT}).`
 	})),
-	quality: Type.Optional(Type.String({ description: "Optional quality: low / medium / high / auto." })),
+	quality: Type.Optional(Type.String({ description: "Optional quality: low / medium / high / xhigh / max / auto." })),
 	outputFormat: Type.Optional(Type.String({ description: "Optional output format: png / jpeg / webp." })),
 	background: Type.Optional(Type.String({ description: "Optional background: transparent / opaque / auto." })),
 	inputImages: Type.Optional(Type.Array(Type.Object({ source: Type.String({ description: "Workspace-relative file path or `data:image/...;base64,...` URL." }) }), { description: "Reference images for edit mode (provider must support edit)." })),
@@ -282,12 +284,10 @@ function createImageGenerateTool(options) {
 					filePath: paths[index],
 					mediaType: "photo"
 				})));
-				const lines = [`Generated and attached ${paths.length} image(s) with ${result.provider}/${result.model}.`, ...paths.map((p) => `Saved: ${p}`)];
-				for (const note of buildNormalizationNotes(result.normalization, result.ignoredOverrides)) lines.push(note);
 				return {
 					content: [{
 						type: "text",
-						text: lines.join("\n")
+						text: [`Generated and attached ${paths.length} image(s) with ${result.provider}/${result.model}.`, ...paths.map((p) => `Saved: ${p}`)].join("\n")
 					}],
 					details: {
 						provider: result.provider,
@@ -308,8 +308,6 @@ function createImageGenerateTool(options) {
 							workspaceRelativePath: workspaceRelativePaths[index]
 						})),
 						attempts: result.attempts,
-						...result.normalization ? { normalization: result.normalization } : {},
-						...result.ignoredOverrides.length > 0 ? { ignoredOverrides: result.ignoredOverrides } : {},
 						...result.metadata ? { metadata: result.metadata } : {}
 					}
 				};
@@ -337,17 +335,5 @@ function createImageGenerateTool(options) {
 		}
 	};
 }
-function buildNormalizationNotes(normalization, ignoredOverrides) {
-	const notes = [];
-	if (normalization) for (const [key, entry] of Object.entries(normalization)) {
-		if (!entry) continue;
-		const requested = entry.requested;
-		const applied = entry.applied;
-		if (requested !== void 0 && applied !== void 0 && requested !== applied) notes.push(`Note: requested ${key}="${requested}" → applied "${applied}".`);
-		else if (applied !== void 0 && entry.derivedFrom) notes.push(`Note: ${key}="${applied}" derived from ${entry.derivedFrom}.`);
-	}
-	for (const ig of ignoredOverrides) notes.push(`Note: ignored ${ig.key}="${ig.value}" (not supported by provider).`);
-	return notes;
-}
 //#endregion
 export { createImageGenerateTool, parseImageDataUrl, resolveImageGenerationModelConfigForTool };

package/dist/src/agent/tools/personal-attention-tool.d.ts

@@ -0,0 +1,21 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { Config } from '../../config/schema.js';
+declare const schema: import("@sinclair/typebox").TObject<{
+    command: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"follow">, import("@sinclair/typebox").TLiteral<"pause">, import("@sinclair/typebox").TLiteral<"end">, import("@sinclair/typebox").TLiteral<"resume">, import("@sinclair/typebox").TLiteral<"settings">, import("@sinclair/typebox").TLiteral<"interests">, import("@sinclair/typebox").TLiteral<"feedback">, import("@sinclair/typebox").TLiteral<"rollback">]>;
+    id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    subject: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    nextCheckAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    nextCheckLocal: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    taskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    projectId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    mode: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"off">, import("@sinclair/typebox").TLiteral<"follow_up">, import("@sinclair/typebox").TLiteral<"balanced">]>>;
+    feedback: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"stop">, import("@sinclair/typebox").TLiteral<"defer">, import("@sinclair/typebox").TLiteral<"adjust">]>>;
+    preparation: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"brief">, import("@sinclair/typebox").TLiteral<"thorough">]>>;
+    versionId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function createPersonalAttentionTool(deps: {
+    getConversationId: () => string | undefined;
+    getConfig: () => Config | undefined;
+}): AgentTool<typeof schema, Record<string, never>>;
+export {};

package/dist/src/agent/tools/personal-attention-tool.js

@@ -0,0 +1,191 @@
+import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
+import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-repository.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
+import { parseLocalCheckTime } from "../../personal-agent/proactivity/follow-up-request.js";
+import { applyThreadFeedback, getAttention, getProactivitySettings, listAttention, listInterestCandidates, patchAttention, patchProactivitySettings, rollbackStrategy, saveAttention, strategyState, userText } from "../../personal-agent/proactivity/repository.js";
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/personal-attention-tool.ts
+init_transaction();
+init_session_instance_repository();
+const schema = Type.Object({
+	command: Type.Union([
+		Type.Literal("list"),
+		Type.Literal("follow"),
+		Type.Literal("pause"),
+		Type.Literal("end"),
+		Type.Literal("resume"),
+		Type.Literal("settings"),
+		Type.Literal("interests"),
+		Type.Literal("feedback"),
+		Type.Literal("rollback")
+	]),
+	id: Type.Optional(Type.String()),
+	subject: Type.Optional(Type.String({ maxLength: 160 })),
+	summary: Type.Optional(Type.String({ maxLength: 1600 })),
+	nextCheckAt: Type.Optional(Type.Number()),
+	nextCheckLocal: Type.Optional(Type.String({ description: "Preferred check time: YYYY-MM-DDTHH:mm in the user configured timezone. Use this instead of calculating epoch milliseconds. For vague tomorrow afternoon, use 15:00." })),
+	taskId: Type.Optional(Type.String()),
+	projectId: Type.Optional(Type.String()),
+	mode: Type.Optional(Type.Union([
+		Type.Literal("off"),
+		Type.Literal("follow_up"),
+		Type.Literal("balanced")
+	])),
+	feedback: Type.Optional(Type.Union([
+		Type.Literal("stop"),
+		Type.Literal("defer"),
+		Type.Literal("adjust")
+	])),
+	preparation: Type.Optional(Type.Union([Type.Literal("brief"), Type.Literal("thorough")])),
+	versionId: Type.Optional(Type.String({ description: "Latest strategy version ID returned by list; required for rollback." }))
+});
+function createPersonalAttentionTool(deps) {
+	return {
+		name: "personal_attention",
+		label: "Personal follow-up",
+		description: "Persist or inspect attention in this personal conversation. An explicit request such as \"check tomorrow afternoon and proactively tell me if useful\" authorizes follow. The running Gateway automatically checks saved attention while the user is away and posts useful developments in this chat; no separate user automation is required. Prefer nextCheckLocal over epoch arithmetic. Checks are not guaranteed notifications. No action authorization is granted. Only claim saved after a successful result; an error means it was not saved, not that background checks are unsupported. Use pause/end/resume only for an explicit user instruction; do not duplicate an existing automation. Query list to verify whether follow-up is saved or active; query settings for current mode and timezone. Use current tool results rather than historical assistant claims. Valid commands: follow, list, settings, pause, end, resume, interests, feedback, rollback. interests reads silent candidates, not authorization. feedback saves an explicit topic preparation/stop/defer preference; rollback undoes the latest version on explicit request. Query list for IDs and versions. settings reads or explicitly changes off, follow_up, balanced.",
+		parameters: schema,
+		async execute(_toolId, input) {
+			const conversationId = deps.getConversationId();
+			const personal = conversationId ? getPersonalAgentByConversation(conversationId) : null;
+			const config = deps.getConfig();
+			if (!personal || !conversationId || !config) throw new Error("Personal attention is unavailable");
+			if ((input.command === "follow" || input.command === "resume") && (!resolveUserContextSessionAccess(config, conversationId).userModel || config.userContext.userModel.writePolicy === "deny")) throw new Error("Personal attention is unavailable");
+			if (input.command === "settings" && !input.mode) return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(getProactivitySettings(personal.ownerId))
+				}],
+				details: {}
+			};
+			if (input.command === "interests") {
+				if (!resolveUserContextSessionAccess(config, conversationId).userModel) throw new Error("Interest access is unavailable");
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify(listInterestCandidates(conversationId))
+					}],
+					details: {}
+				};
+			}
+			if (input.command === "list") return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(listAttention(conversationId).map((thread) => ({
+						id: thread.id,
+						subject: thread.subject,
+						status: thread.status,
+						nextCheckAt: thread.next_check_at,
+						revision: thread.revision,
+						strategy: strategyState(thread.id)
+					})))
+				}],
+				details: {}
+			};
+			const db = getSqliteDatabase();
+			const transcriptId = readCurrentTranscriptId(db, conversationId);
+			const source = db.prepare("SELECT entry_id,payload_json FROM transcript_entries WHERE transcript_id = ? AND role = 'user' ORDER BY seq DESC LIMIT 1").get(transcriptId);
+			if (!source) throw new Error("An explicit user source is required");
+			const sourceText = userText(JSON.parse(source.payload_json));
+			const settings = getProactivitySettings(personal.ownerId);
+			const nextCheckAt = input.nextCheckLocal ? parseLocalCheckTime(input.nextCheckLocal, settings.timezone) : input.nextCheckAt;
+			if (input.command === "settings") {
+				if (!input.mode || !{
+					off: /关闭.*主动|不要.*主动|别.*主动|停.*主动|disable|turn off|no.*proactive/iu,
+					follow_up: /(?:仅|只|少|only|less).*(?:跟进|提醒|联系|follow|remind|contact)/iu,
+					balanced: /(?:开启|恢复|允许|可以|更).*(?:主动|联系)|enable.*proactive|more proactive/iu
+				}[input.mode].test(sourceText)) throw new Error("An explicit mode instruction is required");
+				const settings = patchProactivitySettings(personal.ownerId, {
+					...getProactivitySettings(personal.ownerId),
+					mode: input.mode
+				});
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify(settings)
+					}],
+					details: {}
+				};
+			}
+			let thread;
+			if (input.command === "feedback" || input.command === "rollback") {
+				const current = input.id ? getAttention(input.id, personal.ownerId) : void 0;
+				if (!current || current.conversation_id !== conversationId) throw new Error("Attention is unavailable");
+				if (input.command === "rollback") {
+					if (!/撤销|撤回|回滚|恢复.*(?:之前|原来)|undo|roll\s?back/iu.test(sourceText) || !input.versionId) throw new Error("An explicit undo instruction and latest version ID are required");
+					thread = rollbackStrategy(personal.ownerId, current.id, {
+						versionId: input.versionId,
+						revision: current.revision,
+						idempotencyKey: `input:${source.entry_id}:${current.id}`
+					}, source.entry_id);
+				} else {
+					if (!input.feedback || !{
+						stop: /停止|结束|别再|不用.*(?:关注|跟进|提醒)|stop|don't.*(?:follow|remind)/iu,
+						defer: /晚点|明天|下周|再说|later|tomorrow|next week/iu,
+						adjust: /(?:以后|今后|下次|future|always|next time).*(?:准备|完整|详细|简短|prepare|thorough|brief)|(?:准备|完整|详细|简短|prepare|thorough|brief).*(?:以后|今后|下次|future|always|next time)/iu
+					}[input.feedback].test(sourceText)) throw new Error("An explicit topic feedback instruction is required");
+					thread = applyThreadFeedback(personal.ownerId, current.id, current.revision, {
+						idempotencyKey: `input:${source.entry_id}:${current.id}`,
+						kind: input.feedback,
+						scope: "thread",
+						until: input.feedback === "defer" ? nextCheckAt : void 0,
+						preparation: input.feedback === "adjust" ? input.preparation : void 0
+					}, { entryId: source.entry_id });
+				}
+			} else if (input.command === "follow") {
+				if (!input.subject) throw new Error("A subject is required");
+				thread = saveAttention({
+					conversationId,
+					subject: input.subject,
+					summary: input.summary ?? input.subject,
+					kind: "outcome",
+					entryIds: [source.entry_id],
+					explicit: true,
+					nextCheckAt: nextCheckAt ?? Date.now() + 864e5,
+					taskId: input.taskId,
+					projectId: input.projectId
+				});
+				if (thread.authority !== "user_explicit") throw new Error("Follow-up must be explicitly requested");
+			} else {
+				const current = input.id ? getAttention(input.id, personal.ownerId) : void 0;
+				if (!current || current.conversation_id !== conversationId) throw new Error("Attention is unavailable");
+				const text = sourceText;
+				if (!{
+					pause: /暂停|晚点|再说|下周|明天|pause|later|next week/iu,
+					end: /停止|结束|别再|不用.*(?:跟进|关注|提醒)|stop|end|don't.*(?:follow|remind)/iu,
+					resume: /恢复|继续|重新|resume|continue/iu
+				}[input.command].test(text)) throw new Error("An explicit instruction is required");
+				thread = input.command === "end" ? applyThreadFeedback(personal.ownerId, current.id, current.revision, {
+					idempotencyKey: `input:${source.entry_id}:${current.id}`,
+					kind: "stop",
+					scope: "thread"
+				}, { entryId: source.entry_id }) : patchAttention(personal.ownerId, current.id, current.revision, {
+					status: input.command === "pause" ? "paused" : "active",
+					nextCheckAt
+				});
+			}
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify({
+						id: thread.id,
+						status: thread.status,
+						nextCheckAt: thread.next_check_at,
+						strategy: strategyState(thread.id),
+						timezone: settings.timezone,
+						nextCheckLocal: thread.next_check_at === null ? null : new Intl.DateTimeFormat("sv-SE", {
+							timeZone: settings.timezone,
+							dateStyle: "short",
+							timeStyle: "short"
+						}).format(thread.next_check_at),
+						note: "Attention is persisted. Checks require a running Gateway, enabled proactivity, and the user context policy. This is not a delivery guarantee."
+					})
+				}],
+				details: {}
+			};
+		}
+	};
+}
+//#endregion
+export { createPersonalAttentionTool };

package/dist/src/automations/capabilities/write.d.ts

@@ -125,6 +125,7 @@ export declare const AutomationCreateCapabilityInputSchema: z.ZodObject<{
         kind: z.ZodLiteral<"system">;
         capability: z.ZodEnum<{
             "home.advisor.refresh": "home.advisor.refresh";
+            "personal.proactivity.tick": "personal.proactivity.tick";
             "memory.temporal_sweep": "memory.temporal_sweep";
             "memory.daily_reconciliation": "memory.daily_reconciliation";
             "memory.weekly_knowledge": "memory.weekly_knowledge";
@@ -324,6 +325,7 @@ export declare const AutomationUpdatePatchSchema: z.ZodObject<{
         kind: z.ZodLiteral<"system">;
         capability: z.ZodEnum<{
             "home.advisor.refresh": "home.advisor.refresh";
+            "personal.proactivity.tick": "personal.proactivity.tick";
             "memory.temporal_sweep": "memory.temporal_sweep";
             "memory.daily_reconciliation": "memory.daily_reconciliation";
             "memory.weekly_knowledge": "memory.weekly_knowledge";

package/dist/src/automations/domain/types.d.ts

@@ -56,7 +56,7 @@ export type AutomationAction = {
     command: TaskCommand;
 } | {
     kind: 'system';
-    capability: 'home.advisor.refresh' | 'memory.temporal_sweep' | 'memory.daily_reconciliation' | 'memory.weekly_knowledge';
+    capability: 'home.advisor.refresh' | 'personal.proactivity.tick' | 'memory.temporal_sweep' | 'memory.daily_reconciliation' | 'memory.weekly_knowledge';
 };
 export type AutomationEditableField = 'enabled' | 'trigger';
 export interface AutomationManagement {

package/dist/src/automations/domain/validation.d.ts

@@ -155,6 +155,7 @@ export declare const AutomationActionSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     kind: z.ZodLiteral<"system">;
     capability: z.ZodEnum<{
         "home.advisor.refresh": "home.advisor.refresh";
+        "personal.proactivity.tick": "personal.proactivity.tick";
         "memory.temporal_sweep": "memory.temporal_sweep";
         "memory.daily_reconciliation": "memory.daily_reconciliation";
         "memory.weekly_knowledge": "memory.weekly_knowledge";
@@ -374,6 +375,7 @@ export declare const AutomationSchema: z.ZodObject<{
         kind: z.ZodLiteral<"system">;
         capability: z.ZodEnum<{
             "home.advisor.refresh": "home.advisor.refresh";
+            "personal.proactivity.tick": "personal.proactivity.tick";
             "memory.temporal_sweep": "memory.temporal_sweep";
             "memory.daily_reconciliation": "memory.daily_reconciliation";
             "memory.weekly_knowledge": "memory.weekly_knowledge";
@@ -572,6 +574,7 @@ export declare const CreateAutomationSchema: z.ZodObject<{
         kind: z.ZodLiteral<"system">;
         capability: z.ZodEnum<{
             "home.advisor.refresh": "home.advisor.refresh";
+            "personal.proactivity.tick": "personal.proactivity.tick";
             "memory.temporal_sweep": "memory.temporal_sweep";
             "memory.daily_reconciliation": "memory.daily_reconciliation";
             "memory.weekly_knowledge": "memory.weekly_knowledge";
@@ -797,6 +800,7 @@ export declare const UpdateAutomationSchema: z.ZodObject<{
         kind: z.ZodLiteral<"system">;
         capability: z.ZodEnum<{
             "home.advisor.refresh": "home.advisor.refresh";
+            "personal.proactivity.tick": "personal.proactivity.tick";
             "memory.temporal_sweep": "memory.temporal_sweep";
             "memory.daily_reconciliation": "memory.daily_reconciliation";
             "memory.weekly_knowledge": "memory.weekly_knowledge";

package/dist/src/automations/domain/validation.js

@@ -107,6 +107,7 @@ const AutomationActionSchema = z.discriminatedUnion("kind", [
 		kind: z.literal("system"),
 		capability: z.enum([
 			"home.advisor.refresh",
+			"personal.proactivity.tick",
 			"memory.temporal_sweep",
 			"memory.daily_reconciliation",
 			"memory.weekly_knowledge"

package/dist/src/automations/draft/automation-draft-validator.d.ts

@@ -125,7 +125,7 @@ export declare function buildAutomationDraftResponse(draft: GeneratedAutomationD
             };
         } | {
             kind: "system";
-            capability: "home.advisor.refresh" | "memory.temporal_sweep" | "memory.daily_reconciliation" | "memory.weekly_knowledge";
+            capability: "home.advisor.refresh" | "personal.proactivity.tick" | "memory.temporal_sweep" | "memory.daily_reconciliation" | "memory.weekly_knowledge";
         };
         trigger?: {
             kind: "manual";

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

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

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

@@ -3,6 +3,8 @@ import { CredentialResolver, init_credentials } from "../../auth/credentials.js"
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { getAllModels, getAvailableModels, getConfiguredProviders, getProviderAuthState, getProviderDisplayName, init_providers, isProviderConfigured, providerSupportsApiKey, providerSupportsOAuth, resolveModel } from "../../providers/index.js";
 import { AgentCatalogService } from "../../agent-catalog/service.js";
+import { listImageProviderSpecs } from "../../../packages/image-providers/src/catalog.js";
+import "../../../packages/image-providers/src/index.js";
 import { loadConfig } from "../../config/loader.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";
@@ -18,14 +20,7 @@ init_credentials();
 init_schema();
 init_repository();
 init_providers();
-const IMAGE_GENERATION_IDS = new Set([
-	"gpt-image-2",
-	"wan2.6-t2i",
-	"wan2.7-image-pro",
-	"wan2.7-image",
-	"image-01",
-	"image-01-live"
-]);
+const IMAGE_GENERATION_IDS = new Set(listImageProviderSpecs().flatMap((provider) => provider.models.map((model) => model.id)));
 const VISION_IDS = new Set([
 	"gpt-5.6",
 	"gpt-5.6-luna",