@vcp-dev/contracts 0.10.4 → 0.10.5

package/dist/user-facing-copy.d.ts

@@ -29,6 +29,14 @@ export declare const ERROR_COPY: {
     readonly WORKSPACE_INITIAL_GENERATION_CHECK_FAILED: "Initial generation could not be verified. Please retry.";
     readonly WORKSPACE_INITIAL_GENERATION_FINALIZE_FAILED: "Initial generation could not finalize. Please retry.";
     readonly WORKSPACE_INITIAL_GENERATION_QUALITY_GATE_FAILED: "Initial generation failed quality checks. Please regenerate the site.";
+    readonly WORKSPACE_CHECK_INCOMPLETE: "The check couldn't complete, so no page was delivered this round. Please regenerate the site.";
+    readonly WORKSPACE_RUN_RESUME_EXHAUSTED: "Generation was interrupted several times and stopped. Everything already saved is kept; you can regenerate the missing pages.";
+    readonly WORKSPACE_GENERATION_STOPPED: "You stopped this generation before any page was ready. Nothing was lost — start it again when you want.";
+    readonly WORKSPACE_FILL_IN_INTERRUPTED: "The fill-in run was interrupted and stopped. Your site is unchanged; select the targets again to retry.";
+    readonly WORKSPACE_RUN_LEASE_SUPERSEDED: "Another attempt took over this run, so this one stopped. Reload to see the current progress.";
+    readonly FILL_IN_NOT_AVAILABLE: "Fill-in is available after the site has been generated.";
+    readonly FILL_IN_TARGET_NOT_OMITTED: "One of the selected items is no longer listed as missing. Reload the omissions list and try again.";
+    readonly FILL_IN_TARGET_MODIFIED: "One of the selected items was changed or removed after generation, so it was not filled in. Your edits are kept.";
     readonly WORKSPACE_ITERATION_QUALITY_GATE_FAILED: "Quality check failed. The change was rolled back; try a smaller or more specific request.";
     readonly WORKSPACE_SOCKET_DEAD: "The workspace connection was lost. Please retry.";
     readonly WORKSPACE_RUN_CANCELLED: "The run was cancelled.";
@@ -64,6 +72,21 @@ export declare const ERROR_COPY: {
     readonly SANDBOX_RUNTIME_NOT_READY: "The preview needs to be refreshed before this change can be applied. Refresh the preview and try again.";
     readonly GENERIC: "Something went wrong. Please try again.";
 };
+/**
+ * 「这一轮是用户自己停下来的」那一组终态码。
+ *
+ * 两个码指向同一件事，只是入口不同：`WORKSPACE_RUN_CANCELLED` 来自
+ * `POST /agent-runs/workspace/cancel` 的硬取消，`WORKSPACE_GENERATION_STOPPED`
+ * 来自软停止（用户按停止、这一轮自己保存好已完成的页面后收尾，或租约已经不活
+ * 时由服务端补的终态）。界面必须对两者一视同仁：显示「已取消」终态、不提供
+ * 重试——把用户自己按的停止渲染成一条带重试按钮的错误，是在报一个不存在的故障。
+ *
+ * 只列一次，消费方按这里判定，避免某个分支只认其中一个码。
+ */
+export declare const USER_STOPPED_RUN_ERROR_CODES: readonly ["WORKSPACE_RUN_CANCELLED", "WORKSPACE_GENERATION_STOPPED"];
+export type UserStoppedRunErrorCode = (typeof USER_STOPPED_RUN_ERROR_CODES)[number];
+/** 这个终态码是不是「用户自己停的」。空值一律 false。 */
+export declare function isUserStoppedRunErrorCode(code: string | null | undefined): code is UserStoppedRunErrorCode;
 export declare const REFUSAL_COPY: {
     readonly UNDO_OR_ROLLBACK: "I can't roll back from chat. Use the version history at the top right to pick a restore point.";
     readonly HISTORY_RECALL: "Tell me what you'd like to change now—I'll work from the current page state.";

package/dist/workspace-attachment.d.ts

@@ -21,6 +21,26 @@ export declare const WORKSPACE_ATTACHMENT_UNSUPPORTED_FORMAT_ERROR_CODE: "WORKSP
 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";
+/**
+ * 站点每小时网址截图次数上限。上传是免费的，截图消耗 Firecrawl credits：既有的
+ * 「每消息 4 张」与「24h 未发送 20 张」都不是按花钱次数设计的闸门，这条专门用来
+ * 兜住刷截图。
+ */
+export declare const MAX_WORKSPACE_URL_CAPTURES_PER_SITE_HOUR = 10;
+/** 频控窗口。 */
+export declare const WORKSPACE_URL_CAPTURE_WINDOW_MS: number;
+/** 网址不可截图（非 http(s) / 解析失败 / SSRF 拒绝）。 */
+export declare const WORKSPACE_ATTACHMENT_URL_REJECTED_ERROR_CODE: "WORKSPACE_ATTACHMENT_URL_REJECTED";
+/** 目标不可达、被目标站拦截，或供应商没返回截图。 */
+export declare const WORKSPACE_ATTACHMENT_CAPTURE_FAILED_ERROR_CODE: "WORKSPACE_ATTACHMENT_CAPTURE_FAILED";
+/** 抓取供应商并发已满，稍后可重试。 */
+export declare const WORKSPACE_ATTACHMENT_CAPTURE_BUSY_ERROR_CODE: "WORKSPACE_ATTACHMENT_CAPTURE_BUSY";
+/** 截图超时。 */
+export declare const WORKSPACE_ATTACHMENT_CAPTURE_TIMEOUT_ERROR_CODE: "WORKSPACE_ATTACHMENT_CAPTURE_TIMEOUT";
+/** 站点频控或租户日 credits 预算耗尽。 */
+export declare const WORKSPACE_ATTACHMENT_CAPTURE_BUDGET_ERROR_CODE: "WORKSPACE_ATTACHMENT_CAPTURE_BUDGET_EXCEEDED";
+/** 未配置抓取服务或对象存储，截图能力整体不可用。 */
+export declare const WORKSPACE_ATTACHMENT_CAPTURE_UNAVAILABLE_ERROR_CODE: "WORKSPACE_ATTACHMENT_CAPTURE_UNAVAILABLE";
 export declare const WorkspaceAttachmentSchema: z.ZodObject<{
     attachment_id: z.ZodString;
     media_type: z.ZodEnum<{
@@ -33,9 +53,16 @@ export declare const WorkspaceAttachmentSchema: z.ZodObject<{
     size_bytes: z.ZodNumber;
     filename: z.ZodString;
     image_url: z.ZodString;
+    source_url: z.ZodOptional<z.ZodString>;
     created_at: z.ZodString;
 }, z.core.$strict>;
 export type WorkspaceAttachment = z.infer<typeof WorkspaceAttachmentSchema>;
+/** 网址截图请求体。`full_page` 缺省为真：整页截图。 */
+export declare const WorkspaceAttachmentFromUrlRequestSchema: z.ZodObject<{
+    url: z.ZodString;
+    full_page: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type WorkspaceAttachmentFromUrlRequest = z.infer<typeof WorkspaceAttachmentFromUrlRequestSchema>;
 /** 附件读图路径的唯一事实源；web / api / agent 三方都只认这个形状。 */
 export declare function workspaceAttachmentImagePath(site_id: string, attachment_id: string): string;
 export declare function parseWorkspaceAttachmentImagePath(url: string): {

package/package.json

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