create-windy 0.2.32 → 0.2.34

package/template/packages/server-sdk/src/tool-registration.ts

@@ -1,10 +1,16 @@
 import type { ModuleActor } from "./actor.js";
 import type { ModuleAiJsonValue } from "./ai-operation-registration.js";
+import type { ModuleStoragePort } from "./storage-port.js";
 
 export interface ModuleToolContext {
   readonly actor: ModuleActor;
   readonly requestId: string;
   readonly signal: AbortSignal;
+  /**
+   * 与当前 Tool Actor、请求范围和模块命名空间绑定的受限存储 Port。
+   * Host 未安装 Storage 时为 fail-closed 实现。
+   */
+  readonly storage: ModuleStoragePort;
 }
 
 export type ModuleToolInput = Readonly<Record<string, ModuleAiJsonValue>>;

package/template/packages/server-sdk/src/user-directory-port.ts

@@ -0,0 +1,42 @@
+export interface ModuleUserDirectoryQuery {
+  readonly page?: number;
+  readonly pageSize?: number;
+  readonly q?: string;
+}
+
+export interface ModuleUserDirectoryEntry {
+  readonly id: string;
+  readonly displayName: string;
+}
+
+export interface ModuleUserDirectoryPage {
+  readonly items: readonly ModuleUserDirectoryEntry[];
+  readonly total: number;
+  readonly page: number;
+  readonly pageSize: number;
+}
+
+export type ModuleUserDirectoryErrorCode =
+  | "USER_DIRECTORY_FORBIDDEN"
+  | "USER_DIRECTORY_UNAVAILABLE"
+  | "USER_DIRECTORY_INVALID_QUERY";
+
+export class ModuleUserDirectoryError extends Error {
+  constructor(
+    readonly code: ModuleUserDirectoryErrorCode,
+    message: string,
+  ) {
+    super(message);
+    this.name = "ModuleUserDirectoryError";
+  }
+}
+
+/**
+ * 业务模块使用的只读启用用户目录。
+ *
+ * Actor、租户、部门与 Data Scope 全部由宿主绑定；调用方只能提交分页和搜索条件。
+ * 宿主会执行 Feature、Permission、数据范围与审计，失败时不会降级为全量用户查询。
+ */
+export interface ModuleUserDirectoryPort {
+  list(query?: ModuleUserDirectoryQuery): Promise<ModuleUserDirectoryPage>;
+}

package/template/packages/shared/src/platform-settings.ts

@@ -4,15 +4,31 @@ export interface PlatformBrandingSettings {
   description?: string;
 }
 
+export const WATERMARK_DENSITIES = ["low", "medium", "high"] as const;
+export type WatermarkDensity = (typeof WATERMARK_DENSITIES)[number];
+
+export const WATERMARK_CONTENT_FIELDS = [
+  "username",
+  "displayName",
+  "phone",
+  "email",
+  "custom",
+] as const;
+export type WatermarkContentField = (typeof WATERMARK_CONTENT_FIELDS)[number];
+
 export interface PlatformWatermarkPolicy {
   enabled: boolean;
   businessPagesEnabled: boolean;
+  density: WatermarkDensity;
+  contentFields: WatermarkContentField[];
   customContent: string;
 }
 
 export const DEFAULT_PLATFORM_WATERMARK_POLICY: Readonly<PlatformWatermarkPolicy> =
   {
     enabled: true,
-    businessPagesEnabled: false,
+    businessPagesEnabled: true,
+    density: "medium",
+    contentFields: ["username", "displayName"],
     customContent: "",
   };