@vcp-dev/contracts 0.6.10 → 0.7.0

package/dist/industry-classification.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+/**
+ * 行业判定：把用户已冻结的业务表述归到一份行业先验上。
+ *
+ * 为什么要单独一次调用：`skills/page-generation` 下的行业先验从来没被线上路径读
+ * 到过，所有站共用同一份通用先验。判定的输入是自由文本（客户资料的行业与主营
+ * 产品、原站流冻结的主营产品与现有市场），对自由文本做关键词匹配是本仓明令禁止
+ * 的，所以由服务端模型服务做一次轻量分类。
+ *
+ * 判定发生在建站开始之前（Sitemap 转发时），此时 Step6 设计推荐那次调用还没发生，
+ * 搭不了车，只能独立跑一次。
+ *
+ * 判错比不判更糟 —— 错误的行业先验会把整站带偏。所以宁可返回空，让下游退回通用
+ * 先验，也不给一个没把握的答案。
+ */
+export declare const IndustryClassificationRequestSchema: z.ZodObject<{
+    site_id: z.ZodUUID;
+    site_language: z.ZodString;
+    business_facts: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type IndustryClassificationRequest = z.infer<typeof IndustryClassificationRequestSchema>;
+export declare const IndustryConfidenceSchema: z.ZodEnum<{
+    high: "high";
+    medium: "medium";
+    low: "low";
+}>;
+export type IndustryConfidence = z.infer<typeof IndustryConfidenceSchema>;
+/**
+ * 判定结果。`skill_name` 为 null 表示判不出 —— 调用方据此整个不注入，agent 缺省
+ * 回到通用先验，行为与判定上线前逐字相同。
+ *
+ * `confidence` 由模型自报，调用方不能只押这一个信号：`low` 一律当判不出处理。
+ */
+export declare const IndustryClassificationResultSchema: z.ZodObject<{
+    skill_name: z.ZodNullable<z.ZodString>;
+    confidence: z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export type IndustryClassificationResult = z.infer<typeof IndustryClassificationResultSchema>;

package/dist/input-context-bundle.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 export declare const InputSourceTypeSchema: z.ZodEnum<{
-    text: "text";
     url: "url";
+    text: "text";
     document: "document";
     image: "image";
 }>;
@@ -19,8 +19,8 @@ export declare const InputBundleStatusSchema: z.ZodEnum<{
 }>;
 export type InputBundleStatus = z.infer<typeof InputBundleStatusSchema>;
 export declare const ExtractedFactKindSchema: z.ZodEnum<{
-    copy: "copy";
     product: "product";
+    copy: "copy";
     price: "price";
     contact: "contact";
     audience: "audience";
@@ -29,8 +29,8 @@ export declare const ExtractedFactKindSchema: z.ZodEnum<{
 export declare const ExtractedFactSchema: z.ZodObject<{
     fact: z.ZodString;
     kind: z.ZodEnum<{
-        copy: "copy";
         product: "product";
+        copy: "copy";
         price: "price";
         contact: "contact";
         audience: "audience";
@@ -63,8 +63,8 @@ export type ReferenceSignals = z.infer<typeof ReferenceSignalsSchema>;
 export declare const InputSourceSchema: z.ZodObject<{
     source_id: z.ZodUUID;
     type: z.ZodEnum<{
-        text: "text";
         url: "url";
+        text: "text";
         document: "document";
         image: "image";
     }>;
@@ -198,8 +198,8 @@ export declare const InputContextBundleSchema: z.ZodObject<{
     sources: z.ZodArray<z.ZodObject<{
         source_id: z.ZodUUID;
         type: z.ZodEnum<{
-            text: "text";
             url: "url";
+            text: "text";
             document: "document";
             image: "image";
         }>;
@@ -217,8 +217,8 @@ export declare const InputContextBundleSchema: z.ZodObject<{
     facts: z.ZodArray<z.ZodObject<{
         fact: z.ZodString;
         kind: z.ZodEnum<{
-            copy: "copy";
             product: "product";
+            copy: "copy";
             price: "price";
             contact: "contact";
             audience: "audience";
@@ -250,3 +250,13 @@ export declare const InputContextBundleSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type InputContextBundle = z.infer<typeof InputContextBundleSchema>;
+/**
+ * 整站视觉参考图：用户自己传的 reference 轨图片优先，其次是参考站扫描截图。
+ *
+ * 两个消费方必须选出同一张：`apps/api` 的 Step6 推荐把它算进 `input_digest`
+ * 并转发 source_id，`apps/agent` 按 source_id 回读字节送多模态。选择规则一旦
+ * 分叉，就会出现「API 说图 A、agent 读图 B」的静默错配，所以规则只留这一份。
+ */
+export declare function selectReferenceVisualImage(bundle: Pick<InputContextBundle, "sources" | "reference">): {
+    source_id: string;
+} | null;

package/dist/internal-entity-id.d.ts

@@ -26,6 +26,9 @@ export declare const SandboxSessionIdSchema: z.ZodUUID;
 export declare const DeploymentIdSchema: z.ZodUUID;
 export declare const DeploymentJobIdSchema: z.ZodUUID;
 export declare const SiteOperationLockIdSchema: z.ZodUUID;
+export declare const SitePublishWorkflowIdSchema: z.ZodUUID;
+export declare const SiteWorkflowIdSchema: z.ZodUUID;
+export declare const SiteWorkflowTaskRefIdSchema: z.ZodUUID;
 export declare const FormDesignOperationRecordIdSchema: z.ZodUUID;
 export declare const SiteTemplateUpgradeStateIdSchema: z.ZodUUID;
 export declare const UsageRecordIdSchema: z.ZodUUID;

package/dist/knowledge-category.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+/**
+ * 企业知识库的资料分类。写入侧（`apps/api` 的知识库上传/改分类）与检索侧
+ * （`apps/agent` 的 `query_knowledge_base`）共用同一份枚举：上游对非法分类
+ * 是 200 + 空召回的静默行为，两侧必须锚定同一份合法值才能把"分类拼错"和
+ * "这家企业没这类资料"区分开。
+ *
+ * 顺序即上游与既有 UI 的展示顺序，不要随意调整。
+ */
+export declare const KNOWLEDGE_CATEGORY_CODES: readonly ["company_profile", "product_manual", "product_list", "customer_case", "product_help", "qualification", "industry_material"];
+export declare const KnowledgeCategoryCodeSchema: z.ZodEnum<{
+    company_profile: "company_profile";
+    product_manual: "product_manual";
+    product_list: "product_list";
+    customer_case: "customer_case";
+    product_help: "product_help";
+    qualification: "qualification";
+    industry_material: "industry_material";
+}>;
+export type KnowledgeCategoryCode = z.infer<typeof KnowledgeCategoryCodeSchema>;

package/dist/knowledge-source-readiness.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+export declare const KnowledgeSourceReadinessStatusSchema: z.ZodEnum<{
+    ready: "ready";
+    failed: "failed";
+    pending: "pending";
+    running: "running";
+    missing: "missing";
+}>;
+export declare const KnowledgeTaskStatusSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    status: z.ZodEnum<{
+        ready: "ready";
+        failed: "failed";
+        pending: "pending";
+        running: "running";
+        missing: "missing";
+    }>;
+}, z.core.$strict>;
+/** Server-only normalized task results. Do not expose this to browsers. */
+export declare const KnowledgeTaskStatusBatchSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        task_id: z.ZodString;
+        status: z.ZodEnum<{
+            ready: "ready";
+            failed: "failed";
+            pending: "pending";
+            running: "running";
+            missing: "missing";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const Step2KnowledgeOpaqueIdSchema: z.ZodString;
+export declare const Step2KnowledgeScopeSchema: z.ZodObject<{
+    knowledge_site_id: z.ZodString;
+    source_ids: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const KnowledgeSourceReadinessSchema: z.ZodObject<{
+    source_file_id: z.ZodString;
+    category_code: z.ZodNullable<z.ZodEnum<{
+        company_profile: "company_profile";
+        product_manual: "product_manual";
+        product_list: "product_list";
+        customer_case: "customer_case";
+        product_help: "product_help";
+        qualification: "qualification";
+        industry_material: "industry_material";
+    }>>;
+    category_confirmed: z.ZodBoolean;
+    status: z.ZodEnum<{
+        ready: "ready";
+        failed: "failed";
+        pending: "pending";
+        running: "running";
+        missing: "missing";
+    }>;
+}, z.core.$strict>;
+export declare const KnowledgeContextReadinessSchema: z.ZodObject<{
+    ready: z.ZodBoolean;
+    files: z.ZodArray<z.ZodObject<{
+        source_file_id: z.ZodString;
+        category_code: z.ZodNullable<z.ZodEnum<{
+            company_profile: "company_profile";
+            product_manual: "product_manual";
+            product_list: "product_list";
+            customer_case: "customer_case";
+            product_help: "product_help";
+            qualification: "qualification";
+            industry_material: "industry_material";
+        }>>;
+        category_confirmed: z.ZodBoolean;
+        status: z.ZodEnum<{
+            ready: "ready";
+            failed: "failed";
+            pending: "pending";
+            running: "running";
+            missing: "missing";
+        }>;
+    }, z.core.$strict>>;
+    counts: z.ZodObject<{
+        total: z.ZodNumber;
+        pending: z.ZodNumber;
+        running: z.ZodNumber;
+        ready: z.ZodNumber;
+        failed: z.ZodNumber;
+        missing: z.ZodNumber;
+        unclassified: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type KnowledgeSourceReadinessStatus = z.infer<typeof KnowledgeSourceReadinessStatusSchema>;
+export type KnowledgeTaskStatus = z.infer<typeof KnowledgeTaskStatusSchema>;
+export type KnowledgeTaskStatusBatch = z.infer<typeof KnowledgeTaskStatusBatchSchema>;
+export type Step2KnowledgeScope = z.infer<typeof Step2KnowledgeScopeSchema>;
+export type KnowledgeSourceReadiness = z.infer<typeof KnowledgeSourceReadinessSchema>;
+export type KnowledgeContextReadiness = z.infer<typeof KnowledgeContextReadinessSchema>;