@southwind-ai/shared 0.2.3 → 0.2.4

package/index.ts

@@ -1,4 +1,7 @@
 export * from "./src/audit.js";
+// @windy-module system.agent begin
+export * from "./src/ai-runtime-report.js";
+// @windy-module system.agent end
 export * from "./src/database.js";
 export * from "./src/data-governance.js";
 export * from "./src/feature.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@southwind-ai/shared",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "license": "UNLICENSED",
   "type": "module",
   "engines": {

package/src/ai-runtime-report.ts

@@ -0,0 +1,134 @@
+import type { ISODateTime, PageResult } from "./primitives.js";
+
+export type AiRuntimeReportRange = "day" | "month" | "retained";
+export type AiRuntimeRunStatus =
+  | "accepted"
+  | "running"
+  | "awaiting-approval"
+  | "completed"
+  | "failed"
+  | "cancelled";
+export type AiRuntimeAttemptOutcome =
+  | "running"
+  | "completed"
+  | "failed"
+  | "cancelled"
+  | "blocked"
+  | "abandoned";
+export type AiRuntimeCacheStatus = "hit" | "miss" | "unknown";
+export type AiRuntimeUsageSource =
+  | "provider-reported"
+  | "estimated"
+  | "unknown";
+
+export interface AiRuntimeRunCounts {
+  total: number;
+  completed: number;
+  failed: number;
+  cancelled: number;
+  inProgress: number;
+  successRate: number | null;
+}
+
+export interface AiRuntimeCacheSummary {
+  hit: number;
+  miss: number;
+  unknown: number;
+  hitRate: number | null;
+  tokenRate: number | null;
+  coverageRate: number;
+}
+
+export interface AiRuntimeTokenSummary {
+  input: number | null;
+  output: number | null;
+  cachedInput: number | null;
+  reasoning: number | null;
+  total: number | null;
+  coverageRate: number;
+}
+
+export interface AiRuntimeModelUsageSummary {
+  deploymentKey: string;
+  model: string;
+  attempts: number;
+  inputTokens: number | null;
+  outputTokens: number | null;
+  cachedInputTokens: number | null;
+  reasoningTokens: number | null;
+  totalTokens: number | null;
+  unknownUsageCount: number;
+}
+
+export interface AiRuntimeActivityPoint {
+  date: string;
+  runs: number;
+  completed: number;
+  failed: number;
+  totalTokens: number | null;
+}
+
+export interface AiRuntimeReportSummary {
+  generatedAt: ISODateTime;
+  reportingAvailableFrom: ISODateTime | null;
+  retentionDays: number;
+  runs: AiRuntimeRunCounts;
+  cache: AiRuntimeCacheSummary;
+  tokens: AiRuntimeTokenSummary;
+  byModel: AiRuntimeModelUsageSummary[];
+  activity: AiRuntimeActivityPoint[];
+}
+
+export interface AiRuntimeActorSummary {
+  handle: string;
+  displayName: string;
+  username?: string;
+}
+
+export interface AiRuntimeRunUsage {
+  inputTokens: number | null;
+  outputTokens: number | null;
+  cachedInputTokens: number | null;
+  reasoningTokens: number | null;
+  totalTokens: number | null;
+}
+
+export interface AiRuntimeRunListItem {
+  runId: string;
+  operationKey: string;
+  actor: AiRuntimeActorSummary | null;
+  status: AiRuntimeRunStatus;
+  startedAt: ISODateTime | null;
+  finishedAt: ISODateTime | null;
+  durationMs: number | null;
+  attemptCount: number;
+  models: string[];
+  cacheStatus: AiRuntimeCacheStatus;
+  usage: AiRuntimeRunUsage;
+}
+
+export interface AiRuntimeAttemptDetail extends AiRuntimeRunUsage {
+  attemptId: string;
+  sequence: number;
+  toolRound: number;
+  deploymentKey: string;
+  model: string;
+  outcome: AiRuntimeAttemptOutcome;
+  cacheStatus: AiRuntimeCacheStatus;
+  usageSource: AiRuntimeUsageSource;
+  firstTokenLatencyMs: number | null;
+  durationMs: number | null;
+  safeErrorCode: string | null;
+  startedAt: ISODateTime;
+  finishedAt: ISODateTime | null;
+}
+
+export interface AiRuntimeRunDetail extends AiRuntimeRunListItem {
+  releaseId: string;
+  traceId: string;
+  safeErrorCode: string | null;
+  attempts: AiRuntimeAttemptDetail[];
+}
+
+export type AiRuntimeRunPage = PageResult<AiRuntimeRunListItem>;
+export type AiRuntimeActorPage = PageResult<AiRuntimeActorSummary>;

package/src/platform-settings.ts

@@ -18,12 +18,27 @@ export const WATERMARK_CONTENT_FIELDS = [
 ] as const;
 export type WatermarkContentField = (typeof WATERMARK_CONTENT_FIELDS)[number];
 
+export const WATERMARK_OPACITY_RANGE = {
+  min: 3,
+  max: 30,
+  step: 1,
+} as const;
+
+export const WATERMARK_FONT_SIZE_RANGE = {
+  min: 12,
+  max: 32,
+  step: 1,
+} as const;
+
 export interface PlatformWatermarkPolicy {
   enabled: boolean;
+  /** @deprecated 升级兼容字段，始终与 enabled 保持一致。 */
   businessPagesEnabled: boolean;
   density: WatermarkDensity;
   contentFields: WatermarkContentField[];
   customContent: string;
+  opacityPercent: number;
+  fontSize: number;
 }
 
 export const DEFAULT_PLATFORM_WATERMARK_POLICY: Readonly<PlatformWatermarkPolicy> =
@@ -33,4 +48,6 @@ export const DEFAULT_PLATFORM_WATERMARK_POLICY: Readonly<PlatformWatermarkPolicy
     density: "medium",
     contentFields: ["username", "displayName"],
     customContent: "",
+    opacityPercent: 8,
+    fontSize: 14,
   };