@vcp-dev/contracts 0.10.2 → 0.10.3

package/dist/workspace-attachment.d.ts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+/**
+ * Workspace 聊天图片附件合同。附件是独立边界（不进 input-context 资料轨）：
+ * 消息 `parts` 里只放 AI SDK `file` part 引用，`url` 是附件读图路径；字节只存 S3。
+ * 设计见 docs/superpowers/specs/2026-09-09-workspace-chat-image-attachments-design.md。
+ */
+export declare const MAX_WORKSPACE_ATTACHMENTS_PER_MESSAGE = 4;
+/** 每站 24h 内未绑定（尚未随消息发送）的附件上限，超过则上传 409。 */
+export declare const MAX_UNBOUND_WORKSPACE_ATTACHMENTS_PER_SITE = 20;
+export declare const WORKSPACE_ATTACHMENT_UNBOUND_TTL_MS: number;
+/** 压缩收敛目标（base64 长度）。比首轮参考图的 5MiB 紧：迭代循环每步都重发内联图。 */
+export declare const WORKSPACE_ATTACHMENT_TARGET_BASE64_BYTES = 1000000;
+export declare const WORKSPACE_ATTACHMENT_MEDIA_TYPES: readonly ["image/png", "image/jpeg", "image/webp"];
+export declare const WorkspaceAttachmentMediaTypeSchema: z.ZodEnum<{
+    "image/png": "image/png";
+    "image/jpeg": "image/jpeg";
+    "image/webp": "image/webp";
+}>;
+export type WorkspaceAttachmentMediaType = z.infer<typeof WorkspaceAttachmentMediaTypeSchema>;
+export declare const WORKSPACE_ATTACHMENT_UNSUPPORTED_FORMAT_ERROR_CODE: "WORKSPACE_ATTACHMENT_UNSUPPORTED_FORMAT";
+export declare const WORKSPACE_ATTACHMENT_TOO_LARGE_ERROR_CODE: "WORKSPACE_ATTACHMENT_TOO_LARGE";
+export declare const WORKSPACE_ATTACHMENT_LIMIT_ERROR_CODE: "WORKSPACE_ATTACHMENT_LIMIT";
+export declare const WORKSPACE_ATTACHMENT_BOUND_ERROR_CODE: "WORKSPACE_ATTACHMENT_BOUND";
+export declare const WorkspaceAttachmentSchema: z.ZodObject<{
+    attachment_id: z.ZodString;
+    media_type: z.ZodEnum<{
+        "image/png": "image/png";
+        "image/jpeg": "image/jpeg";
+        "image/webp": "image/webp";
+    }>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    size_bytes: z.ZodNumber;
+    filename: z.ZodString;
+    image_url: z.ZodString;
+    created_at: z.ZodString;
+}, z.core.$strict>;
+export type WorkspaceAttachment = z.infer<typeof WorkspaceAttachmentSchema>;
+/** 附件读图路径的唯一事实源；web / api / agent 三方都只认这个形状。 */
+export declare function workspaceAttachmentImagePath(site_id: string, attachment_id: string): string;
+export declare function parseWorkspaceAttachmentImagePath(url: string): {
+    site_id: string;
+    attachment_id: string;
+} | null;
+export interface WorkspaceAttachmentReference {
+    attachment_id: string;
+    site_id: string;
+    media_type: string;
+    filename: string;
+    url: string;
+}
+/**
+ * 从 UIMessage parts 读出附件引用：只认 `file` part 且 `url` 能解析成附件路径。
+ * 结构化入参而非 `AiSdkUiMessagePart`，避免与 index.ts 循环依赖。
+ */
+export declare function readWorkspaceAttachmentReferences(parts: readonly {
+    type: string;
+    mediaType?: unknown;
+    filename?: unknown;
+    url?: unknown;
+    [key: string]: unknown;
+}[]): WorkspaceAttachmentReference[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vcp-dev/contracts",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {