@xopcai/xopc 0.0.366 → 0.0.367

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

@@ -40,6 +40,7 @@ import { init_extension_capabilities } from "./extension-capabilities.js";
 import { init_usage } from "./usage.js";
 import { init_task_result_delivery } from "./task-result-delivery.js";
 import { init_session_command_rejection } from "./session-command-rejection.js";
+import { init_personal_proactivity } from "./personal-proactivity.js";
 //#region packages/gateway-contract/src/index.ts
 var init_src = __esmMin((() => {
 	init_agent_stream();
@@ -83,6 +84,7 @@ var init_src = __esmMin((() => {
 	init_usage();
 	init_task_result_delivery();
 	init_session_command_rejection();
+	init_personal_proactivity();
 }));
 //#endregion
 init_src();

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

@@ -22,7 +22,8 @@ var init_notifications = __esmMin((() => {
 		}),
 		z.object({
 			kind: z.literal("chat"),
-			conversationId: z.string().min(1)
+			conversationId: z.string().min(1),
+			personal: z.boolean().optional()
 		}),
 		z.object({
 			kind: z.literal("task"),

package/dist/packages/gateway-contract/src/personal-proactivity.js

@@ -0,0 +1,139 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { z } from "zod";
+//#region packages/gateway-contract/src/personal-proactivity.ts
+function parsePersonalProactiveMessage(value) {
+	const result = PersonalProactiveMessageSchema.safeParse(value);
+	return result.success ? result.data : void 0;
+}
+var PERSONAL_PROACTIVE_MESSAGE_TYPE, PersonalProvenanceSchema, PersonalProactiveMessageSchema, PersonalProactivitySettingsSchema, PersonalFeedbackSchema, PersonalStrategyRollbackSchema, PersonalStrategyStateSchema;
+var init_personal_proactivity = __esmMin((() => {
+	PERSONAL_PROACTIVE_MESSAGE_TYPE = "personal_proactive_message";
+	PersonalProvenanceSchema = z.object({
+		outreachId: z.string().uuid(),
+		reasonKind: z.enum([
+			"follow_up",
+			"discussion",
+			"change",
+			"prepared"
+		]),
+		authority: z.enum(["user_explicit", "inferred"])
+	}).strict();
+	PersonalProactiveMessageSchema = z.object({
+		version: z.literal(1),
+		outreachId: z.string().uuid(),
+		threadId: z.string().uuid(),
+		conversationId: z.string().uuid(),
+		originTranscriptId: z.string().min(1),
+		text: z.string().trim().min(1).max(12e3),
+		provenance: PersonalProvenanceSchema,
+		createdAt: z.number().int().nonnegative()
+	}).strict();
+	PersonalProactivitySettingsSchema = z.object({
+		revision: z.number().int().positive().default(1),
+		mode: z.enum([
+			"off",
+			"follow_up",
+			"balanced"
+		]).default("balanced"),
+		timezone: z.string().max(100).default("Asia/Shanghai").refine((value) => {
+			try {
+				new Intl.DateTimeFormat("en", { timeZone: value });
+				return true;
+			} catch {
+				return false;
+			}
+		}, "Invalid timezone"),
+		quietStart: z.number().int().min(0).max(23).default(22),
+		quietEnd: z.number().int().min(0).max(23).default(8),
+		dailyMessages: z.number().int().min(0).max(10).default(2),
+		dailyModelCalls: z.number().int().min(0).max(100).default(12)
+	}).strict();
+	PersonalFeedbackSchema = z.object({
+		idempotencyKey: z.string().min(1).max(200),
+		kind: z.enum([
+			"helpful",
+			"irrelevant",
+			"stop",
+			"defer",
+			"adjust"
+		]),
+		scope: z.enum(["message", "thread"]).default("message"),
+		until: z.number().int().positive().optional(),
+		preparation: z.enum(["brief", "thorough"]).optional()
+	}).strict().superRefine((value, ctx) => {
+		if (value.kind === "defer" && !value.until) ctx.addIssue({
+			code: "custom",
+			message: "A defer time is required"
+		});
+		if (value.kind === "adjust" && !value.preparation) ctx.addIssue({
+			code: "custom",
+			message: "A preparation preference is required"
+		});
+		if ((value.kind === "stop" || value.kind === "adjust") && value.scope !== "thread") ctx.addIssue({
+			code: "custom",
+			message: "A lasting change requires thread scope"
+		});
+	});
+	PersonalStrategyRollbackSchema = z.object({
+		versionId: z.string().uuid(),
+		revision: z.number().int().positive(),
+		idempotencyKey: z.string().min(1).max(200)
+	}).strict();
+	PersonalStrategyStateSchema = z.object({
+		preparation: z.enum(["brief", "thorough"]).nullable(),
+		versions: z.array(z.object({
+			id: z.string().uuid(),
+			revision: z.number().int().positive(),
+			kind: z.enum([
+				"stop",
+				"defer",
+				"adjust",
+				"rollback"
+			]),
+			createdAt: z.number(),
+			preparation: z.enum(["brief", "thorough"]).nullable()
+		}))
+	});
+	z.object({
+		id: z.string().uuid(),
+		subject: z.string(),
+		summary: z.string(),
+		status: z.enum([
+			"candidate",
+			"completed",
+			"expired"
+		]),
+		confidence: z.number().min(0).max(1),
+		independentStatements: z.number().int(),
+		independentDays: z.number().int(),
+		lastSupportedAt: z.number(),
+		expiresAt: z.number(),
+		sources: z.array(z.object({
+			entryId: z.string(),
+			excerpt: z.string(),
+			observedAt: z.number()
+		}))
+	});
+	z.object({
+		provenance: PersonalProvenanceSchema,
+		thread: z.object({
+			id: z.string(),
+			subject: z.string(),
+			status: z.string(),
+			revision: z.number(),
+			nextCheckAt: z.number().nullable()
+		}),
+		whyNow: z.string(),
+		sources: z.array(z.object({
+			conversationId: z.string(),
+			transcriptId: z.string(),
+			entryId: z.string(),
+			excerpt: z.string()
+		})),
+		sourcesAvailable: z.boolean(),
+		strategy: PersonalStrategyStateSchema.optional()
+	});
+}));
+//#endregion
+init_personal_proactivity();
+export { PERSONAL_PROACTIVE_MESSAGE_TYPE, PersonalFeedbackSchema, PersonalProactiveMessageSchema, PersonalProactivitySettingsSchema, PersonalProvenanceSchema, PersonalStrategyRollbackSchema, PersonalStrategyStateSchema, init_personal_proactivity, parsePersonalProactiveMessage };

package/dist/packages/image-providers/src/catalog.js

@@ -0,0 +1,373 @@
+//#region packages/image-providers/src/catalog.ts
+const ratios = [
+	"1:1",
+	"2:3",
+	"3:2",
+	"3:4",
+	"4:3",
+	"4:5",
+	"5:4",
+	"9:16",
+	"16:9",
+	"21:9"
+];
+const square = [
+	"1024x1024",
+	"1536x1024",
+	"1024x1536"
+];
+const pixelGeometry = (minPixels, maxPixels, maxEdge, step = 1, maxRatio = 8, minEdge = 64) => ({
+	sizes: square,
+	pixels: {
+		minPixels,
+		maxPixels,
+		maxEdge,
+		step,
+		maxRatio,
+		minEdge
+	}
+});
+const cap = (maxCount, maxInputs, geometry, formats = ["png"]) => ({
+	generate: {
+		maxCount,
+		supportsSize: Boolean(geometry?.sizes),
+		supportsAspectRatio: Boolean(geometry?.aspectRatios),
+		supportsResolution: Boolean(geometry?.resolutions)
+	},
+	edit: {
+		enabled: maxInputs > 0,
+		maxInputImages: maxInputs,
+		supportsSize: Boolean(geometry?.sizes),
+		supportsAspectRatio: Boolean(geometry?.aspectRatios),
+		supportsResolution: Boolean(geometry?.resolutions)
+	},
+	geometry,
+	output: { formats }
+});
+const model = (id, capabilities, name = id, editPath) => ({
+	id,
+	name,
+	capabilities,
+	...editPath ? { editPath } : {}
+});
+const openai = cap(4, 16, {
+	...pixelGeometry(655360, 8294400, 3840, 16, 3),
+	sizes: [...square, "auto"]
+}, [
+	"png",
+	"jpeg",
+	"webp"
+]);
+openai.output.qualities = [
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max",
+	"auto"
+];
+openai.output.backgrounds = [
+	"transparent",
+	"opaque",
+	"auto"
+];
+const wan = (pro) => {
+	const value = cap(1, 4, {
+		...pixelGeometry(768 * 768, (pro ? 4096 : 2048) ** 2, pro ? 8192 : 4096),
+		sizes: [
+			...square,
+			"1K",
+			"2K",
+			...pro ? ["4K"] : []
+		]
+	});
+	value.edit.maxInputBytes = 20 * 1024 * 1024;
+	value.edit.geometry = {
+		...pixelGeometry(768 * 768, 2048 ** 2, 4096),
+		sizes: [
+			...square,
+			"1K",
+			"2K"
+		]
+	};
+	return value;
+};
+const gemini = (references, resolutions) => cap(1, references, {
+	aspectRatios: ratios,
+	resolutions
+}, ["png", "jpeg"]);
+const seedream = cap(1, 10, { sizes: [
+	"1K",
+	"2K",
+	"4K"
+] }, ["png", "jpeg"]);
+const ideogram = cap(4, 5, { sizes: ["1024x1024", "2048x2048"] });
+ideogram.edit = {
+	enabled: true,
+	maxInputImages: 5
+};
+ideogram.output.qualities = [
+	"low",
+	"medium",
+	"high"
+];
+const flux = cap(1, 8, pixelGeometry(4096, 4e6, 4096, 16), ["png", "jpeg"]);
+const providers = [
+	{
+		id: "openai",
+		name: "OpenAI",
+		protocol: "openai",
+		baseUrl: "https://api.openai.com/v1",
+		timeoutMs: 24e4,
+		documentationUrl: "https://developers.openai.com/api/docs/guides/image-generation",
+		apiKeyUrl: "https://platform.openai.com/api-keys",
+		models: [model("gpt-image-2.5-flare", openai, "GPT Image 2.5 Flare"), model("gpt-image-2.5-sunburst", openai, "GPT Image 2.5 Sunburst")]
+	},
+	{
+		id: "dashscope",
+		name: "Alibaba Model Studio",
+		protocol: "dashscope",
+		baseUrl: "https://dashscope.aliyuncs.com",
+		timeoutMs: 6e5,
+		regions: {
+			cn: "https://dashscope.aliyuncs.com",
+			intl: "https://dashscope-intl.aliyuncs.com"
+		},
+		documentationUrl: "https://help.aliyun.com/zh/model-studio/qwen-image-generation-and-editing-api-reference",
+		apiKeyUrl: "https://bailian.console.aliyun.com/",
+		models: [
+			model("qwen-image-3.0-pro", cap(1, 3, pixelGeometry(512 ** 2, 2048 ** 2, 4096))),
+			model("qwen-image-3.0", cap(1, 3, pixelGeometry(512 ** 2, 2048 ** 2, 4096))),
+			model("wan2.7-image-pro", wan(true)),
+			model("wan2.7-image", wan(false))
+		]
+	},
+	{
+		id: "minimax",
+		name: "MiniMax",
+		protocol: "minimax",
+		baseUrl: "https://api.minimax.io",
+		timeoutMs: 18e4,
+		regions: {
+			cn: "https://api.minimaxi.com",
+			intl: "https://api.minimax.io"
+		},
+		documentationUrl: "https://platform.minimax.io/docs/api-reference/image-generation",
+		apiKeyUrl: "https://platform.minimax.io/user-center/basic-information/interface-key",
+		models: [model("image-01", cap(1, 0, { aspectRatios: [
+			"1:1",
+			"16:9",
+			"9:16",
+			"4:3",
+			"3:4"
+		] }, ["jpeg"])), model("image-01-live", cap(1, 0, { aspectRatios: [
+			"1:1",
+			"16:9",
+			"9:16",
+			"4:3",
+			"3:4"
+		] }, ["jpeg"]))]
+	},
+	{
+		id: "google",
+		name: "Google Gemini",
+		protocol: "google",
+		baseUrl: "https://generativelanguage.googleapis.com",
+		timeoutMs: 24e4,
+		documentationUrl: "https://ai.google.dev/gemini-api/docs/image-generation",
+		apiKeyUrl: "https://aistudio.google.com/app/apikey",
+		models: [
+			model("gemini-nano-banana-2.1", gemini(14, [
+				"1K",
+				"2K",
+				"4K"
+			]), "Nano Banana 2.1"),
+			model("gemini-3.1-flash-lite-image", gemini(1, ["1K"]), "Nano Banana 2 Lite"),
+			model("gemini-3-pro-image", gemini(14, [
+				"1K",
+				"2K",
+				"4K"
+			]), "Nano Banana Pro")
+		]
+	},
+	{
+		id: "fal",
+		name: "fal.ai",
+		protocol: "fal",
+		baseUrl: "https://queue.fal.run",
+		timeoutMs: 6e5,
+		documentationUrl: "https://fal.ai/models",
+		apiKeyUrl: "https://fal.ai/dashboard/keys",
+		models: [
+			model("fal-ai/flux-2-pro", {
+				...flux,
+				edit: {
+					...flux.edit,
+					enabled: true,
+					maxInputImages: 8
+				}
+			}, "FLUX.2 Pro", "fal-ai/flux-2-pro/edit"),
+			model("google/nano-banana-2.1", gemini(14, [
+				"1K",
+				"2K",
+				"4K"
+			]), "Nano Banana 2.1", "google/nano-banana-2.1/edit"),
+			model("fal-ai/flux-2/klein/4b", {
+				...flux,
+				edit: {
+					...flux.edit,
+					enabled: true,
+					maxInputImages: 4
+				}
+			}, "FLUX.2 Klein 4B", "fal-ai/flux-2/klein/4b/edit")
+		]
+	},
+	{
+		id: "seedream",
+		name: "ByteDance Seedream",
+		protocol: "seedream",
+		baseUrl: "https://ark.cn-beijing.volces.com/api/v3",
+		timeoutMs: 24e4,
+		documentationUrl: "https://docs.volcengine.com/docs/ark/image-generation-api?lang=zh",
+		apiKeyUrl: "https://ark.volcengine.com/region:cn-beijing/apikey",
+		models: [model("doubao-seedream-5-0-flash-260915", seedream, "Seedream 5.0 Flash"), model("doubao-seedream-5-0-pro-260628", seedream, "Seedream 5.0 Pro")]
+	},
+	{
+		id: "ideogram",
+		name: "Ideogram",
+		protocol: "ideogram",
+		baseUrl: "https://api.ideogram.ai",
+		timeoutMs: 24e4,
+		documentationUrl: "https://developer.ideogram.ai/ideogram-api/api-overview",
+		apiKeyUrl: "https://ideogram.ai/manage-api",
+		models: [model("ideogram-4-5", ideogram, "Ideogram 4.5")]
+	},
+	{
+		id: "bfl",
+		name: "Black Forest Labs",
+		protocol: "bfl",
+		baseUrl: "https://api.bfl.ai/v1",
+		timeoutMs: 6e5,
+		documentationUrl: "https://docs.bfl.ai/flux_2/flux2_overview",
+		apiKeyUrl: "https://dashboard.bfl.ai/",
+		models: [
+			model("flux-2-pro", flux, "FLUX.2 Pro"),
+			model("flux-2-max", flux, "FLUX.2 Max"),
+			model("flux-2-klein-4b", {
+				...flux,
+				edit: {
+					...flux.edit,
+					enabled: true,
+					maxInputImages: 4
+				}
+			}, "FLUX.2 Klein 4B")
+		]
+	},
+	{
+		id: "zhipu-cn",
+		name: "Zhipu GLM-Image",
+		protocol: "zhipu",
+		baseUrl: "https://open.bigmodel.cn/api/paas/v4",
+		timeoutMs: 24e4,
+		documentationUrl: "https://docs.bigmodel.cn/cn/guide/models/image-generation/glm-image",
+		apiKeyUrl: "https://bigmodel.cn/usercenter/proj-mgmt/apikeys",
+		models: [model("glm-image", cap(1, 0, {
+			...pixelGeometry(512 ** 2, 2048 ** 2, 2048, 32, 4, 512),
+			sizes: [
+				"1280x1280",
+				"1568x1056",
+				"1056x1568",
+				"1472x1088",
+				"1088x1472",
+				"1728x960",
+				"960x1728"
+			]
+		}))]
+	},
+	{
+		id: "tokenhub",
+		name: "Tencent TokenHub",
+		protocol: "tokenhub",
+		baseUrl: "https://tokenhub.tencentmaas.com",
+		timeoutMs: 24e4,
+		documentationUrl: "https://cloud.tencent.com/document/product/1823/135745",
+		apiKeyUrl: "https://console.cloud.tencent.com/tokenhub",
+		models: [model("hy-image-v3.5-preview", {
+			...cap(1, 20, {
+				...pixelGeometry(256 ** 2, 4096 ** 2, 8192, 1, 32, 256),
+				sizes: [
+					"1024x1024",
+					"2048x2048",
+					"4096x4096"
+				]
+			}),
+			edit: {
+				enabled: true,
+				maxInputImages: 20,
+				supportsSize: true,
+				inputFormats: ["png", "jpeg"],
+				maxInputBytes: 20 * 1024 * 1024
+			}
+		}, "Hy Image 3.5 Preview"), model("hy-image-v3", {
+			...cap(1, 3, {
+				...pixelGeometry(512 ** 2, 1024 ** 2, 2048, 1, 4, 512),
+				sizes: ["1024x1024"]
+			}),
+			edit: {
+				enabled: true,
+				maxInputImages: 3,
+				supportsSize: true,
+				inputFormats: ["png", "jpeg"],
+				maxInputBytes: 10 * 1024 * 1024
+			}
+		}, "Hy Image 3.0")]
+	},
+	{
+		id: "stability",
+		name: "Stability AI",
+		protocol: "stability",
+		baseUrl: "https://api.stability.ai",
+		timeoutMs: 18e4,
+		documentationUrl: "https://platform.stability.ai/docs/api-reference",
+		apiKeyUrl: "https://platform.stability.ai/account/keys",
+		models: [model("stable-image-ultra", cap(1, 0, { aspectRatios: [
+			"1:1",
+			"16:9",
+			"9:16",
+			"4:3",
+			"3:4",
+			"3:2",
+			"2:3",
+			"21:9",
+			"9:21"
+		] }, [
+			"png",
+			"jpeg",
+			"webp"
+		])), model("stable-image-core", cap(1, 0, { aspectRatios: [
+			"1:1",
+			"16:9",
+			"9:16",
+			"4:3",
+			"3:4",
+			"3:2",
+			"2:3",
+			"21:9",
+			"9:21"
+		] }, [
+			"png",
+			"jpeg",
+			"webp"
+		]))]
+	}
+];
+function listImageProviderSpecs() {
+	return structuredClone(providers);
+}
+function getImageProviderSpec(id) {
+	const spec = providers.find((item) => item.id === id);
+	if (!spec) throw new Error(`Unknown image provider: ${id}`);
+	return structuredClone(spec);
+}
+//#endregion
+export { getImageProviderSpec, listImageProviderSpecs };